README

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 命令参考。

 Docker

sh
npm run docker:compose:up


Docker 默认通过 http://127.0.0.1:3458 提供管理界面与网关路由。这个 npm 脚本会在存在 ../../next-ai/gateway 时先准备本地支持插件的 ai-gateway runtime，再构建镜像。远程暴露 CCR 前，请先阅读 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 上运行，因为 be

Top issues

Discussions

Latest release

Highlights

- Rebuild the bundled model catalog and publish it to models.ccrdesk.top. The catalog refreshes from the CDN at startup and hourly, with bundled and cached data available offline.
- Improve routing script token estimation, gateway restart recovery, and raw trace delivery.
- Fix Codex session affinity, protocol-specific provider aliases, and upstream streaming resets.
- Add the Y-API provider preset and bound OpenRouter catalog requests with a timeout.

 What's Changed
 fix(gateway): propagate upstream stream resets instead of crashing the core by @Louayzouaoui1 in https://github.co