複数のエージェントをエージェントビューで管理する

​

クイックスタート

claude agents

• ヒント: セッションが開いてから 10 秒間、フッターに ← for agents が表示されます。ヒントが消えた後も ← を押すと機能します
• 待機中の数: バックグラウンドセッションが入力を待機している間、同じ位置にその数が ← 2 agents のように表示されます。99 を超える場合は ← 99+ agents と表示されます。カウントはターミナルがフォーカスされている間は約 10 秒ごとに更新され、フォーカスが戻ると即座に更新されます
• 完了数: 入力を待機しているセッションがない状態でバックグラウンドセッションが正常に完了すると、フッターに完了した数が一時的に表示されます。たとえば 2 つの場合は ← 2 done と表示されます

​

デフォルトでエージェントビューを開く

/config defaultToAgentsView=true

claude

​

エージェントビューでセッションを監視する

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

Pinned
  ✽ clawd walk cycle          Drawing the walk-cycle sprite frames          3m

Ready for review
  ∙ jump physics              Opened PR with collision fix                 #2048  2h

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

Working
  ✽ collision detection       Adding swept-AABB checks to CollisionSystem   2m
  ✢ playtest level 3          all checkpoints cleared ×12                in 4m

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

​

セッション状態を読む

​

行の概要

​

プルリクエストステータス

• Claude Code はラベルを、プルリクエストの場合は #1234、GitLab マージリクエストの場合は !1234 と書きます。
• Claude Code は、SSH や tmux 経由などハイパーリンクのサポートを検出できない場合でもリンクを出力します。ラベルをプレーンテキストとしてレンダリングするには FORCE_HYPERLINK=0 を設定します。
• セッションにフォローアップを送信した後も、行がライブの進捗表示に戻る間、Claude Code はラベルを保持します。

• Claude が gh でプルリクエストを編集、コメント、クローズ、またはレディにマークすると、Claude Code はそのコマンド自身の出力が示すプルリクエストをリンクします。キャプチャされた出力がプルリクエストを示さない gh コマンドはリンクを作成しません。よくあるケースは gh pr merge で、結果をインタラクティブなターミナルにのみ出力するためです。
• Claude が gh pr checkout でプルリクエストをチェックアウトするか、ブランチにプッシュすると、Claude Code は gh pr view でブランチを調べ、そのオープンなプルリクエストをリンクします。
• Claude がプッシュする時点でプルリクエストが存在している必要はありません。Claude Code は、同じディレクトリでその後に実行される最大 5 つの git、gh、glab、または curl コマンドの後にブランチの検索を再試行するため、Claude が GitHub REST API を通じて作成したものも含め、プッシュ後に作成されたプルリクエストは、再試行で見つかった時点でリンクされます。

​

ピーク表示と返信

• ユーザーを待っているセッション：尋ねている正確な質問。返信入力の上に表示されます
• 完了したセッション：その結果
• 作業中のセッション：その完全なステータス文

• waiting 3m のような行：セッションがユーザーを待っている時間。行の右端の経過時間は別の数字で、セッションが開始されてからカウントされます
• safe mode · customizations are off：シェルから claude --bg --safe-mode で開始したため、このセッションは カスタマイズをオフにした状態 で実行されています。そのままにしておいてもかまいません。カスタマイズをオンに戻して会話を続けるには、シェルで claude stop <id> を実行してから claude --resume を実行します

• 作業中のセッション：/model、/effort、/rename、/usage はすぐに実行されます。その他の返信は応答を中断せずにセッションの メッセージキュー に追加され、キューに入れた入力が反映されるタイミング で反映されます。その他の コマンド は、セッション自体のプロンプトで入力するとすぐに実行されるものであっても、ターンが終了するまで待機します
• /stop だけの返信：セッションに届けられるのではなく、セッションが作業中でもユーザーを待っている状態でも、その場でセッションを停止します
• シェルジョブ：返信は /stop も含め、入力としてコマンドのターミナルに送られます

