Claude Code Router 是什么?和 cdnd 有什么区别
Claude Code Router(简称 CCR)是一个开源的本地模型网关:它在你的电脑上运行,让 Claude Code 等编程工具把请求发给你选的模型供应商,比如 DeepSeek、Gemini、OpenRouter。cdnd 则是一个 Claude Code 中转站,提供的是官方 Claude 模型。两者名字里都有“中转”的意思,但解决的问题不一样。本文讲清楚 Claude Code Router 是什么、和 cdnd 有什么区别、能不能一起用。
Claude Code Router 是什么
Claude Code Router 是 musistudio 开源的项目,MIT 协议。按仓库的说法,它是“面向编程 Agent 的本地模型网关和控制面板”:
- 本地网关:在本机启动一个模型网关,默认地址
http://127.0.0.1:3456;Claude Code 等工具把请求发到这里。 - 多个供应商:支持 OpenAI Chat / Responses、Anthropic Messages、Gemini 等协议,内置 OpenRouter、DeepSeek、SiliconFlow、Moonshot、Mistral 等供应商,也能填自定义接口。
- 路由规则:按条件把请求分给不同模型,支持改写请求、重试、按顺序回退到备用模型,以及多个 Key 轮换。
- 扩展能力:给模型加上看图、网页搜索、MCP 工具等能力。
- 多种客户端:除了 Claude Code,还支持 Codex、OpenCode、Kimi CLI 等工具。
- 日志:记录每个请求实际走了哪个供应商和模型、延迟、token 和估算费用。
它有桌面版(macOS、Windows、Linux),也可以用 npm 安装命令行版。
Claude Code Router 用来做什么
CCR 的核心用途是让 Claude Code 用上 Claude 以外的模型,或者在多个供应商之间统一管理:
- 想用 Claude Code 的交互方式,但模型换成 DeepSeek、Gemini、Kimi 等。
- 手里有好几家供应商的 Key,想在一个地方管理、按任务分配模型。
- 某个供应商出错时自动换到备用模型。
- 同时用 Claude Code、Codex 等多个编程工具,想共用一套模型配置。
CCR 本身不提供模型,模型和费用都来自你添加的供应商。
Claude Code Router 和 cdnd 的区别
| 对比项 | Claude Code Router | cdnd |
|---|---|---|
| 是什么 | 开源软件,运行在你自己的电脑或服务器上 | 在线服务,Claude Code 中转站 |
| 模型从哪来 | 你添加的供应商和它们的 Key | 一组官方 Claude 账号 |
| 支持哪些模型 | 多家:DeepSeek、Gemini、OpenRouter 上的模型等 | 只有官方 Claude 模型 |
| 支持哪些客户端 | Claude Code、Codex、OpenCode 等多个工具 | 只有 Claude Code |
| 对请求做什么 | 按规则路由,可转换协议、改写请求、回退到其他模型 | 不换模型、不转换协议,同一会话固定在同一个账号上 |
| 怎么收费 | 软件免费;按各供应商自己的价格付费 | 按 Anthropic 官方美元价,¥2 = $1,没有月费 |
| 需要准备什么 | 各供应商的账号和 API Key,本地运行 CCR | 一个 cdnd API Key,两行环境变量 |
简单说:CCR 是一个“分发器”,决定请求发给谁;cdnd 是一个“供应商”,专门提供官方 Claude。如果你只想在国内用官方 Claude 模型,不需要再加一层路由。cdnd 的价格见 Claude Code 价格。
两者能一起用吗
不建议把 cdnd 作为 CCR 的供应商。 cdnd 只接受 Claude Code 直接发出的请求。CCR 作为中间层,会按自己的规则转发、可能改写请求;它在添加供应商时的连通性检测,也是 CCR 自己发出的请求。这些请求在 cdnd 看来通常不是 Claude Code 发出的,会被拒绝,返回 403 cdnd serves Claude Code only。我们不对这种用法提供支持。
两个都想用,可以让它们各管一摊:
- 用官方 Claude 时:Claude Code 直接指向 cdnd,设置
ANTHROPIC_BASE_URL=https://api.cdnd.sh和ANTHROPIC_AUTH_TOKEN,见 Claude Code 第三方 API 配置教程。 - 用其他模型时:通过 CCR 的 Agent Config 启动另一个 Claude Code,请求走 CCR 发给 DeepSeek、Gemini 等供应商。
- 两套配置来回切换:可以用 cc switch 管理 Claude Code 的供应商配置。
注意 ~/.claude/settings.json 里 env 的值优先于终端里的环境变量。两套配置同时存在时,在 Claude Code 里运行 /status,看 Anthropic base URL 那一行,确认请求发到了哪里。
Claude Code Router 和 cdnd 怎么选
- 只用 Claude 模型、在国内访问不方便:直接用 cdnd,不需要 CCR。两行环境变量接入,同一会话固定在同一个账号上,缓存持续命中。
- 想用 DeepSeek、Gemini 等其他模型驱动 Claude Code:用 CCR,cdnd 不提供其他模型。
- 在多个编程工具、多个供应商之间统一管理:用 CCR;其中需要官方 Claude 的那部分,让 Claude Code 直接连 cdnd。
- 自己有 Claude Pro / Max 订阅:可以托管到 cdnd,自己的账号到达限额时,可以换用账号池 Key 按量付费。
还在比较不同的中转站,看 Claude Code 中转站怎么选;想了解镜像站和中转 API 的区别,看 Claude 镜像站 vs 中转 API。
常见问题
Claude Code Router 怎么配置?
按仓库 README,当前版本推荐装桌面版:在 Providers 里添加供应商和 Key,在 Server 里启动网关,再在 Agent Config 里选 Claude Code 和模型。命令行版需要 Node.js 22 以上,用 npm install -g @musistudio/claude-code-router 安装,运行 ccr ui 打开管理界面。网上较早的教程和当前版本的命令差别较大,具体以 Claude Code Router 仓库为准。
Claude Code Router 能接 cdnd 吗?
不建议。cdnd 只接受 Claude Code 直接发出的请求,经过 CCR 转发或由 CCR 自己发出的请求通常会被拒绝,返回 403。要用 cdnd 的官方 Claude 模型,让 Claude Code 直接设置 ANTHROPIC_BASE_URL 指向 https://api.cdnd.sh 即可,见 Claude Code 第三方 API 配置教程。
Claude Code Router 免费吗?
软件本身开源免费,MIT 协议。但 CCR 不提供模型,你用的每个模型都要在对应供应商那里注册、付费,费用按各家的价格计算。
Claude Code Router 能让 Claude Code 用 DeepSeek 吗?
能,这正是 CCR 的主要用途之一,它内置了 DeepSeek 等供应商。cdnd 不提供 DeepSeek,也不提供 OpenAI 格式接口,只提供官方 Claude 模型。
有没有 Claude Code Router 的替代方案?
看你要解决什么问题。如果只是想在国内用上官方 Claude 模型,不需要路由,直接把 Claude Code 指向 cdnd 这样的中转站即可,价格见 Claude Code 价格。如果只是想在几套供应商配置之间快速切换,可以用 cc switch。如果要多模型路由和回退,CCR 本身就是常见的选择。
Claude Code Router 和 cc switch 有什么区别?
cc switch 主要用来管理和切换 Claude Code 的供应商配置,切换后 Claude Code 直接连接所选供应商。CCR 是一个在本地运行的网关,请求先经过它,再按规则分发给不同的模型。用 cdnd 时,cc switch 这种直连的方式更合适,见 cc switch 配置 cdnd。