# 影片筆記：100%免费！Claude Code 跑本地模型，无需 API！免翻墙使用超强AI Agent｜Ollama｜CC Switch｜零度解说

## 一句話總結

影片介紹如何利用開源專案 **CCSWitch** 搭配本地模型運行工具 **Ollama**，將本地部署的 AI 模型（如 Qwen、Gemma）偽裝成官方 API，從而驅動 **Cloud Code** 桌面版的功能，實現完全本地化、免付費且無需翻牆的 AI Agent 操作。

## 核心重點

1.  **核心原理**：透過 **CCSWitch** 進行請求轉發，將本地模型（Qwen, DeepSeek, GLM 等）的介面偽裝成 Cloud API，使 Cloud Code 以為自己連接的是官方 API，實際上是調用本地模型。
2.  **主要優勢**：
    *   完全本地運行，無需付費 API。
    *   可實現自動讀取項目、修改代碼、執行命令、修復 Bug 及搭建網站等功能。
    *   免翻牆使用。
3.  **操作流程**：
    *   安裝必要環境（Git、Cloud Code、CCSWitch、Ollama）。
    *   下載並部署本地模型（如 Qwen 3.5、Gemma 4）。
    *   配置 CCSwitch 路由。
    *   修改 Cloud Code 註冊表以啟用本地路由。
    *   測試驗證。

## 詳細大綱

### 1. 引言與原理介紹
*   Cloud Code 不僅是聊天工具，更是強大的 AI Agent（可操控電腦、讀取項目、修改代碼）。
*   透過 CCSwitch 將本地模型（Qwen, DeepSeek, GLM 等）偽裝成 Cloud API。
*   實現完全本地化運行，節省 API 費用。

### 2. 前置環境準備
*   安裝 Git（需選擇對應 Windows 版本）。
*   下載並安裝三個關鍵工具：
    1.  Cloud Code 桌面版客戶端。
    2.  CCSwitch（負責模型偽裝與請求轉發）。
    3.  Ollama（負責本地模型運行）。

### 3. 工具安裝步驟
*   **Cloud Code**：下載 Windows 32/64 位版本並安裝。
*   **CCSWitch**：下載 Windows 版本並安裝。
*   **Ollama**：下載 Windows 版本並安裝，建議更新至最新版本（提及 0.24.0）。

### 4. 本地模型部署
*   使用 Ollama 下載並運行本地模型。
*   推薦模型：
    *   **Gemma 4**：提及 24B/26B 版本（約 17GB），支持多模態（Text + Image）。
    *   **Qwen（千問）**：提及 3.5 或 3.6 版本，推薦 9B 版本（約 6GB），適合 8GB 顯存。
*   透過 CMD 命令行執行安裝命令。

### 5. CCSwitch 配置與路由設置
*   在 CCSwitch 中添加新供應商，選擇「自定義配置」。
*   設置模型供應商名稱（如 OLOMA）及自定義模型名稱。
*   API Key 可隨意填寫（如 123456）。
*   請求地址設置為 Ollama 本地地址：`127.0.0.1:11434/v1`。
*   選擇 API 格式為 OpenInit 模式（提及 OpenInit 進入模式）。
*   認證制度選擇 AndroidPig API Key（原文如此）。
*   設置主模型與備用模型。
*   啟用 CCSwitch 的「本地路由」功能。

### 6. 系統環境與 Cloud Code 配置
*   檢查 Windows 虛擬機功能（Windows 虛擬機平台、適用於 Linux 的 Windows 子系統）。
*   進入 Cloud Code 開發者模式（Developer Mode）。
*   在第三方配置中填寫 CCSwitch 提供的網關地址與 API Key。
*   開啟引擎路由模式。
*   導出配置文件為 Windows 註冊表文件。
*   編輯註冊表文件，注入模型選項命令，然後執行註冊表文件。

