SpyBara
Go Premium

Documentation 2026-10-18 22:59 UTC to 2026-10-19 23:58 UTC

62 files changed +1,567 −1,011. View all changes and history on the product overview
2026
Fri 30 23:01 Thu 29 23:57 Wed 28 23:57 Tue 27 22:59 Mon 26 22:57 Sun 25 23:58 Sat 24 22:59 Fri 23 22:59 Thu 22 22:58 Wed 21 23:02 Tue 20 23:00 Mon 19 23:58 Sat 17 23:57 Fri 16 22:59 Thu 15 23:58 Wed 14 22:58 Tue 13 23:57 Sun 11 23:57 Sat 10 23:01 Fri 9 23:02 Thu 8 22:58 Wed 7 23:59 Tue 6 23:59 Mon 5 23:58 Sun 4 23:58 Sat 3 23:57 Fri 2 22:59 Thu 1 23:59
Details

291| :- | :- | :- |291| :- | :- | :- |

292| **システムプロンプト** | すべてのリクエスト | 小さい固定コスト、常に存在 |292| **システムプロンプト** | すべてのリクエスト | 小さい固定コスト、常に存在 |

293| **CLAUDE.md ファイル** | セッション開始時、[`settingSources`](/docs/ja/agent-sdk/claude-code-features)経由 | すべてのリクエストで完全なコンテンツ(ただしプロンプトキャッシュされるため、最初のリクエストのみが完全なコストを支払う) |293| **CLAUDE.md ファイル** | セッション開始時、[`settingSources`](/docs/ja/agent-sdk/claude-code-features)経由 | すべてのリクエストで完全なコンテンツ(ただしプロンプトキャッシュされるため、最初のリクエストのみが完全なコストを支払う) |

294| **ツール定義** | すべてのリクエスト。MCP スキーマはデフォルトで遅延 | 組み込みツールスキーマはすべてのリクエストをロードします。[ツール検索](/docs/ja/agent-sdk/mcp#mcp-tool-search)はデフォルトで MCP ツールスキーマを遅延させ、サポートされていないモデルと特定のプラットフォームでアップフロントロードにフォールバックします。完全なマトリックスについては、[ツール検索を構成](/docs/ja/agent-sdk/tool-search#configure-tool-search)を参照してください |294| **ツール定義** | Bash、Read、Edit などのコア組み込みツールはすべてのリクエスト。MCP ツールとその他の組み込みツールはオンデマンド([ツール検索](/docs/ja/agent-sdk/mcp#mcp-tool-search)がデフォルトで遅延させるため) | [ツール検索を構成](/docs/ja/agent-sdk/tool-search#configure-tool-search)に記載されたケースでは、すべてのスキーマが事前にロードされます |

295| **会話履歴** | ターン間で蓄積 | 各ターンで増加。プロンプト、応答、ツール入力、ツール出力 |295| **会話履歴** | ターン間で蓄積 | 各ターンで増加。プロンプト、応答、ツール入力、ツール出力 |

296| **スキル説明** | セッション開始時、設定ソース経由 | 短い要約。完全なコンテンツは呼び出し時のみロード |296| **スキル説明** | セッション開始時、設定ソース経由 | 短い要約。完全なコンテンツは呼び出し時のみロード |

297 297 


331 331 

332長時間実行されるエージェントのいくつかの戦略。332長時間実行されるエージェントのいくつかの戦略。

333 333 

334* **サブタスク用にサブエージェントを使用します。** 各サブエージェントは新しい会話で開始されます(以前のメッセージ履歴はありませんが、独自のシステムプロンプトとプロジェクトレベルのコンテキスト(CLAUDE.md など)をロードします)。親のターンは表示されず、最終応答のみが親に返されます。メインエージェントのコンテキストは完全なサブタスクトランスクリプトではなく、その要約で増加します。詳細については、[サブエージェントが継承するもの](/docs/ja/agent-sdk/subagents#what-subagents-inherit)を参照してください。334* **サブタスク用にサブエージェントを使用します。** サブエージェントは最終応答のみを返すため、メインエージェントのコンテキストはサブタスクのトランスクリプトではなく、要約の分だけ増加します。

335* **ツールを選別します。** すべてのツール定義はコンテキストスペースを取ります。[`AgentDefinition`](/docs/ja/agent-sdk/subagents#agentdefinition-configuration)の `tools` フィールドを使用してサブエージェントを必要な最小セットにスコープします。335* **ツールを選別します。** すべてのツール定義はコンテキストスペースを取ります。[`AgentDefinition`](/docs/ja/agent-sdk/subagents#agentdefinition-configuration)の `tools` フィールドを使用してサブエージェントを必要な最小セットにスコープします。

336* **MCP サーバーコストを監視します。** [MCP ツール検索](/docs/ja/agent-sdk/mcp#mcp-tool-search)はデフォルトで MCP ツールスキーマを遅延させ、オンデマンドでロードします。ツール検索がオフの場合またはサポートされていないモデルと特定のプラットフォームでアップフロントロードにフォールバックした場合、各 MCP サーバーはすべてのツールスキーマをすべてのリクエストに追加するため、多くのツールを持つ少数のサーバーは、エージェントが何か作業を行う前に大量のコンテキストを消費できます。完全な構成については、[ツール検索を構成](/docs/ja/agent-sdk/tool-search#configure-tool-search)を参照してください。336* **MCP サーバーコストを監視します。** [MCP ツール検索](/docs/ja/agent-sdk/mcp#mcp-tool-search)はデフォルトで MCP ツールスキーマを遅延させ、オンデマンドでロードします。ツール検索がオフの場合またはサポートされていないモデルと特定のプラットフォームでアップフロントロードにフォールバックした場合、各 MCP サーバーはすべてのツールスキーマをすべてのリクエストに追加するため、多くのツールを持つ少数のサーバーは、エージェントが何か作業を行う前に大量のコンテキストを消費できます。完全な構成については、[ツール検索を構成](/docs/ja/agent-sdk/tool-search#configure-tool-search)を参照してください。

337* **ルーチンタスクに低い努力を使用します。** ファイルを読み取るか、ディレクトリをリストするだけで済むエージェント用に[努力](#effort-level)を `"low"` に設定します。これはトークン使用量とコストを削減します。337* **ルーチンタスクに低い努力を使用します。** ファイルを読み取るか、ディレクトリをリストするだけで済むエージェント用に[努力](#effort-level)を `"low"` に設定します。これはトークン使用量とコストを削減します。

Details

123 123 

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

125 125 

126設定しない場合、Claude Code は [セッションが開始するモード](/docs/ja/permission-modes#which-mode-a-session-starts-in) のルールに従って開始権限モードを選択します。126Claude Code v2.1.302 以降では、権限モードを設定せず、設定ファイルの [`permissions.defaultMode`](/docs/ja/settings-reference#permissions-defaultmode) からもモードが取得されない場合、アプリは `default` モードで開始します。`default` モードでは、許可ルール、フック、`canUseTool` コールバック、または権限プロンプトツールを通じて承認しない限り、Claude Code は承認が必要なツール呼び出しをすべて拒否します。ツール呼び出しが拒否される場合は、[`claude -p` および Agent SDK の実行でツール呼び出しが拒否される](/docs/ja/permission-modes#which-mode-a-non-interactive-run-starts-in) を参照してください。

127 

128* セッションの [設定ファイル](/docs/ja/settings#where-settings-live) から `permissions.defaultMode` が適用される場合

129* それ以外の場合は、[自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) である可能性がある組み込みデフォルト

130 

131自動モードで開始するセッションは、[自動モードがアクションを評価する方法](/docs/ja/permission-modes#how-auto-mode-evaluates-actions) で説明されているように、`Bash` エントリなどの広い許可ルールを削除します。アプリケーションが `default` モードまたはそのようなルールに依存している場合は、`default` を明示的に渡してください。

132 

133TypeScript Agent SDK v0.3.286 より前では、`permissionMode` を省略することは `default` を渡すことと同じでした。

134 127 

135<h3 id="available-modes">128<h3 id="available-modes">

136 利用可能なモード129 利用可能なモード

Details

1035)1035)

1036```1036```

1037 1037 

1038* `API_TIMEOUT_MS`:Anthropicクライアントのリクエスト単位のタイムアウト(ミリ秒)。デフォルト`600000`。メインループとすべてのサブエージェントに適用されます。1038* [`API_TIMEOUT_MS`](/docs/ja/env-vars):各リクエスト試行がレスポンスヘッダーを待機できる時間(ミリ秒)。ヘッダーが到着した後にストリーミングレスポンスが続く時間は制限しません。デフォルト`600000`。メインループとすべてのサブエージェントに適用されます。

1039* `CLAUDE_CODE_MAX_RETRIES`:最大APIリトライ。デフォルト`10`、上限`15`。各リトライは独自の`API_TIMEOUT_MS`ウィンドウを取得します。1039* `CLAUDE_CODE_MAX_RETRIES`:最大APIリトライ。デフォルト`10`、上限`15`。各リトライは独自の`API_TIMEOUT_MS`ウィンドウを取得します。

1040 1040 

1041 無人実行で長い停止を待つ必要がある場合は、[`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/ja/errors#tune-retry-behavior)を設定します:一時的な容量エラーを無限に再試行し、Claude Code v2.1.199以降では、他の一時的なエラーのデフォルトを`300`に引き上げ、この変数の上限を削除します。1041 無人実行で長い停止を待つ必要がある場合は、[`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/ja/errors#tune-retry-behavior)を設定します:一時的な容量エラーを無限に再試行し、Claude Code v2.1.199以降では、他の一時的なエラーのデフォルトを`300`に引き上げ、この変数の上限を削除します。

Details

172 172 

173Python SDK では、`disallowedTools` や `mcpServers` などの複数単語のフィールド名は、Python の snake\_case 規約に従うのではなく、ワイヤ形式に一致させるために camelCase スペルを保持します。詳細については、[`AgentDefinition` リファレンス](/docs/ja/agent-sdk/python#agentdefinition)を参照してください。173Python SDK では、`disallowedTools` や `mcpServers` などの複数単語のフィールド名は、Python の snake\_case 規約に従うのではなく、ワイヤ形式に一致させるために camelCase スペルを保持します。詳細については、[`AgentDefinition` リファレンス](/docs/ja/agent-sdk/python#agentdefinition)を参照してください。

174 174 

175サブエージェントはデフォルトでバックグラウンドで実行されます。[`run_in_background`](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) 入力を省略する Agent ツール呼び出しはバックグラウンドサブエージェントを起動し、Claude が続行する前に結果が必要な場合は `run_in_background: false` を設定します。`background` フィールドを `true` に設定して、Claude が要求する内容に関係なく、特定のエージェントに対してバックグラウンド実行を強制します。Claude Code v2.1.198 より前は、バックグラウンドデフォルトは段階的にロールアウトされており、`run_in_background` を省略する Agent ツール呼び出しはサブエージェントを同期的に実行できました。175<h4 id="choose-whether-claude-waits-for-subagents">

176 Claude がサブエージェントを待つかどうかを選択する

177</h4>

176 178 

177サブエージェントは独自のサブエージェントを生成することもできます。そのネストがどの程度深くなるか、一度に何個のサブエージェントが実行されるか、クエリがいくら費やすかを制限するには、[サブエージェントの深さ、同時実行性、および支出を制限する](#cap-subagent-depth-concurrency-and-spend)を参照してください。179デフォルトでは、メインエージェントが生成したサブエージェントは[バックグラウンドで実行されます](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)。Agent ツールの結果は `status: "async_launched"` となり、レポートは後のターンで届きます。

180 

181Claude は、次のアクションにレポートが必要な場合に待機します。その場合、呼び出しはブロックされ、`status: "completed"` を返します。この選択を自分で行うには、次のようにします。

182 

183* **プロンプトで**: 「test-runner エージェントを実行して完了を待って」のように、Claude に待機するよう依頼します

184* **定義で**: `background` を `true` に設定して、そのエージェントをバックグラウンドで実行させたままにします

178 185 

179<h3 id="filesystem-based-definition-alternative">186<h3 id="filesystem-based-definition-alternative">

180 ファイルシステムベースの定義(代替案)187 ファイルシステムベースの定義(代替案)


242 249 

243これにより自動マッチングをバイパスし、指定されたサブエージェントを直接呼び出します。250これにより自動マッチングをバイパスし、指定されたサブエージェントを直接呼び出します。

244 251 

252<h3 id="forked-subagents">

253 フォークされたサブエージェント

254</h3>

255 

256[フォーク](/docs/ja/sub-agents#fork-the-current-conversation)は、新しく開始する代わりにそれまでの会話をコピーするサブエージェントです。Claude Code v2.1.302 以降では、何も設定しなくても、Claude は `subagent_type: "fork"` を指定して Agent ツールを呼び出すことで、アプリケーション内でフォークを開始できます。

257 

258Claude がフォークを開始しないようにするには、[`Agent(fork)` 拒否ルール](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を追加します。

259 

260<CodeGroup>

261 ```python Python theme={null}

262 options = ClaudeAgentOptions(

263 # fork サブエージェントタイプのみを拒否し、他のサブエージェントは引き続き実行される

264 disallowed_tools=["Agent(fork)"],

265 )

266 ```

267 

268 ```typescript TypeScript theme={null}

269 const options = {

270 // fork サブエージェントタイプのみを拒否し、他のサブエージェントは引き続き実行される

271 disallowedTools: ["Agent(fork)"]

272 };

273 ```

274</CodeGroup>

275 

245<h3 id="dynamic-agent-configuration">276<h3 id="dynamic-agent-configuration">

246 動的エージェント設定277 動的エージェント設定

247</h3>278</h3>

Details

610| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | エージェントの結果の出力形式を定義します。詳細は[構造化出力](/docs/ja/agent-sdk/structured-outputs)を参照してください |610| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | エージェントの結果の出力形式を定義します。詳細は[構造化出力](/docs/ja/agent-sdk/structured-outputs)を参照してください |

611| `outputStyle` | `string` | `undefined` | `Options` のフィールドではありません。代わりにインラインの [`settings`](/docs/ja/settings) オブジェクトまたは設定ファイルで `outputStyle` を設定してください。[出力スタイルを有効にする](/docs/ja/agent-sdk/modifying-system-prompts#activate-an-output-style)を参照してください |611| `outputStyle` | `string` | `undefined` | `Options` のフィールドではありません。代わりにインラインの [`settings`](/docs/ja/settings) オブジェクトまたは設定ファイルで `outputStyle` を設定してください。[出力スタイルを有効にする](/docs/ja/agent-sdk/modifying-system-prompts#activate-an-output-style)を参照してください |

612| `pathToClaudeCodeExecutable` | `string` | バンドルされたネイティブバイナリから自動解決 | Claude Code 実行ファイルへのパス。インストール時にオプションの依存関係がスキップされた場合、またはプラットフォームがサポート対象に含まれていない場合にのみ必要です |612| `pathToClaudeCodeExecutable` | `string` | バンドルされたネイティブバイナリから自動解決 | Claude Code 実行ファイルへのパス。インストール時にオプションの依存関係がスキップされた場合、またはプラットフォームがサポート対象に含まれていない場合にのみ必要です |

613| `permissionMode` | [`PermissionMode`](#permissionmode) | `undefined` | セッションの権限モード。省略した場合、セッションは auto モードで開始される可能性があります。Claude Code が開始時の権限モードをどのように選択するかについては[権限モード](/docs/ja/agent-sdk/permissions#permission-modes)を参照してください |613| `permissionMode` | [`PermissionMode`](#permissionmode) | `undefined` | セッションの権限モード。省略し、[`permissions.defaultMode`](/docs/ja/settings-reference#permissions-defaultmode) 設定など他に権限モードを設定するものがない場合、セッションは `default` で開始します。[権限モード](/docs/ja/agent-sdk/permissions#permission-modes)を参照してください |

614| `permissionPromptToolName` | `string` | `undefined` | 権限プロンプト用の MCP ツール名 |614| `permissionPromptToolName` | `string` | `undefined` | 権限プロンプト用の MCP ツール名 |

615| `permissionPrompts` | `'host' \| 'none'` | `'host'` | 権限プロンプトに応答する主体。`'host'` はプロンプトを [`canUseTool`](#canusetool) コールバックまたは `permissionPromptToolName` ツールにルーティングし、`'none'` は[プロンプトを表示するはずだった呼び出しを拒否します](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)。Claude Code v2.1.259 以降が必要です |615| `permissionPrompts` | `'host' \| 'none'` | `'host'` | 権限プロンプトに応答する主体。`'host'` はプロンプトを [`canUseTool`](#canusetool) コールバックまたは `permissionPromptToolName` ツールにルーティングし、`'none'` は[プロンプトを表示するはずだった呼び出しを拒否します](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)。Claude Code v2.1.259 以降が必要です |

616| `persistSession` | `boolean` | `true` | `false` の場合、ディスクへのセッションの永続化を無効にします。セッションを後で再開することはできません |616| `persistSession` | `boolean` | `true` | `false` の場合、ディスクへのセッションの永続化を無効にします。セッションを後で再開することはできません |


662});662});

663```663```

664 664 

665* `API_TIMEOUT_MS`: Anthropic クライアントのリクエストごとのタイムアウト(ミリ秒)。デフォルトは `600000` です。メインループとすべてのサブエージェントに適用されます。665* [`API_TIMEOUT_MS`](/docs/ja/env-vars): 各リクエストの試行がレスポンスヘッダーを待機できる時間(ミリ秒)。ヘッダーの到着後にストリーミングレスポンスが続く時間は制限しません。デフォルトは `600000` です。メインループとすべてのサブエージェントに適用されます。

666* `CLAUDE_CODE_MAX_RETRIES`: API の最大再試行回数。デフォルトは `10` で、上限は `15` です。再試行ごとに独自の `API_TIMEOUT_MS` の時間枠が与えられます。666* `CLAUDE_CODE_MAX_RETRIES`: API の最大再試行回数。デフォルトは `10` で、上限は `15` です。再試行ごとに独自の `API_TIMEOUT_MS` の時間枠が与えられます。

667 667 

668 より長い障害の間も待機し続ける必要がある無人実行では、[`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/ja/errors#tune-retry-behavior) を設定します。これにより一時的な容量エラーは無期限に再試行され、Claude Code v2.1.199 以降では、その他の一時的なエラーのデフォルトが `300` に引き上げられ、この変数の上限も撤廃されます。668 より長い障害の間も待機し続ける必要がある無人実行では、[`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/ja/errors#tune-retry-behavior) を設定します。これにより一時的な容量エラーは無期限に再試行され、Claude Code v2.1.199 以降では、その他の一時的なエラーのデフォルトが `300` に引き上げられ、この変数の上限も撤廃されます。

agent-teams.md +1 −1

Details

557* **シャットダウンが遅い可能性がある**: teammates は現在のリクエストまたはツール呼び出しを完了してからシャットダウンするため、時間がかかる可能性があります。557* **シャットダウンが遅い可能性がある**: teammates は現在のリクエストまたはツール呼び出しを完了してからシャットダウンするため、時間がかかる可能性があります。

558* **セッションごとに 1 つのチーム**: セッションは正確に 1 つのチームを持ち、そのセッションにスコープされています。追加の名前付きチームを作成したり、セッション間でチームを共有したりすることはできません。558* **セッションごとに 1 つのチーム**: セッションは正確に 1 つのチームを持ち、そのセッションにスコープされています。追加の名前付きチームを作成したり、セッション間でチームを共有したりすることはできません。

559* **ネストされたチーム非対応**: teammates は独自の teammates をスポーンできません。lead のみがチームを管理できます。559* **ネストされたチーム非対応**: teammates は独自の teammates をスポーンできません。lead のみがチームを管理できます。

560* **インプロセス teammates からのバックグラウンド subagents 非対応**: インプロセス teammate 自身の subagents はフォアグラウンドで実行されます。これは teammate のバックグラウンド作業が lead のプロセスより長く存続できないためです。Claude Code は、teammate が `background: true` を設定する定義を持つ subagent をスポーンする場合、エラーを返します。teammate の `run_in_background: true` リクエストも失敗し、[Claude Code がフォアグラウンドまたはバックグラウンドを選択する方法](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)で説明されているようにエラーが発生するか、フォアグラウンドで静かに実行されます。メイン会話から起動された Subagents は[バックグラウンドデフォルト](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)に従います。560* **インプロセスのチームメイトからのバックグラウンドサブエージェント非対応**: インプロセスのチームメイト自身のサブエージェントはフォアグラウンドで実行されます。これはチームメイトのバックグラウンド作業がチームリーダーのプロセスより長く存続できないためです。Claude Code は、チームメイトが `background: true` を設定する定義を持つサブエージェントをスポーンする場合、エラーを返します。チームメイトの `run_in_background: true` リクエストも失敗し、エラーが発生するか、フォアグラウンドで静かに実行されます。メイン会話から起動されたサブエージェントは[バックグラウンドのデフォルト](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)に従います。

561* **Lead は固定**: メインセッションはその存続期間中、lead です。teammate を lead に昇格させたり、リーダーシップを譲渡したりすることはできません。561* **Lead は固定**: メインセッションはその存続期間中、lead です。teammate を lead に昇格させたり、リーダーシップを譲渡したりすることはできません。

562* **権限はスポーン時に設定**: teammates は[権限](#permissions)の下で説明されている権限モードで開始します。スポーン後に個別の teammate の権限モードを変更できますが、スポーン時に teammate ごとの権限モードを設定することはできません。562* **権限はスポーン時に設定**: teammates は[権限](#permissions)の下で説明されている権限モードで開始します。スポーン後に個別の teammate の権限モードを変更できますが、スポーン時に teammate ごとの権限モードを設定することはできません。

563* **分割ペインは tmux または iTerm2 が必要**: デフォルトのインプロセスモードはすべてのターミナルで機能します。分割ペインモードは VS Code の統合ターミナル、Windows Terminal、または Ghostty ではサポートされていません。563* **分割ペインは tmux または iTerm2 が必要**: デフォルトのインプロセスモードはすべてのターミナルで機能します。分割ペインモードは VS Code の統合ターミナル、Windows Terminal、または Ghostty ではサポートされていません。

agent-view.md +10 −2

Details

479 479 

480フォーク後、2 つの会話は独立しています。コピーが行ったことが自動的に元の会話に入ることはありません。ただし、[クロスセッションメッセージング](/docs/ja/cross-session-messaging) が有効なセッションでは、どちらのセッションの Claude も明示的にもう一方にメッセージを送信できます。480フォーク後、2 つの会話は独立しています。コピーが行ったことが自動的に元の会話に入ることはありません。ただし、[クロスセッションメッセージング](/docs/ja/cross-session-messaging) が有効なセッションでは、どちらのセッションの Claude も明示的にもう一方にメッセージを送信できます。

481 481 

482セッションのコピーには Claude Code v2.1.212 以降が必要です。v2.1.161 から v2.1.211 では、`/fork` は代わりに [フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation) を開始します。これは現在の `/subtask` です。[エージェントビューがオフになっている](#turn-off-agent-view) 場合、`/fork` はフォークされたサブエージェントの動作を維持し、`/subtask` は利用できません。482[エージェントビューがオフになっている](#turn-off-agent-view) 場合、`/fork` はセッションをコピーする代わりに [フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation) を開始します。

483 483 

484`/fork open a draft pull request with the work so far` のようにプロンプトを渡すと、コピーはすぐにその作業を開始します。プロンプトがない場合、コピーは最初の指示を待ちます。`claude agents` でその行を選択して `Space` を押して指示を送信するか、`claude attach <id>` を実行します。待機中、選択された行には `space to send it a prompt` が表示されます。484`/fork open a draft pull request with the work so far` のようにプロンプトを渡すと、コピーはすぐにその作業を開始します。プロンプトがない場合、コピーは最初の指示を待ちます。`claude agents` でその行を選択して `Space` を押して指示を送信するか、`claude attach <id>` を実行します。待機中、選択された行には `space to send it a prompt` が表示されます。

485 485 


955* **実行中のサブエージェントを持つワークフロー**:[動的ワークフロー](/docs/ja/workflows)にはまだ実行中のサブエージェントがあります。ワークフロー自体は転送されますが、実行中のサブエージェントは最初から再開され、ダイアログはその数を表示します。955* **実行中のサブエージェントを持つワークフロー**:[動的ワークフロー](/docs/ja/workflows)にはまだ実行中のサブエージェントがあります。ワークフロー自体は転送されますが、実行中のサブエージェントは最初から再開され、ダイアログはその数を表示します。

956* **自動アーティファクト返信**:Claude が[アーティファクトのコメントに自動で返信している](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own)場合があります。これらの返信はバックグラウンドセッションで続行され、ダイアログはそのことを表示します。956* **自動アーティファクト返信**:Claude が[アーティファクトのコメントに自動で返信している](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own)場合があります。これらの返信はバックグラウンドセッションで続行され、ダイアログはそのことを表示します。

957 957 

958`/tasks` を実行してすべての実行中のものを確認し、確認してバックグラウンド化するか、`Stay` を選択して作業が完了するまで待機します。[バックグラウンド化するときに転送されるもの](#what-carries-over-when-you-background)を参照して、どのタスク種が転送され、どのタスク種が Claude Code によって停止されるかを確認してください。958`/tasks` を実行してすべての実行中のものを確認し、確認してバックグラウンド化するか、`Stay` を選択して作業が完了するまで待機します。[バックグラウンドに移動するときに引き継がれるもの](#what-carries-over-when-you-background)を参照して、どのタスク種が引き継がれ、どのタスク種が Claude Code によって停止されるかを確認してください。

959 

960<h3 id="carried-into-this-session-and-not-resumed">

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

962</h3>

963 

964この通知は、このセッションで実行されていないバックグラウンドの[サブエージェント](/docs/ja/sub-agents)を示しています。

965 

966Claude はこの通知を確認して自動的に返信するため、プロンプトを入力する必要はありません。Claude の返信を読んだ後もそのサブエージェントの作業が必要な場合は、Claude に依頼してください。

959 967 

960<h3 id="prompt-rejected-as-too-short">968<h3 id="prompt-rejected-as-too-short">

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

Details

182export AWS_PROFILE=your-profile-name182export AWS_PROFILE=your-profile-name

183```183```

184 184 

185Claude Code は、プロファイルの `sso_region` で指定された IAM Identity Center リージョンからロール認証情報をリクエストします。これは Amazon Bedrock を実行するリージョンと一致する必要はありません。v2.1.207 では、Amazon Bedrock リージョンが `sso_region` をオーバーライドしていたため、IAM Identity Center インスタンスが別のリージョンにあるプロファイルは `Session token not found or invalid` エラーで認証に失敗しました。185Claude Code は、プロファイルの `sso_region` で指定された IAM Identity Center リージョンからロール認証情報をリクエストします。これは Amazon Bedrock を実行するリージョンと一致する必要はありません。

186 186 

187<h4 id="use-aws-management-console-credentials">187<h4 id="use-aws-management-console-credentials">

188 AWS Management Console 認証情報を使用する188 AWS Management Console 認証情報を使用する


444 444 

445セッションが実行されているモデルへのアカウントアクセスが失われた場合(例えば、管理者が Amazon Bedrock アカウントでそれを無効化した場合)、Claude Code は各リクエストが失敗する代わりにセッションを別のモデルに切り替え、`Switched to <fallback> because <model> is not available` を表示します。スタートアップフォールバックと同じモデルを試します。同じティアの以前のバージョンを最初に試し、Opus セッションで Opus バージョンが利用できない場合、デフォルト Sonnet モデルを試します。445セッションが実行されているモデルへのアカウントアクセスが失われた場合(例えば、管理者が Amazon Bedrock アカウントでそれを無効化した場合)、Claude Code は各リクエストが失敗する代わりにセッションを別のモデルに切り替え、`Switched to <fallback> because <model> is not available` を表示します。スタートアップフォールバックと同じモデルを試します。同じティアの以前のバージョンを最初に試し、Opus セッションで Opus バージョンが利用できない場合、デフォルト Sonnet モデルを試します。

446 446 

447切り替えは、ピン留めしていないティアにのみ適用されます。これはスタートアップフォールバックと同じ条件です。選択した特定のバージョン、または[アプリケーション推論プロファイル ARN](#map-each-model-version-to-an-inference-profile)でセッションを実行している場合、そのモデルを保持し、フォールバックモデルチェーンがないため、リクエストは失敗します。[自動モード](/docs/ja/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry)では、Claude Code は Amazon Bedrock で自動モードがサポートするモデルにのみ切り替えます。それらのモデルも利用できない場合、リクエストは[AWS 認証失敗](/docs/ja/errors#aws-authentication-failed)で失敗し、モデルを有効にするためのヒントが表示されます。447切り替えは、ピン留めしていないティアにのみ適用されます。これはスタートアップフォールバックと同じ条件です。選択した特定のバージョン、または[アプリケーション推論プロファイル ARN](#map-each-model-version-to-an-inference-profile)でセッションを実行している場合、そのモデルを保持し、フォールバックモデルチェーンがないため、リクエストは失敗します。[auto モード](/docs/ja/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry)では、Claude Code は Amazon Bedrock で auto モードがサポートするモデルにのみ切り替えます。それらのモデルも利用できない場合、リクエストは[AWS 認証失敗](/docs/ja/errors#aws-authentication-failed)で失敗し、モデルを有効にするためのヒントが表示されます。

448 448 

449設定した[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)はティア切り替えを置き換えます。これらの拒否では Claude Code は設定したフォールバックに切り替えます。拒否されたリクエストが切り替わるのではなく失敗するようにするには、[`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](/docs/ja/env-vars)を設定してください。設定したフォールバックチェーンはこれらの拒否で切り替わります。すべての拒否されたリクエストが失敗するようにしたい場合は、チェーンも削除してください。449設定した[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)はティア切り替えを置き換えます。これらの拒否では Claude Code は設定したフォールバックに切り替えます。拒否されたリクエストが切り替わるのではなく失敗するようにするには、[`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](/docs/ja/env-vars)を設定してください。設定したフォールバックチェーンはこれらの拒否で切り替わります。すべての拒否されたリクエストが失敗するようにしたい場合は、チェーンも削除してください。

450 450 

artifacts.md +1 −1

Details

105 アーティファクトを再度見つける105 アーティファクトを再度見つける

106</h2>106</h2>

107 107 

108Claude Code で `/artifacts` を実行すると、所有しているアーティファクトと共有されているアーティファクトが一覧表示されます。現在のセッションのアーティファクトは **This session** の下に最初に表示されます。Claude Code v2.1.208 以降が必要です。108Claude Code で `/artifacts` を実行すると、所有しているアーティファクトと共有されているアーティファクトが一覧表示されます。現在のセッションのアーティファクトは **This session** の下に最初に表示されます。

109 109 

110アーティファクトを選択し、次のいずれかのキーを押します。110アーティファクトを選択し、次のいずれかのキーを押します。

111 111 

Details

321claude auto-mode defaults321claude auto-mode defaults

322```322```

323 323 

324`jq` にパイプしなくても 1 つのルールの完全な文言を読むには、`--label` にルールのラベルの開始部分を渡します。例えば `claude auto-mode defaults --label 'Git Destructive'` のようにします。マッチングは各ルールのラベルに対する大文字小文字を区別しないプレフィックスであり、マッチしないセクションは空のリストとして出力されます。Claude Code v2.1.208 以降が必要です。324`jq` にパイプしなくても 1 つのルールの完全な文言を読むには、`--label` にルールのラベルの開始部分を渡します。例えば `claude auto-mode defaults --label 'Git Destructive'` のようにします。マッチングは各ルールのラベルに対する大文字小文字を区別しないプレフィックスであり、マッチしないセクションは空のリストとして出力されます。

325 325 

326分類器が実際に使用する設定を JSON として出力します。設定が指定されている場合はその設定を、そうでない場合はデフォルトを適用します:326分類器が実際に使用する設定を JSON として出力します。設定が指定されている場合はその設定を、そうでない場合はデフォルトを適用します:

327 327 


359 359 

360カスタムルールを作成した場合、`claude auto-mode critique` はそれらをレビューし、曖昧、冗長、または偽陽性を引き起こす可能性のあるエントリにフラグを立てます。360カスタムルールを作成した場合、`claude auto-mode critique` はそれらをレビューし、曖昧、冗長、または偽陽性を引き起こす可能性のあるエントリにフラグを立てます。

361 361 

362カスタマイズを破棄して組み込みデフォルトに戻すには、reset サブコマンドを実行します。Claude Code v2.1.212 以降が必要であり、ユーザー設定ファイルから `autoMode` セクションを削除します:362カスタマイズを破棄して組み込みデフォルトに戻すには、reset サブコマンドを実行します。このサブコマンドはユーザー設定ファイルから `autoMode` セクションを削除します:

363 363 

364```bash theme={null}364```bash theme={null}

365claude auto-mode reset365claude auto-mode reset

chrome.md +3 −3

Details

113 113 

114この設定がオンで Claude Code v2.1.287 以降を使用している場合、各 VS Code セッションは開始時にブラウザに接続するため、`@browser` と入力する前から Claude がブラウザを使用できます。それより前のバージョン、または設定がオフの場合、VS Code セッションは `@browser` と入力したときに接続します。114この設定がオンで Claude Code v2.1.287 以降を使用している場合、各 VS Code セッションは開始時にブラウザに接続するため、`@browser` と入力する前から Claude がブラウザを使用できます。それより前のバージョン、または設定がオフの場合、VS Code セッションは `@browser` と入力したときに接続します。

115 115 

116Chrome が実行されていない場合でも、Claude Code は通常どおり起動します。v2.1.211 より前では、Chrome 統合が有効で Chrome が実行されていない場合に、起動が停止することがありました。116Chrome が実行されていない場合でも、Claude Code は通常どおり起動します。

117 117 

118<Note>118<Note>

119 Chrome をデフォルトで有効にすると、ブラウザツールとその指示が常にロードされるため、コンテキスト使用量が増加します。コンテキスト消費の増加に気付いた場合は、この設定をオフにして、必要なときにのみ接続してください。CLI では `--chrome` を使用し、VS Code ではプロンプトボックスに [`@browser`](/docs/ja/vs-code#automate-browser-tasks-with-chrome) と入力します。119 Chrome をデフォルトで有効にすると、ブラウザツールとその指示が常にロードされるため、コンテキスト使用量が増加します。コンテキスト消費の増加に気付いた場合は、この設定をオフにして、必要なときにのみ接続してください。CLI では `--chrome` を使用し、VS Code ではプロンプトボックスに [`@browser`](/docs/ja/vs-code#automate-browser-tasks-with-chrome) と入力します。


192 Web ページにファイルをアップロードする192 Web ページにファイルをアップロードする

193</h3>193</h3>

194 194 

195Claude は、マシン上のファイルをページ上のアップロードフィールドに添付できます。Claude Code がファイルを読み取ってその内容をブラウザに送信するため、アップロードはローカルセッションとリモートセッションの両方で機能します。Claude Code v2.1.211 以降が必要です。195Claude は、マシン上のファイルをページ上のアップロードフィールドに添付できます。Claude Code がファイルを読み取ってその内容をブラウザに送信するため、アップロードはローカルセッションとリモートセッションの両方で機能します。

196 196 

197この例では、ログファイルをフォームに添付します。197この例では、ログファイルをフォームに添付します。

198 198 


271Take a screenshot of the checkout page and save it to disk271Take a screenshot of the checkout page and save it to disk

272```272```

273 273 

274Claude は画像をディスクに保存し、ファイルパスを報告します。v2.1.211 より前では、スクリーンショットツールの `save_to_disk` オプションはファイルを書き込みませんでした。274Claude は画像をディスクに保存し、ファイルパスを報告します。

275 275 

276<h2 id="troubleshooting">276<h2 id="troubleshooting">

277 トラブルシューティング277 トラブルシューティング

Details

502 CI パイプラインとリモートマシン502 CI パイプラインとリモートマシン

503</h3>503</h3>

504 504 

505無人パイプラインのサービストークンフローはありません。ゲートウェイサインインは常にブラウザデバイスフローを実行するため、サインインを承認する開発者がない CI ジョブは認証できません。これらをプロバイダーに対して直接設定します。505無人パイプラインのサービストークンフローはありません。ゲートウェイサインインは常にブラウザデバイスフローを実行するため、サインインを承認する開発者がない CI ジョブは認証できません。これらをプロバイダーに対して直接設定します。`forceLoginMethod` と `forceLoginGatewayUrl` は開発者マシンにデプロイし、CI ランナーには設定しないでください。管理設定でこれらが設定されているマシンでは、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` で認証するセッションは[起動時に終了します](/docs/ja/errors#administrator-policy-requires-a-cloud-gateway-sign-in)。

506 506 

507開発者がサインインすると、そのマシンでの各 Claude Code セッションはゲートウェイセッションを使用します。非対話的な `claude -p` 実行と Agent SDK によって開始されたセッションを含みます。Claude Code は[ゲートウェイポリシー](/docs/ja/claude-apps-gateway-config#managed)をそれぞれに適用します。507開発者がサインインすると、そのマシンでの各 Claude Code セッションはゲートウェイセッションを使用します。非対話的な `claude -p` 実行と Agent SDK によって開始されたセッションを含みます。Claude Code は[ゲートウェイポリシー](/docs/ja/claude-apps-gateway-config#managed)をそれぞれに適用します。

508 508 

Details

56 `listen`56 `listen`

57</h3>57</h3>

58 58 

59`listen` ブロックは、ゲートウェイがサービスを提供する場所を制御します。バインドアドレスとポート、外部から見えるオリジン、およびオプションの TLS 終了を指定します。59`listen` ブロックは、ゲートウェイがどこでサービスを提供するかを制御します。バインドアドレスとポート、外部から見えるオリジン、およびオプションの TLS 終端を設定します。

60 60 

61| フィールド | 必須 | 説明 |61| フィールド | 必須 | 説明 |

62| - | - | - |62| - | - | - |

63| `host` | いいえ | バインドアドレス。デフォルト `0.0.0.0`。 |63| `host` | いいえ | バインドアドレス。デフォルトは `0.0.0.0`。 |

64| `port` | いいえ | バインドポート。デフォルト `8080`。 |64| `port` | いいえ | バインドポート。デフォルトは `8080`。 |

65| `public_url` | `host` がループバックでない場合は必須 | 外部から見える `https://` オリジン。IdP の `redirect_uri` と検出メタデータを構築するために使用されます。`host` がループバックアドレスでない場合は常に必須です。TLS が ALB、Ingress、Cloud Run などのプロキシで終了するか、`tls` を通じてゲートウェイ自体で終了するかに関わらず必須です。ゲートウェイは `X-Forwarded-*` ヘッダーから独自のオリジンを導出することはありません。これらはクライアントがなりすまし可能です。これなしではブート失敗します。以下の `trusted_proxies` はクライアント IP 解決のみを制御します。また、[テレメトリ](#telemetry)を有効にするためにも必須です。ゲートウェイはこの URL からクライアントにプッシュする OTLP エンドポイントを構築するためです。 |65| `public_url` | `host` がループバックでない場合 | 外部から見える `https://` オリジンで、IdP の `redirect_uri` とディスカバリメタデータの構築に使用されます。`host` がループバックアドレスでない場合は常に必須です。これは、TLS が ALB、Ingress、Cloud Run などのプロキシで終端される場合も、`tls` を通じてゲートウェイ自体で終端される場合も同様です。ゲートウェイは自身のオリジンを `X-Forwarded-*` ヘッダーから導出することがないためです。これらのヘッダーはクライアントが偽装できます。これがないと起動に失敗します。下記の `trusted_proxies` はクライアント IP の解決のみを制御します。また、ゲートウェイはクライアントにプッシュする OTLP エンドポイントをこの URL から構築するため、[テレメトリ](#telemetry)を有効にする場合にも必須です。 |

66| `tls.cert` / `tls.key` | いいえ | ゲートウェイが TLS を自身で終了する場合の PEM パス |66| `tls.cert` / `tls.key` | いいえ | ゲートウェイ自体が TLS を終端する場合の PEM パス |

67| `trusted_proxies` | いいえ | ゲートウェイの前にあるロードバランサーの CIDR または IP。設定されている場合、ゲートウェイはこれらのピアからのみ `X-Forwarded-For` を信頼し、IP ごとのレート制限と監査のために実際のクライアント IP を記録します。nginx の `set_real_ip_from` と同等です。`X-Forwarded-For` エントリが `ipv4:port` または `[ipv6]:port` として書かれている場合(一部のロードバランサーがそうするように)、ポートを削除して読み込まれます。ポートが付加されたブラケットなしの IPv6 アドレスは、異なるアドレスとして読み込まれるか、まったく読み込まれない可能性があるため、そのフォームを書き込むプロキシのポートオプションをオフにしてください。 |67| `trusted_proxies` | いいえ | ゲートウェイの前段にあるロードバランサーの CIDR または IP。設定すると、ゲートウェイはこれらのピアからの `X-Forwarded-For` のみを信頼し、IP ごとのレート制限と監査のために実際のクライアント IP を記録します。nginx の `set_real_ip_from` に相当します。一部のロードバランサーが行うように `ipv4:port` または `[ipv6]:port` の形式で書かれた `X-Forwarded-For` エントリは、ポートを除いて読み取られます。角括弧なしでポートが付加された IPv6 アドレスは、別のアドレスとして読み取られるか、まったく読み取られない可能性があるため、その形式で書き込むプロキシではポートオプションをオフにしてください。 |

68 68 

69<h3 id="oidc">69<h3 id="oidc">

70 `oidc`70 `oidc`

71</h3>71</h3>

72 72 

73`oidc` ブロックはゲートウェイをアイデンティティプロバイダーに接続し、誰がサインインできるかを決定します。発行者と OAuth クライアントに名前を付け、メールとグループを含むクレームをマップし、メールドメインまたはグループによるサインインを制限します。73`oidc` ブロックは、ゲートウェイを ID プロバイダーに接続し、誰がサインインできるかを決定します。発行者と OAuth クライアントを指定し、メールアドレスとグループを伝えるクレームをマッピングし、メールドメインまたはグループによってサインインを制限します。

74 74 

75OpenID Connect(OIDC)はゲートウェイがアイデンティティプロバイダーで使用する SSO プロトコルです。IdP 側で登録する内容については、[アイデンティティプロバイダーのセットアップ](/docs/ja/claude-apps-gateway-deploy#identity-provider-setup)を参照してください。75OpenID Connect(OIDC)は、ゲートウェイが ID プロバイダーとの間で使用する SSO プロトコルです。IdP 側で登録する内容については、[ID プロバイダーのセットアップ](/docs/ja/claude-apps-gateway-deploy#identity-provider-setup)を参照してください。

76 76 

77| フィールド | 必須 | 説明 |77| フィールド | 必須 | 説明 |

78| - | - | - |78| - | - | - |

79| `issuer` | はい | OIDC 検出ベース。`/.well-known/openid-configuration` で検出を提供する必要があります。本番環境では HTTPS を使用してください。ゲートウェイは `http://` 発行者を受け入れます。`http://localhost:8081` などのループバック発行者は、[SSRF ガード](/docs/ja/claude-apps-gateway-deploy#threat-model-summary)によって拒否されます。ただし、ゲートウェイの環境で `CLAUDE_GATEWAY_ALLOW_LOOPBACK=1` が設定されている場合を除きます。 |79| `issuer` | はい | OIDC ディスカバリのベース。`/.well-known/openid-configuration` でディスカバリを提供する必要があります。本番環境では HTTPS を使用してください。ゲートウェイは `http://` の issuer も受け入れます。`http://localhost:8081` のようなループバックの issuer は、ゲートウェイの環境で `CLAUDE_GATEWAY_ALLOW_LOOPBACK=1` が設定されていない限り、[SSRF ガード](/docs/ja/claude-apps-gateway-deploy#threat-model-summary)によって拒否されます。 |

80| `client_id` | はい | OAuth クライアント登録から取得 |80| `client_id` | はい | OAuth クライアント登録から取得 |

81| `client_secret` | `token_endpoint_auth_method` が `private_key_jwt` でない場合は必須 | OAuth クライアント登録から取得。[証明書によるクライアント認証](#certificate-client-authentication)を使用する場合は省略します。 |81| `client_secret` | `token_endpoint_auth_method` が `private_key_jwt` でない場合 | OAuth クライアント登録から取得。[証明書によるクライアント認証](#certificate-client-authentication)を使用する場合は省略してください。 |

82| `allowed_email_domains` | いいえ | `email` クレームがこれらのドメインのいずれかに含まれていない id\_token を拒否します。大文字と小文字を区別しません。マルチテナント IdP の設定ミスに対する多層防御です。この設定とは無関係に、`email_verified` クレームが明示的に `false` である id\_token は常に拒否されます。 |82| `allowed_email_domains` | いいえ | `email` クレームがこれらのドメインのいずれにも含まれない id\_token を拒否します(大文字と小文字は区別しません)。マルチテナント IdP の設定ミスに対する多層防御です。この設定とは無関係に、`email_verified` クレームが明示的に `false` である id\_token は常に拒否されます。 |

83| `allowed_groups` | いいえ | サインインをこれらの IdP グループのメンバーに制限します。`groups_claim` に対してマッチングされます。許可されたメールドメイン内にいるが、これらのグループのいずれにも属していないユーザーは拒否されます。IdP がグループクレームを発行する必要があります。マッチングは、そのクレーム内の値に対する正確で大文字と小文字を区別する文字列比較です。ゲートウェイはネストされたグループを展開しません。サブグループのメンバーを許可するには、ここにサブグループをリストするか、IdP を設定してフラット化されたメンバーシップを発行してください。 |83| `allowed_groups` | いいえ | サインインをこれらの IdP グループのメンバーに制限します。`groups_claim` と照合されます。許可されたメールドメインに属していても、これらのグループのいずれにも属していないユーザーは拒否されます。IdP がグループクレームを発行する必要があります。照合はそのクレーム内の値に対する完全一致かつ大文字と小文字を区別する文字列比較であり、ゲートウェイはネストされたグループを展開しません。サブグループのメンバーを許可するには、ここにサブグループを列挙するか、フラット化されたメンバーシップを発行するように IdP を設定してください。 |

84| `groups_claim` | いいえ | グループメンバーシップを含む id\_token クレーム。デフォルト `groups`。Microsoft Entra はアプリロールを `roles` の下に発行します。フラットキーまたは `/resource_access/gateway/roles` などのネストされたクレーム用の RFC 6901 JSON ポインタを受け入れます。 |84| `groups_claim` | いいえ | グループメンバーシップを伝える id\_token クレーム。デフォルトは `groups`。Microsoft Entra はアプリロールを `roles` の下に発行します。フラットなキー、またはネストされたクレーム用の `/resource_access/gateway/roles` のような RFC 6901 JSON Pointer を受け付けます。 |

85| `google_groups` | いいえ | Google Workspace Admin SDK Directory API を通じてサインインしたユーザーのグループを検索します。Google の id\_token はグループクレームを含まないためです。`service_account_json_path` を `https://www.googleapis.com/auth/admin.directory.group.readonly` スコープでドメイン全体の委任を持つサービスアカウントキーファイルに設定し、`admin_email` をサービスアカウントが偽装する Workspace 管理者に設定します。Directory API は実際の管理者サブジェクトを必要とします。各ユーザーのグループメールアドレスがそのグループクレームになるため、`allowed_groups` と `managed.policies.match.groups` はグループメールでマッチングします。 |85| `google_groups` | いいえ | Google の id\_token にはグループクレームが含まれないため、Google Workspace Admin SDK Directory API を通じて、サインインしたユーザーのグループを検索します。`service_account_json_path` には、`https://www.googleapis.com/auth/admin.directory.group.readonly` スコープでドメイン全体の委任が設定されたサービスアカウントのキーファイルを、`admin_email` にはサービスアカウントが偽装する Workspace 管理者を設定します。Directory API では実際の管理者サブジェクトが必要です。各ユーザーのグループのメールアドレスがそのユーザーのグループクレームになるため、`allowed_groups` と `managed.policies.match.groups` はグループのメールアドレスで照合します。 |

86| `email_claim` | いいえ | ユーザーのメールを含む id\_token クレーム。デフォルト `email`。ADFS や Entra B2C などの一部の IdP は、代わりに `upn` または `preferred_username` を発行します。フラットキー、JSON ポインタ、または最初に存在するキーが使用されるフォールバックキーのリストを受け入れます。 |86| `email_claim` | いいえ | ユーザーのメールアドレスを伝える id\_token クレーム。デフォルトは `email`。ADFS や Entra B2C などの一部の IdP は、代わりに `upn` または `preferred_username` を発行します。フラットなキー、JSON Pointer、またはフォールバックキーのリスト(最初に存在するキーが使用されます)を受け付けます。 |

87| `scopes` | いいえ | ゲートウェイが要求する OIDC スコープの完全な上書き。デフォルト `[openid, profile, email, offline_access]`。IdP が認識しないスコープを拒否する場合、またはグループまたはメールを発行するためにカスタムスコープが必要な場合に設定します。`openid` を含める必要があります。`offline_access` を削除するとリフレッシュトークンが無効になるため、開発者は `session.ttl_hours` ごとにブラウザログインを再実行します。IdP ごとのスコープレシピ(Google のリフレッシュトークンフローなど)については、[アイデンティティプロバイダーのセットアップ](/docs/ja/claude-apps-gateway-deploy#identity-provider-setup)を参照してください。 |87| `scopes` | いいえ | ゲートウェイが要求する OIDC スコープを完全に上書きします。デフォルトは `[openid, profile, email, offline_access]`。IdP が認識しないスコープを拒否する場合や、グループやメールアドレスを発行するためにカスタムスコープが必要な場合に設定します。`openid` を含める必要があります。`offline_access` を外すとリフレッシュトークンが無効になるため、開発者は `session.ttl_hours` ごとにブラウザログインをやり直すことになります。Google のリフレッシュトークンフローなど、IdP ごとのスコープのレシピについては[ID プロバイダーのセットアップ](/docs/ja/claude-apps-gateway-deploy#identity-provider-setup)を参照してください。 |

88| `scope_on_refresh` | いいえ | ゲートウェイがリフレッシュトークンを交換するときに、サインインリクエストと同じリストで `scope` も送信します。デフォルト `false`:リフレッシュリクエストは `scope` を省略します。ほとんどの IdP はリフレッシュのたびに id\_token を返すため、この設定は不要です。IdP が再度 `openid` を要求された場合にのみリフレッシュ時に id\_token を返す場合(Okta はリフレッシュグラントについてこれを文書化しています)は `true` に設定します。id\_token がない場合、すべてのリフレッシュは、IdP の userinfo エンドポイントがリフレッシュされたアクセストークンを受け入れることに依存します。グループに基づいてサインインを制限したりポリシーをマッチングしたりしていて、IdP のリフレッシュ時の id\_token にグループが含まれない場合は、`userinfo_fallback: true` も設定して、ゲートウェイが userinfo エンドポイントからグループを補完するようにしてください。要求より少ないスコープを付与した IdP は、`invalid_scope` でリフレッシュを拒否することがあります。これがオンの間に `scopes` にエントリを追加した場合は、既存のセッションも対象になります。設定後に `token_endpoint` でリフレッシュが失敗し始めた場合は、このキーを削除してください。ゲートウェイサーバーで Claude Code v2.1.260 以降が必要です。 |88| `scope_on_refresh` | いいえ | ゲートウェイがリフレッシュトークンを交換する際にも、サインインリクエストと同じリストで `scope` を送信します。デフォルトは `false` で、リフレッシュリクエストは `scope` を省略します。ほとんどの IdP はリフレッシュのたびに id\_token を返すため、この設定は不要です。IdP が再度 `openid` を要求された場合にのみリフレッシュ時に id\_token を返す場合は `true` に設定します。Okta はリフレッシュグラントについてこの動作を文書化しています。id\_token がない場合、すべてのリフレッシュは、IdP の userinfo エンドポイントがリフレッシュされたアクセストークンを受け入れるかどうかに依存します。サインインの制限やポリシーの照合にグループを使用しており、IdP のリフレッシュ時の id\_token にグループが含まれない場合は、ゲートウェイが userinfo エンドポイントからグループを補完できるよう `userinfo_fallback: true` も設定してください。要求されたよりも少ないスコープしか付与していない IdP は、`invalid_scope` でリフレッシュを拒否する可能性があります。これには、この設定がオンの間に `scopes` にエントリを追加した場合の既存セッションも含まれます。設定後に `token_endpoint` でリフレッシュが失敗し始めた場合は、このキーを削除してください。ゲートウェイサーバーで Claude Code v2.1.260 以降が必要です。 |

89| `extra_auth_params` | いいえ | IdP 認可リクエストに逐語的に追加される追加クエリパラメータ。これは、Google リフレッシュトークンの `access_type: offline`、一部の Entra テナントの `domain_hint`、またはステップアップフローの `acr_values` など、IdP 固有の動作を上書きするための仕組みです。ゲートウェイが管理するプロトコルパラメータは上書きできません:`state`、`nonce`、`redirect_uri`、PKCE、`scope`、`response_type`、`response_mode`、および `client_id`。 |89| `extra_auth_params` | いいえ | IdP の認可リクエストにそのまま付加される追加のクエリパラメータ。これは IdP 固有の動作を上書きするための仕組みで、たとえば Google のリフレッシュトークン用の `access_type: offline`、一部の Entra テナント用の `domain_hint`、ステップアップフロー用の `acr_values` などがあります。ゲートウェイが管理するプロトコルパラメータ(`state`、`nonce`、`redirect_uri`、PKCE、`scope`、`response_type`、`response_mode`、`client_id`)は上書きできません。 |

90| `userinfo_fallback` | いいえ | id\_token がメールまたはグループを省略する場合、`/userinfo` からそれらを取得します。Keycloak 軽量アクセストークン、Okta org サーバー、および ADFS 最小トークンに必要です。id\_token が引き続き正とされ、userinfo は不足分のみを補完します。デフォルト `false`。 |90| `userinfo_fallback` | いいえ | id\_token にメールアドレスまたはグループが含まれない場合、`/userinfo` から取得します。Keycloak の軽量アクセストークン、Okta の組織サーバー、ADFS の最小トークンで必要です。id\_token が引き続き正となり、userinfo は欠けている部分を補うだけです。デフォルトは `false`。 |

91| `use_pkce` | いいえ | 認可リクエストで PKCE(S256)チャレンジを送信します。デフォルト `true`。IdP がこの機密クライアントの PKCE を拒否する場合のみ `false` に設定します。 |91| `use_pkce` | いいえ | 認可リクエストで PKCE(S256)チャレンジを送信します。デフォルトは `true`。IdP がこのコンフィデンシャルクライアントに対して PKCE を拒否する場合にのみ `false` に設定してください。 |

92| `clock_skew_seconds` | いいえ | id\_token 時間クレームを検証するときにクロックドリフトを許容します。デフォルト `0`(厳密)。サインイン直後にホスト/IdP クロックスキューのため「トークン期限切れ/まだ有効でない」エラーが表示される場合は、これを上げてください。 |92| `clock_skew_seconds` | いいえ | id\_token の時刻クレームを検証する際に時刻のずれを許容します。デフォルトは `0` で、厳格です。ホストと IdP 間の時刻のずれにより、サインイン直後に "token expired / not yet valid" エラーが表示される場合は値を上げてください。 |

93| `token_endpoint_auth_method` | いいえ | ゲートウェイが IdP のトークンエンドポイントに対して認証する方法:`client_secret_basic`、`client_secret_post`、または[証明書によるクライアント認証](#certificate-client-authentication)用の `private_key_jwt`。デフォルトでは、ゲートウェイは IdP が公開している内容から 2 つの `client_secret` 方式のいずれかを選択します。 |93| `token_endpoint_auth_method` | いいえ | ゲートウェイが IdP のトークンエンドポイントに対して認証する方法です。`client_secret_basic`、`client_secret_post`、または[証明書によるクライアント認証](#certificate-client-authentication)用の `private_key_jwt` のいずれかです。デフォルトでは、ゲートウェイは IdP が公開している内容から 2 つの `client_secret` 方式のいずれかを選択します。 |

94| `client_assertion` | `private_key_jwt` の場合は必須 | `private_key_pem` と `certificate_pem` を含むブロック:[証明書によるクライアント認証](#certificate-client-authentication)用の秘密鍵と証明書。v2.1.284 以降が必要です。 |94| `client_assertion` | `private_key_jwt` 使用時 | `private_key_pem` と `certificate_pem` を持つブロック。[証明書によるクライアント認証](#certificate-client-authentication)用の秘密鍵と証明書です。v2.1.284 以降が必要です。 |

95| `id_token_signed_response_alg` | いいえ | 予想される id\_token 署名アルゴリズム。デフォルト `RS256`。ES256、PS256、または EdDSA で署名する IdP に設定します。 |95| `id_token_signed_response_alg` | いいえ | 想定される id\_token の署名アルゴリズム。デフォルトは `RS256`。ES256、PS256、または EdDSA で署名する IdP の場合に設定します。 |

96| `additional_authorized_parties` | いいえ | `client_id` を超えて受け入れる追加の `azp` 値。Keycloak ブローカーとトークン交換フロー用 |96| `additional_authorized_parties` | いいえ | Keycloak のブローカーフローおよびトークン交換フロー用に、`client_id` 以外に受け入れる追加の `azp` 値 |

97| `discovery_url` | いいえ | `issuer` から導出する代わりに、この URL から検出ドキュメントを取得します。発行者ホストを書き換えるプロキシの背後にある IdP の場合。パスは `/.well-known/` を含む必要があります。 |97| `discovery_url` | いいえ | issuer のホストを書き換えるプロキシの背後にある IdP の場合に、`issuer` から導出する代わりにこの URL からディスカバリドキュメントを取得します。パスには `/.well-known/` を含める必要があります。 |

98| `use_proxy` | いいえ | ゲートウェイ独自の IdP リクエストを `HTTPS_PROXY` または `HTTP_PROXY` のフォワードプロキシを通じて送信し、`NO_PROXY` を尊重します。`false` はそれらのリクエストを直接に保ちます。v2.1.227 以降が必要です。以下の[フォワードプロキシを通じた IdP リクエスト](#idp-requests-through-a-forward-proxy)を参照してください。 |98| `use_proxy` | いいえ | ゲートウェイ自身の IdP リクエストを、`NO_PROXY` に従いつつ `HTTPS_PROXY` または `HTTP_PROXY` のフォワードプロキシ経由で送信します。`false` にするとそれらのリクエストは直接送信されます。v2.1.227 以降が必要です。下記の[フォワードプロキシ経由の IdP リクエスト](#idp-requests-through-a-forward-proxy)を参照してください。 |

99| `form_action_origins` | いいえ | `/device` ページの `Content-Security-Policy: form-action` ディレクティブの追加オリジン。ゲートウェイはすでに `'self'` と検出された `authorization_endpoint` オリジンを許可していますが、Chrome は全リダイレクトチェーンに対して `form-action` を強制します。IdP が Azure AD が ADFS にフェデレーションされている、ハブスポーク Okta、または企業 SSO インターセプターなど、2 番目のホストを通じてリダイレクトする場合、認可リクエストがリダイレクトする可能性があるすべてのオリジンをリストします。 |99| `form_action_origins` | いいえ | `/device` ページの `Content-Security-Policy: form-action` ディレクティブに追加するオリジン。ゲートウェイはすでに `'self'` と検出された `authorization_endpoint` のオリジンを許可していますが、Chrome はリダイレクトチェーン全体に対して `form-action` を適用します。Azure AD から ADFS へのフェデレーション、ハブアンドスポーク型の Okta、企業の SSO インターセプターなど、IdP が 2 つ目のホストを経由してリダイレクトする場合は、認可リクエストがリダイレクトで経由する可能性のあるすべてのオリジンを列挙してください。 |

100| `ca_cert_pem` | いいえ | ファイルへのパスではなく、PEM エンコードされた CA 証明書自体。IdP リクエストのみのシステムトラストストアを置き換えます。マウントされたファイルを読み込むには、`${file:/etc/gateway/idp-ca.pem}` と書きます。企業 PKI の背後にある Keycloak または Dex に使用します。 |100| `ca_cert_pem` | いいえ | ファイルへのパスではなく、PEM エンコードされた CA 証明書そのもの。IdP リクエストに限り、システムの信頼ストアを置き換えます。マウントされたファイルを読み込むには `${file:/etc/gateway/idp-ca.pem}` と記述します。企業 PKI の背後にある Keycloak や Dex に使用します。 |

101 101 

102<h4 id="certificate-client-authentication">102<h4 id="certificate-client-authentication">

103 証明書によるクライアント認証103 証明書によるクライアント認証

104</h4>104</h4>

105 105 

106Microsoft Entra が証明書の認証情報で行うように、アイデンティティプロバイダーがクライアントシークレットではなく証明書で OAuth クライアントを認証する場合は、`token_endpoint_auth_method: private_key_jwt` を設定します。ゲートウェイサーバーで Claude Code v2.1.284 以降が必要です。106Microsoft Entra の証明書の認証情報のように、ID プロバイダーが OAuth クライアントをクライアントシークレットではなく証明書で認証する場合は、`token_endpoint_auth_method: private_key_jwt` を設定します。ゲートウェイサーバーで Claude Code v2.1.284 以降が必要です。

107 107 

108この設定では、ゲートウェイはシークレットを送信しません。開発者がサインインするとき、およびゲートウェイがそのセッションをリフレッシュするたびに、証明書の秘密鍵で署名された短期間有効な JWT を使用して IdP のトークンエンドポイントに対して認証します。JWT は RS256 で署名され、`kid` ではなく `x5t` および `x5t#S256` サムプリントヘッダーによって証明書を識別します。IdP は登録された証明書をサムプリントで検索できる必要があります。108この設定では、ゲートウェイはシークレットを送信しません。開発者がサインインするとき、およびゲートウェイがその開発者のセッションをリフレッシュするたびに、証明書の秘密鍵で署名された短命の JWT を使って IdP のトークンエンドポイントに対して認証します。JWT は RS256 で署名され、`kid` ではなく `x5t` および `x5t#S256` のサムプリントヘッダーで証明書を識別します。IdP は、登録された証明書をサムプリントで見つけられる必要があります。

109 109 

110<Steps>110<Steps>

111 <Step title="鍵と証明書を作成する">111 <Step title="鍵と証明書を作成する">

112 PKCS#8 または PKCS#1 PEM 形式の、2048 ビット以上の暗号化されていない RSA 秘密鍵と、それに対応する証明書を作成します。ゲートウェイは、これらの条件を満たさない鍵では起動を拒否します。次の `openssl` コマンドは、そのような鍵と、1 年間有効な自己署名証明書を作成します:112 PKCS#8 または PKCS#1 の PEM 形式で、2048 ビット以上の暗号化されていない RSA 秘密鍵と、それに対応する証明書を作成します。ゲートウェイは、これらの条件を満たさない鍵では起動を拒否します。次の `openssl` コマンドは、そのような鍵と、1 年間有効な自己署名証明書を作成します。

113 113 

114 ```bash theme={null}114 ```bash theme={null}

115 openssl req -x509 -newkey rsa:2048 -nodes -keyout idp-client.key -out idp-client.crt -days 365 -subj "/CN=claude-gateway"115 openssl req -x509 -newkey rsa:2048 -nodes -keyout idp-client.key -out idp-client.crt -days 365 -subj "/CN=claude-gateway"

116 ```116 ```

117 117 

118 これにより、現在のディレクトリに `idp-client.key` と `idp-client.crt` が書き込まれます。両方のファイルを、ゲートウェイが読み取れる場所にコピーまたはマウントします。ステップ 3 の例では `/etc/gateway/` を使用しています。118 現在のディレクトリに `idp-client.key` と `idp-client.crt` が書き込まれます。両方のファイルを、ゲートウェイが読み取れる場所にコピーまたはマウントしてください。ステップ 3 の例では `/etc/gateway/` を使用しています。

119 </Step>119 </Step>

120 120 

121 <Step title="証明書を IdP にアップロードする">121 <Step title="証明書を IdP にアップロードする">


123 </Step>123 </Step>

124 124 

125 <Step title="鍵と証明書を gateway.yaml に追加する">125 <Step title="鍵と証明書を gateway.yaml に追加する">

126 `client_assertion` ブロックで、ゲートウェイに秘密鍵と証明書を渡します。`client_secret` は省略します。`private_key_jwt` と一緒に設定されていると、ゲートウェイは起動を拒否するためです。次の `oidc` ブロックは、証明書を使用してゲートウェイを Microsoft Entra テナントに対して認証します:126 `client_assertion` ブロックで、ゲートウェイに秘密鍵と証明書を渡します。`client_secret` は省略してください。`private_key_jwt` と一緒に設定されていると、ゲートウェイは起動を拒否するためです。次の `oidc` ブロックは、証明書を使用してゲートウェイを Microsoft Entra テナントに対して認証します。

127 127 

128 ```yaml theme={null}128 ```yaml theme={null}

129 oidc:129 oidc:


135 certificate_pem: ${file:/etc/gateway/idp-client.crt}135 certificate_pem: ${file:/etc/gateway/idp-client.crt}

136 ```136 ```

137 137 

138 どちらの値もファイルパスではなく PEM の内容であるため、例のように `${file:/path}` でマウントされたファイルを読み込みます。`certificate_pem` がチェーンの残りを含まない単一の PEM 証明書であり、その公開鍵が `private_key_pem` と一致しない限り、ゲートウェイは起動を拒否します。138 どちらの値もファイルパスではなく PEM の内容であるため、例のように `${file:/path}` でマウントされたファイルを読み込んでください。`certificate_pem` が、チェーンの残りを含まない単一の PEM 証明書であり、かつその公開鍵が `private_key_pem` と一致するものでなければ、ゲートウェイは起動を拒否します。

139 </Step>139 </Step>

140 140 

141 <Step title="ゲートウェイを再起動してブートログを確認する">141 <Step title="ゲートウェイを再起動して起動ログを確認する">

142 ゲートウェイを再起動し、ブートログで次の行を探します:142 ゲートウェイを再起動し、起動ログで次の行を探します。

143 143 

144 ```text theme={null}144 ```text theme={null}

145 [gateway] 2026-10-01T23:07:40.512Z info oidc: client authentication private_key_jwt; certificate CN=claude-gateway, SHA-1 thumbprint DE92821854EE8BAA1D98C758FAA04AABE80B9F57, expires Oct 1 23:07:31 2027 GMT145 [gateway] 2026-10-01T23:07:40.512Z info oidc: client authentication private_key_jwt; certificate CN=claude-gateway, SHA-1 thumbprint DE92821854EE8BAA1D98C758FAA04AABE80B9F57, expires Oct 1 23:07:31 2027 GMT

146 ```146 ```

147 147 

148 SHA-1 サムプリントを、アップロードした証明書について IdP が表示するものと比較します。証明書の有効期限が切れている、またはまだ有効でない場合でもゲートウェイは起動しますが、置き換えるまでサインインとリフレッシュが失敗するという警告をログに記録します。IdP が証明書を受け入れることを確認するには、開発者 1 人にゲートウェイを通じてサインインしてもらいます。148 SHA-1 サムプリントを、アップロードした証明書について IdP が表示するサムプリントと比較してください。証明書の有効期限が切れている場合や、まだ有効になっていない場合でも、ゲートウェイは起動しますが、証明書を置き換えるまでサインインとリフレッシュが失敗するという警告をログに記録します。IdP が証明書を受け入れることを確認するには、開発者 1 人にゲートウェイ経由でサインインしてもらいます。

149 </Step>149 </Step>

150</Steps>150</Steps>

151 151 

152<h4 id="rotate-the-client-certificate">152<h4 id="rotate-the-client-certificate">

153 クライアント証明書のローテーション153 クライアント証明書をローテーションする

154</h4>154</h4>

155 155 

156ゲートウェイは鍵と証明書をブート時に一度だけ読み込むため、ファイルの変更は再起動後にのみ反映されます。IdP が持っていない証明書をトークンリクエストが提示することがないよう、次の順序でローテーションします:156ゲートウェイは起動時に鍵と証明書を一度だけ読み取るため、ファイルの変更は再起動後にのみ有効になります。IdP が持っていない証明書をトークンリクエストが提示することのないよう、次の順序でローテーションしてください。

157 157 

1581. 新しい証明書を、古い証明書と並べて IdP にアップロードします。1581. 新しい証明書を、古い証明書と並べて IdP にアップロードします。

1592. `gateway.yaml` が読み込む鍵と証明書のファイルを置き換えてから、ゲートウェイを再起動します。複数のレプリカを実行している場合は、[ローリング再起動](/docs/ja/claude-apps-gateway-deploy#upgrades)で問題ありません。古い証明書を削除するまで、IdP は両方の証明書を保持しているためです。1592. `gateway.yaml` が読み込む鍵と証明書のファイルを置き換えてから、ゲートウェイを再起動します。複数のレプリカを実行している場合は、古い証明書を削除するまで IdP が両方の証明書を持っているため、[ローリング再起動](/docs/ja/claude-apps-gateway-deploy#upgrades)が機能します。

1603. すべてのレプリカが再起動した後、古い証明書を IdP から削除します。1603. すべてのレプリカが再起動したら、古い証明書を IdP から削除します。

161 161 

162<h4 id="idp-requests-through-a-forward-proxy">162<h4 id="idp-requests-through-a-forward-proxy">

163 フォワードプロキシを通じた IdP リクエスト163 フォワードプロキシ経由の IdP リクエスト

164</h4>164</h4>

165 165 

166推論アップストリームはすべてのバージョンで `HTTPS_PROXY` と `HTTP_PROXY` を尊重します。ゲートウェイ独自の IdP、検出、JWKS、トークン、および userinfo へのリクエストは、`oidc.use_proxy: true` を設定しない限り直接です。これには v2.1.227 以降が必要です。プロキシ変数が設定され、`use_proxy` が設定されておらず、発行者が `NO_PROXY` でカバーされていない場合、ゲートウェイはそれらのリクエストを直接に保ち、ブート時に選択するよう求める通知をログに記録します。`use_proxy: false` はそれらを直接に保ち、通知を抑止します。166推論のアップストリームは、すべてのバージョンで `HTTPS_PROXY` と `HTTP_PROXY` に従います。ゲートウェイ自身の IdP へのリクエスト(ディスカバリ、JWKS、トークン、userinfo)は、`oidc.use_proxy: true` を設定しない限り直接送信されます。この設定には v2.1.227 以降が必要です。プロキシ変数が設定されていて、`use_proxy` が未設定で、issuer が `NO_PROXY` の対象外である場合、ゲートウェイはそれらのリクエストを直接送信し続け、起動時にどちらかを選択するよう求める通知をログに記録します。`use_proxy: false` にすると直接送信が維持され、通知は表示されなくなります。

167 167 

168`use_proxy: true` の場合、ポッドは各 IdP エンドポイントのホスト名を自身で解決し、プロキシに解決された IP アドレスへの `CONNECT` を要求します。プロキシは、発行者だけでなく、検出ドキュメントが名前を付けるすべてのホストの IP アドレスへの `CONNECT` を受け入れる必要があります。`http://` プロキシ URL を使用します。`ca_cert_pem` と [SSRF ガード](/docs/ja/claude-apps-gateway-deploy#threat-model-summary)はプロキシされたパスにも適用されます。168`use_proxy: true` の場合、Pod は各 IdP エンドポイントのホスト名を自分で解決し、解決した IP アドレスへの `CONNECT` をプロキシに依頼します。そのため、プロキシは issuer だけでなく、ディスカバリドキュメントに記載されたすべてのホストの IP アドレスへの `CONNECT` を受け入れる必要があります。`http://` のプロキシ URL を使用してください。`ca_cert_pem` と [SSRF ガード](/docs/ja/claude-apps-gateway-deploy#threat-model-summary)は、プロキシ経由のパスにも適用されます。

169 169 

170[プロキシのみのエグレス](#proxy-only-egress)はこれらの両方を変更します。アクティブな場合、IdP リクエストは `use_proxy: false` を設定しない限りプロキシに従い、ゲートウェイは最初にそれを解決せずにプロキシに各 IdP ホスト名を渡します。170[プロキシのみのエグレス](#proxy-only-egress)は、これらの両方を変更します。これが有効な間、IdP リクエストは `use_proxy: false` を設定しない限りプロキシに従い、ゲートウェイは各 IdP ホスト名を事前に解決せずにプロキシに渡します。

171 171 

172<h4 id="proxy-only-egress">172<h4 id="proxy-only-egress">

173 プロキシのみのエグレス173 プロキシのみのエグレス

174</h4>174</h4>

175 175 

176ポッドがそのフォワードプロキシを通じてのみ他のホストに到達でき、パブリック DNS 名を自身で解決できない場合、またはプロキシが IP アドレスへの `CONNECT` を拒否する場合は、ゲートウェイの環境で `HTTPS_PROXY` の隣に `CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1` を設定します。v2.1.277 以降が必要です。これは `gateway.yaml` キーではなく環境変数です。設定ファイルの何もゲートウェイのアドレスチェックを緩和できないようにするためです。176Pod が他のホストにそのフォワードプロキシ経由でのみ到達でき、自身ではパブリック DNS 名を解決できない場合、またはプロキシが IP アドレスへの `CONNECT` を拒否する場合は、ゲートウェイの環境で `HTTPS_PROXY` と並べて `CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1` を設定します。v2.1.277 以降が必要です。これが `gateway.yaml` のキーではなく環境変数になっているのは、設定ファイル内のいかなる内容もゲートウェイのアドレスチェックを緩められないようにするためです。

177 177 

178```bash theme={null}178```bash theme={null}

179export HTTPS_PROXY=http://proxy.corp.example.com:3128179export HTTPS_PROXY=http://proxy.corp.example.com:3128


182export CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1182export CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1

183```183```

184 184 

185ゲートウェイはプロキシのみのエグレスがアクティブな場合、ブート時に 1 つの `network:` 行をログに記録します。185プロキシのみのエグレスが有効な間、ゲートウェイは起動時に `network:` の行を 1 行ログに記録します。

186 186 

187以下の各行は、`HTTPS_PROXY` が設定されたゲートウェイ上の 1 つのクラスのアウトバウンドリクエストについて、デフォルトの場合とプロキシのみのエグレスがアクティブな場合の動作を示します。187以下の各行は、`HTTPS_PROXY` が設定されたゲートウェイにおける送信リクエストの 1 つの種類について、デフォルト時とプロキシのみのエグレスが有効な時の動作を示しています。

188 188 

189| アウトバウンドリクエスト | デフォルト | プロキシのみのエグレスアクティブ |189| 送信リクエスト | デフォルト | プロキシのみのエグレスが有効 |

190| - | - | - |190| - | - | - |

191| `provider: anthropic` アップストリーム、Workload Identity Federation トークン交換、`telemetry.forward_to` エクスポート | ローカルで解決およびチェックされ、その後、プロキシを通じてチェックされた IP アドレスへの `CONNECT`。`NO_PROXY` にリストされたテレメトリコレクターは代わりに直接到達します | ホスト名がプロキシに渡されます |191| `provider: anthropic` のアップストリーム、Workload Identity Federation のトークン交換、`telemetry.forward_to` のエクスポート | ローカルで解決およびチェックされた後、チェック済みの IP アドレスへプロキシ経由で `CONNECT`。`NO_PROXY` に列挙されたテレメトリコレクターには代わりに直接到達 | ホスト名をプロキシに渡す |

192| IdP 検出、JWKS、トークン、および userinfo | [`oidc.use_proxy: true`](#idp-requests-through-a-forward-proxy) でない限り直接。その場合はチェックされた IP アドレスへの `CONNECT` | ホスト名がプロキシに渡されます。ただし、`oidc.use_proxy: false` は内部 IdP を直接に保ちます |192| IdP のディスカバリ、JWKS、トークン、userinfo | [`oidc.use_proxy: true`](#idp-requests-through-a-forward-proxy) でない限り直接。その場合はチェック済みの IP アドレスへ `CONNECT` | ホスト名をプロキシに渡す。ただし `oidc.use_proxy: false` で内部 IdP を直接のままにできる |

193| Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、および Microsoft Foundry アップストリーム。Google グループ検索 | ホスト名がプロキシに渡されます | 変更なし |193| Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry のアップストリーム、Google グループの検索 | ホスト名をプロキシに渡す | 変更なし |

194 194 

195プロキシのみのエグレスは、ゲートウェイの環境がこれら 3 つの条件をすべて満たさない限り、オフのままです:195プロキシのみのエグレスは、ゲートウェイの環境が次の 3 つの条件をすべて満たさない限りオフのままです。

196 196 

197* `HTTPS_PROXY` または `HTTP_PROXY` が設定されています。197* `HTTPS_PROXY` または `HTTP_PROXY` が設定されている。

198* `NO_PROXY` と `no_proxy` は空です。プラットフォームがいずれかをポッドに注入する場合、ゲートウェイコンテナの両方を空の値に設定します。`NO_PROXY` にテレメトリコレクターをリストすると、プロキシのみのエグレスがオフのままです。198* `NO_PROXY` と `no_proxy` が空である。プラットフォームがいずれかを Pod に注入する場合は、ゲートウェイコンテナで両方を空の値に設定してください。`NO_PROXY` にテレメトリコレクターを列挙すると、プロキシのみのエグレスはオフのままになります。

199* `CLAUDE_GATEWAY_ALLOW_LOOPBACK` がオンになっていません。ポッド独自のループバック上のコレクターまたは IdP は、プロキシのみのエグレスと組み合わせることはできません。ループバックアドレスがプロキシに渡されるとプロキシホスト独自のものになるため、代わりにプロキシが到達できるアドレスをそれらのサービスに与えてください。同じ理由で、ゲートウェイはプロキシのみのエグレスがアクティブな場合、`localhost` スタイルの名前を完全に拒否します。199* `CLAUDE_GATEWAY_ALLOW_LOOPBACK` がオンになっていない。Pod 自身のループバック上にあるコレクターや IdP は、プロキシのみのエグレスと組み合わせることはできません。プロキシに渡されたループバックアドレスはプロキシホスト自身のものになってしまうため、代わりにそれらのサービスにはプロキシが到達できるアドレスを与えてください。同じ理由で、プロキシのみのエグレスが有効な間、ゲートウェイは `localhost` のような名前を一律に拒否します。

200 200 

201これらの条件のいずれかが満たされていない場合、ゲートウェイはブート時に警告をログに記録し、それを停止した変数に名前を付け、デフォルトの動作を保ちます。201これらの条件のいずれかが満たされない場合、ゲートウェイは起動時に、有効化を妨げた変数を示す警告をログに記録し、デフォルトの動作を維持します。

202 202 

203プロキシのみのエグレスがアクティブになったら、内部コレクターと IP アドレスで設定されたホストを含む、プロキシ内のすべての宛先を許可します。[`oidc.use_proxy: false`](#idp-requests-through-a-forward-proxy) で内部 IdP を直接に保つことは引き続き可能です。203プロキシのみのエグレスが有効になったら、内部コレクターや IP アドレスで設定されたホストを含め、すべての宛先をプロキシで許可してください。[`oidc.use_proxy: false`](#idp-requests-through-a-forward-proxy) を使えば、引き続き内部 IdP を直接のままにできます。

204 204 

205<Warning>205<Warning>

206 これをオンにするのは、プロキシの許可リストがゲートウェイ独自のチェック以上に厳密な場合のみです。プロキシは `169.254.169.254` や `metadata.google.internal` などのクラウドメタデータエンドポイント、リンクローカルアドレス、およびプロキシホスト独自のループバックを拒否する必要があります。また、名前だけでなく、名前が解決するアドレスによってそれらを拒否する必要があります。ゲートウェイはもはやそれらのいずれかに解決するホスト名をキャッチしないためです。要求された場所にどこでも接続するプロキシは、これらのリクエストに対するゲートウェイの [SSRF ガード](/docs/ja/claude-apps-gateway-deploy#threat-model-summary)を無効にします。206 プロキシの許可リストが少なくともゲートウェイ自身のチェックと同程度に厳格である場合にのみ、これをオンにしてください。プロキシは、`169.254.169.254` や `metadata.google.internal` などのクラウドメタデータエンドポイント、リンクローカルアドレス、プロキシホスト自身のループバックを拒否する必要があります。また、名前だけでなく、名前の解決先のアドレスによって拒否する必要があります。ゲートウェイは、それらのいずれかに解決されるホスト名をもはや捕捉しないためです。要求された場所ならどこにでも接続するプロキシは、これらのリクエストについてゲートウェイの [SSRF ガード](/docs/ja/claude-apps-gateway-deploy#threat-model-summary)を無効にしてしまいます。

207</Warning>207</Warning>

208 208 

209<h3 id="session">209<h3 id="session">

210 `session`210 `session`

211</h3>211</h3>

212 212 

213`session` ブロックは、ゲートウェイがサインイン後に発行するベアラートークンを定義します。トークンに署名するシークレットと、その有効期間です。213`session` ブロックは、ゲートウェイがサインイン後に発行するベアラートークンの性質を決めます。トークンに署名するシークレットと、トークンの有効期間です。

214 214 

215| フィールド | 必須 | 説明 |215| フィールド | 必須 | 説明 |

216| - | - | - |216| - | - | - |

217| `jwt_secret` | はい | 少なくとも 32 バイトのエントロピー。例えば `openssl rand -base64 32` から。ゲートウェイの HS256 ベアラートークンに署名します。単一の文字列またはローテーション用の配列を受け入れます。インデックス 0 が署名し、すべてのエントリが検証します。ローテーションするには、新しいシークレットを先頭に追加し、`ttl_hours` を待ってから古いものを削除します。 |217| `jwt_secret` | はい | 少なくとも 32 バイトのエントロピー(例: `openssl rand -base64 32` で生成)。ゲートウェイの HS256 ベアラートークンに署名します。単一の文字列、またはローテーション用の配列を受け付けます。インデックス 0 が署名に使われ、すべてのエントリが検証に使われます。ローテーションするには、新しいシークレットを先頭に追加し、`ttl_hours` 待ってから古いシークレットを削除します。 |

218| `ttl_hours` | いいえ | ゲートウェイベアラートークンの有効期間。デフォルト `1`。IdP がリフレッシュトークンを発行する場合、CLI は有効期限前に自動的にリフレッシュします。有効期間が短いほど、より速くプロビジョニング解除されます。長いほど、IdP ラウンドトリップが少なくなります。IdP が `offline_access` が利用できないためリフレッシュトークンを発行できない場合、サイレントリフレッシュはないため、これを `8` または `12` に上げて、開発者を 1 時間ごとにブラウザログインに戻すのを避けてください。 |218| `ttl_hours` | いいえ | ゲートウェイのベアラートークンの有効期間。デフォルトは `1`。IdP がリフレッシュトークンを発行する場合、CLI は有効期限前にサイレントにリフレッシュします。有効期間を短くするとプロビジョニング解除が速くなり、長くすると IdP とのラウンドトリップが減ります。`offline_access` が利用できず IdP がリフレッシュトークンを発行できない場合、サイレントリフレッシュは行われないため、開発者を 1 時間ごとにブラウザログインに戻さないよう、この値を `8` または `12` に上げてください。 |

219 219 

220<h3 id="store">220<h3 id="store">

221 `store`221 `store`

222</h3>222</h3>

223 223 

224`store` ブロックはゲートウェイを PostgreSQL データベースに向けます。このデータベースはデバイスグラントとレート制限カウンターを保持します。224`store` ブロックは、デバイスグラントとレート制限カウンターを保持する PostgreSQL データベースをゲートウェイに指定します。

225 225 

226| フィールド | 必須 | 説明 |226| フィールド | 必須 | 説明 |

227| - | - | - |227| - | - | - |

228| `postgres_url` | はい | `postgres://` または `postgresql://` URL。カンマ区切りのリストではなく、ホストを 1 つだけ指定します。ゲートウェイはブート時およびアップグレード時に独自のスキーママイグレーションを実行するため、ロールはターゲットスキーマでテーブルを作成および変更する権限が必要です。[アップグレード](/docs/ja/claude-apps-gateway-deploy#upgrades)および [Postgres](/docs/ja/claude-apps-gateway-deploy#postgres) を参照してください。 |228| `postgres_url` | はい | カンマ区切りのリストではなく、ホストが 1 つの `postgres://` または `postgresql://` URL。ゲートウェイは起動時とアップグレード時に独自のスキーママイグレーションを実行するため、ロールには対象スキーマでテーブルを作成および変更する権限が必要です。[アップグレード](/docs/ja/claude-apps-gateway-deploy#upgrades)と [Postgres](/docs/ja/claude-apps-gateway-deploy#postgres) を参照してください。 |

229| `username` | いいえ | `postgres_url` のユーザーを上書きします |229| `username` | いいえ | `postgres_url` 内のユーザーを上書きします |

230| `password` | いいえ | データベース認証情報。`postgres_url` ではなくここに設定して、認証情報を URL から外します。任意の文字を受け入れ、URL 認証情報よりも優先されます。 |230| `password` | いいえ | データベースの認証情報。認証情報が URL に含まれないよう、`postgres_url` ではなくここで設定してください。任意の文字を受け付け、URL の認証情報よりも優先されます。 |

231| `max_connections` | いいえ | レプリカあたりの Postgres 接続プールサイズ。デフォルト `5`。保守的で共有データベースに優しいです。[支出制限](#admin)が有効な場合、ホットパスは推論リクエストごとに数回の操作を実行するため、専用データベースが負荷の下にある場合はこれを上げ、レプリカ数 × この値をデータベースの `max_connections` 以下に保ちます。 |231| `max_connections` | いいえ | レプリカごとの Postgres コネクションプールのサイズ。デフォルトは `5` で、控えめな値であり共有データベースに適しています。[支出制限](#admin)を有効にすると、ホットパスで推論リクエストごとにいくつかの操作が行われるため、負荷のかかる専用データベースでは値を上げ、レプリカ数 × この値がデータベースの `max_connections` を下回るようにしてください。 |

232| `connect_timeout_seconds` | いいえ | ゲートウェイが Postgres 接続を開くときに待機する秒数。`1` から `60` の整数。デフォルト `5`。新しいゲートウェイインスタンスが起動するときに接続試行がタイムアウトする場合は、これを上げてください。ゲートウェイサーバーで Claude Code v2.1.274 以降が必要です。以前のバージョンはキーが設定されている場合、起動を拒否します。 |232| `connect_timeout_seconds` | いいえ | ゲートウェイが Postgres 接続を開く際に待機する秒数。`1` から `60` までの整数で、デフォルトは `5`。新しいゲートウェイインスタンスの起動時に接続試行がタイムアウトする場合は値を上げてください。ゲートウェイサーバーで Claude Code v2.1.274 以降が必要です。それより前のバージョンでは、このキーが設定されていると起動を拒否します。 |

233| `readiness_grace_seconds` | いいえ | Postgres が応答を停止した後、`/readyz` が準備完了を報告し続ける秒数。`0` から `3600` の整数。デフォルト `0`。値を選択する方法については、[停止動作](/docs/ja/claude-apps-gateway-deploy#outage-behavior)を参照してください。ゲートウェイサーバーで Claude Code v2.1.282 以降が必要です。以前のバージョンはキーが設定されている場合、起動を拒否します。 |233| `readiness_grace_seconds` | いいえ | Postgres が応答しなくなった後、`/readyz` が ready を報告し続ける秒数。`0` から `3600` までの整数で、デフォルトは `0`。値の選び方については[障害時の動作](/docs/ja/claude-apps-gateway-deploy#outage-behavior)を参照してください。ゲートウェイサーバーで Claude Code v2.1.282 以降が必要です。それより前のバージョンでは、このキーが設定されていると起動を拒否します。 |

234 234 

235ローカル開発の場合、`postgres_url` を使い捨て Postgres コンテナに向けます。例えば `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`。235ローカル開発では、`postgres_url` を使い捨ての Postgres コンテナに向けてください。例: `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`。

236 236 

237<h3 id="upstreams">237<h3 id="upstreams">

238 `upstreams`238 `upstreams`


240 240 

241`upstreams` は順序付きリストです。ゲートウェイは、要求されたモデルを解決する最初のアップストリームに推論を転送します。241`upstreams` は順序付きリストです。ゲートウェイは、要求されたモデルを解決する最初のアップストリームに推論を転送します。

242 242 

243`5xx`、`429`、`401`、`403`、`404`、またはタイムアウト時に、ゲートウェイは次のアップストリームにフェイルオーバーします。他の `4xx` ではフェイルオーバーしません。これらのエラーはアップストリームではなくリクエストに起因するためです。`401` または `403` は、ゲートウェイが使用した認証情報をアップストリームが拒否したか、例えば要求されたモデルへのアクセスを拒否したことを意味します。`404` はそのアップストリームが要求されたモデルを提供しないことを意味するため、リスト内の後のアップストリームがまだ提供できます。243`5xx`、`429`、`401`、`403`、`404`、またはタイムアウトの場合、ゲートウェイは次のアップストリームにフェイルオーバーします。その他の `4xx` ではフェイルオーバーしません。これらのエラーはアップストリームではなくリクエストに起因するためです。`401` または `403` は、ゲートウェイが使用した認証情報をアップストリームが拒否したか、たとえば要求されたモデルへのアクセスを拒否したことを意味します。`404` は、そのアップストリームが要求されたモデルを提供していないことを意味するため、リスト内の後続のアップストリームが提供できる可能性があります。

244 244 

245アップストリームで `forward_user_identity: true` を設定する場合、開発者のメールを含むリクエストに対してそのアップストリームが返す `429` はフェイルオーバーしません。[ユーザーごとの制限による拒否が開発者にどう届くか](#per-user-identity-headers-for-a-proxy-you-run)を参照してください。245アップストリームで `forward_user_identity: true` を設定した場合、開発者のメールアドレスを含むリクエストに対してそのアップストリームが返す `429` はフェイルオーバーしません。[ユーザーごとの制限による拒否が開発者にどのように届くか](#per-user-identity-headers-for-a-proxy-you-run)を参照してください。

246 246 

247`404` でのフェイルオーバーにはゲートウェイ v2.1.198 以降が必要です。以前のリリースは、リスト内の後のアップストリームがモデルを提供している場合でも、最初の `404` をクライアントに返しました。247`404` でのフェイルオーバーには、ゲートウェイ v2.1.198 以降が必要です。それより前のリリースでは、リスト内の後続のアップストリームがモデルを提供している場合でも、最初の `404` をクライアントに返していました。

248 248 

249同じプロバイダーの複数のアップストリームは、異なる `name:` を設定する必要があります。249同じプロバイダーの複数のアップストリームには、それぞれ異なる `name:` を設定する必要があります。

250 250 

251Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、および Microsoft Foundry クライアントはスタートアップ時に 1 回構築され、SDK は内部的に認証情報をリフレッシュするため、クラウド認証情報のローテーションは再起動を必要としません。静的 Anthropic API キーとベアラーはスタートアップ時に読み込まれます。[Anthropic API](#anthropic-api) を参照してください。251Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry のクライアントは起動時に一度だけ作成され、それらの SDK は内部で認証情報をリフレッシュするため、クラウドの認証情報をローテーションしても再起動は不要です。静的な Anthropic API キーとベアラーは起動時に読み込まれます。[Anthropic API](#anthropic-api) を参照してください。

252 252 

253<h4 id="upstream-error-messages">253<h4 id="upstream-error-messages">

254 アップストリームエラーメッセージ254 アップストリームのエラーメッセージ

255</h4>255</h4>

256 256 

257ゲートウェイは、アップストリームがどのように応答したかに応じて、1 つのアップストリームのエラーレスポンスまたはそれ独自の `502` を返します:257ゲートウェイは、アップストリームがどのように応答したかに応じて、いずれかのアップストリームのエラーレスポンス、またはゲートウェイ独自の `502` を返します。

258 258 

259* **ゲートウェイが[フェイルオーバー](#multiple-upstreams)しないステータスをアップストリームが返した**:そのアップストリームのレスポンス。ゲートウェイはそれ以上のアップストリームを試みません。259* **ゲートウェイが[フェイルオーバー](#multiple-upstreams)しないステータスをアップストリームが返した場合**: そのアップストリームのレスポンス。ゲートウェイはそれ以上のアップストリームを試行しません。

260* **ゲートウェイが試みたすべてのアップストリームが[フェイルオーバー](#multiple-upstreams)する方法で失敗した**:最後の `429`。いずれも `429` を返さなかった場合、ゲートウェイは順に、最後の `401` または `403`、最後の `404`、最後の `501` を優先します。いずれも返さなかった場合、ゲートウェイ独自の `502`。`all upstreams failed (N attempted)`。N は [`upstreams`](#upstreams) のすべてのエントリをカウントします。要求されたモデルを提供しないためゲートウェイがスキップしたエントリを含みます。260* **ゲートウェイが試行したすべてのアップストリームが、[フェイルオーバー対象](#multiple-upstreams)となる形で失敗した場合**: 最後の `429`。`429` を返したものがない場合、ゲートウェイは最後の `401` または `403`、最後の `404`、最後の `501` の順に優先します。いずれも返されなかった場合は、ゲートウェイ独自の `502`、`all upstreams failed (N attempted)` を返します。ここで N は、要求されたモデルを提供していないためにゲートウェイがスキップしたエントリも含め、[`upstreams`](#upstreams) 内のすべてのエントリの数です。

261 261 

262ゲートウェイがアップストリームのレスポンスを返す場合、アップストリームのステータスコードを保ちます。アップストリームのメッセージを保つかどうかはプロバイダーに依存します。Anthropic API アップストリームのエラー本体は変更されずに開発者に届きます。262ゲートウェイがアップストリームのレスポンスを返すとき、アップストリームのステータスコードは維持されます。アップストリームのメッセージを維持するかどうかはプロバイダーによって異なります。Anthropic API アップストリームのエラー本文は、変更されずに開発者に届きます。

263 263 

264Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、および Microsoft Foundry アップストリームは、エラーテキストでアカウント ID、ロール ARN、およびプロジェクト ID に名前を付けることがあります。ゲートウェイはその完全なテキストを[運用ログ](/docs/ja/claude-apps-gateway-deploy#logs)に記録します。開発者がこれらのアップストリームから見るものは、拒否の種類に依存します:264Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry のアップストリームは、エラーテキストにアカウント ID、ロール ARN、プロジェクト ID を含めることがあります。ゲートウェイはその全文を[運用ログ](/docs/ja/claude-apps-gateway-deploy#logs)に記録します。これらのアップストリームから開発者に表示される内容は、拒否の内容によって異なります。

265 265 

266* Anthropic の標準エラーエンベロープの `400` または `413`:`prompt is too long` などのアップストリーム独自のメッセージ。Claude Platform on AWS、Agent Platform、および Microsoft Foundry はモデル API の拒否に対してこのエンベロープを返します。266* Anthropic の標準エラーエンベロープでの `400` または `413`: `prompt is too long` などのアップストリーム自身のメッセージ。Claude Platform on AWS、Agent Platform、Microsoft Foundry は、モデル API の拒否についてこのエンベロープを返します。

267* プロバイダー独自の形式の `400` または `413`:`capability_rejected:` トークン。ゲートウェイが拒否を分類できない場合、`400` で `upstream rejected the request` または `413` で `request too large for this upstream`。267* プロバイダー独自の形式での `400` または `413`: `capability_rejected:` トークン。ゲートウェイが拒否を分類できない場合は、`400` では `upstream rejected the request`、`413` では `request too large for this upstream`。

268* その他のステータス:`429` で `upstream rate limit exceeded` などのステータスごとの汎用文言。268* その他のステータス: `429` での `upstream rate limit exceeded` など、ステータスごとの汎用的な文言。

269 269 

270例えば、ゲートウェイは Amazon Bedrock の `Input is too long for requested model.` を `capability_rejected: prompt_too_long` に置き換えます。Claude Code は `prompt is too long` と同様に、そのトークンで[自動的にコンパクト](/docs/ja/errors#prompt-is-too-long)にします。270たとえば、ゲートウェイは Amazon Bedrock の `Input is too long for requested model.` を `capability_rejected: prompt_too_long` に置き換えます。Claude Code は、`prompt is too long` の場合と同様に、このトークンに対して[自動的にコンパクト化](/docs/ja/errors#prompt-is-too-long)します。

271 271 

272クラウドアップストリームの `400` または `413` メッセージを保つか、`capability_rejected:` トークンで置き換えるには、ゲートウェイ v2.1.233 以降が必要です。272クラウドアップストリームの `400` または `413` のメッセージを維持すること、または `capability_rejected:` トークンに置き換えることには、ゲートウェイ v2.1.233 以降が必要です。

273 273 

274<h4 id="anthropic-api">274<h4 id="anthropic-api">

275 Anthropic API275 Anthropic API

276</h4>276</h4>

277 277 

278最小限の Anthropic アップストリームは、[Claude Console](https://platform.claude.com) からの API キーです:278最小構成の Anthropic アップストリームは、[Claude Console](https://platform.claude.com) から取得した API キーです。

279 279 

280```yaml theme={null}280```yaml theme={null}

281upstreams:281upstreams:


287 # base_url: https://api.anthropic.com # default; override for a forward proxy287 # base_url: https://api.anthropic.com # default; override for a forward proxy

288```288```

289 289 

2902 つの認証情報フォームは、送信するヘッダーが異なります:2902 つの認証情報の形式は、送信するヘッダーが異なります。

291 291 

292* **`api_key`**:`x-api-key` を送信します。Claude Console でローテーションし、環境変数を更新します。292* **`api_key`**: `x-api-key` を送信します。Claude Console でローテーションし、環境変数を更新してください。

293* **`oauth_token`**:`Authorization: Bearer` を送信します。組織が長期 API キーではなく短期トークンを発行する場合、ベアラーフォームを使用します。ベアラーはスタートアップ時に 1 回読み込まれるため、シークレットを再マウントして再起動することでリフレッシュします。293* **`oauth_token`**: `Authorization: Bearer` を送信します。組織が長期間有効な API キーの代わりに短命のトークンを発行する場合は、ベアラー形式を使用してください。ベアラーは起動時に一度だけ読み込まれるため、シークレットを再マウントして再起動することでリフレッシュします。

294 294 

295静的キーまたはベアラーの代わりに、Workload Identity Federation を使用できます。[Workload Identity Federation ガイド](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)に従ってフェデレーションルールを作成し、ワークロードの OIDC JWT をファイルとしてマウントします。例えば、Kubernetes プロジェクトサービスアカウントトークンまたは CI プラットフォームの id-token。ゲートウェイは JWT を短期ベアラーと交換し、自動的にリフレッシュします。トークンファイルはすべての交換で再読み込みされるため、ローテーションされたプロジェクトトークンは再起動なしで取得されます。295静的なキーやベアラーの代わりに、Workload Identity Federation を使用できます。[Workload Identity Federation ガイド](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)に従ってフェデレーションルールを作成し、Kubernetes の projected サービスアカウントトークンや CI プラットフォームの id-token など、ワークロードの OIDC JWT をファイルとしてマウントします。ゲートウェイは JWT を短命のベアラーと交換し、自動的にリフレッシュします。トークンファイルは交換のたびに再読み込みされるため、ローテーションされた projected トークンは再起動なしで反映されます。

296 296 

297```yaml theme={null}297```yaml theme={null}

298upstreams:298upstreams:


308<a id="per-user-identity-headers-for-a-proxy-you-run" />308<a id="per-user-identity-headers-for-a-proxy-you-run" />

309 309 

310<h5 id="per-user-identity-headers-for-a-proxy-you-run">310<h5 id="per-user-identity-headers-for-a-proxy-you-run">

311 実行するプロキシの per-user アイデンティティヘッダー311 自分で運用するプロキシ向けのユーザーごとの ID ヘッダー

312</h5>312</h5>

313 313 

314`provider: anthropic` アップストリームの `base_url` を Anthropic API ではなく実行するプロキシに向けることができます。そのプロキシに各リクエストを送信した開発者を伝えるには、そのアップストリームで `forward_user_identity: true` を設定します。プロキシはその後、開発者ごとに支出を帰属させることができます。Claude Code v2.1.233 以降を実行しているゲートウェイが必要です。314`provider: anthropic` アップストリームの `base_url` を、Anthropic API ではなく自分で運用するプロキシに向けることができます。各リクエストをどの開発者が送信したかをそのプロキシに伝えるには、そのアップストリームで `forward_user_identity: true` を設定します。これにより、プロキシは開発者ごとに支出を帰属させることができます。Claude Code v2.1.233 以降を実行しているゲートウェイが必要です。

315 315 

316例えば、`upstream-gateway.internal.example.com` のプロキシの場合:316たとえば、`upstream-gateway.internal.example.com` にあるプロキシの場合は次のようになります。

317 317 

318```yaml theme={null}318```yaml theme={null}

319upstreams:319upstreams:


324 forward_user_identity: true # default false324 forward_user_identity: true # default false

325```325```

326 326 

327ゲートウェイは、そのアップストリームに転送するすべてのリクエストにこれらのヘッダーを追加します。327ゲートウェイは、そのアップストリームに転送するすべてのリクエストに次のヘッダーを追加します。

328 328 

329| ヘッダー | 値 |329| ヘッダー | 値 |

330| - | - |330| - | - |

331| `x-litellm-end-user-id` | IdP が提供した場合、開発者のメール。 |331| `x-litellm-end-user-id` | IdP が提供した場合の、開発者のメールアドレス。 |

332| `x-claude-gateway-user-id` | トークンの `sub` クレームからの開発者の IdP サブジェクト。 |332| `x-claude-gateway-user-id` | トークンの `sub` クレームから取得した、開発者の IdP サブジェクト。 |

333| `x-claude-gateway-user-email` | IdP が提供した場合、開発者のメール。 |333| `x-claude-gateway-user-email` | IdP が提供した場合の、開発者のメールアドレス。 |

334 334 

335IdP トークンがメールを含まない場合、ゲートウェイは `x-claude-gateway-user-id` のみを送信し、2 つのメールヘッダーを省略します。IdP がメールを別のクレームに入れる場合、[`oidc.email_claim`](#oidc) をそのクレームに設定します。335IdP トークンにメールアドレスが含まれない場合、ゲートウェイは `x-claude-gateway-user-id` のみを送信し、2 つのメールヘッダーは省略します。IdP がメールアドレスを別のクレームに格納している場合は、[`oidc.email_claim`](#oidc) をそのクレームに設定してください。

336 336 

337プロキシが開発者のメールを含むリクエストに `429` で応答する場合、ゲートウェイはそのレスポンスを開発者にそのまま返し、次のアップストリームにフェイルオーバーしません。これにより、プロキシのユーザーごとの予算またはレート制限が維持されます。プロキシの他のレスポンスは通常の[フェイルオーバールール](#upstreams)に従います。開発者の IdP トークンがメールを含まない場合、ゲートウェイはメールヘッダーなしでリクエストを転送するため、そのようなリクエストへの `429` はアップストリーム容量としてカウントされ、フェイルオーバーします。ゲートウェイサーバーの v2.1.267 より前では、すべての `429` がフェイルオーバーしました。337開発者のメールアドレスを含むリクエストに対してプロキシが `429` を返した場合、ゲートウェイは次のアップストリームにフェイルオーバーする代わりに、そのレスポンスをそのまま開発者に返すため、プロキシのユーザーごとの予算やレート制限が維持されます。プロキシのその他のレスポンスは、通常の[フェイルオーバールール](#upstreams)に従います。開発者の IdP トークンにメールアドレスが含まれない場合、ゲートウェイはメールヘッダーなしでその開発者のリクエストを転送するため、そうしたリクエストへの `429` はアップストリームの容量としてカウントされ、フェイルオーバーします。ゲートウェイサーバーが v2.1.267 より前の場合は、すべての `429` がフェイルオーバーしていました。

338 338 

339`forward_user_identity` は、`base_url` が運用するプロキシであるアップストリームにのみ設定します。ゲートウェイは開発者メールを、その `base_url` が名前を付けるサーバーに送信します。`base_url` が Anthropic API(デフォルト)の場合、ゲートウェイは起動を拒否します。339`forward_user_identity` は、`base_url` が自分で運用するプロキシであるアップストリームでのみ設定してください。ゲートウェイは、その `base_url` が指すサーバーがどこであっても開発者のメールアドレスを送信します。`base_url` がデフォルトである Anthropic API の場合、ゲートウェイは起動を拒否します。

340 

341<Note>

342 Amazon Bedrock アップストリームで `forward_user_identity` を設定すると、ゲートウェイは起動時に `Unrecognized key(s) in object: 'forward_user_identity'` で終了します。プロキシが Bedrock の前段にある場合は、代わりに `provider: anthropic` アップストリームとして列挙してください。ゲートウェイはそのアップストリームに Anthropic Messages 形式を送信するため、プロキシで [Bedrock 向けにリクエストを変換](/docs/ja/llm-gateway-protocol#format-mismatch-with-the-upstream)する必要があります。代わりに AWS に対して各開発者を識別させるには、[開発者ごとの AWS コスト帰属](#per-developer-aws-cost-attribution)を参照してください。

343</Note>

340 344 

341<h4 id="amazon-bedrock">345<h4 id="amazon-bedrock">

342 Amazon Bedrock346 Amazon Bedrock

343</h4>347</h4>

344 348 

345ゲートウェイが置き換える、または前段に置くクライアント側の Amazon Bedrock デプロイについては、[Claude Code on Amazon Bedrock](/docs/ja/amazon-bedrock) を参照してください。ゲートウェイ側のアップストリーム:349ゲートウェイが置き換える、または前段に置くクライアント側の Amazon Bedrock デプロイについては、[Amazon Bedrock での Claude Code](/docs/ja/amazon-bedrock) を参照してください。ゲートウェイ側のアップストリームは次のとおりです。

346 350 

347```yaml theme={null}351```yaml theme={null}

348upstreams:352upstreams:


361 # base_url: https://bedrock-runtime-fips.us-east-1.amazonaws.com365 # base_url: https://bedrock-runtime-fips.us-east-1.amazonaws.com

362```366```

363 367 

364空の `auth` ブロックは AWS SDK のデフォルト認証情報チェーンを使用します:環境変数、`~/.aws/credentials`、ECS タスクロール、EC2 インスタンスメタデータ、または EKS 上の IRSA。本番環境では、コンテナイメージに静的キーを埋め込む代わりに、ゲートウェイポッドに IAM ロールを与えます。368空の `auth` ブロックは、AWS SDK のデフォルト認証情報チェーン(環境変数、`~/.aws/credentials`、ECS タスクロール、EC2 インスタンスメタデータ、または EKS 上の IRSA)を使用します。本番環境では、コンテナイメージに静的キーを埋め込むのではなく、ゲートウェイ Pod に IAM ロールを付与してください。

365 369 

366明示的な認証情報は完全である必要があります。`aws_access_key_id` と `aws_secret_access_key` が一緒に設定されていない場合、または `aws_session_token` がそれらなしで設定されている場合、ゲートウェイはブート時に失敗します。v2.1.207 より前では、部分的な `auth:` ブロックが検証に合格しました。370明示的な認証情報は完全である必要があります。`aws_access_key_id` と `aws_secret_access_key` が一緒に設定されていない場合、または `aws_session_token` がそれらなしで設定されている場合、ゲートウェイは起動時に失敗します。v2.1.207 より前は、不完全な `auth:` ブロックでも検証を通過していました。

367 371 

368| セットアップ | 方法 |372| セットアップ | 方法 |

369| - | - |373| - | - |

370| IAM 権限 | ゲートウェイのプリンシパルに `bedrock:InvokeModel` と `bedrock:InvokeModelWithResponseStream` を推論プロファイル ARN と基礎モデル ARN の両方に付与します。US リージョンの組み込みカタログの場合:`arn:aws:bedrock:<region>:<account>:inference-profile/us.anthropic.*` と `arn:aws:bedrock:*::foundation-model/anthropic.*`。また、基礎モデル ARN に `bedrock:CountTokens` を付与します。ゲートウェイはこれを無料で使用して、クライアントが放棄したリクエストの入力トークンをカウントし、[支出制限](#admin)を正確に保ちます。これがない場合、ゲートウェイはそのカウントのために 1 トークンの Bedrock リクエストにフォールバックします。 |374| IAM 権限 | ゲートウェイのプリンシパルに、推論プロファイル ARN と基盤となる基盤モデル ARN の両方に対する `bedrock:InvokeModel` と `bedrock:InvokeModelWithResponseStream` を付与します。US リージョンの組み込みカタログの場合は `arn:aws:bedrock:<region>:<account>:inference-profile/us.anthropic.*` と `arn:aws:bedrock:*::foundation-model/anthropic.*` です。また、基盤モデル ARN に対する `bedrock:CountTokens` も付与してください。ゲートウェイはこれを使用して、クライアントが中断したリクエストの入力トークン数を無料でカウントし、[支出制限](#admin)を正確に保ちます。これがない場合、ゲートウェイはそのカウントのために 1 トークンの Bedrock リクエストにフォールバックします。 |

371| モデルアクセス | Amazon Bedrock はデフォルトで商用リージョンでモデルアクセスを有効にします。残りのアカウントレベルのゲートは Anthropic のワンタイムユースケースフォームです。AWS アカウント内の誰もそれを送信していない場合、Amazon Bedrock コンソールを開き、モデルカタログから Anthropic モデルを選択し、フォームを完成させます。AWS Organizations フォームと送信者が必要な権限については、[ユースケース詳細を送信](/docs/ja/amazon-bedrock#1-submit-use-case-details)を参照してください。 |375| モデルアクセス | Amazon Bedrock は、商用リージョンではデフォルトでモデルアクセスを有効にしています。残るアカウントレベルの関門は、Anthropic の 1 回限りのユースケースフォームです。AWS アカウント内の誰もまだ送信していない場合は、Amazon Bedrock コンソールを開き、Model catalog から Anthropic モデルを選択してフォームに記入してください。AWS Organizations 用のフォームと送信者に必要な権限については、[ユースケースの詳細を送信する](/docs/ja/amazon-bedrock#1-submit-use-case-details)を参照してください。 |

372| EKS(IRSA) | 上記のポリシーと、ゲートウェイのサービスアカウントにスコープされたクラスターの OIDC プロバイダー用の信頼ポリシーを持つ IAM ロールを作成します。サービスアカウントに `eks.amazonaws.com/role-arn: arn:aws:iam::<acct>:role/claude-gateway` で注釈を付けます。`auth: {}` がそれを取得します。 |376| EKS(IRSA) | 上記のポリシーと、ゲートウェイのサービスアカウントにスコープを限定した、クラスターの OIDC プロバイダー用の信頼ポリシーを持つ IAM ロールを作成します。サービスアカウントに `eks.amazonaws.com/role-arn: arn:aws:iam::<acct>:role/claude-gateway` のアノテーションを付けます。`auth: {}` がそれを取得します。 |

373| ECS / EC2 | IAM ロールをタスク定義またはインスタンスプロファイルにアタッチします。`auth: {}` がそれを取得します。 |377| ECS / EC2 | IAM ロールをタスク定義またはインスタンスプロファイルにアタッチします。`auth: {}` がそれを取得します。 |

374| その他の場所 | `AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、および `AWS_SESSION_TOKEN` 環境変数を通じて認証情報を渡すか、`${VAR}` 展開で `auth:` に明示的に設定します |378| その他の環境 | `AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、`AWS_SESSION_TOKEN` 環境変数で認証情報を渡すか、`${VAR}` 展開を使用して `auth:` で明示的に設定します |

375| リージョン | `region:` は API エンドポイントリージョンです。クロスリージョン推論プロファイルは、どれを選択するかに関わらず、地理(US、EU、APAC)全体でルーティングします。US 以外のリージョンまたはプロビジョニングされたスループット ARN の場合、正しい per-upstream ID を持つ [`models:`](#models) ブロックを追加します。 |379| リージョン | `region:` は API エンドポイントのリージョンです。クロスリージョン推論プロファイルは、どのリージョンを選んでも地域(US、EU、APAC)内でルーティングされます。US 以外のリージョンやプロビジョンドスループットの ARN の場合は、アップストリームごとの正しい ID を含む [`models:`](#models) ブロックを追加してください。 |

376 380 

377<a id="apply-an-amazon-bedrock-guardrail" />381<a id="apply-an-amazon-bedrock-guardrail" />

378 382 

379<h5 id="apply-an-amazon-bedrock-guardrail">383<h5 id="apply-an-amazon-bedrock-guardrail">

380 Amazon Bedrock ガードレールを適用384 Amazon Bedrock ガードレールを適用する

381</h5>385</h5>

382 386 

383ゲートウェイが Bedrock アップストリームを通じて送信するすべての推論リクエストに Amazon Bedrock ガードレールを適用するには、そのアップストリームに `guardrail` ブロックを追加します。ゲートウェイサーバーで Claude Code v2.1.281 以降が必要です。387ゲートウェイが Bedrock アップストリーム経由で送信するすべての推論リクエストに Amazon Bedrock ガードレールを適用するには、そのアップストリームに `guardrail` ブロックを追加します。ゲートウェイサーバーで Claude Code v2.1.281 以降が必要です。

384 388 

385```yaml theme={null}389```yaml theme={null}

386upstreams:390upstreams:


394```398```

395 399 

396<Warning>400<Warning>

397 ゲートウェイはガードレール入力タグをサポートしていません。プロンプトにガードコンテンツタグを追加しないため、Amazon Bedrock がタグ付き入力にのみ適用するガードレールフィルターはゲートウェイを通じたトラフィックで実行されません。入力タグに依存するフィルターについては、Amazon Bedrock ドキュメントの[入力タグ](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-tagging.html)を参照してください。401 ゲートウェイはガードレールの入力タグをサポートしていません。プロンプトにガードコンテンツタグを追加しないため、Amazon Bedrock がタグ付きの入力にのみ適用するガードレールフィルターは、ゲートウェイを経由するトラフィックでは実行されません。どのフィルターが入力タグに依存するかについては、Amazon Bedrock ドキュメントの[入力タグ](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-tagging.html)を参照してください。

398</Warning>402</Warning>

399 403 

400また、このアップストリームのリクエストに署名するプリンシパル(ゲートウェイの AWS プリンシパル、または [`assume_role`](#bedrock-in-another-aws-account) を使用する場合は `role_arn` で指定したロール)に、そのガードレールに対する `bedrock:ApplyGuardrail` を付与します。404また、このアップストリームのリクエストに署名するプリンシパル(ゲートウェイの AWS プリンシパル、または [`assume_role`](#bedrock-in-another-aws-account) を使用する場合は `role_arn` で指定したロール)に、ガードレールに対する `bedrock:ApplyGuardrail` を付与してください。

401 405 

402すべての `bedrock` アップストリームで `guardrail` を設定するか、どれにも設定しないでください。ゲートウェイは混在した設定では起動を拒否します。そうしないと、[フェイルオーバー](#multiple-upstreams)によってリクエストがガードレールのない Bedrock アップストリームに送信される可能性があるためです。406`guardrail` は、すべての `bedrock` アップストリームに設定するか、どれにも設定しないかのいずれかにしてください。混在していると、[フェイルオーバー](#multiple-upstreams)によってガードレールのない Bedrock アップストリームにリクエストが送信される可能性があるため、ゲートウェイは起動を拒否します。

403 407 

404ガードレールは Bedrock アップストリームのみをカバーします。`upstreams` に別のプロバイダーをリストする場合、ゲートウェイはガードレールなしでそのプロバイダーにリクエストを送信します。ただし、そのプロバイダーが [`mantle`](#amazon-bedrock-mantle-endpoint) の場合は起動を拒否します。408ガードレールは Bedrock アップストリームのみを対象とします。`upstreams` に別のプロバイダーを列挙した場合、ゲートウェイはそのプロバイダーにガードレールなしでリクエストを送信します。そのプロバイダーが [`mantle`](#amazon-bedrock-mantle-endpoint) の場合は起動を拒否します。

405 409 

406本体に `amazon-bedrock-guardrailConfig` などの `amazon-bedrock-*` フィールドを含む `/v1/messages` リクエストが、`guardrail` が設定された Bedrock アップストリームに到達すると、ゲートウェイはそれを転送せずに 400 で応答します。410`amazon-bedrock-guardrailConfig` などの `amazon-bedrock-*` フィールドを本文に含む `/v1/messages` リクエストが、`guardrail` が設定された Bedrock アップストリームに到達した場合、ゲートウェイはそれを転送せずに 400 を返します。

407 411 

408<a id="bedrock-in-another-aws-account" />412<a id="bedrock-in-another-aws-account" />

409 413 


411 別の AWS アカウントの Bedrock415 別の AWS アカウントの Bedrock

412</h5>416</h5>

413 417 

414Bedrock アップストリームで `assume_role` を設定すると、ゲートウェイは独自の AWS アイデンティティを、指定したロールに対して `sts:AssumeRole` を呼び出すためだけに使用します。このロールはゲートウェイとは別の AWS アカウントにあってもかまいません。そのアップストリームからのすべての Bedrock リクエストは、STS が返す 1 時間有効の認証情報で署名されるため、長期アクセスキーがアカウント間を行き来することはありません。418Bedrock アップストリームで `assume_role` を設定すると、ゲートウェイは自身の AWS ID を、指定したロールに対する `sts:AssumeRole` の呼び出しにのみ使用します。このロールはゲートウェイとは別の AWS アカウントにあってもかまいません。そのアップストリームからのすべての Bedrock リクエストは STS が返す 1 時間有効な認証情報で署名されるため、長期間有効なアクセスキーがアカウントをまたぐことはありません。

415 419 

416Claude Code v2.1.281 以降を実行しているゲートウェイが必要です。以前のゲートウェイはキーを見つけたときに起動を拒否します。420Claude Code v2.1.281 以降を実行しているゲートウェイが必要です。それより前のゲートウェイは、このキーを見つけると起動を拒否します。

417 421 

418```yaml theme={null}422```yaml theme={null}

419upstreams:423upstreams:


426 # external_id: ${BEDROCK_ROLE_EXTERNAL_ID} # when the role's trust policy requires one430 # external_id: ${BEDROCK_ROLE_EXTERNAL_ID} # when the role's trust policy requires one

427```431```

428 432 

429`assume_role` ブロックは 3 つのキーを取ります:433`assume_role` ブロックは 3 つのキーを取ります。

430 434 

431| キー | 意味 |435| キー | 意味 |

432| - | - |436| - | - |

433| `role_arn` | ゲートウェイが引き受ける IAM ロール。`arn:aws:iam::` または `arn:aws-us-gov:iam::` ARN として指定します。このアップストリームが必要とする [Bedrock 権限](#amazon-bedrock)(`bedrock:CountTokens` を含む)と、アップストリームが `guardrail` を設定する場合は `bedrock:ApplyGuardrail` を与えます。 |437| `role_arn` | ゲートウェイが引き受ける IAM ロール。`arn:aws:iam::` または `arn:aws-us-gov:iam::` の ARN で指定します。このアップストリームに必要な [Bedrock の権限](#amazon-bedrock)(`bedrock:CountTokens` を含む)に加え、アップストリームで `guardrail` を設定する場合は `bedrock:ApplyGuardrail` を付与してください。 |

434| `external_id` | オプション。すべての `sts:AssumeRole` 呼び出しで外部 ID として送信されます。ロールの信頼ポリシーが外部 ID を必要とする場合に設定し、数字のみの場合は引用符で囲みます。 |438| `external_id` | 省略可能。すべての `sts:AssumeRole` 呼び出しで外部 ID として送信されます。ロールの信頼ポリシーで必要な場合に設定し、すべて数字の場合は引用符で囲んでください。 |

435| `session_name` | オプション。`email` または `sub` は各開発者に独自のセッションを与えます。[Per-developer AWS コスト属性](#per-developer-aws-cost-attribution)を参照してください。設定されていない場合、すべてのリクエストは `claude-apps-gateway` という名前の 1 つのセッションを使用します。 |439| `session_name` | 省略可能。`email` または `sub` を指定すると、開発者ごとに個別のセッションが作られます。[開発者ごとの AWS コスト帰属](#per-developer-aws-cost-attribution)を参照してください。未設定の場合、すべてのリクエストで `claude-apps-gateway` という名前の 1 つのセッションが使用されます。 |

436 440 

437ロールの信頼ポリシーはゲートウェイ独自のプリンシパル(IRSA または ECS タスクロールなど)に名前を付けます。そのプリンシパルはロールに対する `sts:AssumeRole` が必要で、自身の Bedrock 権限は不要です。`external_id` を設定しない場合は `Condition` を削除します。441ロールの信頼ポリシーでは、IRSA や ECS タスクロールなど、ゲートウェイ自身のプリンシパルを指定します。そのプリンシパルにはロールに対する `sts:AssumeRole` が必要で、それ自体に Bedrock の権限は不要です。`external_id` を設定しない場合は `Condition` を削除してください。

438 442 

439```json theme={null}443```json theme={null}

440{444{


448}452}

449```453```

450 454 

451* STS が拒否または到達不可の場合、ゲートウェイはアップストリーム独自の認証情報でリクエストを送信しません。STS エラーを確認すべき点とともにログに記録してから、リストした次のアップストリームを試みます。[アップストリームエラーメッセージ](#upstream-error-messages)は、どのアップストリームも成功しない場合にクライアントが受け取るものをカバーしています。`assume_role` のない後のアップストリームはそれ独自の認証情報でリクエストを処理するため、それが望む動作である場合のみリストしてください。455* STS が拒否した場合や到達できない場合、ゲートウェイはアップストリーム自身の認証情報でリクエストを送信しません。確認すべき点とともに STS エラーをログに記録し、列挙した次のアップストリームを試行します。どのアップストリームも成功しなかった場合にクライアントが受け取る内容については、[アップストリームのエラーメッセージ](#upstream-error-messages)で説明しています。`assume_role` のない後続のアップストリームは自身の認証情報でリクエストを処理するため、それを意図する場合にのみ列挙してください。

452* ゲートウェイはリージョンの STS エンドポイント `sts.<region>.amazonaws.com` を呼び出すため、ネットワークはそれに到達できる必要があります。FIPS エンドポイントの場合、AWS 設定ファイルの `use_fips_endpoint` ではなく、ゲートウェイの環境で `AWS_USE_FIPS_ENDPOINT=true` を設定します。456* ゲートウェイはリージョンの STS エンドポイント `sts.<region>.amazonaws.com` を呼び出すため、ゲートウェイのネットワークからそこに到達できる必要があります。FIPS エンドポイントを使用するには、AWS 設定ファイルの `use_fips_endpoint` ではなく、ゲートウェイの環境で `AWS_USE_FIPS_ENDPOINT=true` を設定してください。

453* `assume_role` は `provider: bedrock` にのみ適用され、SigV4 ソース認証情報が必要です。ゲートウェイは `aws_bearer_token` と一緒に設定されている場合、起動を拒否します。457* `assume_role` は `provider: bedrock` にのみ適用され、SigV4 のソース認証情報が必要です。`aws_bearer_token` と並べて設定すると、ゲートウェイは起動を拒否します。

454* ゲートウェイが許可するすべての開発者はこのアップストリームを使用できます。[`managed`](#managed) はどの開発者がどのモデルを使用できるかを制御します。ロールを通じて提供されるモデルが別のアカウントからも提供されるのを防ぐには、`upstream_model` マップにこのアップストリームの名前のみを持つカスタム id をそのモデルに与えます。そのような id の場合、ゲートウェイは他のすべてのアップストリームをスキップするため、リクエストも、中断されたリクエストのトークンカウントも、別のアカウントにフェイルオーバーすることはありません。組み込みモデル名へのリクエストは引き続き[このアップストリームに到達する](#multiple-upstreams)可能性があり、ゲートウェイはそれを同じロールで署名します。このアカウントでもそれらのモデルを提供する場合を除き、このアップストリームを最後にリストしてください。458* ゲートウェイが受け入れたすべての開発者がこのアップストリームを使用できます。どの開発者がどのモデルを使用できるかは [`managed`](#managed) で制御します。ロール経由で提供されるモデルが別のアカウントからも提供されないようにするには、`upstream_model` マップにこのアップストリームの名前だけを持つカスタム id をそのモデルに付与してください。そのような id については、ゲートウェイは他のすべてのアップストリームをスキップするため、リクエストも中断されたリクエストのトークンカウントも別のアカウントにフェイルオーバーすることはありません。組み込みのモデル名に対するリクエストは引き続き[このアップストリームに到達する](#multiple-upstreams)可能性があり、ゲートウェイはそれを同じロールで署名します。このアカウントでそれらのモデルも提供すべき場合を除き、このアップストリームは最後に列挙してください。

455 459 

456この例は、分離されたアップストリームのみが提供するカスタム id を 1 つのモデルに与えます:460次の例では、分離されたアップストリームのみが提供するカスタム id を 1 つのモデルに付与しています。

457 461 

458```yaml theme={null}462```yaml theme={null}

459models:463models:


465<a id="per-developer-aws-cost-attribution" />469<a id="per-developer-aws-cost-attribution" />

466 470 

467<h5 id="per-developer-aws-cost-attribution">471<h5 id="per-developer-aws-cost-attribution">

468 Per-developer AWS コスト属性472 開発者ごとの AWS コスト帰属

469</h5>473</h5>

470 474 

471デフォルトでは、ゲートウェイはすべての Bedrock リクエストに 1 つの認証情報で署名するため、AWS はすべての開発者のリクエストを単一の IAM プリンシパルの下で見ます。[`assume_role`](#bedrock-in-another-aws-account) に `session_name: email` を追加すると、ゲートウェイは開発者ごとに 1 時間に 1 回 `sts:AssumeRole` を呼び出し、セッション名をその開発者のメールに設定し、返された認証情報でリクエストに署名するため、各開発者のリクエストは独自の引き受けたロールセッションの下で AWS に到達します。ロールはゲートウェイ独自のアカウントにあってもかまいません。475デフォルトでは、ゲートウェイはすべての Bedrock リクエストに 1 つの認証情報で署名するため、AWS からはすべての開発者のリクエストが単一の IAM プリンシパルによるものに見えます。[`assume_role`](#bedrock-in-another-aws-account) に `session_name: email` を追加すると、ゲートウェイは開発者ごとに 1 時間に 1 回、セッション名をその開発者のメールアドレスに設定して `sts:AssumeRole` を呼び出し、返された認証情報でその開発者のリクエストに署名します。これにより、各開発者のリクエストは、その開発者自身の引き受けたロールのセッションで AWS に届きます。ロールはゲートウェイ自身のアカウントにあってもかまいません。

472 476 

473Claude Code v2.1.281 以降を実行しているゲートウェイが必要です。[AWS でのコスト属性](/docs/ja/claude-apps-gateway-on-aws#cost-attribution)は IAM ロールと AWS 請求がセッションを表示する場所をカバーしています。477Claude Code v2.1.281 以降を実行しているゲートウェイが必要です。[AWS でのコスト帰属](/docs/ja/claude-apps-gateway-on-aws#cost-attribution)では、IAM ロールと、AWS の請求でセッションがどこに表示されるかを説明しています。

474 478 

475```yaml theme={null}479```yaml theme={null}

476upstreams:480upstreams:


482 session_name: email # or sub486 session_name: email # or sub

483```487```

484 488 

485`session_name` は、どの検証済みクレームが AWS `RoleSessionName` になるかを選択します:`email` または `sub`。ゲートウェイは ASCII 文字、数字、および `_+,.@-` 以外の任意の文字を UTF-8 バイトごとに `=XX` 16 進数として書き込み、64 文字より長い結果をプレフィックスとハッシュに短縮するため、各開発者のセッション名は有効で一意のままです。トークンがクレームを欠いている開発者からのリクエストはこのアップストリームを通じて送信されず、オペレーターログは `sub` に切り替えるか [`oidc.email_claim`](#oidc) を設定するよう指示します。489`session_name` は、どの検証済みクレームを AWS の `RoleSessionName` にするかを選択します(`email` または `sub`)。ゲートウェイは、ASCII の英字、数字、`_+,.@-` 以外の文字を UTF-8 の 1 バイトごとに `=XX` の 16 進数として書き込み、64 文字を超える結果はプレフィックスとハッシュに短縮するため、各開発者のセッション名は有効かつ一意に保たれます。トークンにそのクレームがない開発者からのリクエストはこのアップストリームを経由して送信されず、オペレーターログには `sub` に切り替えるか [`oidc.email_claim`](#oidc) を設定するよう記録されます。

486 490 

487アクティブな開発者 1 人あたり、ゲートウェイレプリカごとに 1 時間に 1 回の STS 呼び出しが発生します。同時に発生した最初のリクエストは 1 回の呼び出しを共有します。491アクティブな開発者 1 人につき、ゲートウェイのレプリカごとに 1 時間あたり 1 回の STS 呼び出しが発生し、同時に発生した最初のリクエストは 1 回の呼び出しを共有します。

488 492 

489ゲートウェイはこのロールで独自の呼び出しも 1 つ行います。[支出制限](/docs/ja/claude-apps-gateway-spend-limits)を正確に保つための、クライアントが放棄したリクエストのトークンカウントです。そのカウントとその[1 トークンフォールバックリクエスト](#amazon-bedrock)は共有の `claude-apps-gateway` セッションで署名されるため、AWS はフォールバックを開発者ではなく `claude-apps-gateway` に帰属させます。493ゲートウェイは、このロールで独自の呼び出しも 1 つ行います。[支出制限](/docs/ja/claude-apps-gateway-spend-limits)を正確に保つための、クライアントが中断したリクエストのトークンカウントです。そのカウントとその [1 トークンのフォールバックリクエスト](#amazon-bedrock)は共有の `claude-apps-gateway` セッションで署名されるため、AWS はフォールバックを開発者ではなく `claude-apps-gateway` に帰属させます。

490 494 

491厳密な per-developer 属性の場合、リストするすべての Bedrock アップストリームで `assume_role` を `session_name` とともに設定します。それがないアップストリームは、処理するリクエストに独自の認証情報で署名します。495厳密な開発者ごとの帰属を行うには、列挙するすべての Bedrock アップストリームで `session_name` 付きの `assume_role` を設定してください。これがないアップストリームは、処理するリクエストに自身の認証情報で署名します。

492 496 

493<h4 id="amazon-bedrock-mantle-endpoint">497<h4 id="amazon-bedrock-mantle-endpoint">

494 Amazon Bedrock Mantle エンドポイント498 Amazon Bedrock Mantle エンドポイント

495</h4>499</h4>

496 500 

497`mantle` プロバイダーは、推論を Amazon Bedrock の [Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)に送信します。ゲートウェイサーバーで Claude Code v2.1.283 以降が必要です。それより前のゲートウェイリリースはブート時にこれを拒否するため、追加する前にすべてのレプリカをアップグレードしてください。501`mantle` プロバイダーは、Amazon Bedrock の [Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)に推論を送信します。ゲートウェイサーバーで Claude Code v2.1.283 以降が必要です。それより前のゲートウェイリリースは起動時にこれを拒否するため、追加する前にすべてのレプリカをアップグレードしてください。

498 502 

499以下の例では Mantle を最初に置き、その後ろに Amazon Bedrock アップストリームを置いて、`models` フィールドに含まれないすべてのモデルを提供させます:503次の例では Mantle を最初に置き、`models` フィールドで除外されたすべてのモデルを提供するために、その後ろに Amazon Bedrock アップストリームを置いています。

500 504 

501```yaml theme={null}505```yaml theme={null}

502upstreams:506upstreams:


509 auth: {}513 auth: {}

510```514```

511 515 

512以下の表は、`mantle` アップストリーム固有のフィールドを示しています。516次の表は、`mantle` アップストリームに固有のフィールドを示しています。

513 517 

514| フィールド | 必須 | 説明 |518| フィールド | 必須 | 説明 |

515| - | - | - |519| - | - | - |

516| `region` | はい | AWS リージョン。ゲートウェイはここからエンドポイントを `https://bedrock-mantle.<region>.api.aws/anthropic` として導出します。 |520| `region` | はい | AWS リージョン。ゲートウェイはこれからエンドポイントを `https://bedrock-mantle.<region>.api.aws/anthropic` として導出します。 |

517| `models` | はい | Mantle で AWS アカウントに付与されているモデル。`claude-haiku-4-5` のように、クライアントが送信する名前で指定します。これらのモデルのみがこのアップストリームに送られ、それ以外のモデルは次のアップストリームにスキップされます。 |521| `models` | はい | AWS アカウントに Mantle で付与されているモデル。`claude-haiku-4-5` のように、クライアントが送信する名前で指定します。これらのモデルのみがこのアップストリームに送信され、その他のモデルはすべて次のアップストリームにスキップされます。 |

518| `auth` | いいえ | [Amazon Bedrock](#amazon-bedrock) アップストリームの `auth` ブロックと同じキーを、同じルールで受け付けます。 |522| `auth` | いいえ | [Amazon Bedrock](#amazon-bedrock) アップストリームの `auth` ブロックと同じキーを、同じルールで受け付けます。 |

519| `base_url` | いいえ | 導出されたエンドポイントを上書きします。末尾の `/anthropic` パスは残してください。 |523| `base_url` | いいえ | 導出されたエンドポイントを上書きします。末尾の `/anthropic` パスは残してください。 |

520 524 

521アップストリームの AWS アイデンティティに、推論とトークンカウント用の Mantle 独自の IAM アクションを付与します。これらは [Mantle エンドポイントを使用する](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)に記載されています。525アップストリームの AWS ID に、推論とトークンカウント用の Mantle 独自の IAM アクションを付与してください。これらは [Mantle エンドポイントを使用する](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)に記載されています。

522 526 

523ゲートウェイが認識しない Mantle モデル ID の場合は、最上位の [`models:`](#models) ブロックに、`upstream_model` がこのアップストリームの名前をその ID にマップするエントリを追加します。次に、そのエントリの `id` をこのアップストリームの `models` フィールドにも追加します。527ゲートウェイが認識しない Mantle モデル ID の場合は、トップレベルの [`models:`](#models) ブロックに、`upstream_model` でこのアップストリームの名前をその ID にマッピングするエントリを追加します。その後、そのエントリの `id` をこのアップストリームの `models` フィールドにも追加してください。

524 528 

525`bedrock` アップストリームの `guardrail` と `assume_role` の設定は、Mantle が処理するリクエストには適用されません:529`bedrock` アップストリームの `guardrail` と `assume_role` の設定は、Mantle が処理するリクエストには適用されません。

526 530 

527* **`guardrail`**:ゲートウェイは Mantle に送信するリクエストに [Bedrock ガードレール](#apply-an-amazon-bedrock-guardrail)を適用しないため、いずれかの `bedrock` アップストリームが `guardrail` を設定している状態で `mantle` アップストリームがリストされていると、起動を拒否します。531* **`guardrail`**: ゲートウェイは Mantle に送信するリクエストに [Bedrock ガードレール](#apply-an-amazon-bedrock-guardrail)を適用しないため、いずれかの `bedrock` アップストリームで `guardrail` が設定されている状態で `mantle` アップストリームが列挙されていると、起動を拒否します。

528* **`assume_role`**:`mantle` アップストリームは [`assume_role`](#bedrock-in-another-aws-account) を受け付けません。Mantle が処理するリクエストは `mantle` アップストリーム自身の `auth` 認証情報で送信され、[開発者ごとに帰属](#per-developer-aws-cost-attribution)されません。532* **`assume_role`**: `mantle` アップストリームは [`assume_role`](#bedrock-in-another-aws-account) を受け付けません。Mantle が処理するリクエストは `mantle` アップストリーム自身の `auth` 認証情報で送信され、[開発者ごとに帰属](#per-developer-aws-cost-attribution)されません。

529 533 

530Mantle 独自のエラーレスポンスの意味については、[Mantle エンドポイントのエラー](/docs/ja/amazon-bedrock#mantle-endpoint-errors)を参照してください。534Mantle 自身のエラーレスポンスの意味については、[Mantle エンドポイントのエラー](/docs/ja/amazon-bedrock#mantle-endpoint-errors)を参照してください。

531 535 

532<h4 id="claude-platform-on-aws">536<h4 id="claude-platform-on-aws">

533 Claude Platform on AWS537 Claude Platform on AWS

534</h4>538</h4>

535 539 

536Claude Platform on AWS は、`aws-external-anthropic.<region>.api.aws` で AWS インフラストラクチャ上のファーストパーティ Anthropic API を提供します。ファーストパーティのモデル ID を使用し、`anthropic-beta` ヘッダーを送信されたとおりに尊重し、`count_tokens` を提供するため、Bedrock 固有の変換は適用されません。`anthropicAws` プロバイダーには Claude Code v2.1.198 以降が必要です。以前のゲートウェイリリースはブート時にそれを拒否します。540Claude Platform on AWS は、AWS インフラストラクチャ上の `aws-external-anthropic.<region>.api.aws` でファーストパーティの Anthropic API を提供します。ファーストパーティのモデル ID を使用し、`anthropic-beta` ヘッダーを送信されたとおりに尊重し、`count_tokens` を提供するため、Bedrock 固有の変換は一切適用されません。`anthropicAws` プロバイダーには Claude Code v2.1.198 以降が必要です。それより前のゲートウェイリリースは起動時にこれを拒否します。

537 541 

538同じプラットフォームのクライアント側デプロイについては、[Claude Code on Claude Platform on AWS](/docs/ja/claude-platform-on-aws) を参照してください。ゲートウェイ側のアップストリーム:542同じプラットフォームのクライアント側のデプロイについては、[Claude Platform on AWS での Claude Code](/docs/ja/claude-platform-on-aws) を参照してください。ゲートウェイ側のアップストリームは次のとおりです。

539 543 

540```yaml theme={null}544```yaml theme={null}

541upstreams:545upstreams:


554 # base_url: https://aws-external-anthropic.us-east-1.api.aws558 # base_url: https://aws-external-anthropic.us-east-1.api.aws

555```559```

556 560 

557このプラットフォームは Amazon Bedrock とは別の AWS アカウントで実行され、独自のサービス名 `aws-external-anthropic` で SigV4 リクエストに署名するため、Bedrock スコープの IAM ロールではそれを認可できません。`auth.api_key` の API キーは、SigV4 認証情報も設定されている場合に優先されます。空の `auth` ブロックは AWS SDK のデフォルト認証情報チェーンを使用します。これは [Amazon Bedrock](#amazon-bedrock) アップストリームが使用するのと同じチェーンです。561このプラットフォームは Amazon Bedrock とは別の AWS アカウントで実行され、自身のサービス名 `aws-external-anthropic` で SigV4 リクエストに署名するため、Bedrock にスコープされた IAM ロールでは認可されません。SigV4 の認証情報も設定されている場合は、`auth.api_key` の API キーが優先されます。空の `auth` ブロックは、[Amazon Bedrock](#amazon-bedrock) アップストリームと同じ、AWS SDK のデフォルト認証情報チェーンを使用します。

558 562 

559| フィールド | 必須 | 説明 |563| フィールド | 必須 | 説明 |

560| - | - | - |564| - | - | - |

561| `region` | はい | AWS リージョン。小文字、数字、およびハイフン。ゲートウェイはそれからエンドポイントを `https://aws-external-anthropic.<region>.api.aws` として導出します。 |565| `region` | はい | AWS リージョン(小文字の英字、数字、ハイフン)。ゲートウェイはこれからエンドポイントを `https://aws-external-anthropic.<region>.api.aws` として導出します。 |

562| `workspace_id` | はい | すべてのリクエストでヘッダーとして送信されます。プラットフォームはそれを必要とします |566| `workspace_id` | はい | すべてのリクエストでヘッダーとして送信されます。プラットフォームで必須です |

563| `auth.api_key` | いいえ | プラットフォームの API キー。`x-api-key` として送信されます。ベアラートークンではありません。2 つの認証モードは API キーまたは SigV4 です。 |567| `auth.api_key` | いいえ | プラットフォーム用の API キーで、`x-api-key` として送信されます。ベアラートークンではありません。2 つの認証モードは API キーまたは SigV4 です。 |

564| `auth.aws_access_key_id` / `auth.aws_secret_access_key` | いいえ | 明示的な SigV4 認証情報。一方を他方なしで設定するとブート時に失敗します。`auth.aws_session_token` はそれらと一緒に受け入れられます。 |568| `auth.aws_access_key_id` / `auth.aws_secret_access_key` | いいえ | 明示的な SigV4 認証情報。一方だけを設定すると起動時に失敗します。`auth.aws_session_token` もあわせて受け付けます。 |

565| `base_url` | いいえ | 導出されたエンドポイントを上書き |569| `base_url` | いいえ | 導出されたエンドポイントを上書きします |

566 570 

567プラットフォームはファーストパーティのモデル ID を解決するため、組み込みカタログは [`models:`](#models) ブロックなしでそれにルーティングします。`models:` リストをキュレートする場合、エントリのキーを `anthropicAws:` とし、ファーストパーティの ID を指定します。571このプラットフォームはファーストパーティのモデル ID を解決するため、組み込みカタログは [`models:`](#models) ブロックなしでこのプラットフォームにルーティングされます。`models:` リストを独自に作成する場合は、エントリのキーを `anthropicAws:` にしてファーストパーティの ID を指定してください。

568 572 

569<h4 id="google-cloud-agent-platform">573<h4 id="google-cloud-agent-platform">

570 Google Cloud Agent Platform574 Google Cloud Agent Platform

571</h4>575</h4>

572 576 

573同等のクライアント側セットアップについては、[Claude Code on Google Cloud](/docs/ja/google-vertex-ai) を参照してください。ゲートウェイ側のアップストリーム:577同等のクライアント側のセットアップについては、[Google Cloud での Claude Code](/docs/ja/google-vertex-ai) を参照してください。ゲートウェイ側のアップストリームは次のとおりです。

574 578 

575```yaml theme={null}579```yaml theme={null}

576upstreams:580upstreams:


584 # base_url: https://us-east5-aiplatform.p.googleapis.com588 # base_url: https://us-east5-aiplatform.p.googleapis.com

585```589```

586 590 

587空の `auth` ブロックは Application Default Credentials を使用します:`GOOGLE_APPLICATION_CREDENTIALS`、GCE メタデータ、または GKE Workload Identity。サービスアカウント JSON キーファイルはサポートされていますが、推奨されません。Workload Identity を使用するか、GCE または Cloud Run インスタンスにサービスアカウントをアタッチします。591空の `auth` ブロックは、Application Default Credentials(`GOOGLE_APPLICATION_CREDENTIALS`、GCE メタデータ、または GKE Workload Identity)を使用します。サービスアカウントの JSON キーファイルもサポートされていますが推奨されません。Workload Identity を使用するか、GCE または Cloud Run インスタンスにサービスアカウントをアタッチしてください。

588 592 

589リージョンエンドポイントの代わりに [Google Cloud の Agent Platform のグローバルエンドポイント](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations)を使用するには、`region: global` を設定します。Google が各リクエストを利用可能なリージョンにルーティングするため、リージョンごとのモデル可用性を追跡する必要がありません。特定のリージョンを設定すると、すべてのリクエストがそのリージョンに固定されます。593リージョンのエンドポイントではなく [Google Cloud の Agent Platform のグローバルエンドポイント](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations)を使用するには、`region: global` を設定します。その場合、Google が各リクエストを利用可能なリージョンにルーティングするため、リージョンごとのモデルの提供状況を追跡する必要はありません。特定のリージョンを設定すると、すべてのリクエストがそのリージョンに固定されます。

590 594 

591| セットアップ | 方法 |595| セットアップ | 方法 |

592| - | - |596| - | - |

593| IAM 権限 | ゲートウェイのサービスアカウントにプロジェクトで `roles/aiplatform.user`、または `aiplatform.endpoints.predict` を持つカスタムロールを付与します。Google Cloud の Agent Platform API(`aiplatform.googleapis.com`)を有効にします。 |597| IAM 権限 | ゲートウェイのサービスアカウントに、プロジェクトに対する `roles/aiplatform.user`、または `aiplatform.endpoints.predict` を含むカスタムロールを付与します。Google Cloud の Agent Platform API(`aiplatform.googleapis.com`)を有効にしてください。 |

594| モデルアクセス | Model Garden で、プロジェクトの Claude モデルを有効にします。モデルは特定のリージョンに公開されます。サポートされているリージョンについてはモデルカードを確認してください。 |598| モデルアクセス | Model Garden で、プロジェクトの Claude モデルを有効にします。モデルは特定のリージョンで公開されるため、サポートされているリージョンはモデルカードで確認してください。 |

595| GKE(Workload Identity) | GCP サービスアカウントをゲートウェイの Kubernetes サービスアカウントにバインドし、KSA に `iam.gke.io/gcp-service-account: claude-gateway@<proj>.iam.gserviceaccount.com` で注釈を付けます。`auth: {}` がそれを取得します。 |599| GKE(Workload Identity) | GCP サービスアカウントをゲートウェイの Kubernetes サービスアカウントにバインドし、KSA に `iam.gke.io/gcp-service-account: claude-gateway@<proj>.iam.gserviceaccount.com` のアノテーションを付けます。`auth: {}` がそれを取得します。 |

596| Cloud Run / GCE | サービスのサービスアカウントを `roles/aiplatform.user` を持つものに設定します。`auth: {}` がそれを取得します。 |600| Cloud Run / GCE | サービスのサービスアカウントを、`roles/aiplatform.user` を持つものに設定します。`auth: {}` がそれを取得します。 |

597| その他の場所 | `auth: { service_account_json: /secrets/sa.json }`。シークレットとしてマウントされた JSON キーファイルへのパスです。このフィールドはキーの内容ではなくファイルパスを取るため、`${file:…}` 展開は関係ありません。 |601| その他の環境 | `auth: { service_account_json: /secrets/sa.json }`。シークレットとしてマウントされた JSON キーファイルへのパスです。このフィールドはキーの内容ではなくファイルパスを受け取るため、`${file:…}` 展開は関係しません。 |

598 602 

599<h4 id="microsoft-foundry">603<h4 id="microsoft-foundry">

600 Microsoft Foundry604 Microsoft Foundry

601</h4>605</h4>

602 606 

603クライアント側の Microsoft Foundry デプロイについては、[Claude Code on Microsoft Foundry](/docs/ja/microsoft-foundry) を参照してください。ゲートウェイ側のアップストリーム:607クライアント側の Microsoft Foundry デプロイについては、[Microsoft Foundry での Claude Code](/docs/ja/microsoft-foundry) を参照してください。ゲートウェイ側のアップストリームは次のとおりです。

604 608 

605```yaml theme={null}609```yaml theme={null}

606upstreams:610upstreams:


612 # api_key: ${FOUNDRY_API_KEY}616 # api_key: ${FOUNDRY_API_KEY}

613```617```

614 618 

615`use_azure_ad: true` は `DefaultAzureCredential` を通じて解決します:AKS、ACI、または App Service 上の Managed Identity、Azure CLI、または環境認証情報。API キーは機能しますが、プロジェクト全体に適用され、自動的にローテーションしません。Microsoft Foundry のエンドポイントは `resource:` から導出されます。Azure Government などのソブリンクラウドの場合、オプションの `base_url` を設定して上書きします。619`use_azure_ad: true` は `DefaultAzureCredential` を通じて解決されます(AKS、ACI、App Service 上の Managed Identity、Azure CLI、または環境の認証情報)。API キーも機能しますが、プロジェクト全体に適用され、自動的にローテーションされません。Microsoft Foundry のエンドポイントは `resource:` から導出されます。Azure Government などのソブリンクラウドの場合は、オプションの `base_url` を設定して上書きしてください。

616 620 

617| セットアップ | 方法 |621| セットアップ | 方法 |

618| - | - |622| - | - |

619| RBAC | ゲートウェイのアイデンティティに Microsoft Foundry リソースで `Azure AI User` または `Cognitive Services User` を付与 |623| RBAC | ゲートウェイの ID に、Microsoft Foundry リソースに対する `Azure AI User` または `Cognitive Services User` を付与します |

620| デプロイ | Microsoft Foundry は正規モデル ID ではなく、管理者が選択したデプロイ名を使用します。各正規 ID をデプロイ名にマップする [`models:`](#models) ブロックを追加します。 |624| デプロイ | Microsoft Foundry は、正規のモデル ID ではなく管理者が選択したデプロイ名を使用します。各正規 ID をデプロイ名にマッピングする [`models:`](#models) ブロックを追加してください。 |

621| AKS(ワークロードアイデンティティ) | User-Assigned Managed Identity をクラスターの OIDC 発行者とフェデレーションし、ゲートウェイのサービスアカウントにバインドします。`use_azure_ad: true` は `WorkloadIdentityCredential` を通じてそれを取得します。 |625| AKS(ワークロード ID) | ユーザー割り当てマネージド ID をクラスターの OIDC 発行者とフェデレーションし、ゲートウェイのサービスアカウントにバインドします。`use_azure_ad: true` が `WorkloadIdentityCredential` 経由でそれを取得します。 |

622| ACI / App Service | リソースでシステム割り当てまたはユーザー割り当てマネージドアイデンティティを有効にします。`use_azure_ad: true` がそれを取得します。 |626| ACI / App Service | リソースでシステム割り当てまたはユーザー割り当てのマネージド ID を有効にします。`use_azure_ad: true` がそれを取得します。 |

623| その他の場所 | `auth: { api_key: "${FOUNDRY_API_KEY}" }`。`{ }` 内の `${…}` を引用符で囲みます。 |627| その他の環境 | `auth: { api_key: "${FOUNDRY_API_KEY}" }`。`{ }` 内の `${…}` は引用符で囲んでください。 |

624 628 

625<h4 id="static-headers-on-upstream-requests">629<h4 id="static-headers-on-upstream-requests">

626 アップストリームリクエストの静的ヘッダー630 アップストリームリクエストの静的ヘッダー

627</h4>631</h4>

628 632 

629ゲートウェイが 1 つのアップストリームに送信するリクエストに固定ヘッダーを追加するには、そのアップストリームで `headers:` を設定します。プロバイダーの前段で実行するプロキシがヘッダーでトラフィックをルーティングまたは帰属させる場合に使用します。633ゲートウェイが 1 つのアップストリームに送信するリクエストに固定のヘッダーを追加するには、そのアップストリームで `headers:` を設定します。プロバイダーの前段で運用しているプロキシがヘッダーによってトラフィックをルーティングまたは帰属させる場合に使用します。

630 634 

631`headers:` にはゲートウェイサーバーで Claude Code v2.1.277 以降が必要です。以前のゲートウェイはキーを見つけたときに起動を拒否します。すべてのレプリカをアップグレードしてからキーを追加し、以前のバージョンにロールバックする前にキーを削除します。635`headers:` には、ゲートウェイサーバーで Claude Code v2.1.277 以降が必要です。それより前のゲートウェイは、このキーを見つけると起動を拒否します。キーを追加する前にすべてのレプリカをアップグレードし、以前のバージョンにロールバックする前にキーを削除してください。

632 636 

633ヘッダーは `base_url` が名前を付けるサーバー、または `base_url` が設定されていない場合はプロバイダー独自のエンドポイントに送られます。プロキシがそれらを削除しない限り、プロバイダーもそれらを受け取ります。637ヘッダーは `base_url` が指すサーバーに送信されます。`base_url` が未設定の場合はプロバイダー自身のエンドポイントに送信されます。プロキシが削除しない限り、プロバイダーもヘッダーを受け取ります。

634 638 

635この例は、`upstream-proxy.internal.example.com` のプロキシを通じて `provider: vertex` アップストリームに到達します。プロキシが読み取る `x-source` ヘッダーを設定し、`PROXY_TOKEN` 環境変数からのトークンを `x-proxy-token` として送信します:639この例では、`upstream-proxy.internal.example.com` にあるプロキシを経由して `provider: vertex` アップストリームに到達します。プロキシが読み取る `x-source` ヘッダーを設定し、`PROXY_TOKEN` 環境変数のトークンを `x-proxy-token` として送信します。

636 640 

637```yaml theme={null}641```yaml theme={null}

638upstreams:642upstreams:


646 x-proxy-token: ${PROXY_TOKEN}650 x-proxy-token: ${PROXY_TOKEN}

647```651```

648 652 

649値は、どちらの端にもスペースのない印字可能な ASCII テキストです。数字、`true`、または `false` を引用符で囲んで、YAML がそれをテキストとして読むようにします。653値は、両端にスペースのない印刷可能な ASCII テキストです。YAML がテキストとして読み取るよう、数値、`true`、`false` は引用符で囲んでください。

650 654 

651シークレットを設定ファイルから外すには、[シークレット展開](#secret-expansion)を使用して、`${VAR}` で環境変数から、または `${file:/path}` でファイルから値を読み込みます。空の値に解決する `${VAR}` はゲートウェイの起動を停止します。655設定ファイルにシークレットを含めないようにするには、[シークレット展開](#secret-expansion)を使用して、`${VAR}` で環境変数から、または `${file:/path}` でファイルから値を読み込みます。空の値に解決される `${VAR}` があると、ゲートウェイは起動しません。

652 656 

653`headers:` はすべてのプロバイダーで機能し、各アップストリームは自身のヘッダーのみを送信します。657`headers:` はすべてのプロバイダーで機能し、各アップストリームは自身のヘッダーのみを送信します。

654 658 

655ゲートウェイがアップストリームに送信するすべてのリクエストがそれらを含むわけではありません:659ゲートウェイがアップストリームに送信するすべてのリクエストにヘッダーが含まれるわけではありません。

656 660 

657| ゲートウェイがこのアップストリームに送信するリクエスト | `headers:` を含む |661| ゲートウェイがこのアップストリームに送信するリクエスト | `headers:` を含むか |

658| - | - |662| - | - |

659| `/v1/messages`(ストリーミングかどうかを問わない)、および `/v1/messages/count_tokens` | はい |663| `/v1/messages`(ストリーミングの有無を問わない)と `/v1/messages/count_tokens` | はい |

660| 別のアップストリームからフェイルオーバーしたリクエスト | はい。このアップストリームの `headers:` のみ |664| 別のアップストリームからフェイルオーバーしたリクエスト | はい(このアップストリームの `headers:` のみ) |

661| クライアントが放棄したリクエストの Amazon Bedrock の `CountTokens` 呼び出し | いいえ |665| クライアントが中断したリクエストに対する Amazon Bedrock の `CountTokens` 呼び出し | いいえ |

662| Workload Identity Federation トークン交換 | いいえ |666| Workload Identity Federation のトークン交換 | いいえ |

663 667 

664AWS SigV4 でリクエストに署名する Amazon Bedrock または Claude Platform on AWS アップストリームでは、これらのヘッダーは署名の一部であるため、プロキシはそれらを変更せずに通す必要があります。668AWS SigV4 でリクエストに署名する Amazon Bedrock または Claude Platform on AWS アップストリームでは、これらのヘッダーは署名の一部になるため、プロキシはヘッダーを変更せずに通過させる必要があります。

665 669 

666ゲートウェイが予約する名前を使用すると、ゲートウェイは起動を拒否し、起動エラーにそのヘッダーの名前が表示されます。予約名には以下が含まれます:670ゲートウェイが予約している名前を使用すると、ゲートウェイは起動を拒否し、起動エラーにそのヘッダー名が示されます。予約されている名前には次のものがあります。

667 671 

668* `authorization` と `x-api-key`672* `authorization` と `x-api-key`

669* `host`、`content-type`、および `user-agent`673* `host`、`content-type`、`user-agent`

670* `anthropic-`、`x-goog-`、`x-amz-`、または `x-amzn-` で始まる任意の名前674* `anthropic-`、`x-goog-`、`x-amz-`、`x-amzn-` で始まる名前

671 675 

672<h4 id="multiple-upstreams">676<h4 id="multiple-upstreams">

673 複数のアップストリーム677 複数のアップストリーム

674</h4>678</h4>

675 679 

676同じプロバイダーは異なる `name:` で複数回表示できます。これは異なるリージョン、異なるアカウント(異なる認証情報チェーン経由)、プロビジョニングされたスループット対オンデマンド、およびクロスプロバイダーフォールバックをカバーします。680同じプロバイダーを、異なる `name:` を付けて複数回指定できます。これにより、異なるリージョン、異なる認証情報チェーンによる異なるアカウント、プロビジョンドスループットとオンデマンド、プロバイダー間のフォールバックに対応できます。

677 681 

678ゲートウェイはアップストリームを順に試みます。`5xx`、`429`、`401`、`403`、`404`、タイムアウト、および欠落エンドポイント(`501`)がフェイルオーバーします。他の `4xx` はフェイルオーバーしません。682ゲートウェイはアップストリームを順番に試行します。`5xx`、`429`、`401`、`403`、`404`、タイムアウト、エンドポイントの欠如(`501`)はフェイルオーバーします。その他の `4xx` はフェイルオーバーしません。

679 683 

680`429` はアップストリームごとの容量であるため、プロビジョニングされたスループット(PT)の枯渇はオンデマンドにフェイルオーバーします。アップストリームで [`forward_user_identity: true`](#per-user-identity-headers-for-a-proxy-you-run) を設定する場合、開発者のメールを含むリクエストへの `429` は代わりにユーザーごとの拒否となり、フェイルオーバーしません。684`429` はアップストリームごとの容量を表すため、プロビジョンドスループット(PT)を使い切るとオンデマンドにフェイルオーバーします。アップストリームで [`forward_user_identity: true`](#per-user-identity-headers-for-a-proxy-you-run) を設定した場合、開発者のメールアドレスを含むリクエストへの `429` は代わりにユーザーごとの拒否となり、フェイルオーバーしません。

681 685 

682すべてのリクエストは最初のアップストリームで開始されます。リクエストは、それより前のすべてのアップストリームが失敗したか、要求されたモデルを提供しない場合のみ、後のアップストリームに到達します。686すべてのリクエストは最初のアップストリームから開始します。リクエストが後続のアップストリームに到達するのは、それより前のすべてのアップストリームが失敗したか、要求されたモデルを提供していない場合のみです。

683 687 

684ゲートウェイは失敗したアップストリームの記録を保たないため、アップストリームがダウンしている間、それに到達するすべてのリクエストはそれを試み、失敗するのを待ってから先に進みます。688ゲートウェイは失敗したアップストリームの記録を保持しないため、アップストリームがダウンしている間、そこに到達するすべてのリクエストは引き続きそのアップストリームを試行し、失敗するのを待ってから次に進みます。

685 689 

686Anthropic API アップストリームの場合、[`timeouts.upstream_ttfb_ms`](#http-tuning) がダウンしたアップストリームでの待機を制限します。その設定は他のプロバイダーには適用されず、ゲートウェイはアップストリームが応答を開始するまで最大 1 時間待機します。690Anthropic API アップストリームでは、[`timeouts.upstream_ttfb_ms`](#http-tuning) がダウンしたアップストリームでの待機時間の上限を定めます。この設定は他のプロバイダーには適用されず、それらのプロバイダーでは、ゲートウェイはアップストリームが応答を開始するまで最大 1 時間待機します。

687 691 

688`404` はアップストリームごとのモデル可用性であるため、モデルを有効にしていないアップストリームは、それを提供する後のアップストリームをブロックしません。要求されたモデルを解決できないアップストリームはネットワークラウンドトリップなしでスキップされます。692`404` はアップストリームごとのモデルの提供状況を表すため、モデルを有効にしていないアップストリームが、そのモデルを提供する後続のアップストリームを妨げることはありません。要求されたモデルを解決できないアップストリームは、ネットワークのラウンドトリップなしでスキップされます。

689 693 

690この例は、プロビジョニングされたスループットの Amazon Bedrock 割り当てを最初にルーティングし、オンデマンドと 2 番目のアカウントにオーバーフローし、最後に Anthropic API にフォールバックします:694この例では、プロビジョンドスループットの Amazon Bedrock の割り当てを最初にルーティングし、オンデマンドと 2 つ目のアカウントにオーバーフローさせ、最後に Anthropic API にフォールバックします。

691 695 

692```yaml theme={null}696```yaml theme={null}

693upstreams:697upstreams:


725 anthropic-fallback: claude-opus-4-8729 anthropic-fallback: claude-opus-4-8

726```730```

727 731 

728| レバー | 方法 |732| 手段 | 方法 |

729| - | - |733| - | - |

730| 異なるリージョン | リージョンごとに 1 つの Amazon Bedrock アップストリームを置き、それぞれ独自の `region:` を持たせます。[`auto_include_builtin_models: true`](#models) ではクロスリージョン推論プロファイルが自動的にルーティングします。リージョン固定のデプロイの場合、`models:` ブロックを使用します。 |734| 異なるリージョン | リージョンごとに 1 つの Amazon Bedrock アップストリームを設け、それぞれに独自の `region:` を設定します。[`auto_include_builtin_models: true`](#models) の場合、クロスリージョン推論プロファイルは自動的にルーティングされます。リージョンに固定されたデプロイでは `models:` ブロックを使用してください。 |

731| 異なるアカウント | アカウントごとに 1 つの Amazon Bedrock アップストリーム。デフォルトチェーン(`auth: {}`)はポッドのアイデンティティを使用します。2 番目のアカウントの場合、短期認証情報でそれに到達するために [`assume_role`](#bedrock-in-another-aws-account) を追加するか、`auth:` で明示的な認証情報またはベアラートークンを設定します。 |735| 異なるアカウント | アカウントごとに 1 つの Amazon Bedrock アップストリームを設けます。デフォルトのチェーン(`auth: {}`)は Pod の ID を使用します。2 つ目のアカウントについては、[`assume_role`](#bedrock-in-another-aws-account) を追加して短命の認証情報で到達するか、`auth:` で明示的な認証情報またはベアラートークンを設定してください。 |

732| プロビジョニングされたスループット | そのアップストリームの名前について、`models:` でモデルをプロビジョニングされたスループット ARN にマップします。他のアップストリームはオンデマンド ID を保つため、PT 容量はフェイルオーバーする前に使い切られます。 |736| プロビジョンドスループット | `models:` で、そのアップストリームの名前に対してモデルをプロビジョンドスループットの ARN にマッピングします。他のアップストリームはオンデマンドの ID を維持するため、PT の容量を使い切ってからフェイルオーバーします。 |

733| VPC / FIPS エンドポイント | アップストリームで `base_url:` を VPC エンドポイントまたは FIPS エンドポイント URL に設定 |737| VPC / FIPS エンドポイント | アップストリームの `base_url:` を VPC エンドポイントまたは FIPS エンドポイントの URL に設定します |

734| モデルスコープルーティング | 組み込み Claude モデルではないカスタムモデル `id` のみが、その `upstream_model:` マップにないアップストリームをスキップします。`mantle` アップストリームは、その [`models` フィールド](#amazon-bedrock-mantle-endpoint)にリストされたモデルに対してのみ試行されます。他のすべてのアップストリームでは、ゲートウェイは組み込みモデルを順に試み、マップにエントリがない場合はプロバイダーのデフォルト ID を使用するため、組み込みモデルの場合、マップはアップストリームが試みられるかどうかではなく、アップストリームが受け取る ID を変更します。ID を拒否するアップストリームは、他のアップストリームエラーと同じ[フェイルオーバールール](#upstreams)に従います。 |738| モデル単位のルーティング | カスタムモデルの `id`(組み込みの Claude モデルではないもの)の場合のみ、その `upstream_model:` マップにないアップストリームがスキップされます。`mantle` アップストリームは、その [`models` フィールド](#amazon-bedrock-mantle-endpoint)に列挙されたモデルについてのみ試行されます。その他のすべてのアップストリームでは、ゲートウェイは組み込みモデルを順番に試行し、マップにエントリがない場合はプロバイダーのデフォルト ID を使用します。そのため、組み込みモデルでは、マップはアップストリームが試行されるかどうかではなく、アップストリームが受け取る ID を変更します。ID を拒否したアップストリームは、他のアップストリームエラーと同じ[フェイルオーバールール](#upstreams)に従います。 |

735 739 

736クラウドプロバイダー間、または直接 Anthropic API へのフェイルオーバーは、リクエストに適用される契約、地理、およびその他の条件を変更します。740クラウドプロバイダー間、または直接の Anthropic API へのフェイルオーバーでは、リクエストに適用される契約、地域、その他の条件が変わります。

737 741 

738CLI は、どのアップストリームが特定のリクエストを処理するかに関わらず、ゲートウェイに同じ機能ゲーティングを適用するため、フェイルオーバーによってアップストリームが拒否する本体フィールドが送信されることはありません。742CLI は、特定のリクエストをどのアップストリームが処理するかに関係なく、ゲートウェイに同じ機能ゲーティングを適用するため、フェイルオーバーによって、アップストリームが拒否するような本文フィールドが送信されることはありません。

739 743 

740<h2 id="optional-sections">744<h2 id="optional-sections">

741 オプションセクション745 オプションセクション


1131 1135 

1132* `availableModels` からのモデルリスト。各モデルの 1M コンテキストオプションについては [Claude Desktop の拡張コンテキスト](#extended-context-in-claude-desktop) を参照してください1136* `availableModels` からのモデルリスト。各モデルの 1M コンテキストオプションについては [Claude Desktop の拡張コンテキスト](#extended-context-in-claude-desktop) を参照してください

1133* ツール名のみの `permissions.deny` エントリからの無効化されたツール。ポリシーの `desktop` ブロックで `disabledBuiltinTools` を設定した場合、ゲートウェイは指定した値と導出されたリストの和集合を提供します。そのため、この方法でさらにツールを無効化できますが、`permissions.deny` で無効化したツールを再度有効化することはできません1137* ツール名のみの `permissions.deny` エントリからの無効化されたツール。ポリシーの `desktop` ブロックで `disabledBuiltinTools` を設定した場合、ゲートウェイは指定した値と導出されたリストの和集合を提供します。そのため、この方法でさらにツールを無効化できますが、`permissions.deny` で無効化したツールを再度有効化することはできません

1134* `sandbox.network.allowedDomains` からの出力許可リスト。ポリシーの `desktop` ブロックで `coworkEgressAllowedHosts` を設定した場合、ゲートウェイは導出されたリストの代わりにその値を使用します1138* `sandbox.network.allowedDomains` から導出される送信許可リスト。ポリシーの `desktop` ブロックで `coworkEgressAllowedHosts` を設定すると、ゲートウェイは導出リストの代わりにその値を使用します。ゲートウェイが提供する許可リストに `*` が含まれ、かつゲートウェイが Claude Desktop の [`allowedWorkspaceFolders`](https://claude.com/docs/third-party/claude-desktop/code#applied-as-managed-policy) も提供していない場合、Claude Desktop は Code タブで [Bash サンドボックス](/docs/ja/sandboxing)をオンにしません

1135* ゲートウェイ自体を指す OTLP エンドポイントと、サインインしたユーザーのアイデンティティ属性。ゲートウェイはそのエンドポイントで受け取ったエクスポートを `forward_to` の宛先にリレーします。[`telemetry.forward_to`](#telemetry) と `listen.public_url` の両方を設定した場合に、エンドポイントと属性が含まれます。1139* ゲートウェイ自体を指す OTLP エンドポイントと、サインインしたユーザーのアイデンティティ属性。ゲートウェイはそのエンドポイントで受け取ったエクスポートを `forward_to` の宛先にリレーします。[`telemetry.forward_to`](#telemetry) と `listen.public_url` の両方を設定した場合に、エンドポイントと属性が含まれます。

1136 1140 

1137 Claude Desktop はすべてのシグナルを 1 つのエンコーディングでエクスポートします:`http/protobuf`、またはポリシーの `env` で `OTEL_EXPORTER_OTLP_PROTOCOL` またはそのシグナルごとのバリアントのいずれかを `http/json` に設定した場合は `http/json` です。ゲートウェイサーバー上の Claude Code v2.1.261 より前では、レスポンスは常に `http/json` を設定していたため、protobuf のみを受け入れるコレクターは Claude Desktop のエクスポートを拒否していました1141 Claude Desktop はすべてのシグナルを 1 つのエンコーディングでエクスポートします:`http/protobuf`、またはポリシーの `env` で `OTEL_EXPORTER_OTLP_PROTOCOL` またはそのシグナルごとのバリアントのいずれかを `http/json` に設定した場合は `http/json` です。ゲートウェイサーバー上の Claude Code v2.1.261 より前では、レスポンスは常に `http/json` を設定していたため、protobuf のみを受け入れるコレクターは Claude Desktop のエクスポートを拒否していました


1372 1376 

1373protobuf と JSON の両方の OTLP エンコーディングがリレーされ、OpenTelemetry 互換の任意のバックエンドを宛先として使用できます。1377protobuf と JSON の両方の OTLP エンコーディングがリレーされ、OpenTelemetry 互換の任意のバックエンドを宛先として使用できます。

1374 1378 

1379<h4 id="send-cumulative-metrics">

1380 累積メトリクスを送信する

1381</h4>

1382 

1383コレクターが累積メトリクスのみを受け付ける場合は、[`OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE`](/docs/ja/monitoring-usage#common-configuration-variables) を `cumulative` に設定します。Claude Code はデフォルトでデルタメトリクスを送信し、ゲートウェイはそれらを変換せずに中継します。各種類のセッションがこの変数を読み取る場所で設定してください。

1384 

1385* **ターミナルセッション**: ポリシーの [`cli` または `code` キー](#choose-cli-or-code) の下の `env` ブロック

1386* **[ユーザーのマシンで実行される](/docs/ja/managed-settings#where-and-when-a-policy-applies) Cowork セッション**: そのマシン上の [クライアント側の管理設定](#client-side-managed-settings) の `env` ブロック

1387* **`code` ポリシーの下の Code タブセッション**: [`code` 設定が適用される条件](#apply-code-settings-in-the-code-tab) を満たしたうえで、ポリシーの `env` ブロック

1388* **`cli` ポリシーの下の Code タブセッション**: セッションを実行するマシン上のクライアント側の管理設定の `env` ブロック。SSH 経由の場合はリモートホストです。

1389 

1390マシンの管理設定に変数を追加する場合は、そのマシン上の優先順位が最も高いソースで [`parentSettingsBehavior: "merge"`](/docs/ja/claude-apps-gateway#set-the-opt-in) も設定してください。これがないと、Cowork セッションと `cli` ポリシーの下の Code タブセッションは、Claude Desktop が親設定として渡すエグレス許可リストやその他のポリシーなしで実行されます。

1391 

1375<h4 id="add-your-own-labels">1392<h4 id="add-your-own-labels">

1376 独自のラベルを追加する1393 独自のラベルを追加する

1377</h4>1394</h4>

Details

1706claude purge ~/work/my-repo --yes1706claude purge ~/work/my-repo --yes

1707```1707```

1708 1708 

1709パスの代わりに `--all` を渡して、すべてのプロジェクトの状態を一度にパージします。これは `history.jsonl` をフィルタリングするのではなく、完全に削除します。`-i` を渡して、削除計画を 1 つずつステップスルーします。1709その他のオプション:

1710 

1711* パスの代わりに `--all` を渡して、すべてのプロジェクトの状態を一度にパージします。これは `history.jsonl` をフィルタリングするのではなく、完全に削除します。

1712* `-i` を渡して、削除計画を 1 つずつステップスルーします。

1710 1713 

1711コマンドは `shell-snapshots/` と `backups/` をそのままにしておきます。これらはプロジェクトスコープではないため、計画出力で警告します。マシン上で誰かが [`/heapdump`](/docs/ja/troubleshooting#high-cpu-or-memory-usage) を実行した場合は、それが書き込んだ `.heapsnapshot` ファイルも削除してください。ヒープスナップショットには会話全体とプロセスが保持していた認証情報が含まれており、保持スイープもパージもそれには触れません。1714コマンドは `shell-snapshots/` と `backups/` をそのままにしておきます。これらはプロジェクトスコープではないため、計画出力で警告します。マシン上で誰かが [`/heapdump`](/docs/ja/troubleshooting#high-cpu-or-memory-usage) を実行した場合は、それが書き込んだ `.heapsnapshot` ファイルも削除してください。ヒープスナップショットには会話全体とプロセスが保持していた認証情報が含まれており、保持スイープもパージもそれには触れません。

1712 1715 

1713[保持するべき状態ファイル](#state-files-to-keep)を除き、上記のアプリケーションデータパスのいずれかを手動で削除することもできます。新しいセッションは影響を受けません。以下の表は、過去のセッションで失うものを示しています。1716[保持するべき状態ファイル](#state-files-to-keep)を除き、上記のアプリケーションデータパスのいずれかを手動で削除することもできます。

1714 1717 

1715| 削除 | 失うもの |1718| 削除 | 失うもの |

1716| - | - |1719| - | - |


1726| `~/.claude/remote-settings.json` | なし。次の起動時に再取得されます |1729| `~/.claude/remote-settings.json` | なし。次の起動時に再取得されます |

1727| `~/.claude/cache/changelog.md` | なし。バックグラウンドで更新されます |1730| `~/.claude/cache/changelog.md` | なし。バックグラウンドで更新されます |

1728| `~/.claude/policy-limits.json` | なし。自動的に更新されます |1731| `~/.claude/policy-limits.json` | なし。自動的に更新されます |

1729| `~/.claude/tasks/` | 再開されたセッションが取得するタスクリスト |1732| `~/.claude/tasks/` | まだ使用中のものを含む[タスクリスト](/docs/ja/interactive-mode#task-list) |

1730| `~/.claude/skills/.trash/`、`~/.claude/plugins/.trash/` | Claude Code が削除した[同期されたスキル](/docs/ja/skills#how-synced-skills-behave)と[同期されたプラグイン](/docs/ja/plugins/loading#synced-plugins)を復元する機会 |1733| `~/.claude/skills/.trash/`、`~/.claude/plugins/.trash/` | Claude Code が削除した[同期されたスキル](/docs/ja/skills#how-synced-skills-behave)と[同期されたプラグイン](/docs/ja/plugins/loading#synced-plugins)を復元する機会 |

1731| `~/.claude/plugins/installed_plugins.set-aside.<date>.<hash>.json`、`~/.claude/plugins/installed_plugins.unreadable.<date>.<hash>.kept` | Claude Code が削除したプラグインインストールレコード、または読み込めなかったファイルのコピー。何もそれらを読み込み直しません |1734| `~/.claude/plugins/installed_plugins.set-aside.<date>.<hash>.json`、`~/.claude/plugins/installed_plugins.unreadable.<date>.<hash>.kept` | Claude Code が削除したプラグインインストールレコード、または読み込めなかったファイルのコピー。何もそれらを読み込み直しません |

1732| `~/.claude/debug/`、`~/.claude/plans/`、`~/.claude/session-env/`、`~/.claude/shell-snapshots/`、`~/.claude/backups/` | ユーザーに見える何もなし |1735| `~/.claude/debug/`、`~/.claude/plans/`、`~/.claude/session-env/`、`~/.claude/shell-snapshots/`、`~/.claude/backups/` | ユーザーに見える何もなし |

Details

115| `--no-session-persistence` | セッション永続性を無効にして、セッションがディスクに保存されず、再開できないようにします。プリントモードのみ。[`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ja/env-vars)環境変数は任意のモードで同じことを行います | `claude -p --no-session-persistence "query"` |115| `--no-session-persistence` | セッション永続性を無効にして、セッションがディスクに保存されず、再開できないようにします。プリントモードのみ。[`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ja/env-vars)環境変数は任意のモードで同じことを行います | `claude -p --no-session-persistence "query"` |

116| `--output-format` | プリントモードの出力形式を指定します(オプション:`text`、`json`、`stream-json`) | `claude -p "query" --output-format json` |116| `--output-format` | プリントモードの出力形式を指定します(オプション:`text`、`json`、`stream-json`) | `claude -p "query" --output-format json` |

117| `--permission-mode` | 指定された[権限モード](/docs/ja/permission-modes)で開始します。`default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions`、または `manual` を `default` のエイリアスとして受け入れます。`manual` エイリアスは UI が Manual とラベル付けする権限モードを選択し、Claude Code v2.1.200 以降が必要です。`claude --help` は `default` の代わりにそれをリストアップし、両方の値が機能します。設定ファイルの `defaultMode` を上書きします。このフラグまたは `--dangerously-skip-permissions` がない場合、新しいセッションは[セッションが開始される権限モード](/docs/ja/permission-modes#which-mode-a-session-starts-in)で説明されている権限モードで開始されます。このセクションでは `-p` 実行がどのモードで開始されるかについても説明しています | `claude --permission-mode plan` |117| `--permission-mode` | 指定された[権限モード](/docs/ja/permission-modes)で開始します。`default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions`、または `manual` を `default` のエイリアスとして受け入れます。`manual` エイリアスは UI が Manual とラベル付けする権限モードを選択し、Claude Code v2.1.200 以降が必要です。`claude --help` は `default` の代わりにそれをリストアップし、両方の値が機能します。設定ファイルの `defaultMode` を上書きします。このフラグまたは `--dangerously-skip-permissions` がない場合、新しいセッションは[セッションが開始される権限モード](/docs/ja/permission-modes#which-mode-a-session-starts-in)で説明されている権限モードで開始されます。このセクションでは `-p` 実行がどのモードで開始されるかについても説明しています | `claude --permission-mode plan` |

118| `--permission-prompt-tool` | 非対話モードで権限プロンプトを処理する MCP ツールを指定します。Claude Code は、最初のターンを実行する前に、そのツールの MCP サーバーが接続されるまで待機します。デフォルトでは [`MCP_TIMEOUT`](/docs/ja/env-vars) スタートアップタイムアウト 30 秒まで待機します。<br /><br />プロンプトツールは、[ユーザーインタラクションが必要](/docs/ja/mcp#require-approval-for-a-specific-tool)とマークされた MCP ツールを承認できません。Claude Code は 1 つに対する `allow` 結果を拒否に変換します。この制限には Claude Code v2.1.199 以降が必要です | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |118| `--permission-prompt-tool` | 非対話モードで権限プロンプトを処理する MCP ツールを指定します。その実行で読み込まれる MCP サーバー上のツールの完全な名前(`mcp__<server>__<tool>` など)を渡します。Claude Code は、最初のターンを実行する前に、そのツールの MCP サーバーが接続されるまで待機します。デフォルトでは [`MCP_TIMEOUT`](/docs/ja/env-vars) スタートアップタイムアウト 30 秒まで待機します。<br /><br />プロンプトツールは、[ユーザーインタラクションが必要](/docs/ja/mcp#require-approval-for-a-specific-tool)とマークされた MCP ツールを承認できません。Claude Code はそのようなツールに対する `allow` 結果を拒否に変換します。この制限には Claude Code v2.1.199 以降が必要です | `claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query"` |

119| `--permission-prompts` | プリントモードで権限プロンプトに誰が答えるかを設定します。デフォルトの `host` を使用すると、Claude Code はそれらをエージェント SDK ホストまたは `--permission-prompt-tool` ツールに送信します。誰も答えられない場合は `none` を渡し、Claude Code は代わりにそれらを拒否します。[無人実行で権限プロンプトをオフにする](/docs/ja/headless#turn-off-permission-prompts-in-unattended-runs)を参照してください。Claude Code v2.1.259 以降が必要です | `claude -p --permission-prompts none "query"` |119| `--permission-prompts` | プリントモードで権限プロンプトに誰が答えるかを設定します。デフォルトの `host` を使用すると、Claude Code はそれらをエージェント SDK ホストまたは `--permission-prompt-tool` ツールに送信します。誰も答えられない場合は `none` を渡し、Claude Code は代わりにそれらを拒否します。[無人実行で権限プロンプトをオフにする](/docs/ja/headless#turn-off-permission-prompts-in-unattended-runs)を参照してください。Claude Code v2.1.259 以降が必要です | `claude -p --permission-prompts none "query"` |

120| `--plugin-dir` | ディレクトリまたは `.zip` アーカイブからプラグインを読み込むか、[プラグインのフォルダ](/docs/ja/plugins/create#load-a-directory-or-archive-for-one-session)から複数を読み込みます。このセッションのみ。各フラグは 1 つのパスを取ります。より多くのパスについてはフラグを繰り返します。`--plugin-dir A --plugin-dir B.zip`。プラグインのフォルダを渡すには Claude Code v2.1.265 以降が必要です | `claude --plugin-dir ./my-plugin` |120| `--plugin-dir` | ディレクトリまたは `.zip` アーカイブからプラグインを読み込むか、[プラグインのフォルダ](/docs/ja/plugins/create#load-a-directory-or-archive-for-one-session)から複数を読み込みます。このセッションのみ。各フラグは 1 つのパスを取ります。より多くのパスについてはフラグを繰り返します。`--plugin-dir A --plugin-dir B.zip`。プラグインのフォルダを渡すには Claude Code v2.1.265 以降が必要です | `claude --plugin-dir ./my-plugin` |

121| `--plugin-url` | URL からプラグイン `.zip` アーカイブをフェッチします。このセッションのみ。複数のプラグインについてはフラグを繰り返すか、単一の引用値でスペース区切り URL を渡します | `claude --plugin-url https://example.com/plugin.zip` |121| `--plugin-url` | URL からプラグイン `.zip` アーカイブをフェッチします。このセッションのみ。複数のプラグインについてはフラグを繰り返すか、単一の引用値でスペース区切り URL を渡します | `claude --plugin-url https://example.com/plugin.zip` |

Details

117 117 

118* **リポジトリが Manual に設定されている**:コメントでレビューをリクエストする方法118* **リポジトリが Manual に設定されている**:コメントでレビューをリクエストする方法

119* **プルリクエストがフォークからのものである**:メンテナーがレビューをリクエストできること119* **プルリクエストがフォークからのものである**:メンテナーがレビューをリクエストできること

120* **ボット、または書き込みアクセス権のないユーザーが `@claude review` とコメントした**:レビューが開始されなかったことと、誰がリクエストできるか120* **ボット、またはプルリクエストの作成者ではなく書き込みアクセス権もないユーザーが `@claude review` とコメントした**:レビューが開始されなかったことと、誰がリクエストできるか

121* **GitHub 組織が Claude 組織にリンクされていない**:レビューが一時停止していることと、リンクする方法121* **GitHub 組織が Claude 組織にリンクされていない**:レビューが一時停止していることと、リンクする方法

122 122 

123これらのコメントを止めるには、設定をオフにします。123これらのコメントを止めるには、設定をオフにします。

Details

38 38 

39* **このリポジトリで Code Review がオンになっていない**:Claude はコマンドに対してコメントもチェック実行も投稿しません。Owner に[リポジトリを追加する](/docs/ja/code-review-setup#add-more-repositories)よう依頼してください。39* **このリポジトリで Code Review がオンになっていない**:Claude はコマンドに対してコメントもチェック実行も投稿しません。Owner に[リポジトリを追加する](/docs/ja/code-review-setup#add-more-repositories)よう依頼してください。

40* **コメントが条件を満たしていない**:新しいトップレベルのコメントではなく、インラインコメントやレビュー本文だった場合、またはコマンドがコメントの先頭になかった場合です。新しいコメントを投稿せずに以前のコメントを編集した場合も対象外で、プルリクエストはオープンである必要があります。[コメントコマンドの条件](/docs/ja/code-review-pull-requests#comment-commands)を確認し、条件を満たす新しいコメントを投稿してください。40* **コメントが条件を満たしていない**:新しいトップレベルのコメントではなく、インラインコメントやレビュー本文だった場合、またはコマンドがコメントの先頭になかった場合です。新しいコメントを投稿せずに以前のコメントを編集した場合も対象外で、プルリクエストはオープンである必要があります。[コメントコマンドの条件](/docs/ja/code-review-pull-requests#comment-commands)を確認し、条件を満たす新しいコメントを投稿してください。

41* **書き込みアクセス権がない**:リポジトリに対する write、maintain、または admin の権限が必要です。フォークからのプルリクエストの場合は、ベースリポジトリに対する権限が対象になります。組織でヒントがオンになっている場合、Claude は「No review was started: manual reviews can only be requested by someone with write access to this repository.」と返信します。書き込みアクセス権を持つ人に代わりにコメントしてもらってください。41* **書き込みアクセス権がない**:リポジトリに対する write、maintain、または admin の権限が必要です。フォークからのプルリクエストの場合は、ベースリポジトリに対する権限が対象になります。プルリクエストが自分のものでない場合、Claude は[ヒント](/docs/ja/code-review-setup#turn-tip-comments-on-or-off)として「No review was started: manual reviews can only be requested by someone with write access to this repository.」と返信することがあります。書き込みアクセス権を持つ人に代わりにコメントしてもらってください。

42* **予算が尽きた**:Claude は「⚠️ Code review skipped」で始まるコメントを投稿します。[レビューが実行されず、PR に予算に関するメッセージが表示される](#review-didn’t-run-and-the-pr-shows-a-budget-message)を参照してください。42* **予算が尽きた**:Claude は「⚠️ Code review skipped」で始まるコメントを投稿します。[レビューが実行されず、PR に予算に関するメッセージが表示される](#review-didn’t-run-and-the-pr-shows-a-budget-message)を参照してください。

43 43 

44<h3 id="review-didn’t-run-and-the-pr-shows-a-budget-message">44<h3 id="review-didn’t-run-and-the-pr-shows-a-budget-message">

commands.md +5 −5

Details

65| `/background [prompt]` | 現在のセッションをデタッチして[バックグラウンドエージェント](/docs/ja/agent-view)として実行し、このターミナルを解放します。デタッチする前に別の指示を送るためにプロンプトを渡します。`claude agents` でセッションを監視します。このセッションが実行し続けている間に会話を新しいバックグラウンドセッションにコピーするには、`/fork` を使用します。エイリアス:`/bg` |65| `/background [prompt]` | 現在のセッションをデタッチして[バックグラウンドエージェント](/docs/ja/agent-view)として実行し、このターミナルを解放します。デタッチする前に別の指示を送るためにプロンプトを渡します。`claude agents` でセッションを監視します。このセッションが実行し続けている間に会話を新しいバックグラウンドセッションにコピーするには、`/fork` を使用します。エイリアス:`/bg` |

66| `/batch <instruction>` | **[Skill](/docs/ja/skills#bundled-skills).** コードベース全体で大規模な変更を並列に調整します。コードベースを調査し、作業を 5 ~ 30 個の独立したユニットに分解し、計画を提示します。承認されると、分離された [worktree](/docs/ja/worktrees) 内でユニットごとに 1 つの[バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)を生成します。各サブエージェントはそのユニットを実装し、テストを実行し、その変更を公開します。git リポジトリまたは worktree を作成する [`WorktreeCreate` フック](/docs/ja/worktrees#non-git-version-control)が必要です。git リポジトリの外では、`/batch` には Claude Code v2.1.281 以降が必要です。例:`/batch migrate src/ from JavaScript to TypeScript` |66| `/batch <instruction>` | **[Skill](/docs/ja/skills#bundled-skills).** コードベース全体で大規模な変更を並列に調整します。コードベースを調査し、作業を 5 ~ 30 個の独立したユニットに分解し、計画を提示します。承認されると、分離された [worktree](/docs/ja/worktrees) 内でユニットごとに 1 つの[バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)を生成します。各サブエージェントはそのユニットを実装し、テストを実行し、その変更を公開します。git リポジトリまたは worktree を作成する [`WorktreeCreate` フック](/docs/ja/worktrees#non-git-version-control)が必要です。git リポジトリの外では、`/batch` には Claude Code v2.1.281 以降が必要です。例:`/batch migrate src/ from JavaScript to TypeScript` |

67| `/branch [name]` | 現在の会話をこの時点で分岐させて、現状の会話を失わずに別の方向を試すことができます。分岐に切り替え、元の会話を保持します。元の会話には `/resume` で戻ることができます。コピーに切り替える代わりに別の[バックグラウンドセッション](/docs/ja/agent-view)として実行するには、`/fork` を使用します。この会話に報告する[サブエージェント](/docs/ja/sub-agents)に副タスクを渡すには、`/subtask` を使用します |67| `/branch [name]` | 現在の会話をこの時点で分岐させて、現状の会話を失わずに別の方向を試すことができます。分岐に切り替え、元の会話を保持します。元の会話には `/resume` で戻ることができます。コピーに切り替える代わりに別の[バックグラウンドセッション](/docs/ja/agent-view)として実行するには、`/fork` を使用します。この会話に報告する[サブエージェント](/docs/ja/sub-agents)に副タスクを渡すには、`/subtask` を使用します |

68| `/btw [question]` | 会話に追加せずに現在のセッションについて[副質問](/docs/ja/interactive-mode#side-questions-with-%2Fbtw)をします。`/btw` を質問なしで実行すると、Claude Code は最新の副質問を表示して、以前の回答を参照できます。まだ質問していない場合、Claude Code は使用方法の行を出力します。v2.1.212 より前は、`/btw` は質問が必要でした |68| `/btw [question]` | 会話に追加せずに現在のセッションについて[副質問](/docs/ja/interactive-mode#side-questions-with-%2Fbtw)をします。`/btw` を質問なしで実行すると、Claude Code は最新の副質問を表示して、以前の回答を参照できます。まだ質問していない場合、Claude Code は使用方法の行を出力します |

69| `/bug [report]` | バグを報告するか、会話を共有します。セッション履歴をどのくらい含めるかを選択し、何かが送信される前に同意画面で確認します。ファーストパーティ接続で Anthropic にサインインしている場合、レポートは Anthropic に送信されます。サードパーティプロバイダーの場合、または Anthropic 認証情報がない場合、Claude Code はレポートを [`~/.claude/feedback-bundles/` 配下のローカルアーカイブ](/docs/ja/data-usage#telemetry-services)に書き込み、自分で転送します。[VS Code 拡張機能](/docs/ja/vs-code#use-the-prompt-box)では、`/bug` は代わりに拡張機能独自のフィードバックダイアログを開きます。Claude Code v2.1.229 以降が必要です。Claude が応答している間に実行すると、Claude Code はダイアログをすぐに開きます。v2.1.232 より前は、Claude Code はターンが終了するまでコマンドをキューに入れていました。エイリアス:`/share`。v2.1.212 より前は、`/bug` と `/share` は `/feedback` のエイリアスでした |69| `/bug [report]` | バグを報告するか、会話を共有します。セッション履歴をどのくらい含めるかを選択し、何かが送信される前に同意画面で確認します。ファーストパーティ接続で Anthropic にサインインしている場合、レポートは Anthropic に送信されます。サードパーティプロバイダーの場合、または Anthropic 認証情報がない場合、Claude Code はレポートを [`~/.claude/feedback-bundles/` 配下のローカルアーカイブ](/docs/ja/data-usage#telemetry-services)に書き込み、自分で転送します。[VS Code 拡張機能](/docs/ja/vs-code#use-the-prompt-box)では、`/bug` は代わりに拡張機能独自のフィードバックダイアログを開きます。Claude Code v2.1.229 以降が必要です。Claude が応答している間に実行すると、Claude Code はダイアログをすぐに開きます。v2.1.232 より前は、Claude Code はターンが終了するまでコマンドをキューに入れていました。エイリアス:`/share`。v2.1.212 より前は、`/bug` と `/share` は `/feedback` のエイリアスでした |

70| `/cd <path>` | このセッションを新しい作業ディレクトリに移動し、会話を保持します。部分的なパスを入力して一致するディレクトリの提案を表示し、`Tab` を押して 1 つを受け入れます。Claude Code が新しいディレクトリからすぐに適用するもの、および `/cd` が `/add-dir` とどのように異なるかについては、[セッションを別のディレクトリに移動する](/docs/ja/permissions#move-the-session-to-another-directory)を参照してください |70| `/cd <path>` | このセッションを新しい作業ディレクトリに移動し、会話を保持します。部分的なパスを入力して一致するディレクトリの提案を表示し、`Tab` を押して 1 つを受け入れます。Claude Code が新しいディレクトリからすぐに適用するもの、および `/cd` が `/add-dir` とどのように異なるかについては、[セッションを別のディレクトリに移動する](/docs/ja/permissions#move-the-session-to-another-directory)を参照してください |

71| `/chrome` | [Claude in Chrome](/docs/ja/chrome) 設定を構成します |71| `/chrome` | [Claude in Chrome](/docs/ja/chrome) 設定を構成します |


95| `/feedback [report]` | Claude Code に関する製品フィードバックを送信します。[`/bug`](#all-commands) と同じダイアログを開き、同じ同意ステップ、送信ルール、ミッドターン動作があります。[Claude がドラフトしたフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を含むセッションでは、引数なしで `/feedback` を実行するとドラフトキューが代わりに開き、Claude がキューに入れたドラフトを確認、編集、送信、または破棄できます。キューには新しいレポートをダイアログで書き込むオプションが含まれます。引数を指定した場合、および `/bug` の場合は常に、ダイアログが直接開きます |95| `/feedback [report]` | Claude Code に関する製品フィードバックを送信します。[`/bug`](#all-commands) と同じダイアログを開き、同じ同意ステップ、送信ルール、ミッドターン動作があります。[Claude がドラフトしたフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を含むセッションでは、引数なしで `/feedback` を実行するとドラフトキューが代わりに開き、Claude がキューに入れたドラフトを確認、編集、送信、または破棄できます。キューには新しいレポートをダイアログで書き込むオプションが含まれます。引数を指定した場合、および `/bug` の場合は常に、ダイアログが直接開きます |

96| `/fewer-permission-prompts` | **[Skill](/docs/ja/skills#bundled-skills).** トランスクリプトで一般的な読み取り専用 Bash および MCP ツール呼び出しをスキャンし、プロジェクト `.claude/settings.json` に優先順位付きの許可リストを追加して権限プロンプトを減らします |96| `/fewer-permission-prompts` | **[Skill](/docs/ja/skills#bundled-skills).** トランスクリプトで一般的な読み取り専用 Bash および MCP ツール呼び出しをスキャンし、プロジェクト `.claude/settings.json` に優先順位付きの許可リストを追加して権限プロンプトを減らします |

97| `/focus` | フォーカスビューを切り替えます。最後のプロンプト、1 行のツール呼び出し要約と編集 diffstats、および最終応答のみを表示します。ツール呼び出し要約はターンで起動されたサブエージェントもカウントし、完了したバックグラウンドタスク通知を 1 つのカウントに折りたたみます。選択はセッション間で永続化されます。設定で [`viewMode`](/docs/ja/settings-reference#viewmode) を設定して上書きします。[フルスクリーンレンダリング](/docs/ja/fullscreen)でのみ利用可能です。[Remote Control](/docs/ja/remote-control) クライアントから、`/focus [on\|off]` を実行して、保存された選択を変更せずに現在のセッションのみのフォーカスビューをオンまたはオフにします。これには Claude Code v2.1.281 以降が必要です。[VS Code 拡張機能](/docs/ja/vs-code#use-the-prompt-box)は独自のフォーカスビューをコマンドメニューの切り替えとして提供し、拡張機能設定として保存され、`viewMode` とは独立しています |97| `/focus` | フォーカスビューを切り替えます。最後のプロンプト、1 行のツール呼び出し要約と編集 diffstats、および最終応答のみを表示します。ツール呼び出し要約はターンで起動されたサブエージェントもカウントし、完了したバックグラウンドタスク通知を 1 つのカウントに折りたたみます。選択はセッション間で永続化されます。設定で [`viewMode`](/docs/ja/settings-reference#viewmode) を設定して上書きします。[フルスクリーンレンダリング](/docs/ja/fullscreen)でのみ利用可能です。[Remote Control](/docs/ja/remote-control) クライアントから、`/focus [on\|off]` を実行して、保存された選択を変更せずに現在のセッションのみのフォーカスビューをオンまたはオフにします。これには Claude Code v2.1.281 以降が必要です。[VS Code 拡張機能](/docs/ja/vs-code#use-the-prompt-box)は独自のフォーカスビューをコマンドメニューの切り替えとして提供し、拡張機能設定として保存され、`viewMode` とは独立しています |

98| `/fork [prompt]` | [現在の会話をコピー](/docs/ja/agent-view#copy-the-session-with-%2Ffork)して新しいバックグラウンドセッションを作成し、ここで作業を続けます。プロンプトを渡すとコピーはすぐにそれに対して作業を開始します。渡さない場合、エージェントビューで最初のプロンプトを待ちます。コピーが[その場で編集](/docs/ja/agent-view#how-file-edits-are-isolated)する場合を除き、Claude Code はコード変更を行う前に独自の worktree を作成するよう指示します。分離指示には Claude Code v2.1.221 以降が必要です。結果がこの会話に戻ってくるサブエージェントに副タスクを渡すには、`/subtask` を使用します。自分でコピーに切り替えるには、`/branch` を使用します。Claude Code v2.1.212 以降が必要です。v2.1.161 ~ v2.1.211 では、および [agent view がオフ](/docs/ja/agent-view#turn-off-agent-view)になっている場合は常に、`/fork` は代わりに[フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation)を開始します |98| `/fork [prompt]` | [現在の会話をコピー](/docs/ja/agent-view#copy-the-session-with-%2Ffork)して新しいバックグラウンドセッションを作成し、ここで作業を続けます。プロンプトを渡すとコピーはすぐにそれに対して作業を開始します。渡さない場合、エージェントビューで最初のプロンプトを待ちます。コピーが[その場で編集](/docs/ja/agent-view#how-file-edits-are-isolated)する場合を除き、Claude Code はコード変更を行う前に独自の worktree を作成するよう指示します。分離指示には Claude Code v2.1.221 以降が必要です。結果がこの会話に戻ってくるサブエージェントに副タスクを渡すには、`/subtask` を使用します。自分でコピーに切り替えるには、`/branch` を使用します。[agent view がオフ](/docs/ja/agent-view#turn-off-agent-view)になっている場合、`/fork` は代わりに[フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation)を開始します |

99| `/goal [condition\|clear]` | [goal](/docs/ja/goal) を設定します:Claude は条件が満たされるか goal が[別の理由でクリア](/docs/ja/goal#how-evaluation-works)されるまでターンをまたいで作業を続けます。引数がない場合、現在または最近達成された goal を表示します。`clear`、`stop`、`off`、`reset`、`none`、または `cancel` はアクティブな goal を早期に削除します |99| `/goal [condition\|clear]` | [goal](/docs/ja/goal) を設定します:Claude は条件が満たされるか goal が[別の理由でクリア](/docs/ja/goal#how-evaluation-works)されるまでターンをまたいで作業を続けます。引数がない場合、現在または最近達成された goal を表示します。`clear`、`stop`、`off`、`reset`、`none`、または `cancel` はアクティブな goal を早期に削除します |

100| `/heapdump` | JavaScript ヒープスナップショットとメモリ内訳を `~/Desktop`、または Desktop フォルダがない Linux ではホームディレクトリに書き込んで、高いメモリ使用量を診断します。メモリ問題を報告するときは `-diagnostics.json` ファイルのみを添付してください。`.heapsnapshot` には完全な会話と認証情報が含まれているため、共有しないでください。[コマンドメニューから非表示](#how-the-command-menu-matches-what-you-type)です。完全に入力してください。[出力をどう扱うか](/docs/ja/troubleshooting#high-cpu-or-memory-usage)を参照してください |100| `/heapdump` | JavaScript ヒープスナップショットとメモリ内訳を `~/Desktop`、または Desktop フォルダがない Linux ではホームディレクトリに書き込んで、高いメモリ使用量を診断します。メモリ問題を報告するときは `-diagnostics.json` ファイルのみを添付してください。`.heapsnapshot` には完全な会話と認証情報が含まれているため、共有しないでください。[コマンドメニューから非表示](#how-the-command-menu-matches-what-you-type)です。完全に入力してください。[出力をどう扱うか](/docs/ja/troubleshooting#high-cpu-or-memory-usage)を参照してください |

101| `/help` | ヘルプと利用可能なコマンドを表示します |101| `/help` | ヘルプと利用可能なコマンドを表示します |

102| `/hooks` | [フック](/docs/ja/hooks#the-%2Fhooks-menu)設定を表示します |102| `/hooks` | [フック](/docs/ja/hooks#the-%2Fhooks-menu)設定を表示します |

103| `/ide` | IDE 統合を管理して状態を表示します |103| `/ide` | IDE 統合を管理して状態を表示します |

104| `/import [codex\|gemini\|cursor] [--dry-run] [--yes]` | マシン上の OpenAI Codex、Google Gemini CLI、または Cursor から Claude Code に設定を取り込みます。指示ファイル、MCP サーバー、コマンド、サブエージェント、スキルを含みます。`-p` を使用した[非対話モード](/docs/ja/headless)では、`/import` は見つけたものを一覧表示し、インポートを確認するコマンドを提供します。`--dry-run` を追加して何も書き込まずにプレビューするか、`--yes` を追加してインタラクティブなピッカーをスキップします。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、または [Claude apps gateway](/docs/ja/claude-apps-gateway#availability-and-limitations) 経由では利用できません。[フィーチャーフラグフェッチング](/docs/ja/env-vars#features-that-need-feature-flag-fetching)をオフにしている場合も利用できません。Claude Code v2.1.213 以降が必要です。Cursor からのインポートには v2.1.265 以降が必要です |104| `/import [codex\|gemini\|cursor] [--dry-run] [--yes]` | マシン上の OpenAI Codex、Google Gemini CLI、または Cursor から Claude Code に設定を取り込みます。指示ファイル、MCP サーバー、コマンド、サブエージェント、スキルを含みます。`-p` を使用した[非対話モード](/docs/ja/headless)では、`/import` は見つけたものを一覧表示し、インポートを確認するコマンドを提供します。`--dry-run` を追加して何も書き込まずにプレビューするか、`--yes` を追加してインタラクティブなピッカーをスキップします。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、または [Claude apps gateway](/docs/ja/claude-apps-gateway#availability-and-limitations) 経由では利用できません。[フィーチャーフラグフェッチング](/docs/ja/env-vars#features-that-need-feature-flag-fetching)をオフにしている場合も利用できません。Cursor からのインポートには v2.1.265 以降が必要です |

105| `/init` | `CLAUDE.md` ガイドでプロジェクトを初期化します。`CLAUDE_CODE_NEW_INIT=1` を設定すると、スキル、フック、個人メモリファイルのウォークスルーも行うインタラクティブなフローになります。`/init` が OpenAI Codex または Google Gemini CLI の設定を見つけた場合、`/import` で引き継ぐことを提案します |105| `/init` | `CLAUDE.md` ガイドでプロジェクトを初期化します。`CLAUDE_CODE_NEW_INIT=1` を設定すると、スキル、フック、個人メモリファイルのウォークスルーも行うインタラクティブなフローになります。`/init` が OpenAI Codex または Google Gemini CLI の設定を見つけた場合、`/import` で引き継ぐことを提案します |

106| `/insights` | このマシンの最近のセッションを分析する HTML レポートを生成します:どのプロジェクトで作業するか、Claude Code をどのように使用するか、何が問題になるか、試すべき機能。[クラウドセッション](/docs/ja/claude-code-on-the-web)では利用できません。レポートの場所、保持、コストについては、[使用パターンを分析する](/docs/ja/costs#analyze-your-usage-patterns)を参照してください |106| `/insights` | このマシンの最近のセッションを分析する HTML レポートを生成します:どのプロジェクトで作業するか、Claude Code をどのように使用するか、何が問題になるか、試すべき機能。[クラウドセッション](/docs/ja/claude-code-on-the-web)では利用できません。レポートの場所、保持、コストについては、[使用パターンを分析する](/docs/ja/costs#analyze-your-usage-patterns)を参照してください |

107| `/install-github-app` | リポジトリの Claude GitHub App をインストールし、[GitHub Actions](/docs/ja/github-actions) ワークフローとシークレットをセットアップするオプションのステップを実行します。リポジトリを選択して統合を設定するウォークスルーを行います。github.com リポジトリでのみ機能します。リポジトリの git リモートが gitlab.com または bitbucket.org にある場合、コマンドは通知を出力してセットアップを開始する代わりに終了します。GitLab パイプラインから Claude Code を実行するには、[GitLab CI/CD](/docs/ja/gitlab-ci-cd) を参照してください |107| `/install-github-app` | リポジトリの Claude GitHub App をインストールし、[GitHub Actions](/docs/ja/github-actions) ワークフローとシークレットをセットアップするオプションのステップを実行します。リポジトリを選択して統合を設定するウォークスルーを行います。github.com リポジトリでのみ機能します。リポジトリの git リモートが gitlab.com または bitbucket.org にある場合、コマンドは通知を出力してセットアップを開始する代わりに終了します。GitLab パイプラインから Claude Code を実行するには、[GitLab CI/CD](/docs/ja/gitlab-ci-cd) を参照してください |


153| `/statusline` | Claude Code の[ステータスライン](/docs/ja/statusline)を設定します。何をしたいかを説明するか、引数なしで実行してシェルプロンプトから自動設定します |153| `/statusline` | Claude Code の[ステータスライン](/docs/ja/statusline)を設定します。何をしたいかを説明するか、引数なしで実行してシェルプロンプトから自動設定します |

154| `/stickers` | Claude Code ステッカーを注文します |154| `/stickers` | Claude Code ステッカーを注文します |

155| `/stop` | アタッチしている[バックグラウンドセッション](/docs/ja/agent-view)、または[ピーク返信](/docs/ja/agent-view#peek-and-reply)として送信した先のセッションを停止します。トランスクリプトと worktree は保持されます。停止せずにデタッチするには、`/exit` を使用するか、`←` を押します |155| `/stop` | アタッチしている[バックグラウンドセッション](/docs/ja/agent-view)、または[ピーク返信](/docs/ja/agent-view#peek-and-reply)として送信した先のセッションを停止します。トランスクリプトと worktree は保持されます。停止せずにデタッチするには、`/exit` を使用するか、`←` を押します |

156| `/subtask <task>` | [フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation)を生成します:完全な会話を継承し、ユーザーが作業を続けている間にタスクに取り組むバックグラウンドサブエージェントです。その結果は完了時にこの会話に戻ります。代わりに会話を別のバックグラウンドセッションにコピーするには、`/fork` を使用します。Claude Code v2.1.212 以降が必要です。v2.1.161 ~ v2.1.211 では、このコマンドは `/fork` です。[agent view がオフ](/docs/ja/agent-view#turn-off-agent-view)になっている場合、`/subtask` は利用できず、`/fork` がフォークされたサブエージェントの動作を維持します |156| `/subtask <task>` | [フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation)を生成します:完全な会話を継承し、ユーザーが作業を続けている間にタスクに取り組むバックグラウンドサブエージェントです。その結果は完了時にこの会話に戻ります。代わりに会話を別のバックグラウンドセッションにコピーするには、`/fork` を使用します。[agent view がオフ](/docs/ja/agent-view#turn-off-agent-view)になっている場合、`/subtask` は利用できず、代わりに `/fork` がフォークされたサブエージェントを生成します |

157| `/tasks` | 完了したサブエージェントを含む、現在のセッションのバックグラウンド作業を表示および管理します。`/bashes` としても利用可能です |157| `/tasks` | 完了したサブエージェントを含む、現在のセッションのバックグラウンド作業を表示および管理します。`/bashes` としても利用可能です |

158| `/team-onboarding` | Claude Code の使用履歴からチームオンボーディングガイドを生成します。Claude は過去 30 日間のセッション、コマンド、MCP サーバーの使用状況を分析し、チームメイトが最初のメッセージとして貼り付けて素早くセットアップできる markdown ガイドを生成します。Pro、Max、Team、Enterprise プランの claude.ai サブスクライバーには、チームメイトが Claude Code で直接開くことができる共有リンクも返します |158| `/team-onboarding` | Claude Code の使用履歴からチームオンボーディングガイドを生成します。Claude は過去 30 日間のセッション、コマンド、MCP サーバーの使用状況を分析し、チームメイトが最初のメッセージとして貼り付けて素早くセットアップできる markdown ガイドを生成します。Team および Enterprise プランの claude.ai サブスクライバーには、チームメイトが Claude Code で直接開くことができる共有リンクも返します |

159| `/teleport` | [クラウドセッション](/docs/ja/claude-code-on-the-web#from-cloud-to-terminal)をこのターミナルに取り込みます。ピッカーを開き、ブランチと会話をフェッチします。`/tp` としても利用可能です。claude.ai サブスクリプションが必要です |159| `/teleport` | [クラウドセッション](/docs/ja/claude-code-on-the-web#from-cloud-to-terminal)をこのターミナルに取り込みます。ピッカーを開き、ブランチと会話をフェッチします。`/tp` としても利用可能です。claude.ai サブスクリプションが必要です |

160| `/terminal-setup` | VS Code、Cursor、Devin Desktop、Alacritty、または Zed で[改行用の Shift+Enter キーボードショートカットをインストール](/docs/ja/terminal-config#enter-multiline-prompts)します。Apple Terminal では、代わりに[改行用に Option+Enter を有効にして、可聴ベルをオフ](/docs/ja/terminal-config#enable-option-key-shortcuts-on-macos)にします。iTerm2 では、[`/copy` が機能するようにクリップボードアクセスをオン](/docs/ja/terminal-config#enable-option-key-shortcuts-on-macos)にします |160| `/terminal-setup` | VS Code、Cursor、Devin Desktop、Alacritty、または Zed で[改行用の Shift+Enter キーボードショートカットをインストール](/docs/ja/terminal-config#enter-multiline-prompts)します。Apple Terminal では、代わりに[改行用に Option+Enter を有効にして、可聴ベルをオフ](/docs/ja/terminal-config#enable-option-key-shortcuts-on-macos)にします。iTerm2 では、[`/copy` が機能するようにクリップボードアクセスをオン](/docs/ja/terminal-config#enable-option-key-shortcuts-on-macos)にします |

161| `/theme` | カラーテーマを変更します。ターミナルの明るいまたは暗い背景に一致する `auto` オプション、明るいおよび暗い変種、色覚異常対応(daltonized)テーマ、ターミナルのカラーパレットを使用する ANSI テーマ、および `~/.claude/themes/` またはプラグインからの[カスタムテーマ](/docs/ja/terminal-config#create-a-custom-theme)を含みます。**New custom theme…** を選択して 1 つを作成します |161| `/theme` | カラーテーマを変更します。ターミナルの明るいまたは暗い背景に一致する `auto` オプション、明るいおよび暗い変種、色覚異常対応(daltonized)テーマ、ターミナルのカラーパレットを使用する ANSI テーマ、および `~/.claude/themes/` またはプラグインからの[カスタムテーマ](/docs/ja/terminal-config#create-a-custom-theme)を含みます。**New custom theme…** を選択して 1 つを作成します |

Details

120ランチャーが実行できない場合、Claude Code はプロセスをラップなしで起動する代わりに起動を拒否します。Windows では、[変数は無視され](#what-the-launcher-covers)、プロセスはラップなしで起動します。Claude Code はスクリプトをこれらのルールに保持します。120ランチャーが実行できない場合、Claude Code はプロセスをラップなしで起動する代わりに起動を拒否します。Windows では、[変数は無視され](#what-the-launcher-covers)、プロセスはラップなしで起動します。Claude Code はスクリプトをこれらのルールに保持します。

121 121 

122* **`exec "$@"` で終了する。** フォークして終了するランチャーは、バックグラウンドサービスが追跡できない孤立した Claude Code プロセスをバックグラウンドに残します。エージェントビューはそのようなセッションを失敗とマークし、ランチャーを名前で示すメッセージを表示し、サービスはランチャーが残したものを回収します。122* **`exec "$@"` で終了する。** フォークして終了するランチャーは、バックグラウンドサービスが追跡できない孤立した Claude Code プロセスをバックグラウンドに残します。エージェントビューはそのようなセッションを失敗とマークし、ランチャーを名前で示すメッセージを表示し、サービスはランチャーが残したものを回収します。

123* **引数を並べ替え、吸収、または前置しない。** 最初の引数は Claude Code バイナリで、その後のすべてはその argv です。123* **Claude Code の引数を並べ替え、吸収、または追加しない。** 先頭に来るランチャーの[独自の引数](#pass-arguments-to-the-launcher)を取り除き、残りは受け取ったとおりに `exec` に渡します。

124* **継承されたすべての環境変数を `exec` に渡す。** 注入された認証情報などの変数を追加することは問題ありませんが、継承されたものをドロップすることはできません。124* **継承されたすべての環境変数を `exec` に渡す。** 注入された認証情報などの変数を追加することは問題ありませんが、継承されたものをドロップすることはできません。

125 * セッションごとの認証トークン、モデルとプロバイダーの選択、および `CLAUDE_CODE_PROCESS_WRAPPER` 自体はすべて継承された環境で移動するため、許可リストから再構築するランチャーは起動するセッションを破壊し、`/status` はランチャーの不一致を報告します。125 * セッションごとの認証トークン、モデルとプロバイダーの選択、および `CLAUDE_CODE_PROCESS_WRAPPER` 自体はすべて継承された環境で移動するため、許可リストから再構築するランチャーは起動するセッションを破壊し、`/status` はランチャーの不一致を報告します。

126 * ランチャーが環境をリセットするネームスペースまたはサンドボックスに入る必要がある場合は、その内部で継承された環境を逐語的に再エクスポートします。126 * ランチャーが環境をリセットするネームスペースまたはサンドボックスに入る必要がある場合は、その内部で継承された環境を逐語的に再エクスポートします。

127* **ランチャーが実行されるたびに約 3 秒以内に `exec` に到達する。** コールドバックグラウンドディスパッチは最初の出力バイトの前にランチャーを 2 回連続で実行するため、シングルサインオン交換などの遅い作業を遅延またはキャッシュから実行します。127* **ランチャーが実行されるたびに約 3 秒以内に `exec` に到達する。** バックグラウンドセッションは、最初の出力の前にランチャーを 3 回連続で実行することがあります。シングルサインオン交換などの遅い作業は遅延実行するかキャッシュから実行し、ネットワークを待機するステップにはそれぞれ個別のタイムアウトを設定します。

128* **自身の内部から呼び出されることに耐える。** Claude Code はすべてのネストされた自己生成にランチャーを適用するため、排他的リソースを取得するランチャーはそれが既に保持していることを検出する必要があります。128* **自身の内部から呼び出されることに耐える。** Claude Code はすべてのネストされた自己生成にランチャーを適用するため、排他的リソースを取得するランチャーはそれが既に保持していることを検出する必要があります。

129* **Claude Code が起動する前にターミナルに書き込まない。** `exec` の前に出力されたものはすべて、セッションが初期化前に終了した場合のクラッシュ原因として報告されます。129* **Claude Code が起動する前にターミナルや標準出力に書き込まない。** `exec` の前に出力されたものはすべて、セッションが初期化前に終了した場合のクラッシュ原因として報告されます。また、標準出力へのテキストは、`claude -p` の結果を解析するスクリプトなど、Claude Code の出力を読み取るプログラムにも届いてしまいます。

130* **引数の表記方法に依存しない。** フラグの値は、独立した引数(`--flag value`)として渡される場合もあれば、フラグに結合された形(`--flag=value`)で渡される場合もあります。フラグがどちらの形式を使用するかは、バージョン間で変わる可能性があります。130* **引数の表記方法に依存しない。** フラグの値は、独立した引数(`--flag value`)として渡される場合もあれば、フラグに結合された形(`--flag=value`)で渡される場合もあります。フラグがどちらの形式を使用するかは、バージョン間で変わる可能性があります。

131* **ランチャーが起動したディレクトリから `exec` を実行する。** Claude Code は起動したディレクトリで作業するため、ディレクトリを変更するランチャーは誤ったプロジェクトでセッションを開始する可能性があります。ランチャーが作業ディレクトリをリセットするネームスペースまたはサンドボックスに入る必要がある場合は、`exec` の前に、その内部で起動時のディレクトリに戻ります。131* **ランチャーが起動したディレクトリから `exec` を実行する。** Claude Code は起動したディレクトリで作業するため、ディレクトリを変更するランチャーは誤ったプロジェクトでセッションを開始する可能性があります。ランチャーが作業ディレクトリをリセットするネームスペースまたはサンドボックスに入る必要がある場合は、`exec` の前に、その内部で起動時のディレクトリに戻ります。

132* **標準入力を読み取らない。** パスワードを尋ねるコマンドなど、`exec` の前に標準入力を読み取るコマンドは、来ない入力を待ち続けてセッションを停止させる可能性があります。また、Claude Code 向けの入力を奪ってしまい、セッションがその入力なしで実行され、エラーが報告されないこともあります。そのようなコマンドの入力は `/dev/null` からリダイレクトしてください。

133* **他のプログラムは絶対パスで呼び出す。** ランチャーは、シェルプロファイルが追加するディレクトリを含まない `PATH` で起動する場合があります。

132 134 

133<h3 id="format-of-the-launcher-value">135<h3 id="format-of-the-launcher-value">

134 ランチャー値の形式136 ランチャー値の形式


138 140 

139ランチャーに独自の引数を渡すには、パスの後に記述します。Claude Code は値をシェルコマンドではなく引数リストとして解析します。141ランチャーに独自の引数を渡すには、パスの後に記述します。Claude Code は値をシェルコマンドではなく引数リストとして解析します。

140 142 

141* 空白はトークンを区切り、二重引用符はスペースを含むトークンをグループ化します。143* 空白はトークンを区切り、二重引用符はスペースを含むトークンをグループ化します。一重引用符は通常の文字として扱われるため、`'a b'` は 2 つのトークンになります。

142* `[` で始まる値は JSON 文字列配列として読み込まれます(`["/opt/corp/launcher", "--profile", "cc"]` など)。144* `[` で始まる値は JSON 文字列配列として読み込まれます(`["/opt/corp/launcher", "--profile", "cc"]` など)。

143* シェル構文は機能しません。変数展開またはグロビングはなく、`;`、`|`、`&`、`$(` などの引用符なしの演算子は再解釈ではなく設定エラーとして拒否されます。145* シェル構文は機能しません。変数展開またはグロビングはなく、`;`、`|`、`&`、`$(` などの引用符なしの演算子は再解釈ではなく設定エラーとして拒否されます。

144 146 

145値を使用できない場合、Claude Code は影響を受けるプロセスの起動を拒否し、[理由を報告](/docs/ja/errors#claude_code_process_wrapper-launcher-errors)します。147値を使用できない場合、Claude Code は影響を受けるプロセスの起動を拒否し、[理由を報告](/docs/ja/errors#claude_code_process_wrapper-launcher-errors)します。

146 148 

149設定ファイルでは、配列形式を JSON 文字列の中に記述し、引用符をエスケープします: `"[\"/opt/corp/launcher\", \"--profile\", \"cc\"]"`。

150 

151<h3 id="pass-arguments-to-the-launcher">

152 ランチャーに引数を渡す

153</h3>

154 

155ランチャー独自の引数は[値](#format-of-the-launcher-value)のパスの後に記述し、スクリプト内で `exec` の呼び出し前に取り除きます。これらの引数は、Claude Code のコマンドより前に、最初にスクリプトに渡されます。次のスクリプトは値 `/opt/corp/launcher --profile cc` 用に書かれたもので、プロファイル名を保存してから、`shift` で両方の引数を取り除きます。

156 

157```bash theme={null}

158#!/bin/sh

159if [ "$1" = "--profile" ]; then

160 profile="$2"

161 shift 2

162fi

163# Your organization's setup for "$profile".

164exec "$@"

165```

166 

167Claude Code が値から解決した起動コマンドを確認するには、[検証ステップ](#set-up-the-launcher)を使用します。

168 

147<h2 id="relationship-to-claude_code_shell_prefix">169<h2 id="relationship-to-claude_code_shell_prefix">

148 `CLAUDE_CODE_SHELL_PREFIX` との関係170 `CLAUDE_CODE_SHELL_PREFIX` との関係

149</h2>171</h2>

desktop.md +332 −70

Details

44 セッションを開始する44 セッションを開始する

45</h2>45</h2>

46 46 

47最初のメッセージを送信する前に、プロンプト領域で 4 つのことを設定してください:47最初のメッセージを送信する前に、プロンプトボックスの下の行で環境、プロジェクトフォルダ、権限モード、モデルを選択してください:

48 48 

49* **環境**:Claude が実行される場所を選択します。ローカルマシンの場合は**Local**、アプリを閉じた後も継続する[クラウドセッション](#cloud-sessions)の場合は**Cloud**、管理するリモートマシンの場合は[**SSH 接続**](#ssh-sessions)を選択するか、Windows の場合は[**WSL ディストリビューション**](/docs/ja/desktop-wsl)を選択します。SSH セッション内のタスクは [Desktop が切断されている間も継続できます](#keep-a-task-running-while-desktop-is-disconnected)が、Claude アカウントを使用している場合は、サインインの有効期限が切れると停止することがあります。[環境設定](#environment-configuration)を参照してください。49* **環境**:行の最初のコントロールである環境セレクタを使用して、Claude が実行される場所を選択します。[環境設定](#environment-configuration)を参照してください。

50* **プロジェクトフォルダ**:Claude が作業するフォルダまたはリポジトリを選択します。クラウドセッションの場合、[複数のリポジトリ](#run-long-running-tasks-in-the-cloud)を追加できます。50 * 新しいセッションでプロンプトボックスの下に環境セレクタがない場合は、[以前のレイアウトの手順](#check-which-layout-you-have)に従ってください。

51* **モデル**:送信ボタンの横のドロップダウンから[モデル](/docs/ja/model-config#available-models)を選択します。セッション中にこれを変更できます。51* **プロジェクトフォルダ**:環境セレクタの隣にあるプロジェクトフォルダコントロールをクリックして、Claude が作業するフォルダを選択します。

52* **権限モード**:[モードセレクタ](#choose-a-permission-mode)から Claude がどの程度の自律性を持つかを選択します。セッション中にこれを変更できます。52 * **クラウドセッション**:フォルダの代わりに[リポジトリ](#run-long-running-tasks-in-the-cloud)を選択します

53 * **[保存済みのローカルまたは SSH 環境](#create-a-saved-environment)**:環境がすでにフォルダを保持しているため、行にはプロジェクトフォルダコントロールが表示されません。フォルダを変更するには、[環境を編集](#use-edit-or-remove-a-saved-environment)します。

54* **権限モード**:[モードセレクタ](#choose-a-permission-mode)を使用して、Claude がどの程度の自律性を持つかを選択します。セッション中に権限モードを変更できます。

55* **モデル**:行の右端寄りにあるモデルピッカーから[モデル](/docs/ja/model-config#available-models)を選択します。セッション中にモデルを変更できます。

53 56 

54タスクを入力して**Enter**キーを押してセッションを開始します。各セッションは独自のコンテキストと変更を追跡します。57タスクを入力して**Enter**キーを押してセッションを開始します。各セッションは独自のコンテキストと変更を追跡します。

55 58 


82 ファイルとコンテキストをプロンプトに追加する85 ファイルとコンテキストをプロンプトに追加する

83</h3>86</h3>

84 87 

85プロンプトボックスは外部コンテキストを取り込む 2 つの方法をサポートしています:88Claude にファイルを渡すには、プロンプトボックスでファイルを @mention するか添付します:

86 89 

87* **@mention ファイル**:`@`の後にファイル名を入力して、ファイルを会話コンテキストに追加します。Claude はそのファイルを読み取り、参照できます。@mention はクラウドセッションおよび WSL セッションでは利用できません。90* **@mention ファイル**:`@` の後にファイル名を入力して、ファイルを会話コンテキストに追加します。

88* **ファイルを添付**:添付ボタンを使用するか、ファイルをプロンプトに直接ドラッグアンドドロップして、画像、PDF、およびその他のファイルをプロンプトに添付します。これはバグのスクリーンショット、デザインモックアップ、または参照ドキュメントを共有するのに便利です。91 * **クラウドセッションの場合**:`@` でファイルを一覧表示できるのは、最初のメッセージを送信した後のみです。`@` で何も表示されない場合は、ファイルなしで最初のメッセージを送信し、次のメッセージでそのファイルを @mention します。

92* **ファイルを添付**:プロンプトボックスの横の **+** ボタンから画像、PDF、およびその他のファイルをプロンプトに添付するか、ファイルをプロンプトに直接ドラッグアンドドロップします。これはバグのスクリーンショット、デザインモックアップ、または参照ドキュメントを共有するのに便利です。

93 * **[WSL セッション](/docs/ja/desktop-wsl)の場合**:**+** メニューに **Add files or photos** ではなく **Add image** が表示される場合、添付できるのは画像のみです。セッションのフォルダにあるその他のファイルを Claude に渡すには、そのファイルを @mention します。

89 94 

90<h3 id="choose-a-permission-mode">95<h3 id="choose-a-permission-mode">

91 権限モードを選択する96 権限モードを選択する

92</h3>97</h3>

93 98 

94権限モードは、セッション中に Claude がどの程度の自律性を持つかを制御します:ファイルの編集、コマンドの実行、またはその両方の前に確認するかどうかです。送信ボタンの横のモードセレクタを使用して、いつでも権限モードを切り替えることができます。各変更を自分で承認するには、Manual に切り替えます。99権限モードは、セッション中に Claude がどの程度の自律性を持つかを制御します:ファイルの編集、コマンドの実行、またはその両方の前に確認するかどうかです。プロンプトボックスの下の行にあるモードセレクタを使用して、いつでも権限モードを切り替えることができます。各変更を自分で承認するには、Manual に切り替えます。

95 100 

96新しいローカルセッションのデフォルトモードを設定するには、[設定ファイル](/docs/ja/settings#where-settings-live)に`permissions.defaultMode`を追加します。デスクトップアプリは CLI と同じ設定ファイルを読み取ります。セレクタで選択したモードはフォルダごとに記憶され、そのフォルダの`defaultMode`より優先されます。ただし Plan は現在のセッションにのみ適用されます。101新しいローカルセッションのデフォルトモードを設定するには、[設定ファイル](/docs/ja/settings#where-settings-live)に`permissions.defaultMode`を追加します。デスクトップアプリは CLI と同じ設定ファイルを読み取ります。セレクタで選択したモードはフォルダごとに記憶され、そのフォルダの`defaultMode`より優先されます。ただし Plan は現在のセッションにのみ適用されます。

97 102 


129 134 

130Claude は dev サーバーを起動し、Browser ペインで開いて変更を確認できます。これはフロントエンド Web アプリとバックエンドサーバーの両方で機能します:Claude は API エンドポイントをテストし、サーバーログを表示し、見つけた問題を反復処理できます。ほとんどの場合、Claude はプロジェクトファイルを編集した後、サーバーを自動的に起動します。いつでも Claude にプレビューを要求することもできます。デフォルトでは、Claude は編集後に[変更を自動検証](#auto-verify-changes)します。135Claude は dev サーバーを起動し、Browser ペインで開いて変更を確認できます。これはフロントエンド Web アプリとバックエンドサーバーの両方で機能します:Claude は API エンドポイントをテストし、サーバーログを表示し、見つけた問題を反復処理できます。ほとんどの場合、Claude はプロジェクトファイルを編集した後、サーバーを自動的に起動します。いつでも Claude にプレビューを要求することもできます。デフォルトでは、Claude は編集後に[変更を自動検証](#auto-verify-changes)します。

131 136 

132Browser ペインは、プロジェクトから静的 HTML ファイル、PDF、画像、およびビデオを開くこともできます。チャットで HTML、PDF、画像、またはビデオパスをクリックして、Browser ペインで開きます。137ローカルセッションでは、チャットで HTML、PDF、またはビデオのパスをクリックすると、Browser ペインで開きます。

133 138 

134<Note>139<Note>

135 [SSH セッション](#ssh-sessions)では、Claude は Browser ペインのツールを利用できないため、Browser ペインでアプリを開くことができません。アプリを自分で確認するには、[そのポートをコンピューターに転送](#reach-a-port-on-the-remote-machine)します。140 [SSH セッション](#ssh-sessions)では、Claude は Browser ペインのツールを利用できないため、Browser ペインでアプリを開くことができません。アプリを自分で確認するには、[そのポートをコンピューターに転送](#reach-a-port-on-the-remote-machine)します。

136</Note>141</Note>

137 142 

143ローカルセッションで Claude がサーバーを起動した後に Browser ペインが開いていない場合は、チャット内のサーバーのカードにある **Open** をクリックします。

144 

138Browser ペインから、以下を実行できます:145Browser ペインから、以下を実行できます:

139 146 

140* Browser ペインで実行中のアプリと直接対話する147* Browser ペインで実行中のアプリと直接対話する


185 差分ビューで変更を確認する192 差分ビューで変更を確認する

186</h3>193</h3>

187 194 

188Claude がコードに変更を加えた後、差分ビューを使用して、プルリクエストを作成する前にファイルごとに変更を確認できます。195Claude がコードに変更を加えた後、差分ビューを使用して、プルリクエストを作成する前にファイルごとに変更を確認できます。差分ビューを開くには、[セッション詳細パネル](#see-session-details)の **Changes** カードにある `+12 -1` などの行数をクリックします。セッションのタイトルバーにある **Changes** をクリックすることもできます。

189 

190Claude がファイルを変更すると、`+12 -1`などの追加および削除された行数を示す差分統計インジケータが表示されます。このインジケータをクリックして差分ビューアを開きます。左側にファイルリストが表示され、右側に各ファイルの変更が表示されます。

191 196 

192特定の行にコメントするには、差分内の任意の行をクリックしてコメントボックスを開きます。フィードバックを入力して**Enter**キーを押してコメントを追加します。複数の行にコメントを追加した後、すべてのコメントを一度に送信します:197特定の行にコメントするには、差分内の任意の行をクリックしてコメントボックスを開きます。フィードバックを入力して**Enter**キーを押してコメントを追加します。複数の行にコメントを追加した後、すべてのコメントを一度に送信します:

193 198 


213 プルリクエストステータスを監視する218 プルリクエストステータスを監視する

214</h3>219</h3>

215 220 

216プルリクエストを開いた後、CI ステータスバーがセッションに表示されます。Claude Code は GitHub CLI を使用してチェック結果をポーリングし、失敗を表示します。221Claude に失敗したチェックを修正させる、または GitHub にプルリクエストをマージさせるには、**Auto-fix** または **Merge when ready** をオンにします。プルリクエストを開くと、そのプルリクエストが CI チェックのステータスとともに[セッション詳細パネル](#see-session-details)の **Changes** カードに表示されます。タイトルの横にある **⋮** メニューを開きます:

217 222 

218* **Auto-fix CI & address comments**:有効にすると、Claude は失敗出力を読み取り、反復することで、失敗した CI チェックを自動的に修正しようとします。ローカルセッションでは、ユーザー以外の人が残した新しいレビューコメントにも Claude が対応します。対象となるのは、コメントの作成者がリポジトリのオーナー、組織のメンバー、コラボレーター、または GitHub App である場合です。223* **Auto-fix**:ローカルセッションでは、ユーザー以外の人が残した新しいレビューコメントにも Claude が対応します。コメントの作成者は、リポジトリのオーナー、組織のメンバー、コラボレーター、または GitHub App である必要があります。

219* **Auto-merge when ready**:有効にすると、Claude はすべてのチェックが成功したら PR をマージします。マージ方法はスカッシュです。先に [GitHub リポジトリ設定](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository)で auto-merge を有効にしてください。有効になっていない場合、Claude は PR をマージできません。224* **Merge when ready**:PR に対して GitHub の auto-merge をオンにします。ローカルセッションでは、ベースブランチがマージキューを使用していない限り、Desktop はスカッシュマージを要求します。

225 * **SSH および WSL セッションの場合**:**Merge when ready** は無効になっているため、GitHub でプルリクエストの auto-merge をオンにします

226 * **リポジトリが auto-merge を許可していない場合**:**Merge when ready** はオンにならないため、先に [GitHub リポジトリ設定](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository)で auto-merge を有効にします

227* **[以前のレイアウト](#check-which-layout-you-have)**:セッションにプルリクエストができたら、ステータスバーの **CI** をクリックします。

220 228 

221これらをオンにするには、ステータスバーの **CI** をクリックします。PR がマージまたはクローズされた後にセッションを自動的にアーカイブするには、**Settings > Claude Code** で[auto-archive](#work-in-parallel-with-sessions)をオンにします。229PR がマージまたはクローズされた後にセッションを自動的にアーカイブするには、**Settings > Claude Code** で[auto-archive](#archive-a-session)をオンにします。

222 230 

223<Note>231<Note>

224 PR 監視には、[GitHub CLI(`gh`)](https://cli.github.com/)がマシンにインストールされ、認証されている必要があります。`gh`がインストールされていない場合、Desktop は PR を作成しようとする最初の時点でインストールを促します。232 PR 監視には、[GitHub CLI(`gh`)](https://cli.github.com/)がマシンにインストールされ、認証されている必要があります。`gh`がインストールされていない場合、Desktop は PR を作成しようとする最初の時点でインストールを促します。


235複数の画面で作業するには、diff やターミナルなどのペインをポップアウトして独立したウィンドウにし、完了したらドックバックします。Claude はメインウィンドウで作業を続けます。243複数の画面で作業するには、diff やターミナルなどのペインをポップアウトして独立したウィンドウにし、完了したらドックバックします。Claude はメインウィンドウで作業を続けます。

236 244 

237<Note>245<Note>

238 このセクションのペインレイアウト、ターミナル、ファイルエディタ、およびビューモードには Claude Desktop v1.2581.0 以降が必要です。macOS では**Claude → Check for Updates**を、Windows では**Help → Check for Updates**を開いて更新してください。246 このセクションのペインレイアウト、ターミナル、ファイルエディタ、およびビューモードには Claude Desktop v1.2581.0 以降が必要です。macOS では\*\*Claude > Check for Updates…**を、Windows では**Help > Check for Updates…\*\*を開いて更新してください。

239</Note>247</Note>

240 248 

249<h3 id="see-session-details">

250 セッションの詳細を確認する

251</h3>

252 

253セッション詳細パネルは、チャットの横に表示されるカードのセットで、セッションの実行場所、変更内容、実行中の内容を表示します。このパネルはセッションを開始した後、チャットの幅が十分にある場合に表示されます。

254 

255<h4 id="hide-or-show-the-session-details-panel">

256 セッション詳細パネルを表示または非表示にする

257</h4>

258 

259パネルを表示または非表示にするには、セッションのタイトルバー、またはウィンドウの幅が狭い場合はバーの\*\*⋮**メニューで、**Hide session rail**または**Show session rail\*\*をクリックします。それでもパネルが表示されない場合は、[使用している Code タブのレイアウトを確認してください](#check-which-layout-you-have)。

260 

241<h3 id="run-commands-in-the-terminal">261<h3 id="run-commands-in-the-terminal">

242 ターミナルでコマンドを実行する262 ターミナルでコマンドを実行する

243</h3>263</h3>

244 264 

245統合ターミナルを使用すると、別のアプリに切り替えることなく、セッションと並行してコマンドを実行できます。セッションのタイトルバーにある**Terminal**をクリックするか、macOS または Windows で**Ctrl+\`**を押します。ターミナルはセッションの作業ディレクトリで開き、Claude と同じ環境を共有するため、`npm test`や`git status`などのコマンドは Claude が編集しているのと同じファイルを見ます。2 番目のターミナルタブを開くには、ターミナルペインヘッダーの**+**をクリックするか、チャットのフォルダを右クリックして**Open in terminal**を選択します。265統合ターミナルを使用すると、別のアプリに切り替えることなく、セッションと並行してコマンドを実行できます。セッションのタイトルバーにある**Terminal**をクリックするか、macOS または Windows で**Ctrl+\`**を押します。ターミナルはセッションの作業ディレクトリで開き、Claude と同じ環境を共有するため、`npm test`や`git status`などのコマンドは Claude が編集しているのと同じファイルを見ます。2 番目のターミナルタブを開くには、ターミナルペインヘッダーの**+**をクリックするか、チャットのフォルダを右クリックして**Open in terminal**を選択します。

246 266 

247ターミナルはローカルおよび [SSH](#ssh-sessions) セッションで利用可能ですが、[Windows リモートマシン](#windows-remote-machines)では制限があります。267WSL セッションでターミナルがない場合は、[ターミナルまたはコネクタが利用できない場合](/docs/ja/desktop-wsl#check-for-the-terminal-and-connectors)を参照してください。ターミナルはローカルおよび [SSH](#ssh-sessions) セッションで利用可能ですが、[Windows リモートマシン](#windows-remote-machines)では制限があります。

248 268 

249<h3 id="open-and-edit-files">269<h3 id="open-and-edit-files">

250 ファイルを開いて編集する270 ファイルを開いて編集する

251</h3>271</h3>

252 272 

253チャットまたは diff ビューアのファイルパスをクリックして、ファイルペインで開きます。HTML、PDF、画像、およびビデオパスは代わりに[ブラウザペイン](#preview-your-app)で開きます。スポット編集を行い、**Save**をクリックして書き戻します。ファイルを開いてからディスク上で変更された場合、ペインは警告を表示し、上書きまたは破棄できます。**Discard**をクリックして編集を元に戻すか、ペインヘッダーのパスをクリックして絶対パスをコピーします。273Claude が言及したファイルを開くには、チャット内のそのパスをクリックします。

254 274 

255ファイルペインはローカルおよび SSH セッションで利用可能です。クラウドセッションの場合、Claude に変更を加えるよう依頼します。275ファイルを自分で編集するには、[ファイルペイン](#arrange-your-workspace)を使用します:

276 

277* **ローカルセッション**:セッションの作業ディレクトリ内のファイルを編集できます。ただし、`.mcp.json`や`.claude/settings.json`など、一部の表示専用ファイルは除きます。これらを変更するには、[別のアプリで開いてください](#open-files-in-other-apps)。

278* **クラウド、SSH、WSL セッション**:ファイルペインは表示専用のため、Claude に編集を依頼してください。

279 

280<h4 id="save-edits-in-the-file-pane">

281 ファイルペインで編集内容を保存する

282</h4>

283 

284デフォルトでは、ファイルペインでの編集は自動的に保存されるため、ペインに**Save**ボタンは表示されません。編集内容を自分で保存するには、ペインの\*\*⋮**メニューで**Auto save**のチェックを外します。**Auto save**がオフの場合は、ファイルを変更した後に**Save\*\*をクリックして編集内容を書き込むか、**Cancel**をクリックして元に戻します。

285 

286ファイルがディスク上で変更されたことをペインが警告した場合は、**Override**をクリックしてディスク上のバージョンを編集内容で上書きするか、**Discard**をクリックして編集内容を破棄します。

256 287 

257<h3 id="open-files-in-other-apps">288<h3 id="open-files-in-other-apps">

258 ファイルを他のアプリで開く289 ファイルを他のアプリで開く


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

284</h3>315</h3>

285 316 

286macOS で**Cmd+/**を、Windows で**Ctrl+/**を押して、Code タブで利用可能なすべてのショートカットを表示します。Windows では、以下のショートカットに対して**Cmd**の代わりに**Ctrl**を使用します。セッションサイクリング、ターミナルトグル、およびビューモードトグルはすべてのプラットフォームで**Ctrl**を使用します。317macOS で\*\*Cmd+/**を、Windows で**Ctrl+/\*\*を押して、Code タブで利用可能なすべてのショートカットを表示します。このセクションの表は macOS のキーを示しています。Windows および Linux では、以下のキーを置き換えてください:

318 

319* **Cmd+Option**:**Alt**を押す

320* **Cmd**:**Ctrl**を押す

321 

322セッションサイクリング、ターミナルトグル、およびビューモードトグルはすべてのプラットフォームで**Ctrl**を使用します。

287 323 

288| ショートカット | アクション |324| ショートカット | アクション |

289| - | - |325| - | - |

290| `Cmd` `/` | キーボードショートカットを表示 |326| `Cmd` `/` | キーボードショートカットを表示 |

291| `Cmd` `N` | 新しいセッション |327| `Cmd` `N` | 新しいセッション |

328| `Cmd` `Option` `1`–`9` | [現在のレイアウト](#check-which-layout-you-have)の新しいセッション画面で、環境を選択 |

329| `Cmd` `Option` `0` | 現在のレイアウトの新しいセッション画面で、[**New environment** ダイアログ](#create-a-saved-environment)を開く |

292| `Cmd` `W` | セッションを閉じる |330| `Cmd` `W` | セッションを閉じる |

293| `Ctrl` `Tab` / `Ctrl` `Shift` `Tab` | 次または前のセッション |331| `Ctrl` `Tab` / `Ctrl` `Shift` `Tab` | 次または前のセッション |

294| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | 次または前のセッション |332| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | 次または前のセッション |


404 セッションで並列に作業する442 セッションで並列に作業する

405</h3>443</h3>

406 444 

407サイドバーの\*\*+ New session**をクリックするか、macOS で**Cmd+N**を、Windows で**Ctrl+N**を押して、複数のタスクを並列で作業します。**Ctrl+Tab**と**Ctrl+Shift+Tab**を押してサイドバーのセッションをサイクルします。Git リポジトリの場合、ブランチ名の横の**worktree\*\*オプションを選択すると、[Git worktrees](/docs/ja/worktrees)を使用して、セッションにプロジェクトの独立した分離コピーを与えることができます。445サイドバーの **+ New** をクリックするか、macOS で **Cmd+N** を、Windows で **Ctrl+N** を押して、複数のタスクを並列で作業します。**Ctrl+Tab** と **Ctrl+Shift+Tab** を押してサイドバーのセッションをサイクルします。

408 446 

4092 つのセッションを同時に表示するには、macOS で**Cmd**を、Windows で**Ctrl**を押しながらサイドバーのセッションをクリックします。セッションは既に開いているセッションの横の 2 番目のペインで開きます。分割がアクティブな間、別のサイドバーセッションをクリックすると、フォーカスがあるペインが置き換わります。macOS で\*\*Cmd+\\**を、Windows で**Ctrl+\\\*\*を押して、フォーカスされたペインを閉じて、単一のセッションに戻ります。4472 つのセッションを同時に表示するには、macOS で**Cmd**を、Windows で**Ctrl**を押しながらサイドバーのセッションをクリックします。セッションは既に開いているセッションの横の 2 番目のペインで開きます。分割がアクティブな間、別のサイドバーセッションをクリックすると、フォーカスがあるペインが置き換わります。macOS で\*\*Cmd+\\**を、Windows で**Ctrl+\\\*\*を押して、フォーカスされたペインを閉じて、単一のセッションに戻ります。

410 448 

449<h4 id="run-a-session-in-its-own-worktree">

450 セッションを独自の worktree で実行する

451</h4>

452 

453Git リポジトリであるプロジェクトでは、セッションを開始する前に **Worktree** をオンにすると、プロジェクトの分離されたコピーである独自の [Git worktree](/docs/ja/worktrees) でセッションを実行できます。デフォルトでは **Worktree** はオフで、Claude はプロジェクトフォルダ自体で作業します。[プロンプトボックスの下の行](#start-a-session)にあるプロジェクトフォルダのコントロールをクリックし、**Worktree** をオンにします。

454 

455* **[保存済み環境](#create-a-saved-environment)を使用する場合**:環境を作成または編集するときに **Worktree** を設定します

456* **[以前のレイアウト](#check-which-layout-you-have)**:プロンプトボックスの上にあるブランチ名の横の **worktree** チェックボックスを選択します

457 

411Worktrees はデフォルトで`<project-root>/.claude/worktrees/`に保存されます。これはカスタムディレクトリに変更できます:458Worktrees はデフォルトで`<project-root>/.claude/worktrees/`に保存されます。これはカスタムディレクトリに変更できます:

412 459 

413* **ローカルセッション**:**Settings > Claude Code** で **Worktree location** を設定します460* **ローカルセッション**:**Settings > Claude Code** で **Worktree location** を設定します


415 462 

416**Settings > Claude Code** で **Branch prefix** を設定することもできます。Desktop はすべての worktree ブランチ名の前にこれを付加するため、Claude が作成したブランチを整理するのに便利です。463**Settings > Claude Code** で **Branch prefix** を設定することもできます。Desktop はすべての worktree ブランチ名の前にこれを付加するため、Claude が作成したブランチを整理するのに便利です。

417 464 

418完了したら、サイドバーのセッションにマウスを合わせてアーカイブアイコンをクリックして worktree を削除します。プルリクエストがマージまたはクローズされたときにセッションを自動的にアーカイブするには、**Settings > Claude Code** で **Auto-archive after PR merge or close** をオンにします。Auto-archive は実行が完了したローカルセッションにのみ適用されます。

419 

420gitignored ファイル(`.env`など)を新しい worktrees に含めるには、プロジェクトルートに[`.worktreeinclude`ファイル](/docs/ja/worktrees#copy-gitignored-files-into-worktrees)を作成します。worktree セッションがプロジェクト設定、フック、スキルをどこから読み取るかについては、[worktree がメインのチェックアウトと共有するもの](/docs/ja/worktrees#what-worktrees-share-with-the-main-checkout)を参照してください。465gitignored ファイル(`.env`など)を新しい worktrees に含めるには、プロジェクトルートに[`.worktreeinclude`ファイル](/docs/ja/worktrees#copy-gitignored-files-into-worktrees)を作成します。worktree セッションがプロジェクト設定、フック、スキルをどこから読み取るかについては、[worktree がメインのチェックアウトと共有するもの](/docs/ja/worktrees#what-worktrees-share-with-the-main-checkout)を参照してください。

421 466 

422<Note>467<Note>

423 セッション分離には[Git](https://git-scm.com/downloads)が必要です。ほとんどの Mac には Git がデフォルトで含まれています。Terminal で`git --version`を実行して確認してください。バージョン番号が表示されれば、Git がインストールされています。Git エラーが発生した場合は、[Cowork タブ](https://claude.com/product/cowork)で Claude に助けを求めてセットアップのトラブルシューティングを行ってください。468 セッション分離には[Git](https://git-scm.com/downloads)が必要です。ほとんどの Mac には Git がデフォルトで含まれています。Terminal で`git --version`を実行して確認してください。バージョン番号が表示されれば、Git がインストールされています。Git エラーが発生した場合は、[Cowork タブ](https://claude.com/product/cowork)で Claude に助けを求めてセットアップのトラブルシューティングを行ってください。

424</Note>469</Note>

425 470 

426サイドバーの上部のコントロールを使用して、ステータス、プロジェクト、または環境でセッションをフィルタリングし、プロジェクトでセッションをグループ化します。セッション名を変更するには、アクティブセッションの上部のツールバーのセッションタイトルをクリックします。471<h3 id="add-folders-to-a-session">

472 セッションにフォルダを追加する

473</h3>

474 

475フォルダはセッションの開始前または実行中に追加できます:

476 

477* **ローカルセッションの開始前**:[保存済み環境を作成](#create-a-saved-environment)または編集するときに **Folders** の下にフォルダを追加し、[その保存済み環境からセッションを開始](#use-edit-or-remove-a-saved-environment)します。

478* **ローカルまたは [SSH](#ssh-sessions) セッションの実行中**:プロンプトボックスの横の **+** をクリックし、**Add folder** を選択します。Claude は [worktree](#run-a-session-in-its-own-worktree) を使わず、そのフォルダ自体で作業します。

479 

480<h3 id="archive-a-session">

481 セッションをアーカイブする

482</h3>

483 

484worktree にコミットされていない変更があるセッションをアーカイブする前に、[セッションのアーカイブ時にコミットされていない変更を保持する](#keep-uncommitted-changes-when-a-session-is-archived)を参照してください。セッションをアーカイブするには、サイドバーでセッションにマウスを合わせてメニューを開き、**Archive** を選択します。セッションは[アーカイブ済みセッション](#organize-and-find-sessions)に移動します。

485 

486プルリクエストがマージまたはクローズされたときにセッションを自動的にアーカイブするには、**Settings > Claude Code** で **Auto-archive after PR merge or close** をオンにします。クラウドセッションとまだ実行中のセッションは自動的にアーカイブされません。

487 

488<h4 id="keep-uncommitted-changes-when-a-session-is-archived">

489 セッションのアーカイブ時にコミットされていない変更を保持する

490</h4>

491 

492セッションがアーカイブされると、セッションの worktree にあるコミットされていない変更が失われる可能性があるため、保持したいものは先にコミットしてください:

493 

494* **Desktop が変更について確認してきた場合**:**Archive anyway** を選択して変更を破棄するか、キャンセルしてコミットします

495* **変更が追跡されていないファイルのみの場合**:セッション内で Claude が作成したプルリクエストがマージされる前に、保持したいファイルをコミットします。マージ後は Desktop が確認なしにそれらを削除できるためです

496* **それ以外の場合**:worktree は変更とともにディスク上に残ります。ローカルセッションの場合、Desktop はセッションがアーカイブされた時点または最後にセッションを開いた時点のいずれか遅いほうから約 30 日後に、その両方を削除します。変更を保持するには、[**Archived** タブ](#organize-and-find-sessions)からセッションを開き、**Unarchive** を選択します

497 

498<h3 id="organize-and-find-sessions">

499 セッションを整理して見つける

500</h3>

501 

502セッションのグループ化、並べ替え、検索は、サイドバーのセッションリストにあるアイコンから行います:

503 

504* **現在のレイアウト**:セッションリストの見出しにマウスを合わせると **Group and sort** アイコンが表示されるので、それをクリックします。アーカイブ済みセッションを見つけるには、メニューの最後の行である **View all** を選択し、**Archived** タブを開きます。

505* **[以前のレイアウト](#check-which-layout-you-have)**:**Filter** アイコンはマウスを合わせなくても表示されます。これをクリックし、**Group by** または **Sort by** でリストを整理します。アーカイブ済みセッションを表示するには、**Status** を選択し、次に **Archived** を選択します。

506 

507セッション名を変更するには、セッションを開いてタイトルバーのセッションタイトルをクリックします。

508 

509<h3 id="check-and-free-up-context">

510 コンテキストを確認して解放する

511</h3>

427 512 

428コンテキスト使用状況を確認するには、[使用状況を確認する](#check-usage)を参照してください。コンテキストがいっぱいになると、Claude は自動的に会話を要約して作業を続けます。`/compact`を入力して要約をより早くトリガーし、コンテキストスペースを解放することもできます。[コンテキストウィンドウ](/docs/ja/how-claude-code-works#the-context-window)を参照して、圧縮がどのように機能するかについての詳細を確認してください。513コンテキスト使用状況を確認するには、[使用状況を確認する](#check-usage)を参照してください。コンテキストがいっぱいになると、Claude は自動的に会話を要約して作業を続けます。`/compact`を入力して要約をより早くトリガーし、コンテキストスペースを解放することもできます。[コンテキストウィンドウ](/docs/ja/how-claude-code-works#the-context-window)を参照して、圧縮がどのように機能するかについての詳細を確認してください。

429 514 

515<h3 id="get-notified-when-a-session-finishes">

516 セッションの完了時に通知を受け取る

517</h3>

518 

430デスクトップアプリは、Code セッションがタスクを完了し、現在そのセッションを表示していない場合に OS 通知を送信します。[プロジェクト](/docs/ja/claude-projects#see-what-needs-you-in-overview)に属するセッションの場合、代わりにプロジェクトの通知を受け取ります。519デスクトップアプリは、Code セッションがタスクを完了し、現在そのセッションを表示していない場合に OS 通知を送信します。[プロジェクト](/docs/ja/claude-projects#see-what-needs-you-in-overview)に属するセッションの場合、代わりにプロジェクトの通知を受け取ります。

431 520 

432<h3 id="ask-a-side-question-without-derailing-the-session">521<h3 id="ask-a-side-question-without-derailing-the-session">


451 セッション間で作業する540 セッション間で作業する

452</h3>541</h3>

453 542 

454Claude は他の Code タブセッションをリストアップし、各セッションが何をしてきたかを読み取り、セッション間でメッセージを送信できます。平易な言語で尋ねてください:「どのセッションが認証リファクタリングに触れましたか?」、「API セッションは何を結論づけましたか?」、または「支払いセッションにスキーマが変更されたことを伝えてください」。また、Claude にセッションの名前変更またはアーカイブを依頼することもできます。Claude はサイドバーのアーカイブアイコンと同じ方法でセッションをアーカイブするため、PR がマージされたセッションをクリーンアップするよう依頼してください。543Claude は他の Code タブセッションをリストアップし、各セッションが何をしてきたかを読み取り、セッション間でメッセージを送信できます。平易な言語で尋ねてください:「どのセッションが認証リファクタリングに触れましたか?」、「API セッションは何を結論づけましたか?」、または「支払いセッションにスキーマが変更されたことを伝えてください」。

544 

545また、Claude にセッションの名前変更またはアーカイブを依頼することもできます。たとえば、PR がマージされたセッションをアーカイブするよう依頼してください。

455 546 

456このサーフェスを通じて、Claude はデスクトップアプリが自身で実行するセッションのみを見ます:ローカル、[SSH](#ssh-sessions)、および Code タブの[WSL](/docs/ja/desktop-wsl)セッション。Claude はクラウドセッション、またはターミナル CLI または VS Code 拡張機能から開始したセッションを見ません。同じプロジェクトの worktrees にあっても見ません。そのため、9 つのターミナル worktrees が開いていて 2 つのデスクトップセッションがある場合、それらの 1 つで回答する Claude は他の 1 つのデスクトップセッションを報告します。Claude は質問しているセッションをリストアップしません。デフォルトでは、最近アクティブな 20 個のセッションを見て、アーカイブされたセッションをスキップします。ただし、それらを要求する場合を除きます。[クロスセッションメッセージング](/docs/ja/cross-session-messaging)は、Claude が[他の Claude Code セッション](/docs/ja/cross-session-messaging#see-which-sessions-claude-can-reach)(ターミナルセッションを含む)にメッセージを送信することを別途許可します。547このサーフェスを通じて、Claude はデスクトップアプリが自身で実行するセッションのみを見ます:ローカル、[SSH](#ssh-sessions)、および Code タブの[WSL](/docs/ja/desktop-wsl)セッション。Claude はクラウドセッション、またはターミナル CLI または VS Code 拡張機能から開始したセッションを見ません。同じプロジェクトの worktrees にあっても見ません。そのため、9 つのターミナル worktrees が開いていて 2 つのデスクトップセッションがある場合、それらの 1 つで回答する Claude は他の 1 つのデスクトップセッションを報告します。Claude は質問しているセッションをリストアップしません。デフォルトでは、最近アクティブな 20 個のセッションを見て、アーカイブされたセッションをスキップします。ただし、それらを要求する場合を除きます。[クロスセッションメッセージング](/docs/ja/cross-session-messaging)は、Claude が[他の Claude Code セッション](/docs/ja/cross-session-messaging#see-which-sessions-claude-can-reach)(ターミナルセッションを含む)にメッセージを送信することを別途許可します。

457 548 


470 長時間実行されるタスクをクラウドで実行する561 長時間実行されるタスクをクラウドで実行する

471</h3>562</h3>

472 563 

473大規模なリファクタリング、テストスイート、マイグレーション、またはその他の長時間実行されるタスクの場合、セッションを開始するときに**Local**の代わりに**Cloud**を選択します。クラウドセッションはデフォルトで Anthropic が管理するインフラストラクチャで実行され、アプリを閉じたりコンピュータをシャットダウンしたりしても続行します。いつでも戻ってきて進捗を確認するか、Claude を別の方向に導くことができます。[claude.ai/code](https://claude.ai/code)または[Claude モバイルアプリ](/docs/ja/mobile)からクラウドセッションを監視することもできます。564大規模なリファクタリング、テストスイート、マイグレーション、またはその他の長時間実行されるタスクの場合、セッションを開始するときに[環境セレクター](#start-a-session)の **Cloud** の下にある環境を選択します。クラウドセッションはデフォルトで Anthropic が管理するインフラストラクチャで実行され、アプリを閉じたりコンピュータをシャットダウンしたりしても続行します。いつでも戻ってきて進捗を確認するか、Claude を別の方向に導くことができます。[claude.ai/code](https://claude.ai/code)または[Claude モバイルアプリ](/docs/ja/mobile)からクラウドセッションを監視することもできます。

565 

566クラウドセッションは複数のリポジトリもサポートしています。リポジトリは次の場所で選択します:

474 567 

475クラウドセッションは複数のリポジトリもサポートしています。クラウド環境を選択した後、選択されたリポジトリの横の\*\*+\*\*ボタンをクリックして、セッションに追加のリポジトリを追加します。各リポジトリは独自のブランチセレクタを取得します。これは共有ライブラリとそのコンシューマーの更新など、複数のコードベースにまたがるタスクに便利です。568* **現在のレイアウト**:クラウド環境を選択した後、プロンプトボックスの下の行で選択します。

569* **[以前のレイアウト](#check-which-layout-you-have)**:プロンプトボックスの上で選択します。別のリポジトリを追加するには、選択されたリポジトリの横の **+** をクリックします。

476 570 

477クラウドセッションがどのように機能するかについての詳細については、[クラウドで Claude Code を使用する](/docs/ja/claude-code-on-the-web)を参照してください。1 つの作業本体が多くのクラウドセッションを必要とする場合、サイドバーで**Projects**を選択して[プロジェクト](/docs/ja/claude-projects)を作成します。Claude はそこから 1 つの会話でセッションを開始して追跡します。571クラウドセッションがどのように機能するかについての詳細については、[クラウドで Claude Code を使用する](/docs/ja/claude-code-on-the-web)を参照してください。1 つの作業本体が多くのクラウドセッションを必要とする場合、サイドバーで**Projects**を選択して[プロジェクト](/docs/ja/claude-projects)を作成します。Claude はそこから 1 つの会話でセッションを開始して追跡します。

478 572 


500* **そのセッションでオンにする**:セッションの **Remote Control** スイッチを使用するか、プロンプトボックスに `/remote-control` と入力します。594* **そのセッションでオンにする**:セッションの **Remote Control** スイッチを使用するか、プロンプトボックスに `/remote-control` と入力します。

501* **開始時に接続される**:**Settings > Claude Code** で **Connect new sessions to Remote Control** がオンの間、新しいセッションは自動的に接続されます。この設定を一度も変更していない場合、Desktop はユーザー設定または管理設定の [`remoteControlAtStartup`](/docs/ja/settings-reference#remotecontrolatstartup) に従い、次に組織のデフォルトに従います。595* **開始時に接続される**:**Settings > Claude Code** で **Connect new sessions to Remote Control** がオンの間、新しいセッションは自動的に接続されます。この設定を一度も変更していない場合、Desktop はユーザー設定または管理設定の [`remoteControlAtStartup`](/docs/ja/settings-reference#remotecontrolatstartup) に従い、次に組織のデフォルトに従います。

502 596 

503セッションが接続されているかどうかを確認するには、ツールバーのセッションタイトルの前にあるノートパソコンのアイコンを確認します。セッションが接続済みまたは接続中の間、アイコンはハイライト表示されます。アイコンをクリックすると、セッションの **Remote Control** スイッチが開きます。597セッションが接続されているかどうかを確認するには、[セッション詳細パネル](#see-session-details)の **Environment** カードにある **Remote Control** スイッチを確認します。

504 598 

505セッションを他のデバイスに表示しないようにするには、必要なレベルで Remote Control をオフにします:599セッションを他のデバイスに表示しないようにするには、必要なレベルで Remote Control をオフにします:

506 600 


538 外部ツールを接続する632 外部ツールを接続する

539</h3>633</h3>

540 634 

541ローカルおよび [SSH](#ssh-sessions) セッションの場合、プロンプトボックスの横の\*\*+**ボタンをクリックして**Connectors**を選択し、Google Calendar、Slack、GitHub、Linear、Notion などの統合を追加します。セッションの前または中にコネクタを追加できます。**+\*\*ボタンはクラウドセッションおよび WSL セッションでは利用できませんが、[ルーチン](/docs/ja/routines)はルーチン作成時にコネクタを設定します。635コネクタは、グラフィカルなセットアップフローを備えた [MCP サーバー](/docs/ja/mcp)です。

636 

637Claude アカウントを使用したローカルまたは [SSH](#ssh-sessions) セッションでコネクタを追加するには、セッションの開始前または開始中に、プロンプトボックスの横にある **+** をクリックします。**Add connectors** を選択すると、コネクタディレクトリが開きます。メニューに代わりに **Connectors** が表示される場合は、それを選択してから **Browse connectors** を選択します。

638 

639<Note>

640 以下のケースについては、他のページで説明しています:

542 641 

543コネクタを管理または切断するには、デスクトップアプリの Settings → Connectors に移動するか、プロンプトボックスの Connectors メニューから**Manage connectors**を選択します。642 * **WSL セッションで Connectors がグレーアウトしている**:[ターミナルまたはコネクタが利用できない場合](/docs/ja/desktop-wsl#check-for-the-terminal-and-connectors)を参照してください

643 * **クラウドセッション**:[コネクタが Claude Code に届く仕組み](/docs/ja/mcp#how-connectors-reach-claude-code)を参照してください

644</Note>

544 645 

545接続すると、Claude はカレンダーを読み取り、メッセージを送信し、問題を作成し、ツールと直接対話できます。セッションで設定されているコネクタについて Claude に尋ねることができます。646接続すると、Claude はカレンダーを読み取り、メッセージを送信し、問題を作成し、ツールと直接対話できます。セッションで設定されているコネクタについて Claude に尋ねることができます。コネクタを管理または切断するには、デスクトップアプリの **Settings > Connectors** に移動します。

546 647 

547コネクタは [MCP サーバー](/docs/ja/mcp)であり、グラフィカルセットアップフローを備えています。サポートされているサービスとの迅速な統合に使用します。Connectors にリストされていない統合の場合、[設定ファイル](/docs/ja/mcp#installing-mcp-servers)を介して MCP サーバーを手動で追加します。また、[カスタムコネクタを作成](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp)することもできます。648Connectors にリストされていない統合の場合、[設定ファイル](/docs/ja/mcp#installing-mcp-servers)を介して MCP サーバーを手動で追加します。また、[カスタムコネクタを作成](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp)することもできます。

548 649 

549<h3 id="use-skills">650<h3 id="use-skills">

550 スキルを使用する651 スキルを使用する


564 665 

565[プラグイン](/docs/ja/plugins/overview)は、スキル、エージェント、hooks、MCP サーバー、および LSP 設定を Claude Code に追加する再利用可能なパッケージです。ターミナルを使用せずにデスクトップアプリからプラグインをインストールできます。666[プラグイン](/docs/ja/plugins/overview)は、スキル、エージェント、hooks、MCP サーバー、および LSP 設定を Claude Code に追加する再利用可能なパッケージです。ターミナルを使用せずにデスクトップアプリからプラグインをインストールできます。

566 667 

567ローカルおよび [SSH](#ssh-sessions) セッションの場合、プロンプトボックスの横の\*\*+**ボタンをクリックして**Plugins**を選択して、インストール済みプラグインとそのスキルを確認します。プラグインを追加するには、サブメニューから**Add plugin\*\*を選択してプラグインブラウザを開きます。これは、公式 Anthropic マーケットプレイスを含む、設定された [マーケットプレイス](/docs/ja/plugins/overview)から利用可能なプラグインを表示します。**Manage plugins**を選択して、プラグインを有効化、無効化、またはアンインストールします。668ローカルセッションまたは [SSH セッション](#ssh-sessions)では、プロンプトボックスの横にある **+** をクリックし、**Add plugins** を選択してプラグインブラウザを開きます。メニューに代わりに **Plugins** が表示される場合は、それを選択してから **Browse plugins** を選択するか、**Manage plugins** を選択してプラグインを有効化、無効化、またはアンインストールします。

568 669 

569プラグインはユーザーアカウント、特定のプロジェクト、またはローカルのみにスコープできます。組織がプラグインを一元管理する場合、それらのプラグインは CLI と同じ方法で Desktop セッションで利用可能です。ただし、デスクトップアプリが [`disableSideloadFlags`](/docs/ja/settings-reference#disablesideloadflags) の下で保留しているものは除きます。670プラグインはユーザーアカウント、特定のプロジェクト、またはローカルのみにスコープできます。組織がプラグインを一元管理する場合、それらのプラグインは CLI と同じ方法で Desktop セッションで利用可能です。ただし、デスクトップアプリが [`disableSideloadFlags`](/docs/ja/settings-reference#disablesideloadflags) の下で保留しているものは除きます。

570 671 


632| `runtimeArgs` | string\[] | `runtimeExecutable` に渡される引数(`["run", "dev"]` など) |733| `runtimeArgs` | string\[] | `runtimeExecutable` に渡される引数(`["run", "dev"]` など) |

633| `port` | number | サーバーがリッスンするポート。デフォルトは 3000 |734| `port` | number | サーバーがリッスンするポート。デフォルトは 3000 |

634| `cwd` | string | プロジェクトルートに相対的な作業ディレクトリ。デフォルトはプロジェクトルート。プロジェクトルートを明示的に参照するには `${workspaceFolder}` を使用します |735| `cwd` | string | プロジェクトルートに相対的な作業ディレクトリ。デフォルトはプロジェクトルート。プロジェクトルートを明示的に参照するには `${workspaceFolder}` を使用します |

635| `env` | object | `{ "NODE_ENV": "development" }` などのキーと値のペアとしての追加環境変数。このファイルはリポジトリにコミットされるため、ここにシークレットを入れないでください。dev サーバーにシークレットを渡すには、[ローカル環境エディタ](#local-sessions)で設定します。 |736| `env` | object | `{ "NODE_ENV": "development" }` などのキーと値のペアとしての追加環境変数。このファイルはリポジトリにコミットされるため、ここにシークレットを入れないでください。シークレットについては、[dev サーバーの環境変数を設定する](#set-environment-variables-for-dev-servers)を参照してください。 |

636| `autoPort` | boolean | ポート競合の処理方法。[ポート競合](#port-conflicts)を参照してください |737| `autoPort` | boolean | ポート競合の処理方法。[ポート競合](#port-conflicts)を参照してください |

637| `program` | string | `node` で実行するスクリプト。[`program` と `runtimeExecutable` を使用する場合](#when-to-use-program-vs-runtimeexecutable)を参照してください |738| `program` | string | `node` で実行するスクリプト。[`program` と `runtimeExecutable` を使用する場合](#when-to-use-program-vs-runtimeexecutable)を参照してください |

638| `args` | string\[] | `program` に渡される引数。`program` が設定されている場合のみ使用されます |739| `args` | string\[] | `program` に渡される引数。`program` が設定されている場合のみ使用されます |


795* **SSH**:SSH 経由で接続するリモートマシンで実行されます。たとえば、独自のサーバー、クラウド VM、または dev コンテナなどです。実行中のタスクは [Desktop が切断されている間も続行できます](#keep-a-task-running-while-desktop-is-disconnected)が、Claude アカウントの場合はサインインの期限が切れると停止することがあります。896* **SSH**:SSH 経由で接続するリモートマシンで実行されます。たとえば、独自のサーバー、クラウド VM、または dev コンテナなどです。実行中のタスクは [Desktop が切断されている間も続行できます](#keep-a-task-running-while-desktop-is-disconnected)が、Claude アカウントの場合はサインインの期限が切れると停止することがあります。

796* **WSL**(Windows):マシン上の [WSL 2 ディストリビューション](/docs/ja/desktop-wsl)内で実行され、その Linux ツールチェーンとネイティブパスを使用します897* **WSL**(Windows):マシン上の [WSL 2 ディストリビューション](/docs/ja/desktop-wsl)内で実行され、その Linux ツールチェーンとネイティブパスを使用します

797 898 

899<h3 id="create-a-saved-environment">

900 保存済み環境を作成する

901</h3>

902 

903保存済み環境は、Claude が実行される場所を記録する[環境セレクター](#start-a-session)のエントリで、以降のセッションをそこで開始できます。ローカル環境または SSH 環境には、Claude が作業するフォルダーも保持されます。保存済みのローカル環境と SSH 環境には [Claude Desktop v2.37337.0 以降が必要です](#check-which-layout-you-have)。

904 

905<Steps>

906 <Step title="New environment ダイアログを開く">

907 プロンプトボックスの下にある環境セレクターを開き、メニューの一番下にある **New environment** を選択します。

908 </Step>

909 

910 <Step title="Claude の実行場所を選択する">

911 **Local**、**SSH**、または [**Cloud**](#cloud-sessions) タブを選択し、そのタブのフォームに入力します。**SSH** タブでは、[接続](#ssh-sessions)とリモートマシン上のフォルダーを選択します。

912 </Step>

913 

914 <Step title="環境を保存する">

915 **Create environment** を選択します。**Cloud** タブでは **Add environment** を選択します。

916 </Step>

917</Steps>

918 

919<h4 id="environments-that-desktop-creates-for-you">

920 Desktop が自動作成する環境

921</h4>

922 

923環境セレクターに自分で作成していないローカル環境や SSH 環境が表示されている場合、それらは Desktop が作成したものです。[現在のレイアウト](#check-which-layout-you-have)で初めて Code タブを開くと、Desktop は最大 8 つの環境を作成します。これらの環境は、過去 1 か月間に最も多く使用したローカルフォルダーと SSH フォルダーから作成されます。これらは[編集または削除](#use-edit-or-remove-a-saved-environment)できます。

924 

925<h4 id="use-edit-or-remove-a-saved-environment">

926 保存済み環境を使用、編集、または削除する

927</h4>

928 

929[環境セレクター](#start-a-session)で環境のエントリを探します。

930 

931* **セッションを開始する**: エントリを選択します。

932* **編集または削除する**: エントリにカーソルを合わせ、歯車アイコンをクリックします。ローカル環境または SSH 環境を削除するには、**Edit environment** で **Delete environment** をクリックします。

933* **クラウド環境をアーカイブする**: [環境をアーカイブする](/docs/ja/cloud-environments#archive-an-environment)を参照してください。

934 

798<h3 id="local-sessions">935<h3 id="local-sessions">

799 ローカルセッション936 ローカルセッション

800</h3>937</h3>

801 938 

802デスクトップアプリは常にシェル環境全体を継承するわけではありません。macOS では、Dock または Finder からアプリを起動すると、`~/.zshrc` または `~/.bashrc` などのシェルプロファイルを読み取り、Claude Code に `PATH` と固定された Claude Code 変数セットを渡しますが、そこでエクスポートする他の変数は渡しません。Windows では、アプリはユーザーおよびシステム環境変数を継承しますが、PowerShell プロファイルは読み取りません。939デスクトップアプリは常にシェル環境全体を継承するわけではありません。macOS では、Dock または Finder からアプリを起動すると、`~/.zshrc` または `~/.bashrc` などのシェルプロファイルを読み取り、Claude Code に `PATH` と固定された Claude Code 変数セットを渡しますが、そこでエクスポートする他の変数は渡しません。Windows では、アプリはユーザーおよびシステム環境変数を継承しますが、PowerShell プロファイルは読み取りません。

803 940 

804ローカルセッションと dev サーバーの環境変数を設定するには、プロンプトボックスの環境ドロップダウンを開き、**Local** にマウスを合わせて、ギアアイコンをクリックしてローカル環境エディタを開きます。ここで保存する変数は、マシンに暗号化されて保存され、開始するすべてのローカルセッションとプレビューサーバーに適用されます。また、`~/.claude/settings.json` ファイルの `env` キーに変数を追加することもできます。ただし、これらは Claude セッションにのみ到達し、dev サーバーには到達しません。サポートされている変数の完全なリストについては、[環境変数](/docs/ja/env-vars)を参照してください。941<h4 id="set-environment-variables-for-local-sessions">

942 ローカルセッションの環境変数を設定する

943</h4>

944 

945保存済みのローカル環境に変数を追加し、その環境からセッションを開始します。Desktop は `API_TIMEOUT_MS` などの[一部の変数を自身で設定する](#environment-variables-desktop-sets-itself)ため、それらの変数についてはユーザーの値ではなく Desktop の値がセッションに渡されます。

946 

947<Note>

948 環境セレクターがプロンプトボックスの上にある場合は、保存済みローカル環境のない[以前のレイアウト](#check-which-layout-you-have)を使用しています。代わりに[ローカル環境エディター](#use-the-local-environment-editor)を使用してください。

949</Note>

950 

951<Steps>

952 <Step title="環境のフォームを開く">

953 [**New environment**](#create-a-saved-environment) または [**Edit environment**](#use-edit-or-remove-a-saved-environment) を開きます。

954 </Step>

955 

956 <Step title="変数を入力する">

957 **Environment variables** を選択し、1 行に 1 つずつ `KEY=value` を入力して、**Done** を選択します。

958 </Step>

959 

960 <Step title="環境を保存する">

961 **Create environment** または **Save** を選択します。

962 </Step>

963</Steps>

964 

965その環境から開始したセッションにのみ変数が渡されます。

966 

967すべてのローカルセッションに変数を設定するには、`~/.claude/settings.json` ファイルの [`env` キー](/docs/ja/env-vars#set-variables-in-settings-files)に追加します。Desktop がセッションを開始する環境にその変数がすでに存在する場合、Claude Code は[その値を無視します](/docs/ja/settings-reference#how-env-values-interact-with-your-shell)。サポートされている変数の一覧については、[環境変数](/docs/ja/env-vars)を参照してください。

968 

969<h4 id="set-environment-variables-for-dev-servers">

970 開発サーバーの環境変数を設定する

971</h4>

972 

973シークレットを [`launch.json`](#configure-preview-servers) にコミットせずに開発サーバーに渡すには、次のいずれかの場所で設定してから Desktop を再起動します。

974 

975* **macOS と Linux**: シェルプロファイルでエクスポートします

976* **Windows**: ユーザー環境変数またはシステム環境変数に追加します

977* **任意のプラットフォーム**: [ローカル環境エディター](#use-the-local-environment-editor)を開ける場合は、そこに保存します

978 

979[保存済み環境](#create-a-saved-environment)や `~/.claude/settings.json` に追加した変数は、開発サーバーには渡されません。

980 

981<h4 id="use-the-local-environment-editor">

982 ローカル環境エディターを使用する

983</h4>

984 

985ローカル環境エディターを開くには、保存済み環境のエントリではなく、自分のコンピューターのエントリにある歯車アイコンをクリックします。

986 

987* **プロンプトボックスの下にあるセレクター**: **Local** の下の最初にある、自分のコンピューターのエントリにカーソルを合わせます。歯車アイコンが表示されたらクリックします。表示されない場合、エディターは利用できないため、[ローカルセッション](#set-environment-variables-for-local-sessions)または[開発サーバー](#set-environment-variables-for-dev-servers)の変数を別の方法で設定してください。

988* **プロンプトボックスの上にあるセレクター**: **Local** にカーソルを合わせ、歯車アイコンをクリックします

989 

9901 行に 1 つずつ `KEY=value` を入力し、**Save changes** を選択します。ここで保存した変数は、マシン上に暗号化されて保存されます。ローカルセッションにはこれらの変数が渡されますが、`API_TIMEOUT_MS` など [Desktop が自身で設定する](#environment-variables-desktop-sets-itself)変数は除きます。開発サーバーに変数を渡すには、Desktop を再起動します。

991 

992<h4 id="environment-variables-desktop-sets-itself">

993 Desktop が自身で設定する環境変数

994</h4>

995 

996`API_TIMEOUT_MS` や `ANTHROPIC_BASE_URL` を設定してもローカルセッションで何も変わらなかった場合、それは Desktop がこれらの[変数](/docs/ja/env-vars#variables)などを自身で設定しているためです。シェルプロファイル、Windows のユーザー変数またはシステム変数、ローカル環境エディター、保存済み環境のいずれで値を設定しても、ローカルセッションには Desktop の値が渡されます。値を設定ファイルに移しても効果はありません。ローカルセッションでは Claude Code が[その値を無視する](/docs/ja/settings-reference#how-env-values-interact-with-your-shell)ためです。

997 

998* `API_TIMEOUT_MS`: ローカルセッションには `900000`(15 分)が渡されます。より長いタイムアウトが必要な場合は、[Claude Code CLI をインストール](/docs/ja/quickstart)し、Desktop の代わりに使用してください。[シェルで変数を設定](/docs/ja/env-vars#set-variables-in-your-shell)し、ターミナルで `claude` を実行します。

999* `ANTHROPIC_BASE_URL`: Claude アカウントでサインインしている場合、ローカルセッションには Anthropic の API ホストが渡されます。ゲートウェイを使用するには、代わりに Desktop の[サードパーティ推論設定](/docs/ja/llm-gateway-connect#desktop-app)をセットアップしてください。

1000 

1001<h4 id="turn-off-extended-thinking">

1002 拡張思考をオフにする

1003</h4>

805 1004 

806[拡張思考](/docs/ja/model-config#extended-thinking)はデフォルトで有効になっており、複雑な推論タスクのパフォーマンスを向上させますが、追加のトークンを使用します。Anthropic API では、ローカル環境エディタで `MAX_THINKING_TOKENS` を `0` に設定して思考をオフにします。これは Opus 5.5、Sonnet 5.5、Haiku 5.5、または Fable モデルには効果がなく、これらは常に拡張思考を使用します。Anthropic API で思考をオフにした場合、Claude Code は、Opus 5 などの[その組み合わせを受け入れない](/docs/ja/errors#effort-isnt-available-with-thinking-turned-off)ことが分かっているモデルに、より高いレベルではなく effort `high` を送信します。1005[拡張思考](/docs/ja/model-config#extended-thinking)はデフォルトで有効になっており、複雑な推論タスクのパフォーマンスが向上しますが、追加のトークンを消費します。オフにするには、[保存済みのローカル環境](#set-environment-variables-for-local-sessions)または[ローカル環境エディター](#use-the-local-environment-editor)で `MAX_THINKING_TOKENS` を `0` に設定します。これにより Anthropic API で思考がオフになります。ただし、Opus 5.5、Sonnet 5.5、Haiku 5.5、および Fable モデルは常に拡張思考を使用します。

1006 

1007Opus 5 では、セッションを開始する前に effort を `high` 以下に選択してください。[現在のレイアウト](#check-which-layout-you-have)では、モデルピッカーを開き、**Effort** の下でレベルを選択します。より高いレベルでセッションを開始した場合は、`high` 以下で新しいセッションを開始してください。

1008 

1009<h4 id="fixed-thinking-budgets">

1010 固定の思考予算

1011</h4>

807 1012 

808[適応的推論](/docs/ja/model-config#adjust-effort-level)を持つモデルでは、適応的推論が代わりに思考の深さを制御するため、`MAX_THINKING_TOKENS` に正の値を設定しても、Claude Code はその数値自体を無視します。Opus 4.6 と Sonnet 4.6 では、固定思考予算を使用するために `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` を `1` に設定します。Fable モデル、Sonnet 5 以降、Haiku 5.5、および Opus 4.7 以降は常に適応的推論を使用し、固定予算モードはありません。1013[適応的推論](/docs/ja/model-config#adjust-effort-level)を持つモデルでは、適応的推論が代わりに思考の深さを制御するため、`MAX_THINKING_TOKENS` に正の値を設定しても、Claude Code はその数値自体を無視します。Opus 4.6 と Sonnet 4.6 では、固定思考予算を使用するために `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` を `1` に設定します。Fable モデル、Sonnet 5 以降、Haiku 5.5、および Opus 4.7 以降は常に適応的推論を使用し、固定予算モードはありません。

809 1014 


811 管理デバイス上のローカルセッション1016 管理デバイス上のローカルセッション

812</h4>1017</h4>

813 1018 

814管理者は [`disableDesktopLocalSessions` 管理設定](#managed-settings)でローカルセッションをオフにできます。オフにされた場合、**Local** は環境ドロップダウンに留まりますが、グレーアウトされて選択できず、組織がオフにしたことを示すツールチップが表示されます。Windows では、[WSL](/docs/ja/desktop-wsl) エントリも、管理デバイスでの可用性が[別途管理](/docs/ja/admin-setup#wsl-sessions-in-claude-code-desktop)される場合、同じようにグレーアウトされます。新しいセッションは、SSH 接続が設定されている場合、最初の SSH 接続にデフォルト設定されます。Desktop は、既存のセッションを続行しようとした場合、このデバイスではローカルセッションが利用できないというメッセージを表示します。代わりに [SSH](#ssh-sessions) または [Cloud](#cloud-sessions) 環境を選択するか、IT チームに連絡してください。1019環境セレクターで自分のコンピューターのエントリがグレー表示され、**Disabled by your organization** というツールチップが表示されている場合、管理者が[ローカルセッションをオフにしています](#managed-settings)。Windows では、[WSL](/docs/ja/desktop-wsl) のエントリも同じようにグレー表示されます。管理対象デバイスでの WSL の利用可否は[別途管理されます](/docs/ja/admin-setup#wsl-sessions-in-claude-code-desktop)。

1020 

1021SSH 接続が構成されている場合、新しいセッションはデフォルトで最初の SSH 接続を使用します。既存のローカルセッションを続行しようとすると、Desktop はこのデバイスではローカルセッションを利用できないというメッセージを表示します。[保存済みのローカル環境](#create-a-saved-environment)を選択すると、`Couldn’t switch environments: the Local environment isn’t available anymore.` というエラーが表示されます。代わりに [SSH](#ssh-sessions) 環境または[クラウド](#cloud-sessions)環境を選択するか、IT チームに問い合わせてください。

815 1022 

816<h3 id="cloud-sessions">1023<h3 id="cloud-sessions">

817 クラウドセッション1024 クラウドセッション


819 1026 

820クラウドセッションはアプリを閉じても、バックグラウンドで続行されます。使用状況は[サブスクリプションプランの制限](/docs/ja/costs)にカウントされ、別の計算料金はありません。1027クラウドセッションはアプリを閉じても、バックグラウンドで続行されます。使用状況は[サブスクリプションプランの制限](/docs/ja/costs)にカウントされ、別の計算料金はありません。

821 1028 

822異なるネットワークアクセスレベルと環境変数を持つカスタムクラウド環境を作成できます。それらを管理するには、プロンプトボックスの環境ドロップダウンを開いて **Cloud** を選択します:1029クラウド環境を追加、編集、または[アーカイブ](/docs/ja/cloud-environments#archive-an-environment)するには、[環境セレクター](#start-a-session)を開きます。

823 1030 

824* **環境を追加する**:**Add cloud environment** を選択します1031* **環境を追加する**: セレクターのメニューの一番下にある **New environment** を選択し、[**New environment** ダイアログ](#create-a-saved-environment)の **Cloud** タブを選択します

825* **自分の環境の 1 つを編集またはアーカイブする**:それにマウスを合わせて、ギアアイコンをクリックします1032* **自分の環境の 1 つを編集またはアーカイブする**:それにマウスを合わせて、ギアアイコンをクリックします

826 1033 

827ネットワークアクセスと環境変数の設定の詳細については、[クラウド環境を設定する](/docs/ja/cloud-environments)を参照してください。1034ネットワークアクセスと環境変数の設定の詳細については、[クラウド環境を設定する](/docs/ja/cloud-environments)を参照してください。


836 [サードパーティプロバイダー](/docs/ja/third-party-integrations)で Desktop を使用する場合、SSH セッションには個別のセットアップが必要です。[SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions) を参照してください。1043 [サードパーティプロバイダー](/docs/ja/third-party-integrations)で Desktop を使用する場合、SSH セッションには個別のセットアップが必要です。[SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions) を参照してください。

837</Note>1044</Note>

838 1045 

839SSH 接続を追加するには、セッションを開始する前にプロンプトボックスの環境ドロップダウンを開き、**SSH > Add SSH connection…** を選択して接続の詳細を入力します:1046[**New environment** ダイアログ](#create-a-saved-environment)で SSH 接続を追加し、その接続でセッションを開始します。新しいセッションでプロンプトボックスの下に環境セレクターがない場合は、以前のレイアウトを使用しています。[使用しているレイアウトを確認する](#check-which-layout-you-have)を参照してください。

1047 

1048<Steps>

1049 <Step title="New environment ダイアログを開く">

1050 セッションを開始する前に、プロンプトボックスの下にある環境セレクターを開き、メニューの一番下にある **New environment** を選択します。

1051 </Step>

1052 

1053 <Step title="接続を追加する">

1054 **New environment** ダイアログの **SSH** タブで **Host** リストを開き、**Add SSH connection…** を選択して、接続の詳細を入力します。

840 1055 

841* **Name**:この接続のフレンドリーラベル1056 * **Name**: この接続のわかりやすいラベル。

842* **SSH host**:`user@hostname` または `~/.ssh/config` で定義されたホスト1057 * **SSH host**: `user@hostname`、または `~/.ssh/config` で定義されたホスト。

843* **SSH port**:空のままの場合はデフォルトで 22 になるか、SSH config のポートが使用されます1058 * **SSH port**: 空欄の場合はデフォルトで 22 になるか、SSH 設定のポートが使用されます。

844* **SSH key (optional)**:`~/.ssh/id_ed25519` などの秘密鍵へのパス。SSH config または SSH エージェントを使用するには空のままにします。1059 * **SSH key (optional)**: `~/.ssh/id_ed25519` などの秘密鍵へのパス。SSH 設定または SSH エージェントを使用する場合は空欄のままにします。

845* **Worktree folder**:新しいセッションが worktree を作成する、リモートマシン上のフォルダ(`~/worktrees` など)。[リモートマシンのデフォルト](#choose-where-ssh-session-worktrees-go)を使用するには空のままにします。1060 * **Worktree folder**: 新しいセッションが worktree を作成する、`~/worktrees` などのリモートマシン上のフォルダー。[リモートマシンのデフォルト](#choose-where-ssh-session-worktrees-go)を使用する場合は空欄のままにします。

846 1061 

847追加されると、接続は環境ドロップダウンの **SSH** の下に表示されます。それを選択して、そのマシンでセッションを開始します。Claude はリモートマシンで実行され、そのファイルとツールにアクセスできます。1062 その後、**Add SSH connection** を選択します。

1063 </Step>

1064 

1065 <Step title="接続でセッションを開始する">

1066 リモートマシン上のフォルダーを選択し、**Create environment** をクリックします。マシンとフォルダーは、以降のセッション用の[保存済み環境](#create-a-saved-environment)としてまとめて保持されます。Desktop は新しいセッションにその環境を選択するので、タスクを入力して **Enter** を押します。

1067 </Step>

1068</Steps>

848 1069 

849リモートマシンでは Linux、macOS、または [Windows](#windows-remote-machines) を実行できます。Desktop は初回接続時にリモートマシンに Claude Code を自動的にインストールします。接続されると、SSH セッションは権限モード、コネクタ、プラグイン、および MCP サーバーをサポートします。1070リモートマシンでは Linux、macOS、または [Windows](#windows-remote-machines) を実行できます。Desktop は初回接続時にリモートマシンに Claude Code を自動的にインストールします。接続されると、SSH セッションは権限モード、コネクタ、プラグイン、および MCP サーバーをサポートします。

850 1071 


947 1168 

948<Steps>1169<Steps>

949 <Step title="エントリを追加する">1170 <Step title="エントリを追加する">

950 次のエントリを `~/.ssh/config` の末尾に追加するか、`Host *` エントリがある場合は最初の `Host *` エントリの直前に追加します。Docker コンテナ `devbox`、そのユーザー `dev`、マシン `build.example.com` は自分のものに置き換えてください。このエントリのコマンドは、接続ごとにコンテナ内で SSH サーバーを起動します:1171 `~/.ssh/config` の末尾、または最初の `Host *` エントリがある場合はその直前に、次のエントリを追加します。Docker コンテナ `devbox`、そのユーザー `dev`、マシン `build.example.com` を自分のものに置き換えてください。エントリのコマンドは、接続ごとにコンテナ内で SSH サーバーを起動します。

951 1172 

952 ```text ~/.ssh/config theme={null}1173 ```text ~/.ssh/config theme={null}

953 Host devbox-container1174 Host devbox-container


1175 1396 

1176ファイルの編集と一部のツールは、Desktop が切断されている間に失敗することがあります。タスクでそれらが必要な場合は、Desktop を接続したままにしてください:1397ファイルの編集と一部のツールは、Desktop が切断されている間に失敗することがあります。タスクでそれらが必要な場合は、Desktop を接続したままにしてください:

1177 1398 

1178* **worktree**:[worktree](#work-in-parallel-with-sessions) を使用するセッションでは、Desktop は Claude がファイルを編集する前に各編集をチェックします。Desktop が切断されている間、各編集は約 30 秒待機した後に失敗します。シェルコマンドは引き続き実行されます。Linux または macOS のリモートマシンでは、[編集が引き続き機能する場合があります](#worktree-edits-while-disconnected)。不明な場合は、worktree を使用せずにセッションを開始してください。1399* **worktree**: [worktree](#run-a-session-in-its-own-worktree) を使用するセッションでは、Claude がファイルを編集する前に Desktop が各編集を確認します。Desktop が切断されている間、各編集は約 30 秒待機した後に失敗します。シェルコマンドは引き続き実行されます。Linux または macOS のリモートマシンでは、[編集が引き続き機能する場合があります](#worktree-edits-while-disconnected)。不明な場合は、worktree なしでセッションを開始してください。

1179* **フォルダの制限**:組織がセッションで使用できるフォルダを制限している場合、Desktop は worktree の有無にかかわらず、各ファイルの読み取り、検索、編集をチェックします。Desktop が切断されている間、それぞれ最大 10 分間待機した後に失敗します。1400* **フォルダの制限**:組織がセッションで使用できるフォルダを制限している場合、Desktop は worktree の有無にかかわらず、各ファイルの読み取り、検索、編集をチェックします。Desktop が切断されている間、それぞれ最大 10 分間待機した後に失敗します。

1180* **コネクタ**:[コネクタ](#connect-external-tools)および Desktop が提供するその他のツールは Desktop を経由して実行されるため、Desktop が切断されている間は各呼び出しが約 30 秒後に失敗します1401* **コネクタ**:[コネクタ](#connect-external-tools)および Desktop が提供するその他のツールは Desktop を経由して実行されるため、Desktop が切断されている間は各呼び出しが約 30 秒後に失敗します

1181* **ワークフロー**:Desktop は新しい[ワークフロー](/docs/ja/workflows)をそれぞれ開始前にチェックするため、Desktop が切断されている間、新しいワークフローは最大 10 分間待機した後に失敗します1402* **ワークフロー**:Desktop は新しい[ワークフロー](/docs/ja/workflows)をそれぞれ開始前にチェックするため、Desktop が切断されている間、新しいワークフローは最大 10 分間待機した後に失敗します


1264 SSH セッションの worktree の作成場所を選択する1485 SSH セッションの worktree の作成場所を選択する

1265</h4>1486</h4>

1266 1487 

1267組織がセッションで使用できるフォルダを制限していない限り、新しい SSH セッションは、次のうち最初に設定されている場所に [worktree](#work-in-parallel-with-sessions) を作成します:1488組織がセッションで使用できるフォルダーを制限していない限り、新しい SSH セッションは、次の場所のうち設定されている最初の場所に [worktree](#run-a-session-in-its-own-worktree) を作成します。

1268 1489 

12691. SSH 接続の **Worktree folder**14901. SSH 接続の **Worktree folder**

12702. リモートマシン上の `~/.claude/settings.json` にある [`worktree.location`](/docs/ja/settings-reference#worktree-location)14912. リモートマシン上の `~/.claude/settings.json` にある [`worktree.location`](/docs/ja/settings-reference#worktree-location)


1272 1493 

1273設定したフォルダ内には各プロジェクト専用のサブフォルダが作成されるため、`~/worktrees` を設定した場合、worktree のパスは `~/worktrees/<project>-<id>/<worktree-name>` になります。設定したフォルダがプロジェクト内にある場合、Desktop はそのプロジェクトではそのフォルダを無視し、デフォルトを使用します。[Windows リモートマシン](#windows-remote-machines)では、Desktop は常にデフォルトを使用します。1494設定したフォルダ内には各プロジェクト専用のサブフォルダが作成されるため、`~/worktrees` を設定した場合、worktree のパスは `~/worktrees/<project>-<id>/<worktree-name>` になります。設定したフォルダがプロジェクト内にある場合、Desktop はそのプロジェクトではそのフォルダを無視し、デフォルトを使用します。[Windows リモートマシン](#windows-remote-machines)では、Desktop は常にデフォルトを使用します。

1274 1495 

1275以前に追加した接続、または組織が管理する接続に **Worktree folder** を設定するには、環境ドロップダウンでその接続にマウスを合わせて、ギアアイコンをクリックします。1496<a id="set-the-worktree-folder-on-an-existing-connection" />

1276 1497 

1277このフィールドには Claude Desktop v1.44121.0 以降が必要です。組織がセッションで使用できるフォルダを制限している場合、Desktop はこのフィールドを非表示にし、worktree をプロジェクト内に作成します。1498<h5 id="set-the-worktree-folder-on-an-existing-connection">

1499 既存の接続で worktree フォルダーを設定する

1500</h5>

1501 

1502以前に追加した接続、または組織が管理する接続の設定で **Worktree folder** を設定します。このフィールドには Claude Desktop v1.44121.0 以降が必要です。組織がセッションで使用できるフォルダーを制限している場合、Desktop はこのフィールドを非表示にし、worktree をプロジェクト内に保持します。

1503 

1504<Steps>

1505 <Step title="接続を見つける">

1506 [環境セレクター](#start-a-session)を開き、**SSH** の下で接続を探します。

1507 </Step>

1508 

1509 <Step title="接続の設定を開く">

1510 接続にカーソルを合わせ、歯車アイコンをクリックします。開いたダイアログの **Host** の横に **Edit connection…** が表示されている場合は、**Edit connection…** を選択します。

1511 </Step>

1512 

1513 <Step title="フォルダーを設定する">

1514 **Worktree folder** に `~/worktrees` などのリモートマシン上のフォルダーを入力し、**Save changes** を選択します。

1515 </Step>

1516</Steps>

1278 1517 

1279<h4 id="files-and-processes-on-the-remote-machine">1518<h4 id="files-and-processes-on-the-remote-machine">

1280 リモートマシン上のファイルとプロセス1519 リモートマシン上のファイルとプロセス


1321 1 つのセッションのプロセスを終了する1560 1 つのセッションのプロセスを終了する

1322</h5>1561</h5>

1323 1562 

13241 つのセッションの Claude Code プロセスを終了するには、Desktop がリモートマシンに接続している間に、Desktop で[セッションをアーカイブ](#work-in-parallel-with-sessions)します。プロセスは、タスクの完了後も、Desktop を終了した後も実行を続けます。15631 つのセッションの Claude Code プロセスを終了するには、Desktop がリモートマシンに接続されている間に、Desktop で[セッションをアーカイブ](#archive-a-session)します。プロセスは、タスクの完了後も Desktop の終了後も実行を続けます。

1325 1564 

1326worktree を持つセッションをアーカイブする前に、[セッションで並行作業する](#work-in-parallel-with-sessions)を参照してください。1565worktree にコミットされていない変更があるセッションをアーカイブする前に、[セッションのアーカイブ時にコミットされていない変更を保持する](#keep-uncommitted-changes-when-a-session-is-archived)を参照してください。

1327 1566 

1328<h5 id="see-which-user-the-processes-run-as">1567<h5 id="see-which-user-the-processes-run-as">

1329 プロセスを実行するユーザーを確認する1568 プロセスを実行するユーザーを確認する


1474 チームの SSH 接続を事前設定する1713 チームの SSH 接続を事前設定する

1475</h4>1714</h4>

1476 1715 

1477管理者は、[管理設定](/docs/ja/managed-settings)で `sshConfigs` を設定することで、SSH 接続をチームメンバーに配布できます。この方法で定義された接続は、各ユーザーの環境ドロップダウンに自動的に表示され、管理対象として表示されます。ユーザーはそれらを選択し、[独自の **Worktree folder** を設定](#choose-where-ssh-session-worktrees-go)できますが、アプリでそれ以外を編集したり、削除したりすることはできません。1716管理者は、[管理設定](/docs/ja/managed-settings)で `sshConfigs` を設定することで、チームメンバーに SSH 接続を配布できます。

1717 

1718* **ユーザーに表示される内容**:この方法で定義された接続は、各ユーザーの環境セレクターに自動的に表示されます。

1719* **ユーザーが変更できる内容**:ユーザーは管理対象の接続を選択し、その接続に対して[独自の **Worktree folder** を設定](#set-the-worktree-folder-on-an-existing-connection)できます。その他のフィールドを編集したり、アプリ内で削除したりすることはできません。

1478 1720 

1479次の例は、単一の接続を事前設定しています:1721次の例は、単一の接続を事前設定しています:

1480 1722 


1563設定が適用されていることを確認するには、開発者のコンピューターで次を確認します:1805設定が適用されていることを確認するには、開発者のコンピューターで次を確認します:

1564 1806 

1565<Steps>1807<Steps>

1566 <Step title="環境ドロップダウンを確認する">1808 <Step title="環境セレクターを確認する">

1567 Desktop を終了して再度開き、プロンプトボックスの環境ドロップダウンを開きます。**Local** がグレーアウトされ、**SSH** の下に **Shared Dev VM** が表示されます。**Local** がまだ利用できる場合は、Desktop のバージョン、ファイルが有効な JSON であるかどうか、およびコンピューターがどの管理ソースを読み取っているかを確認してください。1809 Desktop を終了して再度開き、[環境セレクター](#start-a-session)を開きます。次のように表示されていれば、設定は適用されています。

1810 

1811 * そのコンピューターのエントリがグレー表示されている

1812 * **SSH** の下に **Shared Dev VM** がある。そこに表示されていない場合は、単一の **SSH** 行、またはグループ末尾の **More** をクリックしてください。

1813 

1814 コンピューターのエントリがまだ選択可能な場合は、次の原因を確認してください。

1815 

1816 * **Desktop のバージョン**:v1.37937.0 より前の場合は Desktop を更新してください。

1817 * **管理設定ファイル**:ファイルが有効な JSON であることを確認してください。

1818 * **管理ソース**:キーを保持している[管理ソース](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)をコンピューターが読み取っていることを確認してください。

1568 </Step>1819 </Step>

1569 1820 

1570 <Step title="許可リストにないホストを追加する">1821 <Step title="許可リストにないホストを追加する">

1571 `other.example.com` など、許可リストにないホスト名で [SSH 接続を追加](#ssh-sessions)します。Desktop は接続を保存しますが、接続を拒否し、組織の設定でその接続が許可されていないことを示します。1822 `other.example.com` など、許可リストにないホスト名で [SSH 接続を追加](#ssh-sessions)します。Desktop は接続を保存しますが、接続は拒否し、組織の設定でその接続が許可されていないことを表示します。

1572 </Step>1823 </Step>

1573</Steps>1824</Steps>

1574 1825 


1612| `browserExternalPageTools` | Claude が[Browser ペイン](#browse-external-sites)の外部ページを読み取るまたは操作するためのツールを使用するのを防ぐには`"disabled"`に設定します。ユーザーは引き続き外部サイトに自分でナビゲートできます。ローカル開発サーバープレビューは影響を受けません。 |1863| `browserExternalPageTools` | Claude が[Browser ペイン](#browse-external-sites)の外部ページを読み取るまたは操作するためのツールを使用するのを防ぐには`"disabled"`に設定します。ユーザーは引き続き外部サイトに自分でナビゲートできます。ローカル開発サーバープレビューは影響を受けません。 |

1613| `disableMobileSimulatorTools` | Claude の[iOS Simulator ペイン](/docs/ja/desktop-ios-simulator#turn-off-simulator-access)でデバイスを制御およびキャプチャするためのツールをブロックするには`true`に設定します。ペインはユーザー自身のタップに対して使用可能なままです。Claude のアクセスのみが削除されます。値は JSON ブール値`true`である必要があります。文字列`"true"`は無視されます。 |1864| `disableMobileSimulatorTools` | Claude の[iOS Simulator ペイン](/docs/ja/desktop-ios-simulator#turn-off-simulator-access)でデバイスを制御およびキャプチャするためのツールをブロックするには`true`に設定します。ペインはユーザー自身のタップに対して使用可能なままです。Claude のアクセスのみが削除されます。値は JSON ブール値`true`である必要があります。文字列`"true"`は無視されます。 |

1614| `disableBrowserExternalNavigation` | [Browser ペイン](#browse-external-sites)の外部ブラウジングを完全にオフにするには`true`に設定します。ユーザーも Claude も外部サイトにナビゲートできません。localhost 開発サーバープレビューは影響を受けません。値は JSON ブール値`true`である必要があります。文字列`"true"`は無視されます。 |1865| `disableBrowserExternalNavigation` | [Browser ペイン](#browse-external-sites)の外部ブラウジングを完全にオフにするには`true`に設定します。ユーザーも Claude も外部サイトにナビゲートできません。localhost 開発サーバープレビューは影響を受けません。値は JSON ブール値`true`である必要があります。文字列`"true"`は無視されます。 |

1615| `sshConfigs` | 環境ドロップダウンに表示される[SSH 接続](#pre-configure-ssh-connections-for-your-team)を事前設定します。ユーザーは管理接続を削除できず、自分の **Worktree folder** 以外は編集できません。 |1866| `sshConfigs` | 環境セレクタに表示される[SSH 接続](#pre-configure-ssh-connections-for-your-team)を事前設定します。ユーザーは管理接続を削除できず、自分の **Worktree folder** 以外は編集できません。 |

1616| `sshHostAllowlist` | [SSH セッション](#restrict-which-ssh-hosts-users-can-connect-to)を、解決されたホスト名がこれらのパターンのいずれかと一致するホストに制限します。管理設定からのみ読み取られます。 |1867| `sshHostAllowlist` | [SSH セッション](#restrict-which-ssh-hosts-users-can-connect-to)を、解決されたホスト名がこれらのパターンのいずれかと一致するホストに制限します。管理設定からのみ読み取られます。 |

1617| `disableDesktopLocalSessions` | [デバイスで実行されるコードセッション](#local-sessions-on-managed-devices)をオフにするには`true`に設定します。他のホストへの SSH セッションとクラウドセッションは利用可能なままです。値は JSON ブール値`true`である必要があります。管理設定からのみ読み取られます。Claude Desktop v1.37937.0 以降が必要です。 |1868| `disableDesktopLocalSessions` | [デバイスで実行されるコードセッション](#local-sessions-on-managed-devices)をオフにするには`true`に設定します。他のホストへの SSH セッションとクラウドセッションは利用可能なままです。値は JSON ブール値`true`である必要があります。管理設定からのみ読み取られます。Claude Desktop v1.37937.0 以降が必要です。 |

1618| `disableSshSavedPasswords` | Desktop が SSH パスワードの保存を提案したり、以前に保存したパスワードを使用または表示したりしないようにするには`true`に設定します。オンにしても、保存済みのパスワードは削除されません。管理設定からのみ読み取られます。Claude Desktop v1.49585.0 以降が必要です。 |1869| `disableSshSavedPasswords` | Desktop が SSH パスワードの保存を提案したり、以前に保存したパスワードを使用または表示したりしないようにするには`true`に設定します。オンにしても、保存済みのパスワードは削除されません。管理設定からのみ読み取られます。Claude Desktop v1.49585.0 以降が必要です。 |


1756 2007 

1757| CLI | Desktop の同等物 |2008| CLI | Desktop の同等物 |

1758| - | - |2009| - | - |

1759| `--model sonnet` | 送信ボタンの横のモデルドロップダウン |2010| `--model sonnet` | プロンプトボックスの下の行にあるモデルピッカー |

1760| `--resume`、`--continue` | サイドバーのセッションをクリックするか、プロンプトボックスで `/resume` と入力して CLI から開始したセッションを選択します |2011| `--resume`、`--continue` | サイドバーのセッションをクリックするか、プロンプトボックスで `/resume` と入力して CLI から開始したセッションを選択します |

1761| `--permission-mode` | 送信ボタンの横のモードセレクタ |2012| `--permission-mode` | プロンプトボックスの下の行にあるモードセレクタ |

1762| `--dangerously-skip-permissions` | 権限モードをバイパスします。Pro および Max プランでは、設定 → Claude Code → 「権限モードのバイパスを許可」で有効にします。Team および Enterprise プランでは、組織ポリシーで制御されます |2013| `--dangerously-skip-permissions` | 権限モードをバイパスします。Pro および Max プランでは、設定 → Claude Code → 「権限モードのバイパスを許可」で有効にします。Team および Enterprise プランでは、組織ポリシーで制御されます |

1763| `--add-dir` | クラウドセッションで **+** ボタンで複数のリポジトリを追加します |2014| `--add-dir` | ローカルセッションと SSH セッションでは[セッションにフォルダを追加](#add-folders-to-a-session)し、クラウドセッションでは[複数のリポジトリ](#run-long-running-tasks-in-the-cloud)を選択します |

1764| `--allowedTools`、`--disallowedTools` | セッションごとの同等物はありません。[設定ファイル](/docs/ja/settings)の権限ルールは引き続き適用されます。 |2015| `--allowedTools`、`--disallowedTools` | セッションごとの同等物はありません。[設定ファイル](/docs/ja/settings)の権限ルールは引き続き適用されます。 |

1765| `--verbose` | [詳細ビューモード](#switch-view-modes) |2016| `--verbose` | [詳細ビューモード](#switch-view-modes) |

1766| `--print`、`--output-format` | 利用できません。Desktop は対話的のみです。 |2017| `--print`、`--output-format` | 利用できません。Desktop は対話的のみです。 |

1767| `ANTHROPIC_MODEL` 環境変数 | 送信ボタンの横のモデルドロップダウン |2018| `ANTHROPIC_MODEL` 環境変数 | プロンプトボックスの下の行にあるモデルピッカー |

1768| `MAX_THINKING_TOKENS` 環境変数 | ローカル環境エディタで設定します。[環境設定](#environment-configuration)を参照してください。 |2019| `MAX_THINKING_TOKENS` 環境変数 | [拡張思考をオフにする](#turn-off-extended-thinking)を参照してください |

1769 2020 

1770<h3 id="shared-configuration">2021<h3 id="shared-configuration">

1771 共有設定2022 共有設定


1777* `~/.claude.json` または `.mcp.json` で設定された **[MCP サーバー](/docs/ja/mcp)** は両方で機能します2028* `~/.claude.json` または `.mcp.json` で設定された **[MCP サーバー](/docs/ja/mcp)** は両方で機能します

1778* 設定で定義された **[フック](/docs/ja/hooks)** および **[スキル](/docs/ja/skills)** は両方に適用されます2029* 設定で定義された **[フック](/docs/ja/hooks)** および **[スキル](/docs/ja/skills)** は両方に適用されます

1779* `~/.claude.json` および `~/.claude/settings.json` の **[設定](/docs/ja/settings)** は共有されます。`settings.json` の権限ルール、許可されたツール、およびその他の設定は Desktop セッションに適用されます。2030* `~/.claude.json` および `~/.claude/settings.json` の **[設定](/docs/ja/settings)** は共有されます。`settings.json` の権限ルール、許可されたツール、およびその他の設定は Desktop セッションに適用されます。

1780* **モデル**:同じ[モデル](/docs/ja/model-config#available-models)が両方で利用可能です。Desktop では、送信ボタンの横のドロップダウンからモデルを選択します。セッション中にも同じドロップダウンからモデルを変更できます。2031* **モデル**:同じ[モデル](/docs/ja/model-config#available-models)が両方で利用可能です。Desktop では、プロンプトボックスの下の行にあるモデルピッカーからモデルを選択します。セッション中にも同じピッカーからモデルを変更できます。

1781 2032 

1782<h4 id="mcp-servers-from-the-claude-desktop-chat-app">2033<h4 id="mcp-servers-from-the-claude-desktop-chat-app">

1783 Claude Desktop チャットアプリからの MCP サーバー2034 Claude Desktop チャットアプリからの MCP サーバー


1805| [サードパーティプロバイダー](/docs/ja/third-party-integrations) | Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry | デフォルトで Anthropic の API。ゲートウェイルーティングについては、[Desktop アプリをゲートウェイに接続](/docs/ja/llm-gateway-connect#desktop-app)を参照してください。Code タブを Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または自己ホスト型 LLM ゲートウェイで実行するには、[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)を参照してください。 |2056| [サードパーティプロバイダー](/docs/ja/third-party-integrations) | Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry | デフォルトで Anthropic の API。ゲートウェイルーティングについては、[Desktop アプリをゲートウェイに接続](/docs/ja/llm-gateway-connect#desktop-app)を参照してください。Code タブを Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または自己ホスト型 LLM ゲートウェイで実行するには、[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)を参照してください。 |

1806| [MCP サーバー](/docs/ja/mcp) | 設定ファイルで設定 | ローカルおよび SSH セッションのコネクタ UI、または設定ファイル |2057| [MCP サーバー](/docs/ja/mcp) | 設定ファイルで設定 | ローカルおよび SSH セッションのコネクタ UI、または設定ファイル |

1807| [プラグイン](/docs/ja/plugins/overview) | `/plugin` コマンド | プラグインマネージャー UI |2058| [プラグイン](/docs/ja/plugins/overview) | `/plugin` コマンド | プラグインマネージャー UI |

1808| @mention ファイル | テキストベース | オートコンプリート付き。ローカルおよび SSH セッションのみ |2059| @mention ファイル | テキストベース | オートコンプリート付き(クラウドセッションの最初のメッセージを除く) |

1809| ファイル添付 | 利用できません | 画像、PDF |2060| ファイル添付 | 利用できません | 画像、PDF |

1810| セッション分離 | [`--worktree`](/docs/ja/cli-reference) フラグ | セッション開始時の **worktree** オプション |2061| セッション分離 | [`--worktree`](/docs/ja/cli-reference) フラグ | [独自の worktree でセッションを実行](#run-a-session-in-its-own-worktree) |

1811| 複数セッション | 別々のターミナル | サイドバータブ |2062| 複数セッション | 別々のターミナル | サイドバータブ |

1812| 定期的なタスク | Cron ジョブ、CI パイプライン | [スケジュールタスク](/docs/ja/desktop-scheduled-tasks) |2063| 定期的なタスク | Cron ジョブ、CI パイプライン | [スケジュールタスク](/docs/ja/desktop-scheduled-tasks) |

1813| コンピューター使用 | macOS で [`/mcp`](/docs/ja/computer-use) で有効化 | macOS および Windows で[アプリとスクリーン制御](#let-claude-use-your-computer) |2064| コンピューター使用 | macOS で [`/mcp`](/docs/ja/computer-use) で有効化 | macOS および Windows で[アプリとスクリーン制御](#let-claude-use-your-computer) |


1833 トラブルシューティング2084 トラブルシューティング

1834</h2>2085</h2>

1835 2086 

1836以下のセクションでは、デスクトップアプリに固有の問題について説明します。チャットに表示される`API Error: 500`、`529 Overloaded`、`429`、または`Prompt is too long`などのランタイム API エラーについては、[エラーリファレンス](/docs/ja/errors)を参照してください。これらのエラーとその修正は、CLI、Desktop、Web 全体で同じです。2087以下のセクションでは、デスクトップアプリに固有の問題について説明します。チャットに表示される`API Error: 500`、`529 Overloaded`、`429`、または`Prompt is too long`などのランタイム API エラーについては、[エラーリファレンス](/docs/ja/errors)を参照してください。

1837 2088 

1838<h3 id="check-your-version">2089<h3 id="check-your-version">

1839 バージョンを確認する2090 バージョンを確認する


1852 2103 

1853セッションで実行されている Claude Code のバージョンを確認するには、**Code** タブのローカルセッションで `/status` と入力し、**Claude Code** 行を確認します。この行には `2.1.286` のようなバージョンが表示されます。2104セッションで実行されている Claude Code のバージョンを確認するには、**Code** タブのローカルセッションで `/status` と入力し、**Claude Code** 行を確認します。この行には `2.1.286` のようなバージョンが表示されます。

1854 2105 

1855ローカルセッション用に新しいバージョンを取得するには、macOS では **Claude → Check for Updates**、Windows では **Help → Check for Updates** を開き、新しいセッションを開始します。2106ローカルセッション用に新しいバージョンを取得するには、macOS では **Claude > Check for Updates…**、Windows では **Help > Check for Updates…** を開き、新しいセッションを開始します。

1856 2107 

1857ローカルセッションでは、**Code** タブは独自の Claude Code のコピーを実行し、そのコピーには独自のバージョン番号があります。デスクトップアプリがそのコピーをダウンロードして更新するため、ターミナルの `claude` コマンドとはバージョンが異なる場合があり、一方を更新してももう一方は更新されません。2108ローカルセッションでは、**Code** タブは独自の Claude Code のコピーを実行し、そのコピーには独自のバージョン番号があります。デスクトップアプリがそのコピーをダウンロードして更新するため、ターミナルの `claude` コマンドとはバージョンが異なる場合があり、一方を更新してももう一方は更新されません。

1858 2109 

2110<h3 id="check-which-layout-you-have">

2111 使用しているレイアウトを確認する

2112</h3>

2113 

2114新しいセッションのプロンプトボックスの下に[環境セレクター](#start-a-session)がない場合は、以前のレイアウトを使用しています:

2115 

2116* **[v2.37337.0 より前の Desktop](#check-your-version)**:更新すると現在のレイアウトになります。macOS では **Claude > Check for Updates…**、Windows では **Help > Check for Updates…** を選択します。

2117* **[サードパーティプロバイダー](/docs/ja/third-party-integrations)**:以前のレイアウトのままとなるため、対応は不要です。

2118 

2119以前のレイアウトでは、プロンプトボックスの上で環境とプロジェクトフォルダを選択し、その下の行で権限モードとモデルを選択します。以前のレイアウトには[セッション詳細パネル](#see-session-details)と[保存済みのローカル環境および SSH 環境](#create-a-saved-environment)がありません。

2120 

1859<h3 id="403-or-authentication-errors-in-the-code-tab">2121<h3 id="403-or-authentication-errors-in-the-code-tab">

1860 Code タブの 403 またはエラー認証エラー2122 Code タブの 403 またはエラー認証エラー

1861</h3>2123</h3>

Details

160* Xcode と iOS シミュレータがインストールされており、Xcode バージョンが [要件](#requirements)を満たしていることを確認します。160* Xcode と iOS シミュレータがインストールされており、Xcode バージョンが [要件](#requirements)を満たしていることを確認します。

161* 組織が Claude Code を管理している場合、[シミュレータツールはポリシーによって無効にされている可能性があります](#turn-off-simulator-access)。161* 組織が Claude Code を管理している場合、[シミュレータツールはポリシーによって無効にされている可能性があります](#turn-off-simulator-access)。

162* Enterprise 組織で HIPAA 設定が有効になっている場合、シミュレータペインは利用できません。162* Enterprise 組織で HIPAA 設定が有効になっている場合、シミュレータペインは利用できません。

163* シミュレータペインには Claude Desktop v1.24012.0 以降が必要です。**Claude → Check for Updates** を開き、アプリを再起動します。163* シミュレータペインには Claude Desktop v1.24012.0 以降が必要です。**Claude > Check for Updates…** を開き、アプリを再起動します。

164 164 

165<h3 id="the-simulator-pane-says-no-simulators-were-found">165<h3 id="the-simulator-pane-says-no-simulators-were-found">

166 シミュレータペインにシミュレータが見つからないと表示される166 シミュレータペインにシミュレータが見つからないと表示される


174 174 

175* [Desktop でのコンピュータの使用](/docs/ja/desktop#let-claude-use-your-computer):専用ペインのないアプリの画面制御175* [Desktop でのコンピュータの使用](/docs/ja/desktop#let-claude-use-your-computer):専用ペインのないアプリの画面制御

176* [CLI からのコンピュータの使用](/docs/ja/computer-use):CLI が iOS シミュレータに到達する方法176* [CLI からのコンピュータの使用](/docs/ja/computer-use):CLI が iOS シミュレータに到達する方法

177* [セッションで並列に作業する](/docs/ja/desktop#work-in-parallel-with-sessions):セッションが変更を分離する方法177* [独自の worktree でセッションを実行する](/docs/ja/desktop#run-a-session-in-its-own-worktree):セッションが変更を分離する方法

178* [Claude Code Desktop を始める](/docs/ja/desktop-quickstart)178* [Claude Code Desktop を始める](/docs/ja/desktop-quickstart)

Details

63 63 

64<Steps>64<Steps>

65 <Step title="環境とフォルダを選択する">65 <Step title="環境とフォルダを選択する">

66 **Local** を選択して、Claude をマシン上で実行し、ファイルを直接使用します。**Select folder** をクリックして、プロジェクトディレクトリを選択します。66 [プロンプトボックスの下の行](/docs/ja/desktop#start-a-session)で、最初のコントロールである環境セレクタをクリックし、**Local** グループの一番上の項目を選択します。次に、環境セレクタの横にあるプロジェクトフォルダのコントロールをクリックし、**Open folder…** を選択して、プロジェクトのディレクトリを選択します。

67 

68 プロンプトボックスの下に環境セレクタが表示されない場合は、以前のレイアウトを使用しています。[使用しているレイアウトを確認する](/docs/ja/desktop#check-which-layout-you-have)を参照してください。

67 69 

68 <Tip>70 <Tip>

69 よく知っている小さなプロジェクトから始めてください。Claude Code が何ができるかを見る最速の方法です。71 よく知っている小さなプロジェクトから始めてください。Claude Code が何ができるかを見る最速の方法です。


72 次のオプションも選択できます。74 次のオプションも選択できます。

73 75 

74 * **Cloud**: アプリを閉じても続行するクラウドセッションを実行します。クラウドセッションの動作方法については [Claude Code in the cloud](/docs/ja/claude-code-on-the-web) を参照してください。76 * **Cloud**: アプリを閉じても続行するクラウドセッションを実行します。クラウドセッションの動作方法については [Claude Code in the cloud](/docs/ja/claude-code-on-the-web) を参照してください。

75 * **SSH**: SSH 経由でリモートマシン(独自のサーバー、クラウド VM、dev コンテナなど)に接続します。Desktop は初回接続時にリモートマシンに Claude Code を自動的にインストールします。実行中のタスクは [Desktop が切断されている間も続行できます](/docs/ja/desktop#keep-a-task-running-while-desktop-is-disconnected)が、Claude アカウントを使用している場合は、サインインの有効期限が切れると停止することがあります。77 * **SSH**: SSH 経由でリモートマシン(独自のサーバー、クラウド VM、dev コンテナなど)に接続します。最初に[接続を追加](/docs/ja/desktop#ssh-sessions)してください。Desktop は初回接続時にリモートマシンに Claude Code を自動的にインストールします。実行中のタスクは [Desktop が切断されている間も続行できます](/docs/ja/desktop#keep-a-task-running-while-desktop-is-disconnected)が、Claude アカウントを使用している場合は、サインインの有効期限が切れると停止することがあります。

76 * **WSL**(Windows): [WSL 2 distribution](/docs/ja/desktop-wsl) 内でセッションを実行します。Claude Code、ツール、git は Linux 側でネイティブパスで実行されます。78 * **WSL**(Windows): [WSL 2 distribution](/docs/ja/desktop-wsl) 内でセッションを実行します。Claude Code、ツール、git は Linux 側でネイティブパスで実行されます。

77 </Step>79 </Step>

78 80 

79 <Step title="モデルを選択する">81 <Step title="モデルを選択する">

80 送信ボタンの横のドロップダウンからモデルを選択します。利用可能なモデルの比較については [models](/docs/ja/model-config#available-models) を参照してください。後で同じドロップダウンからモデルを変更できます。82 プロンプトボックスの下の行の右端寄りにあるモデルピッカーからモデルを選択します。利用可能なモデルの比較については [models](/docs/ja/model-config#available-models) を参照してください。後でモデルピッカーからモデルを変更できます。

81 </Step>83 </Step>

82 84 

83 <Step title="Claude に何をするかを指示する">85 <Step title="Claude に何をするかを指示する">


87 * `main 関数のテストを追加する`89 * `main 関数のテストを追加する`

88 * `このコードベースの手順を含む CLAUDE.md を作成する`90 * `このコードベースの手順を含む CLAUDE.md を作成する`

89 91 

90 [session](/docs/ja/desktop#work-in-parallel-with-sessions) は、コードについて Claude との会話です。各セッションは独自のコンテキストと変更を追跡します。92 [セッション](/docs/ja/desktop#work-in-parallel-with-sessions)は、コードについての Claude との会話です。各セッションは独自のコンテキストと変更を追跡します。

91 </Step>93 </Step>

92 94 

93 <Step title="変更を確認して受け入れる">95 <Step title="変更を確認して受け入れる">

94 次に何が起こるかは、送信ボタンの横のセレクタに表示される [permission mode](/docs/ja/desktop#choose-a-permission-mode) によって異なります。96 プロンプトボックスの下の行で[権限モード](/docs/ja/desktop#choose-a-permission-mode)を確認し、Claude が承認を待つかどうかを確認します。

95 97 

96 * **Auto or Accept edits**: Claude はファイルの変更を適用し、`+12 -1` などのインジケータが表示されるため、diff ビューで確認できます98 * **Auto or Accept edits**: Claude はファイルの変更を適用し、`+12 -1` などのインジケータが表示されるため、diff ビューで確認できます

97 * **Manual**: Claude は各変更を提案し、適用する前にあなたの承認を待ちます。変更を受け入れるまでファイルは変更されず、変更を拒否した場合、Claude は代わりにどのように進めたいかを尋ねます99 * **Manual**: Claude は各変更を提案し、適用する前に承認を待ちます

98 100 

99 Manual モードでは、以下が表示されます。101 Manual モードでは、以下が表示されます。

100 102 


112 114 

113**中断して方向を変える。** Claude をいつでもリダイレクトできます。停止ボタンをクリックして即座に中断するか、修正を入力して **Enter** キーを押して、実行中のアクションを停止せずに送信します。どちらの方法でも、完了を待つ必要がなく、最初からやり直す必要もありません。115**中断して方向を変える。** Claude をいつでもリダイレクトできます。停止ボタンをクリックして即座に中断するか、修正を入力して **Enter** キーを押して、実行中のアクションを停止せずに送信します。どちらの方法でも、完了を待つ必要がなく、最初からやり直す必要もありません。

114 116 

115**Claude により多くのコンテキストを提供する。** プロンプトボックスに `@filename` と入力して特定のファイルを会話に取り込むか、添付ボタンを使用して画像と PDF を添付するか、ファイルをプロンプトに直接ドラッグアンドドロップします。Claude が持つコンテキストが多いほど、結果は良くなります。[ファイルとコンテキストを追加する](/docs/ja/desktop#add-files-and-context-to-prompts)を参照してください。117**Claude により多くのコンテキストを提供する。** プロンプトボックスに `@filename` と入力すると、特定のファイルを会話に取り込めます。Claude が持つコンテキストが多いほど、結果は良くなります。[ファイルとコンテキストを追加する](/docs/ja/desktop#add-files-and-context-to-prompts)を参照してください。

116 118 

117**繰り返し可能なタスクにスキルを使用する。** `/` を入力するか、**+** → **Slash commands** をクリックして、[組み込みコマンド](/docs/ja/commands)、[カスタムスキル](/docs/ja/skills)、およびプラグインスキルを参照します。スキルは、コードレビューチェックリストやデプロイメント手順など、必要なときに呼び出すことができる再利用可能なプロンプトです。119**繰り返し可能なタスクにスキルを使用する。** `/` を入力するか、**+** → **Slash commands** をクリックして、[組み込みコマンド](/docs/ja/commands)、[カスタムスキル](/docs/ja/skills)、およびプラグインスキルを参照します。スキルは、コードレビューチェックリストやデプロイメント手順など、必要なときに呼び出すことができる再利用可能なプロンプトです。

118 120 


125* **Accept edits**: Claude はファイル編集を自動的に受け入れ、より高速な反復を実現します。127* **Accept edits**: Claude はファイル編集を自動的に受け入れ、より高速な反復を実現します。

126* **Plan**: Claude は任意のファイルを編集せずにアプローチを提案します。これは大規模なリファクタリング前に役立ちます。128* **Plan**: Claude は任意のファイルを編集せずにアプローチを提案します。これは大規模なリファクタリング前に役立ちます。

127 129 

128**より多くの機能のためにプラグインを追加する。** プロンプトボックスの横にある **+** ボタンをクリックして **Plugins** を選択し、スキル、エージェント、MCP サーバーなどを追加する [プラグイン](/docs/ja/desktop#install-plugins)を参照してインストールします。130**より多くの機能のためにプラグインを追加する。** スキル、エージェント、MCP サーバーなどを追加する[プラグイン](/docs/ja/desktop#install-plugins)をインストールします。

129 131 

130**ワークスペースを整理する。** チャット、diff、ターミナル、ファイル、ブラウザーペインを任意のレイアウトにドラッグします。**Ctrl+\`** でターミナルを開いてセッションと並行してコマンドを実行するか、ファイルパスをクリックしてファイルペインで開きます。[ワークスペースを整理する](/docs/ja/desktop#arrange-your-workspace)を参照してください。132**ワークスペースを整理する。** チャット、diff、ターミナル、ファイル、ブラウザーペインを任意のレイアウトにドラッグします。**Ctrl+\`** でターミナルを開いてセッションと並行してコマンドを実行するか、ファイルパスをクリックして開きます。[ワークスペースを整理する](/docs/ja/desktop#arrange-your-workspace)を参照してください。

131 133 

132**アプリをプレビューする。** Desktop で開発サーバーを実行すると、アプリはブラウザーペインで開きます。ブラウザーペインは [外部サイトを開く](/docs/ja/desktop#browse-external-sites)こともできます。Claude は実行中のアプリを表示し、エンドポイントをテストし、ログを検査し、表示されているものに対して反復できます。[アプリをプレビューする](/docs/ja/desktop#preview-your-app)を参照してください。134**アプリをプレビューする。** Desktop で開発サーバーを実行すると、アプリはブラウザーペインで開きます。ブラウザーペインは [外部サイトを開く](/docs/ja/desktop#browse-external-sites)こともできます。Claude は実行中のアプリを表示し、エンドポイントをテストし、ログを検査し、表示されているものに対して反復できます。[アプリをプレビューする](/docs/ja/desktop#preview-your-app)を参照してください。

133 135 

134**プルリクエストを追跡する。** PR を開いた後、Claude Code は CI チェック結果を監視し、失敗を自動的に修正するか、すべてのチェックが成功したら PR をマージできます。[プルリクエストステータスを監視する](/docs/ja/desktop#monitor-pull-request-status)を参照してください。136**プルリクエストを追跡する。** PR を開いた後、Claude Code は CI チェック結果を監視し、失敗を自動的に修正できます。[プルリクエストステータスを監視する](/docs/ja/desktop#monitor-pull-request-status)を参照してください。

135 137 

136**Claude をスケジュールに設定する。** [スケジュール済みタスク](/docs/ja/desktop-scheduled-tasks)を設定して、Claude を定期的に自動実行します。毎朝のコードレビュー、週次の依存関係監査、または接続されたツールから情報を取得するブリーフィングです。138**Claude をスケジュールに設定する。** [スケジュール済みタスク](/docs/ja/desktop-scheduled-tasks)を設定して、Claude を定期的に自動実行します。毎朝のコードレビュー、週次の依存関係監査、または接続されたツールから情報を取得するブリーフィングです。

137 139 

Details

33</Tip>33</Tip>

34 34 

35<Note>35<Note>

36 デフォルトでは、スケジュール設定されたタスクは、コミットされていない変更を含む、作業ディレクトリの現在の状態に対して実行されます。タスクを作成するときに worktree トグルを有効にすると、各実行が独立した Git worktree を取得します。これは [parallel sessions](/docs/ja/desktop#work-in-parallel-with-sessions) と同じ方法です。36 デフォルトでは、スケジュールタスクは、コミットされていない変更を含む、作業ディレクトリの現在の状態に対して実行されます。タスクを作成するときに worktree トグルを有効にすると、各実行に独自の[独立した Git worktree](/docs/ja/desktop#run-a-session-in-its-own-worktree) が割り当てられます。

37</Note>37</Note>

38 38 

39<h2 id="create-a-scheduled-task">39<h2 id="create-a-scheduled-task">

desktop-wsl.md +18 −4

Details

24 24 

25<Steps>25<Steps>

26 <Step title="ディストリビューションを選択する">26 <Step title="ディストリビューションを選択する">

27 Code タブで新しいセッションを開始し、環境ピッカーを開きます。インストール済みの WSL 2 ディストリビューションが **WSL** セクションに表示されます。1 つを選択してください。27 Code タブで新しいセッションを開始し、プロンプトボックスの下([以前のレイアウト](/docs/ja/desktop#check-which-layout-you-have)ではその上)にある[環境セレクター](/docs/ja/desktop#start-a-session)を開きます。インストール済みの WSL 2 ディストリビューションが **WSL** の下に表示されます。1 つを選択してください。

28 </Step>28 </Step>

29 29 

30 <Step title="フォルダを選択する">30 <Step title="フォルダを選択する">


38 38 

39ディストリビューション内の最初のセッションは、Claude がその内部をセットアップする間、少し時間がかかります。通常のフォルダピッカーから `\\wsl.localhost\...` フォルダを開くこともでき、そのディストリビューション内で再度開きます。39ディストリビューション内の最初のセッションは、Claude がその内部をセットアップする間、少し時間がかかります。通常のフォルダピッカーから `\\wsl.localhost\...` フォルダを開くこともでき、そのディストリビューション内で再度開きます。

40 40 

41最近使用したフォルダはディストリビューションごとにピッカーに表示されるため、プロジェクトに再接続するのは 1 クリックです。

42 

43<h2 id="what-works-in-a-wsl-session">41<h2 id="what-works-in-a-wsl-session">

44 WSL セッションで機能するもの42 WSL セッションで機能するもの

45</h2>43</h2>

46 44 

47並列セッション、サイドチャット、ビジュアル diff レビュー、ブランチとプルリクエストのステータス、および worktrees はすべて機能し、ディストリビューション内の git とツールチェーンによってサポートされます。「エディタで開く」は [Remote - WSL](https://code.visualstudio.com/docs/remote/wsl) を通じてディストリビューションに接続された VS Code を開きます。45並列セッション、サイドチャット、ビジュアル diff レビュー、ブランチとプルリクエストのステータス、および worktrees はすべて機能し、ディストリビューション内の git とツールチェーンによってサポートされます。「エディタで開く」は [Remote - WSL](https://code.visualstudio.com/docs/remote/wsl) を通じてディストリビューションに接続された VS Code を開きます。

48 46 

49WSL セッションではまだ利用できない機能がいくつかあります。統合ターミナル、コネクタとプラグイン、セッションフォーク、ファイルブラウザペイン、およびコンポーザーで `@` を入力するときのファイル提案です。47Desktop の機能が WSL セッションで利用できない、または制限されている場合は、次のいずれかに該当するかを確認してください。

48 

49* **ターミナルとコネクタ**: セッションで[統合ターミナル](/docs/ja/desktop#run-commands-in-the-terminal)、[コネクタ](/docs/ja/desktop#connect-external-tools)、またはその両方が利用できない場合があります。[ターミナルまたはコネクタが利用できない場合](#check-for-the-terminal-and-connectors)を参照してください。

50* **[プラグイン](/docs/ja/desktop#install-plugins)**: WSL セッションでは利用できません

51* **ファイル編集**: [ファイルペイン](/docs/ja/desktop#open-and-edit-files)でファイルを表示することはできますが、そこで編集することはできないため、変更は Claude に依頼してください

52* **添付ファイル**: **+** メニューに **Add files or photos** の代わりに **Add image** が表示される場合、添付できるのは画像のみです。[プロンプトにファイルとコンテキストを追加する](/docs/ja/desktop#add-files-and-context-to-prompts)を参照してください。

53 

54<a id="check-for-the-terminal-and-connectors" />

55 

56<h3 id="if-the-terminal-or-connectors-are-unavailable">

57 ターミナルまたはコネクタが利用できない場合

58</h3>

59 

60WSL セッションの統合ターミナルやコネクタを自分でオンにすることはできません。

61 

62* **Claude アカウント**: この 2 つの機能は個別に展開されています。**Help > Check for Updates…** を選択し、更新後も機能が表示されない場合は、特に対応する必要はありません。

63* **[サードパーティプロバイダー](/docs/ja/third-party-integrations)**: WSL セッションではターミナルやコネクタは利用できず、Desktop を更新してもそれは変わりません

50 64 

51<h2 id="managed-devices">65<h2 id="managed-devices">

52 管理対象デバイス66 管理対象デバイス

env-vars.md +7 −11

Details

196| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud's Agent Platform へのリクエストの宛先となる GCP プロジェクト ID。[GCP 認証情報を設定する](/docs/ja/google-vertex-ai#3-configure-gcp-credentials)を参照してください |196| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud's Agent Platform へのリクエストの宛先となる GCP プロジェクト ID。[GCP 認証情報を設定する](/docs/ja/google-vertex-ai#3-configure-gcp-credentials)を参照してください |

197| `ANTHROPIC_WORKSPACE_ID` | [ワークロードアイデンティティフェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)のワークスペース ID。フェデレーションルールのスコープが複数のワークスペースにまたがる場合に設定し、トークン交換でどのワークスペースを対象にするかを指定します |197| `ANTHROPIC_WORKSPACE_ID` | [ワークロードアイデンティティフェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)のワークスペース ID。フェデレーションルールのスコープが複数のワークスペースにまたがる場合に設定し、トークン交換でどのワークスペースを対象にするかを指定します |

198| `API_FORCE_IDLE_TIMEOUT` | バイトが届かない場合にストリーミングのモデルレスポンスを中止する、5 分間のボディアイドルタイムアウトを上書きします。低速な[ゲートウェイ](/docs/ja/llm-gateway)やローカルモデルがチャンク間で 5 分以上停止する場合などにタイムアウトをオフにするには `0` を、すべてのプロバイダーでオンのままにするには `1` を設定します。設定されていない場合、タイムアウトは Anthropic API への直接接続、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` を設定した Amazon Bedrock 以外のプロバイダーで有効です。[ストリームウォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)はこれとは独立して動作し、ここで `0` を設定した場合でも、長時間の無応答の停止を中止します |198| `API_FORCE_IDLE_TIMEOUT` | バイトが届かない場合にストリーミングのモデルレスポンスを中止する、5 分間のボディアイドルタイムアウトを上書きします。低速な[ゲートウェイ](/docs/ja/llm-gateway)やローカルモデルがチャンク間で 5 分以上停止する場合などにタイムアウトをオフにするには `0` を、すべてのプロバイダーでオンのままにするには `1` を設定します。設定されていない場合、タイムアウトは Anthropic API への直接接続、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` を設定した Amazon Bedrock 以外のプロバイダーで有効です。[ストリームウォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)はこれとは独立して動作し、ここで `0` を設定した場合でも、長時間の無応答の停止を中止します |

199| `API_TIMEOUT_MS` | API リクエストのタイムアウト(ミリ秒)(デフォルト:600000、つまり 10 分。最大:2147483647)。ストリーミングリクエストは、この時間内にレスポンスヘッダーを受信する必要があります。低速なネットワークでリクエストがタイムアウトする場合や、プロキシ経由でルーティングする場合は、この値を増やしてください |199| `API_TIMEOUT_MS` | 各 API リクエストの試行がレスポンスヘッダーを受信するまでの時間(ミリ秒)(デフォルト:600000、つまり 10 分。最大:2147483647)。その後ストリーミングレスポンスが実行される時間は制限しません。正の値を設定すると、[非ストリーミングリクエスト](/docs/ja/errors#streaming-response-ended-before-any-complete-data-was-received)の各試行はその時間内に完了する必要があります。低速なネットワークでリクエストがタイムアウトする場合や、プロキシ経由でルーティングする場合は、この値を増やしてください |

200| `AWS_BEARER_TOKEN_BEDROCK` | 認証用の Amazon Bedrock API キー([Amazon Bedrock API キー](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)を参照) |200| `AWS_BEARER_TOKEN_BEDROCK` | 認証用の Amazon Bedrock API キー([Amazon Bedrock API キー](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)を参照) |

201| `BASH_DEFAULT_TIMEOUT_MS` | フォアグラウンドの Bash または PowerShell ツールコマンドのデフォルトタイムアウト(ミリ秒)(デフォルト:120000、つまり 2 分)。[バックグラウンドコマンドのデフォルトの時間制限](/docs/ja/tools-reference#time-limit-for-background-commands)を超える値を設定すると、無人セッションではそのデフォルトが置き換えられます。バックグラウンドの時間制限には Claude Code v2.1.285 以降が必要です |201| `BASH_DEFAULT_TIMEOUT_MS` | フォアグラウンドの Bash または PowerShell ツールコマンドのデフォルトタイムアウト(ミリ秒)(デフォルト:120000、つまり 2 分)。[バックグラウンドコマンドのデフォルトの時間制限](/docs/ja/tools-reference#time-limit-for-background-commands)を超える値を設定すると、無人セッションではそのデフォルトが置き換えられます。バックグラウンドの時間制限には Claude Code v2.1.285 以降が必要です |

202| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果に読み込む bash 出力の最大文字数(デフォルト:30000、最大:150000)。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 設定を行っている場合、Claude Code はこの変数を無視します。[出力の制限](/docs/ja/tools-reference#output-limits)を参照してください |202| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果に読み込む bash 出力の最大文字数(デフォルト:30000、最大:150000)。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 設定を行っている場合、Claude Code はこの変数を無視します。[出力の制限](/docs/ja/tools-reference#output-limits)を参照してください |


230| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | v2.1.283 で削除されました。代わりに `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` を使用してください |230| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | v2.1.283 で削除されました。代わりに `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` を使用してください |

231| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | [自動圧縮ウィンドウ](/docs/ja/model-config#set-the-auto-compact-window)をトークン単位で `100000` から `1000000` の範囲で設定します。`500000` のようなプレーンな整数のみを受け付けます。`500k` のような値は `500` として読み取られ、最小値の 100K に制限されます。実際のウィンドウは、モデルのコンテキストウィンドウが上限になります。`/autocompact` コマンド、`--autocompact` フラグ、`autoCompactWindow` 設定より優先されます。ステータスラインの `used_percentage` は常にモデルのコンテキストウィンドウ全体を基準に測定されるため、この変数を設定すると、そのパーセンテージはコンテキスト圧縮が実行されるタイミングを示さなくなります |231| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | [自動圧縮ウィンドウ](/docs/ja/model-config#set-the-auto-compact-window)をトークン単位で `100000` から `1000000` の範囲で設定します。`500000` のようなプレーンな整数のみを受け付けます。`500k` のような値は `500` として読み取られ、最小値の 100K に制限されます。実際のウィンドウは、モデルのコンテキストウィンドウが上限になります。`/autocompact` コマンド、`--autocompact` フラグ、`autoCompactWindow` 設定より優先されます。ステータスラインの `used_percentage` は常にモデルのコンテキストウィンドウ全体を基準に測定されるため、この変数を設定すると、そのパーセンテージはコンテキスト圧縮が実行されるタイミングを示さなくなります |

232| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 自動的な [IDE 接続](/docs/ja/vs-code)を上書きします。デフォルトでは、サポートされている IDE の統合ターミナル内で起動すると、Claude Code は自動的に接続します。これを防ぐには `false` に設定します。tmux が親ターミナルを隠している場合など、自動検出が失敗したときに接続を強制的に試行するには `true` に設定します。[`autoConnectIde`](/docs/ja/settings-reference#autoconnectide) グローバル設定より優先されます |232| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 自動的な [IDE 接続](/docs/ja/vs-code)を上書きします。デフォルトでは、サポートされている IDE の統合ターミナル内で起動すると、Claude Code は自動的に接続します。これを防ぐには `false` に設定します。tmux が親ターミナルを隠している場合など、自動検出が失敗したときに接続を強制的に試行するには `true` に設定します。[`autoConnectIde`](/docs/ja/settings-reference#autoconnectide) グローバル設定より優先されます |

233| `CLAUDE_CODE_AUTO_MODE_MODEL` | [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)で Claude Code が送信する分類器リクエストのモデルを設定します。`claude-sonnet-4-6` のような完全なモデル ID を使用します。Claude Code がこれを無視するケースについては、[分類器モデルを選択する](/docs/ja/permission-modes#choose-the-classifier-model)を参照してください。Claude Code v2.1.302 以降が必要です |

233| `CLAUDE_CODE_AUTO_MODE_SERVER` | Claude Code がサーバーに [auto モードのアクションのレビュー](/docs/ja/permission-modes#server-side-classifier-review)を依頼するかどうかを制御します。代わりに Claude Code 独自の分類器リクエストを使用するには、`0` に設定します。Anthropic API への直接接続では v2.1.281 以降が必要です。リンク先のセクションには、変数が設定されていない場合にどのセッションがサーバーに依頼するか、またどのバージョンからかが記載されています。Claude Code v2.1.271 以降が必要です |234| `CLAUDE_CODE_AUTO_MODE_SERVER` | Claude Code がサーバーに [auto モードのアクションのレビュー](/docs/ja/permission-modes#server-side-classifier-review)を依頼するかどうかを制御します。代わりに Claude Code 独自の分類器リクエストを使用するには、`0` に設定します。Anthropic API への直接接続では v2.1.281 以降が必要です。リンク先のセクションには、変数が設定されていない場合にどのセッションがサーバーに依頼するか、またどのバージョンからかが記載されています。Claude Code v2.1.271 以降が必要です |

234| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | AWS のデフォルト認証情報プロバイダーチェーンが認証情報を生成するまで Claude Code が待機する時間(ミリ秒)。この時間を過ぎると、リクエストは [`AWS default-chain credential resolve timed out`](/docs/ja/errors#aws-default-chain-credential-resolve-timed-out) で失敗します(デフォルト:`60000`)。`aws-vault` のようなラッパーを介した MFA 付きのブラウザベースの SSO サインインなど、チェーン内のステップが正当な理由でより長い時間を必要とする場合に値を引き上げます。Amazon Bedrock、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、[Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)に適用されます。[認証情報のキャッシュと解決タイムアウト](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout)を参照してください。Claude Code v2.1.207 以降が必要です |235| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | AWS のデフォルト認証情報プロバイダーチェーンが認証情報を生成するまで Claude Code が待機する時間(ミリ秒)。この時間を過ぎると、リクエストは [`AWS default-chain credential resolve timed out`](/docs/ja/errors#aws-default-chain-credential-resolve-timed-out) で失敗します(デフォルト:`60000`)。`aws-vault` のようなラッパーを介した MFA 付きのブラウザベースの SSO サインインなど、チェーン内のステップが正当な理由でより長い時間を必要とする場合に値を引き上げます。Amazon Bedrock、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、[Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)に適用されます。[認証情報のキャッシュと解決タイムアウト](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout)を参照してください。Claude Code v2.1.207 以降が必要です |

235| `CLAUDE_CODE_BASH_EDIT_DIFF` | `0` に設定すると [Bash コマンドの実行中に変更されたファイルの差分](/docs/ja/hooks#bash)をオフにし、`1` に設定するとすべての権限モードで差分を記録します。[`bashEditDiffEnabled`](/docs/ja/settings-reference#basheditdiffenabled) 設定より優先されます。Claude Code v2.1.269 以降が必要です |236| `CLAUDE_CODE_BASH_EDIT_DIFF` | `0` に設定すると [Bash コマンドの実行中に変更されたファイルの差分](/docs/ja/hooks#bash)をオフにし、`1` に設定するとすべての権限モードで差分を記録します。[`bashEditDiffEnabled`](/docs/ja/settings-reference#basheditdiffenabled) 設定より優先されます。Claude Code v2.1.269 以降が必要です |


241| `CLAUDE_CODE_CLIENT_CERT` | mTLS 認証用のクライアント証明書ファイルへのパス |242| `CLAUDE_CODE_CLIENT_CERT` | mTLS 認証用のクライアント証明書ファイルへのパス |

242| `CLAUDE_CODE_CLIENT_KEY` | mTLS 認証用のクライアント秘密鍵ファイルへのパス |243| `CLAUDE_CODE_CLIENT_KEY` | mTLS 認証用のクライアント秘密鍵ファイルへのパス |

243| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 暗号化された CLAUDE\_CODE\_CLIENT\_KEY のパスフレーズ(省略可能) |244| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 暗号化された CLAUDE\_CODE\_CLIENT\_KEY のパスフレーズ(省略可能) |

244| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | v2.1.186 で削除され、現在は何も行いません。以前は、ストリーミング API リクエストの接続、TLS、レスポンスヘッダーのフェーズに個別のタイムアウトを設定していました。リクエストごとのタイムアウトには `API_TIMEOUT_MS` を使用します。ストリーミングリクエストのレスポンスヘッダーのフェーズについては、`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` を参照してください |245| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | v2.1.186 で削除され、現在は何の効果もありません。以前は、ストリーミング API リクエストの接続、TLS、レスポンスヘッダーのフェーズに個別のタイムアウトを設定していました。代わりに `API_TIMEOUT_MS` を使用してください。ストリーミングリクエストのレスポンスヘッダーのフェーズについては、`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` を参照してください |

245| `CLAUDE_CODE_DEBUG_LOGS_DIR` | デバッグログファイルのパスを上書きします。名前に反して、これはディレクトリではなくファイルパスです。`--debug`、`/debug`、または `DEBUG` 環境変数を使用して、別途デバッグモードを有効にする必要があります。この変数を設定するだけではログは有効になりません。[`--debug-file`](/docs/ja/cli-reference#cli-flags) フラグは両方を一度に行います。デフォルトは `~/.claude/debug/<session-id>.txt` です |246| `CLAUDE_CODE_DEBUG_LOGS_DIR` | デバッグログファイルのパスを上書きします。名前に反して、これはディレクトリではなくファイルパスです。`--debug`、`/debug`、または `DEBUG` 環境変数を使用して、別途デバッグモードを有効にする必要があります。この変数を設定するだけではログは有効になりません。[`--debug-file`](/docs/ja/cli-reference#cli-flags) フラグは両方を一度に行います。デフォルトは `~/.claude/debug/<session-id>.txt` です |

246| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | デバッグログファイルに書き込まれる最小ログレベル。値:`verbose`、`debug`(デフォルト)、`info`、`warn`、`error`。ステータスラインコマンドの完全な出力など、大量の診断情報を含めるには `verbose` に設定し、ノイズを減らすには `error` に引き上げます |247| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | デバッグログファイルに書き込まれる最小ログレベル。値:`verbose`、`debug`(デフォルト)、`info`、`warn`、`error`。ステータスラインコマンドの完全な出力など、大量の診断情報を含めるには `verbose` に設定し、ノイズを減らすには `error` に引き上げます |

247| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | `1` に設定すると、[1M コンテキストウィンドウ](/docs/ja/model-config#extended-context)のサポートをオフにします。Claude Code はモデルピッカーから `[1m]` モデルバリアントを削除し、デフォルトで 1M ウィンドウで実行されるモデルを 200K ウィンドウに制限します。[1M コンテキストをオフにする](/docs/ja/model-config#turn-off-1m-context)を参照してください。コンプライアンス要件のあるエンタープライズ環境で便利です。認識されない `[1m]` モデル ID のウィンドウを補正する際の役割については、[ゲートウェイまたはカスタムモデル ID のウィンドウを補正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id)を参照してください |248| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | `1` に設定すると、[1M コンテキストウィンドウ](/docs/ja/model-config#extended-context)のサポートをオフにします。Claude Code はモデルピッカーから `[1m]` モデルバリアントを削除し、デフォルトで 1M ウィンドウで実行されるモデルを 200K ウィンドウに制限します。[1M コンテキストをオフにする](/docs/ja/model-config#turn-off-1m-context)を参照してください。コンプライアンス要件のあるエンタープライズ環境で便利です。認識されない `[1m]` モデル ID のウィンドウを補正する際の役割については、[ゲートウェイまたはカスタムモデル ID のウィンドウを補正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id)を参照してください |


304| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Claude がツール呼び出しの入力を生成するのに合わせて、API から入力をストリーミングするかどうかを制御します。これがオフの場合、長いファイル書き込みのような大きなツール入力は Claude が生成を終えた後にのみ届くため、ハングしているように見えることがあります。Anthropic API ではデフォルトで有効です。Amazon Bedrock および Google Cloud's Agent Platform では、デプロイされたコンテナがサポートしているモデルごとに有効になります。`0` に設定するとオプトアウトします。`ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL`、または `ANTHROPIC_BEDROCK_BASE_URL` を介してプロキシ経由でルーティングする場合に、`1` に設定すると強制的にオンになります。Microsoft Foundry および [ゲートウェイ](/docs/ja/llm-gateway) 接続ではデフォルトでオフです |305| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Claude がツール呼び出しの入力を生成するのに合わせて、API から入力をストリーミングするかどうかを制御します。これがオフの場合、長いファイル書き込みのような大きなツール入力は Claude が生成を終えた後にのみ届くため、ハングしているように見えることがあります。Anthropic API ではデフォルトで有効です。Amazon Bedrock および Google Cloud's Agent Platform では、デプロイされたコンテナがサポートしているモデルごとに有効になります。`0` に設定するとオプトアウトします。`ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL`、または `ANTHROPIC_BEDROCK_BASE_URL` を介してプロキシ経由でルーティングする場合に、`1` に設定すると強制的にオンになります。Microsoft Foundry および [ゲートウェイ](/docs/ja/llm-gateway) 接続ではデフォルトでオフです |

305| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `ANTHROPIC_BASE_URL` が LiteLLM、Kong、内部プロキシなどの Anthropic 互換ゲートウェイを指している場合に、`1` に設定すると、ゲートウェイの `/v1/models` エンドポイントから `/model` ピッカーの一覧を作成します。共有 API キーを使うゲートウェイでは、そうしないとキーがアクセスできるすべてのモデルがすべてのユーザーに表示されてしまうため、デフォルトではオフです。検出されたモデルは、セッションが受け取る [`availableModels`](/docs/ja/settings-reference#availablemodels) 許可リストによって引き続きフィルタリングされます。[ゲートウェイ構成ではサーバー管理設定による配信を利用できない](/docs/ja/server-managed-settings#platform-availability) ため、このリストは [MDM または管理設定ファイル](/docs/ja/managed-settings#delivery-mechanisms) を通じて配信してください |306| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `ANTHROPIC_BASE_URL` が LiteLLM、Kong、内部プロキシなどの Anthropic 互換ゲートウェイを指している場合に、`1` に設定すると、ゲートウェイの `/v1/models` エンドポイントから `/model` ピッカーの一覧を作成します。共有 API キーを使うゲートウェイでは、そうしないとキーがアクセスできるすべてのモデルがすべてのユーザーに表示されてしまうため、デフォルトではオフです。検出されたモデルは、セッションが受け取る [`availableModels`](/docs/ja/settings-reference#availablemodels) 許可リストによって引き続きフィルタリングされます。[ゲートウェイ構成ではサーバー管理設定による配信を利用できない](/docs/ja/server-managed-settings#platform-availability) ため、このリストは [MDM または管理設定ファイル](/docs/ja/managed-settings#delivery-mechanisms) を通じて配信してください |

306| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | v2.1.142 で削除されました。このとき [fast mode](/docs/ja/fast-mode) のデフォルトが Opus 4.6 から Opus 4.7 に変わりました |307| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | v2.1.142 で削除されました。このとき [fast mode](/docs/ja/fast-mode) のデフォルトが Opus 4.6 から Opus 4.7 に変わりました |

307| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | `false` に設定すると、プロンプト入力に表示されるグレー表示の予測であるプロンプト候補をオフにします。[`promptSuggestionEnabled`](/docs/ja/settings-reference#promptsuggestionenabled) 設定(`/config` の **Prompt suggestions** トグルが書き込む設定)よりも優先されます。Claude Code は、[アカウントが使用制限に近づいているか達している間も候補を一時停止します](/docs/ja/interactive-mode#when-claude-code-skips-suggestions)。`true` に設定すると、制限に達するまで候補をオンのままにします。Claude Code v2.1.238 以降が必要です。[プロンプト候補](/docs/ja/interactive-mode#prompt-suggestions) を参照してください |308| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | `false` に設定すると、プロンプト入力に表示されるグレーアウトされた予測であるプロンプト候補をオフにします。[`promptSuggestionEnabled`](/docs/ja/settings-reference#promptsuggestionenabled) 設定よりも優先されます。この設定は `/config` の **Prompt suggestions** トグルが書き込むものです。また、Claude Code は[アカウントが使用制限に近づいているか達している間、候補を一時停止します](/docs/ja/interactive-mode#when-claude-code-skips-suggestions)。`true` に設定すると、制限に達するまでその一時停止が適用されないようにします。Claude Code v2.1.238 以降が必要です。[プロンプト候補](/docs/ja/interactive-mode#prompt-suggestions)を参照してください |

308| `CLAUDE_CODE_ENABLE_TASKS` | [タスク追跡ツールを持つセッション](/docs/ja/tools-reference#task-tool-availability) で Claude Code が提供するタスク追跡ツールを選択します。デフォルトでは、Claude Code は Task ツール `TaskCreate`、`TaskUpdate`、`TaskGet`、`TaskList` を提供します。`0` に設定すると、代わりに従来の `TodoWrite` ツールを使用します。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照してください |309| `CLAUDE_CODE_ENABLE_TASKS` | [タスク追跡ツールを持つセッション](/docs/ja/tools-reference#task-tool-availability) で Claude Code が提供するタスク追跡ツールを選択します。デフォルトでは、Claude Code は Task ツール `TaskCreate`、`TaskUpdate`、`TaskGet`、`TaskList` を提供します。`0` に設定すると、代わりに従来の `TodoWrite` ツールを使用します。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照してください |

309| `CLAUDE_CODE_ENABLE_TELEMETRY` | `1` に設定すると、メトリクスとログのための OpenTelemetry データ収集を有効にします。OTel エクスポーターを設定する前に必要です。シェル、ユーザー設定、または管理設定で設定してください。[プロジェクト設定およびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[モニタリング](/docs/ja/monitoring-usage) を参照してください |310| `CLAUDE_CODE_ENABLE_TELEMETRY` | `1` に設定すると、メトリクスとログのための OpenTelemetry データ収集を有効にします。OTel エクスポーターを設定する前に必要です。シェル、ユーザー設定、または管理設定で設定してください。[プロジェクト設定およびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[モニタリング](/docs/ja/monitoring-usage) を参照してください |

310| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | `1` に設定すると、すべてのモデルでタスク追跡ツールを使用できるようにします。これがない場合、Claude Code は [Task ツールの利用可否](/docs/ja/tools-reference#task-tool-availability) に記載されているモデルでのみ、デフォルトでこれらのツールを提供します。`CLAUDE_CODE_ENABLE_TASKS` は引き続き Task ツールか `TodoWrite` かを選択します。Claude Code v2.1.233 以降が必要です |311| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | `1` に設定すると、すべてのモデルでタスク追跡ツールを使用できるようにします。これがない場合、Claude Code は [Task ツールの利用可否](/docs/ja/tools-reference#task-tool-availability) に記載されているモデルでのみ、デフォルトでこれらのツールを提供します。`CLAUDE_CODE_ENABLE_TASKS` は引き続き Task ツールか `TodoWrite` かを選択します。Claude Code v2.1.233 以降が必要です |


316| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | ターミナルが取り消し線をサポートしているものの、`TERM_PROGRAM` が転送されていない SSH 経由など自動検出されない場合に、`1` に設定すると Claude の応答内の `~~text~~` を強制的に取り消し線で表示します。これがない場合、検出されないターミナルではテキストが取り消し線で表示されず、`~~` マーカーがそのまま表示されます。Claude Code v2.1.186 以降が必要です |317| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | ターミナルが取り消し線をサポートしているものの、`TERM_PROGRAM` が転送されていない SSH 経由など自動検出されない場合に、`1` に設定すると Claude の応答内の `~~text~~` を強制的に取り消し線で表示します。これがない場合、検出されないターミナルではテキストが取り消し線で表示されず、`~~` マーカーがそのまま表示されます。Claude Code v2.1.186 以降が必要です |

317| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | ターミナルがサポートしているものの自動検出されない場合に、`1` に設定すると DEC プライベートモード 2026 の [同期出力](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) を強制的に有効にします。BSU/ESU を実装しているものの機能プローブに応答しない Emacs `eat` などのエミュレーターに便利です。tmux の下では効果がありません。[フルスクリーンレンダリング](/docs/ja/fullscreen) に切り替える `CLAUDE_CODE_NO_FLICKER` とは異なり、これはレンダラーを変更しません |318| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | ターミナルがサポートしているものの自動検出されない場合に、`1` に設定すると DEC プライベートモード 2026 の [同期出力](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) を強制的に有効にします。BSU/ESU を実装しているものの機能プローブに応答しない Emacs `eat` などのエミュレーターに便利です。tmux の下では効果がありません。[フルスクリーンレンダリング](/docs/ja/fullscreen) に切り替える `CLAUDE_CODE_NO_FLICKER` とは異なり、これはレンダラーを変更しません |

318| `CLAUDE_CODE_FORCE_TERMINAL_IMAGES` | ターミナルが Unicode プレースホルダー付きの kitty グラフィックスプロトコル画像を描画するものの自動検出されない場合に、`1` に設定すると [mod の `Image` 要素](/docs/ja/plugins/mods/reference#elements) を画像として描画します。[Claude Code が検出するターミナル](/docs/ja/plugins/mods/gallery#image-and-client) と、tmux や screen 内では役に立たない理由を参照してください |319| `CLAUDE_CODE_FORCE_TERMINAL_IMAGES` | ターミナルが Unicode プレースホルダー付きの kitty グラフィックスプロトコル画像を描画するものの自動検出されない場合に、`1` に設定すると [mod の `Image` 要素](/docs/ja/plugins/mods/reference#elements) を画像として描画します。[Claude Code が検出するターミナル](/docs/ja/plugins/mods/gallery#image-and-client) と、tmux や screen 内では役に立たない理由を参照してください |

319| `CLAUDE_CODE_FORK_SUBAGENT` | [フォークモード](/docs/ja/sub-agents#turn-fork-mode-on-or-off) を制御します。フォークモードでは Claude 自身が [フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation) を生成でき、デフォルトでは対話セッションでのみオンです。`1` に設定すると `claude -p` と Agent SDK でもオンになり、`0` に設定するとすべての種類のセッションでオフになります。`/subtask` はフォークモードがオンかどうかに関係なく実行できます。対話セッションでのデフォルトには Claude Code v2.1.232 以降が必要です。それ以前のバージョンでは、この変数を `1` に設定してフォークモードをオンにしてください |320| `CLAUDE_CODE_FORK_SUBAGENT` | fork モードを制御します。fork モードはデフォルトでオンで、Claude が自ら[フォーク](/docs/ja/sub-agents#fork-the-current-conversation)を開始できるようにします。fork モードがオンの間、Claude はマシン上の対話型ターミナル、VS Code、またはデスクトップのセッションで[サブエージェントを待機する](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)こともできません。`0` に設定すると fork モードをオフにします。バージョンについては、[fork モードをオフにする](/docs/ja/sub-agents#turn-fork-mode-on-or-off)を参照してください |

320| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | `1` に設定すると、`claude -p --output-format stream-json` の出力に [サブエージェント](/docs/ja/sub-agents) のテキストと思考ブロックを出力します。これは [`--forward-subagent-text`](/docs/ja/cli-reference#cli-flags) フラグと同じ動作です。ハーネスが `claude` を呼び出し、フラグ自体を渡せない場合にこの変数を使用します。stream-json 出力を伴う非対話モード以外ではエラーで終了するフラグとは異なり、この変数はそのような場合には無視されるため、プロセス全体で設定されていてもネストされた呼び出しは引き続き動作します。Claude Code v2.1.211 以降が必要です |321| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | `1` に設定すると、`claude -p --output-format stream-json` の出力に [サブエージェント](/docs/ja/sub-agents) のテキストと思考ブロックを出力します。これは [`--forward-subagent-text`](/docs/ja/cli-reference#cli-flags) フラグと同じ動作です。ハーネスが `claude` を呼び出し、フラグ自体を渡せない場合にこの変数を使用します。stream-json 出力を伴う非対話モード以外ではエラーで終了するフラグとは異なり、この変数はそのような場合には無視されるため、プロセス全体で設定されていてもネストされた呼び出しは引き続き動作します。Claude Code v2.1.211 以降が必要です |

321| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | `1` に設定すると、カスタムプロキシや、Amazon Bedrock、Claude Platform on AWS などのサードパーティプロバイダーで、`x-claude-code-request-class` や `x-claude-code-compaction` などの [ゲートウェイヒントヘッダー](/docs/ja/llm-gateway-protocol#gateway-hint-headers) を送信します。`0` に設定すると、Claude Code がデフォルトでこれらを送信する Anthropic API への直接接続を含むすべての接続で、送信を停止します。Claude Code v2.1.273 以降が必要です |322| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | `1` に設定すると、カスタムプロキシや、Amazon Bedrock、Claude Platform on AWS などのサードパーティプロバイダーで、`x-claude-code-request-class` や `x-claude-code-compaction` などの [ゲートウェイヒントヘッダー](/docs/ja/llm-gateway-protocol#gateway-hint-headers) を送信します。`0` に設定すると、Claude Code がデフォルトでこれらを送信する Anthropic API への直接接続を含むすべての接続で、送信を停止します。Claude Code v2.1.273 以降が必要です |

322| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` がオンにする [ゲートウェイモデル検出](/docs/ja/llm-gateway-protocol#model-discovery) リクエストのタイムアウト(ミリ秒)(デフォルト: `3000`)。起動時にゲートウェイが `/v1/models` に応答するのに 3 秒より長くかかる場合は、値を増やしてください。数字のみを受け付けます。`0`、負の値、その他の表記ではデフォルトが維持されます。Claude Code v2.1.269 以降が必要です |323| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` がオンにする [ゲートウェイモデル検出](/docs/ja/llm-gateway-protocol#model-discovery) リクエストのタイムアウト(ミリ秒)(デフォルト: `3000`)。起動時にゲートウェイが `/v1/models` に応答するのに 3 秒より長くかかる場合は、値を増やしてください。数字のみを受け付けます。`0`、負の値、その他の表記ではデフォルトが維持されます。Claude Code v2.1.269 以降が必要です |


340| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | メインの会話の下に許可される [サブエージェントの階層](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) の数(デフォルト: 3)。デフォルトでは、サブエージェントは独自のサブエージェントを生成でき、3 番目の階層のサブエージェントはそれ以上生成できません。`1` に設定するとネストをオフにします。v2.1.217 から v2.1.218 ではデフォルトが 1 だったため、制限を引き上げない限りサブエージェントは独自のサブエージェントを生成できませんでした。v2.1.219 でデフォルトが 3 に引き上げられました。正の整数を数字のみで受け付けます。それ以外の値は無視されるため、制限を調整することはできますが、撤廃することはできません。Claude Code v2.1.217 以降が必要です |341| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | メインの会話の下に許可される [サブエージェントの階層](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) の数(デフォルト: 3)。デフォルトでは、サブエージェントは独自のサブエージェントを生成でき、3 番目の階層のサブエージェントはそれ以上生成できません。`1` に設定するとネストをオフにします。v2.1.217 から v2.1.218 ではデフォルトが 1 だったため、制限を引き上げない限りサブエージェントは独自のサブエージェントを生成できませんでした。v2.1.219 でデフォルトが 3 に引き上げられました。正の整数を数字のみで受け付けます。それ以外の値は無視されるため、制限を調整することはできますが、撤廃することはできません。Claude Code v2.1.217 以降が必要です |

341| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 並列に実行できる読み取り専用ツールおよびサブエージェントの最大数(デフォルト: 10)。値を大きくすると並列性が高まりますが、より多くのリソースを消費します |342| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 並列に実行できる読み取り専用ツールおよびサブエージェントの最大数(デフォルト: 10)。値を大きくすると並列性が高まりますが、より多くのリソースを消費します |

342| `CLAUDE_CODE_MAX_TURNS` | 明示的な制限が渡されていない場合のエージェントターン数の上限。[`--max-turns`](/docs/ja/cli-reference#cli-flags) を渡すのと同等で、両方が設定されている場合はフラグが優先されます。正の整数でない値は、上限なしとして扱われるのではなく、起動時にエラーで拒否されます |343| `CLAUDE_CODE_MAX_TURNS` | 明示的な制限が渡されていない場合のエージェントターン数の上限。[`--max-turns`](/docs/ja/cli-reference#cli-flags) を渡すのと同等で、両方が設定されている場合はフラグが優先されます。正の整数でない値は、上限なしとして扱われるのではなく、起動時にエラーで拒否されます |

343| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | [WebSearch](/docs/ja/tools-reference#session-search-limit) 呼び出しの上限(デフォルト: 200)。Claude が上限に達すると、以降の WebSearch 呼び出しは、すでに収集した情報で作業を続けるよう伝える通知を返します。正の整数を受け付け、値に上限はありません。それ以外の値は無視されてデフォルトが適用されるため、上限を引き上げることはできますが、オフにすることはできません。Claude Code v2.1.212 以降が必要です |344| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | [WebSearch](/docs/ja/tools-reference#session-search-limit) 呼び出しの上限(デフォルト: 200)。Claude が上限に達すると、それ以降の WebSearch 呼び出しは、すでに収集した情報で作業を続け、その旨を回答に記載するよう Claude に伝える通知を返します。上限値の制約なしに正の整数を受け付けます。それ以外は無視されてデフォルトが適用されるため、上限を引き上げることはできますが、オフにすることはできません。Claude Code v2.1.212 以降が必要です |

344| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | `1` に設定すると、シェル環境を継承する代わりに、安全な最小限のベースライン環境とサーバーに設定された `env` のみで stdio MCP サーバーを起動します |345| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | `1` に設定すると、シェル環境を継承する代わりに、安全な最小限のベースライン環境とサーバーに設定された `env` のみで stdio MCP サーバーを起動します |

345| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | 実行中の MCP ツール呼び出しが [バックグラウンドタスクに移行する](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) までの経過時間(ミリ秒)(デフォルト: 120000、つまり 2 分)。`0` に設定すると自動バックグラウンド化をオフにします。Claude Code v2.1.212 以降が必要です |346| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | 実行中の MCP ツール呼び出しが [バックグラウンドタスクに移行する](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) までの経過時間(ミリ秒)(デフォルト: 120000、つまり 2 分)。`0` に設定すると自動バックグラウンド化をオフにします。Claude Code v2.1.212 以降が必要です |

346| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | [非対話](/docs/ja/headless)セッションの最初のターンが、まだ接続中の MCP サーバーを待つ時間(ミリ秒)。デフォルトの[最初のターンの待機](/docs/ja/agent-sdk/mcp#connection-timing)の代わりに使用されます。設定すると、待機は保留中のすべてのサーバーが対象になります。[セルフホスト環境](/docs/ja/self-hosted-environments-configuration#connection-timing)では、待機の長さのみが変わります。`0` に設定すると待機をスキップします。[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) のサーバーは、値に関係なく独自の `MCP_TIMEOUT` の待機を維持します。Claude Code v2.1.274 以降が必要です |347| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | [非対話](/docs/ja/headless)セッションの最初のターンが、まだ接続中の MCP サーバーを待つ時間(ミリ秒)。デフォルトの[最初のターンの待機](/docs/ja/agent-sdk/mcp#connection-timing)の代わりに使用されます。設定すると、待機は保留中のすべてのサーバーが対象になります。[セルフホスト環境](/docs/ja/self-hosted-environments-configuration#connection-timing)では、待機の長さのみが変わります。`0` に設定すると待機をスキップします。[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) のサーバーは、値に関係なく独自の `MCP_TIMEOUT` の待機を維持します。Claude Code v2.1.274 以降が必要です |


599* [`/skill-doctor`](/docs/ja/skills#find-unused-skills) を実行する、またはそのレポートを `/plugin` の **Stats** タブで開く600* [`/skill-doctor`](/docs/ja/skills#find-unused-skills) を実行する、またはそのレポートを `/plugin` の **Stats** タブで開く

600* claude.ai アカウントで有効にした[スキル](/docs/ja/skills#where-synced-skills-load)と[プラグイン](/docs/ja/plugins/loading#synced-plugins)をターミナルセッションに同期する601* claude.ai アカウントで有効にした[スキル](/docs/ja/skills#where-synced-skills-load)と[プラグイン](/docs/ja/plugins/loading#synced-plugins)をターミナルセッションに同期する

601* [You should know mod](/docs/ja/interactive-mode#you-should-know-suggestions) をオンにする602* [You should know mod](/docs/ja/interactive-mode#you-should-know-suggestions) をオンにする

602* VS Code 拡張機能のチャットパネルで [mod](/docs/ja/plugins/mods/overview#where-mods-run) が描画する内容を表示する。mod のフックは引き続き実行されます

603* [アドバイザーツール](/docs/ja/advisor#requirements)を使用する603* [アドバイザーツール](/docs/ja/advisor#requirements)を使用する

604* [アーティファクトへのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact)を読む、または返信する604* [アーティファクトへのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact)を読む、または返信する

605* Claude に[別の組織の公開アーティファクト](/docs/ja/artifacts#read-an-artifact-shared-with-you)を読ませる605* Claude に[別の組織の公開アーティファクト](/docs/ja/artifacts#read-an-artifact-shared-with-you)を読ませる


613 インストールまたはアップグレード後の最初のセッション613 インストールまたはアップグレード後の最初のセッション

614</h3>614</h3>

615 615 

616Claude Code をインストールした後、または機能が追加されたバージョンにアップグレードした後の最初のセッションでは、[フラグで制御される機能](#features-that-need-feature-flag-fetching)が利用できないことがあります。また、そのセッションは、以降のセッションとは異なる[権限モード](/docs/ja/permission-modes#which-mode-a-session-starts-in)で開始されることもあります。そのセッション中に Claude Code がフラグを取得すると、フラグはマシンに保存されるため、そのマシンでの次のセッションでは機能が利用でき、通常の開始権限モードになります。616Claude Code をインストールした後、または機能が追加されたバージョンにアップグレードした後の最初のセッションでは、[フラグで制御される機能](#features-that-need-feature-flag-fetching)が利用できないことがあります。そのセッション中に Claude Code が機能フラグを取得すると、フラグはマシンに保存されるため、そのマシンでの次のセッションでは機能が利用できます。

617 

618新規インストール後、`claude -p`、Agent SDK、VS Code 拡張機能などの非対話型セッションでは、Claude Code は[開始権限モードを選択する](/docs/ja/permission-modes#which-mode-a-session-starts-in)前にフラグを取得できることがありますが、必ずしもフラグを待つわけではありません。

619 617 

620次のような構成では、最初以降のセッションも、新たに取得したフラグなしで開始されます。618次のような構成では、最初以降のセッションも、新たに取得したフラグなしで開始されます。

621 619 

622* **実行のたびにクリーンな環境になる場合**: 各実行が CI コンテナや、以前のセッションが保存したフラグのないその他の環境で開始される場合、すべての実行が最初のセッションになります620* **実行のたびにクリーンな環境になる場合**: 各実行が CI コンテナや、以前のセッションが保存したフラグのないその他の環境で開始される場合、すべての実行が最初のセッションになります

623* **API キーのないゲートウェイトークンの場合**: API キーなしで `ANTHROPIC_AUTH_TOKEN` を使用して認証し、`ANTHROPIC_BASE_URL` が [LLM ゲートウェイ](/docs/ja/llm-gateway)など Anthropic 以外のホストを指している場合、Claude Code にはフラグを取得するための認証情報がありません621* **API キーのないゲートウェイトークンの場合**: API キーなしで `ANTHROPIC_AUTH_TOKEN` を使用して認証し、`ANTHROPIC_BASE_URL` が [LLM ゲートウェイ](/docs/ja/llm-gateway)など Anthropic 以外のホストを指している場合、Claude Code にはフラグを取得するための認証情報がありません

624 622 

625これらの構成でセッションを開始する権限モードを選択するには、[別の権限モードで開始する](/docs/ja/permission-modes#start-in-a-different-mode)を参照してください。

626 

627<h2 id="see-also">623<h2 id="see-also">

628 関連項目624 関連項目

629</h2>625</h2>

errors.md +32 −5

Details

41| `Auto mode classifier transcript exceeded context window` | [サーバーエラー](#auto-mode-cannot-determine-the-safety-of-an-action) |41| `Auto mode classifier transcript exceeded context window` | [サーバーエラー](#auto-mode-cannot-determine-the-safety-of-an-action) |

42| `Agent aborted: auto mode classifier request refused by the safety safeguard` | [サーバーエラー](#auto-mode-cannot-determine-the-safety-of-an-action) |42| `Agent aborted: auto mode classifier request refused by the safety safeguard` | [サーバーエラー](#auto-mode-cannot-determine-the-safety-of-an-action) |

43| `The server-side auto mode classifier gave no verdict` | [サーバーエラー](#the-server-returned-no-safety-verdict) |43| `The server-side auto mode classifier gave no verdict` | [サーバーエラー](#the-server-returned-no-safety-verdict) |

44| `<tool> was not reviewed and did not run: the conversation is too long for auto mode's classifier` | [サーバーエラー](#was-not-reviewed-and-did-not-run) |

44| `Auto mode is unavailable — the server returned no safety verdict for the last 10 responses` | [サーバーエラー](#the-server-returned-no-safety-verdict) |45| `Auto mode is unavailable — the server returned no safety verdict for the last 10 responses` | [サーバーエラー](#the-server-returned-no-safety-verdict) |

45| `Agent terminated early due to an API error` | [サーバーエラー](#agent-terminated-early-due-to-an-api-error) |46| `Agent terminated early due to an API error` | [サーバーエラー](#agent-terminated-early-due-to-an-api-error) |

46| `You've hit your session limit` / `You've hit your weekly limit` / `You've hit your Opus limit` / `You've hit your Sonnet limit` | [使用制限](#youve-hit-your-session-limit) |47| `You've hit your session limit` / `You've hit your weekly limit` / `You've hit your Opus limit` / `You've hit your Sonnet limit` | [使用制限](#youve-hit-your-session-limit) |


471| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](/docs/ja/env-vars) | 未設定 | `CLAUDE_CODE_RETRY_WATCHDOG` が設定されている場合に、各 API リクエストが `429` および `529` エラーの解消を待つのに費やす最大時間。単位はミリ秒です。未設定の場合、待機時間に制限はありません。Claude Code v2.1.295 以降が必要です。 |472| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](/docs/ja/env-vars) | 未設定 | `CLAUDE_CODE_RETRY_WATCHDOG` が設定されている場合に、各 API リクエストが `429` および `529` エラーの解消を待つのに費やす最大時間。単位はミリ秒です。未設定の場合、待機時間に制限はありません。Claude Code v2.1.295 以降が必要です。 |

472| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](/docs/ja/env-vars) | 500 | API が `529` 過負荷エラーで拒否したリクエストの再試行間のバックオフにおける、開始時の遅延 (ミリ秒)。API が容量の上限に達している場合に、再試行をより長い期間に分散させるには、最大 32000 まで値を引き上げてください。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.292 以降が必要です。 |473| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](/docs/ja/env-vars) | 500 | API が `529` 過負荷エラーで拒否したリクエストの再試行間のバックオフにおける、開始時の遅延 (ミリ秒)。API が容量の上限に達している場合に、再試行をより長い期間に分散させるには、最大 32000 まで値を引き上げてください。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.292 以降が必要です。 |

473| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](/docs/ja/env-vars) | 32000 | API が `529` 過負荷エラーで拒否したリクエストの再試行間のバックオフにおける、遅延の上限 (ミリ秒)。API が容量の上限に達している場合に、後の再試行の間隔が引き続き広がるようにするには、最大 64000 まで値を引き上げてください。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.296 以降が必要です。 |474| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](/docs/ja/env-vars) | 32000 | API が `529` 過負荷エラーで拒否したリクエストの再試行間のバックオフにおける、遅延の上限 (ミリ秒)。API が容量の上限に達している場合に、後の再試行の間隔が引き続き広がるようにするには、最大 64000 まで値を引き上げてください。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.296 以降が必要です。 |

474| [`API_TIMEOUT_MS`](/docs/ja/env-vars) | 600000 | リクエストごとのタイムアウト (ミリ秒)。低速なネットワークやプロキシを使用する場合は値を引き上げてください。[No response from API](#no-response-from-api) で説明しているように、Claude Code がレスポンスヘッダーを待機する時間の上限にもなります。 |475| [`API_TIMEOUT_MS`](/docs/ja/env-vars) | 600000 | 各リクエストの試行がレスポンスヘッダーを受信するまでの制限時間 (ミリ秒)。その後のストリーミングレスポンスの実行時間は制限しません。低速なネットワークやプロキシを使用する場合は値を引き上げてください。これがファーストバイトの期限の上限となる仕組みについては、[No response from API](#no-response-from-api) を参照してください。 |

475| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](/docs/ja/env-vars) | 未設定 | タイムアウトした[非ストリーミングリクエスト](#streaming-response-ended-before-any-complete-data-was-received)の再送信回数の上限。上限に達すると、リクエストは失敗します。生成にタイムアウトより長い時間がかかる Claude の応答は、再送信のたびに再びタイムアウトするため、より早く失敗させるには `0` などの小さな値を設定してください。非ストリーミングの各試行は、ローカルセッションでは 300 秒後に、`API_TIMEOUT_MS` に正の値を設定している場合はその時間の経過後にタイムアウトします。Claude Code v2.1.285 以降が必要です。 |476| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](/docs/ja/env-vars) | 未設定 | タイムアウトした[非ストリーミングリクエスト](#streaming-response-ended-before-any-complete-data-was-received)の再送信回数の上限。上限に達すると、リクエストは失敗します。生成にタイムアウトより長い時間がかかる Claude の応答は、再送信のたびに再びタイムアウトするため、より早く失敗させるには `0` などの小さな値を設定してください。非ストリーミングの各試行は、ローカルセッションでは 300 秒後に、`API_TIMEOUT_MS` に正の値を設定している場合はその時間の経過後にタイムアウトします。Claude Code v2.1.285 以降が必要です。 |

476| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/ja/env-vars) | 未設定 | ストリーミングリクエストの最初のレスポンスバイトの期限 (ミリ秒)。Claude Code v2.1.242 以降が必要です。これが未設定の場合に Claude Code が期限をどのように決定するかについては、[No response from API](#no-response-from-api) を参照してください。 |477| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/ja/env-vars) | 未設定 | ストリーミングリクエストの最初のレスポンスバイトの期限 (ミリ秒)。Claude Code v2.1.242 以降が必要です。これが未設定の場合に Claude Code が期限をどのように決定するかについては、[No response from API](#no-response-from-api) を参照してください。 |

477 478 


535Request timed out536Request timed out

536```537```

537 538 

538これは高負荷期間中、またはモデルが非常に大きなレスポンスを生成しているときに発生する可能性があります。デフォルトのリクエストタイムアウトは 10 分です。539デフォルトのリクエストタイムアウトは 10 分です。

539 540 

540**対応方法:**541**対応方法:**

541 542 


627<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.628<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.

628```629```

629 630 

630対話セッションでは、このメッセージの代わりに、ツール呼び出しの下に薄く表示される `Not run · auto mode's check had no usable answer` 行が現れます。`Ctrl+O` を押すと、[トランスクリプトビューアー](/docs/ja/interactive-mode#transcript-viewer) でメッセージを読むことができます。[The server returned no safety verdict](#the-server-returned-no-safety-verdict) で説明されている拒否でも同じ行が表示されます。v2.1.296 より前では、メッセージは呼び出しの下に赤いエラーとして表示されていました。631対話セッションでは、このメッセージの代わりに、ツール呼び出しの下に薄く表示される `Not run · auto mode's check had no usable answer` 行が現れます。`Ctrl+O` を押すと、[トランスクリプトビューアー](/docs/ja/interactive-mode#transcript-viewer) でメッセージを読むことができます。[The server returned no safety verdict](#the-server-returned-no-safety-verdict) で説明されている `gave no verdict` 拒否でも同じ行が表示されます。v2.1.296 より前では、メッセージは呼び出しの下に赤いエラーとして表示されていました。

631 632 

632Claude Code が障害カテゴリを判定できる場合、`temporarily unavailable` の後の括弧内にカテゴリを示します。例えば `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`。カテゴリは `(rate-limited)`、`(overloaded)`、`(server error)`、`(timed out)`、`(connection failed)` です。`(timed out)` または `(connection failed)` が繰り返される場合は、接続を確認してください。[Unable to connect to API](#unable-to-connect-to-api) を参照してください。v2.1.229 より前では、メッセージはカテゴリを示さず、`Wait briefly and then try this action again` と読まれていました。633Claude Code が障害カテゴリを判定できる場合、`temporarily unavailable` の後の括弧内にカテゴリを示します。例えば `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`。カテゴリは `(rate-limited)`、`(overloaded)`、`(server error)`、`(timed out)`、`(connection failed)` です。`(timed out)` または `(connection failed)` が繰り返される場合は、接続を確認してください。[Unable to connect to API](#unable-to-connect-to-api) を参照してください。v2.1.229 より前では、メッセージはカテゴリを示さず、`Wait briefly and then try this action again` と読まれていました。

633 634 


638* 数秒後に再試行してください。Claude は同じメッセージを見て、通常は自動的に再試行します。一時的な障害は [auto モードの利用資格](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) とは無関係です。設定を変更する必要はありません639* 数秒後に再試行してください。Claude は同じメッセージを見て、通常は自動的に再試行します。一時的な障害は [auto モードの利用資格](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) とは無関係です。設定を変更する必要はありません

639* 再試行が失敗し続ける場合は、読み取り専用タスクを続行し、後でブロックされたアクションに戻ってください640* 再試行が失敗し続ける場合は、読み取り専用タスクを続行し、後でブロックされたアクションに戻ってください

640* Amazon Bedrock では、メッセージがすべての再試行で返される場合は、アカウントがそれが示すモデルを呼び出せることを確認してください。標準の Amazon Bedrock モデルの場合、[IAM policy](/docs/ja/amazon-bedrock#iam-configuration) がそれを呼び出すことを許可していることを確認してください。Mantle モデル ID の場合は、[AWS アカウントチームに連絡してください](/docs/ja/amazon-bedrock#mantle-endpoint-errors)641* Amazon Bedrock では、メッセージがすべての再試行で返される場合は、アカウントがそれが示すモデルを呼び出せることを確認してください。標準の Amazon Bedrock モデルの場合、[IAM policy](/docs/ja/amazon-bedrock#iam-configuration) がそれを呼び出すことを許可していることを確認してください。Mantle モデル ID の場合は、[AWS アカウントチームに連絡してください](/docs/ja/amazon-bedrock#mantle-endpoint-errors)

642* メッセージがすべての再試行で返され、[`CLAUDE_CODE_AUTO_MODE_MODEL`](/docs/ja/permission-modes#choose-the-classifier-model) で設定したモデルを示している場合は、セッションが実行されている API またはクラウドプロバイダーがそのモデル ID を提供していることを確認してください。提供していない場合は、変数を提供されているモデル ID に設定するか、変数の設定を解除して [デフォルトの分類器モデル](/docs/ja/permission-modes#default-classifier-model) を使用してください。

641 643 

642OAuth トークンの有効期限が切れたか、別のセッションによってローテーションされたために分類器リクエストが失敗した場合、Claude Code はトークンをリフレッシュし、リクエストを 1 回再試行するため、日常的なトークンの有効期限切れはこのメッセージとして表示されません。v2.1.216 より前では、有効期限が切れたまたはローテーションされたトークンによってすべての分類器リクエストが失敗し、トークンがリフレッシュされるまで auto モードはこのメッセージで確認対象のすべてのアクションを拒否していました。644OAuth トークンの有効期限が切れたか、別のセッションによってローテーションされたために分類器リクエストが失敗した場合、Claude Code はトークンをリフレッシュし、リクエストを 1 回再試行するため、日常的なトークンの有効期限切れはこのメッセージとして表示されません。v2.1.216 より前では、有効期限が切れたまたはローテーションされたトークンによってすべての分類器リクエストが失敗し、トークンがリフレッシュされるまで auto モードはこのメッセージで確認対象のすべてのアクションを拒否していました。

643 645 


672* 対話セッションでは、別の [権限モード](/docs/ja/permission-modes) に切り替えて、プロンプトが表示されたときにアクションを承認できるようにしてください674* 対話セッションでは、別の [権限モード](/docs/ja/permission-modes) に切り替えて、プロンプトが表示されたときにアクションを承認できるようにしてください

673* トリガーするコンテンツなしで新しい会話を開始してください675* トリガーするコンテンツなしで新しい会話を開始してください

674 676 

675会話が分類器のコンテキストウィンドウより大きくなった場合:677会話が Claude Code の分類器リクエストには長すぎ、Claude Code が [自動で圧縮](#was-not-reviewed-and-did-not-run) できない場合:

676 678 

677```text theme={null}679```text theme={null}

678Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)680Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)


715 717 

716**対応方法:**718**対応方法:**

717 719 

720* 対話セッションでは、`Ctrl+O` を押して [トランスクリプトビューアー](/docs/ja/interactive-mode#transcript-viewer) で拒否のテキストを読んでください。

721* 拒否が `(the conversation is too long for the check)` を示している場合は、Claude Code のプロンプトで `/compact` を実行して会話を短くしてください。会話が短くなるまでは、別のメッセージを送信しても同じ拒否になります。[自動圧縮](/docs/ja/settings-reference#autocompactenabled) をオフにしている場合は、次回 Claude Code が自動で圧縮するように再度オンにしてください。

718* 別のメッセージを送信して、Claude が再度試行するようにしてください。レスポンスのカウントはリセットされます。722* 別のメッセージを送信して、Claude が再度試行するようにしてください。レスポンスのカウントはリセットされます。

719* 停止が繰り返され、リクエストが [LLM ゲートウェイまたはプロキシ](/docs/ja/llm-gateway) を経由する場合は、それがストリーミングレスポンスを途中で切り詰めたり書き換えたりしていないかを確認してください。[サーバー側の分類器レビュー](/docs/ja/permission-modes#server-side-classifier-review) にはどのゲートウェイの動作が拒否を引き起こすかが記載され、[ゲートウェイ互換性ガイド](/docs/ja/llm-gateway-protocol#feature-pass-through) には変更せずにそのまま渡すべきものが記載されています。723* 停止が繰り返され、リクエストが [LLM ゲートウェイまたはプロキシ](/docs/ja/llm-gateway) を経由する場合は、それがストリーミングレスポンスを途中で切り詰めたり書き換えたりしていないかを確認してください。[サーバー側の分類器レビュー](/docs/ja/permission-modes#server-side-classifier-review) にはどのゲートウェイの動作が拒否を引き起こすかが記載され、[ゲートウェイ互換性ガイド](/docs/ja/llm-gateway-protocol#feature-pass-through) には変更せずにそのまま渡すべきものが記載されています。

720* Claude Code を開始する前に `CLAUDE_CODE_AUTO_MODE_SERVER=0` を設定して、代わりに Claude Code 独自の分類器リクエストを使用してください。v2.1.281 より前では、Claude Code は Anthropic API への直接接続でこの変数を読み取りませんでした。724* Claude Code を開始する前に `CLAUDE_CODE_AUTO_MODE_SERVER=0` を設定して、代わりに Claude Code 独自の分類器リクエストを使用してください。v2.1.281 より前では、Claude Code は Anthropic API への直接接続でこの変数を読み取りませんでした。


722 726 

723v2.1.280 より前では、Claude Code は判定のないレスポンスからの各アクションを直ちに拒否し、ターンを停止することはありませんでした。727v2.1.280 より前では、Claude Code は判定のないレスポンスからの各アクションを直ちに拒否し、ターンを停止することはありませんでした。

724 728 

729v2.1.302 より前では、Anthropic API への直接接続において、Claude Code はサーバーのチェックには長くなりすぎた会話を圧縮しませんでした。

730 

731<h3 id="was-not-reviewed-and-did-not-run">

732 Was not reviewed and did not run

733</h3>

734 

735`was not reviewed and did not run` 拒否は、会話が長すぎて [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) の分類器がアクションをチェックできず、アクションが実行されなかったことを意味します。Claude Code は次のメッセージを Claude に返します。

736 

737```text theme={null}

738<tool> was not reviewed and did not run: the conversation is too long for auto mode's classifier. Claude Code will try to compact the conversation before the next request; if this action is still needed after that, issue it again and it will be reviewed normally.

739```

740 

741コンテキスト圧縮が失敗した場合、分類器がチェックできない以降のアクションには、次の 2 つの別のメッセージのいずれかが表示されます。

742 

743* [`gave no verdict (the conversation is too long for the check)`](#the-server-returned-no-safety-verdict) 拒否

744* [`Auto mode classifier transcript exceeded context window`](#auto-mode-cannot-determine-the-safety-of-an-action) メッセージ

745 

746**対応方法:**

747 

748* メッセージが予告している圧縮が成功した場合は、何もする必要はありません。

749* これら 2 つのメッセージのいずれかが表示された場合は、Claude Code のプロンプトで `/compact` を実行して、自分で会話を短くしてください。[自動圧縮](/docs/ja/settings-reference#autocompactenabled) をオフにしている場合は、次回 Claude Code が自動で圧縮するように再度オンにしてください。

750 

725<h3 id="agent-terminated-early-due-to-an-api-error">751<h3 id="agent-terminated-early-due-to-an-api-error">

726 Agent terminated early due to an API error752 Agent terminated early due to an API error

727</h3>753</h3>


4554* エラーが指定する各エントリを [サブエージェントが利用可能なツール](/docs/ja/sub-agents#available-tools) に対して修正します4580* エラーが指定する各エントリを [サブエージェントが利用可能なツール](/docs/ja/sub-agents#available-tools) に対して修正します

4555* セッションが持たないツールのエントリを削除します。例えば、接続されていないサーバーからの MCP ツール4581* セッションが持たないツールのエントリを削除します。例えば、接続されていないサーバーからの MCP ツール

4556* エントリが接続済みの MCP サーバーを指定している場合は、エントリを、そのサーバーの [ツール名](/docs/ja/permissions#mcp) に綴られているサーバー名(例えば `mcp__reports__v2__get_totals` の `reports__v2`)と比較します。そのサーバーには、`mcp__reports__v2__*`、つまり `mcp__` の後に名前全体と `__*` を続けたものを記述します。`reports` という名前のサーバーを指す短い `mcp__reports` では、サブエージェントは `reports__v2` のツールを 1 つも取得しません4582* エントリが接続済みの MCP サーバーを指定している場合は、エントリを、そのサーバーの [ツール名](/docs/ja/permissions#mcp) に綴られているサーバー名(例えば `mcp__reports__v2__get_totals` の `reports__v2`)と比較します。そのサーバーには、`mcp__reports__v2__*`、つまり `mcp__` の後に名前全体と `__*` を続けたものを記述します。`reports` という名前のサーバーを指す短い `mcp__reports` では、サブエージェントは `reports__v2` のツールを 1 つも取得しません

4557* [バックグラウンドサブエージェントが削除する](/docs/ja/sub-agents#available-tools) ツール(例えば `CronCreate`)の場合、エントリを削除します。ツールを保持するには、[フォークモードをオフにして](/docs/ja/sub-agents#turn-fork-mode-on-or-off) Claude にサブエージェントをフォアグラウンドで実行するよう依頼します4583* [バックグラウンドサブエージェントが削除する](/docs/ja/sub-agents#available-tools) ツール(例えば `CronCreate`)の場合、エントリを削除します

4584* 代わりに `CronCreate` などのツールを保持するには、[Claude にサブエージェントを待機させます](/docs/ja/sub-agents#let-claude-wait-for-a-subagent)。Claude が待機するサブエージェントはフォアグラウンドで実行され、ツールを保持するためです。定義で `background: true` が設定されている場合は、サブエージェントがバックグラウンドのままになるため、先にそのフィールドを削除します

4558* `tools` フィールドを削除して、サブエージェントに [サブエージェントが利用可能なすべてのツール](/docs/ja/sub-agents#available-tools) を与えます4585* `tools` フィールドを削除して、サブエージェントに [サブエージェントが利用可能なすべてのツール](/docs/ja/sub-agents#available-tools) を与えます

4559* `Agent` のみを含む `tools` リストの場合、[深さ制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) を上げるか、エージェントに少なくとも 1 つの他のツールを与えます。Claude Code はその制限で `Agent` を保留するため、リストに他に何もない場合、ツールに解決されません4586* `Agent` のみを含む `tools` リストの場合、[深さ制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) を上げるか、エージェントに少なくとも 1 つの他のツールを与えます。Claude Code はその制限で `Agent` を保留するため、リストに他に何もない場合、ツールに解決されません

4560 4587 

fast-mode.md +1 −1

Details

47* 高速モードがアクティブな間、プロンプトの横に小さい `↯` アイコンが表示されます47* 高速モードがアクティブな間、プロンプトの横に小さい `↯` アイコンが表示されます

48* いつでも `/fast` を再度実行して、高速モードがオンかオフかを確認できます48* いつでも `/fast` を再度実行して、高速モードがオンかオフかを確認できます

49 49 

50Opus 5.5 は Claude Code v2.1.280 以降の高速モードのデフォルトです。v2.1.280 より前では、高速モードは v2.1.219 から v2.1.280 では Opus 5 がデフォルトで、v2.1.154 から v2.1.218 では Opus 4.8 がデフォルトで、v2.1.142 から v2.1.153 では Opus 4.7 がデフォルトでした。50Opus 5.5 は Claude Code v2.1.280 以降の fast mode のデフォルトです。v2.1.280 より前では、fast mode のデフォルトは v2.1.219 以降では Opus 5、v2.1.154 から v2.1.218 では Opus 4.8 でした。

51 51 

52`/fast` を再度実行して高速モードを無効にすると、Opus に留まります。別のモデルに切り替えるには、`/model` を使用します。52`/fast` を再度実行して高速モードを無効にすると、Opus に留まります。別のモデルに切り替えるには、`/model` を使用します。

53 53 

fullscreen.md +4 −4

Details

101* **プロンプト入力をクリック**して、入力しているテキスト内の任意の場所にカーソルを配置します。101* **プロンプト入力をクリック**して、入力しているテキスト内の任意の場所にカーソルを配置します。

102* **`/` コマンドまたは `@` ファイル リストの候補をクリック**して受け入れます。ホバーするとカーソルの下の行がハイライトされます。102* **`/` コマンドまたは `@` ファイル リストの候補をクリック**して受け入れます。ホバーするとカーソルの下の行がハイライトされます。

103* **選択メニューのオプションをクリック**して選択します。これは権限プロンプト、`/model`、`/config`、およびオプションのリストを表示する他のダイアログに適用されます。103* **選択メニューのオプションをクリック**して選択します。これは権限プロンプト、`/model`、`/config`、およびオプションのリストを表示する他のダイアログに適用されます。

104* **複数選択メニューのオプションをクリック**してトグルし、送信ボタンをクリックして選択を確認します。複数選択質問の `Other` 行など、自由形式の行をクリックすると、その入力フィールドにフォーカスが移り、回答を入力できます。Claude Code v2.1.208 以降が必要です。104* **複数選択メニューのオプションをクリック**してトグルし、送信ボタンをクリックして選択を確認します。複数選択質問の `Other` 行など、自由形式の行をクリックすると、その入力フィールドにフォーカスが移り、回答を入力できます。

105* **`/config` パネルの設定値をクリック**して変更し、マウス ホイールで設定リストをスクロールします。Claude Code v2.1.271 以降が必要です。105* **`/config` パネルの設定値をクリック**して変更し、マウス ホイールで設定リストをスクロールします。Claude Code v2.1.271 以降が必要です。

106* **マウス ホイールで選択メニューまたは複数選択メニューをスクロール**します。短いターミナル ウィンドウの `/model` リストなど、一度に表示されるより多くのオプションがある場合に使用します。ポインタがオプションの上にある間、ホイールはリストをスクロールします。Claude Code v2.1.280 以降が必要です。106* **マウス ホイールで選択メニューまたは複数選択メニューをスクロール**します。短いターミナル ウィンドウの `/model` リストなど、一度に表示されるより多くのオプションがある場合に使用します。ポインタがオプションの上にある間、ホイールはリストをスクロールします。Claude Code v2.1.280 以降が必要です。

107* **スクロールバーでオーバーフローしているリストをスクロール**します。`/skills`、`/mcp`、`/plugin` のインストール済みリストなどのリスト パネルでは、ポインタがリストの上にある間、行がフィットするより多くの行を持つリストの横にスクロールバーが表示されます。トラックをクリックしてその位置にジャンプするか、サムをドラッグします。Claude Code v2.1.281 以降が必要です。107* **スクロールバーでオーバーフローしているリストをスクロール**します。`/skills`、`/mcp`、`/plugin` のインストール済みリストなどのリスト パネルでは、ポインタがリストの上にある間、行がフィットするより多くの行を持つリストの横にスクロールバーが表示されます。トラックをクリックしてその位置にジャンプするか、サムをドラッグします。Claude Code v2.1.281 以降が必要です。


146| `Ctrl+End` | 最新メッセージにジャンプして自動フォローを再度有効化 |146| `Ctrl+End` | 最新メッセージにジャンプして自動フォローを再度有効化 |

147| マウスホイール | 一度に数行スクロール |147| マウスホイール | 一度に数行スクロール |

148 148 

149[コンパクション](/docs/ja/context-window#what-survives-compaction)後でも、セッションの開始位置までスクロールバックできます。Claude はコンパクション要約から作業を続けますが、Claude Code は繰り返されるコンパクション全体で、フルスクリーンスクロールバック内のすべての以前のメッセージを保持します。149[コンパクション](/docs/ja/context-window#what-survives-compaction)されたセッションを閉じてから[再開](/docs/ja/sessions#what-a-resumed-session-restores)すると、上へのスクロールは `Conversation compacted` 行で止まり、それ以前のメッセージはディスク上の[トランスクリプトファイル](/docs/ja/sessions#where-transcripts-are-stored)に残ります。それらのメッセージから詳細を取得するには、そのファイル内を調べるよう Claude に依頼してください。

150 150 

151MacBook キーボードのような専用の `PgUp`、`PgDn`、`Home`、`End` キーがないキーボードでは、`Fn` キーを矢印キーと一緒に押してください。`Fn+↑` は `PgUp` を送信し、`Fn+↓` は `PgDn` を送信し、`Fn+←` は `Home` を送信し、`Fn+→` は `End` を送信します。`Ctrl+Fn+→` は macOS の Claude Code に到達しないため、MacBook キーボードはデフォルトでは下部へのジャンプコードが機能しません。代わりに、以下のいずれかのオプションを使用してください。151MacBook キーボードのような専用の `PgUp`、`PgDn`、`Home`、`End` キーがないキーボードでは、`Fn` キーを矢印キーと一緒に押してください。`Fn+↑` は `PgUp` を送信し、`Fn+↓` は `PgDn` を送信し、`Fn+←` は `Home` を送信し、`Fn+→` は `End` を送信します。`Ctrl+Fn+→` は macOS の Claude Code に到達しないため、MacBook キーボードはデフォルトでは下部へのジャンプコードが機能しません。代わりに、以下のいずれかのオプションを使用してください。

152 152 


162 自動フォロー162 自動フォロー

163</h3>163</h3>

164 164 

165上にスクロールすると自動フォローが一時停止され、新しい出力があなたを下部に戻さなくなります。スクロールアップ中は、トランスクリプトの下部エッジに `下部へジャンプ` ボタンが浮かび、新しい出力が到着すると `3 件の新しいメッセージ` などのカウントが表示されます。クリックするか、`Ctrl+End` を押すか、下部までスクロールしてフォローを再開してください。165上にスクロールすると自動フォローが一時停止され、新しい出力によって下部に引き戻されなくなります。スクロールアップ中は、トランスクリプトの下部エッジに `Jump to bottom` ボタンが浮かび、新しい出力が到着すると `3 new messages` などのカウントが表示されます。クリックするか、`Ctrl+End` を押すか、下部までスクロールしてフォローを再開してください。

166 166 

167自動フォローが一時停止されている間、レスポンスのストリーミングが終了すると、ビューはスクロールした場所に留まります。167自動フォローが一時停止されている間、レスポンスのストリーミングが終了すると、ビューはスクロールした場所に留まります。

168 168 


186export CLAUDE_CODE_SCROLL_SPEED=3186export CLAUDE_CODE_SCROLL_SPEED=3

187```187```

188 188 

189値 `3` は `vim` および同様のアプリケーションのデフォルトと一致します。この設定は、0.25 などの 1 未満の小数値を含む、20 までの任意の正の値を受け入れます。これにより、既にホイールイベントを増幅するターミナルで加速されたトラックパッドおよびホイールスクロールを遅くできます。189値 `3` は `vim` および同様のアプリケーションのデフォルトと一致します。この設定は、`0.25` などの 1 未満の小数値を含む、20 までの任意の正の値を受け入れます。これにより、既にホイールイベントを増幅するターミナルで加速されたトラックパッドおよびホイールスクロールを遅くできます。

190 190 

191スクロール速度をインタラクティブに調整するには、`/scroll-speed` を実行してください。ダイアログを開いたままスクロールすると、変更をすぐに体感できます。`←` と `→` を押して速度を調整し、`r` を押してオートディテクトされたデフォルトにリセットし、`Enter` を押して保存してください。ダイアログは 10 までの整数でステップし、より細かい制御をサポートするターミナルでは、0.25 までの 4 分の 1 ステップも提供します。191スクロール速度をインタラクティブに調整するには、`/scroll-speed` を実行してください。ダイアログを開いたままスクロールすると、変更をすぐに体感できます。`←` と `→` を押して速度を調整し、`r` を押してオートディテクトされたデフォルトにリセットし、`Enter` を押して保存してください。ダイアログは 10 までの整数でステップし、より細かい制御をサポートするターミナルでは、0.25 までの 4 分の 1 ステップも提供します。

192 192 

headless.md +5 −4

Details

138 パイプされた stdin は 10MB に制限されています。制限を超えた場合、Claude Code は明確なエラーを表示して終了し、ゼロ以外のステータスを返します。より大きな入力を処理するには、コンテンツをファイルに書き込み、パイプする代わりにプロンプトでファイルパスを参照してください。138 パイプされた stdin は 10MB に制限されています。制限を超えた場合、Claude Code は明確なエラーを表示して終了し、ゼロ以外のステータスを返します。より大きな入力を処理するには、コンテンツをファイルに書き込み、パイプする代わりにプロンプトでファイルパスを参照してください。

139</Note>139</Note>

140 140 

141Claude Code が stdin を読み込めない場合(例えば、Claude Code を起動したプロセスが自分側の接続を切断した場合)、Claude Code は stderr に警告を出力し、コマンドラインから渡されたプロンプトで続行します。v2.1.211 より前では、Windows で stdin を読み込めないとセッションがクラッシュするか、出力なしで静かに終了していました。141Claude Code が stdin を読み込めない場合(例えば、Claude Code を起動したプロセスが自分側の接続を切断した場合)、Claude Code は stderr に警告を出力し、コマンドラインから渡されたプロンプトで続行します。

142 142 

143<h3 id="add-claude-to-a-build-script">143<h3 id="add-claude-to-a-build-script">

144 ビルドスクリプトに Claude を追加する144 ビルドスクリプトに Claude を追加する


213 213 

214ストリームの最後の行は、最終応答テキスト、コスト、セッションメタデータを含む `result` メッセージです。214ストリームの最後の行は、最終応答テキスト、コスト、セッションメタデータを含む `result` メッセージです。

215 215 

216コンシューマーがストリームをゆっくり読む場合、Claude Code はキューに入った出力が排出されるまで待機してから終了します。待機時間はまだキューに残っている量に応じて伸び、上限は 30 秒です。v2.1.214 より前では、終了時の待機の上限は約 2 秒であり、大きな応答の末尾が切り捨てられる可能性がありました。216コンシューマーがストリームをゆっくり読む場合、Claude Code はキューに入った出力が排出されるまで待機してから終了します。待機時間はまだキューに残っている量に応じて伸び、上限は 30 秒です。

217 217 

218次の例は [jq](https://jqlang.org/) を使用してテキストデルタをフィルタリングし、ストリーミングテキストのみを表示します。`-r` フラグは生の文字列(引用符なし)を出力し、`-j` は改行なしで結合するため、トークンが途切れなくストリーミングされます。218次の例は [jq](https://jqlang.org/) を使用してテキストデルタをフィルタリングし、ストリーミングテキストのみを表示します。`-r` フラグは生の文字列(引用符なし)を出力し、`-j` は改行なしで結合するため、トークンが途切れなくストリーミングされます。

219 219 


249 249 

250これらのメッセージの一部がストリームに含まれていない場合は、Claude Code のバージョンを次の最小要件と照らし合わせて確認してください。250これらのメッセージの一部がストリームに含まれていない場合は、Claude Code のバージョンを次の最小要件と照らし合わせて確認してください。

251 251 

252* **`--forward-subagent-text` と `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`**:v2.1.211 以降

253* **あらゆるネストの深さでの転送**:v2.1.219 以降252* **あらゆるネストの深さでの転送**:v2.1.219 以降

254* **Claude がメインの会話から Skill ツールで開始するフォークされたスキル**:`tool_use` および `tool_result` ブロックには v2.1.86 以降、最初の `user` メッセージとテキストブロックおよび思考ブロックには v2.1.265 以降253* **Claude がメインの会話から Skill ツールで開始するフォークされたスキル**:`tool_use` および `tool_result` ブロックには v2.1.86 以降、最初の `user` メッセージとテキストブロックおよび思考ブロックには v2.1.265 以降

255* **フォークされたスキルが生成するサブエージェントのメッセージ、およびサブエージェントや別のフォークされたスキルの中で開始されたフォークされたスキルのメッセージ**:v2.1.275 以降254* **フォークされたスキルが生成するサブエージェントのメッセージ、およびサブエージェントや別のフォークされたスキルの中で開始されたフォークされたスキルのメッセージ**:v2.1.275 以降


336 --allowedTools "Bash,Read,Edit"335 --allowedTools "Bash,Read,Edit"

337```336```

338 337 

339個別のツールを指定する代わりにセッション全体のベースラインを設定するには、[権限モード](/docs/ja/permission-modes)を渡します。何も権限モードを設定しない実行は、[組み込みの開始時の権限モード](/docs/ja/permission-modes#which-mode-a-session-starts-in)になり、これは `auto` の場合があるため、使用したいモードを渡してください。338指定しなかったツールの呼び出しは、承認が不要であれば実行されます。[Manual モード](/docs/ja/permission-modes#available-modes)の `claude -p` 実行では、承認が必要な呼び出しは、[`PermissionRequest` フック](/docs/ja/hooks#permissionrequest)や [`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) などによって承認されない限り拒否されます。Claude Code v2.1.302 以降では、[何も権限モードを設定しない](/docs/ja/permission-modes#which-mode-a-non-interactive-run-starts-in)場合、`claude -p` の実行は Manual モードで開始されます。

339 

340個別のツールを指定する代わりにセッション全体のベースラインを設定するには、`--permission-mode` で `auto`、`dontAsk`、`acceptEdits` などの[権限モード](/docs/ja/permission-modes)を渡します。

340 341 

341* **`auto`**:`--permission-mode auto` を渡すと、ユーザーに代わって分類器がほとんどのアクションをレビューします342* **`auto`**:`--permission-mode auto` を渡すと、ユーザーに代わって分類器がほとんどのアクションをレビューします

342* **`dontAsk`**:Claude Code は、本来なら確認を求めるすべての呼び出しを拒否します。これは制限された CI 実行に役立ちます。Manual モードで承認が不要なアクション(作業ディレクトリでのファイル読み取りや[読み取り専用コマンドセット](/docs/ja/permissions#read-only-commands)など)は引き続き実行され、`--allowedTools` エントリまたは `permissions.allow` ルールがカバーするアクションも実行されます。`AskUserQuestion`、[組織が `ask` に設定したコネクタツール](/docs/ja/mcp#organization-controls-on-connector-tools)、[`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool) とマークされた MCP ツール、および[ネットワークパスからの読み取り](/docs/ja/permissions#network-paths)は、許可ルールが一致する場合でも拒否されます343* **`dontAsk`**:Claude Code は、本来なら確認を求めるすべての呼び出しを拒否します。これは制限された CI 実行に役立ちます。Manual モードで承認が不要なアクション(作業ディレクトリでのファイル読み取りや[読み取り専用コマンドセット](/docs/ja/permissions#read-only-commands)など)は引き続き実行され、`--allowedTools` エントリまたは `permissions.allow` ルールがカバーするアクションも実行されます。`AskUserQuestion`、[組織が `ask` に設定したコネクタツール](/docs/ja/mcp#organization-controls-on-connector-tools)、[`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool) とマークされた MCP ツール、および[ネットワークパスからの読み取り](/docs/ja/permissions#network-paths)は、許可ルールが一致する場合でも拒否されます

hooks.md +26 −32

Details

423* **[プロンプト フック](#prompt-and-agent-hook-fields)** (`type: "prompt"`): Claude モデルにプロンプトを送信して、単一ターンの評価を行います。モデルは決定を JSON として返します。[プロンプト ベースのフック](#prompt-based-hooks)を参照してください。423* **[プロンプト フック](#prompt-and-agent-hook-fields)** (`type: "prompt"`): Claude モデルにプロンプトを送信して、単一ターンの評価を行います。モデルは決定を JSON として返します。[プロンプト ベースのフック](#prompt-based-hooks)を参照してください。

424* **[エージェント フック](#prompt-and-agent-hook-fields)** (`type: "agent"`): Read、Grep、Glob などのツールを使用して条件を検証してから決定を返すことができるサブエージェントを生成します。エージェント フックは実験的であり、変更される可能性があります。[エージェント ベースのフック](#agent-based-hooks)を参照してください。424* **[エージェント フック](#prompt-and-agent-hook-fields)** (`type: "agent"`): Read、Grep、Glob などのツールを使用して条件を検証してから決定を返すことができるサブエージェントを生成します。エージェント フックは実験的であり、変更される可能性があります。[エージェント ベースのフック](#agent-based-hooks)を参照してください。

425 425 

426マッチしたすべてのフックは並列で実行されます。同じハンドラーを複数の設定ファイルで定義した場合、実行は 1 回だけです。プラグインまたはスキルが持つ同じハンドラーのコピーは別個のものとして扱われます。426イベントが発火すると、マッチしたフックは並列で実行されます。そのうち 12 個を超えるフックがプロンプトフックまたはエージェントフックである場合、それらのうち 12 個が同時に実行され、残りは実行中のフックが終了するにつれて開始されます。待機中の各フックの [`timeout`](#common-fields) は、そのフックが開始した時点からカウントされます。

427 

428同じハンドラーを複数の設定ファイルで定義した場合、実行は 1 回だけです。プラグインまたはスキルが持つ同じハンドラーのコピーは別個のものとして扱われます。

427 429 

428ハンドラーは Claude Code の環境を持つ現在のディレクトリで実行されます。現在のディレクトリが存在しなくなった場合(たとえば、別のシェルがセッション中に削除した worktree や一時ディレクトリなど)、Claude Code は次のうち最初に存在するディレクトリからコマンドフックを実行します。セッションを開始したディレクトリ、プロジェクトルート、ホームディレクトリ、またはシステムの一時ディレクトリです。Claude Code は、フォールバック先のディレクトリ名を含む警告を[デバッグログ](#debug-hooks)に記録します。デスクトップアプリから開始する worktree セッションについては、[worktree がメインのチェックアウトと共有するもの](/docs/ja/worktrees#what-worktrees-share-with-the-main-checkout)を参照してください。430ハンドラーは Claude Code の環境を持つ現在のディレクトリで実行されます。現在のディレクトリが存在しなくなった場合(たとえば、別のシェルがセッション中に削除した worktree や一時ディレクトリなど)、Claude Code は次のうち最初に存在するディレクトリからコマンドフックを実行します。セッションを開始したディレクトリ、プロジェクトルート、ホームディレクトリ、またはシステムの一時ディレクトリです。Claude Code は、フォールバック先のディレクトリ名を含む警告を[デバッグログ](#debug-hooks)に記録します。デスクトップアプリから開始する worktree セッションについては、[worktree がメインのチェックアウトと共有するもの](/docs/ja/worktrees#what-worktrees-share-with-the-main-checkout)を参照してください。

429 431 


445 447 

446`if` フィールドは正確に 1 つの権限ルールを保持します。ルールを組み合わせるための `&&`、`||`、またはリスト構文はありません。複数の条件を適用するには、各条件に対して個別のフック ハンドラーを定義します。448`if` フィールドは正確に 1 つの権限ルールを保持します。ルールを組み合わせるための `&&`、`||`、またはリスト構文はありません。複数の条件を適用するには、各条件に対して個別のフック ハンドラーを定義します。

447 449 

448ファイルツールの `if` 条件では、`"Edit(src/**)"` のような単一セグメントのディレクトリパターンは、作業ディレクトリ内の `src` ディレクトリとその配下のファイルにのみマッチします。任意の深さにある `src` という名前のディレクトリにマッチさせるには、`"Edit(**/src/**)"` と記述します。v2.1.214 より前は、`"Edit(src/**)"` は作業ディレクトリ配下の任意の深さにある `src` という名前のディレクトリにマッチしていました。450ファイルツールの `if` 条件では、`"Edit(src/**)"` のような単一セグメントのディレクトリパターンは、作業ディレクトリ内の `src` ディレクトリとその配下のファイルにのみマッチします。任意の深さにある `src` という名前のディレクトリにマッチさせるには、`"Edit(**/src/**)"` と記述します。

449 451 

450<h4 id="bash-if-matching">452<h4 id="bash-if-matching">

451 `if` パターンが Bash コマンドにマッチする仕組み453 `if` パターンが Bash コマンドにマッチする仕組み


825 終了コード出力827 終了コード出力

826</h3>828</h3>

827 829 

828フックの終了コードは、ツール呼び出しやプロンプトなど、フックをトリガーしたアクションを続行するかどうかを Claude Code に伝えます。完了した実行の結果は次の 3 つのいずれかです。830フックの実行が完了すると、Claude Code はその終了コードを使用して、ツール呼び出しやプロンプトなど、フックをトリガーしたアクションを続行するかどうかを判断します。

829 831 

830* **成功**: フックが 0 で終了します。Claude Code はフックが出力した [JSON 出力](#json-output)フィールドを適用し、それらのフィールドがアクションをブロックまたは拒否しない限り、アクションは進行します。例外については[バックグラウンド プロセスを開始するフック](#hooks-that-start-a-background-process)を参照してください。832* **成功**: フックが 0 で終了します。Claude Code はフックが出力した [JSON 出力](#json-output)フィールドを適用し、それらのフィールドがアクションをブロックまたは拒否しない限り、アクションは進行します。例外については[バックグラウンド プロセスを開始するフック](#hooks-that-start-a-background-process)を参照してください。

831* **ブロッキング エラー**: フックが 2 で終了します。[ブロック可能なイベント](#exit-code-2-behavior-per-event)では、Claude Code はアクションを停止します。833* **ブロッキング エラー**: フックが 2 で終了します。[ブロック可能なイベント](#exit-code-2-behavior-per-event)では、Claude Code はアクションを停止します。


853 終了コード 0855 終了コード 0

854</h4>856</h4>

855 857 

856終了 0 は成功を意味し、構造化制御のために JSON を出力する場合に想定される終了コードです。858終了 0 は成功を意味し、構造化制御のために JSON を出力する場合に想定される終了コードです。フックが 0 で終了しても、解析できない JSON や[スキーマ検証](#json-output)に失敗する JSON を出力した場合、[失敗時にアクションをブロックするフック](#block-the-action-when-a-hook-fails)でない限り、アクションは進行します。その実行は、フィールドが適用された成功ではなく、[非ブロッキング エラー](#exit-code-output)になります。

857 

858ほとんどのイベントでは、Claude Code は stdout をデバッグ ログに書き込み、トランスクリプトには表示しません。例外は `UserPromptSubmit`、`UserPromptExpansion`、`SessionStart`、`PostModelSwitch` で、Claude Code はプレーン テキストの stdout を Claude が見て行動できるコンテキストとして追加します。

859 859 

860[非同期](#how-async-hooks-execute)でないフックの場合、Claude Code は、出力全体が前後に空白以外何もない 1 つの JSON オブジェクトであるときに stdout を [JSON 出力](#json-output)として解析し、それ以外の場合はプレーン テキストまたは解析失敗として扱います。860出力を修正するには、`<hook name> hook error` 通知に含まれる解析または検証のメッセージを使用してください。[非同期](#how-async-hooks-execute)でないフックの場合、stdout が [JSON 出力](#json-output)として扱われるのは、1 行または複数行にわたる 1 つの JSON オブジェクトを、前後に空白以外何もない状態で出力した場合のみです。Claude Code はそれ以外の stdout をプレーン テキストまたは解析失敗として読み取ります。

861 861 

862* **1 行または複数行にわたる 1 つの JSON オブジェクト**: JSON 出力として解析されます。

863* **`{` で始まらない出力、または `{` で始まり `}` で終わらない出力**: プレーン テキストとして扱われます。このルールにより、JSON 配列や引用符で囲まれた JSON 文字列はプレーン テキストになります。862* **`{` で始まらない出力、または `{` で始まり `}` で終わらない出力**: プレーン テキストとして扱われます。このルールにより、JSON 配列や引用符で囲まれた JSON 文字列はプレーン テキストになります。

864* **それぞれが単独で JSON として解析できる 2 行以上の出力で、最初の行が `{` で始まり最後の行が `}` で終わるもの**: フィールドを設定する JSON 出力オブジェクトである行がない場合はプレーン テキスト、そのような行がある場合は解析失敗になります。863* **それぞれが単独で JSON として解析できる 2 行以上の出力で、最初の行が `{` で始まり最後の行が `}` で終わるもの**: フィールドを設定する JSON 出力オブジェクトである行がない場合はプレーン テキストになります。そのような行がある場合、出力は解析失敗になるため、そのオブジェクトだけを stdout に出力してください。

865* **`{` で始まり `}` で終わるが有効な JSON ではないその他の出力**: 解析失敗になります。864* **`{` で始まり `}` で終わるが有効な JSON ではないその他の出力**: 解析失敗になります。

866 865 

867[失敗時にアクションをブロックするフック](#block-the-action-when-a-hook-fails)でない限り、解析失敗、または[スキーマ検証](#json-output)に失敗する解析済みオブジェクトは[非ブロッキング エラー](#exit-code-output)になります。`<hook name> hook error` 通知には解析または検証のメッセージが含まれます。プレーン テキストの stdout をコンテキストとして追加するイベントでは、Claude Code は解析に失敗した stdout を追加しません。866ほとんどのイベントでは、Claude Code は stdout をデバッグ ログに書き込み、トランスクリプトには表示しません。例外は `UserPromptSubmit`、`UserPromptExpansion`、`SessionStart`、`PostModelSwitch` で、Claude Code はプレーン テキストの stdout を Claude が見て行動できるコンテキストとして追加します。これらのイベントでは、Claude Code は解析に失敗した stdout を追加しません。

868 867 

869終了 0 のフックからの stderr を Claude が見ることはありません。`PreToolUse` などのイベントで自分で読むには、[デバッグ ログ](#debug-hooks)を有効にしてください。`PostToolUse` または `PostToolUseFailure` フックから Claude に警告を表示するには、代わりに終了 2 を使用してください。そうすれば、ツールがすでに実行されていても [Claude は stderr を確認できます](#exit-code-2-behavior-per-event)。868終了 0 のフックからの stderr を Claude が見ることはありません。`PreToolUse` などのイベントで自分で読むには、[デバッグ ログ](#debug-hooks)を有効にしてください。`PostToolUse` または `PostToolUseFailure` フックから Claude に警告を表示するには、代わりに終了 2 を使用してください。そうすれば、ツールがすでに実行されていても [Claude は stderr を確認できます](#exit-code-2-behavior-per-event)。

870 869 


907 その他の終了コード906 その他の終了コード

908</h4>907</h4>

909 908 

910[失敗時にアクションをブロックするフック](#block-the-action-when-a-hook-fails)でない限り、0 または 2 以外の終了コードで、stdout にプレーン テキストを出力するか何も出力しない場合は[非ブロッキング エラー](#exit-code-output)になります。アクションが進行した場合、トランスクリプトには、`Failed with non-blocking status code:` とフックの stderr の最初の行を含む `<hook name> hook error` 通知が表示されます。909`Failed with non-blocking status code:` を含む `<hook name> hook error` 通知は、フックの終了コードが 0 でも 2 でもなく、stdout がプレーン テキストまたは空だったことを意味します。[失敗時にアクションをブロックするフック](#block-the-action-when-a-hook-fails)でない限り、これは[非ブロッキング エラー](#exit-code-output)であるため、フックはアクションを停止していません。通知に表示される最初の行だけでなくフックの完全な stderr を取得するには、[デバッグ ログ](#debug-hooks)を有効にしてください。

911 910 

912例えば、`Bash` の `PreToolUse` フックが stderr に `something broke` を出力して 1 で終了した場合、`PreToolUse:Bash hook error` 通知には次の行が含まれます。911例えば、`Bash` の `PreToolUse` フックが stderr に `something broke` を出力して 1 で終了した場合、`PreToolUse:Bash hook error` 通知には次の行が含まれます。

913 912 


915Failed with non-blocking status code: something broke914Failed with non-blocking status code: something broke

916```915```

917 916 

918最初の行だけでなく完全な stderr を取得するには、[デバッグ ログ](#debug-hooks)を有効にしてください。917次の行のように通知にシェルの `No such file or directory` メッセージが含まれている場合、スクリプト パスが存在しないなどの理由で、フックは一度も実行されていません。

919 

920[失敗時にアクションをブロックするフック](#block-the-action-when-a-hook-fails)でない限り、起動できないフックも非ブロッキング エラーになります。シェル形式では、スクリプト パスが存在しないか実行可能でない場合、シェルは 127 などのコードで終了し、通知にはインタープリターのメッセージが含まれます。例えば、スクリプト パスが存在しない場合、通知には次のような行が含まれます。

921 918 

922```text theme={null}919```text theme={null}

923Failed with non-blocking status code: /bin/sh: /path/to/hook.sh: No such file or directory920Failed with non-blocking status code: /bin/sh: /path/to/hook.sh: No such file or directory

924```921```

925 922 

923パスが間違っている場合は、フックが設定されている場所で修正してください。シェル形式では、スクリプト パスが存在しないか実行可能でない場合、シェルは 127 などのコードで終了し、通知にはインタープリターのメッセージが含まれます。[失敗時にアクションをブロックするフック](#block-the-action-when-a-hook-fails)でない限り、起動できないフックも非ブロッキング エラーになります。

924 

926ポリシー フックを設定するときは、最初の実行時にこの通知に注意してください。`settings.json` でパスを入力ミスすると、フックは一度も実行されません。フックが起動できないときにアクションをブロックするには、[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を設定してください。925ポリシー フックを設定するときは、最初の実行時にこの通知に注意してください。`settings.json` でパスを入力ミスすると、フックは一度も実行されません。フックが起動できないときにアクションをブロックするには、[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を設定してください。

927 926 

928<Warning>927<Warning>


933 タイムアウト932 タイムアウト

934</h4>933</h4>

935 934 

936[`async: true`](#run-hooks-in-the-background) で実行するコマンド フックを除き、Claude Code は [`timeout`](#common-fields) に達した `command`、`http`、または `mcp_tool` フックをキャンセルし、フックの出力を破棄します。そのため、ほとんどのイベントでは、タイムアウトしたフックは決定を下しません。935[`async: true`](#run-hooks-in-the-background) で実行するコマンド フックを除き、Claude Code は [`timeout`](#common-fields) に達した `command`、`http`、または `mcp_tool` フックをキャンセルし、フックの出力を破棄します。そのため、ほとんどのイベントでは、タイムアウトしたフックは決定を下しません。[`PreModelSwitch`](#premodelswitch) では、タイムアウトでキャンセルされたフックはモデルの切り替えをブロックします。

937 936 

938[`PreModelSwitch`](#premodelswitch) では、タイムアウトでキャンセルされたフックはモデルの切り替えをブロックします。`PreToolUse` では、2 つのフック ファミリーで動作が異なります。937`PreToolUse` では、タイムアウトした `command`、`http`、または `mcp_tool` フックはツール呼び出しをブロックしません。ただし、[失敗時にアクションをブロックするフック](#block-the-action-when-a-hook-fails)は例外です。呼び出しは通常の[権限フロー](/docs/ja/permissions)を通じて続行されるため、停止したフックがゲートとして機能することを当てにしないでください。`command` または `http` フックがタイムアウトしたときに呼び出しをブロックするには、[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を設定してください。タイムアウトを超えた [Agent SDK コールバック フック](/docs/ja/agent-sdk/hooks)は[ツール呼び出しをブロックします](#pretooluse)。

939 

940* タイムアウトした `command`、`http`、または `mcp_tool` フックはツール呼び出しをブロックしません。ただし、[失敗時にアクションをブロックするフック](#block-the-action-when-a-hook-fails)は例外です。呼び出しは通常の[権限フロー](/docs/ja/permissions)を通じて続行されるため、停止したフックがゲートとして機能することを当てにしないでください。`command` または `http` フックがタイムアウトしたときに呼び出しをブロックするには、[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を設定してください。

941* タイムアウトを超えた [Agent SDK コールバック フック](/docs/ja/agent-sdk/hooks)は[ツール呼び出しをブロックします](#pretooluse)。

942 938 

943<h4 id="hooks-that-start-a-background-process">939<h4 id="hooks-that-start-a-background-process">

944 バックグラウンド プロセスを開始するフック940 バックグラウンド プロセスを開始するフック


1086 HTTP レスポンス処理1082 HTTP レスポンス処理

1087</h3>1083</h3>

1088 1084 

1089HTTP フックは終了コードと stdout の代わりに HTTP ステータス コードとレスポンス本体を使用します。以下の結果はほとんどのイベントに適用されます。`WorktreeCreate` のように[イベントごとの表](#exit-code-2-behavior-per-event)に独自の失敗時の規約を持つイベントは、失敗した HTTP フックにもその規約を適用します。1085HTTP フックは終了コードと stdout の代わりに HTTP ステータス コードとレスポンス本体を使用します。リクエストが失敗した場合や 2xx 以外のステータスを返した場合にアクションをブロックするには、[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を設定してください。ツール呼び出しをブロックまたは権限を拒否するには、適切な[決定フィールド](#decision-control)を含む JSON 本体を持つ 2xx レスポンスを返します。

1086 

1087[非ブロッキング エラー](#exit-code-output)の後は、[失敗時にアクションをブロックするフック](#block-the-action-when-a-hook-fails)でない限り、アクションは進行します。`WorktreeCreate` など、[イベントごとの表](#exit-code-2-behavior-per-event)に独自の失敗時の規約を持つイベントを除き、各レスポンスまたは失敗に対する結果は次のとおりです。

1090 1088 

1091* **2xx で空の本体**: 成功、終了コード 0 で出力なしと同等1089* **2xx で空の本体**: 成功、終了コード 0 で出力なしと同等

1092* **2xx で JSON オブジェクト本体**: コマンド フックと同じ [JSON 出力](#json-output)スキーマを使用して解析。スキーマ検証に失敗した本体は非ブロッキング エラー1090* **2xx で JSON オブジェクト本体**: コマンド フックと同じ [JSON 出力](#json-output)スキーマを使用して解析。スキーマ検証に失敗した本体は非ブロッキング エラー


1095* **接続失敗**: 非ブロッキング エラー1093* **接続失敗**: 非ブロッキング エラー

1096* **タイムアウト**: [タイムアウト](#timeouts)で説明されているとおり、フックはキャンセルされます1094* **タイムアウト**: [タイムアウト](#timeouts)で説明されているとおり、フックはキャンセルされます

1097 1095 

1098[非ブロッキング エラー](#exit-code-output)の後は、[失敗時にアクションをブロックするフック](#block-the-action-when-a-hook-fails)でない限り、アクションは進行します。ツール呼び出しをブロックまたは権限を拒否するには、適切な[決定フィールド](#decision-control)を含む JSON 本体を持つ 2xx レスポンスを返します。リクエストが失敗した場合や 2xx 以外のステータスを返した場合にアクションをブロックするには、[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を設定してください。

1099 

1100<h3 id="json-output">1096<h3 id="json-output">

1101 JSON 出力1097 JSON 出力

1102</h3>1098</h3>


1319| `compact` | 自動または手動のコンテキスト圧縮 |1315| `compact` | 自動または手動のコンテキスト圧縮 |

1320| `fork` | 既存のセッションからフォークされた新しいセッション。`--resume` または `--continue` と併用した `--fork-session`、`/fork` によるバックグラウンドコピー、`/branch`、または[バックグラウンドに移動](/docs/ja/agent-view#from-inside-a-session)した会話 |1316| `fork` | 既存のセッションからフォークされた新しいセッション。`--resume` または `--continue` と併用した `--fork-session`、`/fork` によるバックグラウンドコピー、`/branch`、または[バックグラウンドに移動](/docs/ja/agent-view#from-inside-a-session)した会話 |

1321 1317 

1322v2.1.214 より前は、フォークされたセッションはソース `"resume"` を報告していました。

1323 

1324対話セッションを開始したとき、起動時に `--continue` または `--resume` で会話を再開したとき、または `/clear` を実行したとき、SessionStart フックはバックグラウンドで実行されます。すぐに入力を始めることができ、再開した会話はフックを待たずに表示されます。ただし、Claude の最初の応答はフックの完了を待つため、フックのコンテキストは Claude に届きます。1318対話セッションを開始したとき、起動時に `--continue` または `--resume` で会話を再開したとき、または `/clear` を実行したとき、SessionStart フックはバックグラウンドで実行されます。すぐに入力を始めることができ、再開した会話はフックを待たずに表示されます。ただし、Claude の最初の応答はフックの完了を待つため、フックのコンテキストは Claude に届きます。

1325 1319 

1326セッション内で `/resume` を使って会話を切り替える場合は、代わりに切り替えがフックの完了を待ちます。バックグラウンドのフックがまだ実行中に `/clear` を実行したり別の会話に切り替えたりすると、フックが返すものはセッションに一切適用されません。1320セッション内で `/resume` を使って会話を切り替える場合は、代わりに切り替えがフックの完了を待ちます。バックグラウンドのフックがまだ実行中に `/clear` を実行したり別の会話に切り替えたりすると、フックが返すものはセッションに一切適用されません。


1583 1577 

1584[`async: true`](#run-hooks-in-the-background) で実行するコマンドフックを除き、タイムアウトに達した `UserPromptSubmit` のコマンド、HTTP、MCP ツールのフックはキャンセルされ、その出力(`additionalContext` を含む)は破棄されます。プロンプトはそのコンテキストなしで Claude に届きます。代わりにプロンプトをブロックするには、コマンドフックまたは HTTP フックで [`onFailure: "block"`](#block-the-action-when-a-hook-fails) を設定してください。トランスクリプトには、フック名、発生したタイムアウト、出力が破棄されたことを示す通知が表示されます。1578[`async: true`](#run-hooks-in-the-background) で実行するコマンドフックを除き、タイムアウトに達した `UserPromptSubmit` のコマンド、HTTP、MCP ツールのフックはキャンセルされ、その出力(`additionalContext` を含む)は破棄されます。プロンプトはそのコンテキストなしで Claude に届きます。代わりにプロンプトをブロックするには、コマンドフックまたは HTTP フックで [`onFailure: "block"`](#block-the-action-when-a-hook-fails) を設定してください。トランスクリプトには、フック名、発生したタイムアウト、出力が破棄されたことを示す通知が表示されます。

1585 1579 

1586タイムアウトに達した `UserPromptSubmit` の [Agent SDK コールバックフック](/docs/ja/agent-sdk/hooks)は、フック名とタイムアウトを示すメッセージとともにプロンプトをブロックします。そこでのコールバックは、フェイルオープンしてはならないポリシーゲートとして機能している可能性があるためです。セッションは継続します。v2.1.208 より前は、このイベントでのコールバックのタイムアウトは実行エラーとともにターンを終了していました。1580`UserPromptSubmit` の [Agent SDK コールバックフック](/docs/ja/agent-sdk/hooks)がタイムアウトに達すると、フック名とタイムアウトを示すメッセージとともにプロンプトがブロックされます。そこでのコールバックは、フェイルオープンしてはならないポリシーゲートとして機能している可能性があるためです。セッションは継続します。

1587 1581 

1588<h4 id="userpromptsubmit-input">1582<h4 id="userpromptsubmit-input">

1589 UserPromptSubmit の入力1583 UserPromptSubmit の入力


2058 2052 

2059| フィールド | 型 | 例 | 説明 |2053| フィールド | 型 | 例 | 説明 |

2060| :- | :- | :- | :- |2054| :- | :- | :- | :- |

2061| `status` | string | `"completed"` | フォアグラウンドのサブエージェントでは `"completed"`、バックグラウンドのサブエージェントでは `"async_launched"`。サブエージェントはデフォルトでバックグラウンドで実行されるため、`run_in_background` を省略した Agent 呼び出しでも `"async_launched"` になります |2055| `status` | string | `"completed"` | フォアグラウンドのサブエージェントの場合は `"completed"`、バックグラウンドのサブエージェントの場合は `"async_launched"`。どのサブエージェントがどちらの方法で実行されるかについては、[サブエージェントをフォアグラウンドまたはバックグラウンドで実行する](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)を参照してください |

2062| `agentId` | string | `"a4d2c8f1e0b3a297"` | サブエージェントの実行の識別子 |2056| `agentId` | string | `"a4d2c8f1e0b3a297"` | サブエージェントの実行の識別子 |

2063| `content` | array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | サブエージェントの最終的なテキストブロック。または、レポートが `SubagentHandback` を経由するサブエージェントの場合は、その代わりにその引き渡しに関する短い注記 |2057| `content` | array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | サブエージェントの最終的なテキストブロック。または、レポートが `SubagentHandback` を経由するサブエージェントの場合は、その代わりにその引き渡しに関する短い注記 |

2064| `resolvedModel` | string | `"claude-sonnet-4-5"` | サブエージェントが開始時に使用したモデル。要求されたモデルと異なる場合があります |2058| `resolvedModel` | string | `"claude-sonnet-4-5"` | サブエージェントが開始時に使用したモデル。要求されたモデルと異なる場合があります |

2065| `modelsUsed` | array | `["claude-sonnet-4-5", "claude-haiku-4-5"]` | 使用されたモデルの順序付きリスト(連続する重複はまとめられます)。実行中にモデルが切り替えられた場合にのみ設定されます。Claude Code v2.1.212 以降が必要です |2059| `modelsUsed` | array | `["claude-sonnet-4-5", "claude-haiku-4-5"]` | 使用されたモデルを順に並べたもので、連続する重複はまとめられます。実行中にモデルが切り替えられた場合にのみ設定されます |

2066| `totalTokens` | number | `12450` | サブエージェントの最終 API リクエストのトークン数(入力、出力、キャッシュのトークンの合計)。実行全体の合計ではありません |2060| `totalTokens` | number | `12450` | サブエージェントの最終 API リクエストのトークン数(入力、出力、キャッシュのトークンの合計)。実行全体の合計ではありません |

2067| `totalDurationMs` | number | `48211` | サブエージェントの実行の実時間 |2061| `totalDurationMs` | number | `48211` | サブエージェントの実行の実時間 |

2068| `totalToolUseCount` | number | `7` | サブエージェントが行ったツール呼び出しの数 |2062| `totalToolUseCount` | number | `7` | サブエージェントが行ったツール呼び出しの数 |


2072 2066 

2073バックグラウンドのサブエージェントの場合、ツールはタスクがバックグラウンドに移った時点で返るため、`tool_response` には使用量のフィールドは含まれません。バックグラウンドでの起動は即座に返り、Claude Code が実行途中でバックグラウンドに移したフォアグラウンドのタスクはその移行時点で返ります。レスポンスには `status: "async_launched"`、`agentId`、`description`、`prompt`、`outputFile`、`resolvedModel` が含まれます。2067バックグラウンドのサブエージェントの場合、ツールはタスクがバックグラウンドに移った時点で返るため、`tool_response` には使用量のフィールドは含まれません。バックグラウンドでの起動は即座に返り、Claude Code が実行途中でバックグラウンドに移したフォアグラウンドのタスクはその移行時点で返ります。レスポンスには `status: "async_launched"`、`agentId`、`description`、`prompt`、`outputFile`、`resolvedModel` が含まれます。

2074 2068 

2075`completed` のレスポンスでは、`resolvedModel` はサブエージェントが開始時に使用したモデルを示し、`availableModels` などの上書きが適用された場合など、`tool_input` の `model` の値と異なることがあります。`async_launched` のレスポンスでは、`resolvedModel` はエージェントがバックグラウンドに移った時点で使用されていたモデルを示すため、バックグラウンド化の前に行われた切り替えがそこに反映されます。`modelsUsed` と、バックグラウンド化時点の `resolvedModel` の動作には Claude Code v2.1.212 以降が必要です。2069`completed` のレスポンスでは、`resolvedModel` はサブエージェントが開始時に使用したモデルを示します。これは、`availableModels` やその他の上書きが適用される場合など、`tool_input` の `model` の値と異なることがあります。`async_launched` のレスポンスでは、`resolvedModel` はエージェントがバックグラウンドに移動した時点で使用中だったモデルを示すため、バックグラウンドへの移動前に行われたモデルの切り替えはそこに反映されます。

2076 2070 

2077<a id="askuserquestion" />2071<a id="askuserquestion" />

2078 2072 


2120 2114 

2121フックが `"ask"` を返すと、ユーザーに表示される権限プロンプトには、フックの出所を示すラベルが含まれます。任意の設定ファイルまたはエージェントのフロントマターからのフックでは `[settings]`、プラグインのフックでは `[plugin:<name>]`、スキルのフロントマターからのフックでは `[skill]` です。これにより、どの設定ソースが確認を求めているかをユーザーが把握できます。2115フックが `"ask"` を返すと、ユーザーに表示される権限プロンプトには、フックの出所を示すラベルが含まれます。任意の設定ファイルまたはエージェントのフロントマターからのフックでは `[settings]`、プラグインのフックでは `[plugin:<name>]`、スキルのフロントマターからのフックでは `[skill]` です。これにより、どの設定ソースが確認を求めているかをユーザーが把握できます。

2122 2116 

2123フックの `"ask"` は、[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)でも権限プロンプトを強制します。分類器は引き続きツール呼び出しを拒否できますが、呼び出しを暗黙的に承認することはできません。v2.1.211 より前は、分類器は[サンドボックス](/docs/ja/sandboxing)外で実行される Bash コマンドを、フックが要求したプロンプトを表示せずに承認できました。その場合も分類器はそのコマンドに独自の安全ルールを適用しており、フックの `"deny"` は常に尊重されていました。2117フックの `"ask"` は、[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)でも権限プロンプトを強制します。分類器は引き続きツール呼び出しを拒否できますが、呼び出しを黙って承認することはできません。

2124 2118 

2125```json theme={null}2119```json theme={null}

2126{2120{


3696| `source` | string | リクエストの発生元。`/model <name>`、`/config` の Model 設定、fast mode をオンにした場合は `"command"`、モデルピッカーの場合は `"picker"`、Agent SDK のホストまたは Remote Control からの `set_model` リクエスト、または `apply_flag_settings` リクエストでのモデル変更の場合は `"sdk"` |3690| `source` | string | リクエストの発生元。`/model <name>`、`/config` の Model 設定、fast mode をオンにした場合は `"command"`、モデルピッカーの場合は `"picker"`、Agent SDK のホストまたは Remote Control からの `set_model` リクエスト、または `apply_flag_settings` リクエストでのモデル変更の場合は `"sdk"` |

3697| `context_tokens` | number | 次のリクエストがプロンプトとして再送信するトークン数。メイン会話の最後の応答の入力トークン、キャッシュ読み取りトークン、キャッシュ作成トークン、出力トークンの合計です。最初の応答の前は `0` |3691| `context_tokens` | number | 次のリクエストがプロンプトとして再送信するトークン数。メイン会話の最後の応答の入力トークン、キャッシュ読み取りトークン、キャッシュ作成トークン、出力トークンの合計です。最初の応答の前は `0` |

3698| `prompt_cache_warm` | boolean | 現在のモデルのプロンプトキャッシュがまだウォームである可能性が高いかどうか。つまり、切り替えによってそれが失われるかどうか |3692| `prompt_cache_warm` | boolean | 現在のモデルのプロンプトキャッシュがまだウォームである可能性が高いかどうか。つまり、切り替えによってそれが失われるかどうか |

3699| `cache_ttl` | string | Claude Code がこのセッションで要求する[プロンプトキャッシュの有効期間](/docs/ja/prompt-caching#cache-lifetime)。`"5m"` または `"1h"` |3693| `cache_ttl` | string | この切り替え時点でのメイン会話の[プロンプトキャッシュの有効期間](/docs/ja/prompt-caching#cache-lifetime)。`"5m"` または `"1h"` |

3700| `estimated_cache_write_usd` | number | `to_model` で `context_tokens` を `cache_ttl` の料金でプロンプトキャッシュに書き込む推定コスト(米ドル)。次の応答は含みません。サーバーがコンテキスト全体を再キャッシュする必要がない場合もあるため、推定値として扱ってください |3694| `estimated_cache_write_usd` | number | `to_model` で `context_tokens` を `cache_ttl` の料金でプロンプトキャッシュに書き込む推定コスト(米ドル)。次の応答は含みません。サーバーがコンテキスト全体を再キャッシュする必要がない場合もあるため、推定値として扱ってください |

3701| `pricing` | string | Claude Code が `estimated_cache_write_usd` を算出した方法。組織が独自の料金を設定している場合はその料金による `"configured"`、定価による `"catalog"`、または `to_model` の価格が不明で Claude Code がデフォルトの料金を仮定した場合は `"default"` |3695| `pricing` | string | Claude Code が `estimated_cache_write_usd` を算出した方法。組織が独自の料金を設定している場合はその料金による `"configured"`、定価による `"catalog"`、または `to_model` の価格が不明で Claude Code がデフォルトの料金を仮定した場合は `"default"` |

3702 3696 


3757 3751 

3758タイムアウトまでに応答しない PreModelSwitch フックは、切り替えをブロックします。このイベントのデフォルトのタイムアウトは 30 秒です。3752タイムアウトまでに応答しない PreModelSwitch フックは、切り替えをブロックします。このイベントのデフォルトのタイムアウトは 30 秒です。

3759 3753 

37600 または 2 以外の終了コードの動作については、[その他の終了コード](#other-exit-codes)を参照してください。3754有効な JSON 出力なしで 0 または 2 以外の終了コードを返した場合は[ブロックしないエラー](#other-exit-codes)となり、切り替えは続行されます。ただし、[失敗時に切り替えをブロックする](#block-the-action-when-a-hook-fails)フックは例外です。

3761 3755 

3762<h3 id="postmodelswitch">3756<h3 id="postmodelswitch">

3763 PostModelSwitch3757 PostModelSwitch


4275`ok: false` で何が起こるかはイベントによって異なります:4269`ok: false` で何が起こるかはイベントによって異なります:

4276 4270 

4277* `Stop` と `SubagentStop`:理由は Claude の次の指示としてフィードバックされ、ターンが続行されます。ただし、応答で `impossible: true` も設定されている場合は、Claude Code が停止を許可し、ターンが終了します4271* `Stop` と `SubagentStop`:理由は Claude の次の指示としてフィードバックされ、ターンが続行されます。ただし、応答で `impossible: true` も設定されている場合は、Claude Code が停止を許可し、ターンが終了します

4278* `PreToolUse`:ツール呼び出しが拒否されます。デフォルトではターンが終了し、拒否理由は警告行としてチャットに表示されます。代わりに理由をツール エラーとして Claude に返し、Claude が調整して続行できるようにするには、`continueOnBlock: true` を設定します。これはコマンド フックの `permissionDecision: "deny"` と同等です。v2.1.210 より前は、拒否理由はツール エラーとして Claude に返され、ターンは続行されていました4272* `PreToolUse`:ツール呼び出しが拒否されます。デフォルトではターンが終了し、拒否理由は警告行としてチャットに表示されます。代わりに理由をツール エラーとして Claude に返し、Claude が調整して続行できるようにするには、`continueOnBlock: true` を設定します。これはコマンド フックの `permissionDecision: "deny"` と同等です

4279* `PostToolUse`:デフォルトではターンが終了し、理由は警告行としてチャットに表示されます。`continueOnBlock: true` を設定して、理由を Claude にフィードバックし、ターンを続行する代わりに使用します4273* `PostToolUse`:デフォルトではターンが終了し、理由は警告行としてチャットに表示されます。`continueOnBlock: true` を設定して、理由を Claude にフィードバックし、ターンを続行する代わりに使用します

4280* `PostToolBatch`、`UserPromptSubmit`、`UserPromptExpansion`:ターンが終了し、理由は警告行として表示されます。これらのイベントは `continue` に関係なく `decision: "block"` でターンを終了します4274* `PostToolBatch`、`UserPromptSubmit`、`UserPromptExpansion`:ターンが終了し、理由は警告行として表示されます。これらのイベントは `continue` に関係なく `decision: "block"` でターンを終了します

4281* `PostToolUseFailure`、`TaskCreated`:理由は `continueOnBlock` に関係なくツール エラーとして Claude に返され、ターンが続行されます4275* `PostToolUseFailure`、`TaskCreated`:理由は `continueOnBlock` に関係なくツール エラーとして Claude に返され、ターンが続行されます

hooks-guide.md +20 −25

Details

627exit 0 # exit 0 = 決定なし。通常の権限フローが適用されます627exit 0 # exit 0 = 決定なし。通常の権限フローが適用されます

628```628```

629 629 

630終了コードは次に何が起こるかを決定します:6300 と 2 以外の終了コードで有効な JSON 出力がない場合、ほとんどのイベントではアクションが続行されます。ただし、そのフックが [失敗時にアクションをブロックする](/docs/ja/hooks#block-the-action-when-a-hook-fails) ものである場合は除きます。`onFailure` が `"block"` に設定されたフックはその一例です。異議がないことを報告するには 0 で終了し、アクションをブロックするには 2 で終了します:

631 631 

632* **終了 0**:hook は異議を報告しません。632* **終了 0**:`PreToolUse` hook から 0 で終了しても、ツール呼び出しは通常の [権限フロー](/docs/ja/permissions) を経由します。終了 0 はツール呼び出しを承認しないためです。`UserPromptSubmit`、`UserPromptExpansion`、`SessionStart`、および `PostModelSwitch` hooks の場合、Claude Code は [プレーンテキストとして扱う](/docs/ja/hooks#exit-code-0) stdout を Claude のコンテキストに追加します。

633 * `PreToolUse` hook の場合、これはツール呼び出しを承認しません:通常の [許可フロー](/docs/ja/permissions) が引き続き適用されます。633* **終了 2**:stderr に理由を書き込みます。イベントによって、Claude がそれをフィードバックとして受け取って調整できる場合、ユーザーに表示される場合、`ConfigChange` や `Elicitation` のようにメッセージが表示されない場合があります。一部のイベントはブロックできません:`SessionStart` などの場合、終了 2 は stderr をユーザーに表示し、実行は続行されます。[イベントごとの終了コード 2 の動作](/docs/ja/hooks#exit-code-2-behavior-per-event) で完全なリストを参照してください。

634 * `UserPromptSubmit`、`UserPromptExpansion`、`SessionStart`、および `PostModelSwitch` hooks の場合、Claude Code は stdout を [プレーンテキストとして扱い](/docs/ja/hooks#exit-code-0) Claude のコンテキストに追加します。634* **その他の終了コード**:`WorktreeCreate` がゼロ以外の終了で失敗するなどのイベントごとの例外については、[終了コード出力](/docs/ja/hooks#exit-code-output) を参照してください。その他のイベントでは、そのフックが失敗時にアクションをブロックするものでない限り、フックが stdout に出力した内容から該当するケースを確認してください:

635* **終了 2**:Claude Code はアクションをブロックします。stderr に理由を書き込みます。それがどこに着地するかはイベントによって異なります:一部のイベントはそれを Claude にフィードバックとして供給するため、調整できます。他のイベントはそれをユーザーに表示し、`ConfigChange` や `Elicitation` などのいくつかはメッセージを表示しません。一部のイベントはブロックできません:`SessionStart` などの場合、終了 2 は stderr をユーザーに表示し、実行は続行されます。[イベントごとの終了コード 2 の動作](/docs/ja/hooks#exit-code-2-behavior-per-event) で完全なリストを参照してください。635 * スキーマ検証に合格した解析済みオブジェクト:Claude Code は終了コードを無視し、JSON だけが結果を決定し、フックはエラーとして報告されません。

636* **その他の終了コード**:ほとんどのイベントでは、アクションは [ブロックしないエラー](/docs/ja/hooks#exit-code-output) として続行されます。ただし、そのフックが [失敗時にアクションをブロックする](/docs/ja/hooks#block-the-action-when-a-hook-fails) ものである場合や、その JSON 出力が検証に合格した場合は除きます:636 * スキーマ検証に失敗した解析済みオブジェクト、または Claude Code が [JSON として解析しようとする](/docs/ja/hooks#exit-code-0) ものの有効な JSON ではない stdout:アクションはブロックしないエラーとして続行されます。検証またはパースのメッセージについては、`<hook name> hook error` 通知を確認してください。

637 * スキーマ検証に合格した解析済みオブジェクト:Claude Code は終了コードを無視し、JSON だけが結果を決定し、フックはエラーとして報告されません。`WorktreeCreate` がゼロ以外の終了で失敗するなどのイベントごとの例外は、リファレンスの [終了コード出力](/docs/ja/hooks#exit-code-output) セクションに記載されています。

638 * スキーマ検証に失敗した解析済みオブジェクト、または Claude Code が [JSON として解析しようとする](/docs/ja/hooks#exit-code-0) ものの有効な JSON ではない stdout:ブロックしないエラーになります。通知には検証またはパースのメッセージが含まれます。

639 * Claude Code が [プレーンテキストとして扱う](/docs/ja/hooks#exit-code-0) stdout、または空の stdout:アクションはブロックしないエラーとして続行されます。トランスクリプトには `<hook name> hook error` 通知が表示され、続いて `Failed with non-blocking status code:` を先頭に付けた stderr の最初の行が表示されます。stderr 全体をキャプチャするには、`claude --debug` を使用するか、セッション中に `/debug` を実行して [デバッグログ](/docs/ja/hooks#debug-hooks) を有効にしてください。637 * Claude Code が [プレーンテキストとして扱う](/docs/ja/hooks#exit-code-0) stdout、または空の stdout:アクションはブロックしないエラーとして続行されます。トランスクリプトには `<hook name> hook error` 通知が表示され、続いて `Failed with non-blocking status code:` を先頭に付けた stderr の最初の行が表示されます。stderr 全体をキャプチャするには、`claude --debug` を使用するか、セッション中に `/debug` を実行して [デバッグログ](/docs/ja/hooks#debug-hooks) を有効にしてください。

640 638 

641<h4 id="structured-json-output">639<h4 id="structured-json-output">


662 660 

663`"deny"` を使用すると、Claude Code はツール呼び出しをキャンセルし、`permissionDecisionReason` を Claude にフィードバックとして返します。661`"deny"` を使用すると、Claude Code はツール呼び出しをキャンセルし、`permissionDecisionReason` を Claude にフィードバックとして返します。

664 662 

665`PreToolUse` では、Claude Code は各 `permissionDecision` 値を次のように処理します:663`PreToolUse` では、`"ask"` を返してユーザーに通常の権限プロンプトを表示したり、`"allow"` を返して対話的な権限プロンプトをスキップしたりすることもできます。`"allow"` の場合でも、拒否ルールと確認ルール(エンタープライズの管理 deny リストを含む)は引き続き適用され、次に対するプロンプトも引き続き表示されます:

666 

667* `"allow"`:対話的な権限プロンプトをスキップします。拒否ルールと確認ルール(エンタープライズの管理 deny リストを含む)は引き続き適用され、次に対するプロンプトも引き続き表示されます:

668 664 

669 * [ネットワークパス](/docs/ja/permissions#network-paths) からの読み取り665* [ネットワークパス](/docs/ja/permissions#network-paths) からの読み取り

670 * [`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool) とマークされた MCP ツール666* [`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool) とマークされた MCP ツール

671 * その設定が Claude Code に届くセッションで [組織が `ask` に設定した](/docs/ja/mcp#organization-controls-on-connector-tools) コネクタツール667* その設定が Claude Code に届くセッションで [組織が `ask` に設定した](/docs/ja/mcp#organization-controls-on-connector-tools) コネクタツール

672 668 

673 plan モードでの `"allow"` の動作については、[plan モードでのフックによる承認](/docs/ja/permissions#hook-approvals-in-plan-mode) を参照してください。669 plan モードでの `"allow"` の動作については、[plan モードでのフックによる承認](/docs/ja/permissions#hook-approvals-in-plan-mode) を参照してください。

674* `"deny"`:ツール呼び出しをキャンセルし、理由を Claude に送信します

675* `"ask"`:通常どおりユーザーに許可プロンプトを表示します

676 670 

6774 番目の値 `"defer"` は、`-p` フラグ付きの [非インタラクティブモード](/docs/ja/headless) で利用可能です。プロセスを終了し、ツール呼び出しを保持して、Agent SDK ラッパーが入力を収集して再開できるようにします。リファレンスの [ツール呼び出しを後で延期する](/docs/ja/hooks#defer-a-tool-call-for-later) を参照してください。6714 番目の値 `"defer"` は、`-p` フラグ付きの [非インタラクティブモード](/docs/ja/headless) で利用可能です。プロセスを終了し、ツール呼び出しを保持して、Agent SDK ラッパーが入力を収集して再開できるようにします。リファレンスの [ツール呼び出しを後で延期する](/docs/ja/hooks#defer-a-tool-call-for-later) を参照してください。

678 672 


892 886 

893* `"ok": true`:アクションが続行されます887* `"ok": true`:アクションが続行されます

894* `"ok": false`:何が起こるかはイベントによって異なります:888* `"ok": false`:何が起こるかはイベントによって異なります:

895 * `Stop` および `SubagentStop`:`reason` は Claude にフィードバックとして返されるため、作業を続けます。ただし、レスポンスが `"impossible": true` も設定している場合は、その条件が決して満たされることのない条件として印付けられ、その場合 Claude Code は停止を許可してターンが終了します889 * `Stop` および `SubagentStop`:`reason` は Claude にフィードバックとして返されるため、作業を続けます。ただし、応答が `"impossible": true` も設定している場合は、その条件が決して満たされることのない条件として印付けられ、その場合 Claude Code は停止を許可してターンが終了します

896 * `PreToolUse`:ツール呼び出しが拒否されます。デフォルトではターンが終了し、拒否の `reason` は警告行としてチャットに表示されます。hook に `continueOnBlock: true` を設定すると、代わりに `reason` を Claude にツールエラーとして返すため、調整して続行できます。v2.1.210 より前では、拒否の `reason` は Claude にツールエラーとして返され、ターンが続行されていました890 * `PreToolUse`:ツール呼び出しが拒否されます。デフォルトではターンが終了し、拒否の `reason` は警告行としてチャットに表示されます。フックに `continueOnBlock: true` を設定すると、代わりに `reason` を Claude にツールエラーとして返すため、調整して続行できます

897 * `PostToolUse`:デフォルトではターンが終了し、`reason` は警告行としてチャットに表示されます。`continueOnBlock: true` を設定すると、`reason` を Claude にフィードバックとして返し、代わりにターンを続行します891 * `PostToolUse`:デフォルトではターンが終了し、`reason` は警告行としてチャットに表示されます。`continueOnBlock: true` を設定すると、`reason` を Claude にフィードバックとして返し、代わりにターンを続行します

898 * `PostToolBatch`、`UserPromptSubmit`、および `UserPromptExpansion`:ターンが終了し、`reason` は警告行としてチャットに表示されます892 * `PostToolBatch`、`UserPromptSubmit`、および `UserPromptExpansion`:ターンが終了し、`reason` は警告行としてチャットに表示されます

899 893 


1019 フックと権限モード1013 フックと権限モード

1020</h3>1014</h3>

1021 1015 

1022`PreToolUse` フックは、`dontAsk` を含むすべての[権限モード](/docs/ja/permission-modes)において、権限モードのチェックより前に発火します。`permissionDecision: "deny"` を返すフックは、`bypassPermissions` モードや `--dangerously-skip-permissions` を使用している場合でもツールをブロックします。これにより、ユーザーが権限モードを変更しても回避できないポリシーを適用できます。1016設定ファイルやプラグインの `hooks/hooks.json` 内のフックでは、権限ルールが許可する範囲を超えて制限を緩めることはできず、フックの `"deny"` はすべての権限モードで有効です。

1023 1017 

1024逆は成り立ちません。設定ファイルやプラグインの `hooks/hooks.json` 内のフックは、制限を厳しくすることはできますが、権限ルールが許可する範囲を超えて緩めることはできません。`"allow"` を返すフックは、設定の拒否ルールを回避することはできず、以下のプロンプトを抑制することもできません。1018* **`"allow"` に対して引き続き有効なもの**:`"allow"` を返すフックは、設定の拒否ルールを回避することはできず、以下のプロンプトを抑制することもできません。

1025 1019 * [ネットワークパス](/docs/ja/permissions#network-paths)からの読み取り

1026* [ネットワークパス](/docs/ja/permissions#network-paths)からの読み取り1020 * [`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool) が指定された MCP ツール

1027* [`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool) が指定された MCP ツール1021 * その設定が Claude Code に反映されるセッションにおいて、[組織が `ask` に設定した](/docs/ja/mcp#organization-controls-on-connector-tools)コネクタツール

1028* その設定が Claude Code に反映されるセッションにおいて、[組織が `ask` に設定した](/docs/ja/mcp#organization-controls-on-connector-tools)コネクタツール

1029 1022 

1030[plan モード](/docs/ja/permissions#hook-approvals-in-plan-mode)では、`PreToolUse` フックがファイル編集に対して `"allow"` を返しても、フックがない場合にその編集が受けるのと同じプロンプト、ブロック、または承認が適用されます。フックによる承認に対するこの制限を解除するには、[プランを承認する](/docs/ja/permission-modes#review-and-approve-a-plan)か、別の権限モードに切り替えてください。1023[plan モード](/docs/ja/permissions#hook-approvals-in-plan-mode)では、`PreToolUse` フックがファイル編集に対して `"allow"` を返しても、フックがない場合にその編集が受けるのと同じプロンプト、ブロック、または承認が適用されます。フックによる承認に対するこの制限を解除するには、[プランを承認する](/docs/ja/permission-modes#review-and-approve-a-plan)か、別の権限モードに切り替えてください。

1031 1024 

1025* **すべての権限モードでの `"deny"`**:`permissionDecision: "deny"` を返すフックは、`bypassPermissions` モードや `--dangerously-skip-permissions` を使用している場合でもツールをブロックします。`PreToolUse` フックは、`dontAsk` を含むすべての[権限モード](/docs/ja/permission-modes)において、権限モードのチェックより前に発火します。これにより、ユーザーが権限モードを変更しても回避できないポリシーを適用できます。

1026 

1032インストールした [mod](/docs/ja/plugins/mods/overview) が `tool.check` を処理する場合、そのフックが管理設定にない限り、`PreToolUse` フックがブロックした呼び出しを mod が承認できます。plan モードでは、mod はそのような呼び出しが読み取り専用であれば承認できますが、ファイル編集やその他の読み取り専用でない呼び出しは承認できません。mod に対してどのルールが優先されるかは、[フックで権限を拡張する](/docs/ja/permissions#extend-permissions-with-hooks)に記載されています。1027インストールした [mod](/docs/ja/plugins/mods/overview) が `tool.check` を処理する場合、そのフックが管理設定にない限り、`PreToolUse` フックがブロックした呼び出しを mod が承認できます。plan モードでは、mod はそのような呼び出しが読み取り専用であれば承認できますが、ファイル編集やその他の読み取り専用でない呼び出しは承認できません。mod に対してどのルールが優先されるかは、[フックで権限を拡張する](/docs/ja/permissions#extend-permissions-with-hooks)に記載されています。

1033 1028 

1034<h3 id="hook-not-firing">1029<h3 id="hook-not-firing">

Details

183 INSERT モードのキーシーケンスを再マップ183 INSERT モードのキーシーケンスを再マップ

184</h3>184</h3>

185 185 

186[`vimInsertModeRemaps`](/docs/ja/settings-reference#viminsertmoderemaps) 設定は、2 キーの INSERT モードシーケンスを Escape にマップするため、`jj` のようなマッピングで NORMAL モードに戻ります。Claude Code v2.1.208 以降が必要です。186[`vimInsertModeRemaps`](/docs/ja/settings-reference#viminsertmoderemaps) 設定は、2 キーの INSERT モードシーケンスを Escape にマップするため、`jj` のようなマッピングで NORMAL モードに戻ります。

187 187 

188以下の `~/.claude/settings.json` の例は、vim モードをオンにして `jj` を Escape にマップします:188以下の `~/.claude/settings.json` の例は、vim モードをオンにして `jj` を Escape にマップします:

189 189 


248| `cc` | 行を変更 |248| `cc` | 行を変更 |

249| `C` | 行の終わりまで変更 |249| `C` | 行の終わりまで変更 |

250| `cw`/`ce`/`cb` | 単語を変更/終わりまで/戻す |250| `cw`/`ce`/`cb` | 単語を変更/終わりまで/戻す |

251| `s` | 文字を置換:カーソルの下の文字を削除して INSERT モードに入ります。Claude Code v2.1.211 以降が必要です |251| `s` | 文字を置換:カーソルの下の文字を削除して INSERT モードに入ります |

252| `S` | 行を置換:行をクリアして INSERT モードに入ります。Claude Code v2.1.211 以降が必要です |252| `S` | 行を置換:行をクリアして INSERT モードに入ります |

253| `yy`/`Y` | 行をヤンク(コピー) |253| `yy`/`Y` | 行をヤンク(コピー) |

254| `yw`/`ye`/`yb` | 単語をヤンク/終わりまで/戻す |254| `yw`/`ye`/`yb` | 単語をヤンク/終わりまで/戻す |

255| `p` | カーソルの後に貼り付け |255| `p` | カーソルの後に貼り付け |


471* 会話の最初のターンの後、一部のセッションで471* 会話の最初のターンの後、一部のセッションで

472* 前の応答がエラーで終了した場合472* 前の応答がエラーで終了した場合

473* Plan Mode にいる場合473* Plan Mode にいる場合

474* アカウントが使用制限に近い、またはその制限に達している場合。制限に達するまで提案をオンのままにするには、[`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/ja/env-vars) を `true` に設定します。v2.1.238 より前では、変数が `true` に設定されていても、Claude Code は制限に近い場合にそれらをスキップしていました474* アカウントが使用制限に近い、またはその制限に達している場合。制限に達するまでこのスキップが適用されないようにするには、[`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/ja/env-vars) を `true` に設定します。v2.1.238 より前では、変数が `true` に設定されていても、Claude Code は制限に近い場合に提案をスキップしていました

475* [agent team](/docs/ja/agent-teams) では、デフォルトでチームメイトのセッションで。リーダーのセッションは提案を表示します475* [agent team](/docs/ja/agent-teams) では、デフォルトでチームメイトのセッションで。リーダーのセッションは提案を表示します

476 476 

477`Showing fewer prompt suggestions · use one to bring them back` という通知は、提案を使用しないまま連続して多数見送ったため、Claude Code が提案を表示する頻度を下げていることを意味します。通常の頻度に戻すには、提案を使用するか、[`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/ja/env-vars) を `true` に設定します。477`Showing fewer prompt suggestions · use one to bring them back` という通知は、提案を使用しないまま連続して多数見送ったため、Claude Code が提案を表示する頻度を下げていることを意味します。通常の頻度に戻すには、提案を使用するか、[`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/ja/env-vars) を `true` に設定します。


759 759 

7605 つの最新の以前の補足質問は、現在の回答の上に薄い色のリストとして表示され、古いものの数がカウントされます。これらは会話履歴から除外されます。7605 つの最新の以前の補足質問は、現在の回答の上に薄い色のリストとして表示され、古いものの数がカウントされます。これらは会話履歴から除外されます。

761 761 

762オーバーレイを却下した後に戻るには、質問なしで `/btw` を実行します。オーバーレイは最新のやり取りで再度開きます。v2.1.212 より前では、質問なしの `/btw` は代わりに使用メッセージを出力していました。762オーバーレイを却下した後に戻るには、質問なしで `/btw` を実行します。オーバーレイは最新のやり取りで再度開きます。

763 763 

764回答が表示されたら、オーバーレイはこれらのキーを受け入れます。764回答が表示されたら、オーバーレイはこれらのキーを受け入れます。

765 765 

keybindings.md +4 −5

Details

309| `footer:close` | x | 選択した [エージェント](/docs/ja/sub-agents#observe-and-steer-running-forks) または [ワークフロー](/docs/ja/workflows#manage-runs) を停止します。すでに実行中でない場合は、その行を閉じます |309| `footer:close` | x | 選択した [エージェント](/docs/ja/sub-agents#observe-and-steer-running-forks) または [ワークフロー](/docs/ja/workflows#manage-runs) を停止します。すでに実行中でない場合は、その行を閉じます |

310| `footer:dismiss` | (バインドなし) | このアクションにキーをバインドしても効果がなく、それを名前付けする `keybindings.json` は有効なままです。v2.1.281 より前では、Backspace と Delete はフッターから選択したアーティファクトリンクを削除しました。 |310| `footer:dismiss` | (バインドなし) | このアクションにキーをバインドしても効果がなく、それを名前付けする `keybindings.json` は有効なままです。v2.1.281 より前では、Backspace と Delete はフッターから選択したアーティファクトリンクを削除しました。 |

311 311 

312フッター項目が選択されている場合(プロンプトの下のエージェントパネルの行など)、`chat:submit` を `chat:queueSubmit` または `chat:newline` に再バインドしても、`Enter` はそれを開きます。312フッター項目が選択されている間(プロンプトの下のエージェントパネルの行など)は、`Chat` コンテキストで `Enter` を `chat:queueSubmit` または `chat:newline` に再バインドしていても、`Enter` はその項目を開きます。

313 313 

314`Chat` バインディングは、`Shift+Tab` を `chat:cycleMode` のように `Footer` コンテキストがバインドしないキーで機能し、項目が選択されている間も機能します。314`Chat` バインディングは、`Shift+Tab` を `chat:cycleMode` のように `Footer` コンテキストがバインドしないキーで機能し、項目が選択されている間も機能します。

315 315 


462| `abovePrompt:highlightNext` | Down | フォーカスされたセレクト内の次のオプションをハイライト |462| `abovePrompt:highlightNext` | Down | フォーカスされたセレクト内の次のオプションをハイライト |

463| `abovePrompt:highlightPrevious` | Up | フォーカスされたセレクト内の前のオプションをハイライト |463| `abovePrompt:highlightPrevious` | Up | フォーカスされたセレクト内の前のオプションをハイライト |

464 464 

4652 つのコンテキストが、デフォルトでこれらのアクションに追加のキーをバインドしています:465[`AbovePrompt` コンテキスト](#contexts) では、デフォルトで Right と Left も `abovePrompt:next` と `abovePrompt:previous` を実行し、Space も `abovePrompt:press` を実行します。

466 

467* **`AbovePrompt`**:Right と Left も `abovePrompt:next` と `abovePrompt:previous` を実行し、Space も `abovePrompt:press` を実行します

468* **`AbovePromptInput`**:Down と Up も `abovePrompt:next` と `abovePrompt:previous` を実行します

469 466 

470`AbovePrompt` コンテキストは、Up、Down、PageUp、PageDown、Home、End も [ペインのスクロールアクション](#pane-actions) `pane:scrollUp` から `pane:bottom` にバインドしています。そのため、帯でこれらのキーのいずれかを変更するには、`AbovePrompt` ブロックでスクロールアクションをバインドします。467`AbovePrompt` コンテキストは、Up、Down、PageUp、PageDown、Home、End も [ペインのスクロールアクション](#pane-actions) `pane:scrollUp` から `pane:bottom` にバインドしています。そのため、帯でこれらのキーのいずれかを変更するには、`AbovePrompt` ブロックでスクロールアクションをバインドします。

471 468 


769* Vim NORMAL モードでは、`?` はヘルプメニューを表示します(Vim の動作)766* Vim NORMAL モードでは、`?` はヘルプメニューを表示します(Vim の動作)

770* Vim NORMAL モードでは、`/` は履歴検索を開きます。標準モードの Ctrl+R と同じです767* Vim NORMAL モードでは、`/` は履歴検索を開きます。標準モードの Ctrl+R と同じです

771 768 

769Claude が尋ねる質問の `Other` 行では、Vim モードで Escape を押しても質問はすぐにはキャンセルされません。[スクリーンリーダーモード](/docs/ja/accessibility)の場合を除き、この行はフォーカスするたびに INSERT モードで開始されます。`Other` 行で Escape を押すと、行が NORMAL モードに切り替わるか、入力途中の Vim コマンドが破棄され、質問は開いたままになります。質問をキャンセルするには、NORMAL モードで Escape をもう一度押してください。

770 

772<h2 id="validation">771<h2 id="validation">

773 検証772 検証

774</h2>773</h2>

Details

216* **管理者によって配布される**:組織が[設定を配布](/docs/ja/llm-gateway-rollout#distribute-through-managed-settings)している場合、デスクトップアプリはゲートウェイを通じてルーティングされ、設定は不要です216* **管理者によって配布される**:組織が[設定を配布](/docs/ja/llm-gateway-rollout#distribute-through-managed-settings)している場合、デスクトップアプリはゲートウェイを通じてルーティングされ、設定は不要です

217* **ローカルで設定される**:管理者配布設定がないデバイスの場合、Help → Troubleshooting → 開発者モードを有効化を開きます。これはアプリを再起動して開発者メニューを表示します。その後、Developer → Configure Third-Party Inference を開き、ゲートウェイベース URL を入力します。管理者配布設定が優先され、このフォームを読み取り専用にします217* **ローカルで設定される**:管理者配布設定がないデバイスの場合、Help → Troubleshooting → 開発者モードを有効化を開きます。これはアプリを再起動して開発者メニューを表示します。その後、Developer → Configure Third-Party Inference を開き、ゲートウェイベース URL を入力します。管理者配布設定が優先され、このフォームを読み取り専用にします

218 218 

219ゲートウェイ設定がアクティブな場合、環境ピッカーは Anthropic ホスト型クラウド環境を提供せず、[Remote Control](/docs/ja/remote-control) は利用できません。219ゲートウェイ設定がアクティブな場合、環境セレクターは Anthropic ホスト型クラウド環境を提供せず、[Remote Control](/docs/ja/remote-control) は利用できません。

220 220 

221ゲートウェイ設定での SSH セッションはベータ版であり、Claude Desktop v1.40609.0 以降が必要です。接続する前に、許可リストとゲートウェイのアドレスを確認してください:221ゲートウェイ設定での SSH セッションはベータ版であり、Claude Desktop v1.40609.0 以降が必要です。接続する前に、許可リストとゲートウェイのアドレスを確認してください:

222 222 

mcp.md +5 −5

Details

324* ローカル、プロジェクト、またはユーザー [スコープ](#mcp-installation-scopes) のサーバー、または管理 MCP 設定のサーバーの場合、オリジンはその設定に書かれたとおりのホストを表示するため、ホストの `${VAR}` 参照はメッセージで展開されません。324* ローカル、プロジェクト、またはユーザー [スコープ](#mcp-installation-scopes) のサーバー、または管理 MCP 設定のサーバーの場合、オリジンはその設定に書かれたとおりのホストを表示するため、ホストの `${VAR}` 参照はメッセージで展開されません。

325* ステータスまたはエラーコードのない失敗の場合、Claude Code はオリジンなしでエラーテキストを表示します。325* ステータスまたはエラーコードのない失敗の場合、Claude Code はオリジンなしでエラーテキストを表示します。

326 326 

327設定に空の `url` を持つリモートサーバーは `/mcp`、`claude mcp list`、[`/plugin`](/docs/ja/plugins/install) マネージャーで `not configured` として表示され、Claude Code はそれに接続しようとしません。プラグインは後で設定するコネクタのプレースホルダーエントリをこのように含めることができるため、Claude Code はそれをエラーまたはセットアップの問題として報告しません。`/mcp` のサーバーの詳細ビューには `No URL configured for this server` と表示されます。接続するにはエントリの `url` を設定してください。v2.1.208 より前では、Claude Code は空の `url` を設定の問題として報告し、再接続を促していました。327設定に空の `url` を持つリモートサーバーは `/mcp`、`claude mcp list`、[`/plugin`](/docs/ja/plugins/install) マネージャーで `not configured` として表示され、Claude Code はそれに接続しようとしません。プラグインは後で設定するコネクタのプレースホルダーエントリをこのように含めることができるため、Claude Code はそれをエラーまたはセットアップの問題として報告しません。`/mcp` のサーバーの詳細ビューには `No URL configured for this server` と表示されます。接続するにはエントリの `url` を設定してください。

328 328 

329<h4 id="configuration-warnings">329<h4 id="configuration-warnings">

330 設定警告330 設定警告


403* **対話的なターミナルセッション**では、Claude Code はそのサーバーから更新されたリストを取得するため、再接続する必要はありません。403* **対話的なターミナルセッション**では、Claude Code はそのサーバーから更新されたリストを取得するため、再接続する必要はありません。

404* **`-p` フラグを使用した [非対話モード](/docs/ja/headless) および [Agent SDK](/docs/ja/agent-sdk/overview)** では、Claude Code はこれらの通知に対してツールリストのみをリフレッシュします。404* **`-p` フラグを使用した [非対話モード](/docs/ja/headless) および [Agent SDK](/docs/ja/agent-sdk/overview)** では、Claude Code はこれらの通知に対してツールリストのみをリフレッシュします。

405 405 

406リフレッシュリクエストが失敗する場合、Claude Code は後のリフレッシュが成功するまで、サーバーの以前に検出されたツール、プロンプト、リソースを保持します。v2.1.214 より前では、リフレッシュ中の一時的なエラーはサーバーのツール、プロンプト、リソースを空のリストに置き換えていました。406リフレッシュリクエストが失敗する場合、Claude Code は後のリフレッシュが成功するまで、サーバーの以前に検出されたツール、プロンプト、リソースを保持します。

407 407 

408<h4 id="notification-streams-on-the-v2-runtime">408<h4 id="notification-streams-on-the-v2-runtime">

409 v2 ランタイムの通知ストリーム409 v2 ランタイムの通知ストリーム


502 長いツール呼び出しの自動バックグラウンド化502 長いツール呼び出しの自動バックグラウンド化

503</h3>503</h3>

504 504 

505メイン会話の MCP ツール呼び出しが 2 分後も実行中の場合、セッションをブロックする代わりにバックグラウンドタスクに移動します。Claude はタスク ID をすぐに受け取り、作業を続け、結果は呼び出しが解決するときにタスク通知として到着します。自動バックグラウンド化には Claude Code v2.1.212 以降が必要です。505メイン会話の MCP ツール呼び出しが 2 分後も実行中の場合、セッションをブロックする代わりにバックグラウンドタスクに移動します。Claude はタスク ID をすぐに受け取り、作業を続け、結果は呼び出しが解決するときにタスク通知として到着します。

506 506 

507タスクは [`/tasks`](/docs/ja/commands#all-commands) に表示され、そこで停止することもでき、セッションを終了しても存続しません。タスクのエントリは、サーバーが報告した最新の進捗を表示します。タスクを停止すると、Claude Code は呼び出しをキャンセルし、結果が届かないことを Claude に伝えます。停止してもサーバーが停止するとは限りません。サーバーはすでに作業の一部を実行している可能性があり、あるいはそのまま完了させる可能性もあります。507タスクは [`/tasks`](/docs/ja/commands#all-commands) に表示され、そこで停止することもでき、セッションを終了しても存続しません。タスクのエントリは、サーバーが報告した最新の進捗を表示します。タスクを停止すると、Claude Code は呼び出しをキャンセルし、結果が届かないことを Claude に伝えます。停止してもサーバーが停止するとは限りません。サーバーはすでに作業の一部を実行している可能性があり、あるいはそのまま完了させる可能性もあります。

508 508 


1301 Connector が Claude Code に到達する方法1301 Connector が Claude Code に到達する方法

1302</h3>1302</h3>

1303 1303 

1304どの設定が claude.ai connector を管理するかは、セッションが実行される場所によって異なります。セッションの種類によっては、claude.ai 自体から connector を取得するセッションのみがあるためです。以下の各行は、1 種類のセッションで connector がどのように到達するか、およびそこで何が connector を制御するかを示しています。デスクトップアプリの [WSL sessions](/docs/ja/desktop-wsl#what-works-in-a-wsl-session) には、connector がまだ利用できないため、行がありません。1304claude.ai コネクタをどの設定が制御するかは、セッションの実行場所によって異なります。claude.ai からコネクタを自ら取得するのは一部のセッションだけだからです。以下の各行は、セッションの種類ごとにコネクタがどのように届くか、そこで何がコネクタを制御するかを示しています。デスクトップアプリの WSL セッションについては、コネクタが[まだ順次提供中](/docs/ja/desktop-wsl#check-for-the-terminal-and-connectors)であるため、行がありません。

1305 1305 

1306| セッションが実行される場所 | Connector がどのように到達するか | 何が connector を管理するか |1306| セッションが実行される場所 | Connector がどのように到達するか | 何が connector を管理するか |

1307| :- | :- | :- |1307| :- | :- | :- |


1531 1531 

1532[Remote Control](/docs/ja/remote-control) や [Agent SDK](/docs/ja/agent-sdk/overview) 上に構築されたアプリケーションなど、一部のサーフェスでは通常、1 タップでツール呼び出しを承認できます。このアノテーションでマークされたツールの場合、Claude Code は 1 タップアクションを保留し、代わりにツールの完全な権限プロンプトを表示するため、承認は依然として 1 タップではなく、プロンプトに答える人から得られます。1532[Remote Control](/docs/ja/remote-control) や [Agent SDK](/docs/ja/agent-sdk/overview) 上に構築されたアプリケーションなど、一部のサーフェスでは通常、1 タップでツール呼び出しを承認できます。このアノテーションでマークされたツールの場合、Claude Code は 1 タップアクションを保留し、代わりにツールの完全な権限プロンプトを表示するため、承認は依然として 1 タップではなく、プロンプトに答える人から得られます。

1533 1533 

1534Claude Code は、安全警告を含むものや、リモートサーフェスが表示できない常に許可オプションなど、ターミナルダイアログでのみ完全にレンダリングできる権限リクエストに対して、同じ方法で 1 タップ承認を保留します。そのリクエストには Remote Control からではなく、ターミナルダイアログで答えます。Claude Code v2.1.214 以降が必要です。1534Claude Code は、安全警告を含むものや、リモートサーフェスが表示できない常に許可オプションなど、ターミナルダイアログでのみ完全にレンダリングできる権限リクエストに対して、同じ方法で 1 タップ承認を保留します。そのリクエストには Remote Control からではなく、ターミナルダイアログで答えます。

1535 1535 

1536<h2 id="respond-to-mcp-elicitation-requests">1536<h2 id="respond-to-mcp-elicitation-requests">

1537 MCP エリシテーション要求に応答する1537 MCP エリシテーション要求に応答する

memory.md +3 −3

Details

521* `.github/copilot-instructions.md` の Copilot ルール521* `.github/copilot-instructions.md` の Copilot ルール

522* `CLAUDE_CODE_NEW_INIT=1` が設定されている場合: `AGENTS.md`、`.devin/rules/`、`.windsurf/rules/` または `.windsurfrules`、および `.clinerules`522* `CLAUDE_CODE_NEW_INIT=1` が設定されている場合: `AGENTS.md`、`.devin/rules/`、`.windsurf/rules/` または `.windsurfrules`、および `.clinerules`

523 523 

524[`/import`](/docs/ja/commands) を実行して、サポートされているコーディングエージェントの設定を Claude Code に取り込むこともできます。これにより、`AGENTS.md` などの指示ファイルの 1 回限りのコピーが一致する `CLAUDE.md` に追加され、MCP サーバー、コマンド、サブエージェント、およびスキルが引き継がれます。Claude Code v2.1.213 以降が必要です。524[`/import`](/docs/ja/commands) を実行して、サポートされているコーディングエージェントの設定を Claude Code に取り込むこともできます。これにより、`AGENTS.md` などの指示ファイルの 1 回限りのコピーが一致する `CLAUDE.md` に追加され、MCP サーバー、コマンド、サブエージェント、およびスキルが引き継がれます。

525 525 

526<h2 id="auto-memory">526<h2 id="auto-memory">

527 自動メモリ527 自動メモリ


569 569 

570各プロジェクトは `~/.claude/projects/<project>/memory/` に独自のメモリディレクトリを取得します。`<project>` パスは git リポジトリから派生しているため、同じリポジトリ内のすべてのワーキングツリーとサブディレクトリは 1 つの自動メモリディレクトリを共有します。git リポジトリの外では、プロジェクトルートが代わりに使用されます。570各プロジェクトは `~/.claude/projects/<project>/memory/` に独自のメモリディレクトリを取得します。`<project>` パスは git リポジトリから派生しているため、同じリポジトリ内のすべてのワーキングツリーとサブディレクトリは 1 つの自動メモリディレクトリを共有します。git リポジトリの外では、プロジェクトルートが代わりに使用されます。

571 571 

572`CLAUDE_CODE_PROJECT_DIR_NAME` を `CLAUDE_CONFIG_DIR` の横に設定した場合、Claude Code はその名前を、どのリポジトリを起動しても `<config dir>/projects/` の下の `<project>` ディレクトリとして使用するため、その設定ディレクトリで起動されたプロジェクトは 1 つの自動メモリディレクトリを共有します。Claude Code v2.1.234 以降が必要です。詳細は [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ja/sessions#name-the-project-directory-yourself) を参照してください。572[`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ja/sessions#name-the-project-directory-yourself) を `CLAUDE_CONFIG_DIR` と併せて設定した場合、Claude Code はどのリポジトリで起動しても、その名前を `<config dir>/projects/` の下の `<project>` ディレクトリとして使用するため、その設定ディレクトリで起動されたプロジェクトは 1 つの自動メモリディレクトリを共有します。Claude Code v2.1.234 以降が必要です。

573 573 

574自動メモリを別の場所に保存するには、`settings.json` で `autoMemoryDirectory` を設定します。これは任意の[設定スコープ](/docs/ja/settings#settings-precedence)から読み込まれます。ユーザー、プロジェクト、ローカル、ポリシー、または `--settings` です。574自動メモリを別の場所に保存するには、`settings.json` で `autoMemoryDirectory` を設定します。これは任意の[設定スコープ](/docs/ja/settings#settings-precedence)から読み込まれます。ユーザー、プロジェクト、ローカル、ポリシー、または `--settings` です。

575 575 


615 615 

616Claude はセッション中にメモリファイルを読み書きします。Claude Code インターフェイスで「Saved 2 memories」または「Recalled 2 memories」などのメッセージが表示されたら、Claude は `~/.claude/projects/<project>/memory/` から積極的に更新または読み込みを行っています。616Claude はセッション中にメモリファイルを読み書きします。Claude Code インターフェイスで「Saved 2 memories」または「Recalled 2 memories」などのメッセージが表示されたら、Claude は `~/.claude/projects/<project>/memory/` から積極的に更新または読み込みを行っています。

617 617 

618Claude が YAML フロントマターで始まるメモリファイルを書き込む場合、Claude Code は書き込み時刻を ISO 8601 タイムスタンプとして `modified` フロントマターフィールドに記録します。タイムスタンプは、事実がどの程度最新であるかを、あなたと Claude がメモリを読み戻すときの両方に示します。フロントマターを持つすべてのファイルは、以前のバージョンで作成されたファイルを含め、Claude が次に書き込むときにフィールドを取得します。Claude Code はフロントマターを持たないファイルにフロントマターを追加することはありません。`modified` フィールドには Claude Code v2.1.214 以降が必要です。618Claude が YAML フロントマターで始まるメモリファイルを書き込む場合、Claude Code は書き込み時刻を ISO 8601 タイムスタンプとして `modified` フロントマターフィールドに記録します。タイムスタンプは、事実がどの程度最新であるかを、ユーザーと、メモリを読み戻すときの Claude の両方に示します。

619 619 

620<h3 id="audit-and-edit-your-memory">620<h3 id="audit-and-edit-your-memory">

621 メモリを監査および編集する621 メモリを監査および編集する

model-config.md +2 −1

Details

274* **スキルまたはコマンドの上書き**: Claude Code は、ブロックされたファミリーエイリアスを含めて上書きを無視し、スキルまたはコマンドはセッションのモデルで実行されます。[サブエージェントで実行される](/docs/ja/skills#run-skills-in-a-subagent)スキルまたはコマンドは、代わりに上記のサブエージェントの動作に従います274* **スキルまたはコマンドの上書き**: Claude Code は、ブロックされたファミリーエイリアスを含めて上書きを無視し、スキルまたはコマンドはセッションのモデルで実行されます。[サブエージェントで実行される](/docs/ja/skills#run-skills-in-a-subagent)スキルまたはコマンドは、代わりに上記のサブエージェントの動作に従います

275* **`advisorModel` 設定**: そのセッションではアドバイザーが無効になります275* **`advisorModel` 設定**: そのセッションではアドバイザーが無効になります

276* **`--advisor` フラグ**: Claude Code は起動時にエラーで終了します。[バックグラウンドセッション](/docs/ja/agent-view)では、終了する代わりにアドバイザーなしでセッションを開始します276* **`--advisor` フラグ**: Claude Code は起動時にエラーで終了します。[バックグラウンドセッション](/docs/ja/agent-view)では、終了する代わりにアドバイザーなしでセッションを開始します

277* **`CLAUDE_CODE_AUTO_MODE_MODEL`**: Claude Code はこの変数を無視し、[auto モードの分類器リクエスト](/docs/ja/permission-modes#default-classifier-model)に使用するモデルを、この変数を設定していない場合と同様に選択します

277 278 

278Claude Code は、除外されたモデルを `/model` ピッカーから非表示にします。リストに含めたモデル ID が独自の行も持つかどうかは、プロバイダーによって異なります。279Claude Code は、除外されたモデルを `/model` ピッカーから非表示にします。リストに含めたモデル ID が独自の行も持つかどうかは、プロバイダーによって異なります。

279 280 


285* **[フォールバックモデルチェーン](#fallback-model-chains)**: 許可リスト外のエントリは除外されます286* **[フォールバックモデルチェーン](#fallback-model-chains)**: 許可リスト外のエントリは除外されます

286* **plan モードのアップグレード**: Anthropic API と Claude Platform on AWS では、[`opusplan`](#opusplan-model-setting) のように除外されたモデルへのアップグレードは、アップグレード先ファミリーの許可された最新バージョンを使用します。プロバイダー固有のモデル ID を持つプロバイダーの場合、および許可されたバージョンがない場合は、アップグレードはスキップされ、計画はセッションのモデルで続行されます287* **plan モードのアップグレード**: Anthropic API と Claude Platform on AWS では、[`opusplan`](#opusplan-model-setting) のように除外されたモデルへのアップグレードは、アップグレード先ファミリーの許可された最新バージョンを使用します。プロバイダー固有のモデル ID を持つプロバイダーの場合、および許可されたバージョンがない場合は、アップグレードはスキップされ、計画はセッションのモデルで続行されます

287* **[自動モデルフォールバック](#automatic-model-fallback)**: フォールバック先が除外されている場合、フォールバックは実行されないため、警告されたリクエストは代わりに拒否で終了します288* **[自動モデルフォールバック](#automatic-model-fallback)**: フォールバック先が除外されている場合、フォールバックは実行されないため、警告されたリクエストは代わりに拒否で終了します

288* **[auto モードの分類器](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)**: 分類器のデフォルトである Claude Sonnet 5 は、許可リストが Sonnet 5 を許可している場合にのみ適用されます。除外されている場合、分類器はセッションのモデル(すでに許可リストの制御下にあります)で実行されるか、セッションが [Fable モデル](#work-with-fable)で実行されている場合は Opus モデルで実行されます。Anthropic API 以外のプロバイダーでは、その Opus フォールバックは許可リストを参照せずに、`ANTHROPIC_DEFAULT_OPUS_MODEL` で設定したモデル、または設定していない場合は Opus 5 で実行されます。Claude Code v2.1.210 以降が必要です289* **[auto モードの分類器](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)**: 許可リストが[デフォルトの分類器モデル](/docs/ja/permission-modes#default-classifier-model)を除外している場合、そのモデルを使用するはずだった分類器リクエストは、セッションのモデルで実行されるか、[Fable](#work-with-fable) セッションでは Opus モデルで実行されます。Anthropic API 以外のプロバイダーでは、その Opus フォールバックは許可リストを参照せずに、`ANTHROPIC_DEFAULT_OPUS_MODEL` で設定したモデル、または設定していない場合は Opus 5 で実行されます。Claude Code v2.1.210 以降が必要です

289* **[fast mode](/docs/ja/fast-mode)**: 有効化後にセッションが実行されるモデルが許可リスト外である場合、fast mode の有効化は拒否されます290* **[fast mode](/docs/ja/fast-mode)**: 有効化後にセッションが実行されるモデルが許可リスト外である場合、fast mode の有効化は拒否されます

290* **Amazon Bedrock と Google Cloud の Agent Platform での可用性フォールバック**: セッションの途中でアカウントがモデルへのアクセスを失った場合、別のモデルへの切り替えでは除外されたモデルがスキップされます。[Amazon Bedrock](/docs/ja/amazon-bedrock#when-your-organization-enforces-a-model-allowlist) および [Google Cloud の Agent Platform](/docs/ja/google-vertex-ai#when-your-organization-enforces-a-model-allowlist) での起動時のモデルチェックが除外されたモデルをスキップするのは、管理設定で [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) も設定されている場合のみです291* **Amazon Bedrock と Google Cloud の Agent Platform での可用性フォールバック**: セッションの途中でアカウントがモデルへのアクセスを失った場合、別のモデルへの切り替えでは除外されたモデルがスキップされます。[Amazon Bedrock](/docs/ja/amazon-bedrock#when-your-organization-enforces-a-model-allowlist) および [Google Cloud の Agent Platform](/docs/ja/google-vertex-ai#when-your-organization-enforces-a-model-allowlist) での起動時のモデルチェックが除外されたモデルをスキップするのは、管理設定で [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) も設定されている場合のみです

291 292 

Details

137| `OTEL_LOG_TOOL_CONTENT` | [`tool.output` スパンイベント](#tool-output-span-event)でのツールコンテンツのログ記録を有効にします(デフォルト: 無効)。スパン属性は[独自のゲート](#new-context-gates)のもとでツールコンテンツを保持します。[トレース](#traces-beta)が必要です。コンテンツはコンテンツ上限(デフォルトで 60 KB)で切り詰められます | 有効にするには `1` |137| `OTEL_LOG_TOOL_CONTENT` | [`tool.output` スパンイベント](#tool-output-span-event)でのツールコンテンツのログ記録を有効にします(デフォルト: 無効)。スパン属性は[独自のゲート](#new-context-gates)のもとでツールコンテンツを保持します。[トレース](#traces-beta)が必要です。コンテンツはコンテンツ上限(デフォルトで 60 KB)で切り詰められます | 有効にするには `1` |

138| `OTEL_LOG_MANAGED_SETTINGS` | 編集済みの管理設定と、編集前の設定の SHA-256 ダイジェストを[管理設定の解決](#managed-settings-resolved-event)イベントに追加します(デフォルト: 無効)。プロジェクト設定またはローカル設定の値ではオンになりません。Claude Code v2.1.274 以降が必要です | 有効にするには `1` |138| `OTEL_LOG_MANAGED_SETTINGS` | 編集済みの管理設定と、編集前の設定の SHA-256 ダイジェストを[管理設定の解決](#managed-settings-resolved-event)イベントに追加します(デフォルト: 無効)。プロジェクト設定またはローカル設定の値ではオンになりません。Claude Code v2.1.274 以降が必要です | 有効にするには `1` |

139| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API のリクエストとレスポンスの完全な JSON を `api_request_body` / `api_response_body` ログイベントとして出力します(デフォルト: 無効)。ボディには会話履歴全体が含まれます。これを有効にすることは、`OTEL_LOG_USER_PROMPTS`、`OTEL_LOG_TOOL_DETAILS`、`OTEL_LOG_TOOL_CONTENT` によって公開されるすべての内容への同意を意味します | コンテンツ上限(デフォルトで 60 KB)で切り詰められたインラインのボディには `1`、切り詰められていないボディをディスクに保存し、イベントに `body_ref` ポインターを含めるには `file:<dir>` |139| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API のリクエストとレスポンスの完全な JSON を `api_request_body` / `api_response_body` ログイベントとして出力します(デフォルト: 無効)。ボディには会話履歴全体が含まれます。これを有効にすることは、`OTEL_LOG_USER_PROMPTS`、`OTEL_LOG_TOOL_DETAILS`、`OTEL_LOG_TOOL_CONTENT` によって公開されるすべての内容への同意を意味します | コンテンツ上限(デフォルトで 60 KB)で切り詰められたインラインのボディには `1`、切り詰められていないボディをディスクに保存し、イベントに `body_ref` ポインターを含めるには `file:<dir>` |

140| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツ上限: モデルの応答、ツールコンテンツ、システムプロンプト、生の API ボディなど、コンテンツを保持する属性の最大長(切り詰めマーカーを含む、UTF-16 コード単位、デフォルト: 61440、つまり 60 KB)。デフォルト値は属性値を 64 KB に制限するバックエンドに合わせたサイズです。バックエンドがより大きな値を受け付ける場合にのみ引き上げるか、テレメトリ量を削減するために引き下げてください。OpenTelemetry SDK の属性上限である `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` またはその logrecord 版や span 版のいずれかがより小さく設定されている場合、Claude Code はその小さい値で切り詰め、`[TRUNCATED ...]` マーカーが SDK の上限内に収まるようにします。Claude Code v2.1.214 以降が必要です | `262144` |140| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツ上限: モデルの応答、ツールコンテンツ、システムプロンプト、生の API ボディなど、コンテンツを保持する属性の最大長(切り詰めマーカーを含む、UTF-16 コード単位、デフォルト: 61440、つまり 60 KB)。デフォルト値は属性値を 64 KB に制限するバックエンドに合わせたサイズです。バックエンドがより大きな値を受け付ける場合にのみ引き上げるか、テレメトリ量を削減するために引き下げてください。OpenTelemetry SDK の属性上限である `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` またはその logrecord 版や span 版のいずれかがより小さく設定されている場合、Claude Code はその小さい値で切り詰め、`[TRUNCATED ...]` マーカーが SDK の上限内に収まるようにします | `262144` |

141| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | メトリクスのテンポラリティ設定(デフォルト: `delta`)。バックエンドが累積テンポラリティを想定している場合は `cumulative` に設定します | `delta`, `cumulative` |141| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | メトリクスのテンポラリティ設定(デフォルト: `delta`)。バックエンドが累積テンポラリティを想定している場合は `cumulative` に設定します | `delta`, `cumulative` |

142| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的ヘッダーの更新間隔(デフォルト: 1740000ms / 29 分) | `900000` |142| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的ヘッダーの更新間隔(デフォルト: 1740000ms / 29 分) | `900000` |

143 143 

144`http/protobuf` および `http/json` プロトコルでは、Claude Code は各エクスポートリクエストを `Content-Length` ヘッダー付きで送信します。v2.1.212 より前は、v2.1.191 以降の Claude Code バージョンがこれらのリクエストをチャンク転送エンコーディングで送信していたため、Azure Monitor など長さの宣言を必要とするエンドポイントは `411 Length Required` または `400` エラーでこれらを拒否していました。144`http/protobuf` および `http/json` プロトコルでは、Claude Code は各エクスポートリクエストを `Content-Length` ヘッダー付きで送信します。

145 145 

146<h3 id="mtls-authentication">146<h3 id="mtls-authentication">

147 mTLS 認証147 mTLS 認証


202 202 

203受信したトレースコンテキストは[イベント](#events)にも適用されます。`TRACEPARENT` が設定された Agent SDK および `-p` セッションでは、トレースエクスポーターが設定されていない場合でも、各 OTLP イベントログレコードにアプリケーションのトレースと結び付ける `trace_id` と `span_id` の値が付与されるため、ログバックエンドでイベントをトレースの他の部分と関連付けることができます。203受信したトレースコンテキストは[イベント](#events)にも適用されます。`TRACEPARENT` が設定された Agent SDK および `-p` セッションでは、トレースエクスポーターが設定されていない場合でも、各 OTLP イベントログレコードにアプリケーションのトレースと結び付ける `trace_id` と `span_id` の値が付与されるため、ログバックエンドでイベントをトレースの他の部分と関連付けることができます。

204 204 

205インタラクションがアクティブな間に出力されたレコードには、Claude Code がスパンの非同期コンテキストの外で出力した場合(権限プロンプトのコールバック内や、起動中にバッファリングされて後でエクスポートされたレコードなど)でも、インタラクションスパンの ID が付与されます。アクティブなインタラクションスパンがない状態で出力されたレコードには、受信した `TRACEPARENT` の ID が直接付与されます。v2.1.214 より前は、スパンの非同期コンテキストの外で出力されたレコードには、スパンの ID ではなく受信した `TRACEPARENT` の ID が付与されていました。v2.1.212 より前は、アクティブなスパンの外で出力されたイベントレコードには `trace_id` も `span_id` も付与されていませんでした。205インタラクションがアクティブな間に出力されたレコードには、Claude Code がスパンの非同期コンテキストの外で出力した場合(権限プロンプトのコールバック内や、起動中にバッファリングされて後でエクスポートされたレコードなど)でも、インタラクションスパンの ID が付与されます。アクティブなインタラクションスパンがない状態で出力されたレコードには、受信した `TRACEPARENT` の ID が直接付与されます。

206 206 

207<h4 id="span-hierarchy">207<h4 id="span-hierarchy">

208 スパンの階層208 スパンの階層


328| 属性 | 説明 | ゲート |328| 属性 | 説明 | ゲート |

329| - | - | - |329| - | - | - |

330| `duration_ms` | 権限の決定を待っていた時間 | |330| `duration_ms` | 権限の決定を待っていた時間 | |

331| `decision` | `accept` または `reject` | |331| `decision` | `accept`、`reject`、または `cancelled`。`cancelled` は、Claude Code がツール呼び出しに対する権限の決定を待つのをやめ、そのツールを実行しなかったことを意味します | |

332| `source` | 決定のソース。[ツール決定イベント](#tool-decision-event)と一致します | |332| `source` | `accept` または `reject` の場合は、決定のソース(`config`、`hook`、`user_temporary` など)。各値の意味は[ツール決定イベント](#tool-decision-event)で説明しているとおりです。`cancelled` の場合は、決定が行われる前に待機を終了させた要因(`user_abort` など) | |

333 

334`source` が `user_abort` である `cancelled` の決定は、権限プロンプトまたは [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)のチェックが保留中の間に、即時配信が必要なメッセージがターンを中断したことを意味します。たとえば、auto モードのチェック中に、ユーザーがキューに入れていたメッセージを[すぐに送信した](/docs/ja/interactive-mode#when-claude-code-sends-what-you-queued)場合です。

333 335 

334**`claude_code.tool.execution`**336**`claude_code.tool.execution`**

335 337 


820| - | - |822| - | - |

821| `prompt.id` | 単一のユーザープロンプトの処理中に生成されたすべてのイベントを関連付ける UUID v4 識別子 |823| `prompt.id` | 単一のユーザープロンプトの処理中に生成されたすべてのイベントを関連付ける UUID v4 識別子 |

822| `event.sequence` | イベントを順序付けるための 0 始まりのカウンター。セッションごとではなく Claude Code プロセスごとにカウントされます |824| `event.sequence` | イベントを順序付けるための 0 始まりのカウンター。セッションごとではなく Claude Code プロセスごとにカウントされます |

823| `message.uuid` | セッションのトランスクリプト(`~/.claude/projects/*/*.jsonl` ファイル)に保存されたメッセージの UUID。`assistant_response`、`api_response_body`、および `user_prompt` に含まれます。ただし、0 個または複数のメッセージを生成する可能性があるコマンドのディスパッチは除きます。`assistant_response` と `api_response_body` では、これはレスポンスの最後のトランスクリプトエントリであり、次のターンの `parentUuid` がこれにチェーンされます。Claude Code v2.1.214 以降が必要です。`api_response_body` では v2.1.274 以降が必要です |825| `message.uuid` | セッションのトランスクリプト(`~/.claude/projects/*/*.jsonl` ファイル)に保存されたメッセージの UUID。`assistant_response`、`api_response_body`、および `user_prompt` に付与されます。ただし、0 個または複数のメッセージを生成する可能性があるコマンドのディスパッチには付与されません。`assistant_response` と `api_response_body` では、これは応答の最後のトランスクリプトエントリであり、次のターンの `parentUuid` はこれに連結されます。`api_response_body` では Claude Code v2.1.274 以降が必要 |

824| `request_id` | サーバーが割り当てた API リクエストの ID。`request-id` レスポンスヘッダーから読み取られます(例: `req_011...`)。[Amazon Bedrock](/docs/ja/amazon-bedrock) のように `request-id` ヘッダーのないレスポンスでは、代わりに `x-amzn-requestid` ヘッダーから値を取得します。レスポンスにいずれかのヘッダーが含まれる場合、`api_request`、`api_error`、`api_refusal`、`assistant_response`、`api_response_body` に含まれます。`llm_request` トレーススパンの同名の属性と一致します。`x-amzn-requestid` からの取得には Claude Code v2.1.282 以降が必要です |826| `request_id` | サーバーが割り当てた API リクエストの ID。`request-id` レスポンスヘッダーから読み取られます(例: `req_011...`)。[Amazon Bedrock](/docs/ja/amazon-bedrock) のように `request-id` ヘッダーのないレスポンスでは、代わりに `x-amzn-requestid` ヘッダーから値を取得します。レスポンスにいずれかのヘッダーが含まれる場合、`api_request`、`api_error`、`api_refusal`、`assistant_response`、`api_response_body` に含まれます。`llm_request` トレーススパンの同名の属性と一致します。`x-amzn-requestid` からの取得には Claude Code v2.1.282 以降が必要です |

825| `client_request_id` | `x-client-request-id` リクエストヘッダーとして送信される、クライアントが生成した UUID。ファーストパーティの API 接続では `api_request` と `api_error` に含まれます。サードパーティのプロバイダーのバックエンドや、非ストリーミングのフォールバックを通じてリクエストが再試行された場合には含まれません。リクエストとそのレスポンスを対応付けるもので、タイムアウトなどサーバーの `request_id` が生成されなかった失敗の場合にも利用できます。`llm_request` トレーススパンの同名の属性と一致します。Claude Code v2.1.214 以降が必要です |827| `client_request_id` | `x-client-request-id` リクエストヘッダーとして送信される、クライアントが生成した UUID。ファーストパーティの API 接続では `api_request` と `api_error` に付与されます。サードパーティプロバイダーのバックエンドの場合や、リクエストが非ストリーミングのフォールバックで再試行された場合は付与されません。リクエストとそのレスポンスを対応付けるもので、サーバーの `request_id` が生成されなかったタイムアウトなどの失敗時にも利用できます。`llm_request` トレーススパンの同じ属性と一致します |

826 828 

827単一のプロンプトによってトリガーされたすべてのアクティビティを追跡するには、特定の `prompt.id` の値でイベントをフィルタリングします。これにより、そのプロンプトの処理中に発生した user\_prompt イベント、api\_request イベント、tool\_result イベントが返されます。829単一のプロンプトによってトリガーされたすべてのアクティビティを追跡するには、特定の `prompt.id` の値でイベントをフィルタリングします。これにより、そのプロンプトの処理中に発生した user\_prompt イベント、api\_request イベント、tool\_result イベントが返されます。

828 830 


851* `prompt_length`: プロンプトの長さ853* `prompt_length`: プロンプトの長さ

852* `prompt`: プロンプトの内容。デフォルトでは秘匿化されます。含めるには `OTEL_LOG_USER_PROMPTS=1` を設定してください854* `prompt`: プロンプトの内容。デフォルトでは秘匿化されます。含めるには `OTEL_LOG_USER_PROMPTS=1` を設定してください

853* `prompt_text`: `prompt` と同じ値で、同じ条件で伏せ字化されます。ドット区切りの属性名をネストされたオブジェクトとして保存するバックエンドでは、`prompt.id` を `prompt` という名前のオブジェクト内の `id` として読み取るため、プロンプト文字列が失われる可能性があります。その場合は代わりに `prompt_text` を読み取ってください。Claude Code v2.1.287 以降が必要です855* `prompt_text`: `prompt` と同じ値で、同じ条件で伏せ字化されます。ドット区切りの属性名をネストされたオブジェクトとして保存するバックエンドでは、`prompt.id` を `prompt` という名前のオブジェクト内の `id` として読み取るため、プロンプト文字列が失われる可能性があります。その場合は代わりに `prompt_text` を読み取ってください。Claude Code v2.1.287 以降が必要です

854* `message.uuid`: 結果として生成されたユーザーメッセージの UUID。保存されたトランスクリプトのエントリと一致します。0 個または複数のメッセージを生成する可能性があるコマンドのディスパッチには含まれません。Claude Code v2.1.214 以降が必要です856* `message.uuid`: 結果として生成されたユーザーメッセージの UUID。保存されたトランスクリプトエントリと一致します。0 個または複数のメッセージを生成する可能性があるコマンドのディスパッチには付与されません。

855* `command_name`: プロンプトがコマンドを呼び出す場合のコマンド名。`compact` や `debug` などの組み込みおよびバンドルのコマンド名はそのまま出力されます。`reset` などのエイリアスは正規の名前ではなく入力されたとおりに出力されます。カスタム、プラグイン、MCP のコマンド名は、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `custom` または `mcp` にまとめられます857* `command_name`: プロンプトがコマンドを呼び出す場合のコマンド名。`compact` や `debug` などの組み込みおよびバンドルのコマンド名はそのまま出力されます。`reset` などのエイリアスは正規の名前ではなく入力されたとおりに出力されます。カスタム、プラグイン、MCP のコマンド名は、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `custom` または `mcp` にまとめられます

856* `command_source`: コマンドが存在する場合のコマンドの出どころ。`builtin`、`custom`、`mcp` のいずれかです。プラグインが提供するコマンドは `custom` として報告されます858* `command_source`: コマンドが存在する場合のコマンドの出どころ。`builtin`、`custom`、`mcp` のいずれかです。プラグインが提供するコマンドは `custom` として報告されます

857 859 


873* `response`: 応答テキスト。コンテンツの上限(デフォルトは 60 KB)で切り詰められます。デフォルトでは `<REDACTED>` に秘匿化されます。含めるには `OTEL_LOG_ASSISTANT_RESPONSES=1` を設定してください。`OTEL_LOG_ASSISTANT_RESPONSES` が未設定の場合は、代わりに `OTEL_LOG_USER_PROMPTS` によって制御されます。そのため、プロンプトのログ記録を有効にしたまま応答を秘匿化しておくには `OTEL_LOG_ASSISTANT_RESPONSES=0` を設定してください875* `response`: 応答テキスト。コンテンツの上限(デフォルトは 60 KB)で切り詰められます。デフォルトでは `<REDACTED>` に秘匿化されます。含めるには `OTEL_LOG_ASSISTANT_RESPONSES=1` を設定してください。`OTEL_LOG_ASSISTANT_RESPONSES` が未設定の場合は、代わりに `OTEL_LOG_USER_PROMPTS` によって制御されます。そのため、プロンプトのログ記録を有効にしたまま応答を秘匿化しておくには `OTEL_LOG_ASSISTANT_RESPONSES=0` を設定してください

874* `model`: モデル識別子(例: "claude-sonnet-5")876* `model`: モデル識別子(例: "claude-sonnet-5")

875* `request_id`: API リクエスト ID。[イベント相関属性](#event-correlation-attributes)で説明しています877* `request_id`: API リクエスト ID。[イベント相関属性](#event-correlation-attributes)で説明しています

876* `message.uuid`: 応答の最後のトランスクリプトエントリの UUID。API レスポンスはコンテンツブロックごとに 1 つのトランスクリプトエントリとして保存されます。これはその最後のエントリであり、次のターンの `parentUuid` がこれにチェーンされます。Claude Code v2.1.214 以降が必要です878* `message.uuid`: 応答の最後のトランスクリプトエントリの UUID。API のレスポンスはコンテンツブロックごとに 1 つのトランスクリプトエントリとして保存されます。これはその最後のエントリであり、次のターンの `parentUuid` はこれに連結されます。

877* `query_source`: リクエストを発行したサブシステム。`"repl_main_thread"`、`"compact"`、またはサブエージェント名など879* `query_source`: リクエストを発行したサブシステム。`"repl_main_thread"`、`"compact"`、またはサブエージェント名など

878 880 

879<h4 id="tool-result-event">881<h4 id="tool-result-event">


902* `tool_result_size_bytes`: ツール結果のサイズ(バイト)904* `tool_result_size_bytes`: ツール結果のサイズ(バイト)

903* `mcp_server_scope`: MCP サーバーのスコープ識別子(MCP ツールの場合)905* `mcp_server_scope`: MCP サーバーのスコープ識別子(MCP ツールの場合)

904* `vcs.ref.head.revision`、`vcs.ref.head.name`、`vcs.ref.head.type`(`OTEL_LOG_TOOL_DETAILS=1` の場合): Bash または PowerShell ツールによって実行され成功した `git commit` のコミットの識別情報。`vcs.ref.head.revision` はコミット SHA、`vcs.ref.head.name` はコミットされたブランチ、`vcs.ref.head.type` は `branch` です。detached HEAD 上でコミットされた場合、名前と種類は省略されます。Claude Code v2.1.269 以降が必要です906* `vcs.ref.head.revision`、`vcs.ref.head.name`、`vcs.ref.head.type`(`OTEL_LOG_TOOL_DETAILS=1` の場合): Bash または PowerShell ツールによって実行され成功した `git commit` のコミットの識別情報。`vcs.ref.head.revision` はコミット SHA、`vcs.ref.head.name` はコミットされたブランチ、`vcs.ref.head.type` は `branch` です。detached HEAD 上でコミットされた場合、名前と種類は省略されます。Claude Code v2.1.269 以降が必要です

905* `tool_parameters`(`OTEL_LOG_TOOL_DETAILS=1` の場合): ツール固有のパラメーターを含む JSON 文字列。Claude Desktop の組み込みサーバーについては、Claude Desktop が所有するセッションでは、フラグがオフでも `mcp_server_name`/`mcp_tool_name` のペアが含まれます。これは[ツール決定イベント](#tool-decision-event)と同じ、ホストが作成した名前に対する例外であり、Claude Code v2.1.214 以降が必要です。パラメーターはツールによって異なります。907* `tool_parameters`(`OTEL_LOG_TOOL_DETAILS=1` の場合): ツール固有のパラメーターを含む JSON 文字列。Claude Desktop の組み込みサーバーについては、Claude Desktop が所有するセッションでは、フラグがオフでも `mcp_server_name`/`mcp_tool_name` のペアが含まれます。これは[ツール決定イベント](#tool-decision-event)と同じ、ホストが定義する名前に対する例外です。パラメーターはツールによって異なります。

906 * Bash ツールの場合: `bash_command`、`full_command`、`timeout`、`description`、`dangerouslyDisableSandbox` を含みます。さらに `git commit` コマンドが成功した場合は `git_commit_id` と `git_branch` を含みます。`git_commit_id` は、コミットがセッションの作業ディレクトリの HEAD である場合は完全なコミット SHA、それ以外の場合は Git の短縮 SHA です。`git_branch` はコミットされたブランチで、detached HEAD の場合は省略されます908 * Bash ツールの場合: `bash_command`、`full_command`、`timeout`、`description`、`dangerouslyDisableSandbox` を含み、`git commit` コマンドが成功した場合は `git_commit_id` と `git_branch` も含まれます。`git_commit_id` は、コミットがセッションの作業ディレクトリの HEAD である場合は完全なコミット SHA、それ以外の場合は Git の短縮 SHA です。`git_branch` はコミットされたブランチであり、detached HEAD の場合は省略されます

907 * デスクトップアプリのワークスペース Bash ツール(`tool_name` も `Bash` として報告されます)の場合: `bash_command`、`full_command`、`timeout` のみを含みます909 * デスクトップアプリのワークスペース Bash ツール(`tool_name` も `Bash` として報告されます)の場合: `bash_command`、`full_command`、`timeout` のみを含みます

908 * MCP ツールの場合: `mcp_server_name`、`mcp_tool_name` を含みます910 * MCP ツールの場合: `mcp_server_name`、`mcp_tool_name` を含みます

909 * Skill ツールの場合: `skill_name` を含みます911 * Skill ツールの場合: `skill_name` を含みます

910 * Agent ツールまたは従来の Task ツールの場合: `subagent_type` を含みます912 * Agent ツールまたはレガシーの Task ツールの場合: `subagent_type` を含みます

911* `tool_input`(`OTEL_LOG_TOOL_DETAILS=1` の場合): JSON シリアライズされたツールの引数。512 文字を超える個々の値は切り詰められ、ペイロード全体は約 4 K 文字に制限されます。MCP ツールを含むすべてのツールに適用されます。913* `tool_input`(`OTEL_LOG_TOOL_DETAILS=1` の場合): JSON シリアライズされたツールの引数。512 文字を超える個々の値は切り詰められ、ペイロード全体は約 4 K 文字に制限されます。MCP ツールを含むすべてのツールに適用されます。

912 914 

913<h4 id="api-request-event">915<h4 id="api-request-event">


933* `cache_read_tokens`: キャッシュから読み取られたトークン数935* `cache_read_tokens`: キャッシュから読み取られたトークン数

934* `cache_creation_tokens`: キャッシュの作成に使用されたトークン数936* `cache_creation_tokens`: キャッシュの作成に使用されたトークン数

935* `request_id`: API リクエスト ID(例: `"req_011..."`)。[イベント相関属性](#event-correlation-attributes)で説明しています。937* `request_id`: API リクエスト ID(例: `"req_011..."`)。[イベント相関属性](#event-correlation-attributes)で説明しています。

936* `client_request_id`: `x-client-request-id` リクエストヘッダーとして送信される、クライアントが生成した UUID。含まれる条件については[イベント相関属性](#event-correlation-attributes)の表を参照してください。Claude Code v2.1.214 以降が必要です938* `client_request_id`: `x-client-request-id` リクエストヘッダーとして送信される、クライアントが生成した UUID。付与される条件については[イベント相関属性](#event-correlation-attributes)の表を参照してください

937* `speed`: `"fast"` または `"normal"`。fast mode が有効だったかどうかを示します939* `speed`: `"fast"` または `"normal"`。fast mode が有効だったかどうかを示します

938* `query_source`: リクエストを発行したサブシステム。`"repl_main_thread"`、`"compact"`、またはサブエージェント名など940* `query_source`: リクエストを発行したサブシステム。`"repl_main_thread"`、`"compact"`、またはサブエージェント名など

939* `effort`: リクエストに適用された [effort レベル](/docs/ja/model-config#adjust-effort-level)。`"low"`、`"medium"`、`"high"`、`"xhigh"`、`"max"` のいずれか。Claude Code が effort レベルを送信しない場合(effort をサポートしていないモデルなど)は含まれません。941* `effort`: リクエストに適用された [effort レベル](/docs/ja/model-config#adjust-effort-level)。`"low"`、`"medium"`、`"high"`、`"xhigh"`、`"max"` のいずれか。Claude Code が effort レベルを送信しない場合(effort をサポートしていないモデルなど)は含まれません。


959* `duration_ms`: リクエストの所要時間(ミリ秒)961* `duration_ms`: リクエストの所要時間(ミリ秒)

960* `attempt`: 最初のリクエストを含む試行回数。カウントが再開されるタイミングについては[再試行の上限到達を検出する](#detect-retry-exhaustion)を参照してください962* `attempt`: 最初のリクエストを含む試行回数。カウントが再開されるタイミングについては[再試行の上限到達を検出する](#detect-retry-exhaustion)を参照してください

961* `request_id`: API リクエスト ID(例: `"req_011..."`)。[イベント相関属性](#event-correlation-attributes)で説明しています。963* `request_id`: API リクエスト ID(例: `"req_011..."`)。[イベント相関属性](#event-correlation-attributes)で説明しています。

962* `client_request_id`: `x-client-request-id` リクエストヘッダーとして送信される、クライアントが生成した UUID。タイムアウトや接続エラーなどの失敗によってサーバーの `request_id` が生成されなかった場合でも利用できます。含まれる条件については[イベント相関属性](#event-correlation-attributes)の表を参照してください。Claude Code v2.1.214 以降が必要です964* `client_request_id`: `x-client-request-id` リクエストヘッダーとして送信される、クライアントが生成した UUID。タイムアウトや接続エラーなどの失敗でサーバーの `request_id` が生成されなかった場合でも利用できます。付与される条件については[イベント相関属性](#event-correlation-attributes)の表を参照してください。

963* `speed`: `"fast"` または `"normal"`。fast mode が有効だったかどうかを示します965* `speed`: `"fast"` または `"normal"`。fast mode が有効だったかどうかを示します

964* `query_source`: リクエストを発行したサブシステム。`"repl_main_thread"`、`"compact"`、またはサブエージェント名など966* `query_source`: リクエストを発行したサブシステム。`"repl_main_thread"`、`"compact"`、またはサブエージェント名など

965* `effort`: リクエストに適用された [effort レベル](/docs/ja/model-config#adjust-effort-level)。Claude Code が effort レベルを送信しない場合(effort をサポートしていないモデルなど)は含まれません。967* `effort`: リクエストに適用された [effort レベル](/docs/ja/model-config#adjust-effort-level)。Claude Code が effort レベルを送信しない場合(effort をサポートしていないモデルなど)は含まれません。


1057* `tool_name`: ツールの名前(例: "Read"、"Edit"、"Write"、"NotebookEdit")1059* `tool_name`: ツールの名前(例: "Read"、"Edit"、"Write"、"NotebookEdit")

1058* `tool_use_id`: このツール呼び出しの一意の識別子。フックに渡される `tool_use_id` と一致するため、OTel イベントとフックで取得したデータを関連付けることができます。1060* `tool_use_id`: このツール呼び出しの一意の識別子。フックに渡される `tool_use_id` と一致するため、OTel イベントとフックで取得したデータを関連付けることができます。

1059* `decision`: `"accept"` または `"reject"`1061* `decision`: `"accept"` または `"reject"`

1060* `tool_source`: 常に含まれます。ツールの出自を示す、CLI が定める閉じた集合の値です。Claude Code v2.1.214 以降が必要です1062* `tool_source`: 常に付与されます。ツールの由来を示す、CLI が定義する値の閉じたセットです。

1061 * `"builtin"`: CLI 自身のツール1063 * `"builtin"`: CLI 自体のツール

1062 * `"mcp"`: 一般的な MCP サーバー1064 * `"mcp"`: MCP サーバー全般

1063 * `"sdk_host_builtin_mcp"`: Claude Desktop が所有するセッションにおける、Claude Desktop 自体に組み込まれたインプロセスサーバー。Claude Desktop は、自身のエントリポイント(`claude-desktop`、`claude-desktop-3p`、`local-agent`)のいずれかから開始したセッションが、ネストされた子セッションでない場合にそのセッションを所有します。Claude Code 自体が起動するセッションを含むネストされたセッションでは、これらのサーバーは `"mcp"` として報告されます1065 * `"sdk_host_builtin_mcp"`: Claude Desktop 自体に組み込まれたインプロセスサーバー(Claude Desktop が所有するセッションの場合)。Claude Desktop は、自身のエントリポイント(`claude-desktop`、`claude-desktop-3p`、`local-agent`)のいずれかから開始したセッションが入れ子の子セッションでない場合に、そのセッションを所有します。Claude Code 自体が生成するセッションを含む入れ子のセッションでは、これらのサーバーは `"mcp"` として報告されます

1064* `source`: 決定の出どころ:1066* `source`: 決定の発生元。

1065 * `"config"`: プロンプトを表示せずに自動的に決定されたもの。プロジェクト設定、ユーザーの個人設定の許可ルールまたは拒否ルール、エンタープライズの管理ポリシー、`--allowedTools` または `--disallowedTools` フラグ、アクティブな権限モード、同じ対話型 CLI セッション内の以前のプロンプトで付与されたセッションスコープの権限、またはツールが本質的に安全であることに基づきます。イベントには、これらのうちどのソースが一致したかは示されません。Claude Code は、権限プロンプトのリクエスト自体が失敗した場合にも `"config"` を報告します。たとえば、Agent SDK の [`canUseTool`](/docs/ja/agent-sdk/typescript#canusetool) コールバックや [`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) ツールが無効な結果を返した場合や、リクエストの保留中に入力ストリームが閉じられた場合です。v2.1.216 より前は、Claude Code はこれらの失敗を `"user_reject"` として報告していました。1067 * `"config"`: 次のいずれかの発生元によって、プロンプトを表示せずに自動的に決定されました。

1066 * `"hook"`: `PreToolUse` または `PermissionRequest` フックが決定を返したもの。1068 

1067 * `"user_permanent"`: ユーザーが権限プロンプトで「Yes, and don't ask again for ...」を選択したときに出力されます。この選択により、ユーザーの個人設定に許可ルールが保存されます。対話型 CLI では、その選択自体に対してのみ出力され、保存されたルールに一致する以降の呼び出しでは代わりに `"config"` が出力されます。Agent SDK または非対話型の `-p` セッションでは、最初の選択と以降のルール一致の両方で `"user_permanent"` が出力されます。承認として扱われます。1069 * プロジェクト設定

1068 * `"user_temporary"`: ユーザーが権限プロンプトで 1 回限りの承認として「Yes」を選択した場合、またはファイルの編集や読み取りのプロンプトでセッションの残りの間アクセスを許可するオプションを選択した場合に出力されます。対話型 CLI では選択自体に対してのみ出力され、そのセッションスコープの権限によって許可された以降の呼び出しでは代わりに `"config"` が出力されます。Agent SDK または非対話型の `-p` セッションでは、選択と以降の一致の両方で `"user_temporary"` が出力されます。承認として扱われます。1070 * ユーザーの個人設定の許可ルールまたは拒否ルール

1071 * エンタープライズの管理ポリシー

1072 * `--allowedTools` または `--disallowedTools` フラグ

1073 * アクティブな権限モード

1074 * auto モードの分類器。その判定は同じイベントの `classifier_verdict` に記録されます

1075 * 同じ対話型 CLI セッション内の以前の権限プロンプトで付与された、セッションの残りの期間に対する許可

1076 * ツール自体が本質的に安全であること

1077 

1078 `source` の値は、これらのうちどの発生元が一致したかを示しません。

1079 

1080 権限プロンプトのリクエスト自体が失敗した場合も、Claude Code は `"config"` を報告します。たとえば、Agent SDK の [`canUseTool`](/docs/ja/agent-sdk/typescript#canusetool) コールバックまたは [`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) ツールが無効な結果を返した場合や、リクエストが保留中に入力ストリームが閉じた場合に、このリクエストは失敗します。v2.1.216 より前は、Claude Code はこれらの失敗を `"user_reject"` として報告していました。

1081 * `"hook"`: `PreToolUse` または `PermissionRequest` フックが決定を返しました。

1082 * `"user_permanent"`: ユーザーが権限プロンプトで「Yes, and don't ask again for ...」を選択したときに出力されます。これにより、許可ルールが個人設定に保存されます。対話型 CLI では、その選択自体に対してのみ出力され、保存されたルールに一致する後続の呼び出しでは代わりに `"config"` が出力されます。Agent SDK または非対話型の `-p` セッションでは、最初の選択と後続のルール一致の両方で `"user_permanent"` が出力されます。承認として扱われます。

1083 * `"user_temporary"`: ユーザーが権限プロンプトで 1 回限りの承認として「Yes」を選択したとき、またはファイルの編集や読み取りのプロンプトでセッションの残りの期間アクセスを付与するオプションを選択したときに出力されます。対話型 CLI では、その選択自体に対してのみ出力され、そのセッションスコープの許可によって許可された後続の呼び出しでは代わりに `"config"` が出力されます。Agent SDK または非対話型の `-p` セッションでは、選択と後続の一致の両方で `"user_temporary"` が出力されます。承認として扱われます。

1069 * `"user_abort"`: ユーザーが応答せずに権限プロンプトを閉じたときに出力されます。Agent SDK および非対話型の `-p` セッションでは、`canUseTool` または `--permission-prompt-tool` の権限リクエストが保留中にターンを中断した場合も含まれます。v2.1.216 より前は、Claude Code はその中断を `"user_reject"` として報告していました。拒否として扱われます。1084 * `"user_abort"`: ユーザーが応答せずに権限プロンプトを閉じたときに出力されます。Agent SDK および非対話型の `-p` セッションでは、`canUseTool` または `--permission-prompt-tool` の権限リクエストが保留中にターンを中断した場合も含まれます。v2.1.216 より前は、Claude Code はその中断を `"user_reject"` として報告していました。拒否として扱われます。

1070 * `"user_reject"`: プロンプトが表示されたときにユーザーが「No」を選択したときに出力されます。対話型 CLI では、その選択自体に対してのみ出力され、ユーザーの個人設定の拒否ルールに一致する呼び出しでは代わりに `"config"` が出力されます。Agent SDK または非対話型の `-p` セッションでは、個人設定の拒否ルールに一致する呼び出しで `"user_reject"` が出力されます。拒否として扱われます。1085 * `"user_reject"`: プロンプトが表示されたときにユーザーが「No」を選択したときに出力されます。対話型 CLI では、その選択自体に対してのみ出力され、ユーザーの個人設定の拒否ルールに一致する呼び出しでは代わりに `"config"` が出力されます。Agent SDK または非対話型の `-p` セッションでは、個人設定の拒否ルールに一致する呼び出しで `"user_reject"` が出力されます。拒否として扱われます。

1071* `tool_parameters`(`OTEL_LOG_TOOL_DETAILS=1` の場合): ツール固有のパラメーターを含む JSON 文字列。[ツール結果イベント](#tool-result-event)と同じ形式ですが、`git_commit_id` などの実行後のフィールドは含まれません。権限決定が `updatedInput` を介してツール入力を書き換えた場合、承認された呼び出しでは値が `tool_result` と異なることがあります。`decision` が `"reject"` の場合にどのコマンドが拒否されたかを確認するには、この属性を使用してください。1086* `classifier_verdict`: 呼び出しに対する auto モードの[分類器](/docs/ja/permission-modes#how-the-classifier-evaluates-actions)の判定、または判定が得られなかった場合に Claude Code が呼び出しを拒否した理由。Claude Code v2.1.301 以降が必要

1072 * `"sdk_host_builtin_mcp"` ツールの場合: ホストアプリケーションがこれらの名前を定義しているため、`OTEL_LOG_TOOL_DETAILS` がオフの場合でも `mcp_server_name` と `mcp_tool_name` が含まれます。これらがなければ、これらの組み込みサーバーへの拒否された呼び出しをデフォルトのストリームで特定できなくなります。ユーザーが設定した MCP サーバーの場合、イベントの `tool_name` は常にリテラルの `"mcp_tool"` であり、サーバー名とツール名はフラグがオンの場合にのみ `tool_parameters` に表示されます。引数の内容はどの場合もフラグが必要です。Claude Code v2.1.214 以降が必要です1087 

1073 * Bash ツールの場合: `bash_command`、`full_command`、`timeout`、`description`、`dangerouslyDisableSandbox` を含みます。デスクトップアプリのワークスペース Bash ツールも `tool_name` を `Bash` として報告しますが、`bash_command`、`full_command`、`timeout` のみを含みます1088 * `"allow"`: 分類器が呼び出しを承認しました

1089 * `"block"`: 分類器が呼び出しをブロックしました。途中で失敗した分類器のチェックも `"block"` で終わることがあるため、分類器の部分的な障害は `"unavailable"` ではなくブロックの増加として現れることがあります

1090 * `"no_verdict"`: チェックは実行されましたが[使用可能な判定が得られなかった](/docs/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action)ため、Claude Code が呼び出しを拒否しました。この拒否は、分類器が呼び出しを安全でないと判断したことを意味するものではありません

1091 * `"unavailable"`: レート制限、タイムアウト、接続エラーなどにより分類器へのリクエストが失敗したため、Claude Code が呼び出しを拒否しました。[サーバー側の分類器レビュー](/docs/ja/permission-modes#server-side-classifier-review)では、[サーバーが安全性の判定を返さなかった](/docs/ja/errors#the-server-returned-no-safety-verdict)ために拒否された呼び出しにもこの値が付きます

1092 

1093 [分類器が plan モードでコマンドをレビューする](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)場合は、plan モードの呼び出しにもこの属性が含まれます。次の場合、この属性は含まれません。

1094 

1095 * 許可または拒否の[権限ルール](/docs/ja/permissions#manage-permissions)が呼び出しを決定した場合

1096 * Claude Code が分類器に問い合わせずに auto モードで呼び出しを承認した場合

1097 * [ブロックが繰り返された](/docs/ja/permission-modes#repeated-block-thresholds)後に Claude Code が表示したプロンプトにユーザーが応答した場合

1098 * `--permission-prompt-tool` なしの `-p` 実行で、プロンプトに応答する人がいないため、ブロックが繰り返された後に Claude Code が呼び出しを拒否した場合。そのイベントは `decision` を `"reject"`、`source` を `"config"` として報告します

1099* `classifier_category`(`OTEL_LOG_TOOL_DETAILS=1` の場合): 分類器が呼び出しをブロックしたときに挙げた[組み込みルール](/docs/ja/auto-mode-config#inspect-the-defaults-and-your-effective-config)の名前。小文字とアンダースコアで表され、Data Exfiltration ルールの場合は `"data_exfiltration"` のようになります。Claude Code v2.1.301 以降が必要です。この属性は、次のすべてが成り立つ場合に含まれます。

1100 * `classifier_verdict` が `"block"` である

1101 * [サーバー側の分類器レビュー](/docs/ja/permission-modes#server-side-classifier-review)を使用せず、Claude Code 自体が分類器のリクエストを送信した

1102 * 分類器がちょうど 1 つのルールを挙げ、そのルールがユーザーが作成したものではなく組み込みのものである

1103* `permission_mode`: この呼び出しの権限チェックが開始された時点でアクティブだった[権限モード](/docs/ja/permission-modes)。`"default"`、`"plan"`、`"acceptEdits"`、`"bypassPermissions"`、`"dontAsk"`、`"auto"` のいずれか。手動モードは `"default"` として表示されます。[サブエージェント](/docs/ja/sub-agents#permission-modes)の呼び出しは、セッションの権限モードではなくサブエージェントの権限モードを報告します。Claude Code v2.1.301 以降が必要

1104* `tool_parameters`(`OTEL_LOG_TOOL_DETAILS=1` の場合): ツール固有のパラメーターを含む JSON 文字列。[ツール結果イベント](#tool-result-event)と同じ形式ですが、`git_commit_id` などの実行後のフィールドは含まれません。権限の決定が `updatedInput` を介してツール入力を書き換えた場合、承認された呼び出しの値は `tool_result` と異なることがあります。`decision` が `"reject"` の場合に、どのコマンドが拒否されたかを確認するにはこの属性を使用してください。

1105 * `"sdk_host_builtin_mcp"` ツールの場合: ホストアプリケーションがこれらの名前を定義しているため、`OTEL_LOG_TOOL_DETAILS` がオフでも `mcp_server_name` と `mcp_tool_name` が含まれます。これらがなければ、これらの組み込みサーバーのいずれかに対する拒否された呼び出しは、デフォルトのストリーム上で帰属先を特定できなくなります。ユーザーが設定した MCP サーバーの場合、イベントの `tool_name` は常にリテラルの `"mcp_tool"` であり、サーバー名とツール名はフラグがオンの場合にのみ `tool_parameters` に表示されます。引数の内容にはどの場合でもフラグが必要です。

1106 * Bash ツールの場合: `bash_command`、`full_command`、`timeout`、`description`、`dangerouslyDisableSandbox` を含みます。デスクトップアプリのワークスペース bash ツールも `tool_name` を `Bash` として報告しますが、`bash_command`、`full_command`、`timeout` のみを含みます

1074 * MCP ツールの場合: `mcp_server_name`、`mcp_tool_name` を含みます1107 * MCP ツールの場合: `mcp_server_name`、`mcp_tool_name` を含みます

1075 * Skill ツールの場合: `skill_name` を含みます1108 * Skill ツールの場合: `skill_name` を含みます

1076 * Agent ツールまたは従来の Task ツールの場合: `subagent_type` を含みます1109 * Agent ツールまたはレガシーの Task ツールの場合: `subagent_type` を含みます

1077 1110 

1078<h4 id="permission-mode-changed-event">1111<h4 id="permission-mode-changed-event">

1079 権限モード変更イベント1112 権限モード変更イベント


1081 1114 

1082権限モードが変更されたときにログに記録されます。たとえば、`Shift+Tab` による切り替え、plan モードの終了、auto モードのゲートチェックなどです。1115権限モードが変更されたときにログに記録されます。たとえば、`Shift+Tab` による切り替え、plan モードの終了、auto モードのゲートチェックなどです。

1083 1116 

1117ツール呼び出しを、それぞれがチェックされた時点の権限モードでグループ化するには、[ツール決定イベント](#tool-decision-event)の `permission_mode` を使用してください。

1118 

1084**イベント名**: `claude_code.permission_mode_changed`1119**イベント名**: `claude_code.permission_mode_changed`

1085 1120 

1086**属性**:1121**属性**:


1091* `event.sequence`: イベントを順序付けるためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes)で説明しています1126* `event.sequence`: イベントを順序付けるためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes)で説明しています

1092* `from_mode`: 以前の権限モード。例: `"default"`、`"plan"`、`"acceptEdits"`、`"auto"`、`"bypassPermissions"`1127* `from_mode`: 以前の権限モード。例: `"default"`、`"plan"`、`"acceptEdits"`、`"auto"`、`"bypassPermissions"`

1093* `to_mode`: 新しい権限モード1128* `to_mode`: 新しい権限モード

1094* `trigger`: 変更の原因。`"shift_tab"`、`"exit_plan_mode"`、`"auto_gate_denied"`、`"auto_opt_in"` のいずれか。SDK が [`setPermissionMode()`](/docs/ja/agent-sdk/typescript#query-object) を通じて権限モードを設定した場合など、一部の変更では含まれません1129* `trigger`: 変更の原因。`"shift_tab"`、`"exit_plan_mode"`、`"auto_gate_denied"` など。SDK が [`setPermissionMode()`](/docs/ja/agent-sdk/typescript#query-object) を通じて権限モードを設定した場合など、一部の変更では含まれません

1095 1130 

1096<h4 id="auth-event">1131<h4 id="auth-event">

1097 認証イベント1132 認証イベント


1402* `total_tool_uses`: サブエージェントが実行全体で行ったツール呼び出しの数1437* `total_tool_uses`: サブエージェントが実行全体で行ったツール呼び出しの数

1403* `duration_ms`: 実行時間(ミリ秒)1438* `duration_ms`: 実行時間(ミリ秒)

1404* `model`: サブエージェントの実行に解決されたモデル1439* `model`: サブエージェントの実行に解決されたモデル

1405* `final_model`: サブエージェントの最終応答を生成したモデル。フォールバックなど実行途中で切り替えがあった場合は `model` と異なります。Claude Code v2.1.212 以降が必要です1440* `final_model`: サブエージェントの最終的な応答を生成したモデル。フォールバックなど実行途中での切り替えがあった場合、`model` とは異なります

1406* `model_swapped`: サブエージェントのリクエストを複数のモデルが処理したかどうか。Claude Code v2.1.212 以降が必要です1441* `model_swapped`: 複数のモデルがサブエージェントのリクエストを処理したかどうか

1407* `plugin_id_hash`、`plugin.name`: プラグインが提供するエージェントの場合に存在します。公式マーケットプレイスのプラグイン名はそのまま表示されます。その他のプラグイン名は、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `"third-party"` に置き換えられます1442* `plugin_id_hash`、`plugin.name`: プラグインが提供するエージェントの場合に存在します。公式マーケットプレイスのプラグイン名はそのまま表示されます。その他のプラグイン名は、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `"third-party"` に置き換えられます

1408 1443 

1409<h4 id="feedback-survey-event">1444<h4 id="feedback-survey-event">


1548 コストメトリクスは概算です。公式な請求データについては、API プロバイダー (Claude Console、Amazon Bedrock、または Google Cloud の Agent Platform) を参照してください。1583 コストメトリクスは概算です。公式な請求データについては、API プロバイダー (Claude Console、Amazon Bedrock、または Google Cloud の Agent Platform) を参照してください。

1549</Note>1584</Note>

1550 1585 

1551Claude Code は、`ANTHROPIC_BASE_URL` の背後にあるゲートウェイまたはプロキシが複数のフレーム全体で使用状況をプログレッシブにストリーミングする場合を含め、各ストリーミングレスポンスをコストおよびトークンメトリクスに対して正確に 1 回カウントします。v2.1.214 より前では、複数のフレームで使用状況を含むストリームは、`claude_code.cost.usage` と `claude_code.token.usage` を追加フレームごとにおよそ 1 つの追加フルリクエスト分だけ増加させました。1586Claude Code は、`ANTHROPIC_BASE_URL` の背後にあるゲートウェイまたはプロキシが複数のフレーム全体で使用状況をプログレッシブにストリーミングする場合を含め、各ストリーミングレスポンスをコストおよびトークンメトリクスに対して正確に 1 回カウントします。

1552 1587 

1553<h3 id="alerting-and-segmentation">1588<h3 id="alerting-and-segmentation">

1554 アラートとセグメンテーション1589 アラートとセグメンテーション


1570 1605 

1571Claude Code は失敗した API リクエストを内部的に再試行し、あきらめた後にのみ単一の `claude_code.api_error` イベントを出力するため、イベント自体がそのリクエストの終端信号です。中間再試行試行は個別のイベントとしてログされません。1606Claude Code は失敗した API リクエストを内部的に再試行し、あきらめた後にのみ単一の `claude_code.api_error` イベントを出力するため、イベント自体がそのリクエストの終端信号です。中間再試行試行は個別のイベントとしてログされません。

1572 1607 

1573イベントの `attempt` 属性は、試行回数を記録します。`CLAUDE_CODE_MAX_RETRIES` はデフォルトで 10 で、15 で上限です。v2.1.199 以降では、`CLAUDE_CODE_RETRY_WATCHDOG` を設定してデフォルトを引き上げ、上限を削除できます。1608イベントの `attempt` 属性は、試行回数を記録します。`CLAUDE_CODE_MAX_RETRIES` はデフォルトで 10 で、15 で上限です。[`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ja/env-vars) を設定すると、デフォルトはより高くなり、上限はなくなります。

1574 1609 

1575リクエストが一時的なエラーのすべての再試行を枯渇させた場合、`attempt` は最大でもその有効な制限より 1 つ多い値になります: デフォルトでは 11 です。1610リクエストが一時的なエラーのすべての再試行を枯渇させた場合、`attempt` は最大でもその有効な制限より 1 つ多い値になります: デフォルトでは 11 です。

1576 1611 


1646 1681 

1647`OTEL_LOG_TOOL_DETAILS` がない場合、これらのイベントは識別詳細を削除します:1682`OTEL_LOG_TOOL_DETAILS` がない場合、これらのイベントは識別詳細を削除します:

1648 1683 

1649* `tool_result`:`mcp_server_scope` と、ユーザー設定サーバーの場合はリテラル `"mcp_tool"` に編集された `tool_name` を保持し、引数コンテンツを省略します。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、`tool_parameters` 内の `mcp_server_name`/`mcp_tool_name` ペアも保持します。これは `tool_decision` と同じホスト作成例外です。Claude Code v2.1.214 以降が必要です1684* `tool_result`:`mcp_server_scope` と、ユーザー設定サーバーの場合はリテラル `"mcp_tool"` に編集された `tool_name` を保持し、引数コンテンツを省略します。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、`tool_parameters` 内の `mcp_server_name`/`mcp_tool_name` ペアも保持します。これは `tool_decision` と同じホスト作成例外です

1650* `tool_decision`:`tool_source` と、ユーザー設定サーバーの場合はリテラル `"mcp_tool"` に編集された `tool_name` を保持し、引数コンテンツを省略します。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、`tool_parameters` 内の `mcp_server_name`/`mcp_tool_name` ペアも保持します。`tool_source` と名前ペアの両方に Claude Code v2.1.214 以降が必要です1685* `tool_decision`:`tool_source` と、ユーザー設定サーバーの場合はリテラル `"mcp_tool"` に編集された `tool_name` を保持し、引数コンテンツを省略します。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、`tool_parameters` 内の `mcp_server_name`/`mcp_tool_name` ペアも保持します

1651* `mcp_server_connection`:`server_name` とエラーメッセージを省略しますが、`is_plugin`、`plugin_id_hash`、および `plugin.name` を保持し、Anthropic 以外のプラグイン名はリテラル `"third-party"` に編集されるため、プラグイン提供サーバーは詳細ログなしで区別可能なままです1686* `mcp_server_connection`:`server_name` とエラーメッセージを省略しますが、`is_plugin`、`plugin_id_hash`、および `plugin.name` を保持し、Anthropic 以外のプラグイン名はリテラル `"third-party"` に編集されるため、プラグイン提供サーバーは詳細ログなしで区別可能なままです

1652 1687 

1653<h3 id="map-security-questions-to-events">1688<h3 id="map-security-questions-to-events">


1658 1693 

1659| シグナル | イベント | キー属性 |1694| シグナル | イベント | キー属性 |

1660| - | - | - |1695| - | - | - |

1661| ツール呼び出しが許可または拒否され、何によって | `tool_decision` | `decision`、`source`、`tool_name`、`tool_parameters` |1696| ツール呼び出しが許可または拒否されたこと、およびルール、フック、ユーザーなど、その決定の出所 | [`tool_decision`](#tool-decision-event) | `decision`、`source`、`classifier_verdict`、`permission_mode`、`tool_name`;`OTEL_LOG_TOOL_DETAILS=1` を設定した場合は `tool_parameters` |

1697| auto モードの分類器がツール呼び出しを許可またはブロックした、または Claude Code が分類器の判定なしに呼び出しを拒否した | `classifier_verdict` が存在する [`tool_decision`](#tool-decision-event)。判定なしの拒否の場合、`classifier_verdict` は `"no_verdict"` または `"unavailable"` です | `classifier_verdict`、`permission_mode`、`tool_name`;`OTEL_LOG_TOOL_DETAILS=1` を設定した場合は `classifier_category` |

1662| 権限モードのエスカレーション | `permission_mode_changed` | `from_mode`、`to_mode`、`trigger` |1698| 権限モードのエスカレーション | `permission_mode_changed` | `from_mode`、`to_mode`、`trigger` |

1699| サブエージェントによる呼び出しを含め、各ツール呼び出しがどの権限モードでチェックされたか | [`tool_decision`](#tool-decision-event) | `permission_mode`、`session.id` |

1663| ポリシーフックがアクションをブロック | `hook_execution_complete` | `hook_event`、`num_blocking` |1700| ポリシーフックがアクションをブロック | `hook_execution_complete` | `hook_event`、`num_blocking` |

1664| ログイン、ログアウト、認証失敗 | `auth` | `action`、`success`、`error_category` |1701| ログイン、ログアウト、認証失敗 | `auth` | `action`、`success`、`error_category` |

1665| MCP サーバー接続または失敗 | `mcp_server_connection` | `status`、`server_name`、`is_plugin`、`error_code` |1702| MCP サーバー接続または失敗 | `mcp_server_connection` | `status`、`server_name`、`is_plugin`、`error_code` |


1824 1861 

1825 * 詳細なベータトレースでは、スパンには各リクエストとともに送信される新しいユーザーメッセージ、ツール結果、システムリマインダーに加えて、システムプロンプトテキストとモデル出力も含まれます。各属性は[詳細なベータトレースにおけるコンテンツ属性](#new-context-gates)に記載されています。`claude_code.system_prompt` イベントは完全なシステムプロンプトを含みます1862 * 詳細なベータトレースでは、スパンには各リクエストとともに送信される新しいユーザーメッセージ、ツール結果、システムリマインダーに加えて、システムプロンプトテキストとモデル出力も含まれます。各属性は[詳細なベータトレースにおけるコンテンツ属性](#new-context-gates)に記載されています。`claude_code.system_prompt` イベントは完全なシステムプロンプトを含みます

1826* アシスタント応答テキストはデフォルトでは収集されません。応答長のみが記録されます。応答テキストを含めるには、`OTEL_LOG_ASSISTANT_RESPONSES=1` を設定してください。Claude Code からのすべての OpenTelemetry データと同様に、応答テキストは設定した OTel エンドポイントにのみ送信され、Anthropic には送信されません。この変数が設定されていない場合、`OTEL_LOG_USER_PROMPTS` がフォールバックとして使用されるため、イベントで応答コンテンツなしでプロンプトコンテンツが必要な場合は `OTEL_LOG_ASSISTANT_RESPONSES=0` を設定してください。詳細なベータトレースでは、`claude_code.llm_request` スパンは引き続き [`response.model_output`](#new-context-gates) にモデル出力を含みます。これはこの変数ではなく `OTEL_LOG_USER_PROMPTS` に従います1863* アシスタント応答テキストはデフォルトでは収集されません。応答長のみが記録されます。応答テキストを含めるには、`OTEL_LOG_ASSISTANT_RESPONSES=1` を設定してください。Claude Code からのすべての OpenTelemetry データと同様に、応答テキストは設定した OTel エンドポイントにのみ送信され、Anthropic には送信されません。この変数が設定されていない場合、`OTEL_LOG_USER_PROMPTS` がフォールバックとして使用されるため、イベントで応答コンテンツなしでプロンプトコンテンツが必要な場合は `OTEL_LOG_ASSISTANT_RESPONSES=0` を設定してください。詳細なベータトレースでは、`claude_code.llm_request` スパンは引き続き [`response.model_output`](#new-context-gates) にモデル出力を含みます。これはこの変数ではなく `OTEL_LOG_USER_PROMPTS` に従います

1827* ツール入力引数とパラメータはデフォルトではログに記録されません。これらを含めるには、`OTEL_LOG_TOOL_DETAILS=1` を設定してください。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、`tool_decision` と `tool_result` は `mcp_server_name`/`mcp_tool_name` ペアを含みます。これはホストが作成した名前であり、フラグがオフの場合でも引数コンテンツではありません。この例外には Claude Code v2.1.214 以降が必要です。このデータは設定した OTEL エンドポイントにのみ送信され、Anthropic には送信されません。引数には機密値が含まれる可能性があるため、テレメトリバックエンドを設定してこれらの属性をフィルタリングまたは編集してください。有効にすると:1864* ツール入力引数とパラメータはデフォルトではログに記録されません。これらを含めるには、`OTEL_LOG_TOOL_DETAILS=1` を設定してください。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、`tool_decision` と `tool_result` は `mcp_server_name`/`mcp_tool_name` ペアを含みます。これはホストが作成した名前であり、フラグがオフの場合でも引数コンテンツではありません。このデータは設定した OTEL エンドポイントにのみ送信され、Anthropic には送信されません。引数には機密値が含まれる可能性があるため、テレメトリバックエンドを設定してこれらの属性をフィルタリングまたは編集してください。有効にすると:

1828 * `tool_result` と `tool_decision` イベントには、Bash コマンド、MCP サーバーとツール名、およびスキル名を含む `tool_parameters` 属性が含まれます。`full_command` などのフィールドは切り詰められずに出力されます1865 * `tool_result` と `tool_decision` イベントには、Bash コマンド、MCP サーバーとツール名、およびスキル名を含む `tool_parameters` 属性が含まれます。`full_command` などのフィールドは切り詰められずに出力されます

1829 * `tool_result` イベントには、ファイルパス、URL、検索パターン、およびその他の引数を含む `tool_input` 属性も含まれます。512 文字を超える個別の値は切り詰められ、合計は約 4 K 文字に制限されます1866 * `tool_result` イベントには、ファイルパス、URL、検索パターン、およびその他の引数を含む `tool_input` 属性も含まれます。512 文字を超える個別の値は切り詰められ、合計は約 4 K 文字に制限されます

1830 * `user_prompt` イベントには、カスタム、プラグイン、および MCP コマンドの逐語的な `command_name` が含まれます1867 * `user_prompt` イベントには、カスタム、プラグイン、および MCP コマンドの逐語的な `command_name` が含まれます

Details

223* `CLAUDE_STREAM_IDLE_TIMEOUT_MS` は両方のウォッチドッグのタイムアウトを設定します。Claude Code は 5 分未満の値を 5 分に引き上げ、バイトレベルのウォッチドッグについては値の上限を 30 分とします。223* `CLAUDE_STREAM_IDLE_TIMEOUT_MS` は両方のウォッチドッグのタイムアウトを設定します。Claude Code は 5 分未満の値を 5 分に引き上げ、バイトレベルのウォッチドッグについては値の上限を 30 分とします。

224* `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` は、イベントレベルのウォッチドッグのタイムアウトを変更せずに、バイトレベルのウォッチドッグのタイムアウトを設定します。値は 10 秒から 30 分の範囲に制限され、そのウォッチドッグについては `CLAUDE_STREAM_IDLE_TIMEOUT_MS` より優先されます。224* `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` は、イベントレベルのウォッチドッグのタイムアウトを変更せずに、バイトレベルのウォッチドッグのタイムアウトを設定します。値は 10 秒から 30 分の範囲に制限され、そのウォッチドッグについては `CLAUDE_STREAM_IDLE_TIMEOUT_MS` より優先されます。

225* `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` はファーストバイト期限を直接設定します。未設定の場合、Claude Code はバイトレベルのウォッチドッグのタイムアウトを使用するため、`CLAUDE_STREAM_IDLE_TIMEOUT_MS` と `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` によって期限も変わります。値の制限範囲、アップロード分の加算、`API_TIMEOUT_MS` による上限、応答なしで中止された後に再試行が待機する時間については、[No response from API](/docs/ja/errors#no-response-from-api) を参照してください。225* `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` はファーストバイト期限を直接設定します。未設定の場合、Claude Code はバイトレベルのウォッチドッグのタイムアウトを使用するため、`CLAUDE_STREAM_IDLE_TIMEOUT_MS` と `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` によって期限も変わります。値の制限範囲、アップロード分の加算、`API_TIMEOUT_MS` による上限、応答なしで中止された後に再試行が待機する時間については、[No response from API](/docs/ja/errors#no-response-from-api) を参照してください。

226* `API_TIMEOUT_MS` はレスポンスヘッダーの待機時間を制限します。Claude apps gateway セッションなど、ファーストバイト期限が実行されない場合は、応答のないリクエストをより早く再試行するために、この値を `300000`(5 分)未満に設定します。ただし、想定されるヘッダーの最長待機時間や最長の[非ストリーミングリクエスト](/docs/ja/errors#streaming-response-ended-before-any-complete-data-was-received)よりも大きい値にしてください。それより長い時間を要するリクエストは、再試行のたびに再びタイムアウトします。226* `API_TIMEOUT_MS` はレスポンスヘッダーの待機時間を制限するもので、ヘッダー受信後に応答がストリーミングされる時間を制限するものではありません。Claude apps gateway セッションなど、ファーストバイト期限が実行されない場合は、応答のないリクエストをより早く再試行するために、この値を `300000`(5 分)未満に設定します。ただし、想定されるヘッダーの最長待機時間や最長の[非ストリーミングリクエスト](/docs/ja/errors#streaming-response-ended-before-any-complete-data-was-received)よりも大きい値にしてください。それより長い時間を要するリクエストは、再試行のたびに再びタイムアウトします。

227* `API_FORCE_IDLE_TIMEOUT` を `0` に設定するとボディアイドルタイムアウトがオフになり、`1` に設定するとすべてのプロバイダーでオンになります。ウォッチドッグはこの設定とは独立して実行されるため、ストリームがウォッチドッグのしきい値より長く一時停止できるようにするには、ウォッチドッグのタイムアウトも引き上げるか無効にしてください。227* `API_FORCE_IDLE_TIMEOUT` を `0` に設定するとボディアイドルタイムアウトがオフになり、`1` に設定するとすべてのプロバイダーでオンになります。ウォッチドッグはこの設定とは独立して実行されるため、ストリームがウォッチドッグのしきい値より長く一時停止できるようにするには、ウォッチドッグのタイムアウトも引き上げるか無効にしてください。

228 228 

229ウォッチドッグが停止したストリームを中止すると、Claude Code はその中止をストリーム途中の失敗として扱い、表示される内容は応答がどこまで進んでいたかによって異なります。Claude Code はリクエストを再試行するかエラーでターンを終了するか、完了した出力を保持して[不完全な応答の通知](/docs/ja/errors#the-response-above-may-be-incomplete)を表示するか、ターンを通常どおり終了します。各結果がどの場合に当てはまるかは、[自動再試行](/docs/ja/errors#automatic-retries)を参照してください。229ウォッチドッグが停止したストリームを中止すると、Claude Code はその中止をストリーム途中の失敗として扱い、表示される内容は応答がどこまで進んでいたかによって異なります。Claude Code はリクエストを再試行するかエラーでターンを終了するか、完了した出力を保持して[不完全な応答の通知](/docs/ja/errors#the-response-above-may-be-incomplete)を表示するか、ターンを通常どおり終了します。各結果がどの場合に当てはまるかは、[自動再試行](/docs/ja/errors#automatic-retries)を参照してください。

Details

86| Claude Code の実行方法 | 組み込み開始権限モード |86| Claude Code の実行方法 | 組み込み開始権限モード |

87| :- | :- |87| :- | :- |

88| 設定ファイルが `disableAutoMode` を `"disable"` に設定 | `default` |88| 設定ファイルが `disableAutoMode` を `"disable"` に設定 | `default` |

89| `claude -p` または [Agent SDK](/docs/ja/agent-sdk/permissions#permission-modes) | [フィーチャーフラグを取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)するセッションでは `default`。テレメトリがオフの場合やサードパーティプロバイダーなど、フィーチャーフラグを取得しないセッションでは、Claude Code v2.1.285 以降では `auto`、以前のバージョンでは `default`。`auto` デフォルトを保留するポリシーを持つ組織内のセッションは、代わりに `default` で開始します |89| `claude -p` または [Agent SDK](/docs/ja/agent-sdk/permissions#permission-modes) | `default` |

90| 組織に [HIPAA 設定](#hipaa-configuration)が適用されており、セッションが[その対象](/docs/ja/hipaa-setup#check-how-developers-sign-in-and-connect)である | Claude Code v2.1.285 以降では `default`。auto モードへの切り替えは引き続き可能です |90| 組織に [HIPAA 設定](#hipaa-configuration)が適用されており、セッションが[その対象](/docs/ja/hipaa-setup#check-how-developers-sign-in-and-connect)である | Claude Code v2.1.285 以降では `default`。auto モードへの切り替えは引き続き可能です |

91| ターミナルまたは [VS Code 拡張機能](/docs/ja/vs-code)を通じて | Claude Code v2.1.283 以降では `auto`。以前のバージョンでは、Pro、Max、または Team プランで [フィーチャーフラグを取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)するセッションでは `auto`、それ以外は `default` |91| ターミナルまたは [VS Code 拡張機能](/docs/ja/vs-code)を通じて | Claude Code v2.1.283 以降では `auto`。以前のバージョンでは、Pro、Max、または Team プランで [フィーチャーフラグを取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)するセッションでは `auto`、それ以外は `default` |

92 92 

93[インストールまたはアップグレード後の最初のセッション](/docs/ja/env-vars#first-session-after-an-install-or-upgrade)では、Claude Code はフィーチャーフラグが到達する前に開始権限モードを選択できます。そのセッションは表が示すものとは異なる権限モードで開始する可能性があります。

94 

95フラグ、設定ファイル、または組み込みデフォルトが `auto` を選択しても、auto モードがセッションで利用できない場合、Claude Code はセッションを Manual で開始します。Auto モードは、セッションが [利用可能性要件](#eliminate-prompts-with-auto-mode)を満たさない場合(設定ファイルがそれをオフにするか、サポートしていないモデルなど)、または Anthropic がサーバー側で一時的にそれをオフにした場合に利用できません。93フラグ、設定ファイル、または組み込みデフォルトが `auto` を選択しても、auto モードがセッションで利用できない場合、Claude Code はセッションを Manual で開始します。Auto モードは、セッションが [利用可能性要件](#eliminate-prompts-with-auto-mode)を満たさない場合(設定ファイルがそれをオフにするか、サポートしていないモデルなど)、または Anthropic がサーバー側で一時的にそれをオフにした場合に利用できません。

96 94 

97組み込みデフォルトが初めてセッションを auto モードで開始するとき、Claude Code はこのページにリンクする通知を表示します。95組み込みデフォルトが初めてセッションを auto モードで開始するとき、Claude Code はこのページにリンクする通知を表示します。


101 99 

102`~/.claude/settings.json` が `auto` 以外の `defaultMode` を設定し、他の設定ファイルが設定しない場合、セッションはそのモードで開始し続けます。Pro、Max、Team プランおよび [フィーチャーフラグを取得しない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッションでは、Claude Code はターミナルまたは VS Code 拡張機能で 1 回、設定を auto モードに変更するかどうかを尋ねます。却下した場合、設定はそのままです。100`~/.claude/settings.json` が `auto` 以外の `defaultMode` を設定し、他の設定ファイルが設定しない場合、セッションはそのモードで開始し続けます。Pro、Max、Team プランおよび [フィーチャーフラグを取得しない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッションでは、Claude Code はターミナルまたは VS Code 拡張機能で 1 回、設定を auto モードに変更するかどうかを尋ねます。却下した場合、設定はそのままです。

103 101 

102<h3 id="which-mode-a-non-interactive-run-starts-in">

103 `claude -p` と Agent SDK の実行で拒否されるツール呼び出し

104</h3>

105 

106Claude Code v2.1.302 以降では、[権限モードが設定されていない](#which-mode-a-session-starts-in) `claude -p` および [Agent SDK](/docs/ja/agent-sdk/permissions#permission-modes) の実行は Manual モードで開始します。このモードは SDK オプションと設定では `default` として表示されます。承認が必要な呼び出しは、許可ルール、フック、`canUseTool` コールバック、または `--permission-prompt-tool` で承認しない限り拒否されます。

107 

108これらの呼び出しが承認されるようにするには、許可ルールを追加するか、auto モードで開始します。

109 

110* **[許可ルールを追加する](/docs/ja/permissions#manage-permissions)**: Claude は列挙した呼び出しを実行します。`claude -p` に [`--allowedTools "Bash(npm test)"`](/docs/ja/headless#auto-approve-tools) を渡すか、SDK の [allowed-tools オプション](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を設定します。

111* **[auto モード](#eliminate-prompts-with-auto-mode)で開始する**: 分類器モデルが呼び出しをレビューするため、事前に何も列挙する必要はありません。`claude -p` に `--permission-mode auto` を渡すか、SDK の [権限モードオプション](/docs/ja/agent-sdk/permissions#set-permission-mode)を設定します。

112 

113以下の例は、CLI と各 SDK での auto モードの指定方法を示しています。

114 

115<Tabs>

116 <Tab title="CLI">

117 ```bash theme={null}

118 claude -p "Run the test suite and fix any failures" --permission-mode auto

119 ```

120 </Tab>

121 

122 <Tab title="TypeScript">

123 ```typescript theme={null}

124 const options = {

125 permissionMode: "auto"

126 };

127 ```

128 </Tab>

129 

130 <Tab title="Python">

131 ```python theme={null}

132 from claude_agent_sdk import ClaudeAgentOptions

133 

134 options = ClaudeAgentOptions(permission_mode="auto")

135 ```

136 </Tab>

137</Tabs>

138 

139v2.1.302 より前は、[フィーチャーフラグを取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)しない場合、例えば[サードパーティプロバイダー](/docs/ja/third-party-integrations)上や `DISABLE_TELEMETRY` を使用している場合に、これらの実行が auto モードで開始することがありました。

140 

104<h3 id="start-in-a-different-mode">141<h3 id="start-in-a-different-mode">

105 異なる権限モードで開始する142 異なる権限モードで開始する

106</h3>143</h3>


216 </Tab>253 </Tab>

217 254 

218 <Tab title="Desktop">255 <Tab title="Desktop">

219 **セッション中**:Code タブで、送信ボタンの横にあるモードセレクターを使用します。すべてのモードがセレクターに表示されるわけではありません。256 **セッション中**:Code タブで、プロンプトボックスの下の行にあるモードセレクターを使用します。すべてのモードがセレクターに表示されるわけではありません。

220 257 

221 * **Auto**:[auto モードが利用可能](#eliminate-prompts-with-auto-mode)な場合に表示されます258 * **Auto**:[auto モードが利用可能](#eliminate-prompts-with-auto-mode)な場合に表示されます

222 * **Bypass permissions**:Pro と Max プランの Desktop 設定で **Allow bypass permissions mode** トグルが必要です。Team と Enterprise プランでは、組織ポリシーがそれを制御します259 * **Bypass permissions**:Pro と Max プランの Desktop 設定で **Allow bypass permissions mode** トグルが必要です。Team と Enterprise プランでは、組織ポリシーがそれを制御します


345 Bedrock、Agent Platform、または Foundry での auto モード382 Bedrock、Agent Platform、または Foundry での auto モード

346</h3>383</h3>

347 384 

348[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、およびサインイン済みの [Claude apps gateway](/docs/ja/claude-apps-gateway) セッションでは、auto モードはデフォルトで利用可能です。他に権限モードを設定するものがない場合、そのセクションの表に記載されているバージョンでは、[組み込みの開始権限モード](#which-mode-a-session-starts-in)でもあります。開始権限モードを自分で選択するには、[別の権限モードで開始する](#start-in-a-different-mode)の説明に従って `permissions.defaultMode` を設定するか、VS Code 拡張機能のモードインジケーターから権限モードを選択します。385[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、およびサインイン済みの [Claude apps gateway](/docs/ja/claude-apps-gateway) セッションでは、auto モードはデフォルトで利用可能です。そこで権限モードを設定しない場合、インタラクティブなセッションは auto モードで開始し、`claude -p` や Agent SDK の実行は Manual モード(設定値は `default`)で開始します。

386 

387* **インタラクティブなターミナルセッションと VS Code セッション**: auto 以外の権限モードで開始するには、[別の権限モードで開始する](#start-in-a-different-mode)の説明に従って `permissions.defaultMode` を設定するか、VS Code 拡張機能の[モードインジケーター](#switch-permission-modes)から権限モードを選択します。これらのセッションを auto モードで開始する Claude Code のバージョンは、[セッションがどのモードで開始するか](#which-mode-a-session-starts-in)に記載されています。

388* **`claude -p` と Agent SDK の実行**: auto モードで開始するには、`claude -p` に `--permission-mode auto` を渡すか、TypeScript では `permissionMode: "auto"`、Python では `permission_mode="auto"` を渡します。権限モードを渡さない場合は、[`claude -p` および Agent SDK の実行でツール呼び出しが拒否される](#which-mode-a-non-interactive-run-starts-in)を参照してください。このセクションでは以前の Claude Code バージョンについても説明しています。

349 389 

350これらのプロバイダーでサポートされているのは、Claude Sonnet 5 以降、Opus 4.7 以降、Haiku 5.5、および Fable モデルのみです。その他のモデルでは、セッションは代わりに Manual で開始します。これらのプロバイダーで Haiku 5.5 を使用して auto モードを利用するには、Claude Code v2.1.293 以降が必要です。390これらのプロバイダーでサポートされているのは、Claude Sonnet 5 以降、Opus 4.7 以降、Haiku 5.5、および Fable モデルのみです。その他のモデルでは、セッションは代わりに Manual で開始します。これらのプロバイダーで Haiku 5.5 を使用して auto モードを利用するには、Claude Code v2.1.293 以降が必要です。

351 391 


368 408 

369サーバーへの依頼をスキップして常に Claude Code 独自の分類器リクエストを使用するには、[`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/ja/env-vars) を設定します。Anthropic API への直接接続では、この変数には Claude Code v2.1.281 以降が必要です。そこで `1` に設定すると、`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` も設定していない限り、まだサーバーレビューが有効になっていないセッションでサーバーレビューがオンになります。`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` を設定して `CLAUDE_CODE_AUTO_MODE_SERVER` を未設定のままにすると、[プレリリース機能を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities)で説明されている場合を除き、Claude Code はサーバーへの依頼も停止します。409サーバーへの依頼をスキップして常に Claude Code 独自の分類器リクエストを使用するには、[`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/ja/env-vars) を設定します。Anthropic API への直接接続では、この変数には Claude Code v2.1.281 以降が必要です。そこで `1` に設定すると、`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` も設定していない限り、まだサーバーレビューが有効になっていないセッションでサーバーレビューがオンになります。`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` を設定して `CLAUDE_CODE_AUTO_MODE_SERVER` を未設定のままにすると、[プレリリース機能を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities)で説明されている場合を除き、Claude Code はサーバーへの依頼も停止します。

370 410 

411<h3 id="default-classifier-model">

412 デフォルトの分類器モデル

413</h3>

414 

415デフォルトでは、分類器リクエストは Claude Sonnet 5 に送信されます。`/status` で `Auto mode server` が `Enabled` と表示されている場合、リクエストは[サーバーのレビュー](#server-side-classifier-review)の対象外の呼び出しに対してのみ送信されます。

416 

417この表で、セッションに一致する最初の行を見つけてください。Sonnet 5 の代わりに、その行のモデルが使用されます。

418 

419| セッション | 分類器モデル |

420| - | - |

421| Anthropic が設定した分類器モデルがある | 設定されたモデル。どのモデルかは[デバッグログを確認](#classifier-model-check)してください |

422| Claude Sonnet 4.6 で実行されている | Sonnet 4.6 |

423| [`ANTHROPIC_DEFAULT_SONNET_MODEL`](/docs/ja/model-config#environment-variables) が設定されている | その値。ただし値が Claude Sonnet 5.5 または Claude Opus 5.5 の場合は Sonnet 5 |

424 

425Sonnet 5 または `ANTHROPIC_DEFAULT_SONNET_MODEL` のモデルがプロバイダーから利用できない場合、または組織の[モデルポリシー](/docs/ja/model-config#restrict-model-selection)で除外されている場合、Claude Code はフォールバックモデルを使用します。これはセッションのモデルであり、[Fable セッション](/docs/ja/model-config#work-with-fable)では Opus モデルです。

426 

427<h3 id="choose-the-classifier-model">

428 分類器モデルを選択する

429</h3>

430 

431Claude Code v2.1.302 以降では、[`CLAUDE_CODE_AUTO_MODE_MODEL`](/docs/ja/env-vars) を完全なモデル ID に設定すると、[デフォルト](#default-classifier-model)以外のモデルで分類器を実行できます。クラウドプロバイダー独自の完全なモデル ID も使用できます。次の `~/.claude/settings.json` の例では Claude Sonnet 4.6 を設定しています。

432 

433```json theme={null}

434{

435 "env": {

436 "CLAUDE_CODE_AUTO_MODE_MODEL": "claude-sonnet-4-6"

437 }

438}

439```

440 

441<h4 id="classifier-model-not-reviewing">

442 指定したモデルがレビューしない場合

443</h4>

444 

445| 状況 | 動作 | 対処方法 |

446| - | - | - |

447| セッションで `/status` に [`Auto mode server`](#server-side-classifier-review) が `Enabled` と表示されている | 指定したモデルは、サーバーがレビューしないものだけをレビューします | 不要 |

448| Claude Opus 5、Claude Sonnet 5.5、Claude Opus 5.5、または組織の[モデルポリシー](/docs/ja/model-config#restrict-model-selection)で除外されているモデルを設定した | [デフォルトの分類器モデル](#default-classifier-model)がレビューします | 別のモデルを設定します |

449| Anthropic がセッション用の分類器モデルを設定した | そのモデルがレビューします | 不要 |

450| プロバイダーがそのモデルを提供できない | リクエストが失敗し、Claude Code は[レビュー対象のすべてのアクションを拒否します](/docs/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action) | プロバイダーが提供するモデルを設定するか、変数を削除します |

451 

452<h4 id="classifier-model-check">

453 分類器が使用したモデルを確認する

454</h4>

455 

456シェルから [`--debug-file`](/docs/ja/cli-reference#cli-flags) を指定して auto モードのセッションを開始します。

457 

458```bash theme={null}

459claude --permission-mode auto --debug-file classifier-debug.log

460```

461 

462Claude に読み取り専用ではないシェルコマンドを実行させてから、ログで `classifier_request_started` を検索します。

463 

464* **`model=` の後に指定したモデルがある**: 変数が有効になっています

465* **`model=` の後に別のモデルがある**: ログで `ignoring CLAUDE_CODE_AUTO_MODE_MODEL` を検索します。理由と必要な手順が示されています

466* **該当する行がない**: Claude Code のプロンプトで `/status` の `Auto mode server` を確認します。

467 * **`Enabled`**: [サーバー](#server-side-classifier-review)がこのセッションの呼び出しをレビューするよう設定されています。変更は不要です。

468 * **`Disabled`**: [権限モード](#switch-permission-modes)が auto であることを確認してから、Claude に読み取り専用ではない別のコマンドを実行させます。

469 

371<h3 id="what-the-classifier-blocks-by-default">470<h3 id="what-the-classifier-blocks-by-default">

372 分類器がデフォルトでブロックするもの471 分類器がデフォルトでブロックするもの

373</h3>472</h3>


384* 共有インフラストラクチャの変更483* 共有インフラストラクチャの変更

385* セッション前から存在していたファイルの不可逆的な破壊484* セッション前から存在していたファイルの不可逆的な破壊

386* Force push485* Force push

387* 実行時にシークレットや機密データをリポジトリの外に送信する、またはデプロイが公開する範囲を広げる変更のコミットまたはプッシュ。これには、まだシークレットを受け取っていない宛先にシークレットを渡す CI ワークフローやデプロイ設定、シークレットストアを読み取ってデータを外部に送信するスクリプトやセットアップ手順、そしてレジストリ、可視性、アーティファクト、ソースマップの設定など、デプロイが公開する範囲を広げる設定変更が含まれます。このチェックはどのブランチにも適用され、リポジトリが公開されている場合でも適用され、そのコミットやプッシュがパイプラインをトリガーするかどうかにかかわらず、変更がコミットまたはプッシュされた時点で発動します。解除するには、コミットやプッシュだけでなく、実行時の影響を明示する必要があります。v2.1.211 より前では、このチェックは代わりにデフォルトブランチに限定されていました。デフォルトブランチへのプッシュは、機密コンテンツを含む場合、依頼内容に対して変更が隠されていたり誤って説明されていたりする場合、リポジトリ外から持ち込まれたコンテンツを含む場合、または依頼したレビューを迂回する場合にブロックされていました486* 実行時にシークレットや機密データをリポジトリの外に送信する、またはデプロイが公開する範囲を広げる変更のコミットまたはプッシュ。これには、まだシークレットを受け取っていない宛先にシークレットを渡す CI ワークフローやデプロイ設定、シークレットストアを読み取ってデータを外部に送信するスクリプトやセットアップ手順、そしてレジストリ、可視性、アーティファクト、ソースマップの設定など、デプロイが公開する範囲を広げる設定変更が含まれます。このチェックはどのブランチにも適用され、リポジトリが公開されている場合でも適用され、そのコミットやプッシュがパイプラインをトリガーするかどうかにかかわらず、変更がコミットまたはプッシュされた時点で発動します。解除するには、コミットやプッシュだけでなく、実行時の影響を明示する必要があります

388* `git reset --hard`、`git checkout -- .`、`git restore .`、`git clean -fd`、`git stash drop`、または `git stash clear`(分類器はコミットされていない変更を破棄するものと推定します)487* `git reset --hard`、`git checkout -- .`、`git restore .`、`git clean -fd`、`git stash drop`、または `git stash clear`(分類器はコミットされていない変更を破棄するものと推定します)

389* HEAD のコミットがこのセッションで作成されたものでない場合の `git commit --amend`488* HEAD のコミットがこのセッションで作成されたものでない場合の `git commit --amend`

390* v2.1.198 以降、HEAD のコミットがすでにプッシュされている場合の `git commit --amend`。メッセージのみの書き換えはブロックされません。これは、Claude がこのセッション中に作成したコミットに対し、新たにステージされたものがない状態で `--amend -m` を実行する場合です489* v2.1.198 以降、HEAD のコミットがすでにプッシュされている場合の `git commit --amend`。メッセージのみの書き換えはブロックされません。これは、Claude がこのセッション中に作成したコミットに対し、新たにステージされたものがない状態で `--amend -m` を実行する場合です


568 </Accordion>667 </Accordion>

569 668 

570 <Accordion title="コストとレイテンシー">669 <Accordion title="コストとレイテンシー">

571 分類器は、`/model` での選択ではなく、デフォルトで Claude Sonnet 5 で実行されます。Anthropic がサーバー側で設定した分類器モデルは、このデフォルトより優先されます。セッションのモデルが Claude Sonnet 4.6 の場合、または [`availableModels`](/docs/ja/model-config#restrict-model-selection) が Sonnet 5 を除外している場合、分類器は代わりにセッションのモデルで実行され、セッションが [Fable モデル](/docs/ja/model-config#work-with-fable)で実行されている場合は Opus モデルで実行されます。Anthropic API 以外のプロバイダーでは、この Opus のフォールバックは [`ANTHROPIC_DEFAULT_OPUS_MODEL`](/docs/ja/model-config#environment-variables) で設定したモデルであり、設定していない場合は Opus 5 です。670 Claude Code の分類器リクエストは、`/model` での選択とは異なるモデルで実行される場合があります。[どのモデルで実行されるか](#default-classifier-model)を参照してください。

572 

573 セッションの最初の auto モードのリクエストで、Sonnet 5 のデフォルトが検証されます。リクエストが成功すれば Sonnet 5 がセッションの分類器モデルとして維持され、モデルが利用できないために失敗した場合は、セッションは代わりにフォールバックを使用します。

574 671 

575 Enterprise プラン、および Claude API、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry を使用するアカウントでは、分類器の呼び出しはトークン使用量にカウントされます。各チェックではトランスクリプトの一部と保留中のアクションが送信され、実行前に往復の通信が 1 回加わります。読み取りと、保護されたパス以外での作業ディレクトリ内の編集は分類器をスキップするため、オーバーヘッドは主にシェルコマンドとネットワーク操作から生じます。サーバーがセッションのモデルリクエストの一部としてアクションをレビューする場合は、カウントされる個別の分類器呼び出しはありません。[サーバー側の分類器レビュー](#server-side-classifier-review)を参照してください。672 Enterprise プラン、および Claude API、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry を使用するアカウントでは、分類器の呼び出しはトークン使用量にカウントされます。各チェックではトランスクリプトの一部と保留中のアクションが送信され、実行前に往復の通信が 1 回加わります。読み取りと、保護されたパス以外での作業ディレクトリ内の編集は分類器をスキップするため、オーバーヘッドは主にシェルコマンドとネットワーク操作から生じます。サーバーがセッションのモデルリクエストの一部としてアクションをレビューする場合は、カウントされる個別の分類器呼び出しはありません。[サーバー側の分類器レビュー](#server-side-classifier-review)を参照してください。

576 673 

permissions.md +164 −164

Details

240 Bash240 Bash

241</h3>241</h3>

242 242 

243Bash 権限ルールはコマンド全体をマッチさせ、`*` は任意のテキストを表します。[ワイルドカードパターン](#wildcard-patterns)は各ルール形状がマッチするコマンドと `*` の配置場所を示しています。このセクションの残りでは、Claude Code が複合コマンドとラッパーをどのようにマッチさせるか、プレフィックスルールで承認できないラッパーと `find` アクション、ルールがマッチしないもの、読み取り専用コマンド、およびリダイレクションについて説明します。243Bash ルールはコマンドテキスト全体に対してマッチし、`*` は任意のテキストを表します。各ルールの形がどのコマンドにマッチするか、また `*` をどこに置くべきかについては、[ワイルドカードパターン](#wildcard-patterns)を参照してください。このセクションの残りの部分では、Claude Code が複合コマンドとラッパーをどのようにマッチさせるか、プレフィックスルールでは承認できないラッパーと `find` アクション、ルールがマッチしないもの、読み取り専用コマンド、およびリダイレクトについて説明します。

244 244 

245<h4 id="compound-commands">245<h4 id="compound-commands">

246 複合コマンド246 複合コマンド

247</h4>247</h4>

248 248 

249<Tip>249<Tip>

250 Claude Code はシェルオペレータを認識しているため、`Bash(safe-cmd *)` のようなルールは、`safe-cmd && other-cmd` コマンドを実行する権限を与えません。認識されるコマンド区切り文字は `&&`、`||`、`;`、`|`、`|&`、`&`、および改行です。ルールは各サブコマンドを独立して個別にマッチさせる必要があります。250 Claude Code はシェル演算子を認識するため、`Bash(safe-cmd *)` のようなルールで `safe-cmd && other-cmd` というコマンドの実行権限が与えられることはありません。認識されるコマンド区切りは `&&`、`||`、`;`、`|`、`|&`、`&`、および改行です。ルールは各サブコマンドに個別にマッチする必要があります。

251</Tip>251</Tip>

252 252 

253Deny ルールと ask ルールは、サブシェル内のネストされたコマンド、コマンド置換、または `for` ループなどの制御フロー本体内のコマンドを含む、マッチするサブコマンドが存在する場合に適用されます。`Bash(git clean *)` のような ask ルールは、[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)でも、`cd /tmp && git clean -f` または `echo "$(git clean -f)"` に対してプロンプトを表示します。253拒否ルールと確認ルールは、いずれかのサブコマンドがマッチした場合に適用されます。これにはサブシェル、コマンド置換、または `for` ループのような制御フローの本体の中にネストされたコマンドも含まれます。`Bash(git clean *)` のような確認ルールは、[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)であっても、`cd /tmp && git clean -f` や `echo "$(git clean -f)"` に対して引き続き確認を求めます。

254 254 

255`&&` または `||` の後に何もない場合(`npm test &&` など)、Claude Code はコマンドを解析不可能として扱い、allow ルールマッチングのためにサブコマンドに分割しないため、`Bash(npm *)` のようなルールはそれを承認しません。255`npm test &&` のように `&&` や `||` の後に何もない場合、Claude Code はそのコマンドを解析不能として扱い、許可ルールのマッチングのためにサブコマンドへ分割しません。そのため、`Bash(npm *)` のようなルールではそのコマンドは承認されません。

256 256 

257「はい、今後は聞かない」で複合コマンドを承認すると、Claude Code は複合文字列全体の単一ルールではなく、承認が必要な各サブコマンドの個別ルールを保存します。たとえば、`git status && npm test` を承認すると、`npm test` のルールが保存されるため、将来の `npm test` 呼び出しは `&&` の前に何があるかに関係なく認識されます。`cd` をサブディレクトリに移動するようなサブコマンドは、そのパスの独自の Read ルールを生成します。単一の複合コマンドに対して最大 5 つのルールが保存される場合があります。257複合コマンドを「Yes, and don't ask again」で承認すると、Claude Code は複合文字列全体に対する単一のルールではなく、承認が必要な各サブコマンドごとに個別のルールを保存します。たとえば、`git status && npm test` を承認すると `npm test` のルールが保存されるため、今後の `npm test` の呼び出しは `&&` の前に何があっても認識されます。作業ディレクトリの外にあるディレクトリへの `cd` のようなサブコマンドは、そのパスに対する独自の Read ルールを生成します。1 つの複合コマンドに対して保存されるルールは最大 5 つです。

258 258 

259<h4 id="process-wrappers">259<h4 id="process-wrappers">

260 ラッパー260 ラッパー

261</h4>261</h4>

262 262 

263Bash ルールをマッチさせる前に、Claude Code は固定されたラッパーセットをストリップするため、`Bash(npm test *)` のようなルールは `timeout 30 npm test` もマッチさせます。ストリップされるラッパーは `timeout`、`time`、`nice`、`nohup`、`stdbuf`、およびシェルビルトイン `command` と `builtin`、および zsh の `noglob` です。各ラッパーは引数を実際のコマンドとして実行します。ストリップされない関連する 2 つの形式があります。コマンドを検索する `command -v` クエリ形式と、zsh の `nocorrect` です。263Bash ルールをマッチさせる前に、Claude Code は固定されたラッパーのセットを取り除きます。そのため、`Bash(npm test *)` のようなルールは `timeout 30 npm test` にもマッチします。取り除かれるラッパーは `timeout`、`time`、`nice`、`nohup`、`stdbuf`、さらにシェル組み込みの `command` と `builtin`、および zsh の `noglob` です。これらはいずれも引数を実際のコマンドとして実行します。関連する 2 つの形式は取り除かれません。コマンドを実行するのではなく検索するクエリ形式の `command -v` と、zsh の `nocorrect` です。

264 264 

265Claude Code はまた、既知の安全な環境変数の先頭の割り当てをストリップするため、`Bash(npm test *)` は `NODE_ENV=test npm test` にマッチします。Allow ルールは他の変数の割り当てを超えてマッチしません。Deny ルールまたは ask ルールは任意の先頭の割り当てを超えてマッチするため、`Bash(rm *)` を deny で使用すると、`FOO=bar rm -rf tmp/` にマッチします。265Claude Code は、特定の既知の安全な環境変数の先頭での代入も取り除くため、`Bash(npm test *)` は `NODE_ENV=test npm test` にマッチします。許可ルールは、それ以外の変数の代入を越えてマッチすることはありません。拒否ルールまたは確認ルールは先頭のあらゆる代入を越えてマッチするため、deny にある `Bash(rm *)` は `FOO=bar rm -rf tmp/` にも引き続きマッチします。

266 266 

267ベア `xargs` もストリップされるため、`Bash(grep *)` は `xargs grep pattern` にマッチします。ストリップは `xargs` にフラグがない場合にのみ適用されます。`xargs -n1 grep pattern` のような呼び出しは `xargs` コマンドとしてマッチされるため、内部コマンド用に記述されたルールはそれをカバーしません。267フラグなしの `xargs` も取り除かれるため、`Bash(grep *)` は `xargs grep pattern` にマッチします。取り除きが適用されるのは `xargs` にフラグがない場合のみです。`xargs -n1 grep pattern` のような呼び出しは `xargs` コマンドとしてマッチされるため、内側のコマンド向けに書かれたルールではカバーされません。

268 268 

269このラッパーリストは組み込まれており、設定不可能です。`direnv exec`、`devbox run`、`mise exec`、`npx`、`docker exec` などの開発環境ランナーはリストに含まれていません。これらのツールは引数をコマンドとして実行するため、`Bash(devbox run *)` のようなルールは `run` の後に続くものをマッチさせます。これには `devbox run rm -rf .` が含まれます。環境ランナー内での作業を承認するには、ランナーと内部コマンドの両方を含む特定のルールを記述します。例えば `Bash(devbox run npm test)`。許可する内部コマンドごとに 1 つのルールを追加します。269このラッパーリストは組み込みであり、設定できません。`direnv exec`、`devbox run`、`mise exec`、`npx`、`docker exec` などの開発環境ランナーはリストに含まれていません。これらのツールは引数をコマンドとして実行するため、`Bash(devbox run *)` のようなルールは `run` の後に続くものすべてにマッチし、`devbox run rm -rf .` も含まれます。環境ランナー内での作業を承認するには、`Bash(devbox run npm test)` のように、ランナーと内側のコマンドの両方を含む具体的なルールを書いてください。許可したい内側のコマンドごとに 1 つのルールを追加します。

270 270 

271<h4 id="exec-wrappers-and-find-actions">271<h4 id="exec-wrappers-and-find-actions">

272 Exec ラッパーと `find` アクション272 exec ラッパーと `find` アクション

273</h4>273</h4>

274 274 

275`Bash(watch *)` や `Bash(find *)` のようなプレフィックスルールは次のコマンドを自動承認できないため、Manual モードではプロンプトが表示されます。275`Bash(watch *)` や `Bash(find *)` のようなプレフィックスルールでは次のコマンドを自動承認できないため、Manual モードではこれらについて確認が求められます。

276 276 

277* **Exec ラッパー**:`watch`、`setsid`、`ionice`、`flock` など277* **exec ラッパー**: `watch`、`setsid`、`ionice`、`flock` など

278* **`find`**:`-exec`、`-delete`、`-fprint` など、コマンドを実行する、ファイルを削除する、またはファイルを書き込むアクションを伴う場合、または検索対象のパスをファイルから受け取る `-files0-from` を伴う場合278* **`find`**: `-exec`、`-delete`、`-fprint` など、コマンドを実行する、ファイルを削除する、またはファイルに書き込むアクションを伴うもの、あるいは検索するパスをファイルから受け取る `-files0-from` を伴うもの

279 279 

280`*` を含まない特定の呼び出しを承認するには、`Bash(find build -type f -delete)` のように、完全なコマンド文字列に対する完全一致ルールを記述します。280`*` を含まない特定の呼び出しを承認するには、`Bash(find build -type f -delete)` のように、コマンド文字列全体に対する完全一致ルールを書いてください。

281 281 

282`find . -name '*.tmp' -delete` のようにコマンドに `*` が含まれる場合、Claude Code はルールを完全一致ではなく[ワイルドカードパターン](#wildcard-patterns)として読み取るため、コマンドは引き続きプロンプトを表示します。プロンプトが表示されるたびに承認するか、そのコマンドに対して `"allow"` を返す [PreToolUse フック](/docs/ja/hooks#pretooluse-decision-control)を使用してください。282`find . -name '*.tmp' -delete` のようにコマンドに `*` が含まれる場合、Claude Code はルールを完全一致ではなく[ワイルドカードパターン](#wildcard-patterns)として読み取るため、コマンドは引き続き確認を求めます。確認が求められるたびに承認するか、そのコマンドに対して `"allow"` を返す [PreToolUse フック](/docs/ja/hooks#pretooluse-decision-control)を使用してください。

283 283 

284<h4 id="bash-rule-limits">284<h4 id="bash-rule-limits">

285 Bash ルールがマッチしないもの285 Bash ルールがマッチしないもの

286</h4>286</h4>

287 287 

288Bash ルールは Claude が記述したコマンドテキストにマッチします。Claude Code が[複合コマンド](#compound-commands)を分割し、[ラッパー](#process-wrappers)をストリップした後です。同じプログラムを別の形式で呼び出した場合、マッチしません。そのため、deny または ask ルールは Claude が通常生成する呼び出しをカバーし、プログラムの周りのセキュリティ境界ではありません。`deny` または `ask` のこれらのルールは最初の形式を停止し、他の形式は停止しません。288Bash ルールは、Claude Code が[複合コマンド](#compound-commands)を分割し[ラッパー](#process-wrappers)を取り除いた後の、Claude が書いたコマンドテキストにマッチします。別の形式で呼び出された同じプログラムにはマッチしないため、拒否ルールや確認ルールは Claude が通常生成する呼び出しをカバーするものであり、プログラムに対するセキュリティ境界ではありません。`deny` または `ask` にある以下のルールは、最初の形式は止めますが、その他の形式は止めません。

289 289 

290| ルール | 停止 | 停止しない |290| ルール | 止めるもの | 止めないもの |

291| :- | :- | :- |291| :- | :- | :- |

292| `Bash(curl *)` | `curl https://example.com` | `/usr/bin/curl https://example.com`、`sh -c 'curl https://example.com'` |292| `Bash(curl *)` | `curl https://example.com` | `/usr/bin/curl https://example.com`、`sh -c 'curl https://example.com'` |

293| `Bash(rm *)` | `rm -rf build/` | `/bin/rm -rf build/`、`bash -c 'rm -rf build/'` |293| `Bash(rm *)` | `rm -rf build/` | `/bin/rm -rf build/`、`bash -c 'rm -rf build/'` |

294| `Bash(git push *)` | `git push origin main` | `git -C . push origin main`、`git -c push.default=current push origin main`、`git 'push' origin main` |294| `Bash(git push *)` | `git push origin main` | `git -C . push origin main`、`git -c push.default=current push origin main`、`git 'push' origin main` |

295 295 

296最後の列のコマンドは、他のルールと権限モードによって決定されます。296最後の列のコマンドは、他のルールと権限モードによって決まります。

297 297 

298コマンドテキストに依存しないファイルシステムとネットワークの強制には、[サンドボックス](/docs/ja/sandboxing)を使用してください。実行前に独自のロジックで完全なコマンドテキストを検査するには、[PreToolUse フック](#extend-permissions-with-hooks)を使用してください。298コマンドテキストに依存しないファイルシステムおよびネットワークの強制には、[サンドボックス化](/docs/ja/sandboxing)を使用してください。コマンドの実行前に独自のロジックでコマンドテキスト全体を検査するには、[PreToolUse フック](#extend-permissions-with-hooks)を使用してください。

299 299 

300<h4 id="read-only-commands">300<h4 id="read-only-commands">

301 読み取り専用コマンド301 読み取り専用コマンド

302</h4>302</h4>

303 303 

304Claude Code は、Bash コマンドの組み込みセットを読み取り専用として認識し、[`permissions.blockReadsOutsideWorkingDirectories`](/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories)がフェンスするパスを除き、すべてのモードで権限プロンプトなしで実行します。セットには `ls`、`cat`、`echo`、`pwd`、`head`、`tail`、`grep`、`find`、`wc`、`which`、`diff`、`stat`、`du`、`cd`、および `git` の読み取り専用形式が含まれます。セットは設定不可能です。これらのコマンドの 1 つにプロンプトを要求するには、それに対して `ask` または `deny` ルールを追加します。auto モードでは、これらのコマンドは分類器のレビューを待つこともできます。[分類器がアクションを評価する方法](/docs/ja/permission-modes#how-the-classifier-evaluates-actions)を参照してください。304Claude Code は組み込みの Bash コマンドのセットを読み取り専用として認識し、すべてのモードで権限プロンプトなしに実行します。ただし、作業ディレクトリ外のパスについて [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) によって変更される場合を除きます。このセットには `ls`、`cat`、`echo`、`pwd`、`head`、`tail`、`grep`、`find`、`wc`、`which`、`diff`、`stat`、`du`、`cd`、および `git` の読み取り専用形式が含まれます。このセットは設定できません。これらのコマンドのいずれかで確認を必須にするには、そのコマンドに対する `ask` または `deny` ルールを追加してください。auto モードでは、これらのコマンドも分類器のレビューを待つことがあります。[分類器がアクションを評価する方法](/docs/ja/permission-modes#how-the-classifier-evaluates-actions)を参照してください。

305 305 

306`ls > out.txt` などのリダイレクトはターゲットのチェックを追加します。[リダイレクション](#redirections)を参照してください。306`ls > out.txt` のようなリダイレクトでは、対象に対するチェックが追加されます。[リダイレクト](#redirections)を参照してください。

307 307 

308すべてのフラグが読み取り専用であるコマンドに対しては、引用符なしのグロブパターンが許可されるため、`ls *.ts` および `wc -l src/*.py` はプロンプトなしで実行されます。308すべてのフラグが読み取り専用であるコマンドでは、引用符で囲まれていない glob パターンが許可されるため、`ls *.ts` や `wc -l src/*.py` は確認なしで実行されます。

309 309 

310Manual モードでは、このセットのコマンドは以下の場合にもプロンプトを表示します。310Manual モードでは、このセットのコマンドでも次の場合には確認が求められます。

311 311 

312* **書き込み可能なフラグを持つコマンドの引用符なしグロブ**:`find`、`sort`、`sed`、`git` などの書き込み可能または実行可能なフラグを持つコマンドは、グロブが `-delete` のようなフラグに展開される可能性があるため、引用符なしのグロブが存在する場合にプロンプトを表示します。312* **書き込み可能なフラグを持つコマンドでの引用符なしの glob**: `find`、`sort`、`sed`、`git` など、書き込みまたは実行が可能なフラグを持つコマンドは、引用符で囲まれていない glob が存在する場合に確認を求めます。glob が `-delete` のようなフラグに展開される可能性があるためです。

313* **別のデーモンを指す `docker`**:読み取り専用形式の `docker` は、`-H`、`--context`、または Podman の `--url` と `--connection` などの異なるデーモンを選択するフラグを持つコマンドでプロンプトを表示します。313* **別のデーモンを指す `docker`**: `docker` の読み取り専用形式は、`-H`、`--context`、または Podman の `--url` や `--connection` など、別のデーモンを選択するフラグをコマンドが含む場合に確認を求めます。

314* **パス開放フラグを持つ `file`**:`file` は `-m`/`--magic-file` または `-f`/`--files-from` を渡す場合にプロンプトを表示します。これらのフラグにより、`file` はフラグの値で指定されたパスを開くためです。314* **パスを開くフラグを伴う `file`**: `file` は、`-m`/`--magic-file` または `-f`/`--files-from` を渡す場合に確認を求めます。これらのフラグにより、`file` がフラグの値で指定されたパスを開くためです。

315* **環境変数を出力する可能性のある `ps`**:`ps auxe` や `ps aux -e` のように、引数のいずれかが `e` オプションとして機能する可能性がある場合、`ps` はプロンプトを表示します。このオプションはプロセスの環境変数を出力するためです。`ps aux` と `ps -ef` はプロンプトなしで実行されます。`ps aux -e` のようなダッシュ付き形式のチェックには Claude Code v2.1.290 以降が必要です。315* **環境変数を出力する可能性のある `ps`**: `ps` は、`ps auxe` や `ps aux -e` のように、引数のいずれかが `e` オプションとして機能しうる場合に確認を求めます。このオプションはプロセスの環境変数を出力するためです。`ps aux` と `ps -ef` は確認なしで実行されます。`ps aux -e` のようなダッシュ付き形式のチェックには Claude Code v2.1.290 以降が必要です。

316* **Windows 上のネットワークパス**:`\\server\share\file` などのネットワーク(UNC)パスを含む引数を持つコマンドは、ネットワークパスへのアクセスが Windows 認証情報をそれが指すホストに送信する可能性があるため、プロンプトを表示します。同じチェックが [PowerShell ツール](/docs/ja/tools-reference#powershell-tool)コマンドに適用されます。316* **Windows 上のネットワークパス**: `\\server\share\file` のようなネットワーク(UNC)パスを引数に含むコマンドは確認を求めます。ネットワークパスへのアクセスにより、Windows の認証情報がそのパスで指定されたホストに送信される可能性があるためです。同じチェックが [PowerShell ツール](/docs/ja/tools-reference#powershell-tool)のコマンドにも適用されます。

317* **特殊シェル変数への書き込み**:`PATH` または `IFS` などの特定の特殊シェル変数を設定、設定解除、またはループするコマンドは、コマンドの残りが読み取り専用であっても、プロンプトを表示します。317* **特殊なシェル変数への書き込み**: `PATH` や `IFS` など、特定の特殊なシェル変数を設定、解除、またはループするコマンドは、コマンドの残りの部分が読み取り専用であっても確認を求めます。

318* **解析できないコマンド**:Claude Code がコマンドを完全に解析できない場合、読み取り専用として扱う代わりに承認を求めます。10,000 文字を超えるコマンドは、解析が超過するため常にプロンプトを表示します。318* **解析できないコマンド**: Claude Code がコマンドを完全に解析できない場合、そのコマンドを読み取り専用として扱うのではなく承認を求めます。10,000 文字を超えるコマンドは、解析できる範囲を超えるため常に確認を求めます。

319 319 

320作業ディレクトリまたは[追加ディレクトリ](#working-directories)内のパスへの `cd` も読み取り専用です。`cd packages/api && ls` のような複合コマンドは、各部分が独立して適格である場合、プロンプトなしで実行されます。これらの組み合わせは、各部分が読み取り専用であっても、プロンプトを表示します。320作業ディレクトリまたは[追加ディレクトリ](#working-directories)内のパスへの `cd` も読み取り専用であり、`cd packages/api && ls` のような複合コマンドは、各部分がそれぞれ条件を満たす場合に確認なしで実行されます。以下の組み合わせは、各部分が読み取り専用であっても確認を求めます。

321 321 

322* **`cd` と `git`**:`cd` が異なるディレクトリに変更される場合にプロンプトを表示します。新しいディレクトリで `git` を実行するとそのディレクトリのフックを実行できるためです。ターゲットが現在の作業ディレクトリに解決される `cd` は、操作なしであり、プロンプトをトリガーしません。322* **`cd` と `git`**: `cd` が別のディレクトリに移動する場合に確認を求めます。新しいディレクトリで `git` を実行すると、そのディレクトリのフックが実行される可能性があるためです。対象が現在の作業ディレクトリに解決される `cd` は何もしない操作であり、確認は発生しません。

323* **`cd` とリダイレクト**:Claude Code が `cd` 実行後にリダイレクトターゲットが解決するディレクトリを判定できない場合にプロンプトを表示します。唯一のリダイレクトターゲットが `/dev/null` であるコマンド(`cd app; grep -r pattern . 2>/dev/null` など)は、`/dev/null` は作業ディレクトリに依存しないため、プロンプトを表示しません。323* **`cd` とリダイレクト**: `cd` の実行後にリダイレクト先がどのディレクトリを基準に解決されるかを Claude Code が判断できない場合に確認を求めます。`cd app; grep -r pattern . 2>/dev/null` のように、リダイレクト先が `/dev/null` のみであるコマンドは確認を求めません。`/dev/null` は作業ディレクトリに依存しないためです。

324 324 

325<Warning>325<Warning>

326 コマンド引数を制約しようとする Bash 権限パターンは脆弱です。たとえば、`Bash(curl http://github.com/ *)` は curl を GitHub URL に制限することを意図していますが、次のようなバリエーションにはマッチしません。326 コマンドの引数を制限しようとする Bash 権限パターンは脆弱です。たとえば、`Bash(curl http://github.com/ *)` は curl を GitHub の URL に制限することを意図していますが、次のようなバリエーションにはマッチしません。

327 327 

328 * URL の前のオプション:`curl -X GET http://github.com/...`328 * URL の前のオプション: `curl -X GET http://github.com/...`

329 * 異なるプロトコル:`curl https://github.com/...`329 * 異なるプロトコル: `curl https://github.com/...`

330 * リダイレクト:`curl -L http://short.example.com/xyz`(GitHub にリダイレクト)330 * リダイレクト: GitHub にリダイレクトされる `curl -L http://short.example.com/xyz`

331 * 変数:`URL=http://github.com && curl $URL`331 * 変数: `URL=http://github.com && curl $URL`

332 332 

333 より信頼性の高い URL フィルタリングについては、以下を検討してください。333 より信頼性の高い URL フィルタリングのためには、次の方法を検討してください。

334 334 

335 * **Bash ネットワークツールを制限する**:deny ルールを使用して `curl`、`wget` などのコマンドをブロックし、許可されたドメインに対して `WebFetch(domain:github.com)` 権限で WebFetch ツールを使用します。deny ルールは、同じプログラムをパスで呼び出した場合や `sh -c` 内で呼び出した場合にはマッチしないため、制限を確実に保持する必要がある場合は[サンドボックスネットワーク許可リスト](/docs/ja/sandboxing#network-isolation)と組み合わせてください。[Bash ルールがマッチしないもの](#bash-rule-limits)を参照してください。335 * **Bash のネットワークツールを制限する**: 拒否ルールを使用して `curl`、`wget` などのコマンドを止め、許可するドメインについては WebFetch ツールと `WebFetch(domain:github.com)` 権限を使用します。拒否ルールはパス指定や `sh -c` 内の同じプログラムにはマッチしないため、制限を確実に維持する必要がある場合は[サンドボックスのネットワーク許可リスト](/docs/ja/sandboxing#network-isolation)と組み合わせてください。[Bash ルールがマッチしないもの](#bash-rule-limits)を参照してください

336 * **PreToolUse フックを使用する**:Bash コマンドの URL を検証し、許可されていないドメインをブロックするフックを実装します。336 * **PreToolUse フックを使用する**: Bash コマンド内の URL を検証し、許可されていないドメインをブロックするフックを実装します

337 * **CLAUDE.md ガイダンスを追加する**:`CLAUDE.md` で許可された curl パターンについて説明します。これは Claude が試みることを形作りますが、境界を強制しないため、上記のオプションの 1 つと組み合わせてください。337 * **CLAUDE.md にガイダンスを追加する**: 許可する curl パターンを `CLAUDE.md` に記述します。これは Claude が試みる内容を方向付けますが境界を強制するものではないため、上記のいずれかの方法と組み合わせてください

338 338 

339 WebFetch のみを使用しても、ネットワークアクセスは防止されません。Bash が許可されている場合、Claude は `curl`、`wget` または他のツールを使用して任意の URL に到達できます。339 WebFetch を使用するだけではネットワークアクセスは防げないことに注意してください。Bash が許可されている場合、Claude は引き続き `curl`、`wget`、その他のツールを使用して任意の URL にアクセスできます。

340</Warning>340</Warning>

341 341 

342<h4 id="redirections">342<h4 id="redirections">

343 リダイレクション343 リダイレクト

344</h4>344</h4>

345 345 

346コマンドが出力または入力をリダイレクトする場合、Claude Code はリダイレクトターゲットをファイルルールに対してチェックします。Claude が直接そのファイルを書き込みまたは読み取ったかのようにです。346コマンドが出力または入力をリダイレクトする場合、Claude Code は、Claude がそのファイルを直接書き込んだり読み取ったりした場合と同様に、リダイレクト先をファイルルールと照合してチェックします。

347 347 

348* **出力リダイレクト**:`> file`、`>> file`、または `2> file` の場合、チェックは `Edit` allow ルールと deny ルール、[保護されたパス](/docs/ja/permission-modes#protected-paths)、および[作業ディレクトリ](#working-directories)をカバーします。`Bash(git commit *)` のようなルールはコマンドを許可し、ターゲットは許可しません。`~` で始まるターゲットまたはグロブ文字を含むターゲットは承認が必要です。348* **出力リダイレクト**: `> file`、`>> file`、`2> file` の場合、チェックは `Edit` の許可ルールと拒否ルール、[保護されたパス](/docs/ja/permission-modes#protected-paths)、および[作業ディレクトリ](#working-directories)を対象とします。`Bash(git commit *)` のようなルールはコマンドを許可するものであり、リダイレクト先を許可するものではありません。`~` で始まる、または glob 文字を含むリダイレクト先には承認が必要です。

349* **入力リダイレクト**:`< file` の場合、チェックは `Read` allow ルールと deny ルール、および作業ディレクトリをカバーします。作業ディレクトリの外のターゲットは、allow ルールがカバーしない限り承認が必要です。グロブパターンを含むターゲット、または同じコマンド内の `cd` に続く相対パスは、allow ルールがカバーしている場合でも承認が必要です。Claude Code は v2.1.257 以降で入力ターゲットをチェックします。349* **入力リダイレクト**: `< file` の場合、チェックは `Read` の許可ルールと拒否ルール、および作業ディレクトリを対象とします。作業ディレクトリ外のリダイレクト先には、許可ルールでカバーされていない限り承認が必要です。glob パターンを含むリダイレクト先、または同じコマンド内の `cd` の後に続く相対パスは、許可ルールでカバーされていても承認が必要です。Claude Code は v2.1.257 以降で入力先をチェックします。

350 350 

351ターゲットの背後にファイルがない場合はチェックされません。`/dev/null`、`2>&1` や `<&3` などのファイルディスクリプタ形式、および here-docs と here-strings です。351背後にファイルが存在しないリダイレクト先はチェックされません。`/dev/null`、`2>&1` や `<&3` のようなファイルディスクリプタ形式、およびヒアドキュメントとヒアストリングがこれに該当します。

352 352 

353Claude Code はまた、`tee` コマンドが書き込むファイルをチェックします。これには `make | tee build.log` などのパイプラインが含まれます。チェックは `Edit` allow ルールと deny ルール、[保護されたパス](/docs/ja/permission-modes#protected-paths)、および[作業ディレクトリ](#working-directories)をカバーします。`Bash(tee *)` のような allow ルールは、作業ディレクトリの外の宛先をカバーしません。Claude Code は v2.1.269 以降で `tee` ターゲットをチェックします。353Claude Code は、`make | tee build.log` のようなパイプライン内を含め、`tee` コマンドが書き込むファイルもチェックします。チェックは `Edit` の許可ルールと拒否ルール、[保護されたパス](/docs/ja/permission-modes#protected-paths)、および[作業ディレクトリ](#working-directories)を対象とします。`Bash(tee *)` のような許可ルールは、作業ディレクトリ外の書き込み先をカバーしません。Claude Code は v2.1.269 以降で `tee` の書き込み先をチェックします。

354 354 

355<h3 id="powershell">355<h3 id="powershell">

356 PowerShell356 PowerShell

357</h3>357</h3>

358 358 

359PowerShell 権限ルールは Bash ルールと同じ形状を使用しています。`*` を使用したワイルドカードは任意の位置でマッチし、`:*` サフィックスは末尾の ` *` と同等であり、ベア `PowerShell` または `PowerShell(*)` はすべてのコマンドをマッチさせます。この設定により、`Get-ChildItem` および `git commit` コマンドが許可され、`Remove-Item` がブロックされます。359PowerShell の権限ルールは Bash ルールと同じ形式を使用します。`*` によるワイルドカードは任意の位置でマッチし、`:*` サフィックスは末尾の ` *` と同等であり、単独の `PowerShell` または `PowerShell(*)` はすべてのコマンドにマッチします。次の設定は、`Remove-Item` をブロックしつつ、`Get-ChildItem` と `git commit` コマンドを許可します。

360 360 

361```json theme={null}361```json theme={null}

362{362{


372}372}

373```373```

374 374 

375一般的なエイリアスはマッチング前に正規化されます。コマンドレット名用に記述されたルールはそのエイリアスもマッチさせるため、`PowerShell(Get-ChildItem *)` は `gci`、`ls`、`dir` もマッチさせます。マッチングは大文字と小文字を区別しません。375一般的なエイリアスはマッチング前に正規化されます。コマンドレット名に対して書かれたルールはそのエイリアスにもマッチするため、`PowerShell(Get-ChildItem *)` は `gci`、`ls`、`dir` にもマッチします。マッチングでは大文字と小文字は区別されません。

376 376 

377Claude Code は PowerShell AST を解析し、複合コマンド内の各コマンドを独立してチェックします。パイプオペレータ `|`、ステートメント区切り文字 `;`、および PowerShell 7 以降のチェーンオペレータ `&&` と `||` は複合コマンドをサブコマンドに分割します。複合コマンドが許可されるには、ルールがすべてのサブコマンドをマッチさせる必要があります。377Claude Code は PowerShell の AST を解析し、複合コマンド内の各コマンドを個別にチェックします。パイプライン演算子 `|`、ステートメント区切り `;`、および PowerShell 7 以降ではチェーン演算子 `&&` と `||` によって、複合コマンドはサブコマンドに分割されます。複合コマンドが許可されるには、ルールがすべてのサブコマンドにマッチする必要があります。

378 378 

379<h3 id="read-and-edit">379<h3 id="read-and-edit">

380 Read と Edit380 Read と Edit

381</h3>381</h3>

382 382 

383Claude のファイルツールがファイルまたはディレクトリを読み取るのをブロックするには、`Read(./.env)` または `Read(./secrets/**)` などのパスに対して `Read` deny ルールを追加します。[機密ファイルを除外](/docs/ja/settings-reference#exclude-sensitive-files)にはペースト可能な例があります。プロジェクトに `.claudeignore` ファイルがある場合、そのファイルは効果がないため、そのエントリを `Read` deny ルールに移してください。383Claude のファイルツールによるファイルやディレクトリの読み取りをブロックするには、`Read(./.env)` や `Read(./secrets/**)` のように、そのパスに対する `Read` 拒否ルールを追加してください。[機密ファイルを除外する](/docs/ja/settings-reference#exclude-sensitive-files)に、そのまま貼り付けて使える例があります。プロジェクトに `.claudeignore` ファイルがある場合、それは効果がないため、そのエントリを `Read` 拒否ルールに移してください。

384 384 

385`Edit` ルールはファイルを編集するすべての組み込みツールに適用されます。Claude は、Grep や Glob などのファイルを読み取るすべての組み込みツール、プロンプト内の `@file` メンション、および接続された [IDE](/docs/ja/vs-code#the-built-in-ide-mcp-server) が Claude と共有する選択およびオープンファイルコンテキストに `Read` ルールを適用するためにベストエフォートを試みます。385`Edit` ルールは、ファイルを編集するすべての組み込みツールに適用されます。Claude は、Grep や Glob のようなファイルを読み取るすべての組み込みツール、プロンプト内の `@file` メンション、および接続された [IDE](/docs/ja/vs-code#the-built-in-ide-mcp-server) が Claude と共有する選択範囲や開いているファイルのコンテキストに対して、`Read` ルールをベストエフォートで適用しようとします。

386 386 

387`Read(path)` deny ルールは、プロンプトに貼り付けた画像パスと @ メンションしたディレクトリにも適用されます。387`Read(path)` 拒否ルールは、プロンプトに貼り付けた画像パスや @ メンションしたディレクトリにも適用されます。

388 388 

389* **画像パス**:ターミナルでプロンプトに画像のパスを貼り付けるか画像ファイルをドラッグし、ルールがそのパスにマッチする場合、Claude Code は画像を添付しません。貼り付けた内容に他の画像が含まれていない場合、パスはテキストとしてプロンプトに残ります。389* **画像パス**: ターミナルでプロンプトに画像のパスを貼り付けたり画像ファイルをドラッグしたりしたときに、ルールがそのパスにマッチする場合、Claude Code は画像を添付しません。貼り付けた内容に他の画像が含まれていない場合、パスはテキストとしてプロンプトに残ります。

390* **ディレクトリ**:[Claude が受け取る一覧](/docs/ja/common-workflows#reference-files-and-directories)から、ルールにマッチするファイル名とディレクトリ名が除外されます。390* **ディレクトリ**: [Claude が受け取る一覧](/docs/ja/common-workflows#reference-files-and-directories)から、ルールにマッチするファイル名とディレクトリ名が除外されます。

391 391 

392Claude Code は v2.1.290 以降で、貼り付けた画像パスとディレクトリ一覧をチェックします。392Claude Code は v2.1.290 以降で、貼り付けられた画像パスとディレクトリ一覧をチェックします。

393 393 

394`Read` deny ルールは、同じパスの [Edit と Write ツール](/docs/ja/errors#file-is-covered-by-a-read-deny-rule)もブロックします。これには新しいファイルの作成も含まれます。NotebookEdit はカバーされないため、ツールが変更できないパスに対して `Edit` deny ルールを追加してください。チェックには編集時に Claude Code v2.1.208 以降が必要です。書き込み時には v2.1.228 以降が必要です。394`Read` 拒否ルールは、同じパスに対する [Edit ツールと Write ツール](/docs/ja/errors#file-is-covered-by-a-read-deny-rule)もブロックします。これにはそのパスへの新しいファイルの作成も含まれます。NotebookEdit は対象外であるため、どのツールにも変更させたくないパスには `Edit` 拒否ルールを追加してください。Write ツールの場合、このチェックには Claude Code v2.1.228 以降が必要です。

395 395 

396Claude Code は `Edit(path)` と `Read(path)` ルールに対してのみファイル権限をチェックします。代わりに `Write`、`NotebookEdit`、`Glob`、またはレガシー `MultiEdit` ツール用にパスルールを記述する場合、Claude Code はルールを受け入れますが、それを参照することはなく、[起動時に警告](/docs/ja/errors#is-not-matched-by-file-permission-checks)を表示します。ただし、`--allowedTools` で渡された `Glob` ルールは除きます。`Write(docs/**)`、`NotebookEdit(docs/**)`、または `MultiEdit(docs/**)` の代わりに `Edit(docs/**)` を使用し、`Glob(docs/**)` の代わりに `Read(docs/**)` を使用してください。Claude Code は `Write` の deny ルールなど、パスのないツール名ルールについては警告しません。それはどこでもツールレベルでそのルールをマッチさせます。v2.1.210 以降が必要です。396Claude Code は、ファイル権限を `Edit(path)` ルールと `Read(path)` ルールに対してのみチェックします。代わりに `Write`、`NotebookEdit`、`Glob`、または従来の `MultiEdit` ツールに対するパスルールを書いた場合、Claude Code はそのルールを受け入れますが参照することはなく、[起動時に警告します](/docs/ja/errors#is-not-matched-by-file-permission-checks)。ただし、`--allowedTools` で渡された `Glob` ルールは除きます。`Write(docs/**)`、`NotebookEdit(docs/**)`、`MultiEdit(docs/**)` の代わりに `Edit(docs/**)` を、`Glob(docs/**)` の代わりに `Read(docs/**)` を使用してください。`Write` に対する拒否ルールのような、パスを持たないツール名のルールについては、Claude Code は警告しません。そのルールはあらゆる場所でツールレベルでマッチします。

397 397 

398<Warning>398<Warning>

399 Read と Edit deny ルールは Claude の組み込みファイルツール、`cat`、`head`、`tail`、`sed`、`tee` などの Claude Code が認識する Bash ファイルコマンド、および `> file` と `< file` などの Bash [リダイレクション](#redirections)のターゲットに適用されます。これらは、そのファイルがあるディレクトリから実行する `grep -r pattern .` のような、ファイルを名前で指定せずに読み取るコマンドや、Python または Node スクリプトがファイルを自分で開くような、ファイルを間接的に読み書きする任意のサブプロセスには適用されません。パスへのすべてのプロセスのアクセスをブロックする OS レベルの強制については、[サンドボックスを有効にしてください](/docs/ja/sandboxing)。399 Read と Edit の拒否ルールは、Claude の組み込みファイルツール、`cat`、`head`、`tail`、`sed`、`tee` など Claude Code が Bash 内で認識するファイルコマンド、および `> file` や `< file` のような Bash [リダイレクト](#redirections)の対象に適用されます。ファイルを含むディレクトリから実行される `grep -r pattern .` のようにファイル名を指定せずにファイルを読み取るコマンドや、ファイル自体を開く Python や Node のスクリプトのように間接的にファイルを読み書きする任意のサブプロセスには適用されません。すべてのプロセスによるパスへのアクセスをブロックする OS レベルの強制には、[サンドボックスを有効にしてください](/docs/ja/sandboxing)。

400</Warning>400</Warning>

401 401 

402Read と Edit ルールの両方は、[gitignore](https://git-scm.com/docs/gitignore)パターン構文を使用し、4 つの異なるパターンタイプがあります。単一セグメントディレクトリパターンの場合、マッチング深度はルールタイプにも依存し、このセクションの後半で説明されています。402Read ルールと Edit ルールはどちらも、4 つの異なるパターンタイプを持つ [gitignore](https://git-scm.com/docs/gitignore) パターン構文を使用します。単一セグメントのディレクトリパターンの場合、マッチする深さはルールの種類にも依存します。これについてはこのセクションの後半で説明します。

403 403 

404| パターン | 意味 | 例 | マッチ |404| パターン | 意味 | 例 | マッチするもの |

405| - | - | - | - |405| - | - | - | - |

406| `//path` | ファイルシステムルートからの絶対パス | `Read(//Users/alice/secrets/**)` | `/Users/alice/secrets/**` |406| `//path` | ファイルシステムのルートからの絶対パス | `Read(//Users/alice/secrets/**)` | `/Users/alice/secrets/**` |

407| `~/path` | ホームディレクトリからのパス | `Read(~/Documents/*.pdf)` | `/Users/alice/Documents/*.pdf` |407| `~/path` | ホームディレクトリからのパス | `Read(~/Documents/*.pdf)` | `/Users/alice/Documents/*.pdf` |

408| `/path` | 設定ソースからの相対パス | `Edit(/src/**/*.ts)` | プロジェクト設定の `<primary working directory>/src/**/*.ts` |408| `/path` | 設定ソースからの相対パス | `Edit(/src/**/*.ts)` | プロジェクト設定では `<primary working directory>/src/**/*.ts` |

409| `path` または `./path` | 現在のディレクトリからの相対パス | `Read(*.env)` | `<cwd>/*.env` |409| `path` または `./path` | 現在のディレクトリからの相対パス | `Read(*.env)` | `<cwd>/*.env` |

410 410 

411<Warning>411<Warning>

412 `/Users/alice/file` のようなパターンは絶対パスではありません。単一の先頭スラッシュは設定ソースにアンカーされており、ファイルシステムルートではありません。絶対パスには `//Users/alice/file` を使用してください。412 `/Users/alice/file` のようなパターンは絶対パスではありません。先頭の単一のスラッシュは、ファイルシステムのルートではなく設定ソースを基準にします。絶対パスには `//Users/alice/file` を使用してください。

413</Warning>413</Warning>

414 414 

415`/path` パターンは、それを定義する設定ソースに関連付けられたディレクトリにアンカーされるため、同じルールは配置場所に応じて異なる場所にマッチします。415`/path` パターンは、それを定義する設定ソースに関連付けられたディレクトリを基準にするため、同じルールでも配置する場所によって異なる場所にマッチします。

416 416 

417| ルール定義場所 | `/path` の解決先 |417| ルールの定義場所 | `/path` の解決先 |

418| :- | :- |418| :- | :- |

419| `.claude/settings.json` のプロジェクト設定 | `<primary working directory>/path` |419| `.claude/settings.json` のプロジェクト設定 | `<primary working directory>/path` |

420| `.claude/settings.local.json` のローカル設定 | `<primary working directory>/path` |420| `.claude/settings.local.json` のローカル設定 | `<primary working directory>/path` |


422| `--settings <file>` で渡されたファイル | `<directory of file>/path` |422| `--settings <file>` で渡されたファイル | `<directory of file>/path` |

423| CLI フラグまたはセッションルール | `<primary working directory>/path` |423| CLI フラグまたはセッションルール | `<primary working directory>/path` |

424 424 

425`/permissions` を通じて追加するルールは、保存先の設定ファイルの行に従います。425`/permissions` で追加したルールは、保存先の設定ファイルに対応する行に従います。

426 426 

427ローカル設定ルールは、v2.1.211 以降で Claude Code が [ファイルを保存](#permission-system)するリポジトリルートではなく、セッションの [primary working directory](#working-directories) にアンカーされます。リポジトリルートで開始されたセッションでは、2 つのディレクトリは同じです。[worktree](/docs/ja/worktrees)セッションでは、`Edit(/src/**)` などの共有ルールはそのワークツリー独自の `src/` ディレクトリをマッチさせます。427v2.1.211 以降、ローカル設定のルールは、Claude Code が[ファイルを保存する](#permission-system)リポジトリのルートではなく、セッションの[プライマリ作業ディレクトリ](#working-directories)を基準にします。リポジトリのルートで開始されたセッションでは 2 つのディレクトリは同じです。[worktree](/docs/ja/worktrees) セッションでは、`Edit(/src/**)` のような共有ルールはその worktree 自体の `src/` ディレクトリにマッチします。

428 428 

429`Read(/secrets/**)` のような deny ルールをユーザー設定で記述すると、プロジェクト内の `secrets` ディレクトリではなく、`~/.claude/secrets/**` をブロックします。すべてのプロジェクト内で適用されるルールをユーザー設定で記述するには、代わりに `//` 絶対パスまたは `~/` ホーム相対パスを使用してください。429ユーザー設定にある `Read(/secrets/**)` のような拒否ルールは、プロジェクト内の `secrets` ディレクトリではなく、`~/.claude/secrets/**` をブロックします。すべてのプロジェクト内で適用されるルールをユーザー設定に書くには、代わりに `//` の絶対パスまたは `~/` のホーム相対パスを使用してください。

430 430 

431Windows では、パスはマッチング前に POSIX 形式に正規化されます。`C:\Users\alice` は `/c/Users/alice` になるため、そのドライブ上の任意の場所の `.env` ファイルをマッチさせるには `//c/**/.env` を使用します。すべてのドライブにわたってマッチさせるには、`//**/.env` を使用します。431Windows では、パスはマッチング前に POSIX 形式に正規化されます。`C:\Users\alice` は `/c/Users/alice` になるため、そのドライブ上の任意の場所にある `.env` ファイルにマッチさせるには `//c/**/.env` を使用してください。すべてのドライブにわたってマッチさせるには、`//**/.env` を使用してください。

432 432 

433例:433例:

434 434 

435* `Edit(/docs/**)`:`<primary working directory>/docs/` での編集。`/docs/` や `<primary working directory>/.claude/docs/` ではありません435* `Edit(/docs/**)`: `<primary working directory>/docs/` 内の編集。`/docs/` や `<primary working directory>/.claude/docs/` ではありません

436* `Read(~/.zshrc)`:ホームディレクトリの `.zshrc` の読み取り436* `Read(~/.zshrc)`: ホームディレクトリの `.zshrc` の読み取り

437* `Edit(//tmp/scratch.txt)`:絶対パス `/tmp/scratch.txt` の編集437* `Edit(//tmp/scratch.txt)`: 絶対パス `/tmp/scratch.txt` の編集

438* `Read(src/**)`:allow ルールとしては `<current-directory>/src/` からの読み取りのみ。deny ルールまたは ask ルールとしては、現在のディレクトリの下の任意の深さにある `src` ディレクトリにマッチします438* `Read(src/**)`: 許可ルールとしては `<current-directory>/src/` からのみ読み取り、拒否ルールまたは確認ルールとしては現在のディレクトリ配下の任意の深さにある `src` ディレクトリにマッチ

439 439 

440ルールはそのアンカーの下のファイルのみをマッチさせます。その範囲内で、マッチング深度はパターン形状に依存し、単一セグメントディレクトリパターンの場合、ルールタイプにも依存します。以下で説明されています。ベアファイル名は gitignore セマンティクスに従い、任意の深さでマッチするため、`Read(.env)` と `Read(**/.env)` は同等です。440ルールはその基準点の配下にあるファイルにのみマッチします。その範囲内では、マッチする深さはパターンの形と、単一セグメントのディレクトリパターンの場合はルールの種類に依存します。これについては以下で説明します。単独のファイル名は gitignore のセマンティクスに従い任意の深さでマッチするため、`Read(.env)` と `Read(**/.env)` は同等です。

441 441 

442| Deny ルール | ブロック | ブロックしない |442| 拒否ルール | ブロックするもの | ブロックしないもの |

443| - | - | - |443| - | - | - |

444| `Read(.env)` または `Read(**/.env)` | 現在のディレクトリ以下の任意の `.env` | 親ディレクトリまたは別のプロジェクト内の `.env` |444| `Read(.env)` または `Read(**/.env)` | 現在のディレクトリ以下にある任意の `.env` | 親ディレクトリや別のプロジェクトにある `.env` |

445| `Read(//**/.env)` | ファイルシステム上の任意の場所の `.env` | なし。ルールはファイルシステムルートにアンカーされています |445| `Read(//**/.env)` | ファイルシステム上のあらゆる場所にある任意の `.env` | なし。ルールはファイルシステムのルートを基準にしています |

446 446 

447単一ディレクトリセグメント(`src/**` など)を持つ相対パターンは、ルールタイプに応じて異なる深さでマッチします。447`src/**` のように単一のディレクトリセグメントを持つ相対パターンは、ルールの種類によって異なる深さでマッチします。

448 448 

449* **Allow ルール**:`Edit(src/**)` は `<cwd>/src` とその下のファイルのみをマッチさせます。任意の深さでディレクトリ名を許可するには、`Edit(**/src/**)` を記述してください。449* **許可ルール**: `Edit(src/**)` は `<cwd>/src` とその配下のファイルのみにマッチします。任意の深さのディレクトリ名を許可するには、`Edit(**/src/**)` と書いてください。

450* **Deny と ask ルール**:`Read(secrets/**)` は現在のディレクトリの下の任意の深さで `secrets` という名前のディレクトリをマッチさせるため、ルールはネストされたコピーにも適用されます。450* **拒否ルールと確認ルール**: `Read(secrets/**)` は現在のディレクトリ配下の任意の深さにある `secrets` という名前のディレクトリにマッチするため、ルールはネストされたコピーにも適用されます。

451 451 

452他のすべてのパターン形状は、すべてのルールタイプで同じ深さでマッチします。`Edit(/src/**)` と `Edit(src/components/**)` はそのアンカーされた場所でのみマッチし、`Edit(**/src/**)` は任意の深さでマッチします。452その他のすべてのパターンの形は、どのルールの種類でも同じ深さでマッチします。`Edit(/src/**)` と `Edit(src/components/**)` は基準となる場所でのみマッチし、`Edit(**/src/**)` は任意の深さでマッチします。

453 453 

454次の例は、トップレベルの `src/` ディレクトリと `vendor/` の下のネストされたコピーを持つプロジェクトに対する各パターン形状を示しています。454次の例は、トップレベルの `src/` ディレクトリと `vendor/` 配下にネストされたコピーを持つプロジェクトに対して、各パターンの形がどのようにマッチするかを示しています。

455 455 

456```text theme={null}456```text theme={null}

457<current-directory>/457<current-directory>/


463 └── lib.js463 └── lib.js

464```464```

465 465 

466| ルール | `src/app.ts` をマッチ | `vendor/pkg/src/lib.js` をマッチ |466| ルール | `src/app.ts` にマッチ | `vendor/pkg/src/lib.js` にマッチ |

467| :- | :- | :- |467| :- | :- | :- |

468| Allow ルールとしての `Edit(src/**)` | はい | いいえ |468| 許可ルールとしての `Edit(src/**)` | はい | いいえ |

469| Deny または ask ルールとしての `Edit(src/**)` | はい | はい |469| 拒否ルールまたは確認ルールとしての `Edit(src/**)` | はい | はい |

470| 任意のルールタイプの `Edit(/src/**)` | はい | いいえ |470| 任意のルールの種類での `Edit(/src/**)` | はい | いいえ |

471| 任意のルールタイプの `Edit(**/src/**)` | はい | はい |471| 任意のルールの種類での `Edit(**/src/**)` | はい | はい |

472 472 

473<Note>473<Note>

474 gitignore パターンでは、`*` は単一のパスセグメント内でマッチし、パターン内の任意の位置に表示できます。一方、`**` はディレクトリ全体でマッチします。474 gitignore パターンでは、`*` は単一のパスセグメント内でマッチし、パターン内の任意の位置に置くことができます。一方、`**` はディレクトリをまたいでマッチします。

475</Note>475</Note>

476 476 

477「はい、今後は聞かない」でファイルパスを承認すると、Claude Code は `[`、`]`、`*` などの gitignore パターン文字をそのパスでエスケープするため、生成されたルールは承認したリテラルパスのみをマッチさせます。自分で記述したルールはエスケープされません。477ファイルパスを「Yes, and don't ask again」で承認すると、Claude Code はそのパス内の `[`、`]`、`*` などの gitignore パターン文字をエスケープするため、生成されたルールは承認したリテラルのパスのみにマッチします。自分で書いたルールはエスケープされません。

478 478 

479パスに括弧をエスケープする必要はないため、`Edit(./Finance (2024)/**)` は `Finance (2024)` フォルダをそのまま記述してマッチさせます。479パス内の括弧をエスケープする必要はないため、`Edit(./Finance (2024)/**)` は表記どおりの `Finance (2024)` フォルダにマッチします。

480 480 

481パスが gitignore パターンとして使用可能でない deny または ask ルールは、その正確なパスを保護します。使用可能でないパターンを持つ allow ルールは何も承認しません。481gitignore パターンとして使用できないパスを持つ拒否ルールまたは確認ルールも、その正確なパスを引き続き保護します。使用できないパターンを持つ許可ルールは何も承認しません。

482 482 

483deny または ask パターンが `!` で始まる場合、gitignore 否定です。それは、その前にリストされた `path` または `./path` ルールから、それがマッチするパスを削除します。1 つの設定ファイルの `deny` リストで、`Read(*.env)` の後に `Read(!sample.env)` が続く場合、名前が `.env` で終わるすべてのファイルを任意の深さでブロックしますが、`sample.env` という名前のファイルは除きます。最初にリストされた `!` ルールは何も削除しません。483`!` で始まる拒否パターンまたは確認パターンは gitignore の否定です。これは、その前に列挙された `path` または `./path` ルールから、マッチするパスを除外します。1 つの設定ファイルの `deny` リストで、`Read(*.env)` の後に `Read(!sample.env)` が続く場合、名前が `.env` で終わる任意の深さのファイルをすべてブロックしますが、`sample.env` という名前のファイルは除外されます。最初に列挙された `!` ルールは何も除外しません。

484 484 

485削除は同じソースからのルールにのみ到達します。プロジェクト設定または `--disallowedTools` の `Read(!.env)` は、管理設定または他の設定ファイルからの `Read(./.env)` deny をキャンセルしません。485除外が及ぶのは同じソースのルールのみです。プロジェクト設定または `--disallowedTools` にある `Read(!.env)` は、管理設定やその他の設定ファイルにある `Read(./.env)` 拒否を取り消しません。

486 486 

4872 つの制限は、`!` パターンが削除できるものを狭めます。487`!` パターンで除外できる範囲は、次の 2 つの制限によって狭まります。

488 488 

489* Claude Code は、`!` の後に `/`、`~/`、または `//` が続く場合でも、`!` パターンを現在のディレクトリから相対的に読み取るため、パターンはこれらのプレフィックスの 1 つでアンカーされたルールに到達できません。`Read(!~/notes/public/**)` は `Read(~/notes/**)` から何も削除しません。489* Claude Code は、`!` の後に `/`、`~/`、`//` が続く場合でも `!` パターンを現在のディレクトリからの相対パスとして読み取るため、パターンはこれらのプレフィックスのいずれかを基準とするルールには及びません。`Read(!~/notes/public/**)` は `Read(~/notes/**)` から何も除外しません。

490* 削除は、ルールが全体としてブロックするディレクトリ内のファイルを再度開くことはできません。`Read(secrets/**)` と `Read(!secrets/public/**)` では、Claude Code は `secrets/public` をそれ以外の `secrets` と一緒にブロックします。490* 除外によって、ルールがディレクトリ全体としてブロックしているディレクトリ内のファイルを再び開くことはできません。`Read(secrets/**)` と `Read(!secrets/public/**)` がある場合、Claude Code は `secrets` の残りの部分と一緒に `secrets/public` も引き続きブロックします。

491 491 

492<h4 id="symlinks">492<h4 id="symlinks">

493 シンボリックリンク493 シンボリックリンク

494</h4>494</h4>

495 495 

496Claude がシンボリックリンクを通じてファイルパスにアクセスするとき、権限チェックは 2 つのパスをカバーします。Claude が要求したパスと、それが解決するファイルです。これは macOS、Linux、Windows 上のシンボリックリンク、および Windows 上のディレクトリジャンクションに適用されます。496Claude が要求したファイルパスがシンボリックリンクを経由する場合、権限チェックは 2 つのパスを対象とします。Claude が要求したパスと、その解決先のファイルです。これは macOS、Linux、Windows のシンボリックリンクと、Windows のディレクトリジャンクションに適用されます。

497 497 

498<h5 id="how-rules-match-a-symlinked-path">498<h5 id="how-rules-match-a-symlinked-path">

499 ルールがシンボリックリンク付きパスをマッチさせる方法499 ルールがシンボリックリンクされたパスにマッチする仕組み

500</h5>500</h5>

501 501 

502Allow ルールと deny ルールは、要求されたパスと解決先のファイルを異なる方法で扱います。502許可ルールと拒否ルールは、要求されたパスとその解決先のファイルを異なる方法で扱います。

503 503 

504* **Allow ルール**:要求されたパスと解決先のファイルの両方がマッチする場合にのみ適用されます。許可されたディレクトリ内のシンボリックリンクがそれの外を指している場合、ルールはマッチしません。504* **許可ルール**: 要求されたパスとその解決先のファイルの両方がマッチする場合にのみ適用されます。許可されたディレクトリ内にあり、その外を指すシンボリックリンクを介した読み取りは、ルールにマッチしません。

505* **Deny ルール**:要求されたパスまたは解決先のファイルのいずれかがマッチする場合に適用されます。拒否されたファイルを指すシンボリックリンク自体が拒否されます。たとえば、`Read(./project/**)` が許可され、`Read(~/.ssh/**)` が拒否されている場合、`./project/key` にあるシンボリックリンクが `~/.ssh/id_rsa` を指している場合、ターゲットが allow ルールに失敗し、deny ルールにマッチするため、ブロックされます。505* **拒否ルール**: 要求されたパスまたはその解決先のファイルのいずれかがマッチする場合に適用されます。拒否されたファイルを指すシンボリックリンクは、それ自体が拒否されます。たとえば、`Read(./project/**)` が許可され、`Read(~/.ssh/**)` が拒否されている場合、`~/.ssh/id_rsa` を指す `./project/key` のシンボリックリンクはブロックされます。リンク先が許可ルールを満たさず、拒否ルールにマッチするためです。

506 506 

507macOS と Linux では、シンボリックリンク付きディレクトリを通じて記述された deny または ask ルール(`//`、`~/`、または `/` パターン)は、そのディレクトリの実際の場所にも適用されます。たとえば macOS では、`/etc` が `/private/etc` に解決される場合、`Read(//etc/**)` は `/private/etc/hosts` もブロックします。v2.1.268 より前では、シンボリックリンク付きディレクトリを通じて記述された deny または ask ルールは、その実際の場所で指定されたパスに適用されませんでした。507macOS と Linux では、`//`、`~/`、`/` パターンを使ってシンボリックリンクされたディレクトリを経由して書かれた拒否ルールまたは確認ルールは、そのディレクトリの実際の場所にも適用されます。たとえば、`/etc` が `/private/etc` に解決される macOS では、`Read(//etc/**)` は `/private/etc/hosts` もブロックします。v2.1.268 より前では、シンボリックリンクされたディレクトリを経由して書かれた拒否ルールまたは確認ルールは、実際の場所で指定されたパスには適用されませんでした。

508 508 

509Grep と Glob は `path` 引数が解決するディレクトリを検索します。Claude Code はそのディレクトリに `Read` deny ルールを適用します。509Grep と Glob は、`path` 引数の解決先のディレクトリを検索します。Claude Code は、そのディレクトリに `Read` 拒否ルールを適用します。

510 510 

511<h5 id="writes-through-a-symlink">511<h5 id="writes-through-a-symlink">

512 シンボリックリンクを通じた書き込み512 シンボリックリンクを介した書き込み

513</h5>513</h5>

514 514 

515Claude が編集または書き込みを要求するパスがそれ自体がシンボリックリンクである場合、Edit と Write ツールは [書き込みを拒否し、Claude をリンクのターゲットに向ける](/docs/ja/errors#refusing-after-a-symlink-changed)。515Claude が編集または書き込みを求めるパス自体がシンボリックリンクである場合、Edit ツールと Write ツールは[書き込みを拒否し、Claude にリンク先を指示します](/docs/ja/errors#refusing-after-a-symlink-changed)。

516 516 

517ディレクトリへのパスがシンボリックリンクである場合、またはファイルへのパスがシンボリックリンクを通じている場合、または Bash または PowerShell コマンドが書き込みを行う場合、書き込みはシンボリックリンクを通じて渡される可能性があります。これらの書き込みについて、何が起こるかは、書き込みが解決するファイルが [working directories](#working-directories) と [protected paths](/docs/ja/permission-modes#protected-paths) に対してどこに位置するかに依存します。517ファイルへの経路上のディレクトリがシンボリックリンクである場合や、Bash または PowerShell のコマンドが書き込みを行う場合は、書き込みがシンボリックリンクを通過することがあります。このような書き込みでは、書き込みの解決先のファイルが[作業ディレクトリ](#working-directories)と[保護されたパス](/docs/ja/permission-modes#protected-paths)に対してどこに位置するかによって動作が決まります。

518 518 

519* **作業ディレクトリの外に解決**:要求されたパスが作業ディレクトリ内にあり、解決先のファイルがそうでない場合、書き込みは [`acceptEdits` モード](/docs/ja/permission-modes#auto-approve-file-edits-with-acceptedits-mode)で自動承認されません。[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)では、allow ルールが書き込みを承認しない限り、分類器が決定する代わりに、書き込みについてプロンプトが表示されます。プロンプトは、書き込みが解決するパスを指定します。519* **作業ディレクトリ外に解決される場合**: 要求されたパスが作業ディレクトリ内にあり、その解決先のファイルが作業ディレクトリ外にある場合、[`acceptEdits` モード](/docs/ja/permission-modes#auto-approve-file-edits-with-acceptedits-mode)では書き込みは自動承認されません。[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)では、許可ルールが書き込みを承認しない限り、分類器が判断するのではなくユーザーに確認が求められます。確認には書き込みの解決先のパスが表示されます。

520* **要求されたパスが指定しない保護されたパスに解決**:[protected paths テーブル](/docs/ja/permission-modes#protected-paths)は各権限モードの結果を示しますが、テーブルが書き込みを分類器にルーティングする場合を除き、この書き込みはプロンプトを表示します。520* **要求されたパスが指定していない保護されたパスに解決される場合**: [保護されたパスの表](/docs/ja/permission-modes#protected-paths)に各権限モードでの結果が示されています。ただし、表で書き込みが分類器に回される場合、この書き込みでは代わりにユーザーに確認が求められます。

521 521 

522<h5 id="paths-that-can’t-be-resolved-or-that-change">522<h5 id="paths-that-can’t-be-resolved-or-that-change">

523 解決できないパスまたは変更されるパス523 解決できない、または変化するパス

524</h5>524</h5>

525 525 

526Claude Code がディスク上のパスがどこに導くかを判定できない場合(たとえば、シンボリックリンクがループを形成する場合)、Read、Edit、Write ツールは [操作を拒否](/docs/ja/errors#refusing-after-a-symlink-changed)。526たとえばパス上のシンボリックリンクがループを形成しているなどの理由で、Claude Code がパスのディスク上の行き先を判断できない場合、Read、Edit、Write ツールは[操作を拒否します](/docs/ja/errors#refusing-after-a-symlink-changed)。

527 527 

528ツールが承認されたファイルを開くとき、[パスが権限チェックが承認した場所にまだ解決されることを確認](/docs/ja/errors#refusing-after-a-symlink-changed)。528その後ツールが承認済みのファイルを開くときには、[パスが引き続き権限チェックで承認された場所に解決されることを確認します](/docs/ja/errors#refusing-after-a-symlink-changed)。

529 529 

530<h4 id="network-paths">530<h4 id="network-paths">

531 ネットワークパス531 ネットワークパス

532</h4>532</h4>

533 533 

534Read、Grep、Glob などの Claude のファイル読み取りツールがネットワークパスから読み取る場合、その読み取りには専用の権限チェックが行われます。ネットワークパスとは別のコンピューターに到達し得るパスのことで、Windows では `\\server\share\file` のような UNC パス、macOS と Linux では `/net/fileserver/notes.txt` のような `/net` 自動マウントパスを指します。このようなパスを参照すると、そのパスが指すホストと通信する場合があり、Windows ではその通信によって認証情報がホストに送信される可能性があります。シェルコマンドには独自のチェックがあります。Manual モードでは、引数に UNC パスを含む読み取り専用の Bash または PowerShell コマンドは [Windows では引き続きプロンプトを表示します](#read-only-commands)。534Read、Grep、Glob など、Claude のファイル読み取りツールがネットワークパスから読み取る場合、その読み取りには独自の権限チェックが行われます。ネットワークパスとは、別のコンピューターに到達しうるパスのことです。Windows では `\\server\share\file` のような UNC パス、macOS と Linux では `/net/fileserver/notes.txt` のような `/net` 自動マウントパスが該当します。このようなパスを参照すると、そのパスで指定されたホストに接続する可能性があり、Windows ではその接続によってホストに認証情報が送信される可能性があります。シェルコマンドには独自のチェックがあります。Manual モードでは、UNC パスを引数に含む読み取り専用の Bash または PowerShell コマンドは [Windows 上で引き続き確認を求めます](#read-only-commands)。

535 535 

536Claude Code v2.1.292 以降では、次のいずれもプロンプトを省略しません。536Claude Code v2.1.292 以降では、次のいずれの場合も確認はそのまま残ります。

537 537 

538* **Allow ルール**:`Read` のようなツール全体に対するルールを含め、ルールは読み取りを事前承認しません538* **許可ルール**: `Read` のようなツール全体に対するルールを含め、ルールは読み取りを事前承認しません

539* **PreToolUse フック**:`"allow"` を返す[フック](#extend-permissions-with-hooks)はプロンプトをスキップしません539* **PreToolUse フック**: `"allow"` を返す[フック](#extend-permissions-with-hooks)は確認をスキップしません

540* **auto モード**:プロンプトはユーザーに表示され、[分類器](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)は読み取りを判定しません540* **auto モード**: 確認はユーザーに届き、[分類器](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)は読み取りを判断しません

541 541 

542`dontAsk` モードでは、Claude Code はプロンプトを表示する代わりに読み取りを拒否します。`bypassPermissions` モード、および [bypass permissions](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode) が利用可能な plan モードの対話型ターミナルセッションでは、このプロンプトなしで読み取りが実行されます。542`dontAsk` モードでは、Claude Code は確認を求める代わりに読み取りを拒否します。`bypassPermissions` モード、および[権限のバイパス](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)が利用可能な plan モードの対話型ターミナルセッションでは、読み取りはこの確認なしで実行されます。

543 543 

544このプロンプトなしでネットワーク共有上のファイルを読み取るには、まず共有にローカルパスを割り当てます。544この確認なしでネットワーク共有上のファイルを読み取るには、まず共有にローカルパスを割り当ててください。

545 545 

546* **Windows**:[作業ディレクトリ](#working-directories)で説明されているように、共有をドライブ文字にマップし、Claude Code の起動時に `--add-dir` でそのドライブを渡します546* **Windows**: [作業ディレクトリ](#working-directories)で説明されているように、共有をドライブ文字にマッピングし、Claude Code の起動時に `--add-dir` でそのドライブを渡します

547* **macOS と Linux**:[作業ディレクトリがネットワークパスである場合](/docs/ja/errors#working-directory-is-a-network-path)で説明されているように、`/mnt` や `/Volumes` 配下のディレクトリなどのローカルパスに共有をマウントし、そこからファイルを読み取ります547* **macOS と Linux**: [Working directory is a network path](/docs/ja/errors#working-directory-is-a-network-path) で説明されているように、`/mnt` や `/Volumes` 配下のディレクトリなどのローカルパスに共有をマウントし、そこからファイルを読み取ります

548 548 

549<h3 id="webfetch">549<h3 id="webfetch">

550 WebFetch550 WebFetch

551</h3>551</h3>

552 552 

553WebFetch ルールは `domain:` プレフィックスを使用し、リクエストされた URL のホスト名に対してマッチします。マッチングは大文字と小文字を区別せず、`*` ワイルドカードをサポートし、ルールとホスト名の両方から末尾の `.` をストリップするため、`example.com.` と `example.com` は同じものとして扱われます。553WebFetch ルールは `domain:` プレフィックスを使用し、要求された URL のホスト名に対してマッチします。マッチングでは大文字と小文字は区別されず、`*` ワイルドカードをサポートし、ルールとホスト名の両方から末尾の `.` を取り除くため、`example.com.` と `example.com` は同じものとして扱われます。

554 554 

555* `WebFetch(domain:example.com)` は `example.com` へのリクエストのみをマッチさせます。`api.example.com` などのサブドメインもカバーするには、`WebFetch(domain:*.example.com)` ルールを追加します555* `WebFetch(domain:example.com)` は `example.com` へのリクエストのみにマッチします。`api.example.com` のようなサブドメインもカバーするには、`WebFetch(domain:*.example.com)` ルールを追加してください

556* `WebFetch(domain:*.example.com)` は `api.example.com` や `a.b.example.com` などの任意の深さのサブドメインをマッチさせますが、`example.com` 自体はマッチさせません556* `WebFetch(domain:*.example.com)` は、`api.example.com` や `a.b.example.com` など任意の深さのサブドメインにマッチしますが、`example.com` 自体にはマッチしません

557* `WebFetch(domain:*)` はすべてのドメインをマッチさせます。ベア `WebFetch` ルールと同じではありません。[すべてのフェッチを許可または拒否](#allow-or-deny-every-fetch)を参照してください557* `WebFetch(domain:*)` はすべてのドメインにマッチします。これは単独の `WebFetch` ルールとは異なります。[すべての取得を許可または拒否する](#allow-or-deny-every-fetch)を参照してください

558 558 

559先頭の `*.` またはベア `*` 以外の任意の位置では、ワイルドカードは 2 つのドット間のテキストのみをマッチさせます。`WebFetch(domain:example.*)` は `example.org` にマッチします。ここで `*` は `org` になりますが、`example.evil.com` にはマッチしません。ここで `*` は `evil.com` になり、ドットを越えます。これにより、末尾のワイルドカードが攻撃者が登録できるドメインをマッチさせるのを防ぎます。559先頭の `*.` または単独の `*` 以外の位置では、ワイルドカードは 2 つのドットの間のテキストにのみマッチします。`WebFetch(domain:example.*)` は `*` が `org` になる `example.org` にはマッチしますが、`*` が `evil.com` になってドットをまたぐ必要がある `example.evil.com` にはマッチしません。これにより、末尾のワイルドカードが攻撃者が登録しうるドメインにマッチすることを防ぎます。

560 560 

561`WebFetch` ルールのワイルドカードは、フェッチをマッチさせるために Claude Code v2.1.172 以降が必要です。561`WebFetch` ルールのワイルドカードで取得をマッチさせるには、Claude Code v2.1.172 以降が必要です。

562 562 

563<h4 id="allow-or-deny-every-fetch">563<h4 id="allow-or-deny-every-fetch">

564 すべてのフェッチを許可または拒否564 すべての取得を許可または拒否する

565</h4>565</h4>

566 566 

567ベア `WebFetch` ルールは、`"deny": ["WebFetch"]` などの `domain:` 部分のないツール名です。それと `WebFetch(domain:*)` の両方はすべての URL をカバーしますが、Claude Code はそれらを異なる方法で適用し、`domain:` 形式のみがそのドメインをサンドボックスの [許可または拒否ドメインリスト](/docs/ja/sandboxing#network-isolation)に追加します。そのセクションはサンドボックスが尊重するワイルドカード形式とベア `*` を追加したバージョンをリストしています。567単独の `WebFetch` ルールとは、`"deny": ["WebFetch"]` のように `domain:` 部分を持たないツール名です。これと `WebFetch(domain:*)` はどちらもすべての URL をカバーしますが、Claude Code はそれらを異なる方法で適用し、`domain:` 形式のみがそのドメインをサンドボックスの[許可または拒否ドメインリスト](/docs/ja/sandboxing#network-isolation)にも追加します。そのセクションには、サンドボックスが受け入れるワイルドカード形式と、単独の `*` が追加されたバージョンが記載されています。

568 568 

569各行は、`allow` リストと `deny` リストでルールが何をするかを示しています。569各行は、ルールが `allow` リストと `deny` リストでそれぞれ何をするかを示しています。

570 570 

571| ルール | `allow` で | `deny` で |571| ルール | `allow` の場合 | `deny` の場合 |

572| :- | :- | :- |572| :- | :- | :- |

573| `WebFetch` | Claude はプロンプトなしでフェッチします。サンドボックス化されたコマンドが到達できるホストを変更しません。 | Claude Code は `WebFetch` ツールを削除するため、Claude はまったくフェッチできません。サンドボックス化されたコマンドが到達できるホストを変更しません。 |573| `WebFetch` | Claude は確認なしで取得します。サンドボックス化されたコマンドが到達できるホストは変わりません。 | Claude Code は `WebFetch` ツールを削除するため、Claude は一切取得できません。サンドボックス化されたコマンドが到達できるホストは変わりません。 |

574| `WebFetch(domain:*)` | Claude はプロンプトなしでフェッチし、サンドボックス化されたコマンドは任意のホストに到達できます。 | Claude Code はツールを保持し、各フェッチを拒否し、サンドボックス化されたコマンドはホストに到達できません。 |574| `WebFetch(domain:*)` | Claude は確認なしで取得し、サンドボックス化されたコマンドは任意のホストに到達できます。 | Claude Code はツールを保持したまま各取得を拒否し、サンドボックス化されたコマンドはどのホストにも到達できません。 |

575 575 

5762 つの形式は [artifacts](/docs/ja/artifacts)(Artifact ツールが claude.ai に公開するページ)の読み取りについても異なります。ベア `WebFetch` deny または ask ルールはこれらの読み取りに適用されません。`claude.ai` または `*.claudeusercontent.com` コンテンツホストをカバーする `domain:` ルール(`WebFetch(domain:claude.ai)` または `WebFetch(domain:*)` など)は、各読み取りを拒否するか、その前にプロンプトを表示します。[`Artifact` ルール](/docs/ja/artifacts#disable-artifacts)も同じことを行います。5762 つの形式は、Artifact ツールが claude.ai に公開するページである[アーティファクト](/docs/ja/artifacts)の読み取りについても異なります。単独の `WebFetch` 拒否ルールまたは確認ルールは、それらの読み取りには適用されません。`WebFetch(domain:claude.ai)` や `WebFetch(domain:*)` のように、`claude.ai` または `*.claudeusercontent.com` コンテンツホストをカバーする `domain:` ルールは、各読み取りを拒否するか、その前に確認を求めます。[`Artifact` ルール](/docs/ja/artifacts#disable-artifacts)も同じ動作をします。

577 577 

578ルールが読み取りをブロックするとき、拒否はルールを指定します。v2.1.268 より前では、ベア `WebFetch` deny ルールはすべての artifact 読み取りをブロックし、ベア ask ルールはそれぞれの前にプロンプトを表示していました。578ルールが読み取りをブロックすると、拒否メッセージにそのルールが表示されます。v2.1.268 より前では、単独の `WebFetch` 拒否ルールはすべてのアーティファクトの読み取りをブロックし、単独の確認ルールはそれぞれの読み取りの前に確認を求めていました。

579 579 

580Claude がフェッチを自由に行えるようにしながら、サンドボックス許可リストをそのままにするには、ベア形式を使用してください。この `settings.json` はそれを行います。580サンドボックスの許可リストをそのままにしつつ Claude に自由に取得させるには、単独の形式を使用します。次の `settings.json` はそれを行います。

581 581 

582```json theme={null}582```json theme={null}

583{583{


587}587}

588```588```

589 589 

590Claude にページをフェッチするよう求めると、プロンプトなしでフェッチします。[サンドボックス化](/docs/ja/sandboxing)された `curl` をサンドボックス許可リストの外のホストに対して実行するよう求めると、Claude Code はそのホストに対してプロンプトを表示します。ベア形式はホストを許可リストに追加しなかったためです。590Claude にページの取得を依頼すると、確認なしで取得します。サンドボックスの許可リスト外のホストに対して[サンドボックス化された](/docs/ja/sandboxing) `curl` の実行を依頼した場合、単独のルールはそのホストを許可リストに追加していないため、Claude Code は引き続きそのホストについて確認を求めます。

591 591 

592[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)では、Claude は代わりにホストを分類器がレビューするコマンドの [per-command allowed domains](/docs/ja/sandboxing#per-command-allowed-domains-in-auto-mode) に指定します。592[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)では、Claude は代わりに、分類器がレビューできるよう、コマンドの[コマンドごとの許可ドメイン](/docs/ja/sandboxing#per-command-allowed-domains-in-auto-mode)にそのホストを指定します。

593 593 

594<h3 id="mcp">594<h3 id="mcp">

595 MCP595 MCP

596</h3>596</h3>

597 597 

598MCP サーバーのすべてのツールにマッチさせるには、`mcp__<server>__*` と記述します。1 つのツールにマッチさせるには、その完全な名前 `mcp__<server>__<tool>` を記述します。598MCP サーバーのすべてのツールにマッチさせるには、`mcp__<server>__*` と書きます。1 つのツールにマッチさせるには、その完全な名前 `mcp__<server>__<tool>` を書きます。

599 599 

600* `mcp__puppeteer` は `puppeteer` サーバーによって提供されるツールをマッチさせます600* `mcp__puppeteer` は `puppeteer` サーバーが提供する任意のツールにマッチします

601* `mcp__puppeteer__*` ワイルドカード構文を使用し、`puppeteer` サーバーからのすべてのツールもマッチさせます601* `mcp__puppeteer__*` はワイルドカード構文を使用し、同じく `puppeteer` サーバーのすべてのツールにマッチします

602* `mcp__puppeteer__puppeteer_navigate` は `puppeteer` サーバーによって提供される `puppeteer_navigate` ツールをマッチさせます602* `mcp__puppeteer__puppeteer_navigate` は `puppeteer` サーバーが提供する `puppeteer_navigate` ツールにマッチします

603 603 

604`<server>` には、そのサーバーのツール名に現れるとおりのサーバー名を記述します。次の例は、特殊文字を含む名前、プラグインのサーバー、`__` を含むか `_` で終わる名前に対して記述するルールを示しています。604`<server>` には、そのサーバーのツール名に表示されるとおりにサーバー名を書きます。以下の例は、特殊文字を含む名前、プラグインのサーバー、および `__` を含む、または `_` で終わる名前について書くべきルールを示しています。

605 605 

606* **`.` やスペースなどの文字を含む名前**:これらの文字は `_` になるため、`my.server` として設定したサーバーには `mcp__my_server__*` と記述します606* **`.` やスペースなどの文字を含む名前**: これらの文字は `_` になるため、`my.server` として設定したサーバーには `mcp__my_server__*` と書きます

607* **プラグインが提供するサーバー**:`<server>` は[プラグインスコープの形式](/docs/ja/mcp#plugin-provided-mcp-servers)になるため、`my-plugin` という名前のプラグイン内の `database-tools` サーバーには `mcp__plugin_my-plugin_database-tools__*` と記述します607* **プラグインが提供するサーバー**: `<server>` は[プラグインスコープの形式](/docs/ja/mcp#plugin-provided-mcp-servers)をとるため、`my-plugin` という名前のプラグイン内の `database-tools` サーバーには `mcp__plugin_my-plugin_database-tools__*` と書きます

608* **`__` を含むか `_` で終わる `<server>`**:名前全体を使ったワイルドカード形式 `mcp__<server>__*` を記述します。`reports__v2` という名前のサーバーには `mcp__reports__v2__*` と記述します。ベアの `mcp__reports__v2` や短い `mcp__reports` は、Claude Code がどちらも `reports` という名前のサーバーのルールとして読み取るため、allow ルールとしてはそのツールにマッチしません608* **`__` を含む、または `_` で終わる `<server>`**: 名前全体を使ったワイルドカード形式 `mcp__<server>__*` を書きます。`reports__v2` という名前のサーバーには、`mcp__reports__v2__*` と書きます。単独の `mcp__reports__v2` や短い `mcp__reports` は、Claude Code がどちらも `reports` という名前のサーバーに対するルールとして読み取るため、許可ルールとしてはそのツールにマッチしません

609 609 

610組織が [claude.ai コネクタ](/docs/ja/mcp#organization-controls-on-connector-tools)ツールを `ask` に設定している場合、そのツールの allow ルールは有効になりません。Claude Code は `auto` および `bypassPermissions` モードでも、すべての呼び出しでプロンプトを表示します。プロンプトを表示しない `dontAsk` モードでは、Claude Code は代わりに呼び出しを拒否します。Claude Code が自分で取得するコネクタからのツールは `mcp__claude_ai_<server>__<tool>` として表示されます。610組織が [claude.ai コネクタ](/docs/ja/mcp#organization-controls-on-connector-tools)のツールを `ask` に設定しており、その設定がセッション内の Claude Code に届いている場合、そのツールに対する許可ルールは効果を持ちません。Claude Code は `auto` モードや `bypassPermissions` モードであっても、すべての呼び出しで確認を求めます。確認を一切求めない `dontAsk` モードでは、Claude Code は代わりに呼び出しを拒否します。Claude Code 自体が取得するコネクタのツールは、`mcp__claude_ai_<server>__<tool>` として表示されます。

611 611 

612Claude Desktop アプリの [Cowork](https://claude.com/docs/cowork/overview)セッションでは、Claude は組み込み `Bash` ツールではなく Cowork の `mcp__workspace__bash` ツールを通じてシェルコマンドを実行し、Cowork は同様に `mcp__workspace__web_fetch` をウェブフェッチに提供します。Claude Code はまた、全体の `Bash` または `WebFetch` ツールを指す deny ルールをこれらの Cowork ツールに適用するため、管理された `Bash` deny ルールは Claude が Cowork でシェルコマンドを実行するのを停止します。Claude Code がそのような呼び出しをブロックするとき、メッセージは Cowork ツールを指定します。`Permission to use mcp__workspace__bash has been denied.` Allow ルールは引き継がれません。Claude Code は `Bash` allow ルールを `mcp__workspace__bash` に適用することはありません。612Claude Desktop アプリの [Cowork](https://claude.com/docs/cowork/overview) セッションでは、Claude は組み込みの `Bash` ツールではなく Cowork の `mcp__workspace__bash` ツールを通じてシェルコマンドを実行し、同様に Cowork は Web 取得用に `mcp__workspace__web_fetch` を提供します。Claude Code は、`Bash` または `WebFetch` ツール全体を指定する拒否ルールをこれらの Cowork ツールにも適用するため、管理設定の `Bash` 拒否ルールは Claude が Cowork でシェルコマンドを実行するのを止めます。Claude Code がそのような呼び出しをブロックすると、メッセージには Cowork ツールの名前が表示されます: `Permission to use mcp__workspace__bash has been denied.` 許可ルールは引き継がれません。Claude Code が `Bash` 許可ルールを `mcp__workspace__bash` に適用することはありません。

613 613 

614<h3 id="agent-subagents">614<h3 id="agent-subagents">

615 Agent(subagents)615 Agent(サブエージェント)

616</h3>616</h3>

617 617 

618`Agent(AgentName)` ルールを使用して、Claude が使用できる [subagents](/docs/ja/sub-agents) を制御します。618`Agent(AgentName)` ルールを使用して、Claude が使用できる[サブエージェント](/docs/ja/sub-agents)を制御します。

619 619 

620* `Agent(Explore)` は Explore subagent をマッチさせます620* `Agent(Explore)` は Explore サブエージェントにマッチします

621* `Agent(Plan)` は Plan subagent をマッチさせます621* `Agent(Plan)` は Plan サブエージェントにマッチします

622* `Agent(my-custom-agent)` は `my-custom-agent` という名前のカスタム subagent をマッチさせます622* `Agent(my-custom-agent)` は `my-custom-agent` という名前のカスタムサブエージェントにマッチします

623 623 

624これらのルールを設定の `deny` 配列に追加するか、`--disallowedTools` CLI フラグを使用して特定のエージェントを無効にします。Explore エージェントを無効にするには:624特定のエージェントを無効にするには、これらのルールを設定の `deny` 配列に追加するか、`--disallowedTools` CLI フラグを使用します。Explore エージェントを無効にするには、次のようにします。

625 625 

626```json theme={null}626```json theme={null}

627{627{


635 Cd635 Cd

636</h3>636</h3>

637 637 

638`Cd` ルールは、[`/cd` コマンド](/docs/ja/commands)がセッションを移動できるディレクトリを制御します。`Cd` はモデル呼び出し可能なツールではありません。Claude はそれを呼び出すことはできず、ルールは自分で `/cd` を実行する場合にのみ適用されます。638`Cd` ルールは、[`/cd` コマンド](/docs/ja/commands)がセッションを移動できるディレクトリを制御します。`Cd` はモデルが呼び出せるツールではありません。Claude はこれを呼び出すことができず、ルールはユーザー自身が `/cd` を実行した場合にのみ適用されます。

639 639 

640ベア `Cd` deny ルールは `/cd` を完全に無効にします。`Cd(<path-pattern>)` deny ルールはマッチするターゲットをブロックします。Deny ルールはターゲットのすべてのスペルをチェックします。これには、それが解決する各シンボリックリンクホップが含まれるため、1 つのパス用に記述されたルールは、それに解決するターゲットもブロックします。640単独の `Cd` 拒否ルールは `/cd` を完全に無効にします。`Cd(<path-pattern>)` 拒否ルールは、マッチする移動先をブロックします。拒否ルールは、解決の過程で経由する各シンボリックリンクのホップを含め、移動先のあらゆる表記をチェックするため、あるパスに対して書かれたルールは、そのパスに解決される移動先もブロックします。

641 641 

642任意の `Cd` allow ルールを追加すると、`/cd` をホワイトリストモードに切り替えます。解決されたターゲットディレクトリは、allow ルールの 1 つにマッチする必要があります。そうでない場合、`/cd` は拒否します。`Cd` ルールが設定されていない場合、`/cd` はデフォルト動作を保持し、見慣れないディレクトリを信頼するようにプロンプトを表示します。642`Cd` 許可ルールを 1 つでも追加すると、`/cd` は許可リストモードに切り替わります。解決された移動先のディレクトリがいずれかの許可ルールにマッチする必要があり、マッチしない場合 `/cd` は拒否します。`Cd` ルールが設定されていない場合、`/cd` はデフォルトの動作を維持し、見慣れないディレクトリを信頼するかどうかの確認を求めます。

643 643 

644パスパターンは [Read と Edit ルール](#read-and-edit)から `//`、`~/`、`/` アンカーを共有しますが、マッチングはディレクトリパス全体にアンカーされます。gitignore スタイルではなく、`*` は正確に 1 つのパスセグメントをマッチさせ、`**` はセグメント全体でマッチさせます。末尾の `/**` はその名前付きルートもマッチさせます。644パスパターンは [Read と Edit のルール](#read-and-edit)と同じ `//`、`~/`、`/` の基準を共有しますが、マッチングは gitignore スタイルではなくディレクトリパス全体に対して行われます。`*` はちょうど 1 つのパスセグメントにマッチし、`**` はセグメントをまたいでマッチします。末尾の `/**` は、指定されたルート自体にもマッチします。

645 645 

646| ルール | マッチ | マッチしない |646| ルール | マッチするもの | マッチしないもの |

647| - | - | - |647| - | - | - |

648| `Cd(~/code/*)` | `~/code/app` | `~/code/app/src`、`~/code` |648| `Cd(~/code/*)` | `~/code/app` | `~/code/app/src`、`~/code` |

649| `Cd(~/code/**)` | `~/code` およびその下のディレクトリ | `~/code` の外のディレクトリ |649| `Cd(~/code/**)` | `~/code` およびその配下の任意のディレクトリ | `~/code` 外のディレクトリ |

650| `Cd(**/node_modules)` | 現在のディレクトリ配下の任意の深さにある任意の `node_modules` ディレクトリ | `node_modules/pkg` |650| `Cd(**/node_modules)` | 現在のディレクトリ配下の任意の深さにある任意の `node_modules` ディレクトリ | `node_modules/pkg` |

651 651 

652<h2 id="extend-permissions-with-hooks">652<h2 id="extend-permissions-with-hooks">


762 762 

763サンドボックス化を有効にし、`autoAllowBashIfSandboxed` をデフォルトの `true` のままにしている場合、権限に単独の `Bash` 確認ルール、または[同等の `Bash(*)` 形式](#match-all-uses-of-a-tool)が含まれていても、サンドボックス化された Bash コマンドは確認なしで実行されます。サンドボックスの境界が、このツール全体に対する確認の代わりになるためです。763サンドボックス化を有効にし、`autoAllowBashIfSandboxed` をデフォルトの `true` のままにしている場合、権限に単独の `Bash` 確認ルール、または[同等の `Bash(*)` 形式](#match-all-uses-of-a-tool)が含まれていても、サンドボックス化された Bash コマンドは確認なしで実行されます。サンドボックスの境界が、このツール全体に対する確認の代わりになるためです。

764 764 

765[plan モード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)では、Claude Code はこの代替を行いません。確認ルールがない場合、[組み込みの読み取り専用コマンド](#read-only-commands)は引き続き確認なしで実行され、それ以外のシェルコマンドは、計画中である間は通常の権限フローを経由します。plan モードで Claude Code がコマンドをどのように制御するかについては、[plan モード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)を参照してください。単独の `Bash` 確認ルールがある場合は、サンドボックス化されていない場合と同様に、サンドボックス化された読み取り専用コマンドを含むすべての Bash コマンドで確認が求められます。v2.1.212 より前は、この代替は plan モードでも適用されていました。765[plan モード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)では、Claude Code はこの代替を行いません。確認ルールがない場合、[組み込みの読み取り専用コマンド](#read-only-commands)は引き続き確認なしで実行され、それ以外のシェルコマンドは、計画中である間は通常の権限フローを経由します。plan モードで Claude Code がコマンドをどのように制御するかについては、[plan モード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)を参照してください。単独の `Bash` 確認ルールがある場合は、サンドボックス化されていない場合と同様に、サンドボックス化された読み取り専用コマンドを含むすべての Bash コマンドで確認が求められます。

766 766 

767次のチェックは引き続き適用されます。767次のチェックは引き続き適用されます。

768 768 

Details

95 95 

96 <Steps>96 <Steps>

97 <Step title="プラグインブラウザを開く">97 <Step title="プラグインブラウザを開く">

98 プロンプトボックスの横にある **+** ボタンをクリックし、**Plugins** を選択してから **Add plugin** を選択します。プラグインブラウザがマーケットプレイスのプラグインと共に開きます。98 プロンプトボックスの横にある **+** ボタンをクリックし、**Add plugins** を選択します。**+** メニューに **Add plugins** ではなく **Plugins** が表示される場合は、**Plugins** を選択してから **Browse plugins** を選択します。プラグインブラウザがマーケットプレイスのプラグインと共に開きます。

99 </Step>99 </Step>

100 100 

101 <Step title="プラグインを選択する">101 <Step title="プラグインを選択する">

102 `commit-commands` を見つけて選択します。102 `commit-commands` を見つけて選択します。

103 </Step>103 </Step>

104 104 

105 <Step title="範囲を選択する">105 <Step title="スコープを選択する">

106 [範囲](#choose-an-install-scope)を選択します。ユーザーアカウント、このプロジェクト、またはローカルのみ。106 [スコープ](#choose-an-install-scope)を選択します。ユーザーアカウント、このプロジェクト、またはローカルのみ。

107 </Step>107 </Step>

108 </Steps>108 </Steps>

109 109 

110 後で有効化、無効化、またはアンインストールするには、**+ > Plugins > Manage plugins** を使用します。プラグインブラウザはデスクトップアプリのクラウドセッションでは利用できません。[デスクトップアプリでプラグインをインストール](/docs/ja/desktop#install-plugins)を参照してください。110 後でプラグインを有効化、無効化、またはアンインストールするには、[デスクトップアプリでプラグインをインストール](/docs/ja/desktop#install-plugins)を参照してください。

111 </Tab>111 </Tab>

112 112 

113 <Tab title="VS Code">113 <Tab title="VS Code">

Details

362 VS Code 拡張機能で描画する362 VS Code 拡張機能で描画する

363</h3>363</h3>

364 364 

365VS Code 拡張機能では、拡張機能のバージョン 2.1.299 以降で、[機能フラグを取得する](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッションにおいて、mod が描画する内容がチャットパネルに表示されます。パネル向けの `ui.render` フックでは、`e.surface` は `vscode` です。パネルがどの描画箇所と要素を描画し、どの props を無視するかについては、[描画箇所](/docs/ja/plugins/mods/reference#render-sites)と[要素](/docs/ja/plugins/mods/reference#elements)の表を参照してください。365VS Code 拡張機能では、拡張機能のバージョン 2.1.299 以降で、mod が描画する内容がチャットパネルに表示されます。Amazon Bedrock 上のセッションなど、[機能フラグを取得しない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッションでは、2.1.304 以降が必要です。パネル向けの `ui.render` フックでは、`e.surface` は `vscode` です。パネルがどの描画箇所と要素を描画し、どの props を無視するかについては、[描画箇所](/docs/ja/plugins/mods/reference#render-sites)と[要素](/docs/ja/plugins/mods/reference#elements)の表を参照してください。

366 366 

367mod をターミナルだけでなくパネルでも機能させるには、次の違いを考慮してください。367mod をターミナルだけでなくパネルでも機能させるには、次の違いを考慮してください。

368 368 

Details

219| ターミナルの `claude`。エディタの統合ターミナルと JetBrains プラグインを含む | はい | はい |219| ターミナルの `claude`。エディタの統合ターミナルと JetBrains プラグインを含む | はい | はい |

220| Desktop アプリの Code タブ。WSL セッションを除く | はい | はい。[elements テーブル](/docs/ja/plugins/mods/reference#elements) がターミナルのみとしてマークしている要素を除く |220| Desktop アプリの Code タブ。WSL セッションを除く | はい | はい。[elements テーブル](/docs/ja/plugins/mods/reference#elements) がターミナルのみとしてマークしている要素を除く |

221| Desktop アプリの [WSL セッション](/docs/ja/desktop-wsl) | いいえ。WSL セッションではプラグインが利用できないため | いいえ |221| Desktop アプリの [WSL セッション](/docs/ja/desktop-wsl) | いいえ。WSL セッションではプラグインが利用できないため | いいえ |

222| VS Code 拡張機能のチャットパネル | はい | はい。拡張機能のバージョン 2.1.299 以降で、[機能フラグを取得する](/docs/ja/env-vars#features-that-need-feature-flag-fetching) セッションの場合。パネルが描画するものは [描画箇所](/docs/ja/plugins/mods/reference#render-sites) テーブルと [elements](/docs/ja/plugins/mods/reference#elements) テーブルに示されています。 |222| VS Code 拡張機能のチャットパネル | はい | はい。拡張機能のバージョン 2.1.299 以降が必要です。Amazon Bedrock 上のセッションなど、[機能フラグを取得しない](/docs/ja/env-vars#features-that-need-feature-flag-fetching) セッションでは 2.1.304 以降が必要です。パネルが描画するものは [描画箇所](/docs/ja/plugins/mods/reference#render-sites) テーブルと [elements](/docs/ja/plugins/mods/reference#elements) テーブルに示されています。 |

223| `claude -p` と [Agent SDK](/docs/ja/agent-sdk/overview) | はい | いいえ |223| `claude -p` と [Agent SDK](/docs/ja/agent-sdk/overview) | はい | いいえ |

224| claude.ai またはモバイルアプリからの [Remote Control](/docs/ja/remote-control) | はい。マシン上のセッションで | マシン上のターミナルに表示 |224| claude.ai またはモバイルアプリからの [Remote Control](/docs/ja/remote-control) | はい。マシン上のセッションで | マシン上のターミナルに表示 |

225| [クラウドセッション](/docs/ja/claude-code-on-the-web) | はい。[クラウドセッションに引き継がれる](/docs/ja/cloud-environments#what-carries-over-from-your-setup) プラグインの場合 | いいえ |225| [クラウドセッション](/docs/ja/claude-code-on-the-web) | はい。[クラウドセッションに引き継がれる](/docs/ja/cloud-environments#what-carries-over-from-your-setup) プラグインの場合 | いいえ |

Details

257 257 

258描画箇所は、Claude Code のインターフェースにおける拡張ポイントです。各行は `ui.render` フックにおける `e.component` の値で、`e.props` のフィールドと、それを描画するアプリを示しています。`e.surface` は描画しているアプリの名前で、`terminal`、`desktop`、`vscode` などです。各描画箇所でフックができることは、[Claude Code がすでに描画しているものを変更する](/docs/ja/plugins/mods/interface#change-what-claude-code-already-draws)で、選択肢ごとの例とともに説明しています。258描画箇所は、Claude Code のインターフェースにおける拡張ポイントです。各行は `ui.render` フックにおける `e.component` の値で、`e.props` のフィールドと、それを描画するアプリを示しています。`e.surface` は描画しているアプリの名前で、`terminal`、`desktop`、`vscode` などです。各描画箇所でフックができることは、[Claude Code がすでに描画しているものを変更する](/docs/ja/plugins/mods/interface#change-what-claude-code-already-draws)で、選択肢ごとの例とともに説明しています。

259 259 

260VS Code 拡張機能での描画には、拡張機能のバージョン 2.1.299 以降と、[機能フラグを取得する](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッションが必要です。拡張機能で描画が異なる点については、[VS Code 拡張機能で描画する](/docs/ja/plugins/mods/interface#draw-in-the-vs-code-extension)に一覧があります。260VS Code 拡張機能での描画には、拡張機能のバージョン 2.1.299 以降が必要です。[機能フラグを取得しない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッションでは、2.1.304 以降が必要です。拡張機能で描画が異なる点については、[VS Code 拡張機能で描画する](/docs/ja/plugins/mods/interface#draw-in-the-vs-code-extension)に一覧があります。

261 261 

262| 描画箇所 | `e.props` | `e.requestId` | 描画されるアプリ |262| 描画箇所 | `e.props` | `e.requestId` | 描画されるアプリ |

263| :- | :- | :- | :- |263| :- | :- | :- | :- |

Details

315 315 

316* **描画箇所または要素がそのアプリで描画されない**: [描画箇所](/docs/ja/plugins/mods/reference#render-sites) の表で描画箇所を、[要素](/docs/ja/plugins/mods/reference#elements) の表で要素を調べます。アプリにない要素については、フック内で `e.surface` を確認し、アプリが描画できるツリーを返します。316* **描画箇所または要素がそのアプリで描画されない**: [描画箇所](/docs/ja/plugins/mods/reference#render-sites) の表で描画箇所を、[要素](/docs/ja/plugins/mods/reference#elements) の表で要素を調べます。アプリにない要素については、フック内で `e.surface` を確認し、アプリが描画できるツリーを返します。

317* **VS Code 拡張機能が 2.1.299 より古い**: チャットパネルは [拡張機能のバージョン](/docs/ja/vs-code#install-the-extension) 2.1.299 から mod の描画を行います。VS Code の拡張機能ビューでバージョンを確認し、そこで拡張機能を更新してください。317* **VS Code 拡張機能が 2.1.299 より古い**: チャットパネルは [拡張機能のバージョン](/docs/ja/vs-code#install-the-extension) 2.1.299 から mod の描画を行います。VS Code の拡張機能ビューでバージョンを確認し、そこで拡張機能を更新してください。

318* **VS Code セッションがフィーチャーフラグを取得しない**: チャットパネルでの描画にはフィーチャーフラグの取得が必要です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry 上のセッション、または [Claude apps gateway](/docs/ja/claude-apps-gateway) を経由するセッションは、[フィーチャーフラグの取得が必要な機能](/docs/ja/env-vars#features-that-need-feature-flag-fetching) に記載されているその他のセッションと同様に、これをスキップします。そのようなセッションで描画を確認するには、代わりに VS Code の統合ターミナルなどのターミナルで `claude` を実行してください。318* **拡張機能が 2.1.304 より古く、セッションがフィーチャーフラグを取得しない**: 拡張機能を更新するか、代わりに VS Code の統合ターミナルで `claude` を実行してください。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry 上のセッションは取得をスキップします。[Claude apps gateway](/docs/ja/claude-apps-gateway) セッションなど、取得をスキップするその他のセッションについては、[フィーチャーフラグの取得が必要な機能](/docs/ja/env-vars#features-that-need-feature-flag-fetching) を参照してください。

319 319 

320<h2 id="an-edit-or-a-value-is-lost">320<h2 id="an-edit-or-a-value-is-lost">

321 編集または値が失われる321 編集または値が失われる

Details

40 40 

41代わりに、使用しているサーフェスからプラグインをインストールしてください:41代わりに、使用しているサーフェスからプラグインをインストールしてください:

42 42 

43* **Claude デスクトップアプリ、ローカルまたは SSH セッション**:プロンプトの横にある **+** ボタンをクリックし、**プラグイン**、**プラグインを追加**をクリックして[プラグインブラウザ](/docs/ja/desktop#install-plugins)を開きます43* **Claude デスクトップアプリ、ローカルまたは SSH セッション**:[プラグインをインストール](/docs/ja/plugins/install#install-a-plugin)の下の **Desktop app** タブを使用してください

44* **VS Code 拡張**:[プラグインをインストール](/docs/ja/plugins/install#install-a-plugin)の下の **VS Code** タブを使用してください44* **VS Code 拡張**:[プラグインをインストール](/docs/ja/plugins/install#install-a-plugin)の下の **VS Code** タブを使用してください

45* **Web 上の Claude Code、またはデスクトップクラウドセッション**:クラウドセッションにはプラグインブラウザがありません。[プラグインをインストール](/docs/ja/plugins/install#install-a-plugin)の下の **Cloud session** タブを参照して、クラウドセッションが読み込むものを確認してください45* **Web 上の Claude Code、またはデスクトップクラウドセッション**:クラウドセッションにはプラグインブラウザがありません。[プラグインをインストール](/docs/ja/plugins/install#install-a-plugin)の下の **Cloud session** タブを参照して、クラウドセッションが読み込むものを確認してください

46* **アクセス権のあるターミナル**:`claude` を実行してそこで `/plugin` を入力するか、セッションを開始せずにシェルで `claude plugin install <plugin>@<marketplace>` を実行してください46* **アクセス権のあるターミナル**:`claude` を実行してそこで `/plugin` を入力するか、セッションを開始せずにシェルで `claude plugin install <plugin>@<marketplace>` を実行してください

Details

122mkdir -p ~/.claude && { [ -f ~/.claude.json ] || echo '{}' > ~/.claude.json; }122mkdir -p ~/.claude && { [ -f ~/.claude.json ] || echo '{}' > ~/.claude.json; }

123```123```

124 124 

125設定ファイルが配置されたら、`npx` で Claude Code を起動し、ラップするコマンドとして `claude` を渡します:125ランタイムをグローバルにインストールします。インストール先のプレフィックスは、書き込みを許可するすべてのパスの外側にしてください:

126 126 

127```bash theme={null}127```bash theme={null}

128npx @anthropic-ai/sandbox-runtime claude128npm install -g @anthropic-ai/sandbox-runtime

129```129```

130 130 

131Claude Code は、設定したファイルシステムおよびネットワーク境界を持つサンドボックス内で起動します。同じコマンドは、スタンドアロン MCP サーバーや他のヘルパープロセスのサンドボックス化にも使用できます。131設定ファイルが配置されたら、プロジェクトディレクトリから Claude Code をランタイムを通じて起動します:

132 

133```bash theme={null}

134srt claude

135```

136 

137Claude Code は、設定したファイルシステムおよびネットワーク境界を持つサンドボックス内で起動します。同じ `srt` コマンドは、スタンドアロン MCP サーバーや他のヘルパープロセスのサンドボックス化にも使用できます。

132 138 

133<h3 id="what-the-runtime-blocks-on-its-own">139<h3 id="what-the-runtime-blocks-on-its-own">

134 ランタイムが独自にブロックするもの140 ランタイムが独自にブロックするもの

Details

33 33 

34`/plugin` はターミナル CLI でインタラクティブパネルを開きます。Claude が `/plugin` がこの環境では利用できないと報告した場合、別の方法でインストールしてください:34`/plugin` はターミナル CLI でインタラクティブパネルを開きます。Claude が `/plugin` がこの環境では利用できないと報告した場合、別の方法でインストールしてください:

35 35 

36* **Claude デスクトップアプリ、ローカルまたは SSH セッション**:プロンプトの横にある **+** ボタンをクリックして[プラグインブラウザ](/docs/ja/desktop#install-plugins)を開き、**Plugins** をクリックしてから **Add plugin** をクリックします36* **Claude デスクトップアプリ、ローカルまたは SSH セッション**:[プラグインをインストールする](/docs/ja/plugins/install#install-a-plugin)の **Desktop app** タブを使用します

37* **VS Code 拡張機能**:[**Manage plugins** ダイアログ](/docs/ja/vs-code#manage-plugins)からインストールします37* **VS Code 拡張機能**:[**Manage plugins** ダイアログ](/docs/ja/vs-code#manage-plugins)からインストールします

38* **クラウドセッション**:クラウドセッションは、ユーザー設定またはリポジトリの `.claude/settings.json` からプラグインを読み込みません。[セットアップから引き継がれるもの](/docs/ja/cloud-environments#what-carries-over-from-your-setup)で説明されています。組織が管理設定を通じて配布するプラグインについては、[組織のプラグインを管理](/docs/ja/plugins/org)を参照してください38* **クラウドセッション**:クラウドセッションは、ユーザー設定またはリポジトリの `.claude/settings.json` からプラグインを読み込みません。[セットアップから引き継がれるもの](/docs/ja/cloud-environments#what-carries-over-from-your-setup)で説明されています。組織が管理設定を通じて配布するプラグインについては、[組織のプラグインを管理](/docs/ja/plugins/org)を参照してください

39 39 

Details

554* **[`--retire-at`](/docs/ja/self-hosted-environments-reference#runner-cli-flags) を使用する場合**:リタイア時刻とホストが停止する時刻の間に、典型的なターンが終了するのに十分な時間、[ランナーのライフサイクル](/docs/ja/self-hosted-environments#runner-lifecycle)で説明されているバックグラウンドタスクの待機時間、およびログに記録された時間を確保してください。リタイア時刻は起動のたびに計算します。例えば `date +%s` にランナーの想定稼働時間を加えます。554* **[`--retire-at`](/docs/ja/self-hosted-environments-reference#runner-cli-flags) を使用する場合**:リタイア時刻とホストが停止する時刻の間に、典型的なターンが終了するのに十分な時間、[ランナーのライフサイクル](/docs/ja/self-hosted-environments#runner-lifecycle)で説明されているバックグラウンドタスクの待機時間、およびログに記録された時間を確保してください。リタイア時刻は起動のたびに計算します。例えば `date +%s` にランナーの想定稼働時間を加えます。

555* **[`--defer-shutdown-max-min`](#defer-the-drain-past-the-first-signal) を使用する場合**:停止タイムアウトには、設定した分数と、ドレイン開始前のさらなる待機時間(デフォルト設定では 75 秒)も含める必要があります。両方については[最初のシグナルを超えてドレインを遅延させる](#defer-the-drain-past-the-first-signal)で説明しています。ランナーはこの長い時間も起動時にログに記録します。555* **[`--defer-shutdown-max-min`](#defer-the-drain-past-the-first-signal) を使用する場合**:停止タイムアウトには、設定した分数と、ドレイン開始前のさらなる待機時間(デフォルト設定では 75 秒)も含める必要があります。両方については[最初のシグナルを超えてドレインを遅延させる](#defer-the-drain-past-the-first-signal)で説明しています。ランナーはこの長い時間も起動時にログに記録します。

556 556 

557<h3 id="post-a-status-message-before-a-restart">

558 再起動の前にステータスメッセージを投稿する

559</h3>

560 

561セッションを中断する再起動の前に、[Owner](/docs/ja/cloud-environments#organization-shared-environments) に [**Cloud environments** 管理ページ](https://claude.ai/admin-settings/cloud-environments)から環境にステータスメッセージを投稿してもらいます。[claude.ai/code](https://claude.ai/code) では、メンバーはその環境内の自分のセッションでメッセージを確認できます。投稿時に Owner に有効期限を設定してもらうか、ランナーが復帰したらメッセージを削除してもらってください。

562 

557<h3 id="defer-the-drain-past-the-first-signal">563<h3 id="defer-the-drain-past-the-first-signal">

558 最初のシグナルを超えてドレインを遅延させる564 最初のシグナルを超えてドレインを遅延させる

559</h3>565</h3>


632 バージョンをピンする638 バージョンをピンする

633</h2>639</h2>

634 640 

635各セッションの子 Claude Code プロセスはランナー独自のバイナリを実行し、ランナーはセッション内でオートアップデートをオフにするため、すべてのセッションはホストにインストールされたか、イメージに組み込まれたバージョンを実行します。ホストレベルのアップデートはランナーが次に開始するときに有効になります。641各セッションの子プロセスはデフォルトでランナー独自のバイナリを実行し、ランナーは自身が起動するセッション内でオートアップデートをオフにします。このデフォルトでは、すべてのセッションはホストにインストールされたか、イメージに組み込まれたバージョンを実行します。ホストレベルのアップデートはランナーが次に開始するときに有効になります。

636 642 

637セッションが実行するバージョンと、それを変更するタイミングを選択します。643セッションが実行するバージョンと、それを変更するタイミングを選択します。

638 644 


640* **フリートを 1 つのバージョンに保持するには**:ピンされたバージョンでイメージをビルドするか、ベアホストで特定のバージョンをインストールし、[オートアップデートを無効にしてください](/docs/ja/setup#disable-auto-updates)646* **フリートを 1 つのバージョンに保持するには**:ピンされたバージョンでイメージをビルドするか、ベアホストで特定のバージョンをインストールし、[オートアップデートを無効にしてください](/docs/ja/setup#disable-auto-updates)

641* **固定フリートをアップグレードするには**:現在のバージョンとインストールするバージョンの間の [changelog](/docs/en/changelog) のエントリを確認してから、新しいバージョンをインストールするか、イメージを再ビルドしてランナーを再起動してください647* **固定フリートをアップグレードするには**:現在のバージョンとインストールするバージョンの間の [changelog](/docs/en/changelog) のエントリを確認してから、新しいバージョンをインストールするか、イメージを再ビルドしてランナーを再起動してください

642* **オンデマンドランナーをアップグレードするには**:現在のバージョンとインストールするバージョンの間の [changelog](/docs/en/changelog) のエントリを確認してから、[`spawn-runner` フック](/docs/ja/self-hosted-environments-configuration#the-spawn-runner-hook)が起動するイメージを変更してください。新しいランナーにはそれぞれ新しいバージョンが適用されます。すでに起動しているランナー([`--min-idle`](/docs/ja/self-hosted-environments-reference#orchestrator-cli-flags) によって起動されたスタンバイランナーを含む)は、終了するまでそのバージョンを維持します。その作業指示は一度しか使用できないため、再起動しないでください。648* **オンデマンドランナーをアップグレードするには**:現在のバージョンとインストールするバージョンの間の [changelog](/docs/en/changelog) のエントリを確認してから、[`spawn-runner` フック](/docs/ja/self-hosted-environments-configuration#the-spawn-runner-hook)が起動するイメージを変更してください。新しいランナーにはそれぞれ新しいバージョンが適用されます。すでに起動しているランナー([`--min-idle`](/docs/ja/self-hosted-environments-reference#orchestrator-cli-flags) によって起動されたスタンバイランナーを含む)は、終了するまでそのバージョンを維持します。その作業指示は一度しか使用できないため、再起動しないでください。

649* **セッションが別のバイナリを起動する場合**:[`--exec-path`](/docs/ja/self-hosted-environments-reference#runner-cli-flags) または [`command` フック](/docs/ja/self-hosted-environments-configuration#command)を使用してランナー独自のもの以外の Claude Code バイナリを起動する場合、セッションはそのバイナリのバージョンを実行します。ランナーをアップデートするときは、そのバイナリもアップデートしてください。

643* **プラグイン**:プラグインマーケットプレイスもオートアップデートしません。ランナーの環境で `FORCE_AUTOUPDATE_PLUGINS=1` を設定して、バイナリがピンされたままの間、プラグインをオートアップデートさせます650* **プラグイン**:プラグインマーケットプレイスもオートアップデートしません。ランナーの環境で `FORCE_AUTOUPDATE_PLUGINS=1` を設定して、バイナリがピンされたままの間、プラグインをオートアップデートさせます

644 651 

645<h2 id="scale-the-fleet">652<h2 id="scale-the-fleet">


699 * **フラグを有効にする前に**: ソースリモート上の `claude/*` ref にプッシュできるユーザーを制限してください。再開時、ランナーは以前にプッシュされたブランチを、誰がプッシュしたかを検証せずにフェッチします。706 * **フラグを有効にする前に**: ソースリモート上の `claude/*` ref にプッシュできるユーザーを制限してください。再開時、ランナーは以前にプッシュされたブランチを、誰がプッシュしたかを検証せずにフェッチします。

700* **セッションの途中で追加したリポジトリのクローンが失敗することがある**: Claude は HTTPS 経由の `git clone` でリポジトリをクローンします。[`--use-anthropic-git-proxy`](#use-the-anthropic-git-proxy) を使用していないランナーでは、ホスト上にリポジトリを読み取れるものが何もない場合、クローンは git の認証エラーで失敗します。可能であれば、セッションの作成時に、セッションで必要なすべてのリポジトリを選択してください。707* **セッションの途中で追加したリポジトリのクローンが失敗することがある**: Claude は HTTPS 経由の `git clone` でリポジトリをクローンします。[`--use-anthropic-git-proxy`](#use-the-anthropic-git-proxy) を使用していないランナーでは、ホスト上にリポジトリを読み取れるものが何もない場合、クローンは git の認証エラーで失敗します。可能であれば、セッションの作成時に、セッションで必要なすべてのリポジトリを選択してください。

701* **一部のコネクタがセルフホストセッションに表示されない**: claude.ai の設定でまだ接続していないコネクタはセルフホストセッションに表示されず、セッションから接続を求められることもありません。まず設定で接続してから、新しいセッションを開始してください。また、すでに実行中のセッションにコネクタを追加しても、そのツールは Claude で使用できるようになりません。新しく追加したコネクタを反映するには、新しいセッションを開始してください。708* **一部のコネクタがセルフホストセッションに表示されない**: claude.ai の設定でまだ接続していないコネクタはセルフホストセッションに表示されず、セッションから接続を求められることもありません。まず設定で接続してから、新しいセッションを開始してください。また、すでに実行中のセッションにコネクタを追加しても、そのツールは Claude で使用できるようになりません。新しく追加したコネクタを反映するには、新しいセッションを開始してください。

709* **誰かがセッションをアーカイブまたは削除した場合、またはセッションのメニューからランナーを解放した場合**: [`--push-outcome-on-release`](/docs/ja/self-hosted-environments-reference#runner-cli-flags) によるプッシュは当てにしないでください。このような場合にコミットを保存するには、[`post-session` フック](/docs/ja/self-hosted-environments-configuration#post-session)から `HEAD` を退避用ブランチにプッシュしてください。そこにある例をもとにする場合は、コミットされていない変更が何もないときでもプッシュするように変更してください。この例はスナップショットのコミットを作成した後にのみプッシュするためです。

702 710 

703<h3 id="report-an-issue">711<h3 id="report-an-issue">

704 問題を報告する712 問題を報告する


745 セッションの約 30 分後にすべての呼び出しが失敗し始める場合、ラッパースクリプトがセッションの stdin を切断した可能性があります。そのため、トークンローテーションがそれに到達できません。[stdin とファイルディスクリプタ 3 を接続したままにする](/docs/ja/self-hosted-environments-configuration#keep-stdin-and-file-descriptor-3-attached)を参照してください。753 セッションの約 30 分後にすべての呼び出しが失敗し始める場合、ラッパースクリプトがセッションの stdin を切断した可能性があります。そのため、トークンローテーションがそれに到達できません。[stdin とファイルディスクリプタ 3 を接続したままにする](/docs/ja/self-hosted-environments-configuration#keep-stdin-and-file-descriptor-3-attached)を参照してください。

746 754 

747 v2.1.274 より前では、ランナーは数回の試行後に失敗したフェッチの再試行を停止し、次のスケジュール済みのものを待ちました。失敗したターンはフェッチをトリガーしなかったため、次のスケジュール済みフェッチまで、すべてのターンが 401 で失敗しました。755 v2.1.274 より前では、ランナーは数回の試行後に失敗したフェッチの再試行を停止し、次のスケジュール済みのものを待ちました。失敗したターンはフェッチをトリガーしなかったため、次のスケジュール済みフェッチまで、すべてのターンが 401 で失敗しました。

756* **claude.ai/code でターンが `This model needs a newer version of Claude Code` で失敗する**:ランナーがセッションの開始に使用する Claude Code のバージョンが、セッションのモデルが必要とするバージョンより古いため、API が[リクエストを拒否します](/docs/ja/errors#claude-code-does-not-support-this-model)。[バージョンを固定する](#pin-the-version)で説明されているように、ランナーをメッセージが求めるバージョン以降にアップグレードしてください。それまでは、セッション内で別のモデルを選択できます。

748* **ポッドがドレイン中に強制終了される**:`terminationGracePeriodSeconds` をランナーが起動時にログに記録する値以上に引き上げてください。[シャットダウンタイミング](#shutdown-timing)を参照してください。757* **ポッドがドレイン中に強制終了される**:`terminationGracePeriodSeconds` をランナーが起動時にログに記録する値以上に引き上げてください。[シャットダウンタイミング](#shutdown-timing)を参照してください。

749 758 

750ログが初期化されると、ランナーはそのライフサイクルログ(`[runner:fatal]` 行を含む)を stdout に書き込み、デバッグ出力を stderr に書き込みます。すべて JSON ではなくプレーンテキスト行として。上記のトラブルシューティングエントリで説明されているベースディレクトリの失敗はその前に stderr に出力されます。`--log-file` で両方のストリームをキャプチャします。これにより `self-hosted-runner doctor` がそれらをテールできるようになり、またはプラットフォームのログ収集で。759ログが初期化されると、ランナーはそのライフサイクルログ(`[runner:fatal]` 行を含む)を stdout に書き込み、デバッグ出力を stderr に書き込みます。すべて JSON ではなくプレーンテキスト行として。上記のトラブルシューティングエントリで説明されているベースディレクトリの失敗はその前に stderr に出力されます。`--log-file` で両方のストリームをキャプチャします。これにより `self-hosted-runner doctor` がそれらをテールできるようになり、またはプラットフォームのログ収集で。

Details

201* キャッシュされた設定はネットワーク障害を通じて保持されます。起動フェッチが失敗した場合、Claude Code は対話型セッションでキャッシュされたポリシーが有効であることを警告します。201* キャッシュされた設定はネットワーク障害を通じて保持されます。起動フェッチが失敗した場合、Claude Code は対話型セッションでキャッシュされたポリシーが有効であることを警告します。

202* フェッチが成功するまで、起動時に保留された値は保留されたままです。202* フェッチが成功するまで、起動時に保留された値は保留されたままです。

203 203 

204Claude Code は、セッションのペイロードをサーバーが確認するまで、キャッシュされた `env` ブロック内の複数のカテゴリの変数を保留します。これにより、キャッシュされたプロキシ、認証局、エンドポイント、または認証情報の値がペイロードを確認する設定フェッチをリダイレクト、傍受、または再認証することを防ぎます。強化はサーバーがフェッチした設定キャッシュにのみ適用されます。MDM または `managed-settings.json` を通じてデプロイされた[エンドポイント管理設定](/docs/ja/managed-settings#delivery-mechanisms)は影響を受けません。保留には Claude Code v2.1.198 以降が必要です。v2.1.198 より前は、全体のキャッシュされた `env` ブロックが起動時に適用されます。保留中のカテゴリは以下の通りです。204Claude Code は、セッションのペイロードをサーバーが確認するまで、キャッシュされた `env` ブロック内の複数のカテゴリの変数を保留します。これにより、キャッシュされたプロキシ、認証局、エンドポイント、または認証情報の値がペイロードを確認する設定フェッチをリダイレクト、傍受、または再認証することを防ぎます。強化はサーバーがフェッチした設定キャッシュにのみ適用されます。MDM または `managed-settings.json` を通じてデプロイされた[エンドポイント管理設定](/docs/ja/managed-settings#delivery-mechanisms)は影響を受けません。保留されるカテゴリは以下の通りです。

205 205 

206* `HTTPS_PROXY`、`NODE_EXTRA_CA_CERTS`、mTLS クライアント証明書変数 `CLAUDE_CODE_CLIENT_CERT` および `CLAUDE_CODE_CLIENT_KEY` などのプロキシと TLS 構成206* `HTTPS_PROXY`、`NODE_EXTRA_CA_CERTS`、mTLS クライアント証明書変数 `CLAUDE_CODE_CLIENT_CERT` および `CLAUDE_CODE_CLIENT_KEY` などのプロキシと TLS 構成

207* `ANTHROPIC_BASE_URL`、`CLAUDE_CODE_USE_BEDROCK` および `CLAUDE_CODE_USE_VERTEX` などのプロバイダー選択変数、`ANTHROPIC_BEDROCK_BASE_URL` などのプロバイダーエンドポイント URL を含む API ルーティングとプロバイダー選択207* `ANTHROPIC_BASE_URL`、`CLAUDE_CODE_USE_BEDROCK` および `CLAUDE_CODE_USE_VERTEX` などのプロバイダー選択変数、`ANTHROPIC_BEDROCK_BASE_URL` などのプロバイダーエンドポイント URL を含む API ルーティングとプロバイダー選択


312 312 

313Claude Code は常にダイアログを表示できるわけではありません。以下の各ケースは、表示できない場合に適用される設定と、次にダイアログが表示される場合を説明しています。313Claude Code は常にダイアログを表示できるわけではありません。以下の各ケースは、表示できない場合に適用される設定と、次にダイアログが表示される場合を説明しています。

314 314 

315* **ダイアログを表示できない対話型セッション**:Claude Code は配信された設定を適用せず、最後に承認された設定を保持します。ダイアログは、それを表示できる次のセッションに表示されます。Claude Code v2.1.211 以降が必要です。315* **ダイアログを表示できない対話型セッション**:Claude Code は配信された設定を適用せず、最後に承認された設定を保持します。ダイアログは、それを表示できる次のセッションに表示されます。

316* **`claude install` または `claude update`**:Claude Code はどちらのコマンド中もダイアログを表示しません。コマンドは最後に承認された設定で実行され、ダイアログは次の対話型セッションに表示されます。Claude Code が起動時に設定フェッチを待つ場合([`forceRemoteSettingsRefresh`](#enforce-fail-closed-startup) が設定されている場合、または [Claude apps gateway](/docs/ja/claude-apps-gateway) デプロイメント上など)、代わりにコマンド中にダイアログを表示し、パイプからのインストール実行は失敗します。[インストール中の「Raw mode is not supported」](/docs/ja/troubleshoot-install#raw-mode-is-not-supported-during-install)を参照してください。v2.1.246 より前は、Claude Code はこれらのコマンド中もダイアログを表示しようとしました。316* **`claude install` または `claude update`**:Claude Code はどちらのコマンド中もダイアログを表示しません。コマンドは最後に承認された設定で実行され、ダイアログは次の対話型セッションに表示されます。Claude Code が起動時に設定フェッチを待つ場合([`forceRemoteSettingsRefresh`](#enforce-fail-closed-startup) が設定されている場合、または [Claude apps gateway](/docs/ja/claude-apps-gateway) デプロイメント上など)、代わりにコマンド中にダイアログを表示し、パイプからのインストール実行は失敗します。[インストール中の「Raw mode is not supported」](/docs/ja/troubleshoot-install#raw-mode-is-not-supported-during-install)を参照してください。v2.1.246 より前は、Claude Code はこれらのコマンド中もダイアログを表示しようとしました。

317* **エラーがダイアログを閉じる前に答える**:Claude Code は配信された設定を適用せず、最後に承認された設定を保持します。それを表示できる次のセッションでダイアログを再度表示します。317* **エラーがダイアログを閉じる前に答える**:Claude Code は配信された設定を適用せず、最後に承認された設定を保持します。それを表示できる次のセッションでダイアログを再度表示します。

318* **`claude -p` または Agent SDK セッションなどの非対話型実行**:Claude Code はダイアログを表示できないため、配信された設定が承認を必要とする場合、その実行のためだけにそれらを適用します。[ローカルキャッシュ](#fetch-and-caching-behavior)に承認済みとして記録したり、書き込んだりしません。次の対話型セッションはダイアログを表示します。ユーザーが対話型セッションで承認するまで、各非対話型実行は起動時に設定を再度フェッチします。v2.1.207 より前は、非対話型実行は設定を承認済みとして保存したため、後続の対話型セッションはそれらのダイアログを表示しませんでした。318* **`claude -p` または Agent SDK セッションなどの非対話型実行**:Claude Code はダイアログを表示できないため、配信された設定が承認を必要とする場合、その実行のためだけにそれらを適用します。[ローカルキャッシュ](#fetch-and-caching-behavior)に承認済みとして記録したり、書き込んだりしません。次の対話型セッションはダイアログを表示します。ユーザーが対話型セッションで承認するまで、各非対話型実行は起動時に設定を再度フェッチします。v2.1.207 より前は、非対話型実行は設定を承認済みとして保存したため、後続の対話型セッションはそれらのダイアログを表示しませんでした。

sessions.md +4 −3

Details

51 51 

52Claude Code がトランスクリプトから会話を読み込むと、再開されたセッションは会話とそれに保存された状態を復元します。52Claude Code がトランスクリプトから会話を読み込むと、再開されたセッションは会話とそれに保存された状態を復元します。

53 53 

54* 会話履歴:ツール呼び出しと結果を含む完全な履歴。前のプロセスが終了したとき(例えばクラッシュ時)に実行中だったツールは、再開時に完了または再実行されません。Claude はその呼び出しが結果の記録前に中断されたとマークされているのを確認し、再度実行する前にそれが有効になったかどうかを確認するよう指示されます。ただし、[`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ja/env-vars#variables)が設定されている場合は除きます。54* 会話履歴:メッセージ、ツール呼び出し、および結果。セッションが [コンテキスト圧縮](/docs/ja/context-window#what-survives-compaction)されていた場合、会話は `Conversation compacted` 行から開きます。Claude は、最後の圧縮の要約、その圧縮で要約されずに残ったメッセージ、およびそれ以降のすべてのメッセージを使って続行します。最後の圧縮で要約されたメッセージは再度読み込まれません。

55* 中断されたツール呼び出し:前のプロセスが終了したとき(例えばクラッシュ時)に実行中だったツールは、再開時に完了または再実行されません。Claude はその呼び出しが結果の記録前に中断されたとマークされているのを確認し、再度実行する前にそれが有効になったかどうかを確認するよう指示されます。ただし、[`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ja/env-vars#variables)が設定されている場合は除きます。

55* モデル:セッションは使用していたモデルで続行されます。ただし、[モデルの設定](/docs/ja/model-config#setting-your-model)に記載されている場合は除きます。56* モデル:セッションは使用していたモデルで続行されます。ただし、[モデルの設定](/docs/ja/model-config#setting-your-model)に記載されている場合は除きます。

56* エージェント:[`--agent`](/docs/ja/sub-agents#invoke-subagents-explicitly)または `agent` 設定で開始されたセッションはそのエージェントとして続行され、ツール制限とモデルを保持します。別のエージェントを選択するには、再開時に `--agent` を渡します。どちらの場合のシステムプロンプトについては、[再開された会話のシステムプロンプトフラグ](/docs/ja/cli-reference#system-prompt-flags-in-resumed-conversations)を参照してください。Claude Code は 2 つの場所でエージェントを検索します。セッションの元のディレクトリ([そのワークスペースを信頼している](/docs/ja/permissions#project-allow-rules-and-workspace-trust)場合)と、次に再開元のディレクトリです。そのため、プロジェクトスコープのエージェントは別のディレクトリから再開する場合でも読み込まれます。Claude Code がどちらの場所でもエージェントを見つけられない場合、セッションはデフォルトのツールで再開され、[エージェント名を示す警告](/docs/ja/errors#session-agent-no-longer-available)が表示されます。57* エージェント:[`--agent`](/docs/ja/sub-agents#invoke-subagents-explicitly)または `agent` 設定で開始されたセッションはそのエージェントとして続行され、ツール制限とモデルを保持します。別のエージェントを選択するには、再開時に `--agent` を渡します。どちらの場合のシステムプロンプトについては、[再開された会話のシステムプロンプトフラグ](/docs/ja/cli-reference#system-prompt-flags-in-resumed-conversations)を参照してください。Claude Code は 2 つの場所でエージェントを検索します。セッションの元のディレクトリ([そのワークスペースを信頼している](/docs/ja/permissions#project-allow-rules-and-workspace-trust)場合)と、次に再開元のディレクトリです。そのため、プロジェクトスコープのエージェントは別のディレクトリから再開する場合でも読み込まれます。Claude Code がどちらの場所でもエージェントを見つけられない場合、セッションはデフォルトのツールで再開され、[エージェント名を示す警告](/docs/ja/errors#session-agent-no-longer-available)が表示されます。

57* 権限モード:`claude --continue`、`claude --resume <session-id>`、または `claude --resume <name>`(名前が 1 つのセッションと一致する場合)で `-p` なしでターミナルから再開する場合、Claude Code はセッションが使用していた権限モードを復元します。ただし、[再開時の権限モード](#permission-mode-on-resume)に記載されている場合は除きます。このセクションでは、セッションピッカー、`/resume`、および `claude -p` で再開する場合も扱います。復元されたモードを上書きするには、`--permission-mode` または `--dangerously-skip-permissions` を渡します。58* 権限モード:`claude --continue`、`claude --resume <session-id>`、または `claude --resume <name>`(名前が 1 つのセッションと一致する場合)で `-p` なしでターミナルから再開する場合、Claude Code はセッションが使用していた権限モードを復元します。ただし、[再開時の権限モード](#permission-mode-on-resume)に記載されている場合は除きます。このセクションでは、セッションピッカー、`/resume`、および `claude -p` で再開する場合も扱います。復元されたモードを上書きするには、`--permission-mode` または `--dangerously-skip-permissions` を渡します。


162| セッションピッカーから | セッションをハイライトして `Ctrl+R` を押します |163| セッションピッカーから | セッションをハイライトして `Ctrl+R` を押します |

163| プラン受け入れ時 | [Plan Mode](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)でプランを受け入れると、既に設定していない限り、プランに基づいて生成されたタイトルがセッションに付けられます |164| プラン受け入れ時 | [Plan Mode](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)でプランを受け入れると、既に設定していない限り、プランに基づいて生成されたタイトルがセッションに付けられます |

164| claude.ai または Claude アプリから | [Remote Control セッション](/docs/ja/remote-control#connect-from-another-device)の名前を変更します。Claude Code は CLI でも同じ名前を適用します。Claude Code v2.1.221 以降が必要です |165| claude.ai または Claude アプリから | [Remote Control セッション](/docs/ja/remote-control#connect-from-another-device)の名前を変更します。Claude Code は CLI でも同じ名前を適用します。Claude Code v2.1.221 以降が必要です |

165| デスクトップアプリから | [デスクトップアプリ](/docs/ja/desktop#work-in-parallel-with-sessions)でセッションの名前を変更します |166| デスクトップアプリから | [デスクトップアプリ](/docs/ja/desktop#organize-and-find-sessions)でセッションの名前を変更します |

166 167 

167CLI ルートまたは claude.ai からセッションに名前を付けたら、`claude --resume <name>` または `/resume <name>` で再開できます。デスクトップアプリセッションは[デスクトップアプリ](/docs/ja/desktop#work-in-parallel-with-sessions)で再開されます。worktree 全体での名前解決の動作については、[セッションを再開する](#resume-a-session)を参照してください。168CLI ルートまたは claude.ai からセッションに名前を付けたら、`claude --resume <name>` または `/resume <name>` で再開できます。デスクトップアプリセッションは[デスクトップアプリ](/docs/ja/desktop#work-in-parallel-with-sessions)で再開されます。worktree 全体での名前解決の動作については、[セッションを再開する](#resume-a-session)を参照してください。

168 169 

169名前を付けないセッションでも、Claude Code が割り当てる 2 つのラベルが付けられます。生成されたタイトルのみが再開ハンドルとして機能します。170名前を付けないセッションでも、Claude Code が割り当てる 2 つのラベルが付けられます。生成されたタイトルのみが再開ハンドルとして機能します。

170 171 

171* デフォルト表示名:名前を付けないインタラクティブセッションでも、起動時にデフォルト表示名が自動的に付けられます。Claude Code v2.1.196 以降が必要です。デフォルト名は、作業ディレクトリの名前と 2 文字のサフィックスを組み合わせたもので、例えば `my-app-3f` のようになり、[agent view](/docs/ja/agent-view)や `claude agents --json` 出力などの実行中セッションのリストでセッションを識別します。デフォルト名は再開ハンドルではありません。`claude --resume` または `/resume` に渡した場合、Claude Code はセッションを見つけません。172* デフォルト表示名:名前を付けないインタラクティブセッションでも、起動時にデフォルト表示名が付けられます。デフォルト名は、作業ディレクトリの名前と 2 文字のサフィックスを組み合わせたもので、例えば `my-app-3f` のようになり、[agent view](/docs/ja/agent-view)や `claude agents --json` 出力などの実行中セッションのリストでセッションを識別します。デフォルト名は再開ハンドルではありません。`claude --resume` または `/resume` に渡した場合、Claude Code はセッションを見つけません。

172* 生成されたタイトル:セッションに名前を付けない場合、Claude Code はセッションのタイトルを生成します。タイトルは最初のプロンプトの短い要約で、通常は Haiku クラスモデルである小型/高速モデルへのバックグラウンドリクエストで作成されます。シェルまたはスクリプトから直接開始する `claude -p` 実行は生成されません。173* 生成されたタイトル:セッションに名前を付けない場合、Claude Code はセッションのタイトルを生成します。タイトルは最初のプロンプトの短い要約で、通常は Haiku クラスモデルである小型/高速モデルへのバックグラウンドリクエストで作成されます。シェルまたはスクリプトから直接開始する `claude -p` 実行は生成されません。

173 174 

174 プランを受け入れると、生成されたタイトルがプランに基づいたタイトルに置き換わります。`claude --resume` または `/resume` にいずれかのタイトルを渡すことができ、Claude Code は設定した名前と同じ方法で解決します。175 プランを受け入れると、生成されたタイトルがプランに基づいたタイトルに置き換わります。`claude --resume` または `/resume` にいずれかのタイトルを渡すことができ、Claude Code は設定した名前と同じ方法で解決します。

settings-reference.md +267 −260

Details

795| [`spinnerTipsEnabled`](#spinnertipsenabled) | Claude の作業中にスピナーに表示されるヒントを非表示にします | インターフェースとターミナル | Any file |795| [`spinnerTipsEnabled`](#spinnertipsenabled) | Claude の作業中にスピナーに表示されるヒントを非表示にします | インターフェースとターミナル | Any file |

796| [`spinnerTipsOverride`](#spinnertipsoverride) | スピナーのローテーションに独自のヒントを追加するか、組み込みのヒントを置き換えます | インターフェースとターミナル | Any file |796| [`spinnerTipsOverride`](#spinnertipsoverride) | スピナーのローテーションに独自のヒントを追加するか、組み込みのヒントを置き換えます | インターフェースとターミナル | Any file |

797| [`spinnerVerbs`](#spinnerverbs) | ターンの実行中に表示される動詞を追加または置き換えます | インターフェースとターミナル | Any file |797| [`spinnerVerbs`](#spinnerverbs) | ターンの実行中に表示される動詞を追加または置き換えます | インターフェースとターミナル | Any file |

798| [`sshConfigs`](#sshconfigs) | Desktop の環境ドロップダウンに [SSH 接続](/docs/ja/desktop#pre-configure-ssh-connections-for-your-team)を追加します | リモート、デスクトップ、通知 | User or managed |798| [`sshConfigs`](#sshconfigs) | Desktop の環境セレクターに [SSH 接続](/docs/ja/desktop#pre-configure-ssh-connections-for-your-team)を追加します | リモート、デスクトップ、通知 | User or managed |

799| [`sshHostAllowlist`](#sshhostallowlist) | [Desktop の SSH セッション](/docs/ja/desktop#restrict-which-ssh-hosts-users-can-connect-to)が到達できるホストを制限します | リモート、デスクトップ、通知 | Managed |799| [`sshHostAllowlist`](#sshhostallowlist) | [Desktop の SSH セッション](/docs/ja/desktop#restrict-which-ssh-hosts-users-can-connect-to)が到達できるホストを制限します | リモート、デスクトップ、通知 | Managed |

800| [`statusLine`](#statusline) | 独自のコマンドを実行して、プロンプトの下に[ステータスライン](/docs/ja/statusline)を表示します | インターフェースとターミナル | Any file |800| [`statusLine`](#statusline) | 独自のコマンドを実行して、プロンプトの下に[ステータスライン](/docs/ja/statusline)を表示します | インターフェースとターミナル | Any file |

801| [`strictKnownMarketplaces`](#strictknownmarketplaces) | ユーザーが追加およびインストール元として使用できる[マーケットプレイス](/docs/ja/plugins/overview)のソースの許可リストを指定します | プラグインとスキル | Managed |801| [`strictKnownMarketplaces`](#strictknownmarketplaces) | ユーザーが追加およびインストール元として使用できる[マーケットプレイス](/docs/ja/plugins/overview)のソースの許可リストを指定します | プラグインとスキル | Managed |


3283 インターフェースとターミナル3283 インターフェースとターミナル

3284</h2>3284</h2>

3285 3285 

3286Claude Code がターミナルでどのように見え、動作するかを変更します。テーマ、エディタモード、ステータスライン、スピナー、セッション内の通知、アクセシビリティなどです。[ターミナル設定](/docs/ja/terminal-config)を参照してください。3286ターミナルでの Claude Code の見た目と動作を変更します。テーマ、エディターモード、ステータスライン、スピナー、セッション内の通知、アクセシビリティが対象です。[ターミナル設定](/docs/ja/terminal-config)を参照してください。

3287 3287 

3288<h3 id="askuserquestiontimeout">3288<h3 id="askuserquestiontimeout">

3289 `askUserQuestionTimeout`3289 `askUserQuestionTimeout`

3290</h3>3290</h3>

3291 3291 

3292回答されていない [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログがアイドル時間の経過後に自動的に続行し、既に選択していたオプションを送信するようにします。席を離れて Claude に続行させたい場合に設定します。デフォルトでは、質問は回答されるまで待機します。タイマーが一時停止する場合や開始されない場合については、[質問の自動続行タイムアウト](/docs/ja/tools-reference#question-auto-continue-timeout)を参照してください。3292回答されていない [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログを、一定時間操作がなかった後に自動で続行させ、その時点で選択済みのオプションを送信します。席を外している間も Claude に作業を続けさせたい場合に設定します。デフォルトでは、質問は回答されるまで待機します。タイマーが一時停止する場合や開始しない場合については、[質問の自動続行タイムアウト](/docs/ja/tools-reference#question-auto-continue-timeout)を参照してください。

3293 3293 

3294* **スコープ**: [`ユーザーまたはマネージド`](#scopes)3294* **スコープ**: [`User or managed`](#scopes)

3295* **タイプ**: 文字列、`"60s"`、`"5m"`、`"10m"`、または `"never"` のいずれか3295* **型**: 文字列。`"60s"`、`"5m"`、`"10m"`、`"never"` のいずれか

3296* **デフォルト**: `"never"`3296* **デフォルト**: `"never"`

3297* **セッションごとのオーバーライド**: [`CLAUDE_AFK_TIMEOUT_MS`](/docs/ja/env-vars) はこのキーより優先されます3297* **セッションごとの上書き**: 1 つのセッションについては、[`CLAUDE_AFK_TIMEOUT_MS`](/docs/ja/env-vars) がこのキーより優先されます

3298 3298 

3299```json settings.json theme={null}3299```json settings.json theme={null}

3300{3300{


3302}3302}

3303```3303```

3304 3304 

3305`/config` に**質問の自動続行タイムアウト**として表示され、このキーをユーザー設定に書き込みます。管理設定または `--settings` フラグがキーを設定している場合、Claude Code は行を非表示にします。3305`/config` では **Question auto-continue timeout** として表示され、このキーをユーザー設定に書き込みます。管理設定または `--settings` フラグでこのキーが設定されている間、Claude Code はこの行を非表示にします。

3306 3306 

3307<h3 id="autocontinueatusagelimit">3307<h3 id="autocontinueatusagelimit">

3308 `autoContinueAtUsageLimit`3308 `autoContinueAtUsageLimit`

3309</h3>3309</h3>

3310 3310 

3311claude.ai の使用制限がセッションを停止した後、開いているセッションで待機し、リセット後にタスクを自動的に続行します。[自動続行をオフにする](/docs/ja/interactive-mode#turn-automatic-continue-off)を参照してください。Claude Code v2.1.234 以降が必要です。3311claude.ai の使用制限によってセッションが停止した後、開いているセッションで待機し、リセット後にタスクを自動的に続行します。[自動続行をオフにする](/docs/ja/interactive-mode#turn-automatic-continue-off)を参照してください。Claude Code v2.1.234 以降が必要です。

3312 3312 

3313* **スコープ**: [`ユーザーまたはマネージド`](#scopes)。ユーザー設定、`--settings`、およびマネージド設定からのみ読み取ります。これらのいずれもキーを設定しない場合、プロジェクトまたはローカル設定ファイルがキーを設定すると、機能は無視されるのではなくオフになります。3313* **スコープ**: [`User or managed`](#scopes)。ユーザー設定、`--settings`、管理設定からのみ読み取られます。これらのいずれでもキーが設定されていない場合、プロジェクト設定ファイルまたはローカル設定ファイルでこのキーを設定すると、無視されるのではなく機能がオフになります。

3314* **タイプ**: ブール値3314* **型**: Boolean

3315 * `true`: claude.ai の使用制限がセッションを停止した後、Claude Code は開いているセッションで待機し、リセット後にタスクを自動的に続行します3315 * `true`: claude.ai の使用制限によってセッションが停止した後、Claude Code は開いているセッションで待機し、リセット後にタスクを自動的に続行します

3316 * `false`: Claude Code は独自に待機を開始しません。[使用制限オプションメニューから自分で待機を開始](/docs/ja/interactive-mode#start-a-wait-yourself)できます3316 * `false`: Claude Code は自動的には待機を開始しません。使用制限のオプションメニューから[自分で待機を開始する](/docs/ja/interactive-mode#start-a-wait-yourself)ことは引き続き可能です

3317* **デフォルト**: `true`3317* **デフォルト**: `true`

3318 3318 

3319```json settings.json theme={null}3319```json settings.json theme={null}


3322}3322}

3323```3323```

3324 3324 

3325`/config` に**使用制限で自動的に続行**として表示され、このキーをユーザー設定に書き込みます。マネージド設定または `--settings` フラグがキーを設定している場合、Claude Code は行を非表示にします。3325`/config` では **Continue automatically at usage limit** として表示され、このキーをユーザー設定に書き込みます。管理設定または `--settings` フラグでこのキーが設定されている間、Claude Code はこの行を非表示にします。

3326 3326 

3327<h3 id="autoscrollenabled">3327<h3 id="autoscrollenabled">

3328 `autoScrollEnabled`3328 `autoScrollEnabled`

3329</h3>3329</h3>

3330 3330 

3331[フルスクリーンレンダリング](/docs/ja/fullscreen)で会話の下部に新しい出力を追従します。オフにすると、Claude が作業を続ける間、スクロールした場所に留まります。権限プロンプトは引き続き表示されます。3331[フルスクリーンレンダリング](/docs/ja/fullscreen)で、新しい出力に追従して会話の末尾までスクロールします。オフにすると、Claude が作業を続けている間もスクロールした位置にとどまります。権限プロンプトは引き続きスクロールして表示領域に入ります。

3332 3332 

3333* **スコープ**: [`任意のファイル`](#scopes)3333* **スコープ**: [`Any file`](#scopes)

3334* **タイプ**: ブール値3334* **型**: Boolean

3335 * `true`: 会話は新しい出力の下部に追従します3335 * `true`: 会話は新しい出力に追従して末尾までスクロールします

3336 * `false`: Claude が作業を続ける間、スクロールした場所に留まります。権限プロンプトはトランスクリプトの下に表示されます3336 * `false`: Claude が作業を続けている間も、スクロールした位置にとどまります。権限プロンプトは引き続きトランスクリプトの下に表示されます

3337* **デフォルト**: `true`3337* **デフォルト**: `true`

3338 3338 

3339```json settings.json theme={null}3339```json settings.json theme={null}


3342}3342}

3343```3343```

3344 3344 

3345`/config` にフルスクリーンレンダリングがオンの場合**自動スクロール**として表示され、このキーをユーザー設定に書き込みます。3345フルスクリーンレンダリングがオンの場合、`/config` では **Auto-scroll** として表示され、このキーをユーザー設定に書き込みます。

3346 3346 

3347<h3 id="axscreenreader">3347<h3 id="axscreenreader">

3348 `axScreenReader`3348 `axScreenReader`

3349</h3>3349</h3>

3350 3350 

3351スクリーンリーダーフレンドリーな出力をレンダリングします。装飾的なボーダーやアニメーションのないフラットテキストです。スクリーンリーダーモードはクラシックレンダラーを使用するため、アクティブな間は `tui` 設定は効果がありません。接続された[バックグラウンドセッション](/docs/ja/agent-view)は引き続きフルスクリーンでレンダリングされます。3351スクリーンリーダーに適した出力、つまり装飾的な枠線やアニメーションのないフラットなテキストをレンダリングします。スクリーンリーダーモードはクラシックレンダラーを使用するため、有効な間は `tui` 設定は効果がありません。アタッチされた[バックグラウンドセッション](/docs/ja/agent-view)は引き続きフルスクリーンでレンダリングされます。

3352 3352 

3353* **スコープ**: [`任意のファイル`](#scopes)3353* **スコープ**: [`Any file`](#scopes)

3354* **タイプ**: ブール値3354* **型**: Boolean

3355 * `true`: Claude Code は装飾的なボーダーやアニメーションのないフラットテキストをレンダリングし、クラシックレンダラーを使用します3355 * `true`: Claude Code はクラシックレンダラーを使用し、装飾的な枠線やアニメーションのないフラットなテキストをレンダリングします

3356 * `false`: Claude Code は通常通りレンダリングします3356 * `false`: Claude Code は通常どおりレンダリングします

3357* **デフォルト**: 未設定、スクリーンリーダーモードはオフです3357* **デフォルト**: 未設定。スクリーンリーダーモードはオフです

3358* **セッションごとのオーバーライド**: [`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) は [`CLAUDE_AX_SCREEN_READER`](/docs/ja/env-vars) より優先され、両方ともこのキーより優先されます3358* **セッションごとの上書き**: 1 つのセッションについては、[`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) が [`CLAUDE_AX_SCREEN_READER`](/docs/ja/env-vars) より優先され、どちらもこのキーより優先されます

3359 3359 

3360```json settings.json theme={null}3360```json settings.json theme={null}

3361{3361{


3367 `bashEditDiffEnabled`3367 `bashEditDiffEnabled`

3368</h3>3368</h3>

3369 3369 

3370Bash コマンドの実行中に Git リポジトリで変更されたファイルを Claude Code が記録するかどうかを選択します。記録する場合、コマンド後にターミナルでそれらの diff が表示され、[PostToolUse Bash フック](/docs/ja/hooks#bash)は変更されたファイルのリストを受け取ります。3370Bash コマンドの実行中に Git リポジトリ内のどのファイルが変更されたかを Claude Code が記録するかどうかを選択します。記録する場合、コマンドの後にターミナルでその差分が表示され、[PostToolUse Bash フック](/docs/ja/hooks#bash)は変更されたファイルのリストを受け取ります。

3371 3371 

3372リストされたファイルは常にコマンドが変更したものとは限りません。コマンドの実行中に別のプログラムまたは別の Bash 呼び出しが行った変更もそこに表示される可能性があります。3372リストに含まれるファイルが、必ずしもそのコマンドによって変更されたものとは限りません。コマンドの実行中に別のプログラムや別の Bash 呼び出しが行った変更も含まれることがあります。

3373 3373 

3374キーを `true` に設定して、すべての権限モードで記録します。Claude Code v2.1.269 以降が必要です。3374すべての権限モードで記録するには、キーを `true` に設定します。Claude Code v2.1.269 以降が必要です。

3375 3375 

3376* **スコープ**: [`ユーザーまたはマネージド`](#scopes)。`true` はユーザー設定、`--settings` で渡された JSON、または[マネージド設定](/docs/ja/managed-settings)からのみカウントされるため、リポジトリの `.claude/settings.json` または `.claude/settings.local.json` の `true` は記録をオンにできません。リポジトリファイルの `false` は[より高い優先度](/docs/ja/settings#settings-precedence)のファイルが `true` を設定しない限り、引き続きオフになります。3376* **スコープ**: [`User or managed`](#scopes)。`true` はユーザー設定、`--settings` で渡された JSON、または[管理設定](/docs/ja/managed-settings)からのものだけが有効になるため、リポジトリの `.claude/settings.json` や `.claude/settings.local.json` にある `true` では記録をオンにできません。いずれかのリポジトリファイルにある `false` は、[優先順位のより高い](/docs/ja/settings#settings-precedence)ファイルで `true` が設定されていない限り、記録をオフにします。

3377* **タイプ**: ブール値3377* **型**: Boolean

3378* **デフォルト**: 未設定、Claude Code は自動モードと `bypassPermissions` モードで Claude が Bash を通じてファイルを編集するように指示する場合に変更を記録します3378* **デフォルト**: 未設定。Claude Code は、auto モードと `bypassPermissions` モードにおいて、Bash を通じてファイルを編集するよう Claude に指示した場合に変更を記録します

3379* **セッションごとのオーバーライド**: [`CLAUDE_CODE_BASH_EDIT_DIFF`](/docs/ja/env-vars) はこのキーより優先されます3379* **セッションごとの上書き**: 1 つのセッションについては、[`CLAUDE_CODE_BASH_EDIT_DIFF`](/docs/ja/env-vars) がこのキーより優先されます

3380 3380 

3381```json settings.json theme={null}3381```json settings.json theme={null}

3382{3382{


3388 `companyAnnouncements`3388 `companyAnnouncements`

3389</h3>3389</h3>

3390 3390 

3391スタートアップ時に組織のアナウンスメントをユーザーに表示します。複数をリストする場合、Claude Code は各セッションでランダムに 1 つを選択します。ユーザーの最初の起動時には最初のエントリが表示されます。3391起動時に組織からのお知らせをユーザーに表示します。複数指定した場合、Claude Code はセッションごとにランダムに 1 つを選びます。ユーザーが初めて起動したときは最初のエントリを表示します。

3392 3392 

3393* **スコープ**: [`任意のファイル`](#scopes)3393* **スコープ**: [`Any file`](#scopes)

3394* **タイプ**: 文字列の配列3394* **型**: 文字列の配列

3395* **デフォルト**: 未設定、アナウンスメントは表示されません3395* **デフォルト**: 未設定。お知らせは表示されません

3396 3396 

3397```json settings.json theme={null}3397```json settings.json theme={null}

3398{3398{


3406 `defaultShell`3406 `defaultShell`

3407</h3>3407</h3>

3408 3408 

3409入力ボックスで[`!` プレフィックス](/docs/ja/interactive-mode#shell-mode-with-prefix)で入力したシェルコマンド、Claude Code が直接実行してセッションに追加するコマンドを実行するかどうかを選択します。Bash または PowerShell。3409入力ボックスで [`!` プレフィックス](/docs/ja/interactive-mode#shell-mode-with-prefix)を付けて入力したシェルコマンド、つまり Claude Code が直接実行してセッションに追加するコマンドを、Bash と PowerShell のどちらで実行するかを選択します。

3410 3410 

3411`"powershell"` は[PowerShell ツール](/docs/ja/tools-reference#powershell-tool)がオンの場合のみ機能します。このツールは Git Bash のない Windows ではデフォルトでオンであり、Git Bash を使用する Windows では claude.ai および Console アカウント用にオンです。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry セッション、および macOS、Linux、WSL では、`CLAUDE_CODE_USE_POWERSHELL_TOOL=1` を設定してツールをオンにします。そのツールをオフにするには、その変数を `0` に設定します。3411`"powershell"` は [PowerShell ツール](/docs/ja/tools-reference#powershell-tool)がオンの場合にのみ機能します。このツールは、Git Bash のない Windows ではデフォルトでオンになり、Git Bash のある Windows では claude.ai アカウントと Console アカウントの場合にデフォルトでオンになります。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry のセッション、および macOS、Linux、WSL では、`CLAUDE_CODE_USE_POWERSHELL_TOOL=1` を設定してツールをオンにします。この変数を `0` に設定するとツールがオフになります。

3412 3412 

3413* **スコープ**: [`任意のファイル`](#scopes)3413* **スコープ**: [`Any file`](#scopes)

3414* **タイプ**: 文字列、以下のいずれか:3414* **型**: 文字列。次のいずれか:

3415 * `"bash"`: Claude Code は `!` コマンドを Bash で実行します3415 * `"bash"`: Claude Code は `!` コマンドを Bash で実行します

3416 * `"powershell"`: Claude Code は `!` コマンドを PowerShell で実行します3416 * `"powershell"`: Claude Code は `!` コマンドを PowerShell で実行します

3417* **デフォルト**: `"bash"`、または Bash が利用できない Windows では `"powershell"`3417* **デフォルト**: `"bash"`。Bash が利用できない Windows では `"powershell"`

3418 3418 

3419```json settings.json theme={null}3419```json settings.json theme={null}

3420{3420{


3422}3422}

3423```3423```

3424 3424 

3425指定したシェルが利用できない場合、Claude Code は他方を使用します。`"powershell"` は PowerShell ツールがオフの場合 Bash にフォールバックし、`"bash"` は Bash がインストールされていない場合 PowerShell にフォールバックします。3425指定したシェルが利用できない場合、Claude Code はもう一方を使用します。PowerShell ツールがオフの場合 `"powershell"` は Bash にフォールバックし、Bash がインストールされていない場合 `"bash"` は PowerShell にフォールバックします。

3426 3426 

3427<h3 id="dialogexpiry">3427<h3 id="dialogexpiry">

3428 `dialogExpiry`3428 `dialogExpiry`

3429</h3>3429</h3>

3430 3430 

3431Claude Code が[リモートクライアントに転送](/docs/ja/remote-control#limitations)するダイアログ(Remote Control または SDK ホストなど)および[保留中のクロスセッションメッセージ](/docs/ja/cross-session-messaging#control-inbound-messages)の承認ダイアログの期限を設定します。Claude Code v2.1.236 以降では、同じ期限が誰もターミナルにいない可能性があるセッションの途中の[Fable 使用クレジット同意プロンプト](/docs/ja/model-config#fable-and-usage-credits)を制限します。期限前に回答が到着しない場合、Claude Code はダイアログをキャンセルし、デフォルトのアクションなしで続行します。Claude Code v2.1.224 以降が必要です。3431Claude Code が Remote Control や SDK ホストなどの[リモートクライアントに転送する](/docs/ja/remote-control#limitations)ダイアログ、および[保留されたクロスセッションメッセージ](/docs/ja/cross-session-messaging#control-inbound-messages)の承認ダイアログの期限を設定します。Claude Code v2.1.236 以降では、ターミナルに誰もいない可能性のあるセッションにおいて、セッション途中の [Fable 使用クレジットの同意プロンプト](/docs/ja/model-config#fable-and-usage-credits)にも同じ期限が適用されます。期限までに回答がない場合、Claude Code はダイアログをキャンセルし、何もしないデフォルトの動作で続行します。Claude Code v2.1.224 以降が必要です。

3432 3432 

3433* **スコープ**: [`ユーザーまたはマネージド`](#scopes)3433* **スコープ**: [`User or managed`](#scopes)

3434* **タイプ**: 文字列、`"60s"`、`"5m"`、`"10m"`、または期限を無効にする `"never"` のいずれか3434* **型**: 文字列。`"60s"`、`"5m"`、`"10m"`、または期限を無効にする `"never"` のいずれか

3435* **デフォルト**: `"5m"`3435* **デフォルト**: `"5m"`

3436* **セッションごとのオーバーライド**: [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](/docs/ja/env-vars) はこのキーより優先されます3436* **セッションごとの上書き**: 1 つのセッションについては、[`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](/docs/ja/env-vars) がこのキーより優先されます

3437 3437 

3438```json settings.json theme={null}3438```json settings.json theme={null}

3439{3439{


3441}3441}

3442```3442```

3443 3443 

3444権限プロンプトと[`AskUserQuestion`](/docs/ja/tools-reference#askuserquestion-tool-behavior)質問は独自のフローを使用し、この期限の対象ではありません。Claude Code v2.1.232 以降では `/config` に**ダイアログの有効期限**として表示され、このキーをユーザー設定に書き込みます。行には Claude Code v2.1.232 以降が必要であり、マネージド設定または `--settings` フラグがキーを設定している場合、Claude Code は行を非表示にします。3444権限プロンプトと [`AskUserQuestion`](/docs/ja/tools-reference#askuserquestion-tool-behavior) の質問は独自のフローを使用するため、この期限の対象にはなりません。`/config` では **Dialog expiry** として表示され、このキーをユーザー設定に書き込みます。この行には Claude Code v2.1.232 以降が必要で、管理設定または `--settings` フラグでこのキーが設定されている間、Claude Code はこの行を非表示にします。

3445 3445 

3446<h3 id="editormode">3446<h3 id="editormode">

3447 `editorMode`3447 `editorMode`

3448</h3>3448</h3>

3449 3449 

3450入力プロンプトのキーバインディングモードを選択します。3450入力プロンプトのキーバインドモードを選択します。

3451 3451 

3452* **スコープ**: [`任意のファイル`](#scopes)3452* **スコープ**: [`Any file`](#scopes)

3453* **タイプ**: 文字列、以下のいずれか:3453* **型**: 文字列。次のいずれか:

3454 * `"normal"`: プロンプト入力の標準キーバインディング3454 * `"normal"`: プロンプト入力での標準的なキーバインド

3455 * `"vim"`: NORMAL、INSERT、VISUAL モードを備えた vim スタイルの編集3455 * `"vim"`: NORMAL、INSERT、VISUAL モードを備えた vim スタイルの編集

3456* **デフォルト**: `"normal"`3456* **デフォルト**: `"normal"`

3457 3457 


3461}3461}

3462```3462```

3463 3463 

3464`/config` に**エディタモード**として表示され、このキーをユーザー設定に書き込みます。3464`/config` では **Editor mode** として表示され、このキーをユーザー設定に書き込みます。

3465 3465 

3466<h3 id="emojicompletionenabled">3466<h3 id="emojicompletionenabled">

3467 `emojiCompletionEnabled`3467 `emojiCompletionEnabled`

3468</h3>3468</h3>

3469 3469 

3470プロンプト入力で `:` とショートコードを入力するときに絵文字の提案を表示し、`:heart:` などの完成したショートコードを絵文字に置き換えます。`false` に設定して両方をオフにします。3470プロンプト入力で `:` に続けてショートコードを入力したときに絵文字の候補を表示し、`:heart:` のような完成したショートコードを対応する絵文字に置き換えます。両方をオフにするには `false` に設定します。

3471 3471 

3472* **スコープ**: [`任意のファイル`](#scopes)3472* **スコープ**: [`Any file`](#scopes)

3473* **タイプ**: ブール値3473* **型**: Boolean

3474 * `true`: Claude Code は `:` の後に絵文字の提案を表示し、完成したショートコードを絵文字に置き換えます3474 * `true`: Claude Code は `:` の後に絵文字の候補を表示し、完成したショートコードを絵文字に置き換えます

3475 * `false`: Claude Code は絵文字を提案せず、ショートコードを置き換えません3475 * `false`: Claude Code は絵文字の候補を表示せず、ショートコードの置き換えも行いません

3476* **デフォルト**: `true`3476* **デフォルト**: `true`

3477 3477 

3478```json settings.json theme={null}3478```json settings.json theme={null}


3489 `fileSuggestion`3489 `fileSuggestion`

3490</h3>3490</h3>

3491 3491 

3492組み込みのファイル提案の代わりに、`@` ファイルパスオートコンプリートを提供する独自のコマンドを実行します。組み込み提案は高速ファイルシステムトラバーサルを使用します。大規模なモノレポは事前構築されたファイルインデックスなどのプロジェクト固有のインデックスでより良い結果が得られる場合があります。3492組み込みのファイル候補の代わりに、独自のコマンドを実行して `@` ファイルパスのオートコンプリートを提供します。組み込みの候補は高速なファイルシステム走査を使用しますが、大規模なモノレポでは、事前にビルドされたファイルインデックスのようなプロジェクト固有のインデックスを使用したほうがうまくいく場合があります。

3493 3493 

3494* **スコープ**: [`任意のファイル`](#scopes)。[ステータスラインとファイル提案ゲート](#status-line-and-file-suggestion-gates)の下では、Claude Code はコマンドをオフにするか、マネージド値のみを実行し、警告なしにあなたのコマンドをスキップします。3494* **スコープ**: [`Any file`](#scopes)。[ステータスラインとファイル候補のゲート](#status-line-and-file-suggestion-gates)の下では、Claude Code はコマンドをオフにするか管理設定の値のみを実行し、ユーザーのコマンドは警告なしにスキップします。

3495* **タイプ**: `type`(常に `"command"`)と `command`(実行するシェルコマンド)を持つオブジェクト3495* **型**: 常に `"command"` である `type` と、実行するシェルコマンドである `command` を持つオブジェクト

3496* **デフォルト**: 未設定、Claude Code は組み込みのファイル提案を使用します3496* **デフォルト**: 未設定。Claude Code は組み込みのファイル候補を使用します

3497 3497 

3498```json settings.json theme={null}3498```json settings.json theme={null}

3499{3499{


3504}3504}

3505```3505```

3506 3506 

3507これを保存した後、プロンプトで `@` に続けてパスの一部を入力します。提案はコマンドの出力から取得されます。3507これを保存した後、プロンプトで `@` に続けてパスの一部を入力すると、コマンドの出力から候補が表示されます。

3508 3508 

3509<h4 id="command-input-and-output">3509<h4 id="command-input-and-output">

3510 コマンド入力と出力3510 コマンドの入力と出力

3511</h4>3511</h4>

3512 3512 

3513Claude Code は[フック](/docs/ja/hooks)と同じ環境変数(`CLAUDE_PROJECT_DIR` を含む)でコマンドを実行し、5 秒後に待機を停止します。コマンドは stdin で `query` フィールドを持つ JSON を受け取ります。これまでに入力したものを保持します:3513Claude Code は、`CLAUDE_PROJECT_DIR` を含め、[フック](/docs/ja/hooks)と同じ環境変数でコマンドを実行し、5 秒後に待機を打ち切ります。コマンドは、それまでに入力された内容を保持する `query` フィールドを含む JSON を stdin で受け取ります。

3514 3514 

3515```json theme={null}3515```json theme={null}

3516{"query": "src/comp"}3516{"query": "src/comp"}

3517```3517```

3518 3518 

3519stdout にニューラインで区切られたファイルパスを出力します。Claude Code は最大 15 個を表示します:3519改行区切りのファイルパスを stdout に出力します。Claude Code が表示するのは最大 15 件です。

3520 3520 

3521```text theme={null}3521```text theme={null}

3522src/components/Button.tsx3522src/components/Button.tsx


3524src/components/Form.tsx3524src/components/Form.tsx

3525```3525```

3526 3526 

3527次のスクリプトはクエリを読み取り、リポジトリファイルインデックスに渡します:3527次のスクリプトはクエリを読み取り、リポジトリのファイルインデックスに渡します。

3528 3528 

3529```bash theme={null}3529```bash theme={null}

3530#!/bin/bash3530#!/bin/bash


3539 `footerLinksRegexes`3539 `footerLinksRegexes`

3540</h3>3540</h3>

3541 3541 

3542ターン出力(ツール結果(ファイルコンテンツと取得されたページを含む)および Claude 自身の応答)に正規表現がマッチするときに、入力ボックスの下のフッターに追加のクリック可能なバッジをレンダリングします。プロジェクト CLI によって出力される ID(レビューツールおよび問題トラッカーなど)をセッションリンクに変換するために使用します。3542正規表現がターンの出力(ファイルの内容や取得したページを含むツールの結果、および Claude 自身の応答)に一致したとき、入力ボックスの下のフッターにクリック可能なバッジを追加でレンダリングします。レビューツールや課題トラッカーなどのプロジェクトの CLI が出力する ID を、セッション内のリンクに変換するために使用します。

3543 3543 

3544* **スコープ**: [`ユーザーまたはマネージド`](#scopes)3544* **スコープ**: [`User or managed`](#scopes)

3545* **タイプ**: オブジェクトの配列。各オブジェクトは `type` を `"regex"` に設定し、`pattern` 正規表現、`url` テンプレート、およびオプションの `label` を持ちます。`url` および `label` の `{name}` プレースホルダーは `pattern` の名前付きキャプチャグループから入力されます3545* **型**: オブジェクトの配列。各オブジェクトは `"regex"` に設定された `type`、正規表現の `pattern`、`url` テンプレート、およびオプションの `label` を持ちます。`url` と `label` 内の `{name}` プレースホルダーは、`pattern` の名前付きキャプチャグループから埋められます

3546* **デフォルト**: 未設定、バッジはレンダリングされません3546* **デフォルト**: 未設定。バッジはレンダリングされません

3547 3547 

3548この例は `PROJ-1234` などの問題キーにマッチし、キャプチャされたキーから各リンクを構築します:3548この例では `PROJ-1234` のような課題キーに一致させ、キャプチャしたキーから各リンクを構築します。

3549 3549 

3550```json settings.json theme={null}3550```json settings.json theme={null}

3551{3551{


3560}3560}

3561```3561```

3562 3562 

3563これが設定されている場合、`PROJ-1234` がツール結果または Claude の応答に表示されると、`PROJ-1234` バッジがフッターに表示され、`https://issues.example.com/browse/PROJ-1234` にリンクします。3563この設定では、ツールの結果または Claude の応答に `PROJ-1234` が現れると、`https://issues.example.com/browse/PROJ-1234` にリンクする `PROJ-1234` バッジがフッターに表示されます。

3564 3564 

3565<h4 id="badge-constraints">3565<h4 id="badge-constraints">

3566 バッジの制約3566 バッジの制約

3567</h4>3567</h4>

3568 3568 

3569各エントリの URL、ラベル、およびバッジ数は次のように制限されます:3569各エントリの URL、ラベル、バッジの数には次の制限があります。

3570 3570 

3571| 制約 | 動作 |3571| 制約 | 動作 |

3572| :- | :- |3572| :- | :- |

3573| URL オリジン | キャプチャされた値は URL エンコードされ、構築された URL はテンプレートのリテラルオリジンを共有する必要があります。キャプチャはパスセグメントまたはクエリ値を入力できますが、リンクが指す場所を変更することはできません |3573| URL のオリジン | キャプチャされた値は URL エンコードされ、構築された URL はテンプレートのリテラルのオリジンと同じでなければなりません。キャプチャはパスセグメントやクエリ値を埋めることはできますが、リンク先を変更することはできません |

3574| URL 長 | 2048 文字より長い構築された URL は削除されます |3574| URL の長さ | 2048 文字を超える構築された URL は破棄されます |

3575| URL スキーム | `https`、`http`、または認識されたエディタまたはワークスペースディープリンクスキーム: `vscode`、`vscode-insiders`、`cursor`、`windsurf`、`zed`、`jetbrains`、`idea`、`slack`、`linear`、`notion`、`figma` である必要があります |3575| URL スキーム | `https`、`http`、または認識されるエディターやワークスペースのディープリンクスキーム(`vscode`、`vscode-insiders`、`cursor`、`windsurf`、`zed`、`jetbrains`、`idea`、`slack`、`linear`、`notion`、`figma`)でなければなりません |

3576| ラベル | マッチしたテキストにデフォルト設定され、28 表示列に切り詰められます |3576| ラベル | デフォルトは一致したテキストで、表示幅 28 カラムに切り詰められます |

3577| バッジ数 | 最大 5 個のバッジがレンダリングされます。最も古いものは新しいマッチに置き換えられ、`/clear` はそれらを削除します |3577| バッジの数 | レンダリングされるバッジは最大 5 個です。新しい一致によって最も古いものが置き換えられ、`/clear` でバッジは削除されます |

3578 3578 

3579ターンが完了すると、Claude Code はメインスレッドでターン出力に対して各エントリの `pattern` 正規表現をマッチングするため、遅い正規表現は完了するまで UI をブロックします。`(a+)+$` などのネストされた量指定子は特定の入力に対して指数関数的に長くかかり、セッションをフリーズさせる可能性があるため、各 `pattern` を線形に保ち、`+` または `*` のネストを避けてください。3579ターンが完了すると、Claude Code はメインスレッド上で各エントリの `pattern` 正規表現をターンの出力に照合するため、遅い正規表現は完了するまで UI をブロックします。`(a+)+$` のようなネストされた量指定子は、特定の入力に対して指数関数的に時間がかかり、セッションをフリーズさせることがあるため、各 `pattern` は線形に保ち、`+` や `*` のネストは避けてください。

3580 3580 

3581フッターバッジは[カスタムステータスライン](/docs/ja/statusline)が設定されている場合と並んでレンダリングされます。どちらも他方を置き換えません。セッションデータから独自のコンテンツを計算するスクリプト駆動行にはステータスラインを使用し、会話から ID をリンクに変換するにはフッターバッジを使用します。3581[カスタムステータスライン](/docs/ja/statusline)が設定されている場合、フッターバッジはそれと並んでレンダリングされ、どちらも他方を置き換えることはありません。セッションデータから独自に内容を計算するスクリプト駆動の行にはステータスラインを使用し、スクリプトなしで会話中の ID をリンクに変換するにはフッターバッジを使用します。

3582 3582 

3583<h3 id="keybindingflavor">3583<h3 id="keybindingflavor">

3584 `keybindingFlavor`3584 `keybindingFlavor`

3585</h3>3585</h3>

3586 3586 

3587<Warning>3587<Warning>

3588 v2.1.261 以降非推奨であり、効果がありません。プロンプトのワード編集キーは常に[readline 規約に従います](/docs/ja/interactive-mode#make-ctrl-w-delete-back-to-whitespace)。Bash のように。Claude Code は引き続き `keybindingFlavor` を受け入れるため、それを設定する設定ファイルは有効なままです。3588 v2.1.261 以降は非推奨となり、効果はありません。プロンプトの単語編集キーは、Bash と同様に常に [readline の慣例に従います](/docs/ja/interactive-mode#make-ctrl-w-delete-back-to-whitespace)。Claude Code は引き続き `keybindingFlavor` を受け付けるため、これを設定している設定ファイルは有効なままです。

3589</Warning>3589</Warning>

3590 3590 

3591v2.1.238 から v2.1.260 では、`"readline"` に設定すると `Ctrl+W` は前の単語だけでなく前の空白文字に戻って削除されました。3591v2.1.238 から v2.1.260 では、これを `"readline"` に設定すると、`Ctrl+W` が直前の単語だけでなく直前の空白までを削除するようになりました。

3592 3592 

3593* **スコープ**: [`任意のファイル`](#scopes)3593* **スコープ**: [`Any file`](#scopes)

3594* **タイプ**: 文字列、`"classic"` または `"readline"`3594* **型**: 文字列。`"classic"` または `"readline"`

3595* **デフォルト**: 未設定3595* **デフォルト**: 未設定

3596 3596 

3597<h3 id="maxprosewidth">3597<h3 id="maxprosewidth">

3598 `maxProseWidth`3598 `maxProseWidth`

3599</h3>3599</h3>

3600 3600 

3601Claude の応答の散文の幅を制限して、行が広いターミナルで読みやすく保ちます。段落、見出し、リスト、およびブロック引用はこの多くの列内でラップされ、テーブルとコードブロックはターミナルの全幅を保ちます。Claude Code v2.1.282 以降が必要です。3601Claude の応答に含まれる文章の幅に上限を設け、幅の広いターミナルでも行を読みやすく保ちます。段落、見出し、リスト、引用ブロックはこのカラム数の範囲内で折り返され、表とコードブロックはターミナルの全幅を維持します。Claude Code v2.1.282 以降が必要です。

3602 3602 

3603* **スコープ**: [`任意のファイル`](#scopes)3603* **スコープ**: [`Any file`](#scopes)

3604* **タイプ**: ターミナル列の数、整数、最小 `40`。Claude Code は他の値を無視します3604* **型**: ターミナルのカラム数。整数で、最小値は `40`。Claude Code はそれ以外の値を無視します

3605* **デフォルト**: 未設定、散文はターミナルエッジでラップされます3605* **デフォルト**: 未設定。文章はターミナルの端で折り返されます

3606 3606 

3607```json settings.json theme={null}3607```json settings.json theme={null}

3608{3608{


3614 `prefersReducedMotion`3614 `prefersReducedMotion`

3615</h3>3615</h3>

3616 3616 

3617スピナー、シマー、フラッシュエフェクトなどのインターフェースアニメーションを削減またはオフにします。`/config` に**モーションを削減**として表示されます。3617スピナー、シマー、フラッシュ効果などのインターフェースのアニメーションを抑えるか、オフにします。`/config` では **Reduce motion** として表示されます。

3618 3618 

3619* **スコープ**: [`任意のファイル`](#scopes)3619* **スコープ**: [`Any file`](#scopes)

3620* **タイプ**: ブール値3620* **型**: Boolean

3621 * `true`: Claude Code はスピナー、シマー、フラッシュエフェクトなどのインターフェースアニメーションを削減またはオフにします3621 * `true`: Claude Code はスピナー、シマー、フラッシュ効果などのインターフェースのアニメーションを抑えるか、オフにします

3622 * `false`: 未設定と同じです。Claude Code はアニメーションを表示します3622 * `false`: 未設定と同じです。Claude Code はアニメーションを表示します

3623* **デフォルト**: `false`3623* **デフォルト**: `false`

3624 3624 


3632 `promptSuggestionEnabled`3632 `promptSuggestionEnabled`

3633</h3>3633</h3>

3634 3634 

3635[プロンプト提案](/docs/ja/interactive-mode#prompt-suggestions)を表示または非表示にします。プロンプト入力に表示される灰色の予測です。`false` に設定するか、`/config` で**プロンプト提案**をオフにして非表示にします。3635プロンプト入力に表示されるグレーアウトされた予測である[プロンプト候補](/docs/ja/interactive-mode#prompt-suggestions)の表示・非表示を切り替えます。非表示にするには、`false` に設定するか、`/config` で **Prompt suggestions** をオフにします。

3636 3636 

3637* **スコープ**: [`任意のファイル`](#scopes)3637* **スコープ**: [`Any file`](#scopes)

3638* **タイプ**: ブール値3638* **型**: Boolean

3639 * `true`: プロンプト入力にプロンプト提案が表示されます3639 * `true`: プロンプト入力にプロンプト候補が表示されます

3640 * `false`: Claude Code はプロンプト提案を非表示にします3640 * `false`: Claude Code はプロンプト候補を非表示にします

3641* **デフォルト**: `true`3641* **デフォルト**: `true`

3642* **セッションごとのオーバーライド**: [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/ja/env-vars) はこのキーより優先されます3642* **セッションごとの上書き**: 1 つのセッションについては、[`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/ja/env-vars) がこのキーより優先されます

3643 3643 

3644```json settings.json theme={null}3644```json settings.json theme={null}

3645{3645{


3647}3647}

3648```3648```

3649 3649 

3650プロンプト提案には、テレメトリがオンの claude.ai または Console アカウントが必要です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または [`DISABLE_TELEMETRY`](/docs/ja/env-vars) によるテレメトリがオフの場合、このキーは効果がなく、`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=1` のみがそれらをオンにします。3650プロンプト候補には、テレメトリがオンになっている claude.ai アカウントまたは Console アカウントが必要です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry の場合、または [`DISABLE_TELEMETRY`](/docs/ja/env-vars) などでテレメトリがオフになっている場合、このキーは効果がなく、`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=1` でのみオンにできます。

3651 3651 

3652<h3 id="respectgitignore">3652<h3 id="respectgitignore">

3653 `respectGitignore`3653 `respectGitignore`

3654</h3>3654</h3>

3655 3655 

3656`@` ファイルピッカーが `.gitignore` パターンにマッチするファイルを除外するかどうかを制御します。`/config` に**ファイルピッカーで .gitignore を尊重**として表示されます。3656`@` ファイルピッカーが `.gitignore` のパターンに一致するファイルを除外するかどうかを制御します。`/config` では **Respect .gitignore in file picker** として表示されます。

3657 3657 

3658* **スコープ**: [`任意のファイル`](#scopes)。設定ファイルがそれを設定しない場合、Claude Code は `~/.claude.json` の `respectGitignore` にフォールバックします。これは `/config` トグルが書き込みます。3658* **スコープ**: [`Any file`](#scopes)。どの設定ファイルでも設定されていない場合、Claude Code は `/config` のトグルが書き込む `~/.claude.json` 内の `respectGitignore` にフォールバックします。

3659* **タイプ**: ブール値3659* **型**: Boolean

3660 * `true`: `@` ファイルピッカーは `.gitignore` パターンにマッチするファイルを除外します3660 * `true`: `@` ファイルピッカーは `.gitignore` のパターンに一致するファイルを除外します

3661 * `false`: `@` ファイルピッカーは `.gitignore` パターンにマッチするファイルを含めます3661 * `false`: `@` ファイルピッカーは `.gitignore` のパターンに一致するファイルを含めます

3662* **デフォルト**: `true`3662* **デフォルト**: `true`

3663 3663 

3664```json settings.json theme={null}3664```json settings.json theme={null}


3671 `respondToBashCommands`3671 `respondToBashCommands`

3672</h3>3672</h3>

3673 3673 

3674入力ボックスで[`!` プレフィックス](/docs/ja/interactive-mode#shell-mode-with-prefix)でシェルコマンドを実行した後、Claude が応答するかどうかを選択します。デフォルトでは、Claude Code はコマンドの出力を会話に追加し、Claude がそれに応答します。このキーを `false` に設定して、応答なしでコンテキストに出力を追加し、複数のコマンドを実行して一緒に質問できるようにします。3674入力ボックスで [`!` プレフィックス](/docs/ja/interactive-mode#shell-mode-with-prefix)を付けてシェルコマンドを実行した後に、Claude が応答するかどうかを選択します。デフォルトでは、Claude Code はコマンドの出力を会話に追加し、Claude がそれに応答します。このキーを `false` に設定すると、応答なしで出力がコンテキストに追加されるため、複数のコマンドを実行してからまとめて質問できます。

3675 3675 

3676* **スコープ**: [`任意のファイル`](#scopes)3676* **スコープ**: [`Any file`](#scopes)

3677* **タイプ**: ブール値3677* **型**: Boolean

3678 * `true`: Claude Code はコマンドの出力を会話に追加し、Claude がそれに応答します3678 * `true`: Claude Code はコマンドの出力を会話に追加し、Claude がそれに応答します

3679 * `false`: Claude Code は応答なしでコンテキストに出力を追加します3679 * `false`: Claude Code は応答なしで出力をコンテキストに追加します

3680* **デフォルト**: `true`3680* **デフォルト**: `true`

3681 3681 

3682```json settings.json theme={null}3682```json settings.json theme={null}


3685}3685}

3686```3686```

3687 3687 

3688[`!` プレフィックスでシェルモード](/docs/ja/interactive-mode#shell-mode-with-prefix)を参照してください。3688[`!` プレフィックスによるシェルモード](/docs/ja/interactive-mode#shell-mode-with-prefix)を参照してください。

3689 3689 

3690<h3 id="showclearcontextonplanaccept">3690<h3 id="showclearcontextonplanaccept">

3691 `showClearContextOnPlanAccept`3691 `showClearContextOnPlanAccept`

3692</h3>3692</h3>

3693 3693 

3694Claude が[プランモード](/docs/ja/permission-modes#review-and-approve-a-plan)でプランを完了すると、承認メニューが表示されます。計画は多くのコンテキストを使用できるため、このキーはそのメニューに最初のオプション**はい、コンテキストをクリアして…** を追加します。これはプランを承認し、会話コンテキストをクリアし、プランだけから実装を開始します。ラベルの残りはセッションが続く権限モードに名前を付け、計画がコンテキストをどの程度使用したかを示します。3694[plan モード](/docs/ja/permission-modes#review-and-approve-a-plan)で Claude が計画を完成させると、承認メニューが表示されます。計画には多くのコンテキストが使われることがあるため、このキーはそのメニューに最初のオプションとして **Yes, clear context and …** を追加します。このオプションは計画を承認し、会話のコンテキストをクリアして、計画のみに基づいて実装を開始します。ラベルの残りの部分には、セッションが続行する権限モードと、計画にどれだけのコンテキストが使われたかが表示されます。

3695 3695 

3696* **スコープ**: [`任意のファイル`](#scopes)3696* **スコープ**: [`Any file`](#scopes)

3697* **タイプ**: ブール値3697* **型**: Boolean

3698 * `true`: プラン承認メニューは最初のオプション**はい、コンテキストをクリアして…** を取得します。これはプランを承認し、会話コンテキストをクリアします3698 * `true`: 計画の承認メニューに、計画を承認して会話のコンテキストをクリアする最初のオプション **Yes, clear context and …** が追加されます

3699 * `false`: プラン承認メニューはクリアコンテキストオプションを表示しません3699 * `false`: 計画の承認メニューにコンテキストをクリアするオプションは表示されません

3700* **デフォルト**: `false`3700* **デフォルト**: `false`

3701 3701 

3702```json settings.json theme={null}3702```json settings.json theme={null}


3709 `showTurnDuration`3709 `showTurnDuration`

3710</h3>3710</h3>

3711 3711 

3712各応答後のターン期間メッセージを表示または非表示にします。例えば「Cooked for 1m 6s · done 6:05 PM」。「done」の後の時計はターンが完了した時刻を示します。[`timeFormat`](#timeformat) と [`timeZone`](#timezone) はその形式とゾーンを制御します。`/config` に**ターン期間を表示**として表示されます。3712各応答の後に表示されるターンの所要時間メッセージ(「Cooked for 1m 6s · done 6:05 PM」など)の表示・非表示を切り替えます。「done」の後の時刻はターンが終了した時刻を示し、その形式とタイムゾーンは [`timeFormat`](#timeformat) と [`timeZone`](#timezone) で制御します。`/config` では **Show turn duration** として表示されます。

3713 3713 

3714* **スコープ**: [`任意のファイル`](#scopes)。古いバージョンの `~/.claude.json` の値は、設定ファイルがそれを設定しない場合に適用されます。3714* **スコープ**: [`Any file`](#scopes)。どの設定ファイルでも設定されていない場合、古いバージョンによる `~/.claude.json` 内の値が適用されます。

3715* **タイプ**: ブール値3715* **型**: Boolean

3716 * `true`: 各応答後にターン期間メッセージが表示されます3716 * `true`: 各応答の後にターンの所要時間メッセージが表示されます

3717 * `false`: Claude Code はターン期間メッセージを非表示にします3717 * `false`: Claude Code はターンの所要時間メッセージを非表示にします

3718* **デフォルト**: `true`3718* **デフォルト**: `true`

3719 3719 

3720```json settings.json theme={null}3720```json settings.json theme={null}


3727 `spellcheck`3727 `spellcheck`

3728</h3>3728</h3>

3729 3729 

3730入力時にプロンプト入力でスペルミスのある単語に下線を引きます。インストールするスペルチェッカーを使用します。Claude Code はプロンプト入力ボックスのテキストのみをチェックします。[入力時にスペルをチェック](/docs/ja/interactive-mode#check-spelling-as-you-type)は aspell、hunspell、または ispell のインストールとチェッカーがカバーするものについて説明しています。Claude Code v2.1.235 以降が必要です。3730インストールしたスペルチェッカーを使用して、入力中のプロンプト入力内のスペルミスに下線を引きます。Claude Code がチェックするのは入力ボックス内のテキストのみです。aspell、hunspell、ispell のインストール方法とチェッカーの対象範囲については、[入力中にスペルをチェックする](/docs/ja/interactive-mode#check-spelling-as-you-type)を参照してください。Claude Code v2.1.235 以降が必要です。

3731 3731 

3732* **スコープ**: [`ユーザーまたはマネージド`](#scopes)。それを設定する最高層のブロックが全体として適用されます。3732* **スコープ**: [`User or managed`](#scopes)。これを設定している最上位の階層のブロック全体が適用されます。

3733* **タイプ**: `enabled`(ブール値)、`checker`(`"aspell"`、`"hunspell"`、`"ispell"`、または `"auto"`)、`language`(文字列、チェッカーの辞書名として渡される)、および `color`(文字列、ターミナルカラー名、`#rrggbb`、`rgb(r,g,b)`、`ansi256(n)`、または `ansi:<name>`)を持つオブジェクト3733* **型**: `enabled`(Boolean)、`checker`(`"aspell"`、`"hunspell"`、`"ispell"`、または `"auto"`)、`language`(文字列。辞書名としてチェッカーに渡されます)、`color`(文字列。ターミナルのカラー名、`#rrggbb`、`rgb(r,g,b)`、`ansi256(n)`、または `ansi:<name>`)を持つオブジェクト

3734* **デフォルト**: 未設定、スペルチェックはオフです。`checker` はデフォルトで `"auto"`、`PATH` で見つかった最初の 3 つです。`language` はデフォルトでチェッカー自身の辞書です。`color` はデフォルトでテーマのエラーカラーです3734* **デフォルト**: 未設定。スペルチェックはオフです。`checker` のデフォルトは `"auto"` で、`PATH` 上で最初に見つかった 3 つのうちのいずれかです。`language` のデフォルトはチェッカー自身の辞書です。`color` のデフォルトはテーマのエラーカラーです

3735 3735 

3736```json settings.json theme={null}3736```json settings.json theme={null}

3737{3737{


3743 `spinnerTipsEnabled`3743 `spinnerTipsEnabled`

3744</h3>3744</h3>

3745 3745 

3746Claude が作業している間、スピナーラインは「Plan Mode を使用して複雑なリクエストに備えてから変更を加えます。Shift+Tab を 2 回押して有効にします」などの Claude Code 機能に関する短いヒントをローテーションします。このキーを `false` に設定して非表示にします。`/config` に**ヒントを表示**として表示されます。3746Claude の作業中、スピナーの行には Claude Code の機能に関する短いヒント(「Use Plan Mode to prepare for a complex request before making changes. Press Shift+Tab twice to enable.」など)が順に表示されます。これらを非表示にするには、このキーを `false` に設定します。`/config` では **Show tips** として表示されます。

3747 3747 

3748* **スコープ**: [`任意のファイル`](#scopes)3748* **スコープ**: [`Any file`](#scopes)

3749* **タイプ**: ブール値3749* **型**: Boolean

3750 * `true`: Claude が作業している間、スピナーにヒントが表示されます3750 * `true`: Claude の作業中、スピナーにヒントが表示されます

3751 * `false`: Claude Code はスピナーヒントを非表示にします3751 * `false`: Claude Code はスピナーのヒントを非表示にします

3752* **デフォルト**: `true`3752* **デフォルト**: `true`

3753 3753 

3754```json settings.json theme={null}3754```json settings.json theme={null}


3761 `spinnerTipsOverride`3761 `spinnerTipsOverride`

3762</h3>3762</h3>

3763 3763 

3764Claude Code が Claude の作業中に表示する[スピナーヒント](#spinnertipsenabled)に独自のヒントを追加するか、組み込みヒントを置き換えます。Claude Code はあなたのヒントを組み込みのものと同じローテーションに入れます。3764Claude の作業中に Claude Code が表示する[スピナーのヒント](#spinnertipsenabled)に独自のヒントを追加するか、組み込みのヒントを独自のものに置き換えます。Claude Code は独自のヒントを組み込みのヒントと同じローテーションに入れます。

3765 3765 

3766[`spinnerTipsEnabled`](#spinnertipsenabled) を `false` に設定すると、Claude Code はすべてのヒント(あなたのものを含む)を非表示にします。3766[`spinnerTipsEnabled`](#spinnertipsenabled) を `false` に設定すると、Claude Code は独自のヒントも含めてすべてのヒントを非表示にします。

3767 3767 

3768* **スコープ**: [`任意のファイル`](#scopes)。Claude Code はヒントオブジェクト、`tipsFile`、`label`、および `excludeDefault` をユーザー設定、`--settings` フラグ、およびマネージド設定から尊重します。プロジェクトおよびローカル設定からは、プレーン文字列ヒントのみを読み取ります。3768* **スコープ**: [`Any file`](#scopes)。Claude Code は、ユーザー設定、`--settings` フラグ、管理設定からのヒントオブジェクト、`tipsFile`、`label`、`excludeDefault` を受け入れます。プロジェクト設定とローカル設定からは、プレーンな文字列のヒントのみを読み取ります。

3769* **タイプ**: `tips`、`tipsFile`、`label`、および `excludeDefault` フィールドを持つオブジェクト。各フィールドはオプションです3769* **型**: `tips`、`tipsFile`、`label`、`excludeDefault` フィールドを持つオブジェクト。各フィールドはオプションです

3770* **デフォルト**: 未設定、Claude Code は組み込みヒントのみを表示します3770* **デフォルト**: 未設定。Claude Code は組み込みのヒントのみを表示します

3771 3771 

3772ヒントオブジェクト、`tipsFile`、`label`、およびスコープ行のルール(プロジェクトおよびローカル設定がプレーン文字列のみを提供)には Claude Code v2.1.247 以降が必要です。3772ヒントオブジェクト、`tipsFile`、`label`、およびプロジェクト設定とローカル設定はプレーンな文字列のみを提供するというスコープの規則には、Claude Code v2.1.247 以降が必要です。

3773 3773 

3774各 `tips` エントリはプレーン文字列またはこれらのフィールドを持つオブジェクトです:3774各 `tips` エントリは、プレーンな文字列か、次のフィールドを持つオブジェクトです。

3775 3775 

3776| フィールド | 必須 | 説明 |3776| フィールド | 必須 | 説明 |

3777| :- | :- | :- |3777| :- | :- | :- |

3778| `id` | はい | 最大 64 文字、数字、`.`、`_`、または `-`。Claude Code はヒントの表示履歴をキーにするため、ヒントのクールダウンはリストの並べ替えを生き残ります。同じ id を持つ 2 つのエントリのうち、Claude Code は最初のものを使用します |3778| `id` | はい | 最大 64 文字の英字、数字、`.`、`_`、`-`。Claude Code はこれをキーとしてヒントの表示履歴を管理するため、リストの順序を変更してもヒントのクールダウンは維持されます。同じ id を持つエントリが 2 つある場合、Claude Code は最初のものを使用します |

3779| `text` | はい | ヒント、最大 500 文字の 1 行。Claude Code は ANSI エスケープと制御文字を削除し、空白を折りたたみます |3779| `text` | はい | ヒント。最大 500 文字の 1 行です。Claude Code は ANSI エスケープと制御文字を取り除き、空白をまとめます |

3780| `cooldownSessions` | いいえ | Claude Code がヒントを再度表示する前に待機するセッション数、`0` から `1000`、デフォルト `0` |3780| `cooldownSessions` | いいえ | Claude Code がヒントを再表示するまでに待機するセッション数。`0` から `1000`、デフォルトは `0` |

3781| `priority` | いいえ | 同じ期間表示されていないヒント間の順序、より高い最初、`-10` から `10`、デフォルト `0` |3781| `priority` | いいえ | 表示されていない期間が同じヒント同士の順序。値が大きいほど先に表示されます。`-10` から `10`、デフォルトは `0` |

3782 3782 

3783Claude Code はプレーン文字列をこれらのデフォルトを持つヒントとして読み取り、位置ベースの id を読み取るため、リストを並べ替えるとその表示履歴がリセットされます。ヒントに `id` を付けて、編集全体で履歴を保持します。3783Claude Code はプレーンな文字列を、これらのデフォルト値と位置に基づく id を持つヒントとして読み取るため、リストの順序を変更するとその表示履歴はリセットされます。編集をまたいで履歴を保持するには、ヒントに `id` を付けてください。

3784 3784 

3785Claude Code は `tips` と `tipsFile` 全体で最大 200 個のヒントを読み取り、設定ファイルを拒否する代わりに、デバッグ警告で無効なエントリを削除します。3785Claude Code が読み取るヒントは `tips` と `tipsFile` を合わせて最大 200 件で、無効なエントリは設定ファイルを拒否するのではなく、デバッグ警告とともに破棄します。

3786 3786 

3787残りのフィールドを使用して、ヒントファイルに名前を付け、プレフィックスを設定し、組み込みヒントを非表示にします:3787残りのフィールドを使用して、ヒントファイルの指定、プレフィックスの設定、組み込みのヒントの非表示を行います。

3788 3788 

3789* `tipsFile`: ローカル JSON ファイルへの絶対パスまたは `~/` パス。同じエントリの配列、またはオブジェクト(`tips` 配列を持つ)を保持します。最大 256 KB。Claude Code はプロセスごとに 1 回ファイルを読み取るため、次の起動時に編集が読み込まれます。[サーバー管理設定](/docs/ja/server-managed-settings)を通じて設定することはできません。インライン `tips` をそこに展開するか、オンディスク `managed-settings.json` にパスを展開します。3789* `tipsFile`: 同じエントリの配列、または `tips` 配列を持つオブジェクトを保持するローカル JSON ファイルへの絶対パスまたは `~/` パス。最大 256 KB です。Claude Code はファイルをプロセスごとに 1 回読み取るため、編集内容は次回の起動時に読み込まれます。[サーバー管理設定](/docs/ja/server-managed-settings)では設定できません。サーバー管理設定ではインラインの `tips` をデプロイするか、ディスク上の `managed-settings.json` でパスをデプロイしてください。

3790* `label`: Claude Code がユーザー、`--settings`、およびマネージド設定からのヒントの前に表示するプレフィックス。最大 40 文字。デフォルトは `Tip`、組み込みヒントと同じプレフィックスであり、プロジェクトおよびローカル設定からのヒントは常にそれを使用します。3790* `label`: ユーザー設定、`--settings`、管理設定からのヒントの前に Claude Code が表示するプレフィックス。最大 40 文字です。デフォルトは組み込みのヒントと同じプレフィックスの `Tip` で、プロジェクト設定とローカル設定からのヒントには常にこれが使われます。

3791* `excludeDefault`: `true` に設定して、組み込みヒントを非表示にし、あなたのヒントのみを表示します。Claude Code がヒントを読み込めない場合(例えば `tipsFile` が存在しないか、すべてのエントリが無効な場合)、空のスピナーの代わりに組み込みローテーションを保持します。3791* `excludeDefault`: `true` に設定すると、組み込みのヒントを非表示にして独自のヒントのみを表示します。`tipsFile` が存在しない、またはすべてのエントリが無効であるなどの理由で Claude Code が独自のヒントを 1 つも読み込めない場合、空のスピナーではなく組み込みのローテーションを維持します。

3792 3792 

3793複数の設定ファイルがキーを設定する場合、Claude Code はすべてのファイルからヒントを表示し、マネージド設定、`--settings` フラグ、およびユーザー設定のうち、各 `tipsFile`、`label`、および `excludeDefault` を設定する最高優先度のものから取得します。3793複数の設定ファイルでこのキーが設定されている場合、Claude Code はそれらすべてのヒントを表示し、`tipsFile`、`label`、`excludeDefault` はそれぞれ、管理設定、`--settings` フラグ、ユーザー設定のうち、それを設定している最も優先順位の高いものから取得します。

3794 3794 

3795この例(ユーザー設定)は、プレーン文字列ヒントとオブジェクトヒントを `Acme tip` プレフィックスの下のローテーションに追加します:3795この例はユーザー設定に記述するもので、`Acme tip` プレフィックスの下で、プレーンな文字列のヒントとオブジェクトのヒントをローテーションに追加します。

3796 3796 

3797```json settings.json theme={null}3797```json settings.json theme={null}

3798{3798{


3811}3811}

3812```3812```

3813 3813 

3814例の各フィールドは Claude Code がヒントを表示する方法の 1 つを変更します:3814例の各フィールドは、Claude Code によるヒントの表示方法をそれぞれ 1 点ずつ変更します。

3815 3815 

3816* `label`: Claude Code は両方のヒントを `Tip: ...` の代わりに `Acme tip: ...` として表示します。3816* `label`: Claude Code は両方のヒントを `Tip: ...` ではなく `Acme tip: ...` として表示します。

3817* プレーン文字列: Claude Code はデフォルトを付与するため、次のセッションで再度表示される可能性があります。3817* プレーンな文字列: Claude Code はデフォルト値を適用するため、直後のセッションで再び表示されることがあります。

3818* `id`: Claude Code は 2 番目のヒントの表示履歴を `gateway-errors` にキーにするため、そのクールダウンはヒントを追加または並べ替えた後も適用されます。3818* `id`: Claude Code は 2 つ目のヒントの表示履歴を `gateway-errors` をキーとして管理するため、ヒントを追加したり順序を変更したりした後もクールダウンが適用されます。

3819* `cooldownSessions`: Claude Code が `gateway-errors` ヒントを表示した後、そのヒントを 5 セッション後まで再度表示しません。3819* `cooldownSessions`: Claude Code は `gateway-errors` ヒントを表示した後、5 セッション後までそのヒントを再表示しません。

3820* `priority`: `gateway-errors` ヒントと別のヒントが同じ期間表示されていない場合(例えば、どちらも表示されていない場合)、Claude Code は `gateway-errors` を最初に表示します。プレーン文字列はデフォルト優先度 `0` を持ちます。3820* `priority`: `gateway-errors` ヒントと別のヒントが同じセッション数だけ表示されていない場合(たとえば、どちらもまだ表示されていない場合)、Claude Code は `gateway-errors` を先に表示します。プレーンな文字列はデフォルトの優先度 `0` を持ちます。

3821 3821 

3822Claude が作業している間、Claude Code はあなたのプレフィックス(例えば `Acme tip: Run /review before opening a PR`)でスピナーにあなたのヒントを表示します。3822Claude の作業中、Claude Code は `Acme tip: Run /review before opening a PR` のように、スピナーに独自のプレフィックス付きでヒントを表示します。

3823 3823 

3824<h3 id="spinnerverbs">3824<h3 id="spinnerverbs">

3825 `spinnerVerbs`3825 `spinnerVerbs`

3826</h3>3826</h3>

3827 3827 

3828ターンが進行中の間、スピナーは「Accomplishing」、「Architecting」、または「Baking」などのローテーション動詞を表示します。このキーを使用して、そのローテーションに独自の動詞を追加するか、組み込みリストを置き換えます。3828ターンの進行中、スピナーには「Accomplishing」、「Architecting」、「Baking」などの動詞が順に表示されます。このキーを使用すると、そのローテーションに独自の動詞を追加したり、組み込みのリストを独自のものに置き換えたりできます。

3829 3829 

3830* **スコープ**: [`任意のファイル`](#scopes)3830* **スコープ**: [`Any file`](#scopes)

3831* **タイプ**: `verbs` 文字列の配列と `mode` を持つオブジェクト。以下のいずれか:3831* **型**: 文字列の `verbs` 配列と、次のいずれかである `mode` を持つオブジェクト:

3832 * `"append"`: Claude Code は組み込みセットに動詞を追加します3832 * `"append"`: Claude Code は組み込みのセットに独自の動詞を追加します

3833 * `"replace"`: Claude Code はあなたの動詞のみを表示します3833 * `"replace"`: Claude Code は独自の動詞のみを表示します

3834* **デフォルト**: 未設定、Claude Code は組み込み動詞を使用します3834* **デフォルト**: 未設定。Claude Code は組み込みの動詞を使用します

3835 3835 

3836この例は 2 つの動詞を組み込みセットに追加します:3836この例では、組み込みのセットに 2 つの動詞を追加します。

3837 3837 

3838```json settings.json theme={null}3838```json settings.json theme={null}

3839{3839{


3844}3844}

3845```3845```

3846 3846 

3847`"replace"` モードで空の `verbs` 配列の場合、Claude Code は組み込み動詞を保持します。3847`"replace"` モードで `verbs` 配列が空の場合、Claude Code は組み込みの動詞を維持します。

3848 3848 

3849<h3 id="statusline">3849<h3 id="statusline">

3850 `statusLine`3850 `statusLine`

3851</h3>3851</h3>

3852 3852 

3853[ステータスライン](/docs/ja/statusline)をプロンプトの下にレンダリングする独自のコマンドを実行します。モデル、コスト、git ブランチなどのコンテキストを含みます。オプションのフィールドは間隔を調整し、定期的な再実行を追加し、スクリプトが `vim.mode` 自体をレンダリングする場合は組み込みの vim モードインジケーターを非表示にします。3853独自のコマンドを実行して、モデル、コスト、git ブランチなどのコンテキストを含む[ステータスライン](/docs/ja/statusline)をプロンプトの下にレンダリングします。オプションのフィールドで、間隔の調整、定期的な再実行の追加、スクリプト自体が `vim.mode` をレンダリングする場合の組み込みの vim モードインジケーターの非表示を行えます。

3854 3854 

3855* **スコープ**: [`任意のファイル`](#scopes)。[`allowManagedHooksOnly`](#allowmanagedhooksonly) がオンの場合、または [`disableAllHooks`](#disableallhooks) がマネージド設定の外で設定されている場合、マネージド設定値のみが実行されます。3855* **スコープ**: [`Any file`](#scopes)。[`allowManagedHooksOnly`](#allowmanagedhooksonly) がオンの場合、または [`disableAllHooks`](#disableallhooks) が管理設定以外で設定されている場合、管理設定の値のみが実行されます。

3856* **タイプ**: `type` を `"command"` に設定し、`command` 文字列を持つオブジェクト。オプションで `padding` を文字数として、`refreshInterval` を秒数として(最小 `1`)、`hideVimModeIndicator` をブール値として3856* **型**: `"command"` に設定された `type` と `command` 文字列を持つオブジェクト。加えて、文字数を表すオプションの `padding`、秒数を表すオプションの `refreshInterval`(最小値 `1`)、Boolean であるオプションの `hideVimModeIndicator` を持ちます

3857* **デフォルト**: 未設定、ステータスラインなし3857* **デフォルト**: 未設定。ステータスラインは表示されません

3858 3858 

3859この例はモデル名とコンテキスト使用量を出力し、2 文字の水平間隔を追加します:3859この例では、モデル名とコンテキストの使用量を出力し、2 文字分の水平方向の間隔を追加します。

3860 3860 

3861```json settings.json theme={null}3861```json settings.json theme={null}

3862{3862{


3868}3868}

3869```3869```

3870 3870 

3871例には[`jq`](https://jqlang.org/)がインストールされている必要があり、シェルで実行されます。PowerShell および Git Bash の同等物については、[Windows 設定](/docs/ja/statusline#windows-configuration)を参照してください。完全なセットアップについては、[ステータスラインを手動で設定](/docs/ja/statusline#manually-configure-a-status-line)を参照してください。3871この例では [`jq`](https://jqlang.org/) がインストールされている必要があり、シェルで実行されます。PowerShell と Git Bash での同等の設定については [Windows での設定](/docs/ja/statusline#windows-configuration)を、完全な設定手順については[ステータスラインを手動で設定する](/docs/ja/statusline#manually-configure-a-status-line)を参照してください。

3872 3872 

3873<h3 id="subagentstatusline">3873<h3 id="subagentstatusline">

3874 `subagentStatusLine`3874 `subagentStatusLine`

3875</h3>3875</h3>

3876 3876 

3877Claude が[サブエージェント](/docs/ja/sub-agents)を実行する場合、Claude Code はプロンプトの下のタスク表示にそれらをリストします。サブエージェントごとに 1 行。`name · description · token count` を表示します。このキーを使用すると、独自のコマンドを実行してそれらの行を書き直すことができます。例えば、各サブエージェントのコンテキスト使用量をパーセンテージとして表示します。各リフレッシュで、Claude Code は表示されている行を 1 つの JSON オブジェクトとして stdin に送信します。`tasks` 配列は各サブエージェントの `id`、`name`、`status`、`model`、`tokenCount` などを含みます。書き直した各 `id` の行を `{"id", "content"}` 行として置き換えます。書き直さない行はデフォルトレンダリングを保持します。3877Claude が[サブエージェント](/docs/ja/sub-agents)を実行すると、Claude Code はプロンプトの下のタスク表示にそれらを一覧表示し、サブエージェントごとに `name · description · token count` を示す行を 1 行ずつ表示します。このキーを使用すると、独自のコマンドを実行してそれらの行を書き換えられます。たとえば、各サブエージェントのコンテキスト使用量をパーセンテージで表示できます。更新のたびに、Claude Code は表示中の行を 1 つの JSON オブジェクトとして stdin に送信します。このオブジェクトには、各サブエージェントの `id`、`name`、`status`、`model`、`tokenCount` などを含む `tasks` 配列が含まれます。Claude Code は、`{"id", "content"}` 行として書き戻された各 `id` の行を置き換えます。書き戻さなかった行はデフォルトのレンダリングのままです。

3878 3878 

3879* **スコープ**: [`任意のファイル`](#scopes)。[`allowManagedHooksOnly`](#allowmanagedhooksonly) がオンの場合、または [`disableAllHooks`](#disableallhooks) がマネージド設定の外で設定されている場合、マネージド設定値のみが実行されます。3879* **スコープ**: [`Any file`](#scopes)。[`allowManagedHooksOnly`](#allowmanagedhooksonly) がオンの場合、または [`disableAllHooks`](#disableallhooks) が管理設定以外で設定されている場合、管理設定の値のみが実行されます。

3880* **タイプ**: `type` を `"command"` に設定し、`command` 文字列を持つオブジェクト3880* **型**: `"command"` に設定された `type` と `command` 文字列を持つオブジェクト

3881* **デフォルト**: 未設定、Claude Code はデフォルト行をレンダリングします3881* **デフォルト**: 未設定。Claude Code はデフォルトの行をレンダリングします

3882 3882 

3883```json settings.json theme={null}3883```json settings.json theme={null}

3884{3884{


3889}3889}

3890```3890```

3891 3891 

3892[サブエージェントステータスライン](/docs/ja/statusline#subagent-status-lines)を参照してください。3892[サブエージェントのステータスライン](/docs/ja/statusline#subagent-status-lines)を参照してください。

3893 3893 

3894<h3 id="syntaxhighlightingdisabled">3894<h3 id="syntaxhighlightingdisabled">

3895 `syntaxHighlightingDisabled`3895 `syntaxHighlightingDisabled`

3896</h3>3896</h3>

3897 3897 

3898Claude Code は組み込みハイライターを使用して、ターミナルに表示される diff、コードブロック、ファイルプレビューで言語別にコードを色付けします。プラグインまたは言語サーバーは関与しません。このキーを `true` に設定して、代わりにプレーンテキストとして表示します。例えば、色がターミナルテーマと競合する場合やスクリーンリーダーを遅くする場合。3898Claude Code は、ターミナルに表示する差分、コードブロック、ファイルプレビュー内のコードを、組み込みのハイライターで言語ごとに色分けします。プラグインや言語サーバーは関与しません。このキーを `true` に設定すると、代わりにプレーンテキストとして表示します。たとえば、色がターミナルのテーマと合わない場合や、スクリーンリーダーの動作が遅くなる場合に使用します。

3899 3899 

3900* **スコープ**: [`任意のファイル`](#scopes)3900* **スコープ**: [`Any file`](#scopes)

3901* **タイプ**: ブール値3901* **型**: Boolean

3902 * `true`: Claude Code は diff、コードブロック、ファイルプレビューの構文ハイライトをオフにします3902 * `true`: Claude Code は差分、コードブロック、ファイルプレビューでシンタックスハイライトをオフにします

3903 * `false`: Claude Code は構文をハイライトします3903 * `false`: Claude Code はシンタックスハイライトを行います

3904* **デフォルト**: `false`3904* **デフォルト**: `false`

3905 3905 

3906```json settings.json theme={null}3906```json settings.json theme={null}


3913 `terminalProgressBarEnabled`3913 `terminalProgressBarEnabled`

3914</h3>3914</h3>

3915 3915 

3916一部のターミナルは、それらで実行されているプログラムのタブまたはタスクバーに進捗インジケーターを表示できます。Claude が作業している間、Claude Code はターミナルに進行中の状態を報告するため、別のタブまたはウィンドウからセッションがまだビジーかどうかを確認できます。[バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)または[動的ワークフロー](/docs/ja/workflows)がまだ実行されている間、インジケーターはターンの終了後も表示されたままになり、セッションがアイドル状態になるとクリアされます。3916一部のターミナルでは、その中で実行されているプログラムの進行状況インジケーターをタブやタスクバーに表示できます。Claude の作業中、Claude Code はターミナルに進行中の状態を報告するため、別のタブやウィンドウからセッションがまだビジーかどうかを確認できます。ターンの終了後も、[バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)や[動的ワークフロー](/docs/ja/workflows)がまだ実行中の間はインジケーターが表示されたままになり、セッションがアイドル状態になるとクリアされます。

3917 3917 

3918Claude Code はインジケーターをサポートするターミナルでのみ報告します。ConEmu、Ghostty 1.2.0 以降、および iTerm2 3.6.6 以降。このキーを `false` に設定して、Claude Code がそれを報告するのを停止します。`/config` に**ターミナル進捗バー**として表示されます。3918Claude Code がこれを報告するのは、インジケーターをサポートするターミナル(ConEmu、Ghostty 1.2.0 以降、iTerm2 3.6.6 以降)のみです。Claude Code による報告を停止するには、このキーを `false` に設定します。`/config` では **Terminal progress bar** として表示されます。

3919 3919 

3920* **スコープ**: [`任意のファイル`](#scopes)。古いバージョンの `~/.claude.json` の値は、設定ファイルがそれを設定しない場合に適用されます。3920* **スコープ**: [`Any file`](#scopes)。どの設定ファイルでも設定されていない場合、古いバージョンによる `~/.claude.json` 内の値が適用されます。

3921* **タイプ**: ブール値3921* **型**: Boolean

3922 * `true`: サポートするターミナルでターミナル進捗バーが表示されます3922 * `true`: サポートしているターミナルでターミナルのプログレスバーが表示されます

3923 * `false`: Claude Code はターミナル進捗バーを非表示にします3923 * `false`: Claude Code はターミナルのプログレスバーを非表示にします

3924* **デフォルト**: `true`3924* **デフォルト**: `true`

3925 3925 

3926```json settings.json theme={null}3926```json settings.json theme={null}


3933 `terminalTitleFromRename`3933 `terminalTitleFromRename`

3934</h3>3934</h3>

3935 3935 

3936Claude Code はターミナルタブのタイトルを設定します。デフォルトでは、会話から生成されたタイトルを使用し、`/rename` または `--name` で[セッションに名前を付ける](/docs/ja/sessions#name-your-sessions)と、タブはその名前を代わりに表示します。このキーを `false` に設定して、セッションに名前を付けた後も、生成されたタイトルをタブに保持します。名前自体は引き続き適用されるため、`/resume <name>` とセッションピッカーはそれを見つけます。3936Claude Code はターミナルのタブのタイトルを設定します。デフォルトでは会話から生成したタイトルを使用し、`/rename` または `--name` でセッションに[名前](/docs/ja/sessions#name-your-sessions)を付けると、タブには代わりにその名前が表示されます。セッションに名前を付けた後も生成されたタイトルをタブに表示し続けるには、このキーを `false` に設定します。名前自体は引き続き適用されるため、`/resume <name>` やセッションピッカーで見つけることができます。

3937 3937 

3938* **スコープ**: [`任意のファイル`](#scopes)3938* **スコープ**: [`Any file`](#scopes)

3939* **タイプ**: ブール値3939* **型**: Boolean

3940 * `true`: ターミナルタブのタイトルは設定したセッション名を表示します3940 * `true`: ターミナルのタブのタイトルに、設定したセッション名が表示されます

3941 * `false`: タブは会話から生成された Claude Code のタイトルを保持します3941 * `false`: タブには Claude Code が会話から生成したタイトルが表示されたままになります

3942* **デフォルト**: `true`3942* **デフォルト**: `true`

3943 3943 

3944```json settings.json theme={null}3944```json settings.json theme={null}


3947}3947}

3948```3948```

3949 3949 

3950Claude Code がターミナルタイトルを更新するのを完全に停止するには、代わりに [`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`](/docs/ja/env-vars) を `1` に設定します。3950Claude Code によるターミナルのタイトルの更新を完全に停止するには、代わりに [`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`](/docs/ja/env-vars) を `1` に設定します。

3951 3951 

3952<h3 id="theme">3952<h3 id="theme">

3953 `theme`3953 `theme`

3954</h3>3954</h3>

3955 3955 

3956インターフェースのカラーテーマを選択します。`/config` に**テーマ**として表示されます。3956インターフェースのカラーテーマを選択します。`/config` では **Theme** として表示されます。

3957 3957 

3958* **スコープ**: [`任意のファイル`](#scopes)。古いバージョンの `~/.claude.json` の値は、設定ファイルがそれを設定しない場合に適用されます。3958* **スコープ**: [`Any file`](#scopes)。どの設定ファイルでも設定されていない場合、古いバージョンによる `~/.claude.json` 内の値が適用されます。

3959* **タイプ**: 文字列、以下のいずれか:3959* **型**: 文字列。次のいずれか:

3960 * `"auto"`: ターミナルの明るいまたは暗い背景に一致します3960 * `"auto"`: ターミナルのライトまたはダークの背景に合わせます

3961 * `"dark"`: ダークテーマ3961 * `"dark"`: ダークテーマ

3962 * `"light"`: ライトテーマ3962 * `"light"`: ライトテーマ

3963 * `"dark-daltonized"`: 色覚異常フレンドリーな色を持つダークテーマ3963 * `"dark-daltonized"`: 色覚多様性に配慮した色を使用するダークテーマ

3964 * `"light-daltonized"`: 色覚異常フレンドリーな色を持つライトテーマ3964 * `"light-daltonized"`: 色覚多様性に配慮した色を使用するライトテーマ

3965 * `"dark-ansi"`: ターミナルの ANSI カラーパレットのみを使用するダークテーマ3965 * `"dark-ansi"`: ターミナルの ANSI カラーパレットのみを使用するダークテーマ

3966 * `"light-ansi"`: ターミナルの ANSI カラーパレットのみを使用するライトテーマ3966 * `"light-ansi"`: ターミナルの ANSI カラーパレットのみを使用するライトテーマ

3967 * `"custom:<slug>"` または `"custom:<plugin-name>:<slug>"`: `~/.claude/themes/` またはプラグインからのカスタムテーマ3967 * `"custom:<slug>"` または `"custom:<plugin-name>:<slug>"`: `~/.claude/themes/` またはプラグインのカスタムテーマ

3968* **デフォルト**: `"dark"`3968* **デフォルト**: `"dark"`

3969 3969 

3970```json settings.json theme={null}3970```json settings.json theme={null}


3973}3973}

3974```3974```

3975 3975 

3976[カスタムテーマを作成](/docs/ja/terminal-config#create-a-custom-theme)を参照してください。3976[カスタムテーマを作成する](/docs/ja/terminal-config#create-a-custom-theme)を参照してください。

3977 3977 

3978<h3 id="timeformat">3978<h3 id="timeformat">

3979 `timeFormat`3979 `timeFormat`

3980</h3>3980</h3>

3981 3981 

3982Claude Code がインターフェースに表示する時刻の書き方を選択します。例えば、各ターン期間メッセージの終わりの `done 6:05 PM` と[トランスクリプトビューアー](/docs/ja/interactive-mode#transcript-viewer)のタイムスタンプ。プリセットを選択するには、`/config` を実行して**時間形式**を設定します。Claude Code v2.1.257 以降が必要です。3982各ターンの所要時間メッセージの末尾にある `done 6:05 PM` や、[トランスクリプトビューアー](/docs/ja/interactive-mode#transcript-viewer)のタイムスタンプなど、Claude Code がインターフェースに表示する時刻の書式を選択します。プリセットを選ぶには、`/config` を実行して **Time format** を設定します。Claude Code v2.1.257 以降が必要です。

3983 3983 

3984* **スコープ**: [`任意のファイル`](#scopes)3984* **スコープ**: [`Any file`](#scopes)

3985* **タイプ**: 文字列、以下のいずれか:3985* **型**: 文字列。次のいずれか:

3986 * `"auto"`: 未設定と同じです。各時刻は組み込み形式を保持し、ターン期間メッセージではロケールに従います3986 * `"auto"`: 未設定と同じです。各時刻は組み込みの書式を維持し、ターンの所要時間メッセージではロケールに従います

3987 * `"12-hour"`: 12 時間制3987 * `"12-hour"`: 12 時間制

3988 * `"24-hour"`: 24 時間制3988 * `"24-hour"`: 24 時間制

3989 * `"24-hour-utc"`: UTC での 24 時間制。分の後に `Z` が付きます。例えば `18:05Z`。Claude Code はこのプリセットの [`timeZone`](#timezone) を無視します3989 * `"24-hour-utc"`: UTC の 24 時間制で、`18:05Z` のように分の後に `Z` が付きます。このプリセットでは Claude Code は [`timeZone`](#timezone) を無視します

3990 * `"%H:%M"` などの strftime パターン: Claude Code はパターンで各時刻を書きます。`%` を含む値はパターンであり、プリセット外の他の値は `"auto"` としてカウントされます3990 * `"%H:%M"` のような strftime パターン: Claude Code は各時刻をそのパターンで書き出します。`%` を含む値はすべてパターンとして扱われ、プリセット以外のそれ以外の値は `"auto"` とみなされます

3991* **デフォルト**: `"auto"`3991* **デフォルト**: `"auto"`

3992 3992 

3993```json settings.json theme={null}3993```json settings.json theme={null}


3996}3996}

3997```3997```

3998 3998 

3999`/config` はプリセットのみを提供するため、strftime パターンを使用するには、キーを設定ファイルに追加します。この例は各時刻を 2 桁の 24 時間制として表示します:3999`/config` ではプリセットのみが選択できるため、strftime パターンを使用するには、設定ファイルにキーを追加します。この例では、各時刻を 2 桁の 24 時間制で表示します。

4000 4000 

4001```json settings.json theme={null}4001```json settings.json theme={null}

4002{4002{


4004}4004}

4005```4005```

4006 4006 

4007ターン期間メッセージとトランスクリプトビューアーは `18:05` などの時刻を表示します。トランスクリプトビューアーでは、パターンはタイムスタンプ全体であるため、日付をそこに含める場合は日付ディレクティブを追加します。この例は時計の前に日付を配置します:4007すると、ターンの所要時間メッセージとトランスクリプトビューアーに `18:05` のような時刻が表示されます。トランスクリプトビューアーではパターンがタイムスタンプ全体となるため、日付も表示したい場合は日付のディレクティブを追加します。この例では時刻の前に日付を付けます。

4008 4008 

4009```json settings.json theme={null}4009```json settings.json theme={null}

4010{4010{


4012}4012}

4013```4013```

4014 4014 

4015同じサーフェスは `2026-09-01 18:05` などの時刻を表示します。4015すると、同じ箇所に `2026-09-01 18:05` のような時刻が表示されます。

4016 4016 

4017<h3 id="timezone">4017<h3 id="timezone">

4018 `timeZone`4018 `timeZone`

4019</h3>4019</h3>

4020 4020 

4021インターフェースの時刻をシステムの時刻以外のタイムゾーンで表示します。[IANA タイムゾーン名](https://www.iana.org/time-zones)(`"UTC"` または `"Europe/Dublin"` など)に設定します。[`timeFormat`](#timeformat) が制御する時刻はこのゾーンで表示されます。`timeFormat` が `"24-hour-utc"` の場合、時刻は UTC のままであり、Claude Code はこのキーを無視します。`/config` にはこのキーの行がないため、設定ファイルで設定します。Claude Code v2.1.257 以降が必要です。4021インターフェースの時刻を、システムのタイムゾーン以外のタイムゾーンで表示します。`"UTC"` や `"Europe/Dublin"` などの [IANA タイムゾーン名](https://www.iana.org/time-zones)を設定します。これにより、[`timeFormat`](#timeformat) が制御する時刻がこのタイムゾーンで表示されます。`timeFormat` が `"24-hour-utc"` の場合、時刻は UTC のままとなり、Claude Code はこのキーを無視します。`/config` にはこのキーの行がないため、設定ファイルで設定してください。Claude Code v2.1.257 以降が必要です。

4022 4022 

4023* **スコープ**: [`任意のファイル`](#scopes)4023* **スコープ**: [`Any file`](#scopes)

4024* **タイプ**: 文字列、IANA タイムゾーン名。Claude Code が名前を認識しない場合、システムタイムゾーンを使用します4024* **型**: 文字列。IANA タイムゾーン名です。Claude Code が名前を認識できない場合は、システムのタイムゾーンを使用します

4025* **デフォルト**: 未設定、時刻はシステムタイムゾーンで表示されます4025* **デフォルト**: 未設定。時刻はシステムのタイムゾーンで表示されます

4026 4026 

4027```json settings.json theme={null}4027```json settings.json theme={null}

4028{4028{


4034 `tui`4034 `tui`

4035</h3>4035</h3>

4036 4036 

4037ターミナル UI レンダラーを選択します。ちらつきのない[alt-screen レンダラー](/docs/ja/fullscreen)を仮想スクロールバックで使用するには `"fullscreen"` を使用するか、クラシックメインスクリーンレンダラーには `"default"` を使用します。`/tui fullscreen` または `/tui default` を実行すると、このキーが書き込まれます。4037ターミナル UI のレンダラーを選択します。仮想化されたスクロールバックを備えたちらつきのない[代替スクリーンレンダラー](/docs/ja/fullscreen)には `"fullscreen"` を、クラシックなメインスクリーンレンダラーには `"default"` を使用します。`/tui fullscreen` または `/tui default` を実行すると、このキーが自動で書き込まれます。

4038 4038 

4039* **スコープ**: [`任意のファイル`](#scopes)4039* **スコープ**: [`Any file`](#scopes)

4040* **タイプ**: 文字列、以下のいずれか:4040* **型**: 文字列。次のいずれか:

4041 * `"default"`: クラシックメインスクリーンレンダラー4041 * `"default"`: クラシックなメインスクリーンレンダラー

4042 * `"fullscreen"`: 仮想スクロールバック付きのちらつきのない alt-screen レンダラー4042 * `"fullscreen"`: 仮想化されたスクロールバックを備えた、ちらつきのない代替スクリーンレンダラー

4043* **デフォルト**: 未設定、Claude Code は[レンダラーを自動的に選択](/docs/ja/fullscreen#fullscreen-by-default)します4043* **デフォルト**: 未設定。Claude Code が[レンダラーを自動で選択します](/docs/ja/fullscreen#fullscreen-by-default)

4044* **セッションごとのオーバーライド**: [`CLAUDE_CODE_NO_FLICKER`](/docs/ja/env-vars) と [`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`](/docs/ja/env-vars) はこのキーより優先されます。`CLAUDE_CODE_NO_FLICKER=1` はフルスクリーンをオンにし、`CLAUDE_CODE_NO_FLICKER=0` または `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1` はオフにします。両方が設定されている場合、Claude Code はオフにします4044* **セッションごとの上書き**: 1 つのセッションについては、[`CLAUDE_CODE_NO_FLICKER`](/docs/ja/env-vars) と [`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`](/docs/ja/env-vars) がこのキーより優先されます。`CLAUDE_CODE_NO_FLICKER=1` はフルスクリーンをオンにし、`CLAUDE_CODE_NO_FLICKER=0` または `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1` はオフにします。両方が設定されている場合、Claude Code はオフにします

4045 4045 

4046```json settings.json theme={null}4046```json settings.json theme={null}

4047{4047{


4049}4049}

4050```4050```

4051 4051 

4052tmux `-CC` の下または Windows への SSH 経由では、Claude Code は `CLAUDE_CODE_NO_FLICKER=1` を設定しない限りクラシックレンダラーを保持します。[エージェントビュー](/docs/ja/agent-view)から開かれたバックグラウンドセッションは、この設定に関係なく常にフルスクリーンレンダラーを使用します。4052tmux `-CC` の下や、Windows への SSH 接続では、`CLAUDE_CODE_NO_FLICKER=1` を設定しない限り、Claude Code はクラシックレンダラーを維持します。[エージェントビュー](/docs/ja/agent-view)から開いたバックグラウンドセッションは、この設定にかかわらず常にフルスクリーンレンダラーを使用します。

4053 4053 

4054<h3 id="verbose">4054<h3 id="verbose">

4055 `verbose`4055 `verbose`

4056</h3>4056</h3>

4057 4057 

4058デフォルトでは、トランスクリプトは各ツール呼び出しを短い要約に折りたたみます。例えば、Claude が実行したコマンドと出力の行数。詳細を表示したい場合は `Ctrl+O` を押してトランスクリプト全体を展開ビューに切り替えます。このキーを `true` に設定して、すべてのツール呼び出しの完全な入力と出力をインラインで表示します。フック、MCP サーバー、または長いシェルコマンドをデバッグする場合に便利です。`/config` に**詳細出力**として表示されます。4058デフォルトでは、トランスクリプトは各ツール呼び出しを、Claude が実行したコマンドとその出力の行数などの短い要約に折りたたみます。詳細を見たいときは `Ctrl+O` を押して、トランスクリプト全体を展開ビューに切り替えます。このキーを `true` に設定すると、すべてのツール呼び出しの入力と出力の全体が発生時にインラインで表示されます。これは、フック、MCP サーバー、長いシェルコマンドをデバッグする際に便利です。`/config` では **Verbose output** として表示されます。

4059 4059 

4060* **スコープ**: [`任意のファイル`](#scopes)。古いバージョンの `~/.claude.json` の値は、設定ファイルがそれを設定しない場合に適用されます。4060* **スコープ**: [`Any file`](#scopes)。どの設定ファイルでも設定されていない場合、古いバージョンによる `~/.claude.json` 内の値が適用されます。

4061* **タイプ**: ブール値4061* **型**: Boolean

4062 * `true`: 完全なツール出力が表示されます4062 * `true`: ツールの出力全体が表示されます

4063 * `false`: ツール出力の切り詰められた要約が表示されます4063 * `false`: ツールの出力の切り詰められた要約が表示されます

4064* **デフォルト**: `false`4064* **デフォルト**: `false`

4065* **セッションごとのオーバーライド**: [`--verbose`](/docs/ja/cli-reference#cli-flags) はこのキーより優先されます4065* **セッションごとの上書き**: 1 つのセッションについては、[`--verbose`](/docs/ja/cli-reference#cli-flags) がこのキーより優先されます

4066 4066 

4067```json settings.json theme={null}4067```json settings.json theme={null}

4068{4068{


4070}4070}

4071```4071```

4072 4072 

4073[`viewMode`](#viewmode) 値またはスティッキー `/focus` 選択はこのキーを毎セッション上書きします。4073[`viewMode`](#viewmode) の値または保持された `/focus` の選択は、すべてのセッションでこのキーを上書きします。

4074 4074 

4075<h3 id="viewmode">4075<h3 id="viewmode">

4076 `viewMode`4076 `viewMode`

4077</h3>4077</h3>

4078 4078 

4079Claude Code が開始するトランスクリプトビューを設定します。`"default"`、`"verbose"`、または `"focus"`。設定されている場合、スティッキー `/focus` 選択と [`verbose`](#verbose) 設定の両方を上書きします。4079Claude Code が開始時に使用するトランスクリプトビューを `"default"`、`"verbose"`、`"focus"` から設定します。設定すると、保持された `/focus` の選択と [`verbose`](#verbose) 設定の両方を上書きします。

4080 4080 

4081* **スコープ**: [`任意のファイル`](#scopes)4081* **スコープ**: [`Any file`](#scopes)

4082* **タイプ**: 文字列、以下のいずれか:4082* **型**: 文字列。次のいずれか:

4083 * `"default"`: 切り詰められたツール出力を持つ通常のトランスクリプト4083 * `"default"`: ツールの出力が切り詰められた通常のトランスクリプト

4084 * `"verbose"`: 完全なツール出力を持つトランスクリプト4084 * `"verbose"`: ツールの出力全体を含むトランスクリプト

4085 * `"focus"`: 最後のプロンプトのみ、ツール呼び出しの 1 行の要約(編集 diffstats を含む)、および最終応答。フォーカスビューは[フルスクリーンレンダラー](#tui)が必要です4085 * `"focus"`: 最後のプロンプト、編集の diffstat を含むツール呼び出しの 1 行の要約、最終的な応答のみ。フォーカスビューには[フルスクリーンレンダラー](#tui)が必要です

4086* **デフォルト**: 未設定、`verbose` 設定と最後の `/focus` 選択が適用されます4086* **デフォルト**: 未設定。`verbose` 設定と最後の `/focus` の選択が適用されます

4087* **セッションごとのオーバーライド**: [`--verbose`](/docs/ja/cli-reference#cli-flags) はこのキーより優先されます4087* **セッションごとの上書き**: 1 つのセッションについては、[`--verbose`](/docs/ja/cli-reference#cli-flags) がこのキーより優先されます

4088 4088 

4089```json settings.json theme={null}4089```json settings.json theme={null}

4090{4090{


4096 `vimInsertModeRemaps`4096 `vimInsertModeRemaps`

4097</h3>4097</h3>

4098 4098 

4099[vim エディタモード](/docs/ja/interactive-mode#vim-editor-mode)で 2 キーの INSERT モードシーケンスを Escape にマップします。各キーは正確に 2 つの印字可能文字で、順序で入力され、`"<Esc>"` は唯一のサポートされているターゲットです。Claude Code は他のエントリを無視します。Claude Code v2.1.208 以降が必要です。4099[vim エディターモード](/docs/ja/interactive-mode#vim-editor-mode)で、2 キーの INSERT モードのシーケンスを Escape にマッピングします。各キーは続けて入力する印字可能な文字ちょうど 2 文字で、サポートされるターゲットは `"<Esc>"` のみです。Claude Code はそれ以外のエントリを無視します。

4100 4100 

4101* **スコープ**: [`ユーザーまたはマネージド`](#scopes)。リポジトリはキーストロークを再マップできません。4101* **スコープ**: [`User or managed`](#scopes)。リポジトリがユーザーのキー入力を再マッピングすることはできません。

4102* **タイプ**: 2 文字シーケンスを `"<Esc>"` にマップするオブジェクト4102* **型**: 2 文字のシーケンスを `"<Esc>"` にマッピングするオブジェクト

4103* **デフォルト**: 未設定4103* **デフォルト**: 未設定

4104 4104 

4105```json settings.json theme={null}4105```json settings.json theme={null}


4110}4110}

4111```4111```

4112 4112 

4113`editorMode` が `"vim"` でない限り効果がありません。[INSERT モードキーシーケンスを再マップ](/docs/ja/interactive-mode#remap-insert-mode-key-sequences)を参照してください。Claude Code v2.1.208 以降が必要です。4113`editorMode` が `"vim"` でない限り効果はありません。[INSERT モードのキーシーケンスを再マッピングする](/docs/ja/interactive-mode#remap-insert-mode-key-sequences)を参照してください。

4114 4114 

4115<h3 id="voice">4115<h3 id="voice">

4116 `voice`4116 `voice`

4117</h3>4117</h3>

4118 4118 

4119[音声ディクテーション](/docs/ja/voice-dictation)をオンにし、ディクテーションキーの動作を選択します。Claude Code は `/voice` を実行するとこのオブジェクトを書き込みます。4119[音声入力](/docs/ja/voice-dictation)をオンにし、音声入力キーの動作を選択します。`/voice` を実行すると、Claude Code がこのオブジェクトを自動で書き込みます。

4120 4120 

4121* **スコープ**: [`任意のファイル`](#scopes)4121* **スコープ**: [`Any file`](#scopes)

4122* **タイプ**: `enabled` をブール値として、`autoSubmit` をホールドモードのみに適用するブール値として、`mode` を以下のいずれかとして持つオブジェクト:4122* **型**: Boolean である `enabled`、ホールドモードでのみ適用される Boolean である `autoSubmit`、および次のいずれかである `mode` を持つオブジェクト:

4123 * `"hold"`: ディクテーションキーを話している間押し続け、停止するために離します4123 * `"hold"`: 話している間は音声入力キーを押し続け、離すと停止します

4124 * `"tap"`: キーを 1 回タップして記録を開始し、もう一度タップして送信します4124 * `"tap"`: キーを 1 回タップすると録音が開始され、もう 1 回タップすると送信されます

4125* **デフォルト**: 未設定、ディクテーションはオフです。`enabled` が `true` で `mode` が未設定の場合、Claude Code は `"hold"` を使用します4125* **デフォルト**: 未設定。音声入力はオフです。`enabled` が `true` で `mode` が未設定の場合、Claude Code は `"hold"` を使用します

4126 4126 

4127この例はディクテーションをオンにし、キーを 1 回タップして記録を開始し、もう一度タップして送信するようにします:4127この例では、音声入力をオンにし、キーを 1 回タップすると録音を開始し、もう 1 回タップすると送信するようにします。

4128 4128 

4129```json settings.json theme={null}4129```json settings.json theme={null}

4130{4130{


4135}4135}

4136```4136```

4137 4137 

4138`autoSubmit` はホールドモードでキーを離すときにプロンプトを送信します。音声ディクテーションには claude.ai アカウントが必要です。4138`autoSubmit` は、ホールドモードでキーを離したときにプロンプトを送信します。音声入力には claude.ai アカウントが必要です。

4139 4139 

4140<h3 id="voiceenabled">4140<h3 id="voiceenabled">

4141 `voiceEnabled`4141 `voiceEnabled`

4142</h3>4142</h3>

4143 4143 

4144<Warning>4144<Warning>

4145 v2.1.92 以降非推奨。[`voice`](#voice) オブジェクトが置き換えました。Claude Code は引き続きそれを読み取るため、古い設定ファイルは機能し続けますが、新しい設定は `voice.enabled` を設定する必要があります。4145 v2.1.92 で [`voice`](#voice) オブジェクトに置き換えられて以降、非推奨です。古い設定ファイルが引き続き機能するように Claude Code は引き続きこれを読み取りますが、新しい設定では `voice.enabled` を設定してください。

4146</Warning>4146</Warning>

4147 4147 

4148`voice` オブジェクトより前の単一ブール値形式で音声ディクテーションをオンにします。両方が設定されている場合、`voice.enabled` が適用されます。4148`voice` オブジェクトより前から存在する単一の Boolean 形式で、音声入力をオンにします。両方が設定されている場合は `voice.enabled` が適用されます。

4149 4149 

4150* **スコープ**: [`任意のファイル`](#scopes)4150* **スコープ**: [`Any file`](#scopes)

4151* **タイプ**: ブール値4151* **型**: Boolean

4152 * `true`: claude.ai アカウントでログインしており、組織のポリシーが音声を許可している場合、音声ディクテーションはオンです。`voice.enabled` が設定されていない限り4152 * `true`: `voice.enabled` が設定されていない限り、claude.ai アカウントでログインしていて組織のポリシーで音声が許可されている場合に、音声入力がオンになります

4153 * `false`: 音声ディクテーションはオフです。`voice.enabled` が設定されていない限り4153 * `false`: `voice.enabled` が設定されていない限り、音声入力はオフです

4154* **デフォルト**: 未設定4154* **デフォルト**: 未設定

4155 4155 

4156```json settings.json theme={null}4156```json settings.json theme={null}


4163 `wheelScrollAccelerationEnabled`4163 `wheelScrollAccelerationEnabled`

4164</h3>4164</h3>

4165 4165 

4166[フルスクリーンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling)での高速スクロール中にマウスホイールスクロール速度を加速します。ホイールノッチごとに一定のスクロール速度を使用するには `false` に設定します。4166[フルスクリーンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling)で、高速スクロール時にマウスホイールのスクロール速度を加速します。ホイールの 1 ノッチごとに一定の速度でスクロールさせるには、`false` に設定します。

4167 4167 

4168* **スコープ**: [`任意のファイル`](#scopes)4168* **スコープ**: [`Any file`](#scopes)

4169* **タイプ**: ブール値4169* **型**: Boolean

4170 * `true`: Claude Code は高速スクロール中にマウスホイールスクロール速度を加速します4170 * `true`: Claude Code は高速スクロール時にマウスホイールのスクロール速度を加速します

4171 * `false`: Claude Code はホイールノッチごとに一定の速度でスクロールします4171 * `false`: Claude Code はホイールの 1 ノッチごとに一定の速度でスクロールします

4172* **デフォルト**: `true`4172* **デフォルト**: `true`

4173 4173 

4174```json settings.json theme={null}4174```json settings.json theme={null}


5850 `disableDesktopLocalSessions`5850 `disableDesktopLocalSessions`

5851</h3>5851</h3>

5852 5852 

5853開発者が SSH 経由でリモートマシンで作業する必要があるデプロイメント用に、[デスクトップアプリ](/docs/ja/desktop#local-sessions-on-managed-devices) で実行されるコードセッションをオフにします。Code タブでは、**Local** 環境は環境ドロップダウンに留まりますが、グレーアウトされて選択できず、組織がオフにしたことを示すツールチップが表示されます。Windows では WSL エントリも同じようにグレーアウトされますが、WSL セッションがマネージドデバイスで実行されるかどうかは [別途管理されます](/docs/ja/admin-setup#wsl-sessions-in-claude-code-desktop)。新しいセッションは、設定されている場合は最初の [SSH 接続](/docs/ja/desktop#ssh-sessions) にデフォルト設定され、アプリは同じマシンへの SSH 接続を含む、デバイス上のセッションの開始または再開を拒否します。他のホストへの SSH セッションとクラウドセッションは影響を受けません。デスクトップアプリはこのキーを読み取ります。ターミナル CLI は無視します。Claude Desktop v1.37937.0 以降が必要です。5853開発者が SSH 経由でリモートマシンで作業する必要があるデプロイ向けに、[デスクトップアプリ](/docs/ja/desktop#local-sessions-on-managed-devices) でデバイス上で実行される Code セッションをオフにします。キーを `true` に設定すると、ユーザーには Code タブで次のように表示されます:

5854 

5855* **環境セレクター**: ユーザーのコンピューターのエントリはグレーアウトされて選択できなくなり、ツールチップ **Disabled by your organization** が表示されます。Windows では WSL エントリも同じようにグレーアウトされますが、WSL セッションが管理対象デバイスで実行されるかどうか自体は [別途管理されます](/docs/ja/admin-setup#wsl-sessions-in-claude-code-desktop)。

5856* **新しいセッション**: 設定されている場合は、最初の [SSH 接続](/docs/ja/desktop#ssh-sessions) がデフォルトになります

5857* **デバイス上のセッション**: アプリは、同じマシンへの SSH 接続を含め、デバイス上でのセッションの開始または再開を拒否します

5858* **他のホストへの SSH セッションとクラウドセッション**: 影響を受けません

5859 

5860デスクトップアプリはこのキーを読み取ります。ターミナル CLI は無視します。Claude Desktop v1.37937.0 以降が必要です。

5854 5861 

5855* **Scope**: [`Managed`](#scopes)。デフォルトでは、デスクトップアプリは [1 つの管理ソース](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) からキーを読み取ります。5862* **Scope**: [`Managed`](#scopes)。デフォルトでは、デスクトップアプリは [1 つの管理ソース](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) からキーを読み取ります。

5856* **Type**: Boolean。JSON Boolean `true` のみが有効です5863* **Type**: Boolean。JSON Boolean `true` のみが有効です


5997 `sshConfigs`6004 `sshConfigs`

5998</h3>6005</h3>

5999 6006 

6000[Desktop](/docs/ja/desktop#pre-configure-ssh-connections-for-your-team) 環境ドロップダウンに SSH 接続を追加します。管理者はこれを使用して、共有接続をチームに配布します。管理設定で定義した接続は管理対象として表示されます。ユーザーはそれらを選択し、それらに対して [独自の **Worktree folder** を設定](/docs/ja/desktop#choose-where-ssh-session-worktrees-go) できますが、アプリでそれ以外を編集したり、接続を削除したりすることはできません。6007[Desktop](/docs/ja/desktop#pre-configure-ssh-connections-for-your-team) の環境セレクターに SSH 接続を追加します。管理者は `sshConfigs` を使用して、共有接続をチームに配布します。ユーザーは管理対象の接続を選択し、それに対して [独自の **Worktree folder** を設定](/docs/ja/desktop#set-the-worktree-folder-on-an-existing-connection) できます。アプリでそれ以外のフィールドを編集したり、接続を削除したりすることはできません。

6001 6008 

6002* **Scope**: [`User or managed`](#scopes)。デスクトップアプリはこのキーを読み取ります。デフォルトでは、管理対象の接続を [1 つの管理ソース](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) から読み取ります。6009* **Scope**: [`User or managed`](#scopes)。デスクトップアプリはこのキーを読み取ります。デフォルトでは、管理対象の接続を [1 つの管理ソース](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) から読み取ります。

6003* **Type**: オブジェクトの配列。各オブジェクトは必須の `id`、`name`、`sshHost` と、オプションの `sshPort` および `sshIdentityFile` を持ちます6010* **Type**: オブジェクトの配列。各オブジェクトは必須の `id`、`name`、`sshHost` と、オプションの `sshPort` および `sshIdentityFile` を持ちます

statusline.md +2 −2

Details

199| `workspace.added_dirs` | `/add-dir` または `--add-dir` 経由で追加された追加ディレクトリ。追加されていない場合は空配列 |199| `workspace.added_dirs` | `/add-dir` または `--add-dir` 経由で追加された追加ディレクトリ。追加されていない場合は空配列 |

200| `workspace.git_worktree` | 現在のディレクトリが `git worktree add` で作成されたリンク worktree 内にある場合の git worktree 名。メイン作業ツリーでは不在。`worktree.*` が [worktree セッション](/docs/ja/worktrees) 中のみに存在するのとは異なり、任意の git worktree に対して入力されます |200| `workspace.git_worktree` | 現在のディレクトリが `git worktree add` で作成されたリンク worktree 内にある場合の git worktree 名。メイン作業ツリーでは不在。`worktree.*` が [worktree セッション](/docs/ja/worktrees) 中のみに存在するのとは異なり、任意の git worktree に対して入力されます |

201| `workspace.repo.host`、`workspace.repo.owner`、`workspace.repo.name` | `origin` リモートから解析されたリポジトリ ID。例えば `"github.com"`、`"anthropics"`、`"claude-code"`。git リポジトリの外部または `origin` リモートが設定されていない場合は不在。gitlab.com プロジェクトがサブグループにネストされている場合、`owner` は `"group/subgroup"` のようなスラッシュ付きの完全な名前空間パスです。v2.1.260 より前は、これらのプロジェクトでは `workspace.repo` が不在でした |201| `workspace.repo.host`、`workspace.repo.owner`、`workspace.repo.name` | `origin` リモートから解析されたリポジトリ ID。例えば `"github.com"`、`"anthropics"`、`"claude-code"`。git リポジトリの外部または `origin` リモートが設定されていない場合は不在。gitlab.com プロジェクトがサブグループにネストされている場合、`owner` は `"group/subgroup"` のようなスラッシュ付きの完全な名前空間パスです。v2.1.260 より前は、これらのプロジェクトでは `workspace.repo` が不在でした |

202| `cost.total_cost_usd` | USD でのセッションの推定コスト。クライアント側で計算されます。[`modelPricing`](/docs/ja/settings-reference#modelpricing) テーブルが有効な場合を除き、定価で計算されます。実際の請求額と異なる場合があります。`/clear` で新しいセッションが開始されると \$0 にリセットされます。v2.1.211 より前は、`/clear` の後も合計が引き継がれていました |202| `cost.total_cost_usd` | USD でのセッションの推定コスト。クライアント側で計算されます。[`modelPricing`](/docs/ja/settings-reference#modelpricing) テーブルが有効な場合を除き、定価で計算されます。実際の請求額と異なる場合があります。`/clear` で新しいセッションが開始されると \$0 にリセットされます |

203| `cost.total_duration_ms` | セッション開始からの総経過時間(ミリ秒) |203| `cost.total_duration_ms` | セッション開始からの総経過時間(ミリ秒) |

204| `cost.total_api_duration_ms` | API レスポンスを待つのに費やされた総時間(ミリ秒) |204| `cost.total_api_duration_ms` | API レスポンスを待つのに費やされた総時間(ミリ秒) |

205| `cost.total_lines_added`、`cost.total_lines_removed` | 変更されたコード行 |205| `cost.total_lines_added`、`cost.total_lines_removed` | 変更されたコード行 |


1197| `label` | string | Claude Code が持っている場合はタスクの短い進捗サマリー、それ以外の場合は `description` と同じテキスト |1197| `label` | string | Claude Code が持っている場合はタスクの短い進捗サマリー、それ以外の場合は `description` と同じテキスト |

1198| `startTime` | number | タスクが開始された時刻(Unix エポックからのミリ秒) |1198| `startTime` | number | タスクが開始された時刻(Unix エポックからのミリ秒) |

1199| `model` | string、省略可能 | タスクが実行される解決済みモデルの ID。モデルが解決されるまでは省略されます |1199| `model` | string、省略可能 | タスクが実行される解決済みモデルの ID。モデルが解決されるまでは省略されます |

1200| `effort` | string または number、省略可能 | サブエージェントの [定義フロントマター](/docs/ja/sub-agents#supported-frontmatter-fields) または個別の呼び出しで設定された推論 effort: `low`、`medium`、`high`、`xhigh`、`max`、またはトークン予算の数値。これは設定された値であり、モデルがそのレベルをサポートしていない場合、Claude Code が実際に適用する effort は異なる可能性があります。effort が設定されていない場合は省略されます。Claude Code v2.1.213 以降が必要です |1200| `effort` | string または number、省略可能 | サブエージェントの [定義フロントマター](/docs/ja/sub-agents#supported-frontmatter-fields) または個別の呼び出しで設定された推論 effort: `low`、`medium`、`high`、`xhigh`、`max`、またはトークン予算の数値。これは設定された値であり、モデルがそのレベルをサポートしていない場合、Claude Code が実際に適用する effort は異なる可能性があります。effort が設定されていない場合は省略されます |

1201| `contextWindowSize` | number、省略可能 | `model` のコンテキストウィンドウ(トークン単位)。メインステータスラインの [`context_window.context_window_size`](#context-window-fields) と同じ方法で計算されるため、`tokenCount` から行ごとのパーセンテージをレンダリングできます。`model` が省略されている場合は省略されます |1201| `contextWindowSize` | number、省略可能 | `model` のコンテキストウィンドウ(トークン単位)。メインステータスラインの [`context_window.context_window_size`](#context-window-fields) と同じ方法で計算されるため、`tokenCount` から行ごとのパーセンテージをレンダリングできます。`model` が省略されている場合は省略されます |

1202| `tokenCount` | number | サブエージェントの累計トークン数。デフォルトの行に表示される数値です |1202| `tokenCount` | number | サブエージェントの累計トークン数。デフォルトの行に表示される数値です |

1203| `tokenSamples` | array of numbers | 直近最大 16 個の `tokenCount` の読み取り値。リフレッシュティックごとに 1 つずつ、古い順に並び、現在の値で終わります |1203| `tokenSamples` | array of numbers | 直近最大 16 個の `tokenCount` の読み取り値。リフレッシュティックごとに 1 つずつ、古い順に並び、現在の値で終わります |

sub-agents.md +53 −35

Details

287 287 

288`isolation: worktree` を持つサブエージェントは、その worktree 内で Bash および PowerShell コマンドを実行します。作業ディレクトリが代わりにメインチェックアウトに解決されるコマンド(例えば、サブエージェント実行中に worktree ディレクトリが削除された場合)はエラーで失敗します。288`isolation: worktree` を持つサブエージェントは、その worktree 内で Bash および PowerShell コマンドを実行します。作業ディレクトリが代わりにメインチェックアウトに解決されるコマンド(例えば、サブエージェント実行中に worktree ディレクトリが削除された場合)はエラーで失敗します。

289 289 

290この作業ディレクトリチェックは、Claude Code を起動したディレクトリを含むリポジトリ全体をカバーします。セッションがリンクされた[worktree](/docs/ja/worktrees)で独自に実行される場合、チェックはその worktree がリンクされているメインチェックアウトもカバーします。v2.1.210 より前では、チェックは起動ディレクトリのみをカバーしていました。作業ディレクトリがリポジトリ内の他の場所(例えば、monorepo サブディレクトリから Claude Code を起動した場合のリポジトリルート)に解決されるコマンドは、失敗する代わりにそこで実行されました。290この作業ディレクトリチェックは、Claude Code を起動したディレクトリを含むリポジトリ全体をカバーします。セッションがリンクされた[worktree](/docs/ja/worktrees)で独自に実行される場合、チェックはその worktree がリンクされているメインチェックアウトもカバーします。

291 291 

292Bash コマンドの場合、Claude Code はコマンド自体を 2 つの方法でチェックします。292Bash コマンドの場合、Claude Code はコマンド自体を 2 つの方法でチェックします。

293 293 


325| `mcpServers` | いいえ | このサブエージェントで利用可能な[MCP サーバー](/docs/ja/mcp)。各エントリは、既に設定されているサーバーを参照するサーバー名(例えば、`"slack"`)、または完全な[MCP サーバー設定](/docs/ja/mcp#installing-mcp-servers)を値として持つサーバー名をキーとするインライン定義のいずれかです。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |325| `mcpServers` | いいえ | このサブエージェントで利用可能な[MCP サーバー](/docs/ja/mcp)。各エントリは、既に設定されているサーバーを参照するサーバー名(例えば、`"slack"`)、または完全な[MCP サーバー設定](/docs/ja/mcp#installing-mcp-servers)を値として持つサーバー名をキーとするインライン定義のいずれかです。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |

326| `hooks` | いいえ | このサブエージェントにスコープされた[ライフサイクルフック](#define-hooks-for-subagents)。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |326| `hooks` | いいえ | このサブエージェントにスコープされた[ライフサイクルフック](#define-hooks-for-subagents)。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |

327| `memory` | いいえ | [永続メモリスコープ](#enable-persistent-memory)。`user`、`project`、または `local`。クロスセッション学習を有効にします |327| `memory` | いいえ | [永続メモリスコープ](#enable-persistent-memory)。`user`、`project`、または `local`。クロスセッション学習を有効にします |

328| `background` | いいえ | Claude がフォアグラウンドで実行するよう要求した場合でも、このサブエージェントをバックグラウンドに保つには `true` に設定します。[フォークモード](#turn-fork-mode-on-or-off)がオンの場合、Claude Code は Claude がスポーンするサブエージェントを既に[バックグラウンド](#run-subagents-in-foreground-or-background)で実行します |328| `background` | いいえ | Claude がこのサブエージェントの完了を待つよう要求した場合でも、このサブエージェントをバックグラウンドに保つには `true` に設定します。デフォルトでは、Claude がメイン会話からスポーンするサブエージェントは既に[バックグラウンドで開始](#run-subagents-in-foreground-or-background)されます |

329| `omitClaudeMd` | いいえ | このサブエージェントを、[初期コンテキスト](#what-loads-at-startup)にユーザー、プロジェクト、およびローカルの CLAUDE.md ファイルを含めずに起動するには `true` に設定します。[管理ポリシーファイル](/docs/ja/memory#how-claude-md-files-load)は引き続き読み込まれます。ただし、[管理サブエージェント](#choose-the-subagent-scope)は除きます。委任プロンプトから必要なすべてを取得するサブエージェントに使用します。エージェントが `--agent` または `agent` 設定経由でメインセッションエージェントとして実行される場合は無視されます。Claude Code v2.1.271 以降が必要です |329| `omitClaudeMd` | いいえ | このサブエージェントを、[初期コンテキスト](#what-loads-at-startup)にユーザー、プロジェクト、およびローカルの CLAUDE.md ファイルを含めずに起動するには `true` に設定します。[管理ポリシーファイル](/docs/ja/memory#how-claude-md-files-load)は引き続き読み込まれます。ただし、[管理サブエージェント](#choose-the-subagent-scope)は除きます。委任プロンプトから必要なすべてを取得するサブエージェントに使用します。エージェントが `--agent` または `agent` 設定経由でメインセッションエージェントとして実行される場合は無視されます。Claude Code v2.1.271 以降が必要です |

330| `effort` | いいえ | このサブエージェントがアクティブな場合の effort レベル。セッションの effort レベルを上書きしますが、[`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ja/env-vars#variables) 環境変数は上書きしません。オプション:`low`、`medium`、`high`、`xhigh`、`max`。利用可能なレベルはモデルによって異なります。[effort レベルを選択する](#choose-an-effort-level)を参照してください |330| `effort` | いいえ | このサブエージェントがアクティブな場合の effort レベル。セッションの effort レベルを上書きしますが、[`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ja/env-vars#variables) 環境変数は上書きしません。オプション:`low`、`medium`、`high`、`xhigh`、`max`。利用可能なレベルはモデルによって異なります。[effort レベルを選択する](#choose-an-effort-level)を参照してください |

331| `isolation` | いいえ | サブエージェントを一時的な[git worktree](/docs/ja/worktrees)で実行するには `worktree` に設定します。これにより、親セッションの `HEAD` ではなく、デフォルトで[デフォルトブランチ](/docs/ja/worktrees#choose-the-base-branch)からブランチされたリポジトリの分離されたコピーが提供されます。サブエージェントが変更を加えない場合、worktree は自動的にクリーンアップされます |331| `isolation` | いいえ | サブエージェントを一時的な[git worktree](/docs/ja/worktrees)で実行するには `worktree` に設定します。これにより、親セッションの `HEAD` ではなく、デフォルトで[デフォルトブランチ](/docs/ja/worktrees#choose-the-base-branch)からブランチされたリポジトリの分離されたコピーが提供されます。サブエージェントが変更を加えない場合、worktree は自動的にクリーンアップされます |


405 405 

406サブエージェントが実行されているモデルを確認するには、[`/tasks`](/docs/ja/commands)を実行します。Claude Code はサブエージェントの行にモデル名を表示し、そのサブエージェントに [effort レベル](/docs/ja/model-config#adjust-effort-level)が設定されている場合はそれも追加します。Claude Code v2.1.242 以降が必要です。406サブエージェントが実行されているモデルを確認するには、[`/tasks`](/docs/ja/commands)を実行します。Claude Code はサブエージェントの行にモデル名を表示し、そのサブエージェントに [effort レベル](/docs/ja/model-config#adjust-effort-level)が設定されている場合はそれも追加します。Claude Code v2.1.242 以降が必要です。

407 407 

408呼び出しごとの `model` パラメータは、サブエージェントが[再開または後続メッセージが送信](#resume-subagents)される場合にも適用されるため、サブエージェントはそのモデルに留まります。v2.1.211 より前では、再開は呼び出しごとの値をドロップし、サブエージェントは定義の `model` フィールドまたはメイン会話のモデルに戻りました。408呼び出しごとの `model` パラメータは、サブエージェントが[再開または後続メッセージが送信](#resume-subagents)される場合にも適用されるため、サブエージェントはそのモデルに留まります。

409 409 

410v2.1.198 以降、サブエージェントはメイン会話の[拡張思考](/docs/ja/model-config#extended-thinking)設定も継承します。セッションで思考がオンの場合、サブエージェントではオンになり、オフの場合、オフのままです。サブエージェントごとの思考設定はありません。v2.1.198 より前では、サブエージェントはメイン会話の設定に関係なく、拡張思考が無効で実行されていました。410v2.1.198 以降、サブエージェントはメイン会話の[拡張思考](/docs/ja/model-config#extended-thinking)設定も継承します。セッションで思考がオンの場合、サブエージェントではオンになり、オフの場合、オフのままです。サブエージェントごとの思考設定はありません。v2.1.198 より前では、サブエージェントはメイン会話の設定に関係なく、拡張思考が無効で実行されていました。

411 411 


501---501---

502```502```

503 503 

504`tools` リスト内の何もツールに解決されない場合(例えば、すべてのエントリが誤字であるか、サブエージェントで利用できないツールに名前を付けている場合)、Claude Code は通常、サブエージェントの起動を拒否し、Agent ツールは解決されないエントリに名前を付けるエラーを返します。[Agent would be spawned with zero tools](/docs/ja/errors#agent-would-be-spawned-with-zero-tools)を参照してください。メッセージと各エントリを修正する方法。v2.1.208 より前では、そのサブエージェントはツールなしで起動し、空または混乱した結果を返す可能性があります。504`tools` リスト内の何もツールに解決されない場合(例えば、すべてのエントリが誤字であるか、サブエージェントで利用できないツールを指定している場合)、Claude Code は通常、サブエージェントの起動を拒否し、Agent ツールは解決されないエントリを示すエラーを返します。メッセージと各エントリの修正方法については、[Agent would be spawned with zero tools](/docs/ja/errors#agent-would-be-spawned-with-zero-tools)を参照してください。

505 505 

506`tools` フィールドと `disallowedTools` フィールドは、MCP サーバー全体を指すエントリも受け入れます。506`tools` フィールドと `disallowedTools` フィールドは、MCP サーバー全体を指すエントリも受け入れます。

507 507 


969* **フォアグラウンドサブエージェント** はメイン会話をブロックして完了するまで待機します。権限プロンプトは発生時にユーザーに渡されます。969* **フォアグラウンドサブエージェント** はメイン会話をブロックして完了するまで待機します。権限プロンプトは発生時にユーザーに渡されます。

970* **バックグラウンドサブエージェント** は、ユーザーが作業を続ける間に同時に実行されます。バックグラウンドサブエージェントが権限が必要なツール呼び出しに到達すると、Claude Code はメインセッションでプロンプトを表示し、要求しているサブエージェントの名前を示します。承認するとサブエージェントは続行し、Esc を押すとサブエージェントを停止せずにそのツール呼び出しのみを拒否できます。970* **バックグラウンドサブエージェント** は、ユーザーが作業を続ける間に同時に実行されます。バックグラウンドサブエージェントが権限が必要なツール呼び出しに到達すると、Claude Code はメインセッションでプロンプトを表示し、要求しているサブエージェントの名前を示します。承認するとサブエージェントは続行し、Esc を押すとサブエージェントを停止せずにそのツール呼び出しのみを拒否できます。

971 971 

972Claude が Agent ツールで生成するサブエージェントごとに、Claude Code は、適用される最初のケースからフォアグラウンドまたはバックグラウンドを選択します。972<h4 id="which-subagents-run-in-the-background">

973 バックグラウンドで実行されるサブエージェント

974</h4>

975 

976何も設定していない場合、Claude がメイン会話から生成するサブエージェントはバックグラウンドで開始されます。

973 977 

974* インプロセス [エージェントチーム](/docs/ja/agent-teams#limitations) チームメイトがサブエージェントを生成した場合、Claude Code はそれをフォアグラウンドで実行します。Claude Code は、定義が [`background: true`](#supported-frontmatter-fields) を設定するチームメイトのサブエージェントの生成をエラーで拒否します。[フォークモード](#turn-fork-mode-on-or-off) がオフで、[バックグラウンドタスクをオフにしていない](/docs/ja/env-vars) 場合、チームメイトが `run_in_background: true` を設定したときも Claude Code はエラーで拒否します。978* **`claude -p` と Agent SDK**: Claude は自身の判断で、またはユーザーが依頼したときに、サブエージェントを待機できます。

975* [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/ja/env-vars) を `1` に設定した場合、Claude Code はすべての種類のセッションでサブエージェントをフォアグラウンドで実行し、フォークモードがオンかどうかに関わらず実行します。979* **マシン上の対話型ターミナルセッション、VS Code、およびデスクトップアプリのセッション**: Claude がサブエージェントを待機できるようにするには、[デフォルトでオン](#turn-fork-mode-on-or-off) になっている [フォークモードをオフにします](#let-claude-wait-for-a-subagent)。

976* [フォークモード](#turn-fork-mode-on-or-off) がオンの場合(対話セッションではデフォルト)、Claude Code はサブエージェントをバックグラウンドで実行し、フォークおよび非フォークサブエージェント両方を実行し、Claude はフォアグラウンドを要求できません。

977* フォークモードがオフの場合、Claude はデフォルトでサブエージェントをバックグラウンドで実行し、続行する前に結果が必要な場合はフォアグラウンドで実行します。フォークモードは、オンにしない限り、[非対話モード](/docs/ja/headless) で `-p` を使用する場合と Agent SDK ではオフです。Claude が結果を必要とする場合でも特定のサブエージェントをバックグラウンドに保つには、フロントマター [`background`](#supported-frontmatter-fields) フィールドを `true` に設定します。

978 980 

979`context: fork` を持つスキルの場合、Claude Code は、フォークモードがオンかどうかに関わらず、[サブエージェントでスキルを実行](/docs/ja/skills#run-skills-in-a-subagent) のルールに従います。981`context: fork` を持つスキルの場合、Claude Code は、フォークモードがオンかどうかに関わらず、[サブエージェントでスキルを実行](/docs/ja/skills#run-skills-in-a-subagent) のルールに従います。

980 982 

983<h4 id="let-claude-wait-for-a-subagent">

984 Claude にサブエージェントを待機させる

985</h4>

986 

9871. 例えば [`settings.json`](/docs/ja/settings) で `CLAUDE_CODE_FORK_SUBAGENT` を `0` に設定して、[フォークモード](#turn-fork-mode-on-or-off) をオフにします。

988 

989 ```json theme={null}

990 {

991 "env": {

992 "CLAUDE_CODE_FORK_SUBAGENT": "0"

993 }

994 }

995 ```

996 

9972. シェルから `claude` を再度実行するか、新しい VS Code の会話を開きます。

998 

9993. 先に結果が必要な場合は、Claude に待機するよう依頼します。例えば「reviewer サブエージェントを実行して、そのレポートを待ってください」のように依頼します。

1000 

1001Claude が待機している間も作業を続けるには、ターミナルで **Ctrl+B** を押すか、VS Code で [**Run in background**](/docs/ja/vs-code#move-a-running-command-or-subagent-to-the-background) をクリックします。

1002 

1003フォークモードをオフにする代わりに [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/ja/env-vars) 環境変数を `1` に設定した場合、Claude はすべてのサブエージェントを待機し、**Ctrl+B** を含めてバックグラウンドタスクはオフになります。

1004 

1005<h4 id="tools-permissions-and-results-of-background-subagents">

1006 バックグラウンドサブエージェントのツール、権限、結果

1007</h4>

1008 

981バックグラウンドサブエージェントは、会話フォークと [再開された](#resume-subagents) フォアグラウンドサブエージェントを除き、フォアグラウンドサブエージェントより [小さい組み込みツールセット](#available-tools) で実行されます。1009バックグラウンドサブエージェントは、会話フォークと [再開された](#resume-subagents) フォアグラウンドサブエージェントを除き、フォアグラウンドサブエージェントより [小さい組み込みツールセット](#available-tools) で実行されます。

982 1010 

983バックグラウンドサブエージェントはメインセッションのすべての権限プロンプトを表示します。それらのプロンプトの 1 つに、セッションの残り期間続く付与など、その 1 つのツール呼び出しを超えて続く選択で答える場合、Claude Code はセッション全体(メイン会話を含む)にその答えを適用します。1011バックグラウンドサブエージェントはメインセッションのすべての権限プロンプトを表示します。それらのプロンプトの 1 つに、セッションの残り期間続く付与など、その 1 つのツール呼び出しを超えて続く選択で答える場合、Claude Code はセッション全体(メイン会話を含む)にその答えを適用します。

984 1012 

985バックグラウンドサブエージェントは、バックグラウンド [Bash または PowerShell コマンド](/docs/ja/tools-reference#background-commands) を [ターンの終了後も実行し続ける](/docs/ja/interactive-mode#how-backgrounding-works) ことができます。そのコマンドが終了すると、Claude Code はサブエージェントに通知を送信します。1013バックグラウンドサブエージェントは、バックグラウンド [Bash または PowerShell コマンド](/docs/ja/tools-reference#background-commands) を [ターンの終了後も実行し続ける](/docs/ja/interactive-mode#how-backgrounding-works) ことができます。そのコマンドが終了すると、Claude Code はサブエージェントに通知を送信します。

986 1014 

987バックグラウンドサブエージェントの結果は、後のターンで完了通知として Claude に到達します。Claude はその通知を待ってからサブエージェントの結果を報告し、先に進捗について質問すると、サブエージェントがまだ実行中であることを報告します。v2.1.211 より前では、Claude は完了していないバックグラウンドサブエージェントの結果を報告することがありました。1015バックグラウンドサブエージェントの結果は、後のターンで完了通知として Claude に到達します。Claude はその通知を待ってからサブエージェントの結果を報告し、先に進捗について質問すると、サブエージェントがまだ実行中であることを報告します。

988 1016 

989また、自分で操作することもできます。1017<h4 id="finished-subagents-in-the-panel-and-task-list">

990 1018 パネルとタスクリスト内の完了したサブエージェント

991* フォークモードがオフの場合、Claude にタスクをバックグラウンドまたはフォアグラウンドで実行するよう依頼します1019</h4>

992* **Ctrl+B** を押して実行中のタスクをバックグラウンドにします

993 1020 

994Claude Code は、サブエージェントの終了方法に応じて、2 つの方法のいずれかでプロンプト入力下のサブエージェントパネルからバックグラウンドサブエージェントの行をクリアします。1021Claude Code は、サブエージェントの終了方法に応じて、2 つの方法のいずれかでプロンプト入力下のサブエージェントパネルからバックグラウンドサブエージェントの行をクリアします。

995 1022 


1036 1063 

1037[バックグラウンドサブエージェントのレポート](#run-subagents-in-foreground-or-background) は完了通知内に到達し、これはユーザーからのメッセージではなく自動化されたイベントとしてマークされます。1064[バックグラウンドサブエージェントのレポート](#run-subagents-in-foreground-or-background) は完了通知内に到達し、これはユーザーからのメッセージではなく自動化されたイベントとしてマークされます。

1038 1065 

1039<Note>

1040 サブエージェント出力スキャンには Claude Code v2.1.210 以降が必要です。

1041</Note>

1042 

1043<h3 id="common-patterns">1066<h3 id="common-patterns">

1044 一般的なパターン1067 一般的なパターン

1045</h3>1068</h3>


1109 1132 

1110デフォルトでは、サブエージェントは独自のサブエージェントを生成でき、メイン会話の下に最大 3 層です。深さの制限では、Claude Code は [フォーク](#fork-the-current-conversation) を除くすべてのサブエージェントから `Agent` ツールを保留するため、制限時のサブエージェントは委譲された作業を自分で行い、1 つの概要を返します。制限時のフォークは継承されたツールリストに `Agent` を保持しますが、ツールは生成する代わりにエラーを返します。1133デフォルトでは、サブエージェントは独自のサブエージェントを生成でき、メイン会話の下に最大 3 層です。深さの制限では、Claude Code は [フォーク](#fork-the-current-conversation) を除くすべてのサブエージェントから `Agent` ツールを保留するため、制限時のサブエージェントは委譲された作業を自分で行い、1 つの概要を返します。制限時のフォークは継承されたツールリストに `Agent` を保持しますが、ツールは生成する代わりにエラーを返します。

1111 1134 

1112ネストされたサブエージェントは、委譲されたタスク自体が並列サブタスクに分割される場合に適しています。例えば、検出結果ごとに検証者を派遣するレビュアーサブエージェントです。対話セッションでは、トップレベルのサブエージェントの概要のみがユーザーに返され、中間出力はメイン会話から外れます。バックグラウンドサブエージェントを起動するサブエージェントは、完了する前にその結果を待ちます。[非対話モード](/docs/ja/headless) と Agent SDK では、起動するサブエージェントは待たないため、ネストされたバックグラウンドサブエージェントがその起動者の終了後に完了すると、代わりにメイン会話に報告されます。1135ネストされたサブエージェントは、委譲されたタスク自体が並列サブタスクに分割される場合に適しています。例えば、検出結果ごとに検証者を派遣するレビュアーサブエージェントです。デフォルトでは、生成元のサブエージェントは各ネストされたサブエージェントのレポートを待ちます。

1136 

1137* **対話型ターミナルセッション**: バックグラウンドサブエージェントを起動するサブエージェントは完了する前にその結果を待つため、トップレベルのサブエージェントの概要のみがユーザーに返されます。

1138* **`claude -p` と Agent SDK**: [フォークモード](#turn-fork-mode-on-or-off) がオンの間、生成元のサブエージェントは待機します。フォークモードをオフにすると、ネストされたサブエージェントは代わりに [バックグラウンド](#run-subagents-in-foreground-or-background) で開始されます。生成元のサブエージェントはバックグラウンドのネストされたサブエージェントを待たず、そのネストされたサブエージェントは生成元より長く実行された場合、メイン会話に報告します。

1113 1139 

1114制限を変更するには、[`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/ja/env-vars) をメイン会話の下に必要なサブエージェント層の数に設定します。例えば、[`settings.json`](/docs/ja/settings) のこのエントリはネストを 2 層に制限します。1140制限を変更するには、[`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/ja/env-vars) をメイン会話の下に必要なサブエージェント層の数に設定します。例えば、[`settings.json`](/docs/ja/settings) のこのエントリはネストを 2 層に制限します。

1115 1141 


1277</h2>1303</h2>

1278 1304 

1279<Note>1305<Note>

1280 フォークされたサブエージェントは `/subtask` で実行され、Claude Code v2.1.212 以降が必要です。[エージェントビューがオフになっている](/docs/ja/agent-view#turn-off-agent-view)場合、`/subtask` は利用できず、`/fork` がフォークされたサブエージェントを開始します。それ以外の場合、`/fork` はセッション全体を新しい[バックグラウンドセッション](/docs/ja/agent-view#from-inside-a-session)にコピーします。1306 [エージェントビューがオフになっている](/docs/ja/agent-view#turn-off-agent-view)場合、`/subtask` は利用できず、代わりに `/fork` がフォークされたサブエージェントを開始します。それ以外の場合、`/fork` はセッション全体を新しい[バックグラウンドセッション](/docs/ja/agent-view#from-inside-a-session)にコピーします。

1281</Note>1307</Note>

1282 1308 

1283フォークは、これまでの会話全体を継承するサブエージェントです。これにより、サブエージェントが通常提供する入力分離が削除されます。フォークはメインセッションと同じシステムプロンプト、ツール、モデル、およびメッセージ履歴を表示するため、状況を再度説明することなく、サイドタスクを渡すことができます。フォークのツール呼び出しはまだ会話から除外され、最終結果のみが返されるため、メインコンテキストウィンドウはクリーンなままです。フォークを使用する場合は、他のサブエージェントが有用であるには背景が多すぎる場合、または同じ開始点から複数のアプローチを並行して試したい場合です。1309フォークは、これまでの会話全体を継承するサブエージェントです。これにより、サブエージェントが通常提供する入力分離が削除されます。フォークはメインセッションと同じシステムプロンプト、ツール、モデル、およびメッセージ履歴を表示するため、状況を再度説明することなく、サイドタスクを渡すことができます。フォークのツール呼び出しはまだ会話から除外され、最終結果のみが返されるため、メインコンテキストウィンドウはクリーンなままです。フォークを使用する場合は、他のサブエージェントが有用であるには背景が多すぎる場合、または同じ開始点から複数のアプローチを並行して試したい場合です。

1284 1310 

1285Claude は Agent ツールを通じて `fork` サブエージェントタイプをリクエストすることでフォークを開始します。これを制御するのは[フォークモード](#turn-fork-mode-on-or-off)で、インタラクティブセッションではデフォルトでオンになっています。1311フォークモードがオンの間(デフォルトではオンです)、Claude は自らフォークを開始できます。フォークを停止するには、[フォークモードをオフにする](#turn-fork-mode-on-or-off)を参照してください。

1286 1312 

1287`/subtask` の後にタスクを続けることで、フォークモードがオンかどうかに関わらず、自分でフォークを開始できます。v2.1.161 から v2.1.211 ではコマンドは `/fork` です。Claude Code はフォークにタスクの最初の単語から名前を付けます。次の例は、メインセッションで実装を続ける間に、会話をドラフトテストケースにフォークします:1313`/subtask` の後にタスクを続けることで、フォークモードがオンかどうかに関わらず、自分でフォークを開始できます。Claude Code はフォークにタスクの最初の単語から名前を付けます。次の例は、メインセッションで実装を続ける間に、会話をドラフトテストケースにフォークします:

1288 1314 

1289```text wrap theme={null}1315```text wrap theme={null}

1290/subtask draft unit tests for the parser changes so far1316/subtask draft unit tests for the parser changes so far


1327| コンテキスト | 完全な会話履歴 | 渡すプロンプトを使用した新しいコンテキスト |1353| コンテキスト | 完全な会話履歴 | 渡すプロンプトを使用した新しいコンテキスト |

1328| システムプロンプトとツール | メインセッションと同じ | サブエージェントの[定義ファイル](#write-subagent-files)から、[バックグラウンド実行用にフィルタリング](#available-tools) |1354| システムプロンプトとツール | メインセッションと同じ | サブエージェントの[定義ファイル](#write-subagent-files)から、[バックグラウンド実行用にフィルタリング](#available-tools) |

1329| モデル | メインセッションと同じ | サブエージェントの `model` フィールドから |1355| モデル | メインセッションと同じ | サブエージェントの `model` フィールドから |

1330| 権限 | プロンプトがターミナルに表示 | [バックグラウンド実行時にメインセッションに表示](#run-subagents-in-foreground-or-background) |

1331| プロンプトキャッシュ | メインセッションと共有 | 別のキャッシュ |1356| プロンプトキャッシュ | メインセッションと共有 | 別のキャッシュ |

1332 1357 

1333フォークのシステムプロンプトとツール定義は親と同じであるため、最初のリクエストは親の[プロンプトキャッシュ](/docs/ja/prompt-caching#subagents-and-the-cache)を再利用します。この再利用により、同じコンテキストが必要なタスクの場合、フォークは新しいサブエージェントよりも安価です。1358フォークのシステムプロンプトとツール定義は親と同じであるため、最初のリクエストは親の[プロンプトキャッシュ](/docs/ja/prompt-caching#subagents-and-the-cache)を再利用します。この再利用により、同じコンテキストが必要なタスクの場合、フォークは新しいサブエージェントよりも安価です。


1335Claude が Agent ツール経由でフォークをスポーンするときに、`isolation: "worktree"` を渡すことができるため、フォークのファイル編集は、チェックアウトではなく、別の git worktree に書き込まれます。フォークはさらにフォークをスポーンできません。1360Claude が Agent ツール経由でフォークをスポーンするときに、`isolation: "worktree"` を渡すことができるため、フォークのファイル編集は、チェックアウトではなく、別の git worktree に書き込まれます。フォークはさらにフォークをスポーンできません。

1336 1361 

1337<h3 id="turn-fork-mode-on-or-off">1362<h3 id="turn-fork-mode-on-or-off">

1338 フォークモードをオンまたはオフにする1363 フォークモードをオフにする

1339</h3>1364</h3>

1340 1365 

1341Claude Code はインタラクティブセッションではフォークモードをデフォルトでオンにし、[非インタラクティブモード](/docs/ja/headless)(`-p` 付き)および Agent SDK ではデフォルトでオフにします。インタラクティブデフォルトには Claude Code v2.1.232 以降が必要です。それより前のバージョンでは、`CLAUDE_CODE_FORK_SUBAGENT` を `1` に設定してフォークモードをオンにします。1366フォークモードでは、Claude が自らフォークを開始できます。Claude がフォークを開始しないようにするには:

1342 

1343フォークモードがオンであることは、Claude Code が Agent ツールを処理する方法からわかります:

1344 

1345* Claude は `fork` サブエージェントタイプをリクエストすることでフォークをスポーンできます。Claude がタイプをリクエストしない場合、セッションがまだそのタイプを持っていれば[汎用](#built-in-subagents)サブエージェントを取得します。Explore などの定義から生成されたサブエージェントは通常通り機能します。

1346* Claude Code は Claude がスポーンするサブエージェント(フォークと非フォークサブエージェント両方)をバックグラウンドで実行します。ただし[フォアグラウンドに留まるケース](#run-subagents-in-foreground-or-background)は除きます。Claude Code は Agent ツールの `run_in_background` パラメータも削除するため、Claude はフォアグラウンドをリクエストできません。

1347 

1348[`CLAUDE_CODE_FORK_SUBAGENT`](/docs/ja/env-vars)環境変数を設定してデフォルトをオーバーライドします:

1349 1367 

1350* `1` は非インタラクティブモードおよび Agent SDK でもフォークモードをオンにします1368* **フォークのみを停止する**:[設定](#disable-specific-subagents)の `permissions.deny` に `"Agent(fork)"` を追加します。

1351* `0` はすべての種類のセッションでフォークモードをオフにします1369* **フォークモードをオフにする**:[Claude にサブエージェントを待機させる](#let-claude-wait-for-a-subagent)の手順に従って、`CLAUDE_CODE_FORK_SUBAGENT` を `0` に設定します。

1352 1370 

1353フォークモードをオンに保ちながら Claude がフォークをスポーンするのを停止するには、`Agent(fork)` ルールで[`fork` サブエージェントタイプを拒否](#disable-specific-subagents)します。Claude Code は Claude がスポーンするサブエージェントをバックグラウンドで実行し続けます。ただし同じ[フォアグラウンドに留まるケース](#run-subagents-in-foreground-or-background)は除きます。1371フォークモードがオンの間、ローカルマシン上のインタラクティブなターミナル、VS Code、またはデスクトップのセッションでは、Claude は[サブエージェントを待機する](#run-subagents-in-foreground-or-background)こともできません。フォークモードは Claude Code v2.1.302 からデフォルトでオンになっており、インタラクティブなターミナルセッションでは v2.1.232 からオンになっています。

1354 1372 

1355<h2 id="example-subagents">1373<h2 id="example-subagents">

1356 サブエージェントの例1374 サブエージェントの例

Details

58 58 

59 Claude Code の初回実行時のターミナルセットアッププロンプトを受け入れた場合、これはすでに完了しています。そのプロンプトは `/terminal-setup` を実行し、Option を Meta として有効にし、Apple Terminal プロファイルで可聴ベルをオフにします。59 Claude Code の初回実行時のターミナルセットアッププロンプトを受け入れた場合、これはすでに完了しています。そのプロンプトは `/terminal-setup` を実行し、Option を Meta として有効にし、Apple Terminal プロファイルで可聴ベルをオフにします。

60 60 

61 [スクリーンリーダーモード](/docs/ja/accessibility)では、`/terminal-setup` はベル設定を変更しないままにするため、ターミナルベルは可聴のままです。v2.1.211 より前では、`/terminal-setup` はスクリーンリーダーモードでもベルをオフにしていました。以前の実行でベルがオフになった場合は、設定 → プロファイル → 詳細 → 「可聴ベル」でオンに戻してください。61 [スクリーンリーダーモード](/docs/ja/accessibility)では、`/terminal-setup` はベル設定を変更しないままにするため、ターミナルベルは可聴のままです。以前の実行でベルがオフになった場合は、設定 → プロファイル → 詳細 → 「可聴ベル」でオンに戻してください。

62 </Tab>62 </Tab>

63 63 

64 <Tab title="iTerm2">64 <Tab title="iTerm2">

tools-reference.md +30 −30

Details

26| `CronDelete` | ID でスケジュール済みタスクをキャンセルします | いいえ |26| `CronDelete` | ID でスケジュール済みタスクをキャンセルします | いいえ |

27| `CronList` | セッション内のすべてのスケジュール済みタスクをリストします | いいえ |27| `CronList` | セッション内のすべてのスケジュール済みタスクをリストします | いいえ |

28| `Edit` | 特定のファイルに対して対象を絞った編集を行います。[Edit ツールの動作](#edit-tool-behavior)を参照してください | はい |28| `Edit` | 特定のファイルに対して対象を絞った編集を行います。[Edit ツールの動作](#edit-tool-behavior)を参照してください | はい |

29| `EndConversation` | セッションを終了します。持続的な不正使用入力の稀なケースまたは Claude にツールのデモンストレーションを求める場合に使用します。Claude Code v2.1.213 以降が必要です。[EndConversation ツールの動作](#endconversation-tool-behavior)を参照してください | いいえ |29| `EndConversation` | セッションを終了します。持続的な不正使用入力の稀なケースまたは Claude にツールのデモンストレーションを求める場合に使用します。[EndConversation ツールの動作](#endconversation-tool-behavior)を参照してください | いいえ |

30| `EnterPlanMode` | プランモードに切り替えて、コーディング前にアプローチを設計します | いいえ |30| `EnterPlanMode` | プランモードに切り替えて、コーディング前にアプローチを設計します | いいえ |

31| `EnterWorktree` | 分離された[git worktree](/docs/ja/worktrees)を作成し、それに切り替えます。新しいものを作成する代わりに、既存の worktree に切り替えるには `path` を渡します。最初のエントリでは、ターゲットは現在のリポジトリの worktree、またはマルチリポジトリワークスペースでは、その中にネストされたリポジトリの worktree である可能性があります。v2.1.203 より前では、ネストされたリポジトリの worktree は拒否されていました。`.claude/worktrees/` の外の `path` は、セッションのワーキングディレクトリと書き込みアクセスをその場所に移動するため、承認を求めるプロンプトが表示されます。新しい worktree の作成と `.claude/worktrees/` の下のパスはプロンプトを表示しません。v2.1.206 より前では、Claude は `.claude/worktrees/` の外のパスにプロンプトなしで入りました。worktree セッション内から、または [`isolation: worktree`](/docs/ja/sub-agents#supported-frontmatter-fields) などのピン留めされたワーキングディレクトリを持つサブエージェントから、`path` フォームのみが利用可能で、ターゲットはセッションのリポジトリの `.claude/worktrees/` の下にある必要があります | はい |31| `EnterWorktree` | 分離された[git worktree](/docs/ja/worktrees)を作成し、それに切り替えます。新しいものを作成する代わりに、既存の worktree に切り替えるには `path` を渡します。最初のエントリでは、ターゲットは現在のリポジトリの worktree、またはマルチリポジトリワークスペースでは、その中にネストされたリポジトリの worktree である可能性があります。v2.1.203 より前では、ネストされたリポジトリの worktree は拒否されていました。`.claude/worktrees/` の外の `path` は、セッションのワーキングディレクトリと書き込みアクセスをその場所に移動するため、承認を求めるプロンプトが表示されます。新しい worktree の作成と `.claude/worktrees/` の下のパスはプロンプトを表示しません。v2.1.206 より前では、Claude は `.claude/worktrees/` の外のパスにプロンプトなしで入りました。worktree セッション内から、または [`isolation: worktree`](/docs/ja/sub-agents#supported-frontmatter-fields) などのピン留めされたワーキングディレクトリを持つサブエージェントから、`path` フォームのみが利用可能で、ターゲットはセッションのリポジトリの `.claude/worktrees/` の下にある必要があります | はい |

32| `ExitPlanMode` | 承認のためのプランを提示し、プランモードを終了します | はい |32| `ExitPlanMode` | 承認のためのプランを提示し、プランモードを終了します | はい |


48| `SendFeedback` | Claude Code に関するフィードバックレポートを作成します。製品の問題または Claude Code セッション内での Claude 自身の動作をカバーします。ユーザーがレビューできるよう、お使いのマシン上のキューに入れます。Claude Code は、ドラフトを送信することを選択するまで何も送信しません。[SendFeedback ツールの動作](#sendfeedback-tool-behavior)を参照してください。Claude Code v2.1.238 以降が必要です | いいえ |48| `SendFeedback` | Claude Code に関するフィードバックレポートを作成します。製品の問題または Claude Code セッション内での Claude 自身の動作をカバーします。ユーザーがレビューできるよう、お使いのマシン上のキューに入れます。Claude Code は、ドラフトを送信することを選択するまで何も送信しません。[SendFeedback ツールの動作](#sendfeedback-tool-behavior)を参照してください。Claude Code v2.1.238 以降が必要です | いいえ |

49| `SendMessage` | 別のエージェントにメッセージを送信します。[エージェントチーム](/docs/ja/agent-teams)チームメイト、[エージェント ID または名前で再開するサブエージェント](/docs/ja/sub-agents#resume-subagents)、またはこのマシン上またはその外にある他の Claude Code セッションのいずれか。他のセッションへのメッセージングには Claude Code v2.1.224 以降が必要です。[クロスセッションメッセージング](/docs/ja/cross-session-messaging)は、Claude が到達できるセッション、[メッセージが到着したときの外観](/docs/ja/cross-session-messaging#what-a-message-looks-like)、および[別のセッションがアイドル状態になったときに Claude が通知を受け取る方法](/docs/ja/cross-session-messaging#get-a-notice-when-another-session-goes-idle)をカバーしています。Claude はオプションの `summary` 入力を含めることができます。通常は 5~10 語で、Claude Code は 1 行のプレビューとして表示します。Claude が[プレーンテキストメッセージ](/docs/ja/cross-session-messaging#limitations)で省略した場合、Claude Code はメッセージの最初の行を概要として使用します。Claude Code は 200 文字を超える概要を省略記号で切り詰めます | いいえ |49| `SendMessage` | 別のエージェントにメッセージを送信します。[エージェントチーム](/docs/ja/agent-teams)チームメイト、[エージェント ID または名前で再開するサブエージェント](/docs/ja/sub-agents#resume-subagents)、またはこのマシン上またはその外にある他の Claude Code セッションのいずれか。他のセッションへのメッセージングには Claude Code v2.1.224 以降が必要です。[クロスセッションメッセージング](/docs/ja/cross-session-messaging)は、Claude が到達できるセッション、[メッセージが到着したときの外観](/docs/ja/cross-session-messaging#what-a-message-looks-like)、および[別のセッションがアイドル状態になったときに Claude が通知を受け取る方法](/docs/ja/cross-session-messaging#get-a-notice-when-another-session-goes-idle)をカバーしています。Claude はオプションの `summary` 入力を含めることができます。通常は 5~10 語で、Claude Code は 1 行のプレビューとして表示します。Claude が[プレーンテキストメッセージ](/docs/ja/cross-session-messaging#limitations)で省略した場合、Claude Code はメッセージの最初の行を概要として使用します。Claude Code は 200 文字を超える概要を省略記号で切り詰めます | いいえ |

50| `SendUserFile` | セッションからファイルをオプションのキャプション付きでユーザーに送信します。生成されたレポート、図、スクリーンショット、または構築されたアーティファクトがトランスクリプトで言及されるだけでなく、デバイスに届くようにします。オプションの `display` 入力は表示方法を制御します。`render` はファイルをクライアントにインラインで開き、`attach` はダウンロードカードのみを表示し、設定されていない場合、クライアントはファイルタイプで決定します。[Remote Control](/docs/ja/remote-control) クライアントが接続されている場合、または[クラウドセッション](/docs/ja/claude-code-on-the-web)で利用可能です。配信は Anthropic ホスト型インフラストラクチャを通じて実行されるため、このツールは Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません | いいえ |50| `SendUserFile` | セッションからファイルをオプションのキャプション付きでユーザーに送信します。生成されたレポート、図、スクリーンショット、または構築されたアーティファクトがトランスクリプトで言及されるだけでなく、デバイスに届くようにします。オプションの `display` 入力は表示方法を制御します。`render` はファイルをクライアントにインラインで開き、`attach` はダウンロードカードのみを表示し、設定されていない場合、クライアントはファイルタイプで決定します。[Remote Control](/docs/ja/remote-control) クライアントが接続されている場合、または[クラウドセッション](/docs/ja/claude-code-on-the-web)で利用可能です。配信は Anthropic ホスト型インフラストラクチャを通じて実行されるため、このツールは Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません | いいえ |

51| `ShareOnboardingGuide` | ガイドが作成された後、`ONBOARDING.md` をアップロードし、チームメイトが Claude Code で開くことができる共有リンクを返します。`/team-onboarding` から呼び出されます。claude.ai サブスクライバーが Pro、Max、Team、Enterprise プランで利用可能です | はい |51| `ShareOnboardingGuide` | `ONBOARDING.md` をアップロードし、チームメイトが Claude Code で開くことができる共有リンクを返します。ガイドが作成された後、`/team-onboarding` から呼び出されます。Team および Enterprise プランの claude.ai サブスクライバーが利用できます | はい |

52| `Skill` | メイン会話内で[スキル](/docs/ja/skills#control-who-invokes-a-skill)を実行します | はい |52| `Skill` | メイン会話内で[スキル](/docs/ja/skills#control-who-invokes-a-skill)を実行します | はい |

53| `SubagentHandback` | サブエージェントの最終レポートを、そのサブエージェントの結果を受け取る会話に配信します。[オートモード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)でのみ提供され、Agent ツールがローカルで実行するサブエージェント([フォーク](/docs/ja/sub-agents#fork-the-current-conversation)以外)に提供され、ターミナル CLI、IDE 拡張機能、クラウドセッション、および Agent SDK で利用可能です。分類器はレポートが配信される前にレビューします。Claude Code v2.1.271 以降が必要です | いいえ |53| `SubagentHandback` | サブエージェントの最終レポートを、そのサブエージェントの結果を受け取る会話に配信します。[オートモード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)でのみ提供され、Agent ツールがローカルで実行するサブエージェント([フォーク](/docs/ja/sub-agents#fork-the-current-conversation)以外)に提供され、ターミナル CLI、IDE 拡張機能、クラウドセッション、および Agent SDK で利用可能です。分類器はレポートが配信される前にレビューします。Claude Code v2.1.271 以降が必要です | いいえ |

54| `TaskCreate` | タスクリストに新しいタスクを作成します。[タスクツール利用可能性](#task-tool-availability)の下にリストされているモデルでデフォルトで提供され、他のモデルではオプトインした場合に提供されます | いいえ |54| `TaskCreate` | タスクリストに新しいタスクを作成します。[タスクツール利用可能性](#task-tool-availability)の下にリストされているモデルでデフォルトで提供され、他のモデルではオプトインした場合に提供されます | いいえ |


72ほとんどの場合、Claude がこれらのツールをいつ使用するかを決定するため、Claude と対話するときに自分でツール名を指定する必要はありません。権限やその他の設定を定義するときにツール名を直接参照します。72ほとんどの場合、Claude がこれらのツールをいつ使用するかを決定するため、Claude と対話するときに自分でツール名を指定する必要はありません。権限やその他の設定を定義するときにツール名を直接参照します。

73 73 

74* 設定の [`permissions.allow`](/docs/ja/settings-reference#permissions-allow) と [`permissions.deny`](/docs/ja/settings-reference#permissions-deny)、および `/permissions` インターフェース内74* 設定の [`permissions.allow`](/docs/ja/settings-reference#permissions-allow) と [`permissions.deny`](/docs/ja/settings-reference#permissions-deny)、および `/permissions` インターフェース内

75* [`CLI フラグ`](/docs/ja/cli-reference)の `--allowedTools` と `--disallowedTools`75* [CLI フラグ](/docs/ja/cli-reference)の `--allowedTools` と `--disallowedTools`

76* Agent SDK の [`allowedTools` と `disallowedTools`](/docs/ja/agent-sdk/permissions#allow-and-deny-rules) オプション内76* Agent SDK の [`allowedTools` と `disallowedTools`](/docs/ja/agent-sdk/permissions#allow-and-deny-rules) オプション内

77* [スキルの `allowed-tools`](/docs/ja/skills#frontmatter-reference) frontmatter 内77* [スキルの `allowed-tools`](/docs/ja/skills#frontmatter-reference) frontmatter 内

78* フックの [`if` 条件](/docs/ja/hooks-guide#filter-by-tool-name-and-arguments-with-the-if-field)内78* フックの [`if` 条件](/docs/ja/hooks-guide#filter-by-tool-name-and-arguments-with-the-if-field)内


92 92 

93ここに記載されていないツール(`ExitPlanMode` や `ShareOnboardingGuide` など)は、指定子なしの裸のツール名のみを受け入れます。93ここに記載されていないツール(`ExitPlanMode` や `ShareOnboardingGuide` など)は、指定子なしの裸のツール名のみを受け入れます。

94 94 

95`Edit(...)` 許可ルールは同じパスへの読み取りアクセスも付与するため、一致する `Read(...)` ルールは必要ありません。`Read(...)` 拒否ルールは同じパス上の Edit および Write ツールもブロックします。これには新しいファイルの作成も含まれます。両方のツールが Claude が読み戻す必要があるコンテンツを変更するためです。`Read` 拒否チェックには、編集時に Claude Code v2.1.208 以降が必要です。書き込み時には v2.1.228 以降が必要です。95`Edit(...)` 許可ルールは同じパスへの読み取りアクセスも付与するため、一致する `Read(...)` ルールは必要ありません。`Read(...)` 拒否ルールは同じパス上の Edit および Write ツールもブロックします。これには新しいファイルの作成も含まれます。両方のツールが Claude が読み戻す必要があるコンテンツを変更するためです。Write ツールについては、`Read` 拒否チェックに Claude Code v2.1.228 以降が必要です。

96 96 

97フックの `matcher` フィールドは、括弧で囲まれたルール形式ではなく、裸のツール名を使用します。マッチングルールについては [matcher パターン](/docs/ja/hooks#matcher-patterns)を参照してください。各ツールがフック内の `tool_input` に渡すフィールド名については、[PreToolUse 入力リファレンス](/docs/ja/hooks#pretooluse-input)を参照してください。97フックの `matcher` フィールドは、括弧で囲まれたルール形式ではなく、裸のツール名を使用します。マッチングルールについては [matcher パターン](/docs/ja/hooks#matcher-patterns)を参照してください。各ツールがフック内の `tool_input` に渡すフィールド名については、[PreToolUse 入力リファレンス](/docs/ja/hooks#pretooluse-input)を参照してください。

98 98 


100 Agent ツールの動作100 Agent ツールの動作

101</h2>101</h2>

102 102 

103Agent ツールは、別のコンテキストウィンドウでサブエージェントを起動します。サブエージェントはそのタスクを自律的に処理し、親の会話に結果を返します。親はサブエージェントの中間的なツール呼び出しや出力を見ることはなく、最終的な結果のみを見ます。[agent teams](/docs/ja/agent-teams) が有効な場合、`name` を持つ呼び出しは [teammate](/docs/ja/agent-teams#how-claude-starts-agent-teams) を起動することができ、結果を返す代わりにチームメッセージを通じて報告します。103Agent ツールは、別のコンテキストウィンドウでサブエージェントを起動します。サブエージェントはそのタスクを自律的に処理し、親の会話に結果を返します。親はサブエージェントの中間的なツール呼び出しや出力を見ることはなく、最終的な結果のみを見ます。同じツールで、チームメイトやフォークを起動することもできます。

104 104 

105サブエージェントが実行するターン数を制限するには、[subagent definition](/docs/ja/sub-agents#supported-frontmatter-fields) で `maxTurns` を設定します。サブエージェントが制限に達すると、Claude Code は返された結果を部分的な出力としてマークし、Claude は [subagent を再開](/docs/ja/sub-agents#resume-subagents) して続行することができます。105* **チームメイト**: [エージェントチーム](/docs/ja/agent-teams) が有効な場合、`name` を持つ呼び出しは代わりに [チームメイト](/docs/ja/agent-teams#how-claude-starts-agent-teams) を起動できます。チームメイトは結果を返すのではなく、チームメッセージを通じて報告します

106* **フォーク**: [フォークモード](/docs/ja/sub-agents#turn-fork-mode-on-or-off) がオンの場所では、このツールは [フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation) を起動できます。フォークされたサブエージェントは、新規に開始する代わりに親の会話全体を継承します

106 107 

107同じ Agent ツールは、[fork mode](/docs/ja/sub-agents#turn-fork-mode-on-or-off) がオンの場所で [forked subagents](/docs/ja/sub-agents#fork-the-current-conversation) も起動します。フォークは新規に開始する代わりに親の会話全体を継承し、[foreground に留まるケース](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) を除いてバックグラウンドで実行され、ターミナルで権限プロンプトを表示します。このセクションの残りは、非フォーク subagent について説明します。108サブエージェントが実行するターン数を制限するには、[subagent definition](/docs/ja/sub-agents#supported-frontmatter-fields) で `maxTurns` を設定します。サブエージェントが制限に達すると、Claude Code は返された結果を部分的な出力としてマークし、Claude は [subagent を再開](/docs/ja/sub-agents#resume-subagents) して続行することができます。

108 109 

109非フォーク subagent が使用できるツールは、[subagent definition](/docs/ja/sub-agents) の `tools` フィールドと `disallowedTools` フィールドに依存します。110非フォーク subagent が使用できるツールは、[subagent definition](/docs/ja/sub-agents) の `tools` フィールドと `disallowedTools` フィールドに依存します。

110 111 


243 244 

244バックグラウンドに移動されたコマンドの結果は、何が起こったかを示します。245バックグラウンドに移動されたコマンドの結果は、何が起こったかを示します。

245 246 

246* タイムアウトが移動をトリガーする場合、結果は明示的に報告します。`Command did not complete within its 120s timeout and was moved to the background`。秒はタイムアウトに一致し、その後にタスク ID と出力が書き込まれているファイルのパスが続きます。247* タイムアウトが移動をトリガーする場合、結果は明示的に報告します。`Command did not complete within its 120s timeout and was moved to the background`。秒は適用されたタイムアウトに一致し、その後にタスク ID と出力が書き込まれているファイルのパスが続きます。

247* バックグラウンドに移動されるコマンド内の `cd`、`pushd`、`popd`、または `chdir` は決して引き継がれません。結果は `Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands.` と述べているため、Claude は発生しなかったディレクトリ変更に対して行動しません。248* バックグラウンドに移動されるコマンド内の `cd`、`pushd`、`popd`、または `chdir` は決して引き継がれません。結果は `Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands.` と述べているため、Claude は発生しなかったディレクトリ変更に対して行動しません。

248 249 

249<h3 id="memory-limit-on-linux-and-wsl">250<h3 id="memory-limit-on-linux-and-wsl">


255* サイズをバイト数として、または `K`、`M`、`G`、または `T` サフィックス付きで記述します。`0`、`off`、`false`、`no`、または `none` を設定して上限をオフにします。Claude Code は `4e9` などのサイズとして読み取ることができない他の値を無視します。256* サイズをバイト数として、または `K`、`M`、`G`、または `T` サフィックス付きで記述します。`0`、`off`、`false`、`no`、または `none` を設定して上限をオフにします。Claude Code は `4e9` などのサイズとして読み取ることができない他の値を無視します。

256* Claude Code は、各コマンドごとではなく、1 つの上限に対してセッションのすべての Bash、PowerShell、および Monitor コマンドをカウントします。257* Claude Code は、各コマンドごとではなく、1 つの上限に対してセッションのすべての Bash、PowerShell、および Monitor コマンドをカウントします。

257* Claude Code はメモリ cgroup で上限を適用します。cgroup をセットアップできない場合、コマンドは上限なしで実行され、`claude --debug` からのデバッグログは理由を示します。258* Claude Code はメモリ cgroup で上限を適用します。cgroup をセットアップできない場合、コマンドは上限なしで実行され、`claude --debug` からのデバッグログは理由を示します。

258* Claude Code が開始した最初のプロセスが上限をオンにした後、またはオフ値または cgroup セットアップの失敗のためにオフにした後、Claude Code はその結果を保持します。変更または削除された値、または固定されたセットアップを適用するには、`claude` を再度起動します。259* Claude Code が開始した最初のプロセスが上限をオンにした後、またはオフ値または cgroup セットアップの失敗のためにオフにした後、Claude Code は再起動するまでその結果を保持します。変更または削除された値、または修正されたセットアップを適用するには、`claude` を再度起動します。

259* コマンドが上限の下に留まることができない場合、カーネルはコマンドを強制終了し、その結果に上限を名前で示すものはありません。260* コマンドが上限の下に留まることができない場合、カーネルはコマンドを強制終了し、その結果に上限を名前で示すものはありません。

260 261 

261Claude Code は、開始する他の種類のプロセスも同じ制限に対してカウントできます。[`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`](/docs/ja/env-vars#variables) を上限から除外する種類のカンマ区切りリストに設定します。Claude Code はリストにない種類に上限を適用します。`none` に設定してすべての種類に上限を設定するか、`all-new` に設定して Bash、PowerShell、および Monitor ツールコマンドのみに上限を設定します。Claude Code v2.1.246 以降が必要です。名前を付けることができる種類は次のとおりです。262Claude Code は、開始する他の種類のプロセスも同じ制限に対してカウントできます。[`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`](/docs/ja/env-vars#variables) を上限から除外する種類のカンマ区切りリストに設定します。Claude Code はリストにない種類に上限を適用します。`none` に設定してすべての種類に上限を設定するか、`all-new` に設定して Bash、PowerShell、および Monitor ツールコマンドのみに上限を設定します。Claude Code v2.1.246 以降が必要です。名前を付けることができる種類は次のとおりです。


271 272 

272* **不明な名前**: Claude Code は認識しない名前を無視します。273* **不明な名前**: Claude Code は認識しない名前を無視します。

273* **変数が設定されていない**: Claude Code は、Anthropic がサーバーから配信する設定から他のキャップされた種類のセットを取得し、そのセットは時間とともに変わる可能性があるため、変更されないセットが必要な場合は変数を設定します。274* **変数が設定されていない**: Claude Code は、Anthropic がサーバーから配信する設定から他のキャップされた種類のセットを取得し、そのセットは時間とともに変わる可能性があるため、変更されないセットが必要な場合は変数を設定します。

274* **権限ゲーティングフック**: すべての種類がキャップされている場合でも、Claude Code はアクションをブロックまたは変更できるフック、およびそのようなフックが呼び出す MCP サーバーを上限から除外するため、カーネルが権限ゲーティングフックを強制終了してもブロックしていたアクションを許可することはできません。275* **権限ゲーティングフック**: すべての種類がキャップされている場合でも、Claude Code はアクションをブロックまたはその結果を変更できるフック、およびそのようなフックが呼び出す MCP サーバーを上限から除外するため、カーネルが権限ゲーティングフックを強制終了してもブロックしていたアクションを許可することはできません。

275 276 

276<h2 id="edit-tool-behavior">277<h2 id="edit-tool-behavior">

277 Edit ツールの動作278 Edit ツールの動作


279 280 

280Edit ツールは正確な文字列置換を実行します。`old_string` と `new_string` を受け取り、最初のものを 2 番目のものに置き換えます。正規表現やあいまい一致は使用しません。281Edit ツールは正確な文字列置換を実行します。`old_string` と `new_string` を受け取り、最初のものを 2 番目のものに置き換えます。正規表現やあいまい一致は使用しません。

281 282 

282編集を適用するには、これらのチェックに合格する必要があります。そのいずれよりも前に、[`Read` 拒否ルール](/docs/ja/permissions#tool-specific-permission-rules)に一致するパスは拒否されます。新しいファイルをそこに作成することも含まれます。この拒否には Claude Code v2.1.208 以降が必要です。283編集を適用するには、これらのチェックに合格する必要があります。そのいずれよりも前に、[`Read` 拒否ルール](/docs/ja/permissions#tool-specific-permission-rules)に一致するパスは拒否されます。新しいファイルをそこに作成することも含まれます。

283 284 

284* **Read-before-edit**: Claude は編集前に現在の会話でファイルを読み取り、[`PARTIAL view` 通知](#large-files)で短縮された読み取りはカウントされません。Claude Opus 4.6、Claude Haiku 4.5、およびそれ以前のモデルは常に読み取りが必要です。新しいモデルは、読み取りが権限プロンプトを必要としない場合、および Read ツールが利用可能な場合、読み取られていないファイルを編集できます。285* **Read-before-edit**: Claude は編集前に現在の会話でファイルを読み取り、[`PARTIAL view` 通知](#large-files)で短縮された読み取りはカウントされません。Claude Opus 4.6、Claude Haiku 4.5、およびそれ以前のモデルは常に読み取りが必要です。新しいモデルは、読み取りが権限プロンプトを必要としない場合、および Read ツールが利用可能な場合、読み取られていないファイルを編集できます。

285* **Match**: `old_string` はファイルに記述されたとおりに正確に表示される必要があります。空白またはインデントの 1 文字の違いでも一致を逃す可能性があります。286* **Match**: `old_string` はファイルに記述されたとおりに正確に表示される必要があります。空白またはインデントの 1 文字の違いでも一致を逃す可能性があります。

286* **Uniqueness**: `old_string` は正確に 1 回だけ表示される必要があります。複数回表示される場合、Claude は 1 つの出現を特定するのに十分な周囲のコンテキストを含む長い文字列を提供するか、`replace_all: true` を設定してすべてを置換します。287* **Uniqueness**: `old_string` は正確に 1 回だけ表示される必要があります。複数回表示される場合、Claude は 1 つの出現を特定するのに十分な周囲のコンテキストを含む長い文字列を提供するか、`replace_all: true` を設定してすべてを置換します。

287 288 

288Claude が最後に読み取った後、ディスク上で変更されたファイルは、`old_string` が現在のコンテンツと正確かつ明確に一致し、Claude Code がプロンプトなしでファイルを読み取ることができる場合でも編集できます。ファイルの現在のコンテンツに対してマッチングすることでこれを安全に保ち、結果はファイルが他の変更を含むことを示すため、Claude は周囲のコンテンツに依存する編集の前に再度読み取ります。古い `old_string` や `replace_all` なしで複数回一致するものなど、その他の場合は、Claude は編集前にファイルを再度読み取ります。読み取られていないファイルと変更されたファイルの緩和された処理には Claude Code v2.1.208 以降が必要です。それ以前は、Claude Code は会話で読み取られていないファイルまたは読み取り後にディスク上で変更されたファイルへの編集を拒否していました。289Claude が最後に読み取った後、ディスク上で変更されたファイルは、`old_string` が現在のコンテンツと正確かつ明確に一致し、Claude Code がプロンプトなしでファイルを読み取ることができる場合でも編集できます。ファイルの現在のコンテンツに対してマッチングすることでこれを安全に保ち、結果はファイルが他の変更を含むことを示すため、Claude は周囲のコンテンツに依存する編集の前に再度読み取ります。古い `old_string` や `replace_all` なしで複数回一致するものなど、その他の場合は、Claude は編集前にファイルを再度読み取ります。

289 290 

290Claude は、`cat` や `grep` などの Bash コマンドでファイルを表示した後も、別途 Read を行わずにそのファイルを編集できます。対象となるコマンドは `cat`、`nl`、`bat`、`batcat`、`head`、`tail`、`sed -n 'X,Yp'`、`grep`、`egrep`、`fgrep`、`rg` で、いずれもパイプやリダイレクトなしで 1 つのファイルに対して実行したものに限ります。一致するものを何も出力しない検索は読み取りとしてカウントされず、このリストにないコマンドも同様にカウントされません。291Claude は、`cat` や `grep` などの Bash コマンドでファイルを表示した後も、別途 Read を行わずにそのファイルを編集できます。対象となるコマンドは `cat`、`nl`、`bat`、`batcat`、`head`、`tail`、`sed -n 'X,Yp'`、`grep`、`egrep`、`fgrep`、`rg` で、いずれもパイプやリダイレクトなしで 1 つのファイルに対して実行したものに限ります。一致するものを何も出力しない検索は読み取りとしてカウントされず、このリストにないコマンドも同様にカウントされません。

291 292 


316 317 

317[非インタラクティブモード](/docs/ja/headless)で `-p` フラグを使用して終了したセッションを再開するとエラーが発生し、コード 1 で終了するため、スクリプトは終了した実行を成功として読み取りません。318[非インタラクティブモード](/docs/ja/headless)で `-p` フラグを使用して終了したセッションを再開するとエラーが発生し、コード 1 で終了するため、スクリプトは終了した実行を成功として読み取りません。

318 319 

319このツールは権限を求めるプロンプトを表示することはなく、[PreToolUse フック](/docs/ja/hooks#pretooluse)はこのツールに対して実行されません。他のツールが残っている間は、これをブロックすることもできません。[EndConversation という名前の deny and ask ルール](/docs/ja/permissions#tool-specific-permission-rules)は効果がなく、`--disallowedTools` も `--tools` リストもこれを削除できません。この除外は意図的です。このツールはセッションを終了する以外に何もしません。ファイルやデータを読み取ったり変更したりすることはなく、この種のセーフガードは、それが適用されるセッションがそれをオフにできない場合にのみ機能します。deny ルールが他のすべてのツールを削除し、`"*"` のように EndConversation にも一致する場合、Claude Code は allow ルールが EndConversation を明示的に指定しない限り、唯一のツールとして残すのではなく、それを削除します。EndConversation に一致しずに他のすべてのツールを削除する deny リストは、それを所定の位置に残します。320このツールは権限を求めるプロンプトを表示することはなく、[PreToolUse フック](/docs/ja/hooks#pretooluse)はこのツールに対して実行されません。他のツールが残っている間は、これをブロックすることもできません。`EndConversation` を指定する [deny ルールと ask ルール](/docs/ja/permissions#tool-specific-permission-rules)は効果がなく、`--disallowedTools` も `--tools` リストもこれを削除できません。この除外は意図的です。このツールは会話を終了する以外に何もしません。ファイルやデータを読み取ったり変更したりすることはなく、この種のセーフガードは、それが適用されるセッションがそれをオフにできない場合にのみ機能します。deny ルールが他のすべてのツールを削除し、`"*"` のように `EndConversation` にも一致する場合、Claude Code は allow ルールが `EndConversation` を明示的に指定しない限り、唯一のツールとして残すのではなく、それも削除します。`EndConversation` に一致せずに他のすべてのツールを削除する deny リストは、それを所定の位置に残します。

320 321 

321[サブエージェント](/docs/ja/sub-agents)はこのツールを取得しません。メインの会話のツールリストを共有するバックグラウンドタスクはそれを見ますが、そこでそれを呼び出しても何も終了しません。322[サブエージェント](/docs/ja/sub-agents)はこのツールを取得しません。メインの会話のツールリストを共有するバックグラウンドタスクはそれを見ますが、そこでそれを呼び出しても何も終了しません。

322 323 

323このツールは以下のすべてが当てはまる場合にのみ表示されます。324このツールは以下のすべてが当てはまる場合にのみ表示されます。

324 325 

325* **バージョン**: Claude Code v2.1.213 以降。

326* **モデル**: セッションのモデルが Claude Opus 4.8、Claude Sonnet 5、Claude Fable 5、またはこれらのファミリーの後続バージョンです。326* **モデル**: セッションのモデルが Claude Opus 4.8、Claude Sonnet 5、Claude Fable 5、またはこれらのファミリーの後続バージョンです。

327* **サーフェス**: インタラクティブターミナルセッション。IDE の統合ターミナルの `claude` セッションを含みます。これは [JetBrains プラグイン](/docs/ja/jetbrains)がそれを実行する方法です。他のサーフェスはこのツールを含みません。例えば:327* **サーフェス**: インタラクティブターミナルセッション。IDE の統合ターミナルの `claude` セッションを含みます。これは [JetBrains プラグイン](/docs/ja/jetbrains)がそれを実行する方法です。他のサーフェスはこのツールを含みません。例えば:

328 * 非インタラクティブな `-p` 実行328 * 非インタラクティブな `-p` 実行


337 Glob ツールの動作337 Glob ツールの動作

338</h2>338</h2>

339 339 

340Glob ツールはファイル名パターンでファイルを検索します。Windows では、デフォルトツールセットの一部です。macOS、Linux、および WSL では、Claude Code は Glob と [Grep](#grep-tool-behavior) をデフォルトツールセットから除外し、Claude は Bash ツールを通じて `find` と `grep` で検索します。Claude のシェルでは、これら 2 つのコマンドは `bfs` と `ugrep` の組み込みバージョンを実行し、検索は Bash 呼び出しとしてフック と権限ルールに到達します。340Glob ツールはファイル名パターンでファイルを検索します。Windows では、デフォルトツールセットの一部です。macOS、Linux、および WSL では、Claude Code は Glob と [Grep](#grep-tool-behavior) をデフォルトツールセットから除外し、Claude は Bash ツールを通じて `find` と `grep` で検索します。Claude のシェルでは、これら 2 つのコマンドは `bfs` と `ugrep` の組み込みバージョンを実行し、検索は `Bash` 呼び出しとしてフックと権限ルールに到達します。

341 341 

342macOS、Linux、および WSL では、以下の場合に Glob と Grep ツールが戻ります。342macOS、Linux、および WSL では、以下の場合に Glob と Grep ツールが戻ります。

343 343 

344* セッションを開始するときに [`--tools` または `--allowedTools`](/docs/ja/cli-reference#cli-flags) で `Glob` または `Grep` を指定するか、同等の [Agent SDK](/docs/ja/agent-sdk/overview) オプションで指定します。`--tools` を使用すると、リストしたものが取得され、`--allowedTools` でいずれかのツールを指定すると両方が復元されます。設定ファイルの許可ルールはこの効果を持ちません。344* セッションを開始するときに [`--tools` または `--allowedTools`](/docs/ja/cli-reference#cli-flags) で `Glob` または `Grep` を指定するか、同等の [Agent SDK](/docs/ja/agent-sdk/overview) オプションで指定します。`--tools` を使用すると、リストしたものが取得され、`--allowedTools` でいずれかのツールを指定すると両方が復元されます。設定ファイルの許可ルールはこの効果を持ちません。

345* 権限 [拒否ルール](/docs/ja/permissions#match-all-uses-of-a-tool)、`--disallowedTools` フラグ、または [`--restricted`](/docs/ja/cli-reference#cli-flags) がセッションから `Bash` を削除します。345* 権限の[拒否ルール](/docs/ja/permissions#match-all-uses-of-a-tool)、`--disallowedTools` フラグ、または [`--restricted`](/docs/ja/cli-reference#cli-flags) がセッションから `Bash` を削除します。

346* [サブエージェント](/docs/ja/sub-agents#available-tools) が `tools` フィールドに `Glob` または `Grep` をリストし、`Bash` を除外します。リストされたツールはそのサブエージェントのみ、または [`--agent`](/docs/ja/sub-agents#invoke-subagents-explicitly) またはエージェント設定を通じてメインセッションエージェントとして実行される場合はセッション全体に戻ります。346* [サブエージェント](/docs/ja/sub-agents#available-tools)が `tools` フィールドに `Glob` または `Grep` をリストし、`Bash` を除外します。リストされたツールはそのサブエージェントのみ、または [`--agent`](/docs/ja/sub-agents#invoke-subagents-explicitly) または `agent` 設定を通じてメインセッションエージェントとして実行される場合はセッション全体に戻ります。

347 347 

348Glob は再帰的なディレクトリマッチングのための `**` を含む標準的な glob 構文をサポートしています。348Glob は再帰的なディレクトリマッチングのための `**` を含む標準的な glob 構文をサポートしています。

349 349 


351* `src/**/*.ts` は `src/` 以下のすべての `.ts` ファイルにマッチします351* `src/**/*.ts` は `src/` 以下のすべての `.ts` ファイルにマッチします

352* `*.{json,yaml}` は現在のディレクトリ内の `.json` および `.yaml` ファイルにマッチします352* `*.{json,yaml}` は現在のディレクトリ内の `.json` および `.yaml` ファイルにマッチします

353 353 

354結果は変更時刻でソートされ、100 ファイルの上限があります。上限に達した場合、Claude は結果に切り詰めフラグを表示し、パターンを絞り込むことができます。354結果は変更時刻でソートされ、100 ファイルの上限があります。上限に達した場合、Claude には結果内の切り詰めフラグが示され、パターンを絞り込むことができます。

355 355 

356Glob はデフォルトでは `.gitignore` を尊重しないため、gitignore されたファイルと追跡されたファイルの両方を検索します。これは gitignore されたファイルをスキップする [Grep](#grep-tool-behavior) とは異なります。Glob が `.gitignore` を尊重するようにするには、Claude Code を起動する前に `CLAUDE_CODE_GLOB_NO_IGNORE=false` を設定してください。356Glob はデフォルトでは `.gitignore` を尊重しないため、gitignore されたファイルと追跡されたファイルの両方を検索します。これは gitignore されたファイルをスキップする [Grep](#grep-tool-behavior) とは異なります。Glob が `.gitignore` を尊重するようにするには、Claude Code を起動する前に `CLAUDE_CODE_GLOB_NO_IGNORE=false` を設定してください。

357 357 

358Claude Code は Glob 呼び出しの権限を決定してから、検索ディレクトリが存在するかどうかを確認します。[作業ディレクトリ](/docs/ja/permissions#working-directories) 外の存在しない `path` に対しても読み取り権限チェックを実行するため、パスの権限プロンプトはそのパスが存在することを意味しません。358Claude Code は Glob 呼び出しの権限を決定してから、検索ディレクトリが存在するかどうかを確認します。[作業ディレクトリ](/docs/ja/permissions#working-directories)外の存在しない `path` に対しても読み取り権限チェックを実行するため、パスの権限プロンプトはそのパスが存在することを意味しません。

359 359 

360null バイトを含む `pattern` または `path` 値はエラーを返し、Claude にそれを削除するよう求めます。360null バイトを含む `pattern` または `path` 値はエラーを返し、Claude にそれを削除するよう求めます。

361 361 


373 373 

374* `files_with_matches`: ファイルパスのみで、行の内容はありません。これがデフォルトです。374* `files_with_matches`: ファイルパスのみで、行の内容はありません。これがデフォルトです。

375* `content`: ファイルと行番号を含む一致する行。ツールの `offset` パラメータが一致を持つパターンの最後の一致を超えて指す場合、Grep は `No entries at this offset` を返すため、Claude はパターンが一致しないと結論付けるのではなく、offset を拡大またはリセットします。375* `content`: ファイルと行番号を含む一致する行。ツールの `offset` パラメータが一致を持つパターンの最後の一致を超えて指す場合、Grep は `No entries at this offset` を返すため、Claude はパターンが一致しないと結論付けるのではなく、offset を拡大またはリセットします。

376* `count`: ファイルごとの一致数、その後すべての一致するファイル全体の合計。合計はツールの `head_limit` または `offset` パラメータがリストされたファイルごとのエントリを切り詰める場合でも、すべての一致をカバーします。v2.1.208 より前では、合計はリストされたエントリのみを合計していました。376* `count`: ファイルごとの一致数、その後すべての一致するファイル全体の合計。合計はツールの `head_limit` または `offset` パラメータがリストされたファイルごとのエントリを切り詰める場合でも、すべての一致をカバーします。

377 377 

378Claude は `glob` パラメータ(例:`**/*.tsx`)でファイルごとに結果をスコープできます。または `type` パラメータ(例:`py` または `rust`)で言語ごとにスコープできます。デフォルトでは、パターンは単一行内で一致します。Claude は `multiline: true` を設定して、行の境界を越えて一致させることができます。378Claude は `glob` パラメータ(例:`**/*.tsx`)でファイルごとに結果をスコープできます。または `type` パラメータ(例:`py` または `rust`)で言語ごとにスコープできます。デフォルトでは、パターンは単一行内で一致します。Claude は `multiline: true` を設定して、行の境界を越えて一致させることができます。

379 379 


536 Windows エンコーディングと終了コード536 Windows エンコーディングと終了コード

537</h3>537</h3>

538 538 

539Windows では、以下の PowerShell エンコーディングと終了コード動作には Claude Code v2.1.214 以降が必要です。

540 

541* `>` と `>>` でのリダイレクトは PowerShell 5.1 で UTF-8 ファイルを書き込みます539* `>` と `>>` でのリダイレクトは PowerShell 5.1 で UTF-8 ファイルを書き込みます

542* Claude Code はネイティブコマンドの標準入力にパイプされたテキストを UTF-8 としてエンコードします540* Claude Code はネイティブコマンドの標準入力にパイプされたテキストを UTF-8 としてエンコードします

543* Claude Code は ANSI エスケープシーケンスなしでエラー出力をキャプチャします541* Claude Code は ANSI エスケープシーケンスなしでエラー出力をキャプチャします

544* 子プロセスが標準入力で待機するコマンドは、ハングするのではなくファイルの終わりを受け取ります542* 子プロセスが標準入力で待機するコマンドは、ハングするのではなくファイルの終わりを受け取ります

545* `where.exe` からの終了コード 1 は一致がないことを意味し、`fc.exe` と `diff.exe` からはファイルが異なることを意味するため、コマンドが出力を生成する場合、Claude Code はその終了コードをコマンドエラーではなく有効な否定的な回答として扱います。Claude Code は `where.exe /Q` または `$null` へのリダイレクトなどのサイレント形式を終了コード 1 での失敗として報告します543* `where.exe` からの終了コード 1 は一致がないことを意味し、`fc.exe` と `diff.exe` からはファイルが異なることを意味するため、コマンドが出力を生成する場合、Claude Code はその終了コードをコマンドエラーではなく有効な否定的な回答として扱います。Claude Code は `where.exe /Q` または `$null` へのリダイレクトなどのサイレント形式を終了コード 1 での失敗として報告します

546 544 

547v2.1.214 より前では、PowerShell 5.1 の `>` は UTF-16LE ファイルを書き込み、非 ASCII パイプ入力は `?` として到着し、Python スクリプトは非 ASCII 文字を出力するときに `UnicodeEncodeError` でクラッシュする可能性がありました。

548 

549<h3 id="preview-limitations">545<h3 id="preview-limitations">

550 プレビューの制限事項546 プレビューの制限事項

551</h3>547</h3>


561 557 

562Read ツールはファイルパスを受け取り、行番号付きでコンテンツを返します。Claude は常に絶対パスを渡すように指示されています。558Read ツールはファイルパスを受け取り、行番号付きでコンテンツを返します。Claude は常に絶対パスを渡すように指示されています。

563 559 

564空のファイルを読み込むと、ファイルは存在するがコンテンツが空であることを示す通知が返され、最後の行を超えた `offset` はファイルの行数を示す通知を返します。v2.1.208 より前では、空のファイルを読み込むと末尾を超えた通知が返されていました。560空のファイルを読み込むと、ファイルは存在するがコンテンツが空であることを示す通知が返され、最後の行を超えた `offset` はファイルの行数を示す通知を返します。

565 561 

566Read は平文テキスト以外のいくつかのファイルタイプを処理します。562Read は平文テキスト以外のいくつかのファイルタイプを処理します。

567 563 

568* **画像**: PNG、JPG、およびその他の画像形式は、生バイトではなく Claude が見ることができるビジュアルコンテンツとして返されます。Claude Code は大きな画像をモデルの画像サイズ制限に合わせるようにリサイズして再圧縮してから送信するため、Claude は大きなスクリーンショットのダウンスケール版を見る可能性があります。そのリサイズ後も 500KB より大きい画像は、ピクセル寸法を変更せずに品質を低下させた JPEG として再エンコードされます。Claude が大きな画像の細かいピクセルレベルの詳細を見落とした場合、ImageMagick を使用して Bash で領域をトリミングするなど、関心のある領域を最初にトリミングするよう指示してください。564* **画像**: PNG、JPEG、GIF、WebP ファイルは、生バイトではなく Claude が見ることができるビジュアルコンテンツとして返されます。Claude Code は大きな画像をモデルの画像サイズ制限に合わせるようにリサイズして再圧縮してから送信するため、Claude は大きなスクリーンショットのダウンスケール版を見る可能性があります。

565 

566 Claude が大きな画像の細かいピクセルレベルの詳細を見落とした場合は、Bash で ImageMagick を使用するなどして関心のある領域をトリミングするよう指示し、トリミングした画像を読み込ませてください。

569* **PDF**: Claude は短い `.pdf` ファイルを全体として読み込みます。10 ページを超える PDF の場合、`pages` パラメータ(例:`"1-5"`)を使用して範囲で読み込み、一度に最大 20 ページまで読み込みます。ページ範囲の読み込みは poppler-utils の `pdftoppm` でページをレンダリングするため、macOS では `brew install poppler` でインストールし、Debian および Ubuntu では `apt-get install poppler-utils` でインストールしてください。Windows およびその他のプラットフォームでは、`pdftoppm` を `PATH` に配置する poppler ビルドをインストールしてください。これがない場合、ページ範囲の読み込みは `pdftoppm is not installed` というエラーで失敗します。567* **PDF**: Claude は短い `.pdf` ファイルを全体として読み込みます。10 ページを超える PDF の場合、`pages` パラメータ(例:`"1-5"`)を使用して範囲で読み込み、一度に最大 20 ページまで読み込みます。ページ範囲の読み込みは poppler-utils の `pdftoppm` でページをレンダリングするため、macOS では `brew install poppler` でインストールし、Debian および Ubuntu では `apt-get install poppler-utils` でインストールしてください。Windows およびその他のプラットフォームでは、`pdftoppm` を `PATH` に配置する poppler ビルドをインストールしてください。これがない場合、ページ範囲の読み込みは `pdftoppm is not installed` というエラーで失敗します。

570* **Jupyter ノートブック**: `.ipynb` ファイルは、コード、マークダウン、ビジュアライゼーションを含むすべてのセルとその出力を返します。セルの合計が 256 KB を超えるノートブック、または[トークン制限](#large-files)を超えるノートブックは、代わりにエラーを返します。Claude Code は 100 MB を超えるノートブックファイルの読み込みを拒否します。エラーは Claude に、シェルコマンドを使用してセルのスライスなど、ノートブックの一部を読み込む方法を指示します。568* **Jupyter ノートブック**: `.ipynb` ファイルは、コード、マークダウン、ビジュアライゼーションを含むすべてのセルとその出力を返します。セルの合計が 256 KB を超えるノートブック、または[トークン制限](#large-files)を超えるノートブックは、代わりにエラーを返します。Claude Code は 100 MB を超えるノートブックファイルの読み込みを拒否します。エラーは Claude に、シェルコマンドを使用してセルのスライスなど、ノートブックの一部を読み込む方法を指示します。

571 569 

572Read はファイルのみを読み込み、ディレクトリは読み込みません。Claude は `ls` などのシェルコマンドを使用してディレクトリコンテンツをリストします。570Read はファイルのみを読み込み、ディレクトリは読み込みません。Claude は `ls` などのシェルコマンドを使用してディレクトリコンテンツをリストします。

573 571 

572Read は、`.xlsx`、`.parquet`、`.heic`、`.zip` など、バイナリとして扱う拡張子を持つファイルの読み込みを拒否します。拒否された後も Claude は作業を続けます。エラーは、そのファイルタイプに対応するスキルがあればそれを提案し、なければその形式を読み込めるシェルコマンドまたはスクリプトを提案します。Read が拒否するファイルを [`@` メンション](/docs/ja/common-workflows#reference-files-and-directories)した場合、Claude はファイルのパスを受け取りますが、その内容は受け取りません。

573 

574<h3 id="large-files">574<h3 id="large-files">

575 大きなファイル575 大きなファイル

576</h3>576</h3>


691* WebFetch はデフォルトで各レスポンスを 15 分間キャッシュするため、同じ URL の繰り返しフェッチは迅速に返されます。Claude Code v2.1.233 以降では、[`CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS`](/docs/ja/env-vars#variables) を設定して、WebFetch が各レスポンスを保持する期間を変更できます。691* WebFetch はデフォルトで各レスポンスを 15 分間キャッシュするため、同じ URL の繰り返しフェッチは迅速に返されます。Claude Code v2.1.233 以降では、[`CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS`](/docs/ja/env-vars#variables) を設定して、WebFetch が各レスポンスを保持する期間を変更できます。

692* ページが 5 分以内(WebFetch が従うリダイレクトを含む)にダウンロードを完了しない場合、デッドラインエラーで失敗します。Claude Code v2.1.268 以降では、[`CLAUDE_CODE_WEBFETCH_DEADLINE_MS`](/docs/ja/env-vars#variables) を設定して制限を変更するか、`0` に設定して削除できます。692* ページが 5 分以内(WebFetch が従うリダイレクトを含む)にダウンロードを完了しない場合、デッドラインエラーで失敗します。Claude Code v2.1.268 以降では、[`CLAUDE_CODE_WEBFETCH_DEADLINE_MS`](/docs/ja/env-vars#variables) を設定して制限を変更するか、`0` に設定して削除できます。

693* URL が別のホストにリダイレクトされる場合、WebFetch はそれに従う代わりに、元の URL とリダイレクト先を名前で示すテキスト結果を返します。その後 Claude は 2 番目の WebFetch 呼び出しで新しい URL をフェッチします。693* URL が別のホストにリダイレクトされる場合、WebFetch はそれに従う代わりに、元の URL とリダイレクト先を名前で示すテキスト結果を返します。その後 Claude は 2 番目の WebFetch 呼び出しで新しい URL をフェッチします。

694* 抽出ステップが過負荷の API にヒットした場合、Claude Code はバックオフで再試行します。それでも失敗するフェッチはエラー結果を返します。v2.1.212 より前では、API エラーテキストが抽出されたページコンテンツであるかのように Claude に到達する可能性がありました。694* 抽出ステップが過負荷の API にヒットした場合、Claude Code はバックオフで再試行します。それでも失敗するフェッチはエラー結果を返します。

695 695 

696Manual および `acceptEdits` [権限モード](/docs/ja/permission-modes) では、WebFetch はフェッチ前にプロンプトを表示します。ただし、[権限ルール](/docs/ja/permissions#manage-permissions) で既に許可または拒否されているドメインと、プロンプトなしでフェッチされる事前承認済みドキュメンテーションドメインの組み込みセットは例外です。ルールが許可するものが何であれ、フェッチは最初に [WebFetch ドメイン安全性チェック](/docs/ja/data-usage#webfetch-domain-safety-check) に合格する必要があります。そのセクションではチェックが送信する内容とそれをスキップする設定について説明しています。プロンプトは 3 つのオプションを提供します。696Manual および `acceptEdits` [権限モード](/docs/ja/permission-modes) では、WebFetch はフェッチ前にプロンプトを表示します。ただし、[権限ルール](/docs/ja/permissions#manage-permissions) で既に許可または拒否されているドメインと、プロンプトなしでフェッチされる事前承認済みドキュメンテーションドメインの組み込みセットは例外です。ルールが許可するものが何であれ、フェッチは最初に [WebFetch ドメイン安全性チェック](/docs/ja/data-usage#webfetch-domain-safety-check) に合格する必要があります。そのセクションではチェックが送信する内容とそれをスキップする設定について説明しています。プロンプトは 3 つのオプションを提供します。

697 697 


727 727 

728このツールは呼び出しごとに最大 8 つのバックエンド検索を実行でき、結果を返す前に内部で検索を絞り込みます。Claude は `allowed_domains` で結果を特定のホストのみに含めるようにスコープできます。または `blocked_domains` で結果を除外できます。この 2 つのリストは 1 回の呼び出しで組み合わせることはできません。728このツールは呼び出しごとに最大 8 つのバックエンド検索を実行でき、結果を返す前に内部で検索を絞り込みます。Claude は `allowed_domains` で結果を特定のホストのみに含めるようにスコープできます。または `blocked_domains` で結果を除外できます。この 2 つのリストは 1 回の呼び出しで組み合わせることはできません。

729 729 

730検索リクエストが過負荷状態の API にヒットした場合、Claude Code はバックオフで再試行します。それでも失敗した呼び出しはエラー結果を返します。v2.1.212 より前では、API エラーテキストが検索結果のように Claude に到達する可能性がありました。730検索リクエストが過負荷状態の API にヒットした場合、Claude Code はバックオフで再試行します。それでも失敗した呼び出しはエラー結果を返します。

731 731 

732WebSearch 権限ルールは指定子を取りません。`allow` または `deny` の単なる `WebSearch` エントリが唯一の形式です。732WebSearch 権限ルールは指定子を取りません。`allow` または `deny` の単なる `WebSearch` エントリが唯一の形式です。

733 733 


741 セッション検索制限741 セッション検索制限

742</h3>742</h3>

743 743 

744インタラクティブなターミナルセッションには 200 回の WebSearch 呼び出しの制限があります。メイン会話からの検索と、並列リサーチのファンアウトなど [サブエージェント](/docs/ja/sub-agents) からの検索は、同じ制限にカウントされます。この制限には Claude Code v2.1.212 以降が必要です。744インタラクティブなターミナルセッションには 200 回の WebSearch 呼び出しの制限があります。メイン会話からの検索と、並列リサーチのファンアウトなど [サブエージェント](/docs/ja/sub-agents) からの検索は、同じ制限にカウントされます。

745 745 

746セッションが制限に達している間、検索は会話に何もしなかった呼び出しとして表示されます。Claude には、既に収集した情報で続行し、さらに検索が必要な場合は制限を引き上げるようユーザーに求めるよう指示する通知が届きます。746セッションが制限に達している間、検索は会話に何もしなかった呼び出しとして表示されます。Claude には、既に収集した情報で続行し、そのことを回答で伝え、さらに検索が必要な場合は制限を引き上げるようユーザーに求めるよう指示する通知が届きます。

747 747 

748さらに検索するには、上限を引き上げるか、制限の回復を待つか、新しい会話を開始します。748さらに検索するには、上限を引き上げるか、制限の回復を待つか、新しい会話を開始します。

749 749 

Details

15| ログインループ、OAuth エラー、`403 Forbidden`、「organization disabled」、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry 認証情報 | [インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install#login-and-authentication) |15| ログインループ、OAuth エラー、`403 Forbidden`、「organization disabled」、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry 認証情報 | [インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install#login-and-authentication) |

16| 設定が適用されない、hooks が実行されない、MCP サーバーがロードされない | [設定をデバッグする](/docs/ja/debug-your-config) |16| 設定が適用されない、hooks が実行されない、MCP サーバーがロードされない | [設定をデバッグする](/docs/ja/debug-your-config) |

17| セッションが auto モードで開始された、または Claude がファイルを編集してコマンドを実行する(確認なし) | [セッションが開始するモード](/docs/ja/permission-modes#which-mode-a-session-starts-in) |17| セッションが auto モードで開始された、または Claude がファイルを編集してコマンドを実行する(確認なし) | [セッションが開始するモード](/docs/ja/permission-modes#which-mode-a-session-starts-in) |

18| Claude Code または Agent SDK を更新した後、`--permission-mode`、`permissionMode`、`permission_mode` のいずれも渡していない `claude -p` または SDK の実行でツール呼び出しが拒否される | [`claude -p` と Agent SDK の実行でツール呼び出しが拒否される](/docs/ja/permission-modes#which-mode-a-non-interactive-run-starts-in) |

18| `API Error: 5xx`、`529 Overloaded`、`429`、リクエスト検証エラー | [エラーリファレンス](/docs/ja/errors) |19| `API Error: 5xx`、`529 Overloaded`、`429`、リクエスト検証エラー | [エラーリファレンス](/docs/ja/errors) |

19| `model not found` または `you may not have access to it` | [エラーリファレンス](/docs/ja/errors#theres-an-issue-with-the-selected-model) |20| `model not found` または `you may not have access to it` | [エラーリファレンス](/docs/ja/errors#theres-an-issue-with-the-selected-model) |

20| Claude が実行するコマンドが `Your disk quota is full`、`is full (ENOSPC)`、または `Command output was lost` で失敗する | [エラーリファレンス](/docs/ja/errors#disk-quota-or-temp-filesystem-is-full) |21| Claude が実行するコマンドが `Your disk quota is full`、`is full (ENOSPC)`、または `Command output was lost` で失敗する | [エラーリファレンス](/docs/ja/errors#disk-quota-or-temp-filesystem-is-full) |

vs-code.md +25 −9

Details

268 268 

269Claude Code パネル上部の **Session history** ボタンをクリックすると、会話履歴にアクセスできます。キーワードで検索したり、時系列で参照したりできます。269Claude Code パネル上部の **Session history** ボタンをクリックすると、会話履歴にアクセスできます。キーワードで検索したり、時系列で参照したりできます。

270 270 

271任意の会話をクリックすると、完全なメッセージ履歴とともに再開できます。その会話が現在のウィンドウの別のタブですでに開いている場合は、クリックするとそのタブに切り替わります。最初にメッセージが空白のままの場合は、[空白になる理由と表示されるタイミング](#a-resumed-conversation-is-blank-at-first)を参照してください。セッションの再開について詳しくは、[セッションを管理する](/docs/ja/sessions)を参照してください。271任意の会話をクリックすると、その会話を再開できます。その会話が現在のウィンドウの別のタブですでに開いている場合は、クリックするとそのタブに切り替わります。会話を開いたときにメッセージが表示されない場合は、[再開した会話が最初は空白になる理由](#a-resumed-conversation-is-blank-at-first)を参照してください。セッションの再開について詳しくは、[セッションを管理する](/docs/ja/sessions)を参照してください。

272 272 

273* **セッションタイトル**: 新しいセッションには、最初のメッセージに基づいて AI が生成したタイトルが付けられます。273* **セッションタイトル**: 新しいセッションには、最初のメッセージに基づいて AI が生成したタイトルが付けられます。

274* **名前の変更とアーカイブ**: セッションにカーソルを合わせると、これらのアクションが表示されます。名前を変更してわかりやすいタイトルを付けたり、アーカイブしてリスト下部の **Archived sessions** グループに移動したりできます。274* **名前の変更とアーカイブ**: セッションにカーソルを合わせると、これらのアクションが表示されます。名前を変更してわかりやすいタイトルを付けたり、アーカイブしてリスト下部の **Archived sessions** グループに移動したりできます。


414 414 

415会話の読み込み中にパネルがクラッシュしたり応答しなくなったりした場合、または会話が開いてから約 3 秒以内にウィンドウをリロードしたり閉じたりした場合、読み込みは完了しません。会話は変更されず、[セッション履歴](#resume-past-conversations)に残ります。415会話の読み込み中にパネルがクラッシュしたり応答しなくなったりした場合、または会話が開いてから約 3 秒以内にウィンドウをリロードしたり閉じたりした場合、読み込みは完了しません。会話は変更されず、[セッション履歴](#resume-past-conversations)に残ります。

416 416 

417* **それでも開く場合**:**Open it anyway** をクリックするか、セッション履歴から会話を選択します。会話が開いてパネルが正常に動作し続ければ、以降のリロード後も通常どおり復元されます。パネルが再び応答しなくなった場合は、ウィンドウをリロードすると、通知付きの新しいチャットに戻ります。417* **それでも開く場合**:**Open it anyway** をクリックするか、セッション履歴から会話を選択します。会話の読み込みが完了すると、[以降のリロード後も通常どおり復元されます](#continue-conversations-after-a-reload)。

418* **会話の読み込み中にパネルが応答しなくなった場合**:ウィンドウをリロードします。新しいチャットが開きます。

418* **閉じたままにする場合**:新しいチャットで作業を続けてください。プロンプトを送信すると通知は消えます。419* **閉じたままにする場合**:新しいチャットで作業を続けてください。プロンプトを送信すると通知は消えます。

419 420 

420<h3 id="run-multiple-conversations">421<h3 id="run-multiple-conversations">


556 パネルに描画するプラグイン557 パネルに描画するプラグイン

557</h3>558</h3>

558 559 

559[mod](/docs/ja/plugins/mods/overview) を含むプラグインは、チャットパネルに描画できます。描画には、拡張機能のバージョン 2.1.299 以降と、[機能フラグを取得する](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッションが必要です。そのようなプラグインからは、次のものが表示されることがあります。560[mod](/docs/ja/plugins/mods/overview) を含むプラグインは、チャットパネルに描画できます。描画には、拡張機能のバージョン 2.1.299 以降が必要です。Amazon Bedrock 上のセッションなど、[機能フラグを取得しない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッションでは、2.1.304 以降が必要です。そのようなプラグインからは、次のものが表示されることがあります。

560 561 

561* 会話の横またはプロンプトボックスの上にあるペイン562* 会話の横またはプロンプトボックスの上にあるペイン

562* プロンプトボックスの上に表示されるトーストまたはステータスライン563* プロンプトボックスの上に表示されるトーストまたはステータスライン


624 625 

625コマンドや[サブエージェント](/docs/ja/sub-agents)のために Claude が想定以上に長く待機している場合は、会話内のそのツール呼び出しの下にある **Run in background** をクリックします。Claude Code v2.1.287 以降が必要です。626コマンドや[サブエージェント](/docs/ja/sub-agents)のために Claude が想定以上に長く待機している場合は、会話内のそのツール呼び出しの下にある **Run in background** をクリックします。Claude Code v2.1.287 以降が必要です。

626 627 

627* **タイミング**:このアクションは、コマンドが約 2 秒間実行された時点、またはサブエージェントが開始された直後に表示されます。628* **タイミング**:このアクションは、コマンドが約 2 秒間実行された時点、または Claude がメインの会話から起動した[サブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)の待機を開始した直後に表示されます。

628* **クリック後**:Claude は待機をやめてターンを続行します。コマンドまたはサブエージェントは、完了時に Claude に通知する[バックグラウンドタスク](/docs/ja/tools-reference#background-commands)として実行を続けます。629* **クリック後**:Claude は待機をやめてターンを続行します。コマンドまたはサブエージェントは、完了時に Claude に通知する[バックグラウンドタスク](/docs/ja/tools-reference#background-commands)として実行を続けます。

629 630 

630その間にタスクを確認したり停止したりするには、プロンプトボックスに `/tasks` と入力して[エージェントマップ](#use-the-prompt-box)を開きます。サブエージェントはそこでエージェントツリー内の位置を保持し、コマンドはエージェントの下に一覧表示され、その[カードに最新の出力](#monitor-background-processes)が表示されます。631その間にタスクを確認したり停止したりするには、プロンプトボックスに `/tasks` と入力して[エージェントマップ](#use-the-prompt-box)を開きます。サブエージェントはそこでエージェントツリー内の位置を保持し、コマンドはエージェントの下に一覧表示され、その[カードに最新の出力](#monitor-background-processes)が表示されます。

631 632 

633<h4 id="the-run-in-background-action-is-missing-under-a-subagent">

634 サブエージェントの下に Run in background アクションが表示されない

635</h4>

636 

637VS Code では、デフォルトでサブエージェントにこのアクションは表示されません。特定のサブエージェントについてその理由を確認するには、[エージェントマップ](#use-the-prompt-box)でそのカードを開き、`Spawned by` の行を確認します:

638 

639* **`Spawned by the main agent`**:サブエージェントはバックグラウンドで開始されたため、Claude はその完了を待っておらず、操作は必要ありません。代わりに Claude にサブエージェントを待機させるには、[Claude にサブエージェントを待機させる](/docs/ja/sub-agents#let-claude-wait-for-a-subagent)を参照してください。

640* **`Spawned by` に別のサブエージェントの名前が表示される**:このアクションは、メインエージェントが起動したサブエージェントにのみ表示され、別のサブエージェントが待機している[ネストされたサブエージェント](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents)には表示されません。ネストされたサブエージェントを早期に終了するには、そのカードで **Stop agent** をクリックします。待機していたサブエージェントは、その結果なしで処理を続行します。

641 

632<h3 id="monitor-background-processes">642<h3 id="monitor-background-processes">

633 バックグラウンドプロセスを監視する643 バックグラウンドプロセスを監視する

634</h3>644</h3>


1028 1038 

1029周囲の数式は組版されているのに、1 つの数式だけが書かれたまま表示される場合は、次の原因を確認してください。1039周囲の数式は組版されているのに、1 つの数式だけが書かれたまま表示される場合は、次の原因を確認してください。

1030 1040 

1031* **数式以外のものとして解釈される**: 単語として解釈される `$…$` のテキスト(`$O(n log n)$` など)は書かれたまま表示されます。`$30$` や `$1/N$` のように数字で始まる `$…$` のテキストも、`=`、`+`、`^` などの文字で数式であることが示されていない限り、書かれたまま表示されます。代わりに、独立した行に置いた `$$` ブロックを使うよう Claude に依頼してください。パネルはこのチェックを行わずに `$$` ブロックを組版します。1041* **インライン数式がパネルで数式として扱われない**: 独立した行に置いた `$$` ブロックとしてもう一度送信するよう Claude に依頼してください。パネルは、`$…$` 区切り文字の間のテキストが次のいずれかに該当する場合、インライン数式を書かれたまま表示します。

1032* **スペースで囲まれている、長い、または複数行にまたがっている**: ドル記号の内側にスペースがある `$ x^2 $`、60 文字を超える `$…$` の内容、2 行にまたがる `$…$` や `\(…\)` は組版されません。代わりに、独立した行に置いた `$$` ブロックを使うよう Claude に依頼してください。`$$` ブロックにはこれらの制限はありません。1042 * 単純な算術式を超える内容なのに、`$O(n log n)$` のように、数式であることを示す `=`、`+`、`^` などの文字が含まれていない

1033* **TeX を組版できない**: 構文エラーを含む数式、`\newcommand` や `\def` などのマクロ定義、エスケープされていない `%` を含む数式は、書かれたまま表示されます。エラーを修正する、マクロを使わない、またはパーセント記号に `\%` を使うように書き直すよう Claude に依頼してください。1043 * `$30$` や `$1/N$` のように、数字で始まり、そのような文字が含まれていない

1034* **大きすぎる**: 8,192 文字を超える数式や、ソースよりもはるかに大きく描画される数式は、書かれたまま表示されます。より小さな数式に分割するか、よりコンパクトに書くよう Claude に依頼してください。1044 * `$ x^2 $` のように、ドル記号の内側にスペースがある

1035* **大量の数式の後にある**: 応答内の 1 つのテキストブロックでは、パネルは上限に達するまで数式を順番に組版します。上限を超える後続の数式は書かれたまま表示されます。必要な数式を単独でもう一度送信するよう Claude に依頼してください。1045 * 60 文字を超えている

1046 * 2 行にまたがっている。2 行にまたがる `\(…\)` の数式も組版されません。

1047* **数式に TeX の構文エラーがある**: エラーを修正して書き直すよう Claude に依頼してください。

1048* **数式でマクロを定義している**: `\newcommand` や `\def` などのマクロ定義を含む数式は、書かれたまま表示されます。マクロを使わずに書き直すよう Claude に依頼してください。

1049* **数式にエスケープされていない `%` が含まれている**: パーセント記号に `\%` を使って書き直すよう Claude に依頼してください。

1050* **数式が大きすぎる**: 8,192 文字を超える数式や、組版後の出力が TeX ソースよりもはるかに大きくなる数式は、書かれたまま表示されます。より小さな数式に分割するか、よりコンパクトに書くよう Claude に依頼してください。

1051* **数式が大量の数式の後にある**: 応答内の 1 つのテキストブロックでは、パネルは上限に達するまで数式を順番に組版します。上限を超える後続の数式は書かれたまま表示されます。必要な数式を単独でもう一度送信するよう Claude に依頼してください。

1036 1052 

1037<h3 id="claude-code-never-responds">1053<h3 id="claude-code-never-responds">

1038 Claude Code がまったく応答しない1054 Claude Code がまったく応答しない

Details

78 <p className="digest-wins-title">その他の改善</p>78 <p className="digest-wins-title">その他の改善</p>

79 79 

80 <div className="digest-wins-grid">80 <div className="digest-wins-grid">

81 <div><code>claude agents</code> はディスパッチフラグ(<code>--add-dir</code>、<code>--settings</code>、<code>--mcp-config</code>、<code>--plugin-dir</code>、<code>--permission-mode</code>、<code>--model</code>、<code>--effort</code>、<code>--dangerously-skip-permissions</code>)を取得してバックグラウンドセッションを構成し、<code>claude agents --cwd \<path></code> はセッションリストをディレクトリにスコープします</div>81 <div><code>claude agents</code> はディスパッチフラグ(`--add-dir`、`--settings`、`--mcp-config`、`--plugin-dir`、`--permission-mode`、`--model`、`--effort`、`--dangerously-skip-permissions`)を取得してバックグラウンドセッションを構成し、`claude agents --cwd <path>` はセッションリストをディレクトリにスコープします</div>

82 <div>新しいフック <code>args: string\[]</code> exec フォームはシェルなしでコマンドを直接生成するため、パスプレースホルダーは引用符が必要ありません</div>82 <div>新しいフック <code>args: string\[]</code> exec フォームはシェルなしでコマンドを直接生成するため、パスプレースホルダーは引用符が必要ありません</div>

83 <div>新しい <code>continueOnBlock</code> 設定オプション(<code>PostToolUse</code> フック用)はフックの拒否理由を Claude にフィードバックし、ターンを終了する代わりに続行します</div>83 <div>新しい <code>continueOnBlock</code> 設定オプション(<code>PostToolUse</code> フック用)はフックの拒否理由を Claude にフィードバックし、ターンを終了する代わりに続行します</div>

84 <div>フック JSON 出力の新しい <code>terminalSequence</code> フィールドにより、フックは制御ターミナルなしでデスクトップ通知、ウィンドウタイトル、ベルを発行できます</div>84 <div>フック JSON 出力の新しい <code>terminalSequence</code> フィールドにより、フックは制御ターミナルなしでデスクトップ通知、ウィンドウタイトル、ベルを発行できます</div>

85 <div>Rewind メニューに「ここまで要約」が追加され、最近のターンを保持しながら以前のコンテキストを圧縮できます</div>85 <div>Rewind メニューに「ここまで要約」が追加され、最近のターンを保持しながら以前のコンテキストを圧縮できます</div>

86 <div>リモートコントロール、<code>/schedule</code>、Claude.ai MCP コネクタ、および通知設定は、<code>ANTHROPIC\_API\_KEY</code>、<code>apiKeyHelper</code>、または <code>ANTHROPIC\_AUTH\_TOKEN</code> が設定されている場合、Claude.ai ログインと並行していても無効になります。これらの機能を使用するには API キーを設定解除します</div>86 <div>リモートコントロール、<code>/schedule</code>、claude.ai MCP コネクタ、および通知設定は、<code>ANTHROPIC\_API\_KEY</code>、<code>apiKeyHelper</code>、または <code>ANTHROPIC\_AUTH\_TOKEN</code> が設定されている場合、claude.ai ログインと並行していても無効になります。これらの機能を使用するには API キーを設定解除します</div>

87 <div>MCP stdio サーバーは環境で <code>CLAUDE\_PROJECT\_DIR</code> を受け取るようになり、フックと一致し、プラグイン構成はコマンドで <code>\${"{"}CLAUDE\_PROJECT\_DIR{"}"}</code> を参照できます</div>87 <div>MCP stdio サーバーは環境で <code>CLAUDE\_PROJECT\_DIR</code> を受け取るようになり、フックと一致し、プラグイン構成はコマンドで <code>\${"{"}CLAUDE\_PROJECT\_DIR{"}"}</code> を参照できます</div>

88 <div><code>claude plugin details \<name></code> はプラグインのコンポーネントインベントリと予測されるセッションあたりのトークンコストを表示し、<code>/plugin</code> 詳細ペインはプラグインが提供する LSP サーバーもリストします</div>88 <div><code>claude plugin details \<name></code> はプラグインのコンポーネントインベントリと予測されるセッションあたりのトークンコストを表示し、<code>/plugin</code> 詳細ペインはプラグインが提供する LSP サーバーもリストします</div>

89 <div>ルートレベルの <code>SKILL.md</code> を持ち、<code>skills/</code> サブディレクトリがないプラグインはスキルとして表示されるようになりました</div>89 <div>ルートレベルの <code>SKILL.md</code> を持ち、<code>skills/</code> サブディレクトリがないプラグインはスキルとして表示されるようになりました</div>

workflows.md +1 −5

Details

153* スケジュールされたタスクプロンプト153* スケジュールされたタスクプロンプト

154* ウェブフック ペイロードまたはプルリクエストコメントが会話にリレーされた場合154* ウェブフック ペイロードまたはプルリクエストコメントが会話にリレーされた場合

155 155 

156<Note>

157 v2.1.210 より前は、キーワードはこれらのルートのいずれからでもワークフローを開始しました。ウェブフック ペイロードまたはプルリクエストコメントが会話にリレーされた場合も含みます。

158</Note>

159 

160<h3 id="let-claude-decide-with-ultracode">156<h3 id="let-claude-decide-with-ultracode">

161 ultracode で Claude に決めさせる157 ultracode で Claude に決めさせる

162</h3>158</h3>


175 171 

176ultracode をオンにすると既に大規模な実行にオプトインしているため、これらのチェックはオンの間は適用されません。172ultracode をオンにすると既に大規模な実行にオプトインしているため、これらのチェックはオンの間は適用されません。

177 173 

178* [「Large workflow」警告](#cost)はワークフロー実行に表示されません174* [`Large workflow` 警告](#cost)はワークフロー実行に表示されません

179* セッションの[同時サブエージェント制限](/docs/ja/sub-agents#concurrent-subagent-limit)は、Claude が Agent ツールで生成するサブエージェントに対して強制されません175* セッションの[同時サブエージェント制限](/docs/ja/sub-agents#concurrent-subagent-limit)は、Claude が Agent ツールで生成するサブエージェントに対して強制されません

180* 自動権限モード では、[ワークフロー起動を承認](#approve-the-plan-before-it-runs)するよう求められません176* 自動権限モード では、[ワークフロー起動を承認](#approve-the-plan-before-it-runs)するよう求められません

181 177 

worktrees.md +6 −3

Details

9[git worktree](https://git-scm.com/docs/git-worktree) は、独自のファイルとブランチを持つ別の作業ディレクトリであり、メインのチェックアウトと同じリポジトリ履歴とリモートを共有します。各 Claude Code セッションを独自の worktree で実行すると、各セッションが編集用にファイルの個別のコピーを持つため、1 つのセッションで機能を構築しながら、2 つ目のセッションでバグを修正できます。9[git worktree](https://git-scm.com/docs/git-worktree) は、独自のファイルとブランチを持つ別の作業ディレクトリであり、メインのチェックアウトと同じリポジトリ履歴とリモートを共有します。各 Claude Code セッションを独自の worktree で実行すると、各セッションが編集用にファイルの個別のコピーを持つため、1 つのセッションで機能を構築しながら、2 つ目のセッションでバグを修正できます。

10 10 

11<Note>11<Note>

12 worktree には git リポジトリが必要です。その他のバージョン管理システムについては、[git のロジックを置き換えるフックを設定](#non-git-version-control)してください。[デスクトップアプリ](/docs/ja/desktop#work-in-parallel-with-sessions)では、セッションの開始時に **worktree** オプションを選択すると、そのセッション専用の worktree が作成されます。12 別のバージョン管理システムまたはデスクトップアプリを使用している場合は、ご自身の環境に応じた手順に従ってください。

13 

14 * **その他のバージョン管理システム**:worktree には git リポジトリが必要です。[git のロジックを置き換えるフックを設定](#non-git-version-control)してください

15 * **デスクトップアプリ**:[セッションを独自の worktree で実行する](/docs/ja/desktop#run-a-session-in-its-own-worktree)を参照してください

13</Note>16</Note>

14 17 

15worktree は Claude を並列で実行するいくつかの方法の 1 つで、ファイル編集を分離します。[サブエージェント](/docs/ja/sub-agents)は 1 つのセッション内で作業を分割し、[セッション間メッセージング](/docs/ja/cross-session-messaging)を使用すると、Claude は worktree 内のセッション間で調査結果を受け渡せます。アプローチを比較するには [エージェントを並列で実行する](/docs/ja/agents) を参照するか、worktree とサブエージェントを一緒に使用するには [worktree でサブエージェントを分離する](#isolate-subagents-with-worktrees) に進んでください。18worktree は Claude を並列で実行するいくつかの方法の 1 つで、ファイル編集を分離します。[サブエージェント](/docs/ja/sub-agents)は 1 つのセッション内で作業を分割し、[セッション間メッセージング](/docs/ja/cross-session-messaging)を使用すると、Claude は worktree 内のセッション間で調査結果を受け渡せます。アプローチを比較するには [エージェントを並列で実行する](/docs/ja/agents) を参照するか、worktree とサブエージェントを一緒に使用するには [worktree でサブエージェントを分離する](#isolate-subagents-with-worktrees) に進んでください。


270 273 

271これらはすべて、worktree を `--worktree` で作成した場合も、`git worktree add` で作成した場合も適用されます。274これらはすべて、worktree を `--worktree` で作成した場合も、`git worktree add` で作成した場合も適用されます。

272 275 

273[デスクトップアプリ](/docs/ja/desktop#work-in-parallel-with-sessions)から開始した worktree セッションでは、Claude Code は設定、フック、スキル、エージェント、コマンド、[`.mcp.json`](/docs/ja/mcp#project-scope) サーバーなどのプロジェクト設定を、worktree からではなくメインチェックアウトのルートから読み込みます。フックのコマンドはそのルートで実行され、`${CLAUDE_PROJECT_DIR}` はそのルートを指します。Claude が作業しているファイルにアクセスするには、フックの [`cwd` 入力フィールド](/docs/ja/hooks#common-input-fields)から worktree のパスを読み取ってください。`CLAUDE.md` ファイルと `.claude/rules/` は引き続き worktree から読み込まれます。276[デスクトップアプリ](/docs/ja/desktop#run-a-session-in-its-own-worktree)から開始した worktree セッションでは、Claude Code は設定、フック、スキル、エージェント、コマンド、[`.mcp.json`](/docs/ja/mcp#project-scope) サーバーなどのプロジェクト設定を、メインチェックアウトのルートから読み込みます。フックのコマンドはそのルートで実行され、`${CLAUDE_PROJECT_DIR}` はそのルートを指します。Claude が作業しているファイルにアクセスするには、フックの [`cwd` 入力フィールド](/docs/ja/hooks#common-input-fields)から worktree のパスを読み取ってください。`CLAUDE.md` ファイルと `.claude/rules/` は引き続き worktree から読み込まれます。

274 277 

275<h2 id="manage-worktrees-manually">278<h2 id="manage-worktrees-manually">

276 worktree を手動で管理する279 worktree を手動で管理する


434* [セッション間メッセージング](/docs/ja/cross-session-messaging): worktree 内のセッション同士で調査結果を受け渡せるようにする437* [セッション間メッセージング](/docs/ja/cross-session-messaging): worktree 内のセッション同士で調査結果を受け渡せるようにする

435* [エージェントチーム](/docs/ja/agent-teams): 複数の Claude セッションを自動的に調整する438* [エージェントチーム](/docs/ja/agent-teams): 複数の Claude セッションを自動的に調整する

436* [セッションを管理する](/docs/ja/sessions): 会話に名前を付け、再開し、切り替える439* [セッションを管理する](/docs/ja/sessions): 会話に名前を付け、再開し、切り替える

437* [デスクトップ並列セッション](/docs/ja/desktop#work-in-parallel-with-sessions): デスクトップアプリの worktree でサポートされるセッション440* [デスクトップセッションを専用の worktree で実行する](/docs/ja/desktop#run-a-session-in-its-own-worktree): デスクトップアプリの worktree でサポートされるセッション