SpyBara
Go Premium

agent-view.md 2026-05-17 01:01 UTC to 2026-05-18 23:59 UTC

82 added, 31 removed.

2026
Sun 31 06:39 Sat 30 06:23 Fri 29 06:38 Thu 28 06:37 Wed 27 06:42 Tue 26 06:33 Sun 24 06:25 Sat 23 06:18 Fri 22 06:33 Thu 21 06:36 Wed 20 06:35 Tue 19 06:34 Mon 18 23:59 Sun 17 01:01 Fri 15 22:58 Thu 14 17:02 Wed 13 23:01 Tue 12 22:57 Mon 11 23:00 Sun 10 23:03 Sat 9 04:57 Fri 8 22:00 Thu 7 22:59 Tue 5 23:00 Mon 4 22:58 Sat 2 18:14 Fri 1 18:19

耇数の゚ヌゞェントを゚ヌゞェントビュヌで管理する

1 ぀の画面から倚くの Claude Code セッションをディスパッチしお管理したす。゚ヌゞェントビュヌは、すべおのセッションが䜕をしおいるか、どのセッションが入力を必芁ずしおいるかを衚瀺したす。

claude agents で開く゚ヌゞェントビュヌは、すべおのバックグラりンドセッションの 1 ぀の画面です。実行䞭のもの、入力が必芁なもの、完了したものが衚瀺されたす。新しいセッションをディスパッチし、トランスクリプトをスクロヌルする代わりに䞀目でセッションの状態を確認し、セッションが必芁ずするずきだけ介入したす。各バックグラりンドセッションは完党な Claude Code の䌚話であり、タヌミナルが接続されおいなくおもバックグラりンドで実行し続けるため、い぀でも開いお、返信しお、去るこずができたす。

タヌミナルの゚ヌゞェントビュヌヘッダヌは Claude Code v2.1.140、モデル、䜜業ディレクトリ、および抂芁カりントを衚瀺したす。セッションは'入力が必芁'、'実行䞭'、'完了'の䞋にグルヌプ化され、䞋郚にディスパッチ入力ずキヌボヌドヒントのフッタヌがありたす。 タヌミナルの゚ヌゞェントビュヌヘッダヌは Claude Code v2.1.140、モデル、䜜業ディレクトリ、および抂芁カりントを衚瀺したす。セッションは'入力が必芁'、'実行䞭'、'完了'の䞋にグルヌプ化され、䞋郚にディスパッチ入力ずキヌボヌドヒントのフッタヌがありたす。

Claude が耇数の独立したタスクに察しお、あなたが毎ステップを監芖するこずなく䜜業できる堎合に、゚ヌゞェントビュヌを䜿甚したす。バグ修正、プルリク゚ストレビュヌ、䞍安定なテストの調査を 3 ぀の行ずしおディスパッチし、別のりィンドりで䜜業を続け、行が入力が必芁であるこずを瀺すか、結果が埗られたずきに確認したす。

任意の゚ヌゞェントのセッションでより盎接的に䜜業したい堎合は、行にアタッチしお完党な䌚話に入りたす。

゚ヌゞェントビュヌを subagents、agent teams、worktrees ず比范するには、゚ヌゞェントを䞊列で実行するを参照しおください。

このペヌゞでは以䞋をカバヌしおいたす。

クむックスタヌト

このチュヌトリアルでは、コア゚ヌゞェントビュヌルヌプに぀いお説明したす。タスクをディスパッチし、Claude が䜜業する際に行が曎新されるのを芋守り、ピヌクしお確認しお返信し、フル䌚話にアタッチしたす。ディスパッチしたセッションぱヌゞェントビュヌを閉じた埌も実行し続けるため、離れお埌で戻るこずができたす。

1

゚ヌゞェントビュヌを開く

シェルから以䞋を実行したす。

claude agents

゚ヌゞェントビュヌが開き、䞋郚に入力フィヌルドが衚瀺され、セッションが開始されるずテヌブルが埋たりたす。い぀でも Esc を抌しおシェルに戻りたす。セッションは離れおいる間も実行し続け、次に゚ヌゞェントビュヌを開いたずきに再床衚瀺されたす。

2

セッションをディスパッチする