• 選択肢が用意された質問：パネルには選択肢が番号付きで表示されます。返信入力が空の状態で選択肢の番号を押すと入力され、Enter で送信できます。または、代わりに独自の回答を入力します
• 選択肢のない質問：回答を入力します。空の入力に返信の候補が表示されている場合は、Tab を押して入力し、送信前に編集できます
• 権限プロンプトまたはその他のダイアログ（サンドボックス プロンプトや MCP サーバーの 入力リクエスト など）：返信してもダイアログには答えられません。返信はキューで待機します。ダイアログに答えるには、→ でアタッチします

​

セッションにアタッチする

​

ターミナルを離れずにセッションを切り替える

• Enter を押して会話を再度開きます。
• Esc を押して切り替えを元に戻し、会話に戻ります。Esc で Still starting — try again in a moment が表示される場合、バックグラウンドセッションはまだ準備ができていないため、しばらくしてから Esc を再度押します。
• Ctrl+C を 2 回押してシェルに終了します。

• フォアグラウンドのサブエージェントがまだ実行中の場合：Claude が開始したフォアグラウンドのサブエージェントの作業を引き継ぐため、Claude Code は待機を続け、Still backgrounding after the current tool と表示します。待たずにバックグラウンドに移すには、もう一度 ← を押します。この場合、それらのサブエージェントは最初からやり直しになります。
• 権限プロンプトまたは質問が回答を待っている：権限プロンプトまたは Claude が尋ねた質問が待機している間、Claude Code は待機を続け、Still backgrounding after the current tool — a question is waiting for your answer. を表示します。権限プロンプトでの Yes など、回答によってターンが続行する場合、Claude Code は現在のツールが完了した時点でセッションをバックグラウンドにします。
• プロンプト入力に入力した：未送信のテキストはターミナルの入力ボックスに残り、バックグラウンドセッションには移動しないため、Claude Code は切り替えをキャンセルします。Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again. と表示されます。Claude はフォアグラウンドで作業を続けます。
• ターンを停止した：Claude Code は切り替えをキャンセルし、Backgrounding cancelled — the turn was stopped. を表示します。たとえば、Esc で Claude を中断した 場合、メインの会話からの権限プロンプトで コメントなしで No を選択した場合、またはそこで Claude が尋ねた質問で Esc を押した場合に、ターンは停止します。セッションをバックグラウンドにするには、← を再度押します。
• キューに入れたメッセージを移動できない：Claude の作業中にキューに入れた メッセージは、会話とともにバックグラウンドセッションに移動します。そのいずれかを移動できない場合、セッションはフォアグラウンドに留まり、Claude Code は Cannot open agents — 1 queued message can't move to the background. Press ← again once Claude has read it. のような通知を表示します。

セッションがバックグラウンドに移動する際に送信されたプロンプト

• 会話が閉じるときに送信された場合：会話が閉じてエージェントビューが開くときに、応答またはコマンドは停止します
• その時点でまだ フック を待っていた場合：プロンプトは送信されず、画面上にもその旨は表示されません。これには、SessionStart フック がまだ実行中の間に入力したプロンプトも含まれます

​

リストを整理する

• Ctrl+T を押してセッションをトップにピン留めし、アイドル中もそのプロセスを実行し続けます
• Shift+↑ または Shift+↓ を押してセッションを並べ替えます
• Ctrl+R を押してセッションの名前を変更します
• グループヘッダーで Enter を押すと、そのグループを折りたたみます。ただし、フィルター が有効な間は、すべてのグループが展開されたままになります
• Ctrl+X を押してセッションを停止し、2 秒以内に Ctrl+X を再度押してリストから削除します。削除せずに確認を閉じるには Esc を押します。2 回目の押下は、たとえば バックグラウンドサービスが応答していない ために停止の試みが失敗した場合でも、セッションを削除します。その場合、確認はさらに 2 秒間有効なままで、削除によってセッションのプロセス自体が終了されます

​

過去のセッションを戻す

• /resume に ID または検索語が指定されている
• ビューが --cwd でスコープされている
• ビューが --safe-mode で開始された
• ビューが --permission-mode や --settings などのフラグで開かれた

​

セッションをフィルタリングする

​

キーボードショートカット

​

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

​

エージェントビューからエージェントをディスパッチする

