8 8
9`claude agents` で開くエージェントビューは、すべてのバックグラウンドセッションの 1 つの画面です。実行中のもの、入力が必要なもの、完了したものが表示されます。新しいセッションをディスパッチし、トランスクリプトをスクロールする代わりに一目でセッションの状態を確認し、セッションが必要とするときだけ介入します。各バックグラウンドセッションは完全な Claude Code の会話であり、ターミナルが接続されていなくてもバックグラウンドで実行し続けるため、いつでも開いて、返信して、去ることができます。9`claude agents` で開くエージェントビューは、すべてのバックグラウンドセッションの 1 つの画面です。実行中のもの、入力が必要なもの、完了したものが表示されます。新しいセッションをディスパッチし、トランスクリプトをスクロールする代わりに一目でセッションの状態を確認し、セッションが必要とするときだけ介入します。各バックグラウンドセッションは完全な Claude Code の会話であり、ターミナルが接続されていなくてもバックグラウンドで実行し続けるため、いつでも開いて、返信して、去ることができます。
10 10
11<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-light.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=7a186c96ed47d6700d084d77e786be65" className="dark:hidden" alt="ターミナルのエージェントビュー：ヘッダーは Claude Code v2.1.140、モデル、作業ディレクトリ、および概要カウントを表示します。セッションは'入力が必要'、'実行中'、'完了'の下にグループ化され、下部にディスパッチ入力とキーボードヒントのフッターがあります。" width="1772" height="780" data-path="images/agent-view-light.png" />11<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-light.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=7a186c96ed47d6700d084d77e786be65" className="dark:hidden" alt="ターミナルのエージェントビュー：ヘッダーは Claude Code v2.1.140、モデル、作業ディレクトリ、および概要カウントを表示します。セッションは「入力が必要」、「実行中」、「完了」の下にグループ化され、下部にディスパッチ入力とキーボードヒントのフッターがあります。" width="1772" height="780" data-path="images/agent-view-light.png" />
12 12
13<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-dark.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=a5bed7434bae368faea3a8f023b52aa2" className="hidden dark:block" alt="ターミナルのエージェントビュー：ヘッダーは Claude Code v2.1.140、モデル、作業ディレクトリ、および概要カウントを表示します。セッションは'入力が必要'、'実行中'、'完了'の下にグループ化され、下部にディスパッチ入力とキーボードヒントのフッターがあります。" width="1772" height="780" data-path="images/agent-view-dark.png" />13<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-dark.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=a5bed7434bae368faea3a8f023b52aa2" className="hidden dark:block" alt="ターミナルのエージェントビュー：ヘッダーは Claude Code v2.1.140、モデル、作業ディレクトリ、および概要カウントを表示します。セッションは「入力が必要」、「実行中」、「完了」の下にグループ化され、下部にディスパッチ入力とキーボードヒントのフッターがあります。" width="1772" height="780" data-path="images/agent-view-dark.png" />
14 14
15Claude が複数の独立したタスクに対して、あなたが毎ステップを監視することなく作業できる場合に、エージェントビューを使用します。バグ修正、プルリクエストレビュー、不安定なテストの調査を 3 つの行としてディスパッチし、別のウィンドウで作業を続け、行が入力が必要であることを示すか、結果が得られたときに確認します。15Claude が複数の独立したタスクに対して、あなたが毎ステップを監視することなく作業できる場合に、エージェントビューを使用します。バグ修正、プルリクエストレビュー、不安定なテストの調査を 3 つの行としてディスパッチし、別のウィンドウで作業を続け、行が入力が必要であることを示すか、結果が得られたときに確認します。
16 16
19エージェントビューを subagents、agent teams、worktrees と比較するには、[エージェントを並列で実行する](/docs/ja/agents)を参照してください。19エージェントビューを subagents、agent teams、worktrees と比較するには、[エージェントを並列で実行する](/docs/ja/agents)を参照してください。
20 20
21<Note>21<Note>
22 エージェントビューはリサーチプレビューであり、Claude Code v2.1.139 以降が必要です。`claude --version` でバージョンを確認してください。インターフェースとキーボードショートカットは機能の進化に伴って変更される可能性があります。22 エージェントビューはリサーチプレビュー中です。インターフェースとキーボードショートカットは機能の進化に伴って変更される可能性があります。
23</Note>23</Note>
24 24
25このページでは以下をカバーしています。
26
27* [クイックスタート](#quick-start)：Claude にバックグラウンドで作業するタスクを与え、確認し、必要なときに介入する
28* [エージェントビューでセッションを監視する](#monitor-sessions-with-agent-view)。状態アイコン、ピーク表示と返信、アタッチ、整理、キーボードショートカットを含みます
29* [新しいエージェントをディスパッチする](#dispatch-new-agents)。エージェントビューから、セッション内から、またはシェルから
30* [シェルからセッションを管理する](#manage-sessions-from-the-shell)。`claude agents`、`claude attach`、および関連コマンドを使用して
31* [バックグラウンドセッションがどのようにホストされるか](#how-background-sessions-are-hosted)。スーパーバイザープロセスによって
32
33<h2 id="quick-start">25<h2 id="quick-start">
34 クイックスタート26 クイックスタート
35</h2>27</h2>
44 claude agents36 claude agents
45 ```37 ```
46 38
47 エージェントビューが開き、下部に入力フィールドが表示され、セッションが開始されるとテーブルが埋まります。いつでも `Esc` を押してシェルに戻ります。セッションは離れている間も実行し続け、次にエージェントビューを開いたときに再度表示されます。39 まだディレクトリの[ワークスペーストラストダイアログ](/docs/ja/permissions#project-allow-rules-and-workspace-trust)を受け入れていない場合、Claude Code はエージェントビューが開く前にそれを表示します。これは `claude` が表示するのと同じダイアログです。受け入れてワークスペースの信頼を保存して続行します。拒否すると、Claude Code はエージェントビューを開かずに終了します。
40
41 エージェントビューが開き、下部に入力フィールドが表示され、セッションが開始されるとテーブルが埋まります。いつでも `Esc` を押してシェルに戻ります。`←` でセッションをバックグラウンドにして開いた場合、`Esc` はそのセッションの会話に戻ります。セッションは離れている間も実行し続け、次にエージェントビューを開いたときに再度表示されます。
48 </Step>42 </Step>
49 43
50 <Step title="セッションをディスパッチする">44 <Step title="セッションをディスパッチする">
51 タスクを説明するプロンプトを入力して `Enter` を押します。新しいバックグラウンドセッションがそのタスクで開始され、作業中か、入力を待機中か、完了しているかを示す行として表示されます。新しいセッションはエージェントビューヘッダーに表示されているモデルと、そのディレクトリで `claude` を実行する場合と同じ[権限モード](#permission-mode-model-and-effort)を使用します。45 タスクを説明するプロンプトを入力して `Enter` を押します。新しいバックグラウンドセッションがそのタスクで開始され、作業中か、入力を待機中か、完了しているかを示す行として表示されます。新しいセッションはエージェントビューヘッダーに表示されているモデルを使用します。[どの権限モードで開始するか](#permission-mode-model-and-effort)は、エージェントビューをどのように開いたかによって異なります。
52 46
53 ここで入力するすべてのプロンプトは独自の新しいセッションを開始します。別のプロンプトを入力して `Enter` を押すと、最初のセッションへのフォローアップを送信するのではなく、最初のセッションと並行して 2 番目のセッションが起動します。この方法で複数を並行して実行できます。47 ここで入力するすべてのプロンプトは独自の新しいセッションを開始します。別のプロンプトを入力して `Enter` を押すと、最初のセッションへのフォローアップを送信するのではなく、最初のセッションと並行して 2 番目のセッションが起動します。この方法で複数を並行して実行できます。
54 48
64 </Step>58 </Step>
65 59
66 <Step title="既存のセッションを持ち込む">60 <Step title="既存のセッションを持ち込む">
67 このステップは実行中のセッションが必要です。前のステップに従った場合、このターミナルで開いているセッションはないため、別のターミナルで通常の `claude` セッションを開き、最初にメッセージを送信してください。既に開いているセッションをエージェントビューに移動するには、セッション内で `/bg` を実行するか、空のプロンプトで `←` を押してセッションをバックグラウンドにし、1 ステップでエージェントビューを開きます。セッションは実行し続け、ディスパッチしたセッションと並行して行として表示されます。61 このステップは実行中のセッションが必要です。前のステップに従った場合、このターミナルで開いているセッションはないため、別のターミナルで通常の `claude` セッションを開き、最初にメッセージを送信してください。
62
63 既に開いているセッションをエージェントビューに移動するには、セッション内で `/bg` を実行するか、空のプロンプトで `←` を押してセッションをバックグラウンドにし、1 ステップでエージェントビューを開きます。メッセージがまだない新しいセッションでは、`/bg` はメッセージを最初に送信するよう求めますが、`←` はすぐに機能します。セッションは実行し続け、ディスパッチしたセッションと並行して行として表示されます。
68 </Step>64 </Step>
69</Steps>65</Steps>
70 66
71`claude agents` を `claude` の代わりにプライマリエントリーポイントとして使用できます。エージェントビューからすべてのタスクをディスパッチし、フル会話が必要な場合はアタッチし、`←` を押してテーブルに戻ります。67`claude agents` を `claude` の代わりにプライマリエントリーポイントとして使用できます。エージェントビューからすべてのタスクをディスパッチし、フル会話が必要な場合はアタッチし、`←` を押してテーブルに戻ります。
72 68
73通常の `claude` セッション内では、プロンプトフッターの `←` ヒントは、`← 2 agents` のように入力を待機中のバックグラウンドエージェントの数をカウントし、入力が必要なエージェントがない場合は `← for agents` に戻ります。99 を超えるカウントは `99+` として表示されます。カウントはターミナルがフォーカスされている間は約 10 秒ごとに更新され、フォーカスが戻ると即座に更新されます。カウントが移動したときとエージェントが完了したときに色が一時的に変わります。ただし、[`prefersReducedMotion` 設定](/docs/ja/settings#available-settings)がオンの場合は除きます。また、[スクリーンリーダーモード](/docs/ja/accessibility)では非表示になります。[Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry](/docs/ja/third-party-integrations)では、ヒントはカウントなしの通常の `← for agents` 形式のままです。Claude Code v2.1.205 以降が必要です。69通常の `claude` セッション内では、プロンプトフッターの `←` ヒントは、`← 2 agents` のように入力を待機中のバックグラウンドエージェントの数をカウントし、入力が必要なエージェントがない場合は `← for agents` に戻ります。99 を超えるカウントは `99+` として表示されます。カウントはターミナルがフォーカスされている間は約 10 秒ごとに更新され、フォーカスが戻ると即座に更新されます。カウントが移動したときとエージェントが完了したときに色が一時的に変わり、バックグラウンドセッションが完了して入力が必要なエージェントがない場合は、`← 2 done` のように完了した数を一時的に表示します。[`prefersReducedMotion` 設定](/docs/ja/settings-reference#prefersreducedmotion)がオンの場合は両方のフラッシュがオフになり、[スクリーンリーダーモード](/docs/ja/accessibility)ではヒントは非表示になります。
74 70
75<h2 id="monitor-sessions-with-agent-view">71<h2 id="monitor-sessions-with-agent-view">
76 エージェントビューでセッションを監視する72 エージェントビューでセッションを監視する
78 74
79`claude agents` を実行してエージェントビューを開きます。ターミナル全体を占有し、状態でグループ化されたすべてのセッションをリストします。ピン留めされたセッションと入力が必要なセッションが上部に表示されます。各行はセッションの名前、現在のアクティビティ、およびセッションが作成されてからの経過時間を表示します。完了したセッションの経過時間は、実行にかかった時間で固定されます。75`claude agents` を実行してエージェントビューを開きます。ターミナル全体を占有し、状態でグループ化されたすべてのセッションをリストします。ピン留めされたセッションと入力が必要なセッションが上部に表示されます。各行はセッションの名前、現在のアクティビティ、およびセッションが作成されてからの経過時間を表示します。完了したセッションの経過時間は、実行にかかった時間で固定されます。
80 76
81名前は、そのセッションで [`/color`](/docs/ja/commands) によって設定されたカラーで色付けされます。v2.1.199 以降、`←` または `/background` で [セッションをバックグラウンドにする](#from-inside-a-session) ときにカラーが引き継がれます。77名前は、そのセッションで [`/color`](/docs/ja/commands) によって設定されたカラーで色付けされます。`←` または `/background` で [セッションをバックグラウンドにする](#from-inside-a-session) ときにカラーが引き継がれます。
82 78
83デフォルトでは、リストはすべてのプロジェクト全体で開始したすべてのバックグラウンドセッションを表示します。1 つのリポジトリで作業しているセッションと別のワークツリーで作業している別のセッションの両方がここに表示されます。エージェントビューを開いたディレクトリに関係なく表示されます。リストを 1 つのプロジェクトに絞り込むには、`--cwd` を渡します：79デフォルトでは、リストはすべてのプロジェクト全体で開始したすべてのバックグラウンドセッションを表示します。1 つのリポジトリで作業しているセッションと別のワークツリーで作業している別のセッションの両方がここに表示されます。エージェントビューを開いたディレクトリに関係なく表示されます。リストを 1 つのプロジェクトに絞り込むには、`--cwd` を渡します：
84 80
117各行は、セッションの状態を示すアイコンで始まります。アイコンの色とアニメーションはセッションの状態を示します：113各行は、セッションの状態を示すアイコンで始まります。アイコンの色とアニメーションはセッションの状態を示します：
118 114
119| 状態 | アイコン表示 | 意味 |115| 状態 | アイコン表示 | 意味 |
120| :---- | :------ | :----------------------------------------- |116| :---- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
121| 作業中 | アニメーション | Claude がアクティブにツールを実行しているか、応答を生成しています |117| 作業中 | アニメーション | Claude がアクティブにツールを実行しているか、応答を生成しています |
122| 入力が必要 | 黄色 | Claude は特定の質問または許可決定をあなたから待機しています |118| 入力が必要 | 黄色 | Claude は特定の質問または許可決定をあなたから待機しています。あなたのみが提供できる答え、許可決定、または別のプロンプト。例えば [サンドボックス](/docs/ja/sandboxing) プロンプトでネットワークホストを許可するか、MCP サーバーの [入力リクエストに応答する](/docs/ja/mcp#respond-to-mcp-elicitation-requests)。アタッチされたターミナルが必要なコマンド。例えば `/install-github-app` または `/mcp` 設定リスト。[ここで無人セッションを保持します](#attach-to-a-session) |
123| アイドル | 薄い | セッションはすることがなく、次のプロンプトの準備ができています |119| アイドル | 薄い | セッションはすることがなく、次のプロンプトの準備ができています |
124| 完了 | 緑 | タスクが正常に完了しました |120| 完了 | 緑 | タスクが正常に完了しました |
125| 失敗 | 赤 | タスクがエラーで終了しました |121| 失敗 | 赤 | タスクがエラーで終了しました |
126| 停止 | グレー | セッションは `Ctrl+X` または `claude stop` で停止されました |122| 停止 | グレー | セッションは `Ctrl+X` または `claude stop` で停止されました。[そのプロセスは Claude Code の外から終了されました](#the-supervisor-process)。または [バックグラウンドサービスがオフの間に終了しました](#sessions-show-as-failed-after-shutdown) |
127 123
128別に、アイコンの形状は基盤となるプロセスが実行しているかどうかを示します：124別に、アイコンの形状は基盤となるプロセスが実行しているかどうかを示します：
129 125
133| `∙` | プロセスは終了しました。ピーク表示、返信、またはアタッチはできます。Claude は中断したところから再開します |129| `∙` | プロセスは終了しました。ピーク表示、返信、またはアタッチはできます。Claude は中断したところから再開します |
134| `✢` | [`/loop`](/docs/ja/scheduled-tasks) セッションはイテレーション間でスリープしています。行は実行回数とカウントダウンを表示します |130| `✢` | [`/loop`](/docs/ja/scheduled-tasks) セッションはイテレーション間でスリープしています。行は実行回数とカウントダウンを表示します |
135 131
136行の右端に表示される `#N` ラベルは [セッションが開いたプルリクエスト](#pull-request-status) であり、状態アイコンの一部ではありません。132行の右端に表示される `#N` または `!N` ラベルは [セッションのプルリクエストまたはマージリクエスト](#pull-request-status) へのリンクであり、状態アイコンの一部ではありません。
137 133
138ターミナルタブのタイトルは、エージェントビューが開いている間、待機中の入力カウントを表示します。セッションが入力を必要とする場合は `2 awaiting input · claude agents`、そうでない場合は `claude agents` です。134ターミナルタブのタイトルは、エージェントビューが開いている間、待機中の入力カウントを表示します。セッションが入力を必要とする場合は `2 awaiting input · claude agents`、そうでない場合は `claude agents` です。
139 135
140v2.1.198 以降、エージェントビューが開いている間、Claude Code はローカルバックグラウンドセッションが入力を必要とし始めたとき、完了したとき、または失敗したときに、設定された [ターミナル通知チャネル](/docs/ja/terminal-config#get-a-terminal-bell-or-notification) を通じて通知を送信します。[`/loop`](/docs/ja/scheduled-tasks) セッションなどのスケジュールで実行されるセッションは、入力が必要な場合にのみ通知します。通知は Claude Code の残りの部分と同じ [`preferredNotifChannel` 設定](/docs/ja/settings#available-settings) を使用し、`agent_needs_input` または `agent_completed` タイプで [`Notification` フック](/docs/ja/hooks#notification) を発火します。136スクリプトまたは別のプログラムからセッション状態を読み取るには、`~/.claude/jobs/` の下のファイルではなく [`claude agents --json`](#read-session-state-from-a-script) を使用します。
137
138エージェントビューが開いている間、Claude Code はローカルバックグラウンドセッションが入力を必要とし始めたとき、完了したとき、または失敗したときに、設定された [ターミナル通知チャネル](/docs/ja/terminal-config#get-a-terminal-bell-or-notification) を通じて通知を送信します。[`/loop`](/docs/ja/scheduled-tasks) セッションなどのスケジュールで実行されるセッションは、入力が必要な場合にのみ通知します。通知は Claude Code の残りの部分と同じ [`preferredNotifChannel` 設定](/docs/ja/settings-reference#preferrednotifchannel) を使用し、`agent_needs_input` または `agent_completed` タイプで [`Notification` フック](/docs/ja/hooks#notification) を発火します。
141 139
142バックグラウンドセッションは作業を続けるためにターミナルを開く必要がありません。別の [スーパーバイザープロセス](#the-supervisor-process) がセッションを実行するため、エージェントビューを閉じたり、シェルを閉じたり、新しいインタラクティブセッションを開始したりしても、ディスパッチされた作業は続きます。140バックグラウンドセッションは作業を続けるためにターミナルを開く必要がありません。別の [スーパーバイザープロセス](#the-supervisor-process) がセッションを実行するため、エージェントビューを閉じたり、シェルを閉じたり、新しいインタラクティブセッションを開始したりしても、ディスパッチされた作業は続きます。
143 141
144セッション状態はディスク上に永続化され、自動更新とスーパーバイザー再起動を通じて保存されます。セッションはマシンがスリープするときも保存されます。プロセスはウェイク時に再開され、スーパーバイザーはアイドルとして時間ギャップを扱う代わりにそれらに再接続します。シャットダウンはまだ実行中のセッションを停止します。[シャットダウン後にセッションが失敗として表示される](#sessions-show-as-failed-after-shutdown) を参照して、それらを復旧する方法を確認してください。142セッション状態はディスク上に永続化され、自動更新とスーパーバイザー再起動を通じて保存されます。セッションはマシンがスリープするときも保存されます。プロセスはウェイク時に再開され、スーパーバイザーはアイドルとして時間ギャップを扱う代わりにそれらに再接続します。シャットダウンはまだ実行中のセッションを停止します。[シャットダウン後にセッションが失敗として表示される](#sessions-show-as-failed-after-shutdown) を参照して、それらを復旧する方法を確認してください。
145 143
146応答しなくなったセッションを開くと、スーパーバイザーはそのプロセスを再起動し、セッションは中断した応答を中断したところから続行します。マシンがスリープしている間に応答の途中でセッションがその状態になる可能性があります。Claude Code v2.1.200 以降が必要です。144応答しなくなったセッションを開くと、スーパーバイザーはそのプロセスを再起動し、セッションは中断した応答を中断したところから続行します。マシンがスリープしている間に応答の途中でセッションがその状態になる可能性があります。
147 145
148<h3 id="row-summaries">146<h3 id="row-summaries">
149 行の概要147 行の概要
151 149
152各行の 1 行の概要は [Haiku クラスモデル](/docs/ja/model-config) によって生成されるため、トランスクリプトを開かずにセッションが何をしているか、何が必要か、または何を生成したかを伝えることができます。セッションがアクティブに作業している間、行テキストはセッション自身の最近の出力から最大 15 秒ごとに 1 回更新され、モデルリクエストを送信せず、各ターンが終了したときに新しい概要を書きます。150各行の 1 行の概要は [Haiku クラスモデル](/docs/ja/model-config) によって生成されるため、トランスクリプトを開かずにセッションが何をしているか、何が必要か、または何を生成したかを伝えることができます。セッションがアクティブに作業している間、行テキストはセッション自身の最近の出力から最大 15 秒ごとに 1 回更新され、モデルリクエストを送信せず、各ターンが終了したときに新しい概要を書きます。
153 151
154作業中の行はセッションが何をしているかを示し、ブロックされた行は質問を示します。長いターンの間、モデルは約 1 分ごとに概要を書き直し、各書き直しの後に 2 倍待機して最大 4 分まで待機するため、ビジーな行は古い概要を表示し続けません。概要テキストは行の残りの幅を埋め、ターミナルの右端でのみ切り詰められます。[ピークパネル](#peek-and-reply) を開いてエッジが切り詰める文を読みます。v2.1.205 より前では、作業中の行は生のツール呼び出しの代わりにレポートを表示でき、並列作業項目を実行しているセッションはテキストの前に `2/5` などの `done/total` カウントを表示していました。152作業中の行はセッションが何をしているかを示し、ブロックされた行は質問を示します。長いターンの間、モデルは数分ごとに概要を書き直し、ビジーな行は古い概要を表示し続けません。概要テキストは行の残りの幅を埋め、ターミナルの右端でのみ切り詰められます。[ピークパネル](#peek-and-reply) を開いてエッジが切り詰める文を読みます。
155 153
156概要テキストは行の残りの幅を埋め、ターミナルの右端でのみ切り詰められます。[ピークパネル](#peek-and-reply) を開いてエッジが切り詰める文を読みます。v2.1.206 より前では、テキストはターミナル幅に関係なく 64 列で切り詰められていました。154リストが [ディレクトリでグループ化](#organize-the-list) されている場合、概要はセッションの状態を色付きの単語で開きます。例えば `Needs input · double jump or wall climb?` のようになります。デフォルトの状態グループ化では、グループヘッダーはすでに状態を名前付けするため、行は概要のみを表示します。
157 155
158リストが [ディレクトリでグループ化](#organize-the-list) されている場合、概要はセッションの状態を色付きの単語で開きます。例えば `Needs input · double jump or wall climb?` のようになります。デフォルトの状態グループ化では、グループヘッダーはすでに状態を名前付けするため、行は概要のみを表示します。v2.1.205 より前では、ディレクトリでグループ化された行は状態の単語を持ちませんでした。156ターン終了時の概要と各ミッドターン書き直しは、通常のプロバイダーを通じた 1 つの短い Haiku クラスリクエストであり、セッション自体と同じ [データ使用条件](/docs/ja/data-usage) の下で請求および処理されます。15 秒の更新はモデル書き直しの間にセッション自身の出力を再利用し、リクエストを送信しません。Haiku クラスモデルが設定されていないサードパーティプロバイダーまたはゲートウェイでは、リクエストはセッションのメインモデルを使用します。[`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/ja/model-config#environment-variables) を設定して選択します。
159
160出力全体に文字または数字が含まれていないターン。例えば [`/loop`](/docs/ja/scheduled-tasks) セッションが静かなイテレーションで単一の記号を出力する場合、行は前の概要と状態を保持します。v2.1.205 より前では、そのターンは再分類され、入力を待機していたセッションを `Working` に戻す可能性がありました。
161
162ターン終了時の概要と各ミッドターン書き直しは、通常のプロバイダーを通じた 1 つの短い Haiku クラスリクエストであり、セッション自体と同じ [データ使用条件](/docs/ja/data-usage) の下で請求および処理されます。15 秒の更新はモデル書き直しの間にセッション自身の出力を再利用し、リクエストを送信しません。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、カスタムゲートウェイなどのサードパーティプロバイダーでは、Haiku モデルが設定されていない場合、リクエストはセッションのメインモデルにフォールバックします。これらのプロバイダーでこれらの概要のモデルを選択するには、[`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/ja/model-config#environment-variables) を設定します。
163 157
164<h3 id="pull-request-status">158<h3 id="pull-request-status">
165 プルリクエストステータス159 プルリクエストステータス
166</h3>160</h3>
167 161
168セッションがプルリクエストを開くと、`#1234` ラベルが行の右端に表示され、ハイパーリンクをサポートするターミナルではプルリクエストにリンクされます。セッションにフォローアップを送信するときもラベルは保存されるため、行がライブプログレスに戻るときもプルリクエストは表示されたままです。ワークツリーで変更を分離したバックグラウンドセッションはこれらのプルリクエストを自分で開きます。[ファイル編集がどのように分離されるか](#how-file-edits-are-isolated) はそれが起こるときと、セッションが尋ねずに何をしないかをカバーしています。162セッションが [プルリクエストを開く](#how-file-edits-are-isolated) と、Claude Code は行の右端にラベルを追加し、プルリクエストにリンクします：
169 163
170既存のプルリクエストで作業しているセッションは同じ方法でリンクされます。`gh` でプルリクエストを編集、コメント、クローズ、またはマージ準備完了にマークすると、コマンド自身の出力が名前付けするプルリクエストがリンクされるため、キャプチャされた出力がプルリクエストを名前付けしない `gh` コマンドはリンクを作成しません。`gh pr merge` は一般的なケースです。なぜなら、結果をインタラクティブターミナルにのみ出力するためです。`gh pr checkout` でプルリクエストをチェックアウトするか、オープンなプルリクエストを持つブランチにプッシュすると、代わりに `gh pr view` でそのブランチを検索してリンクします。v2.1.205 より前では、セッションが作成またはチェックアウトしたプルリクエストのみがリンクされ、プッシュはローカルブランチ名が一致した場合にのみリンクされました。164* Claude Code はラベルを `#1234` としてプルリクエストに、`!1234` として GitLab マージリクエストに書き込みます。
165* Claude Code はハイパーリンクサポートを検出できない場合でもリンクを出力します。例えば SSH または tmux 経由。[`FORCE_HYPERLINK=0`](/docs/ja/env-vars) を設定してラベルをプレーンテキストとしてレンダリングします。
166* セッションにフォローアップを送信した後、Claude Code はラベルを保持し、行がライブプログレスに戻ります。
171 167
172Claude Code はコマンド出力全体からプルリクエストを読み取ります。コマンドの出力がインライン制限を超えた場合、ファイルに保存された部分を含みます。v2.1.205 より前では、出力が約 30,000 文字を超えた Bash 呼び出しで作成されたプルリクエストはリンクされませんでした。168既存のプルリクエストで作業しているセッションは同じ方法でリンクされます。Claude Code はコマンド Claude が実行するかに応じて異なる方法でプルリクエストを検出します：
169
170* Claude が `gh` でプルリクエストを編集、コメント、クローズ、またはマージ準備完了にマークすると、Claude Code はコマンド自身の出力が名前付けするプルリクエストをリンクします。キャプチャされた出力がプルリクエストを名前付けしない `gh` コマンドはリンクを作成しません。`gh pr merge` は一般的なケースです。なぜなら、結果をインタラクティブターミナルにのみ出力するためです。
171* Claude が `gh pr checkout` でプルリクエストをチェックアウトするか、ブランチにプッシュすると、Claude Code は `gh pr view` でブランチを検索してオープンなプルリクエストをリンクします。
172* プルリクエストは Claude がプッシュするときにまだ存在する必要はありません。Claude Code は同じディレクトリで最大 5 つの後の `git`、`gh`、`glab`、または `curl` コマンドが実行された後、ブランチ検索を再試行します。GitHub REST API を通じて Claude が作成したものを含む、後で作成されたプルリクエストは、再試行がそれを見つけるときにリンクします。
173 173
174セッションが複数のプルリクエストにリンクされている場合、ラベルはカウントを表示します。例えば `3 PRs` のようになり、最も注意が必要なオープンプルリクエストで色付けされます。[ピークパネル](#peek-and-reply) を開いてすべてを表示します。174セッションが複数のプルリクエストにリンクされている場合、ラベルはカウントを表示します。例えば `3 PRs` のようになり、最も注意が必要なオープンプルリクエストで色付けされます。[ピークパネル](#peek-and-reply) を開いてすべてを表示します。
175 175
182| 紫 | マージ済み |182| 紫 | マージ済み |
183| グレー | ドラフトまたはクローズ |183| グレー | ドラフトまたはクローズ |
184 184
185ほとんどのタスクでは、この列が結果を収集する場所です。プルリクエスト番号が緑になったときにプルリクエストをレビューしてマージします。185タスクがプルリクエストで終了する場合、このラベルで結果を確認します。プルリクエスト番号が緑になったときにプルリクエストをレビューしてマージします。
186 186
187<h3 id="peek-and-reply">187<h3 id="peek-and-reply">
188 ピーク表示と返信188 ピーク表示と返信
198 198
199ほとんどの場合、ピークパネルで十分であり、フルトランスクリプトを開く必要はありません。199ほとんどの場合、ピークパネルで十分であり、フルトランスクリプトを開く必要はありません。
200 200
201v2.1.207 より前では、すべてのピークはステータス文と裸のタイムスタンプで開き、ブロックされたセッションの質問はそれらの下に同じタイムスタンプで 2 回目のプレフィックスで表示されました。201ピークパネルに返信を入力して `Enter` を押すと、そのセッションに送信されます。セッションが複数選択肢の質問をしている場合、ピークパネルはオプションを番号付きリストとして表示し、数字キーを押して 1 つを選択できます。許可プロンプトはテキストとして表示され、セッションが実行したいことを説明します。番号付きオプションはありません。返信を入力して答えるか、標準プロンプトで答えるためにアタッチします。他のブロックされたセッションの場合は、`Tab` を押して入力に提案された返信を入力し、送信前に編集できます。返信の前に `!` を付けて Bash コマンドを代わりに送信します。
202 202
203ピークパネルに返信を入力して `Enter` を押すと、そのセッションに送信されます。セッションが複数選択肢の質問をしている場合、ピークパネルはオプションを表示し、数字キーを押して 1 つを選択できます。他のブロックされたセッションの場合は、`Tab` を押して入力に提案された返信を入力し、送信前に編集できます。返信の前に `!` を付けて Bash コマンドを代わりに送信します。203[`PermissionRequest`](/docs/ja/hooks#permissionrequest) または [`PreToolUse`](/docs/ja/hooks#pretooluse) フックが Claude Code がセッションが尋ねている呼び出しに対して検証できない出力を返す場合、行はフックイベントと `hook output invalid:` を検証エラーとともに表示し、その後に保留中のリクエストのテキストを表示します。別の方法で失敗するフックの場合、行はフックが失敗したことを示します。セッションは同じリクエストで待機し続けます。
204 204
205配信できない返信。バックグラウンドサービスに到達できないか、送信が失敗した場合、返信は保存され、そのプロセスが再度開始されるときにセッションの次のプロンプトとして送信されます。エラーメッセージは返信が保存されたことを示します。`!` でプレフィックスされた返信は保存されません。保存されたテキストはセッションにプレーンプロンプトとして到達するため、Bash コマンドとして実行されません。205配信できない返信。バックグラウンドサービスに到達できないか、送信が失敗した場合、返信は保存され、そのプロセスが再度開始されるときにセッションの次のプロンプトとして送信されます。エラーメッセージは返信が保存されたことを示します。`!` でプレフィックスされた返信は保存されません。保存されたテキストはセッションにプレーンプロンプトとして到達するため、Bash コマンドとして実行されません。
206 206
216 216
217アタッチ中、セッションは他の Claude Code セッションのように動作します。すべての [コマンド](/docs/ja/commands)、キーボードショートカット、および機能が機能します。以下の例外があります。217アタッチ中、セッションは他の Claude Code セッションのように動作します。すべての [コマンド](/docs/ja/commands)、キーボードショートカット、および機能が機能します。以下の例外があります。
218 218
219バックグラウンドセッションは `/install-github-app` と [`/mcp`](/docs/ja/mcp) 設定リスト（認証アクションを含む）を拒否します。アタッチされているか、ピークパネルから返信しているかに関係なく。メッセージは通常の `claude` セッションに指示し、`/mcp reconnect <server>`、`/mcp enable`、および `/mcp disable` は引き続き機能します。219アタッチ中、`/install-github-app` と [`/mcp`](/docs/ja/mcp) 設定リストは通常どおり機能します。人間がターミナルにいるため、ダイアログを完了できます。誰もアタッチされていない場合、これらのコマンドはダイアログを開くことができないため、セッションはエージェントビューの `Needs input` の下に表示され、`open this session to manage MCP servers` のような行が表示されます。トランスクリプト返信は同じことを示します。アタッチしてコマンドを再度実行して続行します。アタッチするとニーズ入力行がクリアされます。`/mcp reconnect <server>`、`/mcp enable`、および `/mcp disable` はどちらの方法でもアタッチせずに機能します。
220 220
221アタッチされたセッションは、`tui` 設定に関係なく、常に [フルスクリーンモード](/docs/ja/fullscreen) でレンダリングされます。バックグラウンドセッションには追加するターミナルスクロールバックがないためです。`PgUp`、`PgDn`、またはマウスホイールでスクロールし、トランスクリプトモードの場合は `Ctrl+O` を押します。ターミナルのネイティブスクロールと tmux コピーモードは現在のビューポートのみを表示します。これはフルスクリーンアプリケーションを実行するときと同じです。221アタッチされたセッションは、`tui` 設定に関係なく、常に [フルスクリーンモード](/docs/ja/fullscreen) でレンダリングされます。バックグラウンドセッションには追加するターミナルスクロールバックがないためです。`PgUp`、`PgDn`、またはマウスホイールでスクロールし、トランスクリプトモードの場合は `Ctrl+O` を押します。ターミナルのネイティブスクロールと tmux コピーモードは現在のビューポートのみを表示します。これはフルスクリーンアプリケーションを実行するときと同じです。
222 222
223空のプロンプトで `←` を押すか、`/exit` を実行してデタッチし、エージェントビューに戻ります。v2.1.198 以降、これはエージェントビューからセッションを開いたか、シェルから `claude attach <id>` を実行したかに関係なく同じように機能します。223空のプロンプトで `←` を押すか、`/exit` を実行してデタッチし、エージェントビューに戻ります。エージェントビューからセッションを開いたか、シェルから `claude attach <id>` を実行したかに関係なく機能します。
224
225`←` は [`/btw` オーバーレイ](/docs/ja/interactive-mode#side-questions-with-%2Fbtw) が開いている間もデタッチします。Claude Code v2.1.257 以降が必要です。まだ答えている側の質問は、あなたが離れている間、実行し続けます。次回アタッチするときに、オーバーレイは再度開くか、その答えで開きます。
224 226
225`Ctrl+Z` もデタッチしますが、開始した場所に戻ります。エージェントビューから接続した場合はエージェントビュー、またはシェルから `claude attach` を実行した場合はシェルです。ダイアログがフォーカスを持っており、`←` に応答していない場合は `Ctrl+Z` を使用します。227Windows では、アタッチしてから約半秒以内に `←` を押すと、Claude Code は `Ambiguous ←, press again to detach` を表示します。その時間枠では、ターミナルはアタッチ前からのプレスを再配信できるためです。`←` を再度押してデタッチします。
228
229`Ctrl+Z` もデタッチしますが、開始した場所に戻ります。エージェントビューからアタッチした場合はエージェントビュー、またはシェルから `claude attach` を実行した場合はシェルです。ダイアログがフォーカスを持っており、`←` に応答していない場合は `Ctrl+Z` を使用します。
226 230
227`Ctrl+C` はアタッチ中に標準的な割り込み動作を保持します。実行中の応答または `!` シェルコマンドをキャンセルするのであり、デタッチするのではありません。空のプロンプトで `Ctrl+C` を 2 回押すとデタッチします。これは他のセッションと同じです。231`Ctrl+C` はアタッチ中に標準的な割り込み動作を保持します。実行中の応答または `!` シェルコマンドをキャンセルするのであり、デタッチするのではありません。空のプロンプトで `Ctrl+C` を 2 回押すとデタッチします。これは他のセッションと同じです。
228 232
229デタッチはバックグラウンドセッションを停止しません。`←`、`Ctrl+Z`、`/exit`、および二重 `Ctrl+C` または二重 `Ctrl+D` はすべてセッションを実行し続けます。セッション内からセッションを終了するには、`/stop` を実行します。233デタッチはバックグラウンドセッションを停止しません。`←`、`Ctrl+Z`、`/exit`、および二重 `Ctrl+C` または二重 `Ctrl+D` はすべてセッションを実行し続けます。セッション内からセッションを終了するには、`/stop` を実行します。
230 234
235<h4 id="switch-sessions-without-leaving-the-terminal">
236 ターミナルを離れずにセッションを切り替える
237</h4>
238
231フォアグラウンドで実行しているセッション、つまりエージェントビューからアタッチするのではなくターミナルで開始したセッションでは、空のプロンプトで `←` を押すとセッションをバックグラウンドにし、そのセッションが事前に選択された状態でエージェントビューを開きます。これにより、ターミナルを離れずにセッションを切り替えることができます。同じ単一の押下でアタッチされたセッションをデタッチします。239フォアグラウンドで実行しているセッション、つまりエージェントビューからアタッチするのではなくターミナルで開始したセッションでは、空のプロンプトで `←` を押すとセッションをバックグラウンドにし、そのセッションが事前に選択された状態でエージェントビューを開きます。これにより、ターミナルを離れずにセッションを切り替えることができます。同じ単一の押下でアタッチされたセッションをデタッチします。
232 240
233`←` を押すときにツールが実行されている場合、Claude Code はそれが完了するまで約 10 秒待機してからバックグラウンドにし、応答はバックグラウンドセッションで続きます。代わりに待機せずにすぐにバックグラウンドにするには、`←` を再度押します。進行中の作業がバックグラウンドセッションに引き継ぐことができない場合、`Background this session?` ダイアログが最初に表示されます。これは [`/background`](#from-inside-a-session) と同じです。241プロンプトのテキストの最後を削除した直後、またはプロンプト履歴を移動した直後に `←` を押すと、Claude Code は確認を求めます。最初のプレスは `Press ← again to open agents` を表示するか、アタッチされたセッションで `Press ← again to go back to agents` を表示し、2 番目のプレスが切り替わります。
242
243`←` がフォアグラウンドセッションをバックグラウンドにすると、エージェントビューはリストの上に `Your conversation moved to the background` を表示し、そのセッションの行が既に選択されています。そこから：
244
245* `Enter` を押して会話を再度開きます。
246* `Esc` を押して切り替えを元に戻し、会話に戻ります。`Esc` が `Still starting — try again in a moment` を表示する場合、バックグラウンドセッションはまだ準備ができていないため、しばらくしてから `Esc` を再度押します。
247* `Ctrl+C` を 2 回押してシェルに終了します。
248
249Claude Code が会話を再度開くことができない場合、終了して `claude --resume` コマンドを出力し、それを再開します。
250
251[Claude のタスクリスト](/docs/ja/interactive-mode#task-list) は会話とともにバックグラウンドセッションに移動するため、そのセッションに戻るときにチェックリストは完全です。
252
253`←` を押した行は、矢印キーまたはマウスで選択を移動した後も、太字で薄くない名前を保持するため、どのセッションから来たかを判断できます。
234 254
23510 秒の制限は [subagents](/docs/ja/sub-agents) が実行されている間は適用されません。Claude Code は待機を続けるため、それらの作業が引き継がれ、待機中に `Still backgrounding after the current tool` 通知が表示されます。代わりに待機せずにすぐにバックグラウンドにするには、`←` を再度押します。これにより subagents が最初から再開されます。v2.1.203 より前では、待機は 10 秒後に終了し、実行中の subagents は警告なしに最初から再開されました。255`←` を押すときにツールが実行されている場合、Claude Code はそれが完了するまで約 10 秒待機してからバックグラウンドにし、応答はバックグラウンドセッションで続きます。代わりに待機せずにすぐにバックグラウンドにするには、`←` を再度押します。進行中の作業がバックグラウンドセッションに引き継ぐことができない場合、Claude Code は `Background this session?` ダイアログを最初に表示します。これは [`/background`](#from-inside-a-session) と同じです。
236 256
237行は会話履歴がない新しいセッションからでも作成されるため、`→` はそれに戻ります。v2.1.203 より前では、エージェントビューはその行が唯一の行である場合、その下にオンボーディングヒントを表示していました。25710 秒の制限は [フォアグラウンド subagents](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) Claude が会話で開始した間は適用されません。Claude Code は待機を続けるため、それらの作業が引き継がれ、待機中に `Still backgrounding after the current tool` 通知が表示されます。`←` を再度押してすぐにバックグラウンドにしない場合、これらの subagents が最初から再開されます。Claude Code は [動的ワークフロー](/docs/ja/workflows) が実行している subagents を待機しません。ワークフローに subagents が実行されている場合、Claude Code は `Background this session?` ダイアログを代わりに表示します。
258
259Claude Code はプロンプト入力に未送信のテキストがある間、セッションをバックグラウンドにしません。テキストはターミナルの入力ボックスに留まり、バックグラウンドセッションに移動しません。Claude Code がセッションをバックグラウンドにするのを待っている間に入力に入力すると、`Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` でスイッチがキャンセルされます。
260
261`←` を押すと、会話にメッセージがない場合でもセッションの行が作成されるため、`→` はそれに戻ります。
238 262
239このショートカットは `/config` の `leftArrowOpensAgents` 設定でオフにできます。263このショートカットは `/config` の `leftArrowOpensAgents` 設定でオフにできます。
240 264
255 279
256セッションをリストから削除するには、`Ctrl+X` を押して停止し、2 秒以内に `Ctrl+X` を再度押して削除します。グループヘッダーで `Ctrl+X` を押すと、確認後、そのグループ内のすべてのセッションが削除されます。280セッションをリストから削除するには、`Ctrl+X` を押して停止し、2 秒以内に `Ctrl+X` を再度押して削除します。グループヘッダーで `Ctrl+X` を押すと、確認後、そのグループ内のすべてのセッションが削除されます。
257 281
258削除するとセッションがエージェントビューから削除されます。Claude が [ワークツリーを作成した](#how-file-edits-are-isolated) 場合、削除するとそのワークツリーも削除されます。コミットされていない変更を含みます。保持したい作業をプッシュまたはコミットしてから削除します。自分で作成したワークツリーとセッションを開始した場合は、そのままにしておきます。会話トランスクリプトはローカルマシンに残り、`claude --resume` を通じて利用可能です。2822 番目のプレスは、停止の試みが失敗した場合でもセッションを削除します。例えば [バックグラウンドサービスが応答していない](#agent-view-says-the-background-service-did-not-respond) ため。確認は別の 2 秒間アクティブなままであり、削除はセッション自体のプロセスを終了します。`Esc` を押して確認を削除せずに削除します。
283
284[セッションを削除するときに削除されるもの](#what-deleting-a-session-removes) でカバーされている保持されたケースを除き、削除するとセッションがリストから削除され、Claude が作成したワークツリーは削除、保持、または削除方法とワークツリーが保持するものに応じて所定の位置に残されます。会話トランスクリプトはローカルマシンに常に残り、`claude --resume` を通じて利用可能です。
259 285
260削除は、`Ctrl+X` で削除するか、シェルから [`claude rm`](#manage-sessions-from-the-shell) で削除するかに関係なく、[スーパーバイザーの](#the-supervisor-process) セッションリストからセッションをクリアするため、削除はスーパーバイザー再起動全体で保存されます。v2.1.206 より前では、スーパーバイザーが再起動中または到達不可能な間にセッションを削除すると、そのリストに残り、次のスーパーバイザーはそのプロセスを再開し、行を再度表示していました。286Claude Code v2.1.212 以降でセッションを戻すには、ディスパッチ入力に `/resume` を入力します。ピッカーが開き、エージェントビューを開いたリポジトリの過去のセッションが表示されます。最新のものが最初です。削除したセッションを含みます。既に行を持つセッションはリストされません。`↑`/`↓` は選択を移動し、`Enter` は選択したセッションをバックグラウンドセッションとして再開し、リストに行として再度参加し、`Esc` はピッカーを閉じます。
261 287
262削除もセッションをクリアします。[スーパーバイザーの](#the-supervisor-process) セッションリストから。`Ctrl+X` で削除するか、シェルから [`claude rm`](#manage-sessions-from-the-shell) で削除するかに関係なく。削除はスーパーバイザー再起動全体で保存されます。v2.1.206 より前では、スーパーバイザーが再起動中または到達不可能な間にセッションを削除すると、そのリストに残り、次のスーパーバイザーはそのプロセスを再開し、行を再度表示していました。288ピッカーは裸の `/resume` に対してのみ開きます。ターゲット、スコープ、または制限された再開は、ピッカーで提供できないため、エージェントビューは以下の場合に `attach to a session to run it` ヒントを表示します：
289
290* `/resume` は ID または検索用語を名前付けします
291* ビューは `--cwd` でスコープされます
292* ビューは [`--safe-mode`](/docs/ja/cli-reference#cli-flags) で開始されました
293* ビューは `--permission-mode` または `--settings` などのフラグで開かれました
263 294
264画面に収まらない完了したセッションは「… N more」行に折りたたまれます。失敗とオープンなプルリクエストを持つセッションは常に表示されます。`Completed` グループはライブグループの後に残された垂直スペースを埋め、短いターミナルではヘッダーが単一の概要行にコンパクトされるため、作業中または入力が必要なセッションが表示されたままです。295画面に収まらない完了したセッションは「… N more」行に折りたたまれます。失敗とオープンなプルリクエストを持つセッションは常に表示されます。`Completed` グループはライブグループの後に残された垂直スペースを埋め、短いターミナルではヘッダーが単一の概要行にコンパクトされるため、作業中または入力が必要なセッションが表示されたままです。
265 296
270ディスパッチ入力に入力してディスパッチの代わりにフィルタリングします：301ディスパッチ入力に入力してディスパッチの代わりにフィルタリングします：
271 302
272| フィルター | 表示 |303| フィルター | 表示 |
273| :--------------------- | :----------------------------------------------------------------------- |304| :------------------------------- | :----------------------------------------------------------------------- |
274| `a:<name>` | 名前付きエージェントを実行しているセッション |305| `a:<name>` | 名前付きエージェントを実行しているセッション |
275| `s:<state>` | 指定された状態のセッション。例えば `s:working`。また `s:blocked` はあなたを待機しているすべてのセッションを受け入れます |306| `s:<state>` | 指定された状態のセッション。例えば `s:working`。また `s:blocked` はあなたを待機しているすべてのセッションを受け入れます |
276| `#<number>` または PR URL | そのプルリクエストで作業しているセッション |307| `#<number>` またはプルまたはマージリクエスト URL | そのプルリクエストまたはマージリクエストで作業しているセッション |
277| その他の URL | 最初のプロンプトにその URL が含まれていたセッション |308| その他の URL | 最初のプロンプトにその URL が含まれていたセッション |
278 309
279<h3 id="keyboard-shortcuts">310<h3 id="keyboard-shortcuts">
283エージェントビューで `?` を押してコンテキスト内のすべてのショートカットを表示します。下の表はそれらをまとめています。314エージェントビューで `?` を押してコンテキスト内のすべてのショートカットを表示します。下の表はそれらをまとめています。
284 315
285| ショートカット | アクション |316| ショートカット | アクション |
286| :-------------------- | :------------------------------------------------ |317| :-------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
287| `↑` / `↓` | 行間を移動 |318| `↑` / `↓` | 行間を移動 |
288| `Enter` | 選択したセッションにアタッチするか、入力にテキストがある場合はディスパッチ |319| `Enter` | 選択したセッションにアタッチするか、入力にテキストがある場合はディスパッチ |
289| `Space` | 選択したセッションのピークパネルを開くまたは閉じる |320| `Space` | 選択したセッションのピークパネルを開くまたは閉じる |
290| `Shift+Enter` | ディスパッチして直ちにアタッチ |321| `Shift+Enter` | ディスパッチ入力に改行を挿入します。[メインプロンプトのように](/docs/ja/terminal-config#enter-multiline-prompts) |
322| `Ctrl+Enter` | ディスパッチしてすぐにアタッチします。`?` オーバーレイが `ctrl+enter to start and open` をリストするターミナルで |
291| `→` | 選択したセッションにアタッチ |323| `→` | 選択したセッションにアタッチ |
292| `Alt+1`..`Alt+9` | フォーカスされたセッションのディレクトリ内のセッション 1～9 にアタッチ |324| `Alt+1`..`Alt+9` | フォーカスされたセッションのディレクトリ内のセッション 1～9 にアタッチ |
293| `Tab` | 空の入力で、すべての subagents を参照します。それ以外の場合はハイライトされた提案を適用 |325| `Tab` | 空の入力で、すべての subagents を参照します。それ以外の場合はハイライトされた提案を適用 |
295| `Ctrl+T` | 選択したセッションをピン留めまたはピン留め解除 |327| `Ctrl+T` | 選択したセッションをピン留めまたはピン留め解除 |
296| `Ctrl+R` | 選択したセッションの名前を変更 |328| `Ctrl+R` | 選択したセッションの名前を変更 |
297| `Ctrl+G` | `$VISUAL` または `$EDITOR` でディスパッチプロンプトを開く |329| `Ctrl+G` | `$VISUAL` または `$EDITOR` でディスパッチプロンプトを開く |
330| `Ctrl+J` | ディスパッチ入力に改行を挿入 |
298| `Ctrl+X` | セッションを停止。2 秒以内に再度押して削除 |331| `Ctrl+X` | セッションを停止。2 秒以内に再度押して削除 |
299| `Shift+↑` / `Shift+↓` | 選択したセッションを並べ替え |332| `Shift+↑` / `Shift+↓` | 選択したセッションを並べ替え |
300| `Esc` | ピークパネルを閉じるか、入力をクリアするか、終了 |333| `Esc` | ピークパネルを閉じるか、入力をクリアするか、終了します。`←` でセッションをバックグラウンドにしてエージェントビューを開いた場合、最終的な `Esc` は終了する代わりにその会話に戻ります。[vim エディターモード](/docs/ja/interactive-mode#vim-editor-mode) がオンの場合、入力で `Esc` を押すと INSERT から NORMAL モードに切り替わり、テキストを保持します。メインプロンプトのように |
301| `Ctrl+C` | 入力をクリア。2 回押して終了 |334| `Ctrl+C` | 入力をクリア。2 回押して終了 |
302| `?` | すべてのショートカットを表示 |335| `?` | すべてのショートカットを表示 |
303 336
337`Ctrl+S`、`Ctrl+T`、および `Ctrl+G` は [`keybindings.json`](/docs/ja/keybindings) に従います。`Ctrl+S` と `Ctrl+T` を [`Agents` コンテキスト](/docs/ja/keybindings#agents-actions) の `agents:switchView` と `agents:togglePin` アクションで再バインドまたはアンバインドし、`Ctrl+G` を `Chat` コンテキストの `chat:externalEditor` バインディングを通じて再バインドします。テーブル内の他のショートカットは再バインドできません。
338
304<h2 id="dispatch-new-agents">339<h2 id="dispatch-new-agents">
305 新しいエージェントをディスパッチする340 新しいエージェントをディスパッチする
306</h2>341</h2>
313 348
314エージェントビューの下部の入力にプロンプトを入力して `Enter` を押すと、新しいバックグラウンドセッションが開始されます。セッションはプロンプトから自動的に名前が付けられます。後で `Ctrl+R` で名前を変更できます。349エージェントビューの下部の入力にプロンプトを入力して `Enter` を押すと、新しいバックグラウンドセッションが開始されます。セッションはプロンプトから自動的に名前が付けられます。後で `Ctrl+R` で名前を変更できます。
315 350
316セッションが後で取得する名前は、その行にも表示されます。これには、そのセッションで [プランを承認](/docs/ja/permission-modes#review-and-approve-a-plan) するときに Claude が導出する名前も含まれます。v2.1.207 より前は、プランを承認することで名前が付けられたバックグラウンドセッションは `/status` にその名前を表示していましたが、自分で名前を変更するまでエージェントビューの行には表示されていませんでした。351自動名は [Haiku クラスモデル](/docs/ja/model-config) によって書かれた短いラベルです。セッションが後で取得する名前もその行に表示されます。これには、そのセッションで [プランを承認](/docs/ja/permission-modes#review-and-approve-a-plan) するときに生成される [タイトル](/docs/ja/sessions#name-your-sessions) も含まれます。
317 352
318プロンプトに画像を貼り付けて、タスクにスクリーンショットまたは図を含めます。353プロンプトに画像を貼り付けて、タスクにスクリーンショットまたは図を含めます。
319 354
320800 文字を超えるか 2 行以上の貼り付けられたテキストは `[Pasted text #N]` プレースホルダーに折りたたまれるため、入力は 1 行のままです。ディスパッチするときに完全なテキストが送信されます。ディスパッチする前に折りたたまれたテキストを確認または編集するには、同じテキストを再度貼り付けると、プレースホルダーが入力に展開されます。少なくとも 90 列幅のターミナルでは、貼り付け後数秒間、入力の下に `paste again to expand` リマインダーが表示されます。v2.1.207 より前は、同じテキストを再度貼り付けると、最初のプレースホルダーを展開する代わりに 2 番目のプレースホルダーが追加されていました。355800 文字を超えるか 3 行以上の貼り付けられたテキストは `[Pasted text #N]` プレースホルダーに折りたたまれるため、入力は 1 行のままです。ディスパッチするときに完全なテキストが送信されます。ディスパッチする前に折りたたまれたテキストを確認または編集するには、同じテキストを再度貼り付けると、プレースホルダーが入力に展開されます。
321 356
322プロンプトの一部をプレフィックスまたは言及してセッションの開始方法を制御します：357プロンプトの一部をプレフィックスまたは言及してセッションの開始方法を制御します：
323 358
324| 入力 | 効果 |359| 入力 | 効果 |
325| :------------------------------- | :-------------------------------------------------------------------------------------------------------------- |360| :------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------- |
326| `<agent-name> <prompt>` | 最初の単語がカスタム [subagent](/docs/ja/sub-agents) 名と一致する場合、その subagent はセッションのメインエージェントとして実行され、frontmatter の設定を使用します |361| `<agent-name> <prompt>` | 最初の単語がカスタム [subagent](/docs/ja/sub-agents) 名と一致する場合、その subagent はセッションのメインエージェントとして実行され、frontmatter の設定を使用します |
327| `@<agent-name>` | プロンプト内の任意の場所でカスタム subagent を言及してメインエージェントとして実行 |362| `@<agent-name>` | プロンプト内の任意の場所でカスタム subagent を言及してメインエージェントとして実行 |
328| `@<repo>` | リポジトリを言及してセッションをそこで実行します。どのリポジトリがリストされるかについては、[特定のディレクトリにディスパッチする](#dispatch-to-a-specific-directory) を参照してください |363| `@<repo>` | リポジトリを言及してセッションをそこで実行します。どのリポジトリがリストされるかについては、[特定のディレクトリにディスパッチする](#dispatch-to-a-specific-directory) を参照してください |
329| `/<command>` | [skills](/docs/ja/skills) および [commands](/docs/ja/commands) をディスパッチプロンプトとして提案 |364| `/<command>` | [skills](/docs/ja/skills) および [commands](/docs/ja/commands) をディスパッチプロンプトとして提案 |
330| `! <command>` | Claude セッションを開始する代わりに、シェルコマンドをバックグラウンドジョブとして実行します。ジョブは行として表示され、アタッチ、監視、デタッチできます |365| `! <command>` | Claude セッションを開始する代わりに、シェルコマンドをバックグラウンドジョブとして実行します。ジョブは行として表示され、アタッチ、監視、デタッチできます |
331| `#<number>` または pull request URL | セッションが既にその PR で作業している場合は、ディスパッチの代わりに選択 |366| `#<number>` または pull request または merge request URL | セッションが既にその pull request または merge request で作業している場合、Claude Code はディスパッチの代わりにその行を選択します |
332| `Shift+Enter` | ディスパッチして新しいセッションに直ちにアタッチ |
333 367
334エージェントビュー自体で実行される少数のコマンドがあります。ディスパッチの代わりに：368エージェントビュー自体で実行される少数のコマンドがあります。ディスパッチの代わりに：
335 369
336* `/exit` および `/quit` はエージェントビューを閉じます370* `/exit` および `/quit` はエージェントビューを閉じます
337* `/logout` はサインアウトします371* `/logout` はサインアウトします
338* `/model` は [ディスパッチモデル](#set-the-model) を設定します372* `/model` は [ディスパッチモデル](#set-the-model) を設定します
339* v2.1.198 以降、`/login` はサインインダイアログを開き、セッションにアタッチせずに再度サインインできます373* `/login` はサインインダイアログを開き、セッションにアタッチせずに再度サインインできます
374* 裸の `/resume` またはそのエイリアス `/continue` は、リポジトリの過去のセッションのピッカーを開き、[1 つを戻す](#organize-the-list) ことでバックグラウンドセッションとして復帰させます。Claude Code v2.1.212 以降が必要です
340 375
341skills、独自のコマンド、および `/init` などのプロンプト展開組み込みは、新しいバックグラウンドセッションにその最初のプロンプトとして送信されます。その他の組み込みコマンドは、代わりに `attach to a session to run it` ヒントを表示します。入力したテキストはヒントの横に入力に残るため、編集できます。v2.1.203 より前は、ヒントが入力をクリアし、入力したテキストが失われました。376skills、独自のコマンド、および `/init` などのプロンプト展開組み込みは、新しいバックグラウンドセッションにその最初のプロンプトとして送信されます。その他の組み込みコマンドは、代わりに `attach to a session to run it` ヒントを表示します。入力したテキストはヒントの横に入力に残るため、編集できます。
342 377
343繰り返しタスクを [skill](/docs/ja/skills) としてパッケージ化すると、プロンプトを再入力せずにエージェントビューから同じワークフローを何度も開始できます。378繰り返しタスクを [skill](/docs/ja/skills) としてパッケージ化すると、プロンプトを再入力せずにエージェントビューから同じワークフローを何度も開始できます。
344 379
357 * 起動元のリポジトリの登録済み [git worktrees](/docs/ja/worktrees)。`.claude/worktrees/` の下に Claude が作成したものなど、そのディレクトリツリー内に存在し、チェックアウトされたブランチでラベル付けされたもの。`git worktree add ../feature` などのリポジトリの外に追加された worktree はリストされません392 * 起動元のリポジトリの登録済み [git worktrees](/docs/ja/worktrees)。`.claude/worktrees/` の下に Claude が作成したものなど、そのディレクトリツリー内に存在し、チェックアウトされたブランチでラベル付けされたもの。`git worktree add ../feature` などのリポジトリの外に追加された worktree はリストされません
358 * リスト内に既にセッションがあるディレクトリ393 * リスト内に既にセッションがあるディレクトリ
359 394
360 名前にスペースが含まれるディレクトリはリストされません。v2.1.203 より前は、登録済み worktree がリストされていなかったため、worktree にディスパッチするには、その worktree のディレクトリから `claude --bg` を実行する必要がありました。395 名前にスペースが含まれるディレクトリはリストされません。
361* シェルから、ディレクトリに `cd` して `claude --bg "<prompt>"` を実行します。396* シェルから、ディレクトリに `cd` して `claude --bg "<prompt>"` を実行します。
362 397
363エージェントビューがディレクトリでグループ化されている場合、ハイライトされた行のディレクトリがディスパッチターゲットになるため、グループにスクロールしてパスを再入力せずにそこにディスパッチできます。398エージェントビューがディレクトリでグループ化されている場合、ディスパッチは選択された行のディレクトリにプロンプトを送信するため、グループを選択してパスを再入力せずにそこにディスパッチできます。
364 399
365<h3 id="from-inside-a-session">400<h3 id="from-inside-a-session">
366 セッション内から401 セッション内から
367</h3>402</h3>
368 403
4042 つのコマンドは、セッション内の作業をバックグラウンドに移動します。`/background` は現在の会話をそこに送信してターミナルを解放し、`/fork` はコピーを送信しながら元の場所で作業を続けます。
405
406<h4 id="send-the-session-to-the-background">
407 セッションをバックグラウンドに送信する
408</h4>
409
369`/background` またはそのエイリアス `/bg` を実行して現在の会話をバックグラウンドセッションに移動します。`/bg run the test suite and fix any failures` などのプロンプトを渡して、バックグラウンド化する前に 1 つの追加命令を送信します。Claude が応答中に `/bg` を実行した場合、応答はバックグラウンドセッションで続行されます。410`/background` またはそのエイリアス `/bg` を実行して現在の会話をバックグラウンドセッションに移動します。`/bg run the test suite and fix any failures` などのプロンプトを渡して、バックグラウンド化する前に 1 つの追加命令を送信します。Claude が応答中に `/bg` を実行した場合、応答はバックグラウンドセッションで続行されます。
370 411
371バックグラウンド作業が実行中のインタラクティブセッション（subagent、バックグラウンドシェルコマンド、ワークフロー、または [monitor](/docs/ja/tools-reference#monitor-tool) など）を終了すると、直ちに終了する代わりに `Background work is running` ダイアログが表示されます。v2.1.198 以降、ダイアログは `Exit anyway` および `Stay` と並んで `Move to background and exit` を提供します。これを選択すると、セッションは `/background` と同じ方法でバックグラウンドに移動し、その後シェルに戻るため、転送可能な作業は実行し続け、セッションはエージェントビューに表示されます。このオプションは、エージェントビューが [オフ](#turn-off-agent-view) になっている場合は表示されません。412バックグラウンド作業が実行中のセッション（subagent、バックグラウンドシェルコマンド、ワークフロー、または [monitor](/docs/ja/tools-reference#monitor-tool) など）を終了すると、直ちに終了する代わりに `Background work is running` ダイアログが表示されます。セッションをバックグラウンド化して終了するには `Move to background and exit` を選択します。これは `/background` と同じ方法でセッションをバックグラウンド化し、シェルに戻ります。このオプションは、エージェントビューが [オフ](#turn-off-agent-view) になっている場合は表示されません。
413
414バックグラウンド化されたセッションのリストに既に会話の名前がある場合、Claude Code は新しい行の名前に番号を付けます（例：`my-session (2)`）。既存の行の名前は変わりません。新しい行の名前を変更するには、エージェントビューで選択して `Ctrl+R` を押します。
415
416<h4 id="copy-the-session-with-/fork">
417 /fork でセッションをコピーする
418</h4>
419
420`/fork` を実行して現在の会話を新しいバックグラウンドセッションにコピーしながら、元の会話は実行し続けます。コピーはその時点までの会話のすべてで開始されます。以下の箇条書きを参照してコピーが実行される場所を確認してください。また、モデル、権限モード、努力レベル、およびセッション中に追加したディレクトリまたは「今後は聞かない」権限付与も引き継ぎます。コピーはエージェントビューの独自の行として表示されます。
421
422フォーク後、2 つの会話は独立しています。コピーが実行する内容は、[クロスセッションメッセージング](/docs/ja/cross-session-messaging) が有効になっているセッションでは、どちらのセッションの Claude も明示的に相手にメッセージを送信できますが、それ以外は元の会話に自動的に入りません。
423
424セッションのコピーには Claude Code v2.1.212 以降が必要です。v2.1.161 から v2.1.211 では、`/fork` は代わりに [forked subagent](/docs/ja/sub-agents#fork-the-current-conversation) を開始します。これは現在 `/subtask` です。[エージェントビューがオフ](#turn-off-agent-view) になっている場合、`/fork` は forked subagent の動作を保持し、`/subtask` は利用できません。
425
426`/fork open a draft pull request with the work so far` などのプロンプトを渡すと、コピーはすぐにそれに取り組み始めます。プロンプトがない場合、コピーは最初の命令を待ちます。`claude agents` でその行を選択して `Space` を押すか、`claude attach <id>` を実行します。選択された行は、待機中に `space to send it a prompt` を表示します。
427
428`/fork` 確認は 1 行で、コピーの状態（例：`session running`）、そのエージェントビュー行の名前、および `claude attach` 用のセッション ID を表示します。名前をクリックしてコピーに切り替えます。このセッションはバックグラウンドに移動し（`←` を押すのと同じ）、エージェントビューはコピーのセッションを開きます。
429
430コピーが [所定の位置で編集](#how-file-edits-are-isolated) する場合を除き、Claude Code はコード変更を行う前に独自の worktree を作成するよう指示します。git リポジトリの外では、hook で作成された worktree から移動されたコピーのみが指示を受けます。[`WorktreeCreate` hook](/docs/ja/hooks#worktreecreate) がない場合、コピーは所定の位置で編集します。worktree から移動されたコピーは、分離設定に関係なく、その worktree を編集、実行、または入力しないよう指示されます。
372 431
373インタラクティブセッションからバックグラウンド化すると、保存された会話から再開する新しいプロセスが開始され、実行中の作業がそこに移動します。実行中のバックグラウンドシェルコマンド、backgrounded subagent、動的ワークフロー、および [`/loop`](/docs/ja/scheduled-tasks) で作成したスケジュール済みタスクはバックグラウンドセッションに転送され、そこで実行し続けます。subagent はそれが開始したすべてのものと一緒に移動するため、すべての作業が転送できる場合にのみ転送されます。Windows を含みます。バックグラウンド化の代わりに実行中の作業を停止するには、[`CLAUDE_DISABLE_ADOPT=1`](/docs/ja/env-vars#variables) 環境変数を設定します。Claude Code はバックグラウンド化する前に確認を求めます。432コピーが開始される場所は、現在のセッションが実行されている場所によって異なります：
374 433
375転送できない作業（実行中の [monitor](/docs/ja/tools-reference#monitor-tool) など）は停止されます。monitor を所有している backgrounded subagent は monitor と一緒に停止されます。そのような作業が実行されている場合、Claude Code は `Background this session?` ダイアログを表示するため、停止する前に確認できます。434* ディスパッチされたセッションと同様に、コピーは [ファイルを編集する前に独自の worktree に移動](#how-file-edits-are-isolated) します。その場合、確認はコピーが実行される場所を言及しません。
435* セッションが開始後にリンクされた [worktree](/docs/ja/worktrees) に移動した場合、コピーは移動前のセッションがあった場所に戻ります。[所定の位置で編集](#how-file-edits-are-isolated) しない限り、独自の worktree でコード変更を行います。worktree がブランチにチェックアウトされている場合、その指示はタスクがあなたの作業に基づいている場合、新しいブランチをあなたのブランチに基づくよう指示します。あなたのブランチは worktree でチェックアウトされたままだからです。確認は `runs in the origin tree` で終わります。
436* リンクされた worktree 内でセッションを起動し、リポジトリにメインワーキングツリーがある場合、コピーはそのメインワーキングツリーで開始されます。同じ worktree-of-its-own ルールですが、ブランチ指示はありません。確認はここでも `runs in the origin tree` で終わります。
437* ベアリポジトリレイアウトの worktree 内で起動されたセッションには、戻るメインワーキングツリーがないため、コピーはそこにとどまり、確認は `edits this checkout` で終わります。worktree 分離が [オフ](#how-file-edits-are-isolated) になっているセッションで、リンクされた worktree 内にない場合も同じ注記が表示されます。コピーは開いているファイルを編集するためです。
438
439置き換えられたシステムプロンプトや `--tools` 許可リストなど、コピーが継承しない起動フラグで開始されたセッションはフォークできません。Claude Code はそう言う代わりに部分的なコピーを作成します。エージェントビューからディスパッチされたセッションは通常フォークされます。コピーは、それが来たセッションと同じ [エージェント定義](/docs/ja/sub-agents) と追加命令で起動されます。
440
441<h4 id="what-carries-over-when-you-background">
442 バックグラウンド化するときに引き継がれるもの
443</h4>
444
445バックグラウンド化は、保存された会話から再開する新しいプロセスを開始し、実行中の作業がそこに移動します。実行中のバックグラウンドシェルコマンド、backgrounded subagent、動的ワークフロー、[`/loop`](/docs/ja/scheduled-tasks) で作成したスケジュール済みタスク、および Claude の [artifact コメントへの自動返信](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own) はすべてバックグラウンドセッションに引き継がれ、そこで実行し続けます。subagent はそれが開始したすべてのものと一緒に移動するため、すべての作業が移動できる場合にのみ引き継がれます。バックグラウンド化の代わりに実行中の作業を停止するには、[`CLAUDE_DISABLE_ADOPT=1`](/docs/ja/env-vars#variables) 環境変数を設定します。Claude Code はバックグラウンド化する前に確認を求めます。
446
447[動的ワークフロー](/docs/ja/workflows) がまだ subagent を実行している場合、Claude Code は `Background this session?` ダイアログでバックグラウンド化する前に確認を求めます。再開するサブエージェントの数を表示します。`Stay` を選択して最初に完了させます。確認すると、Claude Code はバックグラウンドセッションで実行を再生成します。まだ実行中だった subagent は最初から再開するため、これまでに使用したトークンは再度費やされます。[一時停止後に再開](/docs/ja/workflows#resume-after-a-pause) を参照して、どの完了した subagent が保存された結果を返し、どれが再度実行されるかを確認してください。
448
449Claude Code は、実行中の [monitor](/docs/ja/tools-reference#monitor-tool) など、引き継げない作業を停止し、monitor を所有している backgrounded subagent を monitor と一緒に停止します。そのような作業が実行されている場合、Claude Code は `Background this session?` ダイアログを表示するため、停止する前に確認できます。
376 450
377バックグラウンドに入ると、セッションは新しい subagent、monitor、およびバックグラウンドコマンドを開始でき、それらは後のデタッチとリアタッチ全体で実行し続けます。451バックグラウンドに入ると、セッションは新しい subagent、monitor、およびバックグラウンドコマンドを開始でき、それらは後のデタッチとリアタッチ全体で実行し続けます。
378 452
385* `--fallback-model`459* `--fallback-model`
386* `--allow-dangerously-skip-permissions`460* `--allow-dangerously-skip-permissions`
387 461
388セッション中に [`/add-dir`](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) で追加したディレクトリも引き継がれます。462セッション中に [`/add-dir`](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) で追加したディレクトリも引き継がれます。`--allow-dangerously-skip-permissions` を引き継ぐことで、バックグラウンド化されたセッションで `bypassPermissions` に到達可能になりますが、新しい権限は付与されません。このモードは、セッションが監視していない状態で承認なしに動作することを許可するため、[権限モード、モデル、および努力](#permission-mode-model-and-effort) で説明されているのと同じ 1 回限りのインタラクティブな受け入れが必要です。
389
390`--allow-dangerously-skip-permissions` を引き継ぐことで、バックグラウンド化されたセッションで `bypassPermissions` に到達可能になりますが、新しい権限は付与されません。このモードは、セッションが監視していない状態で承認なしに動作することを許可するため、[権限モード、モデル、および努力](#permission-mode-model-and-effort) で説明されているのと同じ 1 回限りのインタラクティブな受け入れが必要です。
391 463
392<h3 id="from-your-shell">464<h3 id="from-your-shell">
393 シェルから465 シェルから
399claude --bg "investigate the flaky SettingsChangeDetector test"471claude --bg "investigate the flaky SettingsChangeDetector test"
400```472```
401 473
402プロンプトは `-p` 値ではなく、位置引数です。v2.1.198 以降、`--bg` を `-p` または `--print` と組み合わせることは、セッションが作成される前にエラーで拒否されます。`--print` は `claude agents` がアタッチするインタラクティブセッションを開始しないためです。474プロンプトは `-p` 値ではなく、位置引数です。Claude Code は、セッションが作成される前に `--bg` を `-p` または `--print` と組み合わせることを拒否します。`--print` は `claude agents` がアタッチするインタラクティブセッションを開始しないためです。
403 475
404特定の subagent をセッションのメインエージェントとして実行するには、`--bg` を `--agent` と組み合わせます：476特定の [subagent](/docs/ja/sub-agents)（例：`code-reviewer`）をセッションのメインエージェントとして実行するには、`--bg` を `--agent` と組み合わせます：
405 477
406```bash theme={null}478```bash theme={null}
407claude --agent code-reviewer --bg "address review comments on PR 1234"479claude --agent code-reviewer --bg "address review comments on PR 1234"
408```480```
409 481
482名前がいずれかの subagent と一致しない場合、起動は失敗します。Claude Code は `no agent named` 警告を出力し、セッションはバックグラウンド化されたと報告されますが、セッションは `--agent '<name>' not found` エラーで直ちに終了します。
483
484バックグラウンド化されたセッションが後で再開または再開始されると、Claude Code はエージェントとそのツール制限を復元します。システムプロンプトについては、[再開された会話のシステムプロンプトフラグ](/docs/ja/cli-reference#system-prompt-flags-in-resumed-conversations) を参照してください。[そのワークスペースを信頼](/docs/ja/permissions#project-allow-rules-and-workspace-trust) している場合、セッションのディレクトリでエージェントを最初に検索するため、プロジェクトスコープのエージェントは別のディレクトリから再開されたときに読み込まれます。エージェントが存在しなくなった場合、セッションはデフォルトツールで続行され、トランスクリプトは [エージェントを名前付けする警告](/docs/ja/errors#session-agent-no-longer-available) で開きます。
485
486既存の会話をバックグラウンドで続行するには、完全なセッション ID を `--resume` で渡します：
487
488```bash theme={null}
489claude --resume 1f0e2c9a-6d0b-4c11-9f39-2a77c1d4e8b5 --bg "pick up where you left off and finish the migration"
490```
491
492Claude Code v2.1.257 以降では、Claude Code はそのセッションを同じ ID で続行するか、新しい ID でコピーを開始し、それができなかった理由を説明する `note:` 行を出力します。セッションが所定の位置で続行される場合、`claude agents` はそれに対して 1 つの行を表示します。
493
494`--bg` を `--continue`、裸の `--resume`、または `--resume` と名前またはファイルパスと組み合わせると、Claude Code は常にそのようなコピーを開始します。目的でコピーを開始するには `--fork-session` を追加し、注記なしで開始します。
495
410`--name` を渡して、自動生成されたセッションの代わりにエージェントビューでセッションの表示名を設定します：496`--name` を渡して、自動生成されたセッションの代わりにエージェントビューでセッションの表示名を設定します：
411 497
412```bash theme={null}498```bash theme={null}
427 シェルコマンドを実行する513 シェルコマンドを実行する
428</h4>514</h4>
429 515
430Claude セッションの代わりにシェルコマンドをバックグラウンドジョブとして実行するには、エージェントビューのディスパッチ入力の最初の文字として `!` を入力します。`!` はプレフィックスとして表示され、その後に入力するすべてのものがコマンドです。次の例は、エージェントビューの入力ボックスから `pytest -x` をディスパッチします：516Claude セッションの代わりにシェルコマンドをバックグラウンドジョブとして実行するには、`--exec` を渡します。次の例は `pytest -x` をバックグラウンドジョブとして実行します：
431
432```text theme={null}
433! pytest -x
434```
435
436`Enter` を押してジョブを開始します。同じジョブは、`--exec` を使用してシェルから直接起動することもできます：
437 517
438```bash theme={null}518```bash theme={null}
439claude --bg --exec 'pytest -x'519claude --bg --exec 'pytest -x'
440```520```
441 521
522エージェントビューから、ディスパッチ入力の最初の文字として `!` を入力して同じ種類のジョブをディスパッチします。`!` はプレフィックスとして表示され、その後のすべてがコマンドです。`Enter` を押してジョブを開始します。
523
442コマンドは PTY バックアップジョブとして実行され、エージェントビューの行として表示されます。最新の出力行がそのステータスです。シェルジョブは Claude の代わりにコマンドを実行するため、モデルは呼び出されず、出力はセッションに送信されません。524コマンドは PTY バックアップジョブとして実行され、エージェントビューの行として表示されます。最新の出力行がそのステータスです。シェルジョブは Claude の代わりにコマンドを実行するため、モデルは呼び出されず、出力はセッションに送信されません。
443 525
444出力を確認するには、行にアタッチするか、`Space` を押してアタッチせずにピークするか、シェルから `claude logs <id>` を実行します。キャプチャされた出力はメモリに保持され、ディスクに書き込まれません。行とその出力は、コマンド終了後約 5 分で自動的にクリーンアップされるため、その前に結果が必要な場合は読み取ります。526出力を確認するには、行にアタッチするか、`Space` を押してアタッチせずにピークするか、シェルから `claude logs <id>` を実行します。キャプチャされた出力はメモリに保持され、ディスクに書き込まれません。行とその出力は、コマンド終了後約 5 分で自動的にクリーンアップされるため、その前に結果が必要な場合は読み取ります。
447 ファイル編集の分離方法529 ファイル編集の分離方法
448</h3>530</h3>
449 531
450エージェントビュー、`/bg`、または `claude --bg` から開始されたすべてのバックグラウンドセッションは、作業ディレクトリで開始されます。ファイルを編集する前に、Claude はセッションを `.claude/worktrees/` の下の分離された [git worktree](/docs/ja/worktrees) に移動するため、並列セッションは同じチェックアウトを読み取ることができますが、それぞれが独自のものに書き込みます。532エージェントビュー、`/bg`、または `claude --bg` から開始されたすべてのバックグラウンドセッションは、作業ディレクトリで開始されます。ファイルを編集する前に、Claude はセッションを `.claude/worktrees/` の下の分離された [git worktree](/docs/ja/worktrees) に移動するため、並列セッションは同じチェックアウトを読み取ることができますが、それぞれが独自のものに書き込みます。セッションが worktree に入ると、Claude Code は [worktree 分離を強制](/docs/ja/worktrees#how-claude-code-enforces-isolation) し、セッションとそれが生成する subagent に対して実行します。
451 533
452Claude はワークツリーをスキップします：534Claude はワークツリーをスキップします：
453 535
454* セッションが既にリンクされた git worktree 内にある場合。Claude が `.claude/worktrees/` の下に作成したか、`git worktree add` で別の場所に作成したかに関係なく536* セッションが既にリンクされた git worktree 内にある場合。Claude が `.claude/worktrees/` の下に作成したか、`git worktree add` で別の場所に作成したかに関係なく
537* Claude が編集しているファイルがリンクされた git worktree 内にある場合。セッションまたはその subagent が `git worktree add` で作成したものなど
455* 作業ディレクトリが git リポジトリでない場合、および [`WorktreeCreate` hook](/docs/ja/hooks#worktreecreate) が設定されていない場合538* 作業ディレクトリが git リポジトリでない場合、および [`WorktreeCreate` hook](/docs/ja/hooks#worktreecreate) が設定されていない場合
456* 作業ディレクトリの外への書き込みの場合539* 作業ディレクトリの外への書き込みの場合
457 540
458git worktree が実用的でないリポジトリのワークツリー分離をオフにするには、[`worktree.bgIsolation`](/docs/ja/settings#worktree-settings) を `"none"` に設定します。バックグラウンドセッションは、ワークツリーに移動する前に作業コピーを直接編集します。プロジェクトの `.claude/settings.json` に設定を追加します：541git worktree が実用的でないリポジトリのワークツリー分離をオフにするには、[`worktree.bgIsolation`](/docs/ja/settings-reference#worktree-bgisolation) を `"none"` に設定します。バックグラウンドセッションは、ワークツリーに移動する前に作業コピーを直接編集します。プロジェクトの `.claude/settings.json` に設定を追加します：
459 542
460```json theme={null}543```json theme={null}
461{544{
467 550
468git リポジトリの外では、セッションは作業ディレクトリに直接書き込み、互いに分離されていないため、同じファイルを編集する並列セッションのディスパッチを避けます。別のバージョン管理システムを使用する場合は、[`WorktreeCreate` hook](/docs/ja/worktrees#non-git-version-control) を設定して、Claude は git の場合と同じ方法で編集を分離します。551git リポジトリの外では、セッションは作業ディレクトリに直接書き込み、互いに分離されていないため、同じファイルを編集する並列セッションのディスパッチを避けます。別のバージョン管理システムを使用する場合は、[`WorktreeCreate` hook](/docs/ja/worktrees#non-git-version-control) を設定して、Claude は git の場合と同じ方法で編集を分離します。
469 552
470フックが git リポジトリではないディレクトリで失敗した場合、セッションはそのディレクトリの分離をスキップし、作業ディレクトリを所定の位置で編集します。git リポジトリ内では、セッションが分離されるまで書き込みはブロックされたままです。v2.1.203 より前は、その状態のバックグラウンドセッションはファイルを編集できませんでした。すべての書き込みは分離されるまで拒否され、フックはそのディレクトリを分離できませんでした。553フックがディレクトリで失敗し、それが git リポジトリではない場合、Claude はそのディレクトリの分離をスキップし、作業ディレクトリを所定の位置で編集します。git リポジトリ内では、Claude Code はセッションが worktree に移動するまで共有チェックアウトへの書き込みをブロックします。
554
555セッションの worktree パスを見つけるには、セッションをピークするか、アタッチして作業ディレクトリを確認します。
556
557バックグラウンドセッションが生成する [subagent](/docs/ja/sub-agents) は、セッションの作業ディレクトリを継承するため、そのファイル編集はセッションの worktree ではなく作業コピーに配置されます。subagent に独自の個別ワークツリーを代わりに提供するには、frontmatter で [`isolation: worktree`](/docs/ja/sub-agents#supported-frontmatter-fields) を設定するか、生成時に `isolation: "worktree"` を渡します。
558
559バックグラウンドセッションが Claude が入った worktree でコード変更を行った場合、Claude Code は完了する前に作業を保持するよう Claude に指示するため、セッションと worktree を削除しても生き残ります：
560
561* **コミットとプッシュ**：Claude は確認なしにコミットし、リポジトリにリモートがある場合はブランチをプッシュします。
562* **ドラフトプルリクエスト**：Claude はタスクが呼び出すときに開き、[`#N` ラベル](#pull-request-status) が行に表示されます。
563* **決して**：`main` または `master` へのプッシュ、強制プッシュ、およびマージ。
564* **あなたの git 指示が優先**：タスク、`CLAUDE.md`、または [memory](/docs/ja/memory) があなたがコミットまたはプッシュを自分で処理すると言う場合、Claude は git をあなたに任せます。
565
566分離されていないチェックアウトを編集するセッションは、コミットまたはブランチの切り替え前に確認を求めます。これは、分離が `"none"` に設定されている場合、ワークツリーの移動が失敗した場合、またはセッションが既に存在していた worktree 内で開始された場合に適用されます。
567
568タスクに関係なく、Claude はジョブを報告で終了し、実行内容と作業がある場所を示します。パス、ブランチ、プルリクエスト、または答え自体。
569
570<h4 id="what-deleting-a-session-removes">
571 セッションを削除するときに削除されるもの
572</h4>
573
574[エージェントビュー](#organize-the-list) で `Ctrl+X` を 2 回押すか、[`claude rm`](#manage-sessions-from-the-shell) で削除します。以下の保持されたケースを除き、セッションはリストから削除されます。そのトランスクリプトは `claude --resume` を通じてマシンに残り、削除はスーパーバイザーの再開始を通じて保持されます。
575
576Claude がセッション用に作成した worktree に何が起こるか：
577
578* エージェントビューはそれを削除します。コミットされていない変更を含めて、保持したい変更をまずコミットしてください。
579* `claude rm` はコミットされていない変更がある場合、セッション行と一緒に保持します。
580* エージェントビューも `claude rm` も、別の実行中のセッションが使用または ロックしている worktree を削除しません。再度削除してもそれは変わりません。Claude Code は worktree とセッションを保持し、保持されたディレクトリと理由を名前付けします。エージェントビューでは、セッションの行は `not deleted` を表示します。別のセッションを閉じてから再度削除します。
581* セッションを削除し、その worktree に Claude Code が他の場所に保存されていることを確認できないコミットがある場合、Claude Code は worktree とセッションを保持し、メッセージは worktree のブランチと未プッシュコミット数を名前付けします。メッセージは、2 つの前進方法も提供します。コミットをプッシュするか、再度削除してそれらを破棄します。
582
583 リモートのコミットは削除をブロックしません。ローカルコピーのあなたの `origin` リモートのデフォルトブランチのコミットもブロックしません。そのブランチがメインチェックアウト（リポジトリディレクトリ自体、worktree ではなく）でチェックアウトされている限り。
584
585 その拒否の後、あなたは選択します：
586
587 * コミットを保持するには、それらをプッシュするか、そのデフォルトブランチにマージしてから、セッションを再度削除します。
588 * それらを破棄するには、プッシュせずにセッションを再度削除します。エージェントビューの行で `Ctrl+X` を 2 回押すか、拒否が出力した `claude rm <id> --discard-unpushed` コマンドを実行します。これはセッションと worktree をそのブランチと一緒に削除し、未プッシュコミットとコミットされていない変更を破棄します。
471 589
472セッションを削除する方法によって、Claude が作成したワークツリーが削除されるか保持されるかが異なります：590 再度削除すると、Claude Code は拒否が示したものだけを破棄します。worktree がそれ以来コミットを獲得した場合、Claude Code は再度保持し、更新された状態を表示します。
473 591
474* エージェントビューで `Ctrl+X` を 2 回で削除すると、コミットされていない変更を含めてワークツリーが削除されるため、保持したい変更をまずコミットしてください。592 別の完了したセッションのレコードも worktree を名前付けする場合、再度削除するときに保持されます。コミットをプッシュしてから再度削除します。
475* シェルから [`claude rm`](#manage-sessions-from-the-shell) で削除すると、コミットされていない変更があるワークツリーが保持され、セッション行と一緒に保持されます。593* git が認識しなくなった worktree（例：`git worktree prune` の後）は削除をブロックしません。Claude Code はセッションを削除し、ディレクトリをディスク上に残します。
476* どちらのパスでも、どこかにプッシュされていないコミットがあるワークツリーは削除されません。ワークツリーは [セッションと一緒に保持](#organize-the-list) され、出力は保持されたパスと理由を名前付けします。594* git またはあなたの [`WorktreeRemove` hook](/docs/ja/hooks#worktreeremove) が worktree を削除できない場合、Claude Code は worktree とセッションを保持し、メッセージは原因を名前付けします。フックの場合、メッセージは終了方法（例：`exited 1`）を示し、stderr の開始を引用します。メッセージは、次のいずれかを実行するよう指示します：
477* 自分で作成したワークツリーとセッションを開始した場合は、どちらの方法でも所定の位置に残されます。
478 595
479セッションのワークツリーパスを見つけるには、セッションをピークするか、アタッチして作業ディレクトリを確認します。596 * セッションを再度削除して、エージェントビューの行で `Ctrl+X` を 2 回押すか、拒否が出力した `claude rm <id> --force-remove-worktree <worktree-id>` コマンドを実行してディレクトリを削除します。Claude Code は、ディレクトリがリポジトリのリンクされた worktree の 1 つであることを確認できる場合にのみこれを提供します。`.claude/worktrees/` の下、追跡されたファイルへのコミットされていない変更なし、ネストされたリポジトリなし、他のセッションのレコードがそれを名前付けしていません。worktree のブランチはリポジトリに残ります。
597 * ディレクトリを使用しているものを閉じるなど、障害を修正し、フックを修正してから、セッションを再度削除します。
598 * ディレクトリを自分で削除してから、セッションを再度削除します。
480 599
481バックグラウンドセッションが生成する [subagent](/docs/ja/sub-agents) は、セッションの作業ディレクトリを継承するため、そのファイル編集はセッションのワークツリーではなく作業コピーに配置されます。subagent に独自の個別ワークツリーを代わりに提供するには、frontmatter で [`isolation: worktree`](/docs/ja/sub-agents#supported-frontmatter-fields) を設定するか、生成時に `isolation: "worktree"` を渡します。600自分で作成した worktree とセッションを開始した場合は、どちらの方法でも所定の位置に残されます。
482 601
483v2.1.198 以降、ワークツリーでコード変更を分離したバックグラウンドセッションは、確認を求めずにコミット、独自のブランチをプッシュ、およびドラフトプルリクエストを開きます。プルリクエストが開くと、[`#N` ラベル](#pull-request-status) がその行に表示されます。`main` または `master` にプッシュすることはなく、強制プッシュまたはマージを行わず、プルリクエストを開かないように指示した場合、またはリポジトリにリモートがない場合はプルリクエストをスキップします。602worktree ディレクトリが git リポジトリに属さないセッション（リポジトリが削除されたか、[`WorktreeCreate` hook](/docs/ja/hooks#worktreecreate) がディレクトリを別の場所に作成したため）は、削除できます。ディレクトリにファイルが残っている間：
484 603
485分離されていないチェックアウトを編集するセッションは、コミットまたはブランチの切り替え前に確認を求めます。これは、分離が `"none"` に設定されている場合、ワークツリーの移動が失敗した場合、またはセッションが既に存在していたワークツリー内で開始された場合に適用されます。604* エージェントビューは削除する前に同じ `Ctrl+X` ダブルプレスを要求します。hook で作成されたディレクトリの場合、代わりに [`WorktreeRemove` hook](/docs/ja/hooks#worktreeremove) を実行し、1 つがない場合は削除を拒否してセッションを保持します。
605* `claude rm` はセッションと worktree を保持し、理由を名前付けします。
606
607どちらのパスでも、別の完了したセッションのレコードが名前付けするディレクトリを保持します。
486 608
487<h3 id="set-the-model">609<h3 id="set-the-model">
488 モデルを設定する610 モデルを設定する
489</h3>611</h3>
490 612
491エージェントビューヘッダーに表示されるモデル名はディスパッチのデフォルトです。入力から開始する新しいセッションはこのモデルを使用します。これは [`model` setting](/docs/ja/settings#available-settings) からユーザー設定で取得されます。[`/model` picker](/docs/ja/model-config) でモデルを選択して設定するか、設定を直接編集します。613エージェントビューヘッダーに表示されるモデル名はディスパッチのデフォルトです。入力から開始する新しいセッションはこのモデルを使用します。これは、ユーザー設定の [`model` setting](/docs/ja/settings-reference#model) から取得されます。[`/model` picker](/docs/ja/model-config) でモデルを選択して設定するか、設定を直接編集します。
492 614
493エージェントビューセッション全体でディスパッチのデフォルトをオーバーライドするには、エージェントビューを開く際に `--model` を渡します。[権限モード、モデル、および努力](#permission-mode-model-and-effort) を参照してください。615エージェントビューを開く際にディスパッチのデフォルトをオーバーライドするには、`--model` を渡します。[権限モード、モデル、および努力](#permission-mode-model-and-effort) を参照してください。
494 616
495エージェントビューの内部からディスパッチのデフォルトを変更するには、ディスパッチ入力に `/model` の後にモデル名を入力して `Enter` を押します。ヘッダーは `(session)` マーカー付きでそのモデルを表示するように更新され、その後ディスパッチするセッションはそれを使用します。`/model default` と入力してオーバーライドをクリアし、ディスパッチのデフォルトに戻します。このオーバーライドは現在の `claude agents` 実行の残りの間続き、設定ファイルに書き込まれません。次の例は、1 つのセッションを Opus でディスパッチし、次のセッションを Sonnet でディスパッチします：617エージェントビューの内部からディスパッチのデフォルトを変更するには、ディスパッチ入力に `/model` の後にモデル名を入力して `Enter` を押します。ヘッダーは `(session)` マーカー付きでそのモデルを表示するように更新され、その後ディスパッチするセッションはそれを使用します。`/model default` と入力してオーバーライドをクリアし、ディスパッチのデフォルトに戻します。このオーバーライドは現在の `claude agents` 実行の残りの間続き、設定ファイルに書き込まれません。次の例は、1 つのセッションを Opus でディスパッチし、次のセッションを Sonnet でディスパッチします：
496 618
511 権限モード、モデル、および努力633 権限モード、モデル、および努力
512</h3>634</h3>
513 635
514バックグラウンドセッションは、そこで `claude` を開始した場合と同じように、実行されるディレクトリから [settings](/docs/ja/settings) を読み取ります。これには、プロジェクト設定の [`env` values](/docs/ja/settings#available-settings) が含まれるため、そこで設定された `ANTHROPIC_MODEL` またはプロバイダー変数がそのディレクトリのバックグラウンドセッションに適用されます。636バックグラウンドセッションは、ディスパッチされた場所と方法から設定、プロバイダー、権限モード、モデル、および努力を取得します。以下のサブセクションは各ソースをカバーし、スーパーバイザーがセッションを再開始するときに何が保持されるかをカバーします。
637
638<h4 id="settings-and-provider">
639 設定とプロバイダー
640</h4>
515 641
516`CLAUDE_CODE_USE_BEDROCK` または `CLAUDE_CODE_USE_VERTEX` などのクラウドプロバイダー選択、および `ANTHROPIC_DEFAULT_*_MODEL` エイリアスは、セッションをディスパッチしたシェルに従います。そのシェルで [`CLAUDE_CODE_EXTRA_BODY`](/docs/ja/env-vars) リクエストボディオーバーライドをエクスポートする場合、それはセッションに同じ方法で到達します。v2.1.206 より前は、バックグラウンドワーカーはシェルでエクスポートされた `CLAUDE_CODE_EXTRA_BODY` を無視していました。642バックグラウンドセッションは、そこで `claude` を開始した場合と同じように、実行されるディレクトリから [settings](/docs/ja/settings) を読み取ります。これには、プロジェクト設定の [`env` values](/docs/ja/settings-reference#env) が含まれるため、そこで設定された `ANTHROPIC_MODEL` またはプロバイダー変数がそのディレクトリのバックグラウンドセッションに適用されます。
517 643
518ディスパッチシェルでゲートウェイ `ANTHROPIC_BASE_URL` をエクスポートする場合、スーパーバイザーが同じゲートウェイ環境で実行され、セッションがディスパッチ元のディレクトリで実行されるか、`←` または `/background` でバックグラウンド化された独自のセッションである場合、`ANTHROPIC_CUSTOM_HEADERS` と一緒にセッションにも到達します。これは、エージェントビューを開くか、バックグラウンドセッションをディスパッチする最初のシェルがゲートウェイシェルである場合の通常のケースです。`@repo` または `--cwd` で別のディレクトリにディスパッチすると、シェルのゲートウェイは実行されません。そのプロジェクトの [settings](/docs/ja/settings) がエンドポイントを提供します。バックグラウンドセッションがプロバイダー設定と認証情報をどのようにソースするかについては、[スーパーバイザープロセス](#the-supervisor-process) を参照してください。644バックグラウンドセッションは、ディスパッチ元のシェルの `PATH` でも実行されるため、実行するコマンドはターミナルと同じツールを見つけます。`CLAUDE_CODE_USE_BEDROCK` または `CLAUDE_CODE_USE_VERTEX` などのクラウドプロバイダー選択、`ANTHROPIC_DEFAULT_*_MODEL` エイリアス、および [`CLAUDE_CODE_EXTRA_BODY`](/docs/ja/env-vars) オーバーライドもそのシェルから保持します。
645
646<h4 id="llm-gateway">
647 LLM ゲートウェイ
648</h4>
519 649
520[permission mode](/docs/ja/permissions) は、セッションをどのように開始したかによって異なります。`/bg` または `←` でインタラクティブセッションをバックグラウンド化すると、現在の権限モードが保持されるため、`acceptEdits` または `auto` に切り替えたセッションはデタッチ後もそのモードのままです。エージェントビュー入力からディスパッチするか、シェルから `claude --bg` を実行すると、そのディレクトリの設定から `defaultMode` を使用するか、ディスパッチされた [subagent の frontmatter](/docs/ja/sub-agents#supported-frontmatter-fields) から `permissionMode` を使用します。650[LLM ゲートウェイ](/docs/ja/llm-gateway) を通じて Claude Code をルーティングする場合、ゲートウェイ変数を設定ファイルの `env` ブロックに入れ、シェルでエクスポートするのではなく、バックグラウンドセッションは設定の残りと一緒にそれらを読み取ります。[設定ファイルで設定](/docs/ja/llm-gateway-connect#set-in-a-settings-file) はブロックと資格情報に使用する設定ファイルを表示します。
521 651
522バックグラウンドセッションを開始するときの権限モード、モデル、および努力は、スーパーバイザーが後で [セッションのプロセスを停止して再開](#the-supervisor-process) するときに、[設定フラグ](#from-inside-a-session) とともに保持されます。`claude --bg --dangerously-skip-permissions` または `claude --bg --permission-mode bypassPermissions` で起動したセッションは、ディレクトリの `defaultMode` にフォールバックする代わりに、その再開後も `bypassPermissions` のままです。また、セッション中に `/model` または `/effort` で変更したモデルまたは努力は保持されます。652シェルでのみゲートウェイ `ANTHROPIC_BASE_URL` をエクスポートする場合、[スーパーバイザー](#the-supervisor-process) 自体が同じゲートウェイをエクスポートしたシェルから開始された場合、および以下の場合にのみ、`ANTHROPIC_CUSTOM_HEADERS` と資格情報と一緒にバックグラウンドセッションに到達します：
523 653
524セッションが [`effortLevel` setting](/docs/ja/settings#available-settings) から取得した努力は、`--effort` または `/effort` からではなく、ディスパッチで固定されません。セッションのために開始された各プロセスは設定を再度読み取るため、`settings.json` で `effortLevel` を編集すると、`←` または `/bg` でバックグラウンド化したセッションとそれらの後の再開に到達します。v2.1.203 より前は、セッションをバックグラウンド化すると、`--effort` を渡したかのように、その設定から派生した努力が記録されたため、後の `effortLevel` 編集は到達しませんでした。654* `←` または `/background` で独自のセッションをバックグラウンド化する
655* セッションをあなたがいるディレクトリにディスパッチする
656* あなたがいるディレクトリで停止したセッションを起動するか、それに返信する
657
658Claude Code はクラウドプロバイダーの前のゲートウェイを転送します。ディスパッチ元のシェルがプロバイダーを選択し、認証バイパスフラグ付きのゲートウェイエンドポイントをエクスポートする場合、Claude Code は `ANTHROPIC_BASE_URL` に適用される条件の下でエンドポイントとフラグペアをセッションに転送し、`ANTHROPIC_CUSTOM_HEADERS` と一緒に転送します。例えば、`CLAUDE_CODE_USE_VERTEX=1` を `ANTHROPIC_VERTEX_BASE_URL` と `CLAUDE_CODE_SKIP_VERTEX_AUTH=1` でエクスポートし、Claude Code はそのエンドポイントとフラグを転送します。
659
660Claude Code は転送されたゲートウェイをそのセッションの実行プロセスにのみ適用し、ディスクに書き込みません。
661
662<h4 id="permission-mode">
663 権限モード
664</h4>
525 665
526[`/rename`](/docs/ja/commands) または `Ctrl+R` で設定した名前も、その再開全体で保持されるため、[`claude --resume <name>`](/docs/ja/sessions#name-your-sessions) はセッションを解決します。v2.1.202 より前は、再開はセッションをディスパッチされた名前に戻し、新しい名前は解決を停止しました。666[権限モード](/docs/ja/permissions) は、セッションをどのように開始したかによって異なります：
527 667
528エージェントビューを開く際に `--permission-mode`、`--model`、`--effort`、または `--agent` のいずれかを渡して、エージェントビューからディスパッチするすべてのセッションのデフォルトを設定します：668* **`/bg` または `←` でバックグラウンド化**：Claude Code はセッションが入っていた権限モードを保持するため、`acceptEdits` または `auto` に切り替えたセッションはデタッチ後もそのモードのままです
669* **`←` で開いたエージェントビューからディスパッチ**：ターゲットの独自の設定が最初に来て、他に何も設定しない場合、来たセッションの権限モードが適用されます
670* **シェルで開始した `claude agents` からディスパッチするか、`claude --bg` で実行**：新しいセッションは、[ディスパッチのデフォルト](#dispatch-defaults) で開いたエージェントビューからディスパッチしない限り、そのディレクトリで新しい `claude` セッションが開始する方法で開始されます。[セッションが開始する権限モード](/docs/ja/permission-modes#which-mode-a-session-starts-in) はリストされた順序を示します
671
672`←` で開いたエージェントビューからディスパッチするセッションの場合、Claude Code は以下の最初に適用されるものから権限モードを取得します：
673
6741. ターゲットディレクトリの [`permissions.defaultMode`](/docs/ja/settings-reference#permissions-defaultmode)。2 つのソースルールが適用されます：
675 * `auto` および `bypassPermissions` は [管理設定、`--settings` ファイル、または `~/.claude/settings.json` からのみ有効](/docs/ja/settings-reference#permissions-defaultmode)。
676 * Claude Code は、来たセッションが入っていたモードより許容的なモードを選択するプロジェクトの `.claude/settings.json` または `.claude/settings.local.json` からの `defaultMode` を拒否します。
6772. 来たセッションの権限モード
678
679Claude Code がソースのモードを許容的すぎるとして拒否する場合、リスト内の次のソースが決定します。例えば、plan モードセッションから `acceptEdits` を要求するチェックイン設定を持つディレクトリにディスパッチする場合、新しいセッションは plan モードで開始されます。その `defaultMode` を `~/.claude/settings.json` に移動する場合、来たセッションの権限モードに関係なく適用されます。
680
681許容性は plan、次に Manual と `dontAsk`、次に `acceptEdits` と auto（それぞれが他より許容的と見なされる）、次に `bypassPermissions` を実行します。
682
683<h4 id="dispatch-defaults">
684 ディスパッチのデフォルト
685</h4>
686
687エージェントビューからディスパッチするすべてのセッションのデフォルトを設定するには、開く際に `--permission-mode`、`--model`、`--effort`、または `--agent` のいずれかを渡します：
529 688
530```bash theme={null}689```bash theme={null}
531claude agents --permission-mode plan --model opus --effort high690claude agents --permission-mode plan --model opus --effort high
532```691```
533 692
534`--agent` は、ディスパッチプロンプトが `@name` または最初の単語で名前を付けない場合に使用される [subagent](/docs/ja/sub-agents) を設定します。設定されている場合は [`agent` setting](/docs/ja/settings#available-settings) にデフォルト設定され、そうでない場合は組み込みのキャッチオール `claude` エージェントです。ディスパッチ入力で subagent を名前付けすると、両方がオーバーライドされます。693`--effort` ここは [トップレベル `--effort` フラグ](/docs/ja/cli-reference#cli-flags) と同じ値を受け入れます。`ultracode` を含みます。
694
695`--agent` は、ディスパッチプロンプトが `@name` または最初の単語で名前を付けない場合に使用される [subagent](/docs/ja/sub-agents) を設定します。設定されている場合は [`agent` setting](/docs/ja/settings-reference#agent) にデフォルト設定され、そうでない場合は組み込みのキャッチオール `claude` エージェントです。ディスパッチ入力で subagent を名前付けすると、両方がオーバーライドされます。
535 696
536`claude agents` は、`--permission-mode bypassPermissions` の短縮形として `--dangerously-skip-permissions` も受け入れ、各ディスパッチされたセッションの `Shift+Tab` サイクルで `bypassPermissions` を利用可能にするために `--allow-dangerously-skip-permissions` も受け入れます。どちらも [トップレベル CLI フラグ](/docs/ja/cli-reference) と一致します。697`claude agents` は、`--permission-mode bypassPermissions` の短縮形として `--dangerously-skip-permissions` も受け入れ、各ディスパッチされたセッションの `Shift+Tab` サイクルで `bypassPermissions` を利用可能にするために `--allow-dangerously-skip-permissions` も受け入れます。どちらも [トップレベル CLI フラグ](/docs/ja/cli-reference) と一致します。
537 698
699`--restricted` を渡して、ビューからディスパッチするすべてのセッションを [制限モード](/docs/ja/cli-reference#cli-flags) で開始します。トップレベル `--restricted` フラグで起動したかのように。Claude Code v2.1.248 以降が必要です。
700
538アクティブなデフォルトはディスパッチ入力の下のフッターに表示されます。701アクティブなデフォルトはディスパッチ入力の下のフッターに表示されます。
539 702
540これらのフラグがない場合、セッションはそのディレクトリの設定から `defaultMode` を使用するか、ディスパッチされた [subagent の frontmatter](/docs/ja/sub-agents#supported-frontmatter-fields) から `permissionMode` を使用し、エージェントビューヘッダーに表示されるモデルを使用します。703Claude Code は、セッションが監視していない状態で承認なしに動作することを許可するため、`claude --bg --permission-mode bypassPermissions` を拒否します。これは、`claude` で対話的に実行して `--dangerously-skip-permissions` で受け入れるまで拒否されます。`claude agents` に `--dangerously-skip-permissions` または `--permission-mode bypassPermissions` を渡すと、以前に受け入れていない場合は同じ免責事項が表示され、受け入れるとそのビューから起動するセッションに `bypassPermissions` が適用されます。`--allow-dangerously-skip-permissions` を渡すと、同じ免責事項も表示され、受け入れるとそれらのセッションの `Shift+Tab` サイクルで `bypassPermissions` が利用可能になります。
704
705<h4 id="what-persists-across-restarts">
706 再開始全体で保持されるもの
707</h4>
708
709バックグラウンドセッションに対して選択した権限モード、モデル、および努力は、[設定フラグ](#what-carries-over-when-you-background) と一緒に、スーパーバイザーが後で [セッションのプロセスを停止して再開](#the-supervisor-process) するときに保持されます。`claude --bg --dangerously-skip-permissions` または `claude --bg --permission-mode bypassPermissions` で起動したセッションは、その再開後も `bypassPermissions` のままです。セッション中に `/model` または `/effort` で変更したモデルまたは努力も保持されます。
710
711セッションが設定から努力を取得した場合（`--effort` または `/effort` からではなく）、Claude Code は各プロセスを開始するたびに設定を再度読み取ります。`settings.json` で保存された努力を編集した後、変更は `←` または `/bg` でバックグラウンド化したセッションとそれらの後の再開に到達します。保存された努力は [`effortLevel`](/docs/ja/settings-reference#effortlevel) キーまたは [`modelSettings`](/docs/ja/settings-reference#modelsettings) エントリです。
541 712
542`bypassPermissions` を使用することは、セッションが監視していない状態で承認なしに動作することを許可するため、`claude --bg --permission-mode` で使用するまで拒否されます。これは、`claude` で対話的に実行して `--dangerously-skip-permissions` で受け入れるまで拒否されます。`claude agents` に `--dangerously-skip-permissions` または `--permission-mode bypassPermissions` を渡すと、以前に受け入れていない場合は同じ免責事項が表示され、受け入れるとそのビューから起動するセッションに `bypassPermissions` が適用されます。`--allow-dangerously-skip-permissions` を渡すと、同じ免責事項も表示され、受け入れるとそれらのセッションの `Shift+Tab` サイクルで `bypassPermissions` が利用可能になります。713Claude Code は [`/rename`](/docs/ja/commands) または `Ctrl+R` で設定した名前も、その再開全体で保持するため、[`claude --resume <name>`](/docs/ja/sessions#name-your-sessions) はセッションを解決します。
714
715アタッチ中に [`Ctrl+S`](/docs/ja/interactive-mode#general-controls) で隠した プロンプトもセッションと一緒に保持されます。セッションのプロセスが停止または再開始された後、セッションを再度開き、`Ctrl+S` は隠されたテキストを復元します。隠しの貼り付けコンテンツは再開始を通じて生き残りません。
543 716
544<h3 id="settings-plugins-and-mcp-servers">717<h3 id="settings-plugins-and-mcp-servers">
545 設定、プラグイン、および MCP サーバー718 設定、プラグイン、および MCP サーバー
546</h3>719</h3>
547 720
548エージェントビューは、設定、プラグイン、MCP サーバー、および追加ディレクトリを読み込むための `claude` と同じ設定フラグを受け入れます。各フラグはエージェントビュー自体に適用され、そこからディスパッチするすべてのセッションに渡されるため、この方法で読み込むプラグインまたは MCP サーバーはそれらのセッションでも利用可能です。721エージェントビューは、設定、プラグイン、MCP サーバー、および追加ディレクトリを読み込むための `claude` と同じ設定フラグを受け入れます。エージェントビューは `--settings` と `--plugin-dir` を自身に適用し、すべての設定フラグをそこからディスパッチするセッションに渡すため、この方法で読み込むプラグインまたは MCP サーバーはそれらのセッションでも利用可能です。
549 722
550| フラグ | 効果 |723| フラグ | 効果 |
551| :----------------------------------------------------------------------------------------------- | :-------------------------------------------- |724| :----------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
552| [`--settings <file-or-json>`](/docs/ja/settings) | エージェントビューとディスパッチされたセッションの設定をオーバーライド |725| [`--settings <file-or-json>`](/docs/ja/settings) | エージェントビューとディスパッチされたセッションの設定をオーバーライド |
553| [`--add-dir <path>`](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) | 追加ディレクトリへのファイルアクセスを許可 |726| [`--add-dir <path>`](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) | 追加ディレクトリへのファイルアクセスを許可 |
554| [`--plugin-dir <path>`](/docs/ja/plugins) | ローカルディレクトリからプラグインを読み込む |727| [`--plugin-dir <path>`](/docs/ja/plugins) | ローカルディレクトリからプラグインを読み込む |
555| [`--mcp-config <file-or-json>`](/docs/ja/mcp) | 設定ファイルまたは JSON 文字列から MCP サーバーを読み込む |728| [`--mcp-config <file-or-json>`](/docs/ja/mcp) | 設定ファイルまたは JSON 文字列から MCP サーバーを読み込む |
556| `--strict-mcp-config` | `--mcp-config` からのみ MCP サーバーを使用し、他の MCP 設定を無視 |729| `--strict-mcp-config` | `--mcp-config` からのみ MCP サーバーを使用し、他の MCP 設定を無視します。[managed-mcp.json での排他的制御](/docs/ja/managed-mcp#exclusive-control-with-managed-mcp-json) を参照して、フラグが管理 MCP ファイルの下で何をするかを確認してください |
557 730
558`--add-dir`、`--plugin-dir`、または `--mcp-config` を値ごとに 1 回繰り返します。`--add-dir a b c` などのスペース区切り形式は `claude agents` ではサポートされていません。731`--add-dir`、`--plugin-dir`、または `--mcp-config` を値ごとに 1 回繰り返します。`--add-dir a b c` などのスペース区切り形式は `claude agents` ではサポートされていません。
559 732
733`--settings` と `--plugin-dir` を `agents` の前または後に配置できます。`--add-dir` と `--mcp-config` を `agents` の後に保持します。`agents` の前にいずれかを配置する場合、[`claude agents --json`](#manage-sessions-from-the-shell) は `unknown option` エラーで失敗します。
734
560次の例は、設定オーバーライドと 1 つの追加ディレクトリでエージェントビューを開きます：735次の例は、設定オーバーライドと 1 つの追加ディレクトリでエージェントビューを開きます：
561 736
562```bash theme={null}737```bash theme={null}
563claude agents --settings ./ci-settings.json --add-dir ../shared-lib738claude agents --settings ./ci-settings.json --add-dir ../shared-lib
564```739```
565 740
741`--settings` はファイルパスまたはインライン JSON 文字列を受け入れます。ファイルパスは既存のファイルを指す必要があります。Claude Code は、そうでない場合は `Settings file not found` エラーで終了します。
742
566<h2 id="manage-sessions-from-the-shell">743<h2 id="manage-sessions-from-the-shell">
567 シェルからセッションを管理する744 シェルからセッションを管理する
568</h2>745</h2>
570すべてのバックグラウンドセッションには、シェルから使用できる短い ID があります。ID は `claude --bg` でセッションを開始するときに出力され、各セッションの ID は `~/.claude/jobs/` の下のディレクトリ名です。これらのコマンドはスクリプティングまたはエージェントビューを開きたくない場合に便利です。747すべてのバックグラウンドセッションには、シェルから使用できる短い ID があります。ID は `claude --bg` でセッションを開始するときに出力され、各セッションの ID は `~/.claude/jobs/` の下のディレクトリ名です。これらのコマンドはスクリプティングまたはエージェントビューを開きたくない場合に便利です。
571 748
572| コマンド | 目的 |749| コマンド | 目的 |
573| :--------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |750| :--------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
574| `claude agents` | エージェントビューを開く |751| `claude agents` | エージェントビューを開く |
575| `claude agents --cwd <path>` | `<path>` の下で開始されたセッションにスコープされたエージェントビューを開く |752| `claude agents --cwd <path>` | `<path>` の下で開始されたセッションにスコープされたエージェントビューを開く |
576| `claude agents --json` | アクティブなセッションを JSON 配列として出力して終了します。すべてのライブセッション、およびプロセスが終了した場合でも引き続き動作またはブロックされているバックグラウンドセッションが含まれます。`--all` を追加して、完了したバックグラウンドセッションも含めます。各エントリには `cwd`、`kind`、`startedAt` が含まれます。バックグラウンドエントリには、`claude attach`/`logs`/`stop` で使用可能な `id` と、`working`、`blocked`、`done`、`failed`、`stopped` のいずれかの `state` も含まれます。`pid` と `status` はプロセスが生きている間のみ存在し、status が `waiting` の場合は `waitingFor` が存在し、`permission prompt` や `input needed` など、セッションがブロックされている内容を示します。`sessionId` と `name` は設定されている場合に表示されます。`--cwd <path>` と組み合わせてフィルタリングします |753| `claude agents --json` | セッションを JSON 配列として出力して終了します。[セッションを JSON として一覧表示](#list-sessions-as-json)を参照してください |
577| `claude attach <id>` | このターミナルでセッションにアタッチする |754| `claude attach <id>` | このターミナルでセッションにアタッチする |
578| `claude logs <id>` | セッションの最新出力を出力する |755| `claude logs <id>` | セッションの最新出力を出力する |
579| `claude stop <id>` | セッションを停止する。`claude kill` も受け入れます |756| `claude stop <id>` | セッションを停止する。`claude kill` も受け入れます |
580| `claude respawn <id>` | セッションを再開する。会話を保持したまま実行または停止状態から再開します。例えば、更新された Claude Code バイナリを取得するため |757| `claude respawn <id>` | セッションを再開する。実行中または停止状態のセッションを再開します。例えば、更新された Claude Code バイナリを取得するため。再開されたセッションは保存された会話を再開します。ディスク上に会話がない場合は、新しい会話として元のプロンプトを再度実行します |
581| `claude respawn --all` | すべての実行中のセッションを再開する。例えば、すべてのセッションを一度に更新された Claude Code バイナリに移動するため |758| `claude respawn --all` | すべての実行中のセッションを再開する。例えば、すべてのセッションを一度に更新された Claude Code バイナリに移動するため |
582| `claude rm <id>` | セッションをリストから削除する。コミットされていない変更がない場合、セッション用に Claude が作成した worktree を削除します。それ以外の場合は、セッションも保持され、コマンドは worktree パスと理由を出力するので、それを解決して `claude rm` を再度実行できます。自分で作成した worktree はそのままにしておきます。会話トランスクリプトはローカルマシンに保存され、`claude --resume` を通じて利用可能なままです |759| `claude rm <id>` | セッションをリストから削除します。削除が安全な場合、Claude が作成した worktree も削除します。[セッションの削除で何が削除されるか](#what-deleting-a-session-removes)を参照してください。会話トランスクリプトはローカルマシンに保存され、`claude --resume` を通じて利用可能なままです |
760| `claude rm <id> --discard-unpushed <commit>@<worktree-id>` | プッシュされていないコミットで削除が拒否されたセッションを削除し、worktree をそのブランチとコミットとともに破棄します。拒否が出力した正確な値を渡します。[セッションの削除で何が削除されるか](#what-deleting-a-session-removes)を参照してください。v2.1.260 以降が必要です |
761| `claude rm <id> --force-remove-worktree <worktree-id>` | git または `WorktreeRemove` フックが worktree を削除できなかったために削除が拒否されたセッションを削除し、worktree ディレクトリを削除してそのブランチをリポジトリに残します。拒否が出力した正確な値を渡します。[セッションの削除で何が削除されるか](#what-deleting-a-session-removes)を参照してください。v2.1.268 以降が必要です |
583| `claude daemon status` | [supervisor](#the-supervisor-process) の状態、バージョン、ソケットディレクトリ、およびワーカー数を出力する |762| `claude daemon status` | [supervisor](#the-supervisor-process) の状態、バージョン、ソケットディレクトリ、およびワーカー数を出力する |
584| `claude daemon stop --any` | supervisor プロセスとそれがホストするバックグラウンドセッションを停止します。`--keep-workers` を渡して、バックグラウンドセッションを実行したままにして、次の supervisor が再接続できるようにします。次の `claude agents` または `claude --bg` は新しい supervisor を開始します |763| `claude daemon stop --any` | supervisor プロセスとそれがホストするバックグラウンドセッションを停止します。`--keep-workers` を渡して、バックグラウンドセッションを実行したままにして、次の supervisor が再接続できるようにします。次の `claude agents` または `claude --bg` は新しい supervisor を開始します |
585 764
586<h2 id="how-background-sessions-are-hosted">765<h3 id="list-sessions-as-json">
587 バックグラウンドセッションがどのようにホストされるか766 セッションを JSON として一覧表示
588</h2>
589
590エージェントビューに表示されているすべてのセッションはバックグラウンドセッションと見なされます。現在接続しているかどうかに関わらず、バックグラウンドセッションと見なされます。これに対して、`claude` を直接実行して開始されたセッションはそのターミナルに結び付けられ、ターミナルが閉じると終了します。ただし、[セッション内から](#from-inside-a-session)バックグラウンドに送信することはできます。
591
592<h3 id="the-supervisor-process">
593 スーパーバイザープロセス
594</h3>767</h3>
595 768
596バックグラウンドセッションはユーザーごとのスーパーバイザープロセスによってホストされ、ターミナルおよびエージェントビューとは別です。スーパーバイザーはセッションを初めてバックグラウンド化するか、エージェントビューを開くときに自動的に開始され、直接管理することはありません。769`claude agents --json` はアクティブなセッションを JSON 配列として出力して終了します。すべてのライブセッション、およびプロセスが終了した場合でも引き続き動作またはブロックされているバックグラウンドセッションが含まれます。`--all` を追加して、完了したバックグラウンドセッションも含めます。`--cwd <path>` を追加して、そのディレクトリの下で開始されたセッションに一覧を制限します。
597
598実行中の Claude Code プロセスが起動されたバイナリが更新によって置き換えられたか削除された場合、そのプロセスはインストールされた `claude` ランチャーやディスク上の最新バージョンなど、別のインストール済みコピーからスーパーバイザーを開始します。
599
600スーパーバイザーは、エージェントビューまたは `claude --bg` からのディスパッチがコールドローンチの遅延なく開始されるように、1 つのプリウォーミングされたワーカープロセスを準備完了の状態で保持しています。ディスパッチすると、スーパーバイザーはプリウォーミングされたワーカーをセッションに割り当て、そのセッションのディレクトリ、設定、認証情報をそれに適用してから、次のディスパッチ用の置き換えを開始します。健全なプリウォーミングされたワーカーが利用できない場合、スーパーバイザーは代わりに新しいプロセスを起動します。
601
602スーパーバイザーとそのセッションはインタラクティブセッションと同じ認証情報で認証され、モデル API を超えて追加のネットワーク接続を行いません。`CLAUDE_CODE_USE_BEDROCK` や `ANTHROPIC_DEFAULT_*_MODEL` エイリアスなどのプロバイダー選択変数は、各セッションをディスパッチしたシェルから読み取られ、そのワーカーに適用されます。
603 770
604ディスパッチシェルの `PATH` はワーカーに同じ方法で適用されるため、セッションが実行するシェルコマンドはターミナルと同じツールを見つけます。v2.1.203 より前は、バックグラウンドセッションはスーパーバイザーを最初に開始したシェルの `PATH` を保持していたため、その後 `PATH` に追加されたツールが見つからない可能性があり、特に Windows では見つかりません。771各エントリは 1 つのセッションを説明します。
605 772
606バックグラウンドセッションは、スーパーバイザーを開始したシェルから `ANTHROPIC_BASE_URL` またはそれに相当する Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry ベース URL 変数などのゲートウェイエンドポイント変数を継承しません。ディスパッチするシェルでゲートウェイがエクスポートされていない場合、セッションは保存された認証情報とプロジェクトディレクトリの[設定](/docs/ja/settings)内の `env` 値を使用します。プロジェクト内のすべてのセッションを[LLM ゲートウェイ](/docs/ja/llm-gateway)に指定するには、そのプロジェクトの `.claude/settings.json` `env` ブロックに `ANTHROPIC_BASE_URL` を設定します。773| フィールド | 存在する場合 | 説明 |
774| :----------------------- | :----------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
775| `cwd`、`kind`、`startedAt` | 常に | 作業ディレクトリ、`interactive` または `background`、および Unix ミリ秒での開始時刻 |
776| `id` | バックグラウンドセッション | `claude attach`、`claude logs`、`claude stop` で使用可能な短い ID |
777| `state` | バックグラウンドセッション | `working`、`blocked`、`done`、`failed`、`stopped` のいずれか。各値の意味については[スクリプトからセッション状態を読み取る](#read-session-state-from-a-script)を参照してください |
778| `pid`、`status` | プロセスが生きている間 | プロセス ID および `busy`、`waiting`、`idle` のいずれか |
779| `waitingFor` | `status` が `waiting` の場合 | セッションがブロックされている内容。承認のための `permission prompt`、Claude または MCP サーバーからの質問のための `input needed`、`sandbox request`、`worker request`、`dialog open` |
780| `sessionId`、`name` | 設定されている場合 | `sessionId` は [`claude --resume`](/docs/ja/sessions) で使用可能な完全なセッション UUID です。インタラクティブセッションの `name` は、セッションに名前を付けるか、その中でプランを受け入れるまで、その[デフォルト表示名](/docs/ja/sessions#name-your-sessions)です |
607 781
608ディスパッチするシェルでエクスポートされたゲートウェイ `ANTHROPIC_BASE_URL` はそのセッションのワーカーに到達し、`ANTHROPIC_CUSTOM_HEADERS` とそれらと一緒にエクスポートされた認証情報も到達します。スーパーバイザーが同じゲートウェイを持つ環境から開始された場合です。スーパーバイザーはエージェントビューを開くか、バックグラウンドセッションをディスパッチする最初のシェルからその環境をキャプチャするため、ゲートウェイシェルから開始するとそれにその環境を与えます。転送はまた、ディスパッチするディレクトリまたは `←` または `/background` でセッションからバックグラウンド化されたディレクトリにディスパッチされたセッションにのみ適用されます。`@repo` または `--cwd` で別のディレクトリにディスパッチすると、シェルのゲートウェイは実行されず、そのプロジェクトの `settings.json` `env` ブロックがエンドポイントを提供します。スーパーバイザーの環境が異なるゲートウェイまたはゲートウェイなしを実行する場合、ワーカーは 1 つの環境の認証情報を別の環境のエンドポイントと混ぜるのではなく、デフォルトエンドポイントに対して保存された認証情報を保持します。v2.1.203 より前は、ディスパッチシェルの `ANTHROPIC_BASE_URL` は削除されましたが、それと一緒にエクスポートされた `ANTHROPIC_API_KEY` は保持されたため、ゲートウェイのキーはデフォルトエンドポイントに送信され、すべてのリクエストは 401 で失敗しました。782<h3 id="read-session-state-from-a-script">
609 783 スクリプトからセッション状態を読み取る
610転送されたエンドポイントはそのライブプロセスにのみ適用され、ディスクに書き込まれることはありません。スーパーバイザーがアイドルセッションを停止し、後で再開すると、再開されたプロセスは設定から再度エンドポイントを読み取ります。ゲートウェイ `ANTHROPIC_AUTH_TOKEN` を使用すると、保存された認証情報にフォールバックし、ゲートウェイが発行した `ANTHROPIC_API_KEY` を使用すると、ゲートウェイが設定で設定されるまで認証に失敗する可能性があります。784</h3>
611
612各バックグラウンドセッションは独自の Claude Code プロセスであり、ターミナルではなくスーパーバイザーによって管理されます。アクティブに作業しているセッション、入力を待機しているセッション、またはターミナルが接続されているセッションはプロセスを実行し続けます。実行中のバックグラウンドシェルコマンド、subagent、動的ワークフロー、またはモニターはアクティブな作業としてカウントされるため、開発サーバーなどの長時間実行プロセスはセッションを生かし続けます。
613 785
614セッションが完了し、約 1 時間アタッチされていない状態で待機すると、スーパーバイザーはリソースを解放するためにプロセスを停止します。`Ctrl+T` で[ピン留めした](#organize-the-list)セッションは除外され、アイドル状態でもプロセスを実行し続けます。トランスクリプトと状態はディスク上に残り、次回アタッチ、ピーク表示、または返信するときに、スーパーバイザーは中断したところから新しいプロセスを開始します。すべてのセッションが完了し、ターミナルが接続されていない場合、スーパーバイザー自体が終了し、次回セッションをバックグラウンド化するか、エージェントビューを開くときに再度開始します。786`claude agents --json` は Claude Code の外からセッション状態を読み取るためのサポートされている方法です。例えば、ステータスバー、スケジューラー、またはバックグラウンド作業を監督する別の Claude セッションから。`claude agents --json --all` をポーリングします。これはプロセスが終了したセッションをリストし続け、各エントリの `state`、`status`、`waitingFor` を読み取ります。
615 787
616セッション自体がトップレベルで開始したバックグラウンド作業は、そのプロセスが停止、再開、または更新されるときに引き継がれます。Windows を含みます。そのセッション用に開始された次のプロセスはそれらを取得します。788| `state` | 意味 |
789| :----------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- |
790| `working` | ターンが実行中、またはセッションが [`/loop`](/docs/ja/scheduled-tasks) イテレーションや CI での待機など、独自に駆動する作業のステップ間にあります。`status` は、そのプロセスが現在 `busy` かどうかを示します |
791| `blocked` | セッションはあなたを待っています。それが尋ねた質問、権限またはサンドボックスの決定、あなただけが解決できるエラー（期限切れのログインなど）、またはプロンプトなしで開始した場合の最初のプロンプト。待機がライブプロセスで開いているプロンプトの場合、`waitingFor` がそれに名前を付けます |
792| `done` | 最後のターンがあなたが求めたものを完了し、セッションはあなたの次のプロンプトの準備ができています。プロセスがまだ生きているかどうかに関わらず |
793| `failed`、`stopped` | タスクがエラーで終了したか、セッションが停止されました |
617 794
618* その間に完了したバックグラウンドシェルコマンドは、その出力とともに完了として報告されます795ターンを完了し、次の指示を待っているセッションは `blocked` ではなく `done` を読み取ります。`blocked` は常にセッションが続行する前にあなたから何かが必要であることを意味します。
619* 動的ワークフローは中断したところから再開されます
620* [バックグラウンド subagent](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)は独自のトランスクリプトから再開されます
621 796
622v2.1.198 以降、引き継ぎは 3 つすべてをカバーしています。v2.1.198 より前は、シェルコマンドとワークフローのみをカバーしていたため、バックグラウンド subagent はプロセスで停止し、次回の起動時に失敗として報告されました。797`~/.claude/jobs/<id>/` の下のファイルは安定したインターフェースではありません。セッションまたは別のプログラムが `state`、`detail`、`tempo`、`needs` に書き込む値は、次の更新時に置き換えられます。
623 798
624プロセス内部にのみ状態が存在する作業は、引き継がれるのではなく、プロセスで停止します。これは subagent が開始したシェルコマンドであり、再開された subagent は再度開始でき、実行中の[モニター](/docs/ja/tools-reference#monitor-tool)はイベントストリームを別のプロセスに移動できません。799セッションが独自の言葉で進捗を報告するようにしたい場合は、`state.json` を編集する代わりに、例えば `$CLAUDE_JOB_DIR/tmp` の下など、独自のファイルを書き込むようにしてください。
625 800
626セッションを削除すると、それが引き継いだすべてのものが停止されます。セッションのすべてのバックグラウンド作業を引き継ぎの代わりにプロセスで停止するには、[`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/ja/env-vars#variables)環境変数を `1` に設定します。801<h2 id="how-background-sessions-are-hosted">
802 バックグラウンドセッションのホスティング方法
803</h2>
627 804
628再開されたプロセスは、タスク中に[worktree に移動した](#how-file-edits-are-isolated)セッションの会話を見つけます。トランスクリプトがセッションが開始した場所にない場合、Claude Code はリポジトリの登録済み worktree の下も確認します。v2.1.207 より前は、プロセスが停止した後にエージェントビューからそのセッションを再度開くと、元のプロンプトのみを含む空の会話が表示される可能性があり、トランスクリプトはディスク上に無傷のままでした。v2.1.207 以降でセッションを再度開くと、それを復旧します。805Claude Code は、エージェントビューに表示されているすべてのセッションをバックグラウンドセッションとして扱います。現在接続しているかどうかに関わらず、バックグラウンドセッションとして扱われます。これに対して、`claude` を直接実行して開始したセッションはそのターミナルに紐付けられ、ターミナルが閉じると終了します。ただし、[バックグラウンドに送信](#from-inside-a-session)することはできます。
629 806
630再開されたセッションが、Claude Code がトランスクリプトを空として誤読したため、元のプロンプトのみを表示して戻ってきた場合、会話トランスクリプトは削除される代わりに `.orphaned-` サフィックスで名前が変更されるため、マシンに残ります。807どのような種類のセッションにいるかを確認するには、[`/status`](/docs/ja/commands) を実行してください。バックグラウンドセッションでは、`Session kind` の行に `background job · attached` または `background job · unattended` と表示されます。ターミナルが接続されているかどうかによって異なります。その他のセッションでは `interactive` と表示されます。
631 808
632`←` を押して残された空の行で、プロンプトが与えられたことがない場合は、約 5 分後に完全に削除されるため、リストは自動的にクリアされます。`claude --bg` で開始されたセッションおよびトラストダイアログなどのセットアッププロンプトを待機しているセッションはこの方法では削除されません。809<h3 id="the-supervisor-process">
810 スーパーバイザープロセス
811</h3>
633 812
634ホストのメモリが不足している場合、スーパーバイザーはアイドル状態の非ピン留めセッションを最初に停止し、何も解放されない場合のみアイドル状態のピン留めセッションを停止します。813スーパーバイザーはバックグラウンドサービスで、バックグラウンドセッションを実行し、エージェントビューやターミナルを閉じた後もセッションが動作し続けるようにします。Claude Code は、セッションをバックグラウンドに送信するか、エージェントビューを開いた時点で最初にスーパーバイザーを起動します。自分で管理する必要はありません。
635 814
636スーパーバイザーはディスク上にインストールされた Claude Code バイナリを監視し、通常の[自動更新プログラム](/docs/ja/setup#auto-updates)がそれを置き換えた後、新しいバージョンに再開します。これはネットワークチェックではなく、ローカルファイルウォッチです。バックグラウンドセッションはデタッチされたプロセスであるため、再開を通じて実行し続け、新しいスーパーバイザーはそれらに再接続します。アイドル状態のピン留めセッションも新しいバージョンに再開されるため、再度アタッチすることなく更新を取得します。815各セッションはスーパーバイザーの下で独自の Claude Code プロセスであり、そのプロセスに何が起こるかはセッションの状態によって異なります。
637 816
638新しいスーパーバイザーが引き継ぐと、残りのアイドルセッションも新しいバージョンに再開されます。短い遅延の後、バックグラウンドで数個ずつ再開されます。この遅延により、再開を通じて接続されたターミナルが最初に再接続できます。アクティブに作業しているセッション、入力を待機しているセッション、またはターミナルが接続されているセッションは中断されません。次回そのプロセスが再開されるときに新しいバージョンに移動します。v2.1.206 より前は、スーパーバイザーは新しいバージョンごとに 1 分あたり数個のアイドルセッションのみを移動したため、セッションは更新後しばらくの間古いバージョンを実行し続ける可能性がありました。817* **動作中、権限プロンプトまたは他のダイアログで一時停止中、または接続中**：プロセスは実行を続けます。実行中のサブエージェント、ワークフロー、またはモニターは動作中としてカウントされます。
818* **終了したか、約 1 時間の間、あなたの次のメッセージを待機中で、未接続**：スーパーバイザーはリソースを解放するためにプロセスを停止します。ターンを終了して質問を投げかけたセッションは、あなたの次のメッセージを待機中としてカウントされます。会話はディスクに保存され、次回接続または返信するときに、セッションは中断したところから再開されます。`Ctrl+T` でセッションをピンして、プロセスの実行を継続させます。
819* **スーパーバイザーが実行中に予期せず終了した**：スーパーバイザーはプロセスを再起動します。自分でバックグラウンドに送信したセッションを `←` または `/background` で終了した場合、たとえば `kill` で終了した場合、再起動の代わりに停止済みとしてマークされます。シャットダウンで終了したセッションについては、[セッションがシャットダウン後に失敗または停止として表示される](#sessions-show-as-failed-after-shutdown) を参照してください。
820* **自動更新後**：スーパーバイザーは新しいバージョンに再起動し、アイドル状態のセッションをバックグラウンドで移動します。動作中、あなたを待機中、または接続中のセッションは中断されません。
639 821
640これらの再開は常にセッションをより新しいバージョンに移動するだけです。セッションのプロセスが開始されたバージョンより古い Claude Code バージョンを実行しているスーパーバイザーはそのプロセスをそのままにします。セッションはより新しいスーパーバイザーが引き継ぐまで、より新しいバージョンを実行し続けます。822セッションのプロセスが停止または再起動されると、Claude が開始したバックグラウンドシェルコマンド、動的ワークフロー、およびバックグラウンドサブエージェントは次のプロセスに引き継がれます。実行中のモニターとサブエージェントが開始したシェルコマンドはプロセスで停止します。セッションを削除すると、引き継がれたすべてのものが停止します。代わりにプロセスで停止させるには、[`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/ja/env-vars#variables) を `1` に設定してください。
641 823
642スーパーバイザーがセッションを再開している間に `claude attach` を実行すると、更新、スタール、またはマイグレーションのいずれであっても、失敗するのではなく置き換えプロセスを待機します。`Agent is updating to the new Claude Code…` などのステータス行は、待機している内容を名前付けし、経過秒数をカウントし、セッションの準備ができるとすぐにコマンドが接続されます。約 60 秒後、待機を停止してエラーを報告します。v2.1.205 より前は、`claude attach` は数秒後に再試行を停止し、セッションがまだ再開している間にエラーを出力しました。824スーパーバイザーとそのセッションは、インタラクティブセッションと同じ保存された認証情報で認証されます。セッションに到達する設定とシェル変数（`PATH` を含む）については、[設定とプロバイダー](#settings-and-provider) を参照してください。ゲートウェイエンドポイントについては、[LLM ゲートウェイ](#llm-gateway) を参照してください。
643 825
644<h3 id="where-state-is-stored">826<h3 id="where-state-is-stored">
645 状態が保存される場所827 状態の保存場所
646</h3>828</h3>
647 829
648セッション状態は Claude Code 設定ディレクトリの下に保存されます。[`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars)を設定した場合、スーパーバイザーは `~/.claude` の代わりにそのディレクトリを使用し、独自のセッションを持つ別のインスタンスとして実行されます。830セッション状態は Claude Code 設定ディレクトリの下に保存されます。[`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars) を設定した場合、スーパーバイザーは `~/.claude` の代わりにそのディレクトリを使用し、独自のセッションを持つ別のインスタンスとして実行されます。
649 831
650| パス | 内容 |832| パス | 内容 |
651| :------------------------------- | :--------------------------------------------------------- |833| :------------------------------- | :---------------------------------------------------------------------------------------------------------------- |
652| `~/.claude/daemon.log` | スーパーバイザーログ |834| `~/.claude/daemon.log` | スーパーバイザーログ |
653| `~/.claude/daemon/roster.json` | 実行中のバックグラウンドセッションのリスト。再開後に再接続するために使用 |835| `~/.claude/daemon/roster.json` | 実行中のバックグラウンドセッションのリスト。再起動後の再接続に使用されます |
654| `~/.claude/jobs/<id>/state.json` | エージェントビューに表示されるセッションごとの状態 |836| `~/.claude/jobs/<id>/state.json` | エージェントビューに表示されるセッションごとの状態。ファイルを解析する代わりに、[`claude agents --json`](#read-session-state-from-a-script) を通じて読み取ってください |
655| `~/.claude/jobs/<id>/tmp/` | セッションごとのスクラッチディレクトリ。ここへの書き込みは権限確認を促しません。セッションが削除されると削除されます |837| `~/.claude/jobs/<id>/tmp/` | セッションごとのスクラッチディレクトリ。Claude の `Write` および `Edit` 呼び出しはここで権限を求めるプロンプトを表示しません。セッションが削除されると削除されます |
656
657各バックグラウンドセッションには `CLAUDE_JOB_DIR` 環境変数が `~/.claude/jobs/<id>` ディレクトリに設定されているため、セッションが実行するシェルコマンドは並列セッションと衝突することなく `$CLAUDE_JOB_DIR/tmp` に一時ファイルを書き込むことができます。
658 838
659この状態を直接ファイルを読むことなく検査するには、`claude daemon status` を実行します。スーパーバイザーに到達可能かどうか、そのプロセス ID とバージョン、ソケットディレクトリ、およびライブのバックグラウンドセッション数を報告します。839各バックグラウンドセッションには、`CLAUDE_JOB_DIR` 環境変数が `~/.claude/jobs/<id>` ディレクトリに設定されているため、セッションが実行するシェルコマンドは、並列セッションと衝突することなく、`$CLAUDE_JOB_DIR/tmp` に一時ファイルを書き込むことができます。
660 840
661このコマンドは、実行中のスーパーバイザーが呼び出した `claude` とは異なるバージョンにある場合に警告を表示します。これはスーパーバイザーがまだ再開していない更新後に発生します。警告は両方のバージョンを表示し、`claude daemon stop --any` を実行して新しいバージョンを取得するよう指示します。Claude Code が OS サービスとしてインストールされている場合、推奨されるコマンドはフラグなしの `claude daemon stop` です。841ファイルを直接読み取らずにこの状態を検査するには、`claude daemon status` を実行してください。スーパーバイザーに到達可能かどうか、そのプロセス ID とバージョン、ソケットディレクトリ、およびライブバックグラウンドセッションの数を報告します。
662 842
663セッションはそのバージョンの不一致を無傷で生き残ります。セッションの `state.json` を更新する古い Claude Code バージョンは、認識しないフィールドを保持し、セッションをリストに保持します。`roster.json` のセッションリストは同じルールに従います。それを書き直す古いバージョンは、新しいバージョンが書き込んだフィールドを保持するため、新しいバージョンで開始されたセッションは到達可能なままで、スーパーバイザーが再開した後も入力を受け付け続けます。v2.1.200 より前は、古いバージョンは書き直し時にそれらのフィールドをドロップできました。843このコマンドは、実行中のスーパーバイザーが呼び出した `claude` とは異なるバージョンにある場合に警告を表示します。これは、スーパーバイザーがまだ再起動していない更新後に発生します。警告は両方のバージョンを表示し、`claude daemon stop --any` を実行して新しいバージョンを取得するよう指示します。Claude Code が OS サービスとしてインストールされている場合、提案されるコマンドはフラグなしの `claude daemon stop` です。
664 844
665Windows では、`claude daemon status` はデーモンのパイプキーファイルがロックされているか読み取り不可の場合、一般的な接続失敗を報告する代わりに、基になるファイルエラーを表示します。845セッションはそのバージョンの不一致を無傷で生き残ります。セッションの `state.json` を更新する古い Claude Code バージョンは、認識しないフィールドを保持し、セッションをリストに保ちます。ロスターの `roster.json` のセッションリストは同じルールに従うため、新しいバージョンで開始されたセッションは到達可能なままで、スーパーバイザーが再起動した後も入力を受け付け続けます。
666 846
667<h3 id="turn-off-agent-view">847<h3 id="turn-off-agent-view">
668 エージェントビューをオフにする848 エージェントビューをオフにする
669</h3>849</h3>
670 850
671バックグラウンドエージェントとエージェントビューを完全にオフにするには、`disableAgentView`[設定](/docs/ja/settings)を `true` に設定するか、`CLAUDE_CODE_DISABLE_AGENT_VIEW` 環境変数を設定します。管理者は[マネージド設定](/docs/ja/permissions#managed-settings)を通じてこれを強制できます。851バックグラウンドエージェントとエージェントビューを完全にオフにするには、`disableAgentView` [設定](/docs/ja/settings) を `true` に設定するか、`CLAUDE_CODE_DISABLE_AGENT_VIEW` 環境変数を設定してください。管理者は [管理設定](/docs/ja/managed-settings) を通じてこれを強制できます。
672 852
673<h2 id="troubleshooting">853<h2 id="troubleshooting">
674 トラブルシューティング854 トラブルシューティング
692 バックグラウンド化が `Background this session?` ダイアログを表示する872 バックグラウンド化が `Background this session?` ダイアログを表示する
693</h3>873</h3>
694 874
695`←` を押して現在のセッションをバックグラウンドに移すと `Background this session?` ダイアログが表示される場合、セッションには実行中の [monitor](/docs/ja/tools-reference#monitor-tool) などの、バックグラウンドセッションに移動できない実行中の作業があり、Claude Code はそれを静かに停止しません。ダイアログは停止される作業を名前で表示し、別に転送されるタスクをカウントします。`/tasks` を実行してすべての実行中のものを確認し、確認してバックグラウンド化するか、`Stay` を選択して作業が完了するまで待機します。[セッション内から](#from-inside-a-session)を参照して、どのタスク種が転送され、どのタスク種が停止されるかを確認してください。875`←` を押して現在のセッションをバックグラウンドに移すと、Claude Code が `Background this session?` ダイアログを表示する場合、セッションには実行中の作業があり、バックグラウンド化によって停止、再開、または無人で実行されたままになる可能性があり、Claude Code はそれを実行する前に確認します：
876
877* **移動できない作業**：セッションには、実行中の [monitor](/docs/ja/tools-reference#monitor-tool) などのバックグラウンドセッションに移動できない作業があります。ダイアログは Claude Code が停止する作業を名前で表示し、別に転送されるタスクをカウントします。
878* **実行中のサブエージェントを持つワークフロー**：[動的ワークフロー](/docs/ja/workflows)にはまだ実行中のサブエージェントがあります。ワークフロー自体は転送されますが、実行中のサブエージェントは最初から再開され、ダイアログはその数を表示します。
879* **自動アーティファクト返信**：Claude が[アーティファクトのコメントに自動で返信している](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own)場合があります。これらの返信はバックグラウンドセッションで続行され、ダイアログはそのことを表示します。
880
881`/tasks` を実行してすべての実行中のものを確認し、確認してバックグラウンド化するか、`Stay` を選択して作業が完了するまで待機します。[バックグラウンド化するときに転送されるもの](#what-carries-over-when-you-background)を参照して、どのタスク種が転送され、どのタスク種が Claude Code によって停止されるかを確認してください。
696 882
697<h3 id="prompt-rejected-as-too-short">883<h3 id="prompt-rejected-as-too-short">
698 プロンプトが短すぎるとして拒否される884 プロンプトが短すぎるとして拒否される
701ディスパッチ入力は会話の開始ではなく、タスクの説明を期待しています。4 文字未満のプロンプトは `Too short` ヒントで拒否されるため、誤ったキー入力がセッションを開始しません。セッションで何をしたいかを説明してください。例えば `investigate the flaky checkout test` のようにします。887ディスパッチ入力は会話の開始ではなく、タスクの説明を期待しています。4 文字未満のプロンプトは `Too short` ヒントで拒否されるため、誤ったキー入力がセッションを開始しません。セッションで何をしたいかを説明してください。例えば `investigate the flaky checkout test` のようにします。
702 888
703<h3 id="sessions-show-as-failed-after-shutdown">889<h3 id="sessions-show-as-failed-after-shutdown">
704 シャットダウン後、セッションが失敗として表示される890 シャットダウン後、セッションが失敗または停止として表示される
705</h3>891</h3>
706 892
707マシンをシャットダウンまたは再起動すると、実行中のバックグラウンドセッションが停止するため、次にエージェントビューを開くときに失敗として表示されます。それらのいずれかにアタッチ、ピーク表示、または返信すると、セッションは中断したところから再開します。893マシンをシャットダウンまたは再起動すると、実行中のバックグラウンドセッションが停止します。入力を待機していたセッションは、戻ってきたときに `Needs input` の下に留まります。その他の実行中のセッションについては、エージェントビューが表示する内容は、最後に進捗があってからどのくらい前かによって異なります：
894
895* 48 時間以内の場合、セッションは失敗として表示されます。アタッチまたは返信すると、中断したところから再開します。
896* 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>` でそのフッタープロンプトなしで再開します。
897
898[トランスクリプトクリーンアップ](/docs/ja/settings-reference#cleanupperioddays)が停止したセッションの保存された会話を削除した場合、Claude Code は行を開くことを拒否します。メッセージは再開するものがないことを示しています。`claude rm <id>` は行を削除します。ただし、[保持されたケース](#what-deleting-a-session-removes)で説明されている場合を除き、`claude respawn <id>` は元のプロンプトを再度実行します。[このセッションの保存された会話はディスク上にもはやありません](/docs/ja/errors#this-sessions-saved-conversation-is-no-longer-on-disk)を参照してください。
708 899
709スリープだけではこれは発生しません。セッションはスリープ全体で保持され、スーパーバイザーはウェイク時にそれらに再接続します。900スリープだけではセッションを停止しません。セッションはスリープ全体で保持され、スーパーバイザーはウェイク時にそれらに再接続します。
710 901
711<h3 id="opening-a-session-says-the-conversation-is-already-open">902<h3 id="opening-a-session-says-the-conversation-is-already-open">
712 セッションを開くと、会話が既に開いていると表示される903 セッションを開くと、会話が既に開いていると表示される
713</h3>904</h3>
714 905
715停止した行を開く場合、その会話が別の実行中の非インタラクティブ Claude Code プロセス（例えば、同じ会話のバックグラウンドワーカーがまだシャットダウン中）によっても開かれている場合、2 つのプロセスが同じトランスクリプトに書き込むことができないため、行のプロセスを開始する代わりに `This conversation is already open in another running Claude session` が表示されます。既に会話を開いているセッションで返信するか、それを終了して行を再度開きます。拒否された試みで入力した返信は失われません。セッションが次に開始するときに送信されます。9062 つのプロセスが同じトランスクリプトに書き込むことはできません。停止したセッションの保存された会話が別の実行中の Claude Code プロセスで既に開いている場合、Claude Code はセッション自体のプロセスを開始することを拒否します。何が表示されるかは、会話を保持しているものによって異なります：
907
908* 例えば `claude --resume` または `/resume` で会話を再開したターミナル：行は `Open in a terminal` を表示し、そこで続行するというヒントが表示され、行を開くと `Can't open — this session is running in another terminal` が表示されます。そのターミナルで続行するか、終了して行を再度開きます。
909* 別の非インタラクティブ Claude Code プロセス（例えば、同じ会話のバックグラウンドセッションプロセスがまだ終了していない）：行を開くと `This conversation is already open in another running Claude session` が表示されます。そのプロセスを使用するか、終了するまで待機して行を再度開きます。
910
911Claude Code は拒否された試みで入力した返信を保存し、セッションが次に開始するときに送信します。
912
913<h3 id="opening-a-session-says-it-has-no-saved-transcript">
914 セッションを開くと、保存されたトランスクリプトがないと表示される
915</h3>
716 916
717v2.1.203 より前は、この状態は 2 番目のプロセスを開始していました。そのプロセスは `currently running as a background agent` エラーで終了し、行は失敗として表示されました。917[別の会話からバックグラウンド化された](#from-inside-a-session)停止したセッションが最初の応答が完了する前に停止した場合、再開するものはありません。最初の応答が完了するまで、会話はバックグラウンド化された会話にのみ存在します。`claude attach` は `This session has no saved transcript` で開くことを拒否します。
918
919エージェントビューでは、その行を開くとリストの下に `Press enter again to restart this session fresh` が表示されます。同じ行で再度 `Enter` を押して、空の会話でセッションを再開するか、シェルから `claude respawn <id>` を実行します。
920
921元の会話は無傷です。`claude --resume` で再開するか、それで作業を続けます。詳細については、[エラーリファレンス](/docs/ja/errors#this-session-has-no-saved-transcript)を参照してください。
922
923<h3 id="the-terminal-host-died-or-the-session-stopped-responding">
924 ターミナルホストが停止したか、セッションが応答しなくなった
925</h3>
926
927[スーパーバイザー](#the-supervisor-process)は各バックグラウンドセッションのターミナルを独自のホストプロセスで実行します。そのプロセスが停止したか応答しなくなった場合、Claude Code は理由を表示し、再開を提供します。どちらの場合も会話は保存され、再開はそれを再開します。[エラーリファレンス](/docs/ja/errors#terminal-host-process-died)は完全なメッセージを引用しています。
928
929Claude Code は、`Enter` からまたは `claude attach` から実行される[シェルコマンド](#run-a-shell-command)を実行している行を再開しません。これはコマンドを再度実行するためです。行のメッセージと `claude attach` の両方は、コマンドが再度実行されないことを示しています。
930
931<h4 id="terminal-host-died">
932 ターミナルホストが停止した
933</h4>
934
935Linux と WSL では、スーパーバイザーはセッションを開くかどうかに関わらず数秒ごとに各ホストプロセスをチェックし、プロセスが終了しているがスーパーバイザーへの接続が閉じられていない場合、セッションを失敗としてマークします。
936
937* エージェントビューでは、行は `terminal host process died — press Enter to restart` を表示します。それで `Enter` を押すと、Claude Code はセッションを新しいホストプロセスで再開します。
938* シェルから、`claude attach <id>` は既に失敗としてマークされたセッションを再開します。それ以外の場合は原因を報告して終了し、`claude attach <id>` を再度実行するよう指示します。
939
940<h4 id="session-isn’t-responding">
941 セッションが応答していない
942</h4>
943
944スーパーバイザーが開いた状態を受け入れるが、約 10 秒間出力が到着しない場合、Claude Code は試みを終了し、再開を提供します。単にスタールしたセッション（例えば、マシンスリープ全体）はこの提供に到達しません。スーパーバイザーは[開く時に自動的にそれを再開します](#read-session-state)。
945
946* エージェントビューでは、フッターは `Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).` を表示します。同じ行で再度 `Enter` を押すと、Claude Code は応答しないプロセスを停止し、セッションを再開します。その 2 番目の押下なしに何も停止しません。
947* シェルから、`claude attach <id>` は原因を報告して終了し、`claude stop <id>` を実行してから `claude attach <id>` を実行するよう指示します。
718 948
719<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">949<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">
720 セッションが `possibly low memory` ノートで開始前に失敗する950 セッションが `possibly low memory` ノートで開始前に失敗する
721</h3>951</h3>
722 952
723v2.1.199 以降、バックグラウンドセッションのプロセスが開始を完了する前に終了し、ホストのメモリが不足している場合、行のステータスは終了を名前で表示し、`possibly low memory — free some up and retry` を追加します。以前のバージョンでは、この失敗に対して終了理由のみを表示していました。953バックグラウンドセッションのプロセスが開始を完了する前に終了し、ホストのメモリが不足している場合、行のステータスは終了を名前で表示し、`possibly low memory — free some up and retry` を追加します。
724 954
725ノートは仮説であり、確認された原因ではありません。Claude Code はプロセスがエラーを書き込まずに静かに終了し、シグナルによって停止されず、ホストがその時点で低メモリを報告した場合にのみ追加します。プロセスが終了前にエラーを書き込んだ場合、行はそのエラーを代わりに表示します。955ノートは仮説であり、確認された原因ではありません。Claude Code はプロセスがエラーを書き込まずに静かに終了し、シグナルによって停止されず、ホストがその時点で低メモリを報告した場合にのみ追加します。プロセスが終了前にエラーを書き込んだ場合、行はそのエラーを代わりに表示します。
726 956
727マシンのメモリを解放してから、行にアタッチ、ピーク表示、または返信して、スーパーバイザーがセッションの新しいプロセスを開始します。メモリが低いままの場合、スーパーバイザーは[アイドルセッションを停止](#the-supervisor-process)して、独自にリソースを解放します。957マシンのメモリを解放してから、行にアタッチ、ピーク表示、または返信して、スーパーバイザーがセッションの新しいプロセスを開始します。メモリが低いままの場合、スーパーバイザーは[アイドルセッションを停止](#the-supervisor-process)して、独自にリソースを解放し、他のセッションを停止しても何も解放されない場合は、保持されたピン留めセッションも停止します。
728 958
729<h3 id="agent-view-says-the-background-service-did-not-respond">959<h3 id="agent-view-says-the-background-service-did-not-respond">
730 エージェントビューがバックグラウンドサービスが応答しなかったと表示される960 エージェントビューがバックグラウンドサービスが応答しなかったと表示される
740 970
741スーパーバイザーが起動しても接続を受け入れることができない場合は、独自に終了してロックを解放するため、次の `claude agents` は手動停止なしで新しいものを開始します。上記の手順は、実行中のスーパーバイザーがスタールしている場合に適用されます。971スーパーバイザーが起動しても接続を受け入れることができない場合は、独自に終了してロックを解放するため、次の `claude agents` は手動停止なしで新しいものを開始します。上記の手順は、実行中のスーパーバイザーがスタールしている場合に適用されます。
742 972
973コマンドが代わりに記録されたプロセスがスーパーバイザーとして検証できなかったと言って終了する場合は、報告されたプロセス ID を確認してください。それがあなたが所有するスーパーバイザーの場合は、自分で停止してから、`~/.claude/daemon.lock` を削除して、次の `claude agents` が新しく開始するようにします。
974
743Windows では、スーパーバイザーが停止要求に応答しない場合、コマンドはそのプロセス ID を出力します。`taskkill /PID <pid>` でそのプロセスを終了して復旧を完了します。`--keep-workers` を渡した場合、バックグラウンドセッションは引き続き保持されます。975Windows では、スーパーバイザーが停止要求に応答しない場合、コマンドはそのプロセス ID を出力します。`taskkill /PID <pid>` でそのプロセスを終了して復旧を完了します。`--keep-workers` を渡した場合、バックグラウンドセッションは引き続き保持されます。
744 976
745<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">977<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">
746 ディスパッチが `Could not resolve authentication method` で失敗する978 ディスパッチが `Could not resolve authentication method` で失敗する
747</h3>979</h3>
748 980
749バックグラウンドディスパッチが `Could not resolve authentication method` で失敗し、インタラクティブセッションが正常に認証される場合、ディスパッチを受け取ったワーカーは認証情報を取得しませんでした。スーパーバイザーは[プリウォーミングされたワーカー](#the-supervisor-process)を割り当てるときに新しい認証情報スナップショットを提供するため、このエラーはスーパーバイザープロセス自体で利用可能な保存された認証情報がないことを意味します。`/login` を実行したか、API キーを設定したことを確認してから、スーパーバイザーを停止してください：981バックグラウンドディスパッチが `Could not resolve authentication method` で失敗し、インタラクティブセッションが正常に認証される場合、ディスパッチを受け取ったワーカーは認証情報を取得しませんでした。バックグラウンドセッションは[スーパーバイザー](#the-supervisor-process)から認証情報を取得するため、このエラーはスーパーバイザープロセス自体で利用可能な保存された認証情報がないことを意味します。`/login` を実行したか、API キーを設定したことを確認してから、スーパーバイザーを停止してください：
750 982
751```bash theme={null}983```bash theme={null}
752claude daemon stop --any --keep-workers984claude daemon stop --any --keep-workers
768 macOS でバックグラウンドセッションがローカルネットワークホストに到達できない1000 macOS でバックグラウンドセッションがローカルネットワークホストに到達できない
769</h3>1001</h3>
770 1002
771macOS 15 以降では、ローカルネットワークアクセス権限を付与するまで、システムはプロセスがローカルネットワーク上のデバイスに到達することをブロックします。v2.1.198 より前は、バックグラウンドセッションホストはその権限をリクエストしなかったため、LAN アドレスをターゲットとするコマンドは、同じコマンドがフォアグラウンドターミナルで機能していても `connect: no route to host` で失敗しました。v2.1.198 以降、バックグラウンドセッションでローカルネットワークアドレスに接続する最初のコマンドは、Claude Code の macOS ローカルネットワークアクセス権限プロンプトをトリガーします。一度許可すると、これらのコマンドはフォアグラウンドターミナルと同じ方法で LAN ホストに到達します。1003macOS 15 以降では、システムはローカルネットワークアクセス権限を付与するまで、プロセスがローカルネットワーク上のデバイスに到達することをブロックします。そのため、LAN アドレスをターゲットとするコマンドは、同じコマンドがフォアグラウンドターミナルで機能していても、バックグラウンドセッションで `connect: no route to host` で失敗する可能性があります。バックグラウンドセッションでローカルネットワークアドレスに接続する最初のコマンドは、Claude Code の macOS ローカルネットワークアクセス権限プロンプトをトリガーします。一度許可すると、これらのコマンドはフォアグラウンドターミナルと同じ方法で LAN ホストに到達します。
772 1004
773<h3 id="a-session-is-slow-to-respond-after-attaching">1005<h3 id="a-session-is-slow-to-respond-after-attaching">
774 セッションがアタッチ後に応答が遅い1006 セッションがアタッチ後に応答が遅い
775</h3>1007</h3>
776 1008
777セッションが完了し、約 1 時間アタッチされていない状態で待機すると、スーパーバイザーはリソースを解放するためにプロセスを停止します。アタッチすると、中断したところから新しいプロセスが開始され、プロセスが再起動している間にセッションにすぐに切り替わります。作業中または入力を待機しているセッション、または[ピン留めされた](#organize-the-list)セッションはこの方法で停止されることはありません。セッションを `Ctrl+T` でピン留めして、応答性を保つことができます。1009セッションが完了し、約 1 時間アタッチされていない状態で待機すると、スーパーバイザーはリソースを解放するためにプロセスを停止します。アタッチすると、中断したところから新しいプロセスが開始され、プロセスが再起動している間にセッションにすぐに切り替わります。作業中、入力を待機しているセッション、パーミッションプロンプトまたは別のダイアログで一時停止しているセッション、または[ピン留めされた](#organize-the-list)セッションはこの方法で停止されることはありません。セッションを `Ctrl+T` でピン留めして、応答性を保つことができます。
778 1010
779プロセスが開始している間、セッションのトランスクリプトの最後の画面が `Session is starting` ノートとともに表示され、ライブセッションは準備ができるとすぐにそれを置き換えます。1011プロセスが開始している間、Claude Code はセッションのトランスクリプトの末尾を、ライブセッションが描画する方法でフォーマットして表示します。マークダウン、ハイライトされたコードブロック、ツール呼び出しは薄暗い行として表示され、`Session is starting` ノートを持つ薄暗いプロンプト領域の上に表示されます。ライブセッションは準備ができるとすぐにそれを置き換えます。
780 1012
781<h3 id="claude/worktrees/-is-filling-up">1013<h3 id="claude/worktrees/-is-filling-up">
782 `.claude/worktrees/` が満杯になっている1014 `.claude/worktrees/` が満杯になっている
783</h3>1015</h3>
784 1016
785エージェントビューでセッションを削除すると、Claude が作成したワークツリーが削除されます。安全に削除できないワークツリーは[セッション行を保持](#organize-the-list)して、孤立しないようにします。`claude rm` はコミットされていない変更があるワークツリーを保持し、そのセッション行を保持し、保持されたパスを出力します。プロジェクトディレクトリで `git worktree list` を使用して残りのエントリをリストし、各エントリを `git worktree remove <path>` で削除します。[ワークツリーをクリーンアップする](/docs/ja/worktrees#clean-up-worktrees)を参照してください。1017エージェントビューでセッションを削除すると、Claude が作成したワークツリーが削除されます。ただし、[いくつかの削除はワークツリーを保持するか、そのディレクトリをディスク上に残す](#what-deleting-a-session-removes)ため、孤立したディレクトリが蓄積する可能性があります。Git がもはや認識しないディレクトリは `git worktree list` に表示されないため、それらを手動で削除します。
1018
1019プロジェクトディレクトリで `git worktree list` を使用して孤立したエントリをリストし、各エントリを `git worktree remove <path>` で削除します。[ワークツリーをクリーンアップする](/docs/ja/worktrees#clean-up-worktrees)を参照してください。
786 1020
787<h2 id="limitations">1021<h2 id="limitations">
788 制限事項1022 制限事項
792 1026
793* **レート制限が適用される**：バックグラウンドセッションはインタラクティブセッションと同じようにサブスクリプション使用量を消費するため、10 個のエージェントを並行して実行するとクォータが 10 倍速く消費されます。1027* **レート制限が適用される**：バックグラウンドセッションはインタラクティブセッションと同じようにサブスクリプション使用量を消費するため、10 個のエージェントを並行して実行するとクォータが 10 倍速く消費されます。
794* **セッションはローカル**：バックグラウンドセッションはマシンで実行され、スリープ中は保持されますが、マシンがシャットダウンすると停止します。1028* **セッションはローカル**：バックグラウンドセッションはマシンで実行され、スリープ中は保持されますが、マシンがシャットダウンすると停止します。
795* **Claude が作成した worktrees はエージェント view のセッションで削除される**：セッションが独自の worktree でファイルを編集した場合、セッションを削除する前に変更をコミットしてください。コミットがどこにもプッシュされていない worktree はセッションと一緒に保持されます。`claude rm` は未コミットの変更がある worktree をセッションと一緒に保持し、自分で作成した worktree はそのまま残されます。1029* **Claude が作成した worktrees はエージェント view のセッションで削除される**：セッションが独自の worktree でファイルを編集した場合、セッションを削除する前に変更をコミットしてください。[削除によって worktree が保持される場合もあります](#what-deleting-a-session-removes)。
796 1030
797<h2 id="related-resources">1031<h2 id="related-resources">
798 関連リソース1032 関連リソース
799</h2>1033</h2>
800 1034
801Claude を並列実行する他の方法については、以下を参照してください。1035Claude を並列実行する他の方法、および実行するセッション間で検出結果を渡す方法については、以下を参照してください。
802 1036
803* [エージェントを並列実行](/docs/ja/agents)：エージェントビューとサブエージェント、エージェントチーム、ワークツリーを比較1037* [エージェントを並列実行](/docs/ja/agents)：エージェントビューとサブエージェント、エージェントチーム、ワークツリーを比較
1038* [クロスセッションメッセージング](/docs/ja/cross-session-messaging)：セッション間で検出結果を相互に渡す
804* [Agent teams](/docs/ja/agent-teams)：互いにメッセージを送信する複数のセッションを調整1039* [Agent teams](/docs/ja/agent-teams)：互いにメッセージを送信する複数のセッションを調整
805* [Claude Code on the web](/docs/ja/claude-code-on-the-web)：ローカルではなく、マネージドクラウド環境でセッションを実行1040* [Claude Code on the web](/docs/ja/claude-code-on-the-web)：ローカルではなく、マネージドクラウド環境でセッションを実行
806 1041
811Agent view はリサーチプレビュー中に急速に進化しました。古い Claude Code バージョンを使用している場合、このページの一部の動作が異なる可能性があります。特に、`claude agents` はまだサポートしていないフラグを `unknown option` エラーで拒否します。下の表は各フラグと動作がいつ追加されたかをリストしています。1046Agent view はリサーチプレビュー中に急速に進化しました。古い Claude Code バージョンを使用している場合、このページの一部の動作が異なる可能性があります。特に、`claude agents` はまだサポートしていないフラグを `unknown option` エラーで拒否します。下の表は各フラグと動作がいつ追加されたかをリストしています。
812 1047
813| バージョン | 変更 |1048| バージョン | 変更 |
814| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1049| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
1050| v2.1.268 | [削除が拒否される](#what-deleting-a-session-removes)場合、git または `WorktreeRemove` フックが worktree を削除できなかったため、メッセージは原因を名前で示し、フックがどのように終了したか、その stderr の開始を含みます。リポジトリの `.claude/worktrees/` 下のリンクされた worktree で、追跡ファイルへのコミットされていない変更がなく、その中にネストされたリポジトリがなく、他のセッションのレコードがそれを名前で示していない場合、セッションを再度削除すると、agent view から、または `claude rm <id> --force-remove-worktree <worktree-id>` でディレクトリが削除されます。このリリース前は、行は `worktree could not be removed (WorktreeRemove hook failed)` または git のエラーのみを表示し、フックの stderr はデバッグログにのみ移動し、再度削除するのは同じ方法で拒否されました。 |
1051| v2.1.260 | [セッションをバックグラウンド化する](#from-inside-a-session)場合、他のセッションの [agent リスト](/docs/ja/cross-session-messaging#see-which-sessions-claude-can-reach)は会話をバックグラウンドセッションとして 1 回表示し、それへのメッセージはもはや移動元のターミナルに到達しません。このリリース前は、そのターミナルは会話の名前の下で 2 番目の対話的なセッションとしてリストされたままになる可能性があり、移動前に会話にメッセージを送信したセッションはそのターミナルへの配信を続けました。 |
1052| v2.1.260 | [削除がプッシュされていないコミットで拒否される](#what-deleting-a-session-removes)場合、メッセージは worktree のブランチを名前で示し、プッシュされていないコミット数を示し、セッションを再度削除すると worktree とそのコミットが破棄されます。このリリース前は、拒否は `worktree has commits that are not pushed anywhere` のみを示し、再度削除するのは同じ方法で拒否され、セッションを削除するにはコミットをプッシュするか worktree を手動で削除する必要がありました。 |
1053| v2.1.257 | `←` は [アタッチされたセッションから切り離され、`/btw` オーバーレイが開いている間](#attach-to-a-session)、回答の途中でも、オーバーレイは次にアタッチするときに再度開きます。このリリース前は、`←` はオーバーレイが開いている間は切り離されませんでした。 |
1054| v2.1.257 | [`claude --resume <session-id> --bg`](#from-your-shell) を実行する場合、Claude Code はそのセッションを独自の ID で続行するか、新しい ID でコピーを開始し、理由を説明する `note:` 行を出力します。`--continue`、裸の `--resume`、および `--resume` と名前またはパスは同じメモで コピーを開始します。このリリース前は、`--resume` と `--bg` は常に新しい ID でコピーを開始し、何も言いませんでした。 |
1055| v2.1.257 | `←` で開いた agent view からセッションをディスパッチする場合、Claude Code は [ターゲットディレクトリが `permissions.defaultMode` を通じて設定する権限モード](#permission-mode)でそれを開始します。ディレクトリが設定しない場合、来元のセッションの権限モードが適用されます。このリリース前は、ディスパッチされたセッションは常に来元のセッションの権限モードで開始され、それをオーバーライドしました。 |
1056| v2.1.257 | Agent view の `Ctrl+S`、`Ctrl+T`、`Ctrl+G` は [あなたの `keybindings.json` に従います](#keyboard-shortcuts)。`Ctrl+S` と `Ctrl+T` は `Agents` コンテキストの `agents:switchView` と `agents:togglePin` アクションを通じて、`Ctrl+G` は `Chat` コンテキストの `chat:externalEditor` バインディングを通じて。このリリース前は、agent view は `keybindings.json` を無視し、これらのキーは固定されていました。 |
1057| v2.1.257 | [バックグラウンドサービス](#the-supervisor-process)を開始すると、2 つの障害原因から回復します。macOS npm インストールでは、自己更新中の開始は [インストールを待機します](/docs/ja/errors#eacces-when-starting-a-background-session)。バイナリを置き換えている間に npm が配置するプレースホルダーを実行する代わりに。Windows では、マシンが最後にブートする前に書き込まれた古い `daemon.lock`、またはそのレコードされたプロセス ID が現在別のプロセスに属している場合、置き換えられます。このリリース前は、macOS の開始はインストールウィンドウ中に `Error: claude native binary not installed.` で失敗し、Windows ロックは `~/.claude/daemon.lock` を削除するまで [`exited before it became reachable`](/docs/ja/errors#background-service-exited-before-it-became-reachable) で失敗するたびに開始されました。 |
1058| v2.1.257 | 別の Claude Code プロセスが npm 更新をダウンロード中にバックグラウンドセッションを開くか、ディスパッチする場合、Claude Code は [最大 2 分間待機し続けます](/docs/ja/errors#eacces-when-starting-a-background-session)。インストールが実行され、その後 `Claude Code is being updated by npm on this machine` と言って失敗します。このリリース前は、待機は 10 秒で停止し、ダウンロードがまだ実行中の間に `Couldn't start the background service` で開始が失敗しました。 |
1059| v2.1.257 | [クロスセッションメッセージ](/docs/ja/cross-session-messaging#control-inbound-messages)をあなたの承認のために保持しているバックグラウンドセッションは、その `Needs input` 行に `approve message from` を表示し、送信者のアドレスと送信者が主張する名前を表示します。このリリース前は、行は `Needs input` に移動しましたが、前のテキストを保持したため、`claude agents` の何もが待機中のメッセージまたはその送信者を名前で示しませんでした。 |
1060| v2.1.257 | `Ctrl+S` でスタッシュされたプロンプトは、開かれたバックグラウンドセッション内で [セッションと一緒に保持されます](#what-persists-across-restarts)。そのため、`Ctrl+S` はセッションのプロセスが停止して再度開始された後にそれを復元します。このリリース前は、スタッシュは実行中のプロセスにのみ存在し、セッションがアイドル状態になってプロセスが停止するのに十分な時間が経過したとき、または停止して再度開かれたときに失われました。 |
1061| v2.1.251 | [worktree に移動していない](#how-file-edits-are-isolated)バックグラウンドセッションでは、Claude とそれが生成するサブエージェントはリンクされた git worktree 内のファイルを編集できます。 |
1062| v2.1.251 | Claude Code はディスパッチ元のシェルでエクスポートされたクラウドプロバイダーゲートウェイ（`ANTHROPIC_VERTEX_BASE_URL` または `ANTHROPIC_BEDROCK_BASE_URL` とその認証バイパスフラグなど）を [セッションのワーカー](#llm-gateway)に `ANTHROPIC_BASE_URL` と同じ条件で転送します。このリリース前は、そのようなゲートウェイを通じてのみ認証されたシェルからバックグラウンド化またはディスパッチした場合、セッションが行ったすべてのリクエストは失敗しました。エンドポイントとフラグがその環境から削除されたため。 |
1063| v2.1.251 | 別の Claude Code プロセスが [プラグインマーケットプレイス](/docs/ja/plugin-marketplaces)をリフレッシュしている間にバックグラウンドセッションが開始される場合（[マーケットプレイス自動更新](/docs/ja/discover-plugins#configure-auto-updates)を実行しているシブリングセッションなど）、Claude Code はそのマーケットプレイスのプラグインを利用可能に保ちます。このリリース前は、そのようなセッションはそのマーケットプレイスのスキル、エージェント、フック、MCP サーバーなしで開始でき、その全実行中そのままになる可能性がありました。 |
1064| v2.1.248 | [ディスパッチ入力](#keyboard-shortcuts)の `Shift+Enter` は改行を挿入し、メインプロンプトと一致し、`Ctrl+Enter` はディスパッチして、`?` オーバーレイが `ctrl+enter to start and open` をリストするターミナルで直ちにアタッチします。このリリース前は、`Shift+Enter` はディスパッチしてアタッチしました。 |
1065| v2.1.248 | [セッションを削除する](#what-deleting-a-session-removes)ことは、worktree のコミットが既にあなたの `origin` リモートのデフォルトブランチのローカルコピーにあり、メインチェックアウトがそのブランチをチェックアウトしている場合に成功します。このリリース前は、削除は `has commits that are not pushed anywhere` で拒否されました。 |
1066| v2.1.248 | `←` または `/background` でバックグラウンド化されたセッションは、実行中に worktree の [`git worktree lock`](/docs/ja/worktrees#clean-up-subagent-and-background-session-worktrees) を保持します。このリリース前は、バックグラウンド化はロックを解放し、クリーンアップまたは `git worktree remove` は実行中のセッションの下で worktree を削除できました。 |
1067| v2.1.248 | あなたの入力を待機していなかったバックグラウンドセッションが、最後のアクティビティから 48 時間以上後に見つかった場合（マシンが数日間オフだった後など）、[停止として表示されます](#sessions-show-as-failed-after-shutdown)。`ended while the background service was off` で、`Enter` はそれを再開する前に確認を求めます。このリリース前は、そのようなセッションはリストの上部にソートされた新しい障害として再度表示され、単一の `Enter` は数週間前の会話をフォアグラウンドに引き込みました。 |
1068| v2.1.248 | 停止された行を開く場合、その会話を [別のターミナルで再開した](#opening-a-session-says-the-conversation-is-already-open)場合、`Can't open — this session is running in another terminal` で拒否され、行は `Working` の下に表示する代わりに `Open in a terminal` を表示します。このリリース前は、行を開くと同じ会話に書き込む 2 番目のプロセスが開始されました。 |
1069| v2.1.248 | バックグラウンドセッションが `PermissionRequest` または `PreToolUse` フックが無効な回答を出力している間に権限決定を待機している場合、[フックイベントとスキーマエラーをその行に名前で示します](#peek-and-reply)。このリリース前は、行は保留中のリクエストのみを表示しました。 |
1070| v2.1.248 | Windows では、`claude agents` は以前のプログラムが win32-input-mode で残したターミナルタブで起動されたときにキーボードに応答します。このリリース前は、Claude Code はそのようなタブが送信するキーレコードをデコードしませんでした。 |
1071| v2.1.247 | Linux と WSL では、[ターミナルホストプロセスが死亡した](#the-terminal-host-died-or-the-session-stopped-responding)セッションは数秒以内に理由で失敗します。出力を生成しない開始は約 10 秒後に再開オファーで終了し、行の `Enter` はセッションをその会話で再開します。`claude attach <id>` は原因を報告して終了します。このリリース前は、そのようなセッションを開くと `opening… · esc to cancel` が無期限に表示され、`claude attach <id>` はエラーを報告せずに待機しました。 |
1072| v2.1.246 | npm インストールでは、[バックグラウンドサービス](#the-supervisor-process)が `npm install -g @anthropic-ai/claude-code` がバイナリを置き換えている間に開始に失敗する場合、Claude Code はインストールが完了するのを最大 10 秒間待機して再試行してから [`EACCES: permission denied`](/docs/ja/errors#eacces-when-starting-a-background-session) を報告します。 |
1073| v2.1.246 | [バックグラウンドサービス](#the-supervisor-process)プロセスがエラーを出力した後に死亡する場合、Claude Code は障害を報告し、[サービスの最初のエラー行を引用します](/docs/ja/errors#background-service-exited-before-it-became-reachable)。 |
1074| v2.1.246 | マシンが [バックグラウンドサービス](#the-supervisor-process)の開始中にスリープ状態になる場合、Claude Code は失敗する代わりに開始を 1 回再試行します。 |
1075| v2.1.246 | Claude Code は新しく開始された [バックグラウンドサービス](#the-supervisor-process)が生きているが接続を受け入れるのが遅い場合、45 秒ではなく約 2 分間待機します。 |
1076| v2.1.246 | [バックグラウンドサービス](#the-supervisor-process)はホームディレクトリから開始するため、macOS と Linux では削除または移動された開始ディレクトリはもはや開始をブロックしません。 |
1077| v2.1.246 | `/fork` は [完全な会話をコピーします](#copy-the-session-with-%2Ffork)。それ自体がコピーとして開始され、それ以来新しいプロンプトを記録していないセッションから。アタッチした `/fork` コピー、`←` または `/background` がそれをバックグラウンドに移動した後に再アタッチされたセッション、または `claude --resume <id> --fork-session` で開始されたセッション。このリリース前は、そのようなセッションで新しいプロンプトを送信する前に `/fork` を実行した場合、Claude Code は通常の確認を出力しましたが、空の会話でコピーを開始しました。そのようなセッションを `←` または `/background` でバックグラウンドに移動すると、同じ方法で会話が失われました。 |
1078| v2.1.246 | ディスパッチしたばかりのセッションを開く場合、そのワーカープロセスがまだ開始中（例えば、その行の `Enter` を押す）、Claude Code はプロセスを待機してからアタッチします。このリリース前は、プロセスがまだ開始中に `Enter` を押した場合、Claude Code は [`Session <id> was stopped while the respawn was in flight`](/docs/ja/errors#session-was-stopped-while-the-respawn-was-in-flight) でセッションを停止できました。 |
1079| v2.1.246 | 名前付きセッションを [バックグラウンド化する](#from-inside-a-session)場合、Claude Code はそれを 1 回リストし、同じ会話を再度バックグラウンド化する場合、新しい行の名前に番号を付けます（`my-session (2)` など）。既存の行は名前を保持します。このリリース前は、`←` を押したターミナルは `claude agents --json` で同じ名前の下で 2 番目のセッションとして表示される可能性があり、同じ会話を再度バックグラウンド化した場合、Claude Code は同じ名前の下に別の行を追加しました。 |
1080| v2.1.239 | [vim エディターモード](/docs/ja/interactive-mode#vim-editor-mode)がオンの場合、agent view の入力で `Esc` を押すと INSERT から NORMAL モードに切り替わり、テキストを保持し、メインプロンプトと一致します。NORMAL モードでテキストがまだ入力にある場合、`Esc` を押すとそれをクリアし、空の入力で `Esc` を押すと終了します。[`Esc` ショートカット](#keyboard-shortcuts)が説明するように。このリリース前は、`Esc` は入力をクリアしました。 |
1081| v2.1.233 | GitLab マージリクエストにリンクされたセッションの場合、Claude Code は行のラベルを GitLab の `!1234` 参照構文で書き込みます。マージリクエストの URL を [ディスパッチ入力](#filter-sessions)に貼り付けてそのセッションを選択することもできます。このリリース前は、ラベルは `#1234` としてレンダリングされ、貼り付けられたマージリクエスト URL は最初のプロンプトに URL が含まれている場合にのみセッションと一致しました。 |
1082| v2.1.227 | [セッションを削除する](#what-deleting-a-session-removes)ことは、別のライブ Claude Code セッションがその worktree ディレクトリ内で実行されている間、セッションと worktree を保持します。Agent view は行に `not deleted` を表示し、フッターに理由を表示し、`claude rm` は `kept <id>` を理由で出力します。これは他のセッションのプロセス ID を名前で示します。このリリース前は、セッションを削除すると、他のセッションがまだそれで作業している間に worktree が削除されました。 |
1083| v2.1.225 | 信頼していないディレクトリの `claude agents` は、agent view が開く前に、`claude` が起動時に表示するのと同じ [ワークスペーストラストダイアログ](/docs/ja/permissions#project-allow-rules-and-workspace-trust)を表示します。信頼を受け入れるとそのワークスペースの信頼が保存されます。拒否すると agent view を開かずに終了します。このリリース前は、`claude agents` は確認なしに開かれたため、そこからディスパッチしたセッションは信頼するよう求められたことがないディレクトリで実行されました。<br /><br />リストがディレクトリでグループ化されている場合、行の上にマウスを置くと [ディスパッチターゲット](#dispatch-to-a-specific-directory)を変更せずにハイライトされます。矢印キーまたはクリックで行を選択するとターゲットが変更されます。このリリース前は、別のプロジェクトのセッションの上にマウスを移動すると、次にディスパッチされたセッションが開始するディレクトリが静かに変更されました。 |
1084| v2.1.221 | `/status` は `Session kind` 行を表示します。バックグラウンドセッションでは `background job · attached` または `background job · unattended`（ターミナルがアタッチされているかどうかに応じて）、他のセッションでは `interactive`。このリリース前は、`/status` はセッション種別を報告しませんでした。<br /><br />`/fork`。Claude Code は [コピーに指示します](#from-inside-a-session)。その作業を元のセッションの作業から分離するために。コピーはコード変更を行う前に独自の worktree を作成し、元のセッションが作業している worktree から離れ、その作業がその作業に基づいている場合、元のブランチに基づいて新しいブランチを作成します。正確な条件については、リンクされたセクションを参照してください。このリリース前は、コピーは分離命令を受け取らず、元のセッションがまだ作業している worktree またはチェックアウトを編集する可能性がありました。<br /><br />[vim エディターモード](/docs/ja/interactive-mode#vim-editor-mode)がオンの場合、`u` で空にプロンプトを元に戻した直後に `←` を押すと、テキストを削除またはプロンプト履歴を移動するのと同じ確認を求め、2 番目の押下でのみ切り替わります。このリリース前は、押下は直ちに切り替わりました。 |
1085| v2.1.219 | [vim エディターモード](/docs/ja/interactive-mode#vim-editor-mode)がオンの場合、空のプロンプトで `←` を押すと INSERT と同様に NORMAL モードから agent view を開き、フッターの `←` ヒントは NORMAL モードで表示されます。このリリース前は、ジェスチャーとヒントは INSERT のみで、NORMAL モードでは空のプロンプトで `←` は何もしませんでした。Claude Code がセッションをバックグラウンド化するのを待機している間に入力に入力すると、`Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` で切り替えがキャンセルされます。入力されたドラフトが失われないようにするため。 |
1086| v2.1.218 | 削除がプロンプトを空にした後、またはプロンプト履歴を移動した後、2 秒以内に `←` を押すと、`Press ← again to open agents` または `Press ← again to go back to agents` がアタッチされたセッションで表示され、少なくとも 1 秒後の 2 番目の押下でのみ切り替わります。このリリース前は、押下は直ちに切り替わりました。貼り付けられたまたはスクリプト化された入力内に到達する `←` はもはや切り替えをトリガーしません。フォアグラウンドセッションを `←` でバックグラウンド化すると、`Your conversation moved to the background` がリストの上に表示され、agent view のルートで `Esc` は終了する代わりにその会話に戻ります。ダブル `Ctrl+C` は終了のままです。会話を再度開くことができない場合、Claude Code は終了し、それの `claude --resume` コマンドを出力します。Windows では、アタッチから約半秒以内に押された `←` は `Ambiguous ←, press again to detach` を表示し、2 番目の押下で切り離されます。 |
1087| v2.1.217 | セッションの行のプルリクエストバッジは、Claude Code がターミナルハイパーリンクサポートを検出できない場合（例えば SSH または tmux 経由）でも、ハイパーリンクとしてレンダリングされます。[`FORCE_HYPERLINK=0`](/docs/ja/env-vars) を設定してプレーンテキストとしてレンダリングします。このリリース前は、サポートが検出されない場合、バッジはプレーンテキストとしてレンダリングされました。 |
1088| v2.1.216 | `/fork`。[確認](#from-inside-a-session)は 1 行で、コピーの状態、agent view 行の名前、`claude attach` のセッション ID を表示し、`runs in the origin tree` または `edits this checkout` で終了します。コピーがメインワーキングツリーで実行されるか、開いているチェックアウトを編集する場合のみ。名前をクリックするとこのセッションをバックグラウンド化し、コピーのセッションで agent view を開きます。確認はもはやコピーの継承された権限モードを再度述べません。以前のバージョンはクリック可能な名前のない複数行の確認を出力しました。<br /><br />入力が必要。`/install-github-app` と `/mcp` 設定リストは、誰もアタッチされていない間に実行され、セッションを `Needs input` の下に表示し、行がコマンドを名前で示し、アタッチして再度コマンドを実行すると続行されます。v2.1.208 から v2.1.215 まで、それらはその状態で完全に拒否されました。<br /><br />`--agent` 復元。[バックグラウンド化された `--agent` セッション](#from-your-shell)を再開または再開すると、エージェントのシステムプロンプトとツール制限が復元され、ワークスペースが信頼されている場合、セッション独自のディレクトリでエージェントを最初に検索します。エージェントがもはや存在しないセッションはデフォルトツールとシステムプロンプトで続行し、デフォルトエージェントに静かに戻る代わりに、表示される警告で開きます。<br /><br />`Ctrl+X`。2 回押すと、停止試行が失敗する場合でも、セッションが削除されます。失敗した停止が保留中の削除をキャンセルする代わりに、ワーカープロセスが死亡していた削除されたセッションは次のリフレッシュで再度表示されません。<br /><br />Worktree 削除。worktree ディレクトリが git リポジトリに属さないセッションは削除できます。このリリース前は、そのようなセッションを削除するすべての試行が拒否されました。既に消えているディレクトリはすぐにクリアされます。Agent view ダブルプレスはまだファイルがあるディレクトリを削除し、フック作成ディレクトリの `WorktreeRemove` フックを実行します。別のセッションのレコードもそれを名前で示さない限り。`claude rm` はファイルが残っている場合、常にそのようなディレクトリを保持します。 |
1089| v2.1.214 | `←` または `/background` でバックグラウンド化され、実行中の何もなくアイドル状態で放置されたセッションは、他のアイドルセッションと同様にプロセスが停止されます。バックグラウンドサービスが無期限に実行されたままになる代わりに。完了したセッションは、バックグラウンドサービスがアイドル状態になった後、`claude rm` または agent view から削除できます。ディレクトリがディスパッチされたディレクトリが git リポジトリではない場合（マルチリポワークスペースフォルダなど）、worktree に入ったセッションは、worktree 自体が git リポジトリに属する場合、agent view から削除できます。クリーンアップはディスパッチ元のディレクトリではなく worktree から解決されるため。両方の削除は以前のすべての試行で拒否されました。停止されたセッションを再度開くと、トランスクリプトストア内のフォルダが読み取れない場合でも、保存された会話が復元されます。 |
1090| v2.1.213 | `/install-github-app`、[`/mcp`](/docs/ja/mcp)設定リスト、MCP 認証アクションはバックグラウンドセッションで機能し、ターミナルがアタッチされている間、誰もアタッチされていない場合にのみ拒否されます。アタッチしてコマンドを再度実行するよう指示するメッセージ。v2.1.208 から v2.1.212 まで、ターミナルがアタッチされている場合でも拒否されました。 |
1091| v2.1.212 | [対話的なセッションの `/fork`](#from-inside-a-session)は会話を新しいバックグラウンドセッションにコピーし、独自の行として表示されます。来元のセッションの後に名前が付けられるか、名前のないセッションのプロンプトされたフォークの場合、フォークプロンプトの後に。元のセッションは実行を続けます。以前のフォークされたサブエージェント動作の `/fork` は `/subtask` に移動しました。[agent view がオフになっている](#turn-off-agent-view)場合、`/fork` はフォークされたサブエージェント動作を保持します。最初のプロンプトを待機している焦点を当てた行は `space to send it a prompt` を表示します。`Ctrl+J` は拡張キーレポートを持つターミナルのディスパッチ入力に改行を挿入します。キープレスは以前は無視されました。`?` オーバーレイはショートカットをリストします。対話的なセッションのフッターヒント `←` は、バックグラウンドセッションが完了し、入力が必要なセッションがない場合、簡潔に `N done` を表示します。Agent view で裸の `/resume` を入力すると、agent view を開いたリポジトリの過去のセッションのピッカーが開きます。削除されたセッションを含む。1 つを選択するとバックグラウンドセッションとして再開されます。このリリース前は、`/resume` は agent view で利用できず、削除されたセッションは `claude --resume` または対話的なセッションから `/resume` でのみ到達可能でした。ターゲット化、スコープ化、制限されたフォームは、以前のバージョンがすべてのフォームに表示した `attach to a session to run it` ヒントを保持します。サンドボックスネットワークホストプロンプト、MCP 入力リクエスト、または管理設定プロンプトを待機しているセッションは、agent view と `claude agents --json` で `Needs input` として表示されます。Claude からの質問は `waitingFor: input needed` を報告します。権限プロンプトの代わりに。停止されたセッションにアタッチすると、ライブセッションがレンダリングする方法でトランスクリプトがフォーマットされます。生のテキストの代わりに。保存されたトランスクリプトが予期しない場所にある停止されたセッションは、保存されたトランスクリプトの最後の手段スキャンを通じて再開され、保存されたトランスクリプトがない行を開くと `Press enter again to restart this session fresh` が表示されます。2 番目の押下で新しく再開されます。v2.1.211 は拒否を表示し、agent view から再開する方法がありませんでした。 |
1092| v2.1.211 | 停止されたセッションを起動するか、それが実行されるディレクトリから返信することで、シェルのゲートウェイ `ANTHROPIC_BASE_URL` を再度転送します。新しいディスパッチと同じ条件で。ゲートウェイ `ANTHROPIC_AUTH_TOKEN` を通じて認証されたセッションはゲートウェイで再開されます。`Not logged in` を報告する代わりに。別の会話からバックグラウンド化された停止されたセッションにアタッチし、最初の応答が完了する前に、`This session has no saved transcript` で拒否されます。静かに同じセッション ID の下で空白の会話を開始する代わりに。agent view から同じ行を開くと、フッターに拒否が表示されました。Claude Code の外からプロセスを終了する `←` または `/background` セッションはそれを停止としてマークします。スーパーバイザーが再開する代わりに、ディスク上に既に記録されている停止は、送信した返信がまだ配信を待機していない限り、尊重されます。クラッシュ後に再開されたセッションはそれが再開されたことが通知され、再開された `←` または `/background` セッションは約 1 時間より古い中断された応答を再開しません。セッション命名返信がラベル付けする代わりに、プロンプトに答えるか拒否する場合（例えば、ほとんどがリンクであるプロンプトの場合）、破棄され、行はプロンプトテキストから取得された名前を保持します。Worktree git がもはや認識しないセッションを削除すると成功し、worktree ディレクトリをディスク上に残し、そのパスを名前で示します。すべての試行が拒否される代わりに。拒否された削除は、セッションの行に理由を表示します。worktree を削除できなかった場合の基礎となる git エラーを含む。行が静かに再度表示される代わりに。 |
1093| v2.1.210 | `claude attach` はバックグラウンドサービスが開始または再接続している間に待機します。`job not found` または `still starting` エラーで失敗する代わりに、完了中に終了したセッションを報告し、遅い接続中に行われたターミナルリサイズを接続が完了するときに適用します。プロンプトフッターの `←` 入力が必要なカウントはすべてのプロバイダーに表示されます。以前に `← for agents` フォームを表示していたサードパーティプロバイダーを含む。`←` でセッションをバックグラウンド化すると、Claude のタスクリストがバックグラウンドセッションに転送されます。ドロップする代わりに。`←` を押した行は、選択が移動した後も太字で薄暗くない名前を保持します。`claude agents --effort` は `ultracode` を受け入れます。静かにドロップする代わりに。 |
815| v2.1.208 | プロセスが停止したセッションにアタッチすると、プロセスが開始する間、`Session is starting` ノートのみではなく、トランスクリプトの最後の画面分が表示されます。バックグラウンドサービスに到達できないか送信に失敗したため配信できない返信は保存され、プロセスが再度開始するときにセッションの次のプロンプトとして送信されます。このリリース前は、バックグラウンドサービスに到達できない間に失われた返信は破棄されました。独自のバイナリが更新によって置き換えられたプロセスは、Claude Code が再開されるまで失敗する代わりに、インストール済みの `claude` ランチャーまたはディスク上の最新バージョンからスーパーバイザーを開始できます。古いバージョンを実行しているスーパーバイザーは、新しいバージョンで開始されたアイドルセッションを独自の古いバイナリに再開しません。セッションを削除すると、セッションが worktree を別のブランチに移動した後でも worktree が削除され、worktree にプッシュされていないコミットがある場合、または別のセッションがそれを要求する場合、worktree をセッション行と一緒に保持します。コミットを破棄したり worktree を孤立させたりする代わりに。`/install-github-app` とその `/mcp` 設定リストおよび認証アクションはバックグラウンドセッションで代替案を名前で示すメッセージで拒否されます。v2.1.208 のみでは、`/model` ピッカーは同じ方法で拒否され、入力された `/model <name>` はデフォルトモデルも保存する代わりに、そのセッションのみを切り替えました。 |1094| v2.1.208 | プロセスが停止したセッションにアタッチすると、プロセスが開始する間、`Session is starting` ノートのみではなく、トランスクリプトの最後の画面分が表示されます。バックグラウンドサービスに到達できないか送信に失敗したため配信できない返信は保存され、プロセスが再度開始するときにセッションの次のプロンプトとして送信されます。このリリース前は、バックグラウンドサービスに到達できない間に失われた返信は破棄されました。独自のバイナリが更新によって置き換えられたプロセスは、Claude Code が再開されるまで失敗する代わりに、インストール済みの `claude` ランチャーまたはディスク上の最新バージョンからスーパーバイザーを開始できます。古いバージョンを実行しているスーパーバイザーは、新しいバージョンで開始されたアイドルセッションを独自の古いバイナリに再開しません。セッションを削除すると、セッションが worktree を別のブランチに移動した後でも worktree が削除され、worktree にプッシュされていないコミットがある場合、または別のセッションがそれを要求する場合、worktree をセッション行と一緒に保持します。コミットを破棄したり worktree を孤立させたりする代わりに。`/install-github-app` とその `/mcp` 設定リストおよび認証アクションはバックグラウンドセッションで代替案を名前で示すメッセージで拒否されます。v2.1.208 のみでは、`/model` ピッカーは同じ方法で拒否され、入力された `/model <name>` はデフォルトモデルも保存する代わりに、そのセッションのみを切り替えました。 |
816| v2.1.207 | ピークパネルは行が切り詰める文で開きます。例えば、あなたを待っているセッションの正確な質問など。ブロックされたセッションがどのくらい待機しているかを、ステータス文と質問に同じタイムスタンプをプレフィックスする代わりに、単一の `waiting 3m` 行として表示します。ディスパッチ入力に同じテキストを再度貼り付けると、2 番目のテキストを追加する代わりに、折りたたまれた `[Pasted text #N]` プレースホルダーが展開されます。プランを受け入れることで名前が付けられたバックグラウンドセッションはその行にその名前を表示します。worktree に移動したバックグラウンドセッションは、プロセスが agent view から再開されるときに会話を保持します。 |1095| v2.1.207 | ピークパネルは行が切り詰める文で開きます。例えば、あなたを待っているセッションの正確な質問など。ブロックされたセッションがどのくらい待機しているかを、ステータス文と質問に同じタイムスタンプをプレフィックスする代わりに、単一の `waiting 3m` 行として表示します。ディスパッチ入力に同じテキストを再度貼り付けると、2 番目のテキストを追加する代わりに、折りたたまれた `[Pasted text #N]` プレースホルダーが展開されます。プランを受け入れることで名前が付けられたバックグラウンドセッションはその行にその名前を表示します。worktree に移動したバックグラウンドセッションは、プロセスが agent view から再開されるときに会話を保持します。 |
817| v2.1.206 | 行の概要は行の残りの幅を埋め、64 列ではなくターミナルの右端でのみ切り詰められます。スーパーバイザーが新しい Claude Code バージョンに再開した後、残りのアイドルバックグラウンドセッションを 1 分あたり数個ではなくバックグラウンドでそのバージョンに再開します。`Ctrl+X` または `claude rm` でセッションを削除すると、スーパーバイザーのセッションリストからもクリアされるため、スーパーバイザーの再開後に行が再度表示されません。 |1096| v2.1.206 | 行の概要は行の残りの幅を埋め、64 列ではなくターミナルの右端でのみ切り詰められます。スーパーバイザーが新しい Claude Code バージョンに再開した後、残りのアイドルバックグラウンドセッションを 1 分あたり数個ではなくバックグラウンドでそのバージョンに再開します。`Ctrl+X` または `claude rm` でセッションを削除すると、スーパーバイザーのセッションリストからもクリアされるため、スーパーバイザーの再開後に行が再度表示されません。ディスパッチシェルでエクスポートされた `CLAUDE_CODE_EXTRA_BODY` リクエストボディオーバーライドはバックグラウンドセッションに到達します。無視される代わりに。 |
818| v2.1.205 | 行の概要はセッション自体の 1 行レポートを表示し、64 列で切り詰められます。生のツール呼び出しまたは `done/total` カウントの代わりに表示されます。ディレクトリグループ化された行は色付きの状態単語で開きます。ピークパネルは完全なステータス文で開き、あなたを待っているセッションの場合、返信入力の上にその正確な質問が表示されます。`gh` でプルリクエストを編集、コメント、クローズ、またはレディマークするセッションはそれにリンクされます。プルリクエストを作成またはチェックアウトするセッションだけではなく、プッシュはローカルブランチ名が一致しない場合でもプルリクエストをリンクし、作成コマンドの出力がインライン制限を超えたプルリクエストもリンクされます。読み取り可能なテキストがないターンは、セッションの前の状態を保持し、`Working` に戻すのではなく、フリップします。`claude attach` は再開中のセッションを約 60 秒間待機し、理由を名前で示すステータス行を表示します。失敗する代わりに。 |1097| v2.1.205 | プロンプトフッターの `←` ヒントは、通常の `claude` セッションで、あなたを待機しているバックグラウンドエージェントをカウントします。例えば、`← 2 agents`。行の概要はセッション自体の 1 行レポートを表示し、64 列で切り詰められます。生のツール呼び出しまたは `done/total` カウントの代わりに表示されます。ディレクトリグループ化された行は色付きの状態単語で開きます。ピークパネルは完全なステータス文で開き、あなたを待っているセッションの場合、返信入力の上にその正確な質問が表示されます。`gh` でプルリクエストを編集、コメント、クローズ、またはレディマークするセッションはそれにリンクされます。プルリクエストを作成またはチェックアウトするセッションだけではなく、プッシュはローカルブランチ名が一致しない場合でもプルリクエストをリンクし、作成コマンドの出力がインライン制限を超えたプルリクエストもリンクされます。読み取り可能なテキストがないターンは、セッションの前の状態を保持し、`Working` に戻すのではなく、フリップします。`claude attach` は再開中のセッションを約 60 秒間待機し、理由を名前で示すステータス行を表示します。失敗する代わりに。 |
819| v2.1.203 | ディスパッチシェルでエクスポートされたゲートウェイ `ANTHROPIC_BASE_URL` は、スーパーバイザーがそのゲートウェイ環境を共有する場合、それと同じディレクトリにディスパッチされたセッションに到達します。これは、それと一緒にエクスポートされた API キーが保持されている間にドロップされるのではなく、到達します。ディスパッチシェルの `PATH` は各セッションのワーカーに適用されます。サブエージェントが実行中に `←` を押すと、10 秒後に再開する代わりに、それらが完了するのを待ちます。空のリストは常にセクションヘッダーを各ヘッダーの下に説明とともに表示します。ディスパッチ入力で `@` を入力すると、起動リポジトリの登録済み git worktrees もそのディレクトリツリー内に存在するものをリストします。`effortLevel` 設定から継承された努力は、ディスパッチで固定されるのではなく、その設定への後の編集に従います。別の実行中のセッションで会話がすでに開いている停止されたセッションを開くと、行が失敗するのではなく、メッセージで拒否されます。agent view で利用できないコマンドは、入力に入力されたテキストを残します。git リポジトリの外で失敗する `WorktreeCreate` フックは、セッションがファイルを編集するのをもはやブロックしません。 |1098| v2.1.203 | ディスパッチシェルでエクスポートされたゲートウェイ `ANTHROPIC_BASE_URL` は、スーパーバイザーがそのゲートウェイ環境を共有する場合、それと同じディレクトリにディスパッチされたセッションに到達します。これは、それと一緒にエクスポートされた API キーが保持されている間にドロップされるのではなく、到達します。ディスパッチシェルの `PATH` は各セッションのワーカーに適用されます。サブエージェントが実行中に `←` を押すと、10 秒後に再開する代わりに、それらが完了するのを待ちます。空のリストは常にセクションヘッダーを各ヘッダーの下に説明とともに表示します。ディスパッチ入力で `@` を入力すると、起動リポジトリの登録済み git worktrees もそのディレクトリツリー内に存在するものをリストします。`effortLevel` 設定から継承された努力は、ディスパッチで固定されるのではなく、その設定への後の編集に従います。別の実行中のセッションで会話がすでに開いている停止されたセッションを開くと、行が失敗するのではなく、メッセージで拒否されます。agent view で利用できないコマンドは、入力に入力されたテキストを残します。git リポジトリの外で失敗する `WorktreeCreate` フックは、セッションがファイルを編集するのをもはやブロックしません。 |
820| v2.1.202 | `/rename` または `Ctrl+R` でバックグラウンドセッションに設定された名前は、スーパーバイザーがそのプロセスを停止して再開しても、セッションがディスパッチされた時の名前に戻るのではなく、永続化されます。 |1099| v2.1.202 | `/rename` または `Ctrl+R` でバックグラウンドセッションに設定された名前は、スーパーバイザーがそのプロセスを停止して再開しても、セッションがディスパッチされた時の名前に戻るのではなく、永続化されます。 |
821| v2.1.200 | 古い Claude Code バージョンが `roster.json` のセッションリストを書き直す場合、新しいバージョンによって書き込まれたフィールドを保持し、既存の `state.json` 保証と一致するため、新しいバージョンで開始されたセッションはスーパーバイザーが再開した後も入力を受け入れ続けます。応答を停止したセッションを開くと、スーパーバイザーはそのプロセスを再開し、セッションは中断された応答を中断した場所から続行します。 |1100| v2.1.200 | 古い Claude Code バージョンが `roster.json` のセッションリストを書き直す場合、新しいバージョンによって書き込まれたフィールドを保持し、既存の `state.json` 保証と一致するため、新しいバージョンで開始されたセッションはスーパーバイザーが再開した後も入力を受け入れ続けます。応答を停止したセッションを開くと、スーパーバイザーはそのプロセスを再開し、セッションは中断された応答を中断した場所から続行します。Agent view は `agents` の後に配置された `--plugin-dir` フラグをディスパッチされたセッションと同様に独自のサブエージェントとスキルオートコンプリートに適用します。 |
822| v2.1.199 | プロセスが低メモリホストで起動を完了する前に終了するバックグラウンドセッションは、単に終了理由だけではなく、その行ステータスに `possibly low memory — free some up and retry` を表示します。`←` または `/background` でセッションをバックグラウンド化すると、その `/color` が新しい行に引き継がれます。 |1101| v2.1.199 | プロセスが低メモリホストで起動を完了する前に終了するバックグラウンドセッションは、単に終了理由だけではなく、その行ステータスに `possibly low memory — free some up and retry` を表示します。`←` または `/background` でセッションをバックグラウンド化すると、その `/color` が新しい行に引き継がれます。 |
823| v2.1.198 | Agent view はバックグラウンドセッションが入力を必要とする場合、完了する場合、または失敗する場合に `preferredNotifChannel` を通じて通知を送信し、`agent_needs_input` または `agent_completed` タイプで `Notification` フックを発火します。`claude attach <id>` 内の `←` と `/exit` はシェルに終了するのではなく agent view に戻ります。`Ctrl+Z` はシェルに戻ります。バックグラウンドセッションは作業を worktree に分離し、コミットして独自の分離ブランチをプッシュし、`main` または `master` をプッシュしません。完了時に最初に確認するのではなく、ドラフトプルリクエストを開きます。`/login` は agent view で実行され、サインインダイアログを開きます。`Background work is running` 終了ダイアログは `Move to background and exit` を提供します。終了ハンドオフはバックグラウンドサブエージェントもカバーし、失敗として報告される代わりに次の起動時にトランスクリプトから再開します。`claude --bg` を `-p` または `--print` と組み合わせるとエラーで拒否されます。 |1102| v2.1.198 | Agent view はバックグラウンドセッションが入力を必要とする場合、完了する場合、または失敗する場合に `preferredNotifChannel` を通じて通知を送信し、`agent_needs_input` または `agent_completed` タイプで `Notification` フックを発火します。`claude attach <id>` 内の `←` と `/exit` はシェルに終了するのではなく agent view に戻ります。`Ctrl+Z` はシェルに戻ります。バックグラウンドセッションは作業を worktree に分離し、コミットして独自の分離ブランチをプッシュし、`main` または `master` をプッシュしません。完了時に最初に確認するのではなく、ドラフトプルリクエストを開きます。`/login` は agent view で実行され、サインインダイアログを開きます。`Background work is running` 終了ダイアログは `Move to background and exit` を提供します。終了ハンドオフはバックグラウンドサブエージェントもカバーし、失敗として報告される代わりに次の起動時にトランスクリプトから再開します。`claude --bg` を `-p` または `--print` と組み合わせるとエラーで拒否されます。バックグラウンドセッションホストは、`connect: no route to host` で失敗する代わりに、最初の LAN アクセス時に macOS ローカルネットワーク権限をリクエストします。 |
824| v2.1.196 | 単一の `←` 押下がフォアグラウンドセッションをバックグラウンド化します。以前のバージョンでは 2 回の押下が必要で、フッターヒントと確認がありました。`claude agents` に渡された `--dangerously-skip-permissions` は、静かにドロップされるのではなく、バイパス免責事項を表示します。対話的なセッションで名前を付けたことがない場合は、セッションリストと `claude agents --json` で `my-app-3f` などのデフォルト名を持ちます。バックグラウンドシェルコマンドと動的ワークフローはセッションのプロセスが停止、再開、または更新されても生き残ります。Windows を含みます。ハンドオフをオフにするには `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` を設定します。再開時に空として誤読されたトランスクリプトは削除される代わりに `.orphaned-` サフィックスで名前が変更されます。 |1103| v2.1.196 | 単一の `←` 押下がフォアグラウンドセッションをバックグラウンド化します。以前のバージョンでは 2 回の押下が必要で、フッターヒントと確認がありました。`claude agents` に渡された `--dangerously-skip-permissions` は、静かにドロップされるのではなく、バイパス免責事項を表示します。対話的なセッションで名前を付けたことがない場合は、セッションリストと `claude agents --json` で `my-app-3f` などのデフォルト名を持ちます。バックグラウンドシェルコマンドと動的ワークフローはセッションのプロセスが停止、再開、または更新されても生き残ります。Windows を含みます。ハンドオフをオフにするには `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` を設定します。再開時に空として誤読されたトランスクリプトは削除される代わりに `.orphaned-` サフィックスで名前が変更されます。 |
825| v2.1.195 | 実行中の作業は Windows でセッションをバックグラウンド化するときに転送されます。`CLAUDE_DISABLE_ADOPT=1` を設定して代わりに停止します。`Completed` グループは残りの垂直スペースを埋め、ヘッダーは短いターミナルでコンパクトになります。古い Claude Code バージョンはもはや新しいセッションの `state.json` フィールドをドロップしたり、それらのセッションを `claude agents` から隠したりしません。停止されたセッションにアタッチすると、最大 5 秒間の空白画面を表示する代わりに直ちに切り替わります。接続を受け入れることができないスーパーバイザーは独自に終了してロックを解放します。 |1104| v2.1.195 | 実行中の作業は Windows でセッションをバックグラウンド化するときに転送されます。`CLAUDE_DISABLE_ADOPT=1` を設定して代わりに停止します。`Completed` グループは残りの垂直スペースを埋め、ヘッダーは短いターミナルでコンパクトになります。古い Claude Code バージョンはもはや新しいセッションの `state.json` フィールドをドロップしたり、それらのセッションを `claude agents` から隠したりしません。停止されたセッションにアタッチすると、最大 5 秒間の空白画面を表示する代わりに直ちに切り替わります。接続を受け入れることができないスーパーバイザーは独自に終了してロックを解放します。 |
1105| v2.1.191 | `claude --bg` と `--agent` 名がサブエージェントのいずれとも一致しない場合、起動が失敗します。セッションは `--agent '<name>' not found` エラーで直ちに終了します。デフォルトエージェントで実行する代わりに。 |
826| v2.1.174 | バックグラウンドセッションはスーパーバイザーの起動シェルからゲートウェイエンドポイント変数（`ANTHROPIC_BASE_URL` など）を継承しなくなります。スーパーバイザーはプリウォーミングされたワーカーに新しい認証情報スナップショットを提供し、誤った `Could not resolve authentication method` エラーを修正します。 |1106| v2.1.174 | バックグラウンドセッションはスーパーバイザーの起動シェルからゲートウェイエンドポイント変数（`ANTHROPIC_BASE_URL` など）を継承しなくなります。スーパーバイザーはプリウォーミングされたワーカーに新しい認証情報スナップショットを提供し、誤った `Could not resolve authentication method` エラーを修正します。 |
827| v2.1.172 | ディスパッチ入力の `/model` はセッションスコープのディスパッチモデルオーバーライドを設定します。 |1107| v2.1.172 | ディスパッチ入力の `/model` はセッションスコープのディスパッチモデルオーバーライドを設定します。 |
828| v2.1.161 | 行の概要は並列作業項目の `done/total` カウントを表示します。ピークパネルは最も長く実行されている並列作業項目を名前で表示します。 |1108| v2.1.161 | 行の概要は並列作業項目の `done/total` カウントを表示します。ピークパネルは最も長く実行されている並列作業項目を名前で表示します。 |
