# 影片筆記：Claude Code 入门到高级超详细教程（安装、常用命令、接入国内大模型、核心模式、配置以及CLI与MCP工具）

## 一句話總結

本影片詳細講解了 Claude Code 從環境安裝、基礎命令使用，到接入國內大模型（如 KMK2、Deepseek）的完整流程，並深入介紹了其三種核心模式（自動編輯、Plan、Yolo）、上下文壓縮機制、多層級配置文件系統（Cloud.md、Settings.json），以及內置工具、CLI 命令行工具與 MCP（Model Context Protocol）的整合應用。

## 核心重點

1.  **環境與安裝**：強調 Node.js (推薦 20+ 版本) 與 Git 的安裝，以及 VS Code 擴展的安裝。針對國內用戶，詳細說明了如何通過配置代理和 API Key 接入國產大模型。
2.  **核心模式差異**：
    *   **自動編輯模式 (Auto Edit)**：免確認創建/修改文件。
    *   **Plan 模式**：僅進行規劃，不執行代碼修改。
    *   **Yolo 模式**：最高權限，自動化執行所有操作，無需確認。
3.  **上下文與記憶管理**：
    *   使用 `/compact` 命令壓縮上下文以解決「失憶」問題。
    *   `Cloud.md` 作為系統提示詞，具有企業級、用戶級、項目級三層加載順序，用於定義開發規範。
4.  **工具生態整合**：
    *   支持調用系統 PATH 中的 CLI 工具（如 GitHub CLI）。
    *   通過 MCP (Model Context Protocol) 標準化接入外部工具（如 Chrome DevTools），實現瀏覽器自動化操作。
5.  **配置系統**：
    *   `Settings.json` 用於配置權限預設（Permissions）和環境變數（Env/代理）。
    *   配置具有層級覆蓋特性，項目級配置優先於用戶級，用戶級優先於企業級。

## 詳細大綱

### 1. 環境準備與基礎安裝
*   **依賴安裝**：
    *   Node.js：推薦版本 20、22 或 24。
    *   Git：需配置 Bash 工具環境變數（提及 `git.bass.exe` 或 `Gate.bass.exe`）。
*   **Claude Code 安裝**：
    *   通過命令行安裝 Claude Code。
    *   在 VS Code 中安裝 Claude Code 擴展。
*   **網路配置**：
    *   配置網路代理以解決訪問限制問題（提及測試訪問谷歌）。

### 2. 基礎操作與常用命令 (Slash Commands)
*   **基本命令**：
    *   `/init`：初始化項目記憶。
    *   `/add-dir`：切換工作目錄。
    *   `/clear`：清除對話歷史。
    *   `/compact`：壓縮上下文。
    *   `/model`：查看或切換模型。
    *   `/status`：查看狀態。
    *   `/config`：查看配置。
*   **版本管理**：啟動、驗證版本與升級。

### 3. 接入國產大模型
*   **模型選擇**：提及 KMK2 (Kimi/KMK2 ThinkingTurbo) 和 Deepseek (Deepseek Set)。
*   **API Key 配置**：
    *   獲取 API Key (提及 "apfk", "meel")。
    *   配置方式：臨時終端命令 vs 永久環境變數。
*   **快速切換**：使用 Windows Terminal 快速切換模型配置。
*   **計費與帳號**：提及美元計費、註冊帳號、封號風險及月之暗面 (約阵案面) 相關資訊。

### 4. 核心模式介紹
*   **自動編輯模式 (Auto Edit)**：
    *   免確認創建/修改文件。
    *   提及 "振动编辑模式" 或 "震动边境模式"。
*   **Plan 模式**：
    *   只規劃不執行，生成 Plan.md。
*   **Yolo 模式**：
    *   最高權限，自動化執行。
    *   提及 "Ulo模式" 或 "优劳模式"。
*   **模式切換**：通過快捷鍵切換模式。

