Skip to content

Claude Code 接入

Claude Code 是 Anthropic 官方的终端编程助手。通过 Anthropic Messages 协议接入 Router 后,它的全部请求都经过路由层(智能选路、容灾、计量)。

  • 协议:Anthropic Messages
  • 接入地址https://routerapi.<你的域名>/anthropic

准备工作

  1. 登录 Router 控制台,在「快速接入」或「API Keys」页签发一个 Key 并保存明文
  2. 在控制台「快速接入」页记下 Anthropic Messages 协议的接入地址

安装 Claude Code

bash
npm install -g @anthropic-ai/claude-code

要求 Node.js 18+。其他安装方式见 Claude Code 官方文档。

配置环境变量

macOS / Linux

bash
export ANTHROPIC_BASE_URL="https://routerapi.<你的域名>/anthropic"
export ANTHROPIC_AUTH_TOKEN="<你的 Key>"

Windows(PowerShell)

powershell
$env:ANTHROPIC_BASE_URL="https://routerapi.<你的域名>/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 Key>"

Windows(CMD)

cmd
set ANTHROPIC_BASE_URL=https://routerapi.<你的域名>/anthropic
set ANTHROPIC_AUTH_TOKEN=<你的 Key>

持久化(推荐)

把上面两个变量写入 shell 配置文件(~/.zshrc / ~/.bashrc),或写入 Claude Code 的用户设置 ~/.claude/settings.json

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://routerapi.<你的域名>/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<你的 Key>"
  }
}

启动并验证

bash
cd <你的项目目>
claude

进入交互界面后随便发一条消息(如 你好)。能正常收到回复即接入成功。随后打开控制台「调用记录」,可以看到刚才的调用明细。

可选:指定模型

Claude Code 默认请求它自己的模型名,路由层会按池策略处理。如需锁定模型,追加:

bash
export ANTHROPIC_MODEL="<模型名>"
export ANTHROPIC_SMALL_FAST_MODEL="<模型名>"

模型名从控制台「可用模型」列表选择(直调模型固定使用,路由池由路由层按任务选档)。

常见问题

Q:报 401 / 鉴权失败? 检查 ANTHROPIC_AUTH_TOKEN 是否完整粘贴(sk- 开头)、Key 是否已在控制台被删除。如果之前登录过 Anthropic 官方账号,先执行 claude logout 避免官方凭证覆盖环境变量。

Q:报 404 / 连接被拒? 检查 ANTHROPIC_BASE_URL 是否以 /anthropic 结尾、域名是否与控制台「快速接入」页展示的一致。地址不要以 / 结尾。

Q:如何确认走的是 Router? 随便发一条消息后,到控制台「调用记录」能看到该次调用即确认。

智能模型路由服务