Claude Code ~ VS Code
Claude Code 공식 확장자 Anthropic을 통해 VS Code에서 직접 사용할 수 있습니다. 별도의 계정 Anthropic는 필요하지 않습니다. 확장 프로그램은 API 키 NordRouter을 통해 요청을 보내고 잔액에서 결제 금액을 인출합니다.
필요한 것
- VS Code 버전 1.94 이상;
- API 키
sk-nr-…NordRouter 개인 계정; - 긍정적인 균형.
1. 확장 프로그램 설치
- VS Code을 엽니다.
- Windows/Linux에서는
Ctrl+Shift+X을 클릭하고 macOS에서는Cmd+Shift+X을 클릭합니다. - Claude Code을 찾아 공식 확장 프로그램인 Anthropic을 설치하세요.
- Claude 패널이 나타나지 않으면 Command Palette(
Ctrl+Shift+P/Cmd+Shift+P)를 열고 Developer: Reload Window를 실행한 후 창이 다시 시작될 때까지 기다립니다.
그런 다음 VS Code(Ctrl+, / Cmd+,) 설정을 열고 Claude Code: 로그인 프롬프트 비활성화를 찾아 이 설정을 활성화합니다. 타사 API 공급자를 통해 작업할 때 Anthropic 계정에 대한 로그인을 비활성화합니다.
확장에는 이미 Claude Code CLI가 포함되어 있으므로 VS Code에서 정상적인 작업을 위해서는 CLI를 별도로 설치할 필요가 없습니다.
2. 설정 추가 NordRouter
파일을 열거나 생성합니다.
- Windows:
%USERPROFILE%\.claude\settings.json; - macOS 및 Linux:
~/.claude/settings.json.
다음 구성을 붙여넣고 sk-nr-YOUR-KEY을 키로 바꿉니다.
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"env": {
"ANTHROPIC_API_KEY": "sk-nr-YOUR-KEY",
"ANTHROPIC_BASE_URL": "https://nordrouter.com",
"ANTHROPIC_MODEL": "anthropic/claude-sonnet-4.6",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4.6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}기본 URL이 /v1 없이 지정되었습니다.
정답: https://nordrouter.com. Claude Code은 Anthropic API 경로를 독립적으로 추가합니다. /v1을 지정하면 요청이 존재하지 않는 주소 /v1/v1/messages로 이동할 수 있습니다.
settings.json 파일은 Claude Code CLI 및 VS Code 확장에 공통입니다. 별도로 구성할 필요가 없습니다.
3. Claude Code을 엽니다.
- VS Code에서 프로젝트 폴더를 엽니다.
- 사이드바에서 Claude 아이콘을 클릭하거나 편집기 오른쪽 상단에 있는 ✦ 아이콘을 클릭하세요.
- 아이콘이 없으면 Command Palette를 열고 Claude Code: Open in New Tab을 실행하세요.
settings.json을 변경한 후 개발자:창 다시 로드를 한 번 실행해 보세요.
첫 번째 확인을 위해 계획 모드를 선택하고 보안 요청을 보냅니다.
파일을 변경하지 않고 이 프로젝트의 구조를 설명합니다.
클로드가 대답한다면활동 내역 요청이 나타나면 연결이 작동 중입니다.
모델 변경 방법
ANTHROPIC_MODEL을 settings.json로 변경합니다. 예를 들면 다음과 같습니다.
"ANTHROPIC_MODEL": "anthropic/claude-opus-5"anthropic/ 접두사가 붙은 전체 모델 ID를 사용하세요. 사용 가능한 모델 및 현재 가격은 다음을 참조하세요.NordRouter 카탈로그.
일반적인 문제
확장 프로그램은 귀하의 계정 Anthropic에 로그인하도록 요청합니다.
Claude Code: 로그인 프롬프트 비활성화 설정이 활성화되어 있는지, 그리고 ANTHROPIC_API_KEY이 .claude/settings.json 파일의 env 블록 내부에 있는지 확인하세요. 그런 다음 개발자: 창 다시 로드를 실행합니다. 이전에 Anthropic 계정을 사용하여 Claude Code에 로그인한 경우 Claude Code 터미널에서 /logout을 실행하고 VS Code 창을 다시 시작하세요.
Auth conflict: Both a token and an API key are set
이전 ANTHROPIC_AUTH_TOKEN이 API 키와 충돌합니다. 환경과 settings.json에서 이 변수를 제거하고 ANTHROPIC_API_KEY만 남겨 둡니다.
Invalid URL 또는 /v1/v1/messages로 요청
ANTHROPIC_BASE_URL에서 /v1을 제거합니다. 정확히 https://nordrouter.com여야 합니다.
No pricing available for model …
전체 모델 ID(예: anthropic/claude-sonnet-4.6)를 지정하고 위의 완성된 구성을 사용하여 ANTHROPIC_DEFAULT_*_MODEL 값을 확인합니다.
Claude Code은 VS Code에 표시되지 않습니다.
VS Code을 버전 1.94 이상으로 업데이트하고 현재 프로필에 확장 프로그램이 활성화되어 있는지 확인한 다음 개발자: 창 다시 로드를 실행하세요.
오류가 지속되면 다음을 엽니다.Claude Code에 대한 전체 지침 그리고일반적인 오류에 대한 해결 방법이 포함된 섹션.