Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
claude agents で開くエージェントビューは、すべてのバックグラウンドセッションの 1 つの画面です。実行中のもの、入力が必要なもの、完了したものが表示されます。新しいセッションをディスパッチし、トランスクリプトをスクロールする代わりに一目でセッションの状態を確認し、セッションが必要とするときだけ介入します。各バックグラウンドセッションは完全な Claude Code の会話であり、ターミナルが接続されていなくてもバックグラウンドで実行し続けるため、いつでも開いて、返信して、去ることができます。
エージェントビューはリサーチプレビューであり、Claude Code v2.1.139 以降が必要です。
claude --version でバージョンを確認してください。インターフェースとキーボードショートカットは機能の進化に伴って変更される可能性があります。- クイックスタート：Claude にバックグラウンドで作業するタスクを与え、確認し、必要なときに介入する
- エージェントビューでセッションを監視する。状態アイコン、ピーク表示と返信、アタッチ、整理、キーボードショートカットを含みます
- 新しいエージェントをディスパッチする。エージェントビューから、セッション内から、またはシェルから
- シェルからセッションを管理する
- バックグラウンドセッションがどのようにホストされるか。スーパーバイザープロセスによって
クイックスタート
このチュートリアルでは、コアエージェントビューループについて説明します。タスクをディスパッチし、Claude が作業する際に行が更新されるのを見守り、ピークして確認して返信し、フル会話にアタッチします。ディスパッチしたセッションはエージェントビューを閉じた後も実行し続けるため、離れて後で戻ることができます。エージェントビューを開く
シェルから以下を実行します。エージェントビューが開き、下部に入力フィールドが表示され、セッションが開始されるとテーブルが埋まります。いつでも
Esc を押してシェルに戻ります。セッションは離れている間も実行し続け、次にエージェントビューを開いたときに再度表示されます。セッションをディスパッチする
タスクを説明するプロンプトを入力して
Enter を押します。新しいバックグラウンドセッションがそのタスクで開始され、作業中か、入力を待機中か、完了しているかを示す行として表示されます。新しいセッションはエージェントビューヘッダーに表示されているモデルと、そのディレクトリで claude を実行する場合と同じパーミッションモードを使用します。ここで入力するすべてのプロンプトは独自の新しいセッションを開始します。別のプロンプトを入力して Enter を押すと、最初のセッションへのフォローアップを送信するのではなく、最初のセッションと並行して 2 番目のセッションが起動します。この方法で複数を並行して実行できます。各セッションはサブスクリプションクォータを独立して使用するため、一度に多くをディスパッチする前に制限事項を参照してください。ピーク表示と返信
矢印キーで行を選択し、
Space を押してピークパネルを開きます。フルトランスクリプトではなく、セッションの最新の出力、または待機中の質問が表示されます。返信を入力して Enter を押すと、エージェントビューを離れずに送信できます。アタッチとデタッチ
フル会話が必要な場合は、行で
Enter または → を押してアタッチします。セッションは claude を実行した場合と同じようにターミナルを引き継ぎます。空のプロンプトで ← を押してデタッチし、テーブルに戻ります。claude agents を claude の代わりにプライマリエントリーポイントとして使用できます。エージェントビューからすべてのタスクをディスパッチし、フル会話が必要な場合はアタッチし、← を押してテーブルに戻ります。
エージェントビューでセッションを監視する
claude agents を実行してエージェントビューを開きます。ターミナル全体を占有し、状態でグループ化されたすべてのセッションをリストします。ピン留めされたセッションと入力が必要なセッションが上部に表示されます。各行はセッションの名前、現在のアクティビティ、最後に変更されてからの経過時間を表示します。
リストはすべてのプロジェクト全体で開始したすべてのバックグラウンドセッションを表示します。1 つのリポジトリで作業しているセッションと別のワークツリーで作業している別のセッションの両方がここに表示されます。エージェントビューを開いたディレクトリに関係なく表示されます。他のターミナルで開いているインタラクティブセッションは、バックグラウンドにするまでは表示されません。Subagents と teammates はセッションが生成しても個別の行としてリストされません。
セッション状態を読む
各行は、セッションの状態を示すアイコンで始まります。アイコンの色とアニメーションはセッションの状態を示します。| 状態 | アイコン表示 | 意味 |
|---|---|---|
| 作業中 | アニメーション | Claude がアクティブにツールを実行しているか、応答を生成しています |
| 入力が必要 | 黄色 | Claude は特定の質問または許可決定をあなたから待機しています |
| アイドル | 薄い | セッションはすることがなく、次のプロンプトの準備ができています |
| 完了 | 緑 | タスクが正常に完了しました |
| 失敗 | 赤 | タスクがエラーで終了しました |
| 停止 | グレー | セッションは Ctrl+X または claude stop で停止されました |
| 形状 | 意味 |
|---|---|
✻ またはアニメーション ✽ | セッションプロセスは生きており、すぐに返信します |
∙ | プロセスは終了しました。ピーク表示、返信、またはアタッチはできます。Claude は中断したところから再開します |
✢ | /loop セッションはイテレーション間でスリープしています。行は実行回数とカウントダウンを表示します |
claude respawn --all で再開します。
行の概要
各行の 1 行の概要は Haiku クラスモデル によって生成されるため、行はトランスクリプトを開かずにセッションが何をしているか、何が必要か、または何を生成したかを伝えることができます。セッションがアクティブに作業している間、概要は最大 15 秒ごとに 1 回、および各ターンが終了したときに 1 回更新されます。 各更新は通常のプロバイダーを通じた 1 つの短い Haiku クラスリクエストであり、セッション自体と同じ データ使用条件 の下で請求および処理されます。プルリクエストステータス
セッションがプルリクエストを開くと、ステータスドットが行の右端に表示され、ハイパーリンクをサポートするターミナルではプルリクエストにリンクされます。セッションが複数のプルリクエストを開いた場合、カウントはドットの前に表示され、色はどれが最も注意が必要かを反映します。| ドットの色 | プルリクエストステータス |
|---|---|
| 黄色 | チェックまたはレビューを待機中、またはチェックが失敗 |
| 緑 | チェックが成功し、レビューがブロックされていない |
| 紫 | マージ済み |
| グレー | ドラフトまたはクローズ |
ピーク表示と返信
選択した行でSpace を押してピークパネルを開きます。セッションが何を必要としているか、最新の出力、および開いたプルリクエストが表示されます。ほとんどの場合、これで十分であり、フルトランスクリプトを開く必要はありません。
ピークパネルに返信を入力して Enter を押すと、そのセッションに送信されます。セッションが複数選択肢の質問をしている場合、ピークパネルはオプションを表示し、数字キーを押して 1 つを選択できます。他のブロックされたセッションの場合は、Tab を押して入力に提案された返信を入力し、送信前に編集できます。返信の前に ! を付けて Bash コマンドを代わりに送信します。
↑ と ↓ を使用してパネルを閉じずに隣接するセッションをピーク表示するか、→ を使用してアタッチします。
セッションにアタッチする
選択した行でEnter または → を押してアタッチします。エージェントビューはフルインタラクティブセッションに置き換えられ、そのディレクトリで claude を実行した場合と同じです。アタッチすると、Claude は不在中に何が起こったかの短い要約を投稿します。
アタッチ中、セッションは他の Claude Code セッションのように動作します。すべての コマンド、キーボードショートカット、および機能が機能します。
空のプロンプトで ← を押してデタッチし、エージェントビューに戻ります。ダイアログがフォーカスを持っており、← に応答していない場合は、Ctrl+Z を押して直ちにデタッチします。
デタッチはバックグラウンドセッションを停止しません。←、Ctrl+C、Ctrl+D、Ctrl+Z、および /exit はすべてセッションを実行し続けます。セッション内からセッションを終了するには、/stop を実行します。
エージェントビューからディスパッチまたはバックグラウンドにしたセッションの後、空のプロンプトで ← を押すと、アタッチしたセッションだけでなく、任意の Claude Code セッションから機能します。現在のセッションをバックグラウンドにし、そのセッションが事前に選択された状態でエージェントビューを開くため、ターミナルを離れずにセッションを切り替えることができます。このショートカットは /config でオフにできます。
リストを整理する
エージェントビューはセッションをグループ化し、入力が必要なセッションが上部に表示されます。Ready for review と Needs input は Working と Completed の上に表示されます。これらのグループ名は上記の 状態 と 1 対 1 でマップされません。セッションはオープンなプルリクエストを持つときに Ready for review に移動し、Completed は完了、失敗、および停止したセッションを一緒に収集します。Ctrl+S を押してディレクトリでグループ化に切り替えます。選択内容は実行全体で保存されます。
グループ内で：
Ctrl+Tを押してセッションをトップにピン留めしますShift+↑またはShift+↓を押してセッションを並べ替えますCtrl+Rを押してセッションの名前を変更します- グループヘッダーで
Enterを押して折りたたみます
Ctrl+X を押して停止し、2 秒以内に Ctrl+X を再度押して削除します。グループヘッダーで Ctrl+X を押すと、確認後、そのグループ内のすべてのセッションが削除されます。
削除するとセッションがエージェントビューから削除され、その ワークツリー がクリーンアップされます。コミットされていない変更を含みます。削除する前に、保持したい作業をプッシュまたはコミットします。会話トランスクリプトはディスク上に残り、claude --resume を通じて利用可能です。
古い完了したセッションは「… N more」行に折りたたまれ、リストを短く保ちます。失敗とオープンなプルリクエストを持つセッションは常に表示されます。
セッションをフィルタリングする
ディスパッチ入力に入力してディスパッチの代わりにフィルタリングします。| フィルター | 表示 |
|---|---|
a:<name> | 名前付きエージェントを実行しているセッション |
s:<state> | 指定された状態のセッション。例えば s:working。また s:blocked はあなたを待機しているすべてのセッションを受け入れます |
#<number> または PR URL | そのプルリクエストで作業しているセッション |
キーボードショートカット
エージェントビューで? を押してコンテキスト内のすべてのショートカットを表示します。下の表はそれらをまとめています。
| ショートカット | アクション |
|---|---|
↑ / ↓ | 行間を移動 |
Enter | 選択したセッションにアタッチするか、入力にテキストがある場合はディスパッチ |
Space | 選択したセッションのピークパネルを開くまたは閉じる |
Shift+Enter | ディスパッチして直ちにアタッチ |
→ | 選択したセッションにアタッチ |
Alt+1..Alt+9 | 現在のグループのセッション 1～9 にアタッチ |
Tab | 空の入力で、すべての subagents を参照します。それ以外の場合はハイライトされた提案を適用 |
Ctrl+S | グループ化を状態とディレクトリの間で切り替え |
Ctrl+T | 選択したセッションをピン留めまたはピン留め解除 |
Ctrl+R | 選択したセッションの名前を変更 |
Ctrl+G | $EDITOR でディスパッチプロンプトを開く |
Ctrl+X | セッションを停止。2 秒以内に再度押して削除 |
Shift+↑ / Shift+↓ | 選択したセッションを並べ替え |
Esc | ピークパネルを閉じるか、入力をクリアするか、終了 |
Ctrl+C | 入力をクリア。2 回押して終了 |
? | すべてのショートカットを表示 |
新しいエージェントをディスパッチする
エージェントビューから新しいバックグラウンドセッションをディスパッチするか、既存のインタラクティブセッションをバックグラウンドに送信するか、シェルから直接開始できます。エージェントビューから
エージェントビューの下部の入力にプロンプトを入力してEnter を押すと、新しいバックグラウンドセッションが開始されます。セッションはプロンプトから自動的に名前が付けられます。後で Ctrl+R で名前を変更できます。
プロンプトに画像を貼り付けて、タスクにスクリーンショットまたは図を含めます。
プロンプトの一部をプレフィックスまたは言及してセッションの開始方法を制御します。
| 入力 | 効果 |
|---|---|
<agent-name> <prompt> | 最初の単語がカスタム subagent 名と一致する場合、その subagent はセッションのメインエージェントとして実行され、frontmatter の設定を使用します |
@<agent-name> | プロンプト内の任意の場所でカスタム subagent を言及してメインエージェントとして実行 |
@<repo> | エージェントビューを開いたディレクトリの下のリポジトリを言及してセッションをそこで実行 |
/<skill> | skills をディスパッチプロンプトとして提案 |
#<number> または PR URL | セッションが既にその PR で作業している場合は、ディスパッチの代わりに選択 |
Shift+Enter | ディスパッチして新しいセッションに直ちにアタッチ |
@name が subagent と兄弟リポジトリの両方と一致する場合、subagent が優先されます。最初の単語の一致も適用されるため、subagent 名の 1 つと一致する単語で始まるプロンプトはその subagent をディスパッチします。明示的にしたい場合は @ 形式を使用するか、プロンプトを別の単語で開始して一致を避けます。
特定のディレクトリにディスパッチする
新しいセッションはエージェントビューを開いたディレクトリで実行されます。別のディレクトリをターゲットにするには：- そのディレクトリで
claude agentsを開きます。 - 複数のリポジトリを保持する親ディレクトリで
claude agentsを開き、プロンプトで@<repo>を使用して 1 つを言及してセッションをそこで実行します。 - シェルから、ディレクトリに
cdしてclaude --bg "<prompt>"を実行します。
セッション内から
/background またはそのエイリアス /bg を実行して現在の会話をバックグラウンドセッションに移動します。/bg run the test suite and fix any failures などのプロンプトを渡して、バックグラウンド化する前に 1 つの追加命令を送信します。
インタラクティブセッションからバックグラウンド化すると、保存された会話から再開する新しいプロセスが開始されるため、subagent の実行、monitors、およびバックグラウンドコマンドはそれに転送されません。実行中の場合、Claude はバックグラウンド化する前に確認を求めます。バックグラウンドに入ると、セッションは新しい subagent、monitor、およびバックグラウンドコマンドを開始でき、それらは後のデタッチとリアタッチ全体で実行し続けます。
シェルから
--bg を渡してセッションを直接バックグラウンドに送信します。
--bg を --agent と組み合わせます。
ファイル編集の分離方法
エージェントビュー、/bg、または claude --bg から開始されたすべてのバックグラウンドセッションは、作業ディレクトリで開始されます。ファイルを編集する前に、Claude はセッションを .claude/worktrees/ の下の分離された git worktree に移動するため、並列セッションは同じチェックアウトを読み取ることができますが、それぞれが独自のものに書き込みます。セッションが既に .claude/worktrees/ の下にある場合、作業ディレクトリが git リポジトリでない場合、または作業ディレクトリの外への書き込みの場合、Claude はこれをスキップします。
git リポジトリの外では、セッションは作業ディレクトリに直接書き込み、互いに分離されていないため、同じファイルを編集する並列セッションのディスパッチを避けます。
セッションを削除するとワークツリーが削除されるため、削除する前に保持したい変更をマージまたはプッシュします。セッションのワークツリーパスを見つけるには、セッションをピークするか、アタッチして作業ディレクトリを確認します。
subagent が開始方法に関係なく常に独自のワークツリーで実行されるようにするには、frontmatter で isolation: worktree を設定します。
モデルを設定する
エージェントビューヘッダーに表示されるモデル名はディスパッチのデフォルトです。入力から開始する新しいセッションはこのモデルを使用します。これは任意のセッションで/model が制御するのと同じ設定です。エージェントビューセッション全体でオーバーライドするには、エージェントビューを開く際に --model を渡します。パーミッションモード、モデル、および努力 を参照してください。
各バックグラウンドセッションは異なるモデルで実行できます。1 つのセッションでオーバーライドするには：
- シェルから、
claude --bgで--modelを渡します。 - 実行中のセッションにアタッチして、そこで
/modelを実行します。セッションが再生成される場合、変更は保持されます。 - frontmatter が
modelフィールドを設定する subagent をディスパッチします。
パーミッションモード、モデル、および努力
ディスパッチされたセッションは、そこでclaude を開始した場合と同じように、実行されるディレクトリから settings と permission mode を読み取ります。
エージェントビューからディスパッチするすべてのセッションのデフォルトを設定するには、エージェントビューを開く際に --permission-mode、--model、または --effort のいずれかを渡します。
defaultMode を使用するか、ディスパッチされた subagent の frontmatter から permissionMode を使用し、エージェントビューヘッダーに表示されるモデルを使用します。
bypassPermissions または auto を使用することは、それらのモードが監視していないセッションが承認なしで動作することを許可するため、それらのモードを対話的に実行して claude で受け入れるまで拒否されます。同じことが、モードを claude agents に渡すか、claude --bg --permission-mode に渡すかに関係なく適用されます。
設定、プラグイン、および MCP サーバー
エージェントビューは、設定、プラグイン、MCP サーバー、および追加ディレクトリを読み込むためのclaude と同じ設定フラグを受け入れます。各フラグはエージェントビュー自体に適用され、そこからディスパッチするすべてのセッションに渡されるため、この方法で読み込むプラグインまたは MCP サーバーはそれらのセッションでも利用可能です。
| フラグ | 効果 |
|---|---|
--settings <file-or-json> | エージェントビューとディスパッチされたセッションの設定をオーバーライド |
--add-dir <path> | 追加ディレクトリへのファイルアクセスを許可 |
--plugin-dir <path> | ローカルディレクトリからプラグインを読み込む |
--mcp-config <file-or-json> | 設定ファイルまたは JSON 文字列から MCP サーバーを読み込む |
--strict-mcp-config | --mcp-config からのみ MCP サーバーを使用し、他の MCP 設定を無視 |
--add-dir、--plugin-dir、または --mcp-config を値ごとに 1 回繰り返します。--add-dir a b c などのスペース区切り形式は claude agents ではサポートされていません。
次の例は、設定オーバーライドと 1 つの追加ディレクトリでエージェントビューを開きます。
シェルからセッションを管理する
すべてのバックグラウンドセッションには、シェルから使用できる短い ID があります。ID はclaude --bg でセッションを開始するときに出力され、各セッションの ID は ~/.claude/jobs/ の下のディレクトリ名です。これらのコマンドはスクリプティングまたはエージェントビューを開きたくない場合に便利です。
| コマンド | 目的 |
|---|---|
claude agents | エージェントビューを開く |
claude attach <id> | このターミナルでセッションにアタッチ |
claude logs <id> | セッションの最新出力を出力 |
claude stop <id> | セッションを停止。claude kill も受け入れます |
claude respawn <id> | 会話を保持したまま停止したセッションを再開 |
claude respawn --all | すべての停止したセッションを再開 |
claude rm <id> | リストからセッションを削除。コミットされていない変更がない場合、その worktree をクリーンアップします |
バックグラウンドセッションがどのようにホストされるか
エージェントビューに表示されているすべてのセッションはバックグラウンドセッションと見なされます。現在接続しているかどうかに関わらず、バックグラウンドセッションと見なされます。これに対して、claude を直接実行して開始されたセッションはそのターミナルに結び付けられ、ターミナルが閉じると終了します。ただし、セッション内からバックグラウンドに送信することはできます。
スーパーバイザープロセス
バックグラウンドセッションはユーザーごとのスーパーバイザープロセスによってホストされ、ターミナルおよびエージェントビューとは別です。スーパーバイザーはセッションを初めてバックグラウンド化するか、エージェントビューを開くときに自動的に開始され、直接管理することはありません。 スーパーバイザーとそのセッションはインタラクティブセッションと同じ認証情報で認証され、モデル API を超えて追加のネットワーク接続を行いません。 各バックグラウンドセッションは独自の Claude Code プロセスであり、ターミナルではなくスーパーバイザーによって管理されます。アクティブに作業しているセッション、入力を待機しているセッション、またはターミナルが接続されているセッションはプロセスを実行し続けます。 セッションが完了し、約 1 時間アタッチされていない状態で待機すると、スーパーバイザーはリソースを解放するためにプロセスを停止します。トランスクリプトと状態はディスク上に残り、次回アタッチ、ピーク表示、または返信するときに、スーパーバイザーは中断したところから新しいプロセスを開始します。すべてのセッションが完了し、ターミナルが接続されていない場合、スーパーバイザー自体が終了し、次回セッションをバックグラウンド化するか、エージェントビューを開くときに再度開始します。 スーパーバイザーはディスク上にインストールされた Claude Code バイナリを監視し、通常の 自動更新プログラム がそれを置き換えた後、新しいバージョンに再開します。これはネットワークチェックではなく、ローカルファイルウォッチです。バックグラウンドセッションはデタッチされたプロセスであるため、再開を通じて実行し続け、新しいスーパーバイザーはそれらに再接続します。状態が保存される場所
セッション状態は Claude Code 設定ディレクトリの下に保存されます。CLAUDE_CONFIG_DIR を設定した場合、スーパーバイザーは ~/.claude の代わりにそのディレクトリを使用し、独自のセッションを持つ別のインスタンスとして実行されます。
| パス | 内容 |
|---|---|
~/.claude/daemon.log | スーパーバイザーログ |
~/.claude/daemon/roster.json | 実行中のバックグラウンドセッションのリスト。再開後に再接続するために使用 |
~/.claude/jobs/<id>/state.json | エージェントビューに表示されるセッションごとの状態 |
エージェントビューをオフにする
バックグラウンドエージェントとエージェントビューを完全にオフにするには、disableAgentView 設定 を true に設定するか、CLAUDE_CODE_DISABLE_AGENT_VIEW 環境変数を設定します。管理者は マネージド設定 を通じてこれを強制できます。
トラブルシューティング
claude agents がエージェントビューを開く代わりにサブエージェントをリストする
claude agents が数を出力した後、設定されたサブエージェントを表示してから終了する場合、エージェントビューはお使いの環境では利用できません。以前のバージョンでは、Bedrock、Vertex AI、または Foundry を経由して接続している場合を含め、すべての環境でエージェントビューを開きませんでした。claude update を実行して最新バージョンをインストールしてください。
更新後もエージェントビューが開かない場合は、設定または環境変数によってオフになっているかどうかを確認してください。
エージェントビューがセッションなしで開く
エージェントビューは最初のセッションをディスパッチするまで空です。下部の入力にプロンプトを入力してEnter を押します。
バックグラウンドタスクが実行中のためエージェントを開くことができない
← を押して現在のセッションをバックグラウンドに移すと Cannot open agents — N background task(s) running が表示される場合、セッションにはサブエージェント、ワークフロー、またはバックグラウンドシェルコマンドなどの進行中の作業があり、ショートカットはそれを静かに放棄しません。/tasks を実行して何が実行されているかを確認し、/bg を実行して放棄することを確認します。バックグラウンドに移すときに何が転送され、何が転送されないかについては、セッション内からを参照してください。
プロンプトが短すぎるとして拒否される
ディスパッチ入力は会話の開始ではなく、タスクの説明を期待しています。4 文字未満のプロンプトはToo short ヒントで拒否されるため、誤ったキー入力がセッションを開始しません。セッションで何をしたいかを説明してください。例えば investigate the flaky checkout test のようにします。
マシンをウェイクアップした後、セッションが停止として表示される
バックグラウンドセッションはスリープまたはシャットダウンを生き残りません。実行中だったセッションは、ウェイク後に停止として表示されます。それらのいずれかにアタッチ、ピーク表示、または返信すると、セッションは中断したところから再開します。すべてを一度に再開するには、claude respawn --all を実行します。
セッションがアタッチ後に応答が遅い
セッションが完了し、約 1 時間アタッチされていない状態で待機すると、スーパーバイザーはリソースを解放するためにプロセスを停止します。アタッチすると、中断したところから新しいプロセスが開始され、少し時間がかかります。作業中または入力を待機しているセッションはこの方法で停止されることはありません。.claude/worktrees/ が満杯になっている
ワークツリーはセッションを削除するときに削除されます。セッションがクリーンアップなしで終了した場合は、プロジェクトディレクトリで git worktree list で残りのエントリをリストし、各エントリを git worktree remove <path> で削除します。ワークツリーをクリーンアップするを参照してください。
制限事項
Agent view はリサーチプレビューであり、以下の制限事項があります。- レート制限が適用される：バックグラウンドセッションはインタラクティブセッションと同じようにサブスクリプション使用量を消費するため、10 個のエージェントを並行して実行するとクォータが 10 倍速く消費されます。
- セッションはローカル：バックグラウンドセッションはマシンで実行され、スリープまたはシャットダウンすると停止します。
- Worktrees はセッションで削除される：セッションが独自の Worktrees でファイルを編集した場合、削除する前に変更をマージまたはプッシュしてください。
関連リソース
Claude を並列実行する他の方法については、以下を参照してください。- エージェントを並列実行：エージェントビューとサブエージェント、エージェントチーム、ワークツリーを比較
- Agent teams：互いにメッセージを送信する複数のセッションを調整
- Claude Code on the web：ローカルではなく、マネージドクラウド環境でセッションを実行