# 影片筆記：告别命令行！ 桌面版 Claude code 国内无痛使用  接入DeepSeek | 免魔法 免账号 免信用卡 | 保姆级教程 10分钟快速上手

## 一句話總結

本影片詳細演示了如何在中國大陸網絡環境下，通過安裝 Gate、CCSwitch 等中間件工具，並修改 Windows 註冊表，實現桌面版 Claude Code 免魔法、免官方帳號登錄，直接接入 DeepSeek 第三方模型進行代碼生成與應用開發。

## 核心重點

1.  **突破環境限制**：解決了桌面版 Claude Code 通常需要登錄官方帳號、依賴國外網絡（魔法）及信用卡的問題，實現國內直連。
2.  **第三方模型接入**：通過 CCSwitch 作為 API 路由轉發器，將 Claude Code 的請求轉發至 DeepSeek 模型，實現低成本、高可用性的代碼生成。
3.  **系統級配置**：
    *   需安裝 Gate 依賴及 CCSwitch 路由軟件。
    *   需啟用 Windows 虛擬機平台相關功能以支持隔離運行環境。
    *   需通過修改註冊表（REG 文件）來隱藏登錄選項並啟用模型切換功能。
4.  **實測驗證**：成功生成包含「待辦清單」與「番茄鐘」功能的本地網頁應用，驗證了代碼生成、數據持久化及迭代修改的能力。

## 詳細大綱

### 一、 背景與優勢
*   **痛點**：傳統桌面版 Claude Code 需登錄官方帳號，依賴國外環境（需魔法、海外手機號、信用卡），且界面為黑底白字終端，對普通用戶不友好。
*   **解決方案**：支持接入第三方模型（如 DeepSeek、Kimi），實現國內網絡正常使用，無需魔法，無需註冊 Cloud 帳號。

### 二、 前置軟件安裝
1.  **Gate**
    *   **作用**：Claude Code 許多指令依賴 Gate 執行，未安裝會報錯。
    *   **安裝**：訪問 Gate 官方下載頁面，選擇 64 位 Windows 版本下載安裝（可命令行一鍵安裝或手動下載）。
2.  **CCSwitch (CSSWITCH)**
    *   **作用**：管理大模型 API，將 Claude Code 請求轉發至設置的大模型（如 DeepSeek），作為中間人。
    *   **安裝**：訪問 GitHub 頁面下載最新發布版，選擇「安裝版」（支持自動更新）或「綠色版」（需手動更新）。

### 三、 DeepSeek API 申請與配置
1.  **申請 API Key**
    *   訪問 DeepSeek 官網 -> API 開放平台 -> 手機號登錄/註冊。
    *   充值：建議充值默認 10 元（支持支付寶、微信）。
    *   創建 Key：點擊「API keys」-> 輸入名稱（如 cc）-> 創建 -> **複製並保存生成的字符**（僅出現一次）。
2.  **CCSwitch 配置**
    *   打開 CCSwitch，默認選中 Claude Code。
    *   點擊加號 -> 選擇 DeepSeek 供應商 -> 粘貼 API Key。
    *   測試延遲：顯示綠色表示暢通。
    *   **模型映射修改**：將主模型（Hikusonet/V3）改為 V4 版本（如 V4Flash, V4 Pro）。
    *   點擊「添加」完成配置。
3.  **啟用路由功能**
    *   點擊齒輪圖標進入設置 -> 切換至「路由」標籤。
    *   打開「在主頁顯示本地路由開關」與「路由總開關」。
    *   在「路由啟用」中啟用 Cloud 的路由。
    *   **記錄端口號**：記住服務地址和端口號，後續配置 Claude Code 需用。

### 四、 Windows 系統虛擬化設置
*   **原因**：Claude Code 代碼和命令在格力（Guest/隔離）虛擬環境中運行，保護主系統。
*   **步驟**：
    1.  開始菜單搜索「啟用或關閉 Windows 功能」。
    2.  勾選以下三項：
        *   虛擬機平台
        *   Windows 虛擬機監控程序平台
        *   適用於 Linux 的 Windows 子系統
    3.  點擊確定，系統自動安裝組件並提示重啟。
    4.  重啟電腦。

### 五、 Claude Code 桌面版安裝與配置
1.  **下載與安裝**
    *   **注意**：不要從官網首頁下載（會提示無法使用 Cowork），需進入專門的下載頁面。
    *   選擇對應版本（Windows 64位）。
    *   下載的是安裝器，雙擊運行後自動下載並安裝桌面板。