### 5. 執行控制與歷史恢復
*   **中斷與恢復**：
    *   執行過程中按 `ESC` 鍵中斷操作（如依賴安裝超時）。
    *   輸入 `continue` 恢復後續操作。
*   **歷史對話管理**：
    *   按兩次 `ESC` 鍵進入歷史對話列表。
    *   使用 `ESC` 鍵選擇歷史節點並回滾。
    *   回滾選項：回滾繪畫與代碼、回滾對話、回滾代碼。
    *   強制關閉對話後，可透過命令重新打開歷史記錄並恢復任務狀態。

### 6. 上下文 (Context) 壓縮
*   **問題**：多輪對話導致上下文過長，可能引發「失憶」或「上下位溢出」。
*   **解決方案**：
    *   使用 `-compact` 命令手動壓縮對話。
    *   系統配置 `Auto Compact`：
        *   設為 `true`：自動壓縮。
        *   設為 `Force`：不自動壓縮。

### 7. 批量任務執行
*   **Task.md 文件配置**：
    *   新建 `Task.md` 文件，每行寫一個任務。
    *   Claude Code 讀取文件內容並依序執行每個任務。

### 8. Cloud.md 配置系統 (上下文/系統提示詞)
*   **作用**：相當於系統提示詞 (System Prompt)，定義項目上下文、開發規範、代碼風格。
*   **加載順序與作用範圍 (由上至下，下覆蓋上)**：
    1.  **企業級 (Enterprise)**：Windows/Mac 固定目錄，作用於公司編碼標準、安全策略。
    2.  **用戶級 (User)**：用戶目錄，作用於個人自定義要求，對所有項目有效。
    3.  **項目級 (Project)**：當前項目根目錄，作用於項目自定義要求。
    4.  **項目本地覆蓋 (Local Override)**：`cloud.local.md` (聽寫提及已廢棄)。
*   **創建與編輯**：
    *   手動在根目錄新建 `cloud.md`。
    *   使用 `-memory` 命令快速打開或創建。
    *   使用 `#` 開頭直接追加內容至 `cloud.md` (僅能添加，不能刪除)。
    *   運行 `/rnrt` 命令自動生成。

### 9. Settings.json 配置系統 (運行機制)
*   **作用**：配置 Claude Code 的運行機制、權限預設、代理設置等。
*   **加載順序與位置 (由上至下，下覆蓋上)**：
    1.  **企業級**：系統固定目錄。
    2.  **用戶級**：用戶目錄下的配置文件。
    3.  **項目級**：項目目錄下的 `.cloud` 文件夾中。
    4.  **項目本地覆蓋**：項目根目錄下的 `.cloud` 文件夾中 (常用於個人測試，通常被 Git 忽略)。
*   **關鍵配置項**：
    *   **Permissions (權限)**：非 Yolo 模式下，創建文件、讀取、執行 bash 命令需請求權限。可預設允許特定操作 (如 `edit`, `bash`, `git-commit`, `webfiles`)。
    *   **Env (環境變數)**：可在此配置代理 (Proxy)。

### 10. 工具使用 (Tools)
*   **內置工具 (Built-in Tools)**：
    *   包括 `byte`, `edit`, `read`, `task`, `webfiles`, `website` 等。
    *   根據任務自動調用，部分工具需手動確認權限。
*   **命令行工具 (CLI Tools)**：
    *   只要系統 PATH 中存在 CLI 工具，Claude Code 即可調用。
    *   **示例：`ghcrl` (GitHub CLI)**：
        *   安裝方式：Claude Code 安裝、命令行安裝、手動下載。
        *   登錄：使用 `gh auth login` 流程登錄 GitHub。
        *   使用：透過 Claude Code 調用 CLI 命令 (如推送代碼到 GitHub)。
