Skip to content

Claude Code ~ VS Code

Claude Code 공식 확장자 Anthropic을 통해 VS Code에서 직접 사용할 수 있습니다. 별도의 계정 Anthropic는 필요하지 않습니다. 확장 프로그램은 API 키 NordRouter을 통해 요청을 보내고 잔액에서 결제 금액을 인출합니다.

필요한 것

1. 확장 프로그램 설치

  1. VS Code을 엽니다.
  2. Windows/Linux에서는 Ctrl+Shift+X을 클릭하고 macOS에서는 Cmd+Shift+X을 클릭합니다.
  3. Claude Code을 찾아 공식 확장 프로그램인 Anthropic을 설치하세요.
  4. 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을 키로 바꿉니다.

json
{
  "$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을 엽니다.

  1. VS Code에서 프로젝트 폴더를 엽니다.
  2. 사이드바에서 Claude 아이콘을 클릭하거나 편집기 오른쪽 상단에 있는 ✦ 아이콘을 클릭하세요.
  3. 아이콘이 없으면 Command Palette를 열고 Claude Code: Open in New Tab을 실행하세요.
  4. settings.json을 변경한 후 개발자:창 다시 로드를 한 번 실행해 보세요.

첫 번째 확인을 위해 계획 모드를 선택하고 보안 요청을 보냅니다.

파일을 변경하지 않고 이 프로젝트의 구조를 설명합니다.

클로드가 대답한다면활동 내역 요청이 나타나면 연결이 작동 중입니다.

모델 변경 방법

ANTHROPIC_MODELsettings.json로 변경합니다. 예를 들면 다음과 같습니다.

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에 대한 전체 지침 그리고일반적인 오류에 대한 해결 방법이 포함된 섹션.

공식 문서