Skip to content

Claude Code 연결 ​

Claude Code는 Anthropic Messages API를 사용합니다. ANTHROPIC_BASE_URL은 /v1 없는 NordRouter 루트로 설정하고 키와 모델은 환경 변수나 settings.json에 둡니다.

  • ~/.claude/settings.json은 터미널과 VS Code에서 공유됩니다.
  • Claude Code가 /v1/messages를 자동으로 붙입니다.
  • 로그인, 401, /v1/v1 오류는 로그인 옵션, 키, 주소 순으로 확인하세요.

전체 예제 ​

원본 가이드의 실행 가능한 예제를 모두 아래에 보존했습니다. 사용 중인 도구와 운영체제에 해당하는 블록만 실행하세요.

json
{
    "env": {
        "ANTHROPIC_API_KEY": "sk-nr-YOUR-KEY",
        "ANTHROPIC_BASE_URL": "https://nordrouter.com",
        "ANTHROPIC_MODEL": "anthropic/claude-opus-5",
        "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",
        "ANTHROPIC_SMALL_FAST_MODEL": "anthropic/claude-haiku-4.5",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
    },
    "permissions": {
        "allow": [],
        "deny": []
    }
}
bash
export ANTHROPIC_BASE_URL=https://nordrouter.com
export ANTHROPIC_API_KEY=sk-nr-YOUR-KEY
export ANTHROPIC_MODEL=anthropic/claude-opus-5
claude
powershell
$env:ANTHROPIC_BASE_URL = "https://nordrouter.com"
$env:ANTHROPIC_API_KEY = "sk-nr-YOUR-KEY"
$env:ANTHROPIC_MODEL = "anthropic/claude-opus-5"
claude

공식 문서 및 관련 링크 ​

VariableMeaning
ANTHROPIC_API_KEYYour sk-nr-… key
ANTHROPIC_BASE_URLhttps://nordrouter.com — no trailing /v1
ANTHROPIC_MODELMain model. You can also set anthropic/claude-sonnet-5 or anthropic/claude-fable-5
ANTHROPIC_DEFAULT_*_MODELSo the /model opus|sonnet|haiku command picks the correct IDs from our catalog
ANTHROPIC_SMALL_FAST_MODELFast background model for Claude Code's utility tasks
ErrorCauseFix
Missing Bearer API keyThe key wasn't picked up: empty ANTHROPIC_API_KEY or an "apiKeyHelper": "echo ''" line in the configSet the key; delete the apiKeyHelper line
Auth conflict: Both a token … and an API key are set + endless retriesA stale ANTHROPIC_AUTH_TOKEN (from a previous login) overrides your key — the server receives the wrong credential and returns 401Unset it: $env:ANTHROPIC_AUTH_TOKEN = $null (Windows) / unset ANTHROPIC_AUTH_TOKEN (macOS/Linux); make sure it's not in settings.json
Invalid URL (POST /v1/v1/messages)/v1 appended to ANTHROPIC_BASE_URLRemove /v1: it must be exactly https://nordrouter.com
No pricing available for model claude-opus-5Claude Code requests a model by its "bare" IDSet ANTHROPIC_MODEL and ANTHROPIC_DEFAULT_*_MODEL as in the config above
Invalid or malformed JSON in settings.jsonBroken JSON: missing braces/commas or "smart" quotes pasted from a chatReplace the file contents entirely with the config above
Invalid API keyTypo in the key, or the key was deletedCheck the key in the dashboard

관련 가이드 ​

먼저 최소 텍스트 요청으로 연결을 확인한 다음 스트리밍, 도구 호출, 이미지와 같은 고급 기능을 추가하세요. API 키를 공개 코드나 브라우저 프런트엔드에 넣지 마세요.

문제 해결