Claude Code는 마켓플레이스에서 직접 설치하는 네이티브 VS Code 확장 프로그램으로 실행되며, 브라우저 탭이나 창 간 복사-붙여넣기가 필요 없습니다. 이 확장 프로그램은 CLI를 구동하는 동일한 Claude Code 엔진을 내장하므로, 슬래시 명령어부터 파일 편집, MCP 도구 호출까지 모든 기능이 에디터 사이드바 내에서 동일하게 작동합니다. PyCharm과 나머지 JetBrains 제품군도 전용 JetBrains 플러그인을 통해 동일한 기능을 제공받습니다. 그리고 두 환경 모두 환경 변수에서 ANTHROPIC_BASE_URL을 읽어들이기 때문에, LLM 백엔드를 Novita AI의 API와 더 넓은 모델 선택으로 전환하려면 단일 환경 변수 변경만 하면 됩니다.
VS Code 확장 프로그램의 실제 기능
Claude Code VS Code 확장 프로그램은 에디터에 부착된 채팅 탭이 아닙니다. 사이드바 패널에 전체 Claude Code 에이전트를 표시합니다. 동일한 REPL 스타일 인터페이스, 동일한 도구 세트, 동일한 세션 연속성을 제공합니다. 함수를 리팩터링하거나 열려 있는 파일의 테스트를 작성하도록 요청하면, 해당 파일을 작업 공간에서 직접 읽고 편집합니다. 클립보드가 필요 없습니다.
확장 프로그램이 처리하는 구체적인 작업:
- 인라인 diff가 포함된 다중 파일 편집. Claude Code가 변경 사항을 제안하고, 에디터를 벗어나지 않고 수락하거나 거부할 수 있는 diff를 보여줍니다.
- 슬래시 명령어.
/compact,/init,/memory,/clear등이 CLI와 동일하게 작동합니다. - 컨텍스트 고정.
#접두사를 사용하여 특정 파일, 폴더 또는 심볼을 요청의 컨텍스트로 첨부할 수 있습니다. - CLAUDE.md 인식.
CLAUDE.md에 작성한 프로젝트 지침과 코딩 표준이 세션 시작 시 자동으로 로드됩니다. - MCP 도구 호출. Claude Code 구성에 등록된 모든 MCP 서버를 확장 프로그램 내에서 사용할 수 있습니다.
제공하지 않는 기능: 에디터 버퍼에 AI 자동 완성 기능을 추가하지 않습니다. 이러한 기능은 Copilot이나 Cline 같은 도구가 담당합니다. VS Code의 Claude Code는 에이전트입니다. 작업을 할당하면 여러 단계를 실행하며, 단일 인라인 완성이 아닙니다.
VS Code에 Claude Code 설치하기
VS Code에서 확장 프로그램 패널을 엽니다(Ctrl+Shift+X Windows/Linux, Cmd+Shift+X macOS). Claude Code 를 검색하고 Anthropic 이 게시한 확장 프로그램을 찾습니다. Install 을 클릭합니다.
또는 터미널에서 다음 명령어를 실행합니다:
code --install-extension Anthropic.claude-code
설치 후, Claude 아이콘이 VS Code 왼쪽 Activity Bar에 나타납니다. 클릭하여 Claude Code 패널을 엽니다.
첫 실행 인증. 확장 프로그램이 로그인을 요청합니다. 두 가지 방법이 있습니다:
- Anthropic 계정(구독 또는 콘솔 결제): 브라우저 OAuth 흐름을 진행합니다.
- Novita AI로 API 키 라우팅: Anthropic 인증을 건너뜁니다. VS Code를 실행하기 전에 환경 변수에
ANTHROPIC_BASE_URL과ANTHROPIC_AUTH_TOKEN을 설정하면, 확장 프로그램이 대신 이를 사용합니다. 자세한 지침은 다음 섹션에 있습니다.
자동 업데이트. VS Code는 에디터를 다시 시작할 때 백그라운드에서 확장 프로그램을 업데이트합니다. 수동으로 버전을 관리할 필요가 없습니다.
VS Code에서 Claude Code 일상적으로 사용하기
패널이 열리면 워크플로는 간단합니다. 요청을 입력하면 Claude Code가 작업 공간을 읽고 제안된 작업으로 응답합니다. 파일을 편집하기 전에 기본적으로 diff를 표시하고 승인을 기다립니다.
일상적인 사용을 효율적으로 만드는 몇 가지 패턴:
현재 보고 있는 파일 참조. 파일 이름 뒤에 #을 입력하여 명시적으로 컨텍스트로 첨부합니다. 활성 에디터에서 이미 열려 있는 파일의 경우 Claude Code가 일반적으로 자동으로 인식하지만, 다중 파일 작업에서 특정 파일을 고정하려면 #이 유용합니다.
새 프로젝트에서 /init을 한 번 실행. 이 명령어는 저장소 루트에 CLAUDE.md를 생성하며, 여기에 프로젝트별 지침(선호 라이브러리, 아키텍처 노트, 테스트 규칙 등)을 저장할 수 있습니다. Claude Code는 모든 세션 시작 시 이를 읽어서 같은 내용을 반복하지 않아도 됩니다.
세션이 길어지면 /compact 사용. CLI와 마찬가지로 확장 프로그램은 필요에 따라 대화 기록을 압축하여 현재 작업의 컨텍스트를 확보합니다.
실행 중인 도구 목록 확인. 패널 하단에서 VS Code는 Claude Code가 현재 호출 중인 도구(파일 읽기, bash 명령, 웹 검색 등)를 표시합니다. 이는 긴 자동화 작업에서 무슨 일이 일어나고 있는지 이해하는 데 유용합니다.
실행 취소는 친구입니다. 모든 파일 편집은 표준 VS Code 파일 시스템을 통해 이루어지므로, Ctrl+Z를 사용하면 수동 편집처럼 되돌릴 수 있습니다. Claude Code 변경 사항을 위한 별도의 실행 취소 스택은 없습니다.
확장 프로그램을 Novita AI로 라우팅하기
VS Code 확장 프로그램은 시작 시 환경 변수에서 ANTHROPIC_BASE_URL을 읽습니다. 이는 CLI에서 사용하는 동일한 변수입니다. 이를 Novita AI의 Anthropic 호환 엔드포인트로 설정하면 모든 API 호출이 Anthropic 서버가 아닌 Novita로 전달됩니다. Novita AI의 인프라에서 DeepSeek, Kimi K2, Qwen, GLM 및 기타 모델에 액세스할 수 있으며, Novita의 토큰 요금제로 청구됩니다.
Novita AI API 키 받기
Novita AI 계정에 가입하여 무료 체험 크레딧을 받으세요. 키 관리로 이동하여 새 키를 만들고 복사합니다. 이 키는 Novita를 통해 라우팅할 때 Anthropic API 키를 대체합니다.
VS Code 실행 전 환경 변수 설정
macOS 및 Linux — 셸 프로필(.zshrc, .bashrc 또는 이에 상응하는 파일)에 다음을 추가한 후 다시 로드합니다:
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Your Novita API Key>"
export ANTHROPIC_MODEL="deepseek/deepseek-v4-flash"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek/deepseek-v4-flash"
source ~/.zshrc # 또는 ~/.bashrc
Windows(영구적 — 재시작 후에도 유지) — PowerShell을 사용하여 사용자 수준 환경 변수를 설정합니다:
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.novita.ai/anthropic","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","<Your Novita API Key>","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL","deepseek/deepseek-v4-flash","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL","deepseek/deepseek-v4-flash","User")
이 변수를 설정한 후 VS Code를 다시 시작하면 확장 프로그램이 업데이트된 환경을 읽습니다.
Windows(세션 전용):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Your Novita API Key>
set ANTHROPIC_MODEL=deepseek/deepseek-v4-flash
set ANTHROPIC_SMALL_FAST_MODEL=deepseek/deepseek-v4-flash
이것들을 설정한 후, 동일한 셸에서 VS Code를 실행합니다. 확장 프로그램은 시작 시 변수를 읽습니다. Anthropic에 로그인할 필요가 없습니다. Novita가 API 키를 통해 인증을 처리합니다.
모델 선택
ANTHROPIC_MODEL은 Claude Code가 주요 작업에 사용할 모델을 지정하고, ANTHROPIC_SMALL_FAST_MODEL은 파일 요약과 같은 백그라운드 작업을 제어합니다. Novita AI의 LLM API에서 사용 가능한 모든 모델을 여기에 설정할 수 있습니다. Novita에서 Claude Code와 함께 자주 사용되는 모델로는 DeepSeek V4 Flash, Kimi K2, GLM-4.6 등이 있으며, 각각 컨텍스트 창 크기, 가격, 성능 특성이 작업 부하에 따라 다릅니다.
기본 Anthropic 라우팅으로 되돌리려면 환경 변수를 해제합니다:
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL ANTHROPIC_SMALL_FAST_MODEL
또는 해당 변수가 설정되지 않은 셸에서 VS Code를 실행합니다.
PyCharm 및 JetBrains 통합
Claude Code는 JetBrains 플랫폼용 공식 플러그인을 제공하며, 이는 PyCharm, IntelliJ IDEA, WebStorm, GoLand, Rider 및 나머지 JetBrains 제품군을 지원합니다.
플러그인 설치
JetBrains IDE에서 Settings → Plugins 로 이동한 후 Marketplace 탭으로 전환하고 Claude Code 를 검색합니다. Install 을 클릭한 다음, 메시지가 표시되면 IDE를 다시 시작합니다.
또는 JetBrains Marketplace 웹사이트에서 플러그인 파일을 다운로드하여 Settings → Plugins → Install Plugin from Disk 를 통해 설치합니다.
첫 실행
설치 후, Claude Code 패널이 레이아웃에 따라 IDE 사이드바 또는 도구 창 영역에 나타납니다. 첫 실행 시 VS Code와 동일한 인증 절차가 진행됩니다.
PyCharm을 Novita AI로 라우팅
JetBrains 플러그인은 VS Code 확장 프로그램 및 CLI와 동일한 환경 변수를 읽습니다. IDE를 실행하기 전에 셸 프로필에서 ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL, ANTHROPIC_SMALL_FAST_MODEL을 설정하면 플러그인이 Novita를 통해 라우팅됩니다.
터미널이 아닌 데스크톱 런처에서 PyCharm을 실행하는 경우(macOS 및 Linux에서 흔함), IDE가 셸 환경을 상속하지 않을 수 있습니다. 신뢰할 수 있는 해결 방법은 프로젝트별 .env 파일을 사용하거나 셸 프로필이 아닌 시스템 수준 환경에 변수를 설정하는 것입니다. 특히 macOS에서는 launchctl setenv를 통해 설정된 변수가 GUI 애플리케이션에 표시됩니다.
IDE 확장 프로그램 vs. CLI: 언제 무엇을 사용할지
확장 프로그램과 CLI는 동일한 엔진을 공유합니다. 실질적인 차이는 컨텍스트와 통합 방식입니다.
| VS Code / JetBrains 확장 프로그램 | CLI | |
|---|---|---|
| 파일 탐색 | 클릭하여 열기, #으로 참조 |
CWD에서 읽기, 경로를 명시적으로 지정 |
| Diff 검토 | 에디터에서 인라인 | 터미널 출력 |
| 여러 프로젝트 | 창당 하나의 패널 | 디렉터리당 별도 세션 |
| CI/CD 및 자동화 | 부적합 | -p 플래그로 비대화형 배치 실행 |
| 파이핑 및 스크립팅 | 지원되지 않음 | 전체 Unix 파이프 지원 |
| Novita AI 라우팅 | ANTHROPIC_BASE_URL 환경 변수 |
동일 |
확장 프로그램은 주 워크플로가 대화형으로 코드를 편집하는 경우 더 나은 선택입니다. CLI는 작업을 자동화하거나, 스크립트에서 Claude Code를 실행하거나, CI와 통합하거나, Claude Code SDK 위에 구축하는 경우 적합합니다.
Novita AI의 에이전트 샌드박스
대화형 개발에서 자동화된 파이프라인(Claude Code 에이전트를 헤드리스로 실행, 여러 저장소에 대해 여러 에이전트 실행, 평가 도구 구축 등)으로 전환하는 경우, Novita AI의 Agent Sandbox는 에이전트를 프로그래밍 방식으로 실행하기 위한 격리된 실행 환경을 제공합니다. 각 샌드박스는 firecracker 기반 VM이므로, 에이전트가 개발 머신에 영향을 주지 않고 격리된 상태로 실행됩니다.
FAQ
VS Code 확장 프로그램을 사용하려면 유료 Anthropic 구독이 필요한가요?
아니요. ANTHROPIC_BASE_URL을 통해 확장 프로그램을 Novita AI로 라우팅하면 모든 요금이 Novita AI 계정을 통해 청구됩니다. Anthropic 계정은 필요하지 않으며 청구되지도 않습니다.
Claude Code VS Code 확장 프로그램을 어떻게 설치하나요?
VS Code에서 확장 프로그램 패널(Ctrl+Shift+X)을 열고 Claude Code(게시자: Anthropic)를 검색한 후 Install을 클릭합니다. 또는 터미널에서 code --install-extension Anthropic.claude-code를 실행합니다.
Claude Code 확장 프로그램이 Cursor에서 작동하나요?
Cursor는 VS Code 포크이며 대부분의 VS Code 확장 프로그램을 지원합니다. Claude Code 확장 프로그램이 설치될 수는 있지만, Cursor는 자체 내장 Claude 통합 기능을 이미 제공합니다. 두 가지를 동시에 실행하면 중복 제안과 충돌하는 인증 흐름이 발생할 수 있습니다. 대부분의 개발자는 둘 중 하나만 사용합니다.
Claude 브라우저 확장 프로그램이 있나요?
Anthropic의 공식 Claude 브라우저 확장 프로그램은 없습니다. Claude Code는 VS Code 확장 프로그램, JetBrains 플러그인, CLI, 데스크톱 앱, 그리고 claude.ai/code의 웹 인터페이스로 실행되지만, 임의의 웹 페이지에 연결되는 브라우저 확장 프로그램으로는 제공되지 않습니다.
VS Code를 다시 시작하지 않고 모델을 전환하려면 어떻게 하나요?
셸 프로필에서 ANTHROPIC_MODEL을 변경한 후, 새 터미널 세션에서 VS Code를 다시 엽니다. 실행 중인 VS Code 세션 내에서는 패널 내 모델 전환기가 없습니다. 환경 변수는 시작 시에만 읽힙니다.
프로젝트마다 다른 모델을 사용할 수 있나요?
네. 프로젝트 수준의 .env 파일이나 CLAUDE.md 지침에 ANTHROPIC_MODEL을 설정하거나, direnv를 사용하여 특정 디렉터리로 환경 변수를 범위 지정합니다. Claude Code는 세션 수준에서 환경 값을 인식하므로, 표준 dotfile 도구를 사용하여 프로젝트별 라우팅이 가능합니다.
claude를 vscode와 통합하는 것이 Cline을 사용하는 것과 어떻게 다른가요?
Cline은 VS Code를 모든 OpenAI 호환 백엔드를 사용하는 에이전트 코딩 환경으로 전환하는 확장 프로그램입니다. Claude Code는 Anthropic 자체 에이전트로, VS Code 확장 프로그램으로 제공되며 자체 도구 세트와 추론 루프를 갖추고 있습니다. 주요 실질적 차이점: Cline은 루프를 실행할 공급자와 모델을 더 많이 제어할 수 있는 반면, Claude Code는 기본적으로 Claude 모델 제품군과 긴밀하게 통합되어 있습니다. 다만 ANTHROPIC_BASE_URL을 통해 Novita AI의 호환 엔드포인트로 리디렉션할 수 있습니다.
추천 문서
