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.comno 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 키를 공개 코드나 브라우저 프런트엔드에 넣지 마세요.

문제 해결