文档 / 集成 / Claude Code

Claude Code 接入 RelayRouter

Claude Code 可以对接任何实现了 Anthropic Messages API 的端点。RelayRouter 在 https://relayrouter.io/v1/messages 提供该协议，所以整个配置只有两个环境变量：base URL 和你的密钥。按 token 从预付余额计费，失败请求不收费。

#1. 为 Claude 分组创建密钥

在控制台创建 API 密钥，并选择包含你要用的 Claude 模型的分组。模型页列出了每个分组及其费率；写代码常用 claude-opus-5-5 和 claude-sonnet-4-6。

#2. 设置环境变量

macOS 或 Linux（bash、zsh）：

terminalbash

export ANTHROPIC_BASE_URL="https://relayrouter.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-relayrouter-key"
export ANTHROPIC_MODEL="claude-opus-5-5"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5"
claude

Windows PowerShell：

PowerShellpowershell

$env:ANTHROPIC_BASE_URL = "https://relayrouter.io"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-relayrouter-key"
$env:ANTHROPIC_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_SMALL_FAST_MODEL = "claude-haiku-4-5"
claude

要长期生效，把同样的值写进 ~/.claude/settings.json（或项目内 .claude/settings.json）的 env 块：

~/.claude/settings.jsonjson

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://relayrouter.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-relayrouter-key",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5"
  }
}

想以 Bearer 方式发送密钥时用 ANTHROPIC_AUTH_TOKEN 而不是 ANTHROPIC_API_KEY，两种请求头 RelayRouter 都接受。ANTHROPIC_BASE_URL 不要带 /v1，Claude Code 会自己拼接路径。

#3. 选择模型

变量	作用	建议值
`ANTHROPIC_MODEL`	对话与编辑使用的主模型	`claude-opus-5-5`
`ANTHROPIC_SMALL_FAST_MODEL`	后台任务使用的小模型	`claude-haiku-4-5`

分组里的任何模型 id 都可以，id 与模型页显示的完全一致。会话中也可以用 /model 切换主模型。

#4. 在 Claude Code 之外验证

如果出错，先用同一个密钥和模型发一条请求：

terminalbash

curl https://relayrouter.io/v1/messages \
  -H "x-api-key: sk-your-relayrouter-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5-5","max_tokens":64,"messages":[{"role":"user","content":"ping"}]}'

#排错

现象	原因	处理
`401`	密钥错误、被停用或余额为零	在控制台核对密钥并充值
`404 model not found`	该模型不在密钥所属分组里	换一个包含该模型的分组创建密钥，或改 ANTHROPIC_MODEL
`请求发到了 api.anthropic.com`	变量设在了别的终端，或被 settings.json 覆盖	在同一终端运行 claude，或把值写进 settings.json
`thinking 模型首字慢`	正常现象，模型会先推理再输出	超时设置指南

←SDK & Frameworks Cursor→