VS Code 설정 가이드
VS Code + Cline에서 OpenAI Compatible 방식으로 Guishu Token을 연동합니다.
목표: VS Code에 Cline을 설치하고 OpenAI Compatible 방식으로 Guishu Token을 연동합니다. 설정을 완료하면 VS Code에서 AI가 직접 코드를 읽고 수정하며, 명령을 작성하고 오류를 설명하도록 할 수 있습니다.
| 설정 항목 | 입력 내용 | 비고 |
|---|---|---|
| API Provider | OpenAI Compatible | Cline은 OpenAI 호환 서비스 제공자를 공식 지원합니다. |
| Base URL | https://api.llm-token.cn/v1 | 전체 /chat/completions 경로를 입력하지 마십시오. |
| API Key | sk-xxxxxxxx | 전체 Key를 붙여 넣습니다. |
| Model ID | 모델 목록에서 전체 모델 이름 복사 | 모델이 존재하지 않는다는 오류는 대부분 이 항목을 잘못 입력한 경우입니다. |
1. 사전 준비
- VS Code 설치: https://code.visualstudio.com/
- Git 설치: https://git-scm.com/downloads
- Windows 사용자는 Git 설치 후 환경 변수가 적용되도록 컴퓨터를 한 번 재시작하는 것이 좋습니다.
2. Cline 확장 프로그램 설치
- VS Code를 열고 왼쪽의 Extensions 확장 프로그램 스토어를 클릭합니다.
- Cline을 검색한 뒤 Install을 클릭합니다.
- 설치가 완료되면 왼쪽에 Cline 아이콘이 표시됩니다.
- 아이콘이 나타나지 않으면 VS Code를 재시작합니다.
VS Code에서 Cline 플러그인을 검색하는 화면입니다. 왼쪽의 여러 아이콘 중 ‘확장 프로그램’ 아이콘이 빨간색 테두리로 강…
3. Cline 설정 열기
왼쪽의 Cline 아이콘을 클릭하여 Cline 패널로 이동한 뒤 설정을 엽니다.
VS Code의 Cline 설정 화면으로, 설정을 연 뒤 수행하는 단계에 해당합니다. 위쪽에는 ‘How will you use C…
VS Code의 Cline 플러그인 설정 화면입니다. 왼쪽에는 ‘API Configuration’, ‘Plan Mode’, ‘Ac…
4. Guishu Token 인터페이스 입력
- API Provider: OpenAI Compatible을 선택합니다.
- Base URL:
https://api.llm-token.cn/v1을 입력합니다. - API Key: 본인의
sk-로 시작하는 Key를 붙여 넣습니다. - Model ID:
claude-sonnet-4-6과 같은 전체 모델 ID를 입력합니다. - 설정을 저장한 뒤 새 작업을 만들어 테스트합니다.
저장할 때 오류가 발생하는 경우: 먼저 Base URL을 https://api.llm-token.cn/v1/chat/completions로 입력하지 않았는지 확인하십시오. Cline에는 API 루트 경로인 /v1을 입력해야 합니다.
5. 테스트 및 문제 해결
| 현상 | 처리 방법 |
|---|---|
| URL을 입력할 수 없음 | 일반 OpenAI 공식 제공자가 아니라 OpenAI Compatible을 선택했는지 확인하십시오. |
| Model Not Found | 모델 ID가 모델 목록과 완전히 일치해야 합니다. |
| 연결 실패 | Key, Base URL 및 네트워크 프록시를 확인하십시오. 회사 또는 캠퍼스 네트워크에서는 모바일 핫스팟으로 바꾸어 테스트할 수 있습니다. |
| Cline 아이콘이 없음 | VS Code를 재시작하고, 그래도 표시되지 않으면 확장 프로그램을 다시 설치하십시오. |