# Claude Code Router ### 在一个地方，管理你所有的 Agent 与 Provider 让 Claude Code、Claude Design、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi、ZCode、WorkBuddy 和兼容 API 客户端连接你选择的供应商，并在一个应用里完成每次请求的路由、降级、增强与观测。

## 为什么使用 Claude Code Router？ Claude Code Router（CCR）是面向编程 Agent 的本地模型网关与控制平面。它为 Claude Code、Claude Design、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi、ZCode、WorkBuddy 和兼容 API 客户端提供**一个稳定的本地入口**，让你在一个地方管理入口背后的供应商、模型、账号、路由规则与工具。你可以使用 CCR： - **统一管理所有 Agent 与 Provider**，不再为每个客户端维护一套独立模型配置。 - **切换供应商或模型而不改变工作流**，无需反复修改 Agent 配置文件。 - **通过重试、凭据池、Key 轮换和 Fallback 保持请求可用**。 - **通过 Fusion 视觉、联网搜索、MCP 工具和 ToolHub 扩展现有模型**。 - **通过请求日志、最终路由、耗时、Token、成本估算和账号状态了解真实运行情况**。 CCR 支持 OpenAI Chat / Responses、Anthropic Messages、Gemini Generate Content / Interactions、OpenRouter、DeepSeek、SiliconFlow、Moonshot、Kimi Code、Mistral、Z.AI、百炼以及自定义兼容供应商。

支持的 Agent

Claude Code (CLI & APP)	Codex (CLI & APP)	Grok CLI (CLI)	Kimi CLI (CLI)	Kilo Code (CLI)
OpenCode (CLI & APP)	Pi (CLI)	ZCode (APP)	Claude Design (APP)	WorkBuddy (APP)

## 快速开始 ### 桌面端（推荐） 1.

下载 Claude Code Router，选择 macOS、Windows 或 Linux 版本并启动应用。

Windows

Linux

macOS (Apple Silicon)

macOS (Intel)

2. 打开 **供应商 → 添加供应商**。选择内置预设或自定义端点，填写 API Key，选择协议与模型，然后保存。 3. 打开 **服务** 并点击 **启动**。本地模型网关默认监听 `http://127.0.0.1:3456`。 4. 打开 **Agent配置**，选择 Claude Code、Claude Design、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi、ZCode 或 WorkBuddy，指定模型并应用配置档案。 5. 开始使用 Agent。在 **日志** 中确认最终供应商、模型、状态、Token、耗时与错误。现在 Agent 已经连接到 CCR。如需增加条件规则、自动重试、请求改写或 Fallback 模型，请打开 **路由**。 ### CLI npm CLI 要求 Node.js 22 或更高版本。无需 Electron，也能启动相同的模型网关与浏览器管理界面： ```sh npm install -g @musistudio/claude-code-router ccr ui ``` 打开 `http://127.0.0.1:3458`，然后按照上面的 **供应商 → 服务 → Agent 配置档案** 流程操作。模型网关仍位于 `http://127.0.0.1:3456`。服务模式、鉴权和 Profile 命令见 [CLI 命令参考](https://ccrdesk.top/guides/cli/)。 ### Docker ```sh npm run docker:compose:up ``` Docker 默认通过 `http://127.0.0.1:3458` 提供管理界面与网关路由。这个 npm 脚本会在存在 `../../next-ai/gateway` 时先准备本地支持插件的 ai-gateway runtime，再构建镜像。远程暴露 CCR 前，请先阅读 [Docker 部署指南](https://ccrdesk.top/guides/docker/)。 ## 构建桌面应用先安装 Node.js 22+，然后执行 `npm ci`。 | 目标 | 命令 | 产物目录 | | --- | --- | --- | | macOS 本地 DMG/ZIP | `npm run build:app:mac` | `release-local/` | | Windows 本地 NSIS 安装包 | `npm run build:app:win` | `release-local/` | Windows App 打包必须在 Windows x64 上运行，因为 `better-sqlite3` 包含 Electron 原生模块，不能从 macOS 或 Linux 交叉编译。推送 `v*` tag 时，release workflow 会分别在 macOS runner 和 `windows-latest` 上构建 macOS 与 Windows 产物。 ## 工作方式 ```text Claude Code · Claude Design · Codex · Grok CLI · Kimi CLI · Kilo Code · OpenCode · Pi · ZCode · WorkBuddy · 兼容 API 客户端 │ ▼ Claude Code Router :3456 配置档案 · 路由 · 凭据 · 工具 · 日志 │ ▼ 命中的供应商、模型与账号 ``` ## 核心能力 | 能力领域 | 功能亮点 | | --- | --- | | **Agent** | Claude Code、Claude Design、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi、ZCode 和 WorkBuddy 配置档案；模型覆盖；作用范围；环境变量；CLI / App 启动入口；多开工作流 | | **供应商** | 内置预设和自定义端点；协议探测；模型发现；连通性检测；按支持情况导入本机登录态；单 Key 与凭据池 | | **模型与路由** | 可搜索模型目录；用于任务选择的模型描述；Header / Body 条件；模型前缀；请求改写；重试；有序 Fallback | | **工具与扩展** | Fusion 模型；ToolHub；内置浏览器自动化；Chrome 登录态导入；wrapper / core gateway plugin；本地路由与虚拟模型 | | **访问与额度** | 独立的 CCR 客户端 Key，可设置有效期以及本地请求、Token 和图片限额 | | **日志与观测** | 请求 / 响应详情；最终供应商、模型与凭据；状态；耗时；Token；成本估算；工具调用；Agent 执行链路 | | **AgentClaw** | 通过微信 iLink、企业微信、Slack、Discord、Telegram、LINE、飞书和钉钉接力 Agent | ## 准备好后，继续深入完整文档位于 **[ccrdesk.top](https://ccrdesk.top/)**。 - [安装并启动 CCR](https://ccrdesk.top/guides/install/) - [配置供应商](https://ccrdesk.top/guides/provider/) - [了解路由与完整配置](https://ccrdesk.top/configuration/) - [使用 CLI](https://ccrdesk.top/guides/cli/) - [通过 Docker 部署](https://ccrdesk.top/guides/docker/) - [排查常见问题](https://ccrdesk.top/troubleshooting/) ## 支持与赞助

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

_{通过 Ko-fi 单次赞助}

_{国际赞助通道}

支付宝

微信支付

### 我们的赞助商

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

Z智谱	AIHubmix	BurnCloud	302.AI
RunAPI	TeamoRouter	code0.ai	claudeapi
七牛云 AI	Fenno.ai	Unity2.Ai	无限星河

社区赞助者

@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](LICENSE) 发布。