Claude Code 初學者架構教學

本教學採三層資訊架構:首頁先選模組,再進入主題群組頁,最後閱讀各章節的由淺入深內容。

三種閱讀入口

同一章可以用不同方式讀,不需要被固定層級格式綁住。

先抓全貌

用最短時間掌握責任邊界與主流程,建立共同語言。

沿著執行路徑看

聚焦關鍵判斷、狀態轉換與常見改動點,直接對應實作。

深入取捨與風險

對照替代方案與失敗路徑,建立可維護的設計判斷。

章節閱讀骨架

所有章節遵循同一個閱讀順序,確保你在不同主題下也能維持一致節奏。

  1. 90 秒總覽:先定義這章解決的核心問題。
  2. 執行路徑:用流程圖與片段程式碼掌握主幹。
  3. 關鍵決策:理解設計選擇與代價。
  4. 替代方案取捨:知道為什麼不是另一種做法。
  5. 失敗路徑:先看錯誤,再看防護。
  6. 實作驗證:用最小驗證集確認你真的看懂。

四階段學習路線

建議按階段前進,先看總覽,再依需求深入執行細節與取捨分析。

階段一:基礎概念快速起步 → 啟動流程 → 指令系統
階段二:核心機制Skills 機制 → 工具系統 → 回合引擎 → 服務與 MCP
階段三:進階架構狀態與任務 → 模式與權限 → 記憶系統 → 代理與擴充
階段四:深入主題提示系統 → Hooks 與自動化 → 終端 UI
graph LR
  subgraph phase1["基礎概念"]
    A[快速起步] --> B[啟動流程]
    B --> C[指令系統]
  end
  subgraph phase2["核心機制"]
    C --> D[Skills 機制]
    D --> E[工具系統]
    E --> F[回合引擎]
    F --> N[服務與 MCP]
  end
  subgraph phase3["進階架構"]
    N --> G[狀態與任務]
    G --> H[模式與權限]
    H --> I[記憶系統]
    I --> J[代理與擴充]
  end
  subgraph phase4["深入主題"]
    J --> K[提示系統]
    K --> L[Hooks 與自動化]
    L --> M[終端 UI]
  end
        

依角色推薦閱讀路線

若你時間有限,可先依角色挑選章節,再回頭補完整路線。

角色 建議先讀 接著補讀 目標成果
第一次接觸 Claude Code 快速起步 → 啟動流程 指令系統 → 工具系統 能說清楚系統從輸入到回應的主流程
日常使用者(想提升效率) 指令系統 → 回合引擎 → 模式與權限 Hooks 與自動化 → 提示系統 能設計穩定的工作流並避免常見誤用
維護者/架構導向讀者 工具系統 → 狀態與任務 → 記憶系統 代理與擴充 → 服務與 MCP → 終端 UI 能評估設計取捨與擴充邊界

常見閱讀問題

我一定要照順序讀完 13 章嗎?

不用。先看首頁的角色路線快速上手,再補四階段路線,效率最高。

每章都要從頭看到尾嗎?

不必。建議先看總覽建立地圖,遇到工作需求時再下鑽細節段落。

我想直接改程式,先看哪裡?

先看「啟動流程、回合引擎、模式與權限」,這三章最能降低改動風險。

G0

架構總覽

先用一頁掌握核心模組邊界與協作關係,再決定下一步要深讀哪個系統。

前往章節
G1

啟動流程

從第一個輸入到進入互動回合的啟動路徑,先看快速地圖再看啟動細節。

前往章節
G2

指令系統

斜線命令如何註冊、過濾、路由,並與命令清單實際可見性銜接。

前往章節
G14

Skills 機制

從 skills 載入、發現、觸發到 inline/fork 執行與權限邊界的完整路徑。

前往章節
G3

工具系統

工具契約、組裝、過濾與操作風險判讀,包含完整工具/命令速查。

前往章節
G4

回合引擎

一次 submit 如何穿過系統提示、工具呼叫、串流輸出與收尾。

前往章節
G5

MCP 與服務

外部服務整合、MCP 工具資源注入與政策邊界的交會點。

前往章節
G6

狀態與任務

狀態變化如何驅動互動,任務如何跨回合同步與追蹤進度。

前往章節
G7

模式與權限

工具呼叫前的安全閘門與模式切換,決定哪些操作可被執行。

前往章節
G8

記憶系統

Session 與持久記憶如何載入、合併與影響當前對話決策。

前往章節
G9

代理與擴充

子代理、委派流程與擴充策略,如何在安全邊界內擴展能力。

前往章節
G10

提示系統

提示組裝分層與行為控制,從系統提示到工具提示的完整路徑。

前往章節
G11

Hooks 與自動化

事件觸發、自動執行、驗證與保護,建立可重複的工作流程。

前往章節
G12

終端 UI

CLI 介面渲染引擎、輸入互動、視覺更新與終端限制下的設計取捨。

前往章節
G13

雷達與觀測

用 `src/` feature gate 與條件載入信號追蹤可能尚未全面開放的能力。

前往章節

章節速查對照

如果你已經知道自己遇到的問題類型,可以直接用這張表定位應該先讀哪一章。

你現在卡住的問題 先讀章節 再讀章節 典型收穫
CLI 參數進來後不知道去哪裡 啟動流程 回合引擎 看懂輸入如何進入完整生命週期
不知道 command 為什麼會觸發某個 tool 指令系統 工具系統 掌握解析、分派與工具契約邊界
工具執行常被權限模式擋下 模式與權限 狀態與任務 釐清允許條件與狀態切換時機
對話品質不穩定,提示行為飄移 提示系統 記憶系統 理解提示組裝與記憶載入交互影響
想把流程自動化,但怕破壞安全邊界 Hooks 與自動化 代理與擴充 建立可控的擴充策略與防護點

建議學習節奏(7 天)

這是一個可直接執行的最小學習計畫,適合想在一週內建立穩定心智模型的讀者。

Day 1-2快速起步、啟動流程、指令系統(先看總覽與主流程)
Day 3-4工具系統、回合引擎、模式與權限(補齊失敗路徑)
Day 5記憶系統、提示系統(聚焦穩定性與一致性)
Day 6-7Hooks 與自動化、代理與擴充、終端 UI(看擴充邊界)