### 7. 測試與驗證
*   重啟 Cloud Code 客戶端。
*   測試自我介紹，確認調用本地模型。
*   測試模型切換與偽裝效果（確認 AI 認為自己是 Cloud 模型而非本地模型）。
*   實測生成網站（Syber 文科風格）與 3D 跑酷遊戲，比較不同模型（Gemma 4 vs Qwen）的效果差異。

## 工具 / 模型 / 名詞整理

*   **產品/工具**：
    *   Cloud Code（桌面版客戶端）
    *   CCSwitch（開源專案，負責偽裝與轉發）
    *   Ollama（本地模型運行工具，文中亦寫作 Oloma, Unomar, aluma）
    *   Git（文中寫作 Gate）
    *   CMD（命令提示字元）
    *   Windows 虛擬機平台
    *   適用於 Linux 的 Windows 子系統
*   **模型/技術**：
    *   Qwen（千問，文中亦寫作 千萬, 签换, 千分）
    *   DeepSeek（文中亦寫作 Deep Sync, DPC）
    *   GLM
    *   Gemma 4（文中亦寫作 Gamma 4, gm4, Gemmer 4）
    *   Opus
    *   Hikku（文中亦寫作 Hiku, Hikku 模型）
    *   Enterpeak（開發商名稱，疑點）
    *   Cloud Work / CloudCodeSonic（文中提及的模型或產品名稱變體）
    *   MiniMac, Kimi, NVIDIA, OpenLOD（API 對接選項）
    *   OpenInit 進入模式（API 格式選項）
    *   AndroidPig API Key（認證制度選項）
    *   Syber 文科（網站風格描述）

## 操作流程整理

1.  **安裝基礎環境**：
    *   安裝 Git（Windows 版本）。
    *   安裝 Cloud Code 桌面版客戶端。
    *   安裝 CCSwitch。
    *   安裝 Ollama（建議版本 0.24.0）。
2.  **部署本地模型**：
    *   使用 Ollama 命令行下載模型（推薦 Qwen 9B 或 Gemma 4 24B/26B）。
3.  **配置 CCSwitch**：
    *   添加新供應商，選擇「自定義配置」。
    *   設置供應商名稱（如 OLOMA）及自定義模型名稱。
    *   填寫任意 API Key（如 123456）。
    *   設置請求地址為 `127.0.0.1:11434/v1`。
    *   選擇 API 格式為 OpenInit 模式。
    *   選擇認證制度為 AndroidPig API Key。
    *   設置主模型與備用模型。
    *   啟用「本地路由」功能。
4.  **配置 Cloud Code**：
    *   確保 Windows 虛擬機功能已開啟。
    *   進入 Cloud Code 開發者模式。
    *   在第三方配置中填入 CCSwitch 的網關地址與 API Key。
    *   開啟引擎路由模式。
    *   導出配置文件為 Windows 註冊表文件。
    *   編輯註冊表文件，注入模型選項命令。
    *   執行註冊表文件。
5.  **驗證**：
    *   重啟 Cloud Code。
    *   測試自我介紹及模型切換。
    *   實測生成網站或遊戲。

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

*   **聽寫辨識不確定性**：由於逐字稿存在大量疑似聽寫錯誤，具體的操作按鈕名稱、菜單選項名稱可能存在誤解，需使用者根據實際畫面判斷。
*   **模型性能依賴**：本地模型的效果高度依賴硬體配置（如顯存大小），推薦的 Qwen 9B 適合 8GB 顯存，Gemma 4 24B/26B 約佔 17GB，需確保硬體足夠。
*   **偽裝機制**：此方法依賴於將本地模型偽裝成官方 API，若 Cloud Code 更新驗證機制，可能會失效。
*   **註冊表修改風險**：修改 Windows 註冊表文件需謹慎，錯誤的修改可能影響系統或應用程序正常運行。

## 逐字稿辨識疑點

