Agent View入門──複数のClaude Codeセッションを一画面で束ねる

claude agents で開く Agent View は、独立したタスクを渡したバックグラウンドセッションを一つの画面にまとめ、状態を一覧し、必要なときだけ返信・アタッチする機能です。公式ドキュメントは冒頭で「リサーチプレビューであり、インターフェースとキーボードショートカットは機能の進化とともに変わる可能性がある」と明記しています。同じ Claude Code 内の「サブエージェント」（1つの会話の中で側作業を任せる仕組み）とは別物で、Agent View が扱うのは複数の独立した会話そのものです。この記事では公式ドキュメントの記述だけを土台に、仕様と、削除・権限・課金まわりで実務上引っかかる点を整理します。

• claude agents はバックグラウンドセッションの一覧画面。各セッションはターミナルを閉じても動き続ける独立プロセスで、専用のスーパーバイザー（デーモン）がホストする
• リサーチプレビュー機能。バックグラウンドセッションは対話セッションと同じサブスクリプション枠を消費し、公式は「10個のエージェントを並行実行するとクォータが10倍速く消費される」と明記している
• セッションを Agent View から Ctrl+X 二度押しで削除すると、Claude が作成したワークツリーは未コミットの変更ごと削除される。会話トランスクリプト自体は残る

何をする画面なのか

公式ドキュメントの定義はこうです。「Agent View は、claude agents で開く、すべてのバックグラウンドセッションのための一つの画面です。実行中のもの、入力が必要なもの、完了したものが表示されます」。使う場面として挙げられているのは「Claude が毎ステップの監視なしに取り組める独立したタスクが複数ある」ケースで、例としてバグ修正・プルリクエストレビュー・不安定テストの調査を3行として並列ディスパッチし、行が「入力が必要」を示すか結果が出たときだけ確認する、という使い方が示されています。

比較用の公式ページ「エージェントを並列実行する」は、Agent View を含む4つの並列化手段を並べています。サブエージェントは「1つのセッション内で側作業をこなして要約だけ返す」もの、Agent View は「独立したタスクを渡して後で確認する」もの、エージェントチーム（デフォルト無効の実験的機能）は「Claude が計画・割り当て・監督する複数セッション」、動的ワークフローは「1ターンでは調整しきれない規模の作業」向けとされています。**Agent View が扱うセッションはどれも「あなたに対してのみ結果を報告する」**点が、互いに直接メッセージを送り合うエージェントチームとの違いです。

セッションの状態と操作

行の状態は6種類あります。原文の表をそのまま日本語化すると、Working（アニメーション表示、実行中）、Needs input（黄色、あなたにしか答えられない質問または許可の判断を待っている状態）、Idle（薄い表示、次の指示待ち）、Completed（緑）、Failed（赤）、Stopped（グレー、Ctrl+X か claude stop で停止したか外部からプロセスが終了させられた場合)です。アイコンの形状は別軸で、プロセスが生きているか(✻/✽)、プロセスが終了していて再開待ちか(∙)、/loop セッションが次の周回まで眠っているか(✢)を示します。

行のサマリー文はHaiku級モデルが生成します。「行がトランスクリプトを開かなくても、セッションが何をしているか・何を求めているか・何を出力したかを伝えられるように」という理由で、作業中は15秒ごとにセッション自身の直近出力から(モデルへのリクエストなしで)更新され、ターン終了時にモデルが新しいサマリーを書き直します。ドキュメントは念押しで「ターン終了時のサマリーと途中の書き直しは、あなたの通常のプロバイダーを通じた短いHaiku級リクエストであり、セッション自体と同じデータ利用規約の下で課金・処理される」と書いています。つまりサマリー生成自体もモデル呼び出しで、無料の付帯機能ではありません。

主な操作はキーボード中心です。Space でピークパネル(全文を開かず直近の状態・質問だけを見る)、Enter/→ でアタッチ(フル対話に入る)、←(空プロンプト時)で対話セッションをバックグラウンド化して Agent View に戻る、Ctrl+X を2秒以内に2回で停止→削除、Ctrl+T でピン留め(アイドルでもプロセスを維持)、Ctrl+S で状態別/ディレクトリ別のグループ表示切り替え、? で全ショートカット一覧です。

ファイル編集はワークツリーに隔離される

claude agents・/bg・claude --bg のいずれで始めたセッションも、最初は作業ディレクトリで起動し、ファイルを編集する前に .claude/worktrees/ 配下の独立した git ワークツリーへ移動します。並列セッションが同じチェックアウトを読めても、書き込みは各セッション専用のワークツリーに閉じるための仕組みです。この隔離が起きるのはセッションが実際にファイルを書き込もうとした時点で、その後はサブエージェントを含めて隔離が強制されます。

隔離をスキップするのは、セッションが既にリンクされたワークツリー内にいる場合、作業ディレクトリが git リポジトリでなく WorktreeCreate フックも未設定の場合、書き込み先が作業ディレクトリの外にある場合の3パターン。git 以外のバージョン管理を使うなら WorktreeCreate フックを設定すれば同様に隔離されます。リポジトリ単位で隔離自体を無効化したい場合は .claude/settings.json に "worktree": {"bgIsolation": "none"} を書きます。

ワークツリーで作業を終えたセッションは、確認なしにコミットし、リモートがあればブランチをプッシュし、必要ならドラフトプルリクエストを開きます。ただし main/master への直接プッシュ・強制プッシュ・マージはしないと明記されており、タスクや CLAUDE.md、メモリでコミット作業を自分でやると書いてあれば、Claude はそちらを優先して git操作をユーザーに委ねます。

実務で引っかかる点

