アクシャイ　Claude Code 6層アーキテクチャ解析：モデルは単なるループ内の1つのノードにすぎない

AI 工程師 Akshay Pachaar 5 月 10 日在 X 上公開了一張 Claude Code の全体構成図で、システム全体を 6 つの階層に分解し、「モデルはループの中の一つのノードにすぎない」と強調した。Pachaar の投稿は、4 月 6 日の長文エッセイ『The Anatomy of an Agent Harness』を引用しており、ポイントは、Claude Code が「魔法のよう」に見えるのはモデルそのものではなく、harness 工学の精緻な設計にある、という点だ。

6 層構造：モデルはその中の 1 つのノード

Pachaar が整理した Claude Code 6 層：

入力層（Input Layer）：session 管理、権限制御、YAML 設定による信頼レベルを担当する。いかなる指令もモデルに入る前に、この層を経由する。

知識層（Knowledge Layer）：skill registry、context compressor（3 段圧縮、92% の閾値で発火）、task graph、セッションをまたぐ記憶の保存を含む。これは harness の「知性」が存在する場所であり、モデルの重みとは独立している。

実行層（Execution Layer）：typed registry を通じてツール呼び出しをディスパッチし、各ツールに 1 つの 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 ブランチで独立）を含む。

観測層（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」の 3 種類のサブエージェント実行モードのうち、Worktree が最も強い隔離レベルだ。

Prompt cache の 10% コスト：安定したプレフィックス（system prompt、ツール定義、CLAUDE.md）をキャッシュすることで、同一プレフィックスの重複呼び出しは標準 token 費用の 10% だけで済む。これは長い 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 層構造を解析：モデルはループの中の 1 つのノード」は、最初に 鏈新聞 ABMedia に掲載された。