2.  **啟用開發者模式**
    *   點擊左上角三條橫線 -> Help -> Publishing -> 啟用開發者模式。
    *   Claude Code 自動重啟。
3.  **配置第三方推理**
    *   點擊三條橫線 -> Developer -> 配置第三方推理。
    *   **關鍵參數填寫**：
        *   **網關地址 (Gateway URL)**：填寫 CCSwitch 中顯示的路由地址。
        *   **網關 API Key**：填寫 DeepSeek 的 API Key（表示自動獲取 CCSwitch 配置的 Key）。
        *   **網關授權模式**：保持默認。
    *   **隱藏登錄選項**：拉至最底端，打開「隱藏登錄選項」開關，使啟動後直接進入第三方 API 模式。
4.  **導出與修改註冊表**
    *   點擊左下角「Show as JSON」檢查配置（確保最後字段為 true）。
    *   點擊右下角「導出」，選擇 REG 結尾的 Windows 註冊表文件，保存至桌面。
    *   **編輯註冊表**：
        *   **禁止直接雙擊運行**。
        *   右鍵點擊文件 -> 用「記事本」打開。
        *   在最下方添加一行參數（作用：讓 Claude Code 出現模型選項，支持切換）。
        *   保存並關閉。
    *   **導入註冊表**：雙擊該註冊表文件 -> 點擊「是」允許寫入 -> 提示導入成功。
5.  **徹底重啟 Claude Code**
    *   僅點擊右上角關閉按鈕不會真正退出（會最小化至系統托盤）。
    *   需在系統托盤右鍵點擊 -> 選擇「退出」。
    *   重新打開 Claude Code。

### 六、 界面介紹與實測驗證
1.  **界面功能**
    *   中間：主規劃窗口。
    *   上方：Token 使用情況統計。
    *   下方：命令和內容輸入窗口。
    *   左側：進階繪畫、項目定製任務按鈕、歷史繪畫列表。
    *   右側：預覽窗口、計劃文件實時查看、終端界面、DIF 面板。
    *   操作：支持拖拽添加文件，直觀好看，新手友好。
2.  **模型識別問題**
    *   詢問模型名稱時，Claude Code 回答自己是 Claude 的 Hackle 模型。
    *   **原因**：Claude Code 提示詞注入較深。
    *   **驗證**：查看 CCSwitch 運行日誌，確認連接的是 DeepSeek 的 V4 模型，不影響正常使用。
3.  **代碼生成實測**
    *   **需求**：製作一個本地網頁應用，包含「待辦清單」和「番茄鐘」（25分鐘倒計時），數據保存在瀏覽器本地，文件保存至桌面。
    *   **計劃模式**：AI 自動打開新面板顯示計劃文件內容，比終端界面直觀。
    *   **允許編輯模式**：AI 按計劃寫代碼，將文件放置於桌面。
    *   **結果驗證**：
        *   功能完整：可開始倒計時、添加/完成待辦任務。
        *   數據持久化：關閉再打開，任務數據未流失。
    *   **迭代修改**：
        *   需求：支持自定義時長。
        *   結果：AI 快速修改，增加更多時間選項及自定義輸入框。

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

*   **Claude Code**：桌面版 AI 編程助手（影片標題及內容主要提及）。
*   **DeepSeek**：第三方大模型供應商，提供 API 服務。
*   **Gate**：Claude Code 依賴的執行環境軟件（影片口語）。
*   **CCSwitch / CSSWITCH**：API 路由轉發中間件軟件。
*   **Kimi**：提及的其他可接入模型。
*   **Codex**：提及的其他 AI 工具。
*   **GymLab**：提及的其他 AI 工具。
*   **OpenCode**：提及的其他 AI 工具。
*   **Windows 虛擬機平台**：Windows 系統功能組件。
*   **Windows 虛擬機監控程序平台**：Windows 系統功能組件。
*   **適用於 Linux 的 Windows 子系統**：Windows 系統功能組件。
*   **支付寶 / 微信**：DeepSeek API 充值支付方式。
*   **Hackle**：Claude Code 內部識別模型名稱（影片口語）。
*   **V3 / V4 / V4Flash / V4 Pro**：DeepSeek 模型版本。
*   **Hikusonet**：影片口語中提到的主模型名稱。
*   **REG**：Windows 註冊表文件格式。
*   **JetBrains**：Claude Code 的開發商（影片未明確口述品牌名，但提及產品名）。

## 操作流程整理

