影片筆記：CC Switch 实战：让 Claude Code 自动切换 API，OpenRouter 免费模型也能稳定跑

一句話總結

本影片介紹了開源專案 CC-Switch，該工具可讓 Claude Code 等開發工具在多個 API 供應商之間自動切換。透過內建的路由協議轉換與自動故障轉移（Failover）機制，當主供應商觸發速率限制或故障時，系統會無縫切換至備用供應商（如 OpenRouter 免費模型），確保開發任務不中斷。

核心重點

1. 解決多供應商配置痛点：CC-Switch 旨在解決使用者同時使用多個大模型 API 供應商時，需手動修改配置文件（如 .env 或設定檔）的繁瑣問題。
2. 廣泛的 Agent 支援：不僅支援 Cloud Code，還支援 Codex、OpenCode、OpenCraw、Gemini、CLI、Hermes Agent 等主流開發代理工具。
3. 介面協議轉換（路由功能）：

• 核心功能之一是將 OpenAI 相容格式 的 API 請求轉換為 Anthropic 原生格式。
• 這使得 Claude Code 可以直接使用非 Anthropic 原生格式的供應商 API。
• 需透過命令行終端啟動 Cloud Code，以確保請求指向本地路由服務。

1. 自動故障轉移（Auto Failover）：

• 在路由服務內部，針對每個 HTTP 請求單獨進行供應商選擇與切換。
• 對客戶端（Cloud Code）無感，僅在全部供應商失敗時才返回錯誤。
• 當某個 API 節點掛掉或額度耗盡（觸發速率限制）時，底層自動無縫切換至備用節點。

1. 實戰演示：

• 利用 OpenRouter 的免費模型與多個帳戶進行測試。
• 演示在觸發速率限制時，如何自動切換供應商以維持 Cloud Code 的穩定運作。
• 展示了設定故障轉移供應商佇列（如 NVIDIA、OpenRouter 帳戶）的過程。

詳細大綱

1. CC-Switch 專案介紹

• 專案目標：簡化多供應商 API 的管理，避免手動修改配置。
• 支援工具列表：
• Cloud Code
• Codex
• OpenCode
• OpenCraw
• Gemini
• CLI
• Hermes Agent

2. 安裝與基本配置

• 下載方式：從 Release 頁面下載對應作業系統版本（例如 Windows 的 MSI 安裝檔）。
• 應用程式介面操作：
• 新增服務供應商。
• 填寫 API Key。
• 設定模型名稱。
• 配置注意事項：
• 模型測試配置的重要性：避免使用全局配置導致測試失敗。
• 需分別配置不同供應商的 API Key 與 Base URL。

3. 路由功能（Protocol Routing）

• 原理：介面協議轉換，將 OpenAI 格式轉換為 Anthropic 格式。
• 設定步驟：
• 開啟路由開關。
• 啟動本地 HTTP 服務。
• 啟動注意事項：
• 必須透過命令行終端啟動 Cloud Code。
• 不能透過 CC-Switch 介面直接啟動 Cloud Code，以確保請求正確指向本地路由服務。

4. 自動故障轉移功能（Auto Failover）

• 功能定義：在路由服務內部，針對每個 HTTP 請求單獨進行供應商選擇與切換。
• 行為特徵：
• 對客戶端（Cloud Code）無感。
• 僅在全部供應商失敗時返回錯誤。
• 觸發條件：當某個 API 節點掛掉或額度耗盡時，自動切換。

5. OpenRouter 免費模型實戰測試

• OpenRouter 免費模型特性：
• 存在速率限制與每日請求額度限制。
• 使用體驗與缺點分析。
• 故障轉移測試過程：

1. 設定故障轉移供應商佇列（例如：NVIDIA、OpenRouter 帳戶）。
2. 執行任務並觀察觸發故障轉移的過程。
3. 結果分析：模型切換後的穩定性與額度消耗問題。

• 測試結果：
• 成功演示在觸發速率限制時切換供應商。
• 維持了 Cloud Code 的穩定運作。

工具 / 模型 / 名詞整理

• 專案/工具名稱：
• CC-Switch
• Cloud Code
• Codex
• OpenCode
• OpenCraw
• Gemini
• CLI
• Hermes Agent
• OpenRouter
• 模型名稱（依逐字稿原文）：
• Deepseek
• DeepSickVisPro
• Deepseq
• DeepSecret
• Deepseeker
• DeepSick V4 Flash
• MiniMax 2.5
• FreeModels Router
• Deepseek V4 Flash
• 介面/格式規範：
• OpenAI 相容格式 / OpenAI Chat Completion
• Anthropic 原生格式 / Atherapic Message
• OpenAI 模式
• EM 標識
• 其他專有名詞：
• API Key
• Base URL
• HTTP 服務
• Release 頁面
• MSI 文件
• 速率限制（Rate Limit）
• 熔断（Circuit Breaker/Throttling context）