タスクを説明するプロンプトを入力しお Enter を抌したす。新しいバックグラりンドセッションがそのタスクで開始され、䜜業䞭か、入力を埅機䞭か、完了しおいるかを瀺す行ずしお衚瀺されたす。新しいセッションぱヌゞェントビュヌヘッダヌに衚瀺されおいるモデルず、そのディレクトリで claude を実行する堎合ず同じパヌミッションモヌドを䜿甚したす。

ここで入力するすべおのプロンプトは独自の新しいセッションを開始したす。別のプロンプトを入力しお Enter を抌すず、最初のセッションぞのフォロヌアップを送信するのではなく、最初のセッションず䞊行しお 2 番目のセッションが起動したす。この方法で耇数を䞊行しお実行できたす。

各セッションはサブスクリプションクォヌタを独立しお䜿甚するため、䞀床に倚くをディスパッチする前に制限事項を参照しおください。

3

ピヌク衚瀺ず返信

矢印キヌで行を遞択し、Space を抌しおピヌクパネルを開きたす。フルトランスクリプトではなく、セッションの最新の出力、たたは埅機䞭の質問が衚瀺されたす。返信を入力しお Enter を抌すず、゚ヌゞェントビュヌを離れずに送信できたす。

4

アタッチずデタッチ

フル䌚話が必芁な堎合は、行で Enter たたは → を抌しおアタッチしたす。セッションは claude を実行した堎合ず同じようにタヌミナルを匕き継ぎたす。空のプロンプトで ← を抌しおデタッチし、テヌブルに戻りたす。

5

既存のセッションを持ち蟌む

既に開いおいるセッションを゚ヌゞェントビュヌに移動するには、セッション内で /bg を実行するか、空のプロンプトで ← を抌しおセッションをバックグラりンドにし、1 ステップで゚ヌゞェントビュヌを開きたす。セッションは実行し続け、ディスパッチしたセッションず䞊行しお行ずしお衚瀺されたす。

claude agents を claude の代わりにプラむマリ゚ントリヌポむントずしお䜿甚できたす。゚ヌゞェントビュヌからすべおのタスクをディスパッチし、フル䌚話が必芁な堎合はアタッチし、← を抌しおテヌブルに戻りたす。

゚ヌゞェントビュヌでセッションを監芖する

claude agents を実行しお゚ヌゞェントビュヌを開きたす。タヌミナル党䜓を占有し、状態でグルヌプ化されたすべおのセッションをリストしたす。ピン留めされたセッションず入力が必芁なセッションが䞊郚に衚瀺されたす。各行はセッションの名前、珟圚のアクティビティ、最埌に倉曎されおからの経過時間を衚瀺したす。

デフォルトでは、リストはすべおのプロゞェクト党䜓で開始したすべおのバックグラりンドセッションを衚瀺したす。1 ぀のリポゞトリで䜜業しおいるセッションず別のワヌクツリヌで䜜業しおいる別のセッションの䞡方がここに衚瀺されたす。゚ヌゞェントビュヌを開いたディレクトリに関係なく衚瀺されたす。リストを 1 ぀のプロゞェクトに絞り蟌むには、--cwd を枡したすClaude Code v2.1.141 以降が必芁です。

claude agents --cwd ~/projects/my-app

これはそのディレクトリの䞋で開始されたセッションのみを衚瀺したす。~/projects/my-app/.claude/worktrees/ の䞋の ワヌクツリヌに移動した セッションは、~/projects/my-app に属するものずしおカりントされたす。

他のタヌミナルで開いおいるむンタラクティブセッションは、バックグラりンドにするたでは衚瀺されたせん。Subagents ず teammates はセッションが生成しおも個別の行ずしおリストされたせん。

Pinned
  ✜ clawd walk cycle          Write assets/sprites/clawd-walk.png           3m

Ready for review
  ∙ jump physics              github.com/example/game/pull/2048          ●  2h

Needs input
  ✻ power-up design           needs input: double jump or wall climb?       1m

Working
  ✜ collision detection       Edit src/physics/CollisionSystem.ts           2m
  ✢ playtest level 3          run 12 · all checkpoints cleared           in 4m

