Claude Code Router：在任何型號上執行 Claude Code 的操作指南 (2026)

Claude Code 發出的每個請求都以相同的頻率存取同一個 Anthropic 端點——無論是命名分支、掃描資料夾還是重寫一個 200 行的模組。我運行著十個獨立的品牌容器，當我查看日誌時，發現 Claude Code 整天做的大部分工作都是一些廉價的、一次性的工作，卻按最高價計費。 克勞德代碼路由器 它解決了這個問題。它是一個小型開源代理，位於 Claude Code 前端，並將每個請求發送到真正適合該任務的模型——對於枯燥乏味的任務使用廉價模型，對於真正重要的任務使用前沿模型。.

這是一份操作指南，而非示範。我將向您展示 Claude Code 路由器的具體功能，如何在五分鐘內完成安裝，以及如何編寫… config.json 它會聰明地規劃路線，而且——大多數教程都會忽略這一點——告訴你什麼時候真的值得，什麼時候根本不用費心。沒有廢話，只有實實在在的數據。.

什麼是 Claude Code Router？

Claude Code Router (CCR) 是一個開源的本機代理程式－這個專案是 @musistudio/claude-code-router Claude Code (CCR) 在 GitHub 上發布，採用 MIT 許可證，擁有超過 36,000 個 star。預設情況下，Claude Code 只能與 Claude 通訊。 CCR 會在要求離開您的電腦之前攔截它們，並根據您指定的提供者重寫它們，並根據請求類型選擇合適的模型。您可以使用以下命令啟動代理： ccr程式碼 而不是 克勞德, 除此之外，你的工作流程不會有任何其他變化。.

它解決的問題是單一供應商依賴。當所有流量都透過同一個供應商路由時，你會同時繼承該供應商的所有限制：

• 定價 — 即使小型機型完全可以勝任的工作，你也要支付頂級機型的產出價格。.
• 速率限制 — 一個模型故障就可能導致整個會話中斷。.
• 背景上限 — 您只能使用一家供應商提供的最長窗口期。.

Claude Code 路由器會將這三個參數都回傳給你。你只需定義一次路由規則，請求就會根據任務類型、令牌數量或你指定的任何邏輯自動切換模型。如果你還在猶豫 Claude Code 是否該加入你的技術棧，我的分析如下： 克勞德代碼與代碼 最好從這裡入手——路由器是你添加的一層。 後 您已委託 Claude Code 為您的代理人。.

Claude Code Router 的實際工作原理

這種思維模型就是一個代理網關。當你啟動 CCR 時，它會綁定到本機連接埠—— 127.0.0.1:3456 預設情況下，它會將自身置於 Claude Code 用戶端和任何外部 LLM 提供者之間。從 Claude Code 的角度來看，它只是在與本地端點通訊。實際上，路由器會即時決定每個請求的實際去向。.

對於每個請求，Claude Code 路由器都會執行以下四個操作：

1. 檢查 對請求進行分類，並按類型進行分類。.
2. 適用 使用路由規則選擇提供者和型號。.
3. 轉換 將有效載荷轉換為該提供者期望的格式。.
4. 前鋒 然後，它將回應轉換回 Claude Code 所期望的形式。.

最後一步正是讓整個過程感覺流暢而非生硬的原因：客戶端完全察覺不到任何變化。由於代理伺服器運行在本地，您的請求負載在到達目的地之前無需經過第三方聚合服務——對於任何處理客戶端資料的人來說，這不僅節省了成本，還保障了隱私安全。此外，此轉換器系統還允許您在自己的機器上修改請求頭、移除快取欄位並限制令牌數量。如果您重視這種控制，它與我在上文中提到的方法自然契合。 克勞德代碼安全.

五分鐘內安裝 Claude Code 路由器

