複数のエージェントをエージェントビューで管理する

1 つの画面から多くの Claude Code セッションをディスパッチして管理します。エージェントビューは、すべてのセッションが何をしているか、どのセッションが入力を必要としているかを表示します。

claude agents で開くエージェントビューは、すべてのバックグラウンドセッションの 1 つの画面です。実行中のもの、入力が必要なもの、完了したものが表示されます。新しいセッションをディスパッチし、トランスクリプトをスクロールする代わりに一目でセッションの状態を確認し、セッションが必要とするときだけ介入します。セッションはターミナルが接続されていなくてもバックグラウンドで実行し続けます。

エージェントビューは、Claude が同時に複数の独立したタスク（バグの修正、プルリクエストのレビュー、ログの調査など）に取り組むことができる場合に使用します。問題を一緒に解決したい場合は、セッションにアタッチして、通常どおり Claude Code をインタラクティブに使用します。エージェントビューのセッションは独立して実行され、あなたにのみレポートします。subagents、agent teams、worktrees との比較については、エージェントを並列で実行するを参照してください。

このページでは以下をカバーしています。

• クイックスタート
• エージェントビューでセッションを監視する。状態アイコン、ピーク表示と返信、アタッチ、整理、キーボードショートカットを含みます
• 新しいエージェントをディスパッチする。エージェントビューから、セッション内から、またはシェルから
• シェルからセッションを管理する
• バックグラウンドセッションがどのようにホストされるか。スーパーバイザープロセスによって

クイックスタート

このチュートリアルでは、エージェントビューを開き、セッションをディスパッチし、ピークパネルから返信し、フル会話にアタッチします。

claude agents

既存のインタラクティブセッションをエージェントビューに持ち込むには、セッション内で /bg を実行するか、空のプロンプトで ← を押してセッションをバックグラウンドにし、1 ステップでエージェントビューを開きます。セッションはバックグラウンドで実行し続け、行として表示されます。シェルから直接新しいバックグラウンドセッションを開始するには、claude --bg "<prompt>" を実行します。

claude agents を claude の代わりにプライマリエントリーポイントとして使用できます。エージェントビューからすべてのタスクをディスパッチし、フル会話が必要な場合はアタッチし、← を押してテーブルに戻ります。

エージェントビューでセッションを監視する

claude agents を実行してエージェントビューを開きます。ターミナル全体を占有し、状態でグループ化されたすべてのセッションをリストします。ピン留めされたセッションと入力が必要なセッションが上部に表示されます。各行はセッションの名前、現在のアクティビティ、最後に変更されてからの経過時間を表示します。

リストは config ディレクトリ の下にあるすべてのバックグラウンドセッションを含み、どのプロジェクトまたはワークツリーで作業しているかに関係なく、マシン全体をカバーします。1 つのリポジトリで開始されたセッションと別のワークツリーで開始された別のセッションの両方が一緒に表示されます。他のターミナルで開いているインタラクティブセッションは、バックグラウンドにするまでは表示されず、セッション内で実行している subagents は個別の行としてリストされません。

Pinned
  ✽ clawd walk cycle          Write assets/sprites/clawd-walk.png           3m

Ready for review
  ∙ jump physics              github.com/anthropics/example/pull/2048    ●  2h

Needs input
  ✻ power-up design           needs input: double jump or wall climb?       1m

Working
  ✽ collision detection       Edit src/physics/CollisionSystem.ts           2m
  ✢ playtest level 3          run 12 · all checkpoints cleared           in 4m

Completed
  ✻ title screen              result: menu, options, and credits done       9m
  ∙ sound effects             result: 14 SFX exported to assets/audio       4h
  … 6 more

各行のアイコンは 2 つのシグナルを伝えます。インジケーターはセッションの状態を示し、アイコンの形状は基盤となるプロセスがまだ実行しているかどうかを示します。状態は以下の通りです。

アイコンの形状は、基盤となるプロセスがまだ実行しているかどうかを示します。✻ または Claude が作業中のアニメーション ✽ は、セッションが生きており、すぐに返信できることを意味します。∙ はプロセスが終了したことを意味しますが、ピーク表示、返信、またはアタッチはできます。Claude はセッションを中断したところから再開します。✢ は /loop セッションで、イテレーション間でスリープしており、行は実行回数とカウントダウンを表示します。

バックグラウンドセッションは作業を続けるためにターミナルを開く必要がありません。別の スーパーバイザープロセス がセッションを実行するため、エージェントビューを閉じたり、シェルを閉じたり、新しいインタラクティブセッションを開始したりしても、ディスパッチされた作業は続きます。