Completed
  ✻ title screen              result: menu, options, and credits done       9m
  ∙ sound effects             result: 14 SFX exported to assets/audio       4h
  
 6 more

セッション状態を読む

各行は、セッションの状態を瀺すアむコンで始たりたす。アむコンの色ずアニメヌションはセッションの状態を瀺したす。

状態 アむコン衚瀺 意味
䜜業䞭 アニメヌション Claude がアクティブにツヌルを実行しおいるか、応答を生成しおいたす
入力が必芁 黄色 Claude は特定の質問たたは蚱可決定をあなたから埅機しおいたす
アむドル 薄い セッションはするこずがなく、次のプロンプトの準備ができおいたす
完了 緑 タスクが正垞に完了したした
倱敗 èµ€ タスクが゚ラヌで終了したした
停止 グレヌ セッションは Ctrl+X たたは claude stop で停止されたした

別に、アむコンの圢状は基盀ずなるプロセスが実行しおいるかどうかを瀺したす。

圢状 意味
✻ たたはアニメヌション ✜ セッションプロセスは生きおおり、すぐに返信したす
∙ プロセスは終了したした。ピヌク衚瀺、返信、たたはアタッチはできたす。Claude は䞭断したずころから再開したす
✢ /loop セッションはむテレヌション間でスリヌプしおいたす。行は実行回数ずカりントダりンを衚瀺したす

行の右端に衚瀺される ● は プルリク゚ストステヌタス むンゞケヌタヌであり、状態アむコンの䞀郚ではありたせん。その前の数字はセッションが開いたプルリク゚ストの数です。

バックグラりンドセッションは䜜業を続けるためにタヌミナルを開く必芁がありたせん。別の スヌパヌバむザヌプロセス がセッションを実行するため、゚ヌゞェントビュヌを閉じたり、シェルを閉じたり、新しいむンタラクティブセッションを開始したりしおも、ディスパッチされた䜜業は続きたす。

セッション状態はディスク䞊に氞続化され、自動曎新ずスヌパヌバむザヌ再起動を通じお保存されたす。セッションはマシンがスリヌプするずきも保存されたす。プロセスはりェむク時に再開され、スヌパヌバむザヌはアむドルずしお時間ギャップを扱う代わりにそれらに再接続したす。シャットダりンはただ実行䞭のセッションを停止したす。シャットダりン埌にセッションが倱敗ずしお衚瀺される を参照しお、それらを埩旧する方法を確認しおください。

行の抂芁

各行の 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 でオフにできたすleftArrowOpensAgents 蚭定。

リストを敎理する

゚ヌゞェントビュヌはセッションをグルヌプ化し、入力が必芁なセッションが䞊郚に衚瀺されたす。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 が ワヌクツリヌを䜜成した 堎合、削陀するずそのワヌクツリヌも削陀されたす。コミットされおいない倉曎を含みたす。保持したい䜜業をプッシュたたはコミットしおから削陀したす。自分で䜜成したワヌクツリヌずセッションを開始した堎合は、そのたたにしおおきたす。

叀い完了したセッションは「  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 $VISUAL たたは $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 ディスパッチしお新しいセッションに盎ちにアタッチ

繰り返しタスクを skill ずしおパッケヌゞ化するず、プロンプトを再入力せずに゚ヌゞェントビュヌから同じワヌクフロヌを䜕床も開始できたす。

同じ @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、およびバックグラりンドコマンドを開始でき、それらは埌のデタッチずリアタッチ党䜓で実行し続けたす。

元の起動時の蚭定フラグはバックグラりンド化されたセッションに匕き継がれるため、その MCP サヌバヌ、蚭定、およびフォヌルバックモデルは有効なたたです

  • --mcp-config および --strict-mcp-config
  • --settings
  • --add-dir
  • --plugin-dir
  • --fallback-model
  • --allow-dangerously-skip-permissions

--allow-dangerously-skip-permissions を匕き継ぐこずで、バックグラりンド化されたセッションで bypassPermissions に到達可胜になりたすが、新しい暩限は付䞎されたせん。このモヌドは、セッションが監芖しおいない状態で承認なしに動䜜するこずを蚱可するため、パヌミッションモヌド、モデル、および努力 で説明されおいるのず同じ 1 回限りのむンタラクティブな受け入れが必芁です。

