# 影片筆記：不用魔法！国内免费用上 Claude Code 完整教程 | 接入 DeepSeek V4

## 一句話總結

本影片詳細演示了如何在中國大陸地區，無需翻牆、無需國外手機號與信用卡，透過安裝開源客戶端軟體 **Cloud Code** 並接入國內大模型 API（如 **DeepSeek V4**），實現安全、流暢且免費使用 AI 智能體代碼編輯器的完整流程，涵蓋環境配置、API 設置、權限管理及個性化設定。

## 核心重點

1.  **核心原理**：利用 **Cloud Code** 開源客戶端軟體，接入國內支援的大模型 API（如 DeepSeek），繞過對微軟官方模型服務（Azure OpenAI）的依賴。
2.  **適用對象**：希望使用強大 AI 智能體功能，但受困於網絡限制、需國外手機號/信用卡或易被封號的中國大陸用戶。
3.  **主要工具鏈**：
    *   **Cloud Code**：微軟推出的 AI 智能體/代碼編輯器插件（開源客戶端）。
    *   **Gate**：Cloud Code 依賴的協議/組件，用於讀寫本地文件。
    *   **Wingit**：微軟官方的 Windows 包管理器，用於安裝 Git 和 Cloud Code。
    *   **DeepSeek**：國內大模型供應商，提供 API Key 驅動 Cloud Code。
    *   **第三方配置工具**：用於可視化管理 API Key 及模型映射（文中提及供應商選項為 Leapsic）。
4.  **效果預期**：雖不及官方模型，但可達到八九成水平，且具備智能體工程設計能力。

## 詳細大綱

### 一、 背景與原理
*   **痛點**：Cloud Code 功能強大，但在國內使用面臨網絡限制、需國外手機號/信用卡、易被封號等問題。
*   **解決方案原理**：
    *   Cloud Code 強大在於「模型能力」與「智能體工程設計」。
    *   模型部分受限於官方服務，但智能體軟體部分可免費下載安裝。
    *   通過將 Cloud Code 接入國內大模型（如 DeepSeek、KMI 等），可驅動其正常運行。
    *   效果雖不及官方模型，但可達到八九成水平。

### 二、 環境安裝與配置
1.  **安裝 Gate**
    *   原因：Cloud Code 指令基於 Gate 協議，無 Gate 可能報錯或無法識別文件結構。
    *   作用：讓 Cloud Code 能讀寫本地文件。
2.  **安裝 Git**
    *   工具：使用 Windows 包管理器 **Wingit**（命令行工具）。
    *   步驟：打開 PowerShell（或 Parsel/ParisShare），輸入命令安裝 Git，確認版本號（如 2.54.0）。
3.  **安裝 Cloud Code**
    *   方法一（有網絡條件）：使用官方命令從官方伺服器下載原生版（支持自動更新）。
    *   方法二（無網絡條件/國內推薦）：使用 **Wingit** 從微軟伺服器下載安裝版。
        *   缺點：不支持自動更新，需手動執行命令更新。
    *   驗證：安裝後啟動 Cloud Code，若提示無法連接 Azure OpenAI 伺服器，屬正常現象，因我們將使用第三方模型。

### 三、 接入國內大模型 (DeepSeek)
1.  **獲取 API Key**
    *   訪問 DeepSeek 官方網站 -> API 開放平台。
    *   登錄（手機號碼驗證碼）。
    *   充值（建議充值少量金額，如 10 元，支持支付寶/微信）。
    *   創建 API Key（命名如 "cc"），複製並妥善保存（僅可查看一次）。
2.  **配置 Cloud Code**
    *   **傳統方法**：手動編輯 Cloud 安裝目錄下的配置文件。
    *   **推薦方法**：使用開源工具進行 API 配置管理和快速切換。
        *   工具功能：可視化界面管理 API，支持 Cloud Code、Codex、GIM9、OpenCode 等智能體。
        *   步驟：
            1. 下載並安裝該開源工具（Windows 安裝版）。
            2. 選擇 Cloud Code。
            3. 點擊加號，選擇供應商 **Leapsic**（註：原文聽似 Leapsic，疑點見下文）。
            4. 粘貼 DeepSeek 的 API Key。
            5. 測試連接（延遲約 400ms，確認密鑰有效）。
            6. **模型映射設置**：將默認的 V3 模型改為 V4 模型。
                *   主模型 (Hiku/Sonet) 改為 **V4 Flash**。
                *   Ops 改為 **V4 Pro**。
            7. 添加配置。
