Repolode
musistudio

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. 1

    安装 npm CLI(需要 Node.js 22 或更高版本)

    npm install -g @musistudio/claude-code-router
  2. 2

    启动管理界面

    ccr ui
  3. 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 数据每日更新。

相关项目