Claude Code Deep Dive

1. Core Model

五層架構總圖

先定義每個機制屬於哪一層，再談檔案、規則與團隊設計。這能避免把 `CLAUDE.md`、settings、hooks、skills 全部講成同一種東西。

Claude Code five-layer architecture map — 五層模型把政策、確定性、自訂能力、委派、以及 context 管理拆開。

Current Layer

控制平面

放政策和持久規則，例如 `CLAUDE.md`、rules、settings、permissions。

2. Mechanism Comparison

不是所有規則都該寫進 `CLAUDE.md`

這一區故意把三個最常混在一起的機制攤平比較，避免教學時把「文字規則」誤講成「可執行的確定性限制」。

Surface 適合放什麼不適合放什麼核心風險

`CLAUDE.md` 持久規則、工作節奏、檔案指引太長的 SOP、需要程式保證的限制規則互相衝突、越寫越像教科書

settings scope 與共享設定教學內容、工作方法論 scope 漂移、commit 了本該 local 的東西

hooks 確定性檢查、阻擋危險操作、驗收 gate 需要人判斷的模糊評論把所有事情都硬塞進 shell guardrail

3. Interactive Lab

Scope Switcher + Context Budget Demo

這個實驗頁面把兩個常見誤解拆開：設定 scope 是「放哪裡」，context budget 是「何時該清掉或文件化」。

Scope Switcher

建議檔案位置

~/.claude/settings.json

適合跨專案偏好的預設值，不適合放專案專屬工作流。

Context Budget

目前 session context 使用量

45%

還在安全區，可以繼續，但已經該開始把中間決策寫回檔案。

4. Episode Entry

EP01：控制架構總覽

這是第一集的網站入口。它把問題動機、五層模型、反模式與最小可行檔案樹串成一條清楚路徑。

已上線首集 · 網站互動頁配套

從「一堆 Claude Code 功能」切換成「一套可控的團隊系統」

一句話定義五層模型
三個最常見混用錯誤
最小可行 repo 範本

5. Season One

12 集內容導覽

第一季從五層系統模型開始，依序拆控制面、自動化、能力、協作與 context 治理，最後收在 GitHub Actions 與發佈自動化。

EP01

控制架構總覽

先把 Claude Code 講成五層系統，而不是功能清單。

EP02

CLAUDE.md 與記憶

拆解持久規則、記憶層次與 import 策略。

EP03

Settings 與作用域

分清 user、project、local、managed 的責任邊界。

EP04

Permissions 與模式

把允許清單、審批疲勞與工作流安全拆開看。

EP05

Hooks

把流程限制從文字升級成可執行的 guardrail。

EP06

Workflow Acceptance

用 lifecycle hook 設計 stop gate、handoff 與驗收。

EP07

Skills

把重複流程封裝起來，而不是把 root prompt 越寫越厚。

EP08

Sub-agents

按 ownership 與 context 隔離來設計委派。

EP09

Plugins

把團隊能力做成可攜式模板，不只侷限單一 repo。

EP10

MCP

延伸外部工具時，同時管理 trust boundary 與 token 成本。

EP11

Context 與 Compact

把 context 當資源管理，而不是越多越好。

EP12

GitHub Actions

把 repo 自動化接進交付、驗收與發佈。