*   **MCP (Model Context Protocol)**：
    *   **定義**：AI 使用的標準化工具箱，用於與外部系統交互。
    *   **配置層級與範圍**：
        1.  **本地範圍 (Local)**：`mcp.json` 文件，僅當前項目目錄有效。
        2.  **項目範圍 (Project)**：項目根目錄 `.mcp.json`，僅當前項目有效。
        3.  **用戶範圍 (User)**：全局配置文件，所有項目啟用。
    *   **添加方式**：
        *   使用 `cloud mcp` 命令，通過 `scope` 參數指定範圍 (local, project, user)。
        *   Transport 類型：Remote ATP, Remote SSE, Local STDIO (Windows 需用 `cmd /c` 包裝 npx)。
    *   **加載順序**：本地 > 項目 > 用戶 (解決衝突)。
    *   **示例：`Chrome DVTools` MCP**：用於自動化控制瀏覽器操作 (如打開 GitHub 並點 Star)。

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

*   **開發環境/系統**：Windows, macOS, Linux
*   **基礎依賴**：Node.js (推薦版本 20, 22, 24), Git (提及 `git.bass.exe` 或 `Gate.bass.exe`)
*   **核心工具**：Claude Code (影片口語常稱為 "Cloud Code" 或 "Cloud Code for VS Code")
*   **編輯器**：VS Code (PowerShell, CMD, Windows Terminal)
*   **國產大模型/API**：
    *   KMK2 (提及 "KPK2", "KMK2 ThinkingTurbo")
    *   Deepseek (提及 "deep secret", "Deepshake", "Deepseek Set")
*   **其他提及**：
    *   Cloud.md (項目記憶文件)
    *   Plan.md (規劃文件)
    *   Task.md (批量任務文件)
    *   API Key (提及 "apfk", "meel")
    *   MCP (Model Context Protocol)
    *   Chrome DVTools (MCP 示例)
    *   GitHub CLI (提及 `ghcrl`)

## 操作流程整理

### 1. 環境準備與安裝
1.  安裝 Node.js (推薦 20 以上版本)。
2.  安裝 Git 並配置 Bash 工具環境變數。
3.  安裝 Claude Code (命令行工具)。
4.  在 VS Code 中安裝 Claude Code 擴展。
5.  (可選) 配置網路代理以解決訪問限制。

### 2. 接入國產大模型 (以 KMK2/Deepseek 為例)
1.  獲取 API Key (從月之暗面或 Deepseek 官網)。
2.  配置環境變數：
    *   臨時：在終端中設置環境變數。
    *   永久：在系統或用戶級別設置環境變數。
3.  使用 Windows Terminal 快速切換模型配置。

### 3. 常用命令操作
1.  `/init`：初始化項目記憶。
2.  `/add-dir`：切換工作目錄。
3.  `/clear`：清除對話歷史。
4.  `/compact`：壓縮上下文。
5.  `/model`：查看/切換模型。
6.  `/status`：查看狀態。
7.  `/config`：查看配置。

### 4. 配置 Cloud.md (系統提示詞)
1.  手動在項目根目錄新建 `cloud.md`。
2.  或使用 `-memory` 命令快速打開/創建。
3.  使用 `#` 開頭追加內容至 `cloud.md`。
4.  運行 `/rnrt` 命令自動生成。
5.  根據需求設置企業級、用戶級或項目級配置。

### 5. 配置 Settings.json (運行機制)
1.  在項目目錄下的 `.cloud` 文件夾中創建或編輯 `settings.json`。
2.  配置 Permissions (權限)：預設允許特定操作 (如 `edit`, `bash`)。
3.  配置 Env (環境變數)：設置代理 (Proxy)。

### 6. 使用 MCP 工具 (以 Chrome DVTools 為例)
1.  使用 `cloud mcp` 命令添加 MCP 服務。
2.  指定範圍 (scope)：local, project, 或 user。
3.  選擇 Transport 類型 (Remote ATP, Remote SSE, Local STDIO)。
4.  (Windows) 使用 `cmd /c` 包裝 npx 命令。
5.  在對話中調用 MCP 工具進行自動化操作 (如瀏覽器操作)。

