Claude Code アーキテクチャ分析：TypeScript ソースのリバースエンジニアリングが AI エージェントツールの 5 つの価値と 13 の設計原則を明らかに

この論文は何をするのか？

研究チーム（劉嘉成、趙暁涵、尚欣怡、沈志強）は 2026 年 4 月 17 日に arXiv で Claude Code のアーキテクチャの包括的な分析を発表しました——Anthropic の AI コーディングエージェントで、過去 1 年でこのカテゴリで最も影響力のあるツールの 1 つとなっています。

アプローチは珍しいものです：著者たちは配布された Claude Code パッケージの TypeScript ソースコードをリバースエンジニアリングし（npm モジュールとして出荷されており、技術的に読み取り可能）、アーキテクチャをマッピングし、OpenClaw——Claude Code の機能を複製しようとするオープンソースエージェント——と比較しました。

目標は「Claude Code をコピーする」ではなく：Anthropic が暗黙的に従う設計原則を理解することで、より広いコミュニティがより良いエージェントを構築できるようにすることです。

何を発見したか——5 つの基本的な価値

分析は Claude Code のアーキテクチャを構造的に導く 5 つの価値を抽出しました：

1. 人間の権威 — ユーザーは常に最終決定権を持ちます。エージェントは提案、計画、実行できますが、重要な決定（破壊的な操作、コミット、デプロイ）は明示的な承認が必要です。

2. 安全性 — 多層防御：ランタイムパーミッション、サンドボックス化、監査ログ、ロールバック。エージェントはプロジェクトを「誤って」破壊できません。

3. 実行力 — エージェントは解決策について話すだけでなく、実行します。シェルアクセス、ファイル編集、git 操作——すべて同じコンテキストから。

4. 能力 — 広範なツールセット（bash、read、edit、grep、ウェブフェッチなど）がエージェントをデモだけでなく実際の作業に実用的にします。

5. 適応性 — スキルメカニズムにより再コンパイルなしで拡張が可能です。MCP サーバーアクセスにより外部システムとの統合が開かれます。

著者はその後、これら 5 つの価値を実践化する 13 の設計原則を導出します——例えば「すべての破壊的ツールは明示的な承認が必要」、「コンテキストはトークン効率のために最大 N メッセージを保持」、「ツール結果はロールを混在させずに次の入力としてモデルに返される」など。

驚き：核心はシンプルな while ループ

論文の最も興味深い発見は Claude Code の核心が実際にいかにシンプルかということです：

while not done:
    response = model(current_context)
    if response contains tool_call:
        result = execute_tool(tool_call)
        context.append(result)
    else:
        wait_for_user_input()

すべての複雑性——知性、コンテキスト、ツール、安全性——は以下にあります：

• プロンプトとシステムメッセージ（モデルへの指示方法）
• ツールセットとそのパーミッション（エージェントが何をできるか、どのような条件下で）
• コンテキスト管理（何を保持し、圧縮し、削除するか）

核心に魔法の「エージェントオーケストレーション」ライブラリは存在しません。ループ、モデル、そして慎重に設計されたツールだけです。

なぜエージェントを構築するすべての人にとって重要か？

結論は重要です：

• 複雑なフレームワークは必要ありません。 LangGraph、CrewAI、AutoGen、AGP——すべて豊富なオーケストレーションを提供しますが、Claude Code は強力なシンプルさも競争力があることを示しています。
• 価値観 > 機能。 Anthropic が従う 5 つの基本価値は、UX からセキュリティの閾値まで製品のすべての側面に見えます。
• OpenClaw のレプリカが確認： 価値観とツールが適切に定義されていれば、シンプルなアーキテクチャで競争力のあるエージェントを作ることは可能です。

本論文はプレプリントです。コードは利用可能で（論文は再現性に言及）、分析は自身のエージェントプロジェクトのブループリントとして使えるほど具体的です。AI エージェント領域でビルドかバイかを考えているエンジニアにとって——これは必読の参照点です。