セッションはディスク上に永続化されます。ターミナルを閉じたり、自動更新が行われたりしても失われず、claude agents を再度開くとすべてが表示されます。マシンがスリープまたはシャットダウンした場合、実行中のセッションは停止します。claude respawn --all で再開します。

各行の 1 行の概要は、設定された Haiku クラスモデル によって生成されるため、行はセッションが何をしているか、何が必要か、または何を生成したかをトランスクリプトを開かずに伝えることができます。セッションがアクティブに作業している間、概要は最大 15 秒ごとに 1 回、および各ターンが終了したときに 1 回更新されます。各更新は通常のプロバイダーを通じた 1 つの短い Haiku クラスリクエストであり、セッション自体と同じ データ使用条件 の下で請求および処理されます。

セッションがプルリクエストを開くと、ステータスドットが行の右端に表示され、ハイパーリンクをサポートするターミナルではプルリクエストにリンクされます。セッションが複数のプルリクエストを開いた場合、カウントはドットの前に表示され、色はどれが最も注意が必要かを反映します。

ほとんどのタスクでは、この行が結果を収集する方法です。ドットが緑になったときにプルリクエストをレビューしてマージします。

ピーク表示と返信

選択した行で Space を押してピークパネルを開きます。セッションが何を必要としているか、最新の出力、および開いたプルリクエストが表示されます。ほとんどの場合、これで十分であり、フルトランスクリプトを開く必要はありません。

ピークパネルに返信を入力して Enter を押すと、そのセッションに送信されます。セッションが複数選択肢の質問をしている場合、ピークパネルはオプションを表示し、数字キーを押して 1 つを選択できます。他のブロックされたセッションの場合は、Tab を押して入力に提案された返信を入力し、送信前に編集できます。返信の前に ! を付けて Bash コマンドを代わりに送信します。

↑ と ↓ を使用してパネルを閉じずに隣接するセッションをピーク表示するか、→ を使用してアタッチします。

セッションにアタッチする

選択した行で Enter または → を押してアタッチするか、Alt+1 から Alt+9 を押してフォーカスされたグループの N 番目のセッションに直接アタッチします。エージェントビューはフルインタラクティブセッションに置き換えられ、そのディレクトリで claude を実行した場合と同じです。アタッチすると、Claude は不在中に何が起こったかの短い要約を投稿します。

アタッチ中、セッションは他の Claude Code セッションのように動作します。すべての コマンド、キーボードショートカット、および機能が機能します。

空のプロンプトで ← を押してデタッチし、エージェントビューに戻ります。ダイアログがフォーカスを持っており、← に応答していない場合は、Ctrl+Z を押して直ちにデタッチします。

デタッチはバックグラウンドセッションを停止しません。←、Ctrl+C、Ctrl+D、Ctrl+Z、および /exit はすべてセッションを実行し続けます。セッション内からセッションを終了するには、/stop を実行します。

エージェントビューを使用してセッションをディスパッチまたはバックグラウンドにした後、空のプロンプトで ← を押すと、アタッチしたセッションだけでなく、任意の Claude Code セッションから機能します。現在のセッションをバックグラウンドにし、そのセッションが事前に選択された状態でエージェントビューを開くため、ターミナルを離れずにセッションを切り替えることができます。このショートカットは /config でオフにできます。

リストを整理する

エージェントビューはセッションを状態でグループ化し、入力が必要なセッションが作業中または完了したセッションの上に表示されます。Ctrl+S を押してディレクトリでグループ化に切り替えます。選択内容は実行全体で保存されます。グループ内で、Ctrl+T でセッションをトップにピン留めし、Shift+↑ と Shift+↓ で並べ替えるか、グループヘッダーで Enter を押して折りたたみます。セッションを削除するには、Ctrl+X を押して停止し、2 秒以内に Ctrl+X を再度押して削除します。グループヘッダーで Ctrl+X を押すと、確認後、そのグループ内のすべてのセッションが削除されます。

古い完了したセッションは「… N more」行に折りたたまれ、リストを短く保ちます。失敗とオープンなプルリクエストを持つセッションは常に表示されます。

リストをフィルタリングする

ディスパッチ入力に入力してディスパッチの代わりにフィルタリングします。

キーボードショートカット

エージェントビューで ? を押してすべてのショートカットを表示します。最も一般的なもの。

