接入指南

接入指南

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 登录账号之前,而且不需要确认。
一行命令——写入 ~/.claude/settings.json(会备份原文件;用 --uninstall 撤销)
curl -fsSL https://www.coderouter.io/setup.sh | bash -s -- cr_YOUR_KEY_HERE
claude
或手动编辑:~/.claude/settings.json
{
  "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:

Dry-run 测试
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 就是真实请求。

需要帮助?

遇到报错或配置问题?联系页面列出了需要提供的信息,方便我们第一次回复就定位问题。

联系客服