您需要 Node.js v18 或更高版本，全域安裝 Claude Code，以及至少一個模型後端——可以是來自支援提供者的 API 金鑰，也可以是本機 Ollama 實例。就這些。您無需預先註冊所有提供者的帳戶；一個可用的後端就足夠了。.

全域安裝這兩個軟體包：

npm install -g @anthropic-ai/claude-code npm install -g @musistudio/claude-code-router

在 Linux 系統上，您可能會遇到權限錯誤，因為 npm 嘗試寫入 root 使用者擁有的目錄。 不是 伸手 sudo. 將 npm 的全域前綴重新導向到您已擁有的資料夾：

mkdir -p ~/.npm-global npm config set prefix '~/.npm-global' export PATH=~/.npm-global/bin:$PATH

加上這一點 出口 連接到你的線路 ~/.bashrc 或者 ~/.zshrc 因此，即使切換到新的 shell 後，它也能繼續運作。安裝完成後，CLI 就… ccr. 以下是您實際將要使用的命令：

• ccr程式碼 — 透過路由器啟動 Claude Code。這是你的主要入口點；它會同時啟動代理程式和客戶端。.
• ccr 使用者介面 — 開啟 web 設定編輯器，而不是手動編寫 JSON。.
• ccr 開始 / ccr 停止 / ccr重啟 — 直接控制後台路由器服務。.

跑步 ccr程式碼 您正在進行路由。若要確認路由是否生效，請檢查 ~/.claude-code-router/logs/ 為 ccr-*.log 文件並追蹤它以即時查看請求：

tail -f ~/.claude-code-router/logs/$(ls -t ~/.claude-code-router/logs/ | head -1)

該日誌也是您調試的第一步。如果 Claude Code 啟動但回傳空回應或格式錯誤，90% 的情況下是提供者格式不符——使用了錯誤的提供者。 變壓器, 或者一個 api_base_url 指向的是基礎網域而不是完整的端點。日誌會準確地顯示哪個請求失敗以及提供者傳回的內容，這樣您就可以修復配置項，而無需猜測。更改配置，運行 ccr重啟, 新規則無需修改 shell 會話即可載入。將日誌視為真實可靠的資訊來源，設定過程將不再神秘。.

設定 config.json：提供者和路由規則

所有配置都位於 ~/.claude-code-router/config.json. 在進行任何複雜的配置之前，先選擇一個已知可靠的路由器－這樣可以隔離變數並確認基礎配置是否正常運作。在新機器上，我首先會選擇 OpenRouter，因為一個 API 金鑰就能讓你取得數十種路由器模型（包含免費模型），用於測試路由層。.

以下是使用 OpenRouter 的最小設定範例：

