Claude Code 從原理到實戰
12 篇翔宇深度講解的閱讀地圖:從 Claude Code 是什麼,到上下文、記憶、命令檔案、SubAgents、MCP、許可權和外掛。
Claude Code 不只是一個終端裡的聊天框。理解它的關鍵,是把它看成一個進入工程現場的 coding agent:它能讀專案、執行命令、遵守規則、呼叫工具,也會被上下文、許可權和驗證方式約束。
這條路線先建立心智模型,再進入可複用能力和許可權邊界。不要從外掛、MCP 或 SubAgents 開始學,先理解 Claude Code 在哪裡工作、能看到什麼、被什麼約束。
這套從原理到實戰適合兩類人:剛開始用 Claude Code、但還停留在“讓 AI 寫程式碼”層面的人;以及已經在用,但想把規則、許可權、SubAgents、MCP 和外掛串成一套工程方法的人。
推薦讀法
12 篇分三個階段,每個階段解決一類核心問題。按順序讀最穩;帶著自己的具體問題挑讀也行——每篇開頭都標註"這一篇用 N 分鐘換什麼"。
| 階段 | 篇號 | 核心問題 | 讀完能做什麼 |
|---|---|---|---|
| A · 基礎心智 | 01-04 | AI 在哪裡工作 / 它能看到什麼 / 怎麼記住你的專案 / 怎麼跟它說話 | 不再當 AI 的搬運工,寫出能穩定收斂的提示詞 |
| B · 工程化協作 | 05-08 | 思考多深 / 流程怎麼複用 / 任務怎麼隔離 / 多 Agent 怎麼協作 | 把重複工作沉澱成 Skill,把長任務拆給 SubAgent 不汙染主桌子 |
| C · 擴充套件與邊界 | 09-12 | 外部系統怎麼接 / 操作怎麼自動檢查 / 許可權怎麼管 / 能力怎麼打包分發 | 用 MCP 接外部資料來源,用 Hooks 守住高危操作,用 Plugin 把團隊工具一鍵分發 |
12 篇之間不是孤立的功能清單,而是一條互相依賴的生長線:
flowchart TB
Start["你的工程專案"]
P01["01 位置<br/>AI 住在你電腦裡"]
P02["02 上下文<br/>當前能看到的"]
P03["03 記憶<br/>跨會話保留的"]
P04["04 提示詞<br/>四件套輸入"]
P05["05 思考深度<br/>effort 旋鈕"]
P06["06 Skills<br/>流程複用"]
P07["07 SubAgents<br/>上下文隔離"]
P08["08 Agent Teams<br/>多會話協作"]
P09["09 MCP<br/>外部系統連線"]
P10["10 Hooks<br/>到點必查"]
P11["11 Permissions<br/>訪問邊界"]
P12["12 Plugins<br/>打包分發"]
Start --> P01
P01 --> P02 --> P03
P03 --> P04 --> P05
P05 --> P06 --> P07 --> P08
P05 --> P09
P09 --> P10 --> P11
P11 --> P12
P06 -.-> P12
P07 -.-> P12
style P01 fill:#dcfce7,stroke:#22c55e,stroke-width:2px
style P06 fill:#fef3c7,stroke:#f59e0b
style P09 fill:#dbeafe,stroke:#3b82f6
style P11 fill:#fee2e2,stroke:#ef4444
style P12 fill:#f3e8ff,stroke:#a855f7,stroke-width:2px
實線 = 主線依賴(建議先讀);虛線 = 進階引用(Plugin 是 Skill / SubAgent 的打包容器)。
路線入口
01-04 基礎心智
先理解 Claude Code 是什麼、上下文視窗、記憶和提示詞四件套。
05-08 工程化協作
理解 thinking effort、Skills、SubAgents 和多 Agent 協作邊界。
09-12 擴充套件與許可權
進入 MCP、操作控制、許可權設計和外掛化能力。
官方教程
需要命令、配置、安裝和官方欄位時,回官方教程中文版。
章節地圖
- 01 · Claude Code 是什麼:先搞清楚 AI 住在哪裡,為什麼 Claude Code 和普通聊天助手不是一類東西。
- 02 · 一次能看多少程式碼:上下文視窗不是“記憶”,而是當前工作臺;工作臺被堆滿後,表現就會變差。
- 03 · 怎麼記住你的習慣:區分短期上下文和長期記憶,理解 Claude 怎麼儲存偏好與專案事實。
- 04 · 怎麼和 AI 說話:提示詞不是模板遊戲,重點是給足目標、上下文、邊界和驗收方式。
- 05 · AI 怎麼決定想多深:不同任務需要不同思考深度,別讓簡單任務過度推理,也別讓複雜任務秒答。
- 06 · 把重複的話寫成檔案:把常說的流程沉澱成命令檔案,降低重複溝通成本。
- 07 · 派助手去幹活:SubAgents 不是“開越多越好”,關鍵是任務能否清晰拆分。
- 08 · 多個 AI 怎麼協作:多 Agent 的難點不是並行,而是介面、上下文和整合責任。
- 09 · 怎麼連外部服務:MCP 解決“手不夠長”的問題,讓 Claude 接資料庫、瀏覽器、GitHub 等外部服務。
- 10 · 怎麼讓操作 100% 執行:靠規則和指令碼把必須執行的動作固化下來,不讓 AI 只憑記憶。
- 11 · 該給 AI 多少許可權:許可權不是越大越好,也不是越小越安全;要按風險分層。
- 12 · 怎麼給 AI 裝外掛:把經驗打包成可複用能力,讓 Claude Code 從工具變成個人工作系統。
讀完之後
讀完這 12 篇,你應該能回答三件事:
- 什麼任務適合交給 Claude Code——以及哪類任務它再聰明也做不好(位置 / 上下文 / 許可權的硬約束)
- 要給它哪些上下文和邊界——4 件套(目標 / 上下文 / 邊界 / 驗收)+ 該寫進 CLAUDE.md 的 vs 該臨時給的
- 什麼時候該把經驗沉澱成檔案、SubAgent、MCP 或外掛——也就是從"反覆說同樣的話"升級到"裝成可複用工具"
如果三件事都能回答,再做一道動手題:開啟你當前在用的專案,列出 3 個你最近一週反覆跟 AI 說的話——按本系列的判斷標準,每條該寫進 CLAUDE.md / SKILL.md / Hook / 提示詞模板 哪一個?讀完 03 / 06 / 10 / 04 四篇你應該能直接給答案。
官方資料
- Claude Code 官方文件 —— 12 篇覆蓋的所有概念都在這裡有原始定義
- Anthropic 模型配置 —— 模型別名、effort、上下文視窗的事實基準
- Claude Code What's New —— 版本更新和能力變化