# 影片筆記：500+ 小時 Claude Code 心得：5 件我希望早點知道的事

## 一句話總結
基於超過 500 小時的實際使用經驗，提出五個提升開發效率與精準度的關鍵心法：重視 Context 管理、先規劃後執行、大型專案使用 Superpowers、優先使用 CLI 節省 Token，以及明確分工 Claude Code 與 Codex 的職責。

## 核心重點
1.  **Context 是核心**：Claude Code 的輸出品質取決於提供的上下文（Context）。需善用 `.md` 設定檔與分階段載入資訊（Progress Reloading），避免 Context Window 被無關資訊佔用。
2.  **先規劃後執行**：避免直接要求實作，應先進入 Plan Mode 或要求多個實作方案，確認方向後再進行開發，減少來回修改次數。
3.  **大型專案使用 Superpowers**：針對複雜系統，使用 Brainstorming Skill 迫使開發者釐清細節與計畫，將模糊想法轉化為清晰 Plan。
4.  **優先使用 CLI**：相比 API 與 MCP，CLI 輸出的資訊最乾淨，能有效節省 Token 並避免 Context Window 被大量 MetaData 佔用。效率排名：CLI > API > MCP。
5.  **分工協作**：Claude Code 負責新功能開發與架構設計；Codex 負責 Debug、Code Review 與現有程式碼的最佳化。兩者思考方式不同，結合使用可解決單一模型無法突破的問題。

## 詳細大綱

### 一、 Context 是一切
*   **Context 的定義與來源**：
    *   Claude Code 的效果取決於提供的 Context 豐富度與準確性。
    *   **來源一：Cloud MD**：專案目錄下的設定檔，包含偏好、禁止事項及異常處理方式，每次任務自動讀取。
    *   **來源二：Project Context**：開始任務時提供的背景資訊（如當前進度、Session 目標、限制條件）。
*   **推薦做法：Progress Reloading**：
    *   避免一次性塞入所有資訊。
    *   根據任務需求分階段載入相關 Context。
    *   目的：避免 Context Window 浪費在不相關資訊上。

### 二、 先搞清楚流程再開始做
*   **常見錯誤（Before）**：
    *   直接要求 Claude Code 建立自動化系統（如：每天早上整理 Email 並發送）。
    *   結果方向錯誤，需多次來回修改（可能需改 5-6 次）。
*   **推薦做法（After）**：
    *   進入 **Plan Mode** 或要求 Claude Code 提供五個不同的實作方案。
    *   從方案中選擇最符合需求的一個，再開始實作。
    *   目的：確認方向與自身需求，減少來回修改的時間。
*   **輔助工具**：
    *   使用 Mirror 或 Axelidraw 繪製系統區塊（如 Agent, Memory, Productivity, Content Creation）。
    *   開發完成後將區塊標記為綠色（代表可運作）。

### 三、 大型專案要用 Superpowers
*   **適用情境**：建構較大系統或複雜任務。
*   **具體操作**：使用 **Super Powers** 中的 **Brainstorming Skill**。
*   **機制**：
    *   Claude Code 將使用者視為開發者，逐步詢問細節（目標、限制、功能需求、整體規劃）。
    *   迫使開發者將模糊想法轉化為清晰的 Plan。
    *   Plan 越清楚，最終產出越接近預期。
*   **效益**：避免花費數小時開發後發現方向完全走偏。

### 四、 能用 CLI 就用 CLI
*   **比較對象**：API、MCP、CLI。
*   **API 的問題**：
    *   回傳大量 JSON、MetaData、Status、Code、Object 等資訊。
    *   這些資訊會佔用 Context，浪費 Token。
    *   Claude Code 需額外處理解析邏輯。
*   **MCP 的問題**：
    *   雖為強大插頭，但背景資訊龐大。
    *   每次呼叫都會將資訊載入 Context。
    *   Session 越長，Context 越擁擠，極快耗盡 Token（例如未開始任務已消耗 4300 Token）。
*   **CLI 的優勢**：
    *   輸出非常乾淨，指令與結果對應，不多不少。
    *   相關設定（NCP Custom Command, Context File）存放在遠端雲端主機。
    *   只需呼叫指令並拿回結構化結果。
*   **結論**：
    *   效率排名：CLI > API > MCP。
    *   若僅使用單一服務可選 API；若服務功能多且無 MCP 支援，可考慮 MCP。

### 五、 Claude Code 負責開發，Codex 負責 debug 和更新
*   **分工原則**：
    *   **Claude Code**：負責新功能開發、架構設計、主要 Coding Work。
        *   使用 Front-end Design 或 Super Powers 等 Skill。
    *   **Codex**：負責 Debug、更新、Code Review、現有程式碼最佳化。
*   **協作模式**：
    *   當 Claude Code 遇到 Bug 或卡住時，切換至 Codex。
    *   Codex 在 Review 現有程式碼、找問題及提出修改建議方面表現優異。
    *   兩者思考方式不同，結合使用可解決 Claude Code 無法突破的問題。

### 六、 總結與資源
*   **五件事複習**：
    1.  善用 Cloud.md 與 Progress Loading 整合 Token。
    2.  先確認需求，使用 Plan Mode 提出方案後再執行。
    3.  複雜任務使用 Superpower Brainstorming Skill。
    4.  使用 CLI 節省 Token 且速度最快。
    5.  Claude Code 與 Codex 分工（開發 vs. Debug/Review）。
*   **核心觀念**：
    *   使用 Claude Code 不僅是建立獨立功能，而是建立一個可持續工作的 AI 系統。
    *   系統建立一次後，只需回覆、升級，無需每次都從零開始。
