Claude Code
Claude Code 是 Anthropic 的命令行编程助手。通过环境变量或配置文件把它指向 CodingRouter。
准备
- 安装或升级 Claude Code 到最新版:
npm install -g @anthropic-ai/claude-code - 在控制台创建一个分组为
claude的令牌。
方式一:环境变量
bash
export ANTHROPIC_BASE_URL="https://api.codingrouter.ai"
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
claudepowershell
$env:ANTHROPIC_BASE_URL = "https://api.codingrouter.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的令牌"
claude要长期生效,把两行 export 加到 ~/.zshrc 或 ~/.bashrc。
方式二:settings.json
编辑 ~/.claude/settings.json(Windows 为 %USERPROFILE%\.claude\settings.json),不用每次设置环境变量:
json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.codingrouter.ai",
"ANTHROPIC_AUTH_TOKEN": "sk-你的令牌"
}
}只想在某个项目里使用时,把同样的内容写到项目的 .claude/settings.local.json。
选择模型
启动后输入 /model 切换,或用环境变量指定默认模型:
bash
export ANTHROPIC_MODEL="claude-opus-5-5"也可以在启动时指定:claude --model claude-sonnet-5-5。
验证
bash
claude -p "Reply with exactly: CODINGROUTER OK"输出 CODINGROUTER OK 即配置成功,这次调用会出现在控制台的 使用日志 里。
常见问题
| 现象 | 处理 |
|---|---|
| 启动后要求登录 Anthropic 账号 | 确认环境变量在启动 claude 的同一个终端里;之前登录过官方账号的,先执行 /logout |
同时设置了 ANTHROPIC_API_KEY | 删掉它,只保留 ANTHROPIC_AUTH_TOKEN,避免用错密钥 |
| 提示模型 “isn't described by this version's model catalog” | Claude Code 版本较旧,不认识新模型名;可以正常使用,升级到最新版后提示消失 |
| 返回 404 或 HTML | Base URL 末尾不要加 /v1 |
| 返回 403 或 503 | 令牌分组不是 claude、模型名写错,或余额不足 |