• /exit と /quit はエージェントビューを閉じます
• /logout はサインアウトします
• /model、/effort、/fast は、次にディスパッチするセッションの開始時の設定 を指定します。/effort と /fast には Claude Code v2.1.299 以降が必要です。
• /login はサインインダイアログを開き、セッションにアタッチせずに再度サインインできます
• 引数なしの /resume、またはそのエイリアス /continue は、リポジトリの過去のセッションのピッカーを開き、1 つをバックグラウンドセッションとして 復帰させます

​

特定のディレクトリにディスパッチする

• そのディレクトリで claude agents を開きます。
• 親ディレクトリで claude agents を開き、プロンプトで @<repo> を使用して子リポジトリをメンションします。@ を入力すると、以下の対象がリストされます。
  • 起動ディレクトリの 1 階層下にある Git リポジトリ
  • 起動元のリポジトリに登録された git worktree のうち、そのディレクトリツリー内にあるもの（Claude が .claude/worktrees/ の下に作成したものなど）。チェックアウトされたブランチでラベル付けされます。git worktree add ../feature などでリポジトリの外に追加された worktree はリストされません
  • リストに既にセッションがあるディレクトリ
  名前にスペースを含むディレクトリはリストされません。
• シェルから、そのディレクトリに cd して claude --bg "<prompt>" を実行します。

​

セッションをバックグラウンドに送信またはコピーする

​

セッションをバックグラウンドに送信する

​

/fork でセッションをコピーする

コピーにプロンプトを送信してそのセッションを開く

コピーが実行される場所

• ディスパッチされた他のセッションと同様に、コピーは ファイルを編集する前に独自の worktree に移動します。その場合、確認にはコピーが実行される場所は記載されません。
• セッションが開始後にリンクされた worktree に移動した場合、コピーは移動前にセッションがあった場所で開始され、その場で編集する 場合を除き、そこで独自の worktree を作成してコード変更を行います。元のセッションの worktree がブランチをチェックアウトしている場合、その指示には、元のセッションの作業に基づくタスクを行うコピーが新しいブランチを元のブランチに基づいて作成するよう伝える内容も含まれます。元のブランチは worktree でチェックアウトされたままだからです。確認は runs in the origin tree で終わります。
• メインの作業ツリーを持つリポジトリのリンクされた worktree 内でセッションを起動した場合、コピーはそのメインの作業ツリーで開始され、独自の worktree を作成するルールは同じですが、ブランチについての指示はありません。この場合も確認は runs in the origin tree で終わります。
• ベアリポジトリ構成の worktree 内で起動されたセッションには戻るべきメインの作業ツリーがないため、コピーはその場所にとどまり、確認は edits this checkout で終わります。リンクされた worktree 内にないセッションで worktree 分離が オフになっている 場合も、コピーが開いているファイルを編集することになるため、同じ注記が表示されます。

フォークできないセッション

​

バックグラウンドに移動するときに引き継がれるもの

• 引き継がれるもの: 実行中のバックグラウンドシェルコマンド、バックグラウンド化されたサブエージェント、/loop で作成したスケジュールタスク、および Claude の アーティファクトコメントへの自動返信 は、バックグラウンドセッションで実行を続けます。サブエージェントは自身が開始したすべてのものと一緒に移動するため、その作業のすべてが移動できる場合にのみ引き継がれます。
• Claude が再起動した場合にのみ続行されるもの: 実行中の 動的ワークフロー。バックグラウンドセッションを確認したときにワークフローが続行されていない場合は、Claude に再起動を依頼してください。
• 停止するもの: 実行中の モニター など、バックグラウンドセッションに移動できない作業。そのような作業が実行中の場合、Claude Code は Background this session? ダイアログを表示し、作業を停止する前に確認できるようにします。モニターを所有するバックグラウンド化されたサブエージェントは、モニターと一緒に停止します。

• --mcp-config と --strict-mcp-config
• --settings
• --setting-sources
• --add-dir
• --plugin-dir
• --fallback-model
• --allow-dangerously-skip-permissions

バックグラウンドに移動したときの動的ワークフロー

​

シェルからエージェントをディスパッチする