*   **Gate**：逐字稿中多次提到安裝「Gate」環境，並提到「硬式多的 for Windows」，疑為 **Git** 的聽寫錯誤。
*   **Oloma / Unomar / aluma**：逐字稿中對 Ollama 的稱呼不一致，分別出現為 Oloma, Unomar, aluma。
*   **CCSWage / CCS 位置 / CCSV 去**：逐字稿中對 CCSwitch 的稱呼出現變體，如 CCSWage, CCS 位置, CCSV 去。
*   **CloudCodeSonic**：文中提到「替換真正的 CodeCodeSonic」，疑為對 Cloud Code 官方模型或產品的誤稱。
*   **Card Quote**：文中提到「Card Quote 就會自動吐起整個項目代碼」，疑為 **Cloud Code** 的聽寫錯誤。
*   **依捞關係**：文中提到「理解依捞關係」，疑為 **依賴關係** 的聽寫錯誤。
*   **科者**：文中提到「這個比科者強悍多了」，疑為 **Cloud Code** 或特定模型的誤稱。
*   **兜下來 / 當下來 / 動下來**：多次出現，疑為 **下載** 的聽寫錯誤。
*   **客戶刀 / 安裝刀**：疑為 **客戶端** 或 **安裝包** 的聽寫錯誤。
*   **困住面板**：文中提到「這些困住面板了」，疑為 **配置面板** 或 **控制面板** 的聽寫錯誤。
*   **命迪制服**：文中提到「打開我們的命迪制服」，疑為 **命令提示字元** 或 **CMD** 的聽寫錯誤。
*   **面理提示符合窗口**：文中提到「打開一個面理提示符合窗口」，疑為 **命令提示字元** 或 **終端機** 的聽寫錯誤。
*   **簽換**：文中多次提到「簽換 3.5」，疑為 **Qwen（千問）** 的聽寫錯誤。
*   **Enterpeak**：文中提到「Enterpeak 開發的模型」，疑為 **Anthropic** 或其他開發商的聽寫錯誤。
*   **Cloud Work**：文中提到「我是我的 Cloud Work」，疑為 **Cloud Code** 的聽寫錯誤。
*   **按出屁股光風**：文中提到「按出屁股光風的命令行助手」，疑為 **按出屁股** 為聽寫錯誤，可能意指 **按出** 或特定術語，但「屁股光風」語意不明，疑為聽寫錯誤。
*   **CZWork**：文中提到「通過這 CZWork 調用本地模型」，疑為 **Cloud Work** 或 **Cloud Code** 的聽寫錯誤。
*   **gm4**：文中提到「gm4 模型」，疑為 **Gemma 4** 的縮寫或聽寫。
*   **Syber 文科**：文中提到「Syber 文科個人網站」，疑為特定風格名稱或聽寫錯誤。
*   **127.0.0.1:11434/v1**：文中提到「11434 斜杠位 1」，疑為 **11434/v1** 的聽寫。
*   **OpenInit 進入模式**：文中提到選擇第二個選項為 OpenInit 進入模式，疑為 **OpenAI** 或 **OpenAPI** 格式的聽寫錯誤。
*   **AndroidPig API Key**：文中提到認證制度選擇 AndroidPig API Key，疑為 **Bearer** 或 **API Key** 的聽寫錯誤。
*   **路由總快關**：文中提到「路由總快關給打開」，疑為 **路由總開關** 的聽寫錯誤。
*   **投資我們在主線上顯示**：文中提到「投資我們在主線上顯示本地路由開關」，疑為 **提示** 或 **狀態** 的聽寫錯誤。
*   **單級選下有三個模型**：文中提到「單級選下有三個模型」，疑為 **單擊選下** 或 **界面顯示** 的聽寫錯誤。
*   **知識結識到 2025 年的 5 月**：文中提到「我的知識結識到 2025 年的 5 月」，疑為 **知識截止日期** 的聽寫錯誤。
*   **創舉工作繪畫**：文中提到「在創舉工作繪畫的時候」，疑為 **Cloud Code** 或 **創作工作** 的聽寫錯誤。
*   **automa**：文中提到「可以在 automa 進行配置」，疑為 **Ollama** 的聽寫錯誤。
*   **門地上有一個邊境按鈕**：文中提到「門地上有一個邊境按鈕」，疑為 **界面** 或 **菜單** 上有某個按鈕的聽寫錯誤。
*   **做進保存**：文中提到「做進保存就可以了」，疑為 **點擊保存** 的聽寫錯誤。
*   **Syber 文科風格**：文中提到「Syber 文科風格」，疑為特定設計風格名稱。
*   **決明一下**：文中提到「我們先決明一下」，疑為 **確認** 或 **查看** 的聽寫錯誤。
*   **快遍出來**：文中多次出現「快遍出來」，疑為 **複製出來** 或 **顯示出來** 的聽寫錯誤。
*   **打按它 / 打按注視表文件**：文中提到「打按它」、「打按注視表文件」，疑為 **點擊** 或 **打開** 註冊表文件的聽寫錯誤。
*   **點擊 4**：文中提到「點擊 4 就可以了」，疑為 **點擊是** 或 **點擊確定** 的聽寫錯誤。
*   **徹底退出來**：文中提到「徹底退出來」，疑為 **徹底退出** 的聽寫錯誤。
*   **扣端**：文中提到「Cloud Code 的扣端」，疑為 **客戶端** 的聽寫錯誤。
*   **學著本體廣觀**：文中提到「學著本體廣觀」，疑為 **查看主體界面** 或類似意思的聽寫錯誤。
*   **轉移單級的底層模型**：文中提到「轉移單級的底層模型是什麼」，疑為 **切換當前** 或 **查看當前** 底層模型的聽寫錯誤。
*   **知識結識**：文中提到「知識結識到 2025 年」，疑為 **知識截止日期** 的聽寫錯誤。
*   **創舉工作**：文中提到「創舉工作」，疑為 **Cloud Code** 的聽寫錯誤。
*   **按出屁股光風**：文中提到「按出屁股光風的命令行助手」，語意不明，疑為聽寫錯誤。
*   **門地上有一個邊境按鈕**：文中提到「門地上有一個邊境按鈕」，疑為 **界面** 上有某個按鈕的聽寫錯誤。
*   **做進保存**：文中提到「做進保存」，疑為 **點擊保存** 的聽寫錯誤。
*   **Syber 文科**：文中提到「Syber 文科」，疑為特定名稱。
*   **決明**：文中提到「決明一下」，疑為 **確認** 的聽寫錯誤。
*   **快遍**：文中提到「快遍出來」，疑為 **複製** 或 **顯示** 的聽寫錯誤。
*   **打按**：文中提到「打按它」，疑為 **點擊** 的聽寫錯誤。
*   **注視表文件**：文中提到「注視表文件」，疑為 **註冊表文件** 的聽寫錯誤。
*   **點擊 4**：文中提到「點擊 4」，疑為 **點擊是** 或 **點擊確定** 的聽寫錯誤。
*   **徹底退出來**：文中提到「徹底退出來」，疑為 **徹底退出** 的聽寫錯誤。
*   **扣端**：文中提到「扣端」，疑為 **客戶端** 的聽寫錯誤。
*   **學著本體廣觀**：文中提到「學著本體廣觀」，疑為 **查看主體界面** 的聽寫錯誤。
*   **轉移單級**：文中提到「轉移單級」，疑為 **切換當前** 的聽寫錯誤。
*   **知識結識**：文中提到「知識結識」，疑為 **知識截止日期** 的聽寫錯誤。
*   **創舉工作**：文中提到「創舉工作」，疑為 **Cloud Code** 的聽寫錯誤。
*   **按出屁股光風**：文中提到「按出屁股光風」，疑為聽寫錯誤。
*   **門地上**：文中提到「門地上」，疑為 **界面** 或 **菜單** 的聽寫錯誤。
*   **邊境按鈕**：文中提到「邊境按鈕