### 7. 批量任務執行
1.  新建 `Task.md` 文件。
2.  在文件中每行寫一個任務。
3.  Claude Code 讀取文件內容並依序執行每個任務。

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

1.  **上下文溢出 (失憶)**：多輪對話導致上下文過長，可能引發模型「失憶」或「上下位溢出」，需使用 `/compact` 或配置 `Auto Compact` 進行壓縮。
2.  **權限請求**：在非 Yolo 模式下，創建文件、讀取、執行 bash 命令等操作需手動確認權限，可能影響效率。可通過 `Settings.json` 預設允許特定操作來優化。
3.  **帳號風險**：使用國產大模型 API 時，需注意帳號註冊、計費 (美元) 及可能的封號風險。
4.  **配置覆蓋邏輯**：Cloud.md 和 Settings.json 的配置具有層級覆蓋特性 (項目級 > 用戶級 > 企業級)，需注意配置衝突。
5.  **Windows Terminal 兼容性**：在 Windows 上使用 MCP 的 Local STDIO 傳輸時，可能需要使用 `cmd /c` 包裝 npx 命令。

## 逐字稿辨識疑點

以下詞彙根據逐字稿原文記錄，可能存在聽寫錯誤或口誤，未做更正版：

*   **Cloud Code 相關**：
    *   "Cloud Code入名" -> 疑點：應為 "Cloud Code 入門"
    *   "OS Code" -> 疑點：應為 "VS Code"
    *   "project生涯文" -> 疑點：應為 "project 配置文件" 或類似含義
    *   "Cloud Code for VS Code" -> 確認為擴展名稱
    *   "Cloud Code Hair" -> 疑點：應為 "Cloud Code help"
    *   "坛数" -> 疑點：應為 "參數"
    *   "长远命令" -> 疑點：應為 "常用命令"
    *   "还五个" -> 疑點：應為 "訪問" (測試訪問谷歌)
    *   "人民币的汇率" -> 疑點：應為 "美元" 或 "美金" (上下文提及美元計費)
    *   "可乐扣扣" -> 疑點：應為 "Cloud Code"
    *   "claw code" -> 疑點：應為 "Cloud Code"
    *   "触手化" -> 疑點：應為 "初始化"
    *   "记忆指南" -> 疑點：應為 "記憶指南" 或 "記憶文件"
    *   "上下纹" -> 疑點：應為 "上下文"
    *   "自然远" -> 疑點：應為 "自然語言"
    *   "拜设工具" -> 疑點：應為 "Bash 工具"
    *   "原始速度" -> 疑點：應為 "原始結果"
    *   "排序结果" -> 疑點：應為 "排序結果"
    *   "优化版本结果" -> 疑點：應為 "優化版本結果"
    *   "失忆了" -> 疑點：應為 "上下文溢出" 或 "丟失上下文"
    *   "上下位溢出" -> 疑點：應為 "上下文溢出"
    *   "下回一出" -> 疑點：應為 "上下文溢出"
    *   "爆成就行" -> 疑點：應為 "保存並退出" 或 "保存即可"
    *   "击费" -> 疑點：應為 "計費"
    *   "预购价格" -> 疑點：應為 "預估價格"
    *   "防御" -> 疑點：應為 "註冊" (註冊帳號)
    *   "封号" -> 確認為常見術語
    *   "约阵案面" -> 疑點：應為 "月之暗面" (Kimi/KMK2 開發商)
    *   "kmk2" -> 確認為模型名稱
    *   "deep secret" -> 疑點：應為 "Deepseek"
    *   "meel" -> 疑點：應為 "Key" (API Key)
    *   "冰花数" -> 疑點：應為 "並發數"
    *   "猫人" -> 疑點：應為 "免費"
    *   "FaceUIL" -> 疑點：應為 "API URL"