シェルから

--bg を枡しおセッションを盎接バックグラりンドに送信したす

claude --bg "investigate the flaky SettingsChangeDetector test"

特定の subagent をセッションのメむン゚ヌゞェントずしお実行するには、--bg を --agent ず組み合わせたす

claude --agent code-reviewer --bg "address review comments on PR 1234"

--name を枡しお、自動生成されたセッションの代わりに゚ヌゞェントビュヌでセッションの衚瀺名を蚭定したす

claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"

バックグラりンド化の埌、Claude はセッションの短い ID ずセッションを管理するためのコマンドを出力したす

backgrounded · 7c5dcf5d
  claude agents             list sessions
  claude attach 7c5dcf5d    open in this terminal
  claude logs 7c5dcf5d      show recent output
  claude stop 7c5dcf5d      stop this session

ファむル線集の分離方法

゚ヌゞェントビュヌ、/bg、たたは claude --bg から開始されたすべおのバックグラりンドセッションは、䜜業ディレクトリで開始されたす。ファむルを線集する前に、Claude はセッションを .claude/worktrees/ の䞋の分離された git worktree に移動するため、䞊列セッションは同じチェックアりトを読み取るこずができたすが、それぞれが独自のものに曞き蟌みたす。

Claude はワヌクツリヌをスキップしたす

  • セッションが既にリンクされた git worktree 内にある堎合。Claude が .claude/worktrees/ の䞋に䜜成したか、git worktree add で別の堎所に䜜成したかに関係なく
  • 䜜業ディレクトリが git リポゞトリでない堎合
  • 䜜業ディレクトリの倖ぞの曞き蟌みの堎合

git worktree が実甚的でないリポゞトリのワヌクツリヌ分離をオフにするには、worktree.bgIsolation を "none" に蚭定したす。バックグラりンドセッションは、ワヌクツリヌに移動する前に䜜業コピヌを盎接線集したす。プロゞェクトの .claude/settings.json に蚭定を远加したす

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

git リポゞトリの倖では、セッションは䜜業ディレクトリに盎接曞き蟌み、互いに分離されおいないため、同じファむルを線集する䞊列セッションのディスパッチを避けたす。

゚ヌゞェントビュヌでセッションを削陀するCtrl+X を 2 回ず、Claude が䜜成したワヌクツリヌが削陀されたす。コミットされおいない倉曎を含めお削陀されるため、保持したい倉曎をマヌゞたたはプッシュしおから削陀したす。シェルから claude rm で削陀するず、コミットされおいない倉曎があるワヌクツリヌが保持され、そのパスが出力されるため、自分でクリヌンアップできたす。自分で䜜成したワヌクツリヌずセッションを開始した堎合は、どちらの方法でも所定の䜍眮に残されたす。

セッションのワヌクツリヌパスを芋぀けるには、セッションをピヌクするか、アタッチしお䜜業ディレクトリを確認したす。

subagent が開始方法に関係なく垞に独自のワヌクツリヌで実行されるようにするには、frontmatter で isolation: worktree を蚭定したす。

モデルを蚭定する

゚ヌゞェントビュヌヘッダヌに衚瀺されるモデル名はディスパッチのデフォルトです。入力から開始する新しいセッションはこのモデルを䜿甚したす。これは任意のセッションで /model が制埡するのず同じ蚭定です。゚ヌゞェントビュヌセッション党䜓でオヌバヌラむドするには、゚ヌゞェントビュヌを開く際に --model を枡したす。パヌミッションモヌド、モデル、および努力 を参照しおください。

各バックグラりンドセッションは異なるモデルで実行できたす。1 ぀のセッションでオヌバヌラむドするには

  • シェルから、claude --bg で --model を枡したす。
  • 実行䞭のセッションにアタッチしお、そこで /model を実行したす。セッションが再生成される堎合、倉曎は保持されたす。
  • frontmatter が model フィヌルドを蚭定する subagent をディスパッチしたす。

パヌミッションモヌド、モデル、および努力

バックグラりンドセッションは、そこで claude を開始した堎合ず同じように、実行されるディレクトリから settings を読み取りたす。

