# 影片筆記：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，以確保請求指向本地路由服務。
4.  **自動故障轉移（Auto Failover）**：
    *   在路由服務內部，針對每個 HTTP 請求單獨進行供應商選擇與切換。
    *   對客戶端（Cloud Code）無感，僅在全部供應商失敗時才返回錯誤。
    *   當某個 API 節點掛掉或額度耗盡（觸發速率限制）時，底層自動無縫切換至備用節點。
5.  **實戰演示**：
    *   利用 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）。
2.  **配置供應商**：
    *   開啟 CC-Switch 應用程式。
    *   新增服務供應商，輸入 API Key 與 Base URL。
    *   設定對應的模型名稱。
    *   *注意：進行模型測試時，避免使用全局配置，應針對特定供應商配置。*
3.  **啟用路由功能**：
    *   在介面中開啟路由開關。
    *   啟動本地 HTTP 服務。
4.  **啟動開發工具**：
    *   打開命令行終端。
    *   在終端中啟動 Cloud Code（確保請求指向本地路由服務，而非直接連接到供應商）。
5.  **設定故障轉移佇列（實戰步驟）**：
    *   在 CC-Switch 中設定主供應商與備用供應商佇列（例如：主選 NVIDIA，備選 OpenRouter 帳戶）。
6.  **執行測試任務**：
    *   在 Cloud Code 中執行程式碼生成或修改任務。
    *   觀察當主供應商觸發速率限制時，系統是否自動切換至備用供應商。
7.  **監控與分析**：
    *   確認任務是否因切換供應商而中斷。
    *   檢查額度消耗情況與模型切換後的穩定性。

## 值得注意的限制或風險

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）在配置上有無特殊差異？