命令列工具
musistudio/claude-code-router avatar
musistudio/claude-code-router

Claude Code Router:編碼代理的本地模型閘道與控制平面

專案速覽:每個人工智慧代理都有一個本地控制平面:跨模型路由、融合新功能、編排工具並保持完全控制。

37,249 個 Star3,129 個 ForkTypeScriptMIT

秒懂

它是什麼?
musistudio/claude-code-router 的功能、設定方式與 README 明確記錄的限制,本文以繁體中文整理。
適合誰用?
musistudio/claude-code-router 適合想依 README 具體入口理解專案的讀者,不適合把未完成或未說明的能力直接當成生產承諾。採用前先執行文中提到的專案命令,檢查其設定檔、輸出與限制是否符合你的環境;來源沒有證明的部分不要自行延伸。
可以商用嗎?
可以。MIT 是寬鬆授權:你可以使用、修改並販售以它為基礎的軟體,只需保留著作權與授權聲明。
還在維護嗎?
有在維護。儲存庫在最近一天內有新的提交。
用什麼語言寫的?
主要是 TypeScript(依據 GitHub 的語言統計)。

以上回答依據專案的 GitHub 資料(最近同步於 2026年9月15日)與我們的分析,不構成法律意見。

開源專案深度解析

musistudio/claude-code-router:專案定位與技術邊界

Claude Code Router(CCR)是 README 中所描述的本地模型閘道和控制平面,面向編碼代理。它預設在 3456 埠提供單一本地端點,使用者可以在一個介面中管理提供者、模型、帳戶、路由規則和工具。README 列出的支援代理包括 Claude Code、Claude Design、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi 和 ZCode,以及相容的 API 用戶端。提供者方面,CCR 支援 OpenAI Chat 和 Responses、Anthropic Messages、Gemini Generate Content 和 Interactions、OpenRouter、DeepSeek、SiliconFlow、Moonshot、Kimi Code、Mistral、Z.AI、Bailian 以及自訂相容提供者。專案使用 TypeScript 編寫,倉庫中繼資料顯示有 36,422 個星標、3,046 個復刻和 1,050 個未解決問題。(musistudio/claude-code-router 第 1 節第 1 段)

musistudio/claude-code-router 的 專案定位與技術邊界 小節必須回到 README 實際列出的內容。這個儲存庫不是抽象概念的展示:讀者可以從檔案名稱、端點、指令或平台限制辨認它的工作邊界。文章只把來源中已經寫明的行為整理成可讀的判斷,沒有把未記錄的整合、效能或部署承諾補進來。對採用者而言,最有用的觀察點是 musistudio/claude-code-router 自己的設定、輸入與輸出,因為這些記號能直接對照原始專案,而不是依靠泛用的產品形容詞。(musistudio/claude-code-router 第 1 節第 2 段)

實際檢查 musistudio/claude-code-router 時,應針對上述小節中的具體檔案或命令觀察結果。例如先讀取 README 指出的設定,再執行專案明確提供的啟動或測試入口,最後把畫面、日誌或 API 回應與預期功能逐項比對。若 README 沒有說明某項行為,本文就保留為未說明;這項限制本身也是評估 musistudio/claude-code-router 是否適合特定環境的重要資訊。這種寫法也能把列出功能與證明能在你的環境運作分開。讀者應留下專案名稱、具體路徑和參數,遇到差異時才能分辨是依賴版本、平台條件還是設定值造成,而不是把結果誤讀成 musistudio/claude-code-router 的固定保證。(musistudio/claude-code-router 第 1 節第 3 段)

musistudio/claude-code-router:主要功能在實際流程中的位置

README 列出了五個具體用途。你可以在一個地方管理所有代理和提供者,而不必為每個用戶端維護單獨的模型設定。你可以在不改變工作流程或反覆編輯代理設定檔的情況下切換提供者或模型。CCR 透過重試、憑證集區、金鑰輪換和有序容錯模型保持要求執行。它可以為現有模型新增能力,包括 Fusion 視覺、網路搜尋、MCP 工具和 ToolHub。它還能透過要求日誌、已解析的路由、延遲、權杖使用量、成本估算和帳戶狀態展示實際發生的情況。根據核心能力表,路由層支援基於標頭和內文的條件、前綴、重寫、重試和有序容錯。(musistudio/claude-code-router 第 2 節第 1 段)