claude --bg "investigate the flaky SettingsChangeDetector test"

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

claude --resume 1f0e2c9a-6d0b-4c11-9f39-2a77c1d4e8b5 --bg "pick up where you left off and finish the migration"

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

backgrounded · 7c5dcf5d · flaky-test-fix
  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 "find out why --bg sessions are slow to start on this machine"

​

シェルコマンドを実行する

claude --bg --exec 'pytest -x'

​

ファイル編集の分離方法

• 既に開いていたセッションを ← または /background で バックグラウンドに移動した 場合。そのセッションは、既に作業していた場所でファイルの編集を続けます
• セッションが既にリンクされた git worktree 内にある場合。Claude が .claude/worktrees/ の下に作成したものか、git worktree add で別の場所に作成したものかは問いません
• Claude が編集しているファイルが、セッションまたはそのサブエージェントが git worktree add で作成したものなど、リンクされた git worktree 内にある場合
• 作業ディレクトリが git リポジトリではなく、WorktreeCreate フック も設定されていない場合
• 書き込み先が作業ディレクトリの外にある場合

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

• コミットとプッシュ: Claude は確認なしでコミットし、リポジトリにリモートがある場合はブランチをプッシュします。
• ドラフトプルリクエスト: タスクが必要とする場合、Claude はプルリクエストを作成し、行に #N ラベル が表示されます。
• 行わないこと: main または master へのプッシュ、フォースプッシュ、マージ。
• ユーザーの git に関する指示が優先されます: タスク、CLAUDE.md、または メモリ で、コミットやプッシュはユーザー自身が行うと指定されている場合、Claude は git 操作をユーザーに任せます。

​

セッションを削除すると何が削除されるか

• エージェントビューは、コミットされていない変更も含めて worktree を削除するため、残しておきたいものは先にコミットしてください。
• claude rm は、コミットされていない変更がある場合、セッションの行と一緒に worktree を保持します。
• エージェントビューも claude rm も、別の実行中のセッションが使用中またはロック中の worktree は削除せず、再度削除しても変わりません。Claude Code は worktree とセッションを保持し、保持したディレクトリとその理由を示します。エージェントビューでは、セッションの行に not deleted が表示されます。もう一方のセッションを閉じてから、再度削除してください。
• 他の場所に保存されていることを Claude Code が確認できないコミットが worktree にあるセッションを削除すると、Claude Code は worktree とセッションを保持し、メッセージには worktree のブランチと未プッシュのコミット数が示されます。メッセージには、コミットをプッシュするか、再度削除してコミットを破棄するかの 2 つの対処方法も示されます。 リモート上のコミットは削除を妨げません。origin リモートのデフォルトブランチのローカルコピー上のコミットも、そのブランチがメインチェックアウト（worktree ではなくリポジトリディレクトリ自体）でチェックアウトされている限り、削除を妨げません。 このように拒否された後は、次のいずれかを選択します。
  • コミットを残すには、プッシュするか、そのデフォルトブランチにマージしてから、セッションを再度削除します。
  • コミットを破棄するには、プッシュせずにセッションを再度削除します。エージェントビューでその行に対して Ctrl+X を 2 回押すか、拒否時に出力された claude rm <id> --discard-unpushed コマンドを実行します。これにより、セッションと worktree がそのブランチとともに削除され、未プッシュのコミットとコミットされていない変更は破棄されます。
  再度削除するとき、Claude Code は拒否時に示された内容のみを破棄します。その後 worktree に新しいコミットが追加されていた場合、Claude Code は再び worktree を保持し、更新された状態を表示します。 別の完了済みセッションの記録にもその worktree が記載されている場合、再度削除しても worktree は残ります。コミットをプッシュしてから、再度削除してください。
