Documentation 2026-09-13 21:00 UTC to 2026-09-14 22:58 UTC

83WSL セッションが有効になった後、マネージド設定をそれらに拡張します。83WSL セッションが有効になった後、マネージド設定をそれらに拡張します。

84 84 

85* HKLM レジストリまたは `C:\Program Files\ClaudeCode` ファイルを通じて `wslInheritsWindowsSettings: true` をデプロイして、WSL セッションがホストセッションと同じポリシーを継承するようにしてください。85* HKLM レジストリまたは `C:\Program Files\ClaudeCode` ファイルを通じて `wslInheritsWindowsSettings: true` をデプロイして、WSL セッションがホストセッションと同じポリシーを継承するようにしてください。

86* WSL セッション内で `/status` を実行して検証してください。`Setting sources` 行を読んでください。Claude Code は [選択したマネージドソース](/docs/ja/server-managed-settings#settings-precedence)のみを名前付けするため、行が何を示すかはセッションによって異なります。86* WSL セッション内で `/status` を実行して検証し、`Setting sources` 行を読んでください。それを解釈する方法については、[/status で出力を読む](/docs/ja/managed-settings#read-the-source-in-/status)を参照してください。

87 * **[server-managed settings をフェッチし](/docs/ja/server-managed-settings#platform-availability)、任意のキーを受け取るセッション内**: `Enterprise managed settings (remote)` です。Claude Code は Windows ソースより前にそれらを選択するため、行は フラグが到達したかどうかを示しません。

88 * **その他のセッション内**: `Enterprise managed settings (HKLM)` はレジストリデプロイメントを確認します。`(file)` は Windows ファイルまたはディストリビューション独自の `/etc/claude-code/managed-settings.json` を名前付けるため、ディストリビューションが独自のマネージドファイルを持たない場合にのみ Windows ファイルデプロイメントを確認します。

89 87 

90WSL 2 ユーティリティ VM 内のプロセスは、Windows 側のエンドポイント検出センサーに表示されません。ディストリビューション内のプロセスとファイルアクティビティを観察するには、エンドポイント検出ベンダーの WSL ガイダンスで、ディストリビューション内で実行できる Linux センサーと、それが必要とする除外を確認してください。Claude Code の [OpenTelemetry ツール実行テレメトリ](/docs/ja/monitoring-usage)は WSL とネイティブセッションで同じように出力されます。88WSL 2 ユーティリティ VM 内のプロセスは、Windows 側のエンドポイント検出センサーに表示されません。ディストリビューション内のプロセスとファイルアクティビティを観察するには、エンドポイント検出ベンダーの WSL ガイダンスで、ディストリビューション内で実行できる Linux センサーと、それが必要とする除外を確認してください。Claude Code の [OpenTelemetry ツール実行テレメトリ](/docs/ja/monitoring-usage)は WSL とネイティブセッションで同じように出力されます。

91 89 

92`--advisor` で[バックグラウンドセッション](/docs/ja/agent-view)を開始し、これらのいずれかが当てはまる場合、Claude Code は終了する代わりに advisor なしでセッションを開始します。92`--advisor` で[バックグラウンドセッション](/docs/ja/agent-view)を開始し、これらのいずれかが当てはまる場合、Claude Code は終了する代わりに advisor なしでセッションを開始します。

93 93 

94<h2 id="choose-an-advisor-model">94<h2 id="choose-an-advisor-model">

95 advisor モデルを選択する95 アドバイザーモデルを選択する

96</h2>96</h2>

97 97 

98advisor はメインモデル以上の機能を持つ必要があります。各メインモデルで受け入れられる advisor は次のとおりです。98アドバイザーはメインモデル以上の能力を持つ必要があります。各メインモデルで受け入れられるアドバイザーは以下の通りです。

99 99 

100| メインモデル | 受け入れられる advisor | 注記 |100| メインモデル | 受け入れられるアドバイザー | 注記 |

101| --------------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------- |101| --------------------- | -------------------------- | ------------------------------------------------------------------------------------- |

102| Haiku 4.5 | Fable、Opus、Sonnet | Haiku は advisor を呼び出すことはできますが、advisor として機能することはできません |102| Haiku 4.5 | Fable、Opus、Sonnet | Haiku はアドバイザーを呼び出すことはできますが、アドバイザーとして機能することはできません |

103| Sonnet 4.6 | Fable、Opus、Sonnet | |103| Sonnet 4.6 | Fable、Opus、Sonnet | |

104| Sonnet 5 | Fable、Opus、Sonnet 5 | Sonnet 4.6 advisor は拒否されます |104| Sonnet 5 | Fable、Opus 4.7 以降、Sonnet 5 | Sonnet 4.6 アドバイザーは拒否され、Opus 4.6 アドバイザーを使用したリクエストは API エラーで失敗します |

105| Opus 4.6 | Fable、Opus、Sonnet 5 | Sonnet 5 と Opus 4.6 は同等の機能として評価されるため、Opus 4.6 メインは Sonnet 5 advisor を受け入れます |105| Opus 4.6 | Fable、Opus、Sonnet 5 | Sonnet 4.6 アドバイザーは拒否されます |

106| Opus 4.7 以降 | Fable、Opus 4.7 以降 | Opus 4.7 以降の Opus モデルは同等の機能として評価されるため、どれでも他方を advisor として受け入れます。Opus 4.6 または Sonnet 5 advisor を持つ Opus 4.7 メインは拒否されます |106| Opus 4.7 または Opus 4.8 | Fable、および Opus 4.7 以降 | Opus 4.6 または Sonnet アドバイザーは拒否されます |

107| Fable 5.1 または Fable 5 | Fable 5.1 または Fable 5 | Opus または Sonnet advisor は拒否されます |107| Opus 5 | Fable、Opus 5 | Opus 4.6 または Sonnet アドバイザーは拒否され、Opus 4.7 または Opus 4.8 アドバイザーを使用したリクエストは API エラーで失敗します |

108| Fable 5 | Fable 5.1 または Fable 5 | Opus または Sonnet アドバイザーは拒否されます |

109| Fable 5.1 | Fable 5.1 | Opus または Sonnet アドバイザーは拒否され、Fable 5 アドバイザーを使用したリクエストは API エラーで失敗します |

108 110 

109Fable 5.1 は Claude Code v2.1.257 以降が必要です。どちらの Fable モデルも [Fable アクセス](/docs/ja/model-config#work-with-fable) が必要です。111Fable 5.1 には Claude Code v2.1.257 以降が必要です。両方の Fable モデルには [Fable アクセス](/docs/ja/model-config#work-with-fable) が必要です。

110 112 

111advisor を `fable`、`opus`、または `sonnet` として設定します。これらのエイリアスは Claude Code の各モデルファミリーの組み込みデフォルトバージョンに解決され、新しい Claude Code リリースで進化します。`claude-opus-5` などの完全なモデル ID を渡すこともできます。113アドバイザーを `fable`、`opus`、または `sonnet` として設定します。これらのエイリアスは Claude Code の各モデルファミリーの組み込みデフォルトバージョンに解決され、新しい Claude Code リリースで進化します。`claude-opus-5` などの完全なモデル ID を渡すこともできます。

112 114 

113Subagent は設定された advisor を継承し、独自のモデルに対して同じペアリングチェックを適用します。115サブエージェントは設定されたアドバイザーを継承し、独自のモデルに対して同じペアリングチェックを適用します。

114 116 

115Claude Code はリクエストを送信する前にペアリングを検証します。117Claude Code はリクエストを送信する前にペアリングを検証し、API が再度検証します。

116 118 

117* advisor がメインモデルより機能が低い場合、advisor はメインモデルのリクエストに接続されません。`/advisor` コマンド出力と通知がこれを表示します。独自のモデルがペアリングを満たす Subagent は引き続き advisor を使用できます。119* テーブルで拒否されたアドバイザーの場合、Claude Code はそれをメインモデルのリクエストに添付しません。`/advisor` コマンド出力と通知がこれを表示します。独自のモデルがペアリングを満たすサブエージェントは、引き続きアドバイザーを使用できます。

118* メインモデルまたは advisor が Claude Code が認識しないモデルである場合、advisor は接続されません。120* テーブルで API エラーで失敗するとリストされているアドバイザーの場合、Claude Code はそれを添付し、API がそれを拒否します。`/advisor` でアドバイザーを変更するか、オフにするまで、すべてのリクエストが `'<advisor model>' cannot be used as an advisor when the request model is '<main model>'` で失敗します。

121* メインモデルまたはアドバイザーが Claude Code が認識しないモデルの場合、アドバイザーは添付されません。

119 122 

120<h3 id="fable-advisor-and-usage-credits">123<h3 id="fable-advisor-and-usage-credits">

121 Fable advisor と使用クレジット124 Fable アドバイザーと使用クレジット

122</h3>125</h3>

123 126 

124一部のプランでは、Fable の使用は使用クレジットに請求され、advisor としての Fable も同じ方法で請求されます。アカウントが [Fable の使用を使用クレジットに請求することへの一度限りの同意](/docs/ja/model-config#fable-and-usage-credits) を必要とする場合、Claude Code は `/model` で Fable モデルを選択するときにそれを要求し、その同意を受け入れるまで Fable を advisor として適用しません。127一部のプランでは、Fable の使用は使用クレジットに請求され、アドバイザーとしての Fable も同じ方法で請求されます。アカウントが [Fable の使用を使用クレジットに請求するための一度限りの同意](/docs/ja/model-config#fable-and-usage-credits) を必要とする場合、Claude Code は `/model` で Fable モデルを選択するときにそれを要求し、その同意を受け入れるまで Fable をアドバイザーとして適用しません。

125 128 

126それを受け入れるまで、Claude Code は `/advisor fable` を入力するか `/advisor` ピッカーで Fable を選択しても Fable を advisor として保存しません。代わりに `/model fable` を指します。`claude --advisor fable` では、Claude Code は `/model fable` を指すメッセージで起動時に終了します。[バックグラウンドセッション](#use-the-advisor-flag) では、終了する代わりに advisor なしでセッションを開始します。Fable が既に `advisorModel` として保存されている場合、Claude Code は advisor なしでリクエストを送信します。メインモデルが advisor をサポートするインタラクティブセッションでは、`/model fable` を指す通知も表示されます。129それを受け入れる前に、Claude Code は `/advisor fable` を入力するか `/advisor` ピッカーで Fable を選択するときに Fable をアドバイザーとして保存しません。代わりに `/model fable` を指すようにします。`claude --advisor fable` を使用すると、Claude Code は `/model fable` を指すメッセージで起動時に終了します。[バックグラウンドセッション](#use-the-advisor-flag) では、終了する代わりにアドバイザーなしでセッションを開始します。Fable が既に `advisorModel` として保存されている場合、Claude Code はアドバイザーなしでリクエストを送信します。アドバイザーをサポートするインタラクティブセッションでは、`/model fable` を指す通知も表示されます。

127 130 

128同意を受け入れるには、`/model fable` を実行し、Fable で続行することを選択します。Claude Code は同意を記録し、[Fable を選択したモデルとして保存](/docs/ja/model-config#default-model-setting) します。その後、Fable を advisor として選択します。131同意を受け入れるには、`/model fable` を実行し、Fable で続行することを選択します。Claude Code は同意を記録し、[Fable を選択したモデルとして保存](/docs/ja/model-config#default-model-setting) します。次に、Fable をアドバイザーとして選択します。

129 132 

130<h3 id="common-model-pairings">133<h3 id="common-model-pairings">

131 一般的なモデルペアリング134 一般的なモデルペアリング

132</h3>135</h3>

133 136 

134受け入れられるペアリングはすべて機能します。これらの組み合わせは、異なる方法でコストと機能のバランスを取ります。137受け入れられたペアリングはすべて機能します。これらの組み合わせは、異なる方法でコストと能力のバランスを取ります。

135 138 

136| ペアリング | 使用する場合 |139| ペアリング | 使用する場合 |

137| --------------------------- | -------------------------------------------------------------------------------------------- |140| -------------------------- | --------------------------------------------------------------------------------------- |

138| Sonnet メイン + Opus advisor | Sonnet は定型的な作業を処理し、計画、曖昧な失敗、および完了チェックを Opus にエスカレートします |141| Sonnet メイン + Opus アドバイザー | Sonnet は日常的な作業を処理し、計画、曖昧な失敗、完了チェックを Opus にエスカレートします |

139| Sonnet メイン + Fable advisor | 決定ポイントで Fable ガイダンスを取得し、Fable 全体を実行しません。Fable アクセスが必要です |142| Sonnet メイン + Fable アドバイザー | 決定ポイントで Fable ガイダンスを取得し、プロセス全体で Fable を実行しません。Fable アクセスが必要です |

140| Haiku メイン + Opus advisor | 強力な計画を備えた最も低コストのメインモデル。Haiku のみよりもコストが高くなることが予想されますが、メインモデルを Sonnet または Opus に切り替えるよりは低くなります |143| Haiku メイン + Opus アドバイザー | 強力な計画を備えた最も低コストのメインモデル。Haiku 単独よりも高いコストが予想されますが、メインモデルを Sonnet または Opus に切り替えるよりは低くなります |

141| Opus メイン + Opus advisor | 2 番目の Opus が最初の Opus をレビューします。コストよりも独立したチェックが重要な高リスクタスクに役立ちます |144| Opus メイン + Opus アドバイザー | 2 番目の Opus が最初の Opus をレビューします。コストよりも独立したチェックが重要な高リスクタスクに役立ちます |

142| Fable メイン + Fable advisor | Fable が利用可能な場合の最高機能ペアリング。Claude Code は Fable メインモデルに Opus または Sonnet advisor を適用しません |145| Fable メイン + Fable アドバイザー | Fable が利用可能な場合の最高能力ペアリング。Claude Code は Fable メインモデルに Opus または Sonnet アドバイザーを適用しません |

143| Sonnet メイン + Sonnet advisor | 定型的な見落としをキャッチするための低コストの 2 番目の意見 |146| Sonnet メイン + Sonnet アドバイザー | 日常的な見落としをキャッチするための低コストの 2 番目の意見 |

144 147 

145<h2 id="when-claude-consults-the-advisor">148<h2 id="when-claude-consults-the-advisor">

146 Claude が advisor に相談する場合149 Claude が advisor に相談する場合

62 * `"init"`：実行のセッションメタデータ。セッション起動中に `SessionStart` または `Setup` フックが実行される場合、その[フックライフサイクルメッセージ](/docs/ja/agent-sdk/typescript#sdkhookstartedmessage)は `init` メッセージの前に到着します62 * `"init"`：実行のセッションメタデータ。セッション起動中に `SessionStart` または `Setup` フックが実行される場合、その[フックライフサイクルメッセージ](/docs/ja/agent-sdk/typescript#sdkhookstartedmessage)は `init` メッセージの前に到着します

63 * `"compact_boundary"`：[圧縮](#automatic-compaction)後に発火します63 * `"compact_boundary"`：[圧縮](#automatic-compaction)後に発火します

64 * `"informational"`：ループからのプレーンテキストステータスバナー64 * `"informational"`：ループからのプレーンテキストステータスバナー

65 * `"worker_shutting_down"`：ホストが終了しているか Remote Control が切断されたため、現在のターン後にループが終了します65 * `"worker_shutting_down"`：ホストが終了しているか Remote Control が切断されました

66 66 

67 TypeScript では、`"init"` 以外の各サブタイプは `SDKSystemMessage` のサブタイプではなく、[`SDKMessage` ユニオン](/docs/ja/agent-sdk/typescript#sdkmessage)内の独自のタイプです。67 TypeScript では、`"init"` 以外の各サブタイプは `SDKSystemMessage` のサブタイプではなく、[`SDKMessage` ユニオン](/docs/ja/agent-sdk/typescript#sdkmessage)内の独自のタイプです。

68* **`AssistantMessage`：** 最終テキストのみの応答を含む、Claude の各応答のコンテンツブロックごとに生成されます。各メッセージは、テキストやツール呼び出しなどの単一のコンテンツブロックを持ち、1 つの応答からのメッセージは同じメッセージ ID を共有します。68* **`AssistantMessage`：** 最終テキストのみの応答を含む、Claude の各応答のコンテンツブロックごとに生成されます。各メッセージは、テキストやツール呼び出しなどの単一のコンテンツブロックを持ち、1 つの応答からのメッセージは同じメッセージ ID を共有します。

238| `"xhigh"` | 拡張推論深度 | [サポートしているモデル](/docs/ja/model-config#adjust-effort-level)でのコーディングと agentic coding タスク |238| `"xhigh"` | 拡張推論深度 | [サポートしているモデル](/docs/ja/model-config#adjust-effort-level)でのコーディングと agentic coding タスク |

239| `"max"` | 最大推論深度 | 深い分析が必要な複数ステップの問題 |239| `"max"` | 最大推論深度 | 深い分析が必要な複数ステップの問題 |

240 240 

241`effort` を設定しない場合、両方の SDK はパラメータを未設定のままにして、モデルのデフォルト動作に委譲します。241`effort` を設定しない場合、Claude Code は努力レベルを自身で解決します。その順序は[努力レベルを調整する](/docs/ja/model-config#adjust-effort-level)で説明されています。

242 242 

243<Note>243<Note>

244 `effort` は各応答内の推論深度のレイテンシとトークンコストをトレードオフします。[Extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)は、出力に `thinking` ブロックを生成する別の機能であり、[Python](/docs/ja/agent-sdk/python#thinkingconfig)または[TypeScript](/docs/ja/agent-sdk/typescript#thinkingconfig)の `ThinkingConfig` の `display` フィールドは、テキストを受け取るかどうかを制御します。これらは独立しています。`effort: "low"` を extended thinking 有効で設定することも、`effort: "max"` を有効にしないで設定することもできます。244 `effort` は各応答内の推論深度のレイテンシとトークンコストをトレードオフします。[Extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)は、出力に `thinking` ブロックを生成する別の機能であり、[Python](/docs/ja/agent-sdk/python#thinkingconfig)または[TypeScript](/docs/ja/agent-sdk/typescript#thinkingconfig)の `ThinkingConfig` の `display` フィールドは、テキストを受け取るかどうかを制御します。これらは独立しています。`effort: "low"` を extended thinking 有効で設定することも、`effort: "max"` を有効にしないで設定することもできます。

357| `success` | Claude は通常、タスクを完了しました | はい |357| `success` | Claude は通常、タスクを完了しました | はい |

358| `error_max_turns` | 完了前に `maxTurns` 制限に達しました | いいえ |358| `error_max_turns` | 完了前に `maxTurns` 制限に達しました | いいえ |

359| `error_max_budget_usd` | 完了前に `maxBudgetUsd` 制限に達しました | いいえ |359| `error_max_budget_usd` | 完了前に `maxBudgetUsd` 制限に達しました | いいえ |

360| `error_during_execution` | エラーがループを中断しました（たとえば、API 障害またはキャンセルされたリクエスト） | いいえ |360| `error_during_execution` | エラーがループを中断しました（たとえば、キャンセルされたリクエスト） | いいえ |

361| `error_max_structured_output_retries` | 設定された再試行制限内で有効な構造化出力が生成されませんでした。すべての試行が検証に失敗したか、モデルフォールバックが成功した再試行なしで完了した出力を取り消しました | いいえ |361| `error_max_structured_output_retries` | 設定された再試行制限内で有効な構造化出力が生成されませんでした。すべての試行が検証に失敗したか、モデルフォールバックが成功した再試行なしで完了した出力を取り消しました | いいえ |

362 362 

363`result` フィールドは最終テキスト出力を保持し、`success` バリアントにのみ存在するため、読み取る前に常にサブタイプをチェックしてください。363`result` フィールドは最終テキスト出力を保持し、`success` バリアントにのみ存在するため、読み取る前に常にサブタイプをチェックしてください。

196* **ファイルシステムフック：** `settings.json` で定義されたシェルコマンド。`settingSources` に関連するソースが含まれている場合に読み込まれます。これらは[インタラクティブな Claude Code セッション](/docs/ja/hooks-guide)用に設定するのと同じフックです。196* **ファイルシステムフック：** `settings.json` で定義されたシェルコマンド。`settingSources` に関連するソースが含まれている場合に読み込まれます。これらは[インタラクティブな Claude Code セッション](/docs/ja/hooks-guide)用に設定するのと同じフックです。

197* **プログラマティックフック：** `query()` に直接渡されるコールバック関数。これらはアプリケーションプロセスで実行され、構造化された決定を返すことができます。[フックで実行を制御する](/docs/ja/agent-sdk/hooks)を参照してください。197* **プログラマティックフック：** `query()` に直接渡されるコールバック関数。これらはアプリケーションプロセスで実行され、構造化された決定を返すことができます。[フックで実行を制御する](/docs/ja/agent-sdk/hooks)を参照してください。

198 198 

199両方のタイプは同じフックライフサイクル中に実行されます。プロジェクトの `.claude/settings.json` にフックが既にあり、`settingSources: ["project"]` を設定している場合、それらのフックは追加の設定なしで SDK で自動的に実行されます。

200 

201フックコールバックはツール入力を受け取り、決定辞書を返します。`{}` を返すことはツールの実行を許可することを意味します。実行をブロックするには、`permissionDecision: "deny"` と `permissionDecisionReason` を含む `hookSpecificOutput` オブジェクトを返します。理由は Claude にツール結果として送信されます。完全なコールバック署名と戻り値の型については、[フックガイド](/docs/ja/agent-sdk/hooks)を参照してください。199フックコールバックはツール入力を受け取り、決定辞書を返します。`{}` を返すことはツールの実行を許可することを意味します。実行をブロックするには、`permissionDecision: "deny"` と `permissionDecisionReason` を含む `hookSpecificOutput` オブジェクトを返します。理由は Claude にツール結果として送信されます。完全なコールバック署名と戻り値の型については、[フックガイド](/docs/ja/agent-sdk/hooks)を参照してください。

202 200 

203<CodeGroup>201<CodeGroup>

162| :------------------------------------------------ | :--------------------------- | :------------------------------------------------------ |162| :------------------------------------------------ | :--------------------------- | :------------------------------------------------------ |

163| stdio サーバー、またはキャッシュされたツールリストのない HTTP/SSE サーバー | はい、接続されるまで | [`MCP_TIMEOUT`](/docs/ja/env-vars)、デフォルトは 30 秒。接続はその期限で失敗します |163| stdio サーバー、またはキャッシュされたツールリストのない HTTP/SSE サーバー | はい、接続されるまで | [`MCP_TIMEOUT`](/docs/ja/env-vars)、デフォルトは 30 秒。接続はその期限で失敗します |

164| キャッシュされたツールリストを持つリモートサーバー（Claude Code が以前の接続から保存） | いいえ。キャッシュされたツールは最初のターンから利用可能 | なし。最初のツール呼び出しで接続し、その遅延接続には独自のタイムアウトがあります |164| キャッシュされたツールリストを持つリモートサーバー（Claude Code が以前の接続から保存） | いいえ。キャッシュされたツールは最初のターンから利用可能 | なし。最初のツール呼び出しで接続し、その遅延接続には独自のタイムアウトがあります |

165| インプロセス [SDK サーバー](#sdk-mcp-servers) | いいえ。最初のターンを遅延させることはありません | なし |165| インプロセス [SDK サーバー](#sdk-mcp-servers) | はい、接続してツールをリストするまで | なし。接続とツールリスティングリクエストはそれぞれ独自のタイムアウトを持ちます |

166 166 

167init メッセージが送信される前に、最初のターン待機とは別の、より早い段階でスタートアップ自体をブロックするには：167init メッセージが送信される前に、最初のターン待機とは別の、より早い段階でスタートアップ自体をブロックするには：

168 168 

160 const options = { settings: { outputStyle: "Explanatory" } };160 const options = { settings: { outputStyle: "Explanatory" } };

161 ```161 ```

162 162 

163Python SDK には、出力スタイルをプログラムで選択するオプションはありません。`.claude/settings.local.json` に書き込めないコードのみのデプロイメントの場合は、`append` またはカスタムプロンプト文字列を代わりに使用してください。163Python SDK では、`settings` オプションを通じて `outputStyle` を設定します。これは `'{"outputStyle": "Explanatory"}'` などの JSON 文字列、または `outputStyle` を設定する設定ファイルへのパスを取ります。

164 164 

165**SDK ユーザーへの注記：** 出力スタイルは、オプションに `settingSources: ['user']` または `settingSources: ['project']`（TypeScript）/ `setting_sources=["user"]` または `setting_sources=["project"]`（Python）を含める場合に読み込まれます。165**SDK ユーザーへの注記：** 出力スタイルは、オプションに `settingSources: ['user']` または `settingSources: ['project']`（TypeScript）/ `setting_sources=["user"]` または `setting_sources=["project"]`（Python）を含める場合に読み込まれます。

166 166 

16 16 

17| 対象 | 使用するツール | 理由 |17| 対象 | 使用するツール | 理由 |

18| ----------------------------------------------------------- | --------------------------------------------------------------------------------- | --------------------------------------------------------------------- |18| ----------------------------------------------------------- | --------------------------------------------------------------------------------- | --------------------------------------------------------------------- |

19| ツールループを自分で実装せずにエージェントを構築している | **Agent SDK** | 独自のプロセス内でエージェントループを実行するライブラリで、Python または TypeScript で利用可能です。 |19| ツールループを自分で実装せずにエージェントを構築している | **Agent SDK** | エージェントループを実行する Python または TypeScript ライブラリです。 |

20| ターミナルからの対話的な開発またはワンオフタスクの実行 | [**Claude Code CLI**](/docs/ja/overview) | 日常的な対話的使用のために構築されたターミナルインターフェース。 |20| ターミナルからの対話的な開発またはワンオフタスクの実行 | [**Claude Code CLI**](/docs/ja/overview) | 日常的な対話的使用のために構築されたターミナルインターフェース。 |

21| API を直接呼び出し、ツールループを自分で実装している | [**Client SDK**](https://platform.claude.com/docs/en/api/client-sdks) | Claude Code ではなく Anthropic API への直接アクセス。ツールループを自分で実装します。 |21| API を直接呼び出し、ツールループを自分で実装している | [**Client SDK**](https://platform.claude.com/docs/en/api/client-sdks) | Claude Code ではなく Anthropic API への直接アクセス。ツールループを自分で実装します。 |

22| 独自のサンドボックスまたはセッションインフラストラクチャを管理せずに、長時間実行または非同期エージェントを実行している | [**Managed Agents**](https://platform.claude.com/docs/en/managed-agents/overview) | ホストされた REST API で、Agent SDK とは別の製品です。Anthropic がエージェントとサンドボックスを実行します。 |22| 独自のサンドボックスまたはセッションインフラストラクチャを管理せずに、長時間実行または非同期エージェントを実行している | [**Managed Agents**](https://platform.claude.com/docs/en/managed-agents/overview) | ホストされた REST API で、Agent SDK とは別の製品です。Anthropic がエージェントとサンドボックスを実行します。 |

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4 

5# パーミッションの設定5# 権限の設定

6 6 

7> パーミッションモード、フック、宣言的な許可/拒否ルールを使用して、エージェントがツールをどのように使用するかを制御します。7> 権限モード、hooks、および宣言的な許可/拒否ルールを使用して、エージェントがツールをどのように使用するかを制御します。

8 8 

9Claude Agent SDK は、Claude がツールをどのように使用するかを管理するためのパーミッション制御を提供します。パーミッションモードとルールを使用して、自動的に許可されるものを定義し、[`canUseTool` コールバック](/docs/ja/agent-sdk/user-input)を使用して、実行時にそれ以外のすべてを処理します。9Claude Agent SDK は、Claude がツールをどのように使用するかを管理するための権限制御を提供します。権限モードとルールを使用して、自動的に許可されるものを定義し、[`canUseTool` コールバック](/docs/ja/agent-sdk/user-input)を使用して、実行時にそれ以外のすべてを処理します。

10 

11<Note>

12 このページはパーミッションモードとルールについて説明しています。ユーザーが実行時にツールリクエストを承認または拒否する対話的な承認フローを構築するには、[承認とユーザー入力の処理](/docs/ja/agent-sdk/user-input)を参照してください。

13</Note>

14 10 

15<h2 id="how-permissions-are-evaluated">11<h2 id="how-permissions-are-evaluated">

16 パーミッションの評価方法12 権限がどのように評価されるか

17</h2>13</h2>

18 14 

19Claude がツールをリクエストすると、SDK は次の順序でパーミッションをチェックします。15Claude がツールをリクエストすると、SDK は以下の順序で権限をチェックします。

20 16 

21<Steps>17<Steps>

22 <Step title="フック">18 <Step title="Hooks">

23 最初に[フック](/docs/ja/agent-sdk/hooks)を実行します。フックはコールを直接拒否するか、それを渡すことができます。`allow` を返すフックは、以下の拒否および質問ルールをスキップしません。これらはフックの結果に関係なく評価されます。19 最初に [hooks](/docs/ja/agent-sdk/hooks) を実行します。Hook は呼び出しを完全に拒否するか、それを通すことができます。`allow` を返す Hook は、以下の deny および ask ルールをスキップしません。これらは Hook の結果に関係なく評価されます。`PreToolUse` Hook の allow は、[重要なパス](/docs/ja/permission-modes#critical-paths) をターゲットとする `rm` または `rmdir` の削除を承認することもできません。

24 </Step>20 </Step>

25 21 

26 <Step title="拒否ルール">22 <Step title="Deny ルール">

27 `deny` ルール（`disallowed_tools` および[settings.json](/docs/ja/settings#permission-settings)から）をチェックします。拒否ルールが一致する場合、`bypassPermissions` モードでもツールはブロックされます。`Bash` のような裸名の拒否ルールはこの評価が開始される前に Claude のコンテキストからツールを削除するため、このステップでチェックされるのは `Bash(rm *)` のようなスコープ付きルールのみです。23 `deny` ルール（`disallowed_tools` および [settings.json](/docs/ja/settings-reference#permission-settings) から）をチェックします。Deny ルールがマッチした場合、`bypassPermissions` モードでもツールはブロックされます。`Bash` のような裸名の deny ルールは、この評価が始まる前に Claude のコンテキストからツールを削除するため、`Bash(rm *)` のようなスコープ付きルールのみがこのステップでチェックされます。

28 </Step>24 </Step>

29 25 

30 <Step title="質問ルール">26 <Step title="Ask ルール">

31 [settings.json](/docs/ja/settings#permission-settings)から `ask` ルールをチェックします。質問ルールが一致する場合、`bypassPermissions` モードでも、コールは確認のために[`canUseTool` コールバック](/docs/ja/agent-sdk/user-input)にフォールスルーします。27 [settings.json](/docs/ja/settings-reference#permission-settings) から `ask` ルールをチェックします。Ask ルールがマッチした場合、呼び出しは確認のために [`canUseTool` コールバック](/docs/ja/agent-sdk/user-input) にフォールスルーします。`bypassPermissions` モードでも同様です。

32 28 

33 ユーザーインタラクションが必要なツールは同じように動作します。`AskUserQuestion` および MCP ツール（サーバーが[`_meta["anthropic/requiresUserInteraction"]`](/docs/ja/mcp#require-approval-for-a-specific-tool)を設定）は、許可ルールが一致する場合でも常にコールバックにフォールスルーします。`dontAsk` モードでは、このモードはプロンプトを表示しないため、両方のケースが代わりに拒否されます。MCP アノテーションには Claude Code v2.1.199 以降が必要です。29 ユーザーインタラクションが必要なツールは同じように動作します。`AskUserQuestion` および [`_meta["anthropic/requiresUserInteraction"]`](/docs/ja/mcp#require-approval-for-a-specific-tool) を設定する MCP ツールサーバーは、allow ルールがマッチした場合でも常にコールバックにフォールスルーします。`dontAsk` モードでは、このモードは決してプロンプトを表示しないため、両方のケースが拒否されます。MCP アノテーションには Claude Code v2.1.199 以降が必要です。

34 30 

35 [claude.ai コネクタ](/docs/ja/mcp#organization-controls-on-connector-tools)ツール（組織が `ask` に設定したもの）もこのステップでフローを離れます。すべてのコールはコールバックにフォールスルーします。`bypassPermissions` モードでも、許可ルールが一致する場合でもです。コールバックは理由 `Your organization requires approval for this tool` を受け取ります。`dontAsk` モードではコールが拒否される代わりに、このモードはプロンプトを表示しないためです。31 組織が `ask` に設定した [claude.ai コネクタ](/docs/ja/mcp#organization-controls-on-connector-tools) ツールもこのステップでフローを離れます。`bypassPermissions` モードでも allow ルールがマッチした場合でも、すべての呼び出しはコールバックにフォールスルーします。コールバックは理由 `Your organization requires approval for this tool` を受け取ります。`dontAsk` モードでは、このモードは決してプロンプトを表示しないため、呼び出しは拒否されます。

36 </Step>32 </Step>

37 33 

38 <Step title="権限モード">34 <Step title="Permission モード">

39 アクティブな[権限モード](#permission-modes)を適用します。`bypassPermissions` はこのステップに到達したすべてを承認します。`acceptEdits` はファイル操作を承認します。`plan` はファイル編集およびシェル書き込みツールを許可ルールに関係なく [`canUseTool` コールバック](/docs/ja/agent-sdk/user-input)にルーティングするため、計画中は書き込み操作を自動承認することはできません。その他のモードはフォールスルーします。35 アクティブな [permission モード](#permission-modes) を適用します。

36 

37 * `bypassPermissions` モードでは、Claude Code はこのステップに到達したすべてのものを承認します。ただし、[重要なパス](/docs/ja/permission-modes#critical-paths) をターゲットとする `rm` および `rmdir` の削除は除きます。これらはフォールスルーします。

38 * `acceptEdits` モードでは、Claude Code は [Accept edits モード](#accept-edits-mode-acceptedits) の下にリストされたファイル操作を承認します。

39 * `plan` モードでは、Claude Code は allow ルールに関係なく、ファイル編集およびシェル書き込みツールを `canUseTool` コールバックに送信します。これにより、計画中に書き込み操作を自動承認することはできません。

40 * その他のモードでは、リクエストはフォールスルーします。

40 </Step>41 </Step>

41 42 

42 <Step title="許可ルール">43 <Step title="Allow ルール">

43 `allow` ルール（`allowed_tools` および settings.json から）をチェックします。ルールが一致する場合、ツールは承認されます。44 `allow` ルール（`allowed_tools` および settings.json から）をチェックします。ルールがマッチした場合、ツールは承認されます。ツール自体が承認する呼び出しもこのステップで解決されます。ルールは不要です。例えば、作業ディレクトリ内のファイル読み取りまたは [読み取り専用 Bash コマンド](/docs/ja/permissions#read-only-commands)。`rm` および `rmdir` の削除で [重要なパス](/docs/ja/permission-modes#critical-paths) をターゲットとするものは、allow ルールによって決して承認されません。プロンプトを表示するモードではコールバックに到達し、Claude Code v2.1.218 以降の `auto` モードでは [分類器](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) に移動し、`dontAsk` モードでは拒否されます。

44 </Step>45 </Step>

45 46 

46 <Step title="canUseTool コールバック">47 <Step title="canUseTool コールバック">

47 上記のいずれでも解決されない場合、決定のために[`canUseTool` コールバック](/docs/ja/agent-sdk/user-input)を呼び出します。`dontAsk` モードでは、このステップはスキップされ、ツールは拒否されます。48 上記のいずれでも解決されない場合、決定のために [`canUseTool` コールバック](/docs/ja/agent-sdk/user-input) を呼び出します。`dontAsk` モードでは、このステップはスキップされ、ツールは拒否されます。

49 

50 TypeScript SDK では、[`permissionPrompts: 'none'`](/docs/ja/agent-sdk/typescript#options) を設定した場合、このステップではコールバックは呼び出されません。[`PermissionRequest` hook](/docs/ja/hooks#permissionrequest) はまだ決定する機会があり、そうしない場合、Claude Code は呼び出しを拒否します。このオプションには Claude Code v2.1.259 以降が必要です。

48 </Step>51 </Step>

49</Steps>52</Steps>

50 53 

51<img src="https://mintcdn.com/claude-code/jYgs7qigNjO1Badj/images/agent-sdk/permissions-flow.svg?fit=max&auto=format&n=jYgs7qigNjO1Badj&q=85&s=c771ad9085b1277d3708027a49c744bc" alt="6 ステップのパーミッション評価フロー図。ツールリクエストはフック、拒否ルール、質問ルール、パーミッションモード、許可ルール、canUseTool を通過します。フック、拒否ルール、canUseTool はブロックにルーティングでき、パーミッションモードバイパス、許可ルール、canUseTool は実行にルーティングできます。質問ルールは canUseTool にルーティングします。" width="1180" height="260" data-path="images/agent-sdk/permissions-flow.svg" />54<img src="https://mintcdn.com/claude-code/jYgs7qigNjO1Badj/images/agent-sdk/permissions-flow.svg?fit=max&auto=format&n=jYgs7qigNjO1Badj&q=85&s=c771ad9085b1277d3708027a49c744bc" className="dark:hidden" alt="上記のステップに対応する 6 ステップの権限評価フロー図。ツールリクエストは hooks、deny ルール、ask ルール、permission モード、allow ルール、canUseTool を通過します。Hooks、deny ルール、canUseTool は Blocked にルーティングでき、permission モード bypass、allow ルール、canUseTool は Execute にルーティングでき、ask ルールは canUseTool にルーティングします。" width="1180" height="260" data-path="images/agent-sdk/permissions-flow.svg" />

52 55 

53v2.1.198 以降、このパーミッション評価順序が到達できない `canUseTool` コールバックを渡す場合、TypeScript SDK はクエリが構築されるときに Node.js プロセス警告を 1 回発行します。警告のコードは `CLAUDE_SDK_CAN_USE_TOOL_SHADOWED` です。2 つの設定がこれをトリガーします。56<img src="https://mintcdn.com/claude-code/_xqph1dUOslCOwsj/images/agent-sdk/permissions-flow-dark.svg?fit=max&auto=format&n=_xqph1dUOslCOwsj&q=85&s=e53a91e9059cbf51852b7cedb4dd4251" className="hidden dark:block" alt="上記のステップに対応する 6 ステップの権限評価フロー図。ツールリクエストは hooks、deny ルール、ask ルール、permission モード、allow ルール、canUseTool を通過します。Hooks、deny ルール、canUseTool は Blocked にルーティングでき、permission モード bypass、allow ルール、canUseTool は Execute にルーティングでき、ask ルール は canUseTool にルーティングします。" width="1180" height="260" data-path="images/agent-sdk/permissions-flow-dark.svg" />

54 57 

55* `permissionMode: 'bypassPermissions'`。これはパーミッションモードステップに到達するすべてのコールを自動承認します。58TypeScript SDK がコールバックが相談される前に呼び出しを自動承認することを期待する設定で `canUseTool` コールバックを渡す場合、SDK はクエリが構築されるときに Node.js プロセス警告を 1 回発行します。警告のコードは `CLAUDE_SDK_CAN_USE_TOOL_SHADOWED` です。2 つの設定がそれをトリガーします。

56* `"Read"` などの各裸の `allowedTools` エントリ。これはコールバックが相談される前にそのツール全体を自動承認します。

57 59 

58`Bash(ls *)` などの指定子を持つエントリと `acceptEdits` モードはこれをトリガーしません。また、設定ファイルから来る許可ルールはチェックに表示されません。60* `permissionMode: 'bypassPermissions'`。これは permission モードステップに到達するすべての呼び出しを自動承認します。ただし、[どのモードも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves) は除きます。

61* `"Read"` などの各裸の `allowedTools` エントリ。これはコールバックが相談される前にそのツール全体を自動承認します。ただし、[どのモードも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves) は除きます。

59 62 

60`process.on('warning', ...)` でリッスンしてコードをマッチングしてログに記録するか、それを抑制します。モードとルールに関係なくすべてのツールコールをゲートするには、代わりに[`PreToolUse` フック](/docs/ja/agent-sdk/hooks)を使用します。63`Bash(ls *)` などの指定子を持つエントリおよび `acceptEdits` モードはそれをトリガーしません。また、設定ファイルから来る allow ルールはチェックに表示されません。

61 64 

62このページは**許可および拒否ルール**と**パーミッションモード**に焦点を当てています。その他のステップについては、以下を参照してください。65`process.on('warning', ...)` でリッスンし、コードをマッチさせてログまたは抑制します。モードとルールに関係なくすべてのツール呼び出しをゲートするには、代わりに [`PreToolUse` hook](/docs/ja/agent-sdk/hooks) を使用します。

63 66 

64* **フック：** カスタムコードを実行して、ツールリクエストを許可、拒否、または変更します。[フックで実行を制御](/docs/ja/agent-sdk/hooks)を参照してください。67このページは **allow および deny ルール** および **permission モード** に焦点を当てています。その他のステップについては、以下を参照してください。

65* **canUseTool コールバック：** 実行時にユーザーに承認を促します。[承認とユーザー入力の処理](/docs/ja/agent-sdk/user-input)を参照してください。68 

69* **Hooks：** ツールリクエストを許可、拒否、または変更するカスタムコードを実行します。[実行を Hook で制御する](/docs/ja/agent-sdk/hooks) を参照してください。

70* **canUseTool コールバック：** 前のステップで呼び出しが解決されない場合、実行時にユーザーの承認をプロンプトします。[承認とユーザー入力を処理する](/docs/ja/agent-sdk/user-input) を参照してください。

66 71 

67<h2 id="allow-and-deny-rules">72<h2 id="allow-and-deny-rules">

68 許可および拒否ルール73 許可ルールと拒否ルール

69</h2>74</h2>

70 75 

71`allowed_tools` および `disallowed_tools`（TypeScript：`allowedTools` / `disallowedTools`）は、上記の評価フロー内の許可および拒否ルールリストにエントリを追加します。許可ルールは承認のみに影響します。`allowed_tools` にリストされていないツールは引き続き Claude に利用可能であり、パーミッションモードにフォールスルーします。拒否ルールは、ツール全体に名前を付けるか、ツール内のパターンをスコープするかによって異なる動作をします。76`allowed_tools` と `disallowed_tools`（TypeScript：`allowedTools` / `disallowedTools`）は、上記の評価フロー内の許可ルールと拒否ルールリストにエントリを追加します。`allowed_tools` に[タスク追跡ツール](/docs/ja/agent-sdk/todo-tracking#model-availability)の 1 つを名前で指定すると、Claude Code もセッションをオプトインします。`allowed_tools` にリストされていない他のツールは、Claude でも利用可能であり、承認が必要なそのツールへの呼び出しは権限モードにフォールスルーします。拒否ルールは、ツール名を指定するか、ツール内のパターンをスコープするかによって動作が異なります。

72 77 

73| オプション | 効果 |78| オプション | 効果 |

74| :-------------------------------- | :----------------------------------------------------------------------------------------------------------------------- |79| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

75| `allowed_tools=["Read", "Grep"]` | `Read` および `Grep` は自動承認されます。ここにリストされていないツールは引き続き存在し、パーミッションモードおよび `canUseTool` にフォールスルーします。 |80| `allowed_tools=["Read", "Grep"]` | `Read` と `Grep` は自動承認されます。ここにリストされていない他のツールは依然として存在し、承認が必要なそれらへの呼び出しは権限モードと `canUseTool` にフォールスルーします。 |

76| `disallowed_tools=["Bash"]` | `Bash` ツール定義はリクエストから削除されます。Claude はツールを認識せず、それを試みることはできません。 |81| `disallowed_tools=["Bash"]` | `Bash` ツール定義はリクエストから削除されます。Claude はツールを認識せず、実行を試みることはできません。 |

77| `disallowed_tools=["Bash(rm *)"]` | `Bash` は利用可能なままです。`rm *` に一致する呼び出しは、`bypassPermissions` を含むすべてのパーミッションモードで拒否されます。その他の `Bash` 呼び出しはパーミッションモードにフォールスルーします。 |82| `disallowed_tools=["Bash(rm *)"]` | `Bash` は利用可能なままです。`rm *`[に記載されているとおり](/docs/ja/permissions#bash-rule-limits)にマッチする呼び出しは、`bypassPermissions` を含むすべての権限モードで拒否されます。`/bin/rm` を含む他の `Bash` 呼び出しは、権限モードにフォールスルーします。 |

78| `disallowed_tools=["*"]` | すべてのツール定義はリクエストから削除されます。拒否ルールではツール名グロブがサポートされています。`"*"` はすべてのツールに一致し、`"mcp__*"` はすべてのサーバー全体のすべての MCP ツールに一致します。 |83| `disallowed_tools=["*"]` | すべてのツール定義がリクエストから削除されます。拒否ルールではツール名グロブがサポートされています：`"*"` はすべてのツールにマッチし、`"mcp__*"` はすべてのサーバー全体のすべての MCP ツールにマッチします。 |

79 84 

80許可ルールは、リテラル `mcp__<server>__` プレフィックスの後にのみツール名グロブを受け入れます。サーバーセグメントはグロブフリーである必要があり、設定したサーバーに名前を付けます。`mcp__puppeteer__*` は `puppeteer` サーバーからのすべてのツールに一致し、`mcp__github__get_*` はその `get_` ツールに一致します。`allowed_tools=["*"]` または `allowed_tools=["mcp__*"]` のようなアンカーされていないエントリは、スタートアップ警告で無視され、何も自動承認しません。85許可ルールは、リテラル `mcp__<server>__` プレフィックスの後にのみツール名グロブを受け入れます。サーバーセグメントはグロブフリーである必要があり、設定したサーバーを指定します：`mcp__puppeteer__*` は `puppeteer` サーバーからのすべてのツールにマッチし、`mcp__github__get_*` はその `get_` ツールにマッチします。`allowed_tools=["*"]` や `allowed_tools=["mcp__*"]` のようなアンカーなしエントリは、スタートアップ警告で無視され、何も自動承認しません。

81 86 

82`Read` および `Edit` のスコープ付きルールはパスパターンを取ります。`Edit(path)` ルールは、`Write` および `NotebookEdit` を含む、ファイルを書き込むすべての組み込みツールを管理します。`Write(path)` ルールはファイル権限チェックと一致することはありません。87`Read` と `Edit` のスコープ付きルールはパスパターンを取ります。`Edit(path)` ルールは、`Write` と `NotebookEdit` を含む、ファイルを書き込むすべての組み込みツールを管理します。`Write(path)` ルールはファイル権限チェックによってマッチすることはありません。

83 88 

84絶対ファイルシステムパスには `//path` を使用します。`Edit(//secrets/**)` の拒否ルールは、ディスク上の `/secrets` の下のどこでも書き込みをブロックします。単一の先頭スラッシュを使用する場合、`Edit(/secrets/**)` はルールのソースでアンカーされます。`allowed_tools` または `disallowed_tools` を通じて渡されるルールの場合、これはセッションの作業ディレクトリを意味するため、ルールはディスク上の `/secrets` をブロックしません。4 つのアンカー形式と設定ファイルからのルール解決方法については、[Read および Edit ルール](/docs/ja/permissions#read-and-edit)を参照してください。89絶対ファイルシステムパスには `//path` を使用します：`Edit(//secrets/**)` の拒否ルールは、ディスク上の `/secrets` の下のどこでも書き込みをブロックします。単一の先頭スラッシュの場合、`Edit(/secrets/**)` はルールのソースでアンカーします。`allowed_tools` または `disallowed_tools` を通じて渡されるルールの場合、それはセッションの作業ディレクトリを意味するため、ルールはディスク上の `/secrets` をブロックしません。[Read と Edit ルール](/docs/ja/permissions#read-and-edit)で 4 つのアンカー形式と、設定ファイルからのルール解決方法を参照してください。

85 90 

86<Warning>91<Warning>

87 **自動承認されたツールは `canUseTool` に到達しません。** 任意の前のステップで承認されたツール呼び出し（`acceptEdits` または `bypassPermissions` による、または許可ルールによる）は、`canUseTool` コールバックをスキップするため、そこに配置した権限チェックはそのツールに対して静かにバイパスされます。`AskUserQuestion`、MCP ツール（[`_meta["anthropic/requiresUserInteraction"]`](/docs/ja/mcp#require-approval-for-a-specific-tool) でマークされたもの）、およびコネクタツール（[組織が `ask` に設定したもの](/docs/ja/mcp#organization-controls-on-connector-tools)）は、許可ルールが一致する場合でもコールバックに到達します。92 **自動承認ツールは `canUseTool` に到達しません。** `acceptEdits` または `bypassPermissions` によって、または許可ルールによって、任意の前のステップで承認されたツール呼び出しは、その `canUseTool` コールバックをスキップするため、そこに配置した権限チェックはそのツールに対して静かにバイパスされます。`AskUserQuestion`、MCP ツール（[`_meta["anthropic/requiresUserInteraction"]`](/docs/ja/mcp#require-approval-for-a-specific-tool)でマークされている）、コネクタツール（[組織が `ask` に設定](/docs/ja/mcp#organization-controls-on-connector-tools)）、および[重要なパス](/docs/ja/permission-modes#critical-paths)をターゲットとする `rm` と `rmdir` 削除は、許可ルールがマッチする場合でも、コールバックに到達します。`auto` モードでは、重要なパス削除は[分類器](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)に移動し、コールバックには移動しません。一方、ここにリストされている他の呼び出しはそれでも到達します。分類器ルーティングには Claude Code v2.1.218 以降が必要です。`dontAsk` モードでは、これらの呼び出しは代わりに拒否され、コールバックを呼び出しません。

88 93 

89 カバレッジはエントリの形式に依存します。`Read` または `mcp__github__get_issue` のような単純な名前は、そのツールへのすべての呼び出しを自動承認しますが、`Bash(ls *)` のようなスコープ付きルールは一致する呼び出しのみを自動承認し、その他の `Bash` 呼び出しはコールバックにフォールスルーします。すべてのツール呼び出しで実行する必要があるチェックについては、[`PreToolUse` フック](/docs/ja/agent-sdk/hooks)を使用してください。フックはすべての他のステップの前に実行され、フック拒否は `bypassPermissions` モードでも適用されます。94 カバレッジはエントリの形式に依存します：`Read` や `mcp__github__get_issue` のような裸の名前は、上記の例外を除いて、そのツールへのすべての呼び出しを自動承認しますが、`Bash(npm test *)` のようなスコープ付きルールはマッチする呼び出しのみを自動承認し、承認が必要な他の `Bash` 呼び出しはコールバックにフォールスルーします。すべてのツール呼び出しで実行する必要があるチェックの場合は、[`PreToolUse` フック](/docs/ja/agent-sdk/hooks)を使用します：フックはすべての他のステップの前に実行され、フック拒否は `bypassPermissions` モードでも適用されます。

90</Warning>95</Warning>

91 96 

92ロックダウンされたエージェントの場合、`allowedTools` を `permissionMode: "dontAsk"` と組み合わせます。リストされたツールは承認されます。上記の警告の常にプロンプトが表示されるツールを除き、その他のものはプロンプトの代わりに直接拒否されます。97ロックダウンされたエージェントの場合、`allowedTools` を `permissionMode: "dontAsk"` と組み合わせます：

93 98 

94```typescript theme={null}99```typescript theme={null}

95const options = {100const options = {

98};103};

99```104```

100 105 

106リストされたツールは承認されます。ただし、[モードが自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を除きます。プロンプトを表示する他のすべての呼び出しは代わりに拒否されます。`default` モードで承認が不要な呼び出しは、リストするかどうかに関わらず実行されます。例えば、[読み取り専用 Bash コマンド](/docs/ja/permissions#read-only-commands)、`Agent` のような実行前に尋ねないツール、および作業ディレクトリ内のファイル読み取りなどです。ツールを Claude の到達範囲から完全に外すには、その裸の名前を `disallowedTools` に追加します。

107 

101<Warning>108<Warning>

102 **`allowed_tools` は `bypassPermissions` を制限しません。** `allowed_tools` はリストしたツールのみを事前承認します。リストされていないツールは許可ルールと一致せず、パーミッションモードにフォールスルーします。ここで `bypassPermissions` はそれらを承認します。`allowed_tools=["Read"]` を `permission_mode="bypassPermissions"` と一緒に設定すると、`Bash`、`Write`、`Edit` を含むすべてのツールが承認されます。`bypassPermissions` が必要だが特定のツールをブロックしたい場合は、`disallowed_tools` を使用してください。109 **`allowed_tools` は `bypassPermissions` を制約しません。** `allowed_tools` はリストしたツールを事前承認します。リストされていない他のツールは、許可ルールによってマッチされず、権限モードにフォールスルーします。ここで `bypassPermissions` はそれらを承認します。`allowed_tools=["Read"]` を `permission_mode="bypassPermissions"` と一緒に設定すると、`Bash`、`Write`、`Edit` を含むすべてのツールが承認されます。`bypassPermissions` が必要だが、特定のツールをブロックしたい場合は、`disallowed_tools` を使用します。

103</Warning>110</Warning>

104 111 

105`.claude/settings.json` で許可、拒否、および質問ルールを宣言的に設定することもできます。これらのルールは、`project` 設定ソースが有効な場合に読み込まれます。デフォルトの `query()` オプションではこれが有効です。`setting_sources`（TypeScript：`settingSources`）を明示的に設定する場合は、それらを適用するために `"project"` を含めてください。ルール構文については、[パーミッション設定](/docs/ja/settings#permission-settings)を参照してください。112`.claude/settings.json` で許可、拒否、および質問ルールを宣言的に設定することもできます。これらのルールは、`project` 設定ソースが有効な場合に読み込まれます。デフォルト `query()` オプションではこれが有効です。`setting_sources`（TypeScript：`settingSources`）を明示的に設定する場合は、それらを適用するために `"project"` を含めます。[権限設定](/docs/ja/settings-reference#permission-settings)でルール構文を参照してください。

106 113 

107<h2 id="permission-modes">114<h2 id="permission-modes">

108 パーミッションモード115 権限モード

109</h2>116</h2>

110 117 

111パーミッションモードは、Claude がツールをどのように使用するかについてのグローバル制御を提供します。`query()` を呼び出すときにパーミッションモードを設定するか、ストリーミングセッション中に動的に変更できます。118権限モードは、Claude がツールをどのように使用するかについてグローバルコントロールを提供します。`query()` を呼び出すときに権限モードを設定するか、ストリーミングセッション中に動的に変更できます。

112 119 

113<h3 id="available-modes">120<h3 id="available-modes">

114 利用可能なモード121 利用可能なモード

115</h3>122</h3>

116 123 

117SDK は以下のパーミッションモードをサポートしています。124SDK は以下の権限モードをサポートしています。

118 125 

119| モード | 説明 | ツール動作 |126| モード | 説明 | ツール動作 |

120| :------------------ | :--------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |127| :------------------ | :----------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

121| `default` | 標準パーミッション動作 | 自動承認なし。一致しないツールは `canUseTool` コールバックをトリガーします |128| `default` | 標準的な権限動作 | モードベースの自動承認なし。承認が必要で許可ルールに一致しないコールは、`canUseTool` コールバックをトリガーします |

122| `dontAsk` | プロンプトの代わりに拒否 | `allowed_tools` またはルールで事前承認されていないものはすべて拒否されます。コネクタツール[組織が `ask` に設定](/docs/ja/mcp#organization-controls-on-connector-tools)したもの、およびユーザーインタラクションが必要なツールは、事前承認していても拒否されます。`canUseTool` は呼び出されません |129| `dontAsk` | プロンプトの代わりに拒否 | それ以外の場合はプロンプトが表示されるコールは拒否されます。`allowed_tools` またはルールで承認されたコール、および `default` モードで承認が不要なコールは実行されます。コネクタツール（[組織が `ask` に設定](/docs/ja/mcp#organization-controls-on-connector-tools)）およびユーザーインタラクションが必要なツール、ならびに [重要なパス](/docs/ja/permission-modes#critical-paths) をターゲットとする `rm` および `rmdir` の削除は、事前に承認していても拒否されます。`canUseTool` は呼び出されません |

123| `acceptEdits` | ファイル編集を自動受け入れ | ファイル編集および[ファイルシステム操作](#accept-edits-mode-acceptedits)（`mkdir`、`rm`、`mv` など）は自動的に承認されます |130| `acceptEdits` | ファイル編集を自動承認 | ファイル編集および [ファイルシステム操作](#accept-edits-mode-acceptedits)（`mkdir`、`rm`、`mv` など）は自動的に承認されます |

124| `bypassPermissions` | パーミッションチェックをバイパス | ツールは明示的な [`ask` ルール](#how-permissions-are-evaluated)が一致する場合、コネクタツール[組織が `ask` に設定](/docs/ja/mcp#organization-controls-on-connector-tools)した場合、およびユーザーインタラクションが必要なツール以外は、パーミッションプロンプトなしで実行されます（注意して使用してください） |131| `bypassPermissions` | 権限チェックをバイパス | [モードが自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves) を除き、ツールは権限プロンプトなしで実行されます。注意して使用してください |

125| `plan` | 計画モード | Claude はソースファイルを編集せずにコードベースを探索および計画します。ファイル編集は自動承認されず、`canUseTool` コールバックを通じてプロンプトが表示されます |132| `plan` | 計画モード | Claude はソースファイルを編集せずに探索と計画を行います。ファイル編集は自動承認されず、`canUseTool` コールバックを通じてプロンプトが表示されます |

126| `auto` | モデル分類承認 | モデル分類器が各ツール呼び出しを承認または拒否します。利用可能性については[自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)を参照してください |133| `auto` | モデル分類承認 | モデル分類器が権限プロンプトを承認または拒否します。利用可能性については [自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) を参照してください |

127 134 

128<Warning>135<Warning>

129 **サブエージェント継承：** 親が `bypassPermissions`、`acceptEdits`、または `auto` を使用する場合、すべてのサブエージェントはそのモードを継承し、サブエージェントごとにオーバーライドすることはできません。サブエージェントはシステムプロンプトが異なり、メインエージェントよりも制約が少ない動作をする可能性があるため、`bypassPermissions` を継承すると、完全な自律的なシステムアクセスが付与されます。明示的な [`ask` ルール](#how-permissions-are-evaluated)、コネクタツール[組織が `ask` に設定](/docs/ja/mcp#organization-controls-on-connector-tools)したもの、およびユーザーインタラクションが必要なツールは引き続きプロンプトを強制します。136 **サブエージェント継承：** サブエージェントは、その [`AgentDefinition`](/docs/ja/agent-sdk/typescript#agentdefinition) で `permissionMode` を設定し、親セッションが `default`、`dontAsk`、または `plan` モードにある場合を除き、親セッションの権限モードで実行されます。その場合でも、Claude Code は `"bypassPermissions"` 値を適用しません。サブエージェントは、親セッション自体が `bypassPermissions` モードにある場合にのみ、`bypassPermissions` モードで実行されます。`bypassPermissions` 例外には Claude Code v2.1.267 以降が必要です。

137 

138 サブエージェントは、メインエージェントとは異なるシステムプロンプトを持つ可能性があり、動作がより制約されていないため、`bypassPermissions` を継承すると、完全で自律的なシステムアクセスが付与されます。[モードが自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves) は引き続き適用されます。

130</Warning>139</Warning>

131 140 

132<h3 id="set-permission-mode">141<h3 id="set-permission-mode">

133 パーミッションモードの設定142 権限モードを設定する

134</h3>143</h3>

135 144 

136クエリを開始するときにパーミッションモードを一度設定するか、セッションがアクティブな間に動的に変更できます。145クエリを開始するときに権限モードを一度設定するか、セッションがアクティブな間に動的に変更できます。

137 146 

138<Tabs>147<Tabs>

139 <Tab title="クエリ時">148 <Tab title="クエリ時">

149 async for message in query(158 async for message in query(

150 prompt="Help me refactor this code",159 prompt="Help me refactor this code",

151 options=ClaudeAgentOptions(160 options=ClaudeAgentOptions(

152 permission_mode="default", # ここでモードを設定161 permission_mode="default", # Set the mode here

153 ),162 ),

154 ):163 ):

155 if hasattr(message, "result"):164 if hasattr(message, "result"):

166 for await (const message of query({175 for await (const message of query({

167 prompt: "Help me refactor this code",176 prompt: "Help me refactor this code",

168 options: {177 options: {

169 permissionMode: "default" // ここでモードを設定178 permissionMode: "default" // Set the mode here

170 }179 }

171 })) {180 })) {

172 if ("result" in message) {181 if ("result" in message) {

181 </Tab>190 </Tab>

182 191 

183 <Tab title="ストリーミング中">192 <Tab title="ストリーミング中">

184 `set_permission_mode()`（Python）または `setPermissionMode()`（TypeScript）を呼び出して、セッション中盤でモードを変更します。新しいモードは、その後のすべてのツールリクエストに対して直ちに有効になります。これにより、制限的に開始し、信頼が構築されるにつれてパーミッションを緩和できます。たとえば、Claude の初期アプローチをレビューした後に `acceptEdits` に切り替えます。193 `set_permission_mode()`（Python）または `setPermissionMode()`（TypeScript）を呼び出して、セッション中盤でモードを変更します。新しいモードは、その後のすべてのツールリクエストに対して直ちに有効になります。これにより、制限的に開始して、信頼が構築されるにつれて権限を緩和できます。たとえば、Claude の初期アプローチを確認した後に `acceptEdits` に切り替えることができます。

185 194 

186 <CodeGroup>195 <CodeGroup>

187 ```python Python theme={null}196 ```python Python theme={null}

192 async def main():201 async def main():

193 async with ClaudeSDKClient(202 async with ClaudeSDKClient(

194 options=ClaudeAgentOptions(203 options=ClaudeAgentOptions(

195 permission_mode="default", # デフォルトモードで開始204 permission_mode="default", # Start in default mode

196 )205 )

197 ) as client:206 ) as client:

198 await client.query("Help me refactor this code")207 await client.query("Help me refactor this code")

199 208 

200 # セッション中盤でモードを動的に変更209 # Change mode dynamically mid-session

201 await client.set_permission_mode("acceptEdits")210 await client.set_permission_mode("acceptEdits")

202 211 

203 # 新しいパーミッションモードでメッセージを処理212 # Process messages with the new permission mode

204 async for message in client.receive_response():213 async for message in client.receive_response():

205 if hasattr(message, "result"):214 if hasattr(message, "result"):

206 print(message.result)215 print(message.result)

216 const q = query({225 const q = query({

217 prompt: "Help me refactor this code",226 prompt: "Help me refactor this code",

218 options: {227 options: {

219 permissionMode: "default" // デフォルトモードで開始228 permissionMode: "default" // Start in default mode

220 }229 }

221 });230 });

222 231 

223 // セッション中盤でモードを動的に変更232 // Change mode dynamically mid-session

224 await q.setPermissionMode("acceptEdits");233 await q.setPermissionMode("acceptEdits");

225 234 

226 // 新しいパーミッションモードでメッセージを処理235 // Process messages with the new permission mode

227 for await (const message of q) {236 for await (const message of q) {

228 if ("result" in message) {237 if ("result" in message) {

229 console.log(message.result);238 console.log(message.result);

242</h3>251</h3>

243 252 

244<h4 id="accept-edits-mode-acceptedits">253<h4 id="accept-edits-mode-acceptedits">

245 ファイル編集モード（`acceptEdits`）254 編集受け入れモード（`acceptEdits`）

246</h4>255</h4>

247 256 

248ファイル操作を自動承認し、Claude がプロンプトなしでコードを編集できるようにします。その他のツール（ファイルシステム操作ではない Bash コマンドなど）は引き続き通常のパーミッションが必要です。257ファイル操作を自動承認して、Claude がプロンプトなしでコードを編集できるようにします。その他のツール（ファイルシステム操作ではない Bash コマンドなど）は通常の権限が必要です。

249 258 

250**自動承認される操作：**259**自動承認される操作：**

251 260 

252* ファイル編集（Edit、Write ツール）261* ファイル編集（Edit、Write ツール）

253* ファイルシステムコマンド：`mkdir`、`touch`、`rm`、`rmdir`、`mv`、`cp`、`sed`262* ファイルシステムコマンド：`mkdir`、`touch`、`rm`、`rmdir`、`mv`、`cp`、`sed`

254 263 

255どちらも、作業ディレクトリまたは `additionalDirectories` 内のパスにのみ適用されます。そのスコープ外のパスおよび保護されたパスへの書き込みはプロンプトが表示されます。264どちらも、作業ディレクトリまたは `additionalDirectories` 内のパスにのみ適用されます。`acceptEdits` モードでは、Claude が以下の場合、Claude Code は要求を自動承認しません。

265 

266* そのスコープ外のパスで作業する

267* 保護されたパスに書き込む

268* `rm` または `rmdir` で [重要なパス](/docs/ja/permission-modes#critical-paths) を削除する

256 269 

257**使用時期：** Claude の編集を信頼し、プロトタイピング中など、より高速な反復を望む場合、または分離されたディレクトリで作業する場合。270**使用時期：** Claude の編集を信頼し、より高速な反復を望む場合。プロトタイピング中や分離されたディレクトリで作業する場合など。

258 271 

259<h4 id="don’t-ask-mode-dontask">272<h4 id="don’t-ask-mode-dontask">

260 質問しないモード（`dontAsk`）273 質問しないモード（`dontAsk`）

261</h4>274</h4>

262 275 

263パーミッションプロンプトを拒否に変換します。`allowed_tools`、`settings.json` 許可ルール、またはフックで事前承認されたツールは通常どおり実行されます。コネクタツール[組織が `ask` に設定](/docs/ja/mcp#organization-controls-on-connector-tools)したもの、およびユーザーインタラクションが必要なツールは、許可ルールが一致する場合でも拒否されます。その他のすべては `canUseTool` を呼び出さずに拒否されます。276`canUseTool` を呼び出さずに、権限プロンプトを拒否に変換します。`allowed_tools`、`settings.json` 許可ルール、またはフックで事前承認されたツール、および `default` モードで承認が不要なコール（作業ディレクトリ内のファイル読み取りや `Agent` への呼び出しなど）は通常どおり実行されます。コネクタツール（[組織が `ask` に設定](/docs/ja/mcp#organization-controls-on-connector-tools)）、ユーザーインタラクションが必要なツール、および [重要なパス](/docs/ja/permission-modes#critical-paths) をターゲットとする `rm` および `rmdir` の削除は、許可ルールが一致する場合でも拒否されます。`PreToolUse` フック許可は、重要なパス削除をクリアしません。

264 277 

265**使用時期：** ヘッドレスエージェント用に固定された明示的なツール表面が必要で、`canUseTool` が存在しないことへの暗黙的な依存よりもハード拒否を優先する場合。278**使用時期：** ヘッドレスエージェント用に固定された明示的なツールサーフェスを望み、`canUseTool` が存在しないことへの暗黙的な依存よりもハード拒否を優先する場合。

266 279 

267<h4 id="bypass-permissions-mode-bypasspermissions">280<h4 id="bypass-permissions-mode-bypasspermissions">

268 パーミッションバイパスモード（`bypassPermissions`）281 権限バイパスモード（`bypassPermissions`）

269</h4>282</h4>

270 283 

271プロンプトなしですべてのツール使用を自動承認します。フックは引き続き実行され、必要に応じて操作をブロックできます。284以下に示す場合を除き、プロンプトなしでツール使用を自動承認します。フックは引き続き実行され、必要に応じて操作をブロックできます。

272 285 

273<Warning>286<Warning>

274 極度の注意を持って使用してください。Claude はこのモードでフルシステムアクセスを持ちます。すべての可能な操作を信頼できる制御された環境でのみ使用してください。287 極度の注意を持って使用してください。このモードでは Claude はシステムへの完全なアクセスを持ちます。信頼できるすべての操作が可能な制御された環境でのみ使用してください。

288 

289 `allowed_tools` はこのモードを制約しません。リストしたツールだけでなく、すべてのツールが承認されます。これらのコントロールは引き続き適用されます。

275 290 

276 `allowed_tools` はこのモードを制限しません。リストしたツールだけでなく、すべてのツールが承認されます。拒否ルール（`disallowed_tools`）、明示的な `ask` ルール、およびフックはモードチェック前に評価され、ツールをブロックできます。コネクタツール[組織が `ask` に設定](/docs/ja/mcp#organization-controls-on-connector-tools)したもの、およびユーザーインタラクションが必要なツールは引き続き `canUseTool` コールバックにフォールスルーします。291 * 拒否ルール、明示的な `ask` ルール、およびフックはモードチェック前に評価され、ツールをブロックできます。

292 * コネクタツール（[組織が `ask` に設定](/docs/ja/mcp#organization-controls-on-connector-tools)）、ユーザーインタラクションが必要なツール、および [重要なパス](/docs/ja/permission-modes#critical-paths) をターゲットとする `rm` および `rmdir` の削除は、引き続き `canUseTool` コールバックにフォールスルーします。

293 * [クロスセッションメッセージングセーフガード](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode) は引き続き適用されます。

277</Warning>294</Warning>

278 295 

279<h4 id="plan-mode-plan">296<h4 id="plan-mode-plan">

280 計画モード（`plan`）297 計画モード（`plan`）

281</h4>298</h4>

282 299 

283Claude はコードベースを探索および計画を作成し、ソースファイルを編集しません。読み取り専用ツールはデフォルトモードと同じように実行されます。ファイル編集は計画モードで自動承認されることはなく、許可ルールが一致する場合でも、代わりに `canUseTool` コールバックを通じてプロンプトが表示されます。Claude は計画を最終化する前に要件を明確にするために `AskUserQuestion` を使用する場合があります。これらのプロンプトの処理については、[承認とユーザー入力の処理](/docs/ja/agent-sdk/user-input#handle-clarifying-questions)を参照してください。300Claude はソースファイルを編集せずにコードベースを探索し、計画を作成します。読み取り専用ツールは `default` 権限モードと同じように実行されます。

301 

302ファイル編集は計画モードで自動承認されません。許可ルールが一致する場合でも、代わりに `canUseTool` コールバックを通じてプロンプトが表示されます。Claude Code v2.1.212 以降では、`touch` や `rm` などのファイルを変更するシェルコマンドは同じ方法で `canUseTool` コールバックに到達します。

303 

304Claude は計画を最終化する前に、`AskUserQuestion` を使用して要件を明確にする場合があります。これらのプロンプトの処理については、[承認とユーザー入力の処理](/docs/ja/agent-sdk/user-input#handle-clarifying-questions) を参照してください。

284 305 

285**使用時期：** Claude に変更を提案させたいが実行させたくない場合、たとえばコードレビュー中または変更を実行する前に承認が必要な場合。306**使用時期：** Claude に変更を実行せずに提案させたい場合。コードレビュー中や、変更が行われる前に承認する必要がある場合など。

286 307 

287<h2 id="related-resources">308<h2 id="related-resources">

288 関連リソース309 関連リソース

289</h2>310</h2>

290 311 

291パーミッション評価フロー内の他のステップについては、以下を参照してください。312権限評価フローの他のステップについては、以下をご覧ください。

292 313 

293* [承認とユーザー入力の処理](/docs/ja/agent-sdk/user-input)：対話的な承認プロンプトと明確化の質問314* [承認とユーザー入力の処理](/docs/ja/agent-sdk/user-input)：インタラクティブな承認プロンプトと確認質問

294* [フックガイド](/docs/ja/agent-sdk/hooks)：エージェントライフサイクルの主要なポイントでカスタムコードを実行315* [Hooks ガイド](/docs/ja/agent-sdk/hooks)：エージェントライフサイクルの重要なポイントでカスタムコードを実行

295* [パーミッションルール](/docs/ja/settings#permission-settings)：`settings.json` の宣言的な許可/拒否ルール316* [権限ルール](/docs/ja/settings-reference#permission-settings)：`settings.json` の宣言的な許可/拒否ルール

513 async def receive_messages(self) -> AsyncIterator[Message]513 async def receive_messages(self) -> AsyncIterator[Message]

514 async def receive_response(self) -> AsyncIterator[Message]514 async def receive_response(self) -> AsyncIterator[Message]

515 async def interrupt(self) -> None515 async def interrupt(self) -> None

516 async def set_permission_mode(self, mode: str) -> None516 async def set_permission_mode(self, mode: PermissionMode) -> None

517 async def set_model(self, model: str | None = None) -> None517 async def set_model(self, model: str | None = None) -> None

518 async def rewind_files(self, user_message_id: str) -> None518 async def rewind_files(self, user_message_id: str) -> None

519 async def get_mcp_status(self) -> McpStatusResponse519 async def get_mcp_status(self) -> McpStatusResponse

543| `reconnect_mcp_server(server_name)` | 失敗したか切断された MCP サーバーへの再接続を試みます |543| `reconnect_mcp_server(server_name)` | 失敗したか切断された MCP サーバーへの再接続を試みます |

544| `toggle_mcp_server(server_name, enabled)` | セッション中に MCP サーバーを有効または無効にします。無効にするとそのツールが削除されます |544| `toggle_mcp_server(server_name, enabled)` | セッション中に MCP サーバーを有効または無効にします。無効にするとそのツールが削除されます |

545| `stop_task(task_id)` | 実行中のバックグラウンドタスクを停止します。ステータス `"stopped"` の [`TaskNotificationMessage`](#tasknotificationmessage) がメッセージストリームに続きます |545| `stop_task(task_id)` | 実行中のバックグラウンドタスクを停止します。ステータス `"stopped"` の [`TaskNotificationMessage`](#tasknotificationmessage) がメッセージストリームに続きます |

546| `get_server_info()` | セッション ID と機能を含むサーバー情報を取得します |546| `get_server_info()` | サーバーの初期化情報（利用可能なコマンドと出力スタイルを含む）を取得します |

547| `disconnect()` | Claude から切断します |547| `disconnect()` | Claude から切断します |

548 548 

549<h4 id="context-manager-support">549<h4 id="context-manager-support">

2006すべてのコンテンツブロックの Union 型。2006すべてのコンテンツブロックの Union 型。

2007 2007 

2008```python theme={null}2008```python theme={null}

2009ContentBlock = TextBlock | ThinkingBlock | ToolUseBlock | ToolResultBlock2009ContentBlock = (

2010 TextBlock

2011 | ThinkingBlock

2012 | ToolUseBlock

2013 | ToolResultBlock

2014 | ServerToolUseBlock

2015 | ServerToolResultBlock

2016)

2010```2017```

2011 2018 

2012<h3 id="textblock">2019<h3 id="textblock">

3676| `allowedDomains` | `list[str]` | `[]` | サンドボックス化されたプロセスがアクセスできるドメイン名 |3683| `allowedDomains` | `list[str]` | `[]` | サンドボックス化されたプロセスがアクセスできるドメイン名 |

3677| `deniedDomains` | `list[str]` | `[]` | サンドボックス化されたプロセスがアクセスできないドメイン名。`allowedDomains` より優先されます |3684| `deniedDomains` | `list[str]` | `[]` | サンドボックス化されたプロセスがアクセスできないドメイン名。`allowedDomains` より優先されます |

3678| `allowManagedDomainsOnly` | `bool` | `False` | マネージド設定のみ：マネージド設定で設定されている場合、`allowedDomains` と非マネージド設定ソースからの `WebFetch(domain:...)` 許可ルールを無視します。SDK オプションで設定された場合は効果がありません |3685| `allowManagedDomainsOnly` | `bool` | `False` | マネージド設定のみ：マネージド設定で設定されている場合、`allowedDomains` と非マネージド設定ソースからの `WebFetch(domain:...)` 許可ルールを無視します。SDK オプションで設定された場合は効果がありません |

3679| `allowUnixSockets` | `list[str]` | `[]` | プロセスがアクセスできる Unix ソケットパス（例：Docker ソケット） |3686| `allowUnixSockets` | `list[str]` | `[]` | macOS のみ：プロセスがアクセスできる Unix ソケットパス（例：Docker ソケット）。Linux では無視されます |

3680| `allowAllUnixSockets` | `bool` | `False` | すべての Unix ソケットへのアクセスを許可します |3687| `allowAllUnixSockets` | `bool` | `False` | すべての Unix ソケットへのアクセスを許可します |

3681| `allowLocalBinding` | `bool` | `False` | プロセスがローカルポートにバインドすることを許可します（例：dev サーバー用） |3688| `allowLocalBinding` | `bool` | `False` | プロセスがローカルポートにバインドすることを許可します（例：dev サーバー用） |

3682| `allowMachLookup` | `list[str]` | `[]` | macOS のみ：許可する XPC/Mach サービス名。末尾のワイルドカードをサポートします |3689| `allowMachLookup` | `list[str]` | `[]` | macOS のみ：許可する XPC/Mach サービス名。末尾のワイルドカードをサポートします |

103 Skills が読み込まれたことを確認する103 Skills が読み込まれたことを確認する

104</h3>104</h3>

105 105 

106ストリームの開始付近で、SDK はサブタイプ `init` のシステムメッセージを生成します。その `skills` 配列をチェックして、Claude が作業を開始する前に Skills が読み込まれたことを確認します。配列には、定義したユーザー呼び出し可能な Skills と、[Claude Code に含まれるバンドルされた Skills](/docs/ja/skills#bundled-skills) が含まれます。106ストリームの開始付近で、SDK はサブタイプ `init` のシステムメッセージを生成します。その `skills` 配列をチェックして、Claude が作業を開始する前に Skills が読み込まれたことを確認します。配列には、`description` または `when_to_use` frontmatter フィールドで定義したユーザー呼び出し可能な Skills と、[Claude Code に含まれるバンドルされた Skills](/docs/ja/skills#bundled-skills) が含まれます。

107 107 

108配列はユーザー呼び出し可能な Skills のみをリストします。フロントマターで [`user-invocable: false`](/docs/ja/skills#control-who-invokes-a-skill) を持つ Skill は読み込まれ、Claude で利用可能なままですが、配列には表示されません。配列は、セッションが検出したものを反映し、`skills` リストに含まれているかどうかに関わらず、同じ Skills をリストします。108配列はユーザー呼び出し可能な Skills のみをリストします。フロントマターで [`user-invocable: false`](/docs/ja/skills#control-who-invokes-a-skill) を持つ Skill は読み込まれ、Claude で利用可能なままですが、配列には表示されません。配列は、`skills` リストに含まれているかどうかに関わらず、同じ Skills をリストします。

109 109 

110<h3 id="allow-only-specific-skills">110<h3 id="allow-only-specific-skills">

111 特定の Skills のみを許可する111 特定の Skills のみを許可する

173Available commands: ["clear", "compact", "context", "usage", "code-review", "verify", "security-check", ...]173Available commands: ["clear", "compact", "context", "usage", "code-review", "verify", "security-check", ...]

174```174```

175 175 

176ユーザー呼び出し可能な Skills は、このリストと[Skills が読み込まれたことを確認する](#confirm-skills-loaded)からの `skills` 配列の両方に表示されます。`slash_commands` リストは、セッションで利用可能な残りのコマンドを追加します。フロントマターで [`user-invocable: false`](/docs/ja/skills#control-who-invokes-a-skill) を持つ Skill はどちらにも表示されません。[MCP サーバー](/docs/ja/agent-sdk/mcp)を設定するセッションは、[MCP プロンプトをコマンドとしてエクスポーズ](/docs/ja/mcp#use-mcp-prompts-as-commands)することもできます。176フロントマターで [`user-invocable: false`](/docs/ja/skills#control-who-invokes-a-skill) を持つ skill はこのリストや[Confirm skills loaded](#confirm-skills-loaded)からの `skills` 配列に表示されません。[MCP サーバー](/docs/ja/agent-sdk/mcp)を設定するセッションは、[MCP プロンプトをコマンドとして使用](/docs/ja/mcp#use-mcp-prompts-as-commands)することもできます。

177 177 

178<h3 id="dispatch-commands-by-name">178<h3 id="dispatch-commands-by-name">

179 名前でコマンドをディスパッチする179 名前でコマンドをディスパッチする

79 79 

80部分的なメッセージが有効な場合、生の Claude API ストリーミングイベントがオブジェクトでラップされて返されます。タイプは各 SDK で異なる名前を持ちます：80部分的なメッセージが有効な場合、生の Claude API ストリーミングイベントがオブジェクトでラップされて返されます。タイプは各 SDK で異なる名前を持ちます：

81 81 

82* **Python**: `StreamEvent`（`claude_agent_sdk.types` からインポート）82* **Python**: [`StreamEvent`](/docs/ja/agent-sdk/python#streamevent)（`claude_agent_sdk.types` からインポート）

83* **TypeScript**: `SDKPartialAssistantMessage` with `type: 'stream_event'`83* **TypeScript**: [`SDKPartialAssistantMessage`](/docs/ja/agent-sdk/typescript#sdkpartialassistantmessage) with `type: 'stream_event'`

84 84 

85どちらも生の Claude API イベントを含み、蓄積されたテキストではありません。テキストデルタを自分で抽出して蓄積する必要があります。各タイプの構造は以下の通りです：85どちらも生の Claude API イベントを含み、蓄積されたテキストではありません。テキストデルタを自分で抽出して蓄積する必要があります。

86 

87<CodeGroup>

88 ```python Python theme={null}

89 @dataclass

90 class StreamEvent:

91 uuid: str # このイベントの一意の識別子

92 session_id: str # セッション識別子

93 event: dict[str, Any] # 生の Claude API ストリームイベント

94 parent_tool_use_id: str | None # 常に None

95 ```

96 

97 ```typescript TypeScript theme={null}

98 type SDKPartialAssistantMessage = {

99 type: "stream_event";

100 event: BetaRawMessageStreamEvent; // Anthropic SDK から

101 parent_tool_use_id: string | null;

102 uuid: UUID;

103 session_id: string;

104 ttft_ms?: number; // メッセージ開始イベントにのみ存在する、最初のトークンまでの時間（ミリ秒）

105 user_message_uuid?: string;

106 };

107 ```

108</CodeGroup>

109 86 

110`parent_tool_use_id` フィールドは Python では常に `None`、TypeScript では `null` です。ストリームイベントはメインセッションのみに対して発行されます。サブエージェントからのトークンレベルのデルタは転送されません。出力をサブエージェントに属性付けするには、`parent_tool_use_id` を含む完全なメッセージを使用してください。[サブエージェント呼び出しの検出](/docs/ja/agent-sdk/subagents#detect-subagent-invocation)を参照してください。87`parent_tool_use_id` フィールドは Python では常に `None`、TypeScript では `null` です。ストリームイベントはメインセッションのみに対して発行されます。サブエージェントからのトークンレベルのデルタは転送されません。出力をサブエージェントに属性付けするには、`parent_tool_use_id` を含む完全なメッセージを使用してください。[サブエージェント呼び出しの検出](/docs/ja/agent-sdk/subagents#detect-subagent-invocation)を参照してください。

111 88 

12 12 

13確認質問については、Claude が質問とオプションを生成します。あなたの役割は、それらをユーザーに提示して、ユーザーの選択を返すことです。このフローに独自の質問を追加することはできません。ユーザーに何か尋ねる必要がある場合は、アプリケーションロジックで別途実行してください。13確認質問については、Claude が質問とオプションを生成します。あなたの役割は、それらをユーザーに提示して、ユーザーの選択を返すことです。このフローに独自の質問を追加することはできません。ユーザーに何か尋ねる必要がある場合は、アプリケーションロジックで別途実行してください。

14 14 

15コールバックは無期限に保留中のままにすることができます。実行はコールバックが返されるまで一時停止したままであり、SDK はクエリ自体がキャンセルされた場合にのみ待機をキャンセルします。ユーザーがプロセスが合理的に実行し続けることができるより長く応答するのに時間がかかる可能性がある場合、[`PreToolUse` フック](/docs/ja/agent-sdk/hooks)を登録して、[`defer` 決定](/docs/ja/hooks#defer-a-tool-call-for-later)を返します。これにより、プロセスを終了して、後で永続化されたセッションから再開できます。15コールバックは無期限に保留中のままにすることができます。実行はコールバックが返されるまで一時停止したままです。ユーザーがプロセスが合理的に実行し続けることができるより長く応答するのに時間がかかる可能性がある場合、[`PreToolUse` フック](/docs/ja/agent-sdk/hooks)を登録して、[`defer` 決定](/docs/ja/hooks#defer-a-tool-call-for-later)を返すことで、プロセスを終了して、後で永続化されたセッションから再開できます。

16 16 

17このガイドでは、各タイプのリクエストを検出し、適切に応答する方法を示します。17このガイドでは、各タイプのリクエストを検出し、適切に応答する方法を示します。

18 18 

204 ```204 ```

205</CodeGroup>205</CodeGroup>

206 206 

207<Note>

208 Python では、`can_use_tool` は [ストリーミングモード](/docs/ja/agent-sdk/streaming-vs-single-mode)が必要です。有限のメッセージストリームを `query(prompt=generator)` または `ClaudeSDKClient.connect(prompt=async_iterable)` を通じて渡すと、登録されたフックまたはプロセス内 MCP サーバーがストリームを開いたままにしていない限り、SDK は最後のメッセージの後、許可コールバックが呼び出される前にストリームを閉じます。上記の例は、`{"continue_": True}` を返す `PreToolUse` フックでストリームを開いたままにします。プロンプトなしで接続し、`ClaudeSDKClient.query()` を通じてメッセージを送信すると、ストリームは自動的に開いたままになり、フックは不要です。

209</Note>

210 

211この例では y/n フローを使用しており、`y` 以外の入力は拒否として扱われます。実際には、ユーザーがリクエストを変更したり、フィードバックを提供したり、Claude を完全にリダイレクトしたりできるより豊富な UI を構築する可能性があります。すべての応答方法については [ツールリクエストに応答する](#respond-to-tool-requests)を参照してください。207この例では y/n フローを使用しており、`y` 以外の入力は拒否として扱われます。実際には、ユーザーがリクエストを変更したり、フィードバックを提供したり、Claude を完全にリダイレクトしたりできるより豊富な UI を構築する可能性があります。すべての応答方法については [ツールリクエストに応答する](#respond-to-tool-requests)を参照してください。

212 208 

213<h3 id="respond-to-tool-requests">209<h3 id="respond-to-tool-requests">

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