操作流程整理

1. 安裝 CC-Switch：

• 前往 Release 頁面下載適合作業系統的版本（如 Windows MSI）。

1. 配置供應商：

• 開啟 CC-Switch 應用程式。
• 新增服務供應商，輸入 API Key 與 Base URL。
• 設定對應的模型名稱。
• *注意：進行模型測試時，避免使用全局配置，應針對特定供應商配置。*

1. 啟用路由功能：

• 在介面中開啟路由開關。
• 啟動本地 HTTP 服務。

1. 啟動開發工具：

• 打開命令行終端。
• 在終端中啟動 Cloud Code（確保請求指向本地路由服務，而非直接連接到供應商）。

1. 設定故障轉移佇列（實戰步驟）：

• 在 CC-Switch 中設定主供應商與備用供應商佇列（例如：主選 NVIDIA，備選 OpenRouter 帳戶）。

1. 執行測試任務：

• 在 Cloud Code 中執行程式碼生成或修改任務。
• 觀察當主供應商觸發速率限制時，系統是否自動切換至備用供應商。

1. 監控與分析：

• 確認任務是否因切換供應商而中斷。
• 檢查額度消耗情況與模型切換後的穩定性。

值得注意的限制或風險

1. 免費模型的速率限制：OpenRouter 的免費模型有嚴格的速率限制與每日請求額度，可能影響連續任務的執行。
2. 配置複雜性：需要正確配置多個供應商的 API Key 與 Base URL，且測試時需注意不要使用全局配置以免失敗。
3. 啟動方式限制：必須透過命令行終端啟動 Cloud Code 才能正確使用路由功能，直接從介面啟動可能無效。
4. 全部失敗風險：自動故障轉移僅在部分供應商失敗時生效，若所有配置的供應商均失敗，仍會返回錯誤。
5. 額度消耗問題：實戰中發現模型切換後可能存在額度消耗問題，需留意各供應商的計費或免費額度限制。

逐字稿辨識疑點

• DeepSickVisPro：逐字稿中提及「這裡配置的是 DeepSickVisPro」，疑似為特定模型名稱或聽寫錯誤，保留原樣。
• Deepseq：逐字稿中多次出現「Deepseq API」、「Deepseq 是支持」，疑似為 DeepSeek 的聽寫錯誤，保留原樣。
• DeepSecret：逐字稿中提及「你用 DeepSecret 的接口去測試」，疑似為 DeepSeek 的聽寫錯誤，保留原樣。
• Deepseeker：逐字稿中提及「這裡我配了一個 Deepseeker」，疑似為 DeepSeek 的聽寫錯誤，保留原樣。
• Atherapic / Anthoropic / Athrobic：逐字稿中分別出現「Atherapic Message原生的」、「Anthoropic 的接口的那種規範」、「轉換成 Athrobic 的結果」，均疑似為 Anthropic 的聽寫錯誤，保留原樣。
• 必源：逐字稿中提及「首先就是必源的模型」，疑似為「閉源」的聽寫錯誤，保留原樣。
• 強煙：逐字稿中提及「把底層換一個強煙的模型」，疑似為「強效」或特定模型名稱的聽寫錯誤，保留原樣。
• 空障轉移：逐字稿中提及「為了測試空障轉移這個功能」，疑似為「故障轉移」的聽寫錯誤，保留原樣。
• 數率線：逐字稿中提及「觸發了每分鐘的數率線之後」，疑似為「速率線」或「速率限制」的聽寫錯誤，保留原樣。
• Oppos 或 Haku：逐字稿中提及「沒有明確落到 Sonic 的 Oppos 或 Haku 的角色時」，疑似為特定角色名稱或聽寫錯誤，保留原樣。
• Sonic：逐字稿中提及「沒有明確落到 Sonic 的...」，疑似為特定角色或模型名稱，保留原樣。
• 英偉達：逐字稿中提及「比如像 OpenRouter 英偉達 這些模型提供商」，保留原樣。
• FreeModels Router：逐字稿中提及「FreeModes Router」及「FreeModels Router」，保留原樣。
• DeepSick V4 Flash：逐字稿中提及「比如這個 DeepSick V4 Flash」，保留原樣。
• MiniMax 2.5：逐字稿中提及「MiniMax 2.5 的模型」，保留原樣。
• Deepseek V4 Flash：逐字稿中提及「改成 Deepseek V4 Flash 模型」，保留原樣。

可延伸追問

1. CC-Switch 是否支援其他非 OpenAI 相容格式的供應商？
2. 在自動故障轉移過程中，是否有延遲影響？
3. 如何監控各供應商的剩餘額度與使用情況？
4. CC-Switch 的開源協議為何？是否適合商業環境使用？
5. 除了 Cloud Code，其他支援的 Agent（如 Codex、OpenCode）在配置上有無特殊差異？