本研究では、ユーザーに代わってシェルコマンドの実行、ファイル編集、外部サービス呼び出しが可能なエージェント型コーディングツール「Claude Code」の包括的なアーキテクチャを、公開されているTypeScriptソースコードの分析を通じて詳細に解説します。

Claude Codeのアーキテクチャを動機づける5つの人間的価値観（人間の意思決定権、安全性とセキュリティ、信頼性の高い実行、能力増幅、文脈適応性）を特定し、それらが13の設計原則を経て具体的な実装選択にどのように反映されているかを追跡します。

システムの核心は、モデルの呼び出し、ツールの実行、そして繰り返しを行うシンプルなwhileループですが、コードの大部分は、このループを取り巻くシステムに存在します。具体的には、7つのモードとMLベースの分類器を備えた権限システム、コンテキスト管理のための5層のコンパクションパイプライン、4つの拡張性メカニズム（MCP、プラグイン、スキル、フック）、ワークツリー分離を備えたサブエージェント委譲メカニズム、そして追記型セッションストレージが挙げられます。

また、独立したオープンソースAIエージェントシステムであるOpenClaw（マルチチャネルパーソナルアシスタントゲートウェイ）との比較分析も行いました。これにより、デプロイメントコンテキストが変化すると、同じ設計上の課題に対して異なるアーキテクチャ的回答が導き出されることが示されました。例えば、アクションごとの安全性分類から境界レベルのアクセス制御へ、単一CLIループからゲートウェイ制御プレーン内の組み込みランタイムへ、コンテキストウィンドウの拡張からゲートウェイ全体での機能登録へと変化します。

最後に、最新の実証、アーキテクチャ、およびポリシー文献に基づいた、将来のAIエージェントシステムに向けた6つのオープンな設計方向性を提示しています。