claude-code-router

本地路由层，让 AI Agent 自由切换模型、组合能力、掌控成本

claude-code-router 是一个本地运行的 AI Agent 控制平面，用 TypeScript 编写。它解决的核心问题是：当你在 Claude Code、Cursor、Cline 等工具里调用模型时，往往被绑定到单一供应商或单一模型，切换成本高、成本不可控、能力无法组合。该项目在本地起一个路由层，把请求按规则分发到不同模型（如 Claude、GPT、Gemini、本地模型），并支持在路由过程中融合新能力、编排工具调用，让开发者完全掌控请求走向与数据流向。它不替代 Agent 本身，而是作为 Agent 与模型之间的中间层，统一管理模型选择、故障回退、成本优化和工具链编排。对需要多模型混用、想降低 API 开销、或要求数据不出本地的团队来说，它提供了一种可自托管的集中控制方案。

开源 freemium 基础设施

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 37268

维护状态活跃

是否开源是

定价模式 freemium

项目数据

分类基础设施

开发团队musistudio

所属国家

官网地址https://ccrdesk.top

GitHubhttps://github.com/musistudio/claude-code-router

定价模式freemium

价格说明开源免费，官网提供云服务入口，定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型

GitHub 星标★ 37268

30天Star增速

HF 下载量

上线时间2025-02-25 00:00:00

最近更新2026-09-16 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-12

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：Docker 4 步

环境要求

已安装 Node.js 与 npm（用于执行 npm run 脚本）
已安装 Docker 与 Docker Compose（以容器方式运行 CCR）
本机 127.0.0.1:3458 端口未被占用

安装与启动步骤

1克隆项目仓库

从 GitHub 拉取 claude-code-router 源码到本地当前目录，得到 claude-code-router 文件夹。
```
git clone https://github.com/musistudio/claude-code-router.git
```
2进入项目目录

切换到仓库根目录，后续 npm 脚本需在项目根目录执行。
```
cd claude-code-router
```
3启动 Docker 服务

执行 README 提供的 Docker 启动脚本，它会准备支持插件的 ai-gateway 运行时并构建镜像后启动容器。
```
npm run docker:compose:up
```
4打开管理界面

容器启动后，管理 UI 与网关路由默认通过 http://127.0.0.1:3458 暴露，在浏览器中访问即可。

如何确认成功

浏览器访问 http://127.0.0.1:3458，能打开 CCR 的管理界面即表示启动成功。

常见问题

Q：启动后应该访问哪个地址？

A：默认是 http://127.0.0.1:3458，管理 UI 和网关路由都通过这个地址暴露，无需额外改端口。

Q：可以把它部署到远程服务器对外暴露吗？

A：README 明确提示：在把 CCR 暴露到远程之前，先阅读官方 Docker 部署指南 https://ccrdesk.top/en/guides/docker/。

Q：npm run docker:compose:up 到底做了什么？

A：它会先准备本地支持插件的 ai-gateway 运行时（当 ../../next-ai/gateway 存在时），再构建镜像并启动容器。

Q：运行前需要自己装 Docker 吗？

A：需要。该方式是 Docker 部署，本机必须先具备 Docker 与 Docker Compose，同时需要 npm 来执行该脚本。

注意事项

README 只提供了 Docker 方式的 Quick Start，没有给出 npm 全局安装或源码直跑的安装命令。
服务默认绑定 127.0.0.1:3458，仅本机可访问；对外暴露前务必阅读官方 Docker 部署指南。
README 提到当 ../../next-ai/gateway 目录存在时，脚本会先准备支持插件的 ai-gateway 运行时，该路径不存在时此准备环节可能被跳过。

核心亮点

本地控制平面，请求与密钥不经过第三方中转，数据流向可控
支持跨模型路由与故障回退，可按规则在 Claude、GPT、Gemini 等之间切换
可编排工具调用并融合新能力，方便在现有 Agent 上叠加自定义逻辑

不足之处

路由规则和工具编排需要一定配置成本，新手直接上手有门槛
作为中间层会引入额外延迟，对极低延迟场景需评估

适用场景

团队同时使用多个模型供应商，希望按任务类型自动路由并控制成本
开发者想在 Claude Code 中混用本地模型与云端模型，兼顾隐私与能力
需要为多个 AI Agent 统一管理模型密钥、回退策略和工具调用链

替代项目

LiteLLM、OpenRouter

项目介绍

claude-code-router 是一个基础设施领域的开源项目，官方简介：One local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.。项目使用 TypeScript 开发，在 GitHub 上获得 37191 星标。

上一篇：doris

下一篇：agentsight