• git worktree prune の後など、git がもはや認識しない worktree は削除を妨げません。Claude Code はセッションを削除し、ディレクトリはディスク上に残します。
• git または WorktreeRemove フック が worktree の削除に失敗した場合、Claude Code は worktree とセッションを保持し、メッセージにその原因を示します。フックの場合、メッセージには exited 1 などの終了状況が示され、stderr の冒頭が引用されます。メッセージでは、次に行うべきことも以下から示されます。
  • セッションを再度削除して、それでもディレクトリを削除します。エージェントビューでその行に対して Ctrl+X を 2 回押すか、claude rm の拒否時に出力された claude rm <id> --force-remove-worktree <worktree-id> コマンドを実行します。worktree のブランチはリポジトリに残ります。 Claude Code がこの方法を提示するのは、以下のすべてを確認できる場合のみです。
    • ディレクトリが、.claude/worktrees/ の下にあるリポジトリのリンクされた worktree の 1 つである
    • worktree にも、チェックアウトされたサブモジュールにも、追跡対象ファイルへのコミットされていない変更がない
    • 他のセッションの記録にそのディレクトリが記載されていない
    別の git リポジトリに置き換えられたものなど、サブモジュールのチェックアウトの状態を Claude Code が確認できない場合も、この方法は提示されません。
  • コミットされていない変更をコミットまたはスタッシュする、別の git リポジトリを worktree の外に移動する、ディレクトリを使用しているものを閉じる、フックを修正するなど、障害となっているものを解消してから、セッションを再度削除します。
  • ディレクトリを自分で削除してから、セッションを再度削除します。

• エージェントビューは、ファイルを破棄する前に同じく Ctrl+X の 2 回押しを求めます。フックが作成したディレクトリの場合は、代わりに WorktreeRemove フック を実行し、そのフックがない場合は削除を拒否してセッションを保持します。
• claude rm はセッションと worktree を保持し、その理由を示します。

​

モデル、effort、fast mode を設定する

• モデル: /model <name>。例: /model opus
• effort レベル: /effort に low、medium、high、xhigh、max のいずれかを指定します。例: /effort high。ultracode でセッションを開始するには、代わりにシェルから claude agents --effort ultracode でエージェントビューを開いてください。ディスパッチ入力は /effort ultracode を受け付けません
• fast mode: /fast on または /fast off。セッションが fast mode で開始されるのは、fast mode が 利用可能 で、かつそのモデルが fast mode をサポートしている場合のみです。サポートしていないモデルでは、セッションは fast mode がオフの状態で開始されるため、まず /model で fast mode をサポートするモデル のいずれかを選択してください。新しいセッションが fast mode で開始されるかどうかは、ヘッダーではなく入力の下のヒントで確認できます。

/model opus
refactor auth
/model sonnet
run the test suite

• シェルから、claude --bg に --model を渡します。
• 実行中のセッションにアタッチして /model を実行して切り替えます。ピッカーでの選択、または入力した /model <name> は、ピッカーで s を押してセッション限定の切り替えにしない限り、新しいセッションのデフォルトとして保存されます。セッション限定の切り替えは、セッションが再生成されても維持されます。
• フロントマターで model を設定している サブエージェント を、プロンプトをその名前で始めるか @name でメンションしてディスパッチします。ディスパッチ入力での /model の選択が適用されている間はサブエージェントの model は使用されないため、そこで /model default を入力してください。claude agents --model で起動した場合もサブエージェントの model は使用されないため、シェルで --model を付けずに claude agents を実行してください。

​

権限モード、モデル、effort

​

設定とプロバイダー

​

LLM ゲートウェイ

• ← または /background で自分のセッションをバックグラウンドに移動する場合
• 現在いるディレクトリにセッションをディスパッチする場合
• 現在いるディレクトリの停止したセッションに、アタッチまたは返信して起動する場合
• 現在いるディレクトリのセッションを claude respawn で再起動する場合

​

権限モード

• /bg または ← でバックグラウンドに移動した場合: Claude Code はセッションの 権限モード を維持するため、acceptEdits や auto に切り替えていたセッションは、デタッチ後もそのモードのままです
• シェルで開始した claude agents から、または claude --bg でディスパッチした場合: ディスパッチのデフォルト を指定して開いたエージェントビューからディスパッチした場合を除き、新しいセッションはそのディレクトリで新しい claude セッションを開始した場合と同じように開始されます。順序は セッションがどの権限モードで開始されるか に記載されています

