Skip to content

连接 Claude Code

Claude Code 使用 Anthropic Messages API。将 ANTHROPIC_BASE_URL 设为不含 /v1 的 NordRouter 根地址,并通过环境变量或 settings.json 提供 key 与模型。

  • ~/.claude/settings.json 可供终端和 VS Code 共用。
  • Claude Code 会自动添加 /v1/messages,所以 Base URL 不要包含 /v1。
  • 遇到登录提示、401 或 /v1/v1 时,依次检查登录选项、key 和地址。

完整示例

原始指南中的可执行示例完整保留如下。只运行适用于你的工具和操作系统的代码块。

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 key 放入公开代码或浏览器前端。

故障排除