claude agents で全セッションを1画面に — Agent view 実践ガイド

背景で走らせたセッションが増えてくると、どれが動いていてどれが自分の返事を待っているのか分からなくなる。Claude Code の agent view はその全部を 1 画面にまとめる。起動方法、行の読み方、覗いてその場で返事する手順、worktree の隔離挙動までを実務目線で整理する。

起動と投入

claude agents

これで全画面のインターフェースが開く。下部の入力欄にプロンプトを打って Enter を押せば、そのままセッションが立ち上がる。

シェルから直接投げることもできる。

claude --bg "investigate the flaky checkout test"
claude --bg --name "flaky-test-fix" "prompt here"

すでに開いている会話を背景に送るなら、そのセッションの中で `/bg` を使う。`/fork` なら元の会話を開いたまま、複製を背景セッションとして走らせられる。

行の読み方

各行は「アイコン｜セッション名｜状況または質問｜経過時間」で構成される。

| 状態 | アイコン | 意味 | |---|---|---| | 作業中 | アニメーションする `✽` | ツール実行や生成が進行中 | | 入力待ち | 黄色の `✻` | 返事・許可・入力を待っている | | アイドル | 淡色の `✻` | 次のプロンプトを受けられる | | 完了 | 緑の `✻` | 正常に終わった | | 失敗 | 赤の `✻` | エラーで終わった | | 停止 | 灰色の `✻` | 停止させた |

アイコンの形も情報を持つ。`✻` はプロセスが生きていてすぐ応答する状態、`∙` はプロセスが終了した状態を表す。`∙` でも覗けるし返信もでき、その場合 Claude は中断したところから再開する。

行の見出しは Haiku が生成する。作業中なら何をしているか、詰まっているなら聞いている質問、終わっているなら結果が一行で出る。**この見出しがあるおかげで、開かずに状況が分かる**。

右端には PR 番号がラベルとして出る。色にも意味があり、黄色はチェックやレビュー待ちか失敗、緑は通過してブロッキングなレビューが無い状態、紫はマージ済み、灰色は下書きかクローズを表す。

覗いて、その場で返す

行を選んで Space を押すと peek パネルが開く。待っているなら質問が、作業中なら状況の全文が、終わっているなら結果が読める。

返事はそのまま入力して Enter でよい。選択肢が提示されている場合は数字キーで選べる。`!` を先頭に付ければ Bash コマンドとして送れる。上下キーで隣のセッションを覗いていけるので、全画面に入らずに複数の詰まりを解消できる。

腰を据えて向き合いたくなったら Enter か `→` でアタッチする。全画面の対話セッションに切り替わり、離れている間に何があったかを Claude が要約して出す。抜けるときは空のプロンプトで `←` を押す。抜けてもセッションは走り続ける。

覚えておくと効くキー

| キー | 動作 | |---|---| | `Space` | 選択中のセッションの peek パネルを開閉する | | `Shift+Enter` | 投入してそのままアタッチする | | `Ctrl+S` | グループ分けを状態別とディレクトリ別で切り替える | | `Ctrl+T` | セッションをピン留めする（アイドルでもプロセスを保つ） | | `Ctrl+R` | セッション名を変える | | `Ctrl+X` | セッションを停止する。2 秒以内にもう一度で削除 | | `?` | 全ショートカットを表示する |

入力欄はフィルタとしても使える。`s:working` で作業中のものだけ、`a:<name>` で特定のサブエージェントを走らせているもの、`#1234` や PR の URL でその PR を扱っているセッションに絞り込める。

worktree に隔離される

ここは挙動として知っておきたい。背景セッションはファイルを編集する前に、`.claude/worktrees/` 配下の独立した git worktree に移動する。並行して走るセッション同士が同じファイルを壊し合わないための仕組みだ。

隔離が省略される条件もある。セッションが既にリンク済みの worktree の中にいる場合、作業ディレクトリが git リポジトリでなく `WorktreeCreate` フックも設定されていない場合、そして書き込み先が作業ディレクトリの外にある場合。

リポジトリ単位で隔離を切ることもできる。

{
  "worktree": {
    "bgIsolation": "none"
  }
}