1. 対象ディレクトリの permissions.defaultMode。auto と bypassPermissions は、管理設定、--settings ファイル、または ~/.claude/settings.json からのみ有効になります。Claude Code は、プロジェクトの .claude/settings.json または .claude/settings.local.json の defaultMode が、移動元のセッションのモードより許容度の高いモードを選択している場合、それを拒否します。
2. 移動元のセッションの権限モード。 そのセッションが bypassPermissions モードだった場合、新しいセッションは代わりに Manual モードで開始され、Bypass permissions was requested at launch and ignored という通知が表示されることがあります。これは、バイパスの免責事項への同意が .claude/settings.local.json または --settings ファイルにのみ記録されている場合に発生します。Manual モードのまま続行するか、その同意を ~/.claude/settings.json に追加してください。

​

ディスパッチのデフォルト

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

​

再起動後も維持されるもの

​

設定、プラグイン、MCP サーバー

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

​

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

​

セッションを JSON として一覧表示

​

スクリプトからセッション状態を読み取る

​

バックグラウンドセッションのホスト方法

​

スーパーバイザープロセス

• 作業中、権限プロンプトやその他のダイアログで一時停止中、またはアタッチ中：プロセスは実行を続けます。実行中のサブエージェント、ワークフロー、モニターは作業中とみなされ、/loop のウェイクアップなど保留中のセッションスコープのスケジュールタスクも同様です。
• 完了済み、または次のメッセージを待機中で、約 1 時間アタッチされていない：スーパーバイザーはリソースを解放するためにプロセスを停止します。質問をしてターンを終えたセッションは、次のメッセージを待機中とみなされます。会話はディスク上に残り、次にアタッチまたは返信すると、セッションは中断したところから再開します。プロセスを実行し続けるには、Ctrl+T でセッションをピン留めします。
• スーパーバイザーの実行中にセッションのプロセスが予期せず終了した：スーパーバイザーがそのプロセスを再起動します。← または /background で自分でバックグラウンドに送ったセッションを、たとえば kill で終了した場合は、再起動されずに停止済みとしてマークされます。シャットダウンによって終了したセッションについては、シャットダウン後にセッションが失敗または停止と表示されるを参照してください。
• 自動更新の後：スーパーバイザーは新しいバージョンで自身を再起動し、アイドル状態のセッションをバックグラウンドで移行します。作業中、ユーザーの応答待ち、またはアタッチ中のセッションは中断されません。
• スーパーバイザー自体が停止した（たとえば、そのプロセスが Claude Code の外部から終了された場合）：macOS と Linux では、約 1 分以内に新しいスーパーバイザーが接続しない限り、セッションは停止します。スーパーバイザーを起動するには、シェルで claude agents を実行します。その 1 分を過ぎた場合は、スーパーバイザー停止後もセッションを実行し続けるを参照してください。

​

スーパーバイザー停止後もセッションを実行し続ける

Background sessions still running will stop in about a minute. Run 'claude agents' to keep them.

​

状態の保存場所

​

エージェントビューをオフにする

​

トラブルシューティング

​

claude agents がエージェントビューを開く代わりにサブエージェントをリストする

​

エージェントビューがセッションなしで開く

​

バックグラウンド化が Background this session? ダイアログを表示する

• 移動できない作業：セッションには、実行中の モニター など、バックグラウンドセッションに移動できない作業があります。ダイアログは Claude Code が停止するバックグラウンド作業を名前で表示し、転送されるタスクは別にカウントします。
• 実行中のサブエージェントを持つワークフロー：動的ワークフローにはまだ実行中のサブエージェントがあります。それでもバックグラウンド化すると、それらのサブエージェントは停止し、ダイアログはその数を表示します。Claude がバックグラウンドセッションでワークフローを再起動すると、それらのサブエージェントは最初からやり直します。
• 自動アーティファクト返信：Claude がアーティファクトのコメントに自動で返信している場合があります。これらの返信はバックグラウンドセッションで続行され、ダイアログはそのことを表示します。

​

会話にバックグラウンドエージェントが was carried into this session and not resumed と表示される

​

プロンプトが短すぎるとして拒否される

​

