エージェントループ

学ぶこと

最初のセッションでは、Claude Code の心臓部であるエージェントループを理解します。すべてのインタラクション — シンプルな「このバグを直して」から複雑なマルチファイルリファクタリングまで — このループを通じて処理されます。

問題

Claude Code にプロンプトを入力すると、注目すべきことが起こります：AI は一度だけ応答するのではなく、ファイルを読み、コマンドを実行し、コードを編集し、続けていきます — すべて一回のインタラクションで。

仕組み

コアアーキテクチャの簡略図：

┌─────────────────────────────────────────┐
│              Agent Loop                  │
│                                          │
│  ┌──────────┐                            │
│  │ プロンプト │◄──── ユーザーメッセージ     │
│  └────┬─────┘                            │
│       ▼                                  │
│  ┌──────────┐                            │
│  │  Claude   │◄──── システムプロンプト +   │
│  │   API     │      メッセージ履歴         │
│  └────┬─────┘                            │
│       ▼                                  │
│  ┌──────────────┐                        │
│  │ stop_reason?  │                       │
│  └──┬───────┬───┘                        │
│  "end_turn" "tool_use"                   │
│     │       │                            │
│   完了    ツール実行 → ループバック         │
└──────────────────────────────────────────┘

stop_reason	アクション	意味
end_turn	ループ停止	AI が完了、ユーザーに応答を返す
tool_use	ツール実行、ループバック	AI が応答前にツールを使いたい

キーインサイト

エージェントループはチャットボットではありません。 チャットボットは一つのメッセージを処理して応答します。エージェントループは Node.js のイベントループに近い — やることがなくなるまで処理を続けます。

次のセッション

ループを理解した今、セッション 2 ではツールシステムと権限に進みます。