Claude Code 多模型切换实践：claude-code-router + New API 组合用法

一个助手，多个模型

用 Claude Code 写代码久了会发现一个问题：不是所有活都值得用最贵的模型。改个变量名、补段样板代码，用旗舰模型是杀鸡用牛刀；真到了跨文件重构、排查诡异 bug 的时候，又必须上最强的。理想状态是：入口只有一个，模型按场景切换。这就是我现在的组合：claude-code-router 负责在本地按规则分流，New API 负责在网关侧管 Key、额度和账单。

分工：router 管分流，网关管钥匙

• claude-code-router：装在开发机上，拦截 Claude Code 的请求，按配置把请求转发给不同的模型/供应商。比如默认走一个性价比模型，长上下文场景走另一个，子代理（subagent）任务再走一个便宜的。
• New API：统一网关，供应商的真实 Key 只存在这里。router 不直接连供应商，而是连 New API 的地址，用网关发的令牌调用。这样 Key 不落开发机，换供应商、调额度都在网关面板里改，router 的配置基本不用动。

router 配置长什么样

claude-code-router 的配置核心是 Providers 和 Router 两部分。思路示例：

{
  "Providers": [
    {
      "name": "gateway",
      "api_base_url": "http://你的网关地址/v1/chat/completions",
      "api_key": "网关发的令牌",
      "models": ["model-a", "model-b", "model-c"]
    }
  ],
  "Router": {
    "default": "gateway,model-a",
    "longContext": "gateway,model-b",
    "background": "gateway,model-c"
  }
}

• default：日常对话和写代码的主力模型，选均衡的。
• longContext：上下文超过阈值时自动切到长窗口模型，不用手动干预。
• background：后台任务（比如自动生成摘要、跑子代理）用最便宜的就行。

配好后启动 router，再让 Claude Code 走 router 的本地地址，切换模型这件事就从“改环境变量重启终端”变成了“改一行配置”。

账单要能对上号

多模型混用最怕账算不清。我的做法是在 New API 里按用途发令牌：主力开发一个、后台任务一个、临时测试再一个。网关日志里每个令牌的调用量、模型、花费分开统计，月底一看就知道钱花在哪个场景。发现 background 令牌异常烧钱，基本就是某个自动化任务在空转，吊销令牌立刻止损，不影响主力令牌干活。

两个实战提醒

1. 流式截断先查反代：如果网关前面挂了 Nginx，编程助手的流式回复一段一段卡，多半是反代开了 buffering，关掉 proxy_buffering 再试。这是我这套栈里踩过最久的一个坑。
2. 备用渠道提前配：主供应商偶尔抖动，router 和网关两层都可以配 fallback。提前把备用模型写进配置，真出事时是自动切换，而不是半夜起来改代码。

总结

模型会越来越多，价格和能力也会一直变。与其每次新模型出来就改一遍各工具的配置，不如把“切换”这件事收敛到 router 一层、把“钥匙和账单”收敛到网关一层。工具链稳定下来，注意力才能回到代码本身。