Claude Code는 VS Code에서 사이드바의 풀 코딩 에이전트로 제공됩니다. 단순한 자동 완성 도구가 아니라, 프로젝트를 읽고, 파일을 수정하고, 명령을 실행하는 다단계 문제 해결사입니다. VS Code 확장 프로그램은 CLI와 엔진을 공유하므로 슬래시 명령, CLAUDE.md 인식, MCP 도구 호출 모두 터미널에서 사용하는 것과 동일하게 작동합니다. 이 설정을 이해해야 하는 이유는 백엔드 계층 때문입니다. 모든 추론 호출은 사용자가 제어하는 엔드포인트를 통해 이루어지며, 그 엔드포인트를 Novita AI로 라우팅하면 Claude 모델뿐만 아니라 더 넓은 오픈소스 코딩 대안 카탈로그에도 접근할 수 있습니다. 대규모 에이전트 작업을 실용적으로 만드는 가격으로 말이죠.
Claude Code가 VS Code에서 하는 일
Claude Code VS Code 확장 프로그램은 인라인 자동 완성 엔진이 아닌 사이드바 패널입니다. 패널을 열고 작업을 설명하면 Claude Code가 다단계 작업을 수행합니다. 파일 읽기, 변경 사항 작성, 셸 명령 실행, 그리고 적용 전에 diff에 대한 승인을 기다리는 것까지요. 이 구분이 중요한 이유는 개발자들이 흔히 “claude code vs code”를 검색하면서 Copilot 스타일의 경험, 즉 입력하는 대로 완성되는 한 줄 제안을 기대하기 때문입니다. 하지만 이 도구는 그런 것이 아닙니다. 자동 완성은 다른 도구가 담당합니다. VS Code의 Claude Code는 작업을 위한 도구입니다. 이 모듈의 테스트를 작성하세요, 인증 핸들러를 리팩터링하세요, 이 쿼리가 왜 느린지 설명하세요, 오늘의 변경 사항으로 풀 리퀘스트를 생성하세요.
확장 프로그램 내 구체적인 기능:
- 여러 파일 편집 및 인라인 diff. Claude Code는 여러 파일에 걸친 변경 사항을 제안하고, 편집기를 벗어나지 않고 수락하거나 거부할 수 있는 diff를 표시합니다.
- 슬래시 명령.
/compact,/clear,/init,/memory, 그리고 직접 정의한 사용자 지정 슬래시 명령은 모두 CLI와 동일하게 작동합니다. - 컨텍스트 고정.
#접두사는 특정 파일, 기호 또는 폴더를 요청에 첨부합니다.#src/auth/handler.ts fix the race condition라고 입력하면 Claude Code가 즉시 올바른 컨텍스트를 얻습니다. - CLAUDE.md 인식. 프로젝트 코딩 표준, 아키텍처 노트, 선호 라이브러리 —
CLAUDE.md에 있는 모든 내용이 세션 시작 시 로드됩니다. 한 번 작성하면 에이전트가 모든 세션에서 이를 준수합니다. - MCP 도구 호출. Claude Code 구성에 등록된 MCP 서버는 확장 프로그램 패널 내에서 사용할 수 있습니다.
확장 프로그램이 하지 않는 일: 기존 편집기 키 바인딩을 대체하거나, 구문 강조를 수정하거나, 키 입력마다 완성을 추가하지 않습니다. 일반 VS Code 워크플로 위에 얹히는 에이전트 인터페이스입니다.
VS Code에 Claude Code 추가하는 방법
확장 프로그램 패널을 엽니다 (Windows/Linux에서는 Ctrl+Shift+X, macOS에서는 Cmd+Shift+X). Claude Code 를 검색하고 게시자 Anthropic 을 찾습니다. ** 설치** 를 클릭합니다.
명령줄을 선호한다면:
code --install-extension Anthropic.claude-code
설치 후, Claude 아이콘이 VS Code 왼쪽의 Activity Bar에 나타납니다. 그것을 클릭하여 에이전트 패널을 엽니다.
첫 실행 인증. 확장 프로그램은 처음 열 때 로그인을 요청합니다. 두 가지 방법이 있습니다.
- Anthropic 계정: 브라우저 OAuth 흐름 — Anthropic Console API 키 또는 활성 Claude 구독이 있으면 작동합니다.
- Novita AI API 키: VS Code를 해당 터미널에서 실행하기 전에 셸 환경에
ANTHROPIC_BASE_URL및ANTHROPIC_AUTH_TOKEN을 설정하세요. 확장 프로그램은 시작 시 이를 읽고 Anthropic 로그인을 완전히 우회합니다. 자세한 내용은 다음 섹션에서 설명합니다.
VS Code는 확장 프로그램을 백그라운드에서 자동으로 업데이트합니다. 버전을 수동으로 추적할 필요가 없습니다.
LLM API 백엔드 작동 방식
3계층 아키텍처를 이해하면 모든 구성 결정이 더 명확해집니다.
- UI 계층: VS Code 확장 프로그램 (또는 CLI, 또는 데스크톱 앱 — 서로 교체 가능한 표면입니다).
- 에이전트 로직 계층: Claude Code 엔진 — 도구 정의, 세션 관리, 파일 읽기, 명령 실행.
- LLM API 계층: 모든 언어 모델 호출을 처리하는 추론 엔드포인트.
기본적으로 LLM API 계층은 api.anthropic.com 을 가리킵니다. Claude Code는 Anthropic Messages API 형식을 사용하여 요청을 보냅니다. 중요한 세부 사항: ANTHROPIC_BASE_URL 은 모든 요청을 Anthropic 호환 엔드포인트로 리디렉션합니다. Novita AI는 https://api.novita.ai/anthropic 에서 동일한 Messages API 형식을 제공하므로 에이전트 로직 계층에는 전환이 투명합니다. Claude Code는 응답이 Anthropic 서버에서 왔는지 Novita 서버에서 왔는지 알지 못하고 신경 쓰지 않습니다.
세 가지 환경 변수만 추가로 설정하면 구성이 완료됩니다.
ANTHROPIC_AUTH_TOKEN— 선택한 공급자의 API 키.ANTHROPIC_MODEL— 기본 작업에 사용할 모델 ID.ANTHROPIC_SMALL_FAST_MODEL— 요약 및 컨텍스트 압축 같은 빠른 백그라운드 작업용 모델 ID.
VS Code를 실행하기 전에 이 변수들을 설정하면 확장 프로그램이 셸 환경에서 이를 상속받습니다.
Claude Code를 Novita AI에 연결하기
1단계: Novita AI API 키 받기
novita.ai 에서 가입하고 Key Management 페이지로 이동하세요. 새 키를 생성하고 즉시 복사하세요. 다시 표시되지 않습니다.
2단계: 환경 변수 설정
macOS 또는 Linux에서는 VS Code를 실행하기 전에 터미널에서 변수를 내보냅니다.
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<your-novita-api-key>"
export ANTHROPIC_MODEL="zai-org/glm-4.6"
export ANTHROPIC_SMALL_FAST_MODEL="zai-org/glm-4.6"
Windows(명령 프롬프트)에서는:
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<your-novita-api-key>
set ANTHROPIC_MODEL=zai-org/glm-4.6
set ANTHROPIC_SMALL_FAST_MODEL=zai-org/glm-4.6
그런 다음 동일한 터미널 세션에서 VS Code를 실행합니다:
code .
3단계: 연결 확인
Claude Code 패널을 열고 짧은 테스트 메시지를 보내세요. 확장 프로그램이 응답을 반환하면 라우팅이 작동하는 것입니다. 이제부터 요금은 Novita AI를 통해 청구됩니다. Anthropic 계정에는 요금이 부과되지 않습니다.
구성을 영구적으로 적용하려면 내보내기 명령을 셸 프로필 (~/.zshrc, ~/.bashrc 또는 이에 상응하는 파일)에 추가하거나, 프로젝트별 모델 전환을 위해 direnv 로 관리하는 프로젝트 수준 .env 파일을 사용하세요.
폐쇄형 소스 코딩 성능에 맞먹는 오픈소스 모델
Novita AI를 통해 라우팅하기 시작하면 Claude 모델에 제한되지 않습니다. Novita의 LLM 카탈로그에는 에이전트 코딩 작업에 중요한 벤치마크에서 폐쇄형 소스 대안과 직접 경쟁하는 오픈소스 코딩 모델이 포함되어 있습니다.
Zhiyu AI의 GLM-4.6 이 실용적인 예입니다. 200K 토큰 컨텍스트 윈도우를 제공하며 실제 코딩 평가에서 Claude Sonnet 4를 상대로 48.6%의 승률을 기록합니다. 긴 컨텍스트가 중요한 에이전트 워크플로(대규모 코드베이스 디버깅, 전체 테스트 스위트 읽기)에서 이 컨텍스트 윈도우는 단순한 사양 수치가 아니라 실질적인 이점입니다. Novita 모델 ID는 zai-org/glm-4.6 입니다.
Novita 플랫폼에서 코딩 워크로드로 평가할 만한 다른 모델로는 DeepSeek R1과 Qwen 3 Coder가 있습니다. 두 모델 모두 코드 생성 및 지시 수행 벤치마크에서 경쟁력 있는 성능을 입증했습니다. 동일한 ANTHROPIC_MODEL 환경 변수로 모델을 전환할 수 있습니다. 재설치나 새 통합이 필요 없습니다.
오픈소스의 비용 측면: 대규모로 Claude Code를 실행하는 팀, 즉 CI 파이프라인에서 수많은 에이전트 실행, 공유 Novita API 키를 사용하는 다중 개발자 환경, 상당한 토큰을 소비하는 긴 에이전트 세션을 운영하는 팀은 Novita의 가격으로 제공되는 오픈소스 모델이 인프라 예산에 실질적인 여유를 만들어 준다는 것을 발견합니다. Claude Sonnet 4의 90% 성능을 40% 비용으로 제공하는 모델은 에이전트를 지속적으로 실행하는 경제를 바꿉니다.
실행 환경으로서의 Novita Agent Sandbox
VS Code의 Claude Code는 로컬에서 셸 명령을 실행할 수 있습니다. 프로젝트를 빌드하고, 테스트를 실행하고, 패키지를 설치하고, 머신에 파일을 생성합니다. 대부분의 일상적인 작업에는 충분합니다. 그러나 일부 에이전트 작업은 격리된 컴퓨팅 환경에서 처리하는 것이 더 좋습니다. 머신을 막는 무거운 테스트 스위트, 시스템 패키지를 설치하는 빌드 단계, 시스템 구성을 수정하는 명령, 또는 재현성이 필요한 병렬 에이전트 실행과 같은 작업입니다.
Novita Agent Sandbox 는 이 사용 사례를 위해 특별히 구축된 클라우드 실행 환경을 제공합니다. 샌드박스는 밀리초 단위로 시작되는 마이크로VM으로, 호스트 시스템과 격리된 상태에서 코드를 실행하고 작업이 끝나면 깨끗하게 종료됩니다. 잔여 상태가 없고, 로컬 환경에 영향을 주지 않으며, 머신의 CPU가 회복될 때까지 기다릴 필요가 없습니다.
Claude Code 사용자를 위한 실용적인 워크플로는 다음과 같습니다. 언어 모델 호출은 Novita AI의 LLM 엔드포인트로 라우팅하고, 무거운 실행 작업(빌드, 테스트 실행, 코드 평가)은 Novita Agent Sandbox API 를 통해 Agent Sandbox 인스턴스를 실행합니다. 두 서비스는 동일한 인증(같은 Novita API 키)을 공유하므로 별도의 자격 증명 관리가 필요 없습니다.
자동화된 코드 리뷰 파이프라인이나 CI 통합 Claude Code 에이전트를 구축하는 팀은 이 조합이 특히 유용하다는 것을 알게 됩니다. LLM 비용은 Novita의 토큰당 요금제로 예측 가능하게 유지되고, 컴퓨팅 비용은 Agent Sandbox의 초당 요금제로 예측 가능하게 유지됩니다.
일상적인 VS Code 워크플로 팁
확장 프로그램을 단순한 호기심이 아니라 실용적으로 만들어 주는 몇 가지 패턴입니다.
/init 으로 새 프로젝트 시작하기. 새 저장소에서 /init 을 실행하면 CLAUDE.md 시작 파일이 생성됩니다. Claude Code가 편집을 시작하기 전에 프로젝트 규칙을 알려주는 가장 효율적인 방법입니다.
# 로 컨텍스트 고정하기. 어떤 파일을 볼지 설명하는 대신 #filename 을 입력하여 직접 첨부하세요. 리팩터링 작업의 경우 #src/components/Button.tsx update the onClick handler to use the new event type 라고 입력하는 것이 “Button 컴포넌트를 보고…”라고 설명하는 것보다 빠릅니다.
/compact 를 적극적으로 사용하기. 긴 세션에서는 Claude Code가 컨텍스트를 축적합니다. /compact 는 대화를 요약하고 토큰 오버헤드를 줄입니다. 주요 작업을 마친 후, 다음 작업을 시작하기 전에 실행하세요.
diff를 인라인으로 수락하거나 거부하기. Claude Code가 파일을 편집하기 전에 패널에 diff를 표시합니다. 모든 변경을 수락할 필요는 없습니다. 부분적인 diff를 거부하고 수정된 접근 방식을 요청하세요. 모든 응답을 최종 답변이 아닌 시작점으로 취급하면 더 나은 결과를 얻을 수 있습니다.
프로젝트 지시사항과 세션 지시사항을 분리하기. CLAUDE.md 는 안정적인 프로젝트 컨텍스트(빌드 명령, 아키텍처, 코드 스타일)를 위한 것입니다. 현재 작업에 대한 임시 지시사항은 세션 프롬프트에 넣으세요. CLAUDE.md 를 단일 작업 지침으로 복잡하게 만들지 마세요.
자주 묻는 질문
Claude Code VS Code 확장 프로그램 문서는 어디에 있나요?
공식 확장 프로그램 문서는 Anthropic에서 claude.ai/code 에서 관리합니다. 릴리스 노트와 변경 로그는 VS Code 확장 프로그램 패널의 Claude Code 목록에서 확인할 수 있습니다.
Claude Code VS Code 확장 프로그램은 무료인가요?
확장 프로그램 자체는 무료로 설치할 수 있습니다. 사용 비용은 백엔드 구성에 따라 달라집니다. Anthropic 계정을 사용하면 토큰당 요금을 지불하거나 구독 크레딧을 사용합니다. Novita AI 라우팅을 사용하면 Novita의 토큰당 요금을 지불하며 Anthropic 요금은 부과되지 않습니다. 새 Novita 계정에는 가입 시 무료 체험 크레딧이 제공됩니다.
VS Code 확장 프로그램과 Claude Code CLI를 동시에 사용할 수 있나요?
네, 하지만 별도의 세션으로 실행됩니다. VS Code 확장 프로그램은 열려 있는 CLI 인스턴스와 라이브 세션을 공유하지 않습니다. 두 도구 간에 세션 연속성이 필요하면 CLI에서 claude -c 를 사용하여 해당 디렉터리의 가장 최근 세션을 재개하세요.
VS Code에서 Claude Code와 Cline의 차이점은 무엇인가요?
Cline은 모든 OpenAI 호환 백엔드를 통해 에이전트 작업을 라우팅하는 VS Code 확장 프로그램입니다. 최대한의 공급자 유연성을 제공하지만 더 많은 구성이 필요합니다. Claude Code는 긴밀하게 통합된 도구 세트를 갖춘 Anthropic의 자체 에이전트입니다. ANTHROPIC_BASE_URL 리디렉션은 실제로 Claude Code에도 유사한 백엔드 유연성을 제공합니다. 이미 Claude Code용으로 Novita AI를 설정했다면 Novita의 모델 카탈로그에 접근하기 위해 별도의 Cline 설치가 필요 없습니다.
프로젝트마다 다른 모델을 사용할 수 있나요?
네. direnv 와 프로젝트 수준 .env 파일을 사용하여 ANTHROPIC_MODEL 을 특정 디렉터리로 범위를 지정하세요. direnv가 활성화된 터미널에서 해당 프로젝트를 VS Code로 열면 확장 프로그램이 프로젝트별 모델 설정을 상속받습니다.
Novita AI 는 개발자에게 간단한 API로 AI 모델을 배포할 수 있는 쉬운 방법을 제공하고, 빌드와 확장을 위한 저렴하고 안정적인 GPU 클라우드도 제공하는 AI 클라우드 플랫폼입니다.