新しいエージェントをディスパッチする

エージェントビューから新しいバックグラウンドセッションをディスパッチするか、既存のインタラクティブセッションをバックグラウンドに送信するか、シェルから直接開始できます。

エージェントビューから

エージェントビューの下部の入力にプロンプトを入力して Enter を押すと、新しいバックグラウンドセッションが開始されます。セッションはプロンプトから自動的に名前が付けられます。後で Ctrl+R で名前を変更できます。プロンプトに画像を貼り付けて、タスクにスクリーンショットまたは図を含めます。

プロンプトの一部をプレフィックスまたは言及してセッションの開始方法を制御します。

/ を入力して skill をディスパッチします。繰り返しタスクを skill としてパッケージ化すると、プロンプトを再入力せずにエージェントビューから同じワークフローを何度も開始できます。空の入力で Tab を押してすべてのディスパッチ可能な subagent を参照するか、提案が表示されているときにハイライトされた提案を適用します。

同じ @name が subagent と兄弟リポジトリの両方と一致する場合、subagent が優先されます。@ なしの最初の単語形式も任意の subagent 名に適用されるため、subagent 名の 1 つと一致する単語で始まるプロンプトはその subagent をディスパッチします。明示的にしたい場合は @ 形式を使用します。

特定のディレクトリにディスパッチする

新しいセッションはエージェントビューを開いたディレクトリで実行されます。別のディレクトリをターゲットにするには：

• そのディレクトリで claude agents を開きます。
• 複数のリポジトリを保持する親ディレクトリで claude agents を開き、プロンプトで @<repo> を使用して 1 つを言及してセッションをそこで実行します。
• シェルから、ディレクトリに cd して claude --bg "<prompt>" を実行します。

エージェントビューがディレクトリでグループ化されている場合、ハイライトされた行のディレクトリがディスパッチターゲットになるため、グループにスクロールしてパスを再入力せずにそこにディスパッチできます。

セッション内から

/background またはそのエイリアス /bg を実行して現在の会話をデタッチし、実行し続けます。/bg run the test suite and fix any failures などのプロンプトを渡してデタッチする前に 1 つの追加命令を送信します。

シェルから

--bg を渡してセッションを直接バックグラウンドに送信します。

claude --bg "investigate the flaky SettingsChangeDetector test"

特定の subagent をセッションのメインエージェントとして実行するには、--bg を --agent と組み合わせます。

claude --agent code-reviewer --bg "address review comments on PR 1234"

バックグラウンド化の後、Claude はセッションの短い ID とセッションを管理するためのコマンドを出力します。

backgrounded · 7c5dcf5d
  claude agents             list sessions
  claude attach 7c5dcf5d    open in this terminal
  claude logs 7c5dcf5d      show recent output
  claude stop 7c5dcf5d      stop this session

ファイル編集の分離方法

エージェントビュー、/bg、または claude --bg から開始されたすべてのバックグラウンドセッションは、作業ディレクトリで開始されますが、そこにファイルを書き込むことがブロックされています。セッションがファイルを編集する必要がある場合、Claude は自動的にセッションを .claude/worktrees/ の下の分離された git worktree に移動するため、並列セッションは同じチェックアウトを読み取ることができますが、それぞれが独自のものに書き込みます。セッションが既にワークツリー内にある場合、作業ディレクトリが git リポジトリでない場合、または作業ディレクトリの外への書き込みの場合、ブロックは適用されません。

セッションを削除するとワークツリーが削除されるため、削除する前に保持したい変更をマージまたはプッシュします。セッションのワークツリーパスを見つけるには、セッションをピークするか、アタッチして作業ディレクトリを確認します。

subagent が開始方法に関係なく常に独自のワークツリーで実行されるようにするには、frontmatter で isolation: worktree を設定します。

パーミッションモードと設定

ディスパッチされたセッションは、そこで claude を開始した場合と同じように、実行されるディレクトリから settings と permission mode を読み取ります。エージェントビュー入力からディスパッチしてもパーミッションモードは渡されないため、セッションはそのディレクトリの設定から defaultMode を使用するか、ディスパッチされた subagent の frontmatter から permissionMode を使用します。

シェルからモードを設定するには、claude --bg で --permission-mode を渡します。bypassPermissions または auto をこの方法で使用することは、それらのモードが監視していないセッションが承認なしで動作することを許可するため、それらのモードを対話的に実行して claude で受け入れるまで拒否されます。

シェルからセッションを管理する

