本地网关与菜单栏应用,让 Claude Code、Codex、Gemini CLI 等编程智能体可以使用任意服务商或订阅的模型。
musistudio/claude-code-router
本地模型网关,让 Claude Code、Codex、OpenCode 等编程代理共用一个端点,并把请求路由到多个模型提供商。
- Star
- 37,751
- Fork
- 3,168
- 未关闭 Issue
- 1,150
- 最近提交
- 10天前
这是什么?
Claude Code Router(CCR)是一个本地运行的模型网关,为 Claude Code、Codex、Grok CLI、Kimi CLI、OpenCode、Pi 等编程代理提供一个稳定的本地端点。提供商、模型、账号和路由规则统一在一处管理,各个代理无需单独维护模型配置。
请求可以根据请求头和请求体中的条件进行路由,也可以改写、重试,或按顺序切换到备用模型;凭证池和密钥轮换可以帮助请求持续运行。项目支持 OpenAI Chat 和 Responses、Anthropic Messages、Gemini 协议,以及 OpenRouter、DeepSeek、Mistral 等多个兼容提供商。
项目提供桌面应用、带浏览器管理界面的 CLI,以及 Docker 部署方式。请求日志可查看实际解析的提供商和模型、状态、延迟、token 用量和预估费用。
核心功能
- 01为多个编程代理和 API 客户端提供统一的本地端点。
- 02支持按条件、前缀和改写规则路由请求,并提供重试与有序备用模型。
- 03通过凭证池和密钥轮换管理提供商与账号。
- 04记录每次请求实际使用的提供商、模型、延迟、token 用量和预估费用。
- 05提供桌面应用、带网页界面的 npm CLI 以及 Docker 部署方式。
适用场景
- 让 Claude Code 或 Codex 使用非 Anthropic、非 OpenAI 的模型提供商。
- 在某个提供商限流或报错时自动切换到备用模型。
- 在一台开发机上让多个编程代理共用同一组提供商密钥。
- 统计不同编程代理的 token 用量和费用。
快速上手
- 1
安装 npm CLI(需要 Node.js 22 或更高版本)
npm install -g @musistudio/claude-code-router - 2
启动管理界面
ccr ui - 3
打开界面,添加服务商,启动服务,并应用 Agent 配置;网关地址为 http://127.0.0.1:3456
使用前须知
- 需要自备 API 密钥或服务商账户才能转发请求。
- 通过 Docker 远程暴露前需要谨慎配置安全措施。
标签
常见问题
- claude-code-router 是什么?
- 本地模型网关,让 Claude Code、Codex、OpenCode 等编程代理共用一个端点,并把请求路由到多个模型提供商。 Claude Code Router(CCR)是一个本地运行的模型网关,为 Claude Code、Codex、Grok CLI、Kimi CLI、OpenCode、Pi 等编程代理提供一个稳定的本地端点。提供商、模型、账号和路由规则统一在一处管理,各个代理无需单独维护模型配置。
- claude-code-router 可以免费使用吗?用的什么许可证?
- claude-code-router 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- claude-code-router 还在维护吗?
- 活跃维护中。claude-code-router 最近一次提交是在 2026年10月10日。
- claude-code-router 适合用来做什么?
- 让 Claude Code 或 Codex 使用非 Anthropic、非 OpenAI 的模型提供商。 在某个提供商限流或报错时自动切换到备用模型。 在一台开发机上让多个编程代理共用同一组提供商密钥。 统计不同编程代理的 token 用量和费用。
- claude-code-router 怎么安装和运行?
- 安装 npm CLI(需要 Node.js 22 或更高版本): npm install -g @musistudio/claude-code-router 启动管理界面: ccr ui 打开界面,添加服务商,启动服务,并应用 Agent 配置;网关地址为 http://127.0.0.1:3456
- 在哪里获取 claude-code-router?
- 源代码和安装说明在 GitHub 上:https://github.com/musistudio/claude-code-router
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
为 AI 编程代理设计的 MCP 服务,把工具原始输出挡在上下文窗口之外,并在对话压缩后保留会话状态。
一个让编程助手先给出下一步操作、去掉寒暄和冗余的技能,输出更适合 ADHD 用户阅读。
专为 AI 智能体与人类共用设计的浏览器,智能体在独立 Space 中执行任务,不打扰你的标签页与登录状态。
为 Claude Code、Kiro、Codex CLI、Cursor 等 AI 编程助手提供分阶段的软件交付工作流规则。
让 Claude Code / Codex 制作口播解说视频的 agent skill,支持字级配音同步与 Remotion 渲染。