musistudio/claude-code-router

Claude Code Router (CCR)

是什麼 – 一個本地網關與控制平面桌面（及CLI）應用程式，可將數十個面向程式碼的AI代理（Claude Code、Claude Design、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi、ZCode、WorkBuddy等）視為使用同一API。您只需一次設定提供者（OpenAI、Anthropic、Gemini、Moonshot、Kimi、Mistral、自訂端點等），即可將任何支援的客戶端指向 http://127.0.0.1:3456。

為什麼值得關注

• 單一真實來源：API金鑰、模型選擇與路由規則的統一管理。
• 零程式碼切換提供者：無需修改每個代理的設定，即可更換模型或備用提供者。
• 可靠性功能：自動重試、憑證池、金鑰輪替、有序回退。
• 可觀測性：即時日誌顯示已解析的提供者、模型、Token使用量、延遲、成本估算與工具呼叫。
• 可擴展性：支援「Fusion」視覺模型、網路搜尋、自訂工具，以及「ToolHub」以增強額外功能。
• 多平台支援：提供Windows/macOS/Linux的Electron桌面應用、純Node CLI（npm i -g @musistudio/claude-code-router），以及Docker Compose部署。

運作原理（高階流程）

[代理（Claude Code、Codex等）] → CCR網關（localhost:3456）
    ├─ 設定檔 – 每個代理的設定（模型、環境、範圍）
    ├─ 路由 – 條件性重寫、重試、回退
    ├─ 憑證 – 提供者預設、金鑰池
    └─ 工具 – Fusion視覺、網路搜尋、自訂外掛
        ↓
[選定的提供者端點]（OpenAI、Anthropic、Kimi等）

快速入門

1. 從GitHub發布頁面下載適用於您作業系統的桌面二進位檔（Windows .exe、macOS .dmg、Linux .AppImage）。
2. 開啟應用程式，新增提供者預設或自訂端點，貼上API金鑰並儲存。
3. 點選 Server → Start – 網關將在 127.0.0.1:3456 啟動。
4. 在 Agent Config 中選擇您想要的代理（例如 Claude Code），並選擇一個模型設定檔。
5. 像平常一樣執行代理；CCR將路由請求並記錄詳細資訊。

CLI替代方案 – 安裝 npm i -g @musistudio/claude-code-router 後，執行 ccr ui 啟動相同的Web UI（預設位址為 http://127.0.0.1:3458）。Docker使用者可執行 docker compose up -d 啟動UI與網關。

核心功能

領域	您可獲得的功能
代理	10+個程式碼代理的預設設定檔、模型覆蓋、多執行個體工作流程
提供者	OpenAI、Anthropic、Gemini、Moonshot、Kimi、Mistral、OpenRouter、DeepSeek等內建預設；支援自訂端點
路由	條件路由規則、請求/回應重寫、重試策略、有序回退
工具與擴充	Fusion視覺模型、網路搜尋、瀏覽器自動化、Chrome登入匯入、外掛架構
可觀測性	每個請求的詳細日誌，包含提供者、模型、Token數量、延遲、估算成本、工具呼叫
存取控制	帶配額、到期時間、每請求限制的本地客戶端金鑰
AgentClaw	將代理轉發至聊天平台（WeChat、Slack、Discord、Telegram、LINE、Feishu、DingTalk）

文件與支援 – 完整指南、API參考與故障排除文件托管於 ccrdesk.top。README中列出了Discord社群與贊助連結。

授權 – 專案倉儲採用MIT授權發布。

---

以上所有資訊均直接取自專案README；未推斷任何額外功能。