すべてのバックグラウンドセッションには、シェルから使用できる短い ID があります。これらのコマンドはスクリプティングまたはエージェントビューを開きたくない場合に便利です。

バックグラウンドセッションがどのようにホストされるか

バックグラウンドセッションはユーザーごとのスーパーバイザープロセスによってホストされ、ターミナルおよびエージェントビューとは別です。バックグラウンドセッションを初めてバックグラウンド化するか、エージェントビューを開くときに自動的に開始され、直接管理することはありません。スーパーバイザーとそのセッションはインタラクティブセッションと同じ認証情報で認証され、モデル API を超えて追加のネットワーク接続を行いません。

各バックグラウンドセッションは独自の Claude Code プロセスであり、ターミナルではなくスーパーバイザーの親です。アクティブに作業しているセッション、入力を待機しているセッション、またはターミナルが接続されているセッションはプロセスを実行し続けます。セッションが完了し、約 1 時間アタッチされていない状態で待機すると、スーパーバイザーはリソースを解放するためにプロセスを停止します。トランスクリプトと状態はディスク上に残り、次回アタッチ、ピーク表示、または返信するときに、スーパーバイザーは中断したところから新しいプロセスを開始します。すべてのセッションが完了し、ターミナルが接続されていない場合、スーパーバイザー自体が終了し、次回バックグラウンドセッションをバックグラウンド化するか、エージェントビューを開くときに再度開始します。

スーパーバイザーはディスク上にインストールされた Claude Code バイナリを監視し、通常の 自動更新プログラム がそれを置き換えた後、新しいバージョンに再開します。これはネットワークチェックではなく、ローカルファイルウォッチです。バックグラウンドセッションはデタッチされたプロセスであるため、再開を通じて実行し続け、新しいスーパーバイザーはそれらに再接続します。

セッション状態は Claude Code 設定ディレクトリの下に保存されます。CLAUDE_CONFIG_DIR を設定した場合、スーパーバイザーは ~/.claude の代わりにそのディレクトリを使用し、独自のセッションを持つ別のインスタンスとして実行されます。

バックグラウンドエージェントとエージェントビューを完全にオフにするには、disableAgentView 設定 を true に設定するか、CLAUDE_CODE_DISABLE_AGENT_VIEW 環境変数を設定します。管理者は マネージド設定 を通じてこれを強制できます。

トラブルシューティング

エージェントビューがセッションなしで開く

エージェントビューは最初のセッションをディスパッチするまで空です。下部の入力にプロンプトを入力して Enter を押します。

マシンをウェイクアップした後、セッションが停止として表示される

バックグラウンドセッションはスリープまたはシャットダウンを生き残りません。停止したセッションにアタッチ、ピーク表示、または返信すると、中断したところから再開します。すべてを一度に再開するには、claude respawn --all を実行します。

セッションがアタッチ後に応答が遅い

セッションが完了し、約 1 時間アタッチされていない状態で待機すると、スーパーバイザーはリソースを解放するためにプロセスを停止します。アタッチすると、中断したところから新しいプロセスが開始され、少し時間がかかります。作業中または入力を待機しているセッションはこの方法で停止されることはありません。

.claude/worktrees/ が満杯になっている

ワークツリーはセッションを削除するときに削除されます。セッションがクリーンアップなしで終了した場合は、プロジェクトディレクトリで git worktree list で残りのエントリをリストし、各エントリを git worktree remove <path> で削除します。ワークツリーをクリーンアップする を参照してください。

制限事項

Agent view はリサーチプレビューです。注意すべき現在の制限事項は以下の通りです。

• レート制限が適用される：バックグラウンドセッションはインタラクティブセッションと同じようにサブスクリプション使用量を消費するため、10 個のエージェントを並行して実行するとクォータが 10 倍速く消費されます。
• セッションはローカル：バックグラウンドセッションはマシンで実行され、スリープまたはシャットダウンすると停止します。
• Worktrees はセッションで削除される：セッションが独自の Worktrees でファイルを編集した場合、削除する前に変更をマージまたはプッシュします。

次のステップ

エージェントビューを理解したので、これらの関連機能を探索してください。

• エージェントを並列実行。エージェントビューとサブエージェント、エージェントチーム、ワークツリーを比較
• Subagents。カスタムプロンプト、ツール、分離を使用して再利用可能なエージェント設定を定義
• Agent teams。互いにメッセージを送信する複数のセッションを調整
• Claude Code on the web。ローカルではなく、マネージドクラウド環境でセッションを実行