接入指南
60 秒内让 CodeRouter 和你的 AI Agent 跑起来。
01
免费开始,之后按量付费
CodeRouter 使用自己的 provider key,你不需要自带。新账户先送 $5 用量,7 天内有效,用来评估路由质量。
- 免费试用 —— 无需信用卡,$5 用量,7 天内有效,可用于除 Claude Opus 以外的所有模型。
- 按量付费 —— $20 起充;每个请求按模型标价 +8% 计费,没有月费。可选智能路由或 Direct 模式。
- Team —— 每位开发者每月 $19,用量按标价 +8%,可按成员和项目设预算。
02
获取 API key
用 Google 登录,然后在 dashboard 创建 key。建议按工程师或场景命名(例如 alice、ci、prod),后期看分用量数据时一目了然。
03
配置你的 AI agent
选择你的工具。Claude Code(以及 OpenClaw)可以用一行脚本自动写好配置;其他工具填入 base URL 和你的 key 即可:
Anthropic 的命令行工具。cr_ key 填在 ANTHROPIC_AUTH_TOKEN(以 Authorization: Bearer 发送);Claude Code 会优先用它,排在 ANTHROPIC_API_KEY 和 Claude 登录账号之前,而且不需要确认。
curl -fsSL https://www.coderouter.io/setup.sh | bash -s -- cr_YOUR_KEY_HERE claude
{
"env": {
"ANTHROPIC_BASE_URL": "https://www.coderouter.io",
"ANTHROPIC_AUTH_TOKEN": "cr_YOUR_KEY_HERE",
"ANTHROPIC_MODEL": "auto",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "auto",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "auto",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "auto",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
}
}注意: 如果重启后 Claude Code 顶部显示的是 'Claude Max' 而不是 'API Usage Billing',在 Claude Code 里运行 /logout(或 `claude auth logout`),然后重新启动;/status 会显示当前用的是哪个凭据。如果同时设置了 ANTHROPIC_API_KEY,Claude Code 也可能把它发出去;无论哪种情况 CodeRouter 都使用你的 cr_ key,但建议 unset 掉,免得混淆。
要接其他 Agent(Cline、Continue.dev、通过 LiteLLM 接 GitHub Copilot)?请看完整接入文档。
04
验证 it works
用 X-Dry-Run 在不消耗 token 的情况下测试路由 —— 返回路由决策(模型、phase、成本估算)而不真正调用 provider:
curl https://www.coderouter.io/api/v1/chat/completions \
-H "Authorization: Bearer cr_YOUR_KEY" \
-H "Content-Type: application/json" \
-H "X-Dry-Run: true" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello"}]}'响应里会包含选中的模型和 phase。去掉 X-Dry-Run 就是真实请求。
需要帮助?
遇到报错或配置问题?联系页面列出了需要提供的信息,方便我们第一次回复就定位问题。