この記事ではAIエージェントに特化して解説します。AIエージェント全般は AIエージェントフレームワーク比較2026年版 をご覧ください。
何が起きたか
『Claude Code Unpacked』(ccunpacked.dev)が公開された。Anthropicの公式リリースではなく、ユーザーが自発的にClaude Codeのソースコードを解析し、内部アーキテクチャを可視化したドキュメント。エージェントループの11段階、40以上の組み込みツール、70以上のスラッシュコマンド、そして6つの未リリース機能が網羅されている。
背景と経緯
Claude Codeはテキストプロンプトから複雑な開発タスクを自動実行するエージェントとして機能しているが(Claude Codeベストプラクティスガイドで基本的な使い方を解説)、その内部動作は大部分がブラックボックス。開発者やパワーユーザーは「実際には何が起きているのか」「どのツールが何をできるのか」を知りたいという長年の需要があった。今回の解析により、その全容が初めて体系的に明かされることになった。
エージェントループの全11ステップ
キーボード入力またはstdin"] --> B["2. Message
テキスト解析"] B --> C["3. History
過去ログ取得"] C --> D["4. System
システムプロンプト"] D --> E["5. API
Claude API呼び出し"] E --> F["6. Tokens
トークンカウント"] F --> G{"7. Tools?
ツール呼び出し必要か"} G -->|Yes| H["8. Loop
ツール実行ループ"] G -->|No| I["9. Render
応答レンダリング"] H --> I I --> J["10. Hooks
イベントフック"] J --> K["11. Await
次の入力待機"]
ユーザーがテキストを入力すると、TextInputコンポーネント(Inkベース)がキャプチャ。非対話モードではパイプ入力を処理。その後、会話履歴、システムプロンプト、トークンカウントを経由してClaude APIに投入され、応答が返ってくる。ツール呼び出しが必要と判断されると、ループ内で複数ツールが順次実行される仕組み。
40以上の組み込みツール&その分類
40+ ツール"] --> B["File Operations
6ツール"] A --> C["Execution
3ツール"] A --> D["Search & Fetch
3ツール"] A --> E["Agents & Tasks
10ツール"] A --> F["Planning
4ツール"] A --> G["MCP
4ツール"] A --> H["System
8ツール"] A --> I["Experimental
4ツール"] B --> B1["FileRead"] B --> B2["FileEdit"] B --> B3["FileWrite"] B --> B4["Glob"] B --> B5["Grep"] B --> B6["NotebookEdit"] C --> C1["Bash"] C --> C2["PowerShell"] C --> C3["REPL"] D --> D1["WebFetch"] D --> D2["WebSearch"] D --> D3["ToolSearch"]
ツール別機能表
| カテゴリ | ツール数 | 主なツール | 用途 |
|---|---|---|---|
| ファイル操作 | 6 | FileRead, FileEdit, FileWrite, Glob, Grep, NotebookEdit | コード読み書き、検索、Jupyter操作 |
| 実行 | 3 | Bash, PowerShell, REPL | コマンド実行、スクリプト実行 |
| 検索・取得 | 3 | WebFetch, WebSearch, ToolSearch | Web検索、ドキュメント取得 |
| エージェント・タスク | 10 | Agent, SendMessage, TaskCreate, TaskList, TaskUpdate等 | マルチエージェント連携、タスク管理 |
| 計画 | 4 | EnterPlanMode, ExitPlanMode, EnterWorktree, ExitWorktree | プラン作成、ワークツリー操作 |
| MCP | 4 | ListMcpResources, ReadMcpResource, McpAuth | Model Context Protocol連携 |
| システム | 8 | AskUserQuestion, TodoWrite, Skill, Config等 | ユーザー問い合わせ、設定管理 |
| 実験的 | 4 | Sleep, Brief, StructuredOutput, LSP | 遅延実行、構造化出力 |
70以上のスラッシュコマンド体系
ソースコードから自動抽出された70以上のスラッシュコマンド:
セットアップ・設定系(12個)
/init /login /logout /config /permissions /model /theme
/terminal-setup /doctor /onboarding /mcp /hooks
日常ワークフロー系(24個)
/compact /memory /context /plan /resume /session /files
/add-dir /copy /export /summary /clear /brief /output-style
/color /vim /keybindings /skills /tasks /agents
/fast /effort /extra-usage /rate-limit-options
コードレビュー・Git系(13個)
/review /commit /commit-push-pr /diff /pr_comments /branch
/issue /security-review /autofix-pr /share
/install-github-app /install-slack-app /tag
デバッグ・診断系(23個)
/status /stats /cost /usage /version /feedback
/thinkback /thinkback-play /rewind /ctx_viz
/debug-tool-call /perf-issue /heapdump /ant-trace
/backfill-sessions /break-cache /bridge-kick
/mock-limits /oauth-refresh /reset-limits
/env /bughunter /passes
高度・実験的(23個)
/advisor /ultraplan /bridge /teleport /voice /desktop
/chrome /mobile /sandbox-toggle /plugin /reload-plugins
/remote-setup /remote-env /ide /stickers /good-claude
/btw /upgrade /release-notes /privacy-settings /help /exit /rename
ソースコード構成(564ファイル)
src/
├── components/ 389 files (UI層)
├── utils/ 564 files (ユーティリティ)
├── commands/ 189 files (スラッシュコマンド実装)
├── tools/ 184 files (ツール実装)
├── services/ 130 files (サービス層)
├── hooks/ 104 files (Reactフック)
├── ink/ 96 files (TUI/CLIカスタマイズ)
├── bridge/ 31 files (リモート接続)
├── constants/ 21 files (定数定義)
├── skills/ 20 files (スキルシステム)
└── cli/ (CLIエントリーポイント)
総行数は40,000+行以上。単なるスクリプトではなく、本格的なエージェントフレームワークの規模。
6つの未実装機能(フィーチャーフラグ・環境変数でゲート)
1. Buddy
ターミナル内に住む仮想ペット。ユーザーのアカウントIDから種族とレアリティが決定される。既に実装済みだが、デフォルトでは非表示。
2. Kairos
セッション間の永続的なメモリシステム。
- 日次ログの記録
- セッション間のメモリ統合
- 自動バックグラウンドアクション実行
3. UltraPlan
長時間プランニングモード。
- Opusクラスモデル専用
- 最大30分の実行ウィンドウ
- 複雑なプロジェクト計画に最適化
4. Coordinator Mode
マルチエージェントオーケストレーション。
- リードエージェントがタスク分割
- 複数ワーカーを隔離gitワークツリーで並列実行
- 結果を自動収集・統合
5. Bridge(リモートコントロール)
スマートフォンやブラウザからClaude Codeを操作。
- フルリモートセッション
- パーミッション承認フロー
6. Daemon Mode
バックグラウンド実行。
claude-code --bg
Tmuxを内部利用してセッション管理。
ボーナス: Auto-Dream
セッション間に、AIが過去の実行内容をレビューして学習を整理。UDS(Unix Domain Socket)インボックスでセッション間通信。
アーキテクチャの層構造
| レイヤー | 説明 | ファイル数 |
|---|---|---|
| UI/Components | Ink.jsベースのTUI、リアルタイムレンダリング | 389 |
| ビジネスロジック | コマンド解析、ツール呼び出し、エージェントループ | 189+184 |
| サービス層 | API通信、認証、キャッシング | 130 |
| フック・ステート | Reactのカスタムフック、状態管理 | 104 |
| リモート通信 | Bridge、UDS、ネットワーク | 31 |
| ユーティリティ | ヘルパー、ファイル操作、ログ | 564 |
今後の展望
解析者(zackautocracy)の備考によれば、公式ドキュメントが今後更新される可能性も示唆。未実装機能の中でも「Kairos」「Coordinator Mode」「Daemon Mode」は比較的完成度が高く、近い将来のリリース候補と推測される。
特にCoordinator Modeはプロダクション開発での複数ファイル同時編集やテスト並列実行、Kairosはセッション間の記憶継続によって大規模プロジェクト追跡が初めて実用的になる。Claude Code 2.1.108ガイドで紹介した最新機能と合わせて注目したい。
信頼性について
「Claude Code Unpacked」は非公式プロジェクト。Anthropic公式ではなく、ユーザー有志による逆算解析。分析対象となったソースコードは「Hacker Newsのポスト」で公開されたもの。情報の正確性は原則的に信頼できるが、内部実装変更により陳腐化する可能性がある。分析日時は2026年3月31日記載。
参照ソース
この記事はAI業界の最新動向を速報でお届けする「AI Heartland ニュース」です。