Claude Code 五層架構

一句話定義：Claude Code（CC）的 Agent Development Kit 由五個層級組成，從規則記憶到團隊分發，逐層堆疊出可重複的 AI 工程能力。

五個層級

CLAUDE.md → Skills → Hooks → Subagents → Plugins
設定規則    提供專長  強制品質  委派工作    分發團隊

Layer 1 — CLAUDE.md（Memory Layer）

定義規則、命名、結構與專案期望。

• ~/.claude/CLAUDE.md（global）：所有專案載入
• <repo>/.claude/CLAUDE.md（project）：單一 repo 專用

Layer 2 — Skills（Knowledge Layer）

放在 skills/ 資料夾，CC 根據 SKILL.md 描述自動匹配並載入。

• SKILL.md：技能描述（觸發條件）
• scripts/：參考腳本與模板
• context.md：按需載入的隔離 subagent 知識

Layer 3 — Hooks（Guardrail Layer）

純 shell 腳本（非 AI），工具執行前後觸發。

• PreToolUse.sh：執行前攔截（例如擋 rm -rf）
• PostToolUse.sh：執行後處理（自動 lint、推播）
• SessionStart.sh：對話啟動時執行

關鍵特性：確定性（deterministic），不是 AI 判斷，是 git hooks 等級的硬規則。

Layer 4 — Subagents（Delegation Layer）

放在 subagents/，每個 subagent 有獨立 context window。

• code-reviewer.md、test-runner.md、explorer.md
• 優點：跑完只回傳結果，保持主對話 context 乾淨

Layer 5 — Plugins（Distribution Layer）

把上述四層打包成 plugin 供團隊統一安裝。

• manifest.json：plugin 描述檔
• 類似 npm packages 的代理能力
• 一鍵安裝，全團隊配置一致

設計理念

• L1-L2 是「靜態記憶／知識」 — 載入時讀進來
• L3 是「確定性護欄」 — 不靠 AI 判斷
• L4 是「隔離計算」 — 不污染主 context
• L5 是「共享分發」 — 讓團隊一致

與其他概念的關係

• 上一層使用：Claude Code 常用指令（操作這套架構的 slash command）
• 對比：Claude Chat 與 Claude Code 差異（Chat 沒有 L3/L4/L5）

來源

• Claude 五層架構與 Chat-CC 差異