---
title: "Claude Code 從原理到實戰"
description: "12 篇Aaron深度講解的閱讀地圖：從 Claude Code 是什麼，到上下文、記憶、命令檔案、SubAgents、MCP、許可權和外掛。"
verifiedAt: "2026-05-08"
---

Claude Code 不只是一個終端裡的聊天框。理解它的關鍵，是把它看成一個進入工程現場的 coding agent：它能讀專案、執行命令、遵守規則、呼叫工具，也會被上下文、許可權和驗證方式約束。

> [!NOTE]
> 這條路線先建立心智模型，再進入可複用能力和許可權邊界。不要從外掛、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 篇之間不是孤立的功能清單，而是一條互相依賴的生長線：

```mermaid
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 的打包容器）。

## 路線入口

<Cards>
  <Card title="01-04 基礎心智" description="先理解 Claude Code 是什麼、上下文視窗、記憶和提示詞四件套。" href="/zh-Hant/docs/claude-code/understanding/01-what-is-claude-code" />
  <Card title="05-08 工程化協作" description="理解 thinking effort、Skills、SubAgents 和多 Agent 協作邊界。" href="/zh-Hant/docs/claude-code/understanding/05-thinking-depth" />
  <Card title="09-12 擴充套件與許可權" description="進入 MCP、操作控制、許可權設計和外掛化能力。" href="/zh-Hant/docs/claude-code/understanding/09-mcp" />
  <Card title="官方教程" description="需要命令、配置、安裝和官方欄位時，回官方教程中文版。" href="/zh-Hant/docs/claude-code/official" />
</Cards>

## 章節地圖

- [01 · Claude Code 是什麼](/zh-Hant/docs/claude-code/understanding/01-what-is-claude-code)：先搞清楚 AI 住在哪裡，為什麼 Claude Code 和普通聊天助手不是一類東西。
- [02 · 一次能看多少程式碼](/zh-Hant/docs/claude-code/understanding/02-context-window)：上下文視窗不是“記憶”，而是當前工作臺；工作臺被堆滿後，表現就會變差。
- [03 · 怎麼記住你的習慣](/zh-Hant/docs/claude-code/understanding/03-memory)：區分短期上下文和長期記憶，理解 Claude 怎麼儲存偏好與專案事實。
- [04 · 怎麼和 AI 說話](/zh-Hant/docs/claude-code/understanding/04-prompting)：提示詞不是模板遊戲，重點是給足目標、上下文、邊界和驗收方式。
- [05 · AI 怎麼決定想多深](/zh-Hant/docs/claude-code/understanding/05-thinking-depth)：不同任務需要不同思考深度，別讓簡單任務過度推理，也別讓複雜任務秒答。
- [06 · 把重複的話寫成檔案](/zh-Hant/docs/claude-code/understanding/06-command-files)：把常說的流程沉澱成命令檔案，降低重複溝通成本。
- [07 · 派助手去幹活](/zh-Hant/docs/claude-code/understanding/07-subagents)：SubAgents 不是“開越多越好”，關鍵是任務能否清晰拆分。
- [08 · 多個 AI 怎麼協作](/zh-Hant/docs/claude-code/understanding/08-multi-agent)：多 Agent 的難點不是並行，而是介面、上下文和整合責任。
- [09 · 怎麼連外部服務](/zh-Hant/docs/claude-code/understanding/09-mcp)：MCP 解決“手不夠長”的問題，讓 Claude 接資料庫、瀏覽器、GitHub 等外部服務。
- [10 · 怎麼讓操作 100% 執行](/zh-Hant/docs/claude-code/understanding/10-operation-control)：靠規則和指令碼把必須執行的動作固化下來，不讓 AI 只憑記憶。
- [11 · 該給 AI 多少許可權](/zh-Hant/docs/claude-code/understanding/11-permissions)：許可權不是越大越好，也不是越小越安全；要按風險分層。
- [12 · 怎麼給 AI 裝外掛](/zh-Hant/docs/claude-code/understanding/12-plugins)：把經驗打包成可複用能力，讓 Claude Code 從工具變成個人工作系統。

## 讀完之後

讀完這 12 篇，你應該能回答三件事：

1. **什麼任務適合交給 Claude Code**——以及哪類任務它再聰明也做不好（位置 / 上下文 / 許可權的硬約束）
2. **要給它哪些上下文和邊界**——4 件套（目標 / 上下文 / 邊界 / 驗收）+ 該寫進 CLAUDE.md 的 vs 該臨時給的
3. **什麼時候該把經驗沉澱成檔案、SubAgent、MCP 或外掛**——也就是從"反覆說同樣的話"升級到"裝成可複用工具"

如果三件事都能回答，再做一道動手題：**開啟你當前在用的專案，列出 3 個你最近一週反覆跟 AI 說的話**——按本系列的判斷標準，每條該寫進 CLAUDE.md / SKILL.md / Hook / 提示詞模板 哪一個？讀完 03 / 06 / 10 / 04 四篇你應該能直接給答案。

## 官方資料

- [Claude Code 官方文件](https://code.claude.com/docs/en/overview) —— 12 篇覆蓋的所有概念都在這裡有原始定義
- [Anthropic 模型配置](https://code.claude.com/docs/en/model-config) —— 模型別名、effort、上下文視窗的事實基準
- [Claude Code What's New](https://code.claude.com/docs/en/whats-new) —— 版本更新和能力變化

## 接下來去哪

<Cards>
  <Card title="先讀第 1 篇" description="從 Claude Code 是什麼開始，不要直接跳到高階機制。" href="/zh-Hant/docs/claude-code/understanding/01-what-is-claude-code" />
  <Card title="提示詞四件套" description="已經會用但經常不穩，先補目標、上下文、邊界和驗收。" href="/zh-Hant/docs/claude-code/understanding/04-prompting" />
  <Card title="SubAgents" description="想並行或隔離髒上下文，再進入子代理篇。" href="/zh-Hant/docs/claude-code/understanding/07-subagents" />
  <Card title="許可權邊界" description="真實專案裡最容易出事的是許可權，不是模型能力。" href="/zh-Hant/docs/claude-code/understanding/11-permissions" />
</Cards>
