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
claudepowershell
$env:ANTHROPIC_BASE_URL = "https://nordrouter.com"
$env:ANTHROPIC_API_KEY = "sk-nr-YOUR-KEY"
$env:ANTHROPIC_MODEL = "anthropic/claude-opus-5"
claude공식 문서 및 관련 링크
| Variable | Meaning |
|---|---|
ANTHROPIC_API_KEY | Your sk-nr-… key |
ANTHROPIC_BASE_URL | https://nordrouter.com — no trailing /v1 |
ANTHROPIC_MODEL | Main model. You can also set anthropic/claude-sonnet-5 or anthropic/claude-fable-5 |
ANTHROPIC_DEFAULT_*_MODEL | So the /model opus|sonnet|haiku command picks the correct IDs from our catalog |
ANTHROPIC_SMALL_FAST_MODEL | Fast background model for Claude Code's utility tasks |
| Error | Cause | Fix |
|---|---|---|
Missing Bearer API key | The key wasn't picked up: empty ANTHROPIC_API_KEY or an "apiKeyHelper": "echo ''" line in the config | Set the key; delete the apiKeyHelper line |
Auth conflict: Both a token … and an API key are set + endless retries | A stale ANTHROPIC_AUTH_TOKEN (from a previous login) overrides your key — the server receives the wrong credential and returns 401 | Unset 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_URL | Remove /v1: it must be exactly https://nordrouter.com |
No pricing available for model claude-opus-5 | Claude Code requests a model by its "bare" ID | Set ANTHROPIC_MODEL and ANTHROPIC_DEFAULT_*_MODEL as in the config above |
Invalid or malformed JSON in settings.json | Broken JSON: missing braces/commas or "smart" quotes pasted from a chat | Replace the file contents entirely with the config above |
Invalid API key | Typo in the key, or the key was deleted | Check the key in the dashboard |
관련 가이드
먼저 최소 텍스트 요청으로 연결을 확인한 다음 스트리밍, 도구 호출, 이미지와 같은 고급 기능을 추가하세요. API 키를 공개 코드나 브라우저 프런트엔드에 넣지 마세요.