1.  **準備環境**：
    *   安裝 Gate（依賴軟件）。
    *   安裝 CCSwitch（路由軟件）。
    *   啟用 Windows 虛擬機相關功能並重啟電腦。
2.  **獲取 API**：
    *   在 DeepSeek 官網註冊並充值。
    *   創建 API Key 並保存。
3.  **配置路由**：
    *   在 CCSwitch 中添加 DeepSeek 供應商，填入 API Key。
    *   修改模型映射為 V4 系列。
    *   啟用路由功能，記錄服務地址和端口號。
4.  **配置 Claude Code**：
    *   下載並安裝桌面版 Claude Code（從專門下載頁面）。
    *   啟用開發者模式。
    *   在「配置第三方推理」中填入 Gateway URL 和 API Key。
    *   開啟「隱藏登錄選項」。
5.  **修改註冊表**：
    *   導出配置為 REG 文件。
    *   用記事本打開 REG 文件，在末尾添加參數以啟用模型切換。
    *   雙擊導入註冊表。
6.  **啟動使用**：
    *   徹底退出系統托盤中的 Claude Code。
    *   重新打開 Claude Code，即可使用 DeepSeek 模型進行開發。

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

1.  **模型識別干擾**：Claude Code 內部提示詞注入較深，詢問模型名稱時會錯誤識別為「Hackle」模型，需通過 CCSwitch 日誌確認實際連接的是 DeepSeek V4，這可能影響部分依賴模型名稱的邏輯判斷。
2.  **註冊表修改風險**：需手動編輯註冊表文件，操作不當可能影響軟件啟動或功能。
3.  **版本兼容性**：需確保下載的是專門的下載頁面版本，而非官網首頁版本，否則可能提示無法使用特定功能（如 Cowork）。
4.  **API 成本與穩定性**：依賴第三方 DeepSeek API，需自行承擔充值成本及 API 服務穩定性風險。
5.  **系統依賴**：強依賴 Windows 虛擬機平台功能，若系統未正確配置虛擬化環境，可能無法運行。

## 逐字稿辨識疑點

*   **Gate**：逐字稿中多次提及安裝「Gate」，並稱其為 Claude Code 指令依賴的軟件。通常 Claude Code 依賴的是 JetBrains Gateway，此處聽寫或口誤可能為「Gateway」，但逐字稿均寫作「Gate」，故保留疑點。
*   **CSSWITCH / CCSwitch**：逐字稿中交替使用 CSSWITCH 和 CCSwitch，GitHub 頁面名稱聽起來似為 CSSWITCH，但後續配置中稱為 CCSwitch。
*   **Deepseq**：逐字稿中多次將 DeepSeek 聽寫為「Deepseq」，疑為口誤或聽寫錯誤。
*   **Hikusonet**：在配置模型映射時，逐字稿提到「主模型 Hikusonet」，此名稱在常見大模型中較少見，疑為聽寫錯誤（可能指代某個具體模型名稱或內部變體），需查證。
*   **格力**：在描述虛擬環境時，逐字稿提到「跑在一個格力的虛擬環境里」，疑為「Guest」（客戶機/隔離環境）的聽寫錯誤。
*   **Cowork**：在警告不要從官網首頁下載時，提到「提示無法使用 Cowork」，疑為「CodeWith」或特定功能名稱的聽寫錯誤，或指代 JetBrains 的某項協作功能。
*   **進屆繪畫**：在介紹界面時，提到「進屆繪畫項目定製任務」，疑為「進階繪畫」或「進階編輯」的聽寫錯誤。
*   **愛要求**：在描述代碼寫好後的動作時，提到「並且愛要求呢把文件放到了桌面」，疑為「然後要求」或「並且愛（AI）要求」的聽寫錯誤。
*   **世界**：在描述自定義時長功能時，提到「這個時長來自定義這個世界」，疑為「這個時長」或「這個選項」的聽寫錯誤。
*   **Hackle**：Claude Code 回答自己是「Claude 的 Hackle 模型」，此名稱非標準模型名稱，疑為聽寫錯誤或內部代號。

## 可延伸追問

1.  Gate 與 JetBrains Gateway 的關係為何？是否必須安裝 Gate 才能使用桌面版 Claude Code？
2.  CCSwitch 的開源代碼及具體配置文檔在哪裡可以找到？
3.  修改註冊表時，具體添加的參數內容是什麼？是否有通用模板？
4.  如果 DeepSeek API 限流或停服，是否有備用模型（如 Kimi）的切換方案？
5.  此方法是否適用於 macOS 或 Linux 系統？