シャットダウン後、セッションが失敗または停止として表示される

• 48 時間以内の場合、セッションは失敗として表示されます。アタッチまたは返信すると、保存された会話から再開します。中断した作業を再開するには、続行を求める返信を送信してください。
• 48 時間以上経過した場合（マシンが数日間オフになっていた後など）、セッションは ended while the background service was off として停止として表示されます。行で Enter を押すと、フッターに Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it. が表示されます。同じ行で再度 Enter を押して、保存された会話を再開します。返信または claude attach <id> でそのフッタープロンプトなしで再開します。

​

セッションを開くと、会話が既に開いていると表示される

• 例えば claude --resume または /resume で会話を再開したターミナル：行は Open in a terminal を表示し、そこで続行するというヒントが表示され、行を開くと Can't open — this session is running in another terminal が表示されます。そのターミナルで続行するか、終了して行を再度開きます。
• 別の非インタラクティブ Claude Code プロセス（例えば、同じ会話のバックグラウンドセッションプロセスがまだ終了していない）：行を開くと This conversation is already open in another running Claude session が表示されます。そのプロセスを使用するか、終了するまで待機して行を再度開きます。

​

セッションを開くと、保存されたトランスクリプトがないと表示される

• claude attach は This session has no saved transcript を出力します。
• エージェントビューでは、リストの下に Press enter again to restart this session fresh が表示されます。

​

ターミナルホストが停止したか、セッションが応答しなくなった

​

セッションが possibly low memory ノートで開始前に失敗する

​

エージェントビューがバックグラウンドサービスが応答しなかったと表示される

claude daemon stop --any --keep-workers

​

ディスパッチが Could not resolve authentication method で失敗する

claude daemon stop --any --keep-workers

​

バックグラウンドセッションに No LLM gateway と表示される

• ターミナルでゲートウェイをエクスポートした場合：ゲートウェイ変数をエクスポートしたターミナルで、メッセージに示されたフォルダに cd し、メッセージにある claude respawn <id> コマンドを実行します。
  • ゲートウェイがセッションに届くのは、スーパーバイザー自体が同じゲートウェイをエクスポートしたシェルから起動された場合のみです。そうでない場合は、ディスパッチが Could not resolve authentication method で失敗するの説明に従って、respawn コマンドを実行したターミナルからスーパーバイザーを再起動し、そのコマンドを再度実行します。
• 設定でゲートウェイを指定しているプロジェクトでエージェントビューを使用した場合：ANTHROPIC_BASE_URL とその認証情報を設定ファイルの env ブロックに記述します。~/.claude/settings.json、またはセッション自体のプロジェクト内の .claude/settings.local.json を使用してください。どちらも respawn されたセッションが読み取ります。その後、任意のディレクトリからシェルで claude respawn <id> を実行して、このセッションをゲートウェイ経由で再起動します。

​

macOS でバックグラウンドセッションが Desktop、Documents、または Downloads を読み取ることができない

​

macOS でバックグラウンドセッションがローカルネットワークホストに到達できない

​

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

​

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

​

制限事項

• レート制限が適用される：バックグラウンドセッションはインタラクティブセッションと同じようにサブスクリプション使用量を消費するため、10 個のエージェントを並行して実行するとクォータが 10 倍速く消費されます。
• セッションはローカル：バックグラウンドセッションはマシンで実行され、スリープ中は保持されますが、マシンがシャットダウンすると停止します。
• Claude が作成した worktrees はエージェント view のセッションで削除される：セッションが独自の worktree でファイルを編集した場合、セッションを削除する前に変更をコミットしてください。削除によって worktree が保持される場合もあります。

​

関連リソース

• エージェントを並列実行：エージェントビューとサブエージェント、エージェントチーム、ワークツリーを比較
• クロスセッションメッセージング：セッション間で検出結果を相互に渡す
• Agent teams：互いにメッセージを送信する複数のセッションを調整
• Claude Code on the web：ローカルではなく、マネージドクラウド環境でセッションを実行
• Projects：Claude が 1 つの会話から並列クラウドセッションを調整し、どのセッションが必要かを通知します

​

バージョン履歴