claude-code-router/README_zh.md

Claude Code Router

Claude Code Router Desktop 是一个本地网关和桌面控制台，用来把 Claude Code、Codex、ZCode 以及兼容客户端的 Agent 请求路由到你真正想使用的模型服务。

为什么使用 CCR

• 用一个本地入口连接多个 Agent 工具，不需要在每个客户端里重复配置 Provider。
• 在不改变工作流的情况下混用不同 Provider。CCR 支持 OpenAI 兼容 API、Anthropic Messages、Gemini Generate Content、OpenRouter、DeepSeek、SiliconFlow、Moonshot、Kimi Code、Mistral、Z.AI、百炼以及自定义 Provider。
• 通过 fallback 路由、API Key 轮换、用量统计和请求日志来控制成本和可靠性。

功能和特性

• 概览仪表盘：查看系统状态、用量组件、账号余额、模型分布和分享卡片。
• Provider 管理：添加预设或自定义端点，探测协议支持，检测模型连通性，管理凭据，并在可用时查看账号余额。
• 路由规则：配置条件路由、模型前缀规则、失败降级和请求改写。
• Agent配置：为 Claude Code、Codex 和 ZCode 配置启动入口、模型、作用范围和多开 App 配置。
• 网关兼容层：通过本地 CCR 模型网关转换支持的客户端请求。
• 代理模式：通过本地代理捕获支持的 API 流量，可选系统代理和网络捕获。
• Fusion 组合模型：把基础模型与视觉、联网搜索或 MCP 工具组合成新的可选模型。

文档

完整文档见 ccrdesk.top。

下载和安装

1. 打开 GitHub Releases 页面。
2. 按系统下载对应安装包：
   • macOS Apple 芯片：Claude-Code-Router_<version>-mac-Apple-Silicon-arm64.dmg 或 .zip
   • macOS Intel 芯片：Claude-Code-Router_<version>-mac-Intel-x64.dmg 或 .zip
   • Windows：Claude Code Router_<version>.exe
   • Linux：Claude Code Router_<version>.AppImage
3. 安装并启动 Claude Code Router。
4. 首次启动后，CCR 会创建本地配置数据库：
   • macOS/Linux：~/.claude-code-router/config.sqlite
   • Windows：%APPDATA%\Claude Code Router\config.sqlite

CCR 的运行配置存储在 SQLite 中。旧版 config.json 只会在没有 SQLite 配置时作为迁移来源读取一次。

从 服务 页面启动后，CCR 默认监听 http://localhost:8080。服务 页面负责配置网关 Host、Port、代理模式、系统代理、网络捕获和 CA 证书状态。

快速开始

CCR 可以完全通过桌面 UI 完成配置。首次使用建议按下面顺序操作。

1. 添加 Provider

打开 供应商，点击 添加供应商，选择内置预设或 其他 / 自定义 API 端点。按表单填写 Provider 名称、基础 URL、协议、API Key 和模型列表。可用时先运行协议探测和模型连通性检查，然后保存 Provider。

2. 设置路由

打开 路由，添加条件规则，配置请求改写和失败降级。

如果需要更细粒度控制，使用 添加路由规则 添加模型前缀、请求条件或规则级失败降级目标。

3. 启动网关

打开 服务，点击 启动。页面显示运行中后，CCR 会在本机监听 http://localhost:8080。如果希望每次打开桌面应用时自动启动网关，可以启用自动启动。

4. 连接 Agent 工具

打开 Agent配置，选择要使用的客户端。配置 Claude Code、Codex 或 ZCode，选择目标模型和作用范围，然后应用配置。对于 App 入口，可以使用 打开 Agent 操作通过 CCR 打开目标应用。

5. 日常查看和调整

到 设置 → 日志与观测 打开请求日志和 Agent 观测。使用 日志 确认 request model、resolved provider、resolved model、状态码、tokens、耗时和错误；使用托盘窗口快速查看 Token 和账号状态。

致谢

对 Codex 的支持来自于 musistudio/codexl 这个项目。

支持与赞助

如果你觉得这个项目有帮助，欢迎赞助项目开发。非常感谢你的支持。

通过 Ko-fi 单次赞助

国际赞助通道

支付宝

微信支付

我们的赞助商

非常感谢所有赞助商的慷慨支持。

Z智谱	AIHubmix	BurnCloud	302.AI
RunAPI	TeamoRouter

社区赞助者

@Simon Leischnig	@duanshuaimin	@vrgitadmin	@*o	@ceilwoo	@*说
@*更	@K*g	@R*R	@bobleer	@*苗	@*划
@Clarence-pan	@carter003	@S*r	@*晖	@*敏	@Z*z
@*然	@cluic	@*苗	@PromptExpert	@*应	@yusnake
@*飞	@董*	@*汀	@*涯	@*:-）	@**磊
@*琢	@*成	@Z*o	@*琨	@congzhangzh	@*_
@Z*m	@*鑫	@c*y	@*昕	@witsice	@b*g
@*亿	@*辉	@JACK	@*光	@W*l	@kesku
@biguncle	@二吉吉	@a*g	@*林	@*咸	@*明
@S*y	@f*o	@*智	@F*t	@r*c	@qierkang
@*军	@snrise-z	@*王	@greatheart1000	@*王	@zcutlip
@Peng-YM	@*更	@*.	@F*t	@*政	@*铭
@*叶	@七*o	@*青	@**晨	@*远	@*霄
@**吉	@**飞	@**驰	@x*g	@**东	@*落
@哆*k	@*涛	@苗大	@*呢	@d*u	@crizcraig
s*s	*火	*勤	**锟	*涛	**明
*知	*语	*瓜

_{如果你的名字被打码，请通过我的主页邮箱联系我更新为 GitHub 用户名。}

许可证

本项目基于 MIT License 发布。