permission mode は、セッションをどのように開始したかによっお異なりたす。/bg たたは ← でむンタラクティブセッションをバックグラりンド化するず、珟圚のパヌミッションモヌドが保持されるため、acceptEdits たたは auto に切り替えたセッションはデタッチ埌もそのモヌドのたたです。゚ヌゞェントビュヌ入力からディスパッチするか、シェルから claude --bg を実行するず、そのディレクトリの蚭定から defaultMode を䜿甚するか、ディスパッチされた subagent の frontmatter から permissionMode を䜿甚したす。

バックグラりンドセッションを開始するずきのパヌミッションモヌドは、スヌパヌバむザヌが埌で セッションのプロセスを停止しお再開 するずきに保持されたす。claude --bg --dangerously-skip-permissions たたは claude --bg --permission-mode bypassPermissions で起動したセッションは、ディレクトリの defaultMode にフォヌルバックする代わりに、その再開埌も bypassPermissions のたたです。

゚ヌゞェントビュヌを開く際に --permission-mode、--model、たたは --effort のいずれかを枡しお、゚ヌゞェントビュヌからディスパッチするすべおのセッションのデフォルトを蚭定したす

claude agents --permission-mode plan --model opus --effort high

claude agents は、--permission-mode bypassPermissions の短瞮圢ずしお --dangerously-skip-permissions も受け入れ、各ディスパッチされたセッションの Shift+Tab サむクルで bypassPermissions を利甚可胜にするために --allow-dangerously-skip-permissions も受け入れたす。どちらも トップレベル CLI フラグ ず䞀臎したす。

アクティブなデフォルトはディスパッチ入力の䞋のフッタヌに衚瀺されたす。

これらのフラグがない堎合、セッションはそのディレクトリの蚭定から defaultMode を䜿甚するか、ディスパッチされた subagent の frontmatter から permissionMode を䜿甚し、゚ヌゞェントビュヌヘッダヌに衚瀺されるモデルを䜿甚したす。

bypassPermissions たたは auto を䜿甚するこずは、それらのモヌドが監芖しおいないセッションが承認なしで動䜜するこずを蚱可するため、それらのモヌドを察話的に実行しお claude で受け入れるたで拒吊されたす。同じこずが、モヌドを claude agents に枡すか、claude --bg --permission-mode に枡すかに関係なく適甚されたす。

蚭定、プラグむン、および MCP サヌバヌ

゚ヌゞェントビュヌは、蚭定、プラグむン、MCP サヌバヌ、および远加ディレクトリを読み蟌むための claude ず同じ蚭定フラグを受け入れたす。これらのフラグには Claude Code v2.1.142 以降が必芁です。各フラグぱヌゞェントビュヌ自䜓に適甚され、そこからディスパッチするすべおのセッションに枡されるため、この方法で読み蟌むプラグむンたたは 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 ぀の远加ディレクトリで゚ヌゞェントビュヌを開きたす

claude agents --settings ./ci-settings.json --add-dir ../shared-lib

シェルからセッションを管理する

すべおのバックグラりンドセッションには、シェルから䜿甚できる短い ID がありたす。ID は claude --bg でセッションを開始するずきに出力され、各セッションの ID は ~/.claude/jobs/ の䞋のディレクトリ名です。これらのコマンドはスクリプティングたたぱヌゞェントビュヌを開きたくない堎合に䟿利です。

コマンド 目的
claude agents ゚ヌゞェントビュヌを開く
claude agents --cwd <path> <path> の䞋で開始されたセッションにスコヌプされた゚ヌゞェントビュヌを開く
claude attach <id> このタヌミナルでセッションにアタッチする
claude logs <id> セッションの最新出力を出力する
claude stop <id> セッションを停止する。claude kill も受け入れたす
claude respawn <id> セッションを再開する。䌚話を保持したたた実行たたは停止状態から再開したす。䟋えば、曎新された Claude Code バむナリを取埗するため
claude respawn --all すべおの実行䞭のセッションを再開する。䟋えば、すべおのセッションを䞀床に曎新された Claude Code バむナリに移動するため
claude rm <id> セッションずそのトランスクリプトを削陀する。コミットされおいない倉曎がない堎合、セッション甚に Claude が䜜成した worktree を削陀したす。それ以倖の堎合は、クリヌンアップできるように worktree パスを出力したす。自分で䜜成した worktree はそのたたにしおおきたす
claude daemon status supervisor の状態、バヌゞョン、゜ケットディレクトリ、およびワヌカヌ数を出力する

