claude-code-router

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

开源 🏷️基础免费，高级付费 ✅ 目前可打开基础设施 🍴 复刻 3189 🐛 待处理 1186 👀 关注 134

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 37977

维护状态较活跃

是否开源开源

定价模式 🏷️基础免费，高级付费支持限时试用 · 开源免费，官网提供云服务入口，定价信息待确认

项目预览

项目数据

分类基础设施

开发团队musistudio

官网地址https://ccrdesk.top

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

定价模式🏷️基础免费，高级付费

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

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言TypeScript

GitHub 星标★ 37977

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

代码更新2026-10-10

仓库体积45.7 MB

本站数据更新2026-11-03

维护状态较活跃

收录时间2026-09-12

浏览次数6

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-12 · 当前星标 ★ 37977

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 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 运行时，该路径不存在时此准备环节可能被跳过。