太长不看：Claude Code Router 是什么
- CCR 是免费开源的代理层：Claude Code 的界面、系统提示词和工具原样保留，模型调用指向你配置的服务——DeepSeek、Kimi K2、Gemini、OpenRouter 或本地 Ollama 模型。
- 安装只需一条 npm 命令（npm install -g @musistudio/claude-code-router）；ccr ui 网页控制台直接帮你改 ~/.claude-code-router/config.json，不用手写 JSON。
- 路由按场景分配：default（日常）、background（后台任务）、think（Plan Mode 等重推理）、longContext（超过 6 万 token 自动启用）、webSearch 各自绑定不同模型。
- ccr code 启动路由会话（Base URL 变成 http://127.0.0.1:3456）；直接跑 claude 命令则完全不走路由。已知小坑：/cost 一直显示 $0，花费请看供应商后台。
Claude Code Router 配置全流程
第 1 步 · 让 Claude Code 用上便宜模型
- 1
先看为什么需要这个路由器
Claude Code 只能用 Claude 系模型，而官方定价不便宜：Opus 4.1 输入 $15／百万 token、输出 $75／百万。开源项目 Claude Code Router（CCR）保留 Claude Code 的全部体验，只把每次请求转发到你指定的模型——DeepSeek、Kimi、Gemini 或本地 Ollama。
切换前的 Anthropic 官方定价——这正是 CCR 帮你省掉的开销。视频 0:30 处 - 2
装好 Claude Code，再装路由器
CCR 假设你已装好 Claude Code（npm install -g @anthropic-ai/claude-code），然后安装路由器：npm install -g @musistudio/claude-code-router。供应商配置文件在 ~/.claude-code-router/config.json。
官方 README 给出的两条安装命令——路由器不替代 Claude Code 本体。视频 3:36 处 - 3
等 npm 跑完全局安装
npm 会拉取路由器的依赖（看到 node-domexception 的 deprecation 警告属正常现象）。装完后 ccr 命令全局可用。
全局安装 @musistudio/claude-code-router 时的 npm 拉包过程。视频 3:49 处
第 2 步 · 在 ccr ui 控制台添加供应商
- 4
用 ccr ui 打开可视化配置台
不用手改 JSON，直接运行 ccr ui，浏览器会打开 127.0.0.1:3456 的控制台：左侧管理供应商，右侧 Router 区域给各场景分配模型，下方还有 Custom Transformers。
ccr ui 首次启动：供应商列表为空，路由槽位虚位以待。视频 4:08 处 - 5
从模板添加供应商
点 Add Provider 选模板——视频里用的是 OpenRouter，列表里还有 deepseek、gemini、dashscope、modelscope、siliconflow、volcengine 等预设。模板会自动填好 API URL 和默认模型列表，transformer 留空即可。
ccr ui 的供应商模板——选一个，URL 和模型自动填入。视频 4:30 处 - 6
填入 API Key、挑好模型
真正必填的就三样：API URL（已自动填好）、密钥、模型列表。视频在 OpenRouter 下加了 DeepSeek R1 和 Kimi K2，保存后供应商出现在左侧列表，随时可以分配到路由槽位。
Edit Provider 表单：URL、密钥、模型——其余保持默认即可。视频 4:53 处 - 7
交给 transformer 处理接口差异
transformer 负责改写请求和响应报文，让第三方 API 与 Claude Code 兼容。CCR 内置了常用预设——比如针对 api.deepseek.com 的 deepseek transformer、针对 deepseek-chat 的 tooluse transformer——多数情况下你不用自己写。
README 里的全局与模型级 transformer 示例，含 DeepSeek 预设。视频 3:54 处 - 8
加一个免费 Gemini Key 跑推理任务
用 Gemini 模板添加第二个供应商，去 Google AI Studio 免费创建 API Key（Get API key → Create API key），粘贴保存。稍后把它分配给 think、longContext 和 webSearch 槽位。
在 Google AI Studio 创建免费 Gemini API Key。视频 5:45 处
第 3 步 · 设置场景路由规则
- 9
搞懂五个路由角色
default 管日常任务（没分配的任务也走它）；background 跑后台任务，用小模型或本地模型更省钱；think 承接 Plan Mode 这类重推理；超过 longContextThreshold（默认 6 万 token）时自动切到 longContext；webSearch 要求模型本身支持联网——OpenRouter 上要在模型名后加 :online。会话中还能用 /model 随时切换。
README 里的 Router 对象：五个角色、6 万 token 阈值和 :online 后缀。视频 1:06 处 - 10
给每个场景分配模型
在 Router 区域从已存供应商的模型里挑：视频把 DeepSeek R1 设为 default，Kimi K2 管日常，Gemini 2.5 Pro（100 万上下文）给 longContext，响应快的 Gemini Flash 给 webSearch。最后点右上角 Save and Restart。
在 Default 槽位选中已存供应商的 deepseek/deepseek-r1-0528。视频 5:15 处 - 11
用 ccr code 启动路由会话
回到终端运行 ccr code。Claude Code 欢迎屏会列出 Overrides (via env)——API Base URL http://127.0.0.1:3456，说明请求已经走路由器。直接运行 claude 命令则照常启动不走路由的会话，什么都不用卸载。
欢迎屏的 Overrides 区块：流量已经走 CCR 的本地代理。视频 6:45 处
第 4 步 · 跑真实任务并验证
- 12
丢给它一个真实编码任务
像平常一样下提示词——视频里让它做一个霓虹风格的打砖块游戏。Claude Code 生成待办清单，经由路由后的模型逐步执行。可能遇到小毛病：输入 token 计数停在 0。
Claude Code 逐项推进待办清单，模型调用由 CCR 转发。视频 7:06 处 - 13
检查完成结果
任务收尾时智能体给出功能总结——视觉特效、响应式布局、操作方式、游戏机制——文件落在项目目录（index.html、style.css、script.js）。用浏览器打开 HTML 即可试玩验证。
Claude Code 对霓虹打砖块游戏的完成总结。视频 7:30 处 - 14
去供应商后台核对真实用量
OpenRouter 的 Your Activity 页面才是真账本：路由后的调用一目了然——Kimi K2 被反复调用、DeepSeek 也有一条记录，附带 token 数和花费。这才证明 CCR 真的在用你的便宜模型。
会话结束后的 OpenRouter 用量：被路由的模型都有真实调用记录。视频 7:45 处 - 15
依赖它之前，先知道这些坑
在路由会话里运行 /cost 会显示 $0.0000，按模型统计也全是 claude-sonnet 的 0——成本统计尚未接入第三方供应商。路由本身没问题，现阶段花费请以供应商后台为准。
路由会话里 /cost 的已知误差——供应商后台才是真实计数器。视频 9:25 处