Claude Code VS Code 확장 프로그램 설치
검색할 항목: Claude Code 확장 프로그램 보기에서 Anthropic이 제공하는 항목을 검색하거나, 다음을 붙여 넣으세요: vscode:extension/anthropic.claude-code 브라우저에 붙여 넣으면 바로 열 수 있습니다. 확장 프로그램은 CLI의 프런트엔드입니다. 처음 실행할 때 다음 바이너리가 있는지 확인합니다: claude 바이너리가 없으면 설치합니다(npm 방식에는 Node.js 18 이상이 필요하며, 네이티브 설치 프로그램에는 별도 요구 사항이 없습니다). 이후 활동 표시줄의 Claude 아이콘을 누르면 대화할 수 있는 패널이 열리고, 에이전트가 변경한 내용은 모두 수락하거나 거부할 수 있는 인라인 diff로 표시됩니다. 터미널과 같은 작업 흐름이며, 편집기에서 변경 사항을 검토합니다.
# check the CLI the extension will use
claude --version
# if it is missing, install it yourself and reload VS Code
npm install -g @anthropic-ai/claude-code # or: curl -fsSL https://claude.ai/install.sh | bash확장 프로그램 없이 사용하기: 통합 터미널의 Claude Code
VS Code의 터미널을 열고 다음을 실행하세요: claude. 계획 모드, 하위 에이전트, 훅, MCP를 갖춘 완전한 에이전트입니다: /compact — 확장 프로그램 없이 Cursor와 VSCodium을 포함한 모든 VS Code 포크에서 작동합니다. 편집 내용은 열려 있는 파일에 즉시 반영되며, VS Code 자체 diff 보기에서 확인할 수 있습니다. 긴 자율 작업에는 대부분 이 방식을 선호하고, 작은 대화형 편집에는 확장 프로그램 패널이 더 편리합니다. 두 방식을 동시에 실행할 수도 있습니다.
VS Code에서 Claude Code가 사용하는 계정 확인
확장 프로그램과 터미널은 같은 설정을 읽으므로 어느 쪽에서든 확인 방법은 같습니다. 다음을 실행하세요: /status 세션 안에서 실행하면 엔드포인트(ANTHROPIC_BASE_URL), API 키 또는 다음 구독의 활성화 여부를 출력합니다: /login 구독과 함께 모델 및 버전도 표시합니다. 환경에 API 키가 설정되어 있으면 로그인보다 우선합니다. 이것이 "Max로 로그인했는데 API 잔액에서 요금이 차감됩니다"라는 상황이 발생하는 일반적인 이유입니다. 전환하려면 다음 환경 변수의 설정을 해제하세요: ANTHROPIC_API_KEY 구독을 사용하려면 설정을 해제하고, 사용량 기반 과금을 사용하려면 설정하세요(게이트웨이에는 다음도 함께 설정: ANTHROPIC_BASE_URL ).
# use this gateway from VS Code: put these in your shell profile, restart VS Code
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_keyVS Code는 자신을 실행한 셸의 환경 변수를 상속합니다. 다음 명령이 /status 프로필을 변경한 뒤에도 이전 엔드포인트를 표시한다면 VS Code를 완전히 종료하고 새 터미널에서 시작하세요. 창을 다시 로드하는 것만으로는 충분하지 않습니다.
오류: 'claude-vscode.editor.openlast' 명령을 찾을 수 없음
이 오류는 확장 프로그램이 활성화되기 전에 키 바인딩이나 명령 팔레트에서 확장 프로그램을 호출하거나, 확장 프로그램은 활성화되었지만 내부에서 사용하는 CLI를 찾지 못했을 때 나타납니다.
다음 순서로 진행하세요: 1) 창 다시 로드 (Developer: Reload Window) — 대부분은 여기서 해결됩니다. 2) 다음을 실행하세요: claude --version 터미널에서 실행하세요. 찾을 수 없다면 위에서 설명한 CLI를 설치하고 다시 로드하세요. 3) 확장 프로그램이 단순히 설치된 상태가 아니라 이 작업 공간에서 활성화되어 있는지 확인하세요. 4) VS Code 포크를 사용한다면 확장 프로그램 버전이 해당 포크를 지원하는지 확인하세요. 지원하지 않아도 터미널 방식은 작동합니다. 5) 마지막 수단으로 확장 프로그램을 제거하고 다음을 삭제하세요: ~/.claude/ 캐시는 로컬 세션 기록이 삭제되는 것을 감수할 수 있을 때만 삭제하고, 다시 설치하세요.
기타 확장 프로그램 문제
- 패널은 열리지만 비어 있음 → CLI가 시작 중입니다. 출력 패널(Claude Code)에서 실제 오류를 확인하세요. 대개 오래된 Node.js가 원인입니다.
- 인라인 diff가 표시되지 않음 → 작업 공간이 신뢰되지 않은 상태입니다. VS Code는 제한 모드에서 확장 프로그램을 차단합니다.
- 터미널에서는 작동하지만 패널에서는 작동하지 않음 → 프록시 또는
ANTHROPIC_BASE_URL가 셸 프로필에만 설정되어 있고 VS Code를 실행한 환경에는 설정되어 있지 않습니다. - 401 / 잘못된 키 → 키가 엔드포인트와 일치하지 않습니다. 게이트웨이 URL에는 게이트웨이 키가, Anthropic URL에는 콘솔 키가 필요합니다.
VS Code 내 사용 비용
확장 프로그램은 CLI와 완전히 같은 방식으로 과금됩니다. 연결된 서비스에 따라 토큰당 요금이 부과됩니다. 이 게이트웨이에서는 액면가의 7.69231배 크레딧($13로 $100 상당 사용, 87% 할인) 또는 $1부터 시작하는 정액제 무제한 플랜을 사용할 수 있습니다. 자세한 내용은 요금 가이드에서 확인할 수 있으며, 모델 가이드에는 다음으로 선택할 수 있는 모델이 나와 있습니다: /model 에서 선택할 수 있습니다.
| 계획 | 기간 | 가격 |
|---|---|---|
| 1시간 무제한 | 1시간 | $1 |
| 24시간 무제한 | 24시간 | $10 |
| 1주 무제한 | 1주 | $49 |
| 15일 무제한 | 15일 | $89 |
먼저 무료로 사용해 보세요
신규 계정에는 $5의 무료 API 크레딧이 제공됩니다 사용할 코드: CLAUDECODE — Sonnet으로 저녁 한나절 Claude Code를 사용하기에 충분합니다. 이후에는 액면가의 7.69231배에 해당하는 크레딧이 제공됩니다.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key자주 묻는 질문
VS Code용 Claude Code 확장 프로그램이 있나요?
네. 마켓플레이스에 Anthropic의 공식 `anthropic.claude-code` 확장 프로그램이 있습니다. CLI에 패널과 인라인 diff를 제공하며, CLI는 VS Code의 터미널에서 독립적으로 실행할 수도 있습니다.
VS Code에서 Claude Code가 사용하는 계정을 어떻게 확인하나요?
세션에서 /status를 실행하세요. 엔드포인트, API 키 또는 구독 로그인 활성화 여부, 모델이 표시됩니다. 환경에 설정된 API 키는 /login보다 우선합니다.
'claude-vscode.editor.openlast을 찾을 수 없음' 오류는 어떻게 해결하나요?
VS Code 창을 다시 로드하세요. 문제가 계속되면 터미널에서 `claude --version`가 작동하는지 확인하고(작동하지 않으면 CLI 설치), 확장 프로그램이 해당 작업 공간에서 활성화되어 있는지 확인하세요.
Claude Code는 Cursor나 VSCodium에서 작동하나요?
통합 터미널에서는 항상 작동합니다. 확장 프로그램은 해당 포크의 마켓플레이스에서 제공하는 경우 사용할 수 있습니다.
게이트웨이에서 Claude Code 실행하기
동일한 모델, 환경 변수 두 개, 액면가의 7.69231배에 해당하는 크레딧 또는 정액 무제한 요금제를 이용하세요. 신규 계정: 코드 CLAUDECODE로 $5의 무료 API 크레딧을 받으세요.
API 키 발급받기 무제한 요금제 보기AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.