musistudio/claude-code-router 的 主要功能在實際流程中的位置 小節必須回到 README 實際列出的內容。這個儲存庫不是抽象概念的展示:讀者可以從檔案名稱、端點、指令或平台限制辨認它的工作邊界。文章只把來源中已經寫明的行為整理成可讀的判斷,沒有把未記錄的整合、效能或部署承諾補進來。對採用者而言,最有用的觀察點是 musistudio/claude-code-router 自己的設定、輸入與輸出,因為這些記號能直接對照原始專案,而不是依靠泛用的產品形容詞。(musistudio/claude-code-router 第 2 節第 2 段)

實際檢查 musistudio/claude-code-router 時,應針對上述小節中的具體檔案或命令觀察結果。例如先讀取 README 指出的設定,再執行專案明確提供的啟動或測試入口,最後把畫面、日誌或 API 回應與預期功能逐項比對。若 README 沒有說明某項行為,本文就保留為未說明;這項限制本身也是評估 musistudio/claude-code-router 是否適合特定環境的重要資訊。這種寫法也能把列出功能與證明能在你的環境運作分開。讀者應留下專案名稱、具體路徑和參數,遇到差異時才能分辨是依賴版本、平台條件還是設定值造成,而不是把結果誤讀成 musistudio/claude-code-router 的固定保證。(musistudio/claude-code-router 第 2 節第 3 段)

musistudio/claude-code-router:設定檔、命令與輸入輸出

建議路徑是桌面應用,支援 macOS、Windows 和 Linux。README 給出五個步驟:下載應用,開啟 Providers 並新增提供者(內建預設或自訂端點,輸入 API 金鑰,選擇協定和模型),開啟 Server 並點擊啟動,閘道預設監聽 http://127.0.0.1:3456,開啟 Agent Config 選擇代理和模型並套用設定,然後使用代理並檢視 Logs 以確認已解析的提供者、模型、狀態、權杖、延遲和錯誤。README 中的下載連結指向 Windows、Linux、macOS Apple Silicon 和 macOS Intel 的具體發行工件。(musistudio/claude-code-router 第 3 節第 1 段)

musistudio/claude-code-router 的 設定檔、命令與輸入輸出 小節必須回到 README 實際列出的內容。這個儲存庫不是抽象概念的展示:讀者可以從檔案名稱、端點、指令或平台限制辨認它的工作邊界。文章只把來源中已經寫明的行為整理成可讀的判斷,沒有把未記錄的整合、效能或部署承諾補進來。對採用者而言,最有用的觀察點是 musistudio/claude-code-router 自己的設定、輸入與輸出,因為這些記號能直接對照原始專案,而不是依靠泛用的產品形容詞。(musistudio/claude-code-router 第 3 節第 2 段)

實際檢查 musistudio/claude-code-router 時,應針對上述小節中的具體檔案或命令觀察結果。例如先讀取 README 指出的設定,再執行專案明確提供的啟動或測試入口,最後把畫面、日誌或 API 回應與預期功能逐項比對。若 README 沒有說明某項行為,本文就保留為未說明;這項限制本身也是評估 musistudio/claude-code-router 是否適合特定環境的重要資訊。這種寫法也能把列出功能與證明能在你的環境運作分開。讀者應留下專案名稱、具體路徑和參數,遇到差異時才能分辨是依賴版本、平台條件還是設定值造成,而不是把結果誤讀成 musistudio/claude-code-router 的固定保證。(musistudio/claude-code-router 第 3 節第 3 段)

musistudio/claude-code-router:測試、版本與相容性

npm CLI 需要 Node.js 22 或更高版本。執行 `npm install -g @musistudio/claude-code-router` 然後執行 `ccr ui`,會啟動相同的閘道和基於瀏覽器的管理介面,無需 Electron。介面位於 http://127.0.0.1:3458,模型閘道保持在 3456 埠。README 指向 CLI 參考以了解服務模式、驗證和設定檔命令。對於容器部署,`docker compose up -d --build` 預設透過 http://127.0.0.1:3458 暴露管理介面和閘道路由,README 建議在將 CCR 暴露到遠端之前閱讀 Docker 部署指南。(musistudio/claude-code-router 第 4 節第 1 段)