{ "Providers": [ { "name": "openrouter", "api_base_url": "https://openrouter.ai/api/v1/chat/completions", "api_key": "$OPENROUTER_API_KEY", "models": ["useopenai/gpt-oss-120b);" "Router": { "default": "openrouter,openai/gpt-oss-120b:free" } }

這裡有三點要注意：

• api_base_url 必須指向提供者的 滿的 應該是聊天內容補全接口，而不僅僅是基礎域名。這是最常見的設定錯誤。.
• 變壓器 它會告訴 CCR 使用哪個內建的有效負載適配器，因為不同的提供者期望不同的請求格式。它會靜默地處理轉換過程。.
• 路由器預設 是任何不符合更具體規則的情況的備選方案，寫法如下： 提供者、模型.

切勿將 API 金鑰硬編碼到文件中。 CCR 會遞歸地插值環境變量，因此請使用 $OPENROUTER_API_KEY 並在 shell 中導出實際值。隨著您添加更多提供者，這種模式可以很好地擴展——DeepSeek、Gemini、Groq、Qwen、GLM、MiniMax 或本地模型都可以嵌入到同一個地方。 提供者 大批。.

一旦基線運行正常，一個實際的多提供商配置看起來會是這樣——註冊了兩個提供商，並且 路由器 將不同的模型分配給每個任務類別：

{ "Providers": [ { "name": "openrouter", "api_base_url": "https://openrouter.ai/api/v1/chat/completions", "api_key": "$OPENROUTER_API_KEY", "models": ["propic/claude. ["openrouter"] } }, { "name": "deepseek", "api_base_url": "https://api.deepseek.com/chat/completions", "api_key": "$DEEPSEEK_API_KEY", "models": ["deepseek-chat", kkeek-chat" "Router": { "default": "openrouter,anthropic/claude-sonnet-4", "background": "deepseek,deepseek-chat", "think": "deepseek,deepseek-reasoner", "longContext": "openrouter,google/gemini-2.5-pro" }

閱讀 路由器 從上到下逐一分析，你可以一目了然地看到整個成本策略：低成本的 DeepSeek 處理了無關緊要的後台工作，它的推理器處理計劃模式，Gemini 的大窗口捕獲了所有超過長上下文閾值的內容，而功能強大的默認函數則承擔了其餘工作。如果你完全不想手動編輯 JSON，, ccr 使用者介面 它提供了一個基於表單的編輯器，該編輯器會寫入同一個檔案。這與「一次配置，終身運行」的概念如出一轍。 克勞德代碼鉤子 — 前期投入少，回報永久。.

真正能幫你省錢的路由類別

真正的優勢在於基於任務的路由。 CCR 會對每個傳入請求進行分類，並將其對應到您為該類別指定的模型。您需要專注於五個類別，並分別設定每個類別。 路由器 使用相同的區塊 提供者、模型 句法：

類別	發射時	應該將其路由到哪裡？
背景	文件掃描，上下文收集	快速、便宜的型號（或本地型號）
思考	計劃模式和複雜推理	強推理模型
長情境	超過令牌閾值（預設為 60k）的請求	高語境模型
網路搜尋	網路搜尋任務	具有原生搜尋功能的模型
預設	其他一切	一款性能優異的中階車型

這 背景 路徑是金錢的藏身之處。那些靜默的文件掃描請求在會話期間不斷觸發，在你統計它們之前，你根本不知道它們悄悄累積了多少資源。如果把它們送到廉價或本地模型，你幾乎察覺不到——這類工作的輸出品質幾乎無法區分。同時，你卻在維護一台性能卓越的模型。 思考 以及真正能改變格局的剪輯，品質才能真正發揮作用。.

這就是全部：編碼會話並非單一的工作。總結差異、命名分支和精簡舊上下文都是可有可無的任務。規劃重構是一項推理任務。而精心進行多文件編輯，才是真正體現品質價值的地方。支付前沿費率 全部 其中一部分是浪費的預設設定——而 Claude Code 路由器就是終結這種預設的開關。.

以下是我整個集群的實際表現。在典型的建造日，一個容器可能會透過 Claude Code 發出數千個請求——當我為它們添加標籤時，絕大多數都是無效的。 背景讀取檔案以建立上下文、檢查變更、壓縮歷史記錄以防止會話逾時。這佔據了大部分流量，但幾乎沒有價值。如果將其路由到成本遠低於前沿定價的模型，容器的每日開銷將大幅下降，而真正用於交付程式碼的少量推理和編輯請求仍然可以在優質資源上運行。如果每天運行十個容器，那麼路由就不再是一個巧妙的技巧，而是變成了我託管帳單上的一個固定項目。如果您想了解這些成本在一個月的自主工作中是如何反映的，我已經將資料細分如下： 運行一個人工智慧代理的實際成本是多少？.

Claude Code Router 何時值得使用（以及何時應該跳過）

實話實說，並非人人都需要它。 Claude Code路由器只有在您需要的時候才能發揮作用。 不同的 針對不同請求類型，可以使用不同的模型。如果您只想在單一非 Claude 模型上執行 Claude 程式碼，則完全不需要路由器——您可以直接設定基本 URL 和按鍵，從而跳過額外的步驟。.

如果您符合以下條件，請安裝路由器：

• 每天都在大量運行 Claude Code，眼睜睜看著賬單因為一些無意義的工作而不斷攀升。.
• 以車隊規模運作—對我來說，十個貨櫃意味著後台路由採用廉價模型可以帶來真正的、持續的節省，而不是四捨五入的誤差。.
• 當某個服務提供者達到速率限制時，希望自動故障轉移到另一個服務提供者。.
• 處理敏感客戶數據，並希望請求在發送前保留在您的電腦上。.

如果您符合以下條件，請跳過：

• 對於每月 Claude Code 花費微不足道的輕度用戶來說，設定時間是得不償失的。.
• 只使用一種替代模型——直接讓 Claude Code 看就行了。.
• 調試偶爾出現的提供者格式怪異問題令人頭痛；新增代理又增加了一個故障排除層面。.

需要說明的是，我會在執行大量自主編碼的容器上運行 CCR，而在幾乎不使用 Claude Code 的容器上則不運行。路由器只是一種工具，而不是一種信念。如果您還在摸索代理本身，請先熟悉我文章中的基礎知識。 Claude Code CLI 指南 以及更廣泛的 克勞德代碼攻略 在你加入路由層之前。.

常見問題解答

Claude Code Router是免費的嗎？

是的。路由器本身是開源的，採用 MIT 許可證——軟體本身是免費的。你唯一的成本就是你所使用的模型 API，而這正是你原本想要優化的成本。.

Claude Code路由器會將我的程式碼傳送給第三方嗎？

代理程式在本地運行。 127.0.0.1:3456. 您的有效負載在到達您選擇的提供者之前不會經過任何聚合服務。它們仍然會發送到您路由的任何模型提供者——因此請選擇您信任的提供者——但路由決策和轉換是在您的機器上完成的。.

使用更便宜的型號會影響品質嗎？

只有當你分配的任務不正確時才會出現問題。基於任務的路由的目的是將一些無關緊要的工作（例如文件掃描、分支命名、上下文壓縮）交給成本較低的模型，同時保留一個用於推理和實際編輯的前沿模型。如果做得好，就能在不明顯影響重要工作品質的情況下降低成本。.

我可以使用完全本地化的模型，而不使用外部供應商嗎？

是的。將提供者條目指向已拉取模型的本機 Ollama 實例，您就可以完全離線執行 Claude Code，處理指派給它的路由－這是一種常見的模式。 背景 類別。.

當某個服務提供者的費率受到限制時，這樣做會有幫助嗎？

是的，間接地。因為你的路由規則會依照類別將工作負載分配到多個提供者，所以即使某個型號的效能受到限制，也不會導致整個會話中斷——其他類別的工作負載仍會在各自的提供者繼續運作。而且，當某個提供者開始限制你的流量時，將該路由切換到其他型號只需修改一行程式碼即可。 config.json 其次是 ccr重啟, 而不是重新鋪設整個管道系統。.

最常見的設定錯誤是什麼？

指向 api_base_url 使用基礎網域而不是完整的聊天補全端點。如果路由靜默失敗，請先檢查該 URL，然後追蹤日誌。 ~/.claude-code-router/logs/.

最後想說的話

Claude Code路由器是那種罕見的工具，它在第一週就能收回成本，然後持續為你帶來收益。你只需花五分鐘安裝，十分鐘寫程式碼。 config.json, 從那時起，所有無效請求都不會再消耗 Frontier 的資源，而你真正的工作也能保持品質。對於任何認真運行 Claude Code 的人——尤其是大規模運行的人——來說，這並非錦上添花。它決定了代理堆疊是能夠經濟高效地擴展，還是會悄悄地榨乾你的資源。.

先從一家供應商開始， ccr程式碼 先進行操作，然後一次新增一個路由類別。測量 背景 先走路線。收據就在那裡。.