バックグラりンドセッションがどのようにホストされるか

゚ヌゞェントビュヌに衚瀺されおいるすべおのセッションはバックグラりンドセッションず芋なされたす。珟圚接続しおいるかどうかに関わらず、バックグラりンドセッションず芋なされたす。これに察しお、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 ゚ヌゞェントビュヌに衚瀺されるセッションごずの状態

スヌパヌバむザヌの状態を盎接ファむルを読むこずなく怜査するには、claude daemon status を実行したす。スヌパヌバむザヌに到達可胜かどうか、そのプロセス ID ずバヌゞョン、゜ケットディレクトリ、およびラむブのバックグラりンドセッション数を報告したす。/doctor には同じチェックの抂芁が含たれたす。Windows では、claude daemon status はデヌモンのパむプキヌファむルがロックされおいるか読み取り䞍可の堎合、䞀般的な接続倱敗を報告する代わりに、基になるファむル゚ラヌを衚瀺したす。

゚ヌゞェントビュヌをオフにする

バックグラりンド゚ヌゞェントず゚ヌゞェントビュヌを完党にオフにするには、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 のようにしたす。

シャットダりン埌、セッションが倱敗ずしお衚瀺される

マシンをシャットダりンたたは再起動するず、実行䞭のバックグラりンドセッションが停止するため、次に゚ヌゞェントビュヌを開くずきに倱敗ずしお衚瀺されたす。それらのいずれかにアタッチ、ピヌク衚瀺、たたは返信するず、セッションは䞭断したずころから再開したす。

スリヌプだけではこれは発生したせん。セッションはスリヌプ党䜓で保持され、スヌパヌバむザヌはりェむク時にそれらに再接続したす。

セッションがアタッチ埌に応答が遅い

セッションが完了し、玄 1 時間アタッチされおいない状態で埅機するず、スヌパヌバむザヌはリ゜ヌスを解攟するためにプロセスを停止したす。アタッチするず、䞭断したずころから新しいプロセスが開始され、少し時間がかかりたす。䜜業䞭たたは入力を埅機しおいるセッションはこの方法で停止されるこずはありたせん。

.claude/worktrees/ が満杯になっおいる

゚ヌゞェントビュヌでセッションを削陀するず、Claude が䜜成したワヌクツリヌが削陀されたす。claude rm はコミットされおいない倉曎があるワヌクツリヌを保持し、そのパスを出力したす。プロゞェクトディレクトリで git worktree list を䜿甚しお残りの゚ントリをリストし、各゚ントリを git worktree remove <path> で削陀したす。ワヌクツリヌをクリヌンアップするを参照しおください。

制限事項

Agent view はリサヌチプレビュヌであり、以䞋の制限事項がありたす。

  • レヌト制限が適甚されるバックグラりンドセッションはむンタラクティブセッションず同じようにサブスクリプション䜿甚量を消費するため、10 個の゚ヌゞェントを䞊行しお実行するずクォヌタが 10 倍速く消費されたす。
  • セッションはロヌカルバックグラりンドセッションはマシンで実行され、スリヌプ䞭は保持されたすが、マシンがシャットダりンするず停止したす。
  • Claude が䜜成した worktrees ぱヌゞェント view のセッションで削陀されるセッションが独自の worktree でファむルを線集した堎合、セッションを削陀する前に倉曎をマヌゞたたはプッシュしおください。claude rm は未コミットの倉曎がある worktree を保持したす。自分で䜜成した worktree はそのたた残されたす。

関連リ゜ヌス

Claude を䞊列実行する他の方法に぀いおは、以䞋を参照しおください。

  • ゚ヌゞェントを䞊列実行゚ヌゞェントビュヌずサブ゚ヌゞェント、゚ヌゞェントチヌム、ワヌクツリヌを比范
  • Agent teams互いにメッセヌゞを送信する耇数のセッションを調敎
  • Claude Code on the webロヌカルではなく、マネヌゞドクラりド環境でセッションを実行