使用 Claude Code Router 管理 Claude Code 中的自定义模型
在上一篇文章中,我分享了 在 Claude Code 中使用自定义模型服务 的经验,主要使用的是配置环境变量的方式,这种方式有一个弊端,就是每次切换模型时,都需要修改环境变量,比较麻烦。
我最初想要在 Claude Code 使用 Kimi 是因为其他模型 Token 单价太贵,而 Claude Code 的 Token 消耗又比其他 AI 编码工具高非常多。但是切换到 Kimi 后,发现即使是使用 Kimi,在 Claude Code 中完成一些简单的编码任务的整体消耗也是非常高的。
在 @NanYi 的分享下了解到 Claude Code Router 这个工具,它可以将 Claude Code 请求路由到不同的模型,并自定义任何请求。效果虽然和配置环境变量自定义模型服务类似,但是 Claude Code Router 有更多亮点功能,比如:
- 多模型路由:根据需求将请求路由到不同的模型,可以实现简单任务走免费模型,复杂推理走付费模型,优化模型调用质价比;
- 多模型提供商支持:可以同时接入多个模型提供商,并且可以在 Claude Code 中使用
/model
命令快速切换模型; - 请求、响应转换:通过转换器配置将不同模型的请求和响应转换为 Anthropic API 格式,不再依赖模型提供商的主动兼容。
安装 Claude Code Router
npm install -g @musistudio/claude-code-router
使用 ccr -v
即可验证 Claude Code Router 是否安装成功;使用 ccr -h
查看 Claude Code Router 提供的命令。
配置 Claude Code Router
首先直接启动 Claude Code Router 服务:
ccr start
执行服务启动命令后会被要求输入模型服务提供商名称、API Key、URL 等信息,现在可以随便输入,这一步只是为了先快速生成一个 Claude Code Router 配置文件(免去手动创建配置文件的麻烦)。
生成的配置文件通常存放在:
- macOS/Linux:
~/.claude-code-router/config.json
- Windows:
%USERPROFILE%\.claude-code-router\config.json
现在可以直接使用文本编辑器打开配置文件进行编辑,也可以启动 Claude Code Router 提供的图形化配置界面:
ccr ui
这里以 iFlow 为例,在图形化界面中选择「添加供应商」,选择导入 iFlow 模板,填入 iFlow 提供的 API Key 即可。
iFlow 提供免费的 Kimi K2、GLM 4.5 等模型。
然后再在图形化界面中的「路由」设置部分选择各种任务要使用的模型,完成后点击「保存并重启」即可。注意:每次修改配置之后都需要重启服务,如果使用命令则是 ccr restart
。
使用 Claude Code Router 后,启动 Claude Code 不再使用 claude
命令,而是 ccr code
命令,其他 Claude Code 使用命令完全不变。
另外需要注意:如果已经通过修改环境变量配置了其他模型服务,可能需要先删除对应的环境变量配置,Claude Code Router 的配置才能生效。