*   **額外資源**：
    *   提供關於建立 AI 系統、結合 Claude Code 與 Codex 的影片連結。
    *   提供今日內容整合的 PDF。
    *   邀請加入免費 Skill 社群，獲取 PDF 及更多技巧（如節省 Token、N8N 商業應用）。

## 工具 / 模型 / 名詞整理
*   **Claude Code** (文中亦出現拼寫變體：Cloud Code, Clock)
*   **Codex**
*   **Super Powers**
*   **Brainstorming Skill**
*   **Plan Mode**
*   **Front-end Design**
*   **CLI** (Command Line Interface)
*   **API**
*   **MCP** (文中亦出現拼寫變體：NCP, Cloud Code)
*   **JSON**
*   **MetaData**
*   **JAML** (疑點：通常為 YAML，但逐字稿聽寫為 JAML)
*   **Mirror**
*   **Axelidraw**
*   **AIOS**
*   **Agent**
*   **Memory**
*   **Productivity**
*   **Content Creation**
*   **N8N**
*   **YouTube**
*   **Classroom**
*   **Cloud.md**
*   **Progress Reloading**
*   **NCP Custom Command**

## 操作流程整理
1.  **初始化設定**：
    *   建立專案目錄下的 `Cloud.md` 設定檔，定義偏好、禁止事項及異常處理方式。
2.  **任務規劃階段**：
    *   進入 **Plan Mode** 或要求模型提供多個實作方案。
    *   使用 **Mirror** 或 **Axelidraw** 繪製系統區塊（Agent, Memory, Productivity, Content Creation）。
    *   若為大型專案，使用 **Super Powers** 中的 **Brainstorming Skill** 逐步釐清細節。
3.  **開發與執行階段**：
    *   選擇確認的方案進行實作。
    *   優先使用 **CLI** 進行指令呼叫，避免使用 API 或 MCP 以節省 Context Window。
    *   利用 **Progress Reloading** 策略，分階段載入相關 Context，避免一次性塞入過多資訊。
4.  **除錯與維護階段**：
    *   當 Claude Code 遇到 Bug 或卡住時，切換至 **Codex**。
    *   使用 Codex 進行 Debug、Code Review 及現有程式碼最佳化。
    *   將開發完成的區塊標記為綠色（代表可運作）。

## 值得注意的限制或風險
*   **Context Window 限制**：
    *   使用 API 或 MCP 時，回傳的大量 JSON、MetaData、Status 等資訊會佔用 Context，極快耗盡 Token（例如未開始任務已消耗 4300 Token）。
    *   一次性塞入所有資訊會導致 Context Window 浪費在不相關資訊上。
*   **方向錯誤風險**：
    *   若未先進行規劃（Plan Mode 或 Brainstorming），直接要求實作，可能導致方向錯誤，需多次來回修改（可能需改 5-6 次）。
*   **模型能力差異**：
    *   Claude Code 與 Codex 思考方式不同，單一模型可能無法突破某些問題，需依賴分工協作。

## 逐字稿辨識疑點
*   **Clock Code / Cloud Code**：逐字稿中交替出現 "Clock Code" 與 "Cloud Code"，疑似為同一產品名稱的聽寫不一致。
*   **NCP / MCP**：逐字稿中交替出現 "MCP" 與 "NCP"（例如："不要用 API, 不要用 NCP"、"MCPTools"、"NCP Custom Command"），疑似為同一技術名稱的聽寫不一致。
*   **JAML**：逐字稿提及 "用 JAML 來做一個查詢"，常見格式為 YAML，此處聽寫可能為錯誤。
*   **Mirror / Axelidraw**：疑似為特定繪圖或規劃工具的專有名詞，需查證是否為正確名稱。
*   **AIOS**：疑似為特定系統或專案名稱，需查證是否為正確名稱。
*   **CodeHater**：在描述 API 回傳內容時出現 "CodeHater"，疑似為 "Code Header" 或其他技術術語的聽寫錯誤。
*   **Cloud.md**：通常專案設定檔為 `.gitignore` 或 `.env` 等，"Cloud.md" 可能是特定工具要求的檔名或聽寫錯誤（疑為 `.md` 檔）。
*   **Progress Reloading**：此為講者自創或特定術語，指分階段載入 Context 的方式。
*   **Super Powers**：可能指代某個特定功能集或插件名稱。
*   **Brainstorming Skill**：可能指代某個特定功能或插件名稱。
*   **Front-end Design**：可能指代某個特定功能或插件名稱。
*   **PayPal**：講者提到 "那這個是我的一些 PayPal"，語境上疑似口誤，可能意指 "Payoff"、"Paywall" 或特定專案名稱，或單純口誤。

## 可延伸追問
1.  **Context 管理細節**：如何具體撰寫 `Cloud.md` 以最大化 Claude Code 的遵循度？有哪些具體的範例格式？
2.  **Plan Mode 實作**：Plan Mode 的具體指令或操作步驟為何？如何有效引導模型提供多個實作方案？
3.  **Super Powers 與 Brainstorming Skill**：這些 Skill 的具體安裝方式與使用介面為何？如何與現有開發流程整合？
4.  **CLI 與 MCP 比較**：在哪些特定情境下，MCP 的優勢會超過 CLI？是否有具體的效能對比數據？
5.  **Claude Code 與 Codex 切換機制**：在實際開發中，如何定義 "Bug" 或 "卡住" 的觸發條件，以決定何時切換至 Codex？