1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

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

6 

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

8 

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

10 

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

12 

13<Note>

14 エージェントビューはリサーチプレビューであり、Claude Code v2.1.139 以降が必要です。`claude --version` でバージョンを確認してください。インターフェースとキーボードショートカットは機能の進化に伴って変更される可能性があり、管理者は [`disableAgentView`](#how-background-sessions-are-hosted) マネージド設定を使用して組織のエージェントビューを無効にできます。

15</Note>

16 

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

18 

19* [クイックスタート](#quick-start)

20* [エージェントビューでセッションを監視する](#monitor-sessions-with-agent-view)。状態アイコン、ピーク表示と返信、アタッチ、整理、キーボードショートカットを含みます

21* [新しいエージェントをディスパッチする](#dispatch-new-agents)。エージェントビューから、セッション内から、またはシェルから

22* [シェルからセッションを管理する](#manage-sessions-from-the-shell)

23* [バックグラウンドセッションがどのようにホストされるか](#how-background-sessions-are-hosted)。スーパーバイザープロセスによって

24 

25## クイックスタート

26 

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

28 

29<Steps>

30 <Step title="エージェントビューを開く">

31 シェルから以下を実行します。

32 

33 ```bash theme={null}

34 claude agents

35 ```

36 

37 エージェントビューが開き、下部に入力フィールドが表示され、セッションが開始されるとテーブルが埋まります。いつでも `Esc` を押して終了できます。セッションは実行し続けます。

38 </Step>

39 

40 <Step title="セッションをディスパッチする">

41 入力にプロンプトを入力して `Enter` を押します。新しいセッションが開始され、セッションが作業中か、入力を待機中か、完了しているかを示す行として表示されます。必要なだけ何度も繰り返して、複数のセッションを並行して実行できます。

42 </Step>

43 

44 <Step title="ピーク表示と返信">

45 矢印キーで行を選択し、`Space` を押してセッションが何をしているか、または何が必要かを確認します。返信を入力して `Enter` を押すと、エージェントビューを離れずに送信できます。

46 </Step>

47 

48 <Step title="アタッチとデタッチ">

49 フル会話が必要な場合は、行で `Enter` または `→` を押してアタッチします。セッションは `claude` を実行した場合と同じようにターミナルを引き継ぎます。空のプロンプトで `←` を押してデタッチし、テーブルに戻ります。

50 </Step>

51</Steps>

52 

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

54 

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

56 

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

58 

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

60 

61リストはマシンに対してグローバルであり、どのプロジェクトまたはワークツリーで作業しているかに関係なく、すべてのバックグラウンドセッションを含みます。他のターミナルで開いているインタラクティブセッションは、[バックグラウンドにする](#from-inside-a-session)までは表示されず、セッション内で実行している [subagents](/ja/sub-agents) は個別の行としてリストされません。

62 

63```text theme={null}

64Pinned

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

66 

67Ready for review

68 ∙ jump physics github.com/anthropics/example/pull/2048 2h

69 

70Needs input

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

72 

73Working

74 ✽ collision detection Edit src/physics/CollisionSystem.ts 2m

75 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m

76 

77Completed

78 ✻ title screen result: menu, options, and credits done 9m

79 ∙ sound effects result: 14 SFX exported to assets/audio 4h

80 … 6 more

81```

82 

83アイコンはセッションの状態を示します。

84 

85| アイコン | 状態 | 意味 |

86| :------ | :---- | :----------------------------------------- |

87| アニメーション | 作業中 | Claude がアクティブにツールを実行しているか、応答を生成しています |

88| 黄色 | 入力が必要 | Claude は入力を待機しており、通常は許可決定または回答です |

89| 薄い | アイドル | セッションは入力を待機していますが、特定の質問でブロックされていません |

90| 緑 | 完了 | タスクが正常に完了しました |

91| 赤 | 失敗 | タスクがエラーで終了しました |

92| グレー | 停止 | セッションは `Ctrl+X` または `claude stop` で停止されました |

93 

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

95 

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

97 

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

99 

100各行の 1 行の概要は、設定された [Haiku クラスモデル](/ja/model-config) によって生成されるため、行はセッションが何をしているか、何が必要か、または何を生成したかをトランスクリプトを開かずに伝えることができます。各概要は通常のプロバイダーを通じた 1 つの短い Haiku クラスリクエストであり、セッション自体と同じ [データ使用条件](/ja/data-usage) の下で請求および処理されます。

101 

102セッションがプルリクエストを開くと、行は PR リンクと CI チェックのステータスインジケーターを表示します。ほとんどのタスクでは、この行が作業を収集する方法です。チェックが成功したときにプルリクエストをレビューしてマージします。

103 

104### ピーク表示と返信

105 

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

107 

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

109 

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

111 

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

113 

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

115 

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

117 

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

119 

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

121 

122エージェントビューを使用した後、空のプロンプトで `←` を押すと、アタッチしたセッションだけでなく、任意の Claude Code セッションから機能します。現在のセッションが事前に選択された状態でエージェントビューを開くため、ターミナルを離れずにセッションを切り替えることができます。

123 

124### リストを整理する

125 

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

127 

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

129 

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

131 

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

133 

134| フィルター | 表示 |

135| :--------------------- | :----------------------------------------- |

136| `a:<name>` | 名前付きエージェントを実行しているセッション |

137| `s:<state>` | 指定された状態のセッション。例えば `s:blocked` は入力が必要なセッション |

138| `#<number>` または PR URL | そのプルリクエストで作業しているセッション |

139 

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

141 

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

143 

144| ショートカット | アクション |

145| :-------------------- | :------------------------------------ |

146| `↑` / `↓` | 行間を移動 |

147| `Enter` | 選択したセッションにアタッチするか、入力にテキストがある場合はディスパッチ |

148| `Space` | 選択したセッションのピークパネルを開くまたは閉じる |

149| `Shift+Enter` | ディスパッチして直ちにアタッチ |

150| `→` | 選択したセッションにアタッチ |

151| `Alt+1`..`Alt+9` | フォーカスされたグループの N 番目のセッションにアタッチ |

152| `Tab` | すべての subagents を参照するか、ハイライトされた提案を適用 |

153| `Ctrl+S` | グループ化を状態とディレクトリの間で切り替え |

154| `Ctrl+T` | 選択したセッションをピン留めまたはピン留め解除 |

155| `Ctrl+R` | 選択したセッションの名前を変更 |

156| `Ctrl+G` | `$EDITOR` でディスパッチプロンプトを開く |

157| `Ctrl+X` | セッションを停止。2 秒以内に再度押して削除 |

158| `Shift+↑` / `Shift+↓` | 選択したセッションを並べ替え |

159| `Esc` | ピークパネルを閉じるか、入力をクリアするか、終了 |

160| `Ctrl+C` | 入力をクリア。2 回押して終了 |

161| `?` | すべてのショートカットを表示 |

162 

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

164 

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

166 

167### エージェントビューから

168 

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

170 

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

172 

173| 入力 | 効果 |

174| :---------------------- | :------------------------------------------------------------------------------------------------------- |

175| `<agent-name> <prompt>` | 最初の単語がカスタム [subagent](/ja/sub-agents) 名と一致する場合、その subagent はセッションのメインエージェントとして実行され、frontmatter の設定を使用します |

176| `@<agent-name>` | プロンプト内の任意の場所でカスタム subagent を言及してメインエージェントとして実行 |

177| `@<repo>` | エージェントビューを開いたディレクトリの下のリポジトリを言及してセッションをそこで実行 |

178| `/<skill>` | [skills](/ja/skills) をディスパッチプロンプトとして提案 |

179| `#<number>` または PR URL | セッションが既にその PR で作業している場合は、ディスパッチの代わりに選択 |

180| `Shift+Enter` | ディスパッチして新しいセッションに直ちにアタッチ |

181 

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

183 

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

185 

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

187 

188* そのディレクトリで `claude agents` を開きます。

189* 複数のリポジトリを保持する親ディレクトリで `claude agents` を開き、プロンプトで `@<repo>` を使用して 1 つを言及してセッションをそこで実行します。

190* シェルから、ディレクトリに `cd` して `claude --bg "<prompt>"` を実行します。

191 

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

193 

194#### ワークツリーでファイル編集を分離する

195 

196エージェントビューからディスパッチされたセッションはデフォルトで作業ディレクトリを共有するため、同じファイルを編集する 2 つのエージェントが競合する可能性があります。これを防ぐため、Claude Code はエージェントビューからディスパッチされたセッションが分離された [git worktree](/ja/worktrees) に移動するまでファイルを書き込むことをブロックします。Claude はファイルを編集する必要があるときにこれを自動的に処理します。ワークツリーはプロジェクトディレクトリ内の `.claude/worktrees/` の下に作成され、セッションを削除するときに削除されます。セッションを削除すると、そのワークツリーも削除されるため、削除する前に保持したい変更をマージまたはプッシュします。

197 

198subagent が開始方法に関係なく常に独自のワークツリーで実行されるようにするには、frontmatter で [`isolation: worktree`](/ja/sub-agents#supported-frontmatter-fields) を設定します。

199 

200### セッション内から

201 

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

203 

204### シェルから

205 

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

207 

208```bash theme={null}

209claude --bg "investigate the flaky SettingsChangeDetector test"

210```

211 

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

213 

214```bash theme={null}

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

216```

217 

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

219 

220```text theme={null}

221backgrounded · 7c5dcf5d

222 claude agents list sessions

223 claude attach 7c5dcf5d open in this terminal

224 claude logs 7c5dcf5d show recent output

225 claude stop 7c5dcf5d stop this session

226```

227 

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

229 

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

231 

232| コマンド | 目的 |

233| :--------------------- | :----------------------------- |

234| `claude agents` | エージェントビューを開く |

235| `claude attach <id>` | このターミナルでセッションにアタッチ |

236| `claude logs <id>` | セッションの最新出力を出力 |

237| `claude stop <id>` | セッションを停止。`claude kill` も受け入れます |

238| `claude respawn <id>` | 会話を保持したまま停止したセッションを再開 |

239| `claude respawn --all` | すべての停止したセッションを再開 |

240| `claude rm <id>` | リストからセッションを削除 |

241 

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

243 

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

245 

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

247 

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

249 

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

251 

252| パス | 内容 |

253| :------------------------------- | :----------------------------------- |

254| `~/.claude/daemon.log` | スーパーバイザーログ |

255| `~/.claude/daemon/roster.json` | 実行中のバックグラウンドセッションのリスト。再開後に再接続するために使用 |

256| `~/.claude/jobs/<id>/state.json` | エージェントビューに表示されるセッションごとの状態 |

257 

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

259 

260## トラブルシューティング

261 

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

263 

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

265 

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

267 

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

269 

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

271 

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

273 

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

275 

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

277 

278## 制限事項

279 

280エージェントビューはリサーチプレビューです。注意すべき現在の制限事項。

281 

282* **レート制限が適用される**。バックグラウンドセッションはインタラクティブセッションと同じようにサブスクリプション使用量を消費するため、10 個のエージェントを並行して実行するとクォータが 10 倍速く消費されます。

283* **セッションはローカル**。バックグラウンドセッションはマシンで実行され、スリープまたはシャットダウンすると停止します。

284* **ワークツリーはセッションで削除される**。セッションが独自のワークツリーでファイルを編集した場合、削除する前に変更をマージまたはプッシュします。

285 

286## 次のステップ

287 

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

289 

290* [エージェントを並列実行](/ja/agents)。エージェントビューとサブエージェント、エージェントチーム、ワークツリーを比較

291* [Subagents](/ja/sub-agents)。カスタムプロンプト、ツール、分離を使用して再利用可能なエージェント設定を定義

292* [Agent teams](/ja/agent-teams)。互いにメッセージを送信する複数のセッションを調整

293* [Claude Code on the web](/ja/claude-code-on-the-web)。ローカルではなく、マネージドクラウド環境でセッションを実行