Akshay 解析 Claude Code 6 層架構：模型只是迴圈中的一個節點

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。