claude-code-router(社区简称 CCR)是一个把 Claude Code 的请求劫持并转发到任意大模型供应商的本地开源网关:开发者无需 Anthropic 官方账号,即可用 DeepSeek、Kimi、通义、Gemini 等模型驱动 Claude Code 的完整体验。它是国内「AI 开发者工具」赛道「厂商赞助型开源 OPC」的代表样本——项目免费开源(MIT),收入来自厂商赞助与生态位本身。
这个项目提供了一种在 Anthropic 区域限制下运行 Claude Code 的务实路径,在成本、性能与可定制性之间取得平衡。话虽如此,如果条件允许,官方 Max Plan 仍是最佳体验。
—— musistudio,项目自述博客《Project Motivation and Principles》(意译),原文见 [3]| 维度 | 机制与事实 | 信源 |
|---|---|---|
| 路由原理 | 利用 Claude Code 尊重 ANTHROPIC_BASE_URL 环境变量的特性,由 Express.js 在本地实现 /v1/messages 端点;中间件(transformer)完成 Anthropic Messages 格式与各家 API 格式的双向转换,支持按模型改写请求(prompt 调优)。不改动 Claude Code 源码,可随官方更新受益。 | [3] |
| 供应商分流机制 | v1 定型四角色路由:default(通用兜底)/ background(后台轻任务,作者路由至本地 ollama)/ think(推理规划,接 DeepSeek-R1)/ longContext(tiktoken 实时计长,超 32K 自动切换)。v3 改版后扩展为条件路由、有序故障转移(fallback)、请求重写、重试与凭证池。 | [3] [2] |
| 内置 provider 与赞助生态 | 内置预设覆盖 OpenAI Chat/Responses、Anthropic Messages、Gemini、OpenRouter、DeepSeek、SiliconFlow、Moonshot / Kimi Code、Mistral、Z.AI、百炼等,并支持自定义兼容端点;赞助位 12 家厂商 + 社区赞助者名单,Ko-fi/PayPal/支付宝/微信四通道收款。 | [2] |
| 面向客群 | 核心客群为 Claude Code 用户(尤其受区域限制与订阅成本约束的大陆开发者);v3 之后扩展至 Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi、ZCode、WorkBuddy 等全部主流编程 Agent 用户——「一个稳定的本地端点」。 | [2] [4] |
| 解决痛点 | 三重痛点叠加:① 官方订阅贵且有 5 小时限额(社区原声「max 还是有点贵」);② Anthropic 封锁中国大陆,注册/支付/连通全链路受阻;③ 国产模型强且便宜——作者实测 DeepSeek-V3 成本不足 Claude 3.5 Sonnet 十分之一。CCR 让「Claude Code 的壳 + 国产模型的芯」成为可能。 | [3] [7] [13] |
| 商业模式 | 软件本身 MIT 免费开源;收入 = 厂商赞助位(部分含返佣参数)+ 社区打赏 + 桌面版分发(ccrdesk.top)。未检索到公开营收数据。 | [2] [1] |
| 指标 | 数值 | 时点 | 信源 |
|---|---|---|---|
| GitHub 星标 | 38,127(API 实测) | 2026-11-13 | [1] |
| GitHub 星标(第三方索引互证) | 37,985(MeshKore)/36,000+(EveryDev.ai) | 2026-10-10 索引/2026 查询 | [8][9] |
| GitHub Fork | 3,206 | 2026-11-13 | [1] |
| Open issues | 1,200(单人维护压力信号,见柒-7) | 2026-11-13 | [1] |
| Watchers / 主语言 / 许可 | 133 / TypeScript / MIT | 2026-11-13 | [1] |
| 首条可回溯提交 | 2025-02-26「Bypass auth」 | API 实测 | [1] |
| 仓库创建 | 2025-02-25(Claude Code 发布次日) | API 实测 | [1][3] |
| 赞助方 | 厂商位 12 家(Z智谱、AIHubmix、302.AI、RunAPI、七牛云 AI 等)+ Kimi 阶段性具名赞助(历史快照) | 2026-11 README/2026 快照 | [2][8] |
将 CCR 放入案例墙「网关类项目」坐标系(对标数据均引自案例墙既有核验值,时点以案例墙底稿标注为准):
| 对标项目 | 创业者 | 网关类型 | 星标(时点值) | 模式差异 | 信源 |
|---|---|---|---|---|---|
| claude-code-router | musistudio | 细分场景网关:Claude Code(及编程 Agent)专用 | 38,127★(2026-11-13 实测) | 厂商赞助 + 返佣生态;上游模型原厂付费上车 | [1] |
| new-api | Calcium-Ion(个人发起,后转 QuantumNous 组织) | 通用 LLM 网关与 AI 资产管理 | 51.3k★(2026-11-10 案例墙底稿) | 大量商用中转站底座;已组织化(一人属性中) | 案例墙增补批次(2026-11-10)既有核验值 |
| one-api | songquanpeng(justsong) | 通用 LLM API 网关(事实标准前身) | 37.3k★(案例墙底稿) | 密钥管理与二次分发,国内中转站生态起点 | 案例墙 #10 既有核验值 |
| AIClient-2-API | justlovemaki | 协议反代网关:把 Gemini CLI/Codex/Grok 等客户端协议转为本地 OpenAI 兼容 API | 约 8.9k★(案例墙底稿) | 与 CCR 同属「把客户端协议反向开放」路线,无赞助生态披露 | 案例墙 #13 既有核验值 |
四者的分化揭示了网关赛道的两条路线:one-api / new-api 是通用 API 池路线(服务中转站生意,星标更高但已组织化);CCR 与 AIClient-2-API 是细分场景网关路线——前者锚定「Claude Code 生态」这一最高频刚需场景,后者锚定「客户端协议反代」。CCR 的独特性在于其厂商赞助模式:原厂(Kimi)与供应商(智谱、302.AI 等)主动付费上车,使其成为案例墙中少见的「不卖 License、不接融资、靠生态位收租」的开源 OPC 样本;代价是赞助关系随版本更迭(Kimi 已从当前 README 赞助位淡出),稳定性弱于订阅制收入。
| 维度 | 分析 | 信源 |
|---|---|---|
| 1. 产品功能 | 本地模型网关 + 控制平面:格式转换(Anthropic ↔ 各家 API)、按任务类型分流(默认/后台/思考/长上下文)、条件路由与故障转移、凭证池、动态切换(/model)、GitHub Actions 集成、插件系统;v3 后扩展至 10+ 编程 Agent 并提供桌面 App。 | [3] [2] [4] |
| 2. 面向客群 | 直接客群:受区域限制/成本约束的 Claude Code 大陆开发者(V2EX 实证用户以「ccr + openrouter」为现行方案);扩展客群:全部编程 Agent 用户;间接客群:模型供应商与原厂(赞助位买家)。 | [13] [2] |
| 3. 解决痛点 | 官方模型贵 + 区域封锁 + 国产模型强三重痛点(DeepSeek-V3 成本不足 Claude 3.5 Sonnet 十分之一);第三方指南称「把后台与简单任务路由到小模型,可为 Claude Code 会话节省一半以上 token 开支」。 | [3] [10] |
| 4. 预估年化营收(推算,置信度 C) | 零披露,无任何公开营收数据。可核验的收入通道仅为:厂商赞助位(部分含返佣)、Ko-fi/PayPal/支付宝/微信打赏。参照开源工具类项目惯例,赞助收入量级通常不足以替代工资——本案价值更多体现为生态位、影响力与个人品牌(@musistudio2026),而非直接现金流。不作任何数字推算。 | [2] [8] |
| 5. 融资进展 | 未检索到公开融资信息。非货币资源:模型原厂与供应商的赞助合作(Kimi 阶段性具名赞助、智谱等 12 家厂商位)、火山引擎/InfoQ 官方社区教程的渠道背书。 | [8] [4] [5] |
| 6. 市场评价 | 正面信号密集:火山引擎开发者社区与 InfoQ 写作社区将其列为对接国产模型的标准组件[4][5];第三方目录给予工具级推荐位[9][10];中文社区教程(掘金、X-CMD)持续产出[11][12]。负面信号:open issues 高达 1,200,社区对维护响应与配置复杂度存在抱怨(详见捌)。 | 见左列 |
| 7. 投入成本与合规风险 | ① Anthropic 服务条款风险(核心风险):项目的技术前提是逆向官方闭源工具并劫持其请求端点,用于绕过区域限制——作者博客对此完全公开[3];极客公园与 V2EX 社区均记录了 Claude 侧封号/风控压力的环境背景[7][13]。未检索到 Anthropic 对本项目或 musistudio 本人的公开法律行动。② 开源维护可持续性:单人账号主导、1,200 open issues、2026-10 大改版(v3 桌面化)后维护面从单一 CLI 扩大到多 Agent 控制平面——巴士系数(bus factor)为 1 是此类项目最大结构性风险。③ 商用合规:企业若借 CCR 绕过官方区域限制接入生产环境,需自行评估 ToS 与数据出境风险。 | [3] [1] [2] |
本深度报告共引用 13 条信源,按文中首次出现顺序连续编号。上标颜色与文末徽章同色同义:绿 = 已核验(≥2 独立信源交叉),蓝 = 多源印证(单一权威信源可回溯),黄 = 部分映证(自述/转述/第三方快照)。