42萬字拆解 Claude Code：Agent Operating System 架構深度剖析（15 章全覽）

緣起

2026 年 3 月 31 日，安全研究員 Chaofan Shou 發現 npm 上的 Claude Code 包存在構建配置失誤，披露推文獲超 1700 萬次瀏覽，引發技術社區對 Agent 架構的空前討論。作者連夜讀完源碼，寫成這本 42 萬字的系統分析書，2 小時內破 400+ Star。

聲明：本書基於公開文檔和產品行為的架構分析，未引用任何未授權源碼。

不做使用教程，不列 Prompt 技巧。

這本書填補的空白是：為什麼 用異步生成器而不是回調？為什麼 權限檢查要分四個階段？上下文窗口用完了怎麼辦？

Ch01 智能體編程的新範式 Agent Harness 五大設計原則（異步生成器優先、安全邊界內嵌、緩存感知、漸進能力擴展、不可變狀態流）；技術棧選型（Bun + React/Ink + Zod v4）

Ch02 對話循環 — Agent 的心跳 while(true) 異步生成器主循環完整生命週期；五種 yield 事件類型；十種終止原因與狀態機模型

Ch03 工具系統 — Agent 的雙手 Tool<Input, Output, Progress> 五要素協議；45+ 工具按 12 類註冊；並發分區的貪心算法；延遲工具發現（ToolSearchTool）

Ch04 權限管線 — Agent 的護欄 四階段管線（Schema 驗證→規則匹配→上下文評估→交互式確認）；五種權限模式（default→plan→auto→bubble→bypass）；推測性分類器的 2 秒 Promise.race

Ch05 設置與配置 — Agent 的基因 六層配置優先級鏈；安全邊界：為什麼 projectSettings 被排除在安全檢查之外（防惡意倉庫供應鏈攻擊）

Ch06 記憶系統 — Agent 的長期記憶 四種封閉式記憶類型；「只保存無法從當前狀態推導出的信息」的設計哲學；MEMORY.md 索引文件（200 行 / 25KB 上限）

Ch07 上下文管理 — Agent 的工作記憶 四級漸進壓縮策略（Snip→MicroCompact→Collapse→AutoCompact）；斷路器模式（連續 3 次失敗後熔斷，源自 1,279 個會話的真實數據）；壓縮後 token 預算（50K 總額 / 5K 每文件）

Ch08 鉤子系統 — Agent 的生命週期擴展點 五種 Hook 類型；26 個生命週期事件；結構化 JSON 響應協議（approve/block + updatedInput/additionalContext）

Ch09 子智能體與 Fork 模式 四種內置 Agent（Explore 只讀 / Plan 結構化 / General 全量 / Verification 對抗性）；Fork 模式的字節級上下文繼承；遞歸 Fork 防護

Ch10 協調器模式 — 多智能體編排 Coordinator-Worker 架構；協調器「只編排不執行」約束；四階段工作流（Research→Synthesis→Implementation→Verification）

Ch11 技能系統與插件架構 11 個核心內置技能；SKILL.md frontmatter 完整字段；三級參數替換；分層加載（managed→user→project→plugin→bundled）

Ch12 MCP 集成與外部協議 8 種傳輸協議；MCPConnectionManager 五態連接管理；三段式工具命名（mcp__{server}__{tool}）；Bridge 雙向通信系統

Ch13 流式架構與性能優化 啟動性能優化（並行預取 160ms→65ms，節省 59%）；惰性 require() 與 Zod 惰性 schema 評估

Ch14 Plan 模式與結構化工作流 Plan 模式「先想後做」哲學；ScheduleCronTool 本地調度（文件鎖防重複 / 7天自動過期 / Jitter 防驚群）

Ch15 構建你自己的 Agent Harness Agent Harness vs 簡單 API 調用的決策矩陣；六步實現路線圖；四層可觀測性體系；安全威脅模型與審計 Checklist