ターミナルに管制塔が生まれた — Claude Codeエージェントビュー完全ガイド

claude agents.

このコマンド一つで開くエージェントビューは、すべてのバックグラウンドClaude Codeセッションを一画面に表示する。

何が実行中で、何が入力待ちで、何が完了したか — 複数のターミナルを行き来しなくていい。

エージェントビューとは何か

一言で: 複数のClaude Codeエージェントを同時にディスパッチして管理するCLI管制塔だ。

Claude Code v2.1.139以上で動作するリサーチプレビュー機能だ。

# バージョン確認
claude --version

# エージェントビュー起動
claude agents

バグ修正、PRレビュー、ログ分析のように独立した作業が複数ある時に使う。一緒に解決しなければならない問題であれば、通常のセッションに接続して対話式で使えばいい。

画面に表示されるもの

エージェントビューを開くと、状態別にグループ化されたセッション一覧が見える。

入力が必要
  ✻ power-up design    needs input: double jump or wall climb?    1m

作業中
  ✽ collision detection    Edit src/physics/CollisionSystem.ts    2m

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

各行のアイコンが二つのことを教えてくれる。

インジケーターの色 = セッション状態:

インジケーター	状態	意味
アニメーション	作業中	Claudeがツールを実行または応答生成中
黄色	入力が必要	権限決定または回答待ち
薄い	アイドル	ブロックされずに入力待ち
緑	完了	タスク成功
赤	失敗	エラーで終了
灰色	停止	`Ctrl+X`または`claude stop`で停止

アイコンの形 = プロセス状態:

✻ / アニメーション ✽ → セッション活性、即座に回答可能
∙ → プロセス終了済み、接続すると途中から再開
✢ → /loopセッションが繰り返しの間に休眠中

ピーク（覗き見）と素早い返答

Spaceを押すとピークパネルが開く。

セッションが何をしていて、何が必要かがすぐ分かる。ここで回答を入力してEnterを押すとセッションに送信される — セッションに直接入らなくていい。

Slackで返信するようにエージェントを管理する感覚だ。

選択肢がある質問は数字キーで選択、Tabで提案された回答を補完できる。回答の前に!をつけるとBashコマンドとして送信する。

セッション接続と切り離し

行でEnterまたは→を押すと該当セッションに接続される。エージェントビューが消えて通常のclaudeセッションのようにターミナルを完全に占有する。

空のプロンプトで←を押すと再びエージェントビューに戻る。

切り離してもセッションは継続して実行される。←、Ctrl+C、Ctrl+D、/exitはすべてセッションを生かしたまま切り離す。セッションを終了するには/stopを使う。

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

エージェントビュー下部の入力でプロンプトを入力してEnter。

# シェルから直接バックグラウンドセッション開始
claude --bg "investigate the flaky SettingsChangeDetector test"

# 特定のサブエージェントで実行
claude --agent code-reviewer --bg "address review comments on PR 1234"

既存の対話式セッションをバックグラウンドに送るにはセッション内で/bgを実行する。

ディスパッチ入力で使えるプレフィックス:

入力	効果
`<agent-name> <prompt>`	カスタムサブエージェントで実行
`@<repo>`	特定リポジトリでセッション実行
`/<skill>`	スキルをプロンプトとしてディスパッチ
`#<番号>`またはPR URL	そのPRで作業するセッションを選択
`Shift+Enter`	ディスパッチしてすぐに接続

ファイル編集の分離

バックグラウンドセッションがファイルを編集する際、Claudeは自動的に.claude/worktrees/以下の分離されたgit worktreeに移動する。

並行セッションたちが同じチェックアウトを読み込めるが、それぞれ自分のworktreeに書き込む。

セッションを削除するとworktreeも一緒に削除される。削除前に変更をマージかプッシュする必要がある。

キーボードショートカット全整理

ショートカット	操作
`↑` / `↓`	行間移動
`Enter`	セッション接続またはディスパッチ
`Space`	ピークパネル開閉
`Shift+Enter`	ディスパッチ後すぐに接続
`→`	セッション接続
`←`	セッション切り離し（空プロンプトで）
`Alt+1`..`Alt+9`	N番目のセッションに直接接続
`Tab`	サブエージェント検索または提案適用
`Ctrl+S`	状態/ディレクトリ別グループ化切替
`Ctrl+T`	セッション固定/解除
`Ctrl+R`	セッション名変更
`Ctrl+G`	`$EDITOR`でプロンプト編集
`Ctrl+X`	セッション停止（2秒以内に再入力で削除）
`Esc`	ピーク閉じ、入力クリア、終了
`?`	全ショートカット一覧

シェルからのセッション管理

claude attach <id>     # セッション接続
claude logs <id>       # 最近の出力確認
claude stop <id>       # セッション停止
claude respawn <id>    # 停止したセッション再開
claude respawn --all   # すべての停止セッションを再開
claude rm <id>         # リストからセッション削除

スリープ/シャットダウン後にセッションが止まったとき、claude respawn --allで一度に復活させる。

知っておくと良いこと

トークン使用量はセッション数に比例する。 バックグラウンドセッションはそれぞれ独立したセッションなので、10個を並行で動かすと割り当てを10倍速で消費する。

セッションはローカルだ。 マシンがスリープ状態になると実行中のセッションが停止する。起動後claude respawn --allで再開する。

プロセスが終了してもトランスクリプトは維持される。 完了後約1時間が経つとスーパーバイザープロセスがリソースを確保するためプロセスを停止するが、次に接続すると中断した位置から再開する。

複数のターミナルを行き来していた作業方法が変わる。

エージェントビューはまだリサーチプレビューなのでインターフェースが変わる可能性があるが、方向性は明確だ — AIが一つずつ順番に作業するのではなく、同時に複数の作業を処理する時代。