claude agents で開くエージェントビューは、Claude Codeで並列タスクを管理するためのダッシュボードです。バックグラウンドで動いているすべてのセッションを1画面で確認し、入力待ちのセッションにはその場で返信でき、終了したセッションの結果をまとめて確認できます。
このガイドでは、タスクのディスパッチ方法、セッション状態の読み方、ワークツリー隔離の仕組み、CLIコマンドの全一覧、そしてサブエージェントとの使い分けについて解説します。
エージェントビューはClaude Code v2.1.139以降で利用可能です。
claude --versionでバージョンを確認してください。
エージェントビューとは何か
エージェントビューはタスクランナーやワークフローエンジンではなく、セッションダッシュボードです。各行は独立したClaude Codeの会話であり、バックグラウンドで動き続けます。タスクをディスパッチし、ターミナルを閉じても処理は継続し、入力が必要なときや終了時に確認します。
バックグラウンドセッションとサブエージェントの違い:
| 項目 | バックグラウンドセッション（エージェントビュー） | サブエージェント |
|---|---|---|
| 起動元 | 手動（ユーザーが操作） | 親セッションがプログラム的に生成 |
| ライフサイクル | 親ターミナルを閉じても継続 | 親セッション終了と同時に終了 |
| 可視性 | エージェントビューのダッシュボード | 親セッションのトランスクリプト内 |
| ファイル隔離 | セッションごとに自動でgitワークツリー作成 | 親のワークツリーを継承 |
| 適した用途 | 独立した並行作業 | 1つのワークフロー内の委任タスク |
作業が本当に独立している場合（あるモジュールのリファクタリングとテスト実行など）はバックグラウンドセッションを使います。1つのセッションが結果を集約・調整する必要がある場合はサブエージェントを使います。
タスクのディスパッチ
claude agentsエージェントビューが開き、下部にディスパッチ入力欄が表示されます。タスクを入力してEnterキーを押すとバックグラウンドセッションが開始します。すぐにセッションにアタッチしたい場合はShift+Enterを使います。
既存のセッション内からバックグラウンドに移行するには、プロンプトが空の状態で←キーを押すか、/bgコマンドを実行します：
/bg テストスイートを全実行して失敗を修正してくださいシェルから直接バックグラウンドセッションを開始する場合：
claude --bg "AuthMiddlewareTestの不安定なテストを調査してください"セッション状態の読み方
各行にはアイコンと状態が表示されます：
| アイコン | 状態 | 意味 |
|---|---|---|
アニメーション ✽ | Working | ツール実行または応答生成中 |
| 黄色 | Needs input | 返信または権限の判断を待機中 |
| 薄暗い | Idle | 待機中。次のプロンプトを受け付け可能 |
| 緑色 | Completed | タスクが正常に完了 |
| 赤色 | Failed | エラーで終了 |
| グレー | Stopped | Ctrl+Xまたはclaude stopで停止済み |
アイコンの形でプロセスの稼働状態がわかります：
| 形状 | 意味 |
|---|---|
✻ またはアニメーション | プロセス稼働中。返信はすぐに届く |
∙ | プロセス終了済み。返信すると保存済み状態から再開 |
✢ | /loopセッションがイテレーション間でスリープ中 |
各行の1行サマリーはHaikuクラスのモデルが15秒ごとに更新します。トランスクリプトを開かずに現在の作業内容を確認できます。
ピーク（プレビュー）と返信
行を選択してSpaceキーを押すとピークパネルが開きます。セッションの直近の出力または待機している質問が表示されます。
ピークパネル内で入力してEnterキーを押すとエージェントビューを離れずに返信できます。選択肢が提示されている場合は数字キーで選択、Tabキーで提案された返信候補を編集欄に入力できます。
キーボードショートカット一覧
エージェントビュー内で?を押すと全ショートカットが表示されます：
| ショートカット | 操作 |
|---|---|
↑ / ↓ | 行間移動 |
Enter | 選択セッションにアタッチ（入力ありの場合はディスパッチ） |
Space | ピークパネルの開閉 |
Shift+Enter | ディスパッチしてすぐにアタッチ |
→ | 選択セッションにアタッチ |
← | セッション内での操作：バックグラウンド化してエージェントビューを開く |
Alt+1〜Alt+9 | 同じディレクトリの1〜9番目のセッションにアタッチ |
Tab | サブエージェントブラウズ（入力空時）または提案適用 |
Ctrl+S | グループ切り替え：状態別 / ディレクトリ別 |
Ctrl+T | セッションをピン留め / 解除 |
Ctrl+R | セッション名を変更 |
Ctrl+G | $VISUAL または $EDITOR でディスパッチ入力を編集 |
Ctrl+X | セッションを停止（2秒以内に再度押すと削除） |
Shift+↑ / Shift+↓ | セッションの順序変更 |
Esc | ピークパネルを閉じる / 入力クリア / 終了 |
? | 全ショートカット表示 |
シェルからのセッション管理コマンド
# エージェントビューを開く
claude agents
claude agents --cwd ~/projects/my-app # 特定ディレクトリのセッションのみ表示（v2.1.141以降）
# バックグラウンドセッションの開始
claude --bg "タスクの説明"
claude --bg --name "my-task" "タスクの説明" # 表示名を指定
claude --bg --agent code-reviewer "PR 1234のレビューコメントに対応してください"
claude --bg --exec 'pytest -x' # Claudeを使わないシェルコマンドジョブ
# セッションの個別管理
claude attach <session-id> # 現在のターミナルで開く
claude logs <session-id> # 直近の出力を表示
claude stop <session-id> # セッションを停止
claude rm <session-id> # リストから削除（未コミット変更があればワークツリーは保持）バックグラウンドセッション開始後、セッションIDと管理コマンドが出力されます：
backgrounded · 7c5dcf5d · flaky-test-fix
claude agents セッション一覧
claude attach 7c5dcf5d このターミナルで開く
claude logs 7c5dcf5d 直近の出力を表示
claude stop 7c5dcf5d セッションを停止ワークツリー隔離：並列ファイル編集が衝突しない仕組み
バックグラウンドセッションがファイルを編集する際、Claude Codeは自動的にセッションを .claude/worktrees/ 以下の独立したgitワークツリーに移行させます。複数のセッションが同じリポジトリを読むことはできますが、書き込みはそれぞれ別のブランチに対して行われます。
これにより、同一リポジトリに対して2つのセッションを並行して実行しても安全です：
claude --bg "authモジュールを新しいJWTライブラリ向けにリファクタリングしてください"
claude --bg "APIクライアントを新しいレスポンススキーマに対応させてください"両セッションともファイルを編集しますが、それぞれ別のワークツリーに書き込むため、お互いの未コミット変更は見えません。
ワークツリー隔離がスキップされるケース：
- セッションがすでにリンクされたgitワークツリー内にある
- ディレクトリがgitリポジトリではない（かつ
WorktreeCreateフックが設定されていない） - 書き込み先がワーキングディレクトリ外
gitワークツリーが使えないプロジェクトで隔離を無効にするには、.claude/settings.json に追加します：
{
"worktree": {
"bgIsolation": "none"
}
}"none" に設定すると、バックグラウンドセッションはワーキングコピーに直接書き込みます。この設定では同じファイルを触る並列セッションは避けてください。
重要: Ctrl+X を2回押してセッションを削除すると、Claudeが作成したワークツリーは削除されます（未コミット変更も含む）。削除前にコミットまたはマージしてください。
セッションの永続性
バックグラウンドセッションはターミナルが開いていなくても継続します。スーパーバイザープロセスが独立して管理しているため、エージェントビューを閉じても、シェルを閉じても、別のセッションを開始してもバックグラウンド処理は継続します。
以下をまたいで状態が保持されます：
- Claude Codeの自動アップデート
- スーパーバイザーの再起動
- マシンのスリープと起動
シャットダウンは実行中のセッションを停止します。シャットダウン後にセッションがFailed状態で表示される場合は、エージェントビューで対象セッションを選択してEnterキーを押すと保存済み状態から再開できます。
セッションは30日間操作がなければ自動的にクリーンアップされます。プルリクエストが開いているセッションは明示的に削除するまで表示され続けます。
セッションリストのフィルタリング
ディスパッチ入力欄に以下を入力するとフィルタリングになります（ディスパッチではなく）：
| フィルター | 表示されるセッション |
|---|---|
a:<エージェント名> | 指定エージェントを使用中のセッション |
s:<状態> | 指定状態のセッション（s:working、s:blocked など） |
#<番号> またはPR URL | 指定プルリクエストを対象としたセッション |
| その他のURL | 最初のプロンプトにそのURLを含むセッション |
実用的なワークフローパターン
機能開発とテスト実行の並列化
# リファクタリングを開始
claude --bg --name "auth-refactor" "src/auth/を新しいJWTライブラリ向けにリファクタリングしてください"
# テストを並行実行（シェルコマンドジョブ）
claude --bg --exec 'npm test -- --watch'
# エージェントビューで両方を確認
claude agentsPRレビューループ
claude --bg "PR 2048をレビューしてサマリーコメントを投稿してください"セッションがプルリクエストを開くと行の右端に PR #N ラベルが表示されます。色が状態を示します（黄色：チェック待ち、緑：マージ可能、紫：マージ済み）。
会話の途中でバックグラウンドに切り替える
長時間かかるタスクだとわかった時点で：
/bg 見つかったリンターエラーをすべて修正し続けてくださいセッションはバックグラウンドに移行して作業を継続します。
よくあるミス
セッションを大量にディスパッチする
バックグラウンドセッションはそれぞれ独立してサブスクリプションの使用量を消費します。10セッション同時実行は通常の10倍の消費になります。大量のセッションを実行する前に公式ドキュメントのLimitationsセクションを確認してください。
バックグラウンドセッション間のデータ共有を期待する
バックグラウンドセッションは独立しています。セッションA の出力をセッションB に渡すにはセッションBにアタッチして手動でペーストする必要があります。
未コミット変更があるセッションを削除する
Ctrl+X を2回押すとセッションとそのワークツリーが削除されます（未コミット変更を含む）。有益なコードが書かれている場合は削除前にコミットまたはマージしてください。
エージェントビューを閉じたらセッションが止まると思う
バックグラウンドセッションはエージェントビューを閉じても継続します。Esc またはターミナルを閉じても何も停止しません。セッションを実際に止めるには claude stop <id> または Ctrl+X を使います。
関連ドキュメント
- 公式: Manage multiple agents with agent view
- 公式: Sub-agents — セッション内のタスク委任
- 公式: Git worktrees — 並列セッションのファイル隔離
- Claude Codeのルール・設定ギャラリー — エージェントビューワークフロー向けのCLAUDE.mdパターン集