3.  **驗證生效**
    *   重新啟動 Cloud Code。
    *   確認模型顯示為 **DeepSeq v4**（註：原文聽似 DeepSeq，疑點見下文）。
    *   確認擁有 Cloud Code 的工具生態能力，底層模型為 DeepSeek。

### 四、 Cloud Code 基本使用與技巧
1.  **工作目錄限制**
    *   Cloud Code 基於工作目錄操作，讀寫文件限制在當前目錄及子目錄內。
    *   操作：進入目標目錄（如 Obsidian 文件夾）後，在該目錄下打開 Cloud Code。
2.  **上下文管理**
    *   基於「繪畫」（註：疑點，應為 Chat/對話）管理上下文。
    *   命令：使用特定命令切換歷史繪畫，或在啟動時附加 `-C` 命令打開關閉前的繪畫。
3.  **權限管理模式**
    *   切換方式：`Ctrl + Tab` 循環切換。
    *   **默認模式**：所有寫操作（編輯文件、運行命令、請求網絡）需手動批准。
    *   **自動編輯模式 (ExceptEdit)**：普通寫文件操作自動執行，但仍需監督。
    *   **完全繞過模式**：幾乎可執行所有操作，僅保護系統關鍵路徑。
        *   注意：默認關閉此模式，需在啟動命令後加參數，並進行二次確認才能啟用。
4.  **個性化設置 (cloud.md)**
    *   **項目級設置**：
        *   創建 `cloud.md` 文件，包含項目基本信息、規範、規則。
        *   初始化命令：Cloud 會自動分析當前目錄，提取結構、模板、命名規範生成 `cloud.md`。
    *   **全局級設置**：
        *   創建全局 `cloud.md`，定義全局基本信息、溝通風格、工作流程。
        *   方法：讓 Cloud 進行訪談，根據回答自動生成並寫入配置文件及長期記憶。
        *   效果：Cloud 越用越懂用戶。

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

*   **Cloud Code**：微軟推出的 AI 智能體/代碼編輯器插件。
*   **Gate**：Cloud Code 依賴的協議/組件。
*   **Wingit**：微軟官方的 Windows 包管理器。
*   **Git**：版本控制軟體。
*   **Parsel / ParisShare / Parsile**：逐字稿中提到的命令行工具名稱（疑點，通常指 PowerShell 或 Terminal）。
*   **Azure OpenAI (Azopik)**：微軟官方 AI 服務（文中提及無法連接）。
*   **DeepSeek (DeepSig / DeepSeq)**：國內大模型供應商（文中出現多種拼寫變體）。
*   **KMI**：國內大模型供應商（文中提及）。
*   **Codex**：AI 智能體。
*   **GIM9**：AI 智能體（疑點）。
*   **OpenCode**：AI 智能體。
*   **Leapsic**：開源配置工具中的供應商選項名稱（疑點）。
*   **Obsidian**：知識庫軟體（文中提及作為示例目錄）。
*   **ExceptEdit**：文中提及權限模式名稱（疑點）。
*   **Hiku / Sonet**：文中提及的模型名稱（疑點）。
*   **繪畫**：文中提及的上下文管理單位（疑點）。
*   **clode / clode.md**：文中後段多次將 Cloud Code 拼寫為 clode 或 clode.md（疑點）。

## 操作流程整理

1.  **準備環境**：
    *   安裝 **Gate** 以確保 Cloud Code 能讀寫本地文件。
    *   使用 **Wingit** 安裝 **Git**。
    *   使用 **Wingit** 安裝 **Cloud Code**（國內推薦安裝版，不支持自動更新）。
2.  **獲取 DeepSeek API Key**：
    *   訪問 DeepSeek 官方網站 API 開放平台。
    *   登錄並充值少量金額（如 10 元）。
    *   創建並複製 API Key（僅可查看一次）。