削除するとワークツリーごと未コミット変更が消える。 Agent View 上で Ctrl+X を2回押してセッションを削除すると、Claude が作成したワークツリーは「未コミットの変更を含めて」削除されます。会話トランスクリプト自体はローカルに残り claude --resume で読めますが、コード変更は残りません。シェルの claude rm を使った場合は未コミット変更があるワークツリーとセッション行の両方を保持する、という違いもあります。Agent View から消す前に、そのセッションの行をピークして「何をコミットしたか」を確認する癖が要ります。 なお、プッシュされていないコミットがあるワークツリーや、別セッションが使用中のワークツリーは、どちらの削除経路でも消されず、理由付きで保持されます。

権限モードは「どうやって開いたか」で決まる。 新しいバックグラウンドセッションがどの権限モードで始まるかは、公式ドキュメントによれば2パターンです。/bg や ← で対話セッションをバックグラウンド化した場合は、そのセッションが持っていた権限モード(acceptEdits や auto に切り替えていればそのモード)をそのまま維持します。Agent View の入力欄から新規ディスパッチした場合、またはシェルから claude --bg を実行した場合は、そのディレクトリの設定の defaultMode、もしくはディスパッチする subagent の frontmatter の permissionMode が使われます。bypassPermissions(いわゆる権限スキップ)を使うには、事前に claude --dangerously-skip-permissions を一度対話的に実行して免責事項に同意している必要があり、同意前に claude --bg --permission-mode bypassPermissions を叩くと拒否されます。

レート制限・使用量は対話セッションと合算される。 「制限事項」の章に「バックグラウンドセッションは対話セッションと同じようにサブスクリプション使用量を消費するため、10個のエージェントを並行実行するとクォータがおよそ10倍速く消費される」と明記されています。並列ディスパッチは便利さと引き換えに枠の消費速度も上がる、という前提を最初に踏まえておく必要があります。

バージョン依存がかなり細かい。 ドキュメント末尾の変更履歴は v2.1.139(リサーチプレビュー導入)から v2.1.208 まで並び、--cwd や --permission-mode 等のフラグ対応、削除・復元・通知まわりの挙動が version ごとに追加・変更されています。claude agents を実行してサブエージェント一覧が表示されて終わる場合は、Agent View 自体が使えないバージョンなので claude update で更新が必要、とトラブルシューティング章に書かれています。手元の挙動が本稿と食い違う場合は、まず claude --version を確認するのが早い、という点はサブエージェントの記事と同じです。

macOS だけ追加の権限プロンプトが要る。 バックグラウンドセッションのホストプロセスは対話ターミナルとは別に保護フォルダへのアクセスを要求するため、~/Desktop・~/Documents・~/Downloads を読むと Operation not permitted になることがあり、システム設定の「プライバシーとセキュリティ」→「ファイルとフォルダ」で許可が必要です。また macOS 15 以降はローカルネットワークへの初回接続時に別途「ローカルネットワーク」権限プロンプトが出ます。どちらも対話セッションでは意識しなくてよかった許可です。

Agent View を止めたい場合の設定がある。 disableAgentView 設定を true にするか CLAUDE_CODE_DISABLE_AGENT_VIEW 環境変数を設定すると、バックグラウンドエージェントと Agent View 自体を丸ごと無効化できます。管理者は managed settings 経由でこれを強制できるとも書かれており、組織でバックグラウンド実行自体を許可したくない場合の制御点になります。

公式ドキュメントに記載を見つけられなかったこと

claude agents --help の実出力は掲載されていません。 確認できたのは CLI リファレンスページの一覧表に載っている claude agents の説明文と対応フラグ(--cwd・--json・--permission-mode・--model・--effort・--agent・--settings・--add-dir・--plugin-dir・--mcp-config など)で、ターミナルで --help を打ったときの生の出力そのものは公式ドキュメント上に見つけられませんでした。アプリ内では ? キーでショートカット一覧が出る、という説明はありますが、これも --help の代替であって同一ではありません。

プラン別(Pro/Max/Team/Enterprise)の利用可否は明記が見当たりませんでした。 消費されるのが「サブスクリプションクォータ」であることは書かれていますが、特定プランでのみ使える・使えないといった制限の記述は見つけられませんでした。

並列実行による速度・コスト削減の定量値は書かれていません。 「便利になる」という定性的な説明はあっても、何割速い・何%安いといった数字はどこにも出てきません。本稿の「実務で引っかかる点」も構造上の挙動の説明であり、効果を保証するものではありません。

Windows 固有の細部は言及があるが検証はしていません。 taskkill によるスーパーバイザー強制終了など Windows 向けの復旧手順が変更履歴とトラブルシューティングに複数出てきますが、本稿執筆時に Windows 環境での動作は確認していません。

サブエージェントとの使い分けの基礎はサブエージェントとは、Claude Code 全体の料金体系や基本機能はClaude Code 使い方・料金・できることにまとめています。

---

出典

• 複数のエージェントをエージェントビューで管理する（Claude Code 公式ドキュメント）: https://code.claude.com/docs/ja/agent-view
• エージェントを並列実行する（Claude Code 公式ドキュメント）: https://code.claude.com/docs/ja/agents
• CLI リファレンス（Claude Code 公式ドキュメント）: https://code.claude.com/docs/ja/cli-reference

但し書き

本記事の仕様・キーボード操作・バージョン注記は、2026年8月27日時点で上記3ページ(日本語版)を取得して確認した内容に基づきます。英語版ドキュメントは日本語版より更新が先行している場合があり、本稿の記述と一致しない可能性があります。Agent View は公式が「リサーチプレビュー」と位置づけている機能であり、インターフェースや挙動は今後変わる可能性があります。実行前に手元のバージョン(claude --version)と公式ドキュメントの現行版で確認してください。速度・コスト削減の効果を保証するものではありません。