この記事ではAIエージェントに特化して解説します。AIエージェント全般は AIエージェントフレームワーク比較2026年版 をご覧ください。

何が起きたか

『Claude Code Unpacked』(ccunpacked.dev)が公開された。Anthropicの公式リリースではなく、ユーザーが自発的にClaude Codeのソースコードを解析し、内部アーキテクチャを可視化したドキュメント。エージェントループの11段階、40以上の組み込みツール、70以上のスラッシュコマンド、そして6つの未リリース機能が網羅されている。

背景と経緯

Claude Codeはテキストプロンプトから複雑な開発タスクを自動実行するエージェントとして機能しているが(Claude Codeベストプラクティスガイドで基本的な使い方を解説)、その内部動作は大部分がブラックボックス。開発者やパワーユーザーは「実際には何が起きているのか」「どのツールが何をできるのか」を知りたいという長年の需要があった。今回の解析により、その全容が初めて体系的に明かされることになった。

エージェントループの全11ステップ

Yes

No

1. User Input
キーボード入力またはstdin

2. Message
テキスト解析

3. History
過去ログ取得

4. System
システムプロンプト

5. API
Claude API呼び出し

6. Tokens
トークンカウント

7. Tools?
ツール呼び出し必要か

8. Loop
ツール実行ループ

9. Render
応答レンダリング

10. Hooks
イベントフック

11. Await
次の入力待機

ユーザーがテキストを入力すると、TextInputコンポーネント(Inkベース)がキャプチャ。非対話モードではパイプ入力を処理。その後、会話履歴、システムプロンプト、トークンカウントを経由してClaude APIに投入され、応答が返ってくる。ツール呼び出しが必要と判断されると、ループ内で複数ツールが順次実行される仕組み。

40以上の組み込みツール&その分類

Tools & Commands
40+ ツール

File Operations
6ツール

Execution
3ツール

Search & Fetch
3ツール

Agents & Tasks
10ツール

Planning
4ツール

MCP
4ツール

System
8ツール

Experimental
4ツール

FileRead

FileEdit

FileWrite

Glob

Grep

NotebookEdit

Bash

PowerShell

REPL

WebFetch

WebSearch

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 ニュース」です。