安装配置 Claude Code Router 备忘录

通过 zcf 安装和配置 Claude 很简单，但是要在多个模型、供应商之间切换，还是有点麻烦。后来在 zcf 中看到有 CCR 代理，发现这个开源工具可以接入多个模型供应商或多个模型，使用起来方便不少。下面简要记录一下配置步骤：
1. zcf 中安装和启动 CCR 和 CCR UI 

══════════════════════════════════════════════════CCR - Claude Code Router 管理
══════════════════════════════════════════════════1. 初始化 CCR - 安装并配置 CCR2. 启动 CCR UI - 打开 Web 界面管理 CCR3. 查询 CCR 状态 - 查看 CCR 服务运行状态4. 重启 CCR - 重启 CCR 服务5. 启动 CCR - 启动 CCR 服务6. 停止 CCR - 停止 CCR 服务0. 返回主菜单✔ 请输入选项，回车确认（不区分大小写） 1

启动 CCR，存在会失去响应的情况，改用重启 CCR 也管用

══════════════════════════════════════════════════CCR - Claude Code Router 管理
══════════════════════════════════════════════════1. 初始化 CCR - 安装并配置 CCR2. 启动 CCR UI - 打开 Web 界面管理 CCR3. 查询 CCR 状态 - 查看 CCR 服务运行状态4. 重启 CCR - 重启 CCR 服务5. 启动 CCR - 启动 CCR 服务6. 停止 CCR - 停止 CCR 服务0. 返回主菜单✔ 请输入选项，回车确认（不区分大小写） 4🔄 正在重启 CCR...
Service was not running or failed to stop.
Starting claude code router service...
✅ Service started successfully in the background.✔ CCR 已重启──────────────────────────────────────────────────

══════════════════════════════════════════════════CCR - Claude Code Router 管理
══════════════════════════════════════════════════1. 初始化 CCR - 安装并配置 CCR2. 启动 CCR UI - 打开 Web 界面管理 CCR3. 查询 CCR 状态 - 查看 CCR 服务运行状态4. 重启 CCR - 重启 CCR 服务5. 启动 CCR - 启动 CCR 服务6. 停止 CCR - 停止 CCR 服务0. 返回主菜单✔ 请输入选项，回车确认（不区分大小写） 2🖥️  正在启动 CCR UI...🔑 CCR UI 登录密钥: sk-zcf-x-ccr使用此密钥登录 CCR UI 界面Opening UI at http://127.0.0.1:3456/ui/

✔ CCR UI 已启动──────────────────────────────────────────────────

 

2. 用上面给出的登录密钥，登录 CCR UI (http://127.0.0.1:3456/ui) 后，添加供应商和模型。添加时注意 URL 结尾要补全，并且正确选择供应商转换器。

 
以小马算力为例 ，其官方文档上分别提供了 OpenAI 和 Claude 兼容的多个 API URL。

如果选择 OpenAI 兼容的 URL，要填写 https://api.tokenpony.cn/v1/chat/completions ，供应商转换器对应选则 OpenAI；

如果使用 Claude 兼容的 URL，CCR 中则需要填写 https://api-claude.tokenpony.cn/v1/message ，供应商转换器要选 Authropic

具体能用哪些模型，需要查询小马算力的文档，接下来配置路由设置，包括最基本的默认、后台、思考模型，以及上下文、网页搜索、图像识别具体使用的模型。一般配置前三个就够用，Claude 在非思考模式会一般会优先自动使用后台模型，建议选择轻量快速费率低的，例如 deepseek-v3.2-exp,或者 glm-4.5-flash，思考模式一般选择 qwen3-coder-480b 或者 deepseek-r1-0528，默认模式可以选择 deepseek-v3.1-terminus 性能和价格相对平衡的。

 
3. 在 zcf 中切换到使用 CCR 代理，现在 Claude 应该就可以使用 CCR 工作了

请选择功能-------- Claude Code --------1. 完整初始化 - 安装 Claude Code + 导入工作流 + 配置 API 或 CCR 代理 + 配置 MCP 服务2. 导入工作流 - 仅导入/更新工作流相关文件3. 配置 API 或 CCR 代理 - 配置 API URL、认证信息或 CCR 代理4. 配置 MCP - 配置 MCP 服务（含 Windows 修复）5. 配置默认模型 - 设置默认模型（opus/sonnet/sonnet 1m/自定义）6. 配置 Claude 全局记忆 - 配置 AI 输出语言和输出风格7. 导入推荐环境变量和权限配置 - 导入隐私保护环境变量和系统权限配置--------- 其他工具 ----------R. CCR - 配置 Claude Code Router 以使用多个 AI 模型U. ccusage - Claude Code 用量分析L. CCometixLine - 基于 Rust 的高性能 Claude Code 状态栏工具，集成 Git 信息和实时使用量跟踪------------ ZCF ------------0. 更改显示语言 / Select display language - 更改 ZCF 界面语言S. 切换代码工具 - 在支持的代码工具之间切换 (Claude Code, Codex)-. 卸载和删除配置 - 从系统中删除 Claude Code 配置和工具+. 检查更新 - 检查并更新 Claude Code、CCR 和 CCometixLine 的版本Q. 退出✔ 请输入选项，回车确认（不区分大小写） 3
? 请选择 API 配置模式1. 使用官方登录（不配置 API）2. 自定义 API 配置
❯ 3. 使用CCR代理4. 跳过↑↓ navigate • ⏎ select

Claude 毕竟是在终端运行，用起来总觉得不如直接在 vscode 里顺手，可以安装 Claude Code for vscode 插件，好处是只要 Claude 配置好了，插件里就直接可用，不需要登录官方账号，或做别的配置。不过我自己更喜欢使用 Kilo Code，在 Kilo Code 中又该如何配置使用 CCR 呢？也比较简单

提供商：Authropic, 
勾选使用自定义的 BASE URL：http://127.0.0.1:3456, 
API KEY填写 zcf 配置CCR登录密钥：sk-zcf-x-ccr

现在就可以愉快在 Koli Code 使用 CCR 定义的大模型了，切换模型只需要登录 CCR UI 修改路由，保存后重启 CCR 即可生效。

补充说一下，使用 CCR 我发现有2个小问题：
1. Claude 不知道 CCR 代理实际使用的是什么模型，只会显示为默认的 Sonnet-4.5
2. Kilo Code 之类的第三方工具，好像没法使用 CCR 路由中的思考模型，只会用默认模型或后台模型

最后插一句，博客园跟小马算力最近在搞推广活动，注册就有免费的赠送金羊毛，每日签到还有奖励，非诚适合试水的小伙伴哦。