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에서 확장 패널을 엽니다. (Windows/Linux: Ctrl+Shift+X, macOS: Cmd+Shift+X). Claude Code 를 검색하고 Anthropic 에서 게시한 확장을 찾습니다. Install 을 클릭합니다.
또는 터미널에서 다음 명령어를 실행합니다:
code --install-extension Anthropic.claude-code
설치 후, VS Code Activity Bar 왼쪽에 Claude 아이콘이 나타납니다. 클릭하여 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 서버를 거치지 않게 됩니다. Kimi K2.7 Code, GLM 5.2, DeepSeek V4 Pro, MiniMax M3 등 현재 Novita에서 호스팅하는 코딩 및 도구 사용 모델에 접근할 수 있으며, Novita AI 계정을 통해 Novita의 토큰 요금제로 청구됩니다.
Novita AI API 키 받기
Novita AI 계정에 가입하여 무료 체험 크레딧을 받으세요. Key Management로 이동하여 새 키를 생성하고 복사합니다. 이 키는 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="moonshotai/kimi-k2.7-code"
export ANTHROPIC_SMALL_FAST_MODEL="minimax/minimax-m3"
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","moonshotai/kimi-k2.7-code","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL","minimax/minimax-m3","User")
설정 후 VS Code를 재시작하여 확장이 업데이트된 환경을 읽도록 합니다.
Windows (세션만 해당):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Your Novita API Key>
set ANTHROPIC_MODEL=moonshotai/kimi-k2.7-code
set ANTHROPIC_SMALL_FAST_MODEL=minimax/minimax-m3
설정 후, 동일한 셸에서 VS Code를 실행합니다. 확장은 시작 시 변수를 읽어들입니다. Anthropic에 로그인할 필요가 없습니다. Novita가 API 키를 통해 인증을 처리합니다.
모델 선택하기
ANTHROPIC_MODEL은 Claude Code가 주요 작업에 사용할 모델을 지정합니다. ANTHROPIC_SMALL_FAST_MODEL은 파일 요약과 같은 백그라운드 작업을 제어합니다. Novita AI의 LLM API에서 사용 가능한 모든 모델을 여기에 설정할 수 있습니다. Novita에서 Claude Code와 함께 자주 사용되는 모델:
- Kimi K2.7 Code — 에이전트 방식 IDE 작업을 위한 Novita의 현재 코딩 최우선 추천 모델로, 강력한 저장소 수준 추론, 코드 편집 및 긴 다단계 실행을 제공합니다.
- GLM 5.2 — 코드베이스 분석, 문서, 코딩 및 글쓰기 워크플로우 혼합 작업에서 더 강력한 일반 추론과 큰 컨텍스트 윈도우가 필요할 때 적합한 선택입니다.
- DeepSeek V4 Pro — 가장 비싼 등급으로 뛰어오르지 않고 깊이 있는 복잡한 구현 작업이 필요할 때 균형 잡힌 옵션입니다.
- MiniMax M3 —
ANTHROPIC_SMALL_FAST_MODEL을 위한 비용 효율적인 동반자로, 특히 빠른 요약, 검색 중심 루프 및 도구 호출 워크플로우에 적합합니다.
대부분의 대화형 VS Code 사용에서 ANTHROPIC_MODEL을 Kimi K2.7 Code로, ANTHROPIC_SMALL_FAST_MODEL을 MiniMax M3로 설정하면 코딩 품질, 도구 사용 신뢰성 및 비용 관리의 실용적인 균형을 얻을 수 있습니다.
기본 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 위에 구축할 때 적합합니다. 구체적으로 터미널 우선 코딩 에이전트를 비교하려면 OpenAI Codex vs Claude Code에서 CLI 대 CLI 심층 비교를 확인하세요.
Novita AI의 Agent Sandbox
대화형 개발에서 자동화된 파이프라인으로 이동할 때, VS Code 확장은 더 이상 적절한 도구가 아닙니다. Claude Code를 헤드리스로 실행하는 경우(배치 PR 리뷰, 자동화된 테스트 생성, 다중 저장소 리팩토링, CI 통합 코딩 에이전트)는 로컬 IDE 세션이 아닌 격리된 실행 환경이 필요합니다.
Novita AI의 Agent Sandbox는 에이전트를 프로그래밍 방식으로 실행하기 위한 firecracker 기반 마이크로VM을 제공합니다. 각 샌드박스는 깨끗한 상태로 시작하여 개발 머신과 완전히 격리된 상태에서 실행되며, 사용 시간(초) 단위로 청구됩니다. 실제 사용 사례:
- 배치 PR 리뷰. PR당 하나의 샌드박스를 생성하고, 리뷰 프롬프트로 Claude Code를 실행한 후 출력을 수집하고 샌드박스를 종료합니다. 실행 간에 로컬 상태가 누적되지 않습니다.
- 자동화된 테스트 생성. CI에서 새 브랜치에 대해 샌드박스를 트리거하고, Claude Code가 diff를 읽고 테스트를 생성한 후, 저장소 API를 통해 결과를 커밋합니다.
- 평가 도구. 병렬 샌드박스에서 여러 모델 구성을 사용하여 동일한 코딩 작업을 실행합니다. 각 샌드박스는 로컬에서 설정한 것과 동일한
ANTHROPIC_BASE_URL라우팅을 사용합니다. 샌드박스별로ANTHROPIC_MODEL을 변경하여 실제 작업에서 Kimi K2.7 Code, GLM 5.2, DeepSeek V4 Pro, MiniMax M3를 서로 비교할 수 있습니다. - 다중 에이전트 워크플로우. 샌드박스는 구성 가능합니다. 각 하위 에이전트는 자체 격리된 환경을 얻습니다. 결과는 에이전트가 다른 에이전트의 파일 시스템에 접근하지 않고 상위에서 집계됩니다.
VS Code와 Sandbox 사용 간의 인터페이스는 동일한 환경 변수 계층입니다. 확장에서 Novita AI의 Anthropic 호환 엔드포인트를 통해 라우팅하는 워크플로우는 코드 변경 없이 샌드박스에서 헤드리스로 작동합니다.
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은 모든 OpenAI 호환 백엔드를 사용하여 VS Code를 에이전트 방식 코딩 환경으로 전환하는 확장입니다. Claude Code는 Anthropic의 자체 에이전트로, VS Code 확장으로 제공되며 자체 도구 세트와 추론 루프를 갖추고 있습니다. 주요 실질적 차이점: Cline은 루프를 실행할 공급자와 모델을 더 자유롭게 제어할 수 있는 반면, Claude Code는 기본적으로 Claude 모델 제품군과 긴밀하게 통합되어 있습니다. 다만 ANTHROPIC_BASE_URL을 통해 Novita AI의 호환 엔드포인트로 리디렉션할 수 있습니다.
추천 문서
