集成指南
Claude Code CLI
让 Anthropic 官方 Claude Code CLI 走 ToRouter——不需要 Anthropic 原生 Key 即可享受完整 Agent 编程体验。
Claude Code 是 Anthropic 官方的终端 Agent。它使用原生 Anthropic Messages API,而 ToRouter 1:1 暴露了该接口——只要设置两个环境变量,CLI 无需改动即可对接 ToRouter。
配置
| 变量 | 取值 |
|---|---|
ANTHROPIC_BASE_URL | https://portal.torouter.ai |
ANTHROPIC_API_KEY | sk-*** |
模型在每次会话中通过 CLI 参数 --model 或 /model 斜杠命令切换;默认是当前的旗舰 Claude。
安装与运行
npm install -g @anthropic-ai/claude-code
export ANTHROPIC_BASE_URL=https://portal.torouter.ai
export ANTHROPIC_API_KEY=sk-***
claudenpm install -g @anthropic-ai/claude-code
$env:ANTHROPIC_BASE_URL = "https://portal.torouter.ai"
$env:ANTHROPIC_API_KEY = "sk-***"
claude进入 CLI 后:
> /model claude-opus-4-7
> 重构 src/server.go 的可读性Prompt caching 默认开启
Claude Code 会在 system prompt 与最近若干轮上下文上大量使用 cache_control。ToRouter 在直连 Anthropic 与 Anthropic-on-OpenRouter 两条路径上都原样转发 cache_control,因此长会话的实际成本与 Anthropic 公布的缓存定价一致。
易踩的坑
ANTHROPIC_BASE_URL使用https://portal.torouter.ai——不要加/v1后缀。Claude Code 自己会追加/v1/messages。claude /login是 Anthropic 直连计费的 OAuth 登录流程;走 ToRouter 时直接跳过——上述环境变量已经足够。- 把环境变量写进 shell 配置文件(
~/.zshrc、~/.bashrc)或使用.env加载器,新开终端才会生效。 - 重度使用工具调用时容易触发 Key 级速率限制,可在 ToRouter 控制台 Keys → Rate limits 中调整。