3.  **配置 API 與模型映射**：
    *   下載並安裝第三方開源配置工具。
    *   在工具中選擇 Cloud Code，點擊加號選擇供應商 **Leapsic**。
    *   粘貼 DeepSeek API Key 並測試連接。
    *   設置模型映射：
        *   主模型 (Hiku/Sonet) 改為 **V4 Flash**。
        *   Ops 改為 **V4 Pro**。
4.  **啟動與驗證**：
    *   重新啟動 Cloud Code。
    *   確認模型顯示為 **DeepSeq v4**。
5.  **日常使用與設置**：
    *   在目標目錄（如 Obsidian 文件夾）下打開 Cloud Code。
    *   根據需求切換權限模式（默認、自動編輯 ExceptEdit、完全繞過）。
    *   創建 `cloud.md` 進行項目級或全局級個性化設置，讓 AI 越用越懂用戶。

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

1.  **更新限制**：國內通過 Wingit 安裝的 Cloud Code 版本不支持自動更新，需手動執行命令更新。
2.  **模型效果**：接入國內大模型的效果雖可達到八九成水平，但不及官方模型。
3.  **權限風險**：「完全繞過模式」幾乎可執行所有操作，僅保護系統關鍵路徑，默認關閉，啟用需二次確認，用戶需注意安全。
4.  **API Key 安全**：DeepSeek API Key 僅可查看一次，需妥善保存。
5.  **網絡依賴**：仍需連接國內大模型供應商（DeepSeek）的服務器，需確保網絡暢通。

## 逐字稿辨識疑點

*   **Parsel / ParisShare / Parsile**：逐字稿中多次出現此名稱，指代打開命令行工具的途徑。實際 Windows 系統中通常為 **PowerShell** 或 **Terminal**。文中提到「在桌面上點擊鼠標右鍵...選中這個在中端中打開...打開了 Parsel」，疑似聽寫錯誤。
*   **DeepSig / DeepSeq / Deepsec**：逐字稿中對大模型名稱的拼寫不一致，分別出現為 DeepSig、Deepsec、DeepSeq。實際應指 **DeepSeek**。
*   **Leapsic**：在配置工具中選擇供應商時，逐字稿聽作「Leapsic」。實際 DeepSeek 的供應商名稱通常為 **DeepSeek** 或相關變體，此處需查證該開源工具中的具體顯示名稱。
*   **GIM9**：文中提及該工具支持「GIM9」智能體。此名稱疑似聽寫錯誤，常見 AI 智能體名稱可能為 **Gemini** 或其他，需查證。
*   **Azopik**：文中提及「無法連到 Azopik 的伺服器」。實際應指 **Azure OpenAI** 或 **Azure AI**。
*   **ExceptEdit**：文中提及權限模式為「自動編輯模式，也就是 ExceptEdit」。實際 Cloud Code 中的模式通常稱為 **Auto Edit** 或類似名稱，需查證具體參數或名稱。
*   **Hiku 和 Sonet**：文中提及模型映射時，「主模型 Hiku 和 Sonet」。實際 DeepSeek 的模型名稱通常為 **DeepSeek-V3**、**DeepSeek-V4** 或 **DeepSeek-R1** 等，「Hiku」和「Sonet」疑似聽寫錯誤。
*   **繪畫**：文中多次提到「基於繪畫來管理上下文」、「切換歷史的繪畫」。在 AI 對話語境下，應為 **Chat**（對話）或 **Session**（會話）的聽寫錯誤。
*   **安確人件**：文中提到「需要我守著它來安確人件」。疑似聽寫錯誤，應為 **審核文件** 或 **確認操作**。
*   **clode / clode.md**：文中後段多次將 Cloud Code 拼寫為 **clode** 或 **clode.md**，疑似口誤或聽寫錯誤。

## 可延伸追問

1.  該第三方開源配置工具具體名稱為何？如何下載與安裝？
2.  「Leapsic」供應商選項在該配置工具中是否正確對應 DeepSeek？
3.  Cloud Code 的「完全繞過模式」具體啟動參數為何？
4.  如何手動更新通過 Wingit 安裝的 Cloud Code？
5.  `cloud.md` 文件的具體語法規範與範例為何？