VS Code 설정 가이드
VS Code는 코드 에디터일 뿐 모델 제공업체(Provider)가 아닙니다. VS Code에서 Claude, GPT, Gemini 또는 중계 플랫폼(Provider) 모델을 사용할 때는 일반적으로 Cline, Continue, GitHub Copilot과 같은 확장 프로그램을 통해 연결합니다. Key, Base URL, 모델명을 입력해야 하는 실제 위치는 바로 해당 확장 프로그램의 설정 화면입니다.
공식 정보 다운로드 및 문서는 공식 사이트를 기준으로 합니다.
먼저 세 가지 개념 구분하기
VS Code코드를 작성하는 공간일 뿐이며 프로젝트 열기, 파일 편집, 확장 프로그램 설치 등을 담당합니다.
AI 확장 프로그램Cline, Continue, Copilot 등과 같은 확장 프로그램으로, 질문과 코드 컨텍스트를 모델로 전송하고 그 응답을 다시 VS Code에 표시하는 역할을 합니다.
모델 소스Claude, GPT, Gemini, OpenAI 호환 AI 중계 플랫폼, 로컬 모델 등이 모두 모델 소스에 해당합니다. 사용 가능 여부는 선택한 확장 프로그램의 지원 여부에 달려 있습니다.
따라서 이 페이지는 "Cline 또는 Roo Code로만 설정할 수 있다"는 의미가 아닙니다. 더 정확히 말하자면, VS Code에서 AI 확장 프로그램을 선택한 뒤 해당 확장 프로그램 내에서 Claude, GPT, Gemini 또는 OpenAI 호환 서비스를 선택해 사용하는 구조입니다.
모델 소스 선택 방법
| 사용하려는 모델 | 공급자(Provider) 선택 방식 | Key / Base URL 입력 방법 | 적합한 상황 |
|---|---|---|---|
| Claude | Anthropic / Claude | Anthropic Key를 입력합니다. 중계 플랫폼(Provider)을 사용하는 경우 해당 플랫폼 안내에 따라 OpenAI Compatible 또는 커스텀 항목을 선택하세요. | 코드 이해, 코드 수정 및 긴 컨텍스트 질문/답변에 적합합니다. |
| GPT / OpenAI | OpenAI | OpenAI Key를 입력합니다. 공식 다이렉트 연결 시에는 일반적으로 Base URL을 변경할 필요가 없으며, 중계 플랫폼 이용 시에만 제공받은 API 링크를 입력하면 됩니다. | 일반적인 질문/답변, 코드 설명 및 간단한 수정에 적합합니다. |
| AI 중계 플랫폼 / 통합 서비스 | OpenAI Compatible / Custom Provider | 중계 플랫폼 대시보드에 표시된 Key, Base URL, Model ID를 그대로 복사해 입력합니다. 일부 Base URL에는 /v1이 포함되고 일부는 포함되지 않으므로 대시보드 표기 방식을 그대로 따르세요. | 여러 모델을 일원화된 방식으로 사용하려는 초보자에게 적합합니다. |
| Gemini / 기타 모델 | Google Gemini 또는 해당 Provider | 해당 플랫폼의 Key를 입력합니다. Base URL은 확장 프로그램에서 커스텀 인터페이스를 제공할 때만 입력하면 됩니다. | 다양한 모델을 비교 분석할 때 적합하며, 사용 가능 여부는 확장 프로그램의 현재 버전에 따라 달라집니다. |
| GitHub Copilot | GitHub / Copilot 로그인 | Key와 Base URL을 입력하는 대신 GitHub 계정으로 로그인하여 관련 권한을 활성화합니다. | VS Code 공식 생태계 내에서 번거로움 없이 간편하게 코딩 어시스턴트를 사용하고 싶은 사용자에게 적합합니다. |
설정 진입 경로 및 단계
- 먼저 VS Code를 설치한 후 왼쪽 사이드바의 확장 프로그램 마켓플레이스(Extensions)를 엽니다.
- AI 확장 프로그램을 선택합니다. 초보자라면 Cline으로 시작하는 것을 추천합니다. 이미 Continue를 사용 중이라면 본 사이트의 Continue 전용 가이드를 참고하세요. Roo Code는 고급 사용자에게 더 적합하므로 초보자가 처음부터 설치하는 것은 권장하지 않습니다.
- 확장 프로그램 설정을 열고 Provider, Model Provider, API Provider 형태의 설정 항목을 찾습니다.
- Claude를 사용하려면 Anthropic / Claude를 선택하고, GPT를 사용하려면 OpenAI를 선택하며, 중계 플랫폼을 사용하려면 OpenAI Compatible 또는 Custom Provider를 선택합니다.
- Key를 입력합니다. 공식 모델 플랫폼을 사용할 때는 보통 공식 Key만 필요하지만, 중계 플랫폼을 사용할 때는 대시보드에서 Key와 Base URL을 모두 복사해 입력해야 합니다.
- 모델을 선택하거나 모델명을 직접 입력합니다. 모델명을 임의로 수정하지 말고 중계 플랫폼 대시보드에 표시된 명칭을 그대로 입력하세요.
- 명령어 자동 실행, 파일 자동 수정, 변경 사항 자동 적용 등의 옵션은 비활성화하거나 매번 확인(Confirm)하도록 설정합니다.
안전 테스트 안내
첫 테스트 시 다음과 같이 질문하는 것을 권장합니다
Read only the currently open file. Do not modify files or run commands. Explain what this code does in beginner-friendly language.명령어 실행이나 파일 수정이 포함된 작업은 AI가 수행하려는 동작을 먼저 확인하세요. 초보자는 완전 자동 모드를 켜지 않는 것이 좋습니다.