AI 工程師 Akshay Pachaar 5 月 10 日在 X 公开一張 Claude Code 完整架構圖，把整个系统拆解成 6 个層級、強调「模型只是迴圈中的其中一个節点」。Pachaar 的貼文引用他 4 月 6 日的长篇 essay《The Anatomy of an Agent Harness》，重点是：Claude Code 之所以「像魔法」、不是模型本身、而是 harness 工程的精細设计。
6 層架構：模型只是其中一个節点
Pachaar 整理的 Claude Code 6 層：
Input Layer（输入層）：负责 session 管理、權限控制、以 YAML 设定信任層級。任何指令进入模型前都先经过此層。
Knowledge Layer（知识層）：包含 skill registry、context compressor（3 層壓縮、92% 门檻觸发）、task graph、跨 session 的記憶儲存。这是 harness「智能」存在的地方，獨立於模型權重之外。
Execution Layer（執行層）：透过 typed registry 派遣工具呼叫，每个工具一个 handler—bash、read、write、grep、glob、revert。Streaming runtime 支援平行執行，prompt cache 重複利用穩定前綴、成本降至 10%。
Integration Layer（整合層）：MCP runtime 连接外部伺服器（filesystem、git、自訂工具）。工具向內註冊、記憶向外寫入 agent_memory.md。
Multi-Agent Layer（多代理層）：包含 subagent spawner、teammate mailboxes 透过 redis pub/sub 通訊、有限狀態机協议（IDLE→REQUEST→WAIT→RESPOND）、原子锁的 autonomous board、worktree 隔离（每个任務獨立 git branch）。
Observability Layer（觀測層）：包覆所有層的事件匯流排与 lifecycle hooks，背景執行器以 daemon thread 非阻塞运作。
正中央是「master agent loop」（主代理迴圈）：感知 → 行动 → 觀測。Anthropic 自己把这个迴圈定位为「dumb loop」（笨迴圈）—所有的智能在模型推理裡、harness 只负责调度。
关鍵设计：context compressor 与 worktree 隔离
幾个值得关注的设计細節：
Context compressor 3 層壓縮、92% 门檻：当上下文接近 92% 容量时觸发摘要与壓縮、保留架構決策与未解決的 bug、丟棄重複的工具输出。这呼应 Anthropic 公开的「context engineering 指引」：找最小高訊號 token 集合、最大化目標达成机率。
Worktree 隔离：每个 subagent 在獨立的 git worktree 与獨立分支上工作、合併时做衝突檢測。这套设计让多代理併行修改同一份代碼庫成为可能、不会互踩腳。Claude Code 的「Fork / Teammate / Worktree」三種子代理執行模式中、Worktree 是最強的隔离級別。
Prompt cache 10% 成本：透过快取穩定前綴（system prompt、工具定義、CLAUDE.md），相同前綴的重複呼叫只付 10% 的標準 token 费用。这是长 session 任務能維持成本可控的关鍵。
为什麼这份解析在社群引起共鳴
Pachaar 的貼文獲得 522 个讚、115 次转推，留言区出现「我以为只是个 CLI 工具」、「以为 Claude Code 等於 model + terminal access、不知道 multi-agent layer 有这麼多东西在跑」等回饋。这反映多數开发者对 Claude Code 的理解仍停在「Claude API 包了一層 CLI」、低估了 harness 工程的複雜度。
Pachaar 引用 LangChain 的 Vivek Trivedy 那句話作为核心論点：「如果你不是模型、你就是 harness。」TerminalBench 2.0 上 LangChain 的測試证明—同一个模型權重、只改變外圍 harness、排名从 30 名外躍升到第 5。
对 abmedia 读者来说、这份解析提供一个具體參考点：当你看到 Claude Code、Codex、Gemini Code Assist 等代理产品的差異、其实多數差異不在模型本身、而在 harness 设计—context 管理策略、工具範圍、验证迴圈、多代理協作模式。模型版本一升級、harness 工程的选擇就決定产品體验的高度。
这篇文章 Akshay 解析 Claude Code 6 層架構：模型只是迴圈中的一个節点 最早出现於 链新聞 ABMedia。
相关文章
