Claude Code 接入
Claude Code 是 Anthropic 官方的终端编程助手。通过 Anthropic Messages 协议接入 Router 后,它的全部请求都经过路由层(智能选路、容灾、计量)。
- 协议:Anthropic Messages
- 接入地址:
https://routerapi.<你的域名>/anthropic
准备工作
- 登录 Router 控制台,在「快速接入」或「API Keys」页签发一个 Key 并保存明文
- 在控制台「快速接入」页记下 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? 随便发一条消息后,到控制台「调用记录」能看到该次调用即确认。