影片筆記：不用魔法！国内免费用上 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）。

1. 效果預期：雖不及官方模型，但可達到八九成水平，且具備智能體工程設計能力。

詳細大綱

一、 背景與原理

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

二、 環境安裝與配置

1. 安裝 Gate

• 原因：Cloud Code 指令基於 Gate 協議，無 Gate 可能報錯或無法識別文件結構。
• 作用：讓 Cloud Code 能讀寫本地文件。

1. 安裝 Git

• 工具：使用 Windows 包管理器 Wingit（命令行工具）。
• 步驟：打開 PowerShell（或 Parsel/ParisShare），輸入命令安裝 Git，確認版本號（如 2.54.0）。

1. 安裝 Cloud Code

• 方法一（有網絡條件）：使用官方命令從官方伺服器下載原生版（支持自動更新）。
• 方法二（無網絡條件/國內推薦）：使用 Wingit 從微軟伺服器下載安裝版。
• 缺點：不支持自動更新，需手動執行命令更新。
• 驗證：安裝後啟動 Cloud Code，若提示無法連接 Azure OpenAI 伺服器，屬正常現象，因我們將使用第三方模型。

三、 接入國內大模型 (DeepSeek)

1. 獲取 API Key

• 訪問 DeepSeek 官方網站 -> API 開放平台。
• 登錄（手機號碼驗證碼）。
• 充值（建議充值少量金額，如 10 元，支持支付寶/微信）。
• 創建 API Key（命名如 "cc"），複製並妥善保存（僅可查看一次）。

1. 配置 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。

1. 添加配置。
2. 驗證生效

• 重新啟動 Cloud Code。
• 確認模型顯示為 DeepSeq v4（註：原文聽似 DeepSeq，疑點見下文）。
• 確認擁有 Cloud Code 的工具生態能力，底層模型為 DeepSeek。

四、 Cloud Code 基本使用與技巧

1. 工作目錄限制

• Cloud Code 基於工作目錄操作，讀寫文件限制在當前目錄及子目錄內。
• 操作：進入目標目錄（如 Obsidian 文件夾）後，在該目錄下打開 Cloud Code。

1. 上下文管理

• 基於「繪畫」（註：疑點，應為 Chat/對話）管理上下文。
• 命令：使用特定命令切換歷史繪畫，或在啟動時附加 -C 命令打開關閉前的繪畫。

1. 權限管理模式

• 切換方式：Ctrl + Tab 循環切換。
• 默認模式：所有寫操作（編輯文件、運行命令、請求網絡）需手動批准。
• 自動編輯模式 (ExceptEdit)：普通寫文件操作自動執行，但仍需監督。
• 完全繞過模式：幾乎可執行所有操作，僅保護系統關鍵路徑。
• 注意：默認關閉此模式，需在啟動命令後加參數，並進行二次確認才能啟用。

1. 個性化設置 (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（國內推薦安裝版，不支持自動更新）。

1. 獲取 DeepSeek API Key：

• 訪問 DeepSeek 官方網站 API 開放平台。
• 登錄並充值少量金額（如 10 元）。
• 創建並複製 API Key（僅可查看一次）。

1. 配置 API 與模型映射：

• 下載並安裝第三方開源配置工具。
• 在工具中選擇 Cloud Code，點擊加號選擇供應商 Leapsic。
• 粘貼 DeepSeek API Key 並測試連接。
• 設置模型映射：
• 主模型 (Hiku/Sonet) 改為 V4 Flash。
• Ops 改為 V4 Pro。

1. 啟動與驗證：

• 重新啟動 Cloud Code。
• 確認模型顯示為 DeepSeq v4。

1. 日常使用與設置：

• 在目標目錄（如 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 文件的具體語法規範與範例為何？