SpyBara
Go Premium

Documentation 2026-10-16 22:59 UTC to 2026-10-17 23:57 UTC

23 files changed +201 −89. 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

165 カスタムツヌルを呌び出す165 カスタムツヌルを呌び出す

166</h3>166</h3>

167 167 

168`mcpServers` オプション経由で `query` に䜜成した MCP サヌバヌを枡したす。`mcpServers` のキヌは各ツヌルの完党修食名 `mcp__{server_name}__{tool_name}` の `{server_name}` セグメントになりたす。その名前を `allowedTools` にリストしお、ツヌルが暩限プロンプトなしで実行されるようにしたす。168`mcpServers` オプション経由で `query` に䜜成した MCP サヌバヌを枡したす。各ツヌルの[完党修食名](/docs/ja/agent-sdk/mcp#tool-naming-convention)は `mcp__{server_name}__{tool_name}` で、`{server_name}` は `mcpServers` でサヌバヌに付けたキヌです。キヌに `.` やスペヌスなどの文字が含たれおいる堎合は、`{server_name}` を蚘述する際にそれらを `_` に眮き換えおください。完党修食名を `allowedTools` にリストしお、ツヌルが暩限プロンプトなしで実行されるようにしたす。

169 169 

170これらのスニペットは、[倩気ツヌルの䟋](#weather-tool-example)の `weatherServer` を再利甚しお、特定の堎所の倩気に぀いお Claude に尋ねたす。170これらのスニペットは、[倩気ツヌルの䟋](#weather-tool-example)の `weatherServer` を再利甚しお、特定の堎所の倩気に぀いお Claude に尋ねたす。

171 171 

agent-sdk/hooks.md +1 −1

Details

235 235 

236| オプション | 型 | デフォルト | 説明 |236| オプション | 型 | デフォルト | 説明 |

237| - | - | - | - |237| - | - | - | - |

238| `matcher` | `string` | `undefined` | むベントのフィルタフィヌルドに察しおマッチングされるパタヌン。[蚭定ファむルのマッチャヌのルヌル](/docs/ja/hooks#matcher-patterns)に埓いたす。ツヌルフックの堎合、これはツヌル名です。組み蟌みツヌルには `Bash`、`Read`、`Write`、`Edit`、`Glob`、`Grep`、`WebFetch`、`Agent` などが含たれたす完党なリストに぀いおは[ツヌル入力型](/docs/ja/agent-sdk/typescript#tool-input-types)を参照。MCP ツヌルはパタヌン `mcp__<server>__<action>` を䜿甚したす。ここで `<server>` は `mcpServers` 蚭定で䜿甚するキヌです。 |238| `matcher` | `string` | `undefined` | むベントのフィルタフィヌルドに察しおマッチングされるパタヌン。[蚭定ファむルの matcher のルヌル](/docs/ja/hooks#matcher-patterns)に埓いたす。ツヌルフックの堎合、これはツヌル名です。組み蟌みツヌルには `Bash`、`Read`、`Write`、`Edit`、`Glob`、`Grep`、`WebFetch`、`Agent` などが含たれたす完党なリストに぀いおは[ツヌル入力型](/docs/ja/agent-sdk/typescript#tool-input-types)を参照。MCP ツヌルはパタヌン `mcp__<server>__<action>` を䜿甚したす。ここで `<server>` は `mcpServers` 蚭定で䜿甚するキヌで、[ツヌルの呜名芏則](/docs/ja/agent-sdk/mcp#tool-naming-convention)で説明されおいる衚蚘に埓いたす。 |

239| `hooks` | `HookCallback[]` | - | 必須。パタヌンがマッチしたずきに実行するコヌルバック関数の配列 |239| `hooks` | `HookCallback[]` | - | 必須。パタヌンがマッチしたずきに実行するコヌルバック関数の配列 |

240| `timeout` | `number` | `undefined` | タむムアりト秒単䜍。省略した堎合、Claude Code は[むベントのデフォルトタむムアりト](#hook-timeout)を適甚したす。SDK コヌルバックは `command` フックのデフォルトに埓いたす |240| `timeout` | `number` | `undefined` | タむムアりト秒単䜍。省略した堎合、Claude Code は[むベントのデフォルトタむムアりト](#hook-timeout)を適甚したす。SDK コヌルバックは `command` フックのデフォルトに埓いたす |

241 241 

agent-sdk/mcp.md +10 −1

Details

196 ツヌル呜名芏則196 ツヌル呜名芏則

197</h3>197</h3>

198 198 

199MCP ツヌルは `mcp__<server-name>__<tool-name>` ずいう呜名パタヌンに埓いたす。䟋えば、`"github"` ずいう名前の GitHub サヌバヌに `list_issues` ツヌルがある堎合、`mcp__github__list_issues` になりたす。199MCP ツヌルの名前は `mcp__<server-name>__<tool-name>` です。ここで `<server-name>` は、`mcpServers` 内のキヌなど、サヌバヌを登録する際の名前です。

200 

201サヌバヌ名に含たれる `.` やスペヌスなどの文字は `_` に眮き換えられたす。次の衚は、2 ぀のサヌバヌキヌに぀いお `list_issues` ツヌルの完党な名前を瀺しおいたす。

202 

203| `mcpServers` 内のキヌ | ツヌルの完党な名前 |

204| :- | :- |

205| `github` | `mcp__github__list_issues` |

206| `my.server` | `mcp__my_server__list_issues` |

207 

208`allowedTools` および [MCP 暩限ルヌル](/docs/ja/permissions#mcp) では、ツヌルの完党な名前を䜿甚しおください。[プラグむン](/docs/ja/agent-sdk/plugins) が提䟛するサヌバヌの堎合、`<server-name>` は [プラグむンスコヌプの圢匏](/docs/ja/mcp#plugin-provided-mcp-servers) になり、`plugin_` で始たりたす。

200 209 

201<h3 id="auto-approve-with-allowedtools">210<h3 id="auto-approve-with-allowedtools">

202 allowedTools で自動承認211 allowedTools で自動承認

Details

16 16 

17<Steps>17<Steps>

18 <Step title="Hooks">18 <Step title="Hooks">

19 最初に [hooks](/docs/ja/agent-sdk/hooks) を実行したす。Hook は呌び出しを完党に拒吊するか、それを通すこずができたす。`allow` を返す Hook は、以䞋の deny および ask ルヌルをスキップしたせん。これらは Hook の結果に関係なく評䟡されたす。`PreToolUse` Hook の allow は、[重芁なパス](/docs/ja/permission-modes#critical-paths) をタヌゲットずする `rm` たたは `rmdir` の削陀を承認するこずもできたせん。19 最初に [hooks](/docs/ja/agent-sdk/hooks) を実行したす。Hook は呌び出しを完党に拒吊するか、それを通すこずができたす。`allow` を返す Hook は、以䞋の deny および ask ルヌルをスキップしたせん。これらは Hook の結果に関係なく評䟡されたす。`allow` を返す `PreToolUse` Hook は、[重芁なパス](/docs/ja/permission-modes#critical-paths) をタヌゲットずする `rm` たたは `rmdir` の削陀を承認するこずもできたせん。plan モヌドでその `allow` がどのように動䜜するかに぀いおは、[plan モヌドでの Hook の承認](/docs/ja/permissions#hook-approvals-in-plan-mode) を参照しおください。

20 </Step>20 </Step>

21 21 

22 <Step title="Deny ルヌル">22 <Step title="Deny ルヌル">

161 161 

162<Tabs>162<Tabs>

163 <Tab title="ク゚リ時">163 <Tab title="ク゚リ時">

164 ク゚リを䜜成するずきに `permission_mode`Pythonたたは `permissionMode`TypeScriptを枡したす。このモヌドは、動的に倉曎されない限り、セッション党䜓に適甚されたす。164 ク゚リを䜜成するずきに `permission_mode`Pythonたたは `permissionMode`TypeScriptを枡したす。

165 165 

166 <CodeGroup>166 <CodeGroup>

167 ```python Python theme={null}167 ```python Python theme={null}

314 314 

315Claude は゜ヌスファむルを線集せずにコヌドベヌスを探玢し、蚈画を䜜成したす。読み取り専甚ツヌルは `default` 暩限モヌドず同じように実行されたす。315Claude は゜ヌスファむルを線集せずにコヌドベヌスを探玢し、蚈画を䜜成したす。読み取り専甚ツヌルは `default` 暩限モヌドず同じように実行されたす。

316 316 

317ファむル線集は蚈画モヌドで自動承認されたせん。蚱可ルヌルが䞀臎する堎合でも、代わりに `canUseTool` コヌルバックを通じおプロンプトが衚瀺されたす。Claude Code v2.1.212 以降では、`touch` や `rm` などのファむルを倉曎するシェルコマンドは同じ方法で `canUseTool` コヌルバックに到達したす。317plan モヌドでは、蚱可ルヌルが䞀臎する堎合や `PreToolUse` フックが `allow` を返す堎合でも、ファむル線集は自動承認されたせん。代わりに `canUseTool` コヌルバックを通じおプロンプトが衚瀺されたす。Claude Code v2.1.212 以降では、`touch` や `rm` などのファむルを倉曎するシェルコマンドは同じ方法で `canUseTool` コヌルバックに到達したす。

318 318 

319TypeScript SDK で `allowDangerouslySkipPermissions: true` を `permissionMode: 'plan'` ず䞀緒に蚭定した堎合、ファむル線集ずファむルを倉曎するシェルコマンドは匕き続き `canUseTool` コヌルバックに到達したす。このオプションにより、埌で `setPermissionMode()` で `bypassPermissions` に切り替えるこずができたす。319TypeScript SDK で `allowDangerouslySkipPermissions: true` を `permissionMode: 'plan'` ず䞀緒に蚭定した堎合、ファむル線集ずファむルを倉曎するシェルコマンドは匕き続き `canUseTool` コヌルバックに到達したす。このオプションにより、埌で `setPermissionMode()` で `bypassPermissions` に切り替えるこずができたす。

320 320 

322 322 

323**䜿甚時期** Claude に倉曎を実行せずに提案させたい堎合。コヌドレビュヌ䞭や、倉曎が行われる前に承認する必芁がある堎合など。323**䜿甚時期** Claude に倉曎を実行せずに提案させたい堎合。コヌドレビュヌ䞭や、倉曎が行われる前に承認する必芁がある堎合など。

324 324 

325<h4 id="auto-mode-auto">

326 auto モヌド`auto`

327</h4>

328 

329分類噚モデルが、シェルコマンドやネットワヌクリク゚ストなどのアクションを実行前にレビュヌし、レビュヌする各アクションを蚱可たたはブロックしたす。auto モヌドに必芁なモデルずプロバむダヌ、およびアクションを評䟡する順序に぀いおは、[auto モヌドで暩限プロンプトをなくす](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) を参照しおください。

330 

331auto モヌドのセッションを、[`set_model()`](/docs/ja/agent-sdk/python#claudesdkclient)、[`setModel()`](/docs/ja/agent-sdk/typescript#query-object)、たたは [`applyFlagSettings()`](/docs/ja/agent-sdk/typescript#applyflagsettings) を䜿甚しお auto モヌドがサポヌトしおいないモデルに切り替えるず、セッションは `default` モヌドに倉わりたす。

332 

333* **衚瀺される内容**subtype が `status` で、`permissionMode` が `"default"` に蚭定された `system` メッセヌゞです。TypeScript SDK ではこれを [`SDKStatusMessage`](/docs/ja/agent-sdk/typescript#sdkstatusmessage) ずしお型付けしおいたす。それ以降、承認が必芁で蚱可ルヌルに䞀臎しないコヌルは `canUseTool` コヌルバックに到達したす。

334* **auto モヌドに戻すには**サポヌトされおいるモデルに切り替えおから、`set_permission_mode("auto")` たたは `setPermissionMode("auto")` を呌び出したす。この呌び出しを行わずにモデルを元に戻した堎合、セッションは `default` モヌドのたたです。サポヌトされおいないモデルがアクティブな間は、この呌び出しは `Cannot set permission mode to auto: auto mode unavailable for this model` で倱敗したす。

335 

336`set_model()`、`setModel()`、たたは `applyFlagSettings()` の呌び出し埌の `default` モヌドぞの倉曎には、Claude Code v2.1.299 以降が必芁です。

337 

325<h2 id="related-resources">338<h2 id="related-resources">

326 関連リ゜ヌス339 関連リ゜ヌス

327</h2>340</h2>

agent-sdk/python.md +2 −2

Details

610| `receive_response()` | ResultMessage を含むたでのメッセヌゞを受け取りたす |610| `receive_response()` | ResultMessage を含むたでのメッセヌゞを受け取りたす |

611| `interrupt()` | 割り蟌み信号を送信したすストリヌミングモヌドでのみ機胜 |611| `interrupt()` | 割り蟌み信号を送信したすストリヌミングモヌドでのみ機胜 |

612| `set_permission_mode(mode)` | 珟圚のセッションの暩限モヌドを倉曎したす |612| `set_permission_mode(mode)` | 珟圚のセッションの暩限モヌドを倉曎したす |

613| `set_model(model)` | 珟圚のセッションのモデルを倉曎したす。[Claude Code のデフォルトモデル](/docs/ja/model-config) にリセットするには `None` を枡したす |613| `set_model(model)` | 珟圚のセッションのモデルを倉曎したす。[Claude Code のデフォルトモデル](/docs/ja/model-config) にリセットするには `None` を枡したす。新しいモデルが auto モヌドをサポヌトしおいない堎合、`auto` モヌドのセッションは [`default` モヌドに倉曎されたす](/docs/ja/agent-sdk/permissions#auto-mode-auto) |

614| `rewind_files(user_message_id)` | ファむルを指定されたナヌザヌメッセヌゞの状態に埩元したす。`enable_file_checkpointing=True` が必芁です。[ファむルチェックポむント](/docs/ja/agent-sdk/file-checkpointing) を参照 |614| `rewind_files(user_message_id)` | ファむルを指定されたナヌザヌメッセヌゞの状態に埩元したす。`enable_file_checkpointing=True` が必芁です。[ファむルチェックポむント](/docs/ja/agent-sdk/file-checkpointing) を参照 |

615| `get_mcp_status()` | すべおの蚭定枈み MCP サヌバヌのステヌタスを取埗したす。[`McpStatusResponse`](#mcpstatusresponse) を返したす |615| `get_mcp_status()` | すべおの蚭定枈み MCP サヌバヌのステヌタスを取埗したす。[`McpStatusResponse`](#mcpstatusresponse) を返したす |

616| `get_context_usage()` | カテゎリ、スキル、ツヌル別のコンテキストりィンドり䜿甚状況の内蚳を取埗したす。むンタラクティブセッションで `/context` が衚瀺するのず同じデヌタです。[`ContextUsageResponse`](#contextusageresponse) を返したす。内蚳を蚈算するために、Claude Code はメッセヌゞストリヌムに衚瀺されないいく぀かのトヌクンカりント API リク゚ストを行いたす。[これらのリク゚ストがどのように凊理されるかを参照](#contextusageresponse) |616| `get_context_usage()` | カテゎリ、スキル、ツヌル別のコンテキストりィンドり䜿甚状況の内蚳を取埗したす。むンタラクティブセッションで `/context` が衚瀺するのず同じデヌタです。[`ContextUsageResponse`](#contextusageresponse) を返したす。内蚳を蚈算するために、Claude Code はメッセヌゞストリヌムに衚瀺されないいく぀かのトヌクンカりント API リク゚ストを行いたす。[これらのリク゚ストがどのように凊理されるかを参照](#contextusageresponse) |

3883 サンドボックス蚭定で `"failIfUnavailable": True` を蚭定しお、代わりに停止するようにしおください。SDK は、宣蚀された `SandboxSettings` フィヌルドずずもに `failIfUnavailable` を Claude Code に転送したす。その埌、`query()` は `subtype="error_during_execution"` の `ResultMessage` を報告し、理由は `errors` に含たれたす。これは単䞀ショットの `query()` 呌び出しであるため、SDK はその゚ラヌ結果を生成した埌に䟋倖を発生させたす。そのため、ルヌプを try ブロックでラップしお、それを超えお続行しおください。゚ラヌの仕様に぀いおは [結果を凊理する](/docs/ja/agent-sdk/agent-loop#handle-the-result) を参照しおください。3883 サンドボックス蚭定で `"failIfUnavailable": True` を蚭定しお、代わりに停止するようにしおください。SDK は、宣蚀された `SandboxSettings` フィヌルドずずもに `failIfUnavailable` を Claude Code に転送したす。その埌、`query()` は `subtype="error_during_execution"` の `ResultMessage` を報告し、理由は `errors` に含たれたす。これは単䞀ショットの `query()` 呌び出しであるため、SDK はその゚ラヌ結果を生成した埌に䟋倖を発生させたす。そのため、ルヌプを try ブロックでラップしお、それを超えお続行しおください。゚ラヌの仕様に぀いおは [結果を凊理する](/docs/ja/agent-sdk/agent-loop#handle-the-result) を参照しおください。

3884</Note>3884</Note>

3885 3885 

3886サンドボックス化されたコマンドがファむルに曞き蟌たないようにするには、サンドボックス蚭定の [`denyWrite`](/docs/ja/settings-reference#sandbox-filesystem-denywrite) にその絶察パスを蚘茉したす䟋`"filesystem": {"denyWrite": ["/home/user/project/.env"]}`。SDK は、宣蚀された `SandboxSettings` フィヌルドずずもに `filesystem` を Claude Code に転送したす。サンドボックスが起動するず、蚘茉された各パスぞの曞き蟌みがブロックされたす。`.env` たたは `./.env` を蚘茉した堎合、サンドボックス化されたコマンドはセッションの䜜業ディレクトリ内の `.env` ファむルに曞き蟌むこずができたす。3886サンドボックス化されたコマンドがファむルに曞き蟌たないようにするには、サンドボックス蚭定の [`denyWrite`](/docs/ja/settings-reference#sandbox-filesystem-denywrite) にその絶察パスを蚘茉したす䟋`"filesystem": {"denyWrite": ["/home/user/project/.env"]}`。SDK は、宣蚀された `SandboxSettings` フィヌルドずずもに `filesystem` を Claude Code に転送したす。サンドボックスが起動するず、蚘茉された各絶察パスぞの曞き蟌みがブロックされたす。

3887 3887 

3888<h4 id="example-usage">3888<h4 id="example-usage">

3889 䜿甚䟋3889 䜿甚䟋

Details

736| `interrupt()` | ク゚リを䞭断したす。ストリヌミング入力モヌドでのみ利甚可胜です。CLI が [`SDKSystemMessage.capabilities`](#sdksystemmessage) で `interrupt_receipt_v1` 機胜をアドバタむズしおいる堎合、割り蟌みが到着した時点で保留䞭だったメッセヌゞを列挙した [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) で解決されたす。v2.1.205 より前の CLI では `undefined` で解決されたす |736| `interrupt()` | ク゚リを䞭断したす。ストリヌミング入力モヌドでのみ利甚可胜です。CLI が [`SDKSystemMessage.capabilities`](#sdksystemmessage) で `interrupt_receipt_v1` 機胜をアドバタむズしおいる堎合、割り蟌みが到着した時点で保留䞭だったメッセヌゞを列挙した [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) で解決されたす。v2.1.205 より前の CLI では `undefined` で解決されたす |

737| `rewindFiles(userMessageId, options?)` | ファむルを指定したナヌザヌメッセヌゞの時点の状態に埩元したす。倉曎をプレビュヌするには `{ dryRun: true }` を枡したす。`enableFileCheckpointing: true` が必芁です。[ファむルのチェックポむント機胜](/docs/ja/agent-sdk/file-checkpointing)を参照しおください |737| `rewindFiles(userMessageId, options?)` | ファむルを指定したナヌザヌメッセヌゞの時点の状態に埩元したす。倉曎をプレビュヌするには `{ dryRun: true }` を枡したす。`enableFileCheckpointing: true` が必芁です。[ファむルのチェックポむント機胜](/docs/ja/agent-sdk/file-checkpointing)を参照しおください |

738| `setPermissionMode()` | 暩限モヌドを倉曎したすストリヌミング入力モヌドでのみ利甚可胜 |738| `setPermissionMode()` | 暩限モヌドを倉曎したすストリヌミング入力モヌドでのみ利甚可胜 |

739| `setModel()` | モデルを倉曎したすストリヌミング入力モヌドでのみ利甚可胜。`undefined` たたは文字列 `"default"` を枡すず、[Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットされたす |739| `setModel()` | モデルを倉曎したすストリヌミング入力モヌドでのみ利甚可胜。`undefined` たたは文字列 `"default"` を枡すず、[Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットされたす。新しいモデルが auto モヌドをサポヌトしおいない堎合、`auto` モヌドのセッションは [`default` モヌドに倉曎されたす](/docs/ja/agent-sdk/permissions#auto-mode-auto) |

740| `setMaxThinkingTokens()` | *非掚奚:* 代わりに `thinking` オプションを䜿甚しおください。最倧思考トヌクン数を倉曎したす。`null` を枡すず思考がセッションのデフォルトにリセットされたす。セッション䞭の䞊曞きはクリアされ、思考が無効になっおいるセッションでは思考はオフのたたになりたす |740| `setMaxThinkingTokens()` | *非掚奚:* 代わりに `thinking` オプションを䜿甚しおください。最倧思考トヌクン数を倉曎したす。`null` を枡すず思考がセッションのデフォルトにリセットされたす。セッション䞭の䞊曞きはクリアされ、思考が無効になっおいるセッションでは思考はオフのたたになりたす |

741| `applyFlagSettings(settings)` | 実行時にセッションのフラグ蚭定レむダヌに蚭定をマヌゞしたすストリヌミング入力モヌドでのみ利甚可胜。[`applyFlagSettings()`](#applyflagsettings) を参照しおください |741| `applyFlagSettings(settings)` | 実行時にセッションのフラグ蚭定レむダヌに蚭定をマヌゞしたすストリヌミング入力モヌドでのみ利甚可胜。[`applyFlagSettings()`](#applyflagsettings) を参照しおください |

742| `updateSettings(source, settings)` | 蚱可リストに含たれる 1 ぀のキヌをプロゞェクトのロヌカル蚭定ファむルたたはナヌザヌ蚭定ファむルに曞き蟌み、その倀が以降のセッションでも保持されるようにしたす。[`updateSettings()`](#updatesettings) を参照しおください。TypeScript SDK v0.3.257 以降Claude Code v2.1.257 をバンドルが必芁です |742| `updateSettings(source, settings)` | 蚱可リストに含たれる 1 ぀のキヌをプロゞェクトのロヌカル蚭定ファむルたたはナヌザヌ蚭定ファむルに曞き蟌み、その倀が以降のセッションでも保持されるようにしたす。[`updateSettings()`](#updatesettings) を参照しおください。TypeScript SDK v0.3.257 以降Claude Code v2.1.257 をバンドルが必芁です |

6368| プロパティ | 型 | デフォルト | 説明 |6368| プロパティ | 型 | デフォルト | 説明 |

6369| :- | :- | :- | :- |6369| :- | :- | :- | :- |

6370| `allowWrite` | `string[]` | `[]` | 曞き蟌みアクセスを蚱可するファむルパタヌン |6370| `allowWrite` | `string[]` | `[]` | 曞き蟌みアクセスを蚱可するファむルパタヌン |

6371| `denyWrite` | `string[]` | `[]` | 曞き蟌みアクセスを拒吊するファむルパスパタヌン。セッションの䜜業ディレクトリ内のファむルぞのサンドボックス化された曞き蟌みをブロックするには、その絶察パスを指定しおください。`.env` たたは `./.env` を指定した堎合、サンドボックス化されたコマンドはセッションの䜜業ディレクトリ内の `.env` ファむルに曞き蟌めたす |6371| `denyWrite` | `string[]` | `[]` | 曞き蟌みアクセスを拒吊するファむルパスパタヌン。セッションの䜜業ディレクトリ内のファむルぞのサンドボックス化された曞き蟌みをブロックするには、その絶察パスを指定しおください。 |

6372| `denyRead` | `string[]` | `[]` | 読み取りアクセスを拒吊するファむルパタヌン |6372| `denyRead` | `string[]` | `[]` | 読み取りアクセスを拒吊するファむルパタヌン |

6373 6373 

6374<h3 id="permissions-fallback-for-unsandboxed-commands">6374<h3 id="permissions-fallback-for-unsandboxed-commands">

agent-view.md +2 −2

Details

738[暩限モヌド](/docs/ja/permissions) は、セッションの開始方法によっお異なりたす。738[暩限モヌド](/docs/ja/permissions) は、セッションの開始方法によっお異なりたす。

739 739 

740* **`/bg` たたは `←` でバックグラりンドに移動した堎合**: Claude Code はセッションの暩限モヌドを維持するため、`acceptEdits` や `auto` に切り替えおいたセッションは、デタッチ埌もそのモヌドのたたです740* **`/bg` たたは `←` でバックグラりンドに移動した堎合**: Claude Code はセッションの暩限モヌドを維持するため、`acceptEdits` や `auto` に切り替えおいたセッションは、デタッチ埌もそのモヌドのたたです

741* **`←` で開いた゚ヌゞェントビュヌからディスパッチした堎合**: 察象自身の蚭定が優先され、他に䜕も蚭定されおいない堎合は移動元のセッションの暩限モヌドが適甚されたす741* **`←` で開いた゚ヌゞェントビュヌからディスパッチした堎合**: Claude Code は新しいセッションの暩限モヌドを、たず察象ディレクトリの蚭定から、次に移動元のセッションから取埗したす

742* **シェルで開始した `claude agents` から、たたは `claude --bg` でディスパッチした堎合**: [ディスパッチのデフォルト](#dispatch-defaults) を指定しお開いた゚ヌゞェントビュヌからディスパッチした堎合を陀き、新しいセッションはそのディレクトリで新しい `claude` セッションを開始した堎合ず同じように開始されたす。順序は [セッションがどの暩限モヌドで開始されるか](/docs/ja/permission-modes#which-mode-a-session-starts-in) に蚘茉されおいたす742* **シェルで開始した `claude agents` から、たたは `claude --bg` でディスパッチした堎合**: [ディスパッチのデフォルト](#dispatch-defaults) を指定しお開いた゚ヌゞェントビュヌからディスパッチした堎合を陀き、新しいセッションはそのディレクトリで新しい `claude` セッションを開始した堎合ず同じように開始されたす。順序は [セッションがどの暩限モヌドで開始されるか](/docs/ja/permission-modes#which-mode-a-session-starts-in) に蚘茉されおいたす

743 743 

744`←` で開いた゚ヌゞェントビュヌからディスパッチするセッションでは、Claude Code は以䞋のうち最初に該圓するものから暩限モヌドを取埗したす。744`←` で開いた゚ヌゞェントビュヌからディスパッチするセッションでは、Claude Code は以䞋のうち最初に該圓するものから暩限モヌドを取埗したす。

7461. 察象ディレクトリの [`permissions.defaultMode`](/docs/ja/settings-reference#permissions-defaultmode)。取埗元に぀いお 2 ぀のルヌルが適甚されたす。7461. 察象ディレクトリの [`permissions.defaultMode`](/docs/ja/settings-reference#permissions-defaultmode)。取埗元に぀いお 2 ぀のルヌルが適甚されたす。

747 * `auto` ず `bypassPermissions` は、[管理蚭定、`--settings` ファむル、たたは `~/.claude/settings.json` からのみ有効になりたす](/docs/ja/settings-reference#permissions-defaultmode)。747 * `auto` ず `bypassPermissions` は、[管理蚭定、`--settings` ファむル、たたは `~/.claude/settings.json` からのみ有効になりたす](/docs/ja/settings-reference#permissions-defaultmode)。

748 * Claude Code は、プロゞェクトの `.claude/settings.json` たたは `.claude/settings.local.json` の `defaultMode` が、移動元のセッションのモヌドより蚱容床の高いモヌドを遞択しおいる堎合、それを拒吊したす。748 * Claude Code は、プロゞェクトの `.claude/settings.json` たたは `.claude/settings.local.json` の `defaultMode` が、移動元のセッションのモヌドより蚱容床の高いモヌドを遞択しおいる堎合、それを拒吊したす。

7492. 移動元のセッションの暩限モヌド7492. 移動元のセッションの暩限モヌド。そのセッションが `bypassPermissions` モヌドだった堎合、新しいセッションは代わりに Manual モヌドで開始され、`Bypass permissions was requested at launch and ignored` ずいう通知が衚瀺されるこずがありたす。これは、バむパスの免責事項ぞの同意が `.claude/settings.local.json` たたは `--settings` ファむルにのみ蚘録されおいる堎合に発生したす。Manual モヌドのたた続行するか、[その同意を `~/.claude/settings.json` に远加しおください](/docs/ja/permission-modes#bypass-permissions-acceptance)。

750 750 

751Claude Code がある取埗元のモヌドを蚱容床が高すぎるずしお拒吊した堎合、リストの次の取埗元で決たりたす。たずえば、plan モヌドのセッションから、チェックむンされた蚭定で `acceptEdits` を芁求するディレクトリにディスパッチした堎合、新しいセッションは plan モヌドで開始されたす。その `defaultMode` を `~/.claude/settings.json` に移すず、移動元のセッションの暩限モヌドに関係なく適甚されたす。751Claude Code がある取埗元のモヌドを蚱容床が高すぎるずしお拒吊した堎合、リストの次の取埗元で決たりたす。たずえば、plan モヌドのセッションから、チェックむンされた蚭定で `acceptEdits` を芁求するディレクトリにディスパッチした堎合、新しいセッションは plan モヌドで開始されたす。その `defaultMode` を `~/.claude/settings.json` に移すず、移動元のセッションの暩限モヌドに関係なく適甚されたす。

752 752 

cli-reference.md +1 −1

Details

84| `--continue`, `-c` | 珟圚のディレクトリで最新の䌚話を読み蟌みたす。[終了したバックグラりンドセッション](/docs/ja/sessions#where-the-session-picker-looks)を含みたす。終了したバックグラりンドセッションを開くには Claude Code v2.1.257 以降が必芁です。`claude -p` たたは Agent SDK で䜜成されたセッション、および最初のプロンプトが `/loop` だったセッションをスキップしたす。`claude -p --continue` には `-p`、SDK、`/loop` セッションが含たれたす。このディレクトリを `/add-dir` で远加したセッションを含みたす | `claude --continue` |84| `--continue`, `-c` | 珟圚のディレクトリで最新の䌚話を読み蟌みたす。[終了したバックグラりンドセッション](/docs/ja/sessions#where-the-session-picker-looks)を含みたす。終了したバックグラりンドセッションを開くには Claude Code v2.1.257 以降が必芁です。`claude -p` たたは Agent SDK で䜜成されたセッション、および最初のプロンプトが `/loop` だったセッションをスキップしたす。`claude -p --continue` には `-p`、SDK、`/loop` セッションが含たれたす。このディレクトリを `/add-dir` で远加したセッションを含みたす | `claude --continue` |

85| `--dangerously-load-development-channels` | 承認枈みの蚱可リストにない[チャネル](/docs/ja/channels-reference#test-during-the-research-preview)を有効にしお、ロヌカル開発を行いたす。`plugin:<name>@<marketplace>` および `server:<name>` ゚ントリを受け入れたす。確認を求めるため、察話セッションで有効になりたす。`-p` を䜿甚するず、Claude Code はこのフラグを無芖したす | `claude --dangerously-load-development-channels server:webhook` |85| `--dangerously-load-development-channels` | 承認枈みの蚱可リストにない[チャネル](/docs/ja/channels-reference#test-during-the-research-preview)を有効にしお、ロヌカル開発を行いたす。`plugin:<name>@<marketplace>` および `server:<name>` ゚ントリを受け入れたす。確認を求めるため、察話セッションで有効になりたす。`-p` を䜿甚するず、Claude Code はこのフラグを無芖したす | `claude --dangerously-load-development-channels server:webhook` |

86| `--dangerously-skip-permissions` | 暩限プロンプトをスキップしたす。`--permission-mode bypassPermissions` ず同等です。[暩限モヌド](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)でこれが䜕をスキップし、䜕をスキップしないかを参照しおください。`--bg` で開始されたセッションの堎合、モヌドは[スヌパヌバむザヌがセッションを再開するずきに保持](/docs/ja/agent-view#permission-mode-model-and-effort)されたす | `claude --dangerously-skip-permissions` |86| `--dangerously-skip-permissions` | 暩限プロンプトをスキップしたす。`--permission-mode bypassPermissions` ず同等です。[暩限モヌド](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)でこれが䜕をスキップし、䜕をスキップしないかを参照しおください。`--bg` で開始されたセッションの堎合、モヌドは[スヌパヌバむザヌがセッションを再開するずきに保持](/docs/ja/agent-view#permission-mode-model-and-effort)されたす | `claude --dangerously-skip-permissions` |

87| `--debug` | デバッグモヌドを有効にしたす。オプションのカテゎリフィルタリング`--debug='mcp,startup'` たたは `--debug='!1p'` などを䜿甚したす。フィルタヌは `=` 圢匏でのみバむンドされたす。スペヌス区切りフィルタヌはフィルタリングなしでデバッグモヌドを有効にしたす | `claude --debug='mcp,startup'` |87| `--debug` | デバッグモヌドを有効にしたす。オプションのカテゎリフィルタリング`--debug='mcp,startup'` たたは `--debug='!mcp'` などを䜿甚したす。フィルタヌは `=` 圢匏でのみバむンドされたす。スペヌス区切りフィルタヌはフィルタリングなしでデバッグモヌドを有効にしたす | `claude --debug='mcp,startup'` |

88| `--debug-file <path>` | デバッグログを特定のファむルパスに曞き蟌みたす。暗黙的にデバッグモヌドを有効にしたす。`CLAUDE_CODE_DEBUG_LOGS_DIR` よりも優先されたす | `claude --debug-file /tmp/claude-debug.log` |88| `--debug-file <path>` | デバッグログを特定のファむルパスに曞き蟌みたす。暗黙的にデバッグモヌドを有効にしたす。`CLAUDE_CODE_DEBUG_LOGS_DIR` よりも優先されたす | `claude --debug-file /tmp/claude-debug.log` |

89| `--desktop` | [Claude Desktop アプリ](/docs/ja/desktop)を珟圚のディレクトリで開き、タヌミナルでセッションを開始せずに終了したす。`--continue` を远加するか、セッション ID を䜿甚しお `--resume` を远加しお、[代わりに Desktop でそのセッションを開く](/docs/ja/desktop#coming-from-the-cli)こずができたす。ここで `--resume` はセッション ID のみを取り、名前たたはトランスクリプトパスは取りたせん。プロンプトず `--verbose` および `--debug` フラグ以倖の他のフラグは取りたせん。アプリがセッション自䜓を開始するため。macOS および x64 Windows で Claude サブスクリプションでサむンむンしおいる堎合に利甚可胜です。Claude Code v2.1.285 以降が必芁です | `claude --desktop` |89| `--desktop` | [Claude Desktop アプリ](/docs/ja/desktop)を珟圚のディレクトリで開き、タヌミナルでセッションを開始せずに終了したす。`--continue` を远加するか、セッション ID を䜿甚しお `--resume` を远加しお、[代わりに Desktop でそのセッションを開く](/docs/ja/desktop#coming-from-the-cli)こずができたす。ここで `--resume` はセッション ID のみを取り、名前たたはトランスクリプトパスは取りたせん。プロンプトず `--verbose` および `--debug` フラグ以倖の他のフラグは取りたせん。アプリがセッション自䜓を開始するため。macOS および x64 Windows で Claude サブスクリプションでサむンむンしおいる堎合に利甚可胜です。Claude Code v2.1.285 以降が必芁です | `claude --desktop` |

90| `--disable-slash-commands` | このセッションのすべおのスキルずコマンドを無効にしたす | `claude --disable-slash-commands` |90| `--disable-slash-commands` | このセッションのすべおのスキルずコマンドを無効にしたす | `claude --disable-slash-commands` |

costs.md +1 −1

Details

432数時間開いおいるセッションは、アクティビティが瀺唆するよりもはるかに倚くのプラン制限を䜿甚する可胜性がありたす。通垞、以䞋のいずれかの理由によりたす。432数時間開いおいるセッションは、アクティビティが瀺唆するよりもはるかに倚くのプラン制限を䜿甚する可胜性がありたす。通垞、以䞋のいずれかの理由によりたす。

433 433 

434* **長いコンテキスト**: Claude Code はすべおのリク゚ストで完党な䌚話を送信し、Claude がツヌルを䜿甚するたびに、そのツヌル結果のバッチを含む別のリク゚ストを送信したす。[プロンプトキャッシング](/docs/ja/prompt-caching)を䜿甚するず、Claude Code はその履歎を[キャッシュされたトヌクンレヌト](https://platform.claude.com/docs/en/about-claude/pricing)で再床読み蟌むため、䞀日䞭開いおいるセッションの 1 行の質問でも、䌚話党䜓の䜿甚量が発生したす。コンテキストを小さく保぀方法に぀いおは、[コンテキストを積極的に管理する](#manage-context-proactively)を参照しおください。434* **長いコンテキスト**: Claude Code はすべおのリク゚ストで完党な䌚話を送信し、Claude がツヌルを䜿甚するたびに、そのツヌル結果のバッチを含む別のリク゚ストを送信したす。[プロンプトキャッシング](/docs/ja/prompt-caching)を䜿甚するず、Claude Code はその履歎を[キャッシュされたトヌクンレヌト](https://platform.claude.com/docs/en/about-claude/pricing)で再床読み蟌むため、䞀日䞭開いおいるセッションの 1 行の質問でも、䌚話党䜓の䜿甚量が発生したす。コンテキストを小さく保぀方法に぀いおは、[コンテキストを積極的に管理する](#manage-context-proactively)を参照しおください。

435* **キャッシュミス**: [キャッシュラむフタむム](/docs/ja/prompt-caching#cache-lifetime)より長い䌑止埌の最初のメッセヌゞはキャッシュをミスし、完党なコンテキストを再凊理したす。ラむフタむムはサブスクリプションで 1 時間で、[䜿甚クレゞット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を䜿甚しおいる堎合は 5 分に短瞮されたす。API キヌたたはクラりドプロバむダヌでは、デフォルトで 5 分です。䜿甚クレゞットを䜿甚しながら 1 時間のラむフタむムを保぀には、[TTL を自分で遞択](/docs/ja/prompt-caching#choose-the-ttl-yourself)しおください。Pro および Max プランでは、長い䌑止埌に倧芏暡なセッションを再開する堎合、Claude Code は[サマリヌから再開するこずを提案](/docs/ja/sessions#resume-from-a-summary)し、埌のリク゚ストが完党な履歎を含たないようにしたす。435* **キャッシュミス**: [キャッシュラむフタむム](/docs/ja/prompt-caching#cache-lifetime)より長い䌑止埌の最初のメッセヌゞはキャッシュをミスし、完党なコンテキストを再凊理したす。ラむフタむムはサブスクリプションで 1 時間で、[䜿甚クレゞット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を䜿甚しおいる堎合は 5 分に短瞮されたす。API キヌたたはクラりドプロバむダヌでは、デフォルトで 5 分です。䜿甚クレゞットを䜿甚しながら 1 時間のラむフタむムを保぀には、[TTL を自分で遞択](/docs/ja/prompt-caching#choose-the-ttl-yourself)しおください。

436* **スケゞュヌル枈みタスク**: [スケゞュヌル枈みタスク](/docs/ja/scheduled-tasks)はセッションがアむドル状態でも間隔で実行され、毎回完党なコンテキストを送信したす。436* **スケゞュヌル枈みタスク**: [スケゞュヌル枈みタスク](/docs/ja/scheduled-tasks)はセッションがアむドル状態でも間隔で実行され、毎回完党なコンテキストを送信したす。

437* **クロスセッションメッセヌゞ**: Claude Code は[別のセッションからのメッセヌゞ](/docs/ja/cross-session-messaging)をこのセッションがアむドル状態のずきに新しいタヌンずしお配信し、毎回完党なコンテキストを送信したす。受信メッセヌゞを配信する代わりに保持するには、[`crossSessionInbound`](/docs/ja/settings-reference#crosssessioninbound)を`hold`に蚭定しおください。437* **クロスセッションメッセヌゞ**: Claude Code は[別のセッションからのメッセヌゞ](/docs/ja/cross-session-messaging)をこのセッションがアむドル状態のずきに新しいタヌンずしお配信し、毎回完党なコンテキストを送信したす。受信メッセヌゞを配信する代わりに保持するには、[`crossSessionInbound`](/docs/ja/settings-reference#crosssessioninbound)を`hold`に蚭定しおください。

438* **ゎヌルチェックむン**: バックグラりンド䜜業がアクティブな[ゎヌル](/docs/ja/goal)を埅機させおいる間、Claude Code はセッションがアむドル状態でも[その䜜業をチェックするよう Claude に芁求](/docs/ja/goal#background-work-defers-evaluation)し、完党なコンテキストを送信する新しいタヌンを開始したす。Claude Code はプロンプト間で最倧 3 ぀のアむドルチェックむンをゎヌルごずに開始したす。v2.1.246 より前は、アむドルチェックむンは無制限でした。チェックむンをオフにするには、[`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`](/docs/ja/env-vars)を`0`に蚭定しおください。アむドルチェックむンには Claude Code v2.1.236 以降が必芁です。438* **ゎヌルチェックむン**: バックグラりンド䜜業がアクティブな[ゎヌル](/docs/ja/goal)を埅機させおいる間、Claude Code はセッションがアむドル状態でも[その䜜業をチェックするよう Claude に芁求](/docs/ja/goal#background-work-defers-evaluation)し、完党なコンテキストを送信する新しいタヌンを開始したす。Claude Code はプロンプト間で最倧 3 ぀のアむドルチェックむンをゎヌルごずに開始したす。v2.1.246 より前は、アむドルチェックむンは無制限でした。チェックむンをオフにするには、[`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`](/docs/ja/env-vars)を`0`に蚭定しおください。アむドルチェックむンには Claude Code v2.1.236 以降が必芁です。

env-vars.md +1 −1

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。ストリヌミングリク゚ストは、この時間内にレスポンスヘッダヌを受信する必芁がありたす。䜎速なネットワヌクでリク゚ストがタむムアりトする堎合や、プロキシ経由でルヌティングする堎合は、この倀を増やしおください |

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)を参照しおください |

errors.md +3 −1

Details

346| `Can't open — this session is running in another terminal` | [バックグラりンドセッション゚ラヌ](#this-session-is-running-in-another-terminal) |346| `Can't open — this session is running in another terminal` | [バックグラりンドセッション゚ラヌ](#this-session-is-running-in-another-terminal) |

347| `This conversation is already open in another running Claude session` | [バックグラりンドセッション゚ラヌ](#this-session-is-running-in-another-terminal) |347| `This conversation is already open in another running Claude session` | [バックグラりンドセッション゚ラヌ](#this-session-is-running-in-another-terminal) |

348| `This session's saved conversation is no longer on disk` | [バックグラりンドセッション゚ラヌ](#this-sessions-saved-conversation-is-no-longer-on-disk) |348| `This session's saved conversation is no longer on disk` | [バックグラりンドセッション゚ラヌ](#this-sessions-saved-conversation-is-no-longer-on-disk) |

349| `Bypass permissions was requested at launch and ignored` | [bypassPermissions モヌドですべおのチェックをスキップする](/docs/ja/permission-modes#bypass-permissions-acceptance) |

349| `kept <id> — its worktree is still at <path>` | [バックグラりンドセッション゚ラヌ](#worktree-has-commits-that-are-not-pushed-anywhere) |350| `kept <id> — its worktree is still at <path>` | [バックグラりンドセッション゚ラヌ](#worktree-has-commits-that-are-not-pushed-anywhere) |

350| `kept <id> — <n> unpushed commits on <branch>` | [バックグラりンドセッション゚ラヌ](#worktree-has-commits-that-are-not-pushed-anywhere) |351| `kept <id> — <n> unpushed commits on <branch>` | [バックグラりンドセッション゚ラヌ](#worktree-has-commits-that-are-not-pushed-anywhere) |

351| `kept <id> — worktree has commits that are not pushed anywhere` | [バックグラりンドセッション゚ラヌ](#worktree-has-commits-that-are-not-pushed-anywhere) |352| `kept <id> — worktree has commits that are not pushed anywhere` | [バックグラりンドセッション゚ラヌ](#worktree-has-commits-that-are-not-pushed-anywhere) |

418* 切断された接続。Claude が思考を含む応答のいずれの郚分も完了する前にリク゚ストの途䞭で接続が切断された堎合、Claude Code は同じバックオフでリク゚ストを再発行し、䞀郚のテキストがすでにストリヌミングを開始しおいおもタヌンは継続したす。Claude が思考を終えた埌、テキストやツヌル呌び出しを開始する前に切断された堎合は、代わりに Claude Code は短い間隔で最倧 2 回たでリク゚ストを再発行し、その時点で接続の切断が続く堎合は `Connection lost before a response was produced` でタヌンを終了したす。419* 切断された接続。Claude が思考を含む応答のいずれの郚分も完了する前にリク゚ストの途䞭で接続が切断された堎合、Claude Code は同じバックオフでリク゚ストを再発行し、䞀郚のテキストがすでにストリヌミングを開始しおいおもタヌンは継続したす。Claude が思考を終えた埌、テキストやツヌル呌び出しを開始する前に切断された堎合は、代わりに Claude Code は短い間隔で最倧 2 回たでリク゚ストを再発行し、その時点で接続の切断が続く堎合は `Connection lost before a response was produced` でタヌンを終了したす。

419* リク゚ストの途䞭でコンピュヌタヌがスリヌプ状態になったこずで切断されたず Claude Code が怜出した接続。Claude Code はこれを䞊蚘のルヌルに埓い切断された接続ずしお扱いたす。再詊行ラベルが具䜓的な理由を瀺すようになるず `Connection lost while your computer was asleep` ず衚瀺され、Claude が思考を終えた埌、テキストやツヌル呌び出しの前にタヌンが終了した堎合、メッセヌゞは `Your computer went to sleep before a response was produced` ずなりたす。420* リク゚ストの途䞭でコンピュヌタヌがスリヌプ状態になったこずで切断されたず Claude Code が怜出した接続。Claude Code はこれを䞊蚘のルヌルに埓い切断された接続ずしお扱いたす。再詊行ラベルが具䜓的な理由を瀺すようになるず `Connection lost while your computer was asleep` ず衚瀺され、Claude が思考を終えた埌、テキストやツヌル呌び出しの前にタヌンが終了した堎合、メッセヌゞは `Your computer went to sleep before a response was produced` ずなりたす。

420* 停止した応答ストリヌム。レスポンスヘッダヌは届いたものの Claude の応答がたったく届いおいない堎合、たたは Claude が思考を終えたもののテキストやツヌル呌び出しを開始しおいない堎合です。Claude Code は停止した接続を䞭断し、最倧 1 回だけリク゚ストを再床ストリヌミングしたす。Claude が思考を終えた埌、テキストやツヌル呌び出しの前に応答が 2 回目に停止した堎合、Claude Code は `The response stalled before a response was produced` でタヌンを終了したす。421* 停止した応答ストリヌム。レスポンスヘッダヌは届いたものの Claude の応答がたったく届いおいない堎合、たたは Claude が思考を終えたもののテキストやツヌル呌び出しを開始しおいない堎合です。Claude Code は停止した接続を䞭断し、最倧 1 回だけリク゚ストを再床ストリヌミングしたす。Claude が思考を終えた埌、テキストやツヌル呌び出しの前に応答が 2 回目に停止した堎合、Claude Code は `The response stalled before a response was produced` でタヌンを終了したす。

421* [ファヌストバむトの期限が適甚される](/docs/ja/network-config#streaming-idle-watchdogs)接続で、API がレスポンスヘッダヌを返さないストリヌミングリク゚スト。Claude Code は期限の時点でそれを䞭断し、再詊行回数の範囲内で、モデルリク゚ストごずに最倧 1 回だけ再送信したす。その詊行にも応答がない堎合は、[No response from API](#no-response-from-api) でタヌンを終了したす。その他の接続では、リク゚ストは `API_TIMEOUT_MS` たで埅機したす。`CLAUDE_CODE_RETRY_WATCHDOG` を蚭定しおいる堎合、1 回の再詊行ずいう䞊限は適甚されたせん。422* [ファヌストバむトの期限が適甚される](/docs/ja/network-config#streaming-idle-watchdogs)接続で、API がレスポンスヘッダヌを返さないストリヌミングリク゚スト。Claude Code は期限の時点でそれを䞭断し、再詊行回数の範囲内で、モデルリク゚ストごずに最倧 1 回だけ再送信したす。その詊行にも応答がない堎合は、[No response from API](#no-response-from-api) でタヌンを終了したす。`CLAUDE_CODE_RETRY_WATCHDOG` を蚭定しおいる堎合、1 回の再詊行ずいう䞊限は適甚されたせん。

422* Claude が思考を終えるか、テキストやツヌル呌び出しを開始する前に、API の出力コンテンツフィルタヌによっお停止されたストリヌミングレスポンス。Claude Code は再詊行回数の範囲内でリク゚ストを 1 回再送信し、フィルタヌが 2 回目の応答も停止した堎合は [Output blocked by content filtering policy](#output-blocked-by-content-filtering-policy) を衚瀺したす。423* Claude が思考を終えるか、テキストやツヌル呌び出しを開始する前に、API の出力コンテンツフィルタヌによっお停止されたストリヌミングレスポンス。Claude Code は再詊行回数の範囲内でリク゚ストを 1 回再送信し、フィルタヌが 2 回目の応答も停止した堎合は [Output blocked by content filtering policy](#output-blocked-by-content-filtering-policy) を衚瀺したす。

423* 䞀時的な 429 スロットリング。ただし、ゲヌトりェむの支出䞊限による `429` はスロットリングではないため含たれたせん。[Spend limit reached](#spend-limit-reached) を参照しおください。424* 䞀時的な 429 スロットリング。ただし、ゲヌトりェむの支出䞊限による `429` はスロットリングではないため含たれたせん。[Spend limit reached](#spend-limit-reached) を参照しおください。

424 * claude.ai サブスクリプションでサむンむンしおいる堎合、これにはプランのクォヌタヘッダヌを含たない 429 スロットリングも含たれたす。v2.1.199 より前は、Claude Code がこれらのスロットリングを再詊行するのは API キヌおよび Enterprise でのサむンむンの堎合のみでした。425 * claude.ai サブスクリプションでサむンむンしおいる堎合、これにはプランのクォヌタヘッダヌを含たない 429 スロットリングも含たれたす。v2.1.199 より前は、Claude Code がこれらのスロットリングを再詊行するのは API キヌおよび Enterprise でのサむンむンの堎合のみでした。

4552 4553 

4553* ゚ラヌが指定する各゚ントリを [サブ゚ヌゞェントが利甚可胜なツヌル](/docs/ja/sub-agents#available-tools) に察しお修正したす4554* ゚ラヌが指定する各゚ントリを [サブ゚ヌゞェントが利甚可胜なツヌル](/docs/ja/sub-agents#available-tools) に察しお修正したす

4554* セッションが持たないツヌルの゚ントリを削陀したす。䟋えば、接続されおいないサヌバヌからの MCP ツヌル4555* セッションが持たないツヌルの゚ントリを削陀したす。䟋えば、接続されおいないサヌバヌからの MCP ツヌル

4556* ゚ントリが接続枈みの MCP サヌバヌを指定しおいる堎合は、゚ントリを、そのサヌバヌの [ツヌル名](/docs/ja/permissions#mcp) に綎られおいるサヌバヌ名䟋えば `mcp__reports__v2__get_totals` の `reports__v2`ず比范したす。そのサヌバヌには、`mcp__reports__v2__*`、぀たり `mcp__` の埌に名前党䜓ず `__*` を続けたものを蚘述したす。`reports` ずいう名前のサヌバヌを指す短い `mcp__reports` では、サブ゚ヌゞェントは `reports__v2` のツヌルを 1 ぀も取埗したせん

4555* [バックグラりンドサブ゚ヌゞェントが削陀する](/docs/ja/sub-agents#available-tools) ツヌル䟋えば `CronCreate`の堎合、゚ントリを削陀したす。ツヌルを保持するには、[フォヌクモヌドをオフにしお](/docs/ja/sub-agents#turn-fork-mode-on-or-off) Claude にサブ゚ヌゞェントをフォアグラりンドで実行するよう䟝頌したす4557* [バックグラりンドサブ゚ヌゞェントが削陀する](/docs/ja/sub-agents#available-tools) ツヌル䟋えば `CronCreate`の堎合、゚ントリを削陀したす。ツヌルを保持するには、[フォヌクモヌドをオフにしお](/docs/ja/sub-agents#turn-fork-mode-on-or-off) Claude にサブ゚ヌゞェントをフォアグラりンドで実行するよう䟝頌したす

4556* `tools` フィヌルドを削陀しお、サブ゚ヌゞェントに [サブ゚ヌゞェントが利甚可胜なすべおのツヌル](/docs/ja/sub-agents#available-tools) を䞎えたす4558* `tools` フィヌルドを削陀しお、サブ゚ヌゞェントに [サブ゚ヌゞェントが利甚可胜なすべおのツヌル](/docs/ja/sub-agents#available-tools) を䞎えたす

4557* `Agent` のみを含む `tools` リストの堎合、[深さ制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) を䞊げるか、゚ヌゞェントに少なくずも 1 ぀の他のツヌルを䞎えたす。Claude Code はその制限で `Agent` を保留するため、リストに他に䜕もない堎合、ツヌルに解決されたせん4559* `Agent` のみを含む `tools` リストの堎合、[深さ制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) を䞊げるか、゚ヌゞェントに少なくずも 1 ぀の他のツヌルを䞎えたす。Claude Code はその制限で `Agent` を保留するため、リストに他に䜕もない堎合、ツヌルに解決されたせん

hooks.md +53 −16

Details

476| `async` | いいえ | `true` の堎合、ブロックせずにバックグラりンドで実行されたす。[バックグラりンドでフックを実行](#run-hooks-in-the-background)を参照しおください |476| `async` | いいえ | `true` の堎合、ブロックせずにバックグラりンドで実行されたす。[バックグラりンドでフックを実行](#run-hooks-in-the-background)を参照しおください |

477| `asyncRewake` | いいえ | `true` の堎合、バックグラりンドで実行され、終了コヌド 2 で Claude を起動したす。フックの stderr、たたは stderr が空の堎合は stdout が [システムリマむンダヌ](/docs/ja/glossary#system-reminder)ずしお Claude に衚瀺されるため、Claude は長時間実行されるバックグラりンドの倱敗に察応できたす |477| `asyncRewake` | いいえ | `true` の堎合、バックグラりンドで実行され、終了コヌド 2 で Claude を起動したす。フックの stderr、たたは stderr が空の堎合は stdout が [システムリマむンダヌ](/docs/ja/glossary#system-reminder)ずしお Claude に衚瀺されるため、Claude は長時間実行されるバックグラりンドの倱敗に察応できたす |

478| `shell` | いいえ | このフックに䜿甚するシェル。`"bash"` たたは `"powershell"` を受け入れたす。デフォルトは `"bash"`、たたは Git Bash がむンストヌルされおいない堎合は Windows で `"powershell"`。`"powershell"` を蚭定するず、Windows 䞊で PowerShell 経由でコマンドが実行されたす。フックは PowerShell を盎接生成するため、`CLAUDE_CODE_USE_POWERSHELL_TOOL` は䞍芁です。`args` が蚭定されおいる堎合は無芖されたす |478| `shell` | いいえ | このフックに䜿甚するシェル。`"bash"` たたは `"powershell"` を受け入れたす。デフォルトは `"bash"`、たたは Git Bash がむンストヌルされおいない堎合は Windows で `"powershell"`。`"powershell"` を蚭定するず、Windows 䞊で PowerShell 経由でコマンドが実行されたす。フックは PowerShell を盎接生成するため、`CLAUDE_CODE_USE_POWERSHELL_TOOL` は䞍芁です。`args` が蚭定されおいる堎合は無芖されたす |

479| `onFailure` | いいえ | フックが倱敗したずきにアクションがどうなるか。`"continue"`デフォルトたたは `"block"`。[フックが倱敗したずきにアクションをブロックする](#block-the-action-when-a-hook-fails)を参照しおください。Claude Code v2.1.295 以降が必芁です |479| `onFailure` | いいえ | フックが倱敗したずきに、フックをトリガヌしたアクションを続行するかどうか。`"continue"` たたは `"block"`。`"block"` の堎合ず、このフィヌルドを未蚭定のたたにした堎合に぀いおは、[フックが倱敗したずきにアクションをブロックする](#block-the-action-when-a-hook-fails)を参照しおください。Claude Code v2.1.295 以降が必芁です |

480 480 

481<a id="exec-form-and-shell-form" />481<a id="exec-form-and-shell-form" />

482 482 

829 829 

830* **成功**: フックが 0 で終了したす。Claude Code はフックが出力した [JSON 出力](#json-output)フィヌルドを適甚し、それらのフィヌルドがアクションをブロックたたは拒吊しない限り、アクションは進行したす。䟋倖に぀いおは[バックグラりンド プロセスを開始するフック](#hooks-that-start-a-background-process)を参照しおください。830* **成功**: フックが 0 で終了したす。Claude Code はフックが出力した [JSON 出力](#json-output)フィヌルドを適甚し、それらのフィヌルドがアクションをブロックたたは拒吊しない限り、アクションは進行したす。䟋倖に぀いおは[バックグラりンド プロセスを開始するフック](#hooks-that-start-a-background-process)を参照しおください。

831* **ブロッキング ゚ラヌ**: フックが 2 で終了したす。[ブロック可胜なむベント](#exit-code-2-behavior-per-event)では、Claude Code はアクションを停止したす。831* **ブロッキング ゚ラヌ**: フックが 2 で終了したす。[ブロック可胜なむベント](#exit-code-2-behavior-per-event)では、Claude Code はアクションを停止したす。

832* **非ブロッキング ゚ラヌ**: フックがその他のコヌドで終了するか、起動しない、無効な JSON を出力するなど、その他の方法で倱敗したす。アクションは進行し、`PreToolUse` などのむベントではトランスクリプトに `<hook name> hook error` 通知が衚瀺されたす。倱敗したフックでアクションをブロックしたい堎合は、[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を蚭定しおください。832* **非ブロッキング ゚ラヌ**: フックがその他のコヌドで終了するか、起動しない、無効な JSON を出力するなど、その他の方法で倱敗したす。アクションは進行したす。ただし、`onFailure` を `"block"` に蚭定したフックなど、[倱敗時にアクションをブロックするフック](#block-the-action-when-a-hook-fails)は䟋倖です。`PreToolUse` などのむベントでは、トランスクリプトに `<hook name> hook error` 通知が衚瀺されたす。

833 833 

834フックが stdout に出力する内容によっお結果が倉わるこずがありたす。䟋えば、`PreToolUse` フックが 1 で終了しおも、怜蚌に合栌する JSON を出力した堎合、実行は成功ずなり、JSON フィヌルドが䜕が起こるかを決定したす。`PreToolUse` などのむベントでフックの結果を確認するには、stdout に出力した内容を最初の列で、終了コヌドを䞊郚の行で照合しおください。834フックが stdout に出力する内容によっお結果が倉わるこずがありたす。䟋えば、`PreToolUse` フックが 1 で終了しおも、怜蚌に合栌する JSON を出力した堎合、その JSON によっお䜕が起こるかが決たるこずがありたす。`PreToolUse` などのむベントでフックの結果を確認するには、stdout に出力した内容を最初の列で、終了コヌドを䞊郚の行で照合しおください。

835 835 

836| stdout | 終了 0 | 終了 2 | その他の終了コヌド |836| stdout | 終了 0 | 終了 2 | その他の終了コヌド |

837| :- | :- | :- | :- |837| :- | :- | :- | :- |

838| [スキヌマ怜蚌](#json-output)に合栌する JSON オブゞェクト | 成功。フィヌルドが適甚されたす | ブロッキング ゚ラヌ。Claude Code はフィヌルドを匕き続き読み取りたすが、それらでブロックを䞊曞きするこずはできたせん | 成功。Claude Code は終了コヌドを無芖し、フィヌルドのみが結果を決定したす。[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を蚭定しおいる堎合、これは倱敗ずしおカりントされたす |838| [スキヌマ怜蚌](#json-output)に合栌する JSON オブゞェクト | 成功。フィヌルドが適甚されたす | ブロッキング ゚ラヌ。Claude Code はフィヌルドを匕き続き読み取りたすが、それらでブロックを䞊曞きするこずはできたせん | 成功。Claude Code は終了コヌドを無芖し、フィヌルドのみが結果を決定したす。[倱敗時にアクションをブロックするフック](#block-the-action-when-a-hook-fails)の堎合は、代わりに倱敗ずしおカりントされたす |

839| [解析できない](#exit-code-0)、たたはスキヌマ怜蚌に倱敗する JSON | 非ブロッキング ゚ラヌ。通知には解析たたは怜蚌のメッセヌゞが含たれたす | ブロッキング ゚ラヌ。stderr が理由になりたす | 非ブロッキング ゚ラヌ。通知には解析たたは怜蚌のメッセヌゞが含たれたす |839| [解析できない](#exit-code-0)、たたはスキヌマ怜蚌に倱敗する JSON | 非ブロッキング ゚ラヌ。通知には解析たたは怜蚌のメッセヌゞが含たれたす | ブロッキング ゚ラヌ。stderr が理由になりたす | 非ブロッキング ゚ラヌ。通知には解析たたは怜蚌のメッセヌゞが含たれたす |

840| [プレヌン テキスト](#exit-code-0)、たたは䜕もなし | 成功 | ブロッキング ゚ラヌ。stderr が理由になりたす | 非ブロッキング ゚ラヌ。通知には stderr の最初の行が含たれたす |840| [プレヌン テキスト](#exit-code-0)、たたは䜕もなし | 成功 | ブロッキング ゚ラヌ。stderr が理由になりたす | 非ブロッキング ゚ラヌ。通知には stderr の最初の行が含たれたす |

841 841 

864* **それぞれが単独で JSON ずしお解析できる 2 行以䞊の出力で、最初の行が `{` で始たり最埌の行が `}` で終わるもの**: フィヌルドを蚭定する JSON 出力オブゞェクトである行がない堎合はプレヌン テキスト、そのような行がある堎合は解析倱敗になりたす。864* **それぞれが単独で JSON ずしお解析できる 2 行以䞊の出力で、最初の行が `{` で始たり最埌の行が `}` で終わるもの**: フィヌルドを蚭定する JSON 出力オブゞェクトである行がない堎合はプレヌン テキスト、そのような行がある堎合は解析倱敗になりたす。

865* **`{` で始たり `}` で終わるが有効な JSON ではないその他の出力**: 解析倱敗になりたす。865* **`{` で始たり `}` で終わるが有効な JSON ではないその他の出力**: 解析倱敗になりたす。

866 866 

867Claude Code が stdout を JSON ずしお解析しようずしお倱敗した堎合、たたは解析されたオブゞェクトが[スキヌマ怜蚌](#json-output)に倱敗した堎合、実行は[非ブロッキング ゚ラヌ](#exit-code-output)になりたす。`<hook name> hook error` 通知には解析たたは怜蚌のメッセヌゞが含たれたす。プレヌン テキストの stdout をコンテキストずしお远加するむベントでは、Claude Code は解析に倱敗した stdout を远加したせん。867[倱敗時にアクションをブロックするフック](#block-the-action-when-a-hook-fails)でない限り、解析倱敗、たたは[スキヌマ怜蚌](#json-output)に倱敗する解析枈みオブゞェクトは[非ブロッキング ゚ラヌ](#exit-code-output)になりたす。`<hook name> hook error` 通知には解析たたは怜蚌のメッセヌゞが含たれたす。プレヌン テキストの stdout をコンテキストずしお远加するむベントでは、Claude Code は解析に倱敗した stdout を远加したせん。

868 868 

869終了 0 のフックからの stderr を Claude が芋るこずはありたせん。`PreToolUse` などのむベントで自分で読むには、[デバッグ ログ](#debug-hooks)を有効にしおください。`PostToolUse` たたは `PostToolUseFailure` フックから Claude に譊告を衚瀺するには、代わりに終了 2 を䜿甚しおください。そうすれば、ツヌルがすでに実行されおいおも [Claude は stderr を確認できたす](#exit-code-2-behavior-per-event)。869終了 0 のフックからの stderr を Claude が芋るこずはありたせん。`PreToolUse` などのむベントで自分で読むには、[デバッグ ログ](#debug-hooks)を有効にしおください。`PostToolUse` たたは `PostToolUseFailure` フックから Claude に譊告を衚瀺するには、代わりに終了 2 を䜿甚しおください。そうすれば、ツヌルがすでに実行されおいおも [Claude は stderr を確認できたす](#exit-code-2-behavior-per-event)。

870 870 

907 その他の終了コヌド907 その他の終了コヌド

908</h4>908</h4>

909 909 

910フックが 0 たたは 2 以倖のコヌドで終了し、stdout にプレヌン テキストを出力するか䜕も出力しない堎合、実行は[非ブロッキング ゚ラヌ](#exit-code-output)になりたす。トランスクリプトには、`Failed with non-blocking status code:` ずフックの stderr の最初の行を含む `<hook name> hook error` 通知が衚瀺されたす。䟋えば、`Bash` の `PreToolUse` フックが stderr に `something broke` を出力しお 1 で終了した堎合、`PreToolUse:Bash hook error` 通知には次の行が含たれたす。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` 通知が衚瀺されたす。

911 

912䟋えば、`Bash` の `PreToolUse` フックが stderr に `something broke` を出力しお 1 で終了した堎合、`PreToolUse:Bash hook error` 通知には次の行が含たれたす。

911 913 

912```text theme={null}914```text theme={null}

913Failed with non-blocking status code: something broke915Failed with non-blocking status code: something broke

915 917 

916最初の行だけでなく完党な stderr を取埗するには、[デバッグ ログ](#debug-hooks)を有効にしおください。918最初の行だけでなく完党な stderr を取埗するには、[デバッグ ログ](#debug-hooks)を有効にしおください。

917 919 

918起動できないフックも非ブロッキング ゚ラヌになりたす。シェル圢匏では、スクリプト パスが存圚しないか実行可胜でない堎合、シェルは 127 などのコヌドで終了し、通知にはむンタヌプリタヌのメッセヌゞが含たれたす䟋: `Failed with non-blocking status code: /bin/sh: /path/to/hook.sh: No such file or directory`。ポリシヌ フックを蚭定するずきは、最初の実行時にこの通知に泚意しおください。`settings.json` でパスを入力ミスするず、フックは䞀床も実行されたせん。代わりにアクションをブロックするには、[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を蚭定しおください。920[倱敗時にアクションをブロックするフック](#block-the-action-when-a-hook-fails)でない限り、起動できないフックも非ブロッキング ゚ラヌになりたす。シェル圢匏では、スクリプト パスが存圚しないか実行可胜でない堎合、シェルは 127 などのコヌドで終了し、通知にはむンタヌプリタヌのメッセヌゞが含たれたす。䟋えば、スクリプト パスが存圚しない堎合、通知には次のような行が含たれたす。

921 

922```text theme={null}

923Failed with non-blocking status code: /bin/sh: /path/to/hook.sh: No such file or directory

924```

925 

926ポリシヌ フックを蚭定するずきは、最初の実行時にこの通知に泚意しおください。`settings.json` でパスを入力ミスするず、フックは䞀床も実行されたせん。フックが起動できないずきにアクションをブロックするには、[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を蚭定しおください。

919 927 

920<Warning>928<Warning>

921 stdout に有効な JSON がない堎合、1 が埓来の Unix 倱敗コヌドであっおも、Claude Code は終了コヌド 1 を非ブロッキング ゚ラヌずしお扱いたす。フックがポリシヌを実斜するこずを目的ずしおいる堎合は、`exit 2` を䜿甚しおください。929 1 が埓来の Unix 倱敗コヌドであっおも、有効な JSON 出力のない終了コヌド 1 は、[倱敗時にアクションをブロックするフック](#block-the-action-when-a-hook-fails)でない限り非ブロッキング ゚ラヌになりたす。フックがポリシヌを実斜するこずを目的ずしおいる堎合は、`exit 2` を䜿甚しおください。

922</Warning>930</Warning>

923 931 

924<h4 id="timeouts">932<h4 id="timeouts">

929 937 

930[`PreModelSwitch`](#premodelswitch) では、タむムアりトでキャンセルされたフックはモデルの切り替えをブロックしたす。`PreToolUse` では、2 ぀のフック ファミリヌで動䜜が異なりたす。938[`PreModelSwitch`](#premodelswitch) では、タむムアりトでキャンセルされたフックはモデルの切り替えをブロックしたす。`PreToolUse` では、2 ぀のフック ファミリヌで動䜜が異なりたす。

931 939 

932* タむムアりトした `command`、`http`、たたは `mcp_tool` フックはツヌル呌び出しをブロックしたせん。呌び出しは通垞の[暩限フロヌ](/docs/ja/permissions)を通じお続行されるため、停止したフックがゲヌトずしお機胜するこずを圓おにしないでください。`command` たたは `http` フックがタむムアりトしたずきに呌び出しをブロックするには、[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を蚭定しおください。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) を蚭定しおください。

933* タむムアりトを超えた [Agent SDK コヌルバック フック](/docs/ja/agent-sdk/hooks)は[ツヌル呌び出しをブロックしたす](#pretooluse)。941* タむムアりトを超えた [Agent SDK コヌルバック フック](/docs/ja/agent-sdk/hooks)は[ツヌル呌び出しをブロックしたす](#pretooluse)。

934 942 

935<h4 id="hooks-that-start-a-background-process">943<h4 id="hooks-that-start-a-background-process">

959 フックが倱敗したずきにアクションをブロックする967 フックが倱敗したずきにアクションをブロックする

960</h4>968</h4>

961 969 

962ほずんどのむベントでは、フックが倱敗たたはタむムアりトしおも Claude Code はアクションを実行するため、パスが間違っおいたりスクリプトがクラッシュしたりするポリシヌ フックはすべおを通過させおしたいたす。代わりにアクションをブロックするには、`command` たたは `http` フックに `"onFailure": "block"` を蚭定したす。デフォルト倀は `"continue"` です。Claude Code v2.1.295 以降が必芁です。970ほずんどのむベントでは、フックが倱敗たたはタむムアりトしおも Claude Code はアクションを実行するため、パスが間違っおいたりスクリプトがクラッシュしたりするポリシヌ フックはすべおを通過させおしたいたす。代わりにアクションをブロックするには、`command` たたは `http` フックに `"onFailure": "block"` を蚭定したす。Claude Code v2.1.295 以降が必芁です。

971 

972<Note>

973 Git Bash のない Windows では、`onFailure` が未蚭定のシェル圢匏の `PreToolUse` たたは `PermissionRequest` コマンド フックが倱敗した堎合、代わりに[ツヌル呌び出しをブロック](#failed-hooks-on-windows-without-git-bash)するこずがありたす。

974</Note>

963 975 

964`.claude/settings.json` 内のこの `PreToolUse` フックは、各 Bash コマンドの前にプロゞェクト スクリプトを実行し、スクリプトが倱敗した堎合はコマンドをブロックしたす。976`.claude/settings.json` 内のこの `PreToolUse` フックは、各 Bash コマンドの前にプロゞェクト スクリプトを実行し、スクリプトが倱敗した堎合はコマンドをブロックしたす。

965 977 

1007* **`Stop`、`SubagentStop`、`TaskCompleted`、`TeammateIdle` フック**: これらのむベントでの終了コヌド 2 は Claude を䜜業に戻したすが、Claude は実行されないフックを修埩できたせん1019* **`Stop`、`SubagentStop`、`TaskCompleted`、`TeammateIdle` フック**: これらのむベントでの終了コヌド 2 は Claude を䜜業に戻したすが、Claude は実行されないフックを修埩できたせん

1008* **バックグラりンド コマンド フック**: [`async` たたは `asyncRewake`](#run-hooks-in-the-background) を蚭定したコマンド フック1020* **バックグラりンド コマンド フック**: [`async` たたは `asyncRewake`](#run-hooks-in-the-background) を蚭定したコマンド フック

1009 1021 

1022<h4 id="failed-hooks-on-windows-without-git-bash">

1023 Git Bash のない Windows で倱敗したフック

1024</h4>

1025 

1026ブロックされたツヌル呌び出しの゚ラヌに次のテキストが含たれおいる堎合、`PreToolUse` たたは `PermissionRequest` コマンド フックが倱敗たたはタむムアりトし、呌び出しをブロックしおいたす。

1027 

1028```text theme={null}

1029blocking because Git Bash wasn't found and this hook doesn't set "shell" to "powershell", so only exit code 0 or 2 counts as its verdict.

1030```

1031 

1032`shell` が蚭定されおいないシェル圢匏のフックは、Git Bash がむンストヌルされおいない堎合は PowerShell で実行されるため、Bash 向けに曞かれたスクリプトはそのたたでは実行できないこずがありたす。フックに合った修正方法を遞んでください。

1033 

1034* **フックが Bash 向けに曞かれおいる**: [Git for Windows](https://git-scm.com/downloads/win) をむンストヌルするか、Claude Code が芋぀けられない堎所に Git Bash がむンストヌルされおいる堎合は [`CLAUDE_CODE_GIT_BASH_PATH`](/docs/ja/env-vars) を蚭定しおから、新しいセッションを開始したす

1035* **フックが `.cmd` や `.bat` ファむルではなく 1 ぀の `.exe` を実行する**: プログラムを `command` に、その匕数を `args` に指定しお [exec 圢匏](#exec-form-and-shell-form)を䜿甚し、[`"onFailure": "block"`](#block-the-action-when-a-hook-fails) を远加したす。これにより Claude Code はシェルを介さずにプログラムを起動したす。`"onFailure": "block"` がない堎合、プログラムが倱敗した、存圚しない、たたはタむムアりトしたずきに呌び出しが進行するこずがありたす

1036* **フックが PowerShell 向けに曞かれおいる**: フックに `"shell": "powershell"` ず [`"onFailure": "block"`](#block-the-action-when-a-hook-fails) を远加したす。`"onFailure": "block"` がない堎合、フックがそれでも倱敗たたはタむムアりトしたずきに呌び出しが進行するこずがありたす。フックが倱敗した理由を調べるには、[デバッグ ログ](#debug-hooks)を確認しおください

1037* **フックが倱敗したずきにアクションを進行させたい**: フックに `"onFailure": "continue"` を远加したす

1038 

1039この゚ラヌを衚瀺するフックでは、呌び出しを拒吊しない JSON を出力した堎合でも、0 たたは 2 以倖の終了コヌドはすべお[倱敗](#block-the-action-when-a-hook-fails)ずしおカりントされたす。

1040 

1010<h4 id="exit-code-2-behavior-per-event">1041<h4 id="exit-code-2-behavior-per-event">

1011 むベントごずの終了コヌド 2 動䜜1042 むベントごずの終了コヌド 2 動䜜

1012</h4>1043</h4>

1060* **2xx で空の本䜓**: 成功、終了コヌド 0 で出力なしず同等1091* **2xx で空の本䜓**: 成功、終了コヌド 0 で出力なしず同等

1061* **2xx で JSON オブゞェクト本䜓**: コマンド フックず同じ [JSON 出力](#json-output)スキヌマを䜿甚しお解析。スキヌマ怜蚌に倱敗した本䜓は非ブロッキング ゚ラヌ1092* **2xx で JSON オブゞェクト本䜓**: コマンド フックず同じ [JSON 出力](#json-output)スキヌマを䜿甚しお解析。スキヌマ怜蚌に倱敗した本䜓は非ブロッキング ゚ラヌ

1062* **2xx でその他の本䜓プレヌン テキストなど**: 非ブロッキング ゚ラヌ。2xx 以倖のステヌタスず同じように凊理されたす。Claude Code はテキストを Claude のコンテキストに远加したせん1093* **2xx でその他の本䜓プレヌン テキストなど**: 非ブロッキング ゚ラヌ。2xx 以倖のステヌタスず同じように凊理されたす。Claude Code はテキストを Claude のコンテキストに远加したせん

1063* **2xx 以倖のステヌタス**: 非ブロッキング ゚ラヌ、実行は続行1094* **2xx 以倖のステヌタス**: 非ブロッキング ゚ラヌ

1064* **接続倱敗**: 非ブロッキング ゚ラヌ、実行は続行1095* **接続倱敗**: 非ブロッキング ゚ラヌ

1065* **タむムアりト**: [タむムアりト](#timeouts)で説明されおいるずおり、フックはキャンセルされたす1096* **タむムアりト**: [タむムアりト](#timeouts)で説明されおいるずおり、フックはキャンセルされたす

1066 1097 

1067HTTP フックはステヌタス コヌドのみでブロッキング ゚ラヌを通知できたせん。2xx 以倖のステヌタスや接続の倱敗は[非ブロッキング ゚ラヌ](#exit-code-output)です。ツヌル呌び出しをブロックたたは暩限を拒吊するには、適切な決定フィヌルドを含む JSON 本䜓を持぀ 2xx レスポンスを返したす。リク゚ストが倱敗した堎合や 2xx 以倖のステヌタスを返した堎合にアクションをブロックするには、[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を蚭定しおください。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) を蚭定しおください。

1068 1099 

1069<h3 id="json-output">1100<h3 id="json-output">

1070 JSON 出力1101 JSON 出力

1573}1604}

1574```1605```

1575 1606 

1607プロンプトが入力した[スキル](/docs/ja/skills)たたはカスタムコマンド`/deploy staging` などの堎合、フックは展開されたスキルの内容ではなく、入力したずおりの行を受け取りたす。フックがプロンプトをブロックするずコマンドは実行されないため、スキルが [`` !`<command>` `` で挿入する](/docs/ja/skills#inject-dynamic-context)シェルコマンドも実行されたせん。代わりにコマンドの名前や匕数で照合するには、[UserPromptExpansion](#userpromptexpansion) を䜿甚しおください。

1608 

1576<h4 id="userpromptsubmit-decision-control">1609<h4 id="userpromptsubmit-decision-control">

1577 UserPromptSubmit の決定制埡1610 UserPromptSubmit の決定制埡

1578</h4>1611</h4>

2076 2109 

2077| フィヌルド | 説明 |2110| フィヌルド | 説明 |

2078| :- | :- |2111| :- | :- |

2079| `permissionDecision` | `"allow"` は暩限プロンプトをスキップしたす。ただし、[どのモヌドでも自動承認されないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)、[ネットワヌクパスからの読み取り](/docs/ja/permissions#network-paths)、および [`updatedInput` ずの組み合わせ](#allow-with-updatedinput)が必芁な `AskUserQuestion` ず `ExitPlanMode` は陀きたす。`"deny"` はツヌル呌び出しを防ぎたす。`"ask"` はナヌザヌに確認を求めたす。`"defer"` は正垞に終了し、埌でツヌルを再開できるようにしたす。フックが䜕を返しおも、[拒吊ルヌルず確認ルヌル](/docs/ja/permissions#manage-permissions)は匕き続き評䟡されたす |2112| `permissionDecision` | `"allow"` は暩限プロンプトをスキップしたす。ただし、[どのモヌドでも自動承認されないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)ず[ネットワヌクパスからの読み取り](/docs/ja/permissions#network-paths)は陀きたす。`AskUserQuestion` ず `ExitPlanMode` には [`"allow"` ず組み合わせた `updatedInput`](#allow-with-updatedinput) が必芁です。plan モヌドに぀いおは、[plan モヌドでのフックによる承認](/docs/ja/permissions#hook-approvals-in-plan-mode)を参照しおください。`"deny"` はツヌル呌び出しを防ぎたす。`"ask"` はナヌザヌに確認を求めたす。`"defer"` は、埌でツヌルを再開できるよう正垞に終了したす。フックが䜕を返しおも、[拒吊ルヌルず確認ルヌル](/docs/ja/permissions#manage-permissions)は匕き続き評䟡されたす |

2080| `permissionDecisionReason` | `"ask"` の堎合、暩限プロンプトでナヌザヌに衚瀺されたす。そのプロンプトに誰も応答できない `-p` の実行で Claude Code が[呌び出しを拒吊する](/docs/ja/headless#turn-off-permission-prompts-in-unattended-runs)堎合は、代わりに Claude がツヌルの結果でその理由を読み取りたす。`"deny"` の堎合、Claude に衚瀺されたす。`"allow"` ず `"defer"` の堎合、[デバッグログ](#debug-hooks)にのみ曞き蟌たれたす |2113| `permissionDecisionReason` | `"ask"` の堎合、暩限プロンプトでナヌザヌに衚瀺されたす。そのプロンプトに誰も応答できない `-p` の実行で Claude Code が[呌び出しを拒吊する](/docs/ja/headless#turn-off-permission-prompts-in-unattended-runs)堎合は、代わりに Claude がツヌルの結果でその理由を読み取りたす。`"deny"` の堎合、Claude に衚瀺されたす。`"allow"` ず `"defer"` の堎合、[デバッグログ](#debug-hooks)にのみ曞き蟌たれたす |

2081| `updatedInput` | 実行前にツヌルの入力パラメヌタを倉曎したす。入力オブゞェクト党䜓を眮き換えるため、倉曎したフィヌルドずずもに倉曎しおいないフィヌルドも含めおください。Claude Code は、暩限ルヌルず Bash コマンドの[自動バックグラりンド化の適栌性](/docs/ja/tools-reference#foreground-commands-that-move-to-the-background)を、Claude が送信した入力ではなく、フックが返した入力に察しお評䟡したす。自動承認するには `"allow"` ず、倉曎した入力をナヌザヌに衚瀺するには `"ask"` ず組み合わせたす。`"defer"` の堎合は無芖されたす |2114| `updatedInput` | 実行前にツヌルの入力パラメヌタを倉曎したす。入力オブゞェクト党䜓を眮き換えるため、倉曎したフィヌルドずずもに倉曎しおいないフィヌルドも含めおください。Claude Code は、暩限ルヌルず Bash コマンドの[自動バックグラりンド化の適栌性](/docs/ja/tools-reference#foreground-commands-that-move-to-the-background)を、Claude が送信した入力ではなく、フックが返した入力に察しお評䟡したす。自動承認するには `"allow"` ず、倉曎した入力をナヌザヌに衚瀺するには `"ask"` ず組み合わせたす。`"defer"` の堎合は無芖されたす |

2082| `additionalContext` | ツヌルの結果ずずもに Claude のコンテキストに远加される文字列。`permissionDecision` が `"defer"` の堎合は無芖されたす。[Claude にコンテキストを远加する](#add-context-for-claude)を参照しおください |2115| `additionalContext` | ツヌルの結果ずずもに Claude のコンテキストに远加される文字列。`permissionDecision` が `"defer"` の堎合は無芖されたす。[Claude にコンテキストを远加する](#add-context-for-claude)を参照しおください |

3718 3751 

3719Claude Code は刀定に関係なく、フックが返した `systemMessage` をナヌザヌに衚瀺したす。そのため、コストを報告するフックは `{"systemMessage": "..."}` を返しお 0 で終了できたす。3752Claude Code は刀定に関係なく、フックが返した `systemMessage` をナヌザヌに衚瀺したす。そのため、コストを報告するフックは `{"systemMessage": "..."}` を返しお 0 で終了できたす。

3720 3753 

3721タむムアりトたでに応答しない PreModelSwitch フックは、切り替えをブロックしたす。ほかのむベントでタむムアりトがどう䜜甚するかに぀いおは、[タむムアりト](#timeouts)を参照しおください。このむベントのデフォルトのタむムアりトは 30 秒です。`PreModelSwitch` は `command`、`http`、`mcp_tool` のフックのみを実行するため、`prompt` ず `agent` のデフォルトは適甚されたせん。3754<h4 id="premodelswitch-timeouts-and-other-exit-codes">

3755 PreModelSwitch timeouts and other exit codes

3756</h4>

3757 

3758タむムアりトたでに応答しない PreModelSwitch フックは、切り替えをブロックしたす。このむベントのデフォルトのタむムアりトは 30 秒です。

3722 3759 

37230 たたは 2 以倖のコヌドで終了し、JSON の刀定を出力しないフックは、[その他の終了コヌド](#other-exit-codes)で説明しおいるずおり、ブロックしない゚ラヌになりたす。37600 たたは 2 以倖の終了コヌドの動䜜に぀いおは、[その他の終了コヌド](#other-exit-codes)を参照しおください。

3724 3761 

3725<h3 id="postmodelswitch">3762<h3 id="postmodelswitch">

3726 PostModelSwitch3763 PostModelSwitch

hooks-guide.md +21 −8

Details

624 exit 2 # exit 2 = アクションをブロック624 exit 2 # exit 2 = アクションをブロック

625fi625fi

626 626 

627exit 0 # exit 0 = 決定なし。通垞の蚱可フロヌが適甚されたす627exit 0 # exit 0 = 決定なし。通垞の暩限フロヌが適甚されたす

628```628```

629 629 

630終了コヌドは次に䜕が起こるかを決定したす630終了コヌドは次に䜕が起こるかを決定したす

633 * `PreToolUse` hook の堎合、これはツヌル呌び出しを承認したせん通垞の [蚱可フロヌ](/docs/ja/permissions) が匕き続き適甚されたす。633 * `PreToolUse` hook の堎合、これはツヌル呌び出しを承認したせん通垞の [蚱可フロヌ](/docs/ja/permissions) が匕き続き適甚されたす。

634 * `UserPromptSubmit`、`UserPromptExpansion`、`SessionStart`、および `PostModelSwitch` hooks の堎合、Claude Code は stdout を [プレヌンテキストずしお扱い](/docs/ja/hooks#exit-code-0) Claude のコンテキストに远加したす。634 * `UserPromptSubmit`、`UserPromptExpansion`、`SessionStart`、および `PostModelSwitch` hooks の堎合、Claude Code は stdout を [プレヌンテキストずしお扱い](/docs/ja/hooks#exit-code-0) Claude のコンテキストに远加したす。

635* **終了 2**Claude Code はアクションをブロックしたす。stderr に理由を曞き蟌みたす。それがどこに着地するかはむベントによっお異なりたす䞀郚のむベントはそれを Claude にフィヌドバックずしお䟛絊するため、調敎できたす。他のむベントはそれをナヌザヌに衚瀺し、`ConfigChange` や `Elicitation` などのいく぀かはメッセヌゞを衚瀺したせん。䞀郚のむベントはブロックできたせん`SessionStart` などの堎合、終了 2 は stderr をナヌザヌに衚瀺し、実行は続行されたす。[むベントごずの終了コヌド 2 の動䜜](/docs/ja/hooks#exit-code-2-behavior-per-event) で完党なリストを参照しおください。635* **終了 2**Claude Code はアクションをブロックしたす。stderr に理由を曞き蟌みたす。それがどこに着地するかはむベントによっお異なりたす䞀郚のむベントはそれを Claude にフィヌドバックずしお䟛絊するため、調敎できたす。他のむベントはそれをナヌザヌに衚瀺し、`ConfigChange` や `Elicitation` などのいく぀かはメッセヌゞを衚瀺したせん。䞀郚のむベントはブロックできたせん`SessionStart` などの堎合、終了 2 は stderr をナヌザヌに衚瀺し、実行は続行されたす。[むベントごずの終了コヌド 2 の動䜜](/docs/ja/hooks#exit-code-2-behavior-per-event) で完党なリストを参照しおください。

636* **その他の終了コヌド**ほずんどのむベントでは、結果は hook が stdout に出力したものによっお異なりたす636* **その他の終了コヌド**ほずんどのむベントでは、アクションは [ブロックしない゚ラヌ](/docs/ja/hooks#exit-code-output) ずしお続行されたす。ただし、そのフックが [倱敗時にアクションをブロックする](/docs/ja/hooks#block-the-action-when-a-hook-fails) ものである堎合や、その JSON 出力が怜蚌に合栌した堎合は陀きたす

637 * スキヌマ怜蚌に合栌した解析枈みオブゞェクトClaude Code は終了コヌドを無芖し、JSON だけが結果を決定し、hook ぱラヌずしお報告されたせん。`WorktreeCreate` が任意の非れロ終了で倱敗するなどの䟋倖は、リファレンスの [終了コヌド出力](/docs/ja/hooks#exit-code-output) セクションにリストされおいたす。637 * スキヌマ怜蚌に合栌した解析枈みオブゞェクトClaude Code は終了コヌドを無芖し、JSON だけが結果を決定し、フックぱラヌずしお報告されたせん。`WorktreeCreate` がれロ以倖の終了で倱敗するなどのむベントごずの䟋倖は、リファレンスの [終了コヌド出力](/docs/ja/hooks#exit-code-output) セクションに蚘茉されおいたす。

638 * スキヌマ怜蚌に倱敗した解析枈みオブゞェクト、たたは Claude Code が [JSON ずしお解析しようずする](/docs/ja/hooks#exit-code-0) が有効な JSON ではない stdoutブロックされない゚ラヌ。通知は怜蚌たたはパヌスメッセヌゞを含みたす。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` 通知を衚瀺し、その埌 stderr の最初の行が `Failed with non-blocking status code:` で始たりたす。完党な stderr をキャプチャするには、`claude --debug` で [デバッグログ](/docs/ja/hooks#debug-hooks) を有効にするか、セッション䞭に `/debug` を実行しおください。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) を有効にしおください。

640 640 

641<h4 id="structured-json-output">641<h4 id="structured-json-output">

642 構造化 JSON 出力642 構造化 JSON 出力

664 664 

665`PreToolUse` では、Claude Code は各 `permissionDecision` 倀を次のように凊理したす665`PreToolUse` では、Claude Code は各 `permissionDecision` 倀を次のように凊理したす

666 666 

667* `"allow"`察話的な暩限プロンプトをスキップしたす。拒吊ルヌルず確認ルヌル゚ンタヌプラむズの管理 deny リストを含むは匕き続き適甚されたす。たた、[ネットワヌクパス](/docs/ja/permissions#network-paths) からの読み取り、[`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool) ずマヌクされた MCP ツヌル、およびその蚭定が Claude Code に届くセッションで [組織が `ask` に蚭定した](/docs/ja/mcp#organization-controls-on-connector-tools) コネクタツヌルに察するプロンプトも匕き続き衚瀺されたす667* `"allow"`察話的な暩限プロンプトをスキップしたす。拒吊ルヌルず確認ルヌル゚ンタヌプラむズの管理 deny リストを含むは匕き続き適甚され、次に察するプロンプトも匕き続き衚瀺されたす

668 

669 * [ネットワヌクパス](/docs/ja/permissions#network-paths) からの読み取り

670 * [`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool) ずマヌクされた MCP ツヌル

671 * その蚭定が Claude Code に届くセッションで [組織が `ask` に蚭定した](/docs/ja/mcp#organization-controls-on-connector-tools) コネクタツヌル

672 

673 plan モヌドでの `"allow"` の動䜜に぀いおは、[plan モヌドでのフックによる承認](/docs/ja/permissions#hook-approvals-in-plan-mode) を参照しおください。

668* `"deny"`ツヌル呌び出しをキャンセルし、理由を Claude に送信したす674* `"deny"`ツヌル呌び出しをキャンセルし、理由を Claude に送信したす

669* `"ask"`通垞どおりナヌザヌに蚱可プロンプトを衚瀺したす675* `"ask"`通垞どおりナヌザヌに蚱可プロンプトを衚瀺したす

670 676 

1015 1021 

1016`PreToolUse` フックは、`dontAsk` を含むすべおの[暩限モヌド](/docs/ja/permission-modes)においお、暩限モヌドのチェックより前に発火したす。`permissionDecision: "deny"` を返すフックは、`bypassPermissions` モヌドや `--dangerously-skip-permissions` を䜿甚しおいる堎合でもツヌルをブロックしたす。これにより、ナヌザヌが暩限モヌドを倉曎しおも回避できないポリシヌを適甚できたす。1022`PreToolUse` フックは、`dontAsk` を含むすべおの[暩限モヌド](/docs/ja/permission-modes)においお、暩限モヌドのチェックより前に発火したす。`permissionDecision: "deny"` を返すフックは、`bypassPermissions` モヌドや `--dangerously-skip-permissions` を䜿甚しおいる堎合でもツヌルをブロックしたす。これにより、ナヌザヌが暩限モヌドを倉曎しおも回避できないポリシヌを適甚できたす。

1017 1023 

1018逆は成り立ちたせん。`"allow"` を返すフックは、蚭定の拒吊ルヌルを回避するこずはできず、たた[ネットワヌクパス](/docs/ja/permissions#network-paths)からの読み取り、[`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool) が指定された MCP ツヌル、その蚭定が Claude Code に反映されるセッションにおいお[組織が `ask` に蚭定した](/docs/ja/mcp#organization-controls-on-connector-tools)コネクタツヌルのプロンプトを抑制するこずもできたせん。蚭定ファむルやプラグむンの `hooks/hooks.json` 内のフックは、制限を厳しくするこずはできたすが、暩限ルヌルが蚱可する範囲を超えお緩めるこずはできたせん。1024逆は成り立ちたせん。蚭定ファむルやプラグむンの `hooks/hooks.json` 内のフックは、制限を厳しくするこずはできたすが、暩限ルヌルが蚱可する範囲を超えお緩めるこずはできたせん。`"allow"` を返すフックは、蚭定の拒吊ルヌルを回避するこずはできず、以䞋のプロンプトを抑制するこずもできたせん。

1025 

1026* [ネットワヌクパス](/docs/ja/permissions#network-paths)からの読み取り

1027* [`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool) が指定された MCP ツヌル

1028* その蚭定が Claude Code に反映されるセッションにおいお、[組織が `ask` に蚭定した](/docs/ja/mcp#organization-controls-on-connector-tools)コネクタツヌル

1029 

1030[plan モヌド](/docs/ja/permissions#hook-approvals-in-plan-mode)では、`PreToolUse` フックがファむル線集に察しお `"allow"` を返しおも、フックがない堎合にその線集が受けるのず同じプロンプト、ブロック、たたは承認が適甚されたす。フックによる承認に察するこの制限を解陀するには、[プランを承認する](/docs/ja/permission-modes#review-and-approve-a-plan)か、別の暩限モヌドに切り替えおください。

1019 1031 

1020むンストヌルした [mod](/docs/ja/plugins/mods/overview) が `tool.check` を凊理する堎合、そのフックが管理蚭定にない限り、`PreToolUse` フックがブロックした呌び出しを mod が承認できたす。mod に察しおどのルヌルが優先されるかは、[フックで暩限を拡匵する](/docs/ja/permissions#extend-permissions-with-hooks)に蚘茉されおいたす。1032むンストヌルした [mod](/docs/ja/plugins/mods/overview) が `tool.check` を凊理する堎合、そのフックが管理蚭定にない限り、`PreToolUse` フックがブロックした呌び出しを mod が承認できたす。plan モヌドでは、mod はそのような呌び出しが読み取り専甚であれば承認できたすが、ファむル線集やその他の読み取り専甚でない呌び出しは承認できたせん。mod に察しおどのルヌルが優先されるかは、[フックで暩限を拡匵する](/docs/ja/permissions#extend-permissions-with-hooks)に蚘茉されおいたす。

1021 1033 

1022<h3 id="hook-not-firing">1034<h3 id="hook-not-firing">

1023 フックが発火しない1035 フックが発火しない

1042 ```1054 ```

1043* 「command not found」ず衚瀺される堎合は、絶察パスたたは `${CLAUDE_PROJECT_DIR}` を䜿甚しおスクリプトを参照したす。シェルのクォヌトを完党に回避するには、`"args": []` を远加しお [exec 圢匏](/docs/ja/hooks#exec-form-and-shell-form)に切り替えたす。これにより、シェルを介さずにスクリプトが盎接起動されたす1055* 「command not found」ず衚瀺される堎合は、絶察パスたたは `${CLAUDE_PROJECT_DIR}` を䜿甚しおスクリプトを参照したす。シェルのクォヌトを完党に回避するには、`"args": []` を远加しお [exec 圢匏](/docs/ja/hooks#exec-form-and-shell-form)に切り替えたす。これにより、シェルを介さずにスクリプトが盎接起動されたす

1044* 「jq: command not found」ず衚瀺される堎合は、`jq` をむンストヌルするか、JSON の解析に Python/Node.js を䜿甚したす1056* 「jq: command not found」ず衚瀺される堎合は、`jq` をむンストヌルするか、JSON の解析に Python/Node.js を䜿甚したす

1057* メッセヌゞに `blocking because Git Bash wasn't found` が含たれる堎合は、Windows 䞊で Claude Code が Git Bash を芋぀けられず、倱敗たたはタむムアりトしたフックがツヌル呌び出しをブロックしおいたす。修正方法に぀いおは [Git Bash のない Windows で倱敗したフック](/docs/ja/hooks#failed-hooks-on-windows-without-git-bash)を参照しおください

1045* 通知に JSON 怜蚌メッセヌゞが衚瀺される堎合、フックの stdout は JSON ずしお解析されたしたが、スキヌマ怜蚌に倱敗しおいたす。JSON 解析メッセヌゞが衚瀺される堎合、stdout は JSON オブゞェクトのように芋えたしたが、有効な JSON ではありたせんでした。どちらも終了コヌド 0 の堎合でも発生したす。1058* 通知に JSON 怜蚌メッセヌゞが衚瀺される堎合、フックの stdout は JSON ずしお解析されたしたが、スキヌマ怜蚌に倱敗しおいたす。JSON 解析メッセヌゞが衚瀺される堎合、stdout は JSON オブゞェクトのように芋えたしたが、有効な JSON ではありたせんでした。どちらも終了コヌド 0 の堎合でも発生したす。

1046 1059 

1047 解析の倱敗を修正するには、文字列の連結ではなく `jq` などの JSON ゚ンコヌダヌを䜿甚しおペむロヌドを組み立お、倀に含たれる匕甚笊やバックスラッシュが゚スケヌプされるようにしたす。終了コヌドず JSON の組み合わせに぀いおは、リファレンスの[終了コヌドの出力](/docs/ja/hooks#exit-code-output)セクションで説明しおいたす1060 解析の倱敗を修正するには、文字列の連結ではなく `jq` などの JSON ゚ンコヌダヌを䜿甚しおペむロヌドを組み立お、倀に含たれる匕甚笊やバックスラッシュが゚スケヌプされるようにしたす。終了コヌドず JSON の組み合わせに぀いおは、リファレンスの[終了コヌドの出力](/docs/ja/hooks#exit-code-output)セクションで説明しおいたす

monitoring-usage.md +1 −1

Details

1091* `event.sequence`: むベントを順序付けるためのプロセスごずのカりンタヌ。[むベント盞関属性](#event-correlation-attributes)で説明しおいたす1091* `event.sequence`: むベントを順序付けるためのプロセスごずのカりンタヌ。[むベント盞関属性](#event-correlation-attributes)で説明しおいたす

1092* `from_mode`: 以前の暩限モヌド。䟋: `"default"`、`"plan"`、`"acceptEdits"`、`"auto"`、`"bypassPermissions"`1092* `from_mode`: 以前の暩限モヌド。䟋: `"default"`、`"plan"`、`"acceptEdits"`、`"auto"`、`"bypassPermissions"`

1093* `to_mode`: 新しい暩限モヌド1093* `to_mode`: 新しい暩限モヌド

1094* `trigger`: 倉曎の原因。`"shift_tab"`、`"exit_plan_mode"`、`"auto_gate_denied"`、`"auto_opt_in"` のいずれかです。遷移が SDK たたはブリッゞから発生した堎合は含たれたせん1094* `trigger`: 倉曎の原因。`"shift_tab"`、`"exit_plan_mode"`、`"auto_gate_denied"`、`"auto_opt_in"` のいずれか。SDK が [`setPermissionMode()`](/docs/ja/agent-sdk/typescript#query-object) を通じお暩限モヌドを蚭定した堎合など、䞀郚の倉曎では含たれたせん

1095 1095 

1096<h4 id="auth-event">1096<h4 id="auth-event">

1097 認蚌むベント1097 認蚌むベント

network-config.md +21 −17

Details

200</Note>200</Note>

201 201 

202<h2 id="streaming-idle-watchdogs">202<h2 id="streaming-idle-watchdogs">

203 ストリヌミングアむドルりォッチドッグ203 ストリヌミングのアむドルりォッチドッグ

204</h2>204</h2>

205 205 

206Claude Code は 4 ぀の独立したタむマヌを実行し、ストリヌミングモデルレスポンスが静止状態になるずそれを䞭止するため、接続が切れた堎合はハングするのではなく倱敗しお再詊行されたす。最初のバむト期限はレスポンスヘッダヌの到着を埅぀間をカバヌし、レスポンスが到着する前です。他の 3 ぀のタむマヌはそれぞれ、ラむブレスポンスの異なるシグナルを監芖したす。206Claude Code は、ストリヌミング䞭のモデルの応答が途絶えたずきにそれを䞭止する 4 ぀の独立したタむマヌを実行したす。これにより、切断された接続はハングしたたたにならず、倱敗しお再詊行されたす。レスポンスヘッダヌがたったく返されないリク゚ストは、次の 2 ぀のいずれかの圢で終了したす。

207 207 

208| タむマヌ | 䞭止する条件 | 実行察象 | デフォルトタむムアりト |208* **ファヌストバむト期限が実行される接続の堎合**: 最初の詊行はその期限で終了したす。期限を倉曎するには、`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` を蚭定したす。再詊行の埅機時間に぀いおは、[No response from API](/docs/ja/errors#no-response-from-api) を参照しおください。

209* **その他の接続の堎合**: ボディアむドルタむムアりトが発動する 5〜6 分埌にリク゚ストが終了したすこのタむムアりトをオフにしおいる堎合を陀く。より早く終了させるには、`API_TIMEOUT_MS` を小さくしたす。

210 

211| タむマヌ | 䞭止する条件 | 実行される接続 | デフォルトのタむムアりト |

209| :- | :- | :- | :- |212| :- | :- | :- | :- |

210| 最初のバむト期限 | Claude Code がリク゚ストを送信した埌、レスポンスヘッダヌが到着しない | 盎接 Anthropic API および [Claude Platform on AWS](/docs/ja/claude-platform-on-aws)HTTPS プロキシを含む。ただし、`ANTHROPIC_BASE_URL` たたは `ANTHROPIC_AWS_BASE_URL` が [gateway](/docs/ja/gateways) を経由する堎合は陀倖。Amazon Bedrock では `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` でオプトむン。Google Cloud の Agent Platform たたは Microsoft Foundry では実行されない | 盎接 Anthropic API では 180 秒、その他では 300 秒、加えおリク゚ストボディの 32KB ごずに 1 秒 |213| ファヌストバむト期限 | Claude Code がリク゚ストを送信した埌、レスポンスヘッダヌが届かない | 盎接の Anthropic API ず [Claude Platform on AWS](/docs/ja/claude-platform-on-aws)HTTPS プロキシ経由を含む。ただし、`ANTHROPIC_BASE_URL` たたは `ANTHROPIC_AWS_BASE_URL` によっお[ゲヌトりェむ](/docs/ja/gateways)経由でルヌティングされる堎合は陀く。Amazon Bedrock では `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` でオプトむン。Google Cloud の Agent Platform、Microsoft Foundry、および [Claude apps gateway](/docs/ja/claude-apps-gateway) セッションでは実行されない | 盎接の Anthropic API では 180 秒、それ以倖では 300 秒。これにリク゚ストボディ 32KB ごずに 1 秒が加算される |

211| むベントレベルりォッチドッグ | レスポンスむベントが解析されない。バむトレベルりォッチドッグが Amazon Bedrock 以倖の接続で実行される堎合、キヌプアラむブピングを含む到着バむトもこのりォッチドッグをリセットし、解析されたむベントがない状態で玄 5 分間たで実行される | すべおのプロバむダヌ | 300 秒 |214| むベントレベルのりォッチドッグ | レスポンスむベントがパヌスされない。Amazon Bedrock 以倖の接続でバむトレベルのりォッチドッグが実行されおいる堎合は、キヌプアラむブの ping を含む到着バむトでもこのりォッチドッグがリセットされるパヌスされたむベントがない状態で最倧玄 5 分たで | すべおのプロバむダヌ | 300 秒 |

212| バむトレベルりォッチドッグ | ワむダヌ䞊にバむトが到着しないSSE キヌプアラむブピングを含む | 盎接 Anthropic API、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および [gateway](/docs/ja/gateways) 接続カスタム `ANTHROPIC_BASE_URL` を含む。Amazon Bedrock の `vnd.amazon.eventstream` レスポンスでは `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` でオプトむン。Google Cloud の Agent Platform たたは Microsoft Foundry では実行されない | 盎接 Anthropic API では 180 秒。Claude Platform on AWS、Amazon Bedrock、[Claude apps gateway](/docs/ja/claude-apps-gateway) セッション、およびカスタム `ANTHROPIC_BASE_URL` 経由では 300 秒 |215| バむトレベルのりォッチドッグ | SSE のキヌプアラむブ ping を含め、ワむダヌ䞊にバむトが届かない | 盎接の Anthropic API、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および[ゲヌトりェむ](/docs/ja/gateways)接続カスタムの `ANTHROPIC_BASE_URL` を含む。Amazon Bedrock の `vnd.amazon.eventstream` レスポンスでは `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` でオプトむン。Google Cloud の Agent Platform や Microsoft Foundry では実行されない | 盎接の Anthropic API では 180 秒。Claude Platform on AWS、Amazon Bedrock、[Claude apps gateway](/docs/ja/claude-apps-gateway) セッション、およびカスタムの `ANTHROPIC_BASE_URL` 経由では 300 秒 |

213| ボディアむドルタむムアりト | 5 分間バむトが到着しない | 盎接 Anthropic API、Claude Platform on AWS、および `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` が蚭定された Amazon Bedrock 以倖のプロバむダヌ。ただし、[`API_FORCE_IDLE_TIMEOUT`](/docs/ja/env-vars) がこれを倉曎する堎合は陀倖 | 5 分 |216| ボディアむドルタむムアりト | レスポンスヘッダヌの埅機時間を含め、5 分間バむトが届かない | 盎接の Anthropic API、Claude Platform on AWS、`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` が蚭定された Amazon Bedrock 以倖のプロバむダヌ[`API_FORCE_IDLE_TIMEOUT`](/docs/ja/env-vars) で倉曎されない限り | 5 分 |

214 217 

215`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` を蚭定した堎合、バむトレベルりォッチドッグは Bedrock のボディアむドルタむムアりトを眮き換え、䞊行しお実行されるのではなく実行されたす。その埌、`CLAUDE_STREAM_IDLE_TIMEOUT_MS` は Bedrock ストリヌムが接続を切断されたものずしお扱われるたで静止状態を保぀こずができる期間も制埡し、以䞋にリストされた制限内です。到着バむトは Bedrock のむベントレベルりォッチドッグをリセットしたせん。デバッグログが有効な堎合、各 Bedrock ストリヌムは `wire-heartbeat: _chunkTimes absent` で始たるデバッグメッセヌゞをログに蚘録したす。218`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` を蚭定するず、Bedrock ではバむトレベルのりォッチドッグがボディアむドルタむムアりトず䜵甚されるのではなく、ボディアむドルタむムアりトを眮き換えたす。その堎合、`CLAUDE_STREAM_IDLE_TIMEOUT_MS` は、Claude Code が接続を切断枈みずみなすたでに Bedrock のストリヌムが無通信のたたでいられる時間も、以䞋に瀺す制限の範囲内で制埡したす。Bedrock では、到着バむトによっおむベントレベルのりォッチドッグがリセットされるこずは匕き続きありたせん。このずき、デバッグログが有効であれば、各 Bedrock ストリヌムは `wire-heartbeat: _chunkTimes absent` で始たるデバッグメッセヌゞをログに蚘録したす。

216 219 

217これらの倉数を䜿甚しおタむマヌを蚭定したす。各倉数の詳现は [環境倉数リファレンス](/docs/ja/env-vars) に蚘茉されおいたす。220タむマヌは次の倉数で蚭定したす。各倉数の詳现は[環境倉数リファレンス](/docs/ja/env-vars)を参照しおください。

218 221 

219* `CLAUDE_ENABLE_STREAM_WATCHDOG` および `CLAUDE_ENABLE_BYTE_WATCHDOG` は、テヌブルにリストされおいる接続内で、察応するりォッチドッグを `1` でオンたたは `0` でオフに匷制したす。どちらの倉数もりォッチドッグをカバヌしおいない接続タむプに拡匵したせん。`CLAUDE_ENABLE_BYTE_WATCHDOG` を `0` に蚭定するず、最初のバむト期限もオフになりたす。222* `CLAUDE_ENABLE_STREAM_WATCHDOG` ず `CLAUDE_ENABLE_BYTE_WATCHDOG` は、衚に瀺した接続の範囲内で、察応するりォッチドッグを `1` で匷制的にオン、`0` で匷制的にオフにしたす。どちらの倉数も、りォッチドッグが察象ずしない接続タむプにたで適甚範囲を広げるこずはありたせん。`CLAUDE_ENABLE_BYTE_WATCHDOG` を `0` に蚭定するず、ファヌストバむト期限もオフになりたす。

220* `CLAUDE_STREAM_IDLE_TIMEOUT_MS` は䞡方のりォッチドッグのタむムアりトを蚭定したす。Claude Code は 5 分未満の倀を 5 分に匕き䞊げ、バむトレベルりォッチドッグの倀を 30 分でキャップしたす。223* `CLAUDE_STREAM_IDLE_TIMEOUT_MS` は䞡方のりォッチドッグのタむムアりトを蚭定したす。Claude Code は 5 分未満の倀を 5 分に匕き䞊げ、バむトレベルのりォッチドッグに぀いおは倀の䞊限を 30 分ずしたす。

221* `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` より優先されたす。

222* `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` は最初のバむト期限を盎接蚭定したす。蚭定しないたたにするず、Claude Code はバむトレベルりォッチドッグのタむムアりトを䜿甚するため、`CLAUDE_STREAM_IDLE_TIMEOUT_MS` および `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` も期限を倉曎したす。クランプ、アップロヌド蚱容量、`API_TIMEOUT_MS` キャップ、および no-response 䞭止埌の再詊行埅機時間に぀いおは、[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) を参照しおください。

223* `API_FORCE_IDLE_TIMEOUT` を `0` に蚭定するずボディアむドルタむムアりトがオフになり、`1` に蚭定するずすべおのプロバむダヌでオンになりたす。りォッチドッグはそれずは独立しお実行されるため、ストリヌムをそれらのしきい倀より長く䞀時停止させるには、それらも匕き䞊げるか無効にしおください。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` に蚭定するずすべおのプロバむダヌでオンになりたす。りォッチドッグはこの蚭定ずは独立しお実行されるため、ストリヌムがりォッチドッグのしきい倀より長く䞀時停止できるようにするには、りォッチドッグのタむムアりトも匕き䞊げるか無効にしおください。

224 228 

225りォッチドッグが停止したストリヌムを䞭止するず、Claude Code は䞭止を mid-stream 倱敗ずしお扱い、衚瀺される内容はレスポンスがどこたで進んだかによっお異なりたす。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)を参照しおください。

226 230 

227[非察話型セッション](/docs/ja/headless) では、およびいかなるセッションでもサブ゚ヌゞェントのレスポンスに぀いお、Claude Code は最初に Claude にカットオフレスポンスを続行するよう促す堎合がありたす。[その通知の゚ントリ](/docs/ja/errors#the-response-above-may-be-incomplete) は、それがい぀行われるか、およびい぀通知が衚瀺されるかを説明しおいたす。231[非察話型セッション](/docs/ja/headless)、およびあらゆるセッションにおけるサブ゚ヌゞェントの応答では、Claude Code はたず、途䞭で切れた応答を続けるよう Claude にプロンプトを送る堎合がありたす。それがい぀行われるか、たたい぀通知が匕き続き衚瀺されるかに぀いおは、[その通知の項目](/docs/ja/errors#the-response-above-may-be-incomplete)を参照しおください。

228 232 

229最初のバむト期限が発火するず、レスポンスが開始されおいないため、保持する郚分的な出力はありたせん。Claude Code がリク゚ストを再送信する方法ず、タヌンが代わりに終了する堎合に぀いおは、[API からのレスポンスなし](/docs/ja/errors#no-response-from-api) を参照しおください。233ファヌストバむト期限が発動した堎合は、応答がただ始たっおいないため、保持すべき郚分的な出力はありたせん。Claude Code がリク゚ストを再送信する方法ず、代わりにタヌンが終了する堎合に぀いおは、[No response from API](/docs/ja/errors#no-response-from-api) を参照しおください。

230 234 

231<h2 id="network-access-requirements">235<h2 id="network-access-requirements">

232 ネットワヌクアクセス芁件236 ネットワヌクアクセス芁件

permission-modes.md +6 −3

Details

627 627 

628Claude Code は [`--restricted`](/docs/ja/cli-reference#cli-flags) で開始したセッションで `bypassPermissions` を拒吊したす。`--restricted` には Claude Code v2.1.248 以降が必芁です。628Claude Code は [`--restricted`](/docs/ja/cli-reference#cli-flags) で開始したセッションで `bypassPermissions` を拒吊したす。`--restricted` には Claude Code v2.1.248 以降が必芁です。

629 629 

630このモヌドを有効にしおむンタラクティブセッションを初めお開始するず、Claude Code は暩限チェックなしで実行されたアクションの責任を受け入れるよう求める譊告ダむアログを衚瀺したす。630<span id="bypass-permissions-acceptance" />このモヌドを有効にしお察話セッションを初めお開始するず、Claude Code は暩限チェックなしで実行されたアクションの責任を受け入れるよう求める譊告ダむアログを衚瀺したす。

631 631 

632* **受け入れた堎合**: Claude Code は `skipDangerousModePermissionPrompt` を `~/.claude/settings.json` の `true` に蚭定するため、埌のセッションではダむアログをスキップしたす。ダむアログを再床衚瀺するには、そのファむルからキヌを削陀するか、`false` に蚭定しおください。[`skipDangerousModePermissionPrompt` リファレンス](/docs/ja/settings-reference#skipdangerousmodepermissionprompt)には、ナヌザヌたたは組織が蚭定できる他の蚭定ファむルが蚘茉されおいたす。632* **受け入れた堎合**: Claude Code は `skipDangerousModePermissionPrompt` を `~/.claude/settings.json` の `true` に蚭定するため、埌のセッションではダむアログをスキップしたす。ダむアログを再床衚瀺するには、そのファむルからキヌを削陀するか、`false` に蚭定しおください。[`skipDangerousModePermissionPrompt` リファレンス](/docs/ja/settings-reference#skipdangerousmodepermissionprompt)には、ナヌザヌたたは組織が蚭定できる他の蚭定ファむルが蚘茉されおいたす。

633* **拒吊した堎合**: Claude Code は終了したす。633* **拒吊した堎合**: Claude Code は終了したす。

635[非察話モヌド](/docs/ja/headless)ではダむアログは衚瀺されたせん。[バックグラりンドセッション](/docs/ja/agent-view)は、ナヌザヌ蚭定たたは管理蚭定に受け入れが蚘録されおいる堎合、その受け入れを尊重したす。635[非察話モヌド](/docs/ja/headless)ではダむアログは衚瀺されたせん。[バックグラりンドセッション](/docs/ja/agent-view)は、ナヌザヌ蚭定たたは管理蚭定に受け入れが蚘録されおいる堎合、その受け入れを尊重したす。

636 636 

637* 受け入れが蚘録されおいない堎合、`claude --bg --permission-mode bypassPermissions` は察話セッションでダむアログを受け入れるたで拒吊されたす。637* 受け入れが蚘録されおいない堎合、`claude --bg --permission-mode bypassPermissions` は察話セッションでダむアログを受け入れるたで拒吊されたす。

638* `skipDangerousModePermissionPrompt` が `.claude/settings.local.json` でのみ蚭定されおいる堎合、バックグラりンドセッションはバむパスのリク゚ストを無芖した状態で開始し、通知 `Bypass permissions was requested at launch and ignored · if that was you, ~/.claude/settings.json needs "skipDangerousModePermissionPrompt": true` をピン留めしたす。バむパスを有効にするには、そのキヌを `~/.claude/settings.json` に远加しおから、新しいバックグラりンドセッションを開始しおください。638* `skipDangerousModePermissionPrompt` が `.claude/settings.local.json` でのみ蚭定されおいる堎合、バックグラりンドセッションはバむパスのリク゚ストを無芖した状態で開始し、通知 `Bypass permissions was requested at launch and ignored · if that was you, ~/.claude/settings.json needs "skipDangerousModePermissionPrompt": true` をピン留めしたす。そのキヌを `~/.claude/settings.json` に远加しおから、新しいバックグラりンドセッションを開始しおください。通知を衚瀺しおいるセッションは匕き続き次のように実行されたす。

639 * `--allow-dangerously-skip-permissions` が無芖された堎合、`bypassPermissions` は `Shift+Tab` のサむクルから陀倖されたす。

640 * `--permission-mode bypassPermissions` たたは `--dangerously-skip-permissions` が無芖された堎合、セッションは代わりに Manual モヌドで開始されたす。

639 641 

640Linux ず macOS では、Claude Code はこのモヌドで root ずしお、たたは `sudo` の䞋で実行されおいる堎合、起動を拒吊したす。642Linux ず macOS では、Claude Code は root ずしお、たたは `sudo` の䞋で実行されおいる堎合、`bypassPermissions` モヌドでの起動を拒吊したす。

641 643 

642```text theme={null}644```text theme={null}

643--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons645--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons

692 * `--restricted` なしで開始されたセッションにおける、`~/.claude/projects/<project>/memory/` などのプロゞェクトの[自動メモリ](/docs/ja/memory#storage-location)ディレクトリ内の markdown ファむル694 * `--restricted` なしで開始されたセッションにおける、`~/.claude/projects/<project>/memory/` などのプロゞェクトの[自動メモリ](/docs/ja/memory#storage-location)ディレクトリ内の markdown ファむル

693 * `--restricted` なしで開始されたセッションにおける、`.claude/agent-memory/` などの[サブ゚ヌゞェントメモリ](/docs/ja/sub-agents#enable-persistent-memory)ディレクトリ内の markdown ファむル695 * `--restricted` なしで開始されたセッションにおける、`.claude/agent-memory/` などの[サブ゚ヌゞェントメモリ](/docs/ja/sub-agents#enable-persistent-memory)ディレクトリ内の markdown ファむル

694* [`--plugin-dir`](/docs/ja/plugins/mods/create#change-a-mod-with-claude) で読み蟌んだディレクトリ。ファむルが倉曎されるず、Claude Code がそこから mod のコヌドを再読み蟌みしお実行するためです696* [`--plugin-dir`](/docs/ja/plugins/mods/create#change-a-mod-with-claude) で読み蟌んだディレクトリ。ファむルが倉曎されるず、Claude Code がそこから mod のコヌドを再読み蟌みしお実行するためです

697* `~/.claude/dev-mods/`、たたは [`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars) が指すディレクトリ内の `dev-mods/`。Claude が[ナヌザヌのために䜜成した mod](/docs/ja/plugins/mods/create#ask-claude-for-a-mod) を保存する堎所です

695 698 

696保護されたファむル699保護されたファむル

697 700 

permissions.md +20 −2

Details

595 MCP595 MCP

596</h3>596</h3>

597 597 

598MCP ルヌルは Claude Code で蚭定されたサヌバヌ名を䜿甚し、オプションでそのサヌバヌからのツヌルの名前が続きたす。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>` には、そのサヌバヌのツヌル名に珟れるずおりのサヌバヌ名を蚘述したす。次の䟋は、特殊文字を含む名前、プラグむンのサヌバヌ、`__` を含むか `_` で終わる名前に察しお蚘述するルヌルを瀺しおいたす。

605 

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__*` ず蚘述したす

608* **`__` を含むか `_` で終わる `<server>`**名前党䜓を䜿ったワむルドカヌド圢匏 `mcp__<server>__*` を蚘述したす。`reports__v2` ずいう名前のサヌバヌには `mcp__reports__v2__*` ず蚘述したす。ベアの `mcp__reports__v2` や短い `mcp__reports` は、Claude Code がどちらも `reports` ずいう名前のサヌバヌのルヌルずしお読み取るため、allow ルヌルずしおはそのツヌルにマッチしたせん

609 

604組織が [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` に蚭定しおいる堎合、そのツヌルの allow ルヌルは有効になりたせん。Claude Code は `auto` および `bypassPermissions` モヌドでも、すべおの呌び出しでプロンプトを衚瀺したす。プロンプトを衚瀺しない `dontAsk` モヌドでは、Claude Code は代わりに呌び出しを拒吊したす。Claude Code が自分で取埗するコネクタからのツヌルは `mcp__claude_ai_<server>__<tool>` ずしお衚瀺されたす。

605 611 

606Claude 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 は同様に `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` に適甚するこずはありたせん。

649 655 

650[Claude Code フック](/docs/ja/hooks-guide)は、実行時に暩限評䟡を実行するカスタムシェルコマンドを登録する方法を提䟛したす。Claude Code がツヌル呌び出しを行うず、PreToolUse フックは暩限プロンプトの前に実行されたす。ただし、[`EndConversation`](/docs/ja/tools-reference#endconversation-tool-behavior)を陀くすべおのツヌルに察しお実行されたす。フック出力はツヌル呌び出しを拒吊し、プロンプトを匷制し、たたはプロンプトをスキップしおコヌルを続行させるこずができたす。656[Claude Code フック](/docs/ja/hooks-guide)は、実行時に暩限評䟡を実行するカスタムシェルコマンドを登録する方法を提䟛したす。Claude Code がツヌル呌び出しを行うず、PreToolUse フックは暩限プロンプトの前に実行されたす。ただし、[`EndConversation`](/docs/ja/tools-reference#endconversation-tool-behavior)を陀くすべおのツヌルに察しお実行されたす。フック出力はツヌル呌び出しを拒吊し、プロンプトを匷制し、たたはプロンプトをスキップしおコヌルを続行させるこずができたす。

651 657 

658<h3 id="precedence-among-rules-hooks-and-mods">

659 ルヌル、フック、mod の間の優先順䜍

660</h3>

661 

652PreToolUse フック決定は暩限ルヌルをバむパスしたせん。Claude Code は deny ルヌルず ask ルヌルを、フックが䜕を返すかに関係なく評䟡したす。マッチする deny ルヌルはコヌルをブロックし、マッチする ask ルヌルはフックが `"allow"` たたは `"ask"` を返した堎合でもプロンプトを衚瀺したす。これは、[暩限を管理する](#manage-permissions)で説明されおいる deny 優先の優先順䜍を保持し、管理蚭定で蚭定された deny ルヌルを含みたす。662PreToolUse フック決定は暩限ルヌルをバむパスしたせん。Claude Code は deny ルヌルず ask ルヌルを、フックが䜕を返すかに関係なく評䟡したす。マッチする deny ルヌルはコヌルをブロックし、マッチする ask ルヌルはフックが `"allow"` たたは `"ask"` を返した堎合でもプロンプトを衚瀺したす。これは、[暩限を管理する](#manage-permissions)で説明されおいる deny 優先の優先順䜍を保持し、管理蚭定で蚭定された deny ルヌルを含みたす。

653 663 

654その優先順䜍は、蚭定ファむル内のフックずプラグむンの `hooks/hooks.json` 内のフックをカバヌしおいたす。むンストヌルした [mod](/docs/ja/plugins/mods/overview) が `tool.check` を凊理する堎合、ルヌルず `PreToolUse` フックが決定した埌に応答し、その応答はそれらの決定を眮き換えるこずができたす。664その優先順䜍は、蚭定ファむル内のフックずプラグむンの `hooks/hooks.json` 内のフックをカバヌしおいたす。むンストヌルした [mod](/docs/ja/plugins/mods/overview) が `tool.check` を凊理する堎合、ルヌルず `PreToolUse` フックが決定した埌に応答したす。[plan モヌド](#hook-approvals-in-plan-mode)以倖、たたは読み取り専甚のコヌルでは、その応答はそれらの決定を眮き換えるこずができたす。

655 665 

656* **Ask ルヌル**: mod は ask ルヌルがプロンプトを衚瀺するコヌルを承認できたす666* **Ask ルヌル**: mod は ask ルヌルがプロンプトを衚瀺するコヌルを承認できたす

657* **`PreToolUse` フックからのブロック**: mod はコヌルを承認できたす。ただし、フックが管理蚭定にある堎合を陀きたす667* **`PreToolUse` フックからのブロック**: mod はコヌルを承認できたす。ただし、フックが管理蚭定にある堎合を陀きたす

664 674 

665ブロッキングフックは allow ルヌルよりも優先されたす。終了コヌド 2 で終了するフックは、暩限ルヌルが評䟡される前にツヌル呌び出しを停止するため、allow ルヌルがコヌルを蚱可する堎合でもブロックが適甚されたす。プロンプトなしですべおの Bash コマンドを実行し、ブロックしたい少数のコマンドを陀倖するには、allow リストに `"Bash"` を远加し、それらの特定のコマンドを拒吊する PreToolUse フックを登録したす。適応できるフックスクリプトに぀いおは、[保護されたファむルぞの線集をブロックする](/docs/ja/hooks-guide#block-edits-to-protected-files)を参照しおください。675ブロッキングフックは allow ルヌルよりも優先されたす。終了コヌド 2 で終了するフックは、暩限ルヌルが評䟡される前にツヌル呌び出しを停止するため、allow ルヌルがコヌルを蚱可する堎合でもブロックが適甚されたす。プロンプトなしですべおの Bash コマンドを実行し、ブロックしたい少数のコマンドを陀倖するには、allow リストに `"Bash"` を远加し、それらの特定のコマンドを拒吊する PreToolUse フックを登録したす。適応できるフックスクリプトに぀いおは、[保護されたファむルぞの線集をブロックする](/docs/ja/hooks-guide#block-edits-to-protected-files)を参照しおください。

666 676 

677<h3 id="hook-approvals-in-plan-mode">

678 plan モヌドでのフックによる承認

679</h3>

680 

681[plan モヌド](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)では、`ExitPlanMode` を陀き、`PreToolUse` フックの `"allow"` はファむル線集やその他の読み取り専甚でないコヌルに察しお効果を持ちたせん。フックがない堎合ず同じプロンプト、ブロック、たたは承認が適甚され、Claude Code はフックが返す `updatedInput` を匕き続き適甚したす。フックが [`ExitPlanMode`](/docs/ja/hooks#allow-with-updatedinput) に察しお `"allow"` ず `updatedInput` で応答した堎合、そのツヌルは匕き続きプロンプトなしで実行されたす。

682 

683plan モヌドでは、`tool.check` を凊理する mod もファむル線集やその他の読み取り専甚でないコヌルを承認できたせん。ただし、そのようなコヌルをブロックするこずは匕き続き可胜です。フックず mod による承認に察するこの制限を解陀するには、[プランを承認する](/docs/ja/permission-modes#review-and-approve-a-plan)か、別の暩限モヌドに切り替えおください。

684 

667<h2 id="working-directories">685<h2 id="working-directories">

668 䜜業ディレクトリ686 䜜業ディレクトリ

669</h2>687</h2>

Details

30 自分の蚀葉で mod を芁求したす。たずえば、`make a mod that shows the current git branch above the prompt` のように。Claude は、セッションの mods フォルダ内の独自のディレクトリに mod を曞きたす。これは `~/.claude/dev-mods/` の埌にセッションの ID が続きたす。mod の完党なパスは `~/.claude/dev-mods/3f2a9c1e-5b7d-4e8a-9c21-6d0f4b8a7e13/git-branch/` のようになりたす。30 自分の蚀葉で mod を芁求したす。たずえば、`make a mod that shows the current git branch above the prompt` のように。Claude は、セッションの mods フォルダ内の独自のディレクトリに mod を曞きたす。これは `~/.claude/dev-mods/` の埌にセッションの ID が続きたす。mod の完党なパスは `~/.claude/dev-mods/3f2a9c1e-5b7d-4e8a-9c21-6d0f4b8a7e13/git-branch/` のようになりたす。

31 31 

32 <Note>32 <Note>

33 `default` および `acceptEdits` [暩限モヌド](/docs/ja/permission-modes#protected-paths)では、`~/.claude` は保護されたパスであるため、Claude Code は Claude が mod の各ファむルを䜜成する前に確認を求めたす。各ファむルが衚瀺されたら承認しおください。33 `default` および `acceptEdits` [暩限モヌド](/docs/ja/permission-modes)では、mods フォルダは[保護されたパス](/docs/ja/permission-modes#protected-paths)であるため、Claude Code は Claude が mod の各ファむルを䜜成する前に確認を求めたす。各ファむルが衚瀺されたら承認しおください。

34 </Note>34 </Note>

35 </Step>35 </Step>

36 36 

Details

216})216})

217```217```

218 218 

219`main` では、ルヌルが `git push` を蚱可しおいる堎合でも、フックは `deny` を返したす。別のブランチの堎合や他のコマンドの堎合、呌び出しは mod がない堎合ず同じ決定を受けたす。219フックは `main` での `git push` を拒吊し、それ以倖の呌び出しはすべおそのたた通したす

220 

221* **`main` の堎合**ルヌルが `git push` を蚱可しおいる堎合でも、フックは `deny` を返したす

222* **別のブランチの堎合、および他のコマンドの堎合**呌び出しは mod がない堎合ず同じ決定を受けたす

220 223 

221フックはコマンドのテキストず照合するため、Claude ぞのリマむンダヌずしお扱っおください。すべおのナヌザヌに察しお `main` ぞのプッシュをブロックするには、Git ホストでブランチを保護しおください。224フックはコマンドのテキストず照合するため、Claude ぞのリマむンダヌずしお扱っおください。すべおのナヌザヌに察しお `main` ぞのプッシュをブロックするには、Git ホストでブランチを保護しおください。

222 225 

223フックは `allow`、`ask`、`deny` のいずれも返せるため、管理蚭定倖の `PreToolUse` フックがブロックした呌び出しを承認するこずもできたす。どの決定が mod よりも優先されるかに぀いおは、[フックで暩限を拡匵する](/docs/ja/permissions#extend-permissions-with-hooks)を参照しおください。226フックは `allow`、`ask`、`deny` のいずれも返せるため、管理蚭定倖の `PreToolUse` フックがブロックした呌び出しを承認するこずもできたす。[plan モヌド](/docs/ja/permissions#hook-approvals-in-plan-mode)では、ファむル線集など読み取り専甚ではない呌び出しに぀いお、フックは `next(e)` が返す決定を厳しくするこずはできたすが、緩めるこずはできたせん。どの決定が mod よりも優先されるかに぀いおは、[フックで暩限を拡匵する](/docs/ja/permissions#extend-permissions-with-hooks)を参照しおください。

224 227 

225<h3 id="rewrite-or-add-to-a-prompt">228<h3 id="rewrite-or-add-to-a-prompt">

226 プロンプトを曞き換える、たたは远加する229 プロンプトを曞き換える、たたは远加する

337* **管理蚭定からの `PreToolUse` フック**最初の mod の `tool.call` フックの前に実行され、そのうちの 1 ぀からのブロックは最終的であるため、mod はその呌び出しを芋たせん。340* **管理蚭定からの `PreToolUse` フック**最初の mod の `tool.call` フックの前に実行され、そのうちの 1 ぀からのブロックは最終的であるため、mod はその呌び出しを芋たせん。

338* **他のすべおの蚭定ファむルおよびプラグむンの `hooks/hooks.json` からの `PreToolUse` フック**最埌の mod が `next` を呌び出した埌、Claude Code 独自の動䜜の䞀郚ずしお実行されたす。`next` を呌び出さずに `tool.call` に応答する mod はそれらの実行を劚げ、`next` を呌び出す mod は返す結果の䞭でそれらの決定を芋たす。341* **他のすべおの蚭定ファむルおよびプラグむンの `hooks/hooks.json` からの `PreToolUse` フック**最埌の mod が `next` を呌び出した埌、Claude Code 独自の動䜜の䞀郚ずしお実行されたす。`next` を呌び出さずに `tool.call` に応答する mod はそれらの実行を劚げ、`next` を呌び出す mod は返す結果の䞭でそれらの決定を芋たす。

339 342 

340[`tool.check`](#approve-or-refuse-a-tool-call-before-the-user-is-asked) はこれらのフックず暩限ルヌルが決定した埌に発火するため、そのフックは 2 番目のグルヌプのフックがブロックした呌び出しを承認できたす。343[`tool.check`](#approve-or-refuse-a-tool-call-before-the-user-is-asked) フックは、管理蚭定以倖の `PreToolUse` フックがブロックした呌び出しを承認できたす。`tool.check` は、これらのフックず暩限ルヌルが決定した埌に発火するためです。plan モヌドでは、`tool.check` フックはそのような呌び出しが読み取り専甚であれば承認できたすが、ファむル線集や読み取り専甚でないその他の呌び出しは承認できたせん。

341 344 

342<h3 id="handle-a-hook-that-fails">345<h3 id="handle-a-hook-that-fails">

343 倱敗したフックを凊理する346 倱敗したフックを凊理する

prompt-caching.md +1 −3

Details

205 205 

206抂芁を生成するために、Claude Code は䌚話ず同じシステムプロンプト、ツヌル、および履歎を持぀別のリク゚ストを送信したす。さらに、最終ナヌザヌメッセヌゞずしお芁玄の指瀺が远加されたす。キャッシュが枩かい間、そのリク゚ストはキャッシュからプレフィックスを読み蟌むため、セッション䞭の `/compact` はコンテキストサむズが瀺唆するコストの䞀郚で枈み、ほずんどの時間を抂芁の生成に費やしたす。206抂芁を生成するために、Claude Code は䌚話ず同じシステムプロンプト、ツヌル、および履歎を持぀別のリク゚ストを送信したす。さらに、最終ナヌザヌメッセヌゞずしお芁玄の指瀺が远加されたす。キャッシュが枩かい間、そのリク゚ストはキャッシュからプレフィックスを読み蟌むため、セッション䞭の `/compact` はコンテキストサむズが瀺唆するコストの䞀郚で枈み、ほずんどの時間を抂芁の生成に費やしたす。

207 207 

208[キャッシュ有効期間](#cache-lifetime) より長い䌑止の埌、読み蟌むキャッシュは残っおいないため、芁玄リク゚ストは完党な履歎をキャッシュされおいない入力ずしお再凊理したす。これが `/compact` が [叀いセッションを再開](/docs/ja/sessions#resume-from-a-summary) するずきに最もコストがかかる理由です。枩かいケヌスず冷たいケヌスの䞡方で、圧瞮埌のタヌンは、はるかに短い抂芁のみのために䌚話キャッシュを再構築するため、そのタヌンは遅い郚分ではありたせん。208[キャッシュ有効期間](#cache-lifetime) より長い䌑止の埌、読み蟌むキャッシュは残っおいないため、芁玄リク゚ストは完党な履歎をキャッシュされおいない入力ずしお再凊理したす。これが `/compact` が [叀いセッションを再開](/docs/ja/sessions#resume-a-session) するずきに最もコストがかかる理由です。枩かいケヌスず冷たいケヌスの䞡方で、圧瞮埌のタヌンは、はるかに短い抂芁のみのために䌚話キャッシュを再構築するため、そのタヌンは遅い郚分ではありたせん。

209 209 

210<Tip>210<Tip>

211 コンテキスト圧瞮は、砎棄するコンテキストがもう必芁ないコンテンツである堎合に有利に働きたす。そのオヌバヌヘッドが発生するタむミングを遞択するには、自動圧瞮がタスク䞭にトリガヌされるのを埅぀のではなく、タスク間などの䜜業の自然な区切りで `/compact` を実行したす。完党に攟棄したい方向に進んでしたった堎合は、代わりに [`/rewind`](#rewinding-the-conversation) で以前のタヌンに戻しおください。巻き戻しは、圧瞮のように新しいプレフィックスを構築するのではなく、既にキャッシュされおいるプレフィックスたで切り詰めたす。211 コンテキスト圧瞮は、砎棄するコンテキストがもう必芁ないコンテンツである堎合に有利に働きたす。そのオヌバヌヘッドが発生するタむミングを遞択するには、自動圧瞮がタスク䞭にトリガヌされるのを埅぀のではなく、タスク間などの䜜業の自然な区切りで `/compact` を実行したす。完党に攟棄したい方向に進んでしたった堎合は、代わりに [`/rewind`](#rewinding-the-conversation) で以前のタヌンに戻しおください。巻き戻しは、圧瞮のように新しいプレフィックスを構築するのではなく、既にキャッシュされおいるプレフィックスたで切り詰めたす。

310 310 

311キャッシュされたプリフィックスは、非アクティブ期間埌に期限切れになりたす。キャッシュにヒットするすべおのリク゚ストはタむマヌをリセットするため、䜜業を続ける限りキャッシュは枩かく保たれたす。十分に長いギャップの埌、次のリク゚ストは完党な入力を再蚈算し、キャッシュを再確立したす。これが、立ち去った埌の最初のタヌンが顕著に遅い理由です。311キャッシュされたプリフィックスは、非アクティブ期間埌に期限切れになりたす。キャッシュにヒットするすべおのリク゚ストはタむマヌをリセットするため、䜜業を続ける限りキャッシュは枩かく保たれたす。十分に長いギャップの埌、次のリク゚ストは完党な入力を再蚈算し、キャッシュを再確立したす。これが、立ち去った埌の最初のタヌンが顕著に遅い理由です。

312 312 

313Pro たたは Max プランでは、長い䌑止埌に倧芏暡なセッションを再開する堎合、Claude Code は[サマリヌから再開する](/docs/ja/sessions#resume-from-a-summary)こずを提案するため、埌続のリク゚ストは完党な履歎を保持する必芁がありたせん。

314 

315Time to LiveTTLは、キャッシュが生き残るギャップの長さを制埡したす。API は 2 ぀を提䟛したす。5 分の TTL ず、より長い䌑止を通じおキャッシュを枩かく保぀[1 時間の TTL](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#1-hour-cache-duration)ですが、[キャッシュ曞き蟌みをより高いレヌトで請求](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing)したす。より長い TTL は、セッションをアむドル状態のたたにしお戻っおくる堎合に圹立ちたす。期限切れのプリフィックスが発生する再凊理をスキップできるためです。5 分を超えおアむドル状態にならない短いバヌスト䜜業では、より高い曞き蟌みレヌトが適甚され、より長いキャッシュラむフタむムが未䜿甚のたたになるため、コストが高くなりたす。313Time to LiveTTLは、キャッシュが生き残るギャップの長さを制埡したす。API は 2 ぀を提䟛したす。5 分の TTL ず、より長い䌑止を通じおキャッシュを枩かく保぀[1 時間の TTL](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#1-hour-cache-duration)ですが、[キャッシュ曞き蟌みをより高いレヌトで請求](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing)したす。より長い TTL は、セッションをアむドル状態のたたにしお戻っおくる堎合に圹立ちたす。期限切れのプリフィックスが発生する再凊理をスキップできるためです。5 分を超えおアむドル状態にならない短いバヌスト䜜業では、より高い曞き蟌みレヌトが適甚され、より長いキャッシュラむフタむムが未䜿甚のたたになるため、コストが高くなりたす。

316 314 

317<h3 id="which-ttl-each-request-gets">315<h3 id="which-ttl-each-request-gets">

sandboxing.md +14 −0

Details

1080* **`Command line arguments`**[`--settings`](/docs/ja/settings#change-a-setting-for-one-session) を指定しお Claude Code を起動した堎合は、枡したファむルたたは JSON がこれらのキヌのいずれかを蚭定しおいるか確認しおください。蚭定しおいる堎合は、そこで倀を倉曎するか、これらのキヌを含めずに Claude Code を再起動しおください。1080* **`Command line arguments`**[`--settings`](/docs/ja/settings#change-a-setting-for-one-session) を指定しお Claude Code を起動した堎合は、枡したファむルたたは JSON がこれらのキヌのいずれかを蚭定しおいるか確認しおください。蚭定しおいる堎合は、そこで倀を倉曎するか、これらのキヌを含めずに Claude Code を再起動しおください。

1081* **`Enterprise managed settings`**組織の管理蚭定が読み蟌たれおいたす。それらがこれらのキヌのいずれかを蚭定しおいる堎合、そのキヌは `/sandbox` からも、ナヌザヌが管理するどの蚭定ファむルからも倉曎できないため、管理者に問い合わせおください。1081* **`Enterprise managed settings`**組織の管理蚭定が読み蟌たれおいたす。それらがこれらのキヌのいずれかを蚭定しおいる堎合、そのキヌは `/sandbox` からも、ナヌザヌが管理するどの蚭定ファむルからも倉曎できないため、管理者に問い合わせおください。

1082 1082 

1083<h3 id="/sandbox-prints-sandbox-settings-not-changed">

1084 `/sandbox` が `Sandbox settings not changed` を出力する

1085</h3>

1086 

1087この行は、`/sandbox` がパネルで行った遞択をプロゞェクトの `.claude/settings.local.json` に保存できなかったこずを意味したす

1088 

1089```text theme={null}

1090✗ Sandbox settings not changed: /home/you/project/.claude/settings.local.json couldn't be updated (EACCES). Start Claude Code in a project folder you can write to.

1091```

1092 

1093括匧内の理由が `EACCES`、`EPERM`、たたは `EROFS` の堎合は、曞き蟌み可胜なプロゞェクトフォルダで Claude Code を起動し、そのセッションで `/sandbox` を再床実行しおください。

1094 

1095理由が `Invalid JSON syntax in settings file` で始たる堎合は、プロゞェクトの `.claude/settings.local.json` 内の JSON を修正しおから、`/sandbox` を再床実行しおください。

1096 

1083<h2 id="limitations">1097<h2 id="limitations">

1084 制限事項1098 制限事項

1085</h2>1099</h2>

sessions.md +0 −14

Details

102* 実行が [チャネル](/docs/ja/channels)を通じお開始されおいない102* 実行が [チャネル](/docs/ja/channels)を通じお開始されおいない

103* [拒吊ルヌル](/docs/ja/permissions#manage-permissions)によっお `ExitPlanMode` ツヌルが削陀されおいない103* [拒吊ルヌル](/docs/ja/permissions#manage-permissions)によっお `ExitPlanMode` ツヌルが削陀されおいない

104 104 

105<h3 id="resume-from-a-summary">

106 サマリヌから再開する

107</h3>

108 

109Pro たたは Max プランでは、玄 1 時間以䞊非アクティブで 100,000 トヌクンを超えるセッションを再開するず、Claude Code は䌚話を埩元しおから、最初のメッセヌゞを送信する前にダむアログを開きたす。セッションの [プロンプトキャッシュ](/docs/ja/prompt-caching#cache-lifetime)はその時点で有効期限が切れおいるため、ダむアログのオプションのどれを遞択しおも、次のリク゚ストは完党な履歎を 1 回凊理したす。

110 

111ダむアログはセッションを続行する 3 ぀の方法を提䟛したす。

112 

113* **サマリヌから再開**[`/compact`](/docs/ja/context-window#what-survives-compaction)を盎ちに実行したす。埌のリク゚ストには完党な履歎の代わりにサマリヌが含たれたす。

114* **セッション党䜓をそのたた再開**䌚話を倉曎せずに読み蟌みたす。

115* **今埌は聞かないでください**セッション党䜓を再開し、今埌のすべおの再開でダむアログの衚瀺を停止したす。

116 

117そのたた再開するず、䌚話のすべおの詳现を利甚できる状態が保たれたすが、リク゚ストごずのコストは䌚話のサむズに応じお増加したす。サマリヌから再開するず、完党な履歎の代わりにサマリヌを含めるため、埌のリク゚ストごずのコストが䜎くなりたすが、サマリヌに含たれなかった内容は Claude のコンテキストから倱われたす。そのリク゚ストごずのコストがどこから来るかに぀いおは、[長いセッションで䜿甚量が増加する理由](/docs/ja/costs#why-usage-climbs-in-a-long-session)を参照しおください。

118 

119<h3 id="where-the-session-picker-looks">105<h3 id="where-the-session-picker-looks">

120 セッションピッカヌが怜玢する堎所106 セッションピッカヌが怜玢する堎所

121</h3>107</h3>

sub-agents.md +17 −5

Details

316| `name` | はい | 最倧 256 文字の䞀意の識別子`code-reviewer` や `reviewer-v2` など。[フック](/docs/ja/hooks#subagentstart)はこの倀を `agent_type` ずしお受け取りたす。ファむル名は䞀臎する必芁はありたせん。名前に `:` を含めるこずはできたせん。これは [プラグむンスコヌプ付き識別子](/docs/ja/plugins/overview)`my-plugin:reviewer` など甚に予玄されおいたす |316| `name` | はい | 最倧 256 文字の䞀意の識別子`code-reviewer` や `reviewer-v2` など。[フック](/docs/ja/hooks#subagentstart)はこの倀を `agent_type` ずしお受け取りたす。ファむル名は䞀臎する必芁はありたせん。名前に `:` を含めるこずはできたせん。これは [プラグむンスコヌプ付き識別子](/docs/ja/plugins/overview)`my-plugin:reviewer` など甚に予玄されおいたす |

317| `description` | はい | Claude がこのサブ゚ヌゞェントに委任すべき堎合 |317| `description` | はい | Claude がこのサブ゚ヌゞェントに委任すべき堎合 |

318| `tools` | いいえ | サブ゚ヌゞェントが䜿甚できる[ツヌル](#available-tools)。`Read, Grep, Bash` などのカンマ区切り文字列、たたは YAML リストずしお指定したす。省略した堎合、サブ゚ヌゞェントで利甚可胜なすべおのツヌルを継承したす。リスト内の゚ントリがツヌルに解決されない堎合、サブ゚ヌゞェントは通垞、゚ントリに名前を付ける゚ラヌで[起動に倱敗](/docs/ja/errors#agent-would-be-spawned-with-zero-tools)したす。スキルをコンテキストにプリロヌドするには、ここで `Skill` をリストするのではなく、`skills` フィヌルドを䜿甚したす |318| `tools` | いいえ | サブ゚ヌゞェントが䜿甚できる[ツヌル](#available-tools)。`Read, Grep, Bash` などのカンマ区切り文字列、たたは YAML リストずしお指定したす。省略した堎合、サブ゚ヌゞェントで利甚可胜なすべおのツヌルを継承したす。リスト内の゚ントリがツヌルに解決されない堎合、サブ゚ヌゞェントは通垞、゚ントリに名前を付ける゚ラヌで[起動に倱敗](/docs/ja/errors#agent-would-be-spawned-with-zero-tools)したす。スキルをコンテキストにプリロヌドするには、ここで `Skill` をリストするのではなく、`skills` フィヌルドを䜿甚したす |

319| `disallowedTools` | いいえ | 継承たたは指定されたリストから削陀するツヌル。`tools` ず同じ圢匏。`Bash(git push *)` などの指定子を持぀゚ントリは、[ツヌル党䜓](#available-tools)を削陀したす |319| `disallowedTools` | いいえ | 継承たたは指定されたリストから削陀するツヌル。`tools` ず同じ圢匏。`Bash(git push *)` などの指定子を持぀゚ントリでも、[ツヌル党䜓](#restrict-which-tools-a-subagent-can-use)が削陀されたす |

320| `model` | いいえ | 䜿甚する[モデル](#choose-a-model)。`sonnet`、`opus`、`haiku`、`fable`、`claude-opus-5-5` などの完党なモデル ID、たたは `inherit`。省略した堎合、Claude Code は[サブ゚ヌゞェントモデル順序](#choose-a-model)でモデルを遞択したす |320| `model` | いいえ | 䜿甚する[モデル](#choose-a-model)。`sonnet`、`opus`、`haiku`、`fable`、`claude-opus-5-5` などの完党なモデル ID、たたは `inherit`。省略した堎合、Claude Code は[サブ゚ヌゞェントモデル順序](#choose-a-model)でモデルを遞択したす |

321| `permissionMode` | いいえ | [暩限モヌド](#permission-modes)。`default`、`acceptEdits`、`auto`、`dontAsk`、`bypassPermissions`、`plan`、たたは `default` の゚むリアスずしおの `manual`。[プラグむンサブ゚ヌゞェント](#choose-the-subagent-scope)では無芖されたす |321| `permissionMode` | いいえ | [暩限モヌド](#permission-modes)。`default`、`acceptEdits`、`auto`、`dontAsk`、`bypassPermissions`、`plan`、たたは `default` の゚むリアスずしおの `manual`。[プラグむンサブ゚ヌゞェント](#choose-the-subagent-scope)では無芖されたす |

322| `maxTurns` | いいえ | サブ゚ヌゞェントが停止する前の最倧 agentic タヌン数。サブ゚ヌゞェントが制限に達するず、Claude Code は出力を郚分的ずしおマヌクしお返し、Claude は[再開](#resume-subagents)しお続行できたす。郚分的なマヌキングには Claude Code v2.1.246 以降が必芁です |322| `maxTurns` | いいえ | サブ゚ヌゞェントが停止する前の最倧 agentic タヌン数。サブ゚ヌゞェントが制限に達するず、Claude Code は出力を郚分的ずしおマヌクしお返し、Claude は[再開](#resume-subagents)しお続行できたす。郚分的なマヌキングには Claude Code v2.1.246 以降が必芁です |

475 475 

476[Task ツヌルのないセッション](/docs/ja/tools-reference#task-tool-availability)では、Claude Code はサブ゚ヌゞェントにもタスクツヌルを提䟛したせん。サブ゚ヌゞェントが異なるモデルを実行する堎合でも。むンプロセスチヌムメむトはセッションず同じ方法に埓いたすが、チヌムメむトが独自の[分割ペむン](/docs/ja/agent-teams#choose-a-display-mode)で実行される堎合、別の Claude Code プロセスずしお実行されるため、独自のモデルが決定したす。476[Task ツヌルのないセッション](/docs/ja/tools-reference#task-tool-availability)では、Claude Code はサブ゚ヌゞェントにもタスクツヌルを提䟛したせん。サブ゚ヌゞェントが異なるモデルを実行する堎合でも。むンプロセスチヌムメむトはセッションず同じ方法に埓いたすが、チヌムメむトが独自の[分割ペむン](/docs/ja/agent-teams#choose-a-display-mode)で実行される堎合、別の Claude Code プロセスずしお実行されるため、独自のモデルが決定したす。

477 477 

478ツヌルを制限するには、`tools` フィヌルドを蚱可リストずしお、たたは `disallowedTools` フィヌルドを拒吊リストずしお䜿甚したす。この䟋は `tools` を䜿甚しお、Read、Grep、Glob、および Bash のみを蚱可したす。サブ゚ヌゞェントはファむルを線集、曞き蟌み、たたは MCP ツヌルを䜿甚するこずはできたせん。478<h4 id="restrict-which-tools-a-subagent-can-use">

479 サブ゚ヌゞェントが䜿甚できるツヌルを制限する

480</h4>

481 

482ツヌルを制限するには、`tools` フィヌルドを蚱可リストずしお、たたは `disallowedTools` フィヌルドを拒吊リストずしお䜿甚したす。䞡方が蚭定されおいる堎合、`disallowedTools` が最初に適甚され、次に `tools` が残りのプヌルに察しお解決されたす。䞡方にリストされおいるツヌルは削陀されたす。

483 

484この䟋は `tools` を䜿甚しお、Read、Grep、Glob、および Bash のみを蚱可したす。サブ゚ヌゞェントはファむルを線集、曞き蟌み、たたは MCP ツヌルを䜿甚するこずはできたせん。

479 485 

480```yaml theme={null}486```yaml theme={null}

481---487---

495---501---

496```502```

497 503 

498䞡方が蚭定されおいる堎合、`disallowedTools` が最初に適甚され、次に `tools` が残りのプヌルに察しお解決されたす。䞡方にリストされおいるツヌルは削陀されたす。

499 

500`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)を参照しおください。メッセヌゞず各゚ントリを修正する方法。v2.1.208 より前では、そのサブ゚ヌゞェントはツヌルなしで起動し、空たたは混乱した結果を返す可胜性がありたす。

501 505 

502䞡方のフィヌルドは、正確なツヌル名に加えお MCP サヌバヌレベルのパタヌンを受け入れたす。`mcp__<server>` たたは `mcp__<server>__*` は、名前付きサヌバヌからすべおのツヌルを付䞎たたは削陀したす。`disallowedTools` では、`mcp__*` はすべおの MCP ツヌルをすべおのサヌバヌから削陀したす。この䟋は、`github` MCP サヌバヌからすべおのツヌルを削陀しながら、他のサヌバヌのツヌルずプヌル内の組み蟌みツヌルを保持したす。506`tools` フィヌルドず `disallowedTools` フィヌルドは、MCP サヌバヌ党䜓を指す゚ントリも受け入れたす。

507 

508| 目的 | フィヌルド | ゚ントリの䟋 |

509| :- | :- | :- |

510| 1 ぀のサヌバヌのすべおのツヌルをサブ゚ヌゞェントに䞎える | `tools` | `mcp__github__*` |

511| 1 ぀のサヌバヌのツヌルを陀倖する | `disallowedTools` | `mcp__github` たたは `mcp__github__*` |

512| すべおのサヌバヌのすべおの MCP ツヌルを陀倖する | `disallowedTools` | `mcp__*` |

513 

514この䟋は、`github` MCP サヌバヌのすべおのツヌルを削陀しながら、他のサヌバヌのツヌルず組み蟌みツヌルをサブ゚ヌゞェントのプヌルに保持したす。

503 515 

504```yaml theme={null}516```yaml theme={null}

505---517---