VS Code에서 Claude Code 사용하기: 설정, 모델, 확인
VS Code에 Claude Code 확장을 설치하고 AI in IDE API 키 하나로 연결해, Anthropic 구독 없이 첫 요청을 확인합니다.
설정은 확장 하나, 키 하나, JSON 블록 하나가 전부입니다. 프록시, TLS, Remote SSH, WSL을 포함한 전체 참고 자료는 VS Code에서 Claude Code 사용하기를 읽으세요. 이 페이지는 요약판입니다.
빠른 설정
- 확장 설치. VS Code 1.94.0 이상이 필요합니다. 확장 보기, Visual Studio Marketplace, 또는 마켓을 쓸 수 없을 때 **Install from VSIX…**로 Claude Code를 설치합니다. 패널이 보이지 않으면 Developer: Reload Window를 실행합니다.
- API 키 만들기. API Keys를 열어 키를 만들고 AWSQ 또는 CCMAX 채널을 선택합니다. 이 둘이 Claude Code 채널이며, Codex나 Gemini 키는 여기서 거부됩니다.
- 연결 설정 작성.
~/.claude/settings.json(macOS/Linux) 또는C:/Users/<UserName>/.claude/settings.json(Windows)을 만들거나 기존 내용에 병합합니다.
1 {2 "$schema": "https://json.schemastore.org/claude-code-settings.json",3 "env": {4 "ANTHROPIC_BASE_URL": "https://api.aiinide.com",5 "ANTHROPIC_AUTH_TOKEN": "YOUR_DASHBOARD_API_KEY",6 "API_TIMEOUT_MS": "600000",7 "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"8 }9 }
ANTHROPIC_BASE_URL은 호스트 이름만 넣습니다. Claude Code가 /v1/messages를 붙이므로 /v1로 끝나면 /v1/v1/messages가 되어 404가 납니다. 파일이 이미 있으면 env 객체를 병합해 권한 규칙과 hooks를 보존하세요.
- Anthropic 로그인 화면 끄기. VS Code 사용자 설정에
"claudeCode.disableLoginPrompt": true를 추가하거나 설정에서 "Claude Code login"을 검색합니다. - 확인. 키와
anthropic-version: 2023-06-01헤더로GET /v1/models를 호출합니다. HTTP 200은 채널 모델 목록, 401은 키 없음·무효, 400은 다른 채널의 키입니다. 그다음 파일을 열고 Spark 아이콘 또는 ✻ Claude Code를 클릭해/status를 실행하고 짧은 프롬프트를 보냅니다. 성공한 프롬프트는 Usage에 나타납니다.
지원 모델
| 모델 | 채널 | 적합한 용도 |
|---|---|---|
claude-opus-5-5(별칭 claude-opus-5.5) | AWSQ, CCMAX | 어려운 리팩터링, 긴 자율 실행 |
claude-sonnet-5-5(별칭 claude-sonnet-5.5) | AWSQ, CCMAX | 일상 코딩, 기본 선택 |
claude-haiku-4-5-20251001 | AWSQ, CCMAX | 빠른 수정, 저렴한 확인 호출 |
settings.json에서 model을 생략하면 확장의 선택기를 쓰고, 세션 중에는 /model로 바꿉니다. GET /v1/models의 정확한 ID를 사용하세요. 잘못된 claude-* 이름은 기본 Claude 모델로 해석되어 그 모델 요율로 청구될 수 있습니다. 플랜, 쿼터, 현재 요율은 요금을 보세요.
워크플로 주의점
- 확장은 Claude Code를 내장합니다. 설치해도
claude가 PATH에 추가되지는 않습니다. 터미널 세션이나claude mcp add가 필요할 때만 별도 CLI를 설치하세요. - Dock이나 시작 메뉴에서 실행한 VS Code는 셸 프로필을 읽지 않습니다. 연결 값은 확장과 CLI가 모두 읽는
~/.claude/settings.json에 두세요. - Remote SSH, WSL, dev container에서는 설정 파일이 원격 환경 안에 있어야 합니다. 로컬 파일을 고쳐도 원격 세션에는 적용되지 않습니다.
ANTHROPIC_API_KEY가 내보내져 있으면ANTHROPIC_AUTH_TOKEN보다 우선할 수 있습니다. 정보 출처를 하나로 유지하세요.
문제 해결 요점
API Error: 404—ANTHROPIC_BASE_URL에/v1이 들어 있습니다.https://api.aiinide.com을 쓰세요.API Error: 400— 키가 다른 채널이거나settings.json을 파싱할 수 없습니다. AWSQ 또는 CCMAX로 키를 다시 만들고 JSON을 검증하세요.- Spark 아이콘 없음 — 먼저 파일을 여세요. 아이콘은 파일이 열려 있을 때만 보이고 VS Code가 1.94.0 이상이어야 합니다.
- 패널 무응답 — 명령 팔레트에서 Claude Code: Show Logs를 실행하세요. 내장 CLI 실행에 실패했을 수 있습니다.
자주 묻는 질문
Anthropic 구독도 필요한가요?
아닙니다. ANTHROPIC_AUTH_TOKEN과 AI in IDE 베이스 URL이 claude.ai 로그인을 대체하고, claudeCode.disableLoginPrompt가 확장의 로그인 요구를 막습니다.
같은 키를 Cursor에서도 쓸 수 있나요?
됩니다. Cursor는 같은 확장을 실행하므로 같은 settings.json과 claudeCode.* 설정이 적용됩니다. Cursor에서 Claude Code 사용하기를 보세요.
확장이 claude CLI를 설치하나요?
아닙니다. 확장은 자체 CLI를 내장하지만 claude를 PATH에 넣지 않습니다. 터미널 세션이나 claude mcp add가 필요할 때만 별도 CLI를 설치하세요.
모델은 어디서 바꾸나요?
~/.claude/settings.json의 model을 설정하거나 패널에서 /model을 사용합니다. 둘 다 전체 VS Code 가이드에 나옵니다.