Claude Code 源碼解讀
從源碼層面理解 Claude Code 的架構設計。不是使用教程,是工程解剖——每個模組怎麼設計、為什麼這麼設計。
01
全局視角:不只是 CLI 工具
從 4756 個檔案看 Claude Code 的整體架構:多入口設計、fast-path 分發、101 個命令的背後邏輯
02引擎:主迴圈與 Prompt 編排
query.ts 1729 行狀態機、10 步迴圈、Streaming Tool Execution,以及 Prompt 是怎麼組裝出來的
03工具系統:42 個工具和一條治理流水線
Tool.ts 介面設計、buildTool() 的 fail-closed 預設值、14 步執行 Pipeline,以及 Speculative Classifier 怎麼運作
04多 Agent 體系:分工和調度
6 種內建 Agent、Explore Agent 的嚴格唯讀、Verification Agent 的對抗性 prompt,以及 AgentTool.tsx 怎麼調度它們
05安全層:權限、Hook 和三層防護網
27 個檔案的權限系統、Hook 三個時點、Pre-hook 五種能力,以及三層防護怎麼組合
06生態:Skill、Plugin、MCP
17 個 bundled skill、Plugin 42 個檔案能改什麼、MCP 工具橋怎麼讓模型感知自身能力
07上下文經濟學:Token 就是預算
四道壓縮機制、Reactive Compact 兜底、Token Budget 分配,以及按需注入怎麼讓上下文視窗用在刀口上
08設計原則與產品化
生命週期管理、Bridge 系統、State 管理、UI 層,以及從程式碼庫裡讀出的 7 條設計原則