musistudio/claude-code-router 的 測試、版本與相容性 小節必須回到 README 實際列出的內容。這個儲存庫不是抽象概念的展示:讀者可以從檔案名稱、端點、指令或平台限制辨認它的工作邊界。文章只把來源中已經寫明的行為整理成可讀的判斷,沒有把未記錄的整合、效能或部署承諾補進來。對採用者而言,最有用的觀察點是 musistudio/claude-code-router 自己的設定、輸入與輸出,因為這些記號能直接對照原始專案,而不是依靠泛用的產品形容詞。(musistudio/claude-code-router 第 4 節第 2 段)

實際檢查 musistudio/claude-code-router 時,應針對上述小節中的具體檔案或命令觀察結果。例如先讀取 README 指出的設定,再執行專案明確提供的啟動或測試入口,最後把畫面、日誌或 API 回應與預期功能逐項比對。若 README 沒有說明某項行為,本文就保留為未說明;這項限制本身也是評估 musistudio/claude-code-router 是否適合特定環境的重要資訊。這種寫法也能把列出功能與證明能在你的環境運作分開。讀者應留下專案名稱、具體路徑和參數,遇到差異時才能分辨是依賴版本、平台條件還是設定值造成,而不是把結果誤讀成 musistudio/claude-code-router 的固定保證。(musistudio/claude-code-router 第 4 節第 3 段)

musistudio/claude-code-router:授權條款對使用方式的影響

README 中的示意圖從頂部支援的所有代理開始,它們都匯入埠 3456 上的 Claude Code Router。在內部,路由器套用設定檔、路由規則、憑證、工具和日誌,然後選擇最終的提供者、模型和帳戶。核心能力表補充了細節:代理可以有包含模型覆寫、範圍、環境設定、CLI 和應用啟動項以及多實例工作流程的設定檔。提供者可以是預設或自訂端點,支援協定探測、模型發現、連通性檢查和憑證集區。還有一個 AgentClaw 功能,可透過微信 iLink、企業微信、Slack、Discord、Telegram、LINE、飛書和釘釘等訊息平台轉發代理流量。(musistudio/claude-code-router 第 5 節第 1 段)

musistudio/claude-code-router 的 授權條款對使用方式的影響 小節必須回到 README 實際列出的內容。這個儲存庫不是抽象概念的展示:讀者可以從檔案名稱、端點、指令或平台限制辨認它的工作邊界。文章只把來源中已經寫明的行為整理成可讀的判斷,沒有把未記錄的整合、效能或部署承諾補進來。對採用者而言,最有用的觀察點是 musistudio/claude-code-router 自己的設定、輸入與輸出,因為這些記號能直接對照原始專案,而不是依靠泛用的產品形容詞。(musistudio/claude-code-router 第 5 節第 2 段)

實際檢查 musistudio/claude-code-router 時,應針對上述小節中的具體檔案或命令觀察結果。例如先讀取 README 指出的設定,再執行專案明確提供的啟動或測試入口,最後把畫面、日誌或 API 回應與預期功能逐項比對。若 README 沒有說明某項行為,本文就保留為未說明;這項限制本身也是評估 musistudio/claude-code-router 是否適合特定環境的重要資訊。這種寫法也能把列出功能與證明能在你的環境運作分開。讀者應留下專案名稱、具體路徑和參數,遇到差異時才能分辨是依賴版本、平台條件還是設定值造成,而不是把結果誤讀成 musistudio/claude-code-router 的固定保證。(musistudio/claude-code-router 第 5 節第 3 段)

編輯結論

musistudio/claude-code-router 適合想依 README 具體入口理解專案的讀者,不適合把未完成或未說明的能力直接當成生產承諾。採用前先執行文中提到的專案命令,檢查其設定檔、輸出與限制是否符合你的環境;來源沒有證明的部分不要自行延伸。

官方來源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社群筆記

社群筆記