安装配置 Claude Code Router 备忘录

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

══════════════════════════════════════════════════
  CCR - Claude Code Router 管理
══════════════════════════════════════════════════

  1. 初始化 CCR - 安装并配置 CCR
  2. 启动 CCR UI - 打开 Web 界面管理 CCR
  3. 查询 CCR 状态 - 查看 CCR 服务运行状态
  4. 重启 CCR - 重启 CCR 服务
  5. 启动 CCR - 启动 CCR 服务
  6. 停止 CCR - 停止 CCR 服务
  0. 返回主菜单

✔ 请输入选项，回车确认（不区分大小写） 1

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

══════════════════════════════════════════════════
  CCR - Claude Code Router 管理
══════════════════════════════════════════════════

  1. 初始化 CCR - 安装并配置 CCR
  2. 启动 CCR UI - 打开 Web 界面管理 CCR
  3. 查询 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 - 安装并配置 CCR
  2. 启动 CCR UI - 打开 Web 界面管理 CCR
  3. 查询 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 Code 自动选择"。关掉终端重新打开 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 路由中的思考模型，只会自动选择默认模型或后台模型

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