SpyBara
Go Premium

Documentation 2026-10-20 23:00 UTC to 2026-10-21 23:02 UTC

86 files changed +2,235 −1,306. 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

admin-setup.md +43 −43

Details

81 81 

82WSL 2 ナヌティリティ VM 内のプロセスは、Windows 偎の゚ンドポむント怜出センサヌに衚瀺されたせん。ディストリビュヌション内のプロセスずファむルアクティビティを芳察するには、゚ンドポむント怜出ベンダヌの WSL ガむダンスで、ディストリビュヌション内で実行できる Linux センサヌず、それが必芁ずする陀倖を確認しおください。Claude Code の [OpenTelemetry ツヌル実行テレメトリ](/docs/ja/monitoring-usage)は WSL ずネむティブセッションで同じように出力されたす。82WSL 2 ナヌティリティ VM 内のプロセスは、Windows 偎の゚ンドポむント怜出センサヌに衚瀺されたせん。ディストリビュヌション内のプロセスずファむルアクティビティを芳察するには、゚ンドポむント怜出ベンダヌの WSL ガむダンスで、ディストリビュヌション内で実行できる Linux センサヌず、それが必芁ずする陀倖を確認しおください。Claude Code の [OpenTelemetry ツヌル実行テレメトリ](/docs/ja/monitoring-usage)は WSL ずネむティブセッションで同じように出力されたす。

83 83 

84## 実装する内容を決定する84## 適甚する内容を決める

85 85 

86マネヌゞド蚭定は、ツヌル、サンドボックス実行、MCP サヌバヌずプラグむン゜ヌス、および実行するフック を制限できたす。各行は、それを駆動する蚭定キヌを持぀制埡サヌフェスです。86管理蚭定では、ツヌルのロックダりン、実行のサンドボックス化、MCP サヌバヌやプラグむン゜ヌスの制限、実行するフックの制埡を行えたす。各行は制埡察象ずそれを動かす蚭定キヌを瀺しおいたす。

87 87 

88| 制埡 | 機胜 | キヌ蚭定 |88| 制埡 | 内容 | 䞻な蚭定 |

89| :- | :- | :- |89| :- | :- | :- |

90| [暩限ルヌル](/docs/ja/permissions) | 特定のツヌルずコマンドを蚱可、確認、たたは拒吊する | `permissions.allow`、`permissions.deny` |90| [暩限ルヌル](/docs/ja/permissions) | 特定のツヌルやコマンドを蚱可、確認、たたは拒吊したす | `permissions.allow`、`permissions.deny` |

91| [暩限ロックダりン](/docs/ja/permissions#managed-only-settings) | マネヌゞド蚭定を[暩限ルヌルの唯䞀の蚭定゜ヌス](/docs/ja/settings-reference#allowmanagedpermissionrulesonly)にしたす。`--dangerously-skip-permissions` を無効にする | `allowManagedPermissionRulesOnly`、`permissions.disableBypassPermissionsMode` |91| [暩限のロックダりン](/docs/ja/permissions#managed-only-settings) | 管理蚭定を[暩限ルヌルの唯䞀の蚭定゜ヌス](/docs/ja/settings-reference#allowmanagedpermissionrulesonly)にしたす。`--dangerously-skip-permissions` を無効にしたす | `allowManagedPermissionRulesOnly`、`permissions.disableBypassPermissionsMode` |

92| [開始暩限モヌド](/docs/ja/permission-modes#which-mode-a-session-starts-in) | 組み蟌みの開始暩限モヌドの代わりに、開発者のタヌミナルセッションが開始する暩限モヌドを遞択するか、自動モヌドを削陀したす。[暩限モヌドの切り替え](/docs/ja/permission-modes#switch-permission-modes)は、VS Code 拡匵機胜が `defaultMode` を読み取る時期を䞀芧衚瀺したす | `permissions.defaultMode`、`permissions.disableAutoMode` |92| [開始時の暩限モヌド](/docs/ja/permission-modes#which-mode-a-session-starts-in) | 組み蟌みの開始時暩限モヌドの代わりに、開発者のタヌミナルセッションが開始する暩限モヌドを遞択するか、auto モヌドを削陀したす。VS Code 拡匵機胜が蚭定された `defaultMode` を読み蟌むタむミングに぀いおは、[暩限モヌドの切り替え](/docs/ja/permission-modes#switch-permission-modes)を参照しおください | `permissions.defaultMode`、`permissions.disableAutoMode` |

93| [サンドボックス](/docs/ja/sandboxing) | ドメむン蚱可リスト付きの OS レベルのファむルシステムずネットワヌク分離 | `sandbox.enabled`、`sandbox.network.allowedDomains` |93| [サンドボックス化](/docs/ja/sandboxing) | ドメむン蚱可リストを䜿甚した OS レベルのファむルシステムおよびネットワヌクの分離 | `sandbox.enabled`、`sandbox.network.allowedDomains` |

94| [マネヌゞドポリシヌ CLAUDE.md](/docs/ja/memory#deploy-organization-wide-claude-md) | すべおのセッションで読み蟌たれる組織党䜓の指瀺。陀倖できたせん | マネヌゞドポリシヌパスのファむル |94| [管理ポリシヌの CLAUDE.md](/docs/ja/memory#deploy-organization-wide-claude-md) | クラむアントで匷制されるルヌルではなく、組織党䜓で Claude に䞎える動䜜のガむダンス | 管理ポリシヌのパスに眮くファむル |

95| [MCP サヌバヌ制埡](/docs/ja/managed-mcp) | ナヌザヌが远加たたは接続できる MCP サヌバヌを制限し、固定セットをデプロむするか、リモヌトサヌバヌをすべおのナヌザヌに提䟛したす | `allowedMcpServers`、`deniedMcpServers`、`allowManagedMcpServersOnly`、`managedMcpServers`、たたはデプロむされた `managed-mcp.json` ファむル |95| [MCP サヌバヌの制埡](/docs/ja/managed-mcp) | ナヌザヌが远加たたは接続できる MCP サヌバヌを制限したり、固定のセットをデプロむしたり、各ナヌザヌ自身のサヌバヌに加えおリモヌトサヌバヌを党ナヌザヌに提䟛したりしたす | `allowedMcpServers`、`deniedMcpServers`、`allowManagedMcpServersOnly`、`managedMcpServers`、たたはデプロむされた `managed-mcp.json` ファむル |

96| [プラグむンマヌケットプレむス制埡](/docs/ja/plugins/org#restrict-what-users-can-install) | ナヌザヌが远加およびむンストヌルできるマヌケットプレむス゜ヌスを制限し、単䞀実行のためにプラグむン、゚ヌゞェント、MCP サヌバヌをサむドロヌドする CLI フラグを拒吊し、[`command` プラグむン゜ヌス](/docs/ja/plugins/marketplace-reference#command-plugin-source)をブロックし、どのマヌケットプレむスのプラグむンを提案できるかをホワむトリストに登録したす | `strictKnownMarketplaces`、`blockedMarketplaces`、`disableSideloadFlags`、`disableCommandPluginSources`、`pluginSuggestionMarketplaces` |96| [プラグむンマヌケットプレむスの制埡](/docs/ja/plugins/org#restrict-what-users-can-install) | ナヌザヌが远加およびむンストヌルできるマヌケットプレむス゜ヌスを制限し、単䞀の実行のためにプラグむン、゚ヌゞェント、MCP サヌバヌをサむドロヌドする CLI フラグを拒吊し、[`command` プラグむン゜ヌス](/docs/ja/plugins/marketplace-reference#command-plugin-source)をブロックし、どのマヌケットプレむスのプラグむンを提案できるかを蚱可リストで指定したす | `strictKnownMarketplaces`、`blockedMarketplaces`、`disableSideloadFlags`、`disableCommandPluginSources`、`pluginSuggestionMarketplaces` |

97| [カスタマむズロックダりン](/docs/ja/settings-reference#strictpluginonlycustomization) | スキル、゚ヌゞェント、フック、MCP サヌバヌをナヌザヌおよびプロゞェクト゜ヌスからブロックし、プラグむンたたはマネヌゞド蚭定からのみ取埗できるようにしたす。スキルをロックするず、開発者が claude.ai で有効にした[スキル](/docs/ja/skills#where-synced-skills-load)の同期も停止したす | `strictPluginOnlyCustomization` |97| [カスタマむズのロックダりン](/docs/ja/settings-reference#strictpluginonlycustomization) | ナヌザヌおよびプロゞェクトの゜ヌスからのスキル、゚ヌゞェント、フック、MCP サヌバヌをブロックし、プラグむンたたは管理蚭定からのみ提䟛されるようにしたす。スキルをロックするず、[開発者が claude.ai で有効にしたスキル](/docs/ja/skills#where-synced-skills-load)の同期も停止したす | `strictPluginOnlyCustomization` |

98| [claude.ai 同期を無効にする](/docs/ja/settings-reference#syncclaudeaiskills) | Claude Code が開発者が claude.ai で有効にした[スキル](/docs/ja/skills#how-synced-skills-behave)ず[プラグむン](/docs/ja/plugins/loading#synced-plugins)を読み蟌むのを停止したす。組織の claude.ai でスキルをオフにするず、Claude Code は䞡方の同期を停止したす。v2.1.273 以降では、既に同期したものも削陀したす。スキルをオフにせずにどちらか䞀方を停止するには、マネヌゞド蚭定でそのキヌを `false` に蚭定したす | `syncClaudeAiSkills`、`syncClaudeAiPlugins` |98| [claude.ai 同期の無効化](/docs/ja/settings-reference#syncclaudeaiskills) | 開発者が claude.ai で有効にした[スキル](/docs/ja/skills#how-synced-skills-behave)ず[プラグむン](/docs/ja/plugins/loading#synced-plugins)を Claude Code が読み蟌たないようにしたす。claude.ai で組織の Skills をオフにするず、Claude Code は䞡方の同期を停止し、v2.1.273 以降では同期枈みのものも削陀したす。Skills をオフにせずにいずれかを停止するには、管理蚭定でそのキヌを `false` に蚭定したす | `syncClaudeAiSkills`、`syncClaudeAiPlugins` |

99| [フック制限](/docs/ja/settings-reference#allowmanagedhooksonly) | 実行するフックを制限し、HTTP フック URL を制限したす。[`allowManagedHooksOnly` で実行される内容](/docs/ja/settings-reference#what-runs-under-allowmanagedhooksonly)の完党な効果リストを参照しおください | `allowManagedHooksOnly`、`allowedHttpHookUrls` |99| [フックの制限](/docs/ja/settings-reference#allowmanagedhooksonly) | 実行するフックず HTTP フックの URL を制限したす。圱響の党䞀芧は [`allowManagedHooksOnly` で実行されるもの](/docs/ja/settings-reference#what-runs-under-allowmanagedhooksonly)を参照しおください | `allowManagedHooksOnly`、`allowedHttpHookUrls` |

100| [ログむン匷制](/docs/ja/settings-reference#forceloginmethod) | ログむンを特定の方法たたは Anthropic 組織に制限したす。メ゜ッド制限は VS Code 拡匵機胜、Agent SDK、`claude setup-token`、`/install-github-app` 党䜓に適甚され、タヌミナルのむンタラクティブログむン画面`/login` たたは初回オンボヌディングで到達はメ゜ッドを事前遞択したすが匷制したせん。Claude Code は、タヌミナル、VS Code 拡匵機胜、Agent SDK での claude.ai アカりントログむンの組織を怜蚌し、Claude Console ログむンたたは[ゲヌトりェむ](/docs/ja/claude-apps-gateway)サむンむンではチェックしたせん。v2.1.212 より前は、タヌミナルログむンのみが䞡方のキヌを適甚しおいたした。蚭定するず、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、たたは `apiKeyHelper` によっお認蚌されたセッションはスタヌトアップでブロックされたす。クラりドプロバむダヌセッションは圱響を受けたせん | `forceLoginMethod`、`forceLoginOrgUUID` |100| [ログむンの匷制](/docs/ja/settings-reference#forceloginmethod) | ログむンを特定の方法たたは Anthropic 組織に制限したす。方法の制限は VS Code 拡匵機胜、Agent SDK、`claude setup-token`、`/install-github-app` 党䜓に適甚されたす。`/login` たたは初回のオンボヌディングで衚瀺されるタヌミナルの察話型ログむン画面では、その方法が事前に遞択されたすが、匷制はされたせん。Claude Code は、タヌミナル、VS Code 拡匵機胜、Agent SDK での claude.ai アカりントのログむンに぀いお組織を怜蚌したすが、Claude Console のログむンや[ゲヌトりェむ](/docs/ja/claude-apps-gateway)のサむンむンに぀いおは確認したせん。v2.1.212 より前は、いずれのキヌもタヌミナルのログむンにのみ適甚されおいたした。蚭定されおいる堎合、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、たたは `apiKeyHelper` で認蚌されたセッションは起動時にブロックされたす。クラりドプロバむダヌのセッションは圱響を受けたせんが、これらの認蚌情報のいずれか、たたは以前の Claude Console ログむンで保存された API キヌも存圚する堎合は䟋倖ずしおブロックされたす | `forceLoginMethod`、`forceLoginOrgUUID` |

101| [プロバむダヌ制限](/docs/ja/settings-reference#allowedproviders) | マシンが䜿甚できる API プロバむダヌを制限したす。リストに蚘茉されおいないプロバむダヌ䞊のセッションはスタヌトアップ時、ログむン時、および次に API に接続するずきに拒吊されたす。Claude Code v2.1.285 以降が必芁です | `allowedProviders` |101| [プロバむダヌの制限](/docs/ja/settings-reference#allowedproviders) | マシンが䜿甚できる API プロバむダヌを制限したす。リストにないプロバむダヌのセッションは、起動時、ログむン時、および次に API に接続したずきに拒吊されたす。Claude Code v2.1.285 以降が必芁です | `allowedProviders` |

102| [゚ヌゞェントビュヌを無効にする](/docs/ja/agent-view#how-background-sessions-are-hosted) | `claude agents`、`--bg`、`/background`、およびオンデマンドスヌパヌバむザヌをオフにしたす | `disableAgentView` |102| [゚ヌゞェントビュヌの無効化](/docs/ja/agent-view#how-background-sessions-are-hosted) | `claude agents`、`--bg`、`/background`、およびオンデマンドのスヌパヌバむザヌをオフにしたす | `disableAgentView` |

103| [䌁業ランチャヌを構成する](/docs/ja/corporate-launcher) | [バックグラりンド゚ヌゞェントスヌパヌバむザヌ](/docs/ja/agent-view#how-background-sessions-are-hosted)、そのワヌカヌ、および[その他のカバヌされたバックグラりンドプロセス](/docs/ja/corporate-launcher#what-the-launcher-covers)に、゚ヌゞェントビュヌをオフにする代わりに、必須の䌁業ランチャヌをプレフィックスしたす | `processWrapper` |103| [䌁業ランチャヌの蚭定](/docs/ja/corporate-launcher) | ゚ヌゞェントビュヌをオフにする代わりに、[バックグラりンド゚ヌゞェントのスヌパヌバむザヌ](/docs/ja/agent-view#how-background-sessions-are-hosted)、そのワヌカヌ、および[察象ずなるその他のバックグラりンドプロセス](/docs/ja/corporate-launcher#what-the-launcher-covers)の前に、必須の䌁業ランチャヌを付加したす | `processWrapper` |

104| [モデル制限](/docs/ja/model-config#restrict-model-selection) | `availableModels` はピッカヌに衚瀺されるモデルをフィルタリングしたす。`enforceAvailableModels` を远加するず、自動遞択されたデフォルトモデルも制限されたす。このセッティングが CLI、りェブ、IDE にどのように到達するかに぀いおは、[サヌフェスカバレッゞ](/docs/ja/model-config#surface-coverage)を参照しおください | `availableModels`、`enforceAvailableModels` |104| [モデルの制限](/docs/ja/model-config#restrict-model-selection) | `availableModels` はピッカヌに衚瀺されるモデルを絞り蟌みたす。`enforceAvailableModels` を远加するず、自動遞択されるデフォルトモデルも制玄されたす。この蚭定が CLI、Web、IDE にどのように適甚されるかは[サヌフェスの察応範囲](/docs/ja/model-config#surface-coverage)を参照しおください | `availableModels`、`enforceAvailableModels` |

105| [゚フォヌトキャップ](/docs/ja/settings-reference#maxeffortlevel) | すべおのモデルたたはモデルごずに、すべおのプロバむダヌで[゚フォヌトレベル](/docs/ja/model-config#adjust-effort-level)をキャップしたす | `maxEffortLevel` |105| [effort の䞊限](/docs/ja/settings-reference#maxeffortlevel) | すべおのプロバむダヌで、すべおのモデルたたはモデルごずに [effort レベル](/docs/ja/model-config#adjust-effort-level)の䞊限を蚭定したす | `maxEffortLevel` |

106| [バヌゞョンフロア](/docs/ja/settings-reference#minimumversion) | 自動曎新が組織党䜓の最小倀以䞋をむンストヌルするのを防ぎたす | `minimumVersion` |106| [バヌゞョンの䞋限](/docs/ja/settings-reference#minimumversion) | 組織党䜓の最小バヌゞョンを䞋回るバヌゞョンが自動曎新でむンストヌルされないようにしたす | `minimumVersion` |

107| [必須バヌゞョン範囲](/docs/ja/settings-reference#requiredminimumversion) | 実行䞭のバヌゞョンが組織承認範囲倖の堎合、たったく起動を拒吊したす。ダりングレヌドのみをブロックする `minimumVersion` より匷力です | `requiredMinimumVersion`、`requiredMaximumVersion` |107| [必須バヌゞョン範囲](/docs/ja/settings-reference#requiredminimumversion) | 実行䞭のバヌゞョンが組織で承認された範囲倖の堎合、起動自䜓を拒吊したす。ダりングレヌドのみをブロックする `minimumVersion` よりも匷力です | `requiredMinimumVersion`、`requiredMaximumVersion` |

108| [テレメトリオプトアりト](/docs/ja/data-usage#telemetry-services) | すべおのデバむスで Anthropic バりンドの䜿甚メトリクス、゚ラヌレポヌト、およびサヌベむをオフにしたす | `env` に `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` を `1` に蚭定したす。リンクされたセクションはカテゎリごずの倉数を䞀芧衚瀺したす |108| [テレメトリのオプトアりト](/docs/ja/data-usage#telemetry-services) | すべおのデバむスで、Anthropic に送信される䜿甚状況メトリクス、゚ラヌレポヌト、アンケヌトをオフにしたす | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` を `1` に蚭定した `env`。カテゎリごずの倉数はリンク先のセクションに蚘茉されおいたす |

109 109 

110メンバヌが claude.ai たたは Anthropic API を通じおサむンむンし、Claude Enterprise プランを䜿甚しおいる堎合、䜕もデプロむせずに組織の管理者蚭定からモデルを管理するこずもできたす。110メンバヌが claude.ai たたは Anthropic API 経由でサむンむンし、Claude Enterprise プランを利甚しおいる堎合は、䜕もデプロむせずに組織の管理蚭定からモデルを管理するこずもできたす。

111 111 

112* [組織モデル制限](/docs/ja/model-config#organization-model-restrictions)個別のモデルを無効にしたす。サヌバヌ偎で匷制されたす。112* [組織のモデル制限](/docs/ja/model-config#organization-model-restrictions)個々のモデルを無効にしたす。サヌバヌ偎で匷制されたす。

113* [組織デフォルトモデル](/docs/ja/model-config#organization-default-model)新しいセッションが開始するモデルを蚭定したす。メンバヌは匕き続きモデルを切り替えるこずができたす。起動時にメンバヌを組織のデフォルトに戻すには、そのセクションで説明されおいる䞊曞きをオンにしたす。メンバヌが遞択できるモデルを制限するには、[組織モデル制限](/docs/ja/model-config#organization-model-restrictions)を䜿甚したす。113* [組織のデフォルトモデル](/docs/ja/model-config#organization-default-model)新しいセッションが開始するモデルを蚭定したす。メンバヌは匕き続きモデルを切り替えられたす。起動時にデフォルトに戻すには、そのセクションで説明しおいる䞊曞きをオンにしたす。メンバヌが遞択できるモデルを制限するには、[組織のモデル制限](/docs/ja/model-config#organization-model-restrictions)を䜿甚したす。

114* [組織゚フォヌト制限](/docs/ja/model-config#organization-effort-limits)ロヌルごずの゚フォヌトレベルをキャップしたす。サヌバヌ偎で匷制されたす。114* [組織の effort 制限](/docs/ja/model-config#organization-effort-limits)ロヌルごずに effort レベルの䞊限を蚭定したす。サヌバヌ偎で匷制されたす。

115 115 

116これらの制埡は、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、たたは[AWS 䞊の Claude Platform](/docs/ja/claude-platform-on-aws)のセッションには到達したせん。これらのプロバむダヌでは、代わりにマネヌゞド蚭定を䜿甚しおください。制限には `availableModels`、デフォルトには `model`、゚フォヌトキャップには [`maxEffortLevel`](/docs/ja/settings-reference#maxeffortlevel) を䜿甚したす。116これらの制埡はいずれも、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、たたは [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) 䞊のセッションには適甚されたせん。これらのプロバむダヌでは、代わりに管理蚭定を䜿甚しおください。制限には `availableModels`、デフォルトには `model`、effort の䞊限には [`maxEffortLevel`](/docs/ja/settings-reference#maxeffortlevel) を䜿甚したす。

117 117 

118[クラりドセッション](/docs/ja/claude-code-on-the-web)には、claude.ai 䞊に独自の管理サヌフェスがありたす。118[クラりドセッション](/docs/ja/claude-code-on-the-web)には、claude.ai 䞊に独自の管理画面がありたす。

119 119 

120* **クラりド環境ペヌゞ**オヌナヌは[組織共有環境](/docs/ja/cloud-environments#organization-shared-environments)を䜜成し、メンバヌのクラりドセッションの[ネットワヌクアクセスレベル](/docs/ja/cloud-environments#network-access)、環境倉数、セットアップスクリプトを蚭定したす。120* **クラりド環境ペヌゞ**Owner は、メンバヌのクラりドセッションの[ネットワヌクアクセスレベル](/docs/ja/cloud-environments#network-access)、環境倉数、セットアップスクリプトを蚭定する[組織共有環境](/docs/ja/cloud-environments#organization-shared-environments)を䜜成したす。

121* **デフォルト環境**オヌナヌは、[claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) で組織のデフォルト環境を別途遞択したす。121* **デフォルト環境**Owner は、組織のデフォルト環境を [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) で別途遞択したす。

122* **Git providers ペヌゞ**組織にリンクされおいる GitHub アカりントに぀いおは、[接続された GitHub アカりント](#connected-github-accounts)を参照しおください。122* **Git プロバむダヌペヌゞ**組織にリンクされた GitHub アカりントに぀いおは、[接続された GitHub アカりント](#connected-github-accounts)を参照しおください。

123 123 

124暩限ルヌルずサンドボックスは異なるレむダヌをカバヌしたす。WebFetch を拒吊するず Claude のフェッチツヌルがブロックされたすが、Bash が蚱可されおいる堎合、`curl` ず `wget` は䟝然ずしお任意の URL に到達できたす。サンドボックスは、OS レベルで匷制されるネットワヌクドメむン蚱可リストでそのギャップを閉じたす。124暩限ルヌルずサンドボックス化は異なるレむダヌを察象ずしたす。WebFetch を拒吊するず Claude のフェッチツヌルはブロックされたすが、Bash が蚱可されおいる堎合、`curl` や `wget` は匕き続き任意の URL にアクセスできたす。サンドボックス化は、OS レベルで匷制されるネットワヌクドメむンの蚱可リストによっおこのギャップを埋めたす。

125 125 

126これらの制埡が防埡する脅嚁モデルに぀いおは、[セキュリティ](/docs/ja/security)を参照しおください。126これらの制埡が防埡する脅嚁モデルに぀いおは、[セキュリティ](/docs/ja/security)を参照しおください。

127 127 

128### 接続された GitHub アカりント128### 接続された GitHub アカりント

129 129 

130Team プランず Enterprise プランでは、[**Organization settings > Git providers**](https://claude.ai/admin-settings/source-control) の GitHub セクションに、[Claude GitHub App](https://github.com/apps/claude) を通じお Claude 組織にリンクされおいる GitHub 組織ず個人アカりントが䞀芧衚瀺されたす。Claude Code、[Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github)、Claude Security はこのリストを共有したす。このペヌゞを開くには、Claude 組織での管理者ロヌルが必芁です。130Team プランず Enterprise プランでは、[**Organization settings > Git providers**](https://claude.ai/admin-settings/source-control) の GitHub セクションに、[Claude GitHub App](https://github.com/apps/claude) を通じお Claude 組織にリンクされた GitHub 組織ず個人アカりントが䞀芧衚瀺されたす。Claude Code、[Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github)、Claude Security はこの䞀芧を共有したす。このペヌゞを開くには、Claude 組織の管理者ロヌルが必芁です。

131 131 

132アカりントは管理者たたはメンバヌがリンクできたす。132アカりントは管理者たたはメンバヌがリンクできたす。

133 133 

134* **管理者による接続**管理者がこのセクションで **Connect** をクリックするか、アカりントが接続枈みの堎合は **Add organization** をクリックしお、GitHub 組織に Claude GitHub App をむンストヌルしたす。この方法で組織をリンクするには、GitHub 組織のオヌナヌであり、か぀ Claude 組織の管理者でもある人物が必芁です。134* **管理者による接続**管理者がそのセクションで **Connect** をクリックするか、アカりントが接続枈みの堎合は **Add organization** をクリックし、GitHub 組織に Claude GitHub App をむンストヌルしたす。この方法で組織をリンクするには、GitHub 組織の Owner であり、か぀ Claude 組織の管理者でもあるナヌザヌが必芁です。

135* **メンバヌによる接続**メンバヌが GitHub アカりントを Claude に接続するずたずえば[クラりドセッションのセットアップ](/docs/ja/web-quickstart#connect-github)䞭など、Claude は、そのメンバヌが所有し、Claude GitHub App が既にむンストヌルされおいる GitHub アカりントをリンクしたす。これには、メンバヌの個人アカりントや、メンバヌが所有する GitHub 組織が含たれる堎合がありたす。135* **メンバヌによる接続**メンバヌが自分の GitHub アカりントを Claude に接続するずたずえば[クラりドセッションのセットアップ](/docs/ja/web-quickstart#connect-github)䞭、Claude は、そのメンバヌが所有し、Claude GitHub App がすでにむンストヌルされおいる GitHub アカりントをリンクしたす。これには、メンバヌの個人アカりントや、メンバヌが所有する GitHub 組織が含たれる堎合がありたす。

136 136 

137**Not linked** ずマヌクされた行は、ナヌザヌ自身の GitHub サむンむンに由来するものです。これは、Claude GitHub App がむンストヌルされおいる、ナヌザヌが GitHub 䞊で参照できるアカりントです。137**Not linked** ず衚瀺されおいる行は、自分自身の GitHub サむンむンに由来するものです。これは、GitHub 䞊で自分が参照でき、Claude GitHub App がむンストヌルされおいるアカりントです。

138 138 

139Claude 組織からアカりントのリンクを解陀するには、その行のメニュヌを開き、**Unlink from this workspace** を遞択したす。リンクを解陀しおも Claude GitHub App は GitHub 䞊にむンストヌルされたたたずなり、そのアカりントのオヌナヌの誰かが次に GitHub を Claude に接続したずきに、アカりントは再びリンクされたす。再びリンクされないようにするには、GitHub 䞊でそのアカりントから Claude GitHub App をアンむンストヌルしおください。139Claude 組織からアカりントのリンクを解陀するには、その行のメニュヌを開いお **Unlink from this workspace** を遞択したす。リンクを解陀しおも Claude GitHub App は GitHub 䞊にむンストヌルされたたたであり、そのアカりントのいずれかの Owner が次に GitHub を Claude に接続するず、アカりントは再びリンクされたす。再びリンクされないようにするには、GitHub 䞊でそのアカりントから Claude GitHub App をアンむンストヌルしおください。

140 140 

141Enterprise プランでは、リンクおよびリンク解陀に察応する [Compliance API](https://platform.claude.com/docs/en/api/compliance/activities/list) のアクティビティタむプは `github_app_installation_linked` ず `github_app_installation_unlinked` です。141Enterprise プランでは、リンクおよびリンク解陀に察応する [Compliance API](https://platform.claude.com/docs/en/api/compliance/activities/list) のアクティビティタむプは `github_app_installation_linked` ず `github_app_installation_unlinked` です。

142 142 

advisor.md +1 −1

Details

83 83 

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

85 85 

86リク゚ストされたモデルが advisor ずしお機胜できるものの、セッションのメむンモデルより[䞋䜍にランク付けされおいる](#choose-an-advisor-model)堎合でも、Claude Code はセッションを開始したす。バックグラりンドセッション以倖では、そのモデルがメむンモデルに察しお `cannot advise` であるずいう譊告も起動時に衚瀺したす。86枡したモデルが advisor ずしお機胜できるものの、メむンモデルより[䞋䜍にランク付けされおいる](#choose-an-advisor-model)堎合、バックグラりンドセッションかどうかにかかわらずセッションは開始されたす。その堎合、メむンモデルは advisor なしで実行されたす。

87 87 

88## アドバむザヌモデルを遞択する88## アドバむザヌモデルを遞択する

89 89 

Details

20 20 

21[`claude-agent-sdk-demos`](https://github.com/anthropics/claude-agent-sdk-demos) のアプリケヌションは、メヌルクラむアントからマルチ゚ヌゞェント研究システムたで、ロヌカル開発甚のデモです。構築しおいるものの圢状に合臎するデモをクロヌンしおください。21[`claude-agent-sdk-demos`](https://github.com/anthropics/claude-agent-sdk-demos) のアプリケヌションは、メヌルクラむアントからマルチ゚ヌゞェント研究システムたで、ロヌカル開発甚のデモです。構築しおいるものの圢状に合臎するデモをクロヌンしおください。

22 22 

23## 完党なプロゞェクトをフォヌクする

24 

25Python SDK でショッピング゚ヌゞェントやマヌチャント゚ヌゞェントを構築するには、[Claude for commerce リファレンス実装](https://platform.claude.com/docs/ja/about-claude/use-case-guides/commerce-agents)から始めおください。

26 

23## Python レシピを実行する27## Python レシピを実行する

24 28 

25Claude Cookbook の Agent SDK シリヌズは、各レシピが Python ノヌトブックである䞀連のレシピで、シンプルな研究゚ヌゞェントから掗緎されたマルチ゚ヌゞェントシステムぞず進行したす。各ノヌトブックは前のものに基づいおおり、新しい抂念ず機胜を導入したす。[ワンラむナヌ研究゚ヌゞェント](https://platform.claude.com/cookbook/claude-agent-sdk-00-the-one-liner-research-agent) から始めお、前に進んでください。29Claude Cookbook の Agent SDK シリヌズは、各レシピが Python ノヌトブックである䞀連のレシピで、シンプルな研究゚ヌゞェントから掗緎されたマルチ゚ヌゞェントシステムぞず進行したす。各ノヌトブックは前のものに基づいおおり、新しい抂念ず機胜を導入したす。[ワンラむナヌ研究゚ヌゞェント](https://platform.claude.com/cookbook/claude-agent-sdk-00-the-one-liner-research-agent) から始めお、前に進んでください。

agent-sdk/hooks.md +1 −0

Details

638 638 

639* [`permission_prompt`](/docs/ja/hooks#notification)暩限リク゚ストが [`canUseTool` コヌルバック](/docs/ja/agent-sdk/user-input)で玄 6 秒間埅機した時点で発生したす。TypeScript Agent SDK v0.3.233 以降、たたは Python Agent SDK v0.2.139 以降が必芁です639* [`permission_prompt`](/docs/ja/hooks#notification)暩限リク゚ストが [`canUseTool` コヌルバック](/docs/ja/agent-sdk/user-input)で玄 6 秒間埅機した時点で発生したす。TypeScript Agent SDK v0.3.233 以降、たたは Python Agent SDK v0.2.139 以降が必芁です

640* `elicitation_complete` および `elicitation_response`ナヌザヌぞの入力芁求elicitationフロヌ甚640* `elicitation_complete` および `elicitation_response`ナヌザヌぞの入力芁求elicitationフロヌ甚

641* `plugin_notification`[mod](/docs/ja/plugins/mods/api#show-something-without-starting-a-turn) が `$.ui.notify` を呌び出したずき

641 642 

642`idle_prompt`、`auth_success`、`elicitation_dialog` などのその他のタむプは、SDK セッションでは実行されないむンタラクティブ UI から Claude Code が発行したす。643`idle_prompt`、`auth_success`、`elicitation_dialog` などのその他のタむプは、SDK セッションでは実行されないむンタラクティブ UI から Claude Code が発行したす。

643 644 

agent-sdk/mcp.md +29 −11

Details

142 142 

143## 接続タむミング143## 接続タむミング

144 144 

145Claude Code は `options.mcpServers` で枡すサヌバヌをスタヌトアップ時に登録し、最初のタヌンの埅機存圚する堎合が解決されるず [init メッセヌゞ](#error-handling) を発行したす。各 `options.mcpServers` サヌバヌが最初のタヌンを遅延させるかどうか、および接続するタむミングは、そのタむプによっお異なりたす。145Claude Code はセッション開始時に MCP サヌバヌぞの接続を開始し、最初のタヌンの埅機存圚する堎合が終了するず [init メッセヌゞ](#error-handling) を送信したす。最初のタヌンがサヌバヌをどれだけ埅機するかは、そのサヌバヌをどこで蚭定したかによっお異なりたす。`permissionPromptToolName` を蚭定した堎合、最初のタヌンは、どこで蚭定したかに関わらず、垞にそのツヌルのサヌバヌを `MCP_TIMEOUT` たで埅機したす。

146 

147`options.mcpServers` のサヌバヌに぀いおは、最初の列でそのタむプを確認するず、最初のタヌンがそのサヌバヌをどれだけ埅機するかがわかりたす。

146 148 

147| サヌバヌタむプ | 最初のタヌンを遅延させるか | 最初のタヌン埅機タむムアりト |149| サヌバヌタむプ | 最初のタヌンを遅延させるか | 最初のタヌン埅機タむムアりト |

148| :- | :- | :- |150| :- | :- | :- |

150| キャッシュされたツヌルリストを持぀リモヌトサヌバヌClaude Code が以前の接続から保存 | いいえ。キャッシュされたツヌルは最初のタヌンから利甚可胜 | なし。最初のツヌル呌び出しで接続し、その遅延接続には独自のタむムアりトがありたす |152| キャッシュされたツヌルリストを持぀リモヌトサヌバヌClaude Code が以前の接続から保存 | いいえ。キャッシュされたツヌルは最初のタヌンから利甚可胜 | なし。最初のツヌル呌び出しで接続し、その遅延接続には独自のタむムアりトがありたす |

151| むンプロセス [SDK サヌバヌ](#sdk-mcp-servers) | はい、接続しおツヌルをリストするたで | [`MCP_TIMEOUT`](/docs/ja/env-vars)、デフォルトは 30 秒。接続詊行ごず。接続はその期限で倱敗したす |153| むンプロセス [SDK サヌバヌ](#sdk-mcp-servers) | はい、接続しおツヌルをリストするたで | [`MCP_TIMEOUT`](/docs/ja/env-vars)、デフォルトは 30 秒。接続詊行ごず。接続はその期限で倱敗したす |

152 154 

153[蚭定ファむル](#from-a-config-file)`.mcp.json` などたたはプラグむンから読み蟌たれたサヌバヌは、通垞、init メッセヌゞで `pending` ず衚瀺されたす。`options.mcpServers` が stdio、HTTP、たたは SSE サヌバヌを保持しおいる堎合、最初のタヌンはこれらの保留䞭のサヌバヌも埅機し、`MCP_TIMEOUT` たでです。`options.mcpServers` が空であるか、SDK サヌバヌのみを保持しおいる堎合、最初のタヌンは代わりに最倧 2 秒間埅機したす。155サヌバヌがキャッシュされたツヌルリストを持぀のは、[MCP 怜出キャッシュ](/docs/ja/mcp#server-status-detail) がオンの堎合のみです。

156 

157`.mcp.json` などの [蚭定ファむル](#from-a-config-file) やプラグむンから読み蟌たれたサヌバヌは、init メッセヌゞでただ `pending` ず衚瀺されるこずがよくありたす。最初のタヌンがこれらのサヌバヌをどれだけ埅機するかは、`options.mcpServers` ずツヌル怜玢によっお異なりたす。

158 

159* **`options.mcpServers` に stdio、HTTP、たたは SSE サヌバヌが含たれる堎合**最初のタヌンは、保留䞭の蚭定ファむルおよびプラグむンのサヌバヌも `MCP_TIMEOUT` たで埅機したす。

160* **それ以倖で、`ANTHROPIC_BASE_URL` が [ゲヌトりェむ](/docs/ja/mcp#tool-search-through-a-gateway) を指しおおり、[`ENABLE_TOOL_SEARCH`](/docs/ja/mcp#configure-tool-search) が蚭定されおいない堎合**最初のタヌンは、保留䞭のすべおの蚭定ファむルおよびプラグむンのサヌバヌを最倧 2 秒間埅機したす。

161* **それ以倖で、[ツヌル怜玢](/docs/ja/agent-sdk/tool-search) がオンデフォルトの堎合**最初のタヌンは最倧 2 秒間埅機したすが、察象は [`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) を蚭定した保留䞭のサヌバヌ、たたは [名前を指定した](#named-servers) 保留䞭のサヌバヌのみです。残りのサヌバヌはバックグラりンドで接続を続け、接続埌に Claude は [それらのツヌルに到達したす](/docs/ja/mcp#tool-availability)。

162* **それ以倖で、ツヌル怜玢がオフの堎合**最初のタヌンは、保留䞭のすべおの蚭定ファむルおよびプラグむンのサヌバヌを最倧 2 秒間埅機したす。ツヌル怜玢がオフになるのは、[`ENABLE_TOOL_SEARCH` の倀たたはモデル](/docs/ja/agent-sdk/tool-search#configure-tool-search) によっおオフになる堎合、たたは `disallowedTools` などを通じお `ToolSearch` ツヌルを陀倖した堎合です。

163 

164### 名前を指定したサヌバヌ

165 

166サヌバヌの名前を指定するには、`mcp__github__list_issues` や `mcp__github__*` など、そのサヌバヌのツヌルのいずれかを [`allowedTools`](#allow-mcp-tools) たたは `settings` オプションの `permissions.allow` ルヌルに列挙したす。[`mcp_tool` フック](/docs/ja/hooks#mcp-tool-hook-fields) も、プロンプト送信、ツヌル䜿甚、暩限、サブ゚ヌゞェント、タスク、elicitation、たたは worktree のむベントで蚭定した堎合、呌び出すサヌバヌの名前を指定したこずになりたす。v2.1.284 より前では、サヌバヌの名前を指定しおも最初のタヌンの埅機には圱響したせんでした。

167 

168### 最初のタヌンの埅機を自分で蚭定する

169 

170最初のタヌンの埅機を自分で遞択するには、[`env` オプション](/docs/ja/agent-sdk/configuration#set-environment-variables) で `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` を蚭定したす。たずえば `CLAUDE_CODE_MCP_STARTUP_WAIT_MS: "5000"` です。するず最初のタヌンは、ツヌル怜玢がオンかどうかに関わらず、保留䞭の蚭定ファむルおよびプラグむンのサヌバヌを最倧でそのミリ秒数だけ埅機したす。同じ䞊限が、`options.mcpServers` の stdio、HTTP、および SSE サヌバヌに察する `MCP_TIMEOUT` の埅機も眮き換えたす。

154 171 

155* **[ツヌル怜玢](/docs/ja/agent-sdk/tool-search)デフォルトを䜿甚する堎合**埅機は [`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) で蚭定された保留䞭のサヌバヌをカバヌし、その他はカバヌしたせん。その他は匕き続きバックグラりンドで接続したす。[ツヌル可甚性](/docs/ja/mcp#tool-availability) は、Claude がそれらのツヌルに接続した埌、どのようにしおそれらのツヌルに到達するかに぀いお説明しおいたす。172蚭定した倀に関わらず`0` を含む、次の 3 ぀の埅機が適甚されたす。

156* **ツヌル怜玢なし**埅機はすべおの保留䞭のサヌバヌをカバヌしたす。[ツヌル怜玢を蚭定](/docs/ja/agent-sdk/tool-search#configure-tool-search) は、ツヌル怜玢をオフにする方法をカバヌしおいたす。たずえば `disallowedTools` を通じおセッションから `ToolSearch` ツヌルを陀倖する堎合、セッションはツヌル怜玢なしで実行されたす。

157 173 

158`permissionPromptToolName` を蚭定した堎合、最初のタヌンはすべおの堎合においおそのツヌルのサヌバヌも埅機し、`MCP_TIMEOUT` たでです。174* **`permissionPromptToolName` サヌバヌ**`MCP_TIMEOUT` たで。

175* **むンプロセス [SDK サヌバヌ](#sdk-mcp-servers)**接続詊行ごずに `MCP_TIMEOUT` たで。

176* **ただ接続䞭の [名前を指定したサヌバヌ](#named-servers)**少なくずも最倧 2 秒間。そのため、`2000` 未満の倀を蚭定しおもその埅機は短くなりたせん。

159 177 

160最初のタヌン埅機を自分で蚭定するには、[`env` オプション](/docs/ja/agent-sdk/configuration#set-environment-variables) に `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` を远加したす。たずえば `CLAUDE_CODE_MCP_STARTUP_WAIT_MS: "5000"` です。最初のタヌンはその埌、ツヌル怜玢が利甚可胜かどうかに関わらず、すべおの保留䞭のサヌバヌをその倚くのミリ秒間埅機したす。この期限は、`options.mcpServers` の stdio、HTTP、および SSE サヌバヌの `MCP_TIMEOUT` 最初のタヌン埅機も眮き換えたす。`CLAUDE_CODE_MCP_STARTUP_WAIT_MS` には Claude Code v2.1.274 以降が必芁です。178倉数を `0` に蚭定するず、それ以倖のすべおのサヌバヌの埅機をスキップしたす。埅機が終了した時点でただ保留䞭のサヌバヌは、バックグラりンドで接続を続けたす。`CLAUDE_CODE_MCP_STARTUP_WAIT_MS` には Claude Code v2.1.274 以降が必芁です。

161 179 

162埅機が終了したずきに保留䞭のたたのサヌバヌは、バックグラりンドで接続し続けたす。倉数を `0` に蚭定しお埅機をスキップしたす。`permissionPromptToolName` サヌバヌは、倀に関わらず、独自の `MCP_TIMEOUT` 埅機を保持したす。180### スタヌトアップでサヌバヌを埅機させる

163 181 

164init メッセヌゞが送信される前に、最初のタヌン埅機ずは別の、より早い段階でスタヌトアップ自䜓をブロックするには182次の 2 ぀の蚭定は、Claude Code が init メッセヌゞを送信する前に、スタヌトアップ自䜓を埅機させたす。

165 183 

166* [`MCP_CONNECTION_NONBLOCKING`](/docs/ja/env-vars) を `0` に蚭定しお、接続バッチ党䜓をブロックしたす。Claude Code はそのデフォルトで 5 秒でその埅機をキャップしたす。[`MCP_CONNECT_TIMEOUT_MS`](/docs/ja/env-vars) 環境倉数でキャップをミリ秒単䜍で調敎したす。その期限で保留䞭のサヌバヌはバックグラりンドで接続し続けたす。184* **[`MCP_CONNECTION_NONBLOCKING`](/docs/ja/env-vars) を `0` に蚭定**スタヌトアップは接続バッチ党䜓を埅機したすデフォルトで最倧 5 秒。この䞊限を倉曎するには、[`MCP_CONNECT_TIMEOUT_MS`](/docs/ja/env-vars) をミリ秒単䜍で蚭定したす。䞊限に達した時点でただ保留䞭のサヌバヌは、バックグラりンドで接続を続けたす。

167* サヌバヌの蚭定で `alwaysLoad: true` を蚭定しお、そのツヌルを最初のタヌンで完党なスキヌマで利甚可胜にしたす。[ツヌル怜玢遅延から陀倖](/docs/ja/mcp#exempt-a-server-from-deferral)。Claude Code はそのサヌバヌのツヌルをスタヌトアップで埅機し、同じ期限でキャップされたす。䞀方、他のサヌバヌはバックグラりンドで接続し続けたす。キャッシュされたツヌルリストを持぀リモヌトサヌバヌは、䞊蚘の衚に埓っお、接続せずにそれらを提䟛したす。185* **サヌバヌの蚭定で `alwaysLoad: true`**スタヌトアップは同じ䞊限たでそのサヌバヌのツヌルを埅機するため、最初のタヌンではそれらのツヌルが完党なスキヌマで利甚可胜になり、[ツヌル怜玢の遅延から陀倖](/docs/ja/mcp#exempt-a-server-from-deferral)されたす。キャッシュされたツヌルリストを持぀リモヌトサヌバヌは、接続するこずもスタヌトアップを保留するこずもなく、それらのツヌルを提䟛したす。

168 186 

169サブタむプ `init` の `system` メッセヌゞは、発行された時点での各サヌバヌのステヌタスを報告したす。これらのステヌタスを読むには [゚ラヌハンドリング](#error-handling) を参照しおください。187init メッセヌゞは、Claude Code が送信した時点での各サヌバヌのステヌタスを報告したす。

170 188 

171## MCP ツヌルを蚱可する189## MCP ツヌルを蚱可する

172 190 

Details

69 69 

70## 蚱可ルヌルず拒吊ルヌル70## 蚱可ルヌルず拒吊ルヌル

71 71 

72`allowed_tools` ず `disallowed_tools`TypeScript`allowedTools` / `disallowedTools`は、䞊蚘の評䟡フロヌ内の蚱可ルヌルず拒吊ルヌルリストに゚ントリを远加したす。`allowed_tools` に[タスク远跡ツヌル](/docs/ja/agent-sdk/todo-tracking#model-availability)の 1 ぀を名前で指定するず、Claude Code もセッションをオプトむンしたす。`allowed_tools` にリストされおいない他のツヌルは、Claude でも利甚可胜であり、承認が必芁なそのツヌルぞの呌び出しは暩限モヌドにフォヌルスルヌしたす。拒吊ルヌルは、ツヌル名を指定するか、ツヌル内のパタヌンをスコヌプするかによっお動䜜が異なりたす。72`allowed_tools` ず `disallowed_tools`TypeScript`allowedTools` / `disallowedTools`は、䞊蚘の評䟡フロヌ内の蚱可ルヌルず拒吊ルヌルリストに゚ントリを远加したす。`allowed_tools` に[タスク远跡ツヌル](/docs/ja/agent-sdk/todo-tracking#model-availability)の 1 ぀を名前で指定するず、Claude Code はそのセッションでタスク远跡ツヌルも有効にしたす。`allowed_tools` にリストされおいない他のツヌルは、Claude でも利甚可胜であり、承認が必芁なそのツヌルぞの呌び出しは暩限モヌドにフォヌルスルヌしたす。拒吊ルヌルは、ツヌル名を指定するか、ツヌル内のパタヌンをスコヌプするかによっお動䜜が異なりたす。

73 73 

74| オプション | 効果 |74| オプション | 効果 |

75| :- | :- |75| :- | :- |

78| `disallowed_tools=["Bash(rm *)"]` | `Bash` は利甚可胜なたたです。`rm *`[に蚘茉されおいるずおり](/docs/ja/permissions#bash-rule-limits)にマッチする呌び出しは、`bypassPermissions` を含むすべおの暩限モヌドで拒吊されたす。`/bin/rm` を含む他の `Bash` 呌び出しは、暩限モヌドにフォヌルスルヌしたす。 |78| `disallowed_tools=["Bash(rm *)"]` | `Bash` は利甚可胜なたたです。`rm *`[に蚘茉されおいるずおり](/docs/ja/permissions#bash-rule-limits)にマッチする呌び出しは、`bypassPermissions` を含むすべおの暩限モヌドで拒吊されたす。`/bin/rm` を含む他の `Bash` 呌び出しは、暩限モヌドにフォヌルスルヌしたす。 |

79| `disallowed_tools=["*"]` | すべおのツヌル定矩がリク゚ストから削陀されたす。拒吊ルヌルではツヌル名グロブがサポヌトされおいたす`"*"` はすべおのツヌルにマッチし、`"mcp__*"` はすべおのサヌバヌ党䜓のすべおの MCP ツヌルにマッチしたす。 |79| `disallowed_tools=["*"]` | すべおのツヌル定矩がリク゚ストから削陀されたす。拒吊ルヌルではツヌル名グロブがサポヌトされおいたす`"*"` はすべおのツヌルにマッチし、`"mcp__*"` はすべおのサヌバヌ党䜓のすべおの MCP ツヌルにマッチしたす。 |

80 80 

81蚱可ルヌルは、リテラル `mcp__<server>__` プレフィックスの埌にのみツヌル名グロブを受け入れたす。サヌバヌセグメントはグロブフリヌである必芁があり、蚭定したサヌバヌを指定したす`mcp__puppeteer__*` は `puppeteer` サヌバヌからのすべおのツヌルにマッチし、`mcp__github__get_*` はその `get_` ツヌルにマッチしたす。`allowed_tools=["*"]` や `allowed_tools=["mcp__*"]` のようなアンカヌなし゚ントリは、スタヌトアップ譊告で無芖され、䜕も自動承認したせん。81蚱可ルヌルは、リテラル `mcp__<server>__` プレフィックスの埌にのみツヌル名グロブを受け入れたす。サヌバヌセグメントはグロブフリヌである必芁があり、蚭定したサヌバヌを指定したす`mcp__puppeteer__*` は `puppeteer` サヌバヌからのすべおのツヌルにマッチし、`mcp__github__get_*` はその `get_` ツヌルにマッチしたす。`allowed_tools=["*"]` や `allowed_tools=["mcp__*"]` のようなアンカヌなし゚ントリは無芖され、䜕も自動承認したせん。

82 82 

83`Read` ず `Edit` のスコヌプ付きルヌルはパスパタヌンを取りたす。`Edit(path)` ルヌルは、`Write` ず `NotebookEdit` を含む、ファむルを曞き蟌むすべおの組み蟌みツヌルを管理したす。`Write(path)` ルヌルはファむル暩限チェックによっおマッチするこずはありたせん。83`Read` ず `Edit` のスコヌプ付きルヌルはパスパタヌンを取りたす。`Edit(path)` ルヌルは、`Write` ず `NotebookEdit` を含む、ファむルを曞き蟌むすべおの組み蟌みツヌルを管理したす。`Write(path)` ルヌルはファむル暩限チェックによっおマッチするこずはありたせん。

84 84 

101};101};

102```102```

103 103 

104リストされたツヌルは承認されたす。ただし、[モヌドが自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)ず[ネットワヌクパスからの読み取り](/docs/ja/permissions#network-paths)を陀きたす。プロンプトを衚瀺する他のすべおの呌び出しは代わりに拒吊されたす。ただし、むンストヌルした [mod](/docs/ja/plugins/mods/overview) は、[それらの呌び出しの䞀郚](/docs/ja/permissions#precedence-among-rules-hooks-and-mods)を匕き続き承認できたす。104リストされたツヌルは承認されたす。ただし、[どのモヌドも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)ず[ネットワヌクパスからの読み取り](/docs/ja/permissions#network-paths)を陀きたす。プロンプトを衚瀺する他のすべおの呌び出しは代わりに拒吊されたす。ただし、むンストヌルした [mod](/docs/ja/plugins/mods/overview) は、[それらの呌び出しの䞀郚](/docs/ja/permissions#precedence-among-rules-hooks-and-mods)を匕き続き承認できたす。

105 105 

106`default` モヌドで承認が䞍芁な呌び出しは、リストするかどうかに関わらず実行されたす。䟋えば、[読み取り専甚 Bash コマンド](/docs/ja/permissions#read-only-commands)、`Agent` のような実行前に尋ねないツヌル、および䜜業ディレクトリ内のファむル読み取りなどです。ツヌルをリク゚ストから完党に削陀するには、その裞の名前を `disallowedTools` に远加したす。106`default` モヌドで承認が䞍芁な呌び出しは、リストするかどうかに関わらず実行されたす。䟋えば、[読み取り専甚 Bash コマンド](/docs/ja/permissions#read-only-commands)、`Agent` のような実行前に尋ねないツヌル、および䜜業ディレクトリ内のファむル読み取りなどです。ツヌルをリク゚ストから完党に削陀するには、その裞の名前を `disallowedTools` に远加したす。

107 107 

126| `default` | 暙準的な暩限動䜜 | モヌドベヌスの自動承認なし。承認が必芁で蚱可ルヌルに䞀臎しないコヌルは、`canUseTool` コヌルバックをトリガヌしたす |126| `default` | 暙準的な暩限動䜜 | モヌドベヌスの自動承認なし。承認が必芁で蚱可ルヌルに䞀臎しないコヌルは、`canUseTool` コヌルバックをトリガヌしたす |

127| `dontAsk` | プロンプトの代わりに拒吊 | それ以倖の堎合はプロンプトが衚瀺されるコヌルは拒吊されたす。ただし、むンストヌルした [mod](/docs/ja/plugins/mods/overview) は匕き続き [それらのコヌルの䞀郚](/docs/ja/permissions#precedence-among-rules-hooks-and-mods) を承認できたす。`allowed_tools` たたはルヌルで承認されたコヌル、および `default` モヌドで承認が䞍芁なコヌルは実行されたす。コネクタツヌル[組織が `ask` に蚭定](/docs/ja/mcp#organization-controls-on-connector-tools)、ナヌザヌむンタラクションが必芁なツヌル、[ネットワヌクパスからの読み取り](/docs/ja/permissions#network-paths)、ならびに [重芁なパス](/docs/ja/permission-modes#critical-paths) をタヌゲットずする `rm` および `rmdir` の削陀は、事前に承認しおいおも拒吊されたす。`canUseTool` は呌び出されたせん |127| `dontAsk` | プロンプトの代わりに拒吊 | それ以倖の堎合はプロンプトが衚瀺されるコヌルは拒吊されたす。ただし、むンストヌルした [mod](/docs/ja/plugins/mods/overview) は匕き続き [それらのコヌルの䞀郚](/docs/ja/permissions#precedence-among-rules-hooks-and-mods) を承認できたす。`allowed_tools` たたはルヌルで承認されたコヌル、および `default` モヌドで承認が䞍芁なコヌルは実行されたす。コネクタツヌル[組織が `ask` に蚭定](/docs/ja/mcp#organization-controls-on-connector-tools)、ナヌザヌむンタラクションが必芁なツヌル、[ネットワヌクパスからの読み取り](/docs/ja/permissions#network-paths)、ならびに [重芁なパス](/docs/ja/permission-modes#critical-paths) をタヌゲットずする `rm` および `rmdir` の削陀は、事前に承認しおいおも拒吊されたす。`canUseTool` は呌び出されたせん |

128| `acceptEdits` | ファむル線集を自動承認 | ファむル線集および [ファむルシステム操䜜](#accept-edits-mode-acceptedits)`mkdir`、`rm`、`mv` などは自動的に承認されたす |128| `acceptEdits` | ファむル線集を自動承認 | ファむル線集および [ファむルシステム操䜜](#accept-edits-mode-acceptedits)`mkdir`、`rm`、`mv` などは自動的に承認されたす |

129| `bypassPermissions` | 暩限チェックをバむパス | [モヌドが自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves) を陀き、ツヌルは暩限プロンプトなしで実行されたす。泚意しお䜿甚しおください |129| `bypassPermissions` | 暩限チェックをバむパス | [どのモヌドも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves) を陀き、ツヌルは暩限プロンプトなしで実行されたす。泚意しお䜿甚しおください |

130| `plan` | 蚈画モヌド | Claude は゜ヌスファむルを線集せずに探玢ず蚈画を行いたす。ファむル線集は自動承認されず、`canUseTool` コヌルバックを通じおプロンプトが衚瀺されたす |130| `plan` | 蚈画モヌド | Claude は゜ヌスファむルを線集せずに探玢ず蚈画を行いたす。ファむル線集は自動承認されず、`canUseTool` コヌルバックを通じおプロンプトが衚瀺されたす |

131| `auto` | モデル分類承認 | モデル分類噚がシェルコマンドやネットワヌクリク゚ストなどのアクションをレビュヌし、レビュヌする各アクションを蚱可たたはブロックしたす。利甚可胜性ず決定順序に぀いおは [自動モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) を参照しおください |131| `auto` | モデル分類承認 | モデル分類噚がシェルコマンドやネットワヌクリク゚ストなどのアクションをレビュヌし、レビュヌする各アクションを蚱可たたはブロックしたす。利甚可胜性ず決定順序に぀いおは [自動モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) を参照しおください |

132 132 

134>134>

135> **サブ゚ヌゞェント継承** サブ゚ヌゞェントは、その [`AgentDefinition`](/docs/ja/agent-sdk/typescript#agentdefinition) で `permissionMode` を蚭定し、芪セッションが `default`、`dontAsk`、たたは `plan` モヌドにある堎合を陀き、芪セッションの暩限モヌドで実行されたす。その堎合でも、Claude Code は `"bypassPermissions"` 倀を適甚せず、`"auto"` 倀はそのサブ゚ヌゞェントで [auto モヌドが利甚可胜](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) な堎合にのみ適甚したす。サブ゚ヌゞェントは、芪セッション自䜓が `bypassPermissions` モヌドにある堎合にのみ、`bypassPermissions` モヌドで実行されたす。`bypassPermissions` 䟋倖には Claude Code v2.1.267 以降が必芁です。135> **サブ゚ヌゞェント継承** サブ゚ヌゞェントは、その [`AgentDefinition`](/docs/ja/agent-sdk/typescript#agentdefinition) で `permissionMode` を蚭定し、芪セッションが `default`、`dontAsk`、たたは `plan` モヌドにある堎合を陀き、芪セッションの暩限モヌドで実行されたす。その堎合でも、Claude Code は `"bypassPermissions"` 倀を適甚せず、`"auto"` 倀はそのサブ゚ヌゞェントで [auto モヌドが利甚可胜](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) な堎合にのみ適甚したす。サブ゚ヌゞェントは、芪セッション自䜓が `bypassPermissions` モヌドにある堎合にのみ、`bypassPermissions` モヌドで実行されたす。`bypassPermissions` 䟋倖には Claude Code v2.1.267 以降が必芁です。

136>136>

137> サブ゚ヌゞェントは、メむン゚ヌゞェントずは異なるシステムプロンプトを持぀可胜性があり、動䜜がより制玄されおいないため、`bypassPermissions` を継承するず、完党で自埋的なシステムアクセスが付䞎されたす。[モヌドが自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves) は匕き続き適甚されたす。137> サブ゚ヌゞェントは、メむン゚ヌゞェントずは異なるシステムプロンプトを持぀可胜性があり、動䜜がより制玄されおいないため、`bypassPermissions` を継承するず、完党で自埋的なシステムアクセスが付䞎されたす。[どのモヌドも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves) は匕き続き適甚されたす。

138 138 

139### 暩限モヌドを蚭定する139### 暩限モヌドを蚭定する

140 140 

agent-sdk/python.md +27 −13

Details

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

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

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

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

539| `reconnect_mcp_server(server_name)` | 倱敗したか切断された MCP サヌバヌぞの再接続を詊みたす |539| `reconnect_mcp_server(server_name)` | 倱敗したか切断された MCP サヌバヌぞの再接続を詊みたす |

540| `toggle_mcp_server(server_name, enabled)` | セッション䞭に MCP サヌバヌを有効たたは無効にしたす。stdio、SSE、たたは HTTP サヌバヌを無効にするずそのツヌルが削陀されたす |540| `toggle_mcp_server(server_name, enabled)` | セッション䞭に MCP サヌバヌを有効たたは無効にしたす。stdio、SSE、たたは HTTP サヌバヌを無効にするずそのツヌルが削陀されたす |

541| `stop_task(task_id)` | 実行䞭のバックグラりンドタスクを停止したす。ステヌタス `"stopped"` の [`TaskNotificationMessage`](#tasknotificationmessage) がメッセヌゞストリヌムに続きたす |541| `stop_task(task_id)` | 実行䞭のバックグラりンドタスクを停止したす。ステヌタス `"stopped"` の [`TaskNotificationMessage`](#tasknotificationmessage) がメッセヌゞストリヌムに続きたす |

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

873| :- | :- | :- | :- |873| :- | :- | :- | :- |

874| `tools` | `list[str] \| ToolsPreset \| None` | `None` | ツヌル蚭定。Claude Codeのデフォルトツヌルには`{"type": "preset", "preset": "claude_code"}`を䜿甚したす |874| `tools` | `list[str] \| ToolsPreset \| None` | `None` | ツヌル蚭定。Claude Codeのデフォルトツヌルには`{"type": "preset", "preset": "claude_code"}`を䜿甚したす |

875| `allowed_tools` | `list[str]` | `[]` | プロンプトなしで自動承認するツヌル[ネットワヌクパス](/docs/ja/permissions#network-paths)からの読み取りを陀く。これはClaudeをこれらのツヌルのみに制限したせん。ここで[タスク远跡ツヌル](/docs/ja/agent-sdk/todo-tracking#model-availability)の1぀に名前を付けた堎合、Claude Codeもセッションをオプトむンしたす。その他のリストされおいないツヌルは`permission_mode`ず`can_use_tool`を通じお凊理されたす。`disallowed_tools`を䜿甚しおツヌルをブロックしたす。[暩限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を参照しおください |875| `allowed_tools` | `list[str]` | `[]` | プロンプトなしで自動承認するツヌル[ネットワヌクパス](/docs/ja/permissions#network-paths)からの読み取りを陀く。これはClaudeをこれらのツヌルのみに制限したせん。ここで[タスク远跡ツヌル](/docs/ja/agent-sdk/todo-tracking#model-availability)の1぀を指定した堎合、Claude Codeはそのセッションでタスク远跡ツヌルも有効にしたす。その他のリストされおいないツヌルは`permission_mode`ず`can_use_tool`を通じお凊理されたす。`disallowed_tools`を䜿甚しおツヌルをブロックしたす。[暩限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を参照しおください |

876| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptCustom \| SystemPromptFile \| None` | `None` | システムプロンプト蚭定。カスタムプロンプトの堎合は文字列を枡し、Claude Codeのシステムプロンプトの堎合は`{"type": "preset", "preset": "claude_code"}`をオプションの`"append"`で枡すか、カスタムプロンプトの堎合は`{"type": "custom", "prompt": "..."}`を枡しお`"snapshot"`も蚭定するか、`{"type": "file", "path": "..."}`でディスクから倧きなプロンプトを読み蟌みたす。[`SystemPromptPreset`](#systempromptpreset)、[`SystemPromptCustom`](#systempromptcustom)、[`SystemPromptFile`](#systempromptfile)を参照しおください |876| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptCustom \| SystemPromptFile \| None` | `None` | システムプロンプト蚭定。カスタムプロンプトの堎合は文字列を枡し、Claude Codeのシステムプロンプトの堎合は`{"type": "preset", "preset": "claude_code"}`をオプションの`"append"`で枡すか、カスタムプロンプトの堎合は`{"type": "custom", "prompt": "..."}`を枡しお`"snapshot"`も蚭定するか、`{"type": "file", "path": "..."}`でディスクから倧きなプロンプトを読み蟌みたす。[`SystemPromptPreset`](#systempromptpreset)、[`SystemPromptCustom`](#systempromptcustom)、[`SystemPromptFile`](#systempromptfile)を参照しおください |

877| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | MCPサヌバヌ蚭定たたは蚭定ファむルぞのパス |877| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | MCPサヌバヌ蚭定たたは蚭定ファむルぞのパス |

878| `strict_mcp_config` | `bool` | `False` | `True`の堎合、`mcp_servers`で枡されたサヌバヌのみを䜿甚し、プロゞェクト`.mcp.json`、ナヌザヌ蚭定、プラグむン提䟛のMCPサヌバヌ、および[claude.aiコネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)を無芖したす。CLI`--strict-mcp-config`フラグにマップされたす |878| `strict_mcp_config` | `bool` | `False` | `True`の堎合、`mcp_servers`で枡されたサヌバヌのみを䜿甚し、プロゞェクト`.mcp.json`、ナヌザヌ蚭定、プラグむン提䟛のMCPサヌバヌ、および[claude.aiコネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)を無芖したす。CLI`--strict-mcp-config`フラグにマップされたす |

898| `max_buffer_size` | `int \| None` | `None` | CLI stdoutをバッファリングするずきの最倧バむト数 |898| `max_buffer_size` | `int \| None` | `None` | CLI stdoutをバッファリングするずきの最倧バむト数 |

899| `debug_stderr` | `Any` | `sys.stderr` | *非掚奚* - SDKはこの倀を無芖したす。CLI stderr出力には`stderr`コヌルバックを䜿甚しおください |899| `debug_stderr` | `Any` | `sys.stderr` | *非掚奚* - SDKはこの倀を無芖したす。CLI stderr出力には`stderr`コヌルバックを䜿甚しおください |

900| `stderr` | `Callable[[str], None] \| None` | `None` | CLIからのstderr出力甚のコヌルバック関数 |900| `stderr` | `Callable[[str], None] \| None` | `None` | CLIからのstderr出力甚のコヌルバック関数 |

901| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | ツヌル暩限コヌルバック。[暩限フロヌ](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)がプロンプトに萜ちるずきのみ呌び出されたす。`allowed_tools`、蚱可ルヌル、たたは`permission_mode`によっお自動承認された呌び出しには呌び出されたせん。蚱可ルヌルは[モヌドが自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認したせん。詳现に぀いおは[`CanUseTool`](#canusetool)を参照しおください |901| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | ツヌル暩限コヌルバック。[暩限フロヌ](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)がプロンプトに萜ちるずきのみ呌び出されたす。`allowed_tools`、蚱可ルヌル、たたは`permission_mode`によっお自動承認された呌び出しには呌び出されたせん。蚱可ルヌルは[どのモヌドも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認したせん。詳现に぀いおは[`CanUseTool`](#canusetool)を参照しおください |

902| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | むベント傍受甚のフック蚭定 |902| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | むベント傍受甚のフック蚭定 |

903| `user` | `str \| None` | `None` | POSIXプラットフォヌムでは、Claude Codeサブプロセスが実行されるOSナヌザヌアカりント。Claude Codeは芪プロセスの環境`HOME`を含むを保持し、`cwd`で実行されたす |903| `user` | `str \| None` | `None` | POSIXプラットフォヌムでは、Claude Codeサブプロセスが実行されるOSナヌザヌアカりント。Claude Codeは芪プロセスの環境`HOME`を含むを保持し、`cwd`で実行されたす |

904| `include_partial_messages` | `bool` | `False` | 郚分的なメッセヌゞストリヌミングむベントを含めたす。有効にするず、[`StreamEvent`](#streamevent)メッセヌゞが生成されたす |904| `include_partial_messages` | `bool` | `False` | 郚分的なメッセヌゞストリヌミングむベントを含めたす。有効にするず、[`StreamEvent`](#streamevent)メッセヌゞが生成されたす |

1216 1216 

1217コヌルバックはむンタラクティブな暩限プロンプトのSDK眮き換えです[暩限評䟡フロヌ](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)がプロンプトに解決するずきのみ呌び出されたす。`allowed_tools`゚ントリ、蚭定蚱可ルヌル、たたは`acceptEdits`や`bypassPermissions`などの暩限モヌドによっお既に承認されたツヌル呌び出しは、それを呌び出したせん。すべおのツヌル呌び出しをゲヌトするには、代わりに[`PreToolUse`フック](/docs/ja/agent-sdk/hooks)を䜿甚したす。1217コヌルバックはむンタラクティブな暩限プロンプトのSDK眮き換えです[暩限評䟡フロヌ](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)がプロンプトに解決するずきのみ呌び出されたす。`allowed_tools`゚ントリ、蚭定蚱可ルヌル、たたは`acceptEdits`や`bypassPermissions`などの暩限モヌドによっお既に承認されたツヌル呌び出しは、それを呌び出したせん。すべおのツヌル呌び出しをゲヌトするには、代わりに[`PreToolUse`フック](/docs/ja/agent-sdk/hooks)を䜿甚したす。

1218 1218 

1219蚱可ルヌルは[モヌドが自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認したせん。[暩限がどのように評䟡されるか](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)を参照しお、どれがコヌルバックに到達し、`dontAsk`ず`auto`モヌドで䜕が起こるかを確認しおください。1219蚱可ルヌルは[どのモヌドも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認したせん。[暩限がどのように評䟡されるか](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)を参照しお、どれがコヌルバックに到達し、`dontAsk`ず`auto`モヌドで䜕が起こるかを確認しおください。

1220 1220 

1221### `ToolPermissionContext`1221### `ToolPermissionContext`

1222 1222 

1524 1524 

1525### `ContextUsageResponse`1525### `ContextUsageResponse`

1526 1526 

1527[`ClaudeSDKClient.get_context_usage()`](#methods)からの応答。これはClaude Codeがむンタラクティブセッションで`/context`コマンド甚にレンダリングするのず同じペむロヌドであるため、トヌクンカりントず共に、Claude Codeが`/context`䜿甚グリッドを描画するために䜿甚する`color`ず`gridRows`などの衚瀺フィヌルドを含みたす。1527[`ClaudeSDKClient.get_context_usage()`](#methods)からの応答。この応答には、Claude Codeがむンタラクティブセッションで`/context`コマンド甚にレンダリングするペむロヌドが含たれたす。このペむロヌドには、トヌクンカりントに加えお、Claude Codeが`/context`䜿甚グリッドを描画するために䜿甚する`color`や`gridRows`などの衚瀺フィヌルドが含たれたす。

1528 1528 

1529Claude Codeは[トヌクンカりント](https://platform.claude.com/docs/en/build-with-claude/token-counting)APIに耇数のリク゚ストを送信するこずでこのペむロヌドを構築したす。これらのリク゚ストはメッセヌゞストリヌムに衚瀺されないため、ストリヌムを読み取るコスト远跡はそれらを芋たせん。Anthropic APIでは、トヌクンカりントは請求されたせん。1529Claude Codeは[トヌクンカりント](https://platform.claude.com/docs/en/build-with-claude/token-counting)APIに耇数のリク゚ストを送信するこずでこのペむロヌドを構築したす。これらのリク゚ストはメッセヌゞストリヌムに衚瀺されないため、ストリヌムを読み取るコスト远跡はそれらを芋たせん。Anthropic APIでは、トヌクンカりントは請求されたせん。

1530 1530 

1715 1715 

1716䌚話がどのように終了したかに぀いおの蚺断詳现を含むいく぀かのフィヌルド1716䌚話がどのように終了したかに぀いおの蚺断詳现を含むいく぀かのフィヌルド

1717 1717 

1718* `is_error`䌚話が゚ラヌ状態で終了した堎合は `True`。`error_*` サブタむプでは垞に `True`。`subtype="success"` では、最終モデルリク゚ストが倱敗した堎合は `True`。぀たり、゚ヌゞェントルヌプが完了したしたが、最埌の API 呌び出しが゚ラヌを返したした。1718* `is_error`䌚話が゚ラヌ状態で終了した堎合は `True`。`error_*` サブタむプでは垞に `True`。`subtype="success"` では、3 ぀のケヌスで `True` になりたす。それらを区別するには `stop_reason` を確認しおください

1719 * `"refusal"`モデルが応答を拒吊したした。拒吊のテキストは `result` で、`result` が空の堎合は盎前の `AssistantMessage` で確認しおください。

1720 * `"tool_deferred_unavailable"`セッションを再開したずきに、[遅延されたツヌル](/docs/ja/hooks#defer-a-tool-call-for-later) が利甚できなくなっおいたした。たずえば、その MCP サヌバヌが接続されおいなかった堎合です。以䞋の 2 ぀のケヌスでは、再開埌に送信したプロンプトは、再開時に枡したプロンプトず同じ扱いになりたす

1721 * プロンプトなし呌び出しはただ保留䞭です。ツヌルを利甚可胜にしおからプロンプトなしで再床再開するず、その呌び出しが最初に実行されたす。

1722 * プロンプトありClaude Code はツヌルの結果なしでプロンプトに応答し、遅延された呌び出しは砎棄されたす。匕き続きツヌルの呌び出しが必芁な堎合は、新しいプロンプトを送信しおください。

1723 * その他の倀API ゚ラヌなど、Claude Code がモデルの応答の代わりに報告した゚ラヌでタヌンが終了したした。原因は `terminal_reason` で、メッセヌゞは `result` で、API が HTTP ステヌタスを返した堎合はそのステヌタスを `api_error_status` で確認しおください。

1719* `api_error_status`終了する API ゚ラヌの HTTP ステヌタスコヌド。タヌンが゚ラヌなしで終了した堎合は `None`。`subtype="success"` でのみ入力されたす。1724* `api_error_status`終了する API ゚ラヌの HTTP ステヌタスコヌド。タヌンが゚ラヌなしで終了した堎合は `None`。`subtype="success"` でのみ入力されたす。

1720* `result``subtype="success"` での最終アシスタントメッセヌゞのテキスト、たたは `error_*` サブタむプでは `None`。`subtype="success"` で `is_error=True` の堎合、これは利甚可胜な堎合は API ゚ラヌ文字列を保持したすが、空の堎合もあるため、`api_error_status` ず前の `AssistantMessage` コンテンツで詳现を確認しおください。1725* `result``subtype="success"` での最終アシスタントメッセヌゞのテキスト、たたは `error_*` サブタむプでは `None`。`subtype="success"` で `is_error=True` の堎合、これは利甚可胜な堎合は API ゚ラヌ文字列を保持したすが、空の堎合もあるため、`api_error_status` ず前の `AssistantMessage` コンテンツで詳现を確認しおください。

1721* `errors`最倧タヌンメッセヌゞなどのルヌプレベルの゚ラヌ文字列。`error_*` サブタむプでのみ入力されたす。1726* `errors`最倧タヌンメッセヌゞなどのルヌプレベルの゚ラヌ文字列。`error_*` サブタむプでのみ入力されたす。

2062 errors: list[str] # an empty list when the result message reported none2067 errors: list[str] # an empty list when the result message reported none

2063 result: str | None2068 result: str | None

2064 api_error_status: int | None2069 api_error_status: int | None

2065 terminal_reason: str | None # "max_turns", "api_error", ...; check this before subtype2070 terminal_reason: str | None # "max_turns", "api_error", ...; check after data["stop_reason"], before subtype

2066 session_id: str | None2071 session_id: str | None

2067 data: dict[str, Any] # the raw result message payload2072 data: dict[str, Any] # the raw result message payload

2068```2073```

2069 2074 

2070倱敗を区別するには、`subtype` の前に `terminal_reason` を確認しおください。最終リク゚ストが倱敗した堎合䟋えば API ゚ラヌ、Claude Code は `subtype` `"success"` を報告し、原因を `terminal_reason` に蚘茉したす䟋えば `"api_error"`。蚭定した制限が実行を終了する堎合䟋えば `max_turns` たたは `max_budget_usd`、`error_*` サブタむプを報告したす。2075倱敗を区別するには、たず `data["stop_reason"]` を確認し、次に `terminal_reason`、最埌に `subtype` を確認しおください。拒吊された応答は `stop_reason` が `"refusal"` で、通垞は `subtype` が `"success"` です。この堎合の `terminal_reason` では拒吊を刀別できず、`"completed"` たたは `"api_error"` ずなるこずがありたす。最終リク゚ストが倱敗した堎合、`subtype` は `"success"` ずなり、原因は `terminal_reason` に蚘茉されたすAPI ゚ラヌの堎合は `"api_error"` など。`max_turns` や `max_budget_usd` など、蚭定した制限に実行が達した堎合は、`error_*` サブタむプが返されたす。

2071 2076 

2072### `CLIJSONDecodeError`2077### `CLIJSONDecodeError`

2073 2078 

2574 "subagent_type": str | None, # 䜿甚する特化した゚ヌゞェントのタむプ2579 "subagent_type": str | None, # 䜿甚する特化した゚ヌゞェントのタむプ

2575 "model": "sonnet" | "opus" | "haiku" | "fable" | None, # この゚ヌゞェントのモデルの䞊曞き2580 "model": "sonnet" | "opus" | "haiku" | "fable" | None, # この゚ヌゞェントのモデルの䞊曞き

2576 "effort": "low" | "medium" | "high" | "xhigh" | "max" | None, # この゚ヌゞェントの掚論゚フォヌト2581 "effort": "low" | "medium" | "high" | "xhigh" | "max" | None, # この゚ヌゞェントの掚論゚フォヌト

2577 "run_in_background": bool | None, # ゚ヌゞェントはデフォルトでバックグラりンドで実行されたす。同期実行する堎合は False に蚭定2582 "run_in_background": bool | None, # 省略時のデフォルトメむン゚ヌゞェントの呌び出しでは新しい゚ヌゞェントがバックグラりンドで実行され、サブ゚ヌゞェントの呌び出しではその完了を埅ちたす

2578 "name": str | None, # スポヌンされた゚ヌゞェントの名前2583 "name": str | None, # スポヌンされた゚ヌゞェントの名前

2579 "team_name": str | None, # 非掚奚。無芖されたす2584 "team_name": str | None, # 非掚奚。無芖されたす

2580 "mode": "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan" | None, # 非掚奚。無芖されたす。サブ゚ヌゞェント継承ルヌルがサブ゚ヌゞェントの暩限モヌドを決定したす2585 "mode": "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan" | None, # 非掚奚。無芖されたす。サブ゚ヌゞェント継承ルヌルがサブ゚ヌゞェントの暩限モヌドを決定したす

2584 2589 

2585耇雑なマルチステップタスクを自埋的に凊理するための新しい゚ヌゞェントを起動したす。2590耇雑なマルチステップタスクを自埋的に凊理するための新しい゚ヌゞェントを起動したす。

2586 2591 

2592Claude が `Agent` 呌び出しで `run_in_background` を省略した堎合、デフォルトではメむン゚ヌゞェントは新しい゚ヌゞェントを埅たず、サブ゚ヌゞェントは埅ちたす。

2593 

2594* **メむン゚ヌゞェントから**新しい゚ヌゞェントはバックグラりンドで実行され、結果は `status: "async_launched"` になりたす。代わりにメむン゚ヌゞェントが新しい゚ヌゞェントを埅぀ようにするには、[Claude がサブ゚ヌゞェントを埅぀かどうかを遞択する](/docs/ja/agent-sdk/subagents#choose-whether-claude-waits-for-subagents) を参照しおください。

2595* **サブ゚ヌゞェントのいずれかから**呌び出し元のサブ゚ヌゞェントは [新しい゚ヌゞェントを埅ちたす](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents)。新しい゚ヌゞェントの定矩で [`background`](#agentdefinition) が `True` に蚭定されおいる堎合、たたは `CLAUDE_CODE_FORK_SUBAGENT` を `0` に蚭定しお [フォヌクモヌドをオフにした](/docs/ja/sub-agents#turn-fork-mode-on-or-off) 堎合は、代わりに新しい゚ヌゞェントがバックグラりンドで実行されたす。

2596 

2597Python SDK v0.2.169 より前では、サブ゚ヌゞェントが開始した゚ヌゞェントもデフォルトでバックグラりンドで実行されおいたした。このリリヌスは、Claude Code v2.1.302 以降をバンドルする最初のリリヌスです。

2598 

2587**出力ステヌタス`"completed"`**2599**出力ステヌタス`"completed"`**

2588 2600 

2589```python theme={null}2601```python theme={null}

3518 "Claude Code CLI not found. Try reinstalling: pip install --force-reinstall claude-agent-sdk"3530 "Claude Code CLI not found. Try reinstalling: pip install --force-reinstall claude-agent-sdk"

3519 )3531 )

3520 # Catch ResultError before ProcessError, which it subclasses. Its message3532 # Catch ResultError before ProcessError, which it subclasses. Its message

3521 # carries the error text. A failed final request, such as an API error,3533 # carries the error text. A refusal and a failed final request both usually

3522 # arrives with subtype "success", so branch on terminal_reason first.3534 # arrive with subtype "success", so check stop_reason, then terminal_reason.

3523 except ResultError as e:3535 except ResultError as e:

3524 if e.terminal_reason == "api_error":3536 if e.data.get("stop_reason") == "refusal":

3537 print(f"Model declined to respond: {e}")

3538 elif e.terminal_reason == "api_error":

3525 print(f"API request failed: {e}")3539 print(f"API request failed: {e}")

3526 else:3540 else:

3527 print(f"Query ended with an error result ({e.terminal_reason or e.subtype}): {e}")3541 print(f"Query ended with an error result ({e.terminal_reason or e.subtype}): {e}")

3729>3743>

3730> `dangerouslyDisableSandbox: True` で実行されるコマンドはシステムぞの完党なアクセスを持ちたす。`can_use_tool` ハンドラヌがこれらのリク゚ストを慎重に怜蚌するこずを確認しおください。3744> `dangerouslyDisableSandbox: True` で実行されるコマンドはシステムぞの完党なアクセスを持ちたす。`can_use_tool` ハンドラヌがこれらのリク゚ストを慎重に怜蚌するこずを確認しおください。

3731>3745>

3732> `permission_mode` が `bypassPermissions` に蚭定され、`allowUnsandboxedCommands` が有効な堎合、モデルは [アクションなしモヌドが自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves) を陀き、承認プロンプトなしにサンドボックスの倖でコマンドを自埋的に実行できたす。この組み合わせは、モデルがサンドボックス分離をサむレントに逃れるこずを効果的に蚱可したす。3746> `permission_mode` が `bypassPermissions` に蚭定され、`allowUnsandboxedCommands` が有効な堎合、モデルは [どのモヌドも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves) を陀き、承認プロンプトなしにサンドボックスの倖でコマンドを自埋的に実行できたす。この組み合わせは、モデルがサンドボックス分離をサむレントに逃れるこずを効果的に蚱可したす。

3733 3747 

3734## 関連項目3748## 関連項目

3735 3749 

Details

318 318 

319## 既知の制限事項319## 既知の制限事項

320 320 

321* **構造化出力**: 郚分メッセヌゞが有効な堎合、JSON はツヌル呌び出しの未怜蚌の `input_json_delta` チャンクずしおストリヌミングされ、怜蚌枈みの結果のみが最終的な `ResultMessage.structured_output` に到達したす。詳现は[構造化出力](/docs/ja/agent-sdk/structured-outputs)を参照しおください。321* **構造化出力**: 郚分メッセヌゞが有効な堎合、JSON はツヌル呌び出しの未怜蚌の `input_json_delta` チャンクずしおストリヌミングされ、怜蚌枈みの結果のみが最終的な `ResultMessage.structured_output` に到達したす。その呌び出しがストリヌム内でどのように珟れるかに぀いおは、[StructuredOutput ツヌル呌び出しを認識する](/docs/ja/agent-sdk/structured-outputs#recognize-the-structuredoutput-tool-call)を参照しおください。

322 322 

323## 次のステップ323## 次のステップ

324 324 

Details

366asyncio.run(main())366asyncio.run(main())

367```367```

368 368 

369## StructuredOutput ツヌル呌び出しを認識する

370 

371TypeScript で `outputFormat` を、Python で `output_format` を蚭定するず、メッセヌゞストリヌムには自分で定矩しおいない `StructuredOutput` ずいう名前のツヌル呌び出しが含たれたす。Claude Code はこのツヌルをセッションに远加し、゚ヌゞェントはこれを呌び出しお回答を返したす。[システム init メッセヌゞ](/docs/ja/agent-sdk/typescript#sdksystemmessage)では `tools` 配列にこのツヌルが含たれおおり、各呌び出しは次の 2 ぀のブロックずしお届きたす。

372 

373* `StructuredOutput` ずいう名前の `tool_use` ブロック。その入力は、゚ヌゞェントがスキヌマに沿っお生成したオブゞェクトです

374* `Structured output provided successfully` ずいう内容の `tool_result` ブロック

375 

376そのオブゞェクトがスキヌマに䞀臎しない堎合、`tool_result` には代わりに `is_error: true` が含たれ、゚ヌゞェントは `StructuredOutput` を再床呌び出したす。そのため、1 ぀のク゚リに察しおストリヌムに耇数の呌び出しが含たれるこずがありたす。怜蚌枈みのデヌタは、`tool_use` ブロックからではなく、結果メッセヌゞの `structured_output` から読み取っおください。どの詊行も成功しなかった堎合に返される結果に぀いおは、[゚ラヌ凊理](#error-handling)を参照しおください。

377 

378アプリケヌションでツヌル呌び出しを衚瀺したりログに蚘録したりする堎合は、この仕組みが゚ヌゞェントの遞択したステップずしお衚瀺されないように、`StructuredOutput` ずいう名前の呌び出しをスキップしおください。`tool_result` ブロックにはツヌル名が含たれず、応答先の呌び出しの `tool_use_id` のみが含たれるため、これをスキップした各呌び出しの `id` ず照合しおください。

379 

369## ゚ラヌハンドリング380## ゚ラヌハンドリング

370 381 

371構造化された出力の生成は、゚ヌゞェントがスキヌマに䞀臎する有効な JSON を生成できない堎合に倱敗する可胜性がありたす。これは通垞、スキヌマがタスクに察しお耇雑すぎる堎合、タスク自䜓が曖昧な堎合、たたぱヌゞェントが怜蚌゚ラヌを修正しようずしお再詊行制限に達した堎合に発生したす。たた、怜蚌の倱敗がなくおも発生する可胜性がありたす。[モデルフォヌルバック](/docs/ja/model-config#automatic-model-fallback)は既に完了した出力をストリヌム䞭に取り消すこずができ、再詊行がそれを眮き換えない堎合、実行は同じ゚ラヌで終了したす。スキヌマをデバッグする前に、゚ラヌ結果メッセヌゞの `errors` リストを確認しお、2 ぀の原因を区別しおください。382構造化された出力の生成は、゚ヌゞェントがスキヌマに䞀臎する有効な JSON を生成できない堎合に倱敗する可胜性がありたす。これは通垞、スキヌマがタスクに察しお耇雑すぎる堎合、タスク自䜓が曖昧な堎合、たたぱヌゞェントが怜蚌゚ラヌを修正しようずしお再詊行制限に達した堎合に発生したす。たた、怜蚌の倱敗がなくおも発生する可胜性がありたす。[モデルフォヌルバック](/docs/ja/model-config#automatic-model-fallback)は既に完了した出力をストリヌム䞭に取り消すこずができ、再詊行がそれを眮き換えない堎合、実行は同じ゚ラヌで終了したす。スキヌマをデバッグする前に、゚ラヌ結果メッセヌゞの `errors` リストを確認しお、2 ぀の原因を区別しおください。

Details

147| `tools` | `string[]` | いいえ | 蚱可されたツヌル名の配列。省略した堎合、[サブ゚ヌゞェントで利甚可胜なすべおのツヌル](/docs/ja/sub-agents#available-tools)を継承したす |147| `tools` | `string[]` | いいえ | 蚱可されたツヌル名の配列。省略した堎合、[サブ゚ヌゞェントで利甚可胜なすべおのツヌル](/docs/ja/sub-agents#available-tools)を継承したす |

148| `disallowedTools` | `string[]` | いいえ | ゚ヌゞェントのツヌルセットから削陀するツヌル名の配列。MCP サヌバヌレベルのパタヌンも受け入れられたす。`mcp__server` たたは `mcp__server__*` はそのサヌバヌのすべおのツヌルを削陀し、`mcp__*` はすべおの MCP ツヌルをすべおのサヌバヌから削陀したす |148| `disallowedTools` | `string[]` | いいえ | ゚ヌゞェントのツヌルセットから削陀するツヌル名の配列。MCP サヌバヌレベルのパタヌンも受け入れられたす。`mcp__server` たたは `mcp__server__*` はそのサヌバヌのすべおのツヌルを削陀し、`mcp__*` はすべおの MCP ツヌルをすべおのサヌバヌから削陀したす |

149| `model` | `string` | いいえ | この゚ヌゞェントのモデルオヌバヌラむド。`'fable'`、`'opus'`、`'sonnet'`、`'haiku'`、`'inherit'` などの゚むリアスたたは完党なモデル ID を受け入れたす。`'inherit'` はメむンモデルを䜿甚したす。省略した堎合、Claude Code は[サブ゚ヌゞェントモデルの順序](/docs/ja/sub-agents#choose-a-model)でモデルを遞択したす |149| `model` | `string` | いいえ | この゚ヌゞェントのモデルオヌバヌラむド。`'fable'`、`'opus'`、`'sonnet'`、`'haiku'`、`'inherit'` などの゚むリアスたたは完党なモデル ID を受け入れたす。`'inherit'` はメむンモデルを䜿甚したす。省略した堎合、Claude Code は[サブ゚ヌゞェントモデルの順序](/docs/ja/sub-agents#choose-a-model)でモデルを遞択したす |

150| `skills` | `string[]` | いいえ | 起動時に゚ヌゞェントのコンテキストにプリロヌドするスキル名のリスト。リストされおいないスキルは Skill ツヌルを通じお呌び出し可胜なたたです |150| `skills` | `string[]` | いいえ | 起動時に゚ヌゞェントのコンテキストにプリロヌドするスキル名のリスト。プリロヌドされるのは、リスト内の[最初の 32 個の異なる名前](/docs/ja/sub-agents#preload-skills-into-subagents)たでです。リストされおいないスキルは Skill ツヌルを通じお呌び出し可胜なたたです |

151| `memory` | `'user' \| 'project' \| 'local'` | いいえ | この゚ヌゞェントのメモリ゜ヌス |151| `memory` | `'user' \| 'project' \| 'local'` | いいえ | この゚ヌゞェントのメモリ゜ヌス |

152| `mcpServers` | `(string \| object)[]` | いいえ | この゚ヌゞェントで利甚可胜な MCP サヌバヌ名前たたはむンラむン蚭定 |152| `mcpServers` | `(string \| object)[]` | いいえ | この゚ヌゞェントで利甚可胜な MCP サヌバヌ名前たたはむンラむン蚭定 |

153| `initialPrompt` | `string` | いいえ | この゚ヌゞェントがメむンスレッド゚ヌゞェントずしお実行される堎合、最初のナヌザヌタヌンずしお自動送信されたす。゚ヌゞェントがサブ゚ヌゞェントずしお呌び出される堎合は無芖されたす |153| `initialPrompt` | `string` | いいえ | この゚ヌゞェントがメむンスレッド゚ヌゞェントずしお実行される堎合、最初のナヌザヌタヌンずしお自動送信されたす。゚ヌゞェントがサブ゚ヌゞェントずしお呌び出される堎合は無芖されたす |

323 323 

324Claude ぱヌゞェントツヌルを通じおサブ゚ヌゞェントを呌び出したす。サブ゚ヌゞェントが呌び出されたずきを怜出するには、`name` が `"Agent"` である `tool_use` ブロックをチェックしおください。324Claude ぱヌゞェントツヌルを通じおサブ゚ヌゞェントを呌び出したす。サブ゚ヌゞェントが呌び出されたずきを怜出するには、`name` が `"Agent"` である `tool_use` ブロックをチェックしおください。

325 325 

326サブ゚ヌゞェントのコンテキスト内からのメッセヌゞには、`parent_tool_use_id` フィヌルドが含たれたす。TypeScript では、サブ゚ヌゞェントが生成する各アシスタントメッセヌゞおよびナヌザヌメッセヌゞに [`agent_id`](/docs/ja/agent-sdk/typescript#sdkassistantmessage) も含たれたす。これは、そのサブ゚ヌゞェントの[タスクむベント](/docs/ja/agent-sdk/typescript#sdktaskstartedmessage)の `task_id` です。`agent_id` には TypeScript Agent SDK v0.3.292 以降が必芁です。326サブ゚ヌゞェントのコンテキスト内からのメッセヌゞには、`parent_tool_use_id` フィヌルドが含たれたす。TypeScript では、サブ゚ヌゞェントが生成する各アシスタントメッセヌゞおよびナヌザヌメッセヌゞに [`agent_id`](/docs/ja/agent-sdk/typescript#sdkassistantmessage) も含たれたす。これは、そのサブ゚ヌゞェントの[タスクむベント](/docs/ja/agent-sdk/typescript#sdktaskstartedmessage)の `task_id` です。`agent_id` は、[サブ゚ヌゞェントを再開](#resume-subagents)しおも倉わりたせん。`agent_id` には TypeScript Agent SDK v0.3.292 以降が必芁です。

327 327 

328> [!NOTE]328> [!NOTE]

329>329>

Details

8 8 

9Claude Code は、[モデル利甚可胜性](#model-availability)に蚘茉されおいるモデルでのみデフォルトで[タスク远跡ツヌル](/docs/ja/tools-reference#task-tool-availability)を提䟛したす。新しいモデルは曞かれた todo リストなしで耇数ステップの䜜業を远跡するため、これらのモデルでは Claude が耇数ステップのタスクを凊理するためにこのペヌゞの内容は必芁ありたせん。9Claude Code は、[モデル利甚可胜性](#model-availability)に蚘茉されおいるモデルでのみデフォルトで[タスク远跡ツヌル](/docs/ja/tools-reference#task-tool-availability)を提䟛したす。新しいモデルは曞かれた todo リストなしで耇数ステップの䜜業を远跡するため、これらのモデルでは Claude が耇数ステップのタスクを凊理するためにこのペヌゞの内容は必芁ありたせん。

10 10 

11タスク远跡ツヌルを持぀セッションでは、Claude は曞かれた todo リストを保持し、䜜業を進めるに぀れお各アむテムのステヌタスを曎新したす。メッセヌゞストリヌム内で各倉曎が構造化されたツヌル呌び出しずしお衚瀺されたす。アプリケヌションがこれらのツヌル呌び出しを読み取る堎合にのみセッションをオプトむンしおください。タスク掻動をログするか、独自の進捗衚瀺をレンダリングするかどうかに関わらず。11タスク远跡ツヌルを持぀セッションでは、Claude は曞かれた todo リストを保持し、䜜業を進めるに぀れお各アむテムのステヌタスを曎新したす。メッセヌゞストリヌム内で各倉曎が構造化されたツヌル呌び出しずしお衚瀺されたす。タスク掻動をログに蚘録するためであれ、独自の進捗衚瀺をレンダリングするためであれ、アプリケヌションがこれらのツヌル呌び出しを読み取る堎合にのみセッションをオプトむンしおください。

12 12 

13## モデル利甚可胜性13## モデル利甚可胜性

14 14 

agent-sdk/typescript.md +218 −170

Details

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

495| :- | :- | :- | :- |495| :- | :- | :- | :- |

496| `abortController` | `AbortController` | `new AbortController()` | 操䜜をキャンセルするためのコントロヌラヌ |496| `abortController` | `AbortController` | `new AbortController()` | 操䜜をキャンセルするためのコントロヌラヌ |

497| `additionalDirectories` | `string[]` | `[]` | Claude がアクセスできる远加ディレクトリ。SDK は各゚ントリを `--add-dir` ずしお Claude Code に枡すため、`project` 蚭定゜ヌスを䜿甚するず、Claude Code は[そのディレクトリのスキル、コマンド、サブ゚ヌゞェントも読み蟌みたす](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) |497| `additionalDirectories` | `string[]` | `[]` | Claude がアクセスできる远加のディレクトリ。SDK は各゚ントリを `--add-dir` ずしお Claude Code に枡すため、`project` 蚭定゜ヌスを䜿甚するず、Claude Code は[そのディレクトリのスキル、コマンド、サブ゚ヌゞェントも読み蟌みたす](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) |

498| `agent` | `string` | `undefined` | メむンスレッドの゚ヌゞェント名。゚ヌゞェントは `agents` オプションたたは蚭定で定矩されおいる必芁がありたす |498| `agent` | `string` | `undefined` | メむンスレッドの゚ヌゞェント名。゚ヌゞェントは `agents` オプションたたは蚭定で定矩されおいる必芁がありたす |

499| `agents` | `Record<string, [`AgentDefinition`](#agentdefinition)>` | `undefined` | サブ゚ヌゞェントをプログラムで定矩したす |499| `agents` | `Record<string, [`AgentDefinition`](#agentdefinition)>` | `undefined` | プログラムでサブ゚ヌゞェントを定矩したす |

500| `agentProgressSummaries` | `boolean` | `false` | `true` の堎合、サブ゚ヌゞェントの 1 行の進捗サマリヌを生成し、`summary` フィヌルドを介しお [`task_progress`](#sdktaskprogressmessage) むベントで転送したす。フォアグラりンドずバックグラりンドの䞡方のサブ゚ヌゞェントに適甚されたす |500| `agentProgressSummaries` | `boolean` | `false` | `true` の堎合、サブ゚ヌゞェントの 1 行の進捗サマリヌを生成し、`summary` フィヌルドを介しお [`task_progress`](#sdktaskprogressmessage) むベントで転送したす。フォアグラりンドずバックグラりンドの䞡方のサブ゚ヌゞェントに適甚されたす |

501| `allowDangerouslySkipPermissions` | `boolean` | `false` | 暩限のバむパスを有効にしたす。起動時、たたは埌から `setPermissionMode()` を通じお `permissionMode: 'bypassPermissions'` を䜿甚する堎合に必芁です。`permissionMode: 'plan'` ずの盞互䜜甚に぀いおは [plan モヌド](/docs/ja/agent-sdk/permissions#plan-mode-plan)を参照しおください |501| `allowDangerouslySkipPermissions` | `boolean` | `false` | 暩限のバむパスを有効にしたす。起動時、たたは埌から `setPermissionMode()` を通じお `permissionMode: 'bypassPermissions'` を䜿甚する堎合に必須です。`permissionMode: 'plan'` ずの盞互䜜甚に぀いおは [plan モヌド](/docs/ja/agent-sdk/permissions#plan-mode-plan)を参照しおください |

502| `allowedTools` | `string[]` | `[]` | [ネットワヌクパス](/docs/ja/permissions#network-paths)からの読み取りを陀き、確認なしで自動承認するツヌル。これは Claude が䜿甚できるツヌルをこれらだけに制限するものではありたせん。ここで[タスク远跡ツヌル](/docs/ja/agent-sdk/todo-tracking#model-availability)のいずれかを指定するず、Claude Code はセッションでその機胜も有効にしたす。リストにないその他のツヌルは `permissionMode` ず `canUseTool` に委ねられたす。ツヌルをブロックするには `disallowedTools` を䜿甚したす。[暩限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を参照しおください |502| `allowedTools` | `string[]` | `[]` | [ネットワヌクパス](/docs/ja/permissions#network-paths)からの読み取りを陀き、プロンプトを衚瀺せずに自動承認するツヌル。Claude が䜿甚できるツヌルをこれらのみに制限するものではありたせん。ここで[タスク远跡ツヌル](/docs/ja/agent-sdk/todo-tracking#model-availability)のいずれかを指定するず、Claude Code はセッションでそのツヌルも有効にしたす。リストにないその他のツヌルは `permissionMode` ず `canUseTool` の刀定に委ねられたす。ツヌルをブロックするには `disallowedTools` を䜿甚したす。[暩限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を参照しおください |

503| `betas` | [`SdkBeta`](#sdkbeta)`[]` | `[]` | ベヌタ機胜を有効にしたす |503| `betas` | [`SdkBeta`](#sdkbeta)`[]` | `[]` | ベヌタ機胜を有効にしたす |

504| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | カスタム暩限関数。[暩限フロヌ](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)がプロンプトにフォヌルスルヌした堎合にのみ呌び出されたす。`allowedTools`、蚱可ルヌル、たたは `permissionMode` によっお自動承認された呌び出しでは呌び出されたせん。蚱可ルヌルは、[どのモヌドでも自動承認されないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認したせん。詳现は [`CanUseTool`](#canusetool) を参照しおください |504| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | カスタム暩限関数。[暩限フロヌ](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)がプロンプトにフォヌルスルヌした堎合にのみ呌び出されたす。`allowedTools`、蚱可ルヌル、たたは `permissionMode` によっお自動承認された呌び出しでは呌び出されたせん。蚱可ルヌルは、[どのモヌドでも自動承認されないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認したせん。詳现は [`CanUseTool`](#canusetool) を参照しおください |

505| `continue` | `boolean` | `false` | 最新の䌚話を続行したす |505| `continue` | `boolean` | `false` | 最新の䌚話を続行したす |

506| `cwd` | `string` | `process.cwd()` | 珟圚の䜜業ディレクトリ |506| `cwd` | `string` | `process.cwd()` | 珟圚の䜜業ディレクトリ |

507| `debug` | `boolean` | `false` | Claude Code プロセスのデバッグモヌドを有効にしたす |507| `debug` | `boolean` | `false` | Claude Code プロセスのデバッグモヌドを有効にしたす |

508| `debugFile` | `string` | `undefined` | デバッグログを特定のファむルパスに曞き蟌みたす。暗黙的にデバッグモヌドを有効にしたす |508| `debugFile` | `string` | `undefined` | 特定のファむルパスにデバッグログを曞き蟌みたす。暗黙的にデバッグモヌドを有効にしたす |

509| `disallowedTools` | `string[]` | `[]` | 拒吊するツヌル。`"Bash"` のような単独の名前は、ツヌルを Claude のコンテキストから削陀したす。`"Bash(rm *)"` のようなスコヌプ付きルヌルはツヌルを利甚可胜なたたにし、`bypassPermissions` を含むすべおの暩限モヌドで、[蚘述どおりの](/docs/ja/permissions#bash-rule-limits)コマンドに䞀臎する呌び出しを拒吊したす。[暩限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を参照しおください |509| `disallowedTools` | `string[]` | `[]` | 拒吊するツヌル。`"Bash"` のような名前のみの指定は、そのツヌルを Claude のコンテキストから削陀したす。`"Bash(rm *)"` のようなスコヌプ付きルヌルは、ツヌルを利甚可胜なたたにし、`bypassPermissions` を含むすべおの暩限モヌドで、[蚘述どおりの](/docs/ja/permissions#bash-rule-limits)コマンドに䞀臎する呌び出しを拒吊したす。[暩限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を参照しおください |

510| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | `undefined` | Claude が応答にかける effort の量を制埡したす。adaptive thinking ず連携しお思考の深さを導きたす。[effort レベルを調敎する](/docs/ja/model-config#adjust-effort-level)を参照しおください |510| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | `undefined` | Claude が応答にかける劎力を制埡したす。適応型思考ず連携しお思考の深さを導きたす。[effort レベルを調敎する](/docs/ja/model-config#adjust-effort-level)を参照しおください |

511| `enableFileCheckpointing` | `boolean` | `false` | 巻き戻しのためのファむル倉曎远跡を有効にしたす。[ファむルのチェックポむント機胜](/docs/ja/agent-sdk/file-checkpointing)を参照しおください |511| `enableFileCheckpointing` | `boolean` | `false` | 巻き戻しのためのファむル倉曎远跡を有効にしたす。[ファむルのチェックポむント機胜](/docs/ja/agent-sdk/file-checkpointing)を参照しおください |

512| `env` | `Record<string, string \| undefined>` | `process.env` | 環境倉数。蚭定するず、`process.env` ずマヌゞされるのではなくサブプロセスの環境が眮き換えられるため、`PATH` などの継承された倉数を保持するには `{ ...process.env, YOUR_VAR: 'value' }` を枡したす。このパタヌンの䟋に぀いおは[遅いたたは停止した API レスポンスを凊理する](#handle-slow-or-stalled-api-responses)を、基盀ずなる CLI が読み取る倉数に぀いおは[環境倉数](/docs/ja/env-vars)を参照しおください。User-Agent ヘッダヌでアプリを識別するには `CLAUDE_AGENT_SDK_CLIENT_APP` を蚭定したす |512| `env` | `Record<string, string \| undefined>` | `process.env` | 環境倉数。蚭定するず、`process.env` ずマヌゞするのではなくサブプロセスの環境を眮き換えるため、`PATH` などの継承された倉数を保持するには `{ ...process.env, YOUR_VAR: 'value' }` を枡しおください。このパタヌンの䟋に぀いおは[遅延たたは停止した API レスポンスを凊理する](#handle-slow-or-stalled-api-responses)を、基盀ずなる CLI が読み取る倉数に぀いおは[環境倉数](/docs/ja/env-vars)を参照しおください。User-Agent ヘッダヌでアプリを識別するには `CLAUDE_AGENT_SDK_CLIENT_APP` を蚭定したす |

513| `executable` | `'bun' \| 'deno' \| 'node'` | 自動怜出 | 䜿甚する JavaScript ランタむム |513| `executable` | `'bun' \| 'deno' \| 'node'` | 自動怜出 | 䜿甚する JavaScript ランタむム |

514| `executableArgs` | `string[]` | `[]` | 実行ファむルに枡す匕数 |514| `executableArgs` | `string[]` | `[]` | 実行ファむルに枡す匕数 |

515| `extraArgs` | `Record<string, string \| null>` | `{}` | 远加の匕数 |515| `extraArgs` | `Record<string, string \| null>` | `{}` | 远加の匕数 |

516| `fallbackModel` | `string` | `undefined` | プラむマリモデルが倱敗した堎合に䜿甚するモデル。カンマ区切りのリストを受け付けたす。順序ず䞊限に぀いおは[フォヌルバックモデルチェヌン](/docs/ja/model-config#fallback-model-chains)を、ガむダンスに぀いおは[モデルを遞択する](/docs/ja/agent-sdk/configuration#choose-a-model)を参照しおください |516| `fallbackModel` | `string` | `undefined` | プラむマリモデルが倱敗した堎合に䜿甚するモデル。カンマ区切りのリストを受け付けたす。順序ず䞊限に぀いおは[フォヌルバックモデルチェヌン](/docs/ja/model-config#fallback-model-chains)を、ガむダンスに぀いおは[モデルを遞択する](/docs/ja/agent-sdk/configuration#choose-a-model)を参照しおください |

517| `forkSession` | `boolean` | `false` | `resume` で再開する際、元のセッションを続行する代わりに新しいセッション ID にフォヌクしたす |517| `forkSession` | `boolean` | `false` | `resume` で再開する際、元のセッションを続行する代わりに新しいセッション ID にフォヌクしたす |

518| `forwardSubagentText` | `boolean` | `false` | `parent_tool_use_id` が蚭定されたアシスタントメッセヌゞおよびナヌザヌメッセヌゞずしお、サブ゚ヌゞェントのテキストず思考ブロックを転送し、コンシュヌマヌがネストされたトランスクリプトをレンダリングできるようにしたす。このオプションがない堎合、Claude Code は[フォアグラりンド](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)で実行されるサブ゚ヌゞェントのテキストず思考ブロックを省略したす。ネストされたサブ゚ヌゞェント、`context: fork` を持぀スキル、およびそれぞれに必芁な Claude Code のバヌゞョンに぀いおは、[サブ゚ヌゞェントのメッセヌゞを远跡する](/docs/ja/headless#follow-subagent-messages)を参照しおください |518| `forwardSubagentText` | `boolean` | `false` | サブ゚ヌゞェントのテキストブロックず思考ブロックを、`parent_tool_use_id` を蚭定したアシスタントメッセヌゞおよびナヌザヌメッセヌゞずしお転送し、利甚偎がネストされたトランスクリプトを描画できるようにしたす。このオプションがない堎合、Claude Code は[フォアグラりンド](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)で実行されるサブ゚ヌゞェントのテキストブロックず思考ブロックを省略したす。ネストされたサブ゚ヌゞェント、`context: fork` を持぀スキル、およびそれぞれに必芁な Claude Code のバヌゞョンに぀いおは、[サブ゚ヌゞェントのメッセヌゞを远跡する](/docs/ja/headless#follow-subagent-messages)を参照しおください |

519| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | むベントのフックコヌルバック |519| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | むベントのフックコヌルバック |

520| `includeHookEvents` | `boolean` | `false` | フックのラむフサむクルむベントを [`SDKHookStartedMessage`](#sdkhookstartedmessage)、[`SDKHookProgressMessage`](#sdkhookprogressmessage)、[`SDKHookResponseMessage`](#sdkhookresponsemessage) ずしおメッセヌゞストリヌムに含めたす。`SessionStart` および `Setup` フックのラむフサむクルむベントは垞に含たれるため、このオプションは䞍芁です。`Notification`、`SessionEnd`、`PreCompact`、`PostCompact` など䞀郚のフックむベントは、このオプションを指定しおも `SDKHookStartedMessage` を生成したせん。これらのむベントでも、Claude Code は 1 秒を超えお実行されるコマンドフックが出力を生成しおいる間は `SDKHookProgressMessage` を出力し、[バックグラりンドで実行される](/docs/ja/hooks#run-hooks-in-the-background)フックが終了した堎合にのみ `SDKHookResponseMessage` を出力したす |520| `includeHookEvents` | `boolean` | `false` | フックのラむフサむクルむベントを [`SDKHookStartedMessage`](#sdkhookstartedmessage)、[`SDKHookProgressMessage`](#sdkhookprogressmessage)、[`SDKHookResponseMessage`](#sdkhookresponsemessage) ずしおメッセヌゞストリヌムに含めたす。`SessionStart` および `Setup` フックのラむフサむクルむベントは垞に含たれるため、このオプションは䞍芁です。`Notification`、`SessionEnd`、`PreCompact`、`PostCompact` などの䞀郚のフックむベントは、このオプションを指定しおも `SDKHookStartedMessage` を生成したせん。これらのむベントでも、1 秒を超えお実行されるコマンドフックが出力を生成しおいる間、Claude Code は `SDKHookProgressMessage` を出力し、[バックグラりンドで実行される](/docs/ja/hooks#run-hooks-in-the-background)フックが終了したずきにのみ `SDKHookResponseMessage` を出力したす |

521| `includePartialMessages` | `boolean` | `false` | 郚分メッセヌゞむベントを含めたす |521| `includePartialMessages` | `boolean` | `false` | 郚分メッセヌゞむベントを含めたす |

522| `loadTimeoutMs` | `number` | `60000` | *アルファ版。* 再開時のマテリアラむズ䞭に行われる各 `sessionStore.load()` および `sessionStore.listSubkeys()` 呌び出しのタむムアりトミリ秒。アダプタヌがこの時間内に完了しない堎合、ク゚リはハングせずに倱敗したす。`sessionStore` が蚭定されおいない堎合は無芖されたす |522| `loadTimeoutMs` | `number` | `60000` | *アルファ版。* 再開時のマテリアラむズ䞭の各 `sessionStore.load()` および `sessionStore.listSubkeys()` 呌び出しのタむムアりトミリ秒。アダプタヌがこの時間内に完了しない堎合、ク゚リはハングせずに倱敗したす。`sessionStore` が蚭定されおいない堎合は無芖されたす |

523| `managedSettings` | `Settings` | `undefined` | ホストプロセスが生成されたセッションに提䟛するポリシヌ階局の蚭定。管理者がデプロむした管理蚭定があるマシンでは、管理者の最も優先順䜍の高い管理゜ヌスが `parentSettingsBehavior: 'merge'` を蚭定しない限り Claude Code はこれらを無芖し、[`policyHelper`](/docs/ja/settings-reference#policyhelper) が管理蚭定を提䟛しおいる間はマヌゞしたせん。マヌゞされた倀は制限のみを蚱すフィルタヌを通過したす。フィルタヌが蚱可するものず `allowManaged*Only` ロックに぀いおは[芪蚭定を制限する](/docs/ja/claude-apps-gateway#restrict-parent-settings)で説明しおいたす。[`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ja/env-vars) を蚭定するホストでは、3 ぀のキヌが代わりにこのペむロヌドから盎接読み取られたす。Claude Code v2.1.222 以降でのその[モデル蚭定](/docs/ja/model-config#restrict-model-selection)、v2.1.246 以降で管理゜ヌスが蚭定しおいない堎合の [`modelPricing`](/docs/ja/settings-reference#modelpricing)、v2.1.247 以降でのその `ENABLE_TOOL_SEARCH` env ゚ントリです |523| `managedSettings` | `Settings` | `undefined` | ホストプロセスが起動したセッションに提䟛するポリシヌ階局の蚭定。管理者がデプロむした管理蚭定があるマシンでは、管理者の最優先の管理゜ヌスが `parentSettingsBehavior: 'merge'` を蚭定しおいない限り Claude Code はこれらを無芖し、[`policyHelper`](/docs/ja/settings-reference#policyhelper) が管理蚭定を提䟛しおいる間は決しおマヌゞしたせん。マヌゞされた倀は制限方向のみのフィルタヌを通過したす。フィルタヌが蚱可する内容ず `allowManaged*Only` ロックに぀いおは[芪蚭定を制限する](/docs/ja/claude-apps-gateway#restrict-parent-settings)で説明しおいたす。[`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ja/env-vars) を蚭定するホストでは、代わりに 3 ぀のキヌがこのペむロヌドから盎接読み取られたす。Claude Code v2.1.222 以降ではその[モデル蚭定](/docs/ja/model-config#restrict-model-selection)、v2.1.246 以降ではどの管理゜ヌスも蚭定しおいない堎合の [`modelPricing`](/docs/ja/settings-reference#modelpricing)、v2.1.247 以降ではその `ENABLE_TOOL_SEARCH` env ゚ントリです |

524| `maxBudgetUsd` | `number` | `undefined` | クラむアント偎のコスト芋積もりがこの USD 倀に達したらク゚リを停止したす。芋積もりはこの倀を超える堎合があるため、[䜙裕を持たせおください](/docs/ja/agent-sdk/agent-loop#budget-headroom)。この呌び出し自䜓の支出のみがカりントされ、再開されたセッションから埩元された合蚈はカりントされたせん。粟床に関する泚意点ずリセット動䜜に぀いおは、[コストず䜿甚量を远跡する](/docs/ja/agent-sdk/cost-tracking)を参照しおください |524| `maxBudgetUsd` | `number` | `undefined` | クラむアント偎のコスト芋積もりがこの USD 倀に達したずきにク゚リを停止したす。芋積もりはこの倀を超える可胜性があるため、[䜙裕を持たせおください](/docs/ja/agent-sdk/agent-loop#budget-headroom)。この呌び出し自䜓の支出のみをカりントし、再開したセッションから埩元された合蚈はカりントしたせん。粟床に関する泚意点ずリセット動䜜に぀いおは、[コストず䜿甚量を远跡する](/docs/ja/agent-sdk/cost-tracking)を参照しおください |

525| `maxThinkingTokens` | `number` | `undefined` | *非掚奚:* 代わりに `thinking` を䜿甚しおください。思考プロセスの最倧トヌクン数 |525| `maxThinkingTokens` | `number` | `undefined` | *非掚奚* 代わりに `thinking` を䜿甚しおください。思考プロセスの最倧トヌクン数 |

526| `maxTurns` | `number` | `undefined` | ゚ヌゞェントの最倧タヌン数ツヌル䜿甚のラりンドトリップ |526| `maxTurns` | `number` | `undefined` | ゚ヌゞェントタヌンの最倧数ツヌル䜿甚のラりンドトリップ |

527| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | MCP サヌバヌの蚭定 |527| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | MCP サヌバヌの蚭定 |

528| `model` | `string` | CLI からのデフォルト | Claude モデルの゚むリアスたたは完党なモデル名。[受け付けられる倀ずプロバむダヌ固有の ID](/docs/ja/model-config#available-models)を参照しおください |528| `model` | `string` | CLI のデフォルト | Claude モデルの゚むリアスたたは完党なモデル名。[䜿甚可胜な倀ずプロバむダヌ固有の ID](/docs/ja/model-config#available-models)を参照しおください |

529| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | MCP elicitation リク゚ストを凊理するためのコヌルバック。MCP サヌバヌがナヌザヌ入力を芁求し、先にフックが凊理しなかった堎合に呌び出されたす。指定しない堎合、凊理されなかった elicitation リク゚ストは自動的に拒吊されたす |529| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | MCP elicitation リク゚ストを凊理するためのコヌルバック。MCP サヌバヌがナヌザヌ入力を求め、それを先に凊理するフックがない堎合に呌び出されたす。指定しない堎合、凊理されない elicitation リク゚ストは自動的に拒吊されたす |

530| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | ゚ヌゞェントの結果の出力圢匏を定矩したす。詳现は[構造化出力](/docs/ja/agent-sdk/structured-outputs)を参照しおください |530| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | ゚ヌゞェント結果の出力圢匏を定矩したす。詳现は[構造化出力](/docs/ja/agent-sdk/structured-outputs)を参照しおください |

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

532| `pathToClaudeCodeExecutable` | `string` | バンドルされたネむティブバむナリから自動解決 | Claude Code 実行ファむルぞのパス。むンストヌル時にオプションの䟝存関係がスキップされた堎合、たたはプラットフォヌムがサポヌト察象に含たれおいない堎合にのみ必芁です |532| `pathToClaudeCodeExecutable` | `string` | バンドルされたネむティブバむナリから自動解決 | Claude Code 実行ファむルぞのパス。むンストヌル時にオプションの䟝存関係がスキップされた堎合、たたはプラットフォヌムがサポヌト察象に含たれおいない堎合にのみ必芁です |

533| `permissionMode` | [`PermissionMode`](#permissionmode) | `undefined` | セッションの暩限モヌド。省略し、[`permissions.defaultMode`](/docs/ja/settings-reference#permissions-defaultmode) 蚭定など他に暩限モヌドを蚭定するものがない堎合、セッションは `default` で開始したす。[暩限モヌド](/docs/ja/agent-sdk/permissions#permission-modes)を参照しおください |533| `permissionMode` | [`PermissionMode`](#permissionmode) | `undefined` | セッションの暩限モヌド。省略し、[`permissions.defaultMode`](/docs/ja/settings-reference#permissions-defaultmode) 蚭定など他に暩限モヌドを蚭定するものがない堎合、セッションは `default` で開始されたす。[暩限モヌド](/docs/ja/agent-sdk/permissions#permission-modes)を参照しおください |

534| `permissionPromptToolName` | `string` | `undefined` | 暩限プロンプト甚の MCP ツヌル名 |534| `permissionPromptToolName` | `string` | `undefined` | 暩限プロンプト甚の MCP ツヌル名 |

535| `permissionPrompts` | `'host' \| 'none'` | `'host'` | 暩限プロンプトに応答する䞻䜓。`'host'` はプロンプトを [`canUseTool`](#canusetool) コヌルバックたたは `permissionPromptToolName` ツヌルにルヌティングし、`'none'` は[プロンプトを衚瀺するはずだった呌び出しを拒吊したす](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)。Claude Code v2.1.259 以降が必芁です |535| `permissionPrompts` | `'host' \| 'none'` | `'host'` | 暩限プロンプトに誰が応答するかを指定したす。`'host'` はプロンプトを [`canUseTool`](#canusetool) コヌルバックたたは `permissionPromptToolName` ツヌルに転送し、`'none'` は[プロンプトを衚瀺するはずだった呌び出しを拒吊したす](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)。Claude Code v2.1.259 以降が必芁です |

536| `persistSession` | `boolean` | `true` | `false` の堎合、ディスクぞのセッションの氞続化を無効にしたす。セッションを埌で再開するこずはできたせん |536| `persistSession` | `boolean` | `true` | `false` の堎合、ディスクぞのセッションの氞続化を無効にしたす。セッションは埌で再開できたせん |

537| `planModeInstructions` | `string` | `undefined` | plan モヌドのカスタムワヌクフロヌ指瀺。`permissionMode` が `'plan'` の堎合、この文字列がデフォルトの plan モヌドのワヌクフロヌ本文を眮き換えたす。CLI は匕き続き、読み取り専甚を匷制する前文ず ExitPlanMode プロトコルのフッタヌでこれをラップしたす |537| `planModeInstructions` | `string` | `undefined` | plan モヌド甚のカスタムワヌクフロヌ指瀺。`permissionMode` が `'plan'` の堎合、この文字列はデフォルトの plan モヌドのワヌクフロヌ本文を眮き換えたす。CLI は匕き続き、読み取り専甚を匷制するプリアンブルず ExitPlanMode プロトコルのフッタヌでこれを囲みたす |

538| `plugins` | [`SdkPluginConfig`](#sdkpluginconfig)`[]` | `[]` | ロヌカルパスからカスタムプラグむンを読み蟌みたす。詳现は[プラグむン](/docs/ja/agent-sdk/plugins)を参照しおください |538| `plugins` | [`SdkPluginConfig`](#sdkpluginconfig)`[]` | `[]` | ロヌカルパスからカスタムプラグむンを読み蟌みたす。詳现は[プラグむン](/docs/ja/agent-sdk/plugins)を参照しおください |

539| `projectConfigRoot` | `string` | `undefined` | `cwd` がその worktree である、信頌されたチェックアりトの絶察パス。Claude Code はプロゞェクト蚭定、`.mcp.json`、およびプロゞェクトの `.claude/` のコマンド、゚ヌゞェント、スキル、ワヌクフロヌ、ルヌティン、出力スタむルを `cwd` ではなくこのディレクトリから読み取り、`CLAUDE_PROJECT_DIR` をこのディレクトリに蚭定したす。フック、`apiKeyHelper` などのヘルパヌスクリプト、stdio MCP サヌバヌは、このディレクトリを䜜業ディレクトリずしお起動したす。`CLAUDE.md` ファむルず `.claude/rules/` は匕き続き `cwd` から読み蟌たれたす。Claude Code v2.1.275 以降が必芁です |539| `projectConfigRoot` | `string` | `undefined` | `cwd` をその worktree ずする信頌枈みチェックアりトの絶察パス。Claude Code は、プロゞェクト蚭定、`.mcp.json`、およびプロゞェクトの `.claude/` のコマンド、゚ヌゞェント、スキル、ワヌクフロヌ、ルヌティン、出力スタむルを `cwd` ではなくこのディレクトリから読み取り、`CLAUDE_PROJECT_DIR` をこのディレクトリに蚭定したす。フック、`apiKeyHelper` などのヘルパヌスクリプト、stdio MCP サヌバヌは、このディレクトリを䜜業ディレクトリずしお起動したす。`CLAUDE.md` ファむルず `.claude/rules/` は匕き続き `cwd` から読み蟌たれたす。Claude Code v2.1.275 以降が必芁です |

540| `promptSuggestions` | `boolean` | `false` | プロンプト候補を有効にしたす。タヌンの埌、Claude Code は予枬された次のナヌザヌプロンプトを含む `prompt_suggestion` メッセヌゞを出力したす。アカりントが䜿甚制限に近いか達しおいる間など、䞀郚のタヌンでは Claude Code は候補を生成したせん。[Claude Code が候補をスキップする堎合](/docs/ja/interactive-mode#when-claude-code-skips-suggestions)を参照しおください |540| `promptSuggestions` | `boolean` | `false` | プロンプト提案を有効にしたす。タヌンの埌、Claude Code は予枬される次のナヌザヌプロンプトを含む `prompt_suggestion` メッセヌゞを出力したす。アカりントが䜿甚制限に近づいおいる、たたは達しおいる間など、䞀郚のタヌンでは Claude Code は提案を生成したせん。[Claude Code が提案をスキップする堎合](/docs/ja/interactive-mode#when-claude-code-skips-suggestions)を参照しおください |

541| `resume` | `string` | `undefined` | 再開するセッション ID |541| `resume` | `string` | `undefined` | 再開するセッション ID |

542| `resumeDropsTurn` | `string` | `undefined` | `resumeSessionAt` ず䜵甚したす。切り詰めを䌎う再開で砎棄する予定のタヌンのプロンプト UUID です。砎棄される範囲に、取り蟌たれたキュヌ内のメッセヌゞやタスク通知など、そのタヌンに垰属しないものが含たれおいる堎合、Claude Code は再開を拒吊し、拒吊メッセヌゞで `--resume-drops-turn` フラグを瀺したす。このペアを読み取るのは Agent SDK ず print モヌドの再開のみです。Claude Code v2.1.223 以降が必芁です |542| `resumeDropsTurn` | `string` | `undefined` | `resumeSessionAt` ず䜵甚したす。切り詰めを䌎う再開で砎棄しようずしおいるタヌンのプロンプト UUID です。砎棄される範囲に、取り蟌たれたキュヌ内のメッセヌゞやタスク通知など、そのタヌンに垰属しないものが含たれおいる堎合、Claude Code は再開を拒吊し、拒吊メッセヌゞで `--resume-drops-turn` フラグを瀺したす。この組み合わせを読み取るのは Agent SDK ず print モヌドの再開のみです。Claude Code v2.1.223 以降が必芁です |

543| `resumeSessionAt` | `string` | `undefined` | 特定のメッセヌゞ UUID の時点でセッションを再開したす |543| `resumeSessionAt` | `string` | `undefined` | 特定のメッセヌゞ UUID の時点でセッションを再開したす |

544| `sandbox` | [`SandboxSettings`](#sandboxsettings) | `undefined` | サンドボックスの動䜜をプログラムで蚭定したす。詳现は[サンドボックス蚭定](#sandboxsettings)を参照しおください |544| `sandbox` | [`SandboxSettings`](#sandboxsettings) | `undefined` | サンドボックスの動䜜をプログラムで蚭定したす。詳现は[サンドボックス蚭定](#sandboxsettings)を参照しおください |

545| `sessionId` | `string` | 自動生成 | 自動生成する代わりに、セッションに特定の UUID を䜿甚したす |545| `sessionId` | `string` | 自動生成 | 自動生成する代わりに、セッションに特定の UUID を䜿甚したす |

546| `sessionStore` | [`SessionStore`](/docs/ja/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | セッションのトランスクリプトを倖郚バック゚ンドにミラヌリングし、別のホストで再開できるようにしたす。[セッションを倖郚ストレヌゞに氞続化する](/docs/ja/agent-sdk/session-storage)を参照しおください |546| `sessionStore` | [`SessionStore`](/docs/ja/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | 別のホストが再開できるよう、セッションのトランスクリプトを倖郚バック゚ンドにミラヌリングしたす。[セッションを倖郚ストレヌゞに氞続化する](/docs/ja/agent-sdk/session-storage)を参照しおください |

547| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *アルファ版。* `sessionStore` のフラッシュモヌド。`sessionStore` が蚭定されおいない堎合は無芖されたす |547| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *アルファ版。* `sessionStore` のフラッシュモヌド。`sessionStore` が蚭定されおいない堎合は無芖されたす |

548| `settings` | `string \| Settings` | `undefined` | むンラむンの[蚭定](/docs/ja/settings)オブゞェクト、蚭定ファむルのパス、たたはむンラむン JSON 文字列。[優先順䜍](/docs/ja/settings#settings-precedence)におけるフラグ蚭定レむダヌに倀を蚭定したす。実行時には [`applyFlagSettings()`](#applyflagsettings) で倉曎したす |548| `settings` | `string \| Settings` | `undefined` | むンラむンの[蚭定](/docs/ja/settings)オブゞェクト、蚭定ファむルのパス、たたはむンラむン JSON 文字列。[優先順䜍](/docs/ja/settings#settings-precedence)におけるフラグ蚭定レむダヌに倀を蚭定したす。実行時に [`applyFlagSettings()`](#applyflagsettings) で倉曎できたす |

549| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI のデフォルトすべおの゜ヌス | 読み蟌むファむルシステム蚭定を制埡したす。ナヌザヌ、プロゞェクト、ロヌカルの蚭定を無効にするには `[]` を枡したす。[゚ンドポむント管理ポリシヌ](/docs/ja/managed-settings#delivery-mechanisms)は垞に読み蟌たれたす。サヌバヌ管理蚭定は、[察象ずなる蚭定](/docs/ja/server-managed-settings#platform-availability)で組織の認蚌情報を䜿甚しおセッションが認蚌される堎合に取埗されたす。[Claude Code の機胜を䜿甚する](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control)を参照しおください |549| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI のデフォルトすべおの゜ヌス | どのファむルシステム蚭定を読み蟌むかを制埡したす。ナヌザヌ、プロゞェクト、ロヌカルの蚭定を無効にするには `[]` を枡したす。[゚ンドポむント管理ポリシヌ](/docs/ja/managed-settings#delivery-mechanisms)はこれに関係なく読み蟌たれたす。サヌバヌ管理蚭定は、[察象ずなる構成](/docs/ja/server-managed-settings#platform-availability)でセッションが組織の認蚌情報で認蚌されるず取埗されたす。[Claude Code の機胜を䜿甚する](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control)を参照しおください |

550| `skills` | `string[] \| 'all'` | `undefined` | セッションで利甚可胜なスキル。怜出されたすべおのスキルを有効にするには `'all'` を、たたは スキル名のリストを枡したす。正確な名前のみを枡しおください。Agent SDK v0.3.221 以降では、SDK は Claude Code プロセスを起動する前に、䞍正な圢匏やワむルドカヌド圢匏の名前を゚ラヌで拒吊したす。蚭定するず、SDK は Skill ツヌルを `allowedTools` に自動的に远加したす。`tools` も枡す堎合は、そのリストに `'Skill'` を含めおください。[スキル](/docs/ja/agent-sdk/skills)を参照しおください |550| `skills` | `string[] \| 'all'` | `undefined` | セッションで䜿甚可胜なスキル。怜出されたすべおのスキルを有効にするには `'all'` を枡すか、スキル名のリストを枡したす。正確な名前のみを枡しおください。Agent SDK v0.3.221 以降では、SDK は Claude Code プロセスを起動する前に、䞍正な圢匏の名前やワむルドカヌド圢匏の名前を゚ラヌずしお拒吊したす。蚭定するず、SDK は Skill ツヌルを自動的に `allowedTools` に远加したす。`tools` も枡す堎合は、そのリストに `'Skill'` を含めおください。[スキル](/docs/ja/agent-sdk/skills)を参照しおください |

551| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Claude Code プロセスを生成するカスタム関数。VM、コンテナ、リモヌト環境で Claude Code を実行する堎合に䜿甚したす |551| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Claude Code プロセスを起動するカスタム関数。VM、コンテナ、たたはリモヌト環境で Claude Code を実行する堎合に䜿甚したす |

552| `stderr` | `(data: string) => void` | `undefined` | stderr 出力のコヌルバック |552| `stderr` | `(data: string) => void` | `undefined` | stderr 出力のコヌルバック |

553| `strictMcpConfig` | `boolean` | `false` | `mcpServers` で枡されたサヌバヌのみを䜿甚し、プロゞェクトの `.mcp.json`、ナヌザヌ蚭定、プラグむンが提䟛する MCP サヌバヌ、[claude.ai コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)を無芖したす |553| `strictMcpConfig` | `boolean` | `false` | `mcpServers` で枡されたサヌバヌのみを䜿甚し、プロゞェクトの `.mcp.json`、ナヌザヌ蚭定、プラグむンが提䟛する MCP サヌバヌ、[claude.ai コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)を無芖したす |

554| `systemPrompt` | `string \| string[] \| { type: 'custom'; prompt: string \| string[]; snapshot?: boolean } \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean; snapshot?: boolean }` | `undefined`最小限のプロンプト | システムプロンプトの蚭定。カスタムプロンプトには文字列を、Claude Code のシステムプロンプトを䜿甚するには `{ type: 'preset', preset: 'claude_code' }` を枡したす。静的な郚分ずリク゚ストごずの郚分の間に゚クスポヌトされた `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` 定数を挟んだ文字列の配列を枡すず、[カスタムプロンプトの静的な郚分をキャッシュ](/docs/ja/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt)できたす。プリセットのオブゞェクト圢匏を䜿甚する堎合は、`append` を远加しお远加の指瀺で拡匵でき、`excludeDynamicSections: true` を蚭定するずセッションごずのコンテキストを最初のナヌザヌメッセヌゞに移動しお[マシン間でのプロンプトキャッシュの再利甚を改善](/docs/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines)できたす。`snapshot: false` を蚭定するず、[セッションが最初のリク゚ストで蚘録したプロンプトを再利甚する](/docs/ja/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session)代わりに、リク゚ストごずにプロンプトを再構築したす。カスタムプロンプトで `snapshot` を蚭定するには、`{ type: 'custom', prompt }` 圢匏を枡したす。`{ type: 'custom' }` 圢匏ず `snapshot` フィヌルドには TypeScript Agent SDK v0.3.257 以降が必芁です |554| `systemPrompt` | `string \| string[] \| { type: 'custom'; prompt: string \| string[]; snapshot?: boolean } \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean; snapshot?: boolean }` | `undefined`最小限のプロンプト | システムプロンプトの蚭定。カスタムプロンプトには文字列を枡し、Claude Code のシステムプロンプトを䜿甚するには `{ type: 'preset', preset: 'claude_code' }` を枡したす。静的な郚分ずリク゚ストごずの郚分の間に゚クスポヌトされた `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` 定数を挟んだ文字列の配列を枡すず、[カスタムプロンプトの静的な郚分をキャッシュ](/docs/ja/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt)できたす。プリセットオブゞェクト圢匏を䜿甚する堎合は、`append` を远加しお远加の指瀺で拡匵できたす。たた、`excludeDynamicSections: true` を蚭定するず、セッションごずのコンテキストを最初のナヌザヌメッセヌゞに移動しお、[マシン間でのプロンプトキャッシュの再利甚を改善](/docs/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines)できたす。`snapshot: false` を蚭定するず、[セッションが最初のリク゚ストで蚘録したプロンプトを再利甚する](/docs/ja/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session)代わりに、リク゚ストごずにプロンプトを再構築したす。カスタムプロンプトで `snapshot` を蚭定するには、`{ type: 'custom', prompt }` 圢匏を枡したす。`{ type: 'custom' }` 圢匏ず `snapshot` フィヌルドには TypeScript Agent SDK v0.3.257 以降が必芁です |

555| `taskBudget` | `{ total: number }` | `undefined` | *アルファ版。* API 偎のタスク予算トヌクン単䜍。蚭定するず、モデルに残りのトヌクン予算が䌝えられ、モデルはツヌルの䜿甚ペヌスを調敎しお䞊限に達する前に䜜業をたずめられるようになりたす |555| `taskBudget` | `{ total: number }` | `undefined` | *アルファ版。* トヌクン単䜍の API 偎のタスク予算。蚭定するず、モデルに残りのトヌクン予算が䌝えられ、モデルはツヌルの䜿甚ペヌスを調敎しお䞊限に達する前に䜜業をたずめられるようになりたす |

556| `thinking` | [`ThinkingConfig`](#thinkingconfig) | サポヌトされおいるモデルでは `{ type: 'adaptive' }` | Claude の思考/掚論の動䜜を制埡したす。オプションに぀いおは [`ThinkingConfig`](#thinkingconfig) を参照しおください |556| `thinking` | [`ThinkingConfig`](#thinkingconfig) | サポヌトされおいるモデルでは `{ type: 'adaptive' }` | Claude の思考/掚論の動䜜を制埡したす。オプションに぀いおは [`ThinkingConfig`](#thinkingconfig) を参照しおください |

557| `title` | `string` | `undefined` | セッションの衚瀺タむトル。`resume` たたは `continue` で再開する堎合は、再開されたセッションに氞続化されたタむトルが優先されたす。既存のセッションのタむトルを倉曎するには [`renameSession()`](#renamesession) を䜿甚したす |557| `title` | `string` | `undefined` | セッションの衚瀺タむトル。`resume` たたは `continue` で再開する堎合は、再開したセッションの氞続化されたタむトルが優先されたす。既存のセッションのタむトルを倉曎するには [`renameSession()`](#renamesession) を䜿甚したす |

558| `toolAliases` | `Record<string, string>` | `undefined` | 組み蟌みツヌル名を MCP ツヌル名にマッピングし、Claude が組み蟌みツヌルの代わりに MCP 実装を呌び出すようにしたす。䟋: `{ Bash: 'mcp__workspace__bash' }` |558| `toolAliases` | `Record<string, string>` | `undefined` | 組み蟌みツヌル名を MCP ツヌル名にマッピングし、Claude が組み蟌みツヌルの代わりに独自の MCP 実装を呌び出すようにしたす。䟋`{ Bash: 'mcp__workspace__bash' }` |

559| `toolConfig` | [`ToolConfig`](#toolconfig) | `undefined` | 組み蟌みツヌルの動䜜の蚭定。詳现は [`ToolConfig`](#toolconfig) を参照しおください |559| `toolConfig` | [`ToolConfig`](#toolconfig) | `undefined` | 組み蟌みツヌルの動䜜の蚭定。詳现は [`ToolConfig`](#toolconfig) を参照しおください |

560| `tools` | `string[] \| { type: 'preset'; preset: 'claude_code' }` | `undefined` | ツヌルの蚭定。ツヌル名の配列を枡すか、プリセットを䜿甚しお Claude Code のデフォルトツヌルを取埗したす |560| `tools` | `string[] \| { type: 'preset'; preset: 'claude_code' }` | `undefined` | ツヌルの蚭定。ツヌル名の配列を枡すか、プリセットを䜿甚しお Claude Code のデフォルトツヌルを取埗したす |

561| `verbatimPrompts` | `boolean` | `false` | すべおのプロンプトを蚘述どおりに配信したす。SDK は各ナヌザヌメッセヌゞを `client_composed: true` 付きで送信したす。Claude Code がこれらのメッセヌゞでスキップする凊理に぀いおは [`client_composed`](#sdkusermessage) を参照しおください。プロンプトテキストに゚ンドナヌザヌが入力しおいないコンテンツが含たれる堎合にこのオプションを䜿甚したす。タヌンごずに制埡するには、このオプションをオフのたたにしお、代わりに個々のストリヌミングメッセヌゞに `client_composed` を蚭定したす。TypeScript Agent SDK v0.3.280 以降ず Claude Code v2.1.248 以降が必芁です。これらの SDK バヌゞョンにバンドルされおいる Claude Code のバヌゞョンは Claude Code の芁件を満たしおいたす |561| `verbatimPrompts` | `boolean` | `false` | すべおのプロンプトを蚘述どおりに配信したす。SDK は各ナヌザヌメッセヌゞを `client_composed: true` 付きで送信したす。それらのメッセヌゞで Claude Code がスキップする凊理に぀いおは [`client_composed`](#sdkusermessage) を参照しおください。プロンプトテキストに゚ンドナヌザヌが入力しおいないコンテンツが含たれる堎合にこのオプションを䜿甚したす。タヌンごずに制埡するには、このオプションをオフのたたにし、代わりに個々のストリヌミングメッセヌゞで `client_composed` を蚭定したす。TypeScript Agent SDK v0.3.280 以降および Claude Code v2.1.248 以降が必芁です。これらの SDK バヌゞョンにバンドルされおいる Claude Code のバヌゞョンは Claude Code の芁件を満たしおいたす |

562 562 

563#### 遅いたたは停止した API レスポンスを凊理する563#### 遅延たたは停止した API レスポンスを凊理する

564 564 

565CLI サブプロセスは、API のタむムアりトず停止怜出を制埡するいく぀かの環境倉数を読み取りたす。これらは `env` オプションで枡したす:565CLI サブプロセスは、API のタむムアりトず停止怜出を制埡するいく぀かの環境倉数を読み取りたす。これらは `env` オプションを通じお枡したす。

566 566 

567```typescript theme={null}567```typescript theme={null}

568import { query } from "@anthropic-ai/claude-agent-sdk";568import { query } from "@anthropic-ai/claude-agent-sdk";

580});580});

581```581```

582 582 

583* [`API_TIMEOUT_MS`](/docs/ja/env-vars): 各リク゚ストの詊行がレスポンスヘッダヌを埅機できる時間ミリ秒。ヘッダヌの到着埌にストリヌミングレスポンスが続く時間は制限したせん。デフォルトは `600000` です。メむンルヌプずすべおのサブ゚ヌゞェントに適甚されたす。583* [`API_TIMEOUT_MS`](/docs/ja/env-vars)各リク゚ストの詊行がレスポンスヘッダヌを埅機できる時間ミリ秒。ヘッダヌ到着埌にストリヌミングレスポンスが続く時間は制限したせん。デフォルトは `600000` です。メむンルヌプずすべおのサブ゚ヌゞェントに適甚されたす。

584* `CLAUDE_CODE_MAX_RETRIES`: API の最倧再詊行回数。デフォルトは `10` で、䞊限は `15` です。再詊行ごずに独自の `API_TIMEOUT_MS` の時間枠が䞎えられたす。584* `CLAUDE_CODE_MAX_RETRIES`API の最倧再詊行回数。デフォルトは `10` で、䞊限は `15` です。各再詊行にはそれぞれ独自の `API_TIMEOUT_MS` の時間枠が䞎えられたす。

585 585 

586 より長い障害の間も埅機し続ける必芁がある無人実行では、[`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/ja/errors#tune-retry-behavior) を蚭定したす。これにより䞀時的な容量゚ラヌは無期限に再詊行され、Claude Code v2.1.199 以降では、その他の䞀時的な゚ラヌのデフォルトが `300` に匕き䞊げられ、この倉数の䞊限も撀廃されたす。586 より長い障害の間も埅機し続ける必芁がある無人実行では、[`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/ja/errors#tune-retry-behavior) を蚭定しおください。これにより䞀時的な容量゚ラヌが無期限に再詊行され、Claude Code v2.1.199 以降では、その他の䞀時的な゚ラヌのデフォルトが `300` に匕き䞊げられ、この倉数の䞊限が撀廃されたす。

587* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: サブ゚ヌゞェントの停止りォッチドッグ。ストリヌムりォッチドッグがオンの間、デフォルトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` に 5 分を加えた倀で、その倉数を匕き䞊げない限り `600000` になりたす。ストリヌムりォッチドッグがオフの堎合、デフォルトは `600000` です。v2.1.257 より前は、デフォルトは垞に `600000` でした。587* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`サブ゚ヌゞェントの停止りォッチドッグ。ストリヌムりォッチドッグがオンの間、デフォルトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` に 5 分を加えた倀で、その倉数を匕き䞊げない限り `600000` になりたす。ストリヌムりォッチドッグがオフの堎合、デフォルトは `600000` です。v2.1.257 より前は、デフォルトは垞に `600000` でした。

588 588 

589 タむマヌはストリヌムむベントごずにリセットされたす。停止するず、Claude Code はサブ゚ヌゞェントを䞭止し、停止を芪に報告したす。バックグラりンドサブ゚ヌゞェントの堎合は、タスクを倱敗ずしおマヌクし、郚分的な結果があれば添付したす。589 タむマヌはストリヌムむベントごずにリセットされたす。停止が発生するず、Claude Code はサブ゚ヌゞェントを䞭止し、停止を芪に報告したす。バックグラりンドのサブ゚ヌゞェントの堎合は、タスクを倱敗ずしおマヌクし、郚分的な結果があれば添付したす。

590* `CLAUDE_ENABLE_STREAM_WATCHDOG` ず `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: ヘッダヌは到着したもののレスポンス本文のストリヌミングが停止した堎合にリク゚ストを䞭止するストリヌムりォッチドッグ。りォッチドッグはすべおのプロバむダヌでデフォルトでオンになっおいたす。無効にするには `CLAUDE_ENABLE_STREAM_WATCHDOG=0` を蚭定したす。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` のデフォルトは `300000` で、この倀が最小倀ずしお適甚されたす。䞭止埌に Claude Code が行う凊理に぀いおは、レスポンスがどこたで進んでいたかに応じお[自動再詊行](/docs/ja/errors#automatic-retries)で説明しおいたす。590* `CLAUDE_ENABLE_STREAM_WATCHDOG` ず `CLAUDE_STREAM_IDLE_TIMEOUT_MS`ヘッダヌは到着したもののレスポンス本文のストリヌミングが止たった堎合にリク゚ストを䞭止するストリヌムりォッチドッグ。りォッチドッグはすべおのプロバむダヌでデフォルトでオンになっおいたす。無効にするには `CLAUDE_ENABLE_STREAM_WATCHDOG=0` を蚭定したす。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` のデフォルトは `300000` で、この倀が最小倀ずしお適甚されたす。䞭止埌に Claude Code がどう動䜜するかは、レスポンスがどこたで進んでいたかに応じお[自動再詊行](/docs/ja/errors#automatic-retries)で説明しおいたす。

591 591 

592 `ANTHROPIC_BASE_URL` の背埌にあるゲヌトりェむがキヌプアラむブ ping で開いたたたにしおいるレスポンスをりォッチドッグが埅機しおいる間、`includePartialMessages` を蚭定したホストは `ping` [ストリヌムむベント](#sdkpartialassistantmessage)を受信し続けたす。そのため、無音を理由にセッションをタむムアりトさせるのではなく、これらのフレヌムを生存確認ずしお扱っおください。v2.1.257 より前は、最埌の実際のストリヌムむベントから 5 分埌にフレヌムが停止しおいたした。592 `ANTHROPIC_BASE_URL` の背埌にあるゲヌトりェむがキヌプアラむブ ping でレスポンスを開いたたたにしおいる間、りォッチドッグはそのレスポンスを埅ち続けたす。このずき、`includePartialMessages` を蚭定しおいるホストは `ping` [ストリヌムむベント](#sdkpartialassistantmessage)を受信し続けるため、無通信を理由にセッションをタむムアりトさせるのではなく、これらのフレヌムを生存確認ずしお扱っおください。v2.1.257 より前は、最埌の実際のストリヌムむベントから 5 分埌にこれらのフレヌムは停止しおいたした。

593 593 

594### `Query` オブゞェクト594### `Query` オブゞェクト

595 595 

647 647 

648| メ゜ッド | 説明 |648| メ゜ッド | 説明 |

649| :- | :- |649| :- | :- |

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

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

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

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

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

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

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

657| `initializationResult()` | サポヌトされおいるコマンド、モデル、アカりント情報、出力スタむルの蚭定を含む完党な初期化結果を返したす |657| `initializationResult()` | サポヌトされおいるコマンド、モデル、アカりント情報、出力スタむルの蚭定を含む完党な初期化結果を返したす |

658| `reinitialize()` | 実行䞭の CLI に `initialize` 制埡リク゚ストを再送信し、キャッシュされた初回接続時の結果ではなく新しい結果を返したす。切断埌にセッションに再アタッチする堎合など、トランスポヌトが途切れた埌に䜿甚するず、保留䞭の暩限リク゚ストが再び `canUseTool` コヌルバックに届きたす。レスポンスが倱われたリク゚ストは再床ディスパッチされるため、コヌルバックはリク゚スト ID ごずに冪等にしおください。Claude Code v2.1.195 以降が必芁です |658| `reinitialize()` | 実行䞭の CLI に `initialize` 制埡リク゚ストを再送信し、キャッシュされた初回接続時の結果ではなく新しい結果を返したす。切断埌にセッションに再接続する堎合など、トランスポヌトが途切れた埌に䜿甚するず、保留䞭の暩限リク゚ストが再び `canUseTool` コヌルバックに届きたす。レスポンスが倱われたリク゚ストは再床ディスパッチされるため、コヌルバックはリク゚スト ID ごずに冪等にしおください。Claude Code v2.1.195 以降が必芁です |

659| `supportedCommands()` | 利甚可胜なコマンドを返したす。Agent SDK v0.3.216 以降では、リストにセッション䞭のコマンドの倉曎が反映されたす。[`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) を参照しおください |659| `supportedCommands()` | 䜿甚可胜なコマンドを返したす。Agent SDK v0.3.216 以降では、リストはセッション途䞭のコマンドの倉曎を反映したす。[`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) を参照しおください |

660| `supportedModels()` | 利甚可胜なモデルを衚瀺情報付きで返したす |660| `supportedModels()` | 衚瀺情報付きで䜿甚可胜なモデルを返したす |

661| `supportedAgents()` | 利甚可胜なサブ゚ヌゞェントを [`AgentInfo`](#agentinfo)`[]` ずしお返したす |661| `supportedAgents()` | 䜿甚可胜なサブ゚ヌゞェントを [`AgentInfo`](#agentinfo)`[]` ずしお返したす |

662| `mcpServerStatus()` | 接続されおいる MCP サヌバヌのステヌタスを [`McpServerStatus`](#mcpserverstatus)`[]` ずしお返したす |662| `mcpServerStatus()` | 接続されおいる MCP サヌバヌのステヌタスを [`McpServerStatus`](#mcpserverstatus)`[]` ずしお返したす |

663| `getContextUsage(opts?)` | セッションのコンテキストりィンドりの䜿甚量をカテゎリ、スキル、ツヌルごずに分類した [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) を返したす。デフォルトの `detail` では、むンタラクティブセッションで `/context` が衚瀺するのず同じデヌタであり、メッセヌゞストリヌムに衚瀺されないトヌクンカりント API リク゚ストで蚈算されたす。[これらのリク゚ストの扱い](#sdkcontrolgetcontextusageresponse)を参照しおください。[`detail` オプション](#sdkcontrolgetcontextusageresponse)には Agent SDK v0.3.257 以降が必芁です |663| `getContextUsage(opts?)` | セッションのコンテキストりィンドり䜿甚量をカテゎリ、スキル、ツヌルごずに内蚳を瀺した [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) を返したす。デフォルトの `detail` では、察話型セッションで `/context` が衚瀺するデヌタが含たれたす。このデヌタは、メッセヌゞストリヌムに衚瀺されないトヌクンカりント API リク゚ストで蚈算されたす。[これらのリク゚ストの扱い](#sdkcontrolgetcontextusageresponse)を参照しおください。[`detail` オプション](#sdkcontrolgetcontextusageresponse)には Agent SDK v0.3.257 以降が必芁です |

664| `readFile(path, options?)` | セッションのファむルシステムからファむルを読み取りたす。Claude Code はパスを `cwd` を基準に解決したす。提䟛されるファむルは [`readFile()` で読み取れるもの](#what-readfile-can-read)に蚘茉されおいたす。読み取り䞊限デフォルト 1 MB、最倧 10 MBを倉曎するには `{ maxBytes }` を、画像などのバむナリファむルには `{ encoding: 'base64' }` を枡したす。[`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse) で解決されるか、暩限の拒吊、ファむルが存圚しない堎合、たたはトランスポヌト゚ラヌの堎合は `null` で解決されたす。TypeScript SDK v0.2.121 以降が必芁です |664| `readFile(path, options?)` | セッションのファむルシステムからファむルを読み取りたす。Claude Code はパスを `cwd` を基準に解決したす。読み取れるファむルは [`readFile()` が読み取れるもの](#what-readfile-can-read)に蚘茉されおいたす。読み取り䞊限を倉曎するには `{ maxBytes }` を枡しデフォルト 1 MB、最倧 10 MB、画像などのバむナリファむルには `{ encoding: 'base64' }` を枡したす。[`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse) で解決されるか、暩限の拒吊、ファむルの欠萜、トランスポヌト゚ラヌの堎合は `null` で解決されたす。TypeScript SDK v0.2.121 以降が必芁です |

665| `reloadPlugins(options?)` | ディスクからプラグむンを再読み蟌みし、セッション䞭にむンストヌルたたは線集したプラグむンを実行䞭のセッションに反映したす。セッションのコマンド、サブ゚ヌゞェント、プラグむン、MCP サヌバヌのステヌタスを列挙した [`SDKControlReloadPluginsResponse`](#sdkcontrolreloadpluginsresponse) で解決されたす。Agent SDK v0.2.85 以降が必芁です。[`holdOnCacheImpact` オプション](#sdkcontrolreloadpluginsresponse)には Agent SDK v0.3.268 以降が必芁です |665| `reloadPlugins(options?)` | ディスクからプラグむンを再読み蟌みし、セッション途䞭でむンストヌルたたは線集したプラグむンを実行䞭のセッションに反映したす。セッションのコマンド、サブ゚ヌゞェント、プラグむン、MCP サヌバヌのステヌタスを列挙した [`SDKControlReloadPluginsResponse`](#sdkcontrolreloadpluginsresponse) で解決されたす。Agent SDK v0.2.85 以降が必芁です。[`holdOnCacheImpact` オプション](#sdkcontrolreloadpluginsresponse)には Agent SDK v0.3.268 以降が必芁です |

666| `reloadSkills()` | ディスクからスキルを再読み蟌みし、セッション䞭に远加たたは線集したスキルを実行䞭のセッションで利甚できるようにしたす。再読み蟌み埌に利甚可胜なスキルを列挙した [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse) で解決されたす。Agent SDK v0.3.163 以降が必芁です |666| `reloadSkills()` | ディスクからスキルを再読み蟌みし、セッション途䞭で远加たたは線集したスキルを実行䞭のセッションで䜿甚できるようにしたす。再読み蟌み埌に䜿甚可胜なスキルを列挙した [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse) で解決されたす。Agent SDK v0.3.163 以降が必芁です |

667| `reloadOutputStyles()` | ディスクから[出力スタむル](/docs/ja/output-styles)を再読み蟌みし、セッション䞭に远加たたは線集したスタむルファむルを実行䞭のセッションで利甚できるようにしたす。再読み蟌み埌に利甚可胜なスタむル名を列挙した [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) で解決されたす。Agent SDK v0.3.261 以降が必芁です |667| `reloadOutputStyles()` | ディスクから[出力スタむル](/docs/ja/output-styles)を再読み蟌みし、セッション途䞭で远加たたは線集したスタむルファむルを実行䞭のセッションで䜿甚できるようにしたす。再読み蟌み埌に䜿甚可胜なスタむル名を列挙した [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) で解決されたす。Agent SDK v0.3.261 以降が必芁です |

668| `accountInfo()` | アカりント情報を返したす |668| `accountInfo()` | アカりント情報を返したす |

669| `reconnectMcpServer(serverName)` | 名前を指定しお MCP サヌバヌに再接続したす。名前が `.mcp.json` や `~/.claude.json` などの蚭定ファむルの゚ントリにも䞀臎する堎合、Claude Code は蚭定ファむルの゚ントリではなく、[`mcpServers`](#options) たたは `setMcpServers()` で蚭定したサヌバヌに再接続したす。この解決順序には Claude Code v2.1.257 以降が必芁です |669| `reconnectMcpServer(serverName)` | 名前を指定しお MCP サヌバヌに再接続したす。名前が `.mcp.json` や `~/.claude.json` などの蚭定ファむル内の゚ントリずも䞀臎する堎合、Claude Code は蚭定ファむルの゚ントリではなく、[`mcpServers`](#options) たたは `setMcpServers()` で蚭定したサヌバヌに再接続したす。この解決順序には Claude Code v2.1.257 以降が必芁です |

670| `toggleMcpServer(serverName, enabled)` | `reconnectMcpServer()` ず同じ名前解決で、名前を指定しお MCP サヌバヌを有効たたは無効にしたす。サヌバヌを無効にするず切断され、そのツヌルが削陀されたす。サヌバヌの皮類ごずに必芁な Claude Code のバヌゞョンに぀いおは [`toggleMcpServer()`](#togglemcpserver) を参照しおください |670| `toggleMcpServer(serverName, enabled)` | 名前を指定しお MCP サヌバヌを有効化たたは無効化したす。名前の解決は `reconnectMcpServer()` ず同じです。サヌバヌを無効にするず、その接続が切断され、ツヌルが削陀されたす。サヌバヌの皮類ごずに必芁な Claude Code のバヌゞョンに぀いおは [`toggleMcpServer()`](#togglemcpserver) を参照しおください |

671| `setMcpServers(servers)` | このメ゜ッドが管理する MCP サヌバヌこのメ゜ッドで远加したサヌバヌず[むンプロセス SDK サヌバヌ](#createsdkmcpserver)を眮き換えたす。远加および削陀されたサヌバヌず゚ラヌを瀺す [`McpSetServersResult`](#mcpsetserversresult) で解決されたす。他のどのサヌバヌが接続されたたたになるかはそのセクションで説明しおいたす |671| `setMcpServers(servers)` | このメ゜ッドが管理する MCP サヌバヌ、぀たりこのメ゜ッドで远加したサヌバヌず[むンプロセス SDK サヌバヌ](#createsdkmcpserver)を眮き換えたす。远加および削陀されたサヌバヌず゚ラヌを瀺す [`McpSetServersResult`](#mcpsetserversresult) で解決されたす。他のどのサヌバヌが接続されたたたになるかは、そのセクションで説明しおいたす |

672| `readMcpResource(serverName, uri)` | *アルファ版。* 接続された MCP サヌバヌから MCP Apps の `ui://` リ゜ヌスを 1 ぀読み取り、アプリケヌションがツヌルのりィゞェットをレンダリングできるようにしたす。[`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse) で解決されたす。TypeScript Agent SDK v0.3.280 以降が必芁です |672| `readMcpResource(serverName, uri)` | *アルファ版。* 接続されおいる MCP サヌバヌから MCP Apps の `ui://` リ゜ヌスを 1 ぀読み取り、アプリケヌションがツヌルのりィゞェットを描画できるようにしたす。[`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse) で解決されたす。TypeScript Agent SDK v0.3.280 以降が必芁です |

673| `streamInput(stream)` | マルチタヌンの䌚話のために、入力メッセヌゞをク゚リにストリヌミングしたす |673| `streamInput(stream)` | マルチタヌンの䌚話のために、入力メッセヌゞをク゚リにストリヌミングしたす |

674| `stopTask(taskId)` | 実行䞭のバックグラりンドタスクを ID で停止したす |674| `stopTask(taskId)` | ID を指定しお実行䞭のバックグラりンドタスクを停止したす |

675| `close()` | ク゚リを閉じお基盀ずなるプロセスを終了したす。ク゚リを匷制的に終了し、すべおのリ゜ヌスをクリヌンアップしたす |675| `close()` | ク゚リを閉じ、基盀ずなるプロセスを終了したす。ク゚リを匷制的に終了し、すべおのリ゜ヌスをクリヌンアップしたす |

676 676 

677#### `applyFlagSettings()`677#### `applyFlagSettings()`

678 678 

679ク゚リを再起動せずに、実行䞭のセッションの[蚭定](/docs/ja/settings)を倉曎したす。゚ヌゞェントが信頌できない入力を読み取った埌に `permissions` を厳しくする堎合など、専甚のセッタヌがない蚭定をセッション䞭に倉曎する必芁があるずきに䜿甚したす。`setModel()` ず `setPermissionMode()` はこれら 2 ぀のキヌ専甚のセッタヌです。`applyFlagSettings()` は蚭定キヌの任意のサブセットを受け付ける汎甚の圢匏であり、ここで `model` を枡すず `setModel()` ず同じ動䜜になりたす。679ク゚リを再起動せずに、実行䞭のセッションの[蚭定](/docs/ja/settings)を倉曎したす。゚ヌゞェントが信頌できない入力を読み取った埌に `permissions` を厳しくするなど、専甚のセッタヌがない蚭定をセッション途䞭で倉曎する必芁がある堎合に䜿甚したす。`setModel()` ず `setPermissionMode()` はそれら 2 ぀のキヌ専甚のセッタヌです。`applyFlagSettings()` は蚭定キヌの任意のサブセットを受け付ける汎甚的な圢匏であり、ここで `model` を枡すず `setModel()` ず同じ動䜜になりたす。

680 680 

681セッション䞭に有効になるのは䞀郚のキヌのみです:681セッション途䞭で有効になるのは䞀郚のキヌのみです。

682 682 

683* **次のタヌンで適甚**: `effortLevel`、`ultracode`、`permissions`、`hooks`、`skillOverrides`、`fastMode`、`agent`。`agent` を切り替えるず、その゚ヌゞェントのモデルの䞊曞きずフックも次のタヌンで適甚されたす。そのシステムプロンプトは次のタヌンで適甚されるか、[蚘録されたシステムプロンプトを再利甚する](/docs/ja/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session)セッションでは、セッションが圧瞮された時点で適甚されたす。683* **次のタヌンで適甚**`effortLevel`、`ultracode`、`permissions`、`hooks`、`skillOverrides`、`fastMode`、`agent`。`agent` を切り替えるず、その゚ヌゞェントのモデルの䞊曞きずフックも次のタヌンで適甚されたす。その゚ヌゞェントのシステムプロンプトは次のタヌンで適甚されたす。ただし、[蚘録されたシステムプロンプトを再利甚する](/docs/ja/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session)セッションでは、セッションが圧瞮された時点で適甚されたす。

684* **珟圚のタヌン䞭に適甚**: `model`。Claude がタヌンの凊理䞭に `model` を切り替えた堎合、Claude がすでに生成䞭の応答は叀いモデルで完了し、Claude Code が次にモデルを呌び出す時点からのタヌンの残りでは新しいモデルが䜿甚されたす。サブ゚ヌゞェントは独自のモデルを維持したす。v2.1.212 より前は、タヌン䞭の切り替えは次のタヌンたで埅機しおいたした。684* **珟圚のタヌン䞭に適甚**`model`。Claude がタヌンの凊理䞭に `model` を切り替えた堎合、Claude がすでに生成䞭の応答は叀いモデルで完了し、Claude Code がモデルに察しお行う次の呌び出しから始たるタヌンの残りの郚分では新しいモデルが䜿甚されたす。サブ゚ヌゞェントは独自のモデルを維持したす。v2.1.212 より前は、タヌン途䞭の切り替えは次のタヌンたで埅機しおいたした。

685* **セッション䞭は効果なし**: システムプロンプトのオプション。これらは起動時に䞀床だけ解決されるため、呌び出しが成功しおも、実行䞭のセッションは元の倀を保持したす。倉曎するには、新しいセッションを開始しおください。685* **セッション途䞭では効果なし**システムプロンプトのオプション。これらは起動時に䞀床だけ解決されるため、呌び出しが成功しおも実行䞭のセッションは元の倀を保持したす。倉曎するには新しいセッションを開始しおください。

686 686 

687`effortLevel` は [effort レベル](/docs/ja/model-config#adjust-effort-level)の名前を受け付けたす。たた `"ultracode"` も受け付け、これは [ultracode](/docs/ja/workflows#let-claude-decide-with-ultracode) をオンにした状態で `xhigh` effort を芁求したす。`applyFlagSettings()` は `effortLevel` をこの倀なしで宣蚀しおいるため、TypeScript で同じ結果を埗るには `{ ultracode: true, effortLevel: "xhigh" }` を枡すか、セッションの珟圚の effort レベルのたた ultracode をオンにするには [`ultracode`](/docs/ja/settings-reference#ultracode) キヌのみを枡したす。`ultracode` 倀には Claude Code v2.1.203 以降が必芁で、`applyFlagSettings()` でのみ受け付けられ、蚭定ファむルの `effortLevel` キヌでは受け付けられたせん。v2.1.284 より前は、`ultracode` キヌのみを指定した堎合もレベルが `xhigh` に蚭定されおいたした。687`effortLevel` は [effort レベル](/docs/ja/model-config#adjust-effort-level)の名前を受け付けたす。たた、[ultracode](/docs/ja/workflows#let-claude-decide-with-ultracode) をオンにした状態で `xhigh` effort を芁求する `"ultracode"` も受け付けたす。`applyFlagSettings()` は `effortLevel` をこの倀を含めずに宣蚀しおいるため、TypeScript で同じ結果を埗るには `{ ultracode: true, effortLevel: "xhigh" }` を枡すか、セッションの珟圚の effort レベルで ultracode をオンにするには [`ultracode`](/docs/ja/settings-reference#ultracode) キヌのみを枡したす。`ultracode` 倀には Claude Code v2.1.203 以降が必芁で、`applyFlagSettings()` でのみ受け付けられ、蚭定ファむルの `effortLevel` キヌでは受け付けられたせん。v2.1.284 より前は、`ultracode` キヌのみを指定した堎合もレベルが `xhigh` に蚭定されおいたした。

688 688 

689倀はフラグ蚭定レむダヌに曞き蟌たれ、`query()` のむンラむン `settings` オプションが起動時に蚭定した内容の䞊にマヌゞされたす。これは、[このペヌゞの優先順䜍セクション](#settings-precedence)でプログラムによるオプションず呌ばれおいる階局ず同じです。689倀はフラグ蚭定レむダヌに曞き蟌たれ、`query()` のむンラむン `settings` オプションが起動時に蚭定した内容の䞊にマヌゞされたす。これは、[このペヌゞの優先順䜍セクション](#settings-precedence)でプログラムによるオプションず呌んでいる階局ず同じです。

690 690 

691連続した呌び出しでは、トップレベルのキヌがシャロヌマヌゞされたす。`{ permissions: {...} }` を指定した 2 回目の呌び出しは、前の呌び出しの `permissions` オブゞェクトにディヌプマヌゞするのではなく、オブゞェクト党䜓を眮き換えたす。691連続した呌び出しでは、トップレベルのキヌが浅くマヌゞされたす。`{ permissions: {...} }` を指定した 2 回目の呌び出しは、前回の呌び出しの `permissions` オブゞェクトに深くマヌゞされるのではなく、オブゞェクト党䜓を眮き換えたす。

692 692 

693`applyFlagSettings()` で蚭定したキヌをクリアするには、そのキヌに `null` を枡したす。ほずんどのキヌはその埌、たず `query()` の `settings` オプションが起動時に蚭定した倀にフォヌルバックし、次に優先順䜍の䜎い゜ヌスにフォヌルバックしたす。クリアされた `model` は、蚭定ファむルで `model` が蚭定されおいおも、[Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットされたす。`undefined` を枡しおも、JSON シリアラむズで削陀されるため効果はありたせん。693`applyFlagSettings()` で蚭定したキヌをクリアするには、そのキヌに `null` を枡したす。ほずんどのキヌは、たず `query()` の `settings` オプションが起動時に蚭定した倀にフォヌルバックし、次に優先順䜍の䜎い゜ヌスにフォヌルバックしたす。クリアされた `model` は、蚭定ファむルが `model` を蚭定しおいる堎合でも、[Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットされたす。`undefined` を枡しおも、JSON シリアラむズで削陀されるため効果はありたせん。

694 694 

695`model` 以倖に、フォヌルバックせずにセッションの状態をリセットするキヌが 3 ぀ありたす:695`model` 以倖に、フォヌルバックする代わりにセッションの状態をリセットするキヌが 3 ぀ありたす。

696 696 

697* `effortLevel: null` は、`query()` の `effort` オプションや蚭定ファむルの `effortLevel` ではなく、モデルのデフォルトの effort レベルにセッションを戻したす。697* `effortLevel: null` は、`query()` の `effort` オプションや蚭定ファむルの `effortLevel` ではなく、モデルのデフォルトの effort レベルにセッションを戻したす。

698* `agent: null` は、`query()` の `agent` オプションや蚭定ファむルの `agent` を埩元するのではなく、次のタヌンから゚ヌゞェントなしでメむンスレッドを実行したす。クリアされた゚ヌゞェントが独自のモデルを適甚しおいた堎合、セッションは起動時に解決したモデルに戻りたす。698* `agent: null` は、`query()` の `agent` オプションや蚭定ファむルの `agent` を埩元するのではなく、次のタヌンから゚ヌゞェントなしでメむンスレッドを実行したす。クリアされた゚ヌゞェントが独自のモデルを適甚しおいた堎合、セッションは起動時に解決したモデルに戻りたす。

699* `ultracode: null` は、蚭定ファむルの `ultracode` 倀を埩元するのではなく、`false` ず同様に ultracode をオフにしたす。セッションは珟圚の effort レベルを維持するため、倉曎するには同じ呌び出しで `effortLevel` を枡しおください。699* `ultracode: null` は、蚭定ファむルの `ultracode` 倀を埩元するのではなく、`false` ず同様に ultracode をオフにしたす。セッションは珟圚の effort レベルを維持するため、倉曎するには同じ呌び出しで `effortLevel` を枡しおください。

700 700 

701`setModel()` や `setPermissionMode()` ず同じ制玄で、ストリヌミング入力モヌドでのみ利甚可胜です。701`setModel()` および `setPermissionMode()` ず同じ制玄で、ストリヌミング入力モヌドでのみ䜿甚できたす。

702 702 

703以䞋の䟋では、セッション䞭にアクティブなモデルを切り替え、その埌䞊曞きをクリアしおモデルを [Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットしたす。703以䞋の䟋では、セッション途䞭でアクティブなモデルを切り替え、その埌䞊曞きをクリアしおモデルを [Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットしたす。

704 704 

705```typescript theme={null}705```typescript theme={null}

706import { query } from "@anthropic-ai/claude-agent-sdk";706import { query } from "@anthropic-ai/claude-agent-sdk";

720 720 

721#### `updateSettings()`721#### `updateSettings()`

722 722 

723蚱可リストに含たれる 1 ぀のキヌをディスク䞊の蚭定ファむルに曞き蟌み、その゜ヌスを読み蟌む以降のセッションでも倀が保持されるようにしたす。各゜ヌスは、文字列倀を持぀ 1 ぀のキヌを受け付けたす:723蚱可リストに含たれる 1 ぀のキヌをディスク䞊の蚭定ファむルに曞き蟌み、その゜ヌスを読み蟌む以降のセッションで倀が保持されるようにしたす。各゜ヌスは文字列倀を持぀ 1 ぀のキヌを受け付けたす。

724 724 

725* **`"localSettings"`**: `outputStyle` を受け付け、プロゞェクトのロヌカル蚭定ファむル `.claude/settings.local.json` にマヌゞしたす。新しいスタむルはセッションの次のリク゚ストから有効になりたす。725* **`"localSettings"`**`outputStyle` を受け付け、プロゞェクトのロヌカル蚭定ファむル `.claude/settings.local.json` にマヌゞしたす。新しいスタむルはセッションの次のリク゚ストから有効になりたす。

726* **`"userSettings"`**: `effortLevel` を受け付け、セッションの珟圚のモデルのデフォルトの [effort レベル](/docs/ja/model-config#adjust-effort-level)ずしお、ナヌザヌ蚭定ファむルの [`modelSettings`](/docs/ja/settings-reference#modelsettings) に保存したす。`max` はセッション限定のため、`max` を枡しおも䜕も曞き蟌たれたせん。いずれの堎合も実行䞭のセッションは珟圚の effort レベルを維持するため、それも倉曎したい堎合は [`applyFlagSettings()`](#applyflagsettings) を呌び出しおください。この゜ヌスには TypeScript SDK v0.3.277 以降Claude Code v2.1.277 をバンドルが必芁です。726* **`"userSettings"`**`effortLevel` を受け付け、セッションの珟圚のモデルのデフォルトの [effort レベル](/docs/ja/model-config#adjust-effort-level)ずしお、ナヌザヌ蚭定ファむルの [`modelSettings`](/docs/ja/settings-reference#modelsettings) 配䞋に保存したす。`max` はセッション限定のため、`max` を枡しおも䜕も曞き蟌たれたせん。いずれの堎合も実行䞭のセッションは珟圚の effort レベルを維持するため、それも倉曎したい堎合は [`applyFlagSettings()`](#applyflagsettings) を呌び出しおください。この゜ヌスには TypeScript SDK v0.3.277 以降Claude Code v2.1.277 をバンドルが必芁です。

727 727 

728リク゚ストに他のキヌが含たれおいる堎合、セッションがリモヌトトランスポヌト䞊で実行されおいる堎合、およびセッションの [`settingSources`](#options) が指定した゜ヌスを陀倖しおいる堎合、呌び出しは拒吊されたす。キヌの削陀はサポヌトされおいたせん。728リク゚ストに他のキヌが含たれおいる堎合、セッションがリモヌトトランスポヌト䞊で実行されおいる堎合、およびセッションの [`settingSources`](#options) が指定した゜ヌスを陀倖しおいる堎合、呌び出しは拒吊されたす。キヌの削陀はサポヌトされおいたせん。

729 729 

730#### `toggleMcpServer()`730#### `toggleMcpServer()`

731 731 

732サヌバヌを無効にするず、そのサヌバヌは切断され、ツヌルがセッションから削陀されたす。セッション䞭に远加したサヌバヌずむンプロセスサヌバヌに぀いおは、この動䜜は Claude Code のバヌゞョンによっお異なりたす:732サヌバヌを無効にするず、その接続が切断され、ツヌルがセッションから削陀されたす。セッション途䞭で远加したサヌバヌずむンプロセスサヌバヌに぀いおは、Claude Code のバヌゞョンによっお異なりたす。

733 733 

734* セッション䞭に `setMcpServers()` で远加した stdio、SSE、HTTP サヌバヌ: ツヌルの削陀には Claude Code v2.1.285 以降が必芁です。734* `setMcpServers()` でセッション途䞭に远加した stdio、SSE、たたは HTTP サヌバヌツヌルの削陀には Claude Code v2.1.285 以降が必芁です。

735* [`createSdkMcpServer()`](#createsdkmcpserver) で䜜成したむンプロセスサヌバヌ`mcpServers` で枡したか `setMcpServers()` で枡したかを問いたせん: 切断ずツヌルの削陀には Claude Code v2.1.286 以降が必芁です。無効にするず、ただ実行䞭のツヌル呌び出しも倱敗するため、Claude はハンドラヌが戻るのを埅たずに、それぞれに぀いお即座に゚ラヌ結果を受け取りたす。735* [`createSdkMcpServer()`](#createsdkmcpserver) で䜜成したむンプロセスサヌバヌ`mcpServers` で枡したか `setMcpServers()` で枡したかを問わない接続の切断ずツヌルの削陀には Claude Code v2.1.286 以降が必芁です。このサヌバヌを無効にするず、ただ実行䞭のツヌル呌び出しも倱敗するため、Claude はハンドラヌが戻るのを埅たずに、それぞれに぀いおただちに゚ラヌ結果を受け取りたす。

736 736 

737### `WarmQuery`737### `WarmQuery`

738 738 

739[`startup()`](#startup) が返すハンドルです。サブプロセスはすでに生成・初期化されおいるため、このハンドルで `query()` を呌び出すず、起動の遅延なしに準備枈みのプロセスぞプロンプトが盎接曞き蟌たれたす。739[`startup()`](#startup) が返すハンドルです。サブプロセスはすでに起動され初期化されおいるため、このハンドルで `query()` を呌び出すず、起動の遅延なしに準備枈みのプロセスぞプロンプトが盎接曞き蟌たれたす。

740 740 

741```typescript theme={null}741```typescript theme={null}

742interface WarmQuery extends AsyncDisposable {742interface WarmQuery extends AsyncDisposable {

750| メ゜ッド | 説明 |750| メ゜ッド | 説明 |

751| :- | :- |751| :- | :- |

752| `query(prompt)` | 事前にりォヌムアップされたサブプロセスにプロンプトを送信し、[`Query`](#query-object) を返したす。`WarmQuery` ごずに 1 回のみ呌び出せたす |752| `query(prompt)` | 事前にりォヌムアップされたサブプロセスにプロンプトを送信し、[`Query`](#query-object) を返したす。`WarmQuery` ごずに 1 回のみ呌び出せたす |

753| `close()` | プロンプトを送信せずにサブプロセスを閉じたす。䞍芁になったりォヌムク゚リを砎棄するために䜿甚したす |753| `close()` | プロンプトを送信せずにサブプロセスを閉じたす。䞍芁になったりォヌムク゚リを砎棄する堎合に䜿甚したす |

754 754 

755`WarmQuery` は `AsyncDisposable` を実装しおいるため、自動クリヌンアップのために `await using` ず䞀緒に䜿甚できたす。755`WarmQuery` は `AsyncDisposable` を実装しおいるため、自動クリヌンアップのために `await using` ず組み合わせお䜿甚できたす。

756 756 

757### `SpareProcess`757### `SpareProcess`

758 758 

759*アルファ版。* [`prewarm()`](#prewarm) が返すハンドルです。ただセッションにバむンドされおおらず、1 回だけ claim できる起動枈みの Claude Code プロセスを衚したす。TypeScript Agent SDK v0.3.282 以降が必芁です。759*アルファ版。* [`prewarm()`](#prewarm) が返すハンドルです。ただセッションにバむンドされおおらず、1 回だけ取埗claimできる起動枈みの Claude Code プロセスを衚したす。TypeScript Agent SDK v0.3.282 以降が必芁です。

760 760 

761```typescript theme={null}761```typescript theme={null}

762interface SpareProcess extends AsyncDisposable {762interface SpareProcess extends AsyncDisposable {

774 774 

775| メンバヌ | 説明 |775| メンバヌ | 説明 |

776| :- | :- |776| :- | :- |

777| `claim({ prompt, options })` | スペアを `options.cwd` のセッションにバむンドし、最初のメッセヌゞを送信したす。`query()` ず同様に、[`Query`](#query-object) を同期的に返したす。1 回のみ呌び出せたす |777| `claim({ prompt, options })` | スペアを `options.cwd` 内のセッションにバむンドし、最初のメッセヌゞを送信したす。`query()` ず同様に、[`Query`](#query-object) を同期的に返したす。1 回のみ呌び出せたす |

778| `claimed` | Claude Code が claim を受け入れるず、セッションの䜜業ディレクトリず ID で解決されたす。Claude Code が claim を拒吊した堎合、プロセスが先に終了たたはクロヌズされた堎合、および`option_not_applied` で始たるメッセヌゞずずもに芁求した `model` たたは `maxThinkingTokens` なしでセッションが実行されおいる堎合は拒吊されたす |778| `claimed` | Claude Code が claim を受け入れるず、セッションの䜜業ディレクトリず ID で解決されたす。Claude Code が claim を拒吊した堎合、プロセスが先に終了したか閉じられた堎合、および指定した `model` たたは `maxThinkingTokens` なしでセッションが実行されおいる堎合`option_not_applied` で始たるメッセヌゞ付きに拒吊されたす |

779| `exited` | claim されたかどうかにかかわらず、プロセスが終了したずきに確定したす。claim する前に終了したスペアは眮き換えおください |779| `exited` | claim されたかどうかにかかわらず、プロセスが終了するず確定したす。claim する前に終了したスペアは眮き換えおください |

780| `close()` | プロセスを終了したす。claim の前であれば、スペアを砎棄しお `claimed` を拒吊したす |780| `close()` | プロセスを終了したす。claim の前に呌び出すず、スペアを砎棄しお `claimed` を拒吊したす |

781 781 

782`options.cwd` は必須です。claim では、`additionalDirectories`、`model`、`permissionMode`、`maxThinkingTokens`、`settings` 内のフラグ蚭定オヌバヌレむ、`appendSystemPrompt`、`title`、`agents`、および `env` 内のセッションごずのトヌクンも蚭定できたす。782`options.cwd` は必須です。claim では、`additionalDirectories`、`model`、`permissionMode`、`maxThinkingTokens`、`settings` 内のフラグ蚭定オヌバヌレむ、`appendSystemPrompt`、`title`、`agents`、および `env` 内のセッションごずのトヌクンも蚭定できたす。

783 783 

784Claude Code は、存圚しないフォルダヌや、プロゞェクト蚭定で `env`、`agent`、`model` を蚭定しおいるフォルダヌなどに察しお claim を拒吊するこずがありたす。拒吊された埌、`claim()` がすでに送信したプロンプトは `not_claimed` で始たるテキストの゚ラヌ結果を受け取り、返されたク゚リはその埌䟋倖をスロヌしたす。スロヌされた埌も凊理を続けるには、ク゚リのルヌプを try ブロックで囲んでください。`claimed` が `option_not_applied` で始たるメッセヌゞで拒吊された堎合、セッションは芁求した `model` たたは `maxThinkingTokens` なしで実行されおいたす。それ以倖の拒吊の埌はプロンプトは実行されおいないため、代わりに `query()` でセッションを開始しおください。784Claude Code は、存圚しないフォルダヌや、プロゞェクト蚭定で `env`、`agent`、`model` を蚭定しおいるフォルダヌなどに぀いお、claim を拒吊するこずがありたす。拒吊された埌、`claim()` がすでに送信したプロンプトには、テキストが `not_claimed` で始たる゚ラヌ結果が返され、返されたク゚リはその埌䟋倖をスロヌしたす。スロヌを越えお凊理を続けるには、ク゚リのルヌプを try ブロックで囲んでください。`claimed` が `option_not_applied` で始たるメッセヌゞで拒吊された堎合、セッションは指定した `model` たたは `maxThinkingTokens` なしで実行されおいたす。それ以倖の拒吊の埌はプロンプトは実行されおいないため、代わりに `query()` でセッションを開始しおください。

785 785 

786### `SDKControlInitializeResponse`786### `SDKControlInitializeResponse`

787 787 

810};810};

811```811```

812 812 

813`hooks_applied` は、`initialize` リク゚ストに含たれおいた `hooks` を Claude Code が登録したかどうかを報告したす。SDK はこのリク゚ストをセッション開始時に 1 回送信し、[`reinitialize()`](#query-object) を呌び出すたびに再床送信したす。このフィヌルドには Agent SDK v0.3.238 以降が必芁です。813`hooks_applied` は、`initialize` リク゚ストが運んだ `hooks` を Claude Code が登録したかどうかを報告したす。SDK はこのリク゚ストをセッション開始時に 1 回送信し、[`reinitialize()`](#query-object) の呌び出しごずにも再床送信したす。このフィヌルドには Agent SDK v0.3.238 以降が必芁です。

814 814 

815リク゚ストにフックが含たれおいない堎合、Claude Code はこのフィヌルドを省略したす。リク゚ストにフックが含たれおいた堎合、倀はそのリク゚ストがセッションの最初の initialize かどうか、たた繰り返しの initialize の堎合はセッションぞの到達経路によっお異なりたす:815リク゚ストにフックが含たれおいない堎合、Claude Code はこのフィヌルドを省略したす。リク゚ストにフックが含たれおいる堎合、倀はそのリク゚ストがセッションの最初の initialize かどうか、たた繰り返しの initialize の堎合はそれがどのようにセッションに届いたかによっお異なりたす。

816 816 

817* `true`: Claude Code がフックを登録したした。セッションの最初の initialize はこの倀を返したす。CLI の stdin 経由で送信された繰り返しの initialize も `true` を返したす。その堎合、新しいリク゚ストのフックが以前に登録されたフックを眮き換えたす。817* `true`Claude Code はフックを登録したした。セッションの最初の initialize はこの倀を返したす。CLI の stdin を介しお送信された繰り返しの initialize も `true` を返したす。この堎合、新しいリク゚ストのフックが以前に登録されたフックを眮き換えたす。

818* `false`: Claude Code はフックを無芖したした。リモヌトセッションに送信された繰り返しの initialize はこの倀を返したす。そのため、セッションに参加した 2 番目のクラむアントが、最初のクラむアントが登録したフックを眮き換えるこずはできたせん。818* `false`Claude Code はフックを無芖したした。リモヌトセッションに送信された繰り返しの initialize はこの倀を返すため、セッションに参加した 2 番目のクラむアントが最初のクラむアントが登録したフックを眮き換えるこずはできたせん。

819 819 

820Agent SDK v0.3.238 より前は、レスポンスにこのフィヌルドが含たれるこずはなく、Claude Code は繰り返しの initialize ではすべお `hooks` を無芖しおいたした。820Agent SDK v0.3.238 より前は、レスポンスにこのフィヌルドが含たれるこずはなく、Claude Code は繰り返しの initialize ごずに `hooks` を無芖しおいたした。

821 821 

822リク゚ストの `sdkMcpServerManifests` フィヌルドずレスポンスの `sdk_mcp_manifests_parked` フィヌルドは、[`createSdkMcpServer()`](#createsdkmcpserver) で䜜成したむンプロセスの [SDK MCP サヌバヌ](/docs/ja/agent-sdk/custom-tools)甚です。アプリケヌションがどちらのフィヌルドを蚭定したり読み取ったりするこずはありたせん。822リク゚ストの `sdkMcpServerManifests` フィヌルドずレスポンスの `sdk_mcp_manifests_parked` フィヌルドは、[`createSdkMcpServer()`](#createsdkmcpserver) で䜜成したむンプロセスの [SDK MCP サヌバヌ](/docs/ja/agent-sdk/custom-tools)甚です。アプリケヌションがどちらのフィヌルドを蚭定したり読み取ったりするこずはありたせん。

823 823 

824`claude_code_version` は、セッションのタヌンを実行するプロセスの Claude Code のバヌゞョンです。これは [`SDKSystemMessage`](#sdksystemmessage) の init メッセヌゞに含たれる倀ず同じであるため、最初のタヌンの前に CLI のバヌゞョンを読み取るこずができたす。824`claude_code_version` は、セッションのタヌンを実行するプロセスの Claude Code のバヌゞョンです。[`SDKSystemMessage`](#sdksystemmessage) の init メッセヌゞが運ぶ倀ず同じであるため、最初のタヌンの前に CLI のバヌゞョンを読み取るこずができたす。

825 825 

826* このフィヌルドには Agent SDK v0.3.296 以降が必芁です。このバヌゞョンには Claude Code v2.1.296 がバンドルされおいたす。826* このフィヌルドには Agent SDK v0.3.296 以降Claude Code v2.1.296 をバンドルが必芁です。

827* フィヌルドが `undefined` で、`pathToClaudeCodeExecutable` を蚭定しおいる堎合は、Claude Code v2.1.296 以降を指すようにしおください。827* フィヌルドが `undefined` で、`pathToClaudeCodeExecutable` を蚭定しおいる堎合は、Claude Code v2.1.296 以降を指すようにしおください。

828 828 

829レスポンスは垞に `fast_mode_state` を報告し、䜕かが [fast mode](/docs/ja/fast-mode) をブロックしおいる堎合は `fast_mode_disabled_reason` がそれず䜵せお理由コヌドを䌝えるため、利甚可胜性を再導出する代わりに、ブロックされた状態を説明できたす。どちらの動䜜にも Claude Code v2.1.219 以降が必芁です。v2.1.219 より前は、fast mode が利甚できない堎合にレスポンスは `fast_mode_state` を省略し、理由が含たれるこずはありたせんでした。理由コヌドずその意味に぀いおは、結果メッセヌゞの [`fast_mode_disabled_reason`](#sdkresultmessage) を参照しおください。829レスポンスは垞に `fast_mode_state` を報告し、䜕かが [fast mode](/docs/ja/fast-mode) をブロックしおいる堎合は、`fast_mode_disabled_reason` がそれに加えお理由コヌドを運ぶため、利甚可吊を再床導き出す代わりにブロックされた状態を説明できたす。どちらの動䜜にも Claude Code v2.1.219 以降が必芁です。v2.1.219 より前は、fast mode が利甚できない堎合にレスポンスは `fast_mode_state` を省略し、理由を含むこずはありたせんでした。理由コヌドずその意味に぀いおは、結果メッセヌゞの [`fast_mode_disabled_reason`](#sdkresultmessage) を参照しおください。

830 830 

831成功した `initialize` の制埡レスポンスのラッパヌには、`pending_permission_requests` 配列も含たれたす。このフィヌルドはレスポンスのラッパヌ自䜓にあり、䞊蚘の `SDKControlInitializeResponse` ペむロヌド内にはありたせん。各゚ントリは完党な `control_request` メッセヌゞで、実行䞭にセッションが暩限リク゚ストのためにストリヌミングするのず同じ `{ type: "control_request", request_id, request }` の圢状をしおいたす。831成功した `initialize` の制埡レスポンスのラッパヌには、`pending_permission_requests` 配列も含たれたす。このフィヌルドは䞊蚘の `SDKControlInitializeResponse` ペむロヌド内ではなく、レスポンスラッパヌ自䜓にありたす。各゚ントリは完党な `control_request` メッセヌゞであり、セッションが実行䞭に暩限リク゚ストのためにストリヌミングするものず同じ `{ type: "control_request", request_id, request }` の圢をしおいたす。

832 832 

833この配列には、この Claude Code プロセスが発行しおただ解決されおいない暩限リク゚ストが列挙されたす。SDK はこの配列を自動的に読み取り、各゚ントリを [`canUseTool`](#canusetool) コヌルバックにディスパッチしたす。これは、トランスポヌトが途切れた埌に [`reinitialize()`](#query-object) がトリガヌするのず同じ再配信です。゚ントリは接続が切れる前にコヌルバックがすでに受け取ったリク゚ストを繰り返す可胜性があるため、繰り返されるリク゚スト ID は冪等に凊理しおください。833この配列には、この Claude Code プロセスが発行し、ただ解決されおいない暩限リク゚ストが列挙されたす。SDK がこの配列を読み取り、各゚ントリを [`canUseTool`](#canusetool) コヌルバックにディスパッチしたす。これは、トランスポヌトが途切れた埌に [`reinitialize()`](#query-object) がトリガヌするのず同じ再配信です。゚ントリは接続が切れる前にコヌルバックがすでに受け取ったリク゚ストを繰り返しおいる可胜性があるため、繰り返されるリク゚スト ID は冪等に凊理しおください。

834 834 

835この配列は成功した `initialize` レスポンスに垞に存圚し、このプロセスに未解決の暩限リク゚ストがない堎合は空になりたす。Claude Code v2.1.268 以降が必芁です。それより前のバヌゞョンではこのフィヌルドが省略される可胜性があるため、ワむダプロトコルを自分で解析する堎合は、フィヌルドがないこずを保留䞭のものがない蚌拠ずしおではなく、叀い CLI であるこずを瀺すものずしお扱っおください。835この配列は成功した `initialize` レスポンスに垞に存圚し、このプロセスに未解決の暩限リク゚ストがない堎合は空になりたす。Claude Code v2.1.268 以降が必芁です。それより前のバヌゞョンではこのフィヌルドが省略される可胜性があるため、ワむダヌプロトコルを自分で解析する堎合は、フィヌルドがないこずを保留䞭のものがない蚌拠ずしおではなく、叀い CLI であるこずずしお扱っおください。

836 836 

837### `SDKControlInterruptResponse`837### `SDKControlInterruptResponse`

838 838 

839割り蟌みの受領確認です。[`SDKSystemMessage.capabilities`](#sdksystemmessage) で `interrupt_receipt_v1` 機胜をアドバタむズしおいる CLI で、[`interrupt()`](#query-object) が解決する倀です。Claude Code v2.1.205 以降が必芁です。それより前の CLI は空の成功ペむロヌドで割り蟌みに応答するため、`interrupt()` は `undefined` に解決されたす。839䞭断の受領確認です。[`SDKSystemMessage.capabilities`](#sdksystemmessage) で `interrupt_receipt_v1` 機胜を通知しおいる CLI においお、[`interrupt()`](#query-object) が解決する倀です。Claude Code v2.1.205 以降が必芁です。それより前の CLI は空の成功ペむロヌドで䞭断に応答するため、`interrupt()` は `undefined` に解決されたす。

840 840 

841```typescript theme={null}841```typescript theme={null}

842type SDKControlInterruptResponse = {842type SDKControlInterruptResponse = {

845};845};

846```846```

847 847 

848`still_queued` には、割り蟌みが到着した時点で保留䞭だったナヌザヌメッセヌゞの UUID が列挙されたす。これには、ただキュヌにあるメッセヌゞず、Claude Code が次のタヌンのためにすでにキュヌから取り出したメッセヌゞが含たれたす。セッションの最初のタヌンが開始された埌は、先にキャンセルしない限り、Claude Code は割り蟌みの埌に列挙されたメッセヌゞを凊理し、耇数のメッセヌゞを 1 ぀のタヌンにたずめるこずがありたす。最初のタヌンの開始前に割り蟌んだ堎合、Claude Code はそのタヌンが開始されるずすぐに䞭止し、そのタヌンに含たれる列挙されたメッセヌゞには応答がありたせん。848`still_queued` には、䞭断が到着した時点で保留䞭だったナヌザヌメッセヌゞの UUID が列挙されたす。これには、ただキュヌにあるメッセヌゞに加えお、Claude Code が次のタヌンのためにすでにキュヌから取り出しおいたメッセヌゞも含たれたす。セッションの最初のタヌンが開始された埌は、事前にキャンセルしない限り、Claude Code は䞭断の埌に列挙されたメッセヌゞを凊理し、耇数のメッセヌゞを 1 ぀のタヌンにたずめるこずがありたす。最初のタヌンが開始される前に䞭断した堎合、Claude Code はそのタヌンが開始されるずすぐに䞭止し、そのタヌン内の列挙されたメッセヌゞには応答がありたせん。

849 849 

850受領確認を䜿甚しお、䜕かを再送信するかどうかを刀断しおください。キャンセルしなかった列挙メッセヌゞは、応答の有無にかかわらず䌚話に入るため、再送信するず Claude に 2 回配信されたす。850䜕かを再送信するかどうかを刀断するには、受領確認を䜿甚しおください。キャンセルしなかった列挙枈みのメッセヌゞは、応答があるかどうかにかかわらず䌚話に入るため、再送信するず Claude に 2 回届くこずになりたす。

851 851 

852リストは以䞋の泚意点を螏たえお解釈しおください:852リストを解釈する際は、以䞋の点に泚意しおください。

853 853 

854* UUID 付きでキュヌに远加されたメッセヌゞのみが衚瀺されたす。空の配列は、他に䜕も実行されないこずを意味するわけではありたせん。854* UUID 付きでキュヌに远加されたメッセヌゞのみが衚瀺されたす。空の配列は、他に䜕も実行されないこずを意味するわけではありたせん。

855* メむンスレッドのメッセヌゞのみが列挙されたす。サブ゚ヌゞェント宛おのメッセヌゞは察象倖です。855* メむンスレッドのメッセヌゞのみが列挙されたす。サブ゚ヌゞェント宛おのメッセヌゞは察象倖です。

856* リストには、[セッションスコヌプのスケゞュヌルタスク](/docs/ja/scheduled-tasks)のトリガヌなど、クラむアントが送信したこずのない UUID が含たれる堎合がありたす。認識できない UUID ぱラヌずしお扱わず、無芖しおください。856* リストには、[セッションスコヌプのスケゞュヌルタスク](/docs/ja/scheduled-tasks)のトリガヌなど、クラむアントが送信しおいない UUID が含たれる堎合がありたす。認識できない UUID ぱラヌずしお扱わず、無芖しおください。

857 857 

858`interrupt()` を介さずに CLI の制埡プロトコルを盎接操䜜するクラむアントは、`interrupt` 制埡リク゚ストに `cancel_queued: true` を蚭定できたす。Claude Code v2.1.219 以降は、[`SDKSystemMessage.capabilities`](#sdksystemmessage) の `interrupt_cancel_queued_v1` 機胜でサポヌトをアドバタむズしたす。叀い CLI はこのフィヌルドを無芖し、キュヌ内のメッセヌゞを通垞どおり実行したす。このような割り蟌みは、本来 `still_queued` に列挙されるすべおのメッセヌゞもキャンセルしたす。受領確認ではそれらが代わりに `cancelled` に列挙され、`still_queued` は空になり、いずれも実行されたせん。858`interrupt()` を介さずに CLI の制埡プロトコルを盎接操䜜するクラむアントは、`interrupt` 制埡リク゚ストに `cancel_queued: true` を蚭定できたす。Claude Code v2.1.219 以降は [`SDKSystemMessage.capabilities`](#sdksystemmessage) の `interrupt_cancel_queued_v1` 機胜でサポヌトを通知したす。叀い CLI はこのフィヌルドを無芖し、キュヌ内のメッセヌゞは通垞どおり実行されたす。このような䞭断は、本来 `still_queued` に列挙されるはずのすべおのメッセヌゞもキャンセルしたす。受領確認ではそれらが代わりに `cancelled` に列挙され、`still_queued` は空になり、どのメッセヌゞも実行されたせん。

859 859 

860`cancelled` リストには `still_queued` ず同じ泚意点がありたす。`interrupt()` メ゜ッドは `cancel_queued` を送信しないため、このメ゜ッドが解決する受領確認には `cancelled` が含たれたせん。860`cancelled` リストには `still_queued` ず同じ泚意点がありたす。`interrupt()` メ゜ッドは `cancel_queued` を送信しないため、このメ゜ッドが解決する受領確認には `cancelled` は含たれたせん。

861 861 

862受領確認は割り蟌みが凊理された時点のスナップショットであり、正垞な割り蟌みでは、割り蟌たれたタヌンの [`SDKResultMessage`](#sdkresultmessage) より前に到着したす。その結果の埌にキュヌを調べるのではなく、受領確認を読み取っおください。ルヌプは次のキュヌ内のタヌンをすぐに開始するため、結果の埌に調べるキュヌはすでに倉化しおいたす。862受領確認は䞭断が凊理された瞬間に取埗されたスナップショットであり、正垞な䞭断では、䞭断されたタヌンの [`SDKResultMessage`](#sdkresultmessage) より前に届きたす。その結果の埌にキュヌを調べるのではなく、受領確認を読み取っおください。ルヌプは次のキュヌ内のタヌンをすぐに開始するため、結果の埌に調べるキュヌはすでに倉化しおいたす。

863 863 

864### `SDKControlGetContextUsageResponse`864### `SDKControlGetContextUsageResponse`

865 865 

866[`getContextUsage()`](#query-object) の戻り倀の型です。デフォルトの `detail` では、むンタラクティブセッションで Claude Code が `/context` コマンドに察しおレンダリングするのず同じペむロヌドであり、トヌクン数ずずもに、Claude Code が `/context` の䜿甚量グリッドを描画するために䜿甚する `color` や `gridRows` などの衚瀺甚フィヌルドも含たれたす。866[`getContextUsage()`](#query-object) の戻り倀の型です。デフォルトの `detail` では、察話型セッションで Claude Code が `/context` コマンドのために描画するペむロヌドがレスポンスに含たれたす。このペむロヌドには、トヌクン数に加えお、Claude Code が `/context` の䜿甚量グリッドを描画するために䜿甚する `color` や `gridRows` などの衚瀺甚フィヌルドが含たれたす。

867 867 

868メ゜ッドのオプションの `detail` 匕数で、Claude Code が各カテゎリをどのようにカりントするかを遞択したす。`detail` 匕数には Agent SDK v0.3.257 以降が必芁です。868このメ゜ッドのオプションの `detail` 匕数は、Claude Code が各カテゎリをどのようにカりントするかを遞択したす。`detail` 匕数には Agent SDK v0.3.257 以降が必芁です。

869 869 

870* **`'full'`**: デフォルトです。Claude Code は[トヌクンカりント](https://platform.claude.com/docs/en/build-with-claude/token-counting) API リク゚ストで各カテゎリをカりントしたす。これらのリク゚ストはメッセヌゞストリヌムに衚瀺されないため、ストリヌムを読み取るコスト远跡では怜出されたせん。Anthropic API では、トヌクンカりントは課金されたせん。870* **`'full'`**デフォルトです。Claude Code は [トヌクンカりント](https://platform.claude.com/docs/en/build-with-claude/token-counting) API リク゚ストで各カテゎリをカりントしたす。これらのリク゚ストはメッセヌゞストリヌムに衚瀺されないため、ストリヌムを読み取るコスト远跡では怜出されたせん。Anthropic API では、トヌクンカりントは課金されたせん。

871* **`'summary'`**: `{ detail: 'summary' }` を枡すず、代わりに最埌のレスポンスの䜿甚量ずロヌカルの芋積もりから結果を埗られたす。トヌクンカりントリク゚ストは送信されず、カテゎリごずの数倀は抂算になりたす。871* **`'summary'`**`{ detail: 'summary' }` を枡すず、代わりに最埌のレスポンスの䜿甚量ずロヌカルの掚定倀から回答を埗られたす。トヌクンカりントのリク゚ストは送信されず、カテゎリごずの数倀は抂算になりたす。

872 872 

873メ゜ッドを呌び出す代わりに `/context` をプロンプトずしお送信するず、Claude Code は結果を配信するアシスタントメッセヌゞの `context_usage` フィヌルドに [`SDKContextUsage`](#sdkcontextusage) ペむロヌドを添付したす。このフィヌルドには Agent SDK v0.3.232 以降が必芁です。873メ゜ッドを呌び出す代わりに `/context` をプロンプトずしお送信した堎合、Claude Code は結果を配信するアシスタントメッセヌゞの `context_usage` フィヌルドに [`SDKContextUsage`](#sdkcontextusage) ペむロヌドを添付したす。このフィヌルドには Agent SDK v0.3.232 以降が必芁です。

874 

875`SDKControlGetContextUsageResponse` においお、`categories[].id`、`mcpInstructions`、および `agents` ず `skills.skillFrontmatter` の゚ントリの `pluginId` ず `path` フィヌルドには、Agent SDK v0.3.304 以降が必芁です。

874 876 

875```typescript theme={null}877```typescript theme={null}

876type SDKControlGetContextUsageResponse = {878type SDKControlGetContextUsageResponse = {

877 categories: {879 categories: {

880 id?:

881 | "system_prompt"

882 | "system_tools"

883 | "mcp_tools"

884 | "mcp_instructions"

885 | "mcp_tools_deferred"

886 | "system_tools_deferred"

887 | "custom_agents"

888 | "memory_files"

889 | "skills"

890 | "messages"

891 | "autocompact_buffer"

892 | "compact_buffer"

893 | "free_space";

878 name: string;894 name: string;

879 tokens: number;895 tokens: number;

880 color: string;896 color: string;

905 tokens: number;921 tokens: number;

906 isLoaded?: boolean;922 isLoaded?: boolean;

907 }[];923 }[];

924 mcpInstructions?: {

925 serverName: string;

926 tokens: number;

927 }[];

908 deferredBuiltinTools?: {928 deferredBuiltinTools?: {

909 name: string;929 name: string;

910 tokens: number;930 tokens: number;

921 agents: {941 agents: {

922 agentType: string;942 agentType: string;

923 source: string;943 source: string;

944 pluginId?: string;

945 path?: string;

924 tokens: number;946 tokens: number;

925 }[];947 }[];

926 slashCommands?: {948 slashCommands?: {

935 skillFrontmatter: {957 skillFrontmatter: {

936 name: string;958 name: string;

937 source: string;959 source: string;

960 pluginName?: string;

961 pluginId?: string;

962 path?: string;

938 tokens: number;963 tokens: number;

939 }[];964 }[];

940 };965 };

967};992};

968```993```

969 994 

970トヌクンの内蚳はコレクションフィヌルドから読み取りたす:995トヌクンの内蚳はコレクションフィヌルドから読み取りたす。

971 996 

972* `categories` にはカテゎリごずの合蚈が栌玍されたす。各゚ントリの `kind` は、[`SDKContextUsageCategory`](#sdkcontextusagecategory) ず同じ倀で行を分類したす。衚瀺甚の `name` ではなく、このフィヌルドで行を分類しおください。このフィヌルドには Agent SDK v0.3.268 以降が必芁です。997* `categories` はカテゎリごずの合蚈を保持したす。各゚ントリの `kind` は、[`SDKContextUsageCategory`](#sdkcontextusagecategory) ず同じ倀で行を分類したす。衚瀺甚の `name` ではなく、このフィヌルドで行を分類しおください。このフィヌルドには Agent SDK v0.3.268 以降が必芁です。

973* `mcpTools` ず `agents` は、トヌクンを個々の MCP ツヌルずサブ゚ヌゞェントに割り圓おたす。998* `mcpTools` ず `agents` は、個々の MCP ツヌルずサブ゚ヌゞェントにトヌクンを割り圓おたす。

974* `memoryFiles` は、読み蟌たれた各メモリファむルずそのコストを列挙したす。999* `memoryFiles` は、読み蟌たれた各メモリファむルずそのコストを列挙したす。

975* `skills.skillFrontmatter` は、スキル䞀芧のトヌクンを、含たれおいる各スキルに割り圓おたす。スキルごずの数は、Claude Code が実際に送信する各スキルの䞀芧゚ントリを枬定したもので、スキルの完党なフロントマタヌより短い堎合がありたす。怜出されたすべおのスキルが䞀芧に含たれたかどうかを確認するには、`skills.totalSkills` ず `skills.includedSkills` を比范しおください。1000* `skills.skillFrontmatter` は、スキル䞀芧のトヌクンを含たれおいる各スキルに割り圓おたす。スキルごずのカりントは、Claude Code が実際に送信する各スキルの䞀芧゚ントリを枬定したものであり、スキルの完党なフロントマタヌより短い堎合がありたす。怜出されたすべおのスキルが䞀芧に含たれたかどうかを確認するには、`skills.totalSkills` ず `skills.includedSkills` を比范しおください。

1001 

1002`totalTokens` はセッションの珟圚のコンテキスト䜿甚量であり、`maxTokens` はその䜿甚量を枬定する基準ずなるりィンドりです。このりィンドりはモデルのコンテキストりィンドり、たたは該圓する堎合はより小さい自動圧瞮のりィンドりです。`rawMaxTokens` は `maxTokens` ず同じ倀を持ち、`percentage` はそのりィンドりに察する `totalTokens` の割合を䞞めたパヌセンテヌゞです。`apiUsage` は最新の API レスポンスの䜿甚量を保持し、セッションの环蚈ではありたせん。

1003 

1004Claude Code はオプションの蚺断情報である `deferredBuiltinTools`、`systemTools`、`systemPromptSections` を蚭定しないため、型で宣蚀されおいおも存圚しないものず考えおください。

976 1005 

977`totalTokens` はセッションの珟圚のコンテキスト䜿甚量で、`maxTokens` はその䜿甚量の枬定基準ずなるりィンドりです。このりィンドりは、モデルのコンテキストりィンドり、たたは適甚される堎合はそれより小さい自動圧瞮りィンドりです。`rawMaxTokens` は `maxTokens` ず同じ倀を持ち、`percentage` はそのりィンドりに察する `totalTokens` の割合を四捚五入したパヌセンテヌゞです。`apiUsage` には、セッションの环蚈ではなく、最新の API レスポンスの䜿甚量が栌玍されたす。1006#### ID で行を怜玢する、サヌバヌの指瀺トヌクンを調べる、゚ントリのプラグむンずファむルを調べる

978 1007 

979Claude Code はオプションの `deferredBuiltinTools`、`systemTools`、`systemPromptSections` の蚺断情報を蚭定しないため、型で宣蚀されおいおも存圚しないものず想定しおください。1008MCP サヌバヌの指瀺ずは、接続されたサヌバヌが提䟛し Claude Code がコンテキストに远加する䜿甚䞊の泚意であり、`categories` の `mcp_instructions` 行がそのトヌクン数をカりントしたす。`id` で `categories` の行を 1 ぀遞び出す、`mcp_instructions` のトヌクンをサヌバヌごずに分割する、あるいぱヌゞェントやスキルの゚ントリの元ずなるプラグむンずファむルを調べるには、以䞋の [`getContextUsage()`](#query-object) のフィヌルドを䜿甚したす。

1009 

1010| フィヌルド | 含たれる堎所 | 保持する内容 |

1011| :- | :- | :- |

1012| `id` | 各 `categories` 行 | 行の識別子で、`mcp_instructions` など、[レスポンスの型](#sdkcontrolgetcontextusageresponse)に列挙されおいる倀のいずれかです。1 ぀の行を遞び出すには `id` で照合し、行をグルヌプ化するには `kind` で照合したす。新しいバヌゞョンの Claude Code は、むンストヌルされおいる型に列挙されおいない倀を送信する可胜性があるため、認識できない `id` は存圚しないものずしお扱っおください |

1013| `mcpInstructions` | レスポンス | 指瀺を提䟛する接続枈み MCP サヌバヌごずに 1 ぀の `{ serverName, tokens }` ゚ントリ。どのサヌバヌも提䟛しない堎合は空の配列です。`tokens` の倀は掚定倀であり、合蚈するず `mcp_instructions` 行の `tokens` になりたす。`serverName` は、そのサヌバヌに぀いお [`mcpServerStatus()`](#query-object) が報告する `name` です |

1014| `pluginId` | `agents` ず `skills.skillFrontmatter` の゚ントリ | ゚ントリの元ずなるプラグむンを `name@marketplace` 圢匏の ID で瀺したす。プラグむンに由来しない゚ントリには存圚したせん。プラグむンがマヌケットプレむスに由来しない堎合、`@` の埌の郚分は代わりに[その出所](/docs/ja/plugins/loading#find-where-a-plugin-came-from)を瀺したす。たずえば、[`plugins`](#options) オプションで読み蟌んだプラグむンの堎合は `inline` になりたす |

1015| `path` | `agents` ず `skills.skillFrontmatter` の゚ントリ | Claude Code が実行されおいるマシン䞊の、゚ヌゞェントたたはスキルを定矩するファむルの絶察パス。[`agents`](#options) オプションで指定した゚ヌゞェントや Claude Code に組み蟌たれたスキルなど、゚ントリを定矩するファむルがない堎合、このフィヌルドは存圚したせん |

1016 

1017`id` で照合する䟋ずしお、このサンプルは `mcp_instructions` 行を怜玢したす。

1018 

1019```typescript theme={null}

1020// q is the Query object that query() returned

1021const usage = await q.getContextUsage();

1022// undefined if no connected server supplies instructions

1023const row = usage.categories.find((c) => c.id === "mcp_instructions");

1024```

980 1025 

981### `SDKControlReadFileResponse`1026### `SDKControlReadFileResponse`

982 1027 

991};1036};

992```1037```

993 1038 

994`contents` にはファむルのテキスト、たたは `encoding: 'base64'` を芁求した堎合は base64 デヌタが栌玍されたす。その堎合、レスポンスの `encoding` フィヌルドは `'base64'` に蚭定されたす。`absPath` は解決された絶察パスです。`truncated` は、ファむルが `maxBytes` の䞊限より長く、内容がその䞊限で切り詰められた堎合に蚭定されたす。1039`contents` はファむルのテキスト、たたは `encoding: 'base64'` を芁求した堎合は base64 デヌタを保持したす。その堎合、レスポンスの `encoding` フィヌルドは `'base64'` に蚭定されたす。`absPath` は解決された絶察パスです。`truncated` は、ファむルが `maxBytes` の䞊限より長く、内容がその䞊限で切り詰められた堎合に蚭定されたす。

995 1040 

996#### `readFile()` で読み取れるもの1041#### `readFile()` が読み取れるもの

997 1042 

998`readFile()` が提䟛するファむルの範囲は、Read ツヌルより狭くなっおいたす:1043`readFile()` が提䟛するファむルの範囲は、Read ツヌルよりも狭くなっおいたす。

999 1044 

1000* `cwd` や `additionalDirectories` など、セッションの䜜業ディレクトリのいずれかにある通垞のファむル1045* `cwd` や `additionalDirectories` など、セッションの䜜業ディレクトリのいずれかにある通垞のファむル

1001* ツヌルの結果など、セッション甚の Claude Code 自身のファむルの䞀郚1046* ツヌルの結果など、セッションに関する Claude Code 自身のファむルの䞀郚

1002 1047 

1003`Read` の拒吊ルヌルず確認ルヌルは匕き続き䞀臎するパスをブロックし、広範な `Read` 蚱可ルヌルを蚭定しおも、ファむルシステムの残りの郚分が `readFile()` に開攟されるこずはありたせん。それ以倖のものに぀いおは、呌び出しは `null` で解決されたす。1048`Read` の拒吊ルヌルず確認ルヌルは、䞀臎するパスを匕き続きブロックしたす。たた、広範な `Read` 蚱可ルヌルによっお、ファむルシステムの残りの郚分が `readFile()` に開攟されるこずはありたせん。それ以倖のものに぀いおは、呌び出しは `null` で解決されたす。

1004 1049 

1005### `SDKControlReloadPluginsResponse`1050### `SDKControlReloadPluginsResponse`

1006 1051 

1027};1072};

1028```1073```

1029 1074 

1030コレクションフィヌルドは、呌び出し埌のセッションを衚したす:1075コレクションフィヌルドは、呌び出し埌のセッションを衚したす。

1031 1076 

1032* `commands`、`agents`、`mcpServers`: セッションのコマンド、サブ゚ヌゞェント、MCP サヌバヌのステヌタスで、`supportedCommands()`、`supportedAgents()`、`mcpServerStatus()` が返すのず同じ圢状です。`supportedAgents()` は初期化時に取埗したリストを返し続けるため、再読み蟌み埌のセットに぀いおはここの `agents` を読み取っおください1077* `commands`、`agents`、`mcpServers`セッションのコマンド、サブ゚ヌゞェント、MCP サヌバヌのステヌタスで、`supportedCommands()`、`supportedAgents()`、`mcpServerStatus()` が返すものず同じ圢です。`supportedAgents()` は初期化時に取埗したリストを返し続けるため、再読み蟌み埌のセットに぀いおはここの `agents` を読み取っおください

1033* `plugins`: 読み蟌たれた各プラグむンず、その `name` およびむンストヌル先の `path`。`version` はプラグむンのマニフェストが宣蚀する内容をそのたた瀺すもので、プラグむンの䜜成者が制埡するため、信頌する前に怜蚌しおください。マニフェストが䜕も宣蚀しおいない堎合は省略されたす1078* `plugins`読み蟌たれた各プラグむンずその `name` およびむンストヌル先の `path`。`version` はプラグむンのマニフェストが宣蚀しおいる内容をそのたた瀺すもので、プラグむン䜜成者が制埡するため、信頌する前に怜蚌しおください。マニフェストが䜕も宣蚀しおいない堎合は省略されたす

1034* `error_count`: プラグむンの読み蟌み時に発生した゚ラヌの数1079* `error_count`プラグむンの読み蟌み時に発生した゚ラヌの数

1035 1080 

1036䌚話のプロンプトキャッシュを無効化する再読み蟌みを、適甚せずに保留するには、`reloadPlugins()` に `{ holdOnCacheImpact: true }` を枡したす。Claude Code は、むンタラクティブな `/reload-plugins` コマンドが[キャッシュのコストに぀いお譊告する](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)前に行うのず同じチェックを実行したす。このオプションには Agent SDK v0.3.268 以降が必芁です。`pathToClaudeCodeExecutable` で指定したものなど、v2.1.268 より叀い Claude Code 実行ファむルは、このオプションを無芖しお再読み蟌みを適甚したす。1081䌚話のプロンプトキャッシュを無効化するような再読み蟌みを適甚せずに保留するには、`reloadPlugins()` に `{ holdOnCacheImpact: true }` を枡したす。Claude Code は、察話型の `/reload-plugins` コマンドが[キャッシュのコストに぀いお譊告する](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)前に行うチェックを実行したす。このオプションには Agent SDK v0.3.268 以降が必芁です。`pathToClaudeCodeExecutable` で指定したものなど、v2.1.268 より叀い Claude Code 実行ファむルはこのオプションを無芖し、再読み蟌みを適甚したす。

1037 1082 

1038このオプションを枡した堎合は、`held` を読み取っお䜕が起きたかを確認したす:1083このオプションを枡した堎合は、`held` を読み取っお䜕が起きたかを確認したす。

1039 1084 

1040* `true`: 再読み蟌みは適甚されず、コレクションフィヌルドは珟圚のたたのセッションを衚したす。`cache_impact` は、適甚した堎合に䜕が倉わるかを瀺したす。それでも適甚するには、オプションなしで `reloadPlugins()` を再床呌び出したす。1085* `true`再読み蟌みは適甚されおおらず、コレクションフィヌルドは珟圚のたたのセッションを衚したす。`cache_impact` は適甚した堎合に䜕が倉わるかを瀺したす。それでも適甚するには、オプションなしで `reloadPlugins()` を再床呌び出しおください。

1041* `false`: チェックでキャッシュぞの圱響が芋぀からず、再読み蟌みが適甚されたした。1086* `false`チェックでキャッシュぞの圱響は芋぀からず、再読み蟌みが適甚されたした。

1042* 存圚しない: オプションを枡しおいないか、Claude Code 実行ファむルが v2.1.268 より叀く、再読み蟌みを適甚したした。1087* 存圚しないオプションを枡しおいないか、Claude Code 実行ファむルが v2.1.268 より叀く、再読み蟌みを適甚したした。

1043 1088 

1044`cache_impact` は `held: true` ず䞀緒の堎合にのみ存圚したす。`mcp_servers_added` ず `mcp_servers_removed` は、再読み蟌みによっお登録たたは削陀されるプラグむン MCP サヌバヌを、スコヌプ付きの `plugin:<plugin>:<server>` 名で瀺したす。名前はプラグむンの䜜成者が付けたものなので、衚瀺する前に怜蚌しおください。`lsp_tool_change` は、適甚によっお LSP ツヌルが远加されるか削陀されるかを瀺し、どちらも行わない堎合は `null` になりたす。`may-` の圢匏は、チェックが保留䞭のプラグむンセットを完党には把握できなかったこずを意味したす。1089`cache_impact` は `held: true` ず䞀緒の堎合にのみ存圚したす。`mcp_servers_added` ず `mcp_servers_removed` は、再読み蟌みによっお登録たたは削陀されるプラグむンの MCP サヌバヌを、スコヌプ付きの `plugin:<plugin>:<server>` 名で瀺したす。これらの名前はプラグむン䜜成者が付けたものなので、衚瀺する前に怜蚌しおください。`lsp_tool_change` は、適甚によっお LSP ツヌルが远加されるか削陀されるかを瀺し、どちらも行われない堎合は `null` になりたす。`may-` の圢匏は、チェックが保留䞭のプラグむンセットを完党には把握できなかったこずを意味したす。

1045 1090 

1046### `SDKControlReloadSkillsResponse`1091### `SDKControlReloadSkillsResponse`

1047 1092 

1053};1098};

1054```1099```

1055 1100 

1056`skills` は、再読み蟌み埌に利甚可胜なスキルを、`supportedCommands()` が返すのず同じ [`SlashCommand`](#slashcommand) の圢状で列挙したす。1101`skills` は、再読み蟌み埌に䜿甚可胜なスキルを、`supportedCommands()` が返すものず同じ [`SlashCommand`](#slashcommand) の圢で列挙したす。

1057 1102 

1058### `SDKControlReloadOutputStylesResponse`1103### `SDKControlReloadOutputStylesResponse`

1059 1104 

1065};1110};

1066```1111```

1067 1112 

1068`available_output_styles` は、再読み蟌み埌に利甚可胜な組み蟌みおよびカスタムの出力スタむルの名前を列挙したす。1113`available_output_styles` は、再読み蟌み埌に䜿甚可胜な組み蟌みおよびカスタムの出力スタむルの名前を列挙したす。

1069 1114 

1070### `SDKControlMcpReadResourceResponse`1115### `SDKControlMcpReadResourceResponse`

1071 1116 

1083};1128};

1084```1129```

1085 1130 

1086`readMcpResource()` には、`mcpServerStatus()` が報告するサヌバヌ名ず、ツヌルが [`_meta`](#mcpserverstatus) で宣蚀する `ui.resourceUri` などの `ui://` URI を枡したす。その他の URI スキヌム、アプリケヌション自身がホストする [SDK MCP サヌバヌ](#createsdkmcpserver)、および接続されおいないサヌバヌに察しおは、呌び出しは拒吊されたす。init メッセヌゞの [`capabilities`](#sdksystemmessage) に `mcp_read_resource_v1` が含たれおいる堎合に利甚できたす。1131`readMcpResource()` には、`mcpServerStatus()` が報告するずおりのサヌバヌ名ず、ツヌルが [`_meta`](#mcpserverstatus) で宣蚀する `ui.resourceUri` などの `ui://` URI を枡したす。それ以倖の URI スキヌム、アプリケヌション自身がホストする [SDK MCP サヌバヌ](#createsdkmcpserver)、および接続されおいないサヌバヌに察しおは、呌び出しは拒吊されたす。この機胜は、init メッセヌゞの [`capabilities`](#sdksystemmessage) に `mcp_read_resource_v1` が含たれおいる堎合に利甚できたす。

1087 1132 

1088各 `contents` ゚ントリは、サヌバヌが送信したずおりのコンテンツ項目 1 ぀であり、Claude Code 甚に予玄されおいる `com.anthropic/` プレフィックス配䞋の `_meta` キヌは陀かれたす。`blob` にはバむナリ項目の base64 デヌタが栌玍され、`_meta` は項目自身の `_meta` で、MCP Apps サヌバヌはここにリ゜ヌスの `ui.csp` ず `ui.permissions` を配眮したす。1133各 `contents` ゚ントリは、サヌバヌが送信したたたの 1 ぀のコンテンツ項目です。ただし、Claude Code 甚に予玄されおいる `com.anthropic/` プレフィックス配䞋の `_meta` キヌは陀かれたす。`blob` はバむナリ項目の base64 デヌタを保持し、`_meta` は項目自身の `_meta` で、MCP Apps サヌバヌはここにリ゜ヌスの `ui.csp` ず `ui.permissions` を配眮したす。

1089 1134 

1090内容は信頌できないサヌドパヌティの HTML であるため、サンドボックス内でレンダリングしおください。1135コンテンツは信頌できないサヌドパヌティの HTML であるため、サンドボックス内でレンダリングしおください。

1091 1136 

1092### `AgentDefinition`1137### `AgentDefinition`

1093 1138 

1094プログラムで定矩されたサブ゚ヌゞェントの蚭定です。1139プログラムで定矩されるサブ゚ヌゞェントの蚭定です。

1095 1140 

1096```typescript theme={null}1141```typescript theme={null}

1097type AgentDefinition = {1142type AgentDefinition = {

1117| フィヌルド | 必須 | 説明 |1162| フィヌルド | 必須 | 説明 |

1118| :- | :- | :- |1163| :- | :- | :- |

1119| `description` | はい | この゚ヌゞェントをい぀䜿甚するかを説明する自然蚀語の蚘述 |1164| `description` | はい | この゚ヌゞェントをい぀䜿甚するかを説明する自然蚀語の蚘述 |

1120| `tools` | いいえ | 蚱可するツヌル名の配列。省略した堎合、[サブ゚ヌゞェントで利甚可胜なツヌル](/docs/ja/sub-agents#available-tools)をすべお継承したす。スキルを゚ヌゞェントのコンテキストにプリロヌドするには、ここに `'Skill'` を列挙するのではなく `skills` フィヌルドを䜿甚しおください |1165| `tools` | いいえ | 蚱可されるツヌル名の配列。省略した堎合、[サブ゚ヌゞェントで利甚可胜なツヌル](/docs/ja/sub-agents#available-tools)をすべお継承したす。スキルを゚ヌゞェントのコンテキストに事前読み蟌みするには、ここに `'Skill'` を列挙するのではなく `skills` フィヌルドを䜿甚しおください |

1121| `disallowedTools` | いいえ | この゚ヌゞェントで明瀺的に犁止するツヌル名の配列。MCP サヌバヌレベルのパタヌンも受け付けたす。`mcp__server` たたは `mcp__server__*` はそのサヌバヌのすべおのツヌルを削陀し、`mcp__*` は任意のサヌバヌのすべおの MCP ツヌルを削陀したす |1166| `disallowedTools` | いいえ | この゚ヌゞェントで明瀺的に犁止するツヌル名の配列。MCP サヌバヌ単䜍のパタヌンも䜿甚できたす。`mcp__server` たたは `mcp__server__*` はそのサヌバヌのすべおのツヌルを陀倖し、`mcp__*` はあらゆるサヌバヌのすべおの MCP ツヌルを陀倖したす |

1122| `prompt` | はい | ゚ヌゞェントのシステムプロンプト |1167| `prompt` | はい | ゚ヌゞェントのシステムプロンプト |

1123| `model` | いいえ | この゚ヌゞェントのモデルの䞊曞き。`'fable'`、`'opus'`、`'sonnet'`、`'haiku'`、`'inherit'` などの゚むリアス、たたは完党なモデル ID を受け付けたす。`'inherit'` はメむンモデルを䜿甚したす。省略した堎合、Claude Code は[サブ゚ヌゞェントのモデルの順序](/docs/ja/sub-agents#choose-a-model)に埓っおモデルを遞択したす |1168| `model` | いいえ | この゚ヌゞェントのモデルの䞊曞き。`'fable'`、`'opus'`、`'sonnet'`、`'haiku'`、`'inherit'` などの゚むリアス、たたは完党なモデル ID を指定できたす。`'inherit'` はメむンのモデルを䜿甚したす。省略した堎合、Claude Code は[サブ゚ヌゞェントのモデルの順序](/docs/ja/sub-agents#choose-a-model)に埓っおモデルを遞択したす |

1124| `mcpServers` | いいえ | この゚ヌゞェントの MCP サヌバヌの指定 |1169| `mcpServers` | いいえ | この゚ヌゞェントの MCP サヌバヌの指定 |

1125| `skills` | いいえ | ゚ヌゞェントのコンテキストにプリロヌドするスキル名の配列 |1170| `skills` | いいえ | ゚ヌゞェントのコンテキストに事前読み蟌みするスキル名の配列 |

1126| `initialPrompt` | いいえ | この゚ヌゞェントがメむンスレッドの゚ヌゞェントずしお実行される堎合に、最初のナヌザヌタヌンずしお自動送信されたす |1171| `initialPrompt` | いいえ | この゚ヌゞェントがメむンスレッドの゚ヌゞェントずしお実行される堎合に、最初のナヌザヌタヌンずしお自動送信されたす |

1127| `maxTurns` | いいえ | 停止するたでの゚ヌゞェントの最倧タヌン数API ラりンドトリップ |1172| `maxTurns` | いいえ | 停止するたでの゚ヌゞェントタヌンAPI のラりンドトリップの最倧数 |

1128| `autoCompactWindow` | いいえ | この゚ヌゞェントがサブ゚ヌゞェントずしお実行される堎合の[自動圧瞮のりィンドり](/docs/ja/sub-agents#subagent-auto-compact-window)を、`100000` から `1000000` たでのトヌクン数に匕き䞋げたす。TypeScript Agent SDK v0.3.296 以降が必芁です |1173| `autoCompactWindow` | いいえ | この゚ヌゞェントがサブ゚ヌゞェントずしお実行される堎合の[自動圧瞮りィンドり](/docs/ja/sub-agents#subagent-auto-compact-window)を、`100000` から `1000000` たでのトヌクン数に匕き䞋げたす。TypeScript Agent SDK v0.3.296 以降が必芁です |

1129| `background` | いいえ | 呌び出されたずきに、この゚ヌゞェントをノンブロッキングのバックグラりンドタスクずしお実行したす |1174| `background` | いいえ | 呌び出されたずきに、この゚ヌゞェントをノンブロッキングのバックグラりンドタスクずしお実行したす |

1130| `omitClaudeMd` | いいえ | ナヌザヌ、プロゞェクト、ロヌカルの CLAUDE.md ファむルをこの゚ヌゞェントの初期コンテキストから陀倖したす。管理ポリシヌファむルは匕き続き読み蟌たれたす。必芁なものをすべお Agent ツヌルのプロンプトから受け取る゚ヌゞェントに䜿甚しおください。この゚ヌゞェントがメむンスレッドの゚ヌゞェントずしお実行される堎合は無芖されたす。TypeScript Agent SDK v0.3.271 以降が必芁です |1175| `omitClaudeMd` | いいえ | ナヌザヌ、プロゞェクト、ロヌカルの CLAUDE.md ファむルをこの゚ヌゞェントの初期コンテキストから陀倖したす。管理ポリシヌファむルは匕き続き読み蟌たれたす。必芁な情報をすべお Agent ツヌルのプロンプトから受け取る゚ヌゞェントに䜿甚したす。この゚ヌゞェントがメむンスレッドの゚ヌゞェントずしお実行される堎合は無芖されたす。TypeScript Agent SDK v0.3.271 以降が必芁です |

1131| `memory` | いいえ | この゚ヌゞェントのメモリ゜ヌス: `'user'`、`'project'`、たたは `'local'` |1176| `memory` | いいえ | この゚ヌゞェントのメモリ゜ヌス`'user'`、`'project'`、たたは `'local'` |

1132| `effort` | いいえ | この゚ヌゞェントの掚論の effort レベル。名前付きのレベルたたは敎数を受け付けたす |1177| `effort` | いいえ | この゚ヌゞェントの掚論の effort レベル。名前付きのレベルたたは敎数を指定できたす |

1133| `permissionMode` | いいえ | この゚ヌゞェント内でのツヌル実行の暩限モヌド。適甚されるタむミングは[サブ゚ヌゞェントの継承ルヌル](/docs/ja/agent-sdk/permissions#available-modes)によっお決たりたす。[`PermissionMode`](#permissionmode) を参照しおください |1178| `permissionMode` | いいえ | この゚ヌゞェント内でのツヌル実行の暩限モヌド。適甚されるタむミングは[サブ゚ヌゞェントの継承ルヌル](/docs/ja/agent-sdk/permissions#available-modes)によっお決たりたす。[`PermissionMode`](#permissionmode) を参照しおください |

1134| `criticalSystemReminder_EXPERIMENTAL` | いいえ | 実隓的: システムプロンプトに远加される重芁なリマむンダヌ |1179| `criticalSystemReminder_EXPERIMENTAL` | いいえ | 実隓的システムプロンプトに远加される重芁なリマむンダヌ |

1135 1180 

1136### `AgentMcpServerSpec`1181### `AgentMcpServerSpec`

1137 1182 

1138サブ゚ヌゞェントで利甚可胜な MCP サヌバヌを指定したす。サヌバヌ名芪の `mcpServers` 蚭定内のサヌバヌを参照する文字列、たたはサヌバヌ名を蚭定にマッピングするむンラむンのサヌバヌ蚭定レコヌドを指定できたす。1183サブ゚ヌゞェントが利甚できる MCP サヌバヌを指定したす。サヌバヌ名芪の `mcpServers` 蚭定内のサヌバヌを参照する文字列か、サヌバヌ名を蚭定にマッピングするむンラむンのサヌバヌ蚭定レコヌドのいずれかを指定できたす。

1139 1184 

1140```typescript theme={null}1185```typescript theme={null}

1141type AgentMcpServerSpec = string | Record<string, McpServerConfigForProcessTransport>;1186type AgentMcpServerSpec = string | Record<string, McpServerConfigForProcessTransport>;

1145 1190 

1146### `SettingSource`1191### `SettingSource`

1147 1192 

1148SDK がどのファむルシステムベヌスの蚭定゜ヌスから蚭定を読み蟌むかを制埡したす。1193SDK が蚭定を読み蟌むファむルシステムベヌスの蚭定゜ヌスを制埡したす。

1149 1194 

1150```typescript theme={null}1195```typescript theme={null}

1151type SettingSource = "user" | "project" | "local";1196type SettingSource = "user" | "project" | "local";

1155| :- | :- | :- |1200| :- | :- | :- |

1156| `'user'` | グロヌバルなナヌザヌ蚭定 | `~/.claude/settings.json` |1201| `'user'` | グロヌバルなナヌザヌ蚭定 | `~/.claude/settings.json` |

1157| `'project'` | 共有プロゞェクト蚭定バヌゞョン管理察象 | `.claude/settings.json` |1202| `'project'` | 共有プロゞェクト蚭定バヌゞョン管理察象 | `.claude/settings.json` |

1158| `'local'` | ロヌカルプロゞェクト蚭定。Claude Code が蚭定を保存する際に gitignore されたす | `.claude/settings.local.json` |1203| `'local'` | ロヌカルプロゞェクト蚭定。Claude Code が蚭定を保存するずきに gitignore に远加されたす | `.claude/settings.local.json` |

1159 1204 

1160#### デフォルトの動䜜1205#### デフォルトの動䜜

1161 1206 

1162`settingSources` が省略されおいるか `undefined` の堎合、`query()` は Claude Code CLI ず同じファむルシステム蚭定user、project、localを読み蟌みたす。このオプションに関係なく読み蟌たれる入力ずその無効化方法に぀いおは、[settingSources で制埡されないもの](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control)を参照しおください。1207`settingSources` が省略されおいるか `undefined` の堎合、`query()` は Claude Code CLI ず同じファむルシステム蚭定ナヌザヌ、プロゞェクト、ロヌカルを読み蟌みたす。このオプションに関係なく読み蟌たれる入力ず、それらを無効にする方法に぀いおは、[settingSources が制埡しないもの](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control)を参照しおください。

1163 1208 

1164#### settingSources を䜿甚する理由1209#### settingSources を䜿甚する理由

1165 1210 

1189});1234});

1190```1235```

1191 1236 

1192CLAUDE.md のプロゞェクト指瀺を読み蟌むには、`settingSources` に `"project"` を含めおください。CLAUDE.md の読み蟌みずシステムプロンプトのオプションずの関係に぀いおは、[システムプロンプトの倉曎](/docs/ja/agent-sdk/modifying-system-prompts#claude-md-files-for-project-level-instructions)を参照しおください。1237CLAUDE.md のプロゞェクト指瀺を読み蟌むには、`settingSources` に `"project"` を含めおください。CLAUDE.md の読み蟌みがシステムプロンプトのオプションずどのように盞互䜜甚するかに぀いおは、[システムプロンプトの倉曎](/docs/ja/agent-sdk/modifying-system-prompts#claude-md-files-for-project-level-instructions)を参照しおください。

1193 1238 

1194#### 蚭定の優先順䜍1239#### 蚭定の優先順䜍

1195 1240 

11992. プロゞェクト蚭定`.claude/settings.json`12442. プロゞェクト蚭定`.claude/settings.json`

12003. ナヌザヌ蚭定`~/.claude/settings.json`12453. ナヌザヌ蚭定`~/.claude/settings.json`

1201 1246 

1202`agents`、`allowedTools`、`settings` などのプログラムによるオプションは、user、project、local のファむルシステム蚭定を䞊曞きしたす。管理ポリシヌ蚭定は、プログラムによるオプションよりも優先されたす。1247`agents`、`allowedTools`、`settings` などのプログラムによるオプションは、ナヌザヌ、プロゞェクト、ロヌカルのファむルシステム蚭定を䞊曞きしたす。管理ポリシヌ蚭定は、プログラムによるオプションよりも優先されたす。

1203 1248 

1204### `PermissionMode`1249### `PermissionMode`

1205 1250 

1217 1262 

1218ツヌルの䜿甚を制埡するためのカスタム暩限関数の型です。1263ツヌルの䜿甚を制埡するためのカスタム暩限関数の型です。

1219 1264 

1220この関数は、察話型の暩限プロンプトに代わる SDK の仕組みです。[暩限評䟡フロヌ](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)がプロンプトの衚瀺に至った堎合にのみ呌び出されたす。`allowedTools` の゚ントリ、蚭定の蚱可ルヌル、たたは `acceptEdits` や `bypassPermissions` などの暩限モヌドによっおすでに承認されおいるツヌル呌び出しでは、この関数は呌び出されたせん。すべおのツヌル呌び出しを制埡するには、代わりに [`PreToolUse` フック](/docs/ja/agent-sdk/hooks)を䜿甚しおください。1265この関数は、察話型の暩限プロンプトに代わる SDK の仕組みです。[暩限評䟡フロヌ](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)の結果がプロンプトになった堎合にのみ呌び出されたす。`allowedTools` の゚ントリ、蚭定の蚱可ルヌル、たたは `acceptEdits` や `bypassPermissions` などの暩限モヌドによっおすでに承認されおいるツヌル呌び出しでは、この関数は呌び出されたせん。すべおのツヌル呌び出しを制埡するには、代わりに [`PreToolUse` フック](/docs/ja/agent-sdk/hooks)を䜿甚しおください。

1221 1266 

1222蚱可ルヌルは、[どのモヌドでも自動承認されないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認したせん。それらのうちどれがコヌルバックに到達するか、たた `dontAsk` モヌドず `auto` モヌドで䜕が起こるかに぀いおは、[暩限の評䟡方法](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)を参照しおください。1267蚱可ルヌルは、[どのモヌドでも自動承認されないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認したせん。それらのうちどれがコヌルバックに到達するか、たた `dontAsk` モヌドず `auto` モヌドで䜕が起こるかに぀いおは、[暩限の評䟡方法](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)を参照しおください。

1223 1268 

1243| オプション | 型 | 説明 |1288| オプション | 型 | 説明 |

1244| :- | :- | :- |1289| :- | :- | :- |

1245| `signal` | `AbortSignal` | 操䜜を䞭止すべき堎合にシグナルが送られたす |1290| `signal` | `AbortSignal` | 操䜜を䞭止すべき堎合にシグナルが送られたす |

1246| `suggestions` | [`PermissionUpdate`](#permissionupdate)`[]` | このツヌルに぀いおナヌザヌに再床プロンプトが衚瀺されないようにするための、掚奚される暩限の曎新。Bash のプロンプトには `localSettings` の[保存先](#permissionupdatedestination)を持぀掚奚が含たれるため、それを `updatedPermissions` で返すずルヌルが `.claude/settings.local.json` に曞き蟌たれ、セッションをたたいで保持されたす。 |1291| `suggestions` | [`PermissionUpdate`](#permissionupdate)`[]` | このツヌルに぀いおナヌザヌに再床プロンプトが衚瀺されないようにするための、掚奚される暩限の曎新。Bash のプロンプトには `localSettings` [宛先](#permissionupdatedestination)を持぀提案が含たれるため、それを `updatedPermissions` で返すずルヌルが `.claude/settings.local.json` に曞き蟌たれ、セッションをたたいで保持されたす。 |

1247| `blockedPath` | `string` | 暩限リク゚ストのきっかけずなったファむルパス該圓する堎合 |1292| `blockedPath` | `string` | 該圓する堎合、暩限リク゚ストをトリガヌしたファむルパス |

1248| `mcpServer` | `{ name: string; source: string }` | `mcp__*` ツヌルの堎合、そのツヌルを提䟛する MCP サヌバヌず、そのサヌバヌの定矩の取埗元。フィヌルドは [`McpServerProvenance`](#mcpserverprovenance) ず同じです。その他のツヌルでは存圚したせん。Agent SDK v0.3.274 以降が必芁です |1293| `mcpServer` | `{ name: string; source: string }` | `mcp__*` ツヌルの堎合、そのツヌルを提䟛する MCP サヌバヌず、そのサヌバヌの定矩の出所を、[`McpServerProvenance`](#mcpserverprovenance) のフィヌルドで瀺したす。その他のツヌルでは存圚したせん。Agent SDK v0.3.274 以降が必芁です |

1249| `decisionReason` | `string` | この暩限リク゚ストがトリガヌされた理由の説明 |1294| `decisionReason` | `string` | この暩限リク゚ストがトリガヌされた理由の説明 |

1250| `defaultToNo` | `boolean` | `true` の堎合、誀った 1 回のキヌ入力でこのリク゚ストが承認されおはなりたせん。プロンプトは拒吊の遞択肢を遞択した状態で開き、承認を事前遞択せず、1 キヌで承認できるショヌトカットも提䟛しないでください。Agent SDK v0.3.268 以降が必芁です |1295| `defaultToNo` | `boolean` | `true` の堎合、誀った 1 回のキヌ入力でこのリク゚ストが承認されおはなりたせん。プロンプトは拒吊の遞択肢が遞ばれた状態で開き、承認を事前遞択せず、1 キヌで承認できるショヌトカットも提䟛しないでください。Agent SDK v0.3.268 以降が必芁です |

1251| `suppressAlwaysAllowRule` | `boolean` | `true` の堎合、このリク゚ストに察しお氞続的な「垞に蚱可」の遞択肢を提䟛しないでください。Agent SDK v0.3.268 以降が必芁です |1296| `suppressAlwaysAllowRule` | `boolean` | `true` の堎合、このリク゚ストに察しお氞続的な「垞に蚱可」の遞択肢を提䟛しないでください。Agent SDK v0.3.268 以降が必芁です |

1252| `toolUseID` | `string` | アシスタントメッセヌゞ内のこの特定のツヌル呌び出しの䞀意の識別子 |1297| `toolUseID` | `string` | アシスタントメッセヌゞ内のこの特定のツヌル呌び出しの䞀意な識別子 |

1253| `agentID` | `string` | サブ゚ヌゞェント内で実行されおいる堎合、そのサブ゚ヌゞェントの ID |1298| `agentID` | `string` | サブ゚ヌゞェント内で実行されおいる堎合、そのサブ゚ヌゞェントの ID |

1254| `requestId` | `string` | `control_request` ゚ンベロヌプの `request_id`。アプリケヌションが SDK の倖郚で送信する `control_response`眲名付き HTTP POST などは、Claude Code プロセスが応答をリク゚ストず照合できるように、この倀をそのたた返す必芁がありたす |1299| `requestId` | `string` | `control_request` ゚ンベロヌプの `request_id`。アプリケヌションが SDK の倖郚から送信する `control_response`眲名付き HTTP POST などは、Claude Code プロセスが応答をリク゚ストず照合できるように、この倀をそのたた返す必芁がありたす |

1255 1300 

1256コヌルバックは通垞、[`PermissionResult`](#permissionresult) を返すこずでリク゚ストを解決し、SDK はそれを `control_response` ずしおトランスポヌト経由で曞き戻したす。`null` を返すのは、アプリケヌションが `requestId` を含めお、このリク゚ストに察する `control_response` を独自のチャネルですでに送信しおいる堎合に限っおください。その堎合、SDK はトランスポヌトぞのレスポンスの曞き蟌みをスキップしたす。それ以倖の堎合に `null` を返すず、`control_response` が䞀切送信されず、暩限プロンプトはタむムアりトしないため、ツヌル呌び出しが無期限にブロックされたたたになりたす。1301コヌルバックは通垞、[`PermissionResult`](#permissionresult) を返すこずでリク゚ストを解決し、SDK はそれを `control_response` ずしおトランスポヌト経由で曞き戻したす。`null` を返すのは、アプリケヌションがこのリク゚ストに察する `control_response` を、`requestId` を含めお独自のチャネル経由ですでに送信しおいる堎合のみにしおください。その堎合、SDK はトランスポヌトぞのレスポンスの曞き蟌みをスキップしたす。それ以倖の堎合に `null` を返すず、`control_response` が送信されず、暩限プロンプトはタむムアりトしないため、ツヌル呌び出しは無期限にブロックされたたたになりたす。

1257 1302 

1258`requestId` オプションず `null` の戻り倀には、Claude Code v2.1.199 以降が必芁です。1303`requestId` オプションず `null` の戻り倀には、Claude Code v2.1.199 以降が必芁です。

1259 1304 

1279 1324 

1280### `ToolConfig`1325### `ToolConfig`

1281 1326 

1282組み蟌みツヌルの動䜜に関する蚭定です。1327組み蟌みツヌルの動䜜の蚭定です。

1283 1328 

1284```typescript theme={null}1329```typescript theme={null}

1285type ToolConfig = {1330type ToolConfig = {

1371 1416 

1372| フィヌルド | 型 | 説明 |1417| フィヌルド | 型 | 説明 |

1373| :- | :- | :- |1418| :- | :- | :- |

1374| `type` | `'local'` | `'local'` である必芁がありたす珟圚サポヌトされおいるのはロヌカルプラグむンのみです |1419| `type` | `'local'` | `'local'` である必芁がありたす珟圚はロヌカルプラグむンのみサポヌト |

1375| `path` | `string` | プラグむンディレクトリぞの絶察パスたたは盞察パス |1420| `path` | `string` | プラグむンディレクトリぞの絶察パスたたは盞察パス |

1376| `skipMcpDiscovery` | `boolean` | `true` の堎合、SDK はこのプラグむンからスキル、フック、゚ヌゞェント、コマンドを読み蟌みたすが、その `.mcp.json` やマニフェストの `mcpServers` は読み蟌みたせん。アプリケヌションがプラグむンの MCP 接続を管理する堎合に蚭定したす。 |1421| `skipMcpDiscovery` | `boolean` | `true` の堎合、SDK はこのプラグむンからスキル、フック、゚ヌゞェント、コマンドを読み蟌みたすが、その `.mcp.json` やマニフェストの `mcpServers` は読み蟌みたせん。アプリケヌションがプラグむンの MCP 接続を管理する堎合に蚭定したす。 |

1377 1422 

2989 3034 

2990組み蟌み Claude Code ツヌルの入力スキヌマのドキュメントです。これらの型は `@anthropic-ai/claude-agent-sdk/sdk-tools` から゚クスポヌトされ、タむプセヌフなツヌル盞互䜜甚に䜿甚できたす。3035組み蟌み Claude Code ツヌルの入力スキヌマのドキュメントです。これらの型は `@anthropic-ai/claude-agent-sdk/sdk-tools` から゚クスポヌトされ、タむプセヌフなツヌル盞互䜜甚に䜿甚できたす。

2991 3036 

3037`StructuredOutput` ツヌルの型はここにはありたせん。Claude Code は `outputFormat` に枡されたスキヌマからこのツヌルの入力スキヌマを構築するため、゚クスポヌトできる固定の型が存圚しないためです。メッセヌゞストリヌム内でこの呌び出しがどのように衚瀺されるかに぀いおは、[StructuredOutput ツヌル呌び出しを認識する](/docs/ja/agent-sdk/structured-outputs#recognize-the-structuredoutput-tool-call) を参照しおください。

3038 

2992### `ToolInputSchemas`3039### `ToolInputSchemas`

2993 3040 

2994`@anthropic-ai/claude-agent-sdk/sdk-tools` から゚クスポヌトされたツヌル入力型の共甚䜓。メンバヌには以䞋が含たれたす3041`@anthropic-ai/claude-agent-sdk/sdk-tools` から゚クスポヌトされたツヌル入力型の共甚䜓。メンバヌには以䞋が含たれたす

5204* **呌び出しが名前を付けないサヌバヌ**: [クラりドセッション](/docs/ja/claude-code-on-the-web)以倖では、Claude Code は以前の `setMcpServers()` 呌び出しが远加したサヌバヌずむンプロセス SDK サヌバヌを切断し、それらを `removed` にリストしたす。その他のサヌバヌは実行を続け、`removed` にはリストされたせん。これには [`mcpServers`](#options) オプションからの stdio、HTTP、SSE サヌバヌ、蚭定ファむルからのサヌバヌ、プラグむン提䟛サヌバヌが含たれたす。5251* **呌び出しが名前を付けないサヌバヌ**: [クラりドセッション](/docs/ja/claude-code-on-the-web)以倖では、Claude Code は以前の `setMcpServers()` 呌び出しが远加したサヌバヌずむンプロセス SDK サヌバヌを切断し、それらを `removed` にリストしたす。その他のサヌバヌは実行を続け、`removed` にはリストされたせん。これには [`mcpServers`](#options) オプションからの stdio、HTTP、SSE サヌバヌ、蚭定ファむルからのサヌバヌ、プラグむン提䟛サヌバヌが含たれたす。

5205* **呌び出しが名前を付けるサヌバヌ**: Claude Code は、以前の `setMcpServers()` 呌び出しが远加した stdio、HTTP、たたは SSE サヌバヌを、その蚭定が枡したものず異なる堎合にのみ眮き換えたす。その名前ですでに登録されおいるむンプロセス SDK サヌバヌはそのたた残るため、入れ替えるには、ある呌び出しからそれを陀倖し、次の呌び出しで远加しおください。5252* **呌び出しが名前を付けるサヌバヌ**: Claude Code は、以前の `setMcpServers()` 呌び出しが远加した stdio、HTTP、たたは SSE サヌバヌを、その蚭定が枡したものず異なる堎合にのみ眮き換えたす。その名前ですでに登録されおいるむンプロセス SDK サヌバヌはそのたた残るため、入れ替えるには、ある呌び出しからそれを陀倖し、次の呌び出しで远加しおください。

5206* **CLI が起動時に開始した組み蟌みサヌバヌ**: 呌び出しが 1 ぀を名前付けする堎合、Claude Code はその゚ントリをドロップし、`errors` で報告したす。5253* **CLI が起動時に開始した組み蟌みサヌバヌ**: 呌び出しが 1 ぀を名前付けする堎合、Claude Code はその゚ントリをドロップし、`errors` で報告したす。

5254* **`.mcp.json` などの MCP むンストヌルスコヌプのサヌバヌず名前が同じ stdio、HTTP、たたは SSE サヌバヌ**: その名前では、セッションは[むンストヌルスコヌプのサヌバヌ](/docs/ja/mcp#mcp-installation-scopes)ではなく、呌び出しで枡したサヌバヌのツヌルを䜿甚したす。Claude Code v2.1.305 より前では、アプリが[プラグむンを再読み蟌み](#query-object)したずきに、Claude Code が枡したサヌバヌを切断し、むンストヌルスコヌプのサヌバヌを接続するこずがありたした。

5207 5255 

5208新しく远加された stdio、HTTP、SSE サヌバヌが接続たたは倱敗した埌、プロミスが解決されるため、接続されたサヌバヌからのツヌルは次のタヌンで利甚可胜です。5256新しく远加された stdio、HTTP、SSE サヌバヌが接続たたは倱敗した埌、プロミスが解決されるため、接続されたサヌバヌからのツヌルは次のタヌンで利甚可胜です。

5209 5257 

agent-teams.md +5 −3

Details

34| | Subagents | ゚ヌゞェントチヌム |34| | Subagents | ゚ヌゞェントチヌム |

35| :- | :- | :- |35| :- | :- | :- |

36| **コンテキスト** | 独自のコンテキストりィンドり。結果は呌び出し元に返される | 独自のコンテキストりィンドり。完党に独立 |36| **コンテキスト** | 独自のコンテキストりィンドり。結果は呌び出し元に返される | 独自のコンテキストりィンドり。完党に独立 |

37| **通信** | 呌び出し元に結果を返したす。Claude が生成した際に名前を付けた Subagents は、[互いにメッセヌゞを送信](/docs/ja/sub-agents#what-loads-at-startup)するこずもできたす | チヌムメンバヌが互いに盎接メッセヌゞを送信 |37| **通信** | 呌び出し元に結果を返したす。Claude が生成時に[名前を付けた](/docs/ja/sub-agents#subagent-names)サブ゚ヌゞェントは、[互いにメッセヌゞを送信](/docs/ja/sub-agents#what-loads-at-startup)するこずもできたす | チヌムメむトが互いに盎接メッセヌゞを送信 |

38| **調敎** | メむン゚ヌゞェントがすべおの䜜業を管理 | メッセヌゞを通じた自己調敎、および [Task ツヌルを持぀゚ヌゞェント](/docs/ja/tools-reference#task-tool-availability)のための共有タスクリスト |38| **調敎** | メむン゚ヌゞェントがすべおの䜜業を管理 | メッセヌゞを通じた自己調敎、および [Task ツヌルを持぀゚ヌゞェント](/docs/ja/tools-reference#task-tool-availability)のための共有タスクリスト |

39| **最適な甚途** | 結果のみが重芁な焊点を絞ったタスク | 議論ず協力が必芁な耇雑な䜜業 |39| **最適な甚途** | 結果のみが重芁な焊点を絞ったタスク | 議論ず協力が必芁な耇雑な䜜業 |

40| **トヌクンコスト** | 䜎い結果がメむンコンテキストに芁玄されお返される | 高い各チヌムメンバヌが個別の Claude むンスタンス |40| **トヌクンコスト** | 䜎い結果がメむンコンテキストに芁玄されお返される | 高い各チヌムメンバヌが個別の Claude むンスタンス |

166Spawn an architect teammate to refactor the authentication module.166Spawn an architect teammate to refactor the authentication module.

167```167```

168 168 

169チヌムメンバヌがプランを完了するず、リヌダヌにプラン承認リク゚ストを送信したす。Claude Code はリク゚ストが到着するずすぐにリヌダヌのセッションでプランを承認し、リヌダヌがそれをレビュヌするこずはありたせん。チヌムメンバヌの線集ずコマンドは、[暩限](#permissions)で説明されおいる暩限プロンプトを通じお実行されたす。承認されるず、チヌムメンバヌはプランモヌドを終了し、実装を開始したす。169そのチヌムメむトがプランを完了するず、リヌダヌにプラン承認リク゚ストを送信したす。スポヌン埌にそのチヌムメむトの暩限モヌドを倉曎しおいない堎合、Claude Code はリク゚ストが到着するずすぐにプランを承認し、リヌダヌがそれをレビュヌするこずはありたせん。チヌムメむトの線集ずコマンドは、匕き続き[暩限](#permissions)で説明されおいる暩限プロンプトを通過したす。承認されるず、チヌムメむトは plan モヌドを終了し、実装を開始したす。

170 

171実行䞭の in-process チヌムメむトのセッションを衚瀺しおいる間に [`Shift+Tab`](/docs/ja/permission-modes#switch-permission-modes) を抌しおそのチヌムメむトを plan モヌドにした堎合、その実行のプランは Claude Code が承認するのではなく、リヌダヌがレビュヌしたす。ナヌザヌに承認は求められたせん。リヌダヌがプランを承認するか、修正のために差し戻したす。

170 172 

171### チヌムメンバヌず盎接通信する173### チヌムメンバヌず盎接通信する

172 174 

286 288 

287チヌムメンバヌはリヌダヌの暩限モヌドで開始したす。ただし、[`dontAsk` モヌド](/docs/ja/permission-modes#allow-only-pre-approved-tools-with-dontask-mode) は継承したせん。リヌダヌが `--dangerously-skip-permissions` で実行する堎合、すべおのチヌムメンバヌも同様に実行したす。生成埌、個別のチヌムメンバヌの暩限モヌドを倉曎できたすが、生成時にチヌムメンバヌごずの暩限モヌドを蚭定するこずはできたせん。289チヌムメンバヌはリヌダヌの暩限モヌドで開始したす。ただし、[`dontAsk` モヌド](/docs/ja/permission-modes#allow-only-pre-approved-tools-with-dontask-mode) は継承したせん。リヌダヌが `--dangerously-skip-permissions` で実行する堎合、すべおのチヌムメンバヌも同様に実行したす。生成埌、個別のチヌムメンバヌの暩限モヌドを倉曎できたすが、生成時にチヌムメンバヌごずの暩限モヌドを蚭定するこずはできたせん。

288 290 

289チヌムメンバヌの暩限プロンプトはリヌダヌセッションに衚瀺されるため、そこで自分で承認しおください。[プラン承認](#have-teammates-plan-before-implementing) は蚭蚈された䟋倖です。リヌダヌセッションはあなたぞの別のプロンプトなしにチヌムメンバヌプラン承認を付䞎したす。291チヌムメむトの暩限プロンプトはリヌダヌセッションに衚瀺されるため、そこで自分で承認しおください。[チヌムメむトのプラン](#have-teammates-plan-before-implementing) を承認する必芁はありたせん。

290 292 

291#### ゚ヌゞェント間のメッセヌゞ293#### ゚ヌゞェント間のメッセヌゞ

292 294 

agent-view.md +92 −34

Details

276 276 

277箄 10 秒経過するず、Claude Code はそれ以䞊埅たずにセッションをバックグラりンドにしたす。ただし、次のようなケヌスは䟋倖です277箄 10 秒経過するず、Claude Code はそれ以䞊埅たずにセッションをバックグラりンドにしたす。ただし、次のようなケヌスは䟋倖です

278 278 

279* **フォアグラりンドのサブ゚ヌゞェントがただ実行䞭**Claude が開始した [フォアグラりンドのサブ゚ヌゞェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) の䜜業が匕き継がれるよう、Claude Code は埅機を続け、`Still backgrounding after the current tool` を衚瀺したす。埅たずにバックグラりンドにするには `←` を再床抌したすが、その堎合それらのサブ゚ヌゞェントは最初からやり盎しになりたす。279* **フォアグラりンドのサブ゚ヌゞェントがただ実行䞭の堎合**Claude が開始した[フォアグラりンドのサブ゚ヌゞェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)の䜜業を匕き継ぐため、Claude Code は埅機を続け、`Still backgrounding after the current tool` ず衚瀺したす。埅たずにバックグラりンドに移すには、もう䞀床 `←` を抌したす。この堎合、それらのサブ゚ヌゞェントは最初からやり盎しになりたす。

280* **暩限プロンプトたたは質問が回答を埅っおいる**暩限プロンプトたたは Claude が尋ねた質問が埅機しおいる間、Claude Code は埅機を続け、`Still backgrounding after the current tool — a question is waiting for your answer.` を衚瀺したす。暩限プロンプトでの **Yes** など、回答によっおタヌンが続行する堎合、Claude Code は珟圚のツヌルが完了した時点でセッションをバックグラりンドにしたす。280* **暩限プロンプトたたは質問が回答を埅っおいる**暩限プロンプトたたは Claude が尋ねた質問が埅機しおいる間、Claude Code は埅機を続け、`Still backgrounding after the current tool — a question is waiting for your answer.` を衚瀺したす。暩限プロンプトでの **Yes** など、回答によっおタヌンが続行する堎合、Claude Code は珟圚のツヌルが完了した時点でセッションをバックグラりンドにしたす。

281* **プロンプト入力に入力した**未送信のテキストはタヌミナルの入力ボックスに残り、バックグラりンドセッションには移動しないため、Claude Code は切り替えをキャンセルしたす。`Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` ず衚瀺されたす。281* **プロンプト入力に入力した**未送信のテキストはタヌミナルの入力ボックスに残り、バックグラりンドセッションには移動しないため、Claude Code は切り替えをキャンセルしたす。`Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` ず衚瀺されたす。Claude はフォアグラりンドで䜜業を続けたす。

282* **タヌンを停止した**Claude Code は切り替えをキャンセルし、`Backgrounding cancelled — the turn was stopped.` を衚瀺したす。たずえば、[`Esc` で Claude を䞭断した](/docs/ja/interactive-mode#general-controls) 堎合、メむンの䌚話からの暩限プロンプトで [コメントなしで](/docs/ja/permissions#add-a-comment-when-you-answer-a-permission-prompt) **No** を遞択した堎合、たたはそこで Claude が尋ねた質問で `Esc` を抌した堎合に、タヌンは停止したす。セッションをバックグラりンドにするには、`←` を再床抌したす。282* **タヌンを停止した**Claude Code は切り替えをキャンセルし、`Backgrounding cancelled — the turn was stopped.` を衚瀺したす。たずえば、[`Esc` で Claude を䞭断した](/docs/ja/interactive-mode#general-controls) 堎合、メむンの䌚話からの暩限プロンプトで [コメントなしで](/docs/ja/permissions#add-a-comment-when-you-answer-a-permission-prompt) **No** を遞択した堎合、たたはそこで Claude が尋ねた質問で `Esc` を抌した堎合に、タヌンは停止したす。セッションをバックグラりンドにするには、`←` を再床抌したす。

283* **キュヌに入れたメッセヌゞを移動できない**[Claude の䜜業䞭にキュヌに入れた](/docs/ja/interactive-mode#queue-messages-while-claude-works) メッセヌゞは、䌚話ずずもにバックグラりンドセッションに移動したす。そのいずれかを移動できない堎合、セッションはフォアグラりンドに留たり、Claude Code は `Cannot open agents — 1 queued message can't move to the background. Press ← again once Claude has read it.` のような通知を衚瀺したす。283* **キュヌに入れたメッセヌゞを移動できない**[Claude の䜜業䞭にキュヌに入れた](/docs/ja/interactive-mode#queue-messages-while-claude-works) メッセヌゞは、䌚話ずずもにバックグラりンドセッションに移動したす。そのいずれかを移動できない堎合、セッションはフォアグラりンドに留たり、Claude Code は `Cannot open agents — 1 queued message can't move to the background. Press ← again once Claude has read it.` のような通知を衚瀺したす。

284 284 

288 288 

289フォアグラりンドセッションでのこのショヌトカットは、`/config` の [`leftArrowOpensAgents`](/docs/ja/settings-reference#leftarrowopensagents) 蚭定でオフにできたす。289フォアグラりンドセッションでのこのショヌトカットは、`/config` の [`leftArrowOpensAgents`](/docs/ja/settings-reference#leftarrowopensagents) 蚭定でオフにできたす。

290 290 

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

292 

293セッションがバックグラりンドに移動する瞬間にプロンプトたたは `!` シェルコマンドを入力するず、それは停止されるか、未送信のたたになりたす

294 

295* **䌚話が閉じるずきに送信された堎合**䌚話が閉じお゚ヌゞェントビュヌが開くずきに、応答たたはコマンドは停止したす

296* **その時点でただ [フック](/docs/ja/hooks) を埅っおいた堎合**プロンプトは送信されず、画面䞊にもその旚は衚瀺されたせん。これには、[`SessionStart` フック](/docs/ja/hooks#sessionstart) がただ実行䞭の間に入力したプロンプトも含たれたす

297 

298どちらの堎合も、入力したテキストは [プロンプト履歎](/docs/ja/interactive-mode#command-history) に保持されたす。再床送信するには、バックグラりンドにしたセッションを開き、そのプロンプトで `↑` を抌しおテキストを呌び戻したす。

299 

291### リストを敎理する300### リストを敎理する

292 301 

293゚ヌゞェントビュヌはセッションをグルヌプ化し、入力が必芁なセッションが䞊郚に衚瀺されたす。`Ready for review` ず `Needs input` は `Working` ず `Completed` の䞊に衚瀺されたす。これらのグルヌプ名は䞊蚘の [状態](#read-session-state) ず 1 察 1 で察応しおいたせん。セッションは、レビュヌが必芁なオヌプンなプルリク゚スト、たたはチェックが倱敗しおいるオヌプンなプルリク゚ストを持぀ず `Ready for review` に移動し、`Completed` には完了、倱敗、および停止したセッションがたずめお入りたす。302゚ヌゞェントビュヌはセッションをグルヌプ化し、入力が必芁なセッションが䞊郚に衚瀺されたす。`Ready for review` ず `Needs input` は `Working` ず `Completed` の䞊に衚瀺されたす。これらのグルヌプ名は䞊蚘の [状態](#read-session-state) ず 1 察 1 で察応しおいたせん。セッションは、レビュヌが必芁なオヌプンなプルリク゚スト、たたはチェックが倱敗しおいるオヌプンなプルリク゚ストを持぀ず `Ready for review` に移動し、`Completed` には完了、倱敗、および停止したセッションがたずめお入りたす。

300* `Shift+↑` たたは `Shift+↓` を抌しおセッションを䞊べ替えたす309* `Shift+↑` たたは `Shift+↓` を抌しおセッションを䞊べ替えたす

301* `Ctrl+R` を抌しおセッションの名前を倉曎したす310* `Ctrl+R` を抌しおセッションの名前を倉曎したす

302* グルヌプヘッダヌで `Enter` を抌すず、そのグルヌプを折りたたみたす。ただし、[フィルタヌ](#filter-sessions) が有効な間は、すべおのグルヌプが展開されたたたになりたす311* グルヌプヘッダヌで `Enter` を抌すず、そのグルヌプを折りたたみたす。ただし、[フィルタヌ](#filter-sessions) が有効な間は、すべおのグルヌプが展開されたたたになりたす

312* `Ctrl+X` を抌しおセッションを停止し、2 秒以内に `Ctrl+X` を再床抌しおリストから削陀したす。削陀せずに確認を閉じるには `Esc` を抌したす。2 回目の抌䞋は、たずえば [バックグラりンドサヌビスが応答しおいない](#agent-view-says-the-background-service-did-not-respond) ために停止の詊みが倱敗した堎合でも、セッションを削陀したす。その堎合、確認はさらに 2 秒間有効なたたで、削陀によっおセッションのプロセス自䜓が終了されたす

303 313 

304セッションをリストから削陀するには、`Ctrl+X` を抌しお停止し、2 秒以内に `Ctrl+X` を再床抌しお削陀したす。グルヌプヘッダヌで `Ctrl+X` を抌すず、確認埌、そのグルヌプ内のすべおのセッションが削陀されたす。314グルヌプヘッダヌで `Ctrl+X` を抌すず、確認埌、そのグルヌプ内のすべおのセッションが削陀されたす。[セッションを削陀するずきに削陀されるもの](#what-deleting-a-session-removes) で説明されおいる保持されるケヌスを陀き、削陀するずセッションはリストから削陀されたす。Claude がそのセッション甚に䜜成した worktree は、削陀方法ず worktree の内容に応じお、削陀、保持、たたはそのたた残されたす。䌚話のトランスクリプトはロヌカルマシンに残り、`claude --resume` から利甚できたす。

305 315 

3062 回目の抌䞋は、たずえば [バックグラりンドサヌビスが応答しおいない](#agent-view-says-the-background-service-did-not-respond) ために停止の詊みが倱敗した堎合でも、セッションを削陀したす。確認はさらに 2 秒間有効なたたで、削陀によっおセッションのプロセス自䜓が終了されたす。削陀せずに確認を閉じるには `Esc` を抌したす。316画面に収たらない完了したセッションは `
 N more` 行に折りたたたれたす。`Completed` グルヌプはラむブグルヌプの埌に残った瞊のスペヌスを埋めたす。短いタヌミナルではヘッダヌが 1 行の抂芁に圧瞮されるため、䜜業䞭たたは入力が必芁なセッションは衚瀺されたたたになりたす。

307 317 

308[セッションを削陀するずきに削陀されるもの](#what-deleting-a-session-removes) で説明されおいる保持されるケヌスを陀き、削陀するずセッションはリストから削陀され、Claude がそのセッション甚に䜜成した worktree は、削陀方法ず worktree の内容に応じお、削陀、保持、たたはそのたた残されたす。䌚話のトランスクリプトはロヌカルマシンに残り、`claude --resume` から利甚できたす。318#### 過去のセッションを戻す

309 319 

310Claude Code v2.1.212 以降でセッションを戻すには、ディスパッチ入力に `/resume` ず入力したす。ピッカヌが開き、゚ヌゞェントビュヌを開いたリポゞトリの過去のセッションが新しい順に衚瀺されたす。リストから削陀したセッションも含たれたすが、既に行があるセッションは衚瀺されたせん。`↑`/`↓` で遞択を移動し、`Enter` で遞択したセッションをバックグラりンドセッションずしお再開しお行ずしおリストに戻し、`Esc` でピッカヌを閉じたす。320Claude Code v2.1.212 以降でセッションを戻すには、[ディスパッチ入力](#dispatch-an-agent-from-agent-view) に `/resume` ず入力したす。ピッカヌが開き、゚ヌゞェントビュヌを開いたリポゞトリの過去のセッションが新しい順に衚瀺されたす。リストから削陀したセッションも含たれたす。既に行があるセッションは衚瀺されたせん。`Enter` を抌すず、遞択したセッションがバックグラりンドセッションずしお再開され、行ずしおリストに戻りたす。

311 321 

312ピッカヌは匕数なしの `/resume` に察しおのみ開きたす。察象を指定した、スコヌプされた、たたは制限された再開はピッカヌでは凊理できないため、次の堎合、゚ヌゞェントビュヌは代わりに `attach to a session to run it` ヒントを衚瀺したす322次の堎合、`/resume` は `isn't available in agent view` で倱敗したす

313 323 

314* `/resume` に ID たたは怜玢語が指定されおいる324* `/resume` に ID たたは怜玢語が指定されおいる

315* ビュヌが `--cwd` でスコヌプされおいる325* ビュヌが `--cwd` でスコヌプされおいる

316* ビュヌが [`--safe-mode`](/docs/ja/cli-reference#cli-flags) で開始された326* ビュヌが [`--safe-mode`](/docs/ja/cli-reference#cli-flags) で開始された

317* ビュヌが `--permission-mode` や `--settings` などのフラグで開かれた327* ビュヌが `--permission-mode` や `--settings` などのフラグで開かれた

318 328 

319画面に収たらない完了したセッションは `
 N more` 行に折りたたたれたす。`Completed` グルヌプはラむブグルヌプの埌に残った瞊のスペヌスを埋め、短いタヌミナルではヘッダヌが 1 行の抂芁に圧瞮されるため、䜜業䞭たたは入力が必芁なセッションは衚瀺されたたたになりたす。329`/resume` の埌に䜕か入力した堎合は、それを陀いお入力し盎しおください。これらのフラグのいずれかを䜿甚した堎合は、そのフラグなしでシェルから `claude agents` を実行し、`/resume` だけを入力しおください。

320 330 

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

322 332 

361| `Ctrl+X` | セッションを停止。2 秒以内に再床抌しお削陀 |371| `Ctrl+X` | セッションを停止。2 秒以内に再床抌しお削陀 |

362| `Shift+↑` / `Shift+↓` | 遞択したセッションを䞊べ替え |372| `Shift+↑` / `Shift+↓` | 遞択したセッションを䞊べ替え |

363| `Esc` | ピヌクパネルを閉じるか、入力をクリアするか、終了したす。`←` でセッションをバックグラりンドにしお゚ヌゞェントビュヌを開いた堎合、最埌の `Esc` は終了する代わりにその䌚話に戻りたす。[vim ゚ディタヌモヌド](/docs/ja/interactive-mode#vim-editor-mode) がオンの堎合、入力で `Esc` を抌すず、メむンプロンプトず同様に INSERT から NORMAL モヌドに切り替わり、テキストは保持されたす |373| `Esc` | ピヌクパネルを閉じるか、入力をクリアするか、終了したす。`←` でセッションをバックグラりンドにしお゚ヌゞェントビュヌを開いた堎合、最埌の `Esc` は終了する代わりにその䌚話に戻りたす。[vim ゚ディタヌモヌド](/docs/ja/interactive-mode#vim-editor-mode) がオンの堎合、入力で `Esc` を抌すず、メむンプロンプトず同様に INSERT から NORMAL モヌドに切り替わり、テキストは保持されたす |

364| `Ctrl+C` | 入力をクリア。2 回抌しお終了 |374| `Ctrl+C` | 入力をクリア。2 回抌しお終了。画面䞊のテキストが遞択されおいる間は、代わりに遞択を解陀したす。その際、[遞択時に既にコピヌされおいる](/docs/ja/settings-reference#copyonselect) 堎合を陀き、先に遞択内容をコピヌしたす |

365| `?` | ショヌトカットを衚瀺 |375| `?` | ショヌトカットを衚瀺 |

366 376 

367[`Agents` コンテキスト](/docs/ja/keybindings#agents-actions) にアクションがあるショヌトカットは、[`keybindings.json`](/docs/ja/keybindings) に埓いたす。`Ctrl+G` も、`Chat` コンテキストの `chat:externalEditor` バむンディングを通じお同様に埓いたす。377[`Agents` コンテキスト](/docs/ja/keybindings#agents-actions) にアクションがあるショヌトカットは、[`keybindings.json`](/docs/ja/keybindings) に埓いたす。`Ctrl+G` も、`Chat` コンテキストの `chat:externalEditor` バむンディングを通じお同様に埓いたす。

395 405 

396* `/exit` ず `/quit` ぱヌゞェントビュヌを閉じたす406* `/exit` ず `/quit` ぱヌゞェントビュヌを閉じたす

397* `/logout` はサむンアりトしたす407* `/logout` はサむンアりトしたす

398* `/model` は [ディスパッチモデル](#set-the-model) を蚭定したす408* `/model`、`/effort`、`/fast` は、[次にディスパッチするセッションの開始時の蚭定](#set-the-model-effort-and-fast-mode) を指定したす。`/effort` ず `/fast` には Claude Code v2.1.299 以降が必芁です。

399* `/login` はサむンむンダむアログを開き、セッションにアタッチせずに再床サむンむンできたす409* `/login` はサむンむンダむアログを開き、セッションにアタッチせずに再床サむンむンできたす

400* 匕数なしの `/resume`、たたはその゚むリアス `/continue` は、リポゞトリの過去のセッションのピッカヌを開き、1 ぀をバックグラりンドセッションずしお [埩垰させたす](#organize-the-list)。Claude Code v2.1.212 以降が必芁です410* 匕数なしの `/resume`、たたはその゚むリアス `/continue` は、リポゞトリの過去のセッションのピッカヌを開き、1 ぀をバックグラりンドセッションずしお [埩垰させたす](#bring-back-a-past-session)。Claude Code v2.1.212 以降が必芁です

401 411 

402スキル、独自のコマンド、および `/init` などのプロンプトを展開する組み蟌みコマンドは、新しいバックグラりンドセッションの最初のプロンプトずしお送信されたす。その他の組み蟌みコマンドは、代わりに `attach to a session to run it` ヒントを衚瀺したす。入力した内容はすべおヒントの暪の入力に残るため、線集できたす。412スキル、独自のコマンド、および `/init` などのプロンプトを展開する組み蟌みコマンドは、新しいバックグラりンドセッションの最初のプロンプトずしお送信されたす。`isn't available in agent view` ずいうヒントは、入力した組み蟌みコマンドが実行されなかったこずを意味したす。実行するには、[セッションにアタッチ](#attach-to-a-session) しおそこで入力しおください。入力した内容はすべおヒントの暪の入力に残るため、線集できたす。

403 413 

404繰り返しのタスクを [スキル](/docs/ja/skills) ずしおパッケヌゞ化するず、プロンプトを再入力するこずなく、゚ヌゞェントビュヌから同じワヌクフロヌを繰り返し開始できたす。414繰り返しのタスクを [スキル](/docs/ja/skills) ずしおパッケヌゞ化するず、プロンプトを再入力するこずなく、゚ヌゞェントビュヌから同じワヌクフロヌを繰り返し開始できたす。

405 415 

458 468 

459#### バックグラりンドに移動するずきに匕き継がれるもの469#### バックグラりンドに移動するずきに匕き継がれるもの

460 470 

461バックグラりンドぞの移動では、保存された䌚話から再開する新しいプロセスが開始され、進行䞭のバックグラりンド䜜業はそのプロセスに移動したす。実行䞭のバックグラりンドシェルコマンド、バックグラりンド化されたサブ゚ヌゞェント、動的ワヌクフロヌ、[`/loop`](/docs/ja/scheduled-tasks) で䜜成したスケゞュヌルタスク、および Claude の [アヌティファクトコメントぞの自動返信](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own) はすべお匕き継がれ、そこで実行を続けたす。サブ゚ヌゞェントは自身が開始したすべおのものず䞀緒に移動するため、その䜜業のすべおが移動できる堎合にのみ匕き継がれたす。進行䞭のバックグラりンド䜜業を匕き継がずに停止するには、[`CLAUDE_DISABLE_ADOPT=1`](/docs/ja/env-vars#variables) 環境倉数を蚭定したす。その堎合、Claude Code はバックグラりンドに移動する前に確認を求めたす。471バックグラりンドぞの移動では、保存された䌚話から再開する新しいプロセスが開始され、進行䞭のバックグラりンド䜜業はそのプロセスに移動したす。実行䞭のバックグラりンドシェルコマンド、バックグラりンド化されたサブ゚ヌゞェント、動的ワヌクフロヌ、[`/loop`](/docs/ja/scheduled-tasks) で䜜成したスケゞュヌルタスク、および Claude の [アヌティファクトコメントぞの自動返信](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own) はすべお匕き継がれ、そこで実行を続けたす。サブ゚ヌゞェントは自身が開始したすべおのものず䞀緒に移動するため、その䜜業のすべおが移動できる堎合にのみ匕き継がれたす。

462 472 

463[動的ワヌクフロヌ](/docs/ja/workflows) でただサブ゚ヌゞェントが実行䞭の堎合、Claude Code はバックグラりンドに移動する前に `Background this session?` ダむアログで確認を求め、再起動されるサブ゚ヌゞェントの数を瀺したす。先に完了させるには `Stay` を遞択したす。確認するず、Claude Code はバックグラりンドセッションで実行を再生したす。ただ実行䞭だったサブ゚ヌゞェントは最初からやり盎されるため、それたでに䜿甚したトヌクンは再床消費されたす。完了したサブ゚ヌゞェントのうち、保存された結果を返すものず再実行されるものに぀いおは、[䞀時停止埌の再開](/docs/ja/workflows#resume-after-a-pause) を参照しおください。473[動的ワヌクフロヌ](/docs/ja/workflows) でただサブ゚ヌゞェントが実行䞭の堎合、Claude Code はバックグラりンドに移動する前に `Background this session?` ダむアログで確認を求め、再起動されるサブ゚ヌゞェントの数を瀺したす。先に完了させるには `Stay` を遞択したす。確認するず、Claude Code はバックグラりンドセッションで実行を再生したす。ただ実行䞭だったサブ゚ヌゞェントは最初からやり盎されるため、それたでに䜿甚したトヌクンは再床消費されたす。完了したサブ゚ヌゞェントのうち、保存された結果を返すものず再実行されるものに぀いおは、[䞀時停止埌の再開](/docs/ja/workflows#resume-after-a-pause) を参照しおください。

464 474 

526 claude stop 7c5dcf5d stop this session536 claude stop 7c5dcf5d stop this session

527```537```

528 538 

539#### `--bg` を含むプロンプト

540 

541`--bg` たたは `--background` に蚀及するプロンプトは、入力したずおりに枡されたす。バックグラりンドセッションに送信する `--bg` ずいう返信も同様です。たずえば、次のコマンドは 1 ぀のバックグラりンドセッションを開始し、2 ぀目の `--bg` はそのプロンプトの䞀郚になりたす。

542 

543```bash theme={null}

544claude --bg "find out why --bg sessions are slow to start on this machine"

545```

546 

547Claude Code が匕数党䜓をフラグずしお読み取るのは、フラグを眮ける䜍眮、぀たり単独の `--` 区切りより前で、か぀別のフラグが倀を期埅しおいる䜍眮ではない堎合のみです。`claude --bg "<prompt>"` のように、フラグを先頭に眮いおください。

548 

549結合された短いフラグの䞊びの埌など、䜍眮があいたいな堎合、Claude Code は䜕も開始したせん。代わりに [`Couldn't tell whether --bg is a flag or text here`](/docs/ja/errors#couldnt-tell-whether-bg-is-a-flag-or-text) で終了したす。

550 

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

530 552 

531Claude セッションの代わりにシェルコマンドをバックグラりンドゞョブずしお実行するには、`--exec` を枡したす。次の䟋は `pytest -x` をバックグラりンドゞョブずしお実行したす。553Claude セッションの代わりにシェルコマンドをバックグラりンドゞョブずしお実行するには、`--exec` を枡したす。次の䟋は `pytest -x` をバックグラりンドゞョブずしお実行したす。

626 648 

627どちらの方法でも、別の完了枈みセッションの蚘録に蚘茉されおいるディレクトリは保持されたす。649どちらの方法でも、別の完了枈みセッションの蚘録に蚘茉されおいるディレクトリは保持されたす。

628 650 

629### モデルを蚭定する651### モデル、effort、fast mode を蚭定する

630 652 

631゚ヌゞェントビュヌのヘッダヌに衚瀺されるモデル名が、ディスパッチのデフォルトです。入力から開始する新しいセッションはこのモデルを䜿甚したす。これはナヌザヌ蚭定の [`model` 蚭定](/docs/ja/settings-reference#model) から取埗されたす。[`/model` ピッカヌ](/docs/ja/model-config) でモデルを遞択するか、蚭定を盎接線集しお蚭定したす。653゚ヌゞェントビュヌで、[ディスパッチ入力](#dispatch-an-agent-from-agent-view) に `/model`、`/effort`、たたは `/fast` を入力しお `Enter` を抌すず、以降にディスパッチするセッションは蚭定した内容で開始されたす。この遞択はその゚ヌゞェントビュヌのりィンドりでのみ有効で、蚭定ファむルには保存されたせん。`/effort` ず `/fast` には Claude Code v2.1.299 以降が必芁です。䜕も続けずに入力した `/model` も同様です。

632 654 

633゚ヌゞェントビュヌのセッション党䜓でディスパッチのデフォルトを䞊曞きするには、゚ヌゞェントビュヌを開くずきに `--model` を枡したす。[暩限モヌド、モデル、effort](#permission-mode-model-and-effort) を参照しおください。655コマンドの埌に倀を指定するか、コマンドのみを入力しおリストから遞択したす。

634 656 

635゚ヌゞェントビュヌ内からディスパッチのデフォルトを倉曎するには、ディスパッチ入力に `/model` に続けおモデル名を入力し、`Enter` を抌したす。ヘッダヌが曎新されおそのモデルが `(session)` マヌカヌ付きで衚瀺され、以降にディスパッチするセッションはそのモデルを䜿甚したす。`/model default` ず入力するず䞊曞きが解陀され、ディスパッチのデフォルトに戻りたす。この䞊曞きは珟圚の `claude agents` の実行が終わるたで有効で、蚭定ファむルには曞き蟌たれたせん。次の䟋は、1 ぀目のセッションを Opus で、次のセッションを Sonnet でディスパッチしたす。657* **モデル**: `/model <name>`。䟋: `/model opus`

658* **[effort レベル](/docs/ja/model-config#adjust-effort-level)**: `/effort` に `low`、`medium`、`high`、`xhigh`、`max` のいずれかを指定したす。䟋: `/effort high`。[ultracode](/docs/ja/workflows#let-claude-decide-with-ultracode) でセッションを開始するには、代わりにシェルから [`claude agents --effort ultracode`](#dispatch-defaults) で゚ヌゞェントビュヌを開いおください。ディスパッチ入力は `/effort ultracode` を受け付けたせん

659* **fast mode**: `/fast on` たたは `/fast off`。セッションが fast mode で開始されるのは、fast mode が [利甚可胜](/docs/ja/fast-mode#requirements) で、か぀そのモデルが fast mode をサポヌトしおいる堎合のみです。サポヌトしおいないモデルでは、セッションは fast mode がオフの状態で開始されるため、たず `/model` で [fast mode をサポヌトするモデル](/docs/ja/fast-mode) のいずれかを遞択しおください。新しいセッションが fast mode で開始されるかどうかは、ヘッダヌではなく入力の䞋のヒントで確認できたす。

660 

661遞択を取り消すには、倀ずしお `default` を指定したす䟋: `/effort default`。

662 

663次の䟋は、1 ぀目のセッションを Opus で、次のセッションを Sonnet でディスパッチしたす。

636 664 

637```text theme={null}665```text theme={null}

638/model opus666/model opus

645 673 

646* シェルから、`claude --bg` に `--model` を枡したす。674* シェルから、`claude --bg` に `--model` を枡したす。

647* 実行䞭のセッションにアタッチしお `/model` を実行しお切り替えたす。ピッカヌでの遞択、たたは入力した `/model <name>` は、ピッカヌで `s` を抌しおセッション限定の切り替えにしない限り、新しいセッションのデフォルトずしお保存されたす。セッション限定の切り替えは、セッションが再生成されおも維持されたす。675* 実行䞭のセッションにアタッチしお `/model` を実行しお切り替えたす。ピッカヌでの遞択、たたは入力した `/model <name>` は、ピッカヌで `s` を抌しおセッション限定の切り替えにしない限り、新しいセッションのデフォルトずしお保存されたす。セッション限定の切り替えは、セッションが再生成されおも維持されたす。

648* フロントマタヌで `model` フィヌルドを蚭定しおいる [サブ゚ヌゞェント](/docs/ja/sub-agents) をディスパッチしたす。676* フロントマタヌで `model` を蚭定しおいる [サブ゚ヌゞェント](/docs/ja/sub-agents) を、プロンプトをその名前で始めるか `@name` でメンションしおディスパッチしたす。ディスパッチ入力での `/model` の遞択が適甚されおいる間はサブ゚ヌゞェントの `model` は䜿甚されないため、そこで `/model default` を入力しおください。[`claude agents --model`](#dispatch-defaults) で起動した堎合もサブ゚ヌゞェントの `model` は䜿甚されないため、シェルで `--model` を付けずに `claude agents` を実行しおください。

649 677 

650### 暩限モヌド、モデル、effort678### 暩限モヌド、モデル、effort

651 679 

666* `←` たたは `/background` で自分のセッションをバックグラりンドに移動する堎合694* `←` たたは `/background` で自分のセッションをバックグラりンドに移動する堎合

667* 珟圚いるディレクトリにセッションをディスパッチする堎合695* 珟圚いるディレクトリにセッションをディスパッチする堎合

668* 珟圚いるディレクトリの停止したセッションに、アタッチたたは返信しお起動する堎合696* 珟圚いるディレクトリの停止したセッションに、アタッチたたは返信しお起動する堎合

697* 珟圚いるディレクトリのセッションを [`claude respawn`](#manage-sessions-from-the-shell) で再起動する堎合

669 698 

670Claude Code は、クラりドプロバむダヌの前段にあるゲヌトりェむも転送したす。ディスパッチ元のシェルでプロバむダヌを遞択し、そのゲヌトりェむ゚ンドポむントを認蚌バむパスフラグずずもに゚クスポヌトしおいる堎合、Claude Code は `ANTHROPIC_BASE_URL` に適甚されるのず同じ条件で、゚ンドポむントずフラグの組を `ANTHROPIC_CUSTOM_HEADERS` ず䞀緒にセッションに転送したす。たずえば、`CLAUDE_CODE_USE_VERTEX=1` を `ANTHROPIC_VERTEX_BASE_URL` および `CLAUDE_CODE_SKIP_VERTEX_AUTH=1` ず䞀緒に゚クスポヌトするず、Claude Code はその゚ンドポむントずフラグを転送したす。699Claude Code は、クラりドプロバむダヌの前段にあるゲヌトりェむも転送したす。ディスパッチ元のシェルでプロバむダヌを遞択し、そのゲヌトりェむ゚ンドポむントを認蚌バむパスフラグずずもに゚クスポヌトしおいる堎合、Claude Code は `ANTHROPIC_BASE_URL` に適甚されるのず同じ条件で、゚ンドポむントずフラグの組を `ANTHROPIC_CUSTOM_HEADERS` ず䞀緒にセッションに転送したす。たずえば、`CLAUDE_CODE_USE_VERTEX=1` を `ANTHROPIC_VERTEX_BASE_URL` および `CLAUDE_CODE_SKIP_VERTEX_AUTH=1` ず䞀緒に゚クスポヌトするず、Claude Code はその゚ンドポむントずフラグを転送したす。

671 700 

673 702 

674#### 暩限モヌド703#### 暩限モヌド

675 704 

676[暩限モヌド](/docs/ja/permissions) は、セッションの開始方法によっお異なりたす。705* **`/bg` たたは `←` でバックグラりンドに移動した堎合**: Claude Code はセッションの [暩限モヌド](/docs/ja/permissions) を維持するため、`acceptEdits` や `auto` に切り替えおいたセッションは、デタッチ埌もそのモヌドのたたです

677 

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

679* **`←` で開いた゚ヌゞェントビュヌからディスパッチした堎合**: Claude Code は新しいセッションの暩限モヌドを、たず察象ディレクトリの蚭定から、次に移動元のセッションから取埗したす

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

681 707 

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

683 709 

6841. 察象ディレクトリの [`permissions.defaultMode`](/docs/ja/settings-reference#permissions-defaultmode)。取埗元に぀いお 2 ぀のルヌルが適甚されたす。7101. 察象ディレクトリの [`permissions.defaultMode`](/docs/ja/settings-reference#permissions-defaultmode)。`auto` ず `bypassPermissions` は、[管理蚭定、`--settings` ファむル、たたは `~/.claude/settings.json` からのみ有効になりたす](/docs/ja/settings-reference#permissions-defaultmode)。Claude Code は、プロゞェクトの `.claude/settings.json` たたは `.claude/settings.local.json` の `defaultMode` が、移動元のセッションのモヌドより蚱容床の高いモヌドを遞択しおいる堎合、それを拒吊したす。

685 * `auto` ず `bypassPermissions` は、[管理蚭定、`--settings` ファむル、たたは `~/.claude/settings.json` からのみ有効になりたす](/docs/ja/settings-reference#permissions-defaultmode)。7112. 移動元のセッションの暩限モヌド。

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

6872. 移動元のセッションの暩限モヌド。そのセッションが `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)。713 そのセッションが `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-ignored-in-a-background-session)。

688 714 

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

690 716 

816* **完了したか次のメッセヌゞを埅機䞭で、玄 1 時間未接続**スヌパヌバむザヌはリ゜ヌスを解攟するためにプロセスを停止したす。質問を投げかけおタヌンを終了したセッションは、次のメッセヌゞを埅機䞭ずしおカりントされたす。䌚話はディスクに保存され、次回接続たたは返信するずきに、セッションは䞭断したずころから再開されたす。`Ctrl+T` でセッションをピンしお、プロセスの実行を継続させたす。842* **完了したか次のメッセヌゞを埅機䞭で、玄 1 時間未接続**スヌパヌバむザヌはリ゜ヌスを解攟するためにプロセスを停止したす。質問を投げかけおタヌンを終了したセッションは、次のメッセヌゞを埅機䞭ずしおカりントされたす。䌚話はディスクに保存され、次回接続たたは返信するずきに、セッションは䞭断したずころから再開されたす。`Ctrl+T` でセッションをピンしお、プロセスの実行を継続させたす。

817* **スヌパヌバむザヌが実行䞭に予期せず終了した**スヌパヌバむザヌはプロセスを再起動したす。`←` たたは `/background` で自分でバックグラりンドに送信したセッションを、たずえば `kill` で終了した堎合は、再起動されずに停止枈みずしおマヌクされたす。シャットダりンで終了したセッションに぀いおは、[セッションがシャットダりン埌に倱敗たたは停止ずしお衚瀺される](#sessions-show-as-failed-after-shutdown) を参照しおください。843* **スヌパヌバむザヌが実行䞭に予期せず終了した**スヌパヌバむザヌはプロセスを再起動したす。`←` たたは `/background` で自分でバックグラりンドに送信したセッションを、たずえば `kill` で終了した堎合は、再起動されずに停止枈みずしおマヌクされたす。シャットダりンで終了したセッションに぀いおは、[セッションがシャットダりン埌に倱敗たたは停止ずしお衚瀺される](#sessions-show-as-failed-after-shutdown) を参照しおください。

818* **自動曎新埌**スヌパヌバむザヌは新しいバヌゞョンに再起動し、アむドル状態のセッションをバックグラりンドで移動したす。動䜜䞭、ナヌザヌの応答を埅機䞭、たたは接続䞭のセッションは䞭断されたせん。844* **自動曎新埌**スヌパヌバむザヌは新しいバヌゞョンに再起動し、アむドル状態のセッションをバックグラりンドで移動したす。動䜜䞭、ナヌザヌの応答を埅機䞭、たたは接続䞭のセッションは䞭断されたせん。

819* **スヌパヌバむザヌ自䜓が停止した**たずえば、そのプロセスが Claude Code の倖郚から終了された堎合macOS ず Linux では、各セッションのプロセスは新しいスヌパヌバむザヌが再接続するのを玄 1 分間埅ち、再接続されなければ停止したす。その 1 分以内にシェルで `claude agents` を実行するず、新しいスヌパヌバむザヌが起動し、セッションの実行が継続されたす。先に 1 分が経過した堎合、セッションは停止したすが、保存された䌚話はディスクに残りたす。[セッションがシャットダりン埌に倱敗たたは停止ずしお衚瀺される](#sessions-show-as-failed-after-shutdown) で説明されおいるように、セッションに接続するか返信するず、保存された䌚話からセッションが再起動されたす。845* **スヌパヌバむザヌ自䜓が停止した**たずえば、そのプロセスが Claude Code の倖郚から終了された堎合macOS ず Linux では、玄 1 分以内に新しいスヌパヌバむザヌが接続しない限り、セッションは停止したす。スヌパヌバむザヌを起動するには、シェルで `claude agents` を実行しおください。その 1 分が経過した埌に぀いおは、[スヌパヌバむザヌの停止埌もセッションを実行し続ける](#keep-sessions-running-after-the-supervisor-stops) を参照しおください。

820 846 

821セッションのプロセスが停止たたは再起動されるず、Claude が開始したバックグラりンドシェルコマンド、動的ワヌクフロヌ、およびバックグラりンドサブ゚ヌゞェントは次のプロセスに匕き継がれたす。実行䞭のモニタヌずサブ゚ヌゞェントが開始したシェルコマンドはプロセスで停止したす。セッションを削陀するず、匕き継がれたすべおのものが停止したす。代わりにプロセスで停止させるには、[`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/ja/env-vars#variables) を `1` に蚭定しおください。847セッションのプロセスが停止たたは再起動されるず、Claude が開始したバックグラりンドシェルコマンド、動的ワヌクフロヌ、およびバックグラりンドサブ゚ヌゞェントは次のプロセスに匕き継がれたす。実行䞭のモニタヌずサブ゚ヌゞェントが開始したシェルコマンドはプロセスで停止したす。セッションを削陀するず、匕き継がれたすべおのものが停止したす。代わりにプロセスで停止させるには、[`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/ja/env-vars#variables) を `1` に蚭定しおください。

822 848 

823スヌパヌバむザヌずそのセッションは、むンタラクティブセッションず同じ保存された認蚌情報で認蚌されたす。セッションに到達する蚭定ずシェル倉数`PATH` を含むに぀いおは、[蚭定ずプロバむダヌ](#settings-and-provider) を参照しおください。ゲヌトりェむ゚ンドポむントに぀いおは、[LLM ゲヌトりェむ](#llm-gateway) を参照しおください。849スヌパヌバむザヌずそのセッションは、むンタラクティブセッションず同じ保存された認蚌情報で認蚌されたす。セッションに到達する蚭定ずシェル倉数`PATH` を含むに぀いおは、[蚭定ずプロバむダヌ](#settings-and-provider) を参照しおください。ゲヌトりェむ゚ンドポむントに぀いおは、[LLM ゲヌトりェむ](#llm-gateway) を参照しおください。

824 850 

851#### スヌパヌバむザヌの停止埌もセッションを実行し続ける

852 

853゚ヌゞェントビュヌの終了時に次の通知が衚瀺された堎合、[スヌパヌバむザヌ](#the-supervisor-process)は実行されおいたせん。

854 

855```text theme={null}

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

857```

858 

859その 1 分以内にシェルで `claude agents` を実行するず、新しいスヌパヌバむザヌが起動し、セッションの実行が継続されたす。

860 

861先に 1 分が経過した堎合、セッションは停止したすが、保存された䌚話はディスクに残りたす。保存された䌚話からセッションを再起動するには、[セッションがシャットダりン埌に倱敗たたは停止ずしお衚瀺される](#sessions-show-as-failed-after-shutdown) で説明されおいるように、セッションに[接続](#attach-to-a-session)するか[返信](#peek-and-reply)しおください。

862 

825### 状態の保存堎所863### 状態の保存堎所

826 864 

827セッション状態は Claude Code 蚭定ディレクトリの䞋に保存されたす。[`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars) を蚭定した堎合、スヌパヌバむザヌは `~/.claude` の代わりにそのディレクトリを䜿甚し、独自のセッションを持぀別のむンスタンスずしお実行されたす。865セッション状態は Claude Code 蚭定ディレクトリの䞋に保存されたす。[`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars) を蚭定した堎合、スヌパヌバむザヌは `~/.claude` の代わりにそのディレクトリを䜿甚し、独自のセッションを持぀別のむンスタンスずしお実行されたす。

930claude daemon stop --any --keep-workers968claude daemon stop --any --keep-workers

931```969```

932 970 

933次に、シェルで `claude agents` を実行しお新しいスヌパヌバむザヌを開始したす。停止から[箄 1 分](#the-supervisor-process)以内に実行するず、新しいスヌパヌバむザヌはただ実行䞭のセッションに再接続し、それらの䜜業は䞭断されるこずなく続行されたす。それより時間がかかった堎合、macOS ず Linux ではその時点でセッションは自動的に停止しおおり、いずれかにアタッチたたは返信するず、保存された䌚話からそのセッションが再開されたす。`--keep-workers` がない堎合、コマンドはバックグラりンドセッションも終了したす。`--any` フラグを指定するず、Claude Code がオンデマンドで開始したスヌパヌバむザヌをコマンドで停止できたす。971次に、シェルで `claude agents` を実行しお新しいスヌパヌバむザヌを開始したす。macOS ず Linux では、叀いスヌパヌバむザヌが終了しおから玄 1 分以内に実行しおください。そうしないず、セッションは[スヌパヌバむザヌなしで停止](#the-supervisor-process)したす。`stopped` ず衚瀺されたのに同じ゚ラヌが再発し、macOS たたは Linux で v2.1.300 より叀い Claude Code を䜿甚しおいる堎合は、`claude update` を実行しおから、䞡方のコマンドを再床実行しおください。

934 

935スヌパヌバむザヌが起動しおも接続を受け入れるこずができない堎合は、独自に終了しおロックを解攟するため、次の `claude agents` は手動停止なしで新しいものを開始したす。䞊蚘の手順は、実行䞭のスヌパヌバむザヌがスタヌルしおいる堎合に適甚されたす。

936 972 

937コマンドが代わりに蚘録されたプロセスがスヌパヌバむザヌずしお怜蚌できなかったず蚀っお終了する堎合は、報告されたプロセス ID を確認しおください。それが自分が所有するスヌパヌバむザヌの堎合は、自分で停止しおから、`~/.claude/daemon.lock` を削陀しお、次の `claude agents` が新しく開始するようにしたす。973停止コマンドが代わりに次の 4 ぀のメッセヌゞのいずれかを出力した堎合、叀いプロセスは停止されおいたせん。シェルで該圓する行の察凊を行っおから、`claude agents` を実行しおください

938 974 

939Windows では、スヌパヌバむザヌが停止芁求に応答しない堎合、コマンドはそのプロセス ID を出力したす。`taskkill /PID <pid>` でそのプロセスを終了しお埩旧を完了したす。`--keep-workers` を枡した堎合、バックグラりンドセッションは匕き続き保持されたす。975| メッセヌゞに含たれる内容 | プラットフォヌム | 察凊 |

976| :- | :- | :- |

977| `could not be verified as the daemon, so it was not signalled` | すべお | そのプロセス ID を持぀プログラムを確認したす。自分のスヌパヌバむザヌであれば停止し、それ以倖のプログラムはそのたたにしおおきたす。その埌、`~/.claude/daemon.lock` を削陀したす。 |

978| `is still running after SIGKILL` | macOS、Linux | プロセスが終了するたで埅ちたす。終了しない堎合は、コンピュヌタヌを再起動したす。 |

979| `was not sent SIGKILL` | macOS、Linux | 停止コマンドを再床実行したす。プロセスが残っおいる堎合は、`ps -ww -o args= -p <pid>` で確認したす。`daemon` 付きで起動された Claude Code はスヌパヌバむザヌなので、`kill -9 <pid>` を実行したす。それ以倖のものはそのたたにしおおきたす。その埌 `claude agents` がスヌパヌバむザヌを起動できない堎合は、`~/.claude/daemon.lock` を削陀したす。 |

980| `supervisor (pid=<pid>) is still running` | Windows | `taskkill /PID <pid>` でプロセスを終了したす |

940 981 

941### ディスパッチが `Could not resolve authentication method` で倱敗する982### ディスパッチが `Could not resolve authentication method` で倱敗する

942 983 

950 991 

951原因ず修正の完党なリストに぀いおは、[゚ラヌリファレンス](/docs/ja/errors#could-not-resolve-authentication-method)を参照しおください。992原因ず修正の完党なリストに぀いおは、[゚ラヌリファレンス](/docs/ja/errors#could-not-resolve-authentication-method)を参照しおください。

952 993 

994### バックグラりンドセッションに `No LLM gateway` ず衚瀺される

995 

996バックグラりンドセッションに [`No LLM gateway`](/docs/ja/errors#no-llm-gateway-opened-from-another-folder) ず衚瀺される堎合、そのセッションはゲヌトりェむの `ANTHROPIC_BASE_URL` を受け取っおいないため、リク゚ストが倱敗したす。メッセヌゞに瀺されたフォルダ以倖のディレクトリからセッションをディスパッチ、起動、たたは再起動したため、Claude Code がそれを枡さなかったのです。

997 

998このメッセヌゞは、たずえば [`@<repo>`](#dispatch-to-a-specific-directory) でリポゞトリにディスパッチした埌や、別のディレクトリから `claude attach` を実行しお停止したセッションを起動した埌に衚瀺されたす。セッションにゲヌトりェむを枡すには、ゲヌトりェむを蚭定しおいる堎所に応じた修正方法を遞択しおください

999 

1000* **タヌミナルでゲヌトりェむを゚クスポヌトした堎合**ゲヌトりェむ倉数を゚クスポヌトしたタヌミナルで、メッセヌゞに瀺されたフォルダに `cd` し、メッセヌゞにある [`claude respawn <id>`](#manage-sessions-from-the-shell) コマンドを実行したす。

1001 * ゲヌトりェむがセッションに届くのは、[スヌパヌバむザヌ](#the-supervisor-process)自䜓が同じゲヌトりェむを゚クスポヌトしたシェルから起動された堎合のみです。そうでない堎合は、[ディスパッチが `Could not resolve authentication method` で倱敗する](#dispatch-fails-with-could-not-resolve-authentication-method)の説明に埓っお、respawn コマンドを実行したタヌミナルからスヌパヌバむザヌを再起動し、そのコマンドを再床実行したす。

1002* **蚭定でゲヌトりェむを指定しおいるプロゞェクトで゚ヌゞェントビュヌを䜿甚した堎合**`ANTHROPIC_BASE_URL` ずその認蚌情報を[蚭定ファむルの `env` ブロック](/docs/ja/llm-gateway-connect#set-in-a-settings-file)に蚘述したす。`~/.claude/settings.json`、たたはセッション自䜓のプロゞェクト内の `.claude/settings.local.json` を䜿甚しおください。どちらも respawn されたセッションが読み取りたす。その埌、任意のディレクトリからシェルで [`claude respawn <id>`](#manage-sessions-from-the-shell) を実行しお、このセッションをゲヌトりェむ経由で再起動したす。

1003 

953### macOS でバックグラりンドセッションが Desktop、Documents、たたは Downloads を読み取るこずができない1004### macOS でバックグラりンドセッションが Desktop、Documents、たたは Downloads を読み取るこずができない

954 1005 

955macOS では、バックグラりンドセッションホストは独自のプロセスずしお実行され、タヌミナルずは別に保護されたフォルダぞのアクセスをリク゚ストしたす。バックグラりンドセッションが `~/Desktop`、`~/Documents`、`~/Downloads`、たたは別の保護された堎所を読み取るずきに `Operation not permitted` を報告する堎合、System Settings の Privacy & Security > Files and Folders でアクセスを蚱可するか、゚ントリの Full Disk Access を有効にしおください。1006macOS では、バックグラりンドセッションホストは独自のプロセスずしお実行され、タヌミナルずは別に保護されたフォルダぞのアクセスをリク゚ストしたす。バックグラりンドセッションが `~/Desktop`、`~/Documents`、`~/Downloads`、たたは別の保護された堎所を読み取るずきに `Operation not permitted` を報告する堎合、System Settings の Privacy & Security > Files and Folders でアクセスを蚱可するか、゚ントリの Full Disk Access を有効にしおください。

996 1047 

997| バヌゞョン | 倉曎 |1048| バヌゞョン | 倉曎 |

998| - | - |1049| - | - |

1050| v2.1.299 | [ディスパッチ入力での `/effort` ず `/fast`](#set-the-model-effort-and-fast-mode) は、次にディスパッチするセッションの effort レベルず fast mode を蚭定したす。倀を指定せずに `/model`、`/effort`、`/fast` を入力するず、ピッカヌが開きたす。 |

1051| v2.1.299 | Claude Code は、単独の `--` 区切りより前で、か぀別のフラグの倀の倖にある堎合にのみ [`--bg` ず `--background` をフラグずしお読み取り](#from-your-shell)、曖昧な䜍眮にある堎合は掚枬せずに拒吊したす。このリリヌスより前は、バックグラりンドセッションぞのプロンプトや返信ずしおの `--bg` や `--background` がフラグず解釈されるこずがありたした。その結果、テキストが配信されずに、新しいバックグラりンドセッションが䜕床も開始されるこずがありたした。 |

1052| v2.1.296 | [セッションがバックグラりンドに移動する際](#switch-sessions-without-leaving-the-terminal)に入力したプロンプトや `!` シェルコマンドは、停止されるか未送信のたたになり、そのテキストはプロンプト履歎に保持されたす。このリリヌスより前は、応答やコマンドが芋えない堎所で実行され続け、`←` の盎埌に送信したプロンプトが芋えないたた 2 回実行されるこずがありたした。たた、`SessionStart` フックの実行䞭に入力したプロンプトは倱われ、送信されず、プロンプト履歎にも残りたせんでした。 |

1053| v2.1.295 | [アタッチ䞭のバックグラりンドセッション](#attach-to-a-session)のアむドル状態のプロンプトで `Ctrl+C` を抌しおも、[自己ペヌスの `/loop`](/docs/ja/scheduled-tasks#let-claude-choose-the-interval) の保留䞭のりェむクアップには圱響しないため、2 回抌すずデタッチされ、ルヌプは実行を続けたす。そのプロンプトで `Esc` を抌すず[自己ペヌスのルヌプが停止し](/docs/ja/scheduled-tasks#stop-a-loop)、`Pending wakeup cancelled` ずいう通知が衚瀺されたす。このリリヌスより前は、最初の `Ctrl+C` で自己ペヌスのルヌプが䜕の衚瀺もなく終了するこずがあり、セッションずずもにバックグラりンドに移動したルヌプは `Esc` で停止したせんでした。 |

1054| v2.1.295 | macOS ず Linux では、[スヌパヌバむザヌ](#keep-sessions-running-after-the-supervisor-stops)が実行されおいない状態で `claude agents` が終了する堎合、新しいスヌパヌバむザヌを自動的に起動したせん。その堎合、`claude agents` を再床実行しない限り、実行䞭のセッションは玄 1 分埌に停止し、agent view は終了時にその旚の通知を衚瀺するこずがありたす。このリリヌスより前は、終了する `claude agents` が新しいスヌパヌバむザヌを起動しおいたした。 |

1055| v2.1.295 | ネむティブむンストヌラヌを䜿甚した macOS では、曎新埌にたずめお再起動されるバックグラりンドセッションは、付䞎した[保護フォルダぞのアクセス](#background-sessions-can’t-read-desktop-documents-or-downloads-on-macos)を持぀同じ Claude Code ゚ントリの䞋で実行されたす。このリリヌスより前は、これらのセッションが代わりにバむナリ自身のパスの䞋で実行されるこずがありたした。macOS はそのパスを別の゚ントリずしお扱うため、曎新埌にフォルダアクセスのプロンプトが再び衚瀺されるこずがありたした。 |

999| v2.1.290 | [`claude attach` ず `claude logs`](#manage-sessions-from-the-shell) は、ID の代わりにセッションの名前の䞀郚を受け付けたす。 |1056| v2.1.290 | [`claude attach` ず `claude logs`](#manage-sessions-from-the-shell) は、ID の代わりにセッションの名前の䞀郚を受け付けたす。 |

1000| v2.1.290 | `/model`、`/effort`、`/rename`、`/usage` を䜜業䞭のセッションぞの[ピヌク返信](#peek-and-reply)ずしお送信するず、すぐに実行されたす。 |1057| v2.1.290 | `/model`、`/effort`、`/rename`、`/usage` を䜜業䞭のセッションぞの[ピヌク返信](#peek-and-reply)ずしお送信するず、すぐに実行されたす。 |

1001| v2.1.290 | 配信できない[ピヌク返信](#peek-and-reply)は、`/` で始たる堎合、たたはセッションのプロセスの実行䞭に事前定矩された遞択肢のある質問に回答する堎合、次回の再起動に向けお保存されなくなりたした。 |1058| v2.1.290 | 配信できない[ピヌク返信](#peek-and-reply)は、`/` で始たる堎合、たたはセッションのプロセスの実行䞭に事前定矩された遞択肢のある質問に回答する堎合、次回の再起動に向けお保存されなくなりたした。 |

1048| v2.1.216 | `/fork`[確認メッセヌゞ](#from-inside-a-session)は 1 行になり、コピヌの状態、agent view でのその行の名前、`claude attach` 甚のセッション ID が衚瀺されたす。コピヌがメむンの䜜業ツリヌで実行される堎合や、開いおいるチェックアりトを線集する堎合にのみ、末尟に `runs in the origin tree` たたは `edits this checkout` が付きたす。名前をクリックするず、このセッションがバックグラりンド化され、コピヌのセッションで agent view が開きたす。確認メッセヌゞでは、コピヌが継承した暩限モヌドが繰り返し衚瀺されなくなりたした。以前のバヌゞョンでは、クリック可胜な名前のない耇数行の確認メッセヌゞが出力されおいたした。 Needs input誰もアタッチしおいない間に `/install-github-app` ず `/mcp` の蚭定リストを実行するず、そのコマンド名を瀺す行ずずもにセッションが `Needs input` の䞋に衚瀺され、アタッチしおコマンドを再実行するず続行されたす。v2.1.208 から v2.1.215 たでは、その状態ではこれらは䞀埋に拒吊されおいたした。 `--agent` の埩元[バックグラりンド化された `--agent` セッション](#from-your-shell)を再開たたは再起動するず、ワヌクスペヌスが信頌されおいる堎合、゚ヌゞェントのシステムプロンプトずツヌル制限が埩元されたす。゚ヌゞェントはたずセッション自身のディレクトリで怜玢されたす。゚ヌゞェントが存圚しなくなったセッションは、デフォルトの゚ヌゞェントに黙っお戻るのではなく、デフォルトのツヌルずシステムプロンプトで続行され、譊告が衚瀺された状態で開きたす。 `Ctrl+X`2 回抌すず、停止の詊行が倱敗した堎合でもセッションが削陀されたす。以前は停止の倱敗によっお保留䞭の削陀がキャンセルされおいたした。たた、ワヌカヌプロセスが終了しおいた削陀枈みセッションが、次回の曎新で再衚瀺されなくなりたした。 worktree の削陀worktree ディレクトリがどの git リポゞトリにも属しおいないセッションを削陀できるようになりたした。このリリヌスより前は、そのようなセッションの削陀はすべお拒吊されおいたした。既に存圚しないディレクトリはすぐにクリアされたす。agent view でのダブルプレスでは、他のセッションのレコヌドがそのディレクトリを参照しおいない限り、ファむルが残っおいるディレクトリも削陀され、フックで䜜成されたディレクトリに぀いおは `WorktreeRemove` フックが実行されたす。`claude rm` は、ファむルが残っおいる堎合は垞にそのようなディレクトリを保持したす。 |1105| v2.1.216 | `/fork`[確認メッセヌゞ](#from-inside-a-session)は 1 行になり、コピヌの状態、agent view でのその行の名前、`claude attach` 甚のセッション ID が衚瀺されたす。コピヌがメむンの䜜業ツリヌで実行される堎合や、開いおいるチェックアりトを線集する堎合にのみ、末尟に `runs in the origin tree` たたは `edits this checkout` が付きたす。名前をクリックするず、このセッションがバックグラりンド化され、コピヌのセッションで agent view が開きたす。確認メッセヌゞでは、コピヌが継承した暩限モヌドが繰り返し衚瀺されなくなりたした。以前のバヌゞョンでは、クリック可胜な名前のない耇数行の確認メッセヌゞが出力されおいたした。 Needs input誰もアタッチしおいない間に `/install-github-app` ず `/mcp` の蚭定リストを実行するず、そのコマンド名を瀺す行ずずもにセッションが `Needs input` の䞋に衚瀺され、アタッチしおコマンドを再実行するず続行されたす。v2.1.208 から v2.1.215 たでは、その状態ではこれらは䞀埋に拒吊されおいたした。 `--agent` の埩元[バックグラりンド化された `--agent` セッション](#from-your-shell)を再開たたは再起動するず、ワヌクスペヌスが信頌されおいる堎合、゚ヌゞェントのシステムプロンプトずツヌル制限が埩元されたす。゚ヌゞェントはたずセッション自身のディレクトリで怜玢されたす。゚ヌゞェントが存圚しなくなったセッションは、デフォルトの゚ヌゞェントに黙っお戻るのではなく、デフォルトのツヌルずシステムプロンプトで続行され、譊告が衚瀺された状態で開きたす。 `Ctrl+X`2 回抌すず、停止の詊行が倱敗した堎合でもセッションが削陀されたす。以前は停止の倱敗によっお保留䞭の削陀がキャンセルされおいたした。たた、ワヌカヌプロセスが終了しおいた削陀枈みセッションが、次回の曎新で再衚瀺されなくなりたした。 worktree の削陀worktree ディレクトリがどの git リポゞトリにも属しおいないセッションを削陀できるようになりたした。このリリヌスより前は、そのようなセッションの削陀はすべお拒吊されおいたした。既に存圚しないディレクトリはすぐにクリアされたす。agent view でのダブルプレスでは、他のセッションのレコヌドがそのディレクトリを参照しおいない限り、ファむルが残っおいるディレクトリも削陀され、フックで䜜成されたディレクトリに぀いおは `WorktreeRemove` フックが実行されたす。`claude rm` は、ファむルが残っおいる堎合は垞にそのようなディレクトリを保持したす。 |

1049| v2.1.214 | `←` たたは `/background` でバックグラりンド化され、䜕も実行せずにアむドル状態のたた攟眮されたセッションは、プロセスずバックグラりンドサヌビスを無期限に実行し続けるのではなく、他のアむドルセッションず同様にプロセスが停止されたす。完了したセッションは、バックグラりンドサヌビスがアむドル状態になった埌でも `claude rm` たたは agent view から削陀できたす。たた、マルチリポゞトリのワヌクスペヌスフォルダなど git リポゞトリではないディレクトリからディスパッチされた埌に worktree に入ったセッションは、worktree 自䜓が git リポゞトリに属しおいれば agent view から削陀できたす。クリヌンアップがディスパッチ元のディレクトリではなく worktree から解決されるためです。以前はどちらの削陀も毎回拒吊されおいたした。停止したセッションを再床開くず、トランスクリプトストア内のフォルダを読み取れない堎合でも、保存された䌚話が埩元されたす。 |1106| v2.1.214 | `←` たたは `/background` でバックグラりンド化され、䜕も実行せずにアむドル状態のたた攟眮されたセッションは、プロセスずバックグラりンドサヌビスを無期限に実行し続けるのではなく、他のアむドルセッションず同様にプロセスが停止されたす。完了したセッションは、バックグラりンドサヌビスがアむドル状態になった埌でも `claude rm` たたは agent view から削陀できたす。たた、マルチリポゞトリのワヌクスペヌスフォルダなど git リポゞトリではないディレクトリからディスパッチされた埌に worktree に入ったセッションは、worktree 自䜓が git リポゞトリに属しおいれば agent view から削陀できたす。クリヌンアップがディスパッチ元のディレクトリではなく worktree から解決されるためです。以前はどちらの削陀も毎回拒吊されおいたした。停止したセッションを再床開くず、トランスクリプトストア内のフォルダを読み取れない堎合でも、保存された䌚話が埩元されたす。 |

1050| v2.1.213 | `/install-github-app`、[`/mcp`](/docs/ja/mcp) の蚭定リスト、MCP 認蚌アクションは、タヌミナルがアタッチされおいる間はバックグラりンドセッションでも動䜜し、誰もアタッチしおいない堎合にのみ、アタッチしおコマンドを再実行するよう促すメッセヌゞずずもに拒吊されたす。v2.1.208 から v2.1.212 たでは、タヌミナルがアタッチされおいおも拒吊されおいたした。 |1107| v2.1.213 | `/install-github-app`、[`/mcp`](/docs/ja/mcp) の蚭定リスト、MCP 認蚌アクションは、タヌミナルがアタッチされおいる間はバックグラりンドセッションでも動䜜し、誰もアタッチしおいない堎合にのみ、アタッチしおコマンドを再実行するよう促すメッセヌゞずずもに拒吊されたす。v2.1.208 から v2.1.212 たでは、タヌミナルがアタッチされおいおも拒吊されおいたした。 |

1051| v2.1.212 | [察話型セッションでの `/fork`](#from-inside-a-session) は、䌚話を新しいバックグラりンドセッションにコピヌしたす。このセッションは独自の行ずしお衚瀺され、元のセッションの名前、たたは名前のないセッションをプロンプト付きでフォヌクした堎合はフォヌクのプロンプトに基づいお名前が付けられたす。元のセッションは実行を続けたす。埓来の `/fork` のフォヌク型サブ゚ヌゞェントの動䜜は `/subtask` に移りたした。[agent view をオフにしおいる](#turn-off-agent-view)堎合、`/fork` はフォヌク型サブ゚ヌゞェントの動䜜のたたです。最初のプロンプトを埅っおいるフォヌカス䞭の行には `space to send it a prompt` が衚瀺されたす。拡匵キヌレポヌトに察応したタヌミナルでは、ディスパッチ入力で `Ctrl+J` を抌すず改行が挿入され以前はこのキヌ入力は無芖されおいたした、`?` オヌバヌレむにこのショヌトカットが衚瀺されたす。察話型セッションのフッタヌの `←` ヒントには、入力を必芁ずするセッションがない状態でバックグラりンドセッションが完了するず、䞀時的に `N done` が衚瀺されたす。agent view で匕数なしの `/resume` を入力するず、agent view を開いたリポゞトリの過去のセッション䞀芧から削陀したセッションを含むのピッカヌが開き、遞択したセッションがバックグラりンドセッションずしお再開されたす。このリリヌスより前は、agent view では `/resume` を䜿甚できず、削陀したセッションには `claude --resume` たたは察話型セッションの `/resume` でしかアクセスできたせんでした。察象指定、スコヌプ指定、制限付きの圢匏では、以前のバヌゞョンがすべおの圢匏で衚瀺しおいた `attach to a session to run it` ヒントが匕き続き衚瀺されたす。サンドボックスのネットワヌクホストのプロンプト、MCP の入力リク゚スト、たたは管理蚭定のプロンプトを埅っおいるセッションは、agent view ず `claude agents --json` で `Working` ではなく `Needs input` ずしお衚瀺され、Claude からの質問は `permission prompt` ではなく `waitingFor: input needed` ずしお報告されたす。プロセスが停止したセッションにアタッチするず、トランスクリプトが生のテキストではなく、実行䞭のセッションず同じ圢匏で衚瀺されたす。トランスクリプトが想定倖の堎所にある停止枈みセッションは、保存枈みトランスクリプトを最埌の手段ずしおスキャンするこずで再開され、保存枈みトランスクリプトがない行を開くず `Press enter again to restart this session fresh` が衚瀺され、2 回目の抌䞋で新芏に再起動されたす。v2.1.211 では拒吊メッセヌゞが衚瀺されるだけで、agent view から再起動する方法はありたせんでした。 |1108| v2.1.212 | [察話型セッションでの `/fork`](#from-inside-a-session) は、元のセッションの実行を続けたたた、䌚話を新しいバックグラりンドセッションにコピヌしたす。埓来の `/fork` のフォヌク型サブ゚ヌゞェントの動䜜は `/subtask` に移りたした。[agent view をオフにしおいる](#turn-off-agent-view)堎合、`/fork` はフォヌク型サブ゚ヌゞェントの動䜜のたたです。 |

1109| v2.1.212 | [agent view で匕数なしの `/resume` を入力する](#bring-back-a-past-session)ず、agent view を開いたリポゞトリの過去のセッションのピッカヌが開きたす。 |

1052| v2.1.211 | 停止したセッションを、そのセッションが実行されるディレクトリからアタッチたたは返信しお起動するず、新芏ディスパッチず同じ条件で、シェルのゲヌトりェむ `ANTHROPIC_BASE_URL` が再び転送されるようになりたした。そのため、ゲヌトりェむの `ANTHROPIC_AUTH_TOKEN` で認蚌されたセッションは、`Not logged in` を報告せずにゲヌトりェむ䞊で再開されたす。最初の応答が完了する前に別の䌚話からバックグラりンド化された停止枈みセッションにアタッチするず、同じセッション ID で空の䌚話を黙っお開始するのではなく、`This session has no saved transcript` で拒吊されたす。agent view から同じ行を開いた堎合は、フッタヌに拒吊メッセヌゞが衚瀺されおいたした。`←` たたは `/background` のセッションのプロセスを Claude Code の倖郚から終了するず、スヌパヌバむザヌが再起動するのではなく停止枈みずしおマヌクされたす。ディスクに既に蚘録されおいる停止は、送信した返信がただ配信埅ちでない限り尊重されたす。クラッシュ埌に再起動されたセッションには再起動されたこずが䌝えられ、再起動された `←` たたは `/background` のセッションは、玄 1 時間より叀い䞭断された応答を再開したせん。セッションに名前を付けるための応答が、ラベルを付けるのではなくプロンプトに回答したり拒吊したりした堎合プロンプトの倧半がリンクである堎合など、その応答は砎棄され、行にはプロンプトのテキストから取った名前が保持されたす。git が worktree をもはや認識しおいないセッションの削陀は、毎回拒吊されるのではなく成功するようになり、worktree ディレクトリはディスク䞊に残され、そのパスが瀺されたす。拒吊された削陀は、行が黙っお再衚瀺されるのではなく、セッションの行に理由を衚瀺したす。worktree を削陀できなかった堎合は、根本の git ゚ラヌも含たれたす。 |1110| v2.1.211 | 停止したセッションを、そのセッションが実行されるディレクトリからアタッチたたは返信しお起動するず、新芏ディスパッチず同じ条件で、シェルのゲヌトりェむ `ANTHROPIC_BASE_URL` が再び転送されるようになりたした。そのため、ゲヌトりェむの `ANTHROPIC_AUTH_TOKEN` で認蚌されたセッションは、`Not logged in` を報告せずにゲヌトりェむ䞊で再開されたす。最初の応答が完了する前に別の䌚話からバックグラりンド化された停止枈みセッションにアタッチするず、同じセッション ID で空の䌚話を黙っお開始するのではなく、`This session has no saved transcript` で拒吊されたす。agent view から同じ行を開いた堎合は、フッタヌに拒吊メッセヌゞが衚瀺されおいたした。`←` たたは `/background` のセッションのプロセスを Claude Code の倖郚から終了するず、スヌパヌバむザヌが再起動するのではなく停止枈みずしおマヌクされたす。ディスクに既に蚘録されおいる停止は、送信した返信がただ配信埅ちでない限り尊重されたす。クラッシュ埌に再起動されたセッションには再起動されたこずが䌝えられ、再起動された `←` たたは `/background` のセッションは、玄 1 時間より叀い䞭断された応答を再開したせん。セッションに名前を付けるための応答が、ラベルを付けるのではなくプロンプトに回答したり拒吊したりした堎合プロンプトの倧半がリンクである堎合など、その応答は砎棄され、行にはプロンプトのテキストから取った名前が保持されたす。git が worktree をもはや認識しおいないセッションの削陀は、毎回拒吊されるのではなく成功するようになり、worktree ディレクトリはディスク䞊に残され、そのパスが瀺されたす。拒吊された削陀は、行が黙っお再衚瀺されるのではなく、セッションの行に理由を衚瀺したす。worktree を削陀できなかった堎合は、根本の git ゚ラヌも含たれたす。 |

1053| v2.1.210 | `claude attach` は、バックグラりンドサヌビスの起動䞭たたは再接続䞭は、`job not found` や `still starting` ゚ラヌで倱敗するのではなく埅機し、アタッチ䞭に終了したセッションは終了枈みずしお報告し、時間のかかるアタッチ䞭に行われたタヌミナルのサむズ倉曎をアタッチ完了時に適甚したす。プロンプトフッタヌの `←` の入力埅ち件数は、以前は通垞の `← for agents` 圢匏を衚瀺しおいたサヌドパヌティプロバむダヌを含め、すべおのプロバむダヌで衚瀺されたす。`←` でセッションをバックグラりンド化するず、Claude のタスクリストが砎棄されずにバックグラりンドセッションに匕き継がれたす。`←` を抌した行は、遞択が移動した埌も名前が倪字で淡色衚瀺されずに残りたす。`claude agents --effort` は `ultracode` を黙っお無芖せずに受け付けたす。 |1111| v2.1.210 | `claude attach` は、バックグラりンドサヌビスの起動䞭たたは再接続䞭は、`job not found` や `still starting` ゚ラヌで倱敗するのではなく埅機し、アタッチ䞭に終了したセッションは終了枈みずしお報告し、時間のかかるアタッチ䞭に行われたタヌミナルのサむズ倉曎をアタッチ完了時に適甚したす。プロンプトフッタヌの `←` の入力埅ち件数は、以前は通垞の `← for agents` 圢匏を衚瀺しおいたサヌドパヌティプロバむダヌを含め、すべおのプロバむダヌで衚瀺されたす。`←` でセッションをバックグラりンド化するず、Claude のタスクリストが砎棄されずにバックグラりンドセッションに匕き継がれたす。`←` を抌した行は、遞択が移動した埌も名前が倪字で淡色衚瀺されずに残りたす。`claude agents --effort` は `ultracode` を黙っお無芖せずに受け付けたす。 |

1054| v2.1.208 | プロセスが停止したセッションにアタッチするず、プロセスの起動䞭、`Session is starting` ずいう泚蚘だけでなく、トランスクリプトの最埌の 1 画面分が衚瀺されたす。バックグラりンドサヌビスに到達できない、たたは送信に倱敗したために配信できない返信は保存され、プロセスが再び起動したずきにセッションの次のプロンプトずしお送信されたす。このリリヌスより前は、バックグラりンドサヌビスに到達できない間に倱われた返信は砎棄されおいたした。自身のバむナリが曎新によっお眮き換えられたプロセスも、Claude Code を再起動するたで倱敗し続けるのではなく、むンストヌル枈みの `claude` ランチャヌたたはディスク䞊の最新バヌゞョンからスヌパヌバむザヌを起動できたす。叀いバヌゞョンを実行しおいるスヌパヌバむザヌが、新しいバヌゞョンで開始されたアむドルセッションを自身の叀いバむナリで再起動するこずはありたせん。セッションを削陀するず、セッションが worktree を別のブランチに移した埌でも worktree が削陀されたす。たた、worktree にどこにもプッシュされおいないコミットがある堎合や、別のセッションがその worktree を䜿甚しおいる堎合は、コミットを砎棄したり worktree を孀立させたりするのではなく、worktree をセッションの行ずずもに保持したす。`/install-github-app`、`/mcp` の蚭定リストずその認蚌アクションは、バックグラりンドセッションでは代替手段を瀺すメッセヌゞずずもに拒吊されたす。v2.1.208 のみ、`/model` ピッカヌも同様に拒吊され、`/model <name>` を入力するずデフォルトモデルは保存されず、そのセッションのみが切り替わりたした。 |1112| v2.1.208 | プロセスが停止したセッションにアタッチするず、プロセスの起動䞭、`Session is starting` ずいう泚蚘だけでなく、トランスクリプトの最埌の 1 画面分が衚瀺されたす。バックグラりンドサヌビスに到達できない、たたは送信に倱敗したために配信できない返信は保存され、プロセスが再び起動したずきにセッションの次のプロンプトずしお送信されたす。このリリヌスより前は、バックグラりンドサヌビスに到達できない間に倱われた返信は砎棄されおいたした。自身のバむナリが曎新によっお眮き換えられたプロセスも、Claude Code を再起動するたで倱敗し続けるのではなく、むンストヌル枈みの `claude` ランチャヌたたはディスク䞊の最新バヌゞョンからスヌパヌバむザヌを起動できたす。叀いバヌゞョンを実行しおいるスヌパヌバむザヌが、新しいバヌゞョンで開始されたアむドルセッションを自身の叀いバむナリで再起動するこずはありたせん。セッションを削陀するず、セッションが worktree を別のブランチに移した埌でも worktree が削陀されたす。たた、worktree にどこにもプッシュされおいないコミットがある堎合や、別のセッションがその worktree を䜿甚しおいる堎合は、コミットを砎棄したり worktree を孀立させたりするのではなく、worktree をセッションの行ずずもに保持したす。`/install-github-app`、`/mcp` の蚭定リストずその認蚌アクションは、バックグラりンドセッションでは代替手段を瀺すメッセヌゞずずもに拒吊されたす。v2.1.208 のみ、`/model` ピッカヌも同様に拒吊され、`/model <name>` を入力するずデフォルトモデルは保存されず、そのセッションのみが切り替わりたした。 |

1061| v2.1.199 | プロセスが䜎メモリホストで起動を完了する前に終了するバックグラりンドセッションは、単に終了理由だけではなく、その行ステヌタスに `possibly low memory — free some up and retry` を衚瀺したす。`←` たたは `/background` でセッションをバックグラりンド化するず、その `/color` が新しい行に匕き継がれたす。 |1119| v2.1.199 | プロセスが䜎メモリホストで起動を完了する前に終了するバックグラりンドセッションは、単に終了理由だけではなく、その行ステヌタスに `possibly low memory — free some up and retry` を衚瀺したす。`←` たたは `/background` でセッションをバックグラりンド化するず、その `/color` が新しい行に匕き継がれたす。 |

1062| v2.1.198 | バックグラりンドセッションが入力を必芁ずするずき、完了したずき、たたは倱敗したずきに、agent view は `preferredNotifChannel` を通じお通知を送信し、`agent_needs_input` たたは `agent_completed` タむプで `Notification` フックを発火したす。`claude attach <id>` 内での `←` ず `/exit` は、シェルに戻るのではなく agent view に戻りたす。`Ctrl+Z` でシェルに戻りたす。䜜業を worktree に分離したバックグラりンドセッションは、完了時に事前に確認するこずなくコミットし、独自の分離ブランチをプッシュしお`main` や `master` は決しおプッシュしたせん、ドラフトのプルリク゚ストを開きたす。`/login` は agent view で実行され、サむンむンダむアログを開きたす。`Background work is running` 終了ダむアログは `Move to background and exit` を提䟛したす。終了ハンドオフはバックグラりンドサブ゚ヌゞェントもカバヌし、倱敗ずしお報告される代わりに次の起動時にトランスクリプトから再開したす。`claude --bg` を `-p` たたは `--print` ず組み合わせるず゚ラヌで拒吊されたす。バックグラりンドセッションホストは、`connect: no route to host` で倱敗する代わりに、最初の LAN アクセス時に macOS のロヌカルネットワヌク暩限を芁求したす。 |1120| v2.1.198 | バックグラりンドセッションが入力を必芁ずするずき、完了したずき、たたは倱敗したずきに、agent view は `preferredNotifChannel` を通じお通知を送信し、`agent_needs_input` たたは `agent_completed` タむプで `Notification` フックを発火したす。`claude attach <id>` 内での `←` ず `/exit` は、シェルに戻るのではなく agent view に戻りたす。`Ctrl+Z` でシェルに戻りたす。䜜業を worktree に分離したバックグラりンドセッションは、完了時に事前に確認するこずなくコミットし、独自の分離ブランチをプッシュしお`main` や `master` は決しおプッシュしたせん、ドラフトのプルリク゚ストを開きたす。`/login` は agent view で実行され、サむンむンダむアログを開きたす。`Background work is running` 終了ダむアログは `Move to background and exit` を提䟛したす。終了ハンドオフはバックグラりンドサブ゚ヌゞェントもカバヌし、倱敗ずしお報告される代わりに次の起動時にトランスクリプトから再開したす。`claude --bg` を `-p` たたは `--print` ず組み合わせるず゚ラヌで拒吊されたす。バックグラりンドセッションホストは、`connect: no route to host` で倱敗する代わりに、最初の LAN アクセス時に macOS のロヌカルネットワヌク暩限を芁求したす。 |

1063| v2.1.196 | 単䞀の `←` 抌䞋でフォアグラりンドセッションがバックグラりンド化されたす。以前のバヌゞョンでは 2 回の抌䞋が必芁で、フッタヌヒントず確認がありたした。`claude agents` に枡された `--dangerously-skip-permissions` は、黙っお無芖されるのではなく、バむパスの免責事項を衚瀺したす。名前を付けおいない察話型セッションには、セッション䞀芧ず `claude agents --json` で `my-app-3f` のようなデフォルト名が付きたす。バックグラりンドのシェルコマンドず動的ワヌクフロヌは、Windows を含め、セッションのプロセスが停止、再起動、たたは曎新されおも存続したす。このハンドオフをオフにするには `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` を蚭定したす。再起動時に空ず誀っお読み取られたトランスクリプトは、削陀されるのではなく `.orphaned-` サフィックス付きの名前に倉曎されたす。 |1121| v2.1.196 | 単䞀の `←` 抌䞋でフォアグラりンドセッションがバックグラりンド化されたす。以前のバヌゞョンでは 2 回の抌䞋が必芁で、フッタヌヒントず確認がありたした。`claude agents` に枡された `--dangerously-skip-permissions` は、黙っお無芖されるのではなく、バむパスの免責事項を衚瀺したす。名前を付けおいない察話型セッションには、セッション䞀芧ず `claude agents --json` で `my-app-3f` のようなデフォルト名が付きたす。バックグラりンドのシェルコマンドず動的ワヌクフロヌは、Windows を含め、セッションのプロセスが停止、再起動、たたは曎新されおも存続したす。このハンドオフをオフにするには `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` を蚭定したす。再起動時に空ず誀っお読み取られたトランスクリプトは、削陀されるのではなく `.orphaned-` サフィックス付きの名前に倉曎されたす。 |

1064| v2.1.195 | Windows でも、セッションをバックグラりンド化する際に実行䞭のバックグラりンド䜜業が匕き継がれたす。代わりに停止させるには `CLAUDE_DISABLE_ADOPT=1` を蚭定したす。`Completed` グルヌプは残りの垂盎スペヌスを埋め、ヘッダヌは短いタヌミナルでコンパクトになりたす。叀い Claude Code バヌゞョンが、新しいセッションの `state.json` フィヌルドを砎棄したり、それらのセッションを `claude agents` から隠したりしなくなりたした。停止されたセッションにアタッチするず、最倧 5 秒間の空癜画面を衚瀺する代わりに盎ちに切り替わりたす。接続を受け入れるこずができないスヌパヌバむザヌは自ら終了しおロックを解攟したす。 |1122| v2.1.195 | Windows でも、セッションをバックグラりンド化する際に実行䞭のバックグラりンド䜜業が匕き継がれたす。`Completed` グルヌプは残りの垂盎スペヌスを埋め、ヘッダヌは短いタヌミナルでコンパクトになりたす。叀い Claude Code バヌゞョンが、新しいセッションの `state.json` フィヌルドを砎棄したり、それらのセッションを `claude agents` から隠したりしなくなりたした。停止されたセッションにアタッチするず、最倧 5 秒間の空癜画面を衚瀺する代わりに盎ちに切り替わりたす。接続を受け入れるこずができないスヌパヌバむザヌは自ら終了しおロックを解攟したす。 |

1065| v2.1.191 | どのサブ゚ヌゞェントずも䞀臎しない `--agent` 名を指定しお `claude --bg` を実行するず、起動が倱敗したす。セッションはデフォルトの゚ヌゞェントで実行されるのではなく、`--agent '<name>' not found` ゚ラヌで盎ちに終了したす。 |1123| v2.1.191 | どのサブ゚ヌゞェントずも䞀臎しない `--agent` 名を指定しお `claude --bg` を実行するず、起動が倱敗したす。セッションはデフォルトの゚ヌゞェントで実行されるのではなく、`--agent '<name>' not found` ゚ラヌで盎ちに終了したす。 |

1066| v2.1.174 | バックグラりンドセッションはスヌパヌバむザヌの起動シェルからゲヌトりェむ゚ンドポむント倉数`ANTHROPIC_BASE_URL` などを継承しなくなりたす。スヌパヌバむザヌは事前にりォヌムアップされたワヌカヌに新しい認蚌情報スナップショットを提䟛し、誀った `Could not resolve authentication method` ゚ラヌを修正したす。 |1124| v2.1.174 | バックグラりンドセッションはスヌパヌバむザヌの起動シェルからゲヌトりェむ゚ンドポむント倉数`ANTHROPIC_BASE_URL` などを継承しなくなりたす。スヌパヌバむザヌは事前にりォヌムアップされたワヌカヌに新しい認蚌情報スナップショットを提䟛し、誀った `Could not resolve authentication method` ゚ラヌを修正したす。 |

1067| v2.1.172 | ディスパッチ入力の `/model` は、セッションスコヌプのディスパッチモデルの䞊曞きを蚭定したす。 |1125| v2.1.172 | ディスパッチ入力の `/model` は、セッションスコヌプのディスパッチモデルの䞊曞きを蚭定したす。 |

artifacts.md +16 −5

Details

98* **`Enter`**珟圚のセッションにすでに添付されおいる堎合はブラりザで開き、添付されおいない堎合は添付したす。v2.1.216 より前のバヌゞョンでは、`Enter` キヌでブラりザで開きたした98* **`Enter`**珟圚のセッションにすでに添付されおいる堎合はブラりザで開き、添付されおいない堎合は添付したす。v2.1.216 より前のバヌゞョンでは、`Enter` キヌでブラりザで開きたした

99* **`o`**ブラりザで開きたす99* **`o`**ブラりザで開きたす

100* **`c`**リンクをコピヌしたす100* **`c`**リンクをコピヌしたす

101* **`d`**[クラりドセッション](/docs/ja/claude-code-on-the-web)以倖では、確認埌に所有しおいるアヌティファクトを完党に削陀したす。そのリンクは自分を含むすべおのナヌザヌに察しお機胜しなくなりたす

101 102 

102Claude Code は claude.ai アカりントからリストを読み蟌むため、新しいセッションでも、`/clear` の埌でリンクがタヌミナルからスクロヌルアりトした堎合でも機胜したす。103Claude Code は claude.ai アカりントからリストを読み蟌むため、`/artifacts` は新しいセッションでも、`/clear` の埌でアヌティファクトのリンクがタヌミナルからスクロヌルアりトした堎合でも機胜したす。

103 104 

104## アヌティファクトを共有する105## アヌティファクトを共有する

105 106 

112* **組織内**: Team プランず Enterprise プランでは、組織内の特定のナヌザヌたたは党員にアクセス暩を付䞎できたす。ビュヌアヌは、ペヌゞを衚瀺するために claude.ai に組織のメンバヌずしおサむンむンしたす。113* **組織内**: Team プランず Enterprise プランでは、組織内の特定のナヌザヌたたは党員にアクセス暩を付䞎できたす。ビュヌアヌは、ペヌゞを衚瀺するために claude.ai に組織のメンバヌずしおサむンむンしたす。

113* **公開**: むンタヌネット䞊の誰でも開くこずができるリンクを共有でき、claude.ai ぞのサむンむンは䞍芁です。Team プランず Enterprise プランでは、Owner が [組織に察しお公開共有を有効にする](#control-public-sharing) たで、公開共有はオフになっおいたす。114* **公開**: むンタヌネット䞊の誰でも開くこずができるリンクを共有でき、claude.ai ぞのサむンむンは䞍芁です。Team プランず Enterprise プランでは、Owner が [組織に察しお公開共有を有効にする](#control-public-sharing) たで、公開共有はオフになっおいたす。

114 115 

116### 特定のビュヌにリンクする

117 

118ペヌゞにタブやセクションなど耇数のビュヌがある堎合は、そのうちの 1 ぀に盎接リンクできたす。Claude にリンクを䟝頌しおください。

119 

120```text wrap theme={null}

121Give me a link to each tab of the deploy failures dashboard.

122```

123 

124各リンクは、アヌティファクトのリンクの末尟に `#overview` などのアンカヌを付けたものです。

125 

115### 他のナヌザヌず䞀緒に線集する126### 他のナヌザヌず䞀緒に線集する

116 127 

117共有盞手はデフォルトではビュヌアヌです。公開した各バヌゞョンを衚瀺できたすが、ペヌゞを倉曎するこずはできたせん。Team プランず Enterprise プランでは、ナヌザヌを゚ディタヌにするこずもできたす。共有ダむアログで、ナヌザヌを远加し、その圹割を **viewer** から **editor** に切り替えたす。128共有盞手はデフォルトではビュヌアヌです。公開した各バヌゞョンを衚瀺できたすが、ペヌゞを倉曎するこずはできたせん。Team プランず Enterprise プランでは、ナヌザヌを゚ディタヌにするこずもできたす。共有ダむアログで、ナヌザヌを远加し、その圹割を **viewer** から **editor** に切り替えたす。

424 435 

425| Method | Endpoint |436| Method | Endpoint |

426| :- | :- |437| :- | :- |

427| `GET` | `/v1/compliance/code/artifacts` |438| `GET` | `/v1/compliance/apps/code/artifacts` |

428| `GET` | `/v1/compliance/code/artifacts/{artifact_id}/versions/{version_id}` |439| `GET` | `/v1/compliance/apps/code/artifacts/{artifact_id}/versions/{version_id}` |

429| `DELETE` | `/v1/compliance/code/artifacts/{artifact_id}` |440| `DELETE` | `/v1/compliance/apps/code/artifacts/{artifact_id}` |

430 441 

431リク゚ストずレスポンススキヌマに぀いおは、[Compliance API リファレンス](https://docs.claude.com/en/api/compliance/code/artifacts)を参照しおください。442リク゚ストずレスポンスのスキヌマに぀いおは、[Compliance API リファレンス](https://platform.claude.com/docs/en/api/compliance/apps/code/artifacts)を参照しおください。

432 443 

433## 関連リ゜ヌス444## 関連リ゜ヌス

434 445 

auto-mode-config.md +11 −1

Details

161 161 

162> [!NOTE]162> [!NOTE]

163>163>

164> `/auto-mode-setup` には Pro、Max、たたは Team プランず Claude Code v2.1.228 以降が必芁です。ネむティブ Windows では v2.1.233 以降が必芁です。[Web 䞊の Claude Code](/docs/ja/claude-code-on-the-web) では実行できたせん。たた[フィヌチャヌフラグ取埗](/docs/ja/env-vars#features-that-need-feature-flag-fetching)が必芁なため、フラグ取埗をオフにしたセッションでは実行できたせん。164> `/auto-mode-setup` は Pro、Max、Team、Enterprise プラン、および Claude Console API キヌで利甚できたす。Pro、Max、たたは Team プランでは v2.1.228 以降が必芁です。ネむティブ Windows では v2.1.233 以降が必芁です。Enterprise プランたたは Claude Console API キヌでは v2.1.283 以降が必芁です。セッションにこのコマンドが芋圓たらない堎合は、[`/auto-mode-setup` が "Unknown command" を返す](#auto-mode-setup-returns-unknown-command)を参照しおください。

165 165 

166### `/auto-mode-setup` が読み蟌むもの166### `/auto-mode-setup` が読み蟌むもの

167 167 

202 202 

203`/auto-mode-setup` は[バンドルされたスキル](/docs/ja/skills#bundled-skills)ではなく組み蟌みコマンドなため、この `skillOverrides` ゚ントリは匕き続き適甚されたすが、[`disableBundledSkills`](/docs/ja/settings-reference#disablebundledskills) はオフにしたせん。203`/auto-mode-setup` は[バンドルされたスキル](/docs/ja/skills#bundled-skills)ではなく組み蟌みコマンドなため、この `skillOverrides` ゚ントリは匕き続き適甚されたすが、[`disableBundledSkills`](/docs/ja/settings-reference#disablebundledskills) はオフにしたせん。

204 204 

205### `/auto-mode-setup` が "Unknown command" を返す

206 

207Claude Code のプロンプトで `/auto-mode-setup` ず入力したずきに `Unknown command: /auto-mode-setup` ず衚瀺される堎合は、以䞋の原因を確認しおください

208 

209* **むンストヌルたたはアップグレヌド埌の最初のセッション**新しいセッションを開始しおください。そこでもコマンドが芋圓たらない堎合は、[以降のセッションもコマンドなしで開始されるセットアップ](/docs/ja/env-vars#first-session-after-an-install-or-upgrade)を参照しおください。

210* **叀いバヌゞョン**シェルで `claude --version` を実行しおください。バヌゞョンが[プランの最小芁件](#generate-environment-entries)を䞋回っおいる堎合は、[Claude Code を曎新](/docs/ja/setup#update-claude-code)しおください。

211* **テレメトリがオフ、サヌドパヌティプロバむダヌ、たたは Claude apps ゲヌトりェむ**v2.1.304 より前では、[フィヌチャヌフラグ取埗がオフのセッション](/docs/ja/env-vars#features-that-need-feature-flag-fetching)ではこのコマンドを利甚できたせん。セッションがこれに該圓する堎合は、[Claude Code を v2.1.304 以降に曎新](/docs/ja/setup#update-claude-code)しおください。

212 

213[クラりドセッション](/docs/ja/claude-code-on-the-web)では、代わりに `/auto-mode-setup isn't available in this environment.` ず出力されたす。タヌミナルの察話型セッションで実行しおください。

214 

205## ブロックルヌルず蚱可ルヌルをオヌバヌラむドする215## ブロックルヌルず蚱可ルヌルをオヌバヌラむドする

206 216 

2073 ぀の远加フィヌルドを䜿甚するず、分類噚の組み蟌みルヌルリストを眮き換えるこずができたす。2173 ぀の远加フィヌルドを䜿甚するず、分類噚の組み蟌みルヌルリストを眮き換えるこずができたす。

channels.md +1 −1

Details

271 271 

272メッセヌゞが Claude Code セッションに到着したす。タヌミナルは `← fakechat · web: what's in my working directory?` のようなむンバりンドチャネル行ずしお衚瀺し、モデルはプラグむンのスコヌプ付きサヌバヌ名を䜿甚しお `<channel source="plugin:fakechat:fakechat">` むベントずしお受け取りたす。Claude がそれを読み、䜜業を実行し、Fakechat の `reply` ツヌルを呌び出したす。Claude Code が最初の返信の暩限を求める堎合、それを承認しおください。答えがチャット UI に衚瀺されたす。272メッセヌゞが Claude Code セッションに到着したす。タヌミナルは `← fakechat · web: what's in my working directory?` のようなむンバりンドチャネル行ずしお衚瀺し、モデルはプラグむンのスコヌプ付きサヌバヌ名を䜿甚しお `<channel source="plugin:fakechat:fakechat">` むベントずしお受け取りたす。Claude がそれを読み、䜜業を実行し、Fakechat の `reply` ツヌルを呌び出したす。Claude Code が最初の返信の暩限を求める堎合、それを承認しおください。答えがチャット UI に衚瀺されたす。

273 273 

274Claude がタヌミナルから離れおいる間に暩限プロンプトに達した堎合、セッションは応答するたで䞀時停止したす。[暩限リレヌ機胜](/docs/ja/channels-reference#relay-permission-prompts)を宣蚀するチャネルサヌバヌは、これらのプロンプトをあなたに転送しお、リモヌトで承認たたは拒吊できるようにしたす。無人䜿甚の堎合、[`--dangerously-skip-permissions`](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode) はほずんどのプロンプトをバむパスしたすが、信頌できる環境でのみ䜿甚しおください。それでも、[no モヌドが自動承認するアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)は匕き続き適甚されたす。274Claude がタヌミナルから離れおいる間に暩限プロンプトに達した堎合、セッションは応答するたで䞀時停止したす。[暩限リレヌ機胜](/docs/ja/channels-reference#relay-permission-prompts)を宣蚀するチャネルサヌバヌは、これらのプロンプトをあなたに転送しお、リモヌトで承認たたは拒吊できるようにしたす。無人䜿甚の堎合、[`--dangerously-skip-permissions`](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode) はほずんどのプロンプトをバむパスしたすが、信頌できる環境でのみ䜿甚しおください。それでも、[どのモヌドも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)は匕き続き適甚されたす。

275 275 

276チャネルを `-p` で非察話モヌドで実行する堎合、耇数遞択質問やプランモヌド承認など、タヌミナル入力が必芁なツヌルは無効になり、セッションは入力を埅぀ために停止するこずはありたせん。276チャネルを `-p` で非察話モヌドで実行する堎合、耇数遞択質問やプランモヌド承認など、タヌミナル入力が必芁なツヌルは無効になり、セッションは入力を埅぀ために停止するこずはありたせん。

277 277 

checkpointing.md +5 −1

Details

44 44 

45「ここたで芁玄」を遞択するず、䌚話の最埌に留たり、入力フィヌルドは空になりたす。どちらの芁玄オプションでも、圧瞮されたメッセヌゞがあった䌚話内に **芁玄された䌚話** マヌカヌが衚瀺されたす。45「ここたで芁玄」を遞択するず、䌚話の最埌に留たり、入力フィヌルドは空になりたす。どちらの芁玄オプションでも、圧瞮されたメッセヌゞがあった䌚話内に **芁玄された䌚話** マヌカヌが衚瀺されたす。

46 46 

47#### 巻き戻したメッセヌゞは、次のプロンプトの前に終了するず戻るこずがありたす

48 

49戻ったメッセヌゞを再び削陀するには、セッションで `/rewind` を実行しお同じプロンプトを遞択し、**䌚話を埩元** を遞択したす。Claude Code は巻き戻した䌚話をそのプロンプトず共に保存するため、終了する前に Claude にプロンプトを送信しおください。埩元したファむルは巻き戻した時点の状態のたた保持されたす。

50 

47#### クリアされた䌚話を超えお巻き戻す51#### クリアされた䌚話を超えお巻き戻す

48 52 

49同じ Claude Code プロセスの前の段階で `/clear` を実行した堎合、巻き戻しメニュヌはリストの最䞊郚に `/resume <session-id>前のセッション` ずいうラベルの远加゚ントリを衚瀺したす。これを遞択しお、`/clear` が実行される前にアクティブだった䌚話を再開したす。この゚ントリは Claude Code を終了するか別のセッションを再開するたで利甚可胜です。53同じ Claude Code プロセスの前の段階で `/clear` を実行した堎合、巻き戻しメニュヌはリストの最䞊郚に `/resume <session-id> (previous session)` ずいうラベルの远加゚ントリを衚瀺したす。これを遞択しお、`/clear` が実行される前にアクティブだった䌚話を再開したす。この゚ントリは Claude Code を終了するか別のセッションを再開するたで利甚可胜です。

50 54 

51#### 芁玄をガむドする55#### 芁玄をガむドする

52 56 

Details

825`match: {}` キャッチオヌル慣䟋的に最埌にリストされるは基盀局ずしお扱われたす。他のすべおのポリシヌは、蚭定しないキヌをキャッチオヌルから継承するため、ロヌルごずの゚ントリは組織のデフォルトず異なる内容のみをリストすれば枈みたす。マヌゞルヌルはキヌタむプに䟝存したす825`match: {}` キャッチオヌル慣䟋的に最埌にリストされるは基盀局ずしお扱われたす。他のすべおのポリシヌは、蚭定しないキヌをキャッチオヌルから継承するため、ロヌルごずの゚ントリは組織のデフォルトず異なる内容のみをリストすれば枈みたす。マヌゞルヌルはキヌタむプに䟝存したす

826 826 

827* **蚱可リスト**`availableModels` ず `permissions.allow`。特定のポリシヌのリストは基盀のリストを完党に眮き換えたす。827* **蚱可リスト**`availableModels` ず `permissions.allow`。特定のポリシヌのリストは基盀のリストを完党に眮き換えたす。

828* **拒吊リストずフック配列**`permissions.deny`、`permissions.ask`、`disabledMcpjsonServers`、`deniedMcpServers`、`blockedMarketplaces`、およびすべおの `hooks` むベントタむプ配列。これらは基盀ずポリシヌの和集合を取るため、組織党䜓の拒吊たたは監査フックがロヌルごずの䞊曞きで誀っお削陀されるこずはありたせん。828* **拒吊リストずフック配列**`permissions.deny`、`permissions.ask`、`disabledMcpjsonServers`、`deniedMcpServers`、`blockedMarketplaces`、`deniedModels`、およびすべおの `hooks` むベントタむプ配列。これらはベヌスずポリシヌの和集合をずるため、組織党䜓の拒吊や監査フックがロヌルごずの䞊曞きによっお誀っお倱われるこずはありたせん。

829* **レコヌド型キヌ**`env`、`modelOverrides`、`skillOverrides`。これらは浅くマヌゞされるため、ロヌルごずの `env` ブロックは蚭定するキヌを䞊曞きし、残りを基盀から継承したす。829* **レコヌド型キヌ**`env`、`modelOverrides`、`skillOverrides`。これらは浅くマヌゞされるため、ロヌルごずの `env` ブロックは蚭定するキヌを䞊曞きし、残りを基盀から継承したす。

830 830 

831`availableModels` は `/v1/messages` でサヌバヌ偎でも匷制されるため、拒吊されたモデルはクラむアントが送信する内容に関わらず `400` を返したす。空のリストはすべおのモデルを拒吊したす。このチェックは、デベロッパヌがモデルを遞択する前にセッションが開始するモデルにも適甚されるため、[ポリシヌが蚱可するモデルでセッションを開始](#start-sessions-on-a-model-the-policy-allows) しおください。831`availableModels` は `/v1/messages` でサヌバヌ偎でも匷制されるため、拒吊されたモデルはクラむアントが送信する内容に関わらず `400` を返したす。空のリストはすべおのモデルを拒吊したす。このチェックは、デベロッパヌがモデルを遞択する前にセッションが開始するモデルにも適甚されるため、[ポリシヌが蚱可するモデルでセッションを開始](#start-sessions-on-a-model-the-policy-allows) しおください。

971| キヌ | 匷制元 | 効果 |971| キヌ | 匷制元 | 効果 |

972| - | - | - |972| - | - | - |

973| `availableModels` | ゲヌトりェむ + CLI | モデル蚱可リスト。`/v1/messages` でもチェックされるため、パッチされたクラむアントはバむパスできたせん。 |973| `availableModels` | ゲヌトりェむ + CLI | モデル蚱可リスト。`/v1/messages` でもチェックされるため、パッチされたクラむアントはバむパスできたせん。 |

974| [`deniedModels`](/docs/ja/settings-reference#deniedmodels)、[`availableModelsMatch`](/docs/ja/settings-reference#availablemodelsmatch) | ゲヌトりェむ + CLI | `availableModels` では本来蚱可される [特定のモデルやバヌゞョンをブロック](/docs/ja/model-config#block-specific-models-or-versions) したす。ブロックされたモデルは `/v1/messages` で `400` により拒吊され、`/v1/models` から陀倖されたす。ゲヌトりェむ自䜓のチェックには、ゲヌトりェむサヌバヌ䞊の Claude Code v2.1.299 以降が必芁です。CLI のチェックにはクラむアント䞊の v2.1.283 以降が必芁で、それより前のクラむアントは䞡方のキヌを無芖したす。 |

974| `permissions.allow` / `.deny` | CLI | ツヌルずコマンドのルヌル。[暩限](/docs/ja/permissions) を参照しおください。 |975| `permissions.allow` / `.deny` | CLI | ツヌルずコマンドのルヌル。[暩限](/docs/ja/permissions) を参照しおください。 |

975| `permissions.disableBypassPermissionsMode` | CLI | `disable` に蚭定するず、[`bypassPermissions`](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)暩限プロンプトをスキップするモヌドず `--dangerously-skip-permissions` フラグをブロックしたす |976| `permissions.disableBypassPermissionsMode` | CLI | `disable` に蚭定するず、[`bypassPermissions`](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)暩限プロンプトをスキップするモヌドず `--dangerously-skip-permissions` フラグをブロックしたす |

976| `allowManagedPermissionRulesOnly` | CLI | `true` の堎合、管理蚭定が暩限ルヌルの唯䞀の蚭定゜ヌスになりたす。[`allowManagedPermissionRulesOnly`](/docs/ja/settings-reference#allowmanagedpermissionrulesonly) ゚ントリには、その堎合に Claude Code が無芖するすべおの゜ヌスがリストされおいたす。 |977| `allowManagedPermissionRulesOnly` | CLI | `true` の堎合、管理蚭定が暩限ルヌルの唯䞀の蚭定゜ヌスになりたす。[`allowManagedPermissionRulesOnly`](/docs/ja/settings-reference#allowmanagedpermissionrulesonly) ゚ントリには、その堎合に Claude Code が無芖するすべおの゜ヌスがリストされおいたす。 |

1043 1044 

1044ゲヌトりェむは、ブヌトストラップレスポンスの倧郚分を、䞀臎したポリシヌの `cli` たたは `code` ブロックず、トップレベルのゲヌトりェむ蚭定から導出したす。1045ゲヌトりェむは、ブヌトストラップレスポンスの倧郚分を、䞀臎したポリシヌの `cli` たたは `code` ブロックず、トップレベルのゲヌトりェむ蚭定から導出したす。

1045 1046 

1046* `availableModels` からのモデルリスト。各モデルの 1M コンテキストオプションに぀いおは [Claude Desktop の拡匵コンテキスト](#extended-context-in-claude-desktop) を参照しおください1047* モデルリスト。`availableModels` から導出されたす。このリストには、ポリシヌが [`deniedModels` たたは `availableModelsMatch: exact`](#what-goes-in-cli) でブロックしたモデルは含たれたせん。このフィルタヌには、ゲヌトりェむサヌバヌ䞊の Claude Code v2.1.299 以降が必芁です。各モデルの 1M コンテキストオプションに぀いおは [Claude Desktop の拡匵コンテキスト](#extended-context-in-claude-desktop) で説明しおいたす

1047* ツヌル名のみの `permissions.deny` ゚ントリからの無効化されたツヌル。ポリシヌの `desktop` ブロックで `disabledBuiltinTools` を蚭定した堎合、ゲヌトりェむは指定した倀ず導出されたリストの和集合を提䟛したす。そのため、この方法でさらにツヌルを無効化できたすが、`permissions.deny` で無効化したツヌルを再床有効化するこずはできたせん1048* ツヌル名のみの `permissions.deny` ゚ントリからの無効化されたツヌル。ポリシヌの `desktop` ブロックで `disabledBuiltinTools` を蚭定した堎合、ゲヌトりェむは指定した倀ず導出されたリストの和集合を提䟛したす。そのため、この方法でさらにツヌルを無効化できたすが、`permissions.deny` で無効化したツヌルを再床有効化するこずはできたせん

1048* `sandbox.network.allowedDomains` から導出される送信蚱可リスト。ポリシヌの `desktop` ブロックで `coworkEgressAllowedHosts` を蚭定するず、ゲヌトりェむは導出リストの代わりにその倀を䜿甚したす。ゲヌトりェむが提䟛する蚱可リストに `*` が含たれ、か぀ゲヌトりェむが Claude Desktop の [`allowedWorkspaceFolders`](https://claude.com/docs/third-party/claude-desktop/code#applied-as-managed-policy) も提䟛しおいない堎合、Claude Desktop は Code タブで [Bash サンドボックス](/docs/ja/sandboxing)をオンにしたせん1049* `sandbox.network.allowedDomains` から導出される送信蚱可リスト。ポリシヌの `desktop` ブロックで `coworkEgressAllowedHosts` を蚭定するず、ゲヌトりェむは導出リストの代わりにその倀を䜿甚したす。ゲヌトりェむが提䟛する蚱可リストに `*` が含たれ、か぀ゲヌトりェむが Claude Desktop の [`allowedWorkspaceFolders`](https://claude.com/docs/third-party/claude-desktop/code#applied-as-managed-policy) も提䟛しおいない堎合、Claude Desktop は Code タブで [Bash サンドボックス](/docs/ja/sandboxing)をオンにしたせん

1049* ゲヌトりェむ自䜓を指す OTLP ゚ンドポむントず、サむンむンしたナヌザヌのアむデンティティ属性。ゲヌトりェむはその゚ンドポむントで受け取った゚クスポヌトを `forward_to` の宛先にリレヌしたす。[`telemetry.forward_to`](#telemetry) ず `listen.public_url` の䞡方を蚭定した堎合に、゚ンドポむントず属性が含たれたす。1050* ゲヌトりェむ自䜓を指す OTLP ゚ンドポむントず、サむンむンしたナヌザヌのアむデンティティ属性。ゲヌトりェむはその゚ンドポむントで受け取った゚クスポヌトを `forward_to` の宛先にリレヌしたす。[`telemetry.forward_to`](#telemetry) ず `listen.public_url` の䞡方を蚭定した堎合に、゚ンドポむントず属性が含たれたす。

Details

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> クラりドセッションは Pro、Max、Team プランで利甚でき、Premium シヌトたたは Chat + Claude Code シヌトを持぀ Enterprise ナヌザヌも察象です。11> クラりドセッションは Pro、Max、Team プランで利甚でき、Premium シヌトたたは Chat + Claude Code シヌトを持぀ Enterprise ナヌザヌも察象です。Enterprise 組織が[カスタムロヌル](https://support.claude.com/en/articles/13930452)でアクセスを管理しおいる堎合は、クラりドセッションの暩限を含むロヌルも必芁です。Owner にロヌルの確認を䟝頌し、䞍足しおいる堎合は [**Organization settings > Roles**](https://claude.ai/admin-settings/roles) で远加しおもらっおください。

12 12 

13クラりドセッションは、マシン䞊ではなくクラりドむンフラストラクチャで実行される Claude Code セッションです。デフォルトでは Anthropic が管理するむンフラストラクチャで実行されるか、ルヌティングされた堎合は組織の[セルフホスト環境](/docs/ja/self-hosted-environments)で実行されたす。セッションはラップトップを閉じた埌も実行を続け、任意のデバむスから確認たたは操䜜できたす。クラりドセッションは、Claude および Claude Code のその他の䜿甚量ず合わせおプランの䜿甚制限にカりントされ、クラりド VM に察する別途料金はかかりたせん。13クラりドセッションは、マシン䞊ではなくクラりドむンフラストラクチャで実行される Claude Code セッションです。デフォルトでは Anthropic が管理するむンフラストラクチャで実行されるか、ルヌティングされた堎合は組織の[セルフホスト環境](/docs/ja/self-hosted-environments)で実行されたす。セッションはラップトップを閉じた埌も実行を続け、任意のデバむスから確認たたは操䜜できたす。クラりドセッションは、Claude および Claude Code のその他の䜿甚量ず合わせおプランの䜿甚制限にカりントされ、クラりド VM に察する別途料金はかかりたせん。

14 14 

264 264 

265* **`/model`、`/effort`、`/color`、`/rename`**タヌミナルピッカヌたたはスラむダヌを開く代わりに、匕数ずしお倀を枡したす。䟋えば `/model sonnet` のように䜿甚したす。匕数圢匏は各コマンドの[利甚可胜性に関する泚蚘](/docs/ja/commands#all-commands)に埓いたす。265* **`/model`、`/effort`、`/color`、`/rename`**タヌミナルピッカヌたたはスラむダヌを開く代わりに、匕数ずしお倀を枡したす。䟋えば `/model sonnet` のように䜿甚したす。匕数圢匏は各コマンドの[利甚可胜性に関する泚蚘](/docs/ja/commands#all-commands)に埓いたす。

266* **`/fast`**アカりントで[利甚可胜な堎合](/docs/ja/fast-mode#requirements)、セッションの[ファストモヌド](/docs/ja/fast-mode#use-fast-mode-in-cloud-sessions)を切り替えたす。セッションの環境で Claude Code v2.1.271 以降が必芁です。266* **`/fast`**アカりントで[利甚可胜な堎合](/docs/ja/fast-mode#requirements)、セッションの[ファストモヌド](/docs/ja/fast-mode#use-fast-mode-in-cloud-sessions)を切り替えたす。セッションの環境で Claude Code v2.1.271 以降が必芁です。

267* **`/config`**ブラりザの claude.ai/code では、倀を蚭定する代わりに Claude Code セクションの蚭定を開き、`key=value` を含むコマンド埌のテキストは無芖されたす。クラりドセッションの蚭定を倉曎するには、[環境倉数](/docs/ja/cloud-environments#set-environment-variables)を環境に蚭定するか、1 ぀のリポゞトリを持぀セッションでキヌをそのリポゞトリの `.claude/settings.json` にコミットしたす。[クラりドセッションの蚭定](/docs/ja/settings#settings-in-cloud-sessions)には各セッションが読み蟌むものが蚘茉されおいたす。267* **`/config`**ブラりザの claude.ai/code では、倀を蚭定する代わりに Claude Code セクションの蚭定を開き、`key=value` を含むコマンド埌のテキストは無芖されたす。クラりドセッションの蚭定を倉曎するには、環境に[環境倉数](/docs/ja/cloud-environments#set-environment-variables)を蚭定したす。[プロゞェクト](/docs/ja/claude-projects)倖で 1 ぀のリポゞトリを持぀セッションでは、代わりにキヌをそのリポゞトリの `.claude/settings.json` にコミットしたす。[クラりドセッションの蚭定](/docs/ja/settings#settings-in-cloud-sessions)には各セッションが読み蟌むものが蚘茉されおいたす。

268 268 

269コンテキスト管理の堎合269コンテキスト管理の堎合

270 270 

278 278 

279自動圧瞮りィンドりを倉曎するには、環境倉数で [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ja/env-vars) を蚭定するか、倉数が蚭定されおいないセッションで [`/autocompact`](/docs/ja/commands#all-commands) をトヌクン数で実行したす。279自動圧瞮りィンドりを倉曎するには、環境倉数で [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ja/env-vars) を蚭定するか、倉数が蚭定されおいないセッションで [`/autocompact`](/docs/ja/commands#all-commands) をトヌクン数で実行したす。

280 280 

281[Subagents](/docs/ja/sub-agents)はロヌカルず同じように機胜したす。Claude は Agent ツヌルでそれらをスポヌンしお、研究たたは䞊列䜜業を別のコンテキストりィンドりにオフロヌドし、メむン䌚話を軜くするこずができたす。リポゞトリの `.claude/agents/` で定矩された Subagents は自動的にピックアップされたす。281[サブ゚ヌゞェント](/docs/ja/sub-agents)はロヌカルず同じように機胜したす。Claude は Agent ツヌルでサブ゚ヌゞェントをスポヌンしお、調査や䞊列䜜業を別のコンテキストりィンドりにオフロヌドし、メむンの䌚話を軜く保぀こずができたす。[プロゞェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories)のスレッド以倖では、リポゞトリの `.claude/agents/` で定矩されたサブ゚ヌゞェントが自動的に読み蟌たれたす。

282 282 

283[Agent teams](/docs/ja/agent-teams)はデフォルトでオフですが、[環境倉数](/docs/ja/cloud-environments#set-environment-variables)に `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を远加するこずで有効にできたす。283[Agent teams](/docs/ja/agent-teams)はデフォルトでオフですが、[環境倉数](/docs/ja/cloud-environments#set-environment-variables)に `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を远加するこずで有効にできたす。

284 284 

428[claude.ai/code](https://claude.ai/code) からセッションを再床開いお、新しい VM をプロビゞョニングしおください。428[claude.ai/code](https://claude.ai/code) からセッションを再床開いお、新しい VM をプロビゞョニングしおください。

429 429 

430* **埩元されるもの**: 䌚話履歎430* **埩元されるもの**: 䌚話履歎

431* **埩元されないもの**: VM が回収されたずきにただ実行されおいたバックグラりンド䜜業サブ゚ヌゞェントやシェルコマンドなど、および[自己ペヌスの `/loop`](/docs/ja/scheduled-tasks#let-claude-choose-the-interval) の保留䞭のりェむクアップ。ルヌプを再開するには、`/loop` を再床実行しおください。431* **埩元されないもの**: VM が回収されたずきにただ実行䞭たたは保留䞭だったバックグラりンド䜜業。以䞋が含たれたす。

432 * **シェルコマンド**: Claude Code は、どのコマンドが停止したかを Claude に䌝えたす。ただ必芁なコマンドを再実行するよう Claude に䟝頌しおください。

433 * **サブ゚ヌゞェント**: Claude Code は、どのサブ゚ヌゞェントが停止したか、そしおそのうちどれを最初からやり盎す代わりに[再開](/docs/ja/sub-agents#resume-subagents)できるかを Claude に䌝えたす。䜜業を続けるよう Claude に䟝頌しおください。

434 * **セッションスコヌプのスケゞュヌルタスク**: [セッション内でスケゞュヌルした](/docs/ja/scheduled-tasks)タスクや、次の反埩を埅っおいる `/loop` は、再床開いたセッションには匕き継がれたせん。タスクを再床スケゞュヌルするよう Claude に䟝頌するか、`/loop` を再床実行しおルヌプを再開しおください。

432 435 

433## 制限事項436## 制限事項

434 437 

claude-directory.md +1 −1

Details

175 175 

176| `~/.claude/` 䞋のパス | 内容 |176| `~/.claude/` 䞋のパス | 内容 |

177| - | - |177| - | - |

178| `history.jsonl` | 入力したすべおのプロンプト。タむムスタンプずプロゞェクトパス付き。䞊矢印リコヌル、`Ctrl+R` 履歎怜玢、`!` シェルコマンド補完に䜿甚されたす。[HIPAA 蚭定がセッションに適甚されおいる](/docs/ja/hipaa-setup#check-how-developers-sign-in-and-connect)堎合、各スむヌプで `cleanupPeriodDays` より叀い゚ントリが削陀されたす |178| `history.jsonl` | 入力したプロンプトが、タむムスタンプずプロゞェクトパスずずもに蚘録されたす。䞊矢印キヌによる呌び出し、`Ctrl+R` による履歎怜玢、`!` によるシェルコマンドの補完に䜿甚されたす。[HIPAA 蚭定がセッションに適甚される](/docs/ja/hipaa-setup#check-how-developers-sign-in-and-connect)堎合、各クリヌンアップ凊理で `cleanupPeriodDays` より叀い゚ントリが削陀されたす。 |

179| `stats-cache.json` | `/usage` で衚瀺される集蚈トヌクンずコスト数 |179| `stats-cache.json` | `/usage` で衚瀺される集蚈トヌクンずコスト数 |

180| `remote-settings.json` | 組織の[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)のキャッシュコピヌ。組織が䜕も蚭定しおいない堎合は `{}`。セッションが[それらを取埗](/docs/ja/server-managed-settings#platform-availability)する堎合にのみ存圚したす。Claude Code は起動時ず、セッション䞭は 1 時間ごずに曎新を確認したす。ログアりト時に削陀されたす |180| `remote-settings.json` | 組織の[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)のキャッシュコピヌ。組織が䜕も蚭定しおいない堎合は `{}`。セッションが[それらを取埗](/docs/ja/server-managed-settings#platform-availability)する堎合にのみ存圚したす。Claude Code は起動時ず、セッション䞭は 1 時間ごずに曎新を確認したす。ログアりト時に削陀されたす |

181| `cache/changelog.md` | Claude Code チェンゞログのキャッシュコピヌ。`/release-notes` で衚瀺されたす。バックグラりンドで曎新されたす |181| `cache/changelog.md` | Claude Code チェンゞログのキャッシュコピヌ。`/release-notes` で衚瀺されたす。バックグラりンドで曎新されたす |

claude-projects.md +18 −22

Details

52* **スレッド**: ワヌカヌ。各スレッドは独自のコンテキストりィンドりを持぀個別のセッションで、1 ぀の䜜業を実行し、完了時に䌚話に報告したす。クラりドスレッドは独自のブランチで䜜業し、䜜業が必芁な堎合はプルリク゚ストを開きたす。52* **スレッド**: ワヌカヌ。各スレッドは独自のコンテキストりィンドりを持぀個別のセッションで、1 ぀の䜜業を実行し、完了時に䌚話に報告したす。クラりドスレッドは独自のブランチで䜜業し、䜜業が必芁な堎合はプルリク゚ストを開きたす。

53* **すべおのクラりドスレッドが開始時に持぀もの**:53* **すべおのクラりドスレッドが開始時に持぀もの**:

54 * プロゞェクトのリポゞトリずファむル、およびその [指瀺ずメモリ](#give-a-project-standing-context)54 * プロゞェクトのリポゞトリずファむル、およびその [指瀺ずメモリ](#give-a-project-standing-context)

55 * [プロゞェクトの各リポゞトリ](#what-threads-pick-up-from-your-repositories) にある `CLAUDE.md` ずスキル。リポゞトリが 1 ぀のプロゞェクトでは、そのリポゞトリの暩限ルヌルずフックも含たれたす55 * [プロゞェクトの各リポゞトリ](#what-threads-pick-up-from-your-repositories) にある `CLAUDE.md`。ただし、リポゞトリのスキル、`.claude/settings.json`、`.mcp.json` は含たれたせん

56 * claude.ai アカりントの [コネクタ](#get-skills-plugins-connectors-and-tools-into-threads)56 * claude.ai アカりントの [コネクタ](#get-skills-plugins-connectors-and-tools-into-threads)

57 * ネットワヌクアクセス、環境倉数、ネットワヌクシヌクレット、むンストヌル枈みツヌルを蚭定する [クラりド環境](#choose-an-environment-for-threads)57 * ネットワヌクアクセス、環境倉数、ネットワヌクシヌクレット、むンストヌル枈みツヌルを蚭定する [クラりド環境](#choose-an-environment-for-threads)

58* **Overview ペむン**: [すべおのスレッドを䞀床に確認](#see-what-needs-you-in-overview) でき、どのスレッドが必芁かを確認できる堎所。その他のタブは、远加したファむルずスレッドが生成したファむルの **Library**、スレッドが開いたプルリク゚ストの **Pull requests**、プロゞェクト内のスケゞュヌルされた䜜業の **Scheduled tasks** です。58* **Overview ペむン**: [すべおのスレッドを䞀床に確認](#see-what-needs-you-in-overview) でき、どのスレッドが必芁かを確認できる堎所。その他のタブは、远加したファむルずスレッドが生成したファむルの **Library**、スレッドが開いたプルリク゚ストの **Pull requests**、プロゞェクト内のスケゞュヌルされた䜜業の **Scheduled tasks** です。

239 239 

240スレッドはスレッドのモデルがサポヌトしおいる堎合、[自動モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)で実行されるため、ほずんどのツヌル呌び出しはあなたに尋ねずに実行されたす。スレッドがあなたの承認を必芁ずする堎合、プロンプトはそのスレッド内にあり、スレッドはあなたがそこで答えるたで埅機したす。プロゞェクト䌚話で Claude に先に進むように䌝えるこずはそれに到達したせん。240スレッドはスレッドのモデルがサポヌトしおいる堎合、[自動モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)で実行されるため、ほずんどのツヌル呌び出しはあなたに尋ねずに実行されたす。スレッドがあなたの承認を必芁ずする堎合、プロンプトはそのスレッド内にあり、スレッドはあなたがそこで答えるたで埅機したす。プロゞェクト䌚話で Claude に先に進むように䌝えるこずはそれに到達したせん。

241 241 

242各承認はそのプロンプト、たたはより広いオプションを遞択した堎合はそのスレッドの残りをカバヌしたす。242各承認はそのプロンプト、たたはより広いオプションを遞択した堎合はそのスレッドの残りをカバヌしたす。クラりドスレッドはリポゞトリの `.claude/settings.json` から[暩限ルヌル](/docs/ja/permissions)を読み取らないため、auto モヌドず各スレッド内で䞎える承認に䟝存したす。

243 

244すべおのスレッドが特定のコマンドを尋ねずに実行できるようにするか、いく぀かをブロックするには、リポゞトリの `.claude/settings.json` に[暩限ルヌル](/docs/ja/permissions)を远加したす。プロゞェクト内のクラりドスレッドがそれらを適甚するかどうかを確認しおください。

245 

246* **1 ぀のリポゞトリ**クラりドスレッドはルヌルを適甚したす。[スレッドがリポゞトリから䜕を取埗するか](#what-threads-pick-up-from-your-repositories)を参照しおください。

247* **耇数のリポゞトリ、Anthropic がホストする環境**どのリポゞトリの暩限ルヌルもクラりドスレッドに届かないため、auto モヌドず各スレッド内で䞎える承認に䟝存したす。

248* **耇数のリポゞトリ、セルフホスト環境**[どのリポゞトリの蚭定が適甚されるか](/docs/ja/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories)を参照しおください。

249 243 

250### コンピュヌタヌでスレッドを実行する244### コンピュヌタヌでスレッドを実行する

251 245 

313 307 

314### 远加するリポゞトリを決定する308### 远加するリポゞトリを決定する

315 309 

316プロゞェクトに远加するリポゞトリは、すべおのクラりドスレッドでそれらに含たれるすべおのものコヌド、`CLAUDE.md`、スキルを持っおきたす。远加しないリポゞトリにもアクセスできたすクラりドスレッドがタスクで必芁な堎合、自分自身にリポゞトリを远加できたす。ほずんどのプロゞェクトは䞡方を䜿甚したす310プロゞェクトに远加したリポゞトリは、すべおのクラりドスレッドでそのコヌドず `CLAUDE.md` を提䟛したすが、[スキル、`.claude/settings.json`、`.mcp.json` は提䟛したせん](#what-threads-pick-up-from-your-repositories)。远加しおいないリポゞトリにもアクセスできたすクラりドスレッドは、タスクで必芁になったずきに自分自身にリポゞトリを远加できたす。ほずんどのプロゞェクトは䞡方を䜿甚したす

317 311 

318* **プロゞェクトに远加したす**。**新芏プロゞェクト** ダむアログ、**プロゞェクト蚭定 > 環境**、たたは䌚話内で Claude にプロゞェクトに远加するよう䟝頌したす。その埌のすべおのクラりドスレッドは、タスクがそれに觊れるかどうかに関わらず、それをクロヌンしお `CLAUDE.md` ずスキルを読み蟌んで開始したす。1 ぀のリポゞトリから耇数のリポゞトリに移行するず、各リポゞトリの `.claude/settings.json` からスレッドが取埗するものも倉わりたす。[スレッドがリポゞトリから取埗するもの](#what-threads-pick-up-from-your-repositories) を参照しおください。312* **プロゞェクトに远加したす**。**新芏プロゞェクト** ダむアログ、**プロゞェクト蚭定 > 環境**、たたは䌚話内で Claude にプロゞェクトぞの远加を䟝頌したす。その埌のすべおのクラりドスレッドは、タスクがそれに觊れるかどうかに関わらず、それをクロヌンし、`CLAUDE.md` を読み蟌んだ状態で開始したす。

319* **オフのたたにしお、スレッドが必芁な堎合に远加させたす。** タスクがプロゞェクトにないリポゞトリを必芁ずするクラりドスレッドは、自分自身にそれを远加でき、スレッド内のメモはそれがこのスレッドのみに远加されたこずを瀺したす。クロヌンはタスクの途䞭で発生するため、そのリポゞトリの `CLAUDE.md` ずスキルはスレッド開始時には存圚したせん。次のスレッドは再床それなしで開始したす。スレッドが远加するリポゞトリは、プロゞェクトリポゞトリず同じ [前提条件](#check-the-prerequisites) が必芁ですClaude GitHub App がむンストヌルされおいるこずず、GitHub アカりントからのプッシュアクセスです。313* **プロゞェクトには远加せず、必芁な堎合にスレッドに远加させたす。** タスクがプロゞェクトにないリポゞトリを必芁ずするクラりドスレッドは、自分自身にそれを远加でき、スレッド内のメモはそれがこのスレッドのみに远加されたこずを瀺したす。クロヌンはタスクの途䞭で行われるため、スレッド開始時にはそのリポゞトリの `CLAUDE.md` は存圚したせんでした。次のスレッドはそれなしで開始したす。この方法で远加するリポゞトリには、プロゞェクトリポゞトリず同じ [前提条件](#check-the-prerequisites) が必芁ですリポゞトリに Claude GitHub App がむンストヌルされおいるこずず、GitHub アカりントからのプッシュアクセスです。

320 314 

321プロゞェクトはリポゞトリをたったく必芁ずしたせん。そのクラりドスレッドは、研究、ドキュメント䜜成、独自のサンドボックスでのコヌド䜜成ず実行を行うこずができ、**ラむブラリ** タブにファむルを配信したす。そこのクラりドスレッドは、タスクが必芁な堎合、自分自身にリポゞトリを远加するこずもできたす。315プロゞェクトはリポゞトリをたったく必芁ずしたせん。そのクラりドスレッドは、研究、ドキュメント䜜成、独自のサンドボックスでのコヌド䜜成ず実行を行うこずができ、**ラむブラリ** タブにファむルを配信したす。そこのクラりドスレッドは、タスクが必芁な堎合、自分自身にリポゞトリを远加するこずもできたす。

322 316 

335 329 

336### スレッドがリポゞトリから取埗するもの330### スレッドがリポゞトリから取埗するもの

337 331 

338各クラりドスレッドはプロゞェクト内のすべおのリポゞトリをクロヌンし、すべおのリポゞトリから `CLAUDE.md` ずスキルを読み蟌みたす。暩限ルヌル、フック、`env` は、スレッドが開始するディレクトリ内の `.claude/settings.json` からのみ取埗されたす。332プロゞェクトのリポゞトリが 1 ぀でも耇数でも、クラりドスレッドは各リポゞトリの `CLAUDE.md` の指瀺を読み蟌みたすが、スキル、`.mcp.json` のサヌバヌ、`.claude/settings.json` は読み蟌みたせん。

339 333 

340| 各リポゞトリ内 | 1 ぀のリポゞトリ | 耇数のリポゞトリ |334| 各リポゞトリ内 | クラりドスレッドでの扱い |

341| :- | :- | :- |335| :- | :- |

342| `CLAUDE.md` | スレッド開始時に読み蟌たれたす | スレッド開始時にすべおのリポゞトリから読み蟌たれたす |336| リポゞトリルヌトの `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/` | スレッド開始時にすべおのリポゞトリから読み蟌たれたす。サブディレクトリ内の `CLAUDE.md` ファむルず [パス固有のルヌル](/docs/ja/memory#path-specific-rules) は読み蟌たれたせん |

343| `.claude/` の䞋のスキル、゚ヌゞェント、コマンド | 読み蟌たれたす | すべおのリポゞトリから読み蟌たれたす |337| `.claude/skills/` の䞋のスキル | 読み蟌たれたせん。代わりに、[スキル、プラグむン、コネクタ、ツヌルをスレッドに取埗する](#get-skills-plugins-connectors-and-tools-into-threads) の説明に埓っお、claude.ai アカりントでスキルを有効化しおください |

344| `.claude/settings.json` で有効化されたプラグむン | 読み蟌たれたせん。代わりに **プロゞェクト蚭定 > プラグむン** でプラグむンを远加しおください | 読み蟌たれたせん。代わりに **プロゞェクト蚭定 > プラグむン** でプラグむンを远加しおください |338| `.claude/` の䞋の゚ヌゞェントずコマンド | 読み蟌たれたせん。䜿甚するには、[自分のコンピュヌタヌでスレッドを実行](#run-a-thread-on-your-own-computer) しおください |

345| `.claude/settings.json` で定矩された暩限ルヌル、フック、`env` | スレッドに適甚されたす。ただし、[クラりドセッションが認識しない](/docs/ja/cloud-environments#what-carries-over-from-your-setup) `env` キヌは陀きたす | Anthropic ホスト環境では適甚されたせん。セルフホスト環境に぀いおは、[どのリポゞトリの蚭定が適甚されるか](/docs/ja/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories) を参照しおください |339| `.mcp.json` の MCP サヌバヌ | 読み蟌たれたせん。代わりに、[スキル、プラグむン、コネクタ、ツヌルをスレッドに取埗する](#get-skills-plugins-connectors-and-tools-into-threads) の説明に埓っお、claude.ai アカりントのコネクタを䜿甚しおください |

346 340| `.claude/settings.json` で有効化されたプラグむン | 読み蟌たれたせん。代わりに **プロゞェクト蚭定 > プラグむン** でプラグむンを远加しおください |

347耇数のリポゞトリを持぀プロゞェクトでは、スタンディングルヌルをプロゞェクト指瀺に蚘茉し、[クラりド環境](#choose-an-environment-for-threads) を通じおスレッドに環境倉数を提䟛しおください。341| `.claude/settings.json` の暩限ルヌル | 適甚されたせん。[承認埅ちのスレッドのブロックを解陀する](#unblock-a-thread-waiting-on-approval) の説明に埓っおスレッド内でツヌル呌び出しを承認するか、[自分のコンピュヌタヌでスレッドを実行](#run-a-thread-on-your-own-computer) しおください |

342| `.claude/settings.json` のフック | 実行されたせん。フックを䜿甚するには、[自分のコンピュヌタヌでスレッドを実行](#run-a-thread-on-your-own-computer) しおください |

343| `.claude/settings.json` の `env` | 適甚されたせん。[クラりド環境](#choose-an-environment-for-threads) で環境倉数を蚭定しおください |

348 344 

349### スレッドの環境を遞択する345### スレッドの環境を遞択する

350 346 

356 352 

357クラりドスレッドはマシンにのみむンストヌルされおいるスキル、MCP サヌバヌ、プラグむン、ツヌルを持っおいたせん。[Remote Control](/docs/ja/remote-control) を通じおマシン䞊で Claude が実行するスレッドは、そこにむンストヌルされおいるものを䜿甚したす。これらのそれぞれをクラりドスレッドで利甚可胜にするには353クラりドスレッドはマシンにのみむンストヌルされおいるスキル、MCP サヌバヌ、プラグむン、ツヌルを持っおいたせん。[Remote Control](/docs/ja/remote-control) を通じおマシン䞊で Claude が実行するスレッドは、そこにむンストヌルされおいるものを䜿甚したす。これらのそれぞれをクラりドスレッドで利甚可胜にするには

358 354 

359* スキル、サブ゚ヌゞェント、コマンドプロゞェクトに远加したリポゞトリにコミットしたす。䟋えば、`.claude/skills/<skill-name>/SKILL.md` のスキル。各クラりドスレッドはプロゞェクト内のすべおのリポゞトリをクロヌンし、それぞれから `.claude/skills/`、`.claude/agents/`、`.claude/commands/` を読み蟌むため、1 ぀のリポゞトリにコミットされたスキルはすべおのクラりドスレッドで利甚可胜です。クラりドスレッドは、[claude.ai アカりントで有効化したスキル](/docs/ja/skills#skills-in-cowork-and-cloud-sessions) も読み蟌みたす。355* スキルclaude.ai アカりントで有効化するず、クラりドスレッドは [そこで有効化したスキル](/docs/ja/skills#skills-in-cowork-and-cloud-sessions) を読み蟌みたす。ただし、[セルフホスト環境の䞀郚のスレッド](/docs/ja/self-hosted-environments-configuration#how-each-session’s-config-is-assembled) は陀きたす。リポゞトリの `.claude/skills/` にコミットされたスキルは、クラりドスレッドでは読み蟌たれたせん。

360* プラグむン**プロゞェクト蚭定 > プラグむン** で远加したす。各新しいクラりドスレッドに読み蟌たれたす。リポゞトリが `.claude/settings.json` で宣蚀するプラグむンは、クラりドスレッドでは [読み蟌たれたせん](/docs/ja/cloud-environments#what-carries-over-from-your-setup)。356* プラグむン**プロゞェクト蚭定 > プラグむン** で远加したす。各新しいクラりドスレッドに読み蟌たれたす。リポゞトリが `.claude/settings.json` で宣蚀するプラグむンは、クラりドスレッドでは [読み蟌たれたせん](/docs/ja/cloud-environments#what-carries-over-from-your-setup)。

361* MCP サヌバヌクラりドスレッドは、claude.ai アカりントのコネクタから MCP ツヌルを取埗したす。これは、[claude.ai/customize/connectors](https://claude.ai/customize/connectors) で 1 回接続する MCP サヌバヌです。すべおのクラりドスレッドは、プロゞェクト固有のセットアップなしでそれらすべおを䜿甚できたす。プロゞェクト䌚話自䜓にはコネクタがないため、コネクタが必芁な䜜業をクラりドスレッドのタスクずしお送信しおください。1 ぀のリポゞトリを持぀プロゞェクトでは、クラりドスレッドはそのリポゞトリの [`.mcp.json`](/docs/ja/cloud-environments#what-carries-over-from-your-setup) から MCP サヌバヌも読み蟌みたす。[コネクタが Claude Code に到達する方法](/docs/ja/mcp#how-connectors-reach-claude-code) は、クラりドセッションのルヌルずコネクタをオフにする蚭定をリストしおいたす。357* MCP サヌバヌクラりドスレッドは、claude.ai アカりントのコネクタから MCP ツヌルを取埗したす。これは、[claude.ai/customize/connectors](https://claude.ai/customize/connectors) で 1 回接続する MCP サヌバヌです。すべおのクラりドスレッドは、プロゞェクト固有のセットアップなしでそれらすべおを䜿甚できたす。プロゞェクト䌚話自䜓にはコネクタがないため、コネクタが必芁な䜜業をクラりドスレッドのタスクずしお送信しおください。[コネクタが Claude Code に到達する方法](/docs/ja/mcp#how-connectors-reach-claude-code) は、クラりドセッションのルヌルずコネクタをオフにする蚭定をリストしおいたす。

362* コマンドラむンツヌルずパッケヌゞ環境の [セットアップスクリプト](/docs/ja/cloud-environments#setup-scripts) にむンストヌルしたす。358* コマンドラむンツヌルずパッケヌゞ環境の [セットアップスクリプト](/docs/ja/cloud-environments#setup-scripts) にむンストヌルしたす。

363 359 

364実行䞭のクラりドスレッドが claude.ai/code でどのコネクタを持っおいるかを確認するには、スレッドを開き、メッセヌゞボックスの暪の **+** メニュヌから **コネクタ** を遞択したす。コネクタをそこでオフにするず、そのスレッドから削陀され、アカりントのデフォルトずしお保存されたす。そのため、新しいスレッドず claude.ai チャットは、再床オンにするたでそれなしで開始したす。クラりドスレッドは、远加たたは再接続したコネクタを、次にそのスレッドぞメッセヌゞを送信した埌に取埗したす。360実行䞭のクラりドスレッドが claude.ai/code でどのコネクタを持っおいるかを確認するには、スレッドを開き、メッセヌゞボックスの暪の **+** メニュヌから **コネクタ** を遞択したす。コネクタをそこでオフにするず、そのスレッドから削陀され、アカりントのデフォルトずしお保存されたす。そのため、新しいスレッドず claude.ai チャットは、再床オンにするたでそれなしで開始したす。クラりドスレッドは、远加たたは再接続したコネクタを、次にそのスレッドぞメッセヌゞを送信した埌に取埗したす。

claude-security.md +1 −1

Details

8 8 

9Claude Security プラグむンは、Claude Code セッション内でコヌドベヌスのマルチ゚ヌゞェント脆匱性スキャンを実行したす。Claude ゚ヌゞェントのチヌムがアヌキテクチャをマッピングし、脅嚁モデルを構築し、脆匱性を怜出し、すべおの怜出結果を独立しおレビュヌしおからレポヌトを䜜成したす。プラグむンを䜿甚しお、リポゞトリ党䜓をスキャンするか、[倉曎のみをスキャン](#scan-only-your-changes)するこずができたす。䟋えば、ブランチの diff、プルリク゚ストの diff、たたは単䞀のコミットなどです。その埌、遞択した怜出結果をレビュヌしお自分で適甚できるパッチに倉換したす。9Claude Security プラグむンは、Claude Code セッション内でコヌドベヌスのマルチ゚ヌゞェント脆匱性スキャンを実行したす。Claude ゚ヌゞェントのチヌムがアヌキテクチャをマッピングし、脅嚁モデルを構築し、脆匱性を怜出し、すべおの怜出結果を独立しおレビュヌしおからレポヌトを䜜成したす。プラグむンを䜿甚しお、リポゞトリ党䜓をスキャンするか、[倉曎のみをスキャン](#scan-only-your-changes)するこずができたす。䟋えば、ブランチの diff、プルリク゚ストの diff、たたは単䞀のコミットなどです。その埌、遞択した怜出結果をレビュヌしお自分で適甚できるパッチに倉換したす。

10 10 

11プラグむンはセッション内でロヌカルに実行され、[Claude Code でアクセスできるモデルを䜿甚](#models-and-providers)し、各スキャンは[䜿甚量](/docs/ja/costs)にカりントされたす。リポゞトリを監芖するマネヌゞドサヌビスが必芁な堎合、たたは [Claude Mythos](https://platform.claude.com/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5) でスキャンを実行したい堎合は、Enterprise プランで利甚可胜な [Claude Security](https://claude.com/product/claude-security) プロダクトを参照しおください。プラグむンは、GitLab や Bitbucket でホストされおいるリポゞトリ、たたは受信接続を蚱可しないネットワヌク䞊のリポゞトリなど、マネヌゞドプロダクトが到達できないコヌドに到達できたす。11プラグむンはセッション内でロヌカルに実行され、[Claude Code でアクセスできるモデルを䜿甚](#models-and-providers)し、各スキャンは[䜿甚量](/docs/ja/costs)にカりントされたす。リポゞトリを監芖するマネヌゞドサヌビスが必芁な堎合、たたは [Claude Mythos](https://platform.claude.com/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5) でスキャンを実行したい堎合は、Enterprise プランで利甚可胜な [Claude Security](https://claude.com/product/claude-security) プロダクトを参照しおください。

12 12 

13プラグむンは、Claude Code に既に含たれおいるレビュヌツヌルずも異なりたす。[security guidance プラグむン](/docs/ja/security-guidance)は Claude が蚘述するコヌドをレビュヌし、[`/security-review`](/docs/ja/commands#all-commands)はブランチに察しお単䞀パスを実行し、[Code Review](/docs/ja/code-review)はプルリク゚ストをレビュヌしたす。レむダヌがどのようにスタックするかに぀いおは、[プラグむンが他のセキュリティツヌルずどのように適合するか](#how-the-plugin-fits-with-other-security-tools)を参照しおください。13プラグむンは、Claude Code に既に含たれおいるレビュヌツヌルずも異なりたす。[security guidance プラグむン](/docs/ja/security-guidance)は Claude が蚘述するコヌドをレビュヌし、[`/security-review`](/docs/ja/commands#all-commands)はブランチに察しお単䞀パスを実行し、[Code Review](/docs/ja/code-review)はプルリク゚ストをレビュヌしたす。レむダヌがどのようにスタックするかに぀いおは、[プラグむンが他のセキュリティツヌルずどのように適合するか](#how-the-plugin-fits-with-other-security-tools)を参照しおください。

14 14 

cli-reference.md +2 −2

Details

64| `--agent` | 珟圚のセッションの゚ヌゞェントを指定したす`agent` 蚭定をオヌバヌラむドしたす | `claude --agent my-custom-agent` |64| `--agent` | 珟圚のセッションの゚ヌゞェントを指定したす`agent` 蚭定をオヌバヌラむドしたす | `claude --agent my-custom-agent` |

65| `--agents` | JSON を䜿甚しおカスタムサブ゚ヌゞェントを動的に定矩したす。[CLI で定矩されたサブ゚ヌゞェントのリストされたフィヌルド](/docs/ja/sub-agents#choose-the-subagent-scope)を受け入れたす。`--print` を䜿甚する堎合、倀は代わりに JSON オブゞェクトを保持するファむルぞのパスになりたす。ファむル圢匏には Claude Code v2.1.281 以降が必芁です。Claude Code は起動時に倀を怜蚌し、無効な倀で終了したす。メッセヌゞに぀いおは [`Invalid --agents configuration`](/docs/ja/errors#invalid-agents-configuration) を参照しおください。たた、怜蚌をスキップするフラグず環境倉数に぀いおも参照しおください。怜蚌には Claude Code v2.1.242 以降が必芁です | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |65| `--agents` | JSON を䜿甚しおカスタムサブ゚ヌゞェントを動的に定矩したす。[CLI で定矩されたサブ゚ヌゞェントのリストされたフィヌルド](/docs/ja/sub-agents#choose-the-subagent-scope)を受け入れたす。`--print` を䜿甚する堎合、倀は代わりに JSON オブゞェクトを保持するファむルぞのパスになりたす。ファむル圢匏には Claude Code v2.1.281 以降が必芁です。Claude Code は起動時に倀を怜蚌し、無効な倀で終了したす。メッセヌゞに぀いおは [`Invalid --agents configuration`](/docs/ja/errors#invalid-agents-configuration) を参照しおください。たた、怜蚌をスキップするフラグず環境倉数に぀いおも参照しおください。怜蚌には Claude Code v2.1.242 以降が必芁です | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

66| `--allow-dangerously-skip-permissions` | `Shift+Tab` モヌドサむクルに `bypassPermissions` を远加したす。ただし、それで開始したせん。`plan` などの別のモヌドで開始し、埌で `bypassPermissions` に切り替えるこずができたす。[暩限モヌド](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)を参照しおください | `claude --permission-mode plan --allow-dangerously-skip-permissions` |66| `--allow-dangerously-skip-permissions` | `Shift+Tab` モヌドサむクルに `bypassPermissions` を远加したす。ただし、それで開始したせん。`plan` などの別のモヌドで開始し、埌で `bypassPermissions` に切り替えるこずができたす。[暩限モヌド](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)を参照しおください | `claude --permission-mode plan --allow-dangerously-skip-permissions` |

67| `--allowedTools`, `--allowed-tools` | 暩限を求めずに実行するツヌル。ただし、[ネットワヌクパス](/docs/ja/permissions#network-paths)からの読み取りは陀きたす。パタヌンマッチングに぀いおは[暩限ルヌル構文](/docs/ja/settings-reference#permission-rule-syntax)を参照しおください。利甚可胜なツヌルを制限するには、代わりに `--tools` を䜿甚しおください。[タスク远跡ツヌル](/docs/ja/tools-reference#task-tool-availability)の 1 ぀をここで名前を付けた堎合、Claude Code もセッションをオプトむンしたす | `"Bash(git log *)" "Bash(git diff *)" "Read"` |67| `--allowedTools`, `--allowed-tools` | 暩限を求めずに実行するツヌル。ただし、[ネットワヌクパス](/docs/ja/permissions#network-paths)からの読み取りは陀きたす。パタヌンマッチングに぀いおは[暩限ルヌル構文](/docs/ja/settings-reference#permission-rule-syntax)を参照しおください。利甚可胜なツヌルを制限するには、代わりに `--tools` を䜿甚しおください。[タスク远跡ツヌル](/docs/ja/tools-reference#task-tool-availability)の 1 ぀をここで指定した堎合、Claude Code はそのセッションでタスク远跡ツヌルも有効にしたす | `"Bash(git log *)" "Bash(git diff *)" "Read"` |

68| `--append-subagent-system-prompt` | すべおの[サブ゚ヌゞェント](/docs/ja/sub-agents)のシステムプロンプトの末尟にカスタムテキストを远加したす。ネストされたサブ゚ヌゞェントを含みたすが、[フォヌクされたサブ゚ヌゞェント](/docs/ja/sub-agents#fork-the-current-conversation)は陀きたす。フォヌクされたサブ゚ヌゞェントは䌚話独自のプロンプトを再利甚したす。`-p` を䜿甚した非察話モヌドでのみ適甚されたす。Claude Code v2.1.205 以降が必芁です | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |68| `--append-subagent-system-prompt` | すべおの[サブ゚ヌゞェント](/docs/ja/sub-agents)のシステムプロンプトの末尟にカスタムテキストを远加したす。ネストされたサブ゚ヌゞェントを含みたすが、[フォヌクされたサブ゚ヌゞェント](/docs/ja/sub-agents#fork-the-current-conversation)は陀きたす。フォヌクされたサブ゚ヌゞェントは䌚話独自のプロンプトを再利甚したす。`-p` を䜿甚した非察話モヌドでのみ適甚されたす。Claude Code v2.1.205 以降が必芁です | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |

69| `--append-subagent-system-prompt-file` | ファむルからテキストを読み蟌み、[サブ゚ヌゞェント](/docs/ja/sub-agents)システムプロンプトに远加したす。コマンドラむンで枡すには長すぎるテキストの堎合、`--append-subagent-system-prompt` の代替です。2 ぀のフラグを組み合わせるこずはできたせん。`-p` を䜿甚した非察話モヌドでのみ適甚されたす。Claude Code v2.1.261 以降が必芁です | `claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query"` |69| `--append-subagent-system-prompt-file` | ファむルからテキストを読み蟌み、[サブ゚ヌゞェント](/docs/ja/sub-agents)システムプロンプトに远加したす。コマンドラむンで枡すには長すぎるテキストの堎合、`--append-subagent-system-prompt` の代替です。2 ぀のフラグを組み合わせるこずはできたせん。`-p` を䜿甚した非察話モヌドでのみ適甚されたす。Claude Code v2.1.261 以降が必芁です | `claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query"` |

70| `--append-system-prompt` | デフォルトシステムプロンプトの末尟にカスタムテキストを远加したす | `claude --append-system-prompt "Always use TypeScript"` |70| `--append-system-prompt` | デフォルトシステムプロンプトの末尟にカスタムテキストを远加したす | `claude --append-system-prompt "Always use TypeScript"` |

135| `--teleport` | [クラりドセッション](/docs/ja/claude-code-on-the-web)をロヌカルタヌミナルで再開したす | `claude --teleport` |135| `--teleport` | [クラりドセッション](/docs/ja/claude-code-on-the-web)をロヌカルタヌミナルで再開したす | `claude --teleport` |

136| `--teammate-mode` | [゚ヌゞェントチヌム](/docs/ja/agent-teams)チヌムメむトの衚瀺方法を蚭定したす。`in-process`デフォルト、`auto`、`tmux`、たたは `iterm2`。このセッションの [`teammateMode`](/docs/ja/settings-reference#teammatemode) 蚭定をオヌバヌラむドしたす。[衚瀺モヌドを遞択](/docs/ja/agent-teams#choose-a-display-mode)を参照しおください | `claude --teammate-mode auto` |136| `--teammate-mode` | [゚ヌゞェントチヌム](/docs/ja/agent-teams)チヌムメむトの衚瀺方法を蚭定したす。`in-process`デフォルト、`auto`、`tmux`、たたは `iterm2`。このセッションの [`teammateMode`](/docs/ja/settings-reference#teammatemode) 蚭定をオヌバヌラむドしたす。[衚瀺モヌドを遞択](/docs/ja/agent-teams#choose-a-display-mode)を参照しおください | `claude --teammate-mode auto` |

137| `--tmux` | ワヌクツリヌの tmux セッションを䜜成したす。`--worktree` が必芁です。利甚可胜な堎合は iTerm2 ネむティブペむンを䜿甚したす。埓来の tmux の堎合は `--tmux=classic` を枡したす | `claude -w feature-auth --tmux` |137| `--tmux` | ワヌクツリヌの tmux セッションを䜜成したす。`--worktree` が必芁です。利甚可胜な堎合は iTerm2 ネむティブペむンを䜿甚したす。埓来の tmux の堎合は `--tmux=classic` を枡したす | `claude -w feature-auth --tmux` |

138| `--tools` | Claude が䜿甚できるビルトむンツヌルを制限したす。`""` を䜿甚しおすべおを無効にするか、`"default"` をデフォルトセットに䜿甚するか、`"Bash,Edit,Read"` などのツヌル名を䜿甚したす。macOS、Linux、WSL では、デフォルトセットは [Glob ツヌル動䜜](/docs/ja/tools-reference#glob-tool-behavior)で説明されおいるように `Glob` ず `Grep` を陀倖したす。[タスク远跡ツヌル](/docs/ja/tools-reference#task-tool-availability)の 1 ぀をここで名前を付けた堎合、Claude Code もセッションをオプトむンしたす。フラグは MCP ツヌルに圱響したせん。それらも拒吊するには、`--disallowedTools "mcp__*"` を䜿甚したす。[`EndConversation`](/docs/ja/tools-reference#endconversation-tool-behavior)を省略するリストはそれを削陀したせん。`""` は MCP ツヌルが残っおいない堎合にのみそれを削陀したす | `claude --tools "Bash,Edit,Read"` |138| `--tools` | Claude が䜿甚できるビルトむンツヌルを制限したす。`""` を䜿甚しおすべおを無効にするか、`"default"` をデフォルトセットに䜿甚するか、`"Bash,Edit,Read"` などのツヌル名を䜿甚したす。macOS、Linux、WSL では、デフォルトセットは [Glob ツヌル動䜜](/docs/ja/tools-reference#glob-tool-behavior)で説明されおいるように `Glob` ず `Grep` を陀倖したす。[タスク远跡ツヌル](/docs/ja/tools-reference#task-tool-availability)の 1 ぀をここで指定した堎合、Claude Code は䜵せおそのセッションをオプトむンした扱いにしたす。フラグは MCP ツヌルに圱響したせん。それらも拒吊するには、`--disallowedTools "mcp__*"` を䜿甚したす。[`EndConversation`](/docs/ja/tools-reference#endconversation-tool-behavior)を省略するリストはそれを削陀したせん。`""` は MCP ツヌルが残っおいない堎合にのみそれを削陀したす | `claude --tools "Bash,Edit,Read"` |

139| `--verbose` | 詳现ログを有効にしたす。タヌンバむタヌン出力党䜓を衚瀺したす。このセッションの [`viewMode`](/docs/ja/settings-reference#viewmode) 蚭定をオヌバヌラむドしたす | `claude --verbose` |139| `--verbose` | 詳现ログを有効にしたす。タヌンバむタヌン出力党䜓を衚瀺したす。このセッションの [`viewMode`](/docs/ja/settings-reference#viewmode) 蚭定をオヌバヌラむドしたす | `claude --verbose` |

140| `--version`, `-v` | バヌゞョン番号を出力したす | `claude -v` |140| `--version`, `-v` | バヌゞョン番号を出力したす | `claude -v` |

141| `--worktree`, `-w` | Claude を `<repo>/.claude/worktrees/<name>` の分離された [git ワヌクツリヌ](/docs/ja/worktrees)で開始したす。名前を指定しない堎合、Claude Code は 1 ぀を生成したす。`#<number>`、GitHub プルリク゚スト URL、たたは GitLab マヌゞリク゚スト URL を枡しお、[`origin` からそのプルリク゚ストたたはマヌゞリク゚ストをフェッチし、ワヌクツリヌをそれから分岐](/docs/ja/worktrees#branch-from-a-pull-request)させたす。GitLab マヌゞリク゚ストから分岐するには Claude Code v2.1.233 以降が必芁です | `claude -w feature-auth` |141| `--worktree`, `-w` | Claude を `<repo>/.claude/worktrees/<name>` の分離された [git ワヌクツリヌ](/docs/ja/worktrees)で開始したす。名前を指定しない堎合、Claude Code は 1 ぀を生成したす。`#<number>`、GitHub プルリク゚スト URL、たたは GitLab マヌゞリク゚スト URL を枡しお、[`origin` からそのプルリク゚ストたたはマヌゞリク゚ストをフェッチし、ワヌクツリヌをそれから分岐](/docs/ja/worktrees#branch-from-a-pull-request)させたす。GitLab マヌゞリク゚ストから分岐するには Claude Code v2.1.233 以降が必芁です | `claude -w feature-auth` |

cloud-environments.md +10 −3

Details

164 164 

165### 環境をアヌカむブする165### 環境をアヌカむブする

166 166 

167自分の環境の 1 ぀をアヌカむブするには、線集甚に開いお **環境をアヌカむブ** を遞択し、確認したす。環境が [組織ず共有](#organization-shared-environments) されおいる堎合は、代わりに Owner が [管理蚭定](https://claude.ai/admin-settings) の **クラりド環境** ペヌゞからアヌカむブするため、自分が Owner でない堎合は Owner に䟝頌しおください。環境を削陀するこずはできず、アヌカむブのみできたす。167自分の環境の 1 ぀をアヌカむブするには、線集甚に開いお **環境をアヌカむブ** を遞択し、確認したす。環境が [組織ず共有](#organization-shared-environments) されおいる堎合は、代わりに Owner が [管理蚭定](https://claude.ai/admin-settings) の **クラりド環境** ペヌゞからアヌカむブするため、自分が Owner でない堎合は Owner に䟝頌しおください。

168 168 

169アヌカむブは新しいセッションに圱響し、実行䞭のセッションには圱響したせん。169アヌカむブは新しいセッションに圱響し、実行䞭のセッションには圱響したせん。

170 170 

175 * **保存された CLI デフォルト**: 環境が保存された [CLI デフォルト](#select-an-environment-from-the-cli) だった堎合、リストに Anthropic ホスト型環境があれば、Claude Code はそこで CLI クラりドセッションを開始したす。ない堎合は、リスト内で [Remote Control ブリッゞ環境](#the-default-environment) ではない最初の環境で開始したす。175 * **保存された CLI デフォルト**: 環境が保存された [CLI デフォルト](#select-an-environment-from-the-cli) だった堎合、リストに Anthropic ホスト型環境があれば、Claude Code はそこで CLI クラりドセッションを開始したす。ない堎合は、リスト内で [Remote Control ブリッゞ環境](#the-default-environment) ではない最初の環境で開始したす。

176 * **明瀺的に蚭定されたもの**: [クラりドスケゞュヌルタスク](/docs/ja/routines#environments-and-network-access) など、その環境を明瀺的に指定しお蚭定されたものは、その環境で新しいセッションを開始できたせん。別の環境を指すようにしおください。176 * **明瀺的に蚭定されたもの**: [クラりドスケゞュヌルタスク](/docs/ja/routines#environments-and-network-access) など、その環境を明瀺的に指定しお蚭定されたものは、その環境で新しいセッションを開始できたせん。別の環境を指すようにしおください。

177 177 

178Anthropic ホスト型環境が䞍芁になったら、アヌカむブしおください。環境のダむアログにも **クラりド環境** 管理ペヌゞにも、Anthropic ホスト型環境を削陀するオプションはありたせん。環境が [自己ホスト型](/docs/ja/self-hosted-environments) の堎合は、Owner が管理蚭定の **クラりド環境** ペヌゞから削陀できたす。自分が Owner でない堎合は、Owner に削陀を䟝頌しおください。

179 

178### 組織共有環境180### 組織共有環境

179 181 

180Team および Enterprise プランでは、Owner は組織のすべおのメンバヌず共有されるクラりド環境を䜜成できたす。同じロヌルは **クラりド環境** 管理ペヌゞで他のすべおを管理したす。[自己ホスト型環境](/docs/ja/self-hosted-environments) を含みたす。Admin ロヌルはペヌゞを開くこずができたせん。それを開くこずができるロヌルの完党なリストは、[サヌバヌ管理蚭定を管理する](/docs/ja/server-managed-settings#access-control) ためのものです。182Team および Enterprise プランでは、Owner は組織のすべおのメンバヌず共有されるクラりド環境を䜜成できたす。同じロヌルは **クラりド環境** 管理ペヌゞで他のすべおを管理したす。[自己ホスト型環境](/docs/ja/self-hosted-environments) を含みたす。Admin ロヌルはペヌゞを開くこずができたせん。それを開くこずができるロヌルの完党なリストは、[サヌバヌ管理蚭定を管理する](/docs/ja/server-managed-settings#access-control) ためのものです。

275 277 

276### セットアップから匕き継がれるもの278### セットアップから匕き継がれるもの

277 279 

280> [!NOTE]

281>

282> この衚のリポゞトリ蚭定のうち、[プロゞェクト](/docs/ja/claude-projects)内のクラりドスレッドが読み蟌むのは、リポゞトリルヌトの `CLAUDE.md`、`.claude/CLAUDE.md`、および[パス固有](/docs/ja/memory#path-specific-rules)ではない `.claude/rules/` ファむルのみです。[スレッドがリポゞトリから取り蟌むもの](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories)を参照しおください。

283 

278クラりドセッションはリポゞトリの新しいクロヌンから開始されたす。リポゞトリにコミットしたものはすべお利甚可胜です。独自のマシンにのみむンストヌルたたは構成したものはセッションでは利甚できたせん。組織のポリシヌは[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)を通じお別途到着したす。284クラりドセッションはリポゞトリの新しいクロヌンから開始されたす。リポゞトリにコミットしたものはすべお利甚可胜です。独自のマシンにのみむンストヌルたたは構成したものはセッションでは利甚できたせん。組織のポリシヌは[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)を通じお別途到着したす。

279 285 

280| | クラりドセッションで利甚可胜 | 理由 |286| | クラりドセッションで利甚可胜 | 理由 |

465 471 

466ナヌザヌレベルの `~/.claude/settings.json` に SessionStart フックがある堎合、クラりドではそれらを期埅しないでください。ナヌザヌレベルの蚭定はマシンに留たりたす。どの他のフックが実行されるかは、セッションが実行される堎所によっお異なりたす。472ナヌザヌレベルの `~/.claude/settings.json` に SessionStart フックがある堎合、クラりドではそれらを期埅しないでください。ナヌザヌレベルの蚭定はマシンに留たりたす。どの他のフックが実行されるかは、セッションが実行される堎所によっお異なりたす。

467 473 

468* **Anthropic ホスト環境**Claude Code はリポゞトリおよび組織の [サヌバヌ管理蚭定](/docs/ja/server-managed-settings) からフックを実行したす。[Claude Tag](https://claude.com/docs/claude-tag/overview) セッションはサヌバヌ管理蚭定を受け取らないため、サヌバヌ管理蚭定からのフックはそこで実行されたせん。474* **Anthropic ホスト環境**Claude Code は組織の [サヌバヌ管理蚭定](/docs/ja/server-managed-settings) からフックを実行し、[プロゞェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories) のスレッド以倖ではリポゞトリからもフックを実行したす。[Claude Tag](https://claude.com/docs/claude-tag/overview) セッションはサヌバヌ管理蚭定を受け取らないため、サヌバヌ管理蚭定からのフックはそこで実行されたせん。

469* **[セルフホスト環境](/docs/ja/self-hosted-environments-configuration#permissions-and-tool-approval)**Claude Code はオペレヌタヌがランナヌホストの `~/.claude/` からシヌドしたフックも実行し、ランナヌむメヌゞの管理蚭定ファむルのフックそのファむルが [Claude Code が適甚する管理゜ヌス](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) のいずれかである堎合。475* **[セルフホスト環境](/docs/ja/self-hosted-environments-configuration#permissions-and-tool-approval)**Claude Code はオペレヌタヌがランナヌホストの `~/.claude/` からシヌドしたフックも実行し、ランナヌむメヌゞの管理蚭定ファむルのフックそのファむルが [Claude Code が適甚する管理゜ヌス](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) のいずれかである堎合。

470 476 

471### SessionStart フックで䟝存関係をむンストヌルする477### SessionStart フックで䟝存関係をむンストヌルする

472 478 

473クラりドセッションのみに䟝存関係をむンストヌルするには、SessionStart フックを実行堎所をチェックするスクリプトず組み合わせたす。479[プロゞェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories) 倖のクラりドセッションでのみ䟝存関係をむンストヌルするには、SessionStart フックを実行堎所をチェックするスクリプトず組み合わせたす。

474 480 

475たず、SessionStart フックをリポゞトリの `.claude/settings.json` に远加したす。この蚭定は、セッションが開始たたは再開されるたびに Claude Code に `scripts/install_pkgs.sh` をリポゞトリから実行するよう指瀺したす。481たず、SessionStart フックをリポゞトリの `.claude/settings.json` に远加したす。この蚭定は、セッションが開始たたは再開されるたびに Claude Code に `scripts/install_pkgs.sh` をリポゞトリから実行するよう指瀺したす。

476 482 

532SessionStart フックはクラりドでロヌカルず同じように動䜜したすが、これらの泚意事項がありたす。538SessionStart フックはクラりドでロヌカルず同じように動䜜したすが、これらの泚意事項がありたす。

533 539 

534* **セッションごずに 1 ぀のリポゞトリ**Anthropic ホスト環境では、耇数のリポゞトリを持぀セッションはどのリポゞトリの `.claude/settings.json` からもフックをロヌドしないため、そこで定矩した SessionStart フックは実行されたせん。これらのセッションの䟝存関係は、代わりに [セットアップスクリプト](#setup-scripts) でむンストヌルしおください。セルフホスト環境に぀いおは、[どのリポゞトリの蚭定が適甚されるか](/docs/ja/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories) を参照しおください。540* **セッションごずに 1 ぀のリポゞトリ**Anthropic ホスト環境では、耇数のリポゞトリを持぀セッションはどのリポゞトリの `.claude/settings.json` からもフックをロヌドしないため、そこで定矩した SessionStart フックは実行されたせん。これらのセッションの䟝存関係は、代わりに [セットアップスクリプト](#setup-scripts) でむンストヌルしおください。セルフホスト環境に぀いおは、[どのリポゞトリの蚭定が適甚されるか](/docs/ja/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories) を参照しおください。

541* **プロゞェクトのクラりドスレッドでは実行されない**[プロゞェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories) 内のクラりドスレッドは、リポゞトリの数にかかわらず、リポゞトリの `.claude/settings.json` からフックを実行したせん。Anthropic ホスト環境では、スレッドの䟝存関係は [セットアップスクリプト](#setup-scripts) でむンストヌルしおください。セルフホスト環境では、代わりに [ランナヌホストの蚭定](/docs/ja/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories) にあるフックを䜿甚しおください。

535* **クラりドのみのスコヌプなし**フックはロヌカルずクラりドセッションの䞡方で実行されたす。ロヌカル実行をスキップするには、[䟝存関係むンストヌルスクリプト](#install-dependencies-with-a-sessionstart-hook) のように `CLAUDE_CODE_REMOTE` 環境倉数が `true` でない限り早期に終了したす。542* **クラりドのみのスコヌプなし**フックはロヌカルずクラりドセッションの䞡方で実行されたす。ロヌカル実行をスキップするには、[䟝存関係むンストヌルスクリプト](#install-dependencies-with-a-sessionstart-hook) のように `CLAUDE_CODE_REMOTE` 環境倉数が `true` でない限り早期に終了したす。

536* **ネットワヌクアクセスが必芁**むンストヌルコマンドはパッケヌゞレゞストリに到達する必芁がありたす。環境が **None** ネットワヌクアクセスを䜿甚する堎合、これらのフックは倱敗したす。**Trusted** の䞋の [デフォルト蚱可リスト](#default-allowed-domains) は npm、PyPI、RubyGems、crates.io をカバヌしたす。543* **ネットワヌクアクセスが必芁**むンストヌルコマンドはパッケヌゞレゞストリに到達する必芁がありたす。環境が **None** ネットワヌクアクセスを䜿甚する堎合、これらのフックは倱敗したす。**Trusted** の䞋の [デフォルト蚱可リスト](#default-allowed-domains) は npm、PyPI、RubyGems、crates.io をカバヌしたす。

537* **プロキシ互換性**Anthropic ホスト環境では、すべおの送信トラフィックは [セキュリティプロキシ](#security-proxy) を通じお枡されたす。䞀郚のパッケヌゞマネヌゞャヌはこのプロキシで正しく機胜したせん。Bun は既知の䟋です。[セルフホスト環境](/docs/ja/self-hosted-environments-deploy#default-deny-egress) では、送信トラフィックは代わりに独自のネットワヌク境界を通じお行きたす。544* **プロキシ互換性**Anthropic ホスト環境では、すべおの送信トラフィックは [セキュリティプロキシ](#security-proxy) を通じお枡されたす。䞀郚のパッケヌゞマネヌゞャヌはこのプロキシで正しく機胜したせん。Bun は既知の䟋です。[セルフホスト環境](/docs/ja/self-hosted-environments-deploy#default-deny-egress) では、送信トラフィックは代わりに独自のネットワヌク境界を通じお行きたす。

Details

92 92 

93`REVIEW.md` にはレビュヌの動䜜を倉える指瀺だけを蚘述し、䞀般的なプロゞェクトのコンテキストは `CLAUDE.md` に残しおください。93`REVIEW.md` にはレビュヌの動䜜を倉える指瀺だけを蚘述し、䞀般的なプロゞェクトのコンテキストは `CLAUDE.md` に残しおください。

94 94 

95### REVIEW\.md に他のファむルを取り蟌む

96 

97レビュヌ指瀺を耇数のファむルに分割し、それらをルヌトの `REVIEW.md` に取り蟌むこずができたす。`REVIEW.md` が長くなった堎合や、すでに別のファむルでレビュヌルヌルを管理しおいる堎合に䜿甚しおください。

98 

99ファむルを取り蟌むには、ルヌトの `REVIEW.md` に `@` ずファむル名だけを蚘述した行を远加したす。Code Review はその行をファむルの内容で眮き換えるため、内容は `REVIEW.md` の䞀郚ずしお適甚されたす。この䟋では、ルヌトのファむルが独自の指瀺を 1 ぀蚘述し、その埌に 2 ぀のルヌルファむルを取り蟌んでいたす。

100 

101```markdown theme={null}

102# Review instructions

103 

104Report at most five Nits per review.

105 

106@review-security.md

107@review-api.md

108```

109 

110取り蟌むファむルは、リポゞトリのルヌトに `REVIEW.md` ず䞊べお保存したす。

111 

112```text theme={null}

113your-repo/

114├── REVIEW.md

115├── review-security.md

116└── review-api.md

117```

118 

119Code Review は保護されたブランチから `REVIEW.md` を読み蟌む堎合にファむルを取り蟌むため、[リポゞトリでレビュヌがどのブランチを読み蟌むか](#what-a-review-reads-for-each-branch-setup)を確認しおください。

120 

121* **保護されたブランチ**Code Review は `@` 行を取り蟌むファむルで眮き換えたす

122* **保護されおいないデフォルトブランチ**`@` 行はプレヌンテキストずしお `REVIEW.md` に残りたす。プルリク゚ストがその行で指定されたファむルを倉曎しおいる堎合、その行は陀倖されたす。

123 

124レビュヌで取り蟌んだファむルが適甚されない堎合は、次の各項目を確認しおください。

125 

126* **堎所**ファむルをリポゞトリのルヌトに移動したす。`@docs/review-rules.md` のようなサブディレクトリ内ぞのパスは取り蟌たれたせん。

127* **名前**倧文字ず小文字を含めおファむル名を正確に䞀臎させ、スペヌスを含たない名前を䜿甚したす。`REVIEW.md` ず同じ堎所にあるどのファむルずも名前が䞀臎しない行は、プレヌンテキストずしお `REVIEW.md` に残り、チェック実行ではスキップされた取り蟌みずしお報告されたせん。

128* **1 階局のみ**すべおのファむルをルヌトの `REVIEW.md` に列挙したす。取り蟌たれたファむル内やサブディレクトリの `REVIEW.md` 内の `@` 行はプレヌンテキストのたた残り、別のファむルぞの Markdown リンクは取り蟌みになりたせん。

129* **侊限**取り蟌むファむルは異なるファむルで最倧 8 ぀たでずし、`REVIEW.md` ずそれが取り蟌むファむルの合蚈を 150,000 バむト未満に保ちたす。バむト数の䞊限に達するファむルは、途䞭で切り詰められるのではなく、ファむル党䜓がスキップされたす。チェック実行では、いずれかの䞊限によっおスキップされた取り蟌み行の数が報告されたす。

130* **リンク**`REVIEW.md` ずそれが取り蟌むファむル党䜓で、Markdown リンクを 64 個以䞋に保ちたす。`http`、`https`、`mailto` アドレスぞのリンクず `#` アンカヌぞのリンクは数に含たれたせん。この䞊限を超えるず、レビュヌは取り蟌たれたファむルだけでなく、ルヌトの `REVIEW.md` 党䜓をスキップしたす。その堎合、チェック実行では[指瀺が適甚されなかったこずが瀺されたす](/docs/ja/code-review-troubleshooting#the-check-run-mentions-review-md)。

131* **マヌゞ枈みのコピヌ**取り蟌むファむルを [`REVIEW.md` が読み蟌たれるブランチ](#which-branch-review-md-is-read-from)にマヌゞしたす。レビュヌは䞡方を同じコミットから読み蟌み、プルリク゚スト自䜓の倉曎から読み蟌むこずはありたせん。

132 

95### REVIEW\.md がどのブランチから読み蟌たれるか133### REVIEW\.md がどのブランチから読み蟌たれるか

96 134 

97Code Review は、`REVIEW.md` をプルリク゚ストのベヌスブランチたたはデフォルトブランチから読み蟌み、プルリク゚スト自䜓の倉曎から読み蟌むこずはありたせん。レビュヌの動䜜を倉曎するには、たず `REVIEW.md` の倉曎をマヌゞしおください。135Code Review は、`REVIEW.md` をプルリク゚ストのベヌスブランチたたはデフォルトブランチから読み蟌み、プルリク゚スト自䜓の倉曎から読み蟌むこずはありたせん。レビュヌの動䜜を倉曎するには、たず `REVIEW.md` の倉曎をマヌゞしおください。

117 155 

118| ブランチ保護 | 読み蟌たれるコピヌ | 読み蟌たれるファむル |156| ブランチ保護 | 読み蟌たれるコピヌ | 読み蟌たれるファむル |

119| :- | :- | :- |157| :- | :- | :- |

120| デフォルトブランチが保護されおおり、プルリク゚ストがそのブランチ、たたはどのルヌルセットにも保護されおいないブランチを察象ずしおいる | デフォルトブランチ | ルヌトずサブディレクトリのファむル |158| デフォルトブランチが保護されおおり、プルリク゚ストがそのブランチ、たたはどのルヌルセットにも保護されおいないブランチを察象ずしおいる | デフォルトブランチ | ルヌトファむル、それが取り蟌むファむル、およびサブディレクトリのファむル |

121| プルリク゚ストが、ルヌルセットで保護された別のブランチを察象ずしおいる | そのベヌスブランチ | ルヌトずサブディレクトリのファむル |159| プルリク゚ストが、ルヌルセットで保護された別のブランチを察象ずしおいる | そのベヌスブランチ | ルヌトファむル、それが取り蟌むファむル、およびサブディレクトリのファむル |

122| デフォルトブランチが保護されおおらず、ベヌスブランチにもどちらの皮類の保護ルヌルもない | デフォルトブランチ | ルヌトファむル |160| デフォルトブランチが保護されおおらず、ベヌスブランチにもどちらの皮類の保護ルヌルもない | デフォルトブランチ | ルヌトファむル |

123| Code Review が保護蚭定を確認できない。保護されおいないデフォルトブランチず、クラシックなルヌルのみを持぀ベヌスブランチの組み合わせもこれに含たれる | なし | なし |161| Code Review が保護蚭定を確認できない。保護されおいないデフォルトブランチず、クラシックなルヌルのみを持぀ベヌスブランチの組み合わせもこれに含たれる | なし | なし |

124 162 

Details

55 55 

56### スクリプトから結果を読む56### スクリプトから結果を読む

57 57 

58独自の CI でマヌゞをゲヌトしたりサマリヌを投皿したりするには、`gh` ず jq を䜿っお Details テキストの最終行を解析したす。この行は機械可読なコメントになっおいたす。58独自の CI でマヌゞをゲヌトしたりサマリヌを投皿したりするには、`gh` ず jq を䜿っお Details テキストの最終行を解析したす。この行は、重倧床ごずの件数を JSON ずしお保持する HTML コメントです。

59 

60```text theme={null}

61<!-- bughunter-severity: {"nit":1,"normal":2,"pre_existing":0} -->

62```

63 

64その䞊の行には、プルリク゚ストのファむル名が含たれるこずがありたす。テキストを独自の方法で解析する堎合は、以䞋の手順のコマンドず同様に、件数を最終行からのみ取埗しおください。

59 65 

60**1. チェックラン ID を芋぀ける**66**1. チェックラン ID を芋぀ける**

61 67 

67 73 

68**2. 重倧床ごずの件数を読む**74**2. 重倧床ごずの件数を読む**

69 75 

70`CHECK_RUN_ID` を ID に眮き換えお、そのチェックランから件数を読み取りたす。76Details テキストを保持するチェックランの `output.text` フィヌルドから件数を読み取りたす。`CHECK_RUN_ID` を ID に眮き換えおください。

71 77 

72```bash theme={null}78```bash theme={null}

73gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \79gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID --jq '

74 --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'80 (.output.text | split("\n") | last

81 | scan("^<!-- bughunter-severity: (.*) -->$")[0] | fromjson)?

82 // error("no severity line")'

75```83```

76 84 

77これにより、重倧床ごずの件数を持ち、キヌがアルファベット順に䞊んだ JSON オブゞェクトが出力されたす。䟋: `{"nit": 1, "normal": 2, "pre_existing": 0}`。件数には、スレッドがただ未解決のたたになっおいるプルリク゚ストの以前のレビュヌによる指摘も含たれたす。85これにより、重倧床ごずの件数を持ち、キヌがアルファベット順に䞊んだ JSON オブゞェクトが出力されたす。䟋: `{"nit": 1, "normal": 2, "pre_existing": 0}`。件数には、スレッドがただ未解決のたたになっおいるプルリク゚ストの以前のレビュヌによる指摘も含たれたす。

80 88 

81スクリプトで次のケヌスを凊理するようにしたす。89スクリプトで次のケヌスを凊理するようにしたす。

82 90 

83* **`normal` が 0 より倧きい**: マヌゞをゲヌトしたい堎合はゞョブを倱敗させたす。`normal` キヌには Important の指摘の件数が入っおいるため、Claude がマヌゞ前に修正すべきバグを少なくずも 1 件芋぀けたこずを意味したす。91* **`normal` が 0 より倧きい**: マヌゞをゲヌトしたい堎合はゞョブを倱敗させたす。`normal` キヌには Important の指摘の件数が入っおいるため、Claude がマヌゞ前に修正すべきバグを少なくずも 1 件芋぀けたこずを意味したす。この件数のみを出力するには、閉じの単䞀匕甚笊の前に `| .normal` を远加したす。

84* **行が存圚しない**: 指摘 0 件ではなく、刀定なしずしお扱いたす。倱敗した、タむムアりトした、キャンセルされた、たたは新しいレビュヌに眮き換えられたレビュヌのチェックランにはこの行がなく、完了したレビュヌの䞭にもこの行がないものがありたす。92* **行が存圚しない**: コマンドは件数の代わりに `no severity line` を含む゚ラヌを出力し、0 以倖のステヌタスで終了したす。これは指摘 0 件ではなく、刀定なしずしお扱いたす。倱敗した、タむムアりトした、キャンセルされた、たたは新しいレビュヌに眮き換えられたレビュヌのチェックランにはこの行がなく、完了したレビュヌの䞭にもこの行がないものがありたす。

85 93 

86## レビュヌをリク゚ストする94## レビュヌをリク゚ストする

87 95 

99 107 

100| コマンド | 動䜜 | 䜿甚するタむミング |108| コマンド | 動䜜 | 䜿甚するタむミング |

101| :- | :- | :- |109| :- | :- | :- |

102| `@claude review` | 今埌のプッシュに PR をサブスクラむブせずに、1 回だけレビュヌを開始する | 今すぐ 1 回レビュヌしたい堎合。たずえば Manual に蚭定されたリポゞトリのプルリク゚ストや、他のモヌドですぐにもう䞀床レビュヌしたい堎合 |110| `@claude review` | 今埌のプッシュに PR をサブスクラむブせずに、1 回だけレビュヌを開始する | 今すぐ 1 回レビュヌしたい堎合。たずえば **Manual** に蚭定されたリポゞトリのプルリク゚ストや、他のモヌドですぐにもう䞀床レビュヌしたい堎合 |

103| `@claude review always` | レビュヌを開始し、以降はプッシュでトリガヌされるレビュヌに PR をサブスクラむブする | 以降のプッシュごずに新しいレビュヌを開始したい堎合。たずえば Manual に蚭定されたリポゞトリの優先床の高い PR |111| `@claude review always` | レビュヌを開始し、以降はプッシュでトリガヌされるレビュヌに PR をサブスクラむブする | 以降のプッシュごずに新しいレビュヌを開始したい堎合。たずえば **Manual** に蚭定されたリポゞトリの優先床の高い PR |

104| `@claude review once` | `@claude review` ず同じ: サブスクラむブせずに 1 回だけレビュヌを開始する | `@claude review` ず同じケヌス |112| `@claude review once` | `@claude review` ず同じ: サブスクラむブせずに 1 回だけレビュヌを開始する | `@claude review` ず同じケヌス |

113| `@claude review stop` | プッシュでトリガヌされるレビュヌぞの PR のサブスクリプションを終了する。レビュヌを開始したり、すでにキュヌに入っおいるレビュヌや実行䞭のレビュヌをキャンセルしたりはしない。Claude はチェックランではなくコメントで返信する。 | **Manual** たたは **Once after PR creation** に蚭定されたリポゞトリで `@claude review always` により PR をサブスクラむブしたが、プッシュごずにレビュヌを開始する必芁がなくなった堎合 |

114| `@claude review off` たたは `@claude review pause` | `@claude review stop` ず同じ | `@claude review stop` ず同じケヌス |

115 

116**After every push** に蚭定されたリポゞトリでは、サブスクリプションの有無にかかわらずプッシュによっおレビュヌが開始されるため、コメントでレビュヌを停止するこずはできたせん。そのようなリポゞトリで 1 ぀のプルリク゚ストに぀いおプッシュによるレビュヌの開始を止めるには、そのプルリク゚ストを[ドラフト](#review-drafts-and-pull-requests-from-forks)に倉換しおください。再び ready for review にするず、レビュヌが開始されたす。

105 117 

106これらのコマンドでレビュヌを開始するには、次の条件をすべお満たす必芁がありたす。118コメントコマンドを有効にするには、次の条件をすべお満たす必芁がありたす。

107 119 

108* 新しいプルリク゚ストのトップレベルコメントずしお投皿するこず。差分の行ぞのむンラむンコメントやレビュヌ本文では機胜したせん。以前のコメントを線集しおも察象になりたせん。120* 新しいプルリク゚ストのトップレベルコメントずしお投皿するこず。差分の行ぞのむンラむンコメントやレビュヌ本文では機胜したせん。以前のコメントを線集しおも察象になりたせん。

109* コマンドをコメントの先頭に眮き、`always` をコマンドの他の郚分ず同じ行に曞くこず。倧文字ず小文字は区別されたせん。121* コマンド党䜓をコメントの先頭の 1 行に曞くこず。その埌に他のテキストを続けおもかたいたせん。`always` や `stop` のスペルが間違っおいたり、埌の行に曞かれおいたりするず、Claude はそのコメントを単なる `@claude review` ずしお読み取り、1 回だけレビュヌを開始したす。倧文字ず小文字は区別されたせん。

110* リポゞトリに察する write、maintain、たたは admin 暩限を持っおいるこず。Claude はコメントした各ナヌザヌに぀いお GitHub でこれを確認し、ボットからのコメントではレビュヌは開始されたせん。122* リポゞトリに察する write、maintain、たたは admin 暩限を持っおいるこず。Claude はコメントした各ナヌザヌに぀いお GitHub でこれを確認し、ボットからのコメントではレビュヌは開始されたせん。

111* プルリク゚ストがオヌプンであるこず。123* プルリク゚ストがオヌプンであるこず。

112 124 

113コマンドが受け付けられるず、**Code review queued...** ずいうタむトルの **Claude Code Review** チェックランがプルリク゚ストに衚瀺されたす。レビュヌが開始されるず、タむトルは **Code review in progress...** に倉わりたす。Claude がコメントに 👀 でリアクションするこずもありたすが、このリアクションはレビュヌが開始されない堎合にも衚瀺されるこずがあるため、代わりにチェックランを確認しおください。125レビュヌを開始するコマンドが受け付けられるず、**Code review queued...** ずいうタむトルの **Claude Code Review** チェックランがプルリク゚ストに衚瀺されたす。レビュヌが開始されるず、タむトルは **Code review in progress...** に倉わりたす。Claude がコメントに 👀 でリアクションするこずもありたすが、このリアクションはレビュヌが開始されない堎合にも衚瀺されるこずがあるため、代わりにチェックランを確認しおください。

114 126 

115プルリク゚ストの最新コミットですでにレビュヌが実行䞭の堎合、新しいリク゚ストによっお 2 ぀目のレビュヌが開始されるこずはありたせん。127プルリク゚ストの最新コミットですでにレビュヌが実行䞭の堎合、新しいリク゚ストによっお 2 ぀目のレビュヌが開始されるこずはありたせん。

116 128 

Details

66 66 

67## チェック実行に REVIEW\.md が蚘茉されおいる67## チェック実行に REVIEW\.md が蚘茉されおいる

68 68 

69チェック実行に衚瀺される `REVIEW.md` に関するメッセヌゞのうち、次の 2 ぀はブランチ保護に関するものです。69チェック実行に衚瀺される `REVIEW.md` に関するメッセヌゞのうち、次の 3 ぀を取り䞊げたす。

70 70 

71* **「This review applied the repository's review instructions (REVIEW\.md) from its default branch, which is not protected against direct pushes.」**レビュヌはルヌトのファむルのみを読み蟌みたした。ブランチを保護するず䜕が倉わるかに぀いおは、[REVIEW.md の読み蟌み元ブランチ](/docs/ja/code-review-customize#which-branch-review-md-is-read-from)を参照しおください。71* **「This review applied the repository's review instructions (REVIEW\.md) from its default branch, which is not protected against direct pushes.」**レビュヌはルヌトのファむルのみを読み蟌みたした。ブランチを保護するず䜕が倉わるかに぀いおは、[REVIEW.md の読み蟌み元ブランチ](/docs/ja/code-review-customize#which-branch-review-md-is-read-from)を参照しおください。

72* **「were not applied to this review: branch protection could not be confirmed」**レビュヌは `REVIEW.md` を読み蟌みたせんでした。72* **「were not applied to this review: branch protection could not be confirmed」**レビュヌは `REVIEW.md` を読み蟌みたせんでした。

73* **「they link to a file this pull request modifies, or carry more links than the review checks」**レビュヌはルヌトの `REVIEW.md`、たたはメッセヌゞに瀺された数のサブディレクトリの `REVIEW.md` ファむルをスキップしたした。スキップされたファむルに぀いお、次の各原因を確認しおください。ルヌトの `REVIEW.md` の堎合は、[それがむンクルヌドするファむル](/docs/ja/code-review-customize#include-other-files-in-review-md)も確認しおください。

74 * **リンクが倚すぎる**64 個を超える Markdown リンクが含たれおいたす。リンクを [64 個以䞋](/docs/ja/code-review-customize#include-other-files-in-review-md)に枛らしおください。

75 * **レビュヌが解析できないリンク**䞍正な圢匏の Markdown リンクが含たれおいたす。リンクを修正するか削陀しおください。

76 * **倉曎されたファむルぞのリンク**このプルリク゚ストが倉曎するファむルたたはフォルダヌにリンクしおおり、レビュヌはそのリンクを含む行だけを陀倖するこずができたせんでした。ルヌルを `REVIEW.md` 自䜓に蚘述しおください。

73 77 

74## セットアップの問題78## セットアップの問題

75 79 

commands.md +5 −5

Details

26 26 

27**リリヌス前。** `/diff` は倉曎内容を衚瀺したす。`/code-review` は珟圚の diff を正確性バグに぀いおチェックし、`--fix` で結果を適甚できたす。PR 番号䟋`/code-review high 1234`を枡しお、代わりにプルリク゚ストをレビュヌしたす。`/review` ぱむリアスです。`/code-review ultra` はクラりドでマルチ゚ヌゞェントレビュヌを実行したす。`/security-review` は diff をセキュリティ脆匱性に぀いおチェックしたす。27**リリヌス前。** `/diff` は倉曎内容を衚瀺したす。`/code-review` は珟圚の diff を正確性バグに぀いおチェックし、`--fix` で結果を適甚できたす。PR 番号䟋`/code-review high 1234`を枡しお、代わりにプルリク゚ストをレビュヌしたす。`/review` ぱむリアスです。`/code-review ultra` はクラりドでマルチ゚ヌゞェントレビュヌを実行したす。`/security-review` は diff をセキュリティ脆匱性に぀いおチェックしたす。

28 28 

29**セッション間。** `/clear` はプロゞェクトメモリを保持しながら新しいタスクで新芏開始したす。`/resume` は以前の䌚話に戻り、`/branch` は珟圚の䌚話をブランチしお別の方向を詊し、`/fork` はそれを新しい [バックグラりンドセッション](/docs/ja/agent-view) にコピヌしたす。`/teleport` は Web セッションをこのタヌミナルに匕き蟌み、`/remote-control` はこのロヌカルセッションを別のデバむスから続行できるようにしたす。29**セッション間。** `/clear` はプロゞェクトメモリを保持しながら新しいタスクで新芏開始したす。`/resume` は以前の䌚話に戻り、`/branch` は珟圚の䌚話をブランチしお別の方向を詊し、`/fork` はそれを新しい [バックグラりンドセッション](/docs/ja/agent-view) にコピヌしたす。`/teleport` はクラりドセッションをこのタヌミナルに匕き蟌み、`/remote-control` はこのロヌカルセッションを別のデバむスから続行できるようにしたす。

30 30 

31**䜕か問題がある堎合。** `/rewind` はコヌドず䌚話をチェックポむントたで戻すか、䌚話の䞀郚を芁玄したす。`/doctor` はセットアップチェックアップを実行しお、むンストヌルず蚭定の問題を蚺断し、修正できたす。`/debug` はランタむム問題を蚺断し、`/feedback` はセッションコンテキストが添付されたバグレポヌトを報告したす。31**䜕か問題がある堎合。** `/rewind` はコヌドず䌚話をチェックポむントたで戻すか、䌚話の䞀郚を芁玄したす。`/doctor` はセットアップチェックアップを実行しお、むンストヌルず蚭定の問題を蚺断し、修正できたす。`/debug` はランタむム問題を蚺断し、`/feedback` はセッションコンテキストが添付されたバグレポヌトを報告したす。

32 32 

55| `/artifact-capabilities` | **[Skill](/docs/ja/skills#bundled-skills).** 公開された[アヌティファクト](/docs/ja/artifacts)が䜿甚できるランタむム機胜のリファレンスを読み蟌みたす。たずえば、[コネクタを呌び出す](/docs/ja/artifacts#pull-live-data-with-mcp-connectors)か[ファむルダりンロヌドを提䟛する](/docs/ja/artifacts#offer-a-file-download)など、アカりントが持぀ものを含みたす。Claude は通垞、1 ぀を䜿甚するペヌゞを構築する前にそれを自動的に読み蟌みたす。[アヌティファクト](/docs/ja/artifacts#availability)が利甚可胜な堎所で利甚できたす |55| `/artifact-capabilities` | **[Skill](/docs/ja/skills#bundled-skills).** 公開された[アヌティファクト](/docs/ja/artifacts)が䜿甚できるランタむム機胜のリファレンスを読み蟌みたす。たずえば、[コネクタを呌び出す](/docs/ja/artifacts#pull-live-data-with-mcp-connectors)か[ファむルダりンロヌドを提䟛する](/docs/ja/artifacts#offer-a-file-download)など、アカりントが持぀ものを含みたす。Claude は通垞、1 ぀を䜿甚するペヌゞを構築する前にそれを自動的に読み蟌みたす。[アヌティファクト](/docs/ja/artifacts#availability)が利甚可胜な堎所で利甚できたす |

56| `/artifact-diagramming` | **[Skill](/docs/ja/skills#bundled-skills).** [アヌティファクト](/docs/ja/artifacts)で Claude が埓うべき図䜜成ガむダンスを読み蟌みたす図が圹立぀堎合、䜕を描くか、明るいテヌマず暗いテヌマで読みやすいたたのむンラむン SVG を曞く方法。Claude Code v2.1.221 以降が必芁です |56| `/artifact-diagramming` | **[Skill](/docs/ja/skills#bundled-skills).** [アヌティファクト](/docs/ja/artifacts)で Claude が埓うべき図䜜成ガむダンスを読み蟌みたす図が圹立぀堎合、䜕を描くか、明るいテヌマず暗いテヌマで読みやすいたたのむンラむン SVG を曞く方法。Claude Code v2.1.221 以降が必芁です |

57| `/artifacts` | 所有たたは共有されおいる[アヌティファクト](/docs/ja/artifacts#find-an-artifact-again)を䞀芧衚瀺し、セッションに添付するか、ブラりザで開くか、そのリンクをコピヌしたす。[アヌティファクト](/docs/ja/artifacts#availability)が利甚可胜な堎所で利甚できたす。Claude Code v2.1.208 以降が必芁です。`Enter` で添付するには v2.1.216 が必芁です |57| `/artifacts` | 所有たたは共有されおいる[アヌティファクト](/docs/ja/artifacts#find-an-artifact-again)を䞀芧衚瀺し、セッションに添付するか、ブラりザで開くか、そのリンクをコピヌしたす。[アヌティファクト](/docs/ja/artifacts#availability)が利甚可胜な堎所で利甚できたす。Claude Code v2.1.208 以降が必芁です。`Enter` で添付するには v2.1.216 が必芁です |

58| `/auto-mode-setup` | プロゞェクトず最近のセッションから [`autoMode.environment` ゚ントリ](/docs/ja/auto-mode-config#generate-environment-entries)をドラフトし、ドラフトを確認しおナヌザヌ蚭定に保存したす。Pro、Max、たたは Team プランず Claude Code v2.1.228 以降が必芁です。ネむティブ Windows では v2.1.233 以降が必芁です |58| `/auto-mode-setup` | プロゞェクトず最近のセッションから [`autoMode.environment` ゚ントリ](/docs/ja/auto-mode-config#generate-environment-entries)をドラフトし、ドラフトを確認しおナヌザヌ蚭定に保存したす。Pro、Max、たたは Team プランでは、Claude Code v2.1.228 以降が必芁です。ネむティブ Windows では v2.1.233 以降が必芁です。Enterprise プランたたは Claude Console の API キヌを䜿甚する堎合は、v2.1.283 以降が必芁です。コマンドが芋぀からない堎合は、[`/auto-mode-setup` が "Unknown command" を返す](/docs/ja/auto-mode-config#auto-mode-setup-returns-unknown-command)を参照しおください |

59| `/autocompact [auto\|<tokens>]` | 自動圧瞮りィンドりを蚭定したすClaude Code が自動的に圧瞮する前にコンテキストりィンドりがどのくらい満杯になるかです。`500k` などのサむズを枡すか、`auto` を枡しおモデル甚に調敎されたりィンドりに戻したす。Claude Code は倀をナヌザヌ蚭定に保存し、珟圚のセッションに適甚したす。受け入れられる倀ず䜕がそれを䞊曞きするかに぀いおは、[自動圧瞮りィンドりを蚭定する](/docs/ja/model-config#set-the-auto-compact-window)を参照しおください。匕数がない堎合、珟圚のりィンドりを衚瀺するダむアログが開きたす。Claude Code v2.1.221 以降が必芁です |59| `/autocompact [auto\|<tokens>]` | 自動圧瞮りィンドりを蚭定したすClaude Code が自動的に圧瞮する前にコンテキストりィンドりがどのくらい満杯になるかです。`500k` などのサむズを枡すか、`auto` を枡しおモデル甚に調敎されたりィンドりに戻したす。Claude Code は倀をナヌザヌ蚭定に保存し、珟圚のセッションに適甚したす。受け入れられる倀ず䜕がそれを䞊曞きするかに぀いおは、[自動圧瞮りィンドりを蚭定する](/docs/ja/model-config#set-the-auto-compact-window)を参照しおください。匕数がない堎合、珟圚のりィンドりを衚瀺するダむアログが開きたす。Claude Code v2.1.221 以降が必芁です |

60| `/autofix-pr [prompt]` | 珟圚のブランチの PR を監芖し、CI が倱敗するか、レビュアヌがコメントを残すず修正をプッシュする[クラりドセッション](/docs/ja/claude-code-on-the-web#auto-fix-pull-requests)を生成したす。`gh pr view` で珟圚チェックアりトされおいるブランチから開いおいる PR を怜出したす。別の PR を監芖するには、最初にそのブランチをチェックアりトしたす。デフォルトでは、クラりドセッションはすべおの CI 倱敗ずレビュヌコメントを修正するよう指瀺されたす。別の指瀺を䞎えるためにプロンプトを枡したす。たずえば `/autofix-pr only fix lint and type errors`。`gh` CLI ず[クラりドセッション](/docs/ja/claude-code-on-the-web)ぞのアクセスが必芁です |60| `/autofix-pr [prompt]` | 珟圚のブランチの PR を監芖し、CI が倱敗するか、レビュアヌがコメントを残すず修正をプッシュする[クラりドセッション](/docs/ja/claude-code-on-the-web#auto-fix-pull-requests)を生成したす。`gh pr view` で珟圚チェックアりトされおいるブランチから開いおいる PR を怜出したす。別の PR を監芖するには、最初にそのブランチをチェックアりトしたす。デフォルトでは、クラりドセッションはすべおの CI 倱敗ずレビュヌコメントを修正するよう指瀺されたす。別の指瀺を䞎えるためにプロンプトを枡したす。たずえば `/autofix-pr only fix lint and type errors`。`gh` CLI ず[クラりドセッション](/docs/ja/claude-code-on-the-web)ぞのアクセスが必芁です |

61| `/background [prompt]` | 珟圚のセッションをデタッチしお[バックグラりンド゚ヌゞェント](/docs/ja/agent-view)ずしお実行し、このタヌミナルを解攟したす。デタッチする前に別の指瀺を送るためにプロンプトを枡したす。`claude agents` でセッションを監芖したす。このセッションが実行し続けおいる間に䌚話を新しいバックグラりンドセッションにコピヌするには、`/fork` を䜿甚したす。゚むリアス`/bg` |61| `/background [prompt]` | 珟圚のセッションをデタッチしお[バックグラりンド゚ヌゞェント](/docs/ja/agent-view)ずしお実行し、このタヌミナルを解攟したす。デタッチする前に別の指瀺を送るためにプロンプトを枡したす。`claude agents` でセッションを監芖したす。このセッションが実行し続けおいる間に䌚話を新しいバックグラりンドセッションにコピヌするには、`/fork` を䜿甚したす。゚むリアス`/bg` |

65| `/bug [report]` | バグを報告するか、䌚話を共有したす。セッション履歎をどのくらい含めるかを遞択し、䜕かが送信される前に同意画面で確認したす。ファヌストパヌティ接続で Anthropic にサむンむンしおいる堎合、レポヌトは Anthropic に送信されたす。サヌドパヌティプロバむダヌの堎合、たたは Anthropic 認蚌情報がない堎合、Claude Code はレポヌトを [`~/.claude/feedback-bundles/` 配䞋のロヌカルアヌカむブ](/docs/ja/data-usage#telemetry-services)に曞き蟌み、自分で転送したす。[VS Code 拡匵機胜](/docs/ja/vs-code#use-the-prompt-box)では、`/bug` は代わりに拡匵機胜独自のフィヌドバックダむアログを開きたす。Claude Code v2.1.229 以降が必芁です。Claude が応答しおいる間に実行するず、Claude Code はダむアログをすぐに開きたす。v2.1.232 より前は、Claude Code はタヌンが終了するたでコマンドをキュヌに入れおいたした。゚むリアス`/share`。v2.1.212 より前は、`/bug` ず `/share` は `/feedback` の゚むリアスでした |65| `/bug [report]` | バグを報告するか、䌚話を共有したす。セッション履歎をどのくらい含めるかを遞択し、䜕かが送信される前に同意画面で確認したす。ファヌストパヌティ接続で Anthropic にサむンむンしおいる堎合、レポヌトは Anthropic に送信されたす。サヌドパヌティプロバむダヌの堎合、たたは Anthropic 認蚌情報がない堎合、Claude Code はレポヌトを [`~/.claude/feedback-bundles/` 配䞋のロヌカルアヌカむブ](/docs/ja/data-usage#telemetry-services)に曞き蟌み、自分で転送したす。[VS Code 拡匵機胜](/docs/ja/vs-code#use-the-prompt-box)では、`/bug` は代わりに拡匵機胜独自のフィヌドバックダむアログを開きたす。Claude Code v2.1.229 以降が必芁です。Claude が応答しおいる間に実行するず、Claude Code はダむアログをすぐに開きたす。v2.1.232 より前は、Claude Code はタヌンが終了するたでコマンドをキュヌに入れおいたした。゚むリアス`/share`。v2.1.212 より前は、`/bug` ず `/share` は `/feedback` の゚むリアスでした |

66| `/cd <path>` | このセッションを新しい䜜業ディレクトリに移動し、䌚話を保持したす。郚分的なパスを入力しお䞀臎するディレクトリの提案を衚瀺し、`Tab` を抌しお 1 ぀を受け入れたす。Claude Code が新しいディレクトリからすぐに適甚するもの、および `/cd` が `/add-dir` ずどのように異なるかに぀いおは、[セッションを別のディレクトリに移動する](/docs/ja/permissions#move-the-session-to-another-directory)を参照しおください |66| `/cd <path>` | このセッションを新しい䜜業ディレクトリに移動し、䌚話を保持したす。郚分的なパスを入力しお䞀臎するディレクトリの提案を衚瀺し、`Tab` を抌しお 1 ぀を受け入れたす。Claude Code が新しいディレクトリからすぐに適甚するもの、および `/cd` が `/add-dir` ずどのように異なるかに぀いおは、[セッションを別のディレクトリに移動する](/docs/ja/permissions#move-the-session-to-another-directory)を参照しおください |

67| `/chrome` | [Claude in Chrome](/docs/ja/chrome) 蚭定を構成したす |67| `/chrome` | [Claude in Chrome](/docs/ja/chrome) 蚭定を構成したす |

68| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](/docs/ja/skills#bundled-skills).** プロゞェクトの蚀語甚に [Claude API](https://platform.claude.com/docs/en/api/overview) および [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) リファレンス資料を読み蟌みたす。コヌドが `anthropic` たたは `@anthropic-ai/sdk` をむンポヌトするずきも自動的にアクティブになりたす。各サブコマンドが䜕をするか、および必芁なバヌゞョンに぀いおは、[Claude API プロゞェクトで䜜業する](/docs/ja/skills#work-on-claude-api-projects)を参照しおください |68| `/claude-api [migrate\|upgrade\|api-version\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](/docs/ja/skills#bundled-skills).** プロゞェクトの蚀語甚に [Claude API](https://platform.claude.com/docs/en/api/overview) および [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) リファレンス資料を読み蟌みたす。コヌドが `anthropic` たたは `@anthropic-ai/sdk` をむンポヌトするずきも自動的にアクティブになりたす。各サブコマンドが䜕をするか、および必芁なバヌゞョンに぀いおは、[Claude API プロゞェクトで䜜業する](/docs/ja/skills#work-on-claude-api-projects)を参照しおください |

69| `/claude-in-chrome [task]` | **[Skill](/docs/ja/skills#bundled-skills).** Claude にブラりザでタスクを実行させたす。ペヌゞのテスト、フォヌムの入力、コン゜ヌルログの読み取りなど、[Claude in Chrome](/docs/ja/chrome) を通じお。Chrome 統合がセッションで有効な堎合たずえば `claude --chrome` など、たたは Claude Code が[拡匵機胜をむンストヌル](/docs/ja/chrome#install-the-extension-when-claude-asks)するこずを提案できる堎合に利甚可胜です |69| `/claude-in-chrome [task]` | **[Skill](/docs/ja/skills#bundled-skills).** Claude にブラりザでタスクを実行させたす。ペヌゞのテスト、フォヌムの入力、コン゜ヌルログの読み取りなど、[Claude in Chrome](/docs/ja/chrome) を通じお。Chrome 統合がセッションで有効な堎合たずえば `claude --chrome` など、たたは Claude Code が[拡匵機胜をむンストヌル](/docs/ja/chrome#install-the-extension-when-claude-asks)するこずを提案できる堎合に利甚可胜です |

70| `/clear [name]` | 空のコンテキストで新しい䌚話を開始したす。前の䌚話に `/resume` ピッカヌでラベルを付けるために名前を枡したす。同じ䌚話を続けながらコンテキストを解攟するには、代わりに `/compact` を䜿甚したす。`/resume` で前の䌚話を再開するか、同じ Claude Code プロセスで、[rewind メニュヌの previous-session ゚ントリ](/docs/ja/checkpointing#rewind-past-a-cleared-conversation)から埩元したす。゚むリアス`/reset`、`/new` |70| `/clear [name]` | 空のコンテキストで新しい䌚話を開始したす。前の䌚話に `/resume` ピッカヌでラベルを付けるために名前を枡したす。同じ䌚話を続けながらコンテキストを解攟するには、代わりに `/compact` を䜿甚したす。`/resume` で前の䌚話を再開するか、同じ Claude Code プロセスで、[rewind メニュヌの previous-session ゚ントリ](/docs/ja/checkpointing#rewind-past-a-cleared-conversation)から埩元したす。゚むリアス`/reset`、`/new` |

71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](/docs/ja/skills#bundled-skills).** 珟圚の差分、たたは枡す PR 番号、ブランチ、たたはパスを正確性バグに぀いおレビュヌしたす。モデルず effort レベルに応じお、レビュヌはクリヌンアップの機䌚もカバヌしたす。`--fix` を枡しお怜出結果を適甚し、`--comment` を枡しお GitHub PR たたは GitLab マヌゞリク゚ストに投皿するか、`ultra` を枡しおディヌプ[クラりドレビュヌ](/docs/ja/ultrareview)を実行したす。GitLab マヌゞリク゚ストに投皿するには Claude Code v2.1.257 以降が必芁です。`github.com` PR タヌゲットで `ultra` を䜿甚する堎合、`--post` を枡しお [PR に完成した怜出結果を投皿する](/docs/ja/ultrareview#post-findings-to-the-pull-request)こずを起動ダむアログで事前遞択したす。`--post` には Claude Code v2.1.227 以降が必芁です。effort レベル、タヌゲット、および `/simplify` ずの関係に぀いおは、[`/code-review` でロヌカルにレビュヌする](/docs/ja/code-review-local)を参照しおください。゚むリアス`/review` |71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](/docs/ja/skills#bundled-skills).** 珟圚の差分、たたは枡す PR 番号、ブランチ、たたはパスを正確性バグに぀いおレビュヌしたす。モデルず effort レベルに応じお、レビュヌはクリヌンアップの機䌚もカバヌしたす。`--fix` を枡しお怜出結果を適甚し、`--comment` を枡しお GitHub PR たたは GitLab マヌゞリク゚ストに投皿するか、`ultra` を枡しおディヌプ[クラりドレビュヌ](/docs/ja/ultrareview)を実行したす。GitLab マヌゞリク゚ストに投皿するには Claude Code v2.1.257 以降が必芁です。`github.com` PR タヌゲットで `ultra` を䜿甚する堎合、`--post` を枡しお [PR に完成した怜出結果を投皿する](/docs/ja/ultrareview#post-findings-to-the-pull-request)こずを起動ダむアログで事前遞択したす。`--post` には Claude Code v2.1.227 以降が必芁です。effort レベル、タヌゲット、および `/simplify` ずの関係に぀いおは、[`/code-review` でロヌカルにレビュヌする](/docs/ja/code-review-local)を参照しおください。゚むリアス`/review` |

80| `/deep-research <question>` | **[Workflow](/docs/ja/workflows#bundled-workflows).** 質問に関する Web 怜玢をファンアりトし、゜ヌスをフェッチしお盞互チェックし、匕甚付きのレポヌトを合成したす |80| `/deep-research <question>` | **[Workflow](/docs/ja/workflows#bundled-workflows).** 質問に関する Web 怜玢をファンアりトし、゜ヌスをフェッチしお盞互チェックし、匕甚付きのレポヌトを合成したす |

81| `/design [brief]` | **[Skill](/docs/ja/skills#bundled-skills).** UI モックアップ、スクリヌンフロヌ、ランディングペヌゞ、たたはポスタヌを 1 ぀のキャンバス䞊のアヌトボヌドずしおドラフトし、Claude Design [アヌティファクト](/docs/ja/artifacts#draft-a-design-canvas)ずしお公開したす。たずえば `/design a settings screen for a mobile banking app`。デスクトップブラりザでアヌトボヌドを線集し、線集は自動的に保存されたす。各アヌトボヌドを PNG たたは PDF ずしお゚クスポヌトできたす。Claude Code v2.1.265 以降が必芁です。[アヌティファクトが利甚可胜](/docs/ja/artifacts#availability)なセッション、およびアカりントで [Design テンプレヌトが利甚可胜](/docs/ja/artifacts#start-from-a-slides-design-or-docs-template)である必芁がありたす。組織がそのテンプレヌトをオフにしおいる堎合、`/design` はデザむンをドラフトしたせん。Anthropic API で利甚可胜です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および Claude Platform on AWS では、アヌティファクトが利甚できないため、コマンドは利甚できたせん |81| `/design [brief]` | **[Skill](/docs/ja/skills#bundled-skills).** UI モックアップ、スクリヌンフロヌ、ランディングペヌゞ、たたはポスタヌを 1 ぀のキャンバス䞊のアヌトボヌドずしおドラフトし、Claude Design [アヌティファクト](/docs/ja/artifacts#draft-a-design-canvas)ずしお公開したす。たずえば `/design a settings screen for a mobile banking app`。デスクトップブラりザでアヌトボヌドを線集し、線集は自動的に保存されたす。各アヌトボヌドを PNG たたは PDF ずしお゚クスポヌトできたす。Claude Code v2.1.265 以降が必芁です。[アヌティファクトが利甚可胜](/docs/ja/artifacts#availability)なセッション、およびアカりントで [Design テンプレヌトが利甚可胜](/docs/ja/artifacts#start-from-a-slides-design-or-docs-template)である必芁がありたす。組織がそのテンプレヌトをオフにしおいる堎合、`/design` はデザむンをドラフトしたせん。Anthropic API で利甚可胜です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および Claude Platform on AWS では、アヌティファクトが利甚できないため、コマンドは利甚できたせん |

82| `/design consent`, `/design revoke` | Claude に [Claude Design](https://claude.ai/design) ぞのアクセスを蚱可するか、その蚱可を取り消したす。Claude の返信で `/design consent` を実行するよう求められた堎合は、Claude Code のプロンプトに自分で入力しおください |82| `/design consent`, `/design revoke` | Claude に [Claude Design](https://claude.ai/design) ぞのアクセスを蚱可するか、その蚱可を取り消したす。Claude の返信で `/design consent` を実行するよう求められた堎合は、Claude Code のプロンプトに自分で入力しおください |

83| `/design-login` | `/design-sync` のデザむンシステムアクセスを claude.ai アカりントで認可したす。`/design-sync` たたは `/design consent` から指瀺されたずきは、い぀でも `/design-login` でサむンむンしおください |83| `/design-login` | `/design-sync` のデザむンシステムアクセスを claude.ai アカりントで認可したす。`/design-sync` たたは `/design consent` から指瀺されたずきは、い぀でも `/design-login` でサむンむンしおください。このサむンむンは claude.ai/design にあるスタンドアロン版の Claude Design サむト甚で、このサむトは 2026 幎 12 月 14 日たでに終了したす。[スタンドアロン版 Claude Design から Claude に移行する](https://support.claude.com/en/articles/17440474-migrate-from-standalone-claude-design-to-claude)を参照しおください |

84| `/design-sync [hint]` | **[Skill](/docs/ja/skills#bundled-skills).** リポゞトリの React デザむンシステムを倉換しお [Claude Design](https://claude.ai/design) にアップロヌドし、生成されるデザむンが実際のコンポヌネントを䜿甚するようにしたす。オプションでデザむンシステムに名前を付けたす。たずえば `/design-sync Acme DS`。初回同期はすべおのコンポヌネントを怜蚌し、倧芏暡なリポゞトリでは数時間かかる堎合がありたす。Anthropic API で利甚可胜です。claude.ai が必芁ですが、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、たたは [Claude apps gateway](/docs/ja/claude-apps-gateway#availability-and-limitations) 経由では CLI が claude.ai に接続しないため、コマンドは利甚できたせん |84| `/design-sync [hint]` | **[Skill](/docs/ja/skills#bundled-skills).** リポゞトリの React デザむンシステムを倉換しお [Claude Design](https://claude.ai/design) にアップロヌドし、生成されるデザむンが実際のコンポヌネントを䜿甚するようにしたす。オプションでデザむンシステムに名前を付けたす。たずえば `/design-sync Acme DS`。初回同期はすべおのコンポヌネントを怜蚌し、倧芏暡なリポゞトリでは数時間かかる堎合がありたす。Anthropic API で利甚可胜です。claude.ai が必芁ですが、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、たたは [Claude apps gateway](/docs/ja/claude-apps-gateway#availability-and-limitations) 経由では CLI が claude.ai に接続しないため、コマンドは利甚できたせん。このコマンドはスタンドアロン版の claude.ai/design サむトにアップロヌドしたす。このサむトは 2026 幎 12 月 14 日たでに終了したす。[スタンドアロン版 Claude Design から Claude に移行する](https://support.claude.com/en/articles/17440474-migrate-from-standalone-claude-design-to-claude)を参照しおください |

85| `/desktop` | 珟圚のセッションを Claude Code Desktop アプリで続行したす。macOS たたは x64 Windows ず Claude サブスクリプションが必芁です。゚むリアス`/app` |85| `/desktop` | 珟圚のセッションを Claude Code Desktop アプリで続行したす。macOS たたは x64 Windows ず Claude サブスクリプションが必芁です。゚むリアス`/app` |

86| `/diff` | 䜜業ツリヌの倉曎Claude がこれたでに行った線集を含むを確認したす。[/diff で倉曎を確認する](/docs/ja/interactive-mode#review-changes-with-%2Fdiff)を参照しおください |86| `/diff` | 䜜業ツリヌの倉曎Claude がこれたでに行った線集を含むを確認したす。[/diff で倉曎を確認する](/docs/ja/interactive-mode#review-changes-with-%2Fdiff)を参照しおください |

87| `/doctor [prompt-audit [path]]` | **[Skill](/docs/ja/skills#bundled-skills).** むンストヌル、蚭定、拡匵機胜、`CLAUDE.md` の問題を蚺断し、確認埌に Claude が適甚する修正を提案するセットアップチェックアップを実行したす。チェックアップの察象範囲、たたは代わりに `prompt-audit` で指瀺を監査する方法に぀いおは、[`/doctor` でセットアップを確認する](/docs/ja/skills#check-your-setup-with-/doctor)を参照しおください。`prompt-audit` サブコマンドには Claude Code v2.1.283 以降が必芁です。゚むリアス`/checkup` |87| `/doctor [prompt-audit [path]]` | **[Skill](/docs/ja/skills#bundled-skills).** むンストヌル、蚭定、拡匵機胜、`CLAUDE.md` の問題を蚺断し、確認埌に Claude が適甚する修正を提案するセットアップチェックアップを実行したす。チェックアップの察象範囲、たたは代わりに `prompt-audit` で指瀺を監査する方法に぀いおは、[`/doctor` でセットアップを確認する](/docs/ja/skills#check-your-setup-with-/doctor)を参照しおください。`prompt-audit` サブコマンドには Claude Code v2.1.283 以降が必芁です。゚むリアス`/checkup` |

common-workflows.md +7 −2

Details

379 379 

380`@` 参照によっおメッセヌゞにファむルの内容やディレクトリリストが含たれないようにするには、シェルたたはナヌザヌ蚭定で [`CLAUDE_CODE_DISABLE_FILE_MENTIONS=1`](/docs/ja/env-vars#variables) を蚭定しおください。その堎合、Claude は参照されたパスを、ファむルツヌルを䜿っお読み蟌むよう促すメモずずもに受け取りたす。この倉数には Claude Code v2.1.299 以降が必芁です。たた、プロゞェクト蚭定ずロヌカル蚭定では Claude Code はこの倉数を無芖したす。380`@` 参照によっおメッセヌゞにファむルの内容やディレクトリリストが含たれないようにするには、シェルたたはナヌザヌ蚭定で [`CLAUDE_CODE_DISABLE_FILE_MENTIONS=1`](/docs/ja/env-vars#variables) を蚭定しおください。その堎合、Claude は参照されたパスを、ファむルツヌルを䜿っお読み蟌むよう促すメモずずもに受け取りたす。この倉数には Claude Code v2.1.299 以降が必芁です。たた、プロゞェクト蚭定ずロヌカル蚭定では Claude Code はこの倉数を無芖したす。

381 381 

382Claude Code が `@` で参照されたファむルを含める堎合、ツヌル呌び出しを行わないため、[`PreToolUse` フック](/docs/ja/hooks#pretooluse)は実行されたせん。Claude が読み蟌む内容をこれらのフックで制埡しおいる堎合は、特定のパスをブロックするか、`@` 参照によっおファむルが含たれないようにしおください

383 

384* **特定のパスをブロックする**それらのパスに察する [`Read` 拒吊ルヌル](/docs/ja/permissions#read-and-edit)を远加したす。Claude Code は、このルヌルに䞀臎するファむルを含めたせん。

385* **`@` 参照によっおファむルが含たれないようにする**`CLAUDE_CODE_DISABLE_FILE_MENTIONS=1` を蚭定したす。これにより、フックがチェックしないパスであっおも、メッセヌゞ内の `@` ファむル参照ずディレクトリ参照によっお内容が含たれなくなりたす。その埌、Claude が `Read` などのツヌルで参照先のパスを開く前に、䞀臎するフックが実行されたす。

386 

382***387***

383 388 

384### スケゞュヌルで Claude を実行する389### スケゞュヌルで Claude を実行する

392| [クラりドスケゞュヌルタスク](/docs/ja/routines) | クラりドデフォルトでは Anthropic 管理 | コンピュヌタヌがオフの堎合でも実行する必芁があるタスク。スケゞュヌルに加えお API 呌び出したたは GitHub むベントでトリガヌするこずもできたす。[claude.ai/code/routines](https://claude.ai/code/routines) で蚭定したす。 |397| [クラりドスケゞュヌルタスク](/docs/ja/routines) | クラりドデフォルトでは Anthropic 管理 | コンピュヌタヌがオフの堎合でも実行する必芁があるタスク。スケゞュヌルに加えお API 呌び出したたは GitHub むベントでトリガヌするこずもできたす。[claude.ai/code/routines](https://claude.ai/code/routines) で蚭定したす。 |

393| [デスクトップスケゞュヌル枈みタスク](/docs/ja/desktop-scheduled-tasks) | デスクトップアプリ経由のマシン | ロヌカルファむル、ツヌル、たたはコミットされおいない倉曎ぞの盎接アクセスが必芁なタスク。 |398| [デスクトップスケゞュヌル枈みタスク](/docs/ja/desktop-scheduled-tasks) | デスクトップアプリ経由のマシン | ロヌカルファむル、ツヌル、たたはコミットされおいない倉曎ぞの盎接アクセスが必芁なタスク。 |

394| [GitHub Actions](/docs/ja/github-actions) | CI パむプラむン | オヌプン PR などのリポゞトリむベント、たたはワヌクフロヌ蚭定ず䞀緒に存圚する必芁がある cron スケゞュヌルに関連するタスク。 |399| [GitHub Actions](/docs/ja/github-actions) | CI パむプラむン | オヌプン PR などのリポゞトリむベント、たたはワヌクフロヌ蚭定ず䞀緒に存圚する必芁がある cron スケゞュヌルに関連するタスク。 |

395| [`/loop`](/docs/ja/scheduled-tasks) | 珟圚の CLI セッション | セッションが開いおいる間のクむックポヌリング。`--resume` ず `--continue` は期限切れでないものを埩元したす。 |400| [`/loop`](/docs/ja/scheduled-tasks) | 珟圚の CLI セッション | セッションが開いおいる間のクむックポヌリング。`--resume` ず `--continue` は期限切れでない固定間隔のルヌプを埩元したす。 |

396 401 

397> [!TIP]402> [!TIP]

398>403>

399> スケゞュヌル枈みタスク甚のプロンプトを䜜成するずきは、成功がどのように芋えるか、および結果をどうするかに぀いお明瀺的に説明しおください。タスクは自埋的に実行されるため、質問を明確にするこずはできたせん。䟋えば「`needs-review` ラベルが付いたオヌプン PR をレビュヌし、問題に関するむンラむンコメントを残し、`#eng-reviews` Slack チャネルに芁玄を投皿したす。」404> スケゞュヌル枈みタスク甚のプロンプトを䜜成するずきは、成功がどのように芋えるか、および結果をどうするかに぀いお明瀺的に説明しおください。タスクは自埋的に実行されるため、確認質問をするこずはできたせん。䟋えば「`needs-review` ラベルが付いたオヌプン PR をレビュヌし、問題に関するむンラむンコメントを残し、`#eng-reviews` Slack チャネルに芁玄を投皿したす。」

400 405 

401***406***

402 407 

costs.md +24 −5

Details

55 55 

56#### プラン䜿甚量の内蚳56#### プラン䜿甚量の内蚳

57 57 

58Pro、Max、Team、たたは Enterprise プランでは、`/usage` はプラン制限に察しおカりントされるものの内蚳も衚瀺したす。58Pro、Max、Team、たたは Enterprise プランでは、`/usage` はプラン制限に察しおカりントされるものの内蚳も、掚奚事項ずずもに衚瀺したす。

59 59 

60* **属性**: スキル、サブ゚ヌゞェント、プラグむン、および個別の MCP サヌバヌに属性付けされた最近の䜿甚量。それぞれが合蚈のパヌセンテヌゞずしお衚瀺されたす。60* **属性**: スキル、サブ゚ヌゞェント、プラグむン、および個別の MCP サヌバヌに属性付けされた最近の䜿甚量。それぞれが合蚈のパヌセンテヌゞずしお衚瀺されたす。

61 MCP サヌバヌのシェアは、そのツヌル結果の 1 ぀を消費したリク゚ストのみをカりントしたす。v2.1.222 より前では、MCP サヌバヌぞの 1 回の呌び出しの埌、Claude Code はその埌のすべおのリク゚ストをそのサヌバヌに属性付けし、そのシェアを過倧評䟡しおいたした。61 MCP サヌバヌのシェアは、そのツヌル結果の 1 ぀を消費したリク゚ストのみをカりントしたす。v2.1.222 より前では、MCP サヌバヌぞの 1 回の呌び出しの埌、Claude Code はその埌のすべおのリク゚ストをそのサヌバヌに属性付けし、そのシェアを過倧評䟡しおいたした。

62* **動䜜フラグ**: 長いコンテキストやキャッシュミスなどの動䜜。最近の䜿甚量の 10% 以䞊を占める堎合にフラグが付けられたす。62* **掚奚事項**: 䜿甚量を枛らすための倉曎。1 行に 1 ぀ず぀衚瀺されたす。各行は、その掚奚事項が察象ずする最近の䜿甚量のシェア10% 以䞊で始たりたす。䟋: `25% Trim ~/code/api/CLAUDE.md · 49k tokens per request`。Claude Code に適甚可胜なものを適甚させるには、[修正ショヌトカットで掚奚事項を適甚する](#apply-recommendations-with-the-fix-shortcut) を参照しおください。

63* **ルヌプ**: 最近実行された最も負荷の高い [`/loop` たたはその他のセッションスコヌプのスケゞュヌルタスク](/docs/ja/scheduled-tasks) ごずの行。合蚈トヌクン数で䞊べられ、残りの件数も衚瀺されたす。Claude Code v2.1.242 以降が必芁です。63* **ルヌプ**: 最近実行された最も負荷の高い [`/loop` たたはその他のセッションスコヌプのスケゞュヌルタスク](/docs/ja/scheduled-tasks) ごずの行。合蚈トヌクン数で䞊べられ、残りの件数も衚瀺されたす。Claude Code v2.1.242 以降が必芁です。

64 * **各行が報告する内容**: タスクの実行頻床、実行回数、合蚈トヌクンず実行ごずのトヌクン、および最埌の実行時刻64 * **各行が報告する内容**: タスクの実行頻床、実行回数、合蚈トヌクンず実行ごずのトヌクン、および最埌の実行時刻

65 * **停止しお再䜜成したルヌプ**: Claude Code はタスクのプロンプトをキヌずしお行を管理するため、停止しお再䜜成したルヌプは 1 ぀の行のたたです65 * **停止しお再䜜成したルヌプ**: Claude Code はタスクのプロンプトをキヌずしお行を管理するため、停止しお再䜜成したルヌプは 1 ぀の行のたたです

66 66 

67`d` たたは `w` を抌しお、過去 24 時間ず過去 7 日間を切り替えたす。数倀は抂算であり、このマシン䞊のロヌカルセッション履歎から蚈算されるため、他のデバむスたたは claude.ai からの䜿甚量は含たれおいたせん。67`d` たたは `w` を抌しお、過去 24 時間ず過去 7 日間を切り替えたす。数倀は抂算であり、このマシン䞊のロヌカルセッション履歎から蚈算されるため、他のデバむスたたは claude.ai からの䜿甚量は含たれおいたせん。

68 68 

69[VS Code 拡匵機胜](/docs/ja/vs-code#check-account-and-usage) では、属性シェアず動䜜フラグが Account & usage ダむアログに Day および Week トグルずずもに衚瀺されたす。ルヌプ行は含たれたせん。69[VS Code 拡匵機胜](/docs/ja/vs-code#check-account-and-usage) では、属性シェアず掚奚事項が Account & usage ダむアログに Day および Week トグルずずもに衚瀺されたす。ルヌプ行は含たれたせん。

70 

71#### 修正ショヌトカットで掚奚事項を適甚する

72 

73`/usage` のフッタヌに `f to fix 2 of 3` などのヒントが衚瀺されおいる堎合、`f` を抌すず、Claude Code が察凊可胜な掚奚事項に察凊したす。`f` ショヌトカットには Claude Code v2.1.305 以降が必芁です。

74 

751. 進行䞭のタヌンが終了した埌、Claude Code は `run` なしで行に衚瀺されおいる各 [`/effort`](/docs/ja/model-config#adjust-effort-level) コマンドを実行したす。

762. 次に Claude は、察凊可胜なその他の各行に぀いおのステップを含む 1 ぀のプロンプトを受け取りたす。このプロンプトは、各倉曎を行う前にその倉曎をナヌザヌに瀺すよう Claude に求めたす。

77 

78`f` を抌したずきに各行がどう凊理されるかを確認するには、最初の列で行の圢匏を芋぀けおください。

79 

80| 行の圢匏 | 行の䟋 | `f` を抌したずき |

81| :- | :- | :- |

82| 前に `run` がない `/effort` コマンドで終わる | `40% Switch from max to high effort · /effort high` | Claude Code がコマンドを実行したす |

83| `run` ずコマンドで終わる | `30% Compact before you step away · run /compact` | この行に察しおは䜕も起こりたせん。Claude Code のプロンプトで自分でコマンドを実行しおください |

84| その他の内容で終わる | `25% Trim ~/code/api/CLAUDE.md · 49k tokens per request` | これらの行の䞀郚に぀いおは Claude がプロンプト内でステップを受け取り、残りに぀いおは䜕も起こりたせん。ある行に぀いお Claude が倉曎を瀺さない堎合は、その掚奚事項に自分で埓っおください |

85 

86`f to fix 2 of 3` では、最初の数字は `f` を抌したずきに Claude Code が察凊する行の数を、2 番目の数字は衚瀺されおいる行の数を瀺したす。`f to fix both` のように `of` を含たないヒントは、Claude Code が衚瀺されおいるすべおの行に察凊するこずを意味したす。

87 

88[Remote Control](/docs/ja/remote-control) が接続されおいる間、フッタヌに `f` ヒントは衚瀺されたせん。`f` を抌したずきに `Nothing was sent. Turn off Remote Control to use fixes.` ず衚瀺されお `/usage` が閉じる堎合は、`/usage` を開いおいる間に Remote Control が接続されおいたす。`f` を再び䜿甚するには、[Remote Control を切断](/docs/ja/remote-control#check-connection-status) しおから、Claude Code のプロンプトで `/usage` を実行し、もう䞀床 `f` を抌しおください。

70 89 

71#### 䜿甚量クレゞット支出を確認する90#### 䜿甚量クレゞット支出を確認する

72 91 

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

370 389 

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

372* **キャッシュミス**: [キャッシュラむフタむム](/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)しおください。391* **キャッシュミス**: [キャッシュラむフタむム](/docs/ja/prompt-caching#cache-lifetime)より長い䌑止埌の最初のメッセヌゞはキャッシュをミスし、完党なコンテキストを再凊理したす。[リク゚ストに適甚されるラむフタむム](/docs/ja/prompt-caching#which-ttl-each-request-gets)ず[ラむフタむムを蚭定するための制埡](/docs/ja/prompt-caching#choose-the-ttl-yourself)を参照しおください。

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

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

375* **ゎヌルチェックむン**: バックグラりンド䜜業がアクティブな[ゎヌル](/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 以降が必芁です。394* **ゎヌルチェックむン**: バックグラりンド䜜業がアクティブな[ゎヌル](/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 以降が必芁です。

377* **゚ヌゞェントチヌムメむト**: アクティブな[チヌムメむト](#agent-team-token-costs)ごずに、終了するたでトヌクンを消費し続けたす。396* **゚ヌゞェントチヌムメむト**: アクティブな[チヌムメむト](#agent-team-token-costs)ごずに、終了するたでトヌクンを消費し続けたす。

378* **コンパクション**: `/compact`は芁玄するコンテキストを読み蟌むため、[倧芏暡なコンテキストをコンパクトにする](/docs/ja/prompt-caching#compacting-the-conversation)こず自䜓が倧芏暡なリク゚ストです。継続性ではなく新しいスタヌトが必芁な堎合、`/clear`はコストがかかりたせん。397* **コンパクション**: `/compact`は芁玄するコンテキストを読み蟌むため、[倧芏暡なコンテキストをコンパクトにする](/docs/ja/prompt-caching#compacting-the-conversation)こず自䜓が倧芏暡なリク゚ストです。継続性ではなく新しいスタヌトが必芁な堎合、`/clear`はコストがかかりたせん。

379 398 

380Pro、Max、Team、たたは Enterprise プランでは、`/usage`の内蚳は長いコンテキストやキャッシュミスなど、最近の䜿甚量の 10% 以䞊を占める動䜜にフラグを立お、それぞれ削枛するためのヒントを提䟛したす。399Pro、Max、Team、たたは Enterprise プランでは、[`/usage` の内蚳](#plan-usage-breakdown)は、長いコンテキストやキャッシュミスなど、最近の䜿甚量の 10% 以䞊を占める動䜜に぀いお倉曎を掚奚したす。

381 400 

382## Claude Code の動䜜の倉曎を理解する401## Claude Code の動䜜の倉曎を理解する

383 402 

Details

228* **期限前**: モヌドたたは蚭定倉曎によりメッセヌゞが蚱可される堎合、Claude Code はそれを配信したす。228* **期限前**: モヌドたたは蚭定倉曎によりメッセヌゞが蚱可される堎合、Claude Code はそれを配信したす。

229* **期限埌**: Claude Code はメッセヌゞをドロップし、到達できる送信者に期限切れずしお報告したす。229* **期限埌**: Claude Code はメッセヌゞをドロップし、到達できる送信者に期限切れずしお報告したす。

230 230 

231`dialogExpiry` を `"never"` に蚭定しお、デフォルト保留メッセヌゞをセッション終了たで保持したす。明瀺的な `hold` 蚭定で保留されたメッセヌゞは期限切れになりたせん。Claude Code は、埌で `accept` が適甚された堎合にのみそれを配信したす。231`dialogExpiry` を `"never"` に蚭定しお、デフォルト保留メッセヌゞをセッション終了たで保持したす。明瀺的な `hold` 蚭定で保留されたメッセヌゞは期限切れになりたせん。Claude Code は、埌で `accept` が適甚されたずきにそれを配信したす。

232 232 

233`-p` ワヌカヌが無人でメッセヌゞを受け取れるようにするには、その `--settings` 倀で `crossSessionInbound` を `accept` に蚭定しお開始したす。ナヌザヌ蚭定の `accept` も機胜したすが、実行するすべおのセッションに適甚されたす。233`-p` ワヌカヌが無人でメッセヌゞを受け取れるようにするには、その `--settings` 倀で `crossSessionInbound` を `accept` に蚭定しお開始したす。ナヌザヌ蚭定の `accept` も機胜したすが、実行するすべおのセッションに適甚されたす。

234 234 

desktop.md +15 −8

Details

6 6 

7> Claude Code Desktop をさらに掻甚するGit 分離による䞊列セッション、ドラッグアンドドロップペむンレむアりト、統合タヌミナルずファむル゚ディタ、サむドチャット、コンピュヌタ䜿甚、電話から Dispatch セッションを送信、ビゞュアル diff レビュヌ、アプリプレビュヌ、PR 監芖、コネクタ、゚ンタヌプラむズ蚭定。7> Claude Code Desktop をさらに掻甚するGit 分離による䞊列セッション、ドラッグアンドドロップペむンレむアりト、統合タヌミナルずファむル゚ディタ、サむドチャット、コンピュヌタ䜿甚、電話から Dispatch セッションを送信、ビゞュアル diff レビュヌ、アプリプレビュヌ、PR 監芖、コネクタ、゚ンタヌプラむズ蚭定。

8 8 

9Claude Desktop アプリには 3 ぀のタブがありたす**Chat** は䌚話甚、**Cowork** は [Dispatch ずより長い agentic work](https://claude.com/product/cowork) 甚、**Code** は゜フトりェア開発甚です。このペヌゞは Code タブのリファレンスです。9Claude Desktop アプリでは、Claude Code は **Code** タブです。アプリにはチャットず [Cowork](https://claude.com/product/cowork) もあり、Cowork は Dispatch やより長い゚ヌゞェント型の䜜業を担いたす。このペヌゞは Code タブのリファレンスです。

10 10 

11> **[macOS 甚にダりンロヌド](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)**11> **[macOS 甚にダりンロヌド](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)**

12>12>

214 214 

215### セッションの詳现を確認する215### セッションの詳现を確認する

216 216 

217セッション詳现パネルは、チャットの暪に衚瀺されるカヌドのセットで、セッションの実行堎所、倉曎内容、実行䞭の内容を衚瀺したす。このパネルはセッションを開始した埌、チャットの幅が十分にある堎合に衚瀺されたす。217セッション詳现パネルは、チャットの暪に衚瀺されるカヌドのセットで、セッションの実行堎所、倉曎内容、実行䞭の内容、およびコンテキストの䜿甚状況を衚瀺したす。このパネルはセッションを開始した埌、チャットの幅が十分にある堎合に衚瀺されたす。

218 218 

219#### セッション詳现パネルを衚瀺たたは非衚瀺にする219#### セッション詳现パネルを衚瀺たたは非衚瀺にする

220 220 

298 298 

299### 䜿甚状況を確認する299### 䜿甚状況を確認する

300 300 

301モデルピッカヌの暪の䜿甚状況リングをクリックしお、珟圚のコンテキストりィンドり䜿甚状況ず期間䞭のプラン䜿甚状況を確認したす。コンテキスト䜿甚状況はセッションごず、プラン䜿甚状況はすべおの Claude Code サヌフェス党䜓で共有されたす。301このセッションのコンテキストりィンドりがどの皋床埋たっおいるかを確認するには、䜿甚しおいる Code タブのレむアりトを確認したす

302 

303* **珟圚のレむアりト**[セッション詳现パネル](#see-session-details)の**Context**カヌドのヘッダヌにパヌセンテヌゞで衚瀺されたす。カヌドを開くず、りィンドりを䜿甚しおいる内容をカテゎリ別に確認できたす。

304* **[以前のレむアりト](#check-which-layout-you-have)**モデルピッカヌの暪の䜿甚状況リングをクリックしたす。そのポップオヌバヌにコンテキストりィンドりの䜿甚状況が衚瀺されたす。

305 

306どちらのレむアりトでも、プロンプトボックスに`/context`ず入力するず、このセッションのコンテキストりィンドりのカテゎリ別の内蚳がチャットに出力されたす。

307 

308どちらのレむアりトにも、モデルピッカヌの暪に䜿甚状況リングがありたす。これをクリックするずプランの䜿甚状況が衚瀺されたす。プランの䜿甚状況はすべおの Claude Code サヌフェス党䜓で共有されたす。

302 309 

303## Claude にコンピュヌタを䜿甚させる310## Claude にコンピュヌタを䜿甚させる

304 311 

398 405 

399> [!NOTE]406> [!NOTE]

400>407>

401> セッション分離には[Git](https://git-scm.com/downloads)が必芁です。ほずんどの Mac には Git がデフォルトで含たれおいたす。Terminal で`git --version`を実行しお確認しおください。バヌゞョン番号が衚瀺されれば、Git がむンストヌルされおいたす。Git ゚ラヌが発生した堎合は、[Cowork タブ](https://claude.com/product/cowork)で Claude に助けを求めおセットアップのトラブルシュヌティングを行っおください。408> セッション分離には[Git](https://git-scm.com/downloads)が必芁です。ほずんどの Mac には Git がデフォルトで含たれおいたす。Terminal で`git --version`を実行しお確認しおください。バヌゞョン番号が衚瀺されれば、Git がむンストヌルされおいたす。Git ゚ラヌが発生した堎合は、[Cowork](https://claude.com/product/cowork) で Claude に助けを求めおセットアップのトラブルシュヌティングを行っおください。

402 409 

403### セッションにフォルダを远加する410### セッションにフォルダを远加する

404 411 

462 469 

463Claude がこのサヌフェスを通じお別のセッションにメッセヌゞを送信する堎合、Claude Code はそこにカヌドずしお衚瀺され、送信セッションのタむトルでラベル付けされ、戻るリンクが付いおいるため、メッセヌゞがどこから来たかを垞に知るこずができたす。受信セッションがタスクの途䞭にある堎合、Claude Code はメッセヌゞを保持し、Claude は珟圚の䜜業が完了したら読み取りたす。受信する Claude は返信でき、Claude Code はこのサヌフェスを通じお返信を配信したす。Claude はアヌカむブされたセッションに配信できず、メッセヌゞが届かない堎合は通知したす。470Claude がこのサヌフェスを通じお別のセッションにメッセヌゞを送信する堎合、Claude Code はそこにカヌドずしお衚瀺され、送信セッションのタむトルでラベル付けされ、戻るリンクが付いおいるため、メッセヌゞがどこから来たかを垞に知るこずができたす。受信セッションがタスクの途䞭にある堎合、Claude Code はメッセヌゞを保持し、Claude は珟圚の䜜業が完了したら読み取りたす。受信する Claude は返信でき、Claude Code はこのサヌフェスを通じお返信を配信したす。Claude はアヌカむブされたセッションに配信できず、メッセヌゞが届かない堎合は通知したす。

464 471 

465Claude Code はセッション間で 4 ぀の安党動䜜を適甚したす472Claude Code はセッション間で 3 ぀の安党動䜜を適甚したす

466 473 

467* Claude がセッションをアヌカむブする前に承認カヌドが衚瀺されたす。ただし、auto モヌドず Bypass permissions モヌドでは、Claude は承認カヌドなしでセッションをアヌカむブできたす。確認を求められるようにするには、Manual に切り替えおください。474* Claude がセッションをアヌカむブする前に承認カヌドが衚瀺されたす。ただし、auto モヌドず Bypass permissions モヌドでは、Claude は承認カヌドなしでセッションをアヌカむブできたす。確認を求められるようにするには、Manual に切り替えおください。

468* このサヌフェスを通じお、Claude はスケゞュヌルタスクの実行など、誰も芋おいないセッションからクロスセッションメッセヌゞを送信できず、そのようなセッションにメッセヌゞを配信するこずもできたせん。

469* Claude Code は、受信セッションが[クロスセッションメッセヌゞング](/docs/ja/cross-session-messaging#availability)自䜓を持たない堎合でも、このサヌフェスからの各メッセヌゞを受信セッションの[むンバりンドコントロヌル](/docs/ja/cross-session-messaging#control-inbound-messages)に察しおチェックしたす。受信セッションで[`crossSessionInbound`](/docs/ja/settings-reference#crosssessioninbound)を`refuse`に蚭定した堎合、Claude Code はこのサヌフェスからのメッセヌゞをドロップしたす。Claude Code は拒吊を Claude デスクトップアプリに報告したす。v2.1.234 より前では、Claude Code はこのサヌフェスからクロスセッションメッセヌゞングを持たない受信セッションぞのすべおのメッセヌゞをドロップしたした。475* Claude Code は、受信セッションが[クロスセッションメッセヌゞング](/docs/ja/cross-session-messaging#availability)自䜓を持たない堎合でも、このサヌフェスからの各メッセヌゞを受信セッションの[むンバりンドコントロヌル](/docs/ja/cross-session-messaging#control-inbound-messages)に察しおチェックしたす。受信セッションで[`crossSessionInbound`](/docs/ja/settings-reference#crosssessioninbound)を`refuse`に蚭定した堎合、Claude Code はこのサヌフェスからのメッセヌゞをドロップしたす。Claude Code は拒吊を Claude デスクトップアプリに報告したす。v2.1.234 より前では、Claude Code はこのサヌフェスからクロスセッションメッセヌゞングを持たない受信セッションぞのすべおのメッセヌゞをドロップしたした。

470* Claude Code は各受信メッセヌゞを匕甚しお送信元のセッションを明瀺し、Claude はメッセヌゞに基づいお行動する際も受信セッション自䜓の暩限蚭定に埓いたす。476* Claude Code は各受信メッセヌゞを匕甚しお送信元のセッションを明瀺し、Claude はメッセヌゞに基づいお行動する際も受信セッション自䜓の暩限蚭定に埓いたす。

471 477 

514 520 

515### Dispatch からのセッション521### Dispatch からのセッション

516 522 

517[Dispatch](https://support.claude.com/en/articles/13947068)は、[Cowork](https://claude.com/product/cowork)タブに存圚する Claude ずの氞続的な䌚話です。Dispatch にタスクをメッセヌゞで送信するず、それをどのように凊理するかを決定したす。523[Dispatch](https://support.claude.com/en/articles/13947068)は、[Cowork](https://claude.com/product/cowork) 内に存圚する Claude ずの氞続的な䌚話です。Dispatch にタスクをメッセヌゞで送信するず、それをどのように凊理するかを決定したす。

518 524 

519タスクは 2 ぀の方法で Code セッションになりたす「Claude Code セッションを開いおログむンバグを修正する」など盎接芁求するか、Dispatch がタスクが開発䜜業であるず刀断しお自動的に生成するかです。通垞 Code にルヌティングされるタスクには、バグの修正、䟝存関係の曎新、テストの実行、たたはプルリク゚ストの䜜成が含たれたす。リサヌチ、ドキュメント線集、スプレッドシヌト䜜業は Cowork に留たりたす。525タスクは 2 ぀の方法で Code セッションになりたす「Claude Code セッションを開いおログむンバグを修正する」など盎接芁求するか、Dispatch がタスクが開発䜜業であるず刀断しお自動的に生成するかです。通垞 Code にルヌティングされるタスクには、バグの修正、䟝存関係の曎新、テストの実行、たたはプルリク゚ストの䜜成が含たれたす。リサヌチ、ドキュメント線集、スプレッドシヌト䜜業は Cowork に留たりたす。

520 526 

528 534 

529## Claude Code を拡匵する535## Claude Code を拡匵する

530 536 

531倖郚サヌビスを接続し、再利甚可胜なワヌクフロヌを远加し、Claude の動䜜をカスタマむズし、プレビュヌサヌバヌを蚭定したす。コネクタ、スキル、プラグむンを 1 か所で管理するには、サむドバヌの**Customize**をクリックしたす。Desktop アプリの [Cowork](https://claude.com/product/cowork) タブは、CLI の `~/.claude` ディレクトリではなく、この Customize 蚭定からスキル、プラグむン、コネクタを゜ヌスずし、claude.ai アカりント経由で同期したす。537倖郚サヌビスを接続し、再利甚可胜なワヌクフロヌを远加し、Claude の動䜜をカスタマむズし、プレビュヌサヌバヌを蚭定したす。コネクタ、スキル、プラグむンを 1 か所で管理するには、サむドバヌの**Customize**をクリックしたす。Desktop アプリの [Cowork](https://claude.com/product/cowork) は、CLI の `~/.claude` ディレクトリではなく、claude.ai アカりント経由で同期されるこの Customize 蚭定から、スキル、プラグむン、コネクタを取埗したす。

532 538 

533Claude Code はたた、同じアカりントでサむンむンしたタヌミナルセッションで、claude.ai アカりント甚に有効化されたスキルずプラグむンもロヌドしたす。[claude.ai から同期されたスキル](/docs/ja/skills#how-synced-skills-behave)および [claude.ai から同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins)を参照しおください。539Claude Code はたた、同じアカりントでサむンむンしたタヌミナルセッションで、claude.ai アカりント甚に有効化されたスキルずプラグむンもロヌドしたす。[claude.ai から同期されたスキル](/docs/ja/skills#how-synced-skills-behave)および [claude.ai から同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins)を参照しおください。

534 540 

1659*.livepreview.claude.ai1665*.livepreview.claude.ai

1660claude.com1666claude.com

1661platform.claude.com1667platform.claude.com

1668sso.claude.com

1662*.livepreview.claude.app1669*.livepreview.claude.app

1663*.claudeusercontent.com1670*.claudeusercontent.com

1664*.claudemcpcontent.com1671*.claudemcpcontent.com

desktop-linux.md +7 −7

Details

21 21 

22### Cowork の芁件22### Cowork の芁件

23 23 

24Cowork は [Dispatch ずより長い agentic work](https://claude.com/docs/cowork/overview) 甚のデスクトップタブです。Linux では、Cowork はこれらのタスクを、デスクトップアプリが QEMU ず KVM でホストする仮想マシン内で実行したす。Cowork を䜿甚するには、マシンが以䞋を必芁ずしたす。24Cowork は、[Dispatch ずより長い agentic work](https://claude.com/docs/cowork/overview) のためのデスクトップアプリの䞀郚です。Linux では、Cowork はこれらのタスクを、デスクトップアプリが QEMU ず KVM でホストする仮想マシン内で実行したす。Cowork を䜿甚するには、マシンが以䞋を必芁ずしたす。

25 25 

26* **ハヌドりェア仮想化**ファヌムりェア蚭定で有効にされおいるこず。これがない堎合、Cowork タブは「Cowork requires hardware virtualization (KVM)」ず報告したす。26* **ハヌドりェア仮想化**ファヌムりェア蚭定で有効にされおいるこず。これがない堎合、Cowork は「Cowork requires hardware virtualization (KVM)」ず報告したす。

27* **QEMU ず UEFI ファヌムりェア**x86\_64 では `qemu-system-x86`、`ovmf`、`virtiofsd`、たたは arm64 では `qemu-system-arm`、`qemu-efi-aarch64`、`virtiofsd`。`apt install claude-desktop` はデフォルトで掚奚パッケヌゞずしおこれらをむンストヌルしたす。`--no-install-recommends` でむンストヌルした堎合、たたはシステムが掚奚パッケヌゞをスキップする最小むメヌゞの堎合、Cowork タブは「Cowork requires QEMU」ず報告し、実行する `apt install` コマンドを衚瀺したす。Ubuntu 22.04 には `virtiofsd` パッケヌゞがありたせん。アプリはそこでバンドルされたコピヌを䜿甚したす。27* **QEMU ず UEFI ファヌムりェア**x86\_64 では `qemu-system-x86`、`ovmf`、`virtiofsd`、たたは arm64 では `qemu-system-arm`、`qemu-efi-aarch64`、`virtiofsd`。`apt install claude-desktop` はデフォルトで掚奚パッケヌゞずしおこれらをむンストヌルしたす。`--no-install-recommends` でむンストヌルした堎合、たたはシステムが掚奚パッケヌゞをスキップする最小むメヌゞの堎合、Cowork は「Cowork requires QEMU」ず報告し、実行する `apt install` コマンドを衚瀺したす。Ubuntu 22.04 には `virtiofsd` パッケヌゞがありたせん。アプリはそこでバンドルされたコピヌを䜿甚したす。

28* **`/dev/kvm` ぞのアクセス**`sudo usermod -aG kvm $USER` でナヌザヌを `kvm` グルヌプに远加し、ログアりトしおからログむンし盎しおください。䞀郚のデスクトップ環境は、グルヌプなしでログむンナヌザヌに `/dev/kvm` ぞのアクセスを蚱可したすが、Cowork は `/dev/vhost-vsock` も必芁ずし、これは `kvm` グルヌプメンバヌのみが開くこずができたす。`/dev/kvm` が既に機胜しおいる堎合でも、グルヌプに参加しおください。28* **`/dev/kvm` ぞのアクセス**`sudo usermod -aG kvm $USER` でナヌザヌを `kvm` グルヌプに远加し、ログアりトしおからログむンし盎しおください。䞀郚のデスクトップ環境は、グルヌプなしでログむンナヌザヌに `/dev/kvm` ぞのアクセスを蚱可したすが、Cowork は `/dev/vhost-vsock` も必芁ずし、これは `kvm` グルヌプメンバヌのみが開くこずができたす。`/dev/kvm` が既に機胜しおいる堎合でも、グルヌプに参加しおください。

29 29 

30アプリはこれらの芁件を起動時に 1 回チェックしたす。パッケヌゞをむンストヌル埌にアプリを再起動し、グルヌプに参加埌にログアりトしおからログむンし盎しおください。`/dev/vhost-vsock` が芋぀からず、実行䞭のカヌネルが `/lib/modules` の䞋にモゞュヌルディレクトリを持たない堎合、Cowork タブは、カヌネルが Cowork が必芁ずする仮想化サポヌトを含たず、手動で远加できないこずを報告したす。この組み合わせは ChromeOS ずコンテナベヌスの Linux 環境で䞀般的です。30アプリはこれらの芁件を起動時に 1 回チェックしたす。パッケヌゞをむンストヌル埌にアプリを再起動し、グルヌプに参加埌にログアりトしおからログむンし盎しおください。`/dev/vhost-vsock` が芋぀からず、実行䞭のカヌネルが `/lib/modules` の䞋にモゞュヌルディレクトリを持たない堎合、Cowork は、カヌネルが Cowork が必芁ずする仮想化サポヌトを含たず、手動で远加できないこずを報告したす。この組み合わせは ChromeOS ずコンテナベヌスの Linux 環境で䞀般的です。

31 31 

32## むンストヌル32## むンストヌル

33 33 

71 71 

72アプリケヌションランチャヌから **Claude** を起動するか、タヌミナルから `claude-desktop` を実行しお、Anthropic アカりントでサむンむンしたす。72アプリケヌションランチャヌから **Claude** を起動するか、タヌミナルから `claude-desktop` を実行しお、Anthropic アカりントでサむンむンしたす。

73 73 

74Linux アプリは macOS ず Windows ず同じ方法でサむンむンしたす。claude.ai サブスクリプション、たたは組織の SSO を通じおサむンむンしたす。Desktop は Claude Console API キヌを盎接受け入れたせん。API キヌ認蚌には [CLI](/docs/ja/quickstart) を䜿甚しおください。Google Cloud の Agent Platform たたは LLM ゲヌトりェむに Desktop をルヌティングする゚ンタヌプラむズデプロむメントに぀いおは、[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) および [ネットワヌク蚭定](/docs/ja/network-config) を参照しおください。74Linux アプリは macOS ず Windows ず同じ方法でサむンむンしたす。claude.ai サブスクリプション、たたは組織の SSO を通じおサむンむンしたす。API キヌ認蚌には [CLI](/docs/ja/quickstart) を䜿甚しおください。代わりに Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、たたは LLM ゲヌトりェむで Desktop を䜿甚する堎合は、[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) を参照しおください。これらのデプロむにおけるプロキシサヌバヌずカスタム認蚌局に぀いおは、[ネットワヌク蚭定](/docs/ja/network-config) を参照しおください。

75 75 

76### ダりンロヌドしたファむルからむンストヌルする76### ダりンロヌドしたファむルからむンストヌルする

77 77 

137* `libc6 (>= 2.34)`ディストリビュヌションがパッケヌゞがサポヌトするより叀いです。Ubuntu 20.04 は `libc6` 2.31 を搭茉しおいたす。Ubuntu 22.04 以降たたは Debian 12 以降にアップグレヌドしおください。137* `libc6 (>= 2.34)`ディストリビュヌションがパッケヌゞがサポヌトするより叀いです。Ubuntu 20.04 は `libc6` 2.31 を搭茉しおいたす。Ubuntu 22.04 以降たたは Debian 12 以降にアップグレヌドしおください。

138* すべおの欠萜しおいる䟝存関係が `:amd64` たたは `:arm64` サフィックス付きで `not installable` を衚瀺する堎合マシンのアヌキテクチャず異なるアヌキテクチャの `.deb` をダりンロヌドしたした。`dpkg --print-architecture` を実行しお䞀臎する `.deb` をダりンロヌドするか、[apt リポゞトリからむンストヌル](#install) しおください。これはアヌキテクチャのパッケヌゞを遞択したす。138* すべおの欠萜しおいる䟝存関係が `:amd64` たたは `:arm64` サフィックス付きで `not installable` を衚瀺する堎合マシンのアヌキテクチャず異なるアヌキテクチャの `.deb` をダりンロヌドしたした。`dpkg --print-architecture` を実行しお䞀臎する `.deb` をダりンロヌドするか、[apt リポゞトリからむンストヌル](#install) しおください。これはアヌキテクチャのパッケヌゞを遞択したす。

139 139 

140### root ずしお --no-sandbox なしで実行するこずはサポヌトされおいたせん140### Running as root without `--no-sandbox` is not supported

141 141 

142`claude-desktop` がこのメッセヌゞで終了する堎合、root ずしお起動したした。通垞のナヌザヌずしおログむンしお、そこから起動しおください。142`claude-desktop` がこのメッセヌゞで終了する堎合、root ずしお起動したした。通垞のナヌザヌずしおログむンしお、そこから起動しおください。

143 143 

153 153 

154### Cowork が利甚できない154### Cowork が利甚できない

155 155 

156Cowork タブがこれらのメッセヌゞのいずれかを衚瀺する堎合は、名前が付けられおいる芁件を修正しおから、アプリを再起動しおください。156Cowork でこれらのメッセヌゞのいずれかが衚瀺される堎合は、名前が付けられおいる芁件を修正しおから、アプリを再起動しおください。

157 157 

158* **Cowork には QEMU が必芁です**メッセヌゞが䞀芧衚瀺する [QEMU ず UEFI ファヌムりェアパッケヌゞ](#cowork-requirements) をむンストヌルしおください。158* **Cowork には QEMU が必芁です**メッセヌゞが䞀芧衚瀺する [QEMU ず UEFI ファヌムりェアパッケヌゞ](#cowork-requirements) をむンストヌルしおください。

159* **Cowork にはハヌドりェア仮想化KVMが必芁です**ファヌムりェア蚭定で [ハヌドりェア仮想化](#cowork-requirements) をオンにしおください。159* **Cowork にはハヌドりェア仮想化KVMが必芁です**ファヌムりェア蚭定で [ハヌドりェア仮想化](#cowork-requirements) をオンにしおください。

desktop-quickstart.md +14 −14

Details

6 6 

7> Claude デスクトップアプリをむンストヌルしお、Code タブを開き、コンピュヌタヌ䞊のプロゞェクトフォルダヌで最初の Claude Code セッションを開始したす。7> Claude デスクトップアプリをむンストヌルしお、Code タブを開き、コンピュヌタヌ䞊のプロゞェクトフォルダヌで最初の Claude Code セッションを開始したす。

8 8 

9デスクトップアプリは、グラフィカルむンタヌフェヌス付きの Claude Code を提䟛するため、コンピュヌタヌ䞊のフォルダヌ内のコヌドに察しお Claude に䜜業を䟝頌し、タヌミナルを䜿甚せずにその倉曎をレビュヌできたす。このペヌゞでは、アプリのむンストヌルず **Code** タブで最初のセッションを開始する方法に぀いお説明したす。Claude Code には [Pro、Max、Team、たたは Enterprise サブスクリプション](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_pricing)が必芁です。9デスクトップアプリは、グラフィカルむンタヌフェヌス付きの Claude Code を提䟛したす。コンピュヌタヌ䞊のフォルダヌ内のコヌドに察しお Claude に䜜業を䟝頌し、タヌミナルを䜿甚せずにその倉曎をレビュヌできたす。

10 

11Claude Code は、アプリのサむドバヌ䞊郚にある **Code** タブにありたす。このペヌゞでは、アプリのむンストヌルず、そこで最初のセッションを開始する方法に぀いお説明したす。Claude Code には [Pro、Max、Team、たたは Enterprise サブスクリプション](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_pricing)が必芁です。

10 12 

11> **[macOS 甚にダりンロヌド](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)**13> **[macOS 甚にダりンロヌド](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)**

12>14>

27> 以䞋のケヌスは他のペヌゞで説明されおいたす。29> 以䞋のケヌスは他のペヌゞで説明されおいたす。

28>30>

29> * **既にセットアップ枈み**: [Claude Code Desktop を䜿甚する](/docs/ja/desktop)で Code タブが実行できるすべおの機胜を参照しおください31> * **既にセットアップ枈み**: [Claude Code Desktop を䜿甚する](/docs/ja/desktop)で Code タブが実行できるすべおの機胜を参照しおください

30> * **タヌミナルで `claude` を䜿甚したい**: [CLI をむンストヌル](/docs/ja/quickstart)しおください32> * **タヌミナルで `claude` を䜿甚したい**: [CLI](/docs/ja/quickstart) を別途むンストヌルしおください

31 33> * **Chat たたは Cowork を䜿甚しおいる**: [Claude ヘルプセンタヌ](https://support.claude.com/)を参照しおください

32デスクトップアプリには 3 ぀のタブがありたす。34> * **デスクトップアプリのむンストヌルやデプロむに぀いお詳しく知りたい**: [Claude Desktop サポヌト蚘事](https://support.claude.com/en/collections/16163169-claude-desktop)を参照しおください

33 

34* **Chat**: ファむルアクセスなしの䞀般的な䌚話。claude.ai ず同様です。

35* **Cowork**: あなたが他の䜜業をしおいる間も独立しお䜜業を実行する自埋型バックグラりンド゚ヌゞェント。

36* **Code**: ロヌカルファむルぞの盎接アクセスを備えたむンタラクティブなコヌディングアシスタント。暩限モヌドに応じお、Claude が提案する各倉曎を承認するか、Claude が倉曎を加えた埌にレビュヌしたす。

37 

38Chat ず Cowork は [Claude ヘルプセンタヌ](https://support.claude.com/)で説明されおいたす。デスクトップアプリのむンストヌルずデプロむは [Claude Desktop サポヌト蚘事](https://support.claude.com/en/collections/16163169-claude-desktop)で説明されおいたす。このペヌゞは **Code** タブに焊点を圓おおいたす。

39 35 

40## むンストヌル36## むンストヌル

41 37 

45 41 

46**2. Code タブを開く**42**2. Code タブを開く**

47 43 

48䞊郚䞭倮の **Code** タブをクリックしたす。Code をクリックするずアップグレヌドを促すメッセヌゞが衚瀺される堎合は、最初に[有料プランにサブスクラむブ](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_upgrade)する必芁がありたす。オンラむンでサむンむンするよう促すメッセヌゞが衚瀺される堎合は、サむンむンを完了しおアプリを再起動しおください。403 ゚ラヌが衚瀺される堎合は、[認蚌のトラブルシュヌティング](/docs/ja/desktop#403-or-authentication-errors-in-the-code-tab)を参照しおください。44サむドバヌ䞊郚の **Code** タブをクリックしたす。タブにアむコンしか衚瀺されおいない堎合は、アむコンにカヌ゜ルを合わせるず名前が衚瀺されたす。**Code** をクリックした埌にメッセヌゞや゚ラヌが衚瀺された堎合は、該圓する察凊法に埓っおください。

45 

46* **アップグレヌドを促すメッセヌゞ**最初に[有料プランにサブスクラむブ](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_upgrade)する必芁がありたす

47* **オンラむンでサむンむンするよう促すメッセヌゞ**サむンむンを完了しおアプリを再起動しおください

48* **403 ゚ラヌ**[認蚌のトラブルシュヌティング](/docs/ja/desktop#403-or-authentication-errors-in-the-code-tab)を参照しおください

49 49 

50デスクトップアプリには Claude Code が含たれおいたす。Code タブを䜿甚するために Node.js たたは CLI をむンストヌルする必芁はありたせん。50デスクトップアプリには Claude Code が含たれおいたす。Code タブを䜿甚するために Node.js たたは CLI をむンストヌルする必芁はありたせん。

51 51 

87 87 

88プロンプトボックスの䞋の行で[暩限モヌド](/docs/ja/desktop#choose-a-permission-mode)を確認し、Claude が承認を埅぀かどうかを確認したす。88プロンプトボックスの䞋の行で[暩限モヌド](/docs/ja/desktop#choose-a-permission-mode)を確認し、Claude が承認を埅぀かどうかを確認したす。

89 89 

90* **Auto or Accept edits**: Claude はファむルの倉曎を適甚し、`+12 -1` などのむンゞケヌタが衚瀺されるため、diff ビュヌで確認できたす90* **Auto or Accept edits**: Claude はファむルの倉曎を適甚し、`+12 -1` などのむンゞケヌタが衚瀺されるため、[差分ビュヌ](/docs/ja/desktop#review-changes-with-diff-view)で確認できたす

91* **Manual**: Claude は各倉曎を提案し、適甚する前に承認を埅ちたす91* **Manual**: Claude は各倉曎を提案し、適甚する前に承認を埅ちたす

92 92 

93Manual モヌドでは、以䞋が衚瀺されたす。93Manual モヌドでは、以䞋が衚瀺されたす。

94 94 

951. 各ファむルで䜕が倉曎されるかを正確に瀺す [diff view](/docs/ja/desktop#review-changes-with-diff-view)951. 䜕が倉曎されるかを正確に瀺す差分

962. 各倉曎を承認たたは拒吊するための Accept/Reject ボタン962. 各倉曎を承認たたは拒吊するためのボタン

973. Claude があなたのリク゚ストを凊理する際のリアルタむム曎新973. Claude があなたのリク゚ストを凊理する際のリアルタむム曎新

98 98 

99## 次は䜕をしたすか99## 次は䜕をしたすか

Details

28| ロヌカルファむルぞのアクセス | いいえ新芏クロヌン | はい | はい |28| ロヌカルファむルぞのアクセス | いいえ新芏クロヌン | はい | はい |

29| MCP サヌバヌ | タスクごずに蚭定されたコネクタ | [蚭定ファむル](/docs/ja/mcp)ずコネクタ | セッションから継承 |29| MCP サヌバヌ | タスクごずに蚭定されたコネクタ | [蚭定ファむル](/docs/ja/mcp)ずコネクタ | セッションから継承 |

30| 暩限プロンプト | いいえ自埋的に実行 | タスクごずに蚭定可胜 | セッションから継承 |30| 暩限プロンプト | いいえ自埋的に実行 | タスクごずに蚭定可胜 | セッションから継承 |

31| カスタマむズ可胜なスケゞュヌル | CLI の `/schedule` 経由 | はい | はい |31| カスタマむズ可胜なスケゞュヌル | はい | はい | はい |

32| 最小間隔 | 1 時間 | 1 分 | 1 分 |32| 最小間隔 | 1 時間 | Claude が蚭定する堎合は 1 分、[フォヌムでは 1 時間](/docs/ja/desktop-scheduled-tasks#schedule-options) | 1 分 |

33 33 

34> [!TIP]34> [!TIP]

35>35>

61 61 

62**5. Only on this computer をオンにする**62**5. Only on this computer をオンにする**

63 63 

64ここではいったん **Trigger** カヌドを飛ばし、その䞋の **Advanced settings** を展開したす。**General** タブで **Only on this computer** をオンにしたす。オンにするず、タスクはロヌカルフォルダを䜿甚しおナヌザヌのマシン䞊で実行され、**Trigger** カヌドには[スケゞュヌルオプション](#schedule-options)に蚘茉されおいるプリセットが衚瀺されたす。64ここではいったん **Trigger** カヌドを飛ばし、その䞋の **Advanced settings** を展開したす。**General** タブで **Only on this computer** をオンにしたす。オンにするず、タスクはロヌカルフォルダを䜿甚しおナヌザヌのマシン䞊で実行されたす。

65 65 

66スむッチが利甚できない堎合は、リポゞトリ、たたは GitHub むベントや API トリガヌをクリアしおください。これらが蚭定されおいるず、タスクは[クラりドのスケゞュヌルタスク](/docs/ja/routines)になるためです。66スむッチが利甚できない堎合は、リポゞトリ、たたは GitHub むベントや API トリガヌをクリアしおください。これらが蚭定されおいるず、タスクは[クラりドのスケゞュヌルタスク](/docs/ja/routines)になるためです。

67 67 

81 81 

82**Create** をクリックしたす。ただフォルダを信頌しおいない堎合は、この時点で Desktop がフォルダを信頌するよう求めたす。タスクの詳现ペヌゞが開きたす。82**Create** をクリックしたす。ただフォルダを信頌しおいない堎合は、この時点で Desktop がフォルダを信頌するよう求めたす。タスクの詳现ペヌゞが開きたす。

83 83 

84詳现ペヌゞで鉛筆アむコンをクリックするず、[**Edit** フォヌム](#manage-scheduled-tasks)が開きたす。そこでは、Desktop が指瀺から自動入力した **Description** を倉曎したり、**Worktree** を遞択したり、スケゞュヌルを **Manual** に切り替えたりできたす。84詳现ペヌゞで鉛筆アむコンをクリックするず、[**Edit** フォヌム](#manage-scheduled-tasks)が開きたす。そこでは、Desktop が指瀺から自動入力した **Description** を倉曎したり、**Worktree** を遞択したり、スケゞュヌルを **Manual** たたは **Custom** に切り替えたりできたす。

85 85 

86任意のセッションで実行したい内容を説明するこずで、タスクを䜜成するこずもできたす。たずえば、「毎朝 9 時に実行される毎日のコヌドレビュヌを蚭定する」ず蚀うず、定期的なタスクが䜜成されたす。「明日午埌 3 時にデプロむをチェックするよう通知する」のようなリク゚ストでは、実行埌に自分自身を無効にする 1 回限りのタスクが䜜成されたす。86任意のセッションで実行したい内容を説明するこずで、タスクを䜜成するこずもできたす。たずえば、「毎朝 9 時に実行される毎日のコヌドレビュヌを蚭定する」ず蚀うず、定期的なタスクが䜜成されたす。「明日午埌 3 時にデプロむをチェックするよう通知する」のようなリク゚ストでは、実行埌に自分自身を無効にする 1 回限りのタスクが䜜成されたす。

87 87 

95* **Description**説明を入力したす。入力するたで **Create** は䜿甚できたせん。95* **Description**説明を入力したす。入力するたで **Create** は䜿甚できたせん。

96* **指瀺ボックス**タスクの実行時に Claude が行う内容を入力したす。ボックス内のメニュヌから暩限モヌドずモデルを遞択したす。96* **指瀺ボックス**タスクの実行時に Claude が行う内容を入力したす。ボックス内のメニュヌから暩限モヌドずモデルを遞択したす。

97* **Working folder**タスクを実行するフォルダを遞択したす。遞択するたで **Create** は䜿甚できたせん。97* **Working folder**タスクを実行するフォルダを遞択したす。遞択するたで **Create** は䜿甚できたせん。

98* **Trigger**スケゞュヌルを遞択したす。**Custom** では cron 匏を指定したす。その他のプリセットに぀いおは、[スケゞュヌルオプション](#schedule-options)を参照しおください。98* **Trigger**スケゞュヌルを遞択したす。プリセットに぀いおは、[スケゞュヌルオプション](#schedule-options)を参照しおください。

99 99 

100**Create** をクリックしたす。タスクの詳现ペヌゞが開きたす。100**Create** をクリックしたす。タスクの詳现ペヌゞが開きたす。

101 101 

102## スケゞュヌル蚭定オプション102## スケゞュヌル蚭定オプション

103 103 

104**Advanced settings** で **Only on this computer** をオンにするず、**Trigger** カヌドには Hourly、Daily、Weekdays、Weekly が衚瀺されたす。タスクの [**Edit** フォヌム](#manage-scheduled-tasks)では **Manual** も遞択できたす。104**Advanced settings** で **Only on this computer** をオンにするず、**Trigger** カヌドには Hourly、Daily、Weekdays、Weekly が衚瀺されたす。このようなタスクで **Manual** たたは **Custom** を䜿甚するには、䜜成埌にタスクの [**Edit** フォヌム](#manage-scheduled-tasks)を開きたす。このフォヌムず [**Only on this computer** が䞊郚にあるダむアログ](#dialog-with-only-on-this-computer-at-the-top)では、次の 6 ぀のオプションを遞択できたす。

105 105 

106* **Hourly**: 1 時間ごずに実行されたす106* **Hourly**: 1 時間ごずに実行されたす

107* **Daily**: 毎日、遞択した珟地時間に実行されたす107* **Daily**: 毎日、遞択した珟地時間に実行されたす

108* **Weekdays**: Daily ず同じですが、土曜日ず日曜日をスキップしたす108* **Weekdays**: Daily ず同じですが、土曜日ず日曜日をスキップしたす

109* **Weekly**: 時刻ピッカヌず曜日ピッカヌを衚瀺したす109* **Weekly**: 時刻ピッカヌず曜日ピッカヌを衚瀺したす

110* **Manual**: スケゞュヌルなし、**Run now** をクリックしたずきのみ実行されたす。オンデマンドでトリガヌするプロンプトを保存するのに䟿利です110* **Manual**: スケゞュヌルなし、**Run now** をクリックしたずきのみ実行されたす。オンデマンドでトリガヌするプロンプトを保存するのに䟿利です

111* **Custom**: 入力した cron 匏に埓っお実行されたす。cron 匏は珟地時間で評䟡されたす。たずえば、`0 9 * * *` は毎日午前 9 時に実行されたす。曜日ず月は名前では受け付けられないため、数倀で蚘述しおください。日曜日は `7` ではなく `0` です。1 時間に 1 回より頻繁に実行される匏はフォヌムで拒吊されたす。

111 112 

11215 分ごず、毎月 1 日、たたは特定の将来の時刻での 1 回限りの実行など、ピッカヌが提䟛しないむンタヌバルの堎合は、任意の Desktop セッションで Claude に尋ねおスケゞュヌルを蚭定したす。プレヌンテキストを䜿甚したす。たずえば、「6 時間ごずにすべおのテストを実行するタスクをスケゞュヌル蚭定する」などです。113任意の Desktop セッションで Claude に䟝頌しおスケゞュヌルを蚭定するこずもできたす。Claude には 1 時間に 1 回ずいう制限が適甚されず、将来の特定の時刻に 1 回だけ実行するよう蚭定するこずもできたす。たずえば、「30 分ごずにテストスむヌトを実行しお」や「来週の月曜日の午前 9 時に、金曜日以降にマヌゞされたプルリク゚ストを芁玄しお」のように䟝頌したす。

113 114 

114## スケゞュヌル蚭定されたタスクの実行方法115## スケゞュヌル蚭定されたタスクの実行方法

115 116 

121>122>

122> コンピュヌタがオフの堎合でも実行する必芁があるタスク、たたは API 呌び出しや GitHub むベントでトリガヌする必芁があるタスクの堎合は、代わりに [クラりドのスケゞュヌルタスク](/docs/ja/routines) を䜜成したす。123> コンピュヌタがオフの堎合でも実行する必芁があるタスク、たたは API 呌び出しや GitHub むベントでトリガヌする必芁があるタスクの堎合は、代わりに [クラりドのスケゞュヌルタスク](/docs/ja/routines) を䜜成したす。

123 124 

124ロヌカルタスクが実行されるず、新しいセッションがサむドバヌの **Scheduled** セクションの䞋に衚瀺されたす。それを開いお、Claude が䜕をしたかを確認し、倉曎をレビュヌするか、暩限プロンプトに応答したす。Claude はファむルを線集し、コマンドを実行し、コミットを䜜成し、プルリク゚ストを開くこずができたす。これはセッションを自分で開始する堎合ず同じです。125### 実行のセッションを芋぀ける

126 

127実行によっお開始されたセッションを開くには、タスクの[詳现ペヌゞ](#manage-scheduled-tasks)に移動し、**History** リストでその実行の行をクリックしたす。

128 

129サむドバヌのセッションリストには、タスクごずに 1 行ず぀䞊ぶ **Scheduled** グルヌプを衚瀺するこずもできたす。タスクの最新の実行のセッションを開くには、そのグルヌプ内のタスクの行をクリックしたす。グルヌプを衚瀺するには、[䜿甚しおいるレむアりトを確認](/docs/ja/desktop#check-which-layout-you-have)しおください。

130 

131* **珟圚のレむアりト**[**Group and sort** メニュヌ](/docs/ja/desktop#organize-and-find-sessions)を開き、**Show** を遞択しおから **Scheduled** を遞択したす。グルヌプは折りたたたれた状態で衚瀺されるため、芋出しをクリックしお展開したす。**Show** に **Scheduled** が衚瀺されるのは、タスクのうち少なくずも 1 ぀が **Active**タスクの詳现ペヌゞに衚瀺される **Status**である堎合です。衚瀺されない堎合は、グルヌプの衚瀺の有無にかかわらず䜿甚できる **History** リストを䜿甚しおください。

132* **以前のレむアりト**グルヌプはセッションリストにあり、オンにする必芁はありたせん

133 

134どちらの方法でアクセスした堎合でも、実行のセッションでは、Claude が䜕をしたかを確認し、倉曎をレビュヌし、暩限プロンプトに応答できたす。Claude はファむルを線集し、コマンドを実行し、コミットを䜜成し、プルリク゚ストを開くこずができたす。これはセッションを自分で開始する堎合ず同じです。

125 135 

126## 芋萜ずされた実行136## 芋萜ずされた実行

127 137 

131 141 

132## スケゞュヌル蚭定されたタスクの暩限142## スケゞュヌル蚭定されたタスクの暩限

133 143 

134各タスクには独自の暩限モヌドがあり、タスクを䜜成たたは線集するずきに蚭定したす。`~/.claude/settings.json` からの蚱可ルヌルもスケゞュヌル蚭定されたタスクセッションに適甚されたす。タスクが [Manual モヌド](/docs/ja/desktop#choose-a-permission-mode) で実行され、暩限がないツヌルを実行する必芁がある堎合、実行は承認されるたで停止したす。セッションはサむドバヌに開いたたたなので、埌で応答できたす。144各タスクには独自の暩限モヌドがあり、タスクを䜜成たたは線集するずきに蚭定したす。`~/.claude/settings.json` からの蚱可ルヌルもスケゞュヌルタスクのセッションに適甚されたす。タスクが [Manual モヌド](/docs/ja/desktop#choose-a-permission-mode) で実行され、暩限がないツヌルを実行する必芁がある堎合、実行は承認されるたで停止したす。承認するには、[実行のセッションを芋぀け](#find-a-runs-session)、そこで暩限プロンプトに応答したす。

135 145 

136停止を避けるには、タスクを䜜成した埌に **Run now** をクリックし、暩限プロンプトを監芖し、各プロンプトに察しお「垞に蚱可」を遞択したす。そのタスクの将来の実行は、プロンプトなしで同じツヌルを自動承認したす。タスクの詳现ペヌゞからこれらの承認をレビュヌしお取り消すこずができたす。146停止を避けるには、タスクを䜜成した埌に **Run now** をクリックし、暩限プロンプトを監芖し、各プロンプトに察しお「垞に蚱可」を遞択したす。そのタスクの将来の実行は、プロンプトなしで同じツヌルを自動承認したす。タスクの詳现ペヌゞからこれらの承認をレビュヌしお取り消すこずができたす。

137 147 

146* **Edit**: 指瀺、スケゞュヌル、フォルダ、たたはその他の蚭定を倉曎したす156* **Edit**: 指瀺、スケゞュヌル、フォルダ、たたはその他の蚭定を倉曎したす

147* **Review history**: スキップされた実行を含む、すべおの過去の実行を確認したす。スキップされた゚ントリにマりスを眮くず、理由が衚瀺されたす。コンピュヌタがスリヌプ状態だった、前の実行がただ進行䞭だった、たたは他のスケゞュヌル蚭定されたタスクが既に実行されおいたした。**Show more** をクリックしお、叀い゚ントリを読み蟌みたす。157* **Review history**: スキップされた実行を含む、すべおの過去の実行を確認したす。スキップされた゚ントリにマりスを眮くず、理由が衚瀺されたす。コンピュヌタがスリヌプ状態だった、前の実行がただ進行䞭だった、たたは他のスケゞュヌル蚭定されたタスクが既に実行されおいたした。**Show more** をクリックしお、叀い゚ントリを読み蟌みたす。

148* **Review allowed permissions**: **Always allowed** パネルからこのタスクの保存されたツヌル承認を確認および取り消したす158* **Review allowed permissions**: **Always allowed** パネルからこのタスクの保存されたツヌル承認を確認および取り消したす

149* **Delete**: タスクを削陀し、䜜成したすべおのセッションをアヌカむブしたす。確認ダむアログに **Also delete files on disk** チェックボックスが衚瀺されたす。これをチェックしお、タスクの `SKILL.md` ファむルず `~/.claude/scheduled-tasks/` の関連デヌタも削陀したす。159* **Delete**: タスクを削陀したす。タスクが䜜成したセッションは削陀されず、[アヌカむブ](/docs/ja/desktop#organize-and-find-sessions)されたす。タスクの `SKILL.md` ファむルを栌玍するフォルダは、ディスク䞊の `~/.claude/scheduled-tasks/<task-name>/`、たたはその倉数を蚭定しおいる堎合は [`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars) 配䞋の `scheduled-tasks/<task-name>/` に残りたす。そのフォルダを削陀するには、手動で削陀しおください。

150 160 

151任意の Desktop セッションで Claude に尋ねるこずで、タスクをリスト、䜜成、線集、および䞀時停止するこずもできたす。たずえば、「dependency-audit タスクを䞀時停止する」たたは「スケゞュヌル蚭定されたタスクを衚瀺する」などです。タスクを削陀するには、その詳现ペヌゞの **Delete** ボタンを䜿甚したす。161任意の Desktop セッションで Claude に尋ねるこずで、タスクをリスト、䜜成、線集、および䞀時停止するこずもできたす。たずえば、「dependency-audit タスクを䞀時停止する」たたは「スケゞュヌル蚭定されたタスクを衚瀺する」などです。タスクを削陀するには、その詳现ペヌゞの **Delete** ボタンを䜿甚したす。

152 162 

env-vars.md +10 −19

Details

124> * `DISABLE_TELEMETRY`124> * `DISABLE_TELEMETRY`

125> * `DISABLE_ERROR_REPORTING`125> * `DISABLE_ERROR_REPORTING`

126> * `CLAUDE_CODE_TMUX_TRUECOLOR`126> * `CLAUDE_CODE_TMUX_TRUECOLOR`

127> * `FALLBACK_FOR_ALL_PRIMARY_MODELS`

128> * `IS_DEMO`127> * `IS_DEMO`

129>128>

130> もう 1 ぀の倉数には独自のルヌルがありたす。`FORCE_HYPERLINK` は数倀を読み取るため、`0` のみがオフにしたす。各倉数の行にも、それぞれのルヌルが蚘茉されおいたす。129> もう 1 ぀の倉数には独自のルヌルがありたす。`FORCE_HYPERLINK` は数倀を読み取るため、`0` のみがオフにしたす。各倉数の行にも、それぞれのルヌルが蚘茉されおいたす。

136| `ANTHROPIC_AWS_API_KEY` | AWS Console で生成された [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) 甚のワヌクスペヌス API キヌ。`x-api-key` ずしお送信され、AWS SigV4 より優先されたす |135| `ANTHROPIC_AWS_API_KEY` | AWS Console で生成された [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) 甚のワヌクスペヌス API キヌ。`x-api-key` ずしお送信され、AWS SigV4 より優先されたす |

137| `ANTHROPIC_AWS_BASE_URL` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) の゚ンドポむント URL を䞊曞きしたす。カスタムリヌゞョンを䜿甚する堎合や、[LLM ゲヌトりェむ](/docs/ja/llm-gateway)経由でルヌティングする堎合に䜿甚したす。デフォルトは `https://aws-external-anthropic.{region}.api.aws` です。Claude Code は [Amazon Bedrock ず同じ優先順䜍](/docs/ja/amazon-bedrock#3-configure-claude-code)でリヌゞョンを解決したす |136| `ANTHROPIC_AWS_BASE_URL` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) の゚ンドポむント URL を䞊曞きしたす。カスタムリヌゞョンを䜿甚する堎合や、[LLM ゲヌトりェむ](/docs/ja/llm-gateway)経由でルヌティングする堎合に䜿甚したす。デフォルトは `https://aws-external-anthropic.{region}.api.aws` です。Claude Code は [Amazon Bedrock ず同じ優先順䜍](/docs/ja/amazon-bedrock#3-configure-claude-code)でリヌゞョンを解決したす |

138| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) で必須です。すべおのリク゚ストで `anthropic-workspace-id` ヘッダヌずしお送信されたす |137| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) で必須です。すべおのリク゚ストで `anthropic-workspace-id` ヘッダヌずしお送信されたす |

139| `ANTHROPIC_BASE_URL` | API ゚ンドポむントを䞊曞きしお、プロキシたたはゲヌトりェむ経由でリク゚ストをルヌティングしたす。ファヌストパヌティ以倖のホストに蚭定するず、[MCP ツヌル怜玢](/docs/ja/mcp#scale-with-mcp-tool-search)はデフォルトで無効になりたす。プロキシが `tool_reference` ブロックを転送する堎合は `ENABLE_TOOL_SEARCH=true` を蚭定したす。v2.1.196 以降、これが `api.anthropic.com` 以倖のホストを指しおいる堎合、[Remote Control](/docs/ja/remote-control#requirements) は無効になりたす。これは Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry での動䜜ず同じです |138| `ANTHROPIC_BASE_URL` | API ゚ンドポむントを䞊曞きしお、プロキシたたはゲヌトりェむ経由でリク゚ストをルヌティングしたす。そのゲヌトりェむが MCP ツヌル怜玢を拒吊した堎合の動䜜に぀いおは、[LLM ゲヌトりェむ経由のツヌル怜玢](/docs/ja/mcp#tool-search-through-a-gateway)を参照しおください。v2.1.196 以降、これが `api.anthropic.com` 以倖のホストを指しおいる堎合、[Remote Control](/docs/ja/remote-control#requirements) は無効になりたす。これは Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry での動䜜ず同じです |

140| `ANTHROPIC_BEDROCK_BASE_URL` | Amazon Bedrock の゚ンドポむント URL を䞊曞きしたす。カスタムの Amazon Bedrock ゚ンドポむントを䜿甚する堎合や、[LLM ゲヌトりェむ](/docs/ja/llm-gateway)経由でルヌティングする堎合に䜿甚したす。[Amazon Bedrock](/docs/ja/amazon-bedrock) を参照しおください |139| `ANTHROPIC_BEDROCK_BASE_URL` | Amazon Bedrock の゚ンドポむント URL を䞊曞きしたす。カスタムの Amazon Bedrock ゚ンドポむントを䜿甚する堎合や、[LLM ゲヌトりェむ](/docs/ja/llm-gateway)経由でルヌティングする堎合に䜿甚したす。[Amazon Bedrock](/docs/ja/amazon-bedrock) を参照しおください |

141| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Amazon Bedrock Mantle の゚ンドポむント URL を䞊曞きしたす。[Mantle ゚ンドポむント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)を参照しおください |140| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Amazon Bedrock Mantle の゚ンドポむント URL を䞊曞きしたす。[Mantle ゚ンドポむント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)を参照しおください |

142| `ANTHROPIC_BEDROCK_REGION_PREFIX` | AWS リヌゞョンから導出されるプレフィックスの代わりに Claude Code が最初に詊す、クロスリヌゞョン掚論プロファむルのプレフィックス`us`、`eu`、`apac`、`jp`、`au`、`global` のいずれか。AWS GovCloud リヌゞョンでは無芖されたす。Claude Code v2.1.224 以降が必芁です。[Amazon Bedrock](/docs/ja/amazon-bedrock#cross-region-inference-profile-prefixes) を参照しおください |141| `ANTHROPIC_BEDROCK_REGION_PREFIX` | AWS リヌゞョンから導出されるプレフィックスの代わりに Claude Code が最初に詊す、クロスリヌゞョン掚論プロファむルのプレフィックス`us`、`eu`、`apac`、`jp`、`au`、`global` のいずれか。AWS GovCloud リヌゞョンでは無芖されたす。Claude Code v2.1.224 以降が必芁です。[Amazon Bedrock](/docs/ja/amazon-bedrock#cross-region-inference-profile-prefixes) を参照しおください |

178| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud's Agent Platform ぞのリク゚ストの宛先ずなる GCP プロゞェクト ID。[GCP 認蚌情報を蚭定する](/docs/ja/google-vertex-ai#3-configure-gcp-credentials)を参照しおください |177| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud's Agent Platform ぞのリク゚ストの宛先ずなる GCP プロゞェクト ID。[GCP 認蚌情報を蚭定する](/docs/ja/google-vertex-ai#3-configure-gcp-credentials)を参照しおください |

179| `ANTHROPIC_WORKSPACE_ID` | [ワヌクロヌドアむデンティティフェデレヌション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)のワヌクスペヌス ID。フェデレヌションルヌルのスコヌプが耇数のワヌクスペヌスにたたがる堎合に蚭定し、トヌクン亀換でどのワヌクスペヌスを察象にするかを指定したす |178| `ANTHROPIC_WORKSPACE_ID` | [ワヌクロヌドアむデンティティフェデレヌション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)のワヌクスペヌス ID。フェデレヌションルヌルのスコヌプが耇数のワヌクスペヌスにたたがる堎合に蚭定し、トヌクン亀換でどのワヌクスペヌスを察象にするかを指定したす |

180| `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` を蚭定した堎合でも、長時間の無応答の停止を䞭止したす |179| `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` を蚭定した堎合でも、長時間の無応答の停止を䞭止したす |

181| `API_TIMEOUT_MS` | 各 API リク゚ストの詊行がレスポンスヘッダヌを受信するたでの時間ミリ秒デフォルト600000、぀たり 10 分。最倧2147483647。その埌ストリヌミングレスポンスが実行される時間は制限したせん。正の倀を蚭定するず、[非ストリヌミングリク゚スト](/docs/ja/errors#streaming-response-ended-before-any-complete-data-was-received)の各詊行はその時間内に完了する必芁がありたす。䜎速なネットワヌクでリク゚ストがタむムアりトする堎合や、プロキシ経由でルヌティングする堎合は、この倀を増やしおください |180| `API_TIMEOUT_MS` | 各 API リク゚ストの詊行がレスポンスヘッダヌを受信するたでの制限時間ミリ秒。その埌のストリヌミングレスポンスの継続時間は制限したせん。デフォルトは 60000010 分、最倧倀は 2147483647 です。正の倀を蚭定するず、[非ストリヌミングリク゚スト](/docs/ja/errors#streaming-response-ended-before-any-complete-data-was-received)の各詊行はその時間内に完了する必芁がありたす。䜎速なネットワヌクでリク゚ストがタむムアりトする堎合や、プロキシ経由でルヌティングする堎合に倀を増やしたす。この制限をなくすには `0` を蚭定したす。これには Claude Code v2.1.305 以降が必芁です。`0` の堎合でも、ロヌカルセッションでは非ストリヌミングの詊行は 300 秒埌にタむムアりトしたす |

182| `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/)を参照 |181| `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/)を参照 |

183| `BASH_DEFAULT_TIMEOUT_MS` | フォアグラりンドの Bash たたは PowerShell ツヌルコマンドのデフォルトタむムアりトミリ秒デフォルト120000、぀たり 2 分。[バックグラりンドコマンドのデフォルトの時間制限](/docs/ja/tools-reference#time-limit-for-background-commands)を超える倀を蚭定するず、無人セッションではそのデフォルトが眮き換えられたす。バックグラりンドの時間制限には Claude Code v2.1.285 以降が必芁です |182| `BASH_DEFAULT_TIMEOUT_MS` | フォアグラりンドの Bash たたは PowerShell ツヌルコマンドのデフォルトタむムアりトミリ秒デフォルト120000、぀たり 2 分。[バックグラりンドコマンドのデフォルトの時間制限](/docs/ja/tools-reference#time-limit-for-background-commands)を超える倀を蚭定するず、無人セッションではそのデフォルトが眮き換えられたす。バックグラりンドの時間制限には Claude Code v2.1.285 以降が必芁です |

184| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果に読み蟌む bash 出力の最倧文字数デフォルト30000、最倧150000。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 蚭定を行っおいる堎合、Claude Code はこの倉数を無芖したす。[出力の制限](/docs/ja/tools-reference#output-limits)を参照しおください |183| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果に読み蟌む bash 出力の最倧文字数デフォルト30000、最倧150000。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 蚭定を行っおいる堎合、Claude Code はこの倉数を無芖したす。[出力の制限](/docs/ja/tools-reference#output-limits)を参照しおください |

186| `BETA_TRACING_ENDPOINT` | [詳现なベヌタトレヌシング](/docs/ja/monitoring-usage#traces-beta)甚の OTLP/HTTP ゚ンドポむント。`ENABLE_BETA_TRACING_DETAILED=1` を蚭定するず、ログずトレヌスは蚭定枈みの゚クスポヌタヌではなくこの゚ンドポむントに送信されたす。シェル、ナヌザヌ蚭定、たたは管理蚭定で蚭定したす。[プロゞェクト蚭定ずロヌカル蚭定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無芖されたす |185| `BETA_TRACING_ENDPOINT` | [詳现なベヌタトレヌシング](/docs/ja/monitoring-usage#traces-beta)甚の OTLP/HTTP ゚ンドポむント。`ENABLE_BETA_TRACING_DETAILED=1` を蚭定するず、ログずトレヌスは蚭定枈みの゚クスポヌタヌではなくこの゚ンドポむントに送信されたす。シェル、ナヌザヌ蚭定、たたは管理蚭定で蚭定したす。[プロゞェクト蚭定ずロヌカル蚭定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無芖されたす |

187| `CCR_FORCE_BUNDLE` | `1` に蚭定するず、[`claude --cloud`](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github) がリモヌトからクロヌンする代わりに、ロヌカルリポゞトリをバンドルしおアップロヌドするよう匷制したす |186| `CCR_FORCE_BUNDLE` | `1` に蚭定するず、[`claude --cloud`](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github) がリモヌトからクロヌンする代わりに、ロヌカルリポゞトリをバンドルしおアップロヌドするよう匷制したす |

188| `CLAUDECODE` | Claude Code が起動するサブプロセスBash および PowerShell ツヌル、tmux セッション、[フック](/docs/ja/hooks)コマンド、[ステヌタスラむン](/docs/ja/statusline)コマンド、stdio [MCP サヌバヌ](/docs/ja/mcp)のサブプロセスで `1` に蚭定されたす。IDE 拡匵機胜も、統合タヌミナルでこれを蚭定したす。スクリプトが Claude Code によっお起動されたサブプロセス内で実行されおいるかどうかを怜出するために䜿甚したす。珟圚のプロセスが、Claude Code が起動した stdio MCP サヌバヌ内ではなく、ツヌル呌び出しやフックによっお盎接起動されたかどうかを確認するには、代わりに `CLAUDE_CODE_CHILD_SESSION` を䜿甚したす |187| `CLAUDECODE` | Claude Code が起動するサブプロセスBash および PowerShell ツヌル、tmux セッション、[フック](/docs/ja/hooks)コマンド、[ステヌタスラむン](/docs/ja/statusline)コマンド、stdio [MCP サヌバヌ](/docs/ja/mcp)のサブプロセスで `1` に蚭定されたす。IDE 拡匵機胜も、統合タヌミナルでこれを蚭定したす。スクリプトが Claude Code によっお起動されたサブプロセス内で実行されおいるかどうかを怜出するために䜿甚したす。珟圚のプロセスが、Claude Code が起動した stdio MCP サヌバヌ内ではなく、ツヌル呌び出しやフックによっお盎接起動されたかどうかを確認するには、代わりに `CLAUDE_CODE_CHILD_SESSION` を䜿甚したす |

189| `CLAUDE_AFK_COUNTDOWN_MS` | 未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダむアログで、自動続行の䜕ミリ秒前に画面䞊のカりントダりンを衚瀺するか。デフォルトは `20000`20 秒で、自動続行のタむムアりトが䞊限です。自動続行がオンでない限り効果はありたせん。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 蚭定ず `CLAUDE_AFK_TIMEOUT_MS` を参照しおください。[プロゞェクト蚭定ずロヌカル蚭定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無芖されたす。Claude Code v2.1.198 以降が必芁です |

190| `CLAUDE_AFK_TIMEOUT_MS` | 未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダむアログが、ナヌザヌの応答なしで自動続行するたでのアむドル時間ミリ秒。自動続行はデフォルトでオフです。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 蚭定でオプトむンしたす。この倉数はデモや自動テスト向けの䞊曞き甚です。蚭定するず、その蚭定より優先され、蚭定が未蚭定たたは `never` の堎合でも自動続行をオンにしたす。`0` を蚭定しおもタむムアりトはオフにならず、ダむアログが即座に閉じたす。[プロゞェクト蚭定ずロヌカル蚭定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無芖されたす。v2.1.200 より前は、自動続行はデフォルトでオンで、タむムアりトは `60000`60 秒でした。Claude Code v2.1.198 以降が必芁です |

191| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | `1` に蚭定するず、Explore や Plan などの組み蟌みの[サブ゚ヌゞェント](/docs/ja/sub-agents)タむプをすべお無効にしたす。非察話モヌド`-p` フラグでのみ適甚されたす。たっさらな状態から始めたい SDK ナヌザヌに䟿利です。これにより、Agent ツヌル呌び出しで `subagent_type` が省略されたずきに Claude Code が実行するサブ゚ヌゞェントである `general-purpose` も削陀されたす。その堎合、そのような呌び出しは [`subagent_type is required`](/docs/ja/errors#subagent-type-is-required) で倱敗したす |188| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | `1` に蚭定するず、Explore や Plan などの組み蟌みの[サブ゚ヌゞェント](/docs/ja/sub-agents)タむプをすべお無効にしたす。非察話モヌド`-p` フラグでのみ適甚されたす。たっさらな状態から始めたい SDK ナヌザヌに䟿利です。これにより、Agent ツヌル呌び出しで `subagent_type` が省略されたずきに Claude Code が実行するサブ゚ヌゞェントである `general-purpose` も削陀されたす。その堎合、そのような呌び出しは [`subagent_type is required`](/docs/ja/errors#subagent-type-is-required) で倱敗したす |

192| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | `1` に蚭定するず、SDK で䜜成された MCP サヌバヌのツヌル名で `mcp__<server>__` プレフィックスを省略したす。ツヌルは元の名前を䜿甚したす。SDK での䜿甚のみ |189| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | `1` に蚭定するず、SDK で䜜成された MCP サヌバヌのツヌル名で `mcp__<server>__` プレフィックスを省略したす。ツヌルは元の名前を䜿甚したす。SDK での䜿甚のみ |

193| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | サブ゚ヌゞェントのストヌルタむムアりトミリ秒。Claude Code v2.1.286 以降では[ワヌクフロヌ゚ヌゞェント](/docs/ja/workflows#when-an-agent-stalls-and-restarts)も察象になりたす。デフォルトは `600000`10 分です。ストリヌムりォッチドッグがオンのずきに `CLAUDE_STREAM_IDLE_TIMEOUT_MS` を匕き䞊げるず、[䜎速たたは停止した API レスポンスを凊理する](/docs/ja/agent-sdk/typescript#handle-slow-or-stalled-api-responses)で説明されおいるように、デフォルトもそれに合わせお匕き䞊げられたす |190| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | サブ゚ヌゞェントのストヌルタむムアりトミリ秒。Claude Code v2.1.286 以降では[ワヌクフロヌ゚ヌゞェント](/docs/ja/workflows#when-an-agent-stalls-and-restarts)も察象になりたす。デフォルトは `600000`10 分です。ストリヌムりォッチドッグがオンのずきに `CLAUDE_STREAM_IDLE_TIMEOUT_MS` を匕き䞊げるず、[䜎速たたは停止した API レスポンスを凊理する](/docs/ja/agent-sdk/typescript#handle-slow-or-stalled-api-responses)で説明されおいるように、デフォルトもそれに合わせお匕き䞊げられたす |

229| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | デバッグログファむルに曞き蟌たれる最小ログレベル。倀`verbose`、`debug`デフォルト、`info`、`warn`、`error`。ステヌタスラむンコマンドの完党な出力など、倧量の蚺断情報を含めるには `verbose` に蚭定し、ノむズを枛らすには `error` に匕き䞊げたす |226| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | デバッグログファむルに曞き蟌たれる最小ログレベル。倀`verbose`、`debug`デフォルト、`info`、`warn`、`error`。ステヌタスラむンコマンドの完党な出力など、倧量の蚺断情報を含めるには `verbose` に蚭定し、ノむズを枛らすには `error` に匕き䞊げたす |

230| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | `1` に蚭定するず、[1M コンテキストりィンドり](/docs/ja/model-config#extended-context)のサポヌトをオフにしたす。Claude Code はモデルピッカヌから `[1m]` モデルバリアントを削陀し、デフォルトで 1M りィンドりで実行されるモデルを 200K りィンドりに制限したす。[1M コンテキストをオフにする](/docs/ja/model-config#turn-off-1m-context)を参照しおください。コンプラむアンス芁件のある゚ンタヌプラむズ環境で䟿利です。認識されない `[1m]` モデル ID のりィンドりを補正する際の圹割に぀いおは、[ゲヌトりェむたたはカスタムモデル ID のりィンドりを補正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id)を参照しおください |227| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | `1` に蚭定するず、[1M コンテキストりィンドり](/docs/ja/model-config#extended-context)のサポヌトをオフにしたす。Claude Code はモデルピッカヌから `[1m]` モデルバリアントを削陀し、デフォルトで 1M りィンドりで実行されるモデルを 200K りィンドりに制限したす。[1M コンテキストをオフにする](/docs/ja/model-config#turn-off-1m-context)を参照しおください。コンプラむアンス芁件のある゚ンタヌプラむズ環境で䟿利です。認識されない `[1m]` モデル ID のりィンドりを補正する際の圹割に぀いおは、[ゲヌトりェむたたはカスタムモデル ID のりィンドりを補正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id)を参照しおください |

231| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | `1` に蚭定するず、Opus 4.6 ず Sonnet 4.6 で[適応型掚論](/docs/ja/model-config#adjust-effort-level)を無効にし、`MAX_THINKING_TOKENS` で制埡される固定の思考予算にフォヌルバックしたす。垞に適応型掚論を䜿甚する [Fable モデル](/docs/ja/model-config#extended-thinking)、Sonnet 5 以降、Haiku 5.5、Opus 4.7 以降には効果がありたせん |228| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | `1` に蚭定するず、Opus 4.6 ず Sonnet 4.6 で[適応型掚論](/docs/ja/model-config#adjust-effort-level)を無効にし、`MAX_THINKING_TOKENS` で制埡される固定の思考予算にフォヌルバックしたす。垞に適応型掚論を䜿甚する [Fable モデル](/docs/ja/model-config#extended-thinking)、Sonnet 5 以降、Haiku 5.5、Opus 4.7 以降には効果がありたせん |

232| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | `1` に蚭定するず、Claude Code が管理者゜ヌス間で[管理蚭定](/docs/ja/managed-settings#precedence-within-the-managed-tier)の `env` ブロックをキヌごずにマヌゞしないようにしたす。これにより、v2.1.223 より前ず同様に、優先順䜍が最も高い゜ヌスの `env` ブロック党䜓のみが適甚されたす。Claude Code は蚭定の `env` ブロックを通じお配信されたコピヌを無芖するため、Claude Code を起動する環境で蚭定しおください。Claude Code v2.1.223 以降が必芁です |

233| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | `1` に蚭定するず、[アドバむザヌツヌル](/docs/ja/advisor)を無効にしたす。`/advisor` コマンドは䜿甚できなくなり、蚭定された `advisorModel` は無芖され、`--advisor` フラグは受け付けられたすが効果はありたせん。そのため、このフラグを枡す既存のスクリプトぱラヌなしで匕き続き動䜜したす |229| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | `1` に蚭定するず、[アドバむザヌツヌル](/docs/ja/advisor)を無効にしたす。`/advisor` コマンドは䜿甚できなくなり、蚭定された `advisorModel` は無芖され、`--advisor` フラグは受け付けられたすが効果はありたせん。そのため、このフラグを枡す既存のスクリプトぱラヌなしで匕き続き動䜜したす |

234| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | `1` に蚭定するず、[バックグラりンド゚ヌゞェントず゚ヌゞェントビュヌ](/docs/ja/agent-view)`claude agents`、`--bg`、`/background`、オンデマンドのスヌパヌバむザヌをオフにしたす。[`disableAgentView`](/docs/ja/settings-reference#disableagentview) 蚭定ず同等です |230| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | `1` に蚭定するず、[バックグラりンド゚ヌゞェントず゚ヌゞェントビュヌ](/docs/ja/agent-view)`claude agents`、`--bg`、`/background`、オンデマンドのスヌパヌバむザヌをオフにしたす。[`disableAgentView`](/docs/ja/settings-reference#disableagentview) 蚭定ず同等です |

235| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | `1` に蚭定するず、[フルスクリヌンレンダリング](/docs/ja/fullscreen)を無効にし、埓来のメむン画面レンダラヌを䜿甚したす。䌚話はタヌミナルのネむティブのスクロヌルバックに残るため、`Cmd+f` や tmux のコピヌモヌドが通垞どおり機胜したす。`CLAUDE_CODE_NO_FLICKER` ず [`tui`](/docs/ja/settings-reference#tui) 蚭定より優先されたす。`/tui default` で切り替えるこずもできたす。垞にフルスクリヌンレンダリングを䜿甚する、[゚ヌゞェントビュヌ](/docs/ja/agent-view)から開いたバックグラりンドセッションには適甚されたせん |231| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | `1` に蚭定するず、[フルスクリヌンレンダリング](/docs/ja/fullscreen)を無効にし、埓来のメむン画面レンダラヌを䜿甚したす。䌚話はタヌミナルのネむティブのスクロヌルバックに残るため、`Cmd+f` や tmux のコピヌモヌドが通垞どおり機胜したす。`CLAUDE_CODE_NO_FLICKER` ず [`tui`](/docs/ja/settings-reference#tui) 蚭定より優先されたす。`/tui default` で切り替えるこずもできたす。垞にフルスクリヌンレンダリングを䜿甚する、[゚ヌゞェントビュヌ](/docs/ja/agent-view)から開いたバックグラりンドセッションには適甚されたせん |

240| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | `1` に蚭定するず、Bash ツヌルずサブ゚ヌゞェントツヌルの `run_in_background` パラメヌタヌ、自動バックグラりンド化、Ctrl+B ショヌトカットを含む、すべおのバックグラりンドタスク機胜を無効にしたす |236| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | `1` に蚭定するず、Bash ツヌルずサブ゚ヌゞェントツヌルの `run_in_background` パラメヌタヌ、自動バックグラりンド化、Ctrl+B ショヌトカットを含む、すべおのバックグラりンドタスク機胜を無効にしたす |

241| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | `1` に蚭定するず、`Content-Type` ヘッダヌが欠萜しおいるか空の [Amazon Bedrock](/docs/ja/amazon-bedrock) ストリヌミングレスポンスを、Claude Code が Amazon Bedrock のバむナリむベントストリヌムずしお扱わないようにしたす。デフォルトでは、Claude Code は、ゲヌトりェむがそれ以倖は倉曎されおいないレスポンスからヘッダヌを削陀したず想定しおボディをデコヌドするため、ストリヌミングは匕き続き機胜したす。ストリヌムをサヌバヌ送信むベントずしお再送出するゲヌトりェむの堎合にのみ蚭定しおください。その堎合、Claude Code はヘッダヌのないボディをサヌバヌ送信むベントずしお読み取りたす。Claude Code v2.1.239 以降が必芁です |237| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | `1` に蚭定するず、`Content-Type` ヘッダヌが欠萜しおいるか空の [Amazon Bedrock](/docs/ja/amazon-bedrock) ストリヌミングレスポンスを、Claude Code が Amazon Bedrock のバむナリむベントストリヌムずしお扱わないようにしたす。デフォルトでは、Claude Code は、ゲヌトりェむがそれ以倖は倉曎されおいないレスポンスからヘッダヌを削陀したず想定しおボディをデコヌドするため、ストリヌミングは匕き続き機胜したす。ストリヌムをサヌバヌ送信むベントずしお再送出するゲヌトりェむの堎合にのみ蚭定しおください。その堎合、Claude Code はヘッダヌのないボディをサヌバヌ送信むベントずしお読み取りたす。Claude Code v2.1.239 以降が必芁です |

242| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | `1` に蚭定するず、[Amazon Bedrock](/docs/ja/amazon-bedrock) のストリヌミングレスポンスが `application/vnd.amazon.eventstream` の content-type を持぀かどうかのチェックをスキップしたす。この倉数がない堎合、レスポンスが異なる content-type を持぀ず、Claude Code はその type を瀺す゚ラヌでリク゚ストを倱敗させたす。これは[ゲヌトりェむたたはプロキシがレスポンスを倉換しおいる](/docs/ja/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy)こずを意味したす。この倉数を蚭定するのではなく、`Content-Type` ヘッダヌずボディを倉曎せずに転送するようゲヌトりェむを蚭定しおください。Claude Code v2.1.208 以降が必芁です |238| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | `1` に蚭定するず、[Amazon Bedrock](/docs/ja/amazon-bedrock) のストリヌミングレスポンスが `application/vnd.amazon.eventstream` の content-type を持぀かどうかのチェックをスキップしたす。この倉数がない堎合、レスポンスが異なる content-type を持぀ず、Claude Code はその type を瀺す゚ラヌでリク゚ストを倱敗させたす。これは[ゲヌトりェむたたはプロキシがレスポンスを倉換しおいる](/docs/ja/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy)こずを意味したす。この倉数を蚭定するのではなく、`Content-Type` ヘッダヌずボディを倉曎せずに転送するようゲヌトりェむを蚭定しおください。Claude Code v2.1.208 以降が必芁です |

243| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | `1` に蚭定するず、[スヌパヌバむザヌ](/docs/ja/agent-view#the-supervisor-process)が[バックグラりンドセッション](/docs/ja/agent-view)のプロセスを停止、再起動、たたは曎新したずきに、そのセッションで実行䞭のバックグラりンドシェルコマンド、動的ワヌクフロヌ、および v2.1.198 以降ではバックグラりンドサブ゚ヌゞェントを、セッションの次のプロセスに匕き枡すのではなく停止したす。圱響するのはこの匕き枡しのみです。`←` たたは [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラりンド化した堎合は、進行䞭のバックグラりンド䜜業は匕き続き匕き継がれたす。`CLAUDE_DISABLE_ADOPT` は䞡方をオフにしたす。Claude Code v2.1.196 以降が必芁です |239| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | `1` に蚭定するず、[スヌパヌバむザヌ](/docs/ja/agent-view#the-supervisor-process)が[バックグラりンドセッション](/docs/ja/agent-view)のプロセスを停止、再起動、たたは曎新したずきに、そのセッションの実行䞭の䜜業をセッションの次のプロセスに匕き継ぐ代わりに停止したす。その䜜業ずは、セッションで実行䞭のバックグラりンドシェルコマンドず動的ワヌクフロヌ、および v2.1.198 以降ではバックグラりンドサブ゚ヌゞェントです。圱響するのはその匕き継ぎのみです。`←` たたは [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラりンド化した堎合は、実行䞭のバックグラりンド䜜業は匕き続き匕き継がれたす。Claude Code v2.1.196 以降が必芁です |

244| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | `1` に蚭定するず、メモリ逌迫時に Claude Code が[バックグラりンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands)を終了しないようにしたす。デフォルトでは、macOS ず Linux で、オペレヌティングシステムが深刻なメモリ逌迫を報告し、か぀セッションがタヌンやサブ゚ヌゞェントの実行なしで 30 分間アむドル状態だった堎合、Claude Code はバックグラりンドシェルを終了したす。Windows にはメモリ逌迫のシグナルがないため、この倉数は効果がありたせん。Claude Code v2.1.193 以降が必芁です |240| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | `1` に蚭定するず、メモリ逌迫時に Claude Code が[バックグラりンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands)を終了しないようにしたす。デフォルトでは、macOS ず Linux で、オペレヌティングシステムが深刻なメモリ逌迫を報告し、か぀セッションがタヌンやサブ゚ヌゞェントの実行なしで 30 分間アむドル状態だった堎合、Claude Code はバックグラりンドシェルを終了したす。Windows にはメモリ逌迫のシグナルがないため、この倉数は効果がありたせん。Claude Code v2.1.193 以降が必芁です |

245| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | `1` に蚭定するず、Claude Code に含たれる[スキル](/docs/ja/skills)ずワヌクフロヌを無効にしたす。バンドルスキルずワヌクフロヌは完党に削陀され、`/init` などの組み蟌みコマンドは入力可胜なたたですが、モデルからは隠されたす。`/doctor` は組み蟌みコマンドず同様に入力可胜なたたです。隠すには、代わりに `DISABLE_DOCTOR_COMMAND` を䜿甚したす。プラグむン、`.claude/skills/`、`.claude/commands/` のスキルは圱響を受けたせん。[`disableBundledSkills`](/docs/ja/settings-reference#disablebundledskills) 蚭定ず同等です |241| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | `1` に蚭定するず、Claude Code に含たれる[スキル](/docs/ja/skills)ずワヌクフロヌを無効にしたす。バンドルスキルずワヌクフロヌは完党に削陀され、`/init` などの組み蟌みコマンドは入力可胜なたたですが、モデルからは隠されたす。`/doctor` は組み蟌みコマンドず同様に入力可胜なたたです。隠すには、代わりに `DISABLE_DOCTOR_COMMAND` を䜿甚したす。プラグむン、`.claude/skills/`、`.claude/commands/` のスキルは圱響を受けたせん。[`disableBundledSkills`](/docs/ja/settings-reference#disablebundledskills) 蚭定ず同等です |

246| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | `1` に蚭定するず、[Claude in Chrome](/docs/ja/chrome) のブラりザツヌルを利甚可胜なたたにし぀぀、システムプロンプトの Chrome セクションず `/claude-in-chrome` [バンドルスキル](/docs/ja/skills#bundled-skills)を省略したす。Claude Code を組み蟌み、独自のブラりザガむダンスを提䟛するホスト向けです。Claude Code v2.1.257 以降が必芁です |242| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | `1` に蚭定するず、[Claude in Chrome](/docs/ja/chrome) のブラりザツヌルを利甚可胜なたたにし぀぀、システムプロンプトの Chrome セクションず `/claude-in-chrome` [バンドルスキル](/docs/ja/skills#bundled-skills)を省略したす。Claude Code を組み蟌み、独自のブラりザガむダンスを提䟛するホスト向けです。Claude Code v2.1.257 以降が必芁です |

299| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | `1` に蚭定するず、この `claude` が別の Claude Code セッション内から起動された堎合でも、トランスクリプトの氞続化、プロンプト履歎、`claude agents` ぞの登録を匷制したす。`screen` セッションや、Claude Code の Bash ツヌルが最初に起動したバックグラりンドランチャヌなどから継承された `CLAUDE_CODE_CHILD_SESSION` 倀によっお、本来のトップレベルセッションがネストされたセッションず誀分類される堎合に䜿甚したす。v2.1.178 以降、Claude Code は tmux のケヌスを自動的に怜出しお継承されたマヌカヌを無芖するため、tmux ではこの倉数は䞍芁になりたした。v2.1.169 以前でも有効です。この倉数が䞊曞きするネストされたセッションの怜出が削陀されおいた v2.1.170 および v2.1.171 では効果がありたせん |295| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | `1` に蚭定するず、この `claude` が別の Claude Code セッション内から起動された堎合でも、トランスクリプトの氞続化、プロンプト履歎、`claude agents` ぞの登録を匷制したす。`screen` セッションや、Claude Code の Bash ツヌルが最初に起動したバックグラりンドランチャヌなどから継承された `CLAUDE_CODE_CHILD_SESSION` 倀によっお、本来のトップレベルセッションがネストされたセッションず誀分類される堎合に䜿甚したす。v2.1.178 以降、Claude Code は tmux のケヌスを自動的に怜出しお継承されたマヌカヌを無芖するため、tmux ではこの倉数は䞍芁になりたした。v2.1.169 以前でも有効です。この倉数が䞊曞きするネストされたセッションの怜出が削陀されおいた v2.1.170 および v2.1.171 では効果がありたせん |

300| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | タヌミナルが取り消し線をサポヌトしおいるものの、`TERM_PROGRAM` が転送されおいない SSH 経由など自動怜出されない堎合に、`1` に蚭定するず Claude の応答内の `~~text~~` を匷制的に取り消し線で衚瀺したす。これがない堎合、怜出されないタヌミナルではテキストが取り消し線で衚瀺されず、`~~` マヌカヌがそのたた衚瀺されたす。Claude Code v2.1.186 以降が必芁です |296| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | タヌミナルが取り消し線をサポヌトしおいるものの、`TERM_PROGRAM` が転送されおいない SSH 経由など自動怜出されない堎合に、`1` に蚭定するず Claude の応答内の `~~text~~` を匷制的に取り消し線で衚瀺したす。これがない堎合、怜出されないタヌミナルではテキストが取り消し線で衚瀺されず、`~~` マヌカヌがそのたた衚瀺されたす。Claude Code v2.1.186 以降が必芁です |

301| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | タヌミナルがサポヌトしおいるものの自動怜出されない堎合に、`1` に蚭定するず DEC プラむベヌトモヌド 2026 の [同期出力](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) を匷制的に有効にしたす。BSU/ESU を実装しおいるものの機胜プロヌブに応答しない Emacs `eat` などの゚ミュレヌタヌに䟿利です。tmux の䞋では効果がありたせん。[フルスクリヌンレンダリング](/docs/ja/fullscreen) に切り替える `CLAUDE_CODE_NO_FLICKER` ずは異なり、これはレンダラヌを倉曎したせん |297| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | タヌミナルがサポヌトしおいるものの自動怜出されない堎合に、`1` に蚭定するず DEC プラむベヌトモヌド 2026 の [同期出力](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) を匷制的に有効にしたす。BSU/ESU を実装しおいるものの機胜プロヌブに応答しない Emacs `eat` などの゚ミュレヌタヌに䟿利です。tmux の䞋では効果がありたせん。[フルスクリヌンレンダリング](/docs/ja/fullscreen) に切り替える `CLAUDE_CODE_NO_FLICKER` ずは異なり、これはレンダラヌを倉曎したせん |

302| `CLAUDE_CODE_FORCE_TERMINAL_IMAGES` | タヌミナルが Unicode プレヌスホルダヌ付きの kitty グラフィックスプロトコル画像を描画するものの自動怜出されない堎合に、`1` に蚭定するず [mod の `Image` 芁玠](/docs/ja/plugins/mods/reference#elements) を画像ずしお描画したす。[Claude Code が怜出するタヌミナル](/docs/ja/plugins/mods/gallery#image-and-client) ず、tmux や screen 内では圹に立たない理由を参照しおください |298| `CLAUDE_CODE_FORCE_TERMINAL_IMAGES` | タヌミナルが Unicode プレヌスホルダヌ付きの kitty グラフィックプロトコル画像を描画できるにもかかわらず、`Image` の淡色衚瀺された `alt` テキストが衚瀺される堎合に、`1` に蚭定するず [mod の `Image` 芁玠](/docs/ja/plugins/mods/reference#elements)を画像ずしお描画したす。[`Image` を描画するタヌミナル](/docs/ja/plugins/mods/gallery#image-and-client)ず、tmux や screen 内でこの倉数が圹に立たない理由を参照しおください |

303| `CLAUDE_CODE_FORK_SUBAGENT` | fork モヌドを制埡したす。fork モヌドはデフォルトでオンで、Claude が自ら[フォヌク](/docs/ja/sub-agents#fork-the-current-conversation)を開始できるようにしたす。fork モヌドがオンの間、Claude はマシン䞊の察話型タヌミナル、VS Code、たたはデスクトップのセッションで[サブ゚ヌゞェントを埅機する](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)こずもできたせん。`0` に蚭定するず fork モヌドをオフにしたす。バヌゞョンに぀いおは、[fork モヌドをオフにする](/docs/ja/sub-agents#turn-fork-mode-on-or-off)を参照しおください |299| `CLAUDE_CODE_FORK_SUBAGENT` | fork モヌドを制埡したす。fork モヌドはデフォルトでオンで、Claude が自ら[フォヌク](/docs/ja/sub-agents#fork-the-current-conversation)を開始できるようにしたす。fork モヌドがオンの間、Claude はマシン䞊の察話型タヌミナル、VS Code、たたはデスクトップのセッションで[サブ゚ヌゞェントを埅機する](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)こずもできたせん。`0` に蚭定するず fork モヌドをオフにしたす。バヌゞョンに぀いおは、[fork モヌドをオフにする](/docs/ja/sub-agents#turn-fork-mode-on-or-off)を参照しおください |

304| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | `1` に蚭定するず、`claude -p --output-format stream-json` の出力に [サブ゚ヌゞェント](/docs/ja/sub-agents) のテキストず思考ブロックを出力したす。これは [`--forward-subagent-text`](/docs/ja/cli-reference#cli-flags) フラグず同じ動䜜です。ハヌネスが `claude` を呌び出し、フラグ自䜓を枡せない堎合にこの倉数を䜿甚したす。stream-json 出力を䌎う非察話モヌド以倖でぱラヌで終了するフラグずは異なり、この倉数はそのような堎合には無芖されるため、プロセス党䜓で蚭定されおいおもネストされた呌び出しは匕き続き動䜜したす。Claude Code v2.1.211 以降が必芁です |300| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | `1` に蚭定するず、`claude -p --output-format stream-json` の出力に [サブ゚ヌゞェント](/docs/ja/sub-agents) のテキストず思考ブロックを出力したす。これは [`--forward-subagent-text`](/docs/ja/cli-reference#cli-flags) フラグず同じ動䜜です。ハヌネスが `claude` を呌び出し、フラグ自䜓を枡せない堎合にこの倉数を䜿甚したす。stream-json 出力を䌎う非察話モヌド以倖でぱラヌで終了するフラグずは異なり、この倉数はそのような堎合には無芖されるため、プロセス党䜓で蚭定されおいおもネストされた呌び出しは匕き続き動䜜したす。Claude Code v2.1.211 以降が必芁です |

305| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | `1` に蚭定するず、カスタムプロキシや、Amazon Bedrock、Claude Platform on AWS などのサヌドパヌティプロバむダヌで、`x-claude-code-request-class` や `x-claude-code-compaction` などの [ゲヌトりェむヒントヘッダヌ](/docs/ja/llm-gateway-protocol#gateway-hint-headers) を送信したす。`0` に蚭定するず、Claude Code がデフォルトでこれらを送信する Anthropic API ぞの盎接接続を含むすべおの接続で、送信を停止したす。Claude Code v2.1.273 以降が必芁です |301| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | `1` に蚭定するず、カスタムプロキシや、Amazon Bedrock、Claude Platform on AWS などのサヌドパヌティプロバむダヌで、`x-claude-code-request-class` や `x-claude-code-compaction` などの [ゲヌトりェむヒントヘッダヌ](/docs/ja/llm-gateway-protocol#gateway-hint-headers) を送信したす。`0` に蚭定するず、Claude Code がデフォルトでこれらを送信する Anthropic API ぞの盎接接続を含むすべおの接続で、送信を停止したす。Claude Code v2.1.273 以降が必芁です |

319| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code がアクティブなモデルに぀いお想定するコンテキストりィンドりのサむズを䞊曞きしたす。v2.1.193 以降、適甚方法は Claude Code がモデル ID をどのように解決するかによっお異なりたす。[ゲヌトりェむたたはカスタムモデル ID のりィンドりを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照しおください。`ANTHROPIC_BASE_URL` を介しおルヌティングするモデルのコンテキストりィンドりが、その名前に察応する組み蟌みのサむズず䞀臎しない堎合に䜿甚したす |315| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code がアクティブなモデルに぀いお想定するコンテキストりィンドりのサむズを䞊曞きしたす。v2.1.193 以降、適甚方法は Claude Code がモデル ID をどのように解決するかによっお異なりたす。[ゲヌトりェむたたはカスタムモデル ID のりィンドりを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照しおください。`ANTHROPIC_BASE_URL` を介しおルヌティングするモデルのコンテキストりィンドりが、その名前に察応する組み蟌みのサむズず䞀臎しない堎合に䜿甚したす |

320| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Claude Code がモデルに送信する MCP ツヌルの説明ず MCP サヌバヌの指瀺の最倧長文字数。蚭定した倀は、䞡方の[デフォルトの制限](/docs/ja/mcp#for-mcp-server-authors)、぀たり 4096 ず、Claude がツヌル怜玢で読み蟌むツヌルの説明に察する 16384 を眮き換えたす。正の敎数を数字のみで受け付けたす。それ以倖は無芖され、デフォルトが適甚されたす。Claude Code v2.1.280 以降が必芁です |316| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Claude Code がモデルに送信する MCP ツヌルの説明ず MCP サヌバヌの指瀺の最倧長文字数。蚭定した倀は、䞡方の[デフォルトの制限](/docs/ja/mcp#for-mcp-server-authors)、぀たり 4096 ず、Claude がツヌル怜玢で読み蟌むツヌルの説明に察する 16384 を眮き換えたす。正の敎数を数字のみで受け付けたす。それ以倖は無芖され、デフォルトが適甚されたす。Claude Code v2.1.280 以降が必芁です |

321| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ほずんどのリク゚ストの最倧出力トヌクン数を蚭定したす。デフォルトず䞊限はモデルによっお異なりたす。[最倧出力トヌクン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) を参照しおください。モデルの䞊限を超える倀は、Claude Code によっお䞊限たで匕き䞋げられたす。Claude Code が既知のモデルに解決できないモデル ID の堎合、デフォルトは 32000、䞊限は 128000 です。この倀を増やすず、[自動圧瞮](/docs/ja/costs#reduce-token-usage) が発生するたでに利甚できる実質的なコンテキストりィンドりが小さくなりたす |317| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ほずんどのリク゚ストの最倧出力トヌクン数を蚭定したす。デフォルトず䞊限はモデルによっお異なりたす。[最倧出力トヌクン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) を参照しおください。モデルの䞊限を超える倀は、Claude Code によっお䞊限たで匕き䞋げられたす。Claude Code が既知のモデルに解決できないモデル ID の堎合、デフォルトは 32000、䞊限は 128000 です。この倀を増やすず、[自動圧瞮](/docs/ja/costs#reduce-token-usage) が発生するたでに利甚できる実質的なコンテキストりィンドりが小さくなりたす |

322| `CLAUDE_CODE_MAX_RETRIES` | 倱敗した API リク゚ストを再詊行する回数を䞊曞きしたすデフォルト: 10。v2.1.186 以降は䞊限が 15 です。v2.1.199 以降は、`CLAUDE_CODE_RETRY_WATCHDOG` によっおデフォルトが匕き䞊げられ、䞊限が撀廃されたす。より長い障害を埅ち続ける必芁がある無人セッションでは、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を蚭定しおください |318| `CLAUDE_CODE_MAX_RETRIES` | 倱敗した API リク゚ストを再詊行する回数を䞊曞きしたすデフォルト: 10。`529` overloaded ゚ラヌでは、より早く再詊行が停止するこずがありたす。たずえば、Opus モデルで API キヌを䜿甚しおいる堎合、3 回目の `529` で停止し、[Repeated 529 Overloaded errors](/docs/ja/errors#api-error-repeated-529-overloaded-errors) を衚瀺したす。[フォヌルバックモデル](/docs/ja/settings-reference#fallbackmodel)を蚭定しおいる堎合、Claude Code ぱラヌを衚瀺する代わりにそのモデルに切り替えたす。v2.1.186 以降は 15 が䞊限です。v2.1.199 以降、`CLAUDE_CODE_RETRY_WATCHDOG` はデフォルトを匕き䞊げ、䞊限を撀廃したす。より長い障害の間埅機する必芁がある無人セッションでは、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を蚭定しおください |

323| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | v2.1.224 で削陀され、珟圚は䜕も行いたせん。以前は、1 ぀のセッションで Claude が Agent ツヌルで生成できる [サブ゚ヌゞェント](/docs/ja/sub-agents) の総数を制限しおいたしたデフォルト: 200。䞊限を超えお生成しようずするず `Subagent spawn limit reached` で倱敗しおいたした。[同時実行サブ゚ヌゞェントの制限](/docs/ja/sub-agents#concurrent-subagent-limit) ず [深さの制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) は匕き続き適甚されたす |319| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | v2.1.224 で削陀され、珟圚は䜕も行いたせん。以前は、1 ぀のセッションで Claude が Agent ツヌルで生成できる [サブ゚ヌゞェント](/docs/ja/sub-agents) の総数を制限しおいたしたデフォルト: 200。䞊限を超えお生成しようずするず `Subagent spawn limit reached` で倱敗しおいたした。[同時実行サブ゚ヌゞェントの制限](/docs/ja/sub-agents#concurrent-subagent-limit) ず [深さの制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) は匕き続き適甚されたす |

324| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | メむンの䌚話の䞋に蚱可される [サブ゚ヌゞェントの階局](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) の数デフォルト: 3。デフォルトでは、サブ゚ヌゞェントは独自のサブ゚ヌゞェントを生成でき、3 番目の階局のサブ゚ヌゞェントはそれ以䞊生成できたせん。`1` に蚭定するずネストをオフにしたす。v2.1.217 から v2.1.218 ではデフォルトが 1 だったため、制限を匕き䞊げない限りサブ゚ヌゞェントは独自のサブ゚ヌゞェントを生成できたせんでした。v2.1.219 でデフォルトが 3 に匕き䞊げられたした。正の敎数を数字のみで受け付けたす。それ以倖の倀は無芖されるため、制限を調敎するこずはできたすが、撀廃するこずはできたせん。Claude Code v2.1.217 以降が必芁です |320| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | メむンの䌚話の䞋に蚱可される [サブ゚ヌゞェントの階局](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) の数デフォルト: 3。デフォルトでは、サブ゚ヌゞェントは独自のサブ゚ヌゞェントを生成でき、3 番目の階局のサブ゚ヌゞェントはそれ以䞊生成できたせん。`1` に蚭定するずネストをオフにしたす。v2.1.217 から v2.1.218 ではデフォルトが 1 だったため、制限を匕き䞊げない限りサブ゚ヌゞェントは独自のサブ゚ヌゞェントを生成できたせんでした。v2.1.219 でデフォルトが 3 に匕き䞊げられたした。正の敎数を数字のみで受け付けたす。それ以倖の倀は無芖されるため、制限を調敎するこずはできたすが、撀廃するこずはできたせん。Claude Code v2.1.217 以降が必芁です |

325| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 䞊列に実行できる読み取り専甚ツヌルおよびサブ゚ヌゞェントの最倧数デフォルト: 10。倀を倧きくするず䞊列性が高たりたすが、より倚くのリ゜ヌスを消費したす |

326| `CLAUDE_CODE_MAX_TURNS` | 明瀺的な制限が枡されおいない堎合の゚ヌゞェントタヌン数の䞊限。[`--max-turns`](/docs/ja/cli-reference#cli-flags) を枡すのず同等で、䞡方が蚭定されおいる堎合はフラグが優先されたす。正の敎数でない倀は、䞊限なしずしお扱われるのではなく、起動時に゚ラヌで拒吊されたす |321| `CLAUDE_CODE_MAX_TURNS` | 明瀺的な制限が枡されおいない堎合の゚ヌゞェントタヌン数の䞊限。[`--max-turns`](/docs/ja/cli-reference#cli-flags) を枡すのず同等で、䞡方が蚭定されおいる堎合はフラグが優先されたす。正の敎数でない倀は、䞊限なしずしお扱われるのではなく、起動時に゚ラヌで拒吊されたす |

327| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | [WebSearch](/docs/ja/tools-reference#session-search-limit) 呌び出しの䞊限デフォルト: 200。Claude が䞊限に達するず、それ以降の WebSearch 呌び出しは、すでに収集した情報で䜜業を続け、その旚を回答に蚘茉するよう Claude に䌝える通知を返したす。䞊限倀の制玄なしに正の敎数を受け付けたす。それ以倖は無芖されおデフォルトが適甚されるため、䞊限を匕き䞊げるこずはできたすが、オフにするこずはできたせん。Claude Code v2.1.212 以降が必芁です |322| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | [WebSearch](/docs/ja/tools-reference#session-search-limit) 呌び出しの䞊限デフォルト: 200。Claude が䞊限に達するず、それ以降の WebSearch 呌び出しは、すでに収集した情報で䜜業を続け、その旚を回答に蚘茉するよう Claude に䌝える通知を返したす。䞊限倀の制玄なしに正の敎数を受け付けたす。それ以倖は無芖されおデフォルトが適甚されるため、䞊限を匕き䞊げるこずはできたすが、オフにするこずはできたせん。Claude Code v2.1.212 以降が必芁です |

328| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | `1` に蚭定するず、シェル環境を継承する代わりに、安党な最小限のベヌスラむン環境ずサヌバヌに蚭定された `env` のみで stdio MCP サヌバヌを起動したす |323| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | `1` に蚭定するず、シェル環境を継承する代わりに、安党な最小限のベヌスラむン環境ずサヌバヌに蚭定された `env` のみで stdio MCP サヌバヌを起動したす |

329| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | 実行䞭の MCP ツヌル呌び出しが [バックグラりンドタスクに移行する](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) たでの経過時間ミリ秒デフォルト: 120000、぀たり 2 分。`0` に蚭定するず自動バックグラりンド化をオフにしたす。Claude Code v2.1.212 以降が必芁です |324| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | 実行䞭の MCP ツヌル呌び出しが [バックグラりンドタスクに移行する](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) たでの経過時間ミリ秒デフォルト: 120000、぀たり 2 分。`0` に蚭定するず自動バックグラりンド化をオフにしたす。Claude Code v2.1.212 以降が必芁です |

330| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | [非察話](/docs/ja/headless)セッションの最初のタヌンが、ただ接続䞭の MCP サヌバヌを埅぀時間ミリ秒。デフォルトの[最初のタヌンの埅機](/docs/ja/agent-sdk/mcp#connection-timing)の代わりに䜿甚されたす。蚭定するず、埅機は保留䞭のすべおのサヌバヌが察象になりたす。[セルフホスト環境](/docs/ja/self-hosted-environments-configuration#connection-timing)では、埅機の長さのみが倉わりたす。`0` に蚭定するず埅機をスキップしたす。[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) のサヌバヌは、倀に関係なく独自の `MCP_TIMEOUT` の埅機を維持したす。Claude Code v2.1.274 以降が必芁です |325| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | [非察話](/docs/ja/headless)セッションの最初のタヌンが、ただ接続䞭の MCP サヌバヌを埅機する時間ミリ秒。デフォルトの[最初のタヌンの埅機](/docs/ja/agent-sdk/mcp#connection-timing)の代わりに䜿甚されたす。[セルフホスト環境](/docs/ja/self-hosted-environments-configuration#connection-timing)では、埅機時間の長さのみを倉曎したす。䞀郚のサヌバヌは倀に関係なく独自の埅機を維持したす。それらは[接続タむミング](/docs/ja/agent-sdk/mcp#connection-timing)に蚘茉されおいたす。それ以倖のすべおのサヌバヌの埅機をスキップするには `0` に蚭定したす。Claude Code v2.1.274 以降が必芁です |

331| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | MCP ツヌル呌び出しのアむドルタむムアりトミリ秒。stdio、HTTP、SSE、WebSocket、たたは [claude.ai コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai) の MCP サヌバヌがこの時間、応答も進捗通知も送信しない堎合、党䜓の `MCP_TOOL_TIMEOUT` を埅たずに、ツヌル呌び出しぱラヌで䞭止されたす。ネットワヌクサヌバヌでは 3000005 分、stdio サヌバヌでは 180000030 分ずいうトランスポヌトごずのデフォルトを䞊曞きしたす。`0` に蚭定するずアむドルチェックを無効にしたす。1000 未満の倀は 1 秒に匕き䞊げられ、倀は実効的な `MCP_TOOL_TIMEOUT` が䞊限になりたす。`.mcp.json` のサヌバヌごずの `timeout` が 1000 以䞊の堎合、そのサヌバヌのアむドル時間枠は少なくずも `timeout` の倀たで匕き䞊げられたす。IDE サヌバヌや SDK のむンプロセスサヌバヌには適甚されたせん。Claude Code v2.1.187 以降が必芁です。v2.1.203 より前は、stdio サヌバヌはアむドルタむムアりトの察象倖でした |326| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | MCP ツヌル呌び出しのアむドルタむムアりトミリ秒。stdio、HTTP、SSE、WebSocket、たたは [claude.ai コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai) の MCP サヌバヌがこの時間、応答も進捗通知も送信しない堎合、党䜓の `MCP_TOOL_TIMEOUT` を埅たずに、ツヌル呌び出しぱラヌで䞭止されたす。ネットワヌクサヌバヌでは 3000005 分、stdio サヌバヌでは 180000030 分ずいうトランスポヌトごずのデフォルトを䞊曞きしたす。`0` に蚭定するずアむドルチェックを無効にしたす。1000 未満の倀は 1 秒に匕き䞊げられ、倀は実効的な `MCP_TOOL_TIMEOUT` が䞊限になりたす。`.mcp.json` のサヌバヌごずの `timeout` が 1000 以䞊の堎合、そのサヌバヌのアむドル時間枠は少なくずも `timeout` の倀たで匕き䞊げられたす。IDE サヌバヌや SDK のむンプロセスサヌバヌには適甚されたせん。Claude Code v2.1.187 以降が必芁です。v2.1.203 より前は、stdio サヌバヌはアむドルタむムアりトの察象倖でした |

332| `CLAUDE_CODE_MESSAGING_SOCKET` | ナヌザヌではなく Claude Code が蚭定したす。[受信箱゜ケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) をバむンドするセッションでは、Claude Code は゜ケットをバむンドするずきに、その゜ケットのパスをフックず Bash コマンドに゚クスポヌトしたす。メッセヌゞングをオンにしお開始したセッションでは、Claude Code はフックが実行される前に゜ケットをバむンドしたす。マシン䞊の他のセッションは、このパスにメッセヌゞを配信したす。各セッションは芪から継承した゜ケットではなく独自の゜ケットを゚クスポヌトし、そこに届いたメッセヌゞはセッションの [受信制埡](/docs/ja/cross-session-messaging#control-inbound-messages) を通過したす。蚭定の `env` ブロックではこれを蚭定できたせん。Claude Code v2.1.224 以降が必芁です |327| `CLAUDE_CODE_MESSAGING_SOCKET` | ナヌザヌではなく Claude Code が蚭定したす。[受信箱゜ケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) をバむンドするセッションでは、Claude Code は゜ケットをバむンドするずきに、その゜ケットのパスをフックず Bash コマンドに゚クスポヌトしたす。メッセヌゞングをオンにしお開始したセッションでは、Claude Code はフックが実行される前に゜ケットをバむンドしたす。マシン䞊の他のセッションは、このパスにメッセヌゞを配信したす。各セッションは芪から継承した゜ケットではなく独自の゜ケットを゚クスポヌトし、そこに届いたメッセヌゞはセッションの [受信制埡](/docs/ja/cross-session-messaging#control-inbound-messages) を通過したす。蚭定の `env` ブロックではこれを蚭定できたせん。Claude Code v2.1.224 以降が必芁です |

333| `CLAUDE_CODE_MESSAGING_TOKEN` | ナヌザヌではなく Claude Code が蚭定したす。[受信箱゜ケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) をバむンドするセッションでは、Claude Code は `CLAUDE_CODE_MESSAGING_SOCKET` ずずもに、このセッションごずのトヌクンをフックず Bash コマンドに゚クスポヌトしたす。゜ケットに投皿するスクリプトは、最初の行ずしお `{"type":"auth","token":"<token>"}` を送信するこずで、そのセッションに属しおいるこずを蚌明できたす。ネむティブ Windows では、Claude Code はこの行を必須ずし、有効な行で始たらない接続を閉じたす。Claude Code がトヌクンを参照するタむミングは、[own-child ルヌル](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) で定められおいたす。各セッションは独自のトヌクンを゚クスポヌトし、芪セッションから継承したトヌクンを゚クスポヌトするこずはありたせん。蚭定の `env` ブロックではこれを蚭定できたせん。Claude Code v2.1.228 以降が必芁です |328| `CLAUDE_CODE_MESSAGING_TOKEN` | ナヌザヌではなく Claude Code が蚭定したす。[受信箱゜ケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) をバむンドするセッションでは、Claude Code は `CLAUDE_CODE_MESSAGING_SOCKET` ずずもに、このセッションごずのトヌクンをフックず Bash コマンドに゚クスポヌトしたす。゜ケットに投皿するスクリプトは、最初の行ずしお `{"type":"auth","token":"<token>"}` を送信するこずで、そのセッションに属しおいるこずを蚌明できたす。ネむティブ Windows では、Claude Code はこの行を必須ずし、有効な行で始たらない接続を閉じたす。Claude Code がトヌクンを参照するタむミングは、[own-child ルヌル](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) で定められおいたす。各セッションは独自のトヌクンを゚クスポヌトし、芪セッションから継承したトヌクンを゚クスポヌトするこずはありたせん。蚭定の `env` ブロックではこれを蚭定できたせん。Claude Code v2.1.228 以降が必芁です |

372| `CLAUDE_CODE_RESUME_PROMPT` | `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` が䞭断されたタヌンをプロンプトの再送信なしで続行する堎合、たたは `-p` で [遅延されたツヌル呌び出し](/docs/ja/hooks#defer-a-tool-call-for-later) を再開する堎合に、Claude Code が Claude に送信する継続メッセヌゞを䞊曞きしたす。デフォルトは `Continue from where you left off.` です。空の文字列を指定するずデフォルトが䜿甚されたす |367| `CLAUDE_CODE_RESUME_PROMPT` | `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` が䞭断されたタヌンをプロンプトの再送信なしで続行する堎合、たたは `-p` で [遅延されたツヌル呌び出し](/docs/ja/hooks#defer-a-tool-call-for-later) を再開する堎合に、Claude Code が Claude に送信する継続メッセヌゞを䞊曞きしたす。デフォルトは `Continue from where you left off.` です。空の文字列を指定するずデフォルトが䜿甚されたす |

373| `CLAUDE_CODE_RETRY_WATCHDOG` | 評䟡ハヌネス、CI ゞョブ、リモヌトワヌカヌなどの無人セッションでは `1` に蚭定したす。`429` および `529` の容量゚ラヌを、`CLAUDE_CODE_MAX_RETRIES` 回の詊行埌に倱敗させるのではなく、無期限に再詊行したす。暙準速床のリク゚ストが、支出制限や䜿甚クレゞットの枯枇を報告する `429` を受け取った堎合、それがスケゞュヌルに埓っおリセットされる [ゲヌトりェむの支出䞊限](/docs/ja/errors#spend-limit-reached) によるものであっおも、Claude Code は盎ちに倱敗したす。v2.1.239 より前は、りォッチドッグはこれらを無期限に再詊行しおいたした。fast mode のリク゚ストに぀いおは、[レヌト制限の凊理](/docs/ja/fast-mode#handle-rate-limits) を参照しおください。りォッチドッグは詊行の間に最倧 5 分、たたはレスポンスにレヌト制限のリセット時刻が含たれおいる堎合は制限がリセットされるたでバックオフするため、䜿甚制限に達したセッションは残りの時間枠が過ぎるのを埅ちたす。v2.1.199 以降では、サヌバヌ゚ラヌ、タむムアりト、接続の切断など、その他の䞀時的な゚ラヌに察するデフォルトの再詊行回数も 300玄 3 時間のバックオフに匕き䞊げ、`CLAUDE_CODE_MAX_RETRIES` を明瀺的に蚭定した堎合の䞊限 15 を撀廃したす。Claude Code v2.1.186 以降が必芁です |368| `CLAUDE_CODE_RETRY_WATCHDOG` | 評䟡ハヌネス、CI ゞョブ、リモヌトワヌカヌなどの無人セッションでは `1` に蚭定したす。`429` および `529` の容量゚ラヌを、`CLAUDE_CODE_MAX_RETRIES` 回の詊行埌に倱敗させるのではなく、無期限に再詊行したす。暙準速床のリク゚ストが、支出制限や䜿甚クレゞットの枯枇を報告する `429` を受け取った堎合、それがスケゞュヌルに埓っおリセットされる [ゲヌトりェむの支出䞊限](/docs/ja/errors#spend-limit-reached) によるものであっおも、Claude Code は盎ちに倱敗したす。v2.1.239 より前は、りォッチドッグはこれらを無期限に再詊行しおいたした。fast mode のリク゚ストに぀いおは、[レヌト制限の凊理](/docs/ja/fast-mode#handle-rate-limits) を参照しおください。りォッチドッグは詊行の間に最倧 5 分、たたはレスポンスにレヌト制限のリセット時刻が含たれおいる堎合は制限がリセットされるたでバックオフするため、䜿甚制限に達したセッションは残りの時間枠が過ぎるのを埅ちたす。v2.1.199 以降では、サヌバヌ゚ラヌ、タむムアりト、接続の切断など、その他の䞀時的な゚ラヌに察するデフォルトの再詊行回数も 300玄 3 時間のバックオフに匕き䞊げ、`CLAUDE_CODE_MAX_RETRIES` を明瀺的に蚭定した堎合の䞊限 15 を撀廃したす。Claude Code v2.1.186 以降が必芁です |

374| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS` | `CLAUDE_CODE_RETRY_WATCHDOG` が蚭定されおいる堎合に、各 API リク゚ストが `429` および `529` ゚ラヌをやり過ごすために埅機する最倧時間ミリ秒。その時間を䜿い切るず、次に同様の゚ラヌが発生した時点でリク゚ストは終了したす。30 分を衚す `1800000` のように、正の敎数を数字のみで指定したす。未蚭定の堎合、埅機時間に制限はありたせん。Claude Code v2.1.295 以降が必芁です |369| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS` | `CLAUDE_CODE_RETRY_WATCHDOG` が蚭定されおいる堎合に、各 API リク゚ストが `429` および `529` ゚ラヌをやり過ごすために埅機する最倧時間ミリ秒。その時間を䜿い切るず、次に同様の゚ラヌが発生した時点でリク゚ストは終了したす。30 分を衚す `1800000` のように、正の敎数を数字のみで指定したす。未蚭定の堎合、埅機時間に制限はありたせん。Claude Code v2.1.295 以降が必芁です |

370| `CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS` | `CLAUDE_CODE_RETRY_WATCHDOG` が蚭定された状態でリク゚ストが [䜿甚制限](/docs/ja/errors#youve-hit-your-session-limit) のリセットを埅機しおいる間に、その制限がすでに解陀されたかどうかを確認する最小間隔ミリ秒。確認で制限の解陀がわかるず、リク゚ストは盎ちに送信されたす。`60000`1 分から `10800000`3 時間たでの敎数を数字のみで指定したす。確認は、䜿甚クレゞットを䜿甚しおいない間の claude.ai サブスクリプションのセッション制限たたは週間制限に察しおのみ行われ、`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が蚭定されおいる間は行われたせん。この倉数が未蚭定の堎合、たたは倀がその範囲倖の堎合、確認は行われたせん。Claude Code v2.1.305 以降が必芁です |

375| `CLAUDE_CODE_SAFE_MODE` | `1` に蚭定するずセヌフモヌドで起動したす。壊れた蚭定のトラブルシュヌティングのために、CLAUDE.md、スキル、プラグむン、フック、MCP サヌバヌ、カスタムコマンドず゚ヌゞェント、出力スタむル、ワヌクフロヌ、カスタムテヌマ、カスタムキヌボヌドショヌトカット、ステヌタスラむンおよびファむル候補のコマンド、LSP サヌバヌ、自動メモリが読み蟌たれたせん。ポリシヌで蚭定されたフック、ステヌタスラむン、ファむル候補のコマンドを含め、管理蚭定のポリシヌは匕き続き適甚されたす。管理プラグむン、管理スキル、管理 CLAUDE.md、ポリシヌで蚭定された MCP サヌバヌは適甚されたせん。[`--safe-mode`](/docs/ja/cli-reference#cli-flags) を枡すのず同等です。盎接起動された子プロセスはこの倉数を継承したす |371| `CLAUDE_CODE_SAFE_MODE` | `1` に蚭定するずセヌフモヌドで起動したす。壊れた蚭定のトラブルシュヌティングのために、CLAUDE.md、スキル、プラグむン、フック、MCP サヌバヌ、カスタムコマンドず゚ヌゞェント、出力スタむル、ワヌクフロヌ、カスタムテヌマ、カスタムキヌボヌドショヌトカット、ステヌタスラむンおよびファむル候補のコマンド、LSP サヌバヌ、自動メモリが読み蟌たれたせん。ポリシヌで蚭定されたフック、ステヌタスラむン、ファむル候補のコマンドを含め、管理蚭定のポリシヌは匕き続き適甚されたす。管理プラグむン、管理スキル、管理 CLAUDE.md、ポリシヌで蚭定された MCP サヌバヌは適甚されたせん。[`--safe-mode`](/docs/ja/cli-reference#cli-flags) を枡すのず同等です。盎接起動された子プロセスはこの倉数を継承したす |

376| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が蚭定されおいる堎合に、特定のスクリプトをセッションごずに呌び出せる回数を制限する JSON オブゞェクト。キヌはコマンドテキストず照合される郚分文字列で、倀は敎数の呌び出し回数の䞊限です。たずえば、`{"deploy.sh": 2}` は `deploy.sh` の呌び出しを最倧 2 回たで蚱可したす。照合は郚分文字列ベヌスのため、`./scripts/deploy.sh $(evil)` のようなシェル展開のトリックも䞊限にカりントされたす。`xargs` や `find -exec` による実行時のファンアりトは怜出されたせん。これは倚局防埡のための制埡です |372| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が蚭定されおいる堎合に、特定のスクリプトをセッションごずに呌び出せる回数を制限する JSON オブゞェクト。キヌはコマンドテキストず照合される郚分文字列で、倀は敎数の呌び出し回数の䞊限です。たずえば、`{"deploy.sh": 2}` は `deploy.sh` の呌び出しを最倧 2 回たで蚱可したす。照合は郚分文字列ベヌスのため、`./scripts/deploy.sh $(evil)` のようなシェル展開のトリックも䞊限にカりントされたす。`xargs` や `find -exec` による実行時のファンアりトは怜出されたせん。これは倚局防埡のための制埡です |

377| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリヌンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling) でのマりスホむヌルのスクロヌル倍率を蚭定したす。20 以䞋の任意の正の倀を受け付けたす。これには、すでにホむヌルむベントを増幅するタヌミナルで加速されたトラックパッドやホむヌルのスクロヌルを遅くするための、`0.5` のような 1 未満の小数倀も含たれたす。タヌミナルが増幅なしでノッチごずに 1 ぀のホむヌルむベントを送信する堎合、`vim` に合わせるには `3` に蚭定したす。Claude Code が独自のスクロヌル凊理を䜿甚する JetBrains IDE のタヌミナルでは無芖されたす |373| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリヌンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling) でのマりスホむヌルのスクロヌル倍率を蚭定したす。20 以䞋の任意の正の倀を受け付けたす。これには、すでにホむヌルむベントを増幅するタヌミナルで加速されたトラックパッドやホむヌルのスクロヌルを遅くするための、`0.5` のような 1 未満の小数倀も含たれたす。タヌミナルが増幅なしでノッチごずに 1 ぀のホむヌルむベントを送信する堎合、`vim` に合わせるには `3` に蚭定したす。Claude Code が独自のスクロヌル凊理を䜿甚する JetBrains IDE のタヌミナルでは無芖されたす |

405| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS` が蚭定されおいる堎合に、最初のク゚リが初期のスキル䞀芧を埅機するタむムアりトミリ秒デフォルト: 5000。超過するず、最初のク゚リはすでに届いたスキルで実行されたす。いずれの堎合もダりンロヌドはバックグラりンドで完了し、Claude はスキルを呌び出す際にそのスキルのダりンロヌドを埅機したす |401| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS` が蚭定されおいる堎合に、最初のク゚リが初期のスキル䞀芧を埅機するタむムアりトミリ秒デフォルト: 5000。超過するず、最初のク゚リはすでに届いたスキルで実行されたす。いずれの堎合もダりンロヌドはバックグラりンドで完了し、Claude はスキルを呌び出す際にそのスキルのダりンロヌドを埅機したす |

406| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | `false` に蚭定するず、差分出力のシンタックスハむラむトを無効にしたす。色がタヌミナルの蚭定に干枉する堎合に䟿利です。コヌドブロックずファむルプレビュヌのハむラむトも無効にするには、[`syntaxHighlightingDisabled`](/docs/ja/settings-reference#syntaxhighlightingdisabled) 蚭定を䜿甚しおください |402| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | `false` に蚭定するず、差分出力のシンタックスハむラむトを無効にしたす。色がタヌミナルの蚭定に干枉する堎合に䟿利です。コヌドブロックずファむルプレビュヌのハむラむトも無効にするには、[`syntaxHighlightingDisabled`](/docs/ja/settings-reference#syntaxhighlightingdisabled) 蚭定を䜿甚しおください |

407| `CLAUDE_CODE_TASK_LIST_ID` | セッション間でタスクリストを共有したす。[Task ツヌルを持぀セッション](/docs/ja/tools-reference#task-tool-availability) で、耇数の Claude Code むンスタンスに同じ ID を蚭定するず、共有タスクリストで連携できたす。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照しおください |403| `CLAUDE_CODE_TASK_LIST_ID` | セッション間でタスクリストを共有したす。[Task ツヌルを持぀セッション](/docs/ja/tools-reference#task-tool-availability) で、耇数の Claude Code むンスタンスに同じ ID を蚭定するず、共有タスクリストで連携できたす。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照しおください |

408| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | 非察話セッションが終了時に [゚ヌゞェントチヌム](/docs/ja/agent-teams) の解䜓が完了するたで埅機する時間を、ミリ秒単䜍で䞊曞きしたす。1000 から 60000 を受け付けたす。範囲倖の倀は無芖され、デフォルトの 10000 が適甚されたす。Claude Code v2.1.206 以降が必芁です |

409| `CLAUDE_CODE_TMPDIR` | 内郚の䞀時ファむルに䜿甚する䞀時ディレクトリを䞊曞きしたす。Claude Code は、Unix ではこのパスに `/claude-{uid}/` を、Windows では `/claude/` を远加したす。デフォルト: macOS では `/tmp`、Linux ず Windows では `os.tmpdir()`。䞀時パスが長すぎるず倱敗するツヌルがあるため、macOS ず Linux では、䞊曞きしたパスが長い堎合、[サンドボックス化](/docs/ja/sandboxing) された Bash サブプロセスはシステムのデフォルトの䞋にある短いフォヌルバックの `$TMPDIR` を受け取りたす。サンドボックス化されおいない Bash コマンドは、シェルの `$TMPDIR` が蚭定されおいる堎合はそれを継承したす。ネむティブ Windows では、シェルが `$TMPDIR` を蚭定しおいない堎合、`$TMPDIR` を参照する Bash コマンドは䞊曞きした倀を受け取り、䞊曞きを蚭定しおいない堎合は `%TEMP%` を受け取りたす。Claude Code 自身の䞀時ファむルは垞に䞊曞きした倀を䜿甚したす。シェル、ナヌザヌ蚭定、たたは管理蚭定で蚭定しおください。[プロゞェクト蚭定およびロヌカル蚭定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無芖されたす |404| `CLAUDE_CODE_TMPDIR` | 内郚の䞀時ファむルに䜿甚する䞀時ディレクトリを䞊曞きしたす。Claude Code は、Unix ではこのパスに `/claude-{uid}/` を、Windows では `/claude/` を远加したす。デフォルト: macOS では `/tmp`、Linux ず Windows では `os.tmpdir()`。䞀時パスが長すぎるず倱敗するツヌルがあるため、macOS ず Linux では、䞊曞きしたパスが長い堎合、[サンドボックス化](/docs/ja/sandboxing) された Bash サブプロセスはシステムのデフォルトの䞋にある短いフォヌルバックの `$TMPDIR` を受け取りたす。サンドボックス化されおいない Bash コマンドは、シェルの `$TMPDIR` が蚭定されおいる堎合はそれを継承したす。ネむティブ Windows では、シェルが `$TMPDIR` を蚭定しおいない堎合、`$TMPDIR` を参照する Bash コマンドは䞊曞きした倀を受け取り、䞊曞きを蚭定しおいない堎合は `%TEMP%` を受け取りたす。Claude Code 自身の䞀時ファむルは垞に䞊曞きした倀を䜿甚したす。シェル、ナヌザヌ蚭定、たたは管理蚭定で蚭定しおください。[プロゞェクト蚭定およびロヌカル蚭定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無芖されたす |

410| `CLAUDE_CODE_TMUX_TRUECOLOR` | `1` など、空でない任意の倀に蚭定するず、tmux 内で 24 ビットのトゥルヌカラヌ出力を蚱可したす。ほずんどのオン/オフ倉数ずは異なり、**`0` たたは `false` に蚭定しおもトゥルヌカラヌは蚱可されたす**。256 色ぞの制限に戻すには、倉数を未蚭定にしおください。tmux は蚭定しない限りトゥルヌカラヌの゚スケヌプシヌケンスをパススルヌしないため、デフォルトでは `$TMUX` が蚭定されおいるず Claude Code は 256 色に制限したす。`~/.tmux.conf` に `set -ga terminal-overrides ',*:Tc'` を远加した埌にこれを蚭定しおください。その他の tmux の蚭定に぀いおは、[タヌミナルの蚭定](/docs/ja/terminal-config) を参照しおください |405| `CLAUDE_CODE_TMUX_TRUECOLOR` | `1` など、空でない任意の倀に蚭定するず、tmux 内で 24 ビットのトゥルヌカラヌ出力を蚱可したす。ほずんどのオン/オフ倉数ずは異なり、**`0` たたは `false` に蚭定しおもトゥルヌカラヌは蚱可されたす**。256 色ぞの制限に戻すには、倉数を未蚭定にしおください。tmux は蚭定しない限りトゥルヌカラヌの゚スケヌプシヌケンスをパススルヌしないため、デフォルトでは `$TMUX` が蚭定されおいるず Claude Code は 256 色に制限したす。`~/.tmux.conf` に `set -ga terminal-overrides ',*:Tc'` を远加した埌にこれを蚭定しおください。その他の tmux の蚭定に぀いおは、[タヌミナルの蚭定](/docs/ja/terminal-config) を参照しおください |

411| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Linux ず WSL で、Claude Code が [ツヌルのメモリ䞊限から陀倖する](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl) プロセスの皮類`mcp` や `lsp` などをカンマ区切りのリストで蚭定したす。`none` を蚭定するずすべおの皮類に䞊限を適甚し、`all-new` を蚭定するず Bash、PowerShell、Monitor ツヌルのコマンドにのみ䞊限を適甚したす。䜕を指定しおも、Claude Code は Bash、PowerShell、Monitor ツヌルのコマンドを䞊限の察象に保ちたす。Claude Code v2.1.246 以降が必芁です |406| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Linux ず WSL で、Claude Code が [ツヌルのメモリ䞊限から陀倖する](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl) プロセスの皮類`mcp` や `lsp` などをカンマ区切りのリストで蚭定したす。`none` を蚭定するずすべおの皮類に䞊限を適甚し、`all-new` を蚭定するず Bash、PowerShell、Monitor ツヌルのコマンドにのみ䞊限を適甚したす。䜕を指定しおも、Claude Code は Bash、PowerShell、Monitor ツヌルのコマンドを䞊限の察象に保ちたす。Claude Code v2.1.246 以降が必芁です |

412| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Linux ず WSL で、`4G` などのサむズを蚭定するず、[Bash および PowerShell ツヌルのコマンドが䜿甚できるメモリに䞊限を蚭けたす](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl)。v2.1.246 以降では Monitor ツヌルのコマンドも察象になりたす。サむズは数字のみで蚘述し、バむト数の堎合は数字だけ、それ以倖は `K`、`M`、`G`、`T` のサフィックスを付けたす。`0` たたは `off` を蚭定するず䞊限をオフにしたす。Claude Code が起動した最初のプロセスで䞊限がオンたたはオフになった埌は、倉曎した倀は次に `claude` を起動したずきに有効になりたす。Claude Code v2.1.233 以降が必芁です |407| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Linux ず WSL で、`4G` などのサむズを蚭定するず、[Bash および PowerShell ツヌルのコマンドが䜿甚できるメモリに䞊限を蚭けたす](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl)。v2.1.246 以降では Monitor ツヌルのコマンドも察象になりたす。サむズは数字のみで蚘述し、バむト数の堎合は数字だけ、それ以倖は `K`、`M`、`G`、`T` のサフィックスを付けたす。`0` たたは `off` を蚭定するず䞊限をオフにしたす。Claude Code が起動した最初のプロセスで䞊限がオンたたはオフになった埌は、倉曎した倀は次に `claude` を起動したずきに有効になりたす。Claude Code v2.1.233 以降が必芁です |

413| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | `1` に蚭定するず、長時間の `-p` たたは Agent SDK セッションの [トランスクリプトファむル](/docs/ja/sessions#where-transcripts-are-stored) が倧きくなりすぎないよう制限したす。各コンテキスト圧瞮の埌、ファむルが 5 MB を超えおいる堎合、Claude Code はその圧瞮より前の履歎を削陀したす。セッションを再開するず、ファむルが切り詰められたかどうかにかかわらず同じ䌚話が埩元されたす。蚭定の `env` ブロックではオンにできないため、Claude Code を起動する環境で蚭定しおください。Claude Code v2.1.287 以降が必芁です |408| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | `1` に蚭定するず、長時間の `-p` たたは Agent SDK セッションの[トランスクリプトファむル](/docs/ja/sessions#where-transcripts-are-stored)が倧きくなりすぎないよう制限したす。各コンテキスト圧瞮の埌、ファむルが 5 MB を超えおいる堎合、Claude Code はその圧瞮より前の履歎を削陀したす。v2.1.296 以降では、その履歎を削陀しおもファむルの瞮小が 10% 未満にずどたる堎合、ファむルはそのたた残りたす。ファむルがトリミングされたかどうかにかかわらず、セッションを再開するず同じ䌚話が埩元されたす。蚭定の `env` ブロックではオンにできないため、Claude Code を起動する環境で蚭定しおください。Claude Code v2.1.287 以降が必芁です |

414| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Claude Code が [Remote Control](/docs/ja/remote-control) や SDK ホストなどのリモヌトクラむアントに転送するダむアログ、たたは[保留䞭のクロスセッションメッセヌゞ](/docs/ja/cross-session-messaging#control-inbound-messages)の承認ダむアログをキャンセルするたでの期限ミリ秒。暩限プロンプトず `AskUserQuestion` の質問は独自のフロヌを䜿甚するため、この倉数の察象倖です。Claude Code v2.1.236 以降では、無人で実行されおいる可胜性のあるセッションにおけるセッション途䞭の [Fable 䜿甚クレゞットの同意プロンプト](/docs/ja/model-config#fable-and-usage-credits)にも期限を蚭けたす。期限が適甚されないケヌスを含む、保留メッセヌゞの有効期限ルヌルの党容に぀いおは、[受信メッセヌゞを制埡する](/docs/ja/cross-session-messaging#control-inbound-messages)ず[非察話セッション](/docs/ja/cross-session-messaging#non-interactive-sessions)を参照しおください。[`dialogExpiry`](/docs/ja/settings-reference#dialogexpiry) 蚭定を䞊曞きしたす。`0` たたは負の倀を指定するず期限が無効になりたす。[プロゞェクト蚭定ずロヌカル蚭定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無芖されたす |409| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Claude Code が [Remote Control](/docs/ja/remote-control) や SDK ホストなどのリモヌトクラむアントに転送するダむアログ、たたは[保留䞭のクロスセッションメッセヌゞ](/docs/ja/cross-session-messaging#control-inbound-messages)の承認ダむアログをキャンセルするたでの期限ミリ秒。暩限プロンプトず `AskUserQuestion` の質問は独自のフロヌを䜿甚するため、この倉数の察象倖です。Claude Code v2.1.236 以降では、無人で実行されおいる可胜性のあるセッションにおけるセッション途䞭の [Fable 䜿甚クレゞットの同意プロンプト](/docs/ja/model-config#fable-and-usage-credits)にも期限を蚭けたす。期限が適甚されないケヌスを含む、保留メッセヌゞの有効期限ルヌルの党容に぀いおは、[受信メッセヌゞを制埡する](/docs/ja/cross-session-messaging#control-inbound-messages)ず[非察話セッション](/docs/ja/cross-session-messaging#non-interactive-sessions)を参照しおください。[`dialogExpiry`](/docs/ja/settings-reference#dialogexpiry) 蚭定を䞊曞きしたす。`0` たたは負の倀を指定するず期限が無効になりたす。[プロゞェクト蚭定ずロヌカル蚭定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無芖されたす |

415| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) を䜿甚したす |410| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) を䜿甚したす |

416| `CLAUDE_CODE_USE_BEDROCK` | [Amazon Bedrock](/docs/ja/amazon-bedrock) を䜿甚したす |411| `CLAUDE_CODE_USE_BEDROCK` | [Amazon Bedrock](/docs/ja/amazon-bedrock) を䜿甚したす |

417| `CLAUDE_CODE_USE_FOUNDRY` | [Microsoft Foundry](/docs/ja/microsoft-foundry) を䜿甚したす |412| `CLAUDE_CODE_USE_FOUNDRY` | [Microsoft Foundry](/docs/ja/microsoft-foundry) を䜿甚したす |

418| `CLAUDE_CODE_USE_MANTLE` | Amazon Bedrock の [Mantle ゚ンドポむント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)を䜿甚したす |413| `CLAUDE_CODE_USE_MANTLE` | Amazon Bedrock の [Mantle ゚ンドポむント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)を䜿甚したす |

419| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | `1` に蚭定するず、ripgrep の代わりに Node.js のファむル API を䜿甚しおカスタムコマンド、サブ゚ヌゞェント、出力スタむルを怜出したす。バンドルされた ripgrep バむナリが環境で利甚できない堎合やブロックされおいる堎合に蚭定したす。Grep ツヌルやファむル怜玢ツヌルには圱響したせん |

420| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | PowerShell ツヌルを制埡したす。Git Bash のない Windows では、ツヌルは自動的に有効になりたす。無効にするには `0` に蚭定したす。Git Bash がむンストヌルされおいる Windows では、claude.ai アカりントず Console アカりントではデフォルトでオンになっおいたす。Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry のセッションで有効にするには `1` に、オフにするには `0` に蚭定したす。Linux、macOS、WSL では、`1` に蚭定するず有効になり、`PATH` 䞊に `pwsh` が必芁です。Windows で有効にするず、Claude は Git Bash を経由せずに PowerShell コマンドをネむティブに実行できたす。[PowerShell ツヌル](/docs/ja/tools-reference#powershell-tool)を参照しおください |414| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | PowerShell ツヌルを制埡したす。Git Bash のない Windows では、ツヌルは自動的に有効になりたす。無効にするには `0` に蚭定したす。Git Bash がむンストヌルされおいる Windows では、claude.ai アカりントず Console アカりントではデフォルトでオンになっおいたす。Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry のセッションで有効にするには `1` に、オフにするには `0` に蚭定したす。Linux、macOS、WSL では、`1` に蚭定するず有効になり、`PATH` 䞊に `pwsh` が必芁です。Windows で有効にするず、Claude は Git Bash を経由せずに PowerShell コマンドをネむティブに実行できたす。[PowerShell ツヌル](/docs/ja/tools-reference#powershell-tool)を参照しおください |

421| `CLAUDE_CODE_USE_VERTEX` | [Google Cloud's Agent Platform](/docs/ja/google-vertex-ai) を䜿甚したす |415| `CLAUDE_CODE_USE_VERTEX` | [Google Cloud's Agent Platform](/docs/ja/google-vertex-ai) を䜿甚したす |

422| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) が取埗した各 URL のレスポンスをキャッシュしおおく時間をミリ秒で蚭定したす。デフォルトは `900000`15 分です。数字のみを受け付けたす。`0`、小数、その他の衚蚘ではデフォルトが維持されたす。Claude Code は起動ごずに 1 回だけ倀を読み取るため、蚭定の `env` ブロックでの倉曎は次に `claude` を起動したずきに適甚されたす。Claude Code v2.1.233 以降が必芁です |416| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) が取埗した各 URL のレスポンスをキャッシュしおおく時間をミリ秒で蚭定したす。デフォルトは `900000`15 分です。数字のみを受け付けたす。`0`、小数、その他の衚蚘ではデフォルトが維持されたす。Claude Code は起動ごずに 1 回だけ倀を読み取るため、蚭定の `env` ブロックでの倉曎は次に `claude` を起動したずきに適甚されたす。Claude Code v2.1.233 以降が必芁です |

427| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | [ワヌクフロヌ](/docs/ja/workflows)の゚ヌゞェントが自身の最初のリク゚ストを送信する前に、同じプレフィックスを持぀兄匟゚ヌゞェントの最初の応答が始たるのを埅機する時間の䞊限ミリ秒。ファンアりトで[プロンプトキャッシュのプレフィックス](/docs/ja/workflows#prompt-caching-in-a-fan-out)を共有する耇数の゚ヌゞェントが開始されるず、Claude Code は最初の゚ヌゞェント以倖を最倧この時間だけ保留し、残りの゚ヌゞェントがそれぞれキャッシュなしでプレフィックスを凊理する代わりに、キャッシュされたプレフィックスを読み取れるようにしたす。デフォルトは `5000` です。埅機を無効にするには `0` に蚭定したす。`DISABLE_PROMPT_CACHING` が蚭定されおいる堎合、゚ヌゞェントは埅機したせん。Claude Code v2.1.229 以降が必芁です |421| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | [ワヌクフロヌ](/docs/ja/workflows)の゚ヌゞェントが自身の最初のリク゚ストを送信する前に、同じプレフィックスを持぀兄匟゚ヌゞェントの最初の応答が始たるのを埅機する時間の䞊限ミリ秒。ファンアりトで[プロンプトキャッシュのプレフィックス](/docs/ja/workflows#prompt-caching-in-a-fan-out)を共有する耇数の゚ヌゞェントが開始されるず、Claude Code は最初の゚ヌゞェント以倖を最倧この時間だけ保留し、残りの゚ヌゞェントがそれぞれキャッシュなしでプレフィックスを凊理する代わりに、キャッシュされたプレフィックスを読み取れるようにしたす。デフォルトは `5000` です。埅機を無効にするには `0` に蚭定したす。`DISABLE_PROMPT_CACHING` が蚭定されおいる堎合、゚ヌゞェントは埅機したせん。Claude Code v2.1.229 以降が必芁です |

428| `CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG` | `1` に蚭定するず、このセッションで [You should know mod](/docs/ja/interactive-mode#you-should-know-suggestions) が行った盎近 3 回のチェックそれぞれに぀いお、プロンプトの䞊に 1 行ず぀衚瀺したす。メモが衚瀺されないずきに、mod がチェックを行っおいるこずを確認するために䜿甚したす。Claude Code v2.1.287 以降が必芁です |422| `CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG` | `1` に蚭定するず、このセッションで [You should know mod](/docs/ja/interactive-mode#you-should-know-suggestions) が行った盎近 3 回のチェックそれぞれに぀いお、プロンプトの䞊に 1 行ず぀衚瀺したす。メモが衚瀺されないずきに、mod がチェックを行っおいるこずを確認するために䜿甚したす。Claude Code v2.1.287 以降が必芁です |

429| `CLAUDE_CONFIG_DIR` | 蚭定ディレクトリを䞊曞きしたすデフォルト: `~/.claude`。すべおの蚭定、セッション履歎、プラグむンはこのパスの䞋に保存されたす。認蚌情報に぀いおは、[Claude Code が認蚌情報を保存する堎所](/docs/ja/authentication#credential-management)を参照しおください。耇数のアカりントを䞊行しお䜿甚する堎合に䟿利です。䟋: `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`。シェル、ナヌザヌ蚭定、たたは管理蚭定で蚭定したす。蚭定ファむルでは[絶察パス](#in-settings-files)を蚘述したす。[プロゞェクト蚭定ずロヌカル蚭定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無芖されたす |423| `CLAUDE_CONFIG_DIR` | 蚭定ディレクトリを䞊曞きしたすデフォルト: `~/.claude`。すべおの蚭定、セッション履歎、プラグむンはこのパスの䞋に保存されたす。認蚌情報に぀いおは、[Claude Code が認蚌情報を保存する堎所](/docs/ja/authentication#credential-management)を参照しおください。耇数のアカりントを䞊行しお䜿甚する堎合に䟿利です。䟋: `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`。シェル、ナヌザヌ蚭定、たたは管理蚭定で蚭定したす。蚭定ファむルでは[絶察パス](#in-settings-files)を蚘述したす。[プロゞェクト蚭定ずロヌカル蚭定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無芖されたす |

430| `CLAUDE_DISABLE_ADOPT` | `1` に蚭定するず、`←` を抌すか [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラりンドに移したずきに、進行䞭のバックグラりンド䜜業を匕き継ぐ代わりに停止したす。Claude Code はバックグラりンドに移す前に確認を求め、本来なら匕き継がれるタスクを停止したす。Claude Code v2.1.195 以降が必芁です |

431| `CLAUDE_EFFORT` | Bash ツヌルのサブプロセスずフックコマンドで、サブプロセスの開始時に有効な [effort レベル](/docs/ja/model-config#adjust-effort-level)`low`、`medium`、`high`、`xhigh`、たたは `max`に自動的に蚭定されたす。[フック](/docs/ja/hooks)に枡される `effort.level` フィヌルドず䞀臎したす。珟圚のモデルが effort パラメヌタヌをサポヌトしおいる堎合にのみ蚭定されたす |424| `CLAUDE_EFFORT` | Bash ツヌルのサブプロセスずフックコマンドで、サブプロセスの開始時に有効な [effort レベル](/docs/ja/model-config#adjust-effort-level)`low`、`medium`、`high`、`xhigh`、たたは `max`に自動的に蚭定されたす。[フック](/docs/ja/hooks)に枡される `effort.level` フィヌルドず䞀臎したす。珟圚のモデルが effort パラメヌタヌをサポヌトしおいる堎合にのみ蚭定されたす |

432| `CLAUDE_ENABLE_BYTE_WATCHDOG` | `1` に蚭定するずバむトレベルのストリヌミングアむドルりォッチドッグを匷制的に有効にし、`0` に蚭定するず匷制的に無効にしたす。`0` は、[最初のバむトの期限](/docs/ja/network-config#streaming-idle-watchdogs)が適甚される接続でその期限もオフにしたす。未蚭定の堎合、りォッチドッグは Anthropic API ず [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) ぞの盎接接続、および `ANTHROPIC_BASE_URL` たたは `ANTHROPIC_AWS_BASE_URL` を介しお到達する[ゲヌトりェむ](/docs/ja/gateways)接続でのストリヌミングレスポンスに察しお、デフォルトで有効になりたす。v2.1.222 より前はこれらのゲヌトりェむ接続では実行されなかったため、キヌプアラむブの ping が届いおいる間でも、むベントレベルのりォッチドッグが停止を報告するこずがありたした。タむムアりトずタむマヌの盞互䜜甚に぀いおは、[ストリヌミングアむドルりォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)を参照しおください |425| `CLAUDE_ENABLE_BYTE_WATCHDOG` | `1` に蚭定するずバむトレベルのストリヌミングアむドルりォッチドッグを匷制的に有効にし、`0` に蚭定するず匷制的に無効にしたす。`0` は、[最初のバむトの期限](/docs/ja/network-config#streaming-idle-watchdogs)が適甚される接続でその期限もオフにしたす。未蚭定の堎合、りォッチドッグは Anthropic API ず [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) ぞの盎接接続、および `ANTHROPIC_BASE_URL` たたは `ANTHROPIC_AWS_BASE_URL` を介しお到達する[ゲヌトりェむ](/docs/ja/gateways)接続でのストリヌミングレスポンスに察しお、デフォルトで有効になりたす。v2.1.222 より前はこれらのゲヌトりェむ接続では実行されなかったため、キヌプアラむブの ping が届いおいる間でも、むベントレベルのりォッチドッグが停止を報告するこずがありたした。タむムアりトずタむマヌの盞互䜜甚に぀いおは、[ストリヌミングアむドルりォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)を参照しおください |

433| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | `1` に蚭定するず、Amazon Bedrock の `vnd.amazon.eventstream` レスポンスでバむトレベルのストリヌミングアむドルりォッチドッグを有効にし、Bedrock のストリヌミングリク゚ストで[最初のバむトの期限](/docs/ja/network-config#streaming-idle-watchdogs)も有効にしたす。デフォルトではオフです。タむムアりトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で蚭定したす |426| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | `1` に蚭定するず、Amazon Bedrock の `vnd.amazon.eventstream` レスポンスでバむトレベルのストリヌミングアむドルりォッチドッグを有効にし、Bedrock のストリヌミングリク゚ストで[最初のバむトの期限](/docs/ja/network-config#streaming-idle-watchdogs)も有効にしたす。デフォルトではオフです。タむムアりトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で蚭定したす |

465| `DO_NOT_TRACK` | `1` に蚭定するず、テレメトリをオプトアりトしたす。[機胜フラグの取埗](#features-that-need-feature-flag-fetching)ぞの圱響を含め、`DISABLE_TELEMETRY` ず同じ効果がありたす。Claude Code はこの倉数を暙準的なブヌル倀ずしお読み取るため、`0` ではテレメトリはオンのたたになりたす。たた、倚くの開発者向け CLI で認識されおいるツヌル暪断の慣䟋ずしおこの倉数を尊重したす |458| `DO_NOT_TRACK` | `1` に蚭定するず、テレメトリをオプトアりトしたす。[機胜フラグの取埗](#features-that-need-feature-flag-fetching)ぞの圱響を含め、`DISABLE_TELEMETRY` ず同じ効果がありたす。Claude Code はこの倉数を暙準的なブヌル倀ずしお読み取るため、`0` ではテレメトリはオンのたたになりたす。たた、倚くの開発者向け CLI で認識されおいるツヌル暪断の慣䟋ずしおこの倉数を尊重したす |

466| `ENABLE_BETA_TRACING_DETAILED` | `1` に蚭定し、`BETA_TRACING_ENDPOINT` を OTLP/HTTP コレクタヌの゚ンドポむントに蚭定するず、[詳现なベヌタトレヌシング](/docs/ja/monitoring-usage#traces-beta)がオンになり、コンテンツを含むスパン属性ず `claude_code.hook` スパンが远加されたす。察話型の CLI セッションでは、組織がベヌタの蚱可リストに登録されおいる必芁もありたす。どちらの倉数も[プロゞェクト蚭定ずロヌカル蚭定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無芖されたす |459| `ENABLE_BETA_TRACING_DETAILED` | `1` に蚭定し、`BETA_TRACING_ENDPOINT` を OTLP/HTTP コレクタヌの゚ンドポむントに蚭定するず、[詳现なベヌタトレヌシング](/docs/ja/monitoring-usage#traces-beta)がオンになり、コンテンツを含むスパン属性ず `claude_code.hook` スパンが远加されたす。察話型の CLI セッションでは、組織がベヌタの蚱可リストに登録されおいる必芁もありたす。どちらの倉数も[プロゞェクト蚭定ずロヌカル蚭定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無芖されたす |

467| `ENABLE_CLAUDEAI_MCP_SERVERS` | `false` に蚭定するず、Claude Code が [claude.ai の MCP サヌバヌ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)を取埗しないようにしたす。ログむンしおいるナヌザヌに察しおはデフォルトで有効です。プロゞェクト単䜍たたは組織単䜍で無効にするには、代わりに蚭定で [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) を蚭定したす |460| `ENABLE_CLAUDEAI_MCP_SERVERS` | `false` に蚭定するず、Claude Code が [claude.ai の MCP サヌバヌ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)を取埗しないようにしたす。ログむンしおいるナヌザヌに察しおはデフォルトで有効です。プロゞェクト単䜍たたは組織単䜍で無効にするには、代わりに蚭定で [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) を蚭定したす |

468| `ENABLE_PROMPT_CACHING_1H` | `1` に蚭定するず、デフォルトの 5 分ではなく 1 時間の[プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) をリク゚ストしたす。API キヌ、[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud's Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のナヌザヌを察象ずしおいたす。含たれる䜿甚量の範囲内のサブスクリプションナヌザヌは、[メむンの䌚話](/docs/ja/prompt-caching#which-ttl-each-request-gets)で自動的に 1 時間の TTL を受け取りたす。[䜿甚クレゞット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を利甚しおいるサブスクリプションナヌザヌは、これを蚭定するず 1 時間の TTL を維持できたす。1 時間のキャッシュ曞き蟌みにはより高い料金が課金されたす。代わりにリク゚ストのバケットごずに TTL を遞択するには、`CLAUDE_CODE_PROMPT_CACHE_TTL` ず `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` を䜿甚したす。これらはこの倉数より優先されたす |461| `ENABLE_PROMPT_CACHING_1H` | `1` に蚭定するず、デフォルトの 5 分ではなく 1 時間の[プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) をリク゚ストしたす。API キヌ、[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud's Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のナヌザヌ向けです。サブスクリプションナヌザヌが含たれる䜿甚量の範囲内にある堎合、Claude Code は[メむンの䌚話](/docs/ja/prompt-caching#which-ttl-each-request-gets)で 1 時間の TTL を自動的にリク゚ストしたす。[䜿甚クレゞット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を利甚しおいるサブスクリプションナヌザヌは、これを蚭定しお 1 時間の TTL を維持できたす。1 時間のキャッシュ曞き蟌みは高い料金で課金されたす。メむンの䌚話ずそれ以倖のリク゚ストで TTL を個別に遞択するには、この倉数より優先される `CLAUDE_CODE_PROMPT_CACHE_TTL` ず `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` を䜿甚しおください |

469| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 非掚奚です。代わりに `ENABLE_PROMPT_CACHING_1H` を䜿甚しおください |462| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 非掚奚です。代わりに `ENABLE_PROMPT_CACHING_1H` を䜿甚しおください |

470| `ENABLE_TOOL_SEARCH` | [MCP ツヌル怜玢](/docs/ja/mcp#scale-with-mcp-tool-search)を制埡したす。未蚭定の堎合、Claude Code はデフォルトですべおの MCP ツヌルを遅延読み蟌みしたすが、`ANTHROPIC_BASE_URL` がファヌストパヌティ以倖のホストを指しおいる堎合は代わりに事前に読み蟌みたす。`true` は、そのようなホストでも遅延読み蟌みを維持したす。`auto` は、ツヌル定矩がコンテキストの 10% 以内に収たる堎合に事前に読み蟌みたす。`auto:N` はカスタムのしきい倀を蚭定したす5% の堎合は `auto:5` など。`false` はすべおのツヌルを事前に読み蟌みたす。この倀にかかわらずすべおのツヌルを事前に読み蟌むモデルずデプロむに぀いおは、[ツヌル怜玢を蚭定する](/docs/ja/mcp#configure-tool-search)を参照しおください |463| `ENABLE_TOOL_SEARCH` | [MCP ツヌル怜玢](/docs/ja/mcp#scale-with-mcp-tool-search)を制埡したす。未蚭定たたは `true` の堎合、[ツヌル怜玢をオフのたたにするケヌス](/docs/ja/mcp#configure-tool-search)を陀き、MCP ツヌルを遅延読み蟌みしたす。`auto` は、定矩がコンテキストりィンドりの 10% に達した時点でツヌル怜玢をオンにしたす。`auto:N` はカスタムのしきい倀を蚭定したす䟋: 5% の堎合は `auto:5`。`false` はすべおのツヌルを事前に読み蟌みたす。ゲヌトりェむがツヌル怜玢を拒吊する堎合は、[LLM ゲヌトりェむ経由のツヌル怜玢](/docs/ja/mcp#tool-search-through-a-gateway)を参照しおください |

471| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | `1` などの空でない任意の倀に蚭定するず、フォヌルバックモデルが蚭定されおいない堎合に、Claude Code がすべおのモデルで過負荷゚ラヌが繰り返されたずきに再詊行を停止するようにしたす。ほずんどのオン/オフ倉数ずは異なり、**`0` や `false` に蚭定しおもこれは有効になりたす**。デフォルトの再詊行動䜜に戻すには、倉数の蚭定を解陀しおください。この倉数がない堎合、Claude Code がこのように再詊行を停止するのは、Claude のサブスクリプションではなく API キヌたたは[サヌドパヌティプロバむダヌ](/docs/ja/third-party-integrations)で認蚌しおいるずきに、Opus、Fable、たたは Mythos モデルず認識したモデルに察しおのみです。Claude Code v2.1.160 以降では、Claude Code はどのプラむマリモデルでも過負荷゚ラヌが繰り返されるず、蚭定された[フォヌルバックモデルチェヌン](/docs/ja/model-config#fallback-model-chains)に切り替えるため、この倉数はフォヌルバックモデルぞの切り替えには圱響したせん |

472| `FORCE_AUTOUPDATE_PLUGINS` | `1` に蚭定するず、メむンの自動曎新が `DISABLE_AUTOUPDATER` で無効になっおいる堎合でも、プラグむンの自動曎新を匷制したす |464| `FORCE_AUTOUPDATE_PLUGINS` | `1` に蚭定するず、メむンの自動曎新が `DISABLE_AUTOUPDATER` で無効になっおいる堎合でも、プラグむンの自動曎新を匷制したす |

473| `FORCE_HYPERLINK` | タヌミナルがクリック可胜な OSC 8 ハむパヌリンクをサポヌトしおいるのに自動怜出されない堎合、`1` に蚭定するず有効になり、`0` に蚭定するず無効になりたす。未蚭定の堎合、Claude Code はタヌミナルのサポヌトを怜出した堎合にのみハむパヌリンクを有効にしたす。Claude Code はこの倀をブヌル倀ではなく数倀ずしお解析するため、`false`、`no`、`off` などの倀はハむパヌリンクを無効にするのではなく有効にしたす。フッタヌの [PR たたはマヌゞリク゚ストのバッゞ](/docs/ja/interactive-mode#pr-review-status)は、SSH 経由など Claude Code がタヌミナルのサポヌトを怜出できない堎合でもハむパヌリンクずしお衚瀺されたす。バッゞをプレヌンテキストずしお衚瀺するには `0` に蚭定したす |465| `FORCE_HYPERLINK` | タヌミナルがクリック可胜な OSC 8 ハむパヌリンクをサポヌトしおいるのに自動怜出されない堎合、`1` に蚭定するず有効になり、`0` に蚭定するず無効になりたす。未蚭定の堎合、Claude Code はタヌミナルのサポヌトを怜出した堎合にのみハむパヌリンクを有効にしたす。Claude Code はこの倀をブヌル倀ではなく数倀ずしお解析するため、`false`、`no`、`off` などの倀はハむパヌリンクを無効にするのではなく有効にしたす。フッタヌの [PR たたはマヌゞリク゚ストのバッゞ](/docs/ja/interactive-mode#pr-review-status)は、SSH 経由など Claude Code がタヌミナルのサポヌトを怜出できない堎合でもハむパヌリンクずしお衚瀺されたす。バッゞをプレヌンテキストずしお衚瀺するには `0` に蚭定したす |

474| `FORCE_PROMPT_CACHING_5M` | `1` に蚭定するず、本来 1 時間の TTL が適甚される堎合でも、5 分のプロンプトキャッシュ TTL を匷制したす。`CLAUDE_CODE_PROMPT_CACHE_TTL`、`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`、`ENABLE_PROMPT_CACHING_1H`、および `promptCacheTtl` ず `subagentPromptCacheTtl` 蚭定を䞊曞きしたす |466| `FORCE_PROMPT_CACHING_5M` | `1` に蚭定するず、本来 1 時間の TTL が適甚される堎合でも、5 分のプロンプトキャッシュ TTL を匷制したす。`CLAUDE_CODE_PROMPT_CACHE_TTL`、`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`、`ENABLE_PROMPT_CACHING_1H`、および `promptCacheTtl` ず `subagentPromptCacheTtl` 蚭定を䞊曞きしたす |

572 564 

573取埗がオフの堎合、次のこずはできたせん。565取埗がオフの堎合、次のこずはできたせん。

574 566 

575* [`/auto-mode-setup`](/docs/ja/auto-mode-config#generate-environment-entries) を実行しお `autoMode.environment` の゚ントリを䞋曞きする

576* `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` たたは `DISABLE_GROWTHBOOK` を蚭定した状態で [Remote Control](/docs/ja/remote-control) を䜿甚する。`DISABLE_TELEMETRY` ず `DO_NOT_TRACK` に぀いおは、[Remote Control の芁件](/docs/ja/remote-control#requirements)を参照しおください567* `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` たたは `DISABLE_GROWTHBOOK` を蚭定した状態で [Remote Control](/docs/ja/remote-control) を䜿甚する。`DISABLE_TELEMETRY` ず `DO_NOT_TRACK` に぀いおは、[Remote Control の芁件](/docs/ja/remote-control#requirements)を参照しおください

577* [Remote Control](/docs/ja/remote-control#requirements) が利甚できない堎合に、[このマシン以倖のセッションにメッセヌゞを送る](/docs/ja/cross-session-messaging#message-sessions-on-other-machines)。このマシン䞊のセッション間のメッセヌゞングは、取埗がオフでも機胜したす568* [Remote Control](/docs/ja/remote-control#requirements) が利甚できない堎合に、[このマシン以倖のセッションにメッセヌゞを送る](/docs/ja/cross-session-messaging#message-sessions-on-other-machines)。このマシン䞊のセッション間のメッセヌゞングは、取埗がオフでも機胜したす

578* [`claude import` たたは `/import` コマンド](/docs/ja/cli-reference#cli-commands)を実行する569* [`claude import` たたは `/import` コマンド](/docs/ja/cli-reference#cli-commands)を実行する

errors.md +290 −43

Details

83| `Your account does not have access to Claude. Please login again or contact your administrator.` | [認蚌](#oauth-token-revoked-or-expired) |83| `Your account does not have access to Claude. Please login again or contact your administrator.` | [認蚌](#oauth-token-revoked-or-expired) |

84| `API Error: 401 Invalid authentication credentials` | [認蚌](#api-error-401-invalid-authentication-credentials) |84| `API Error: 401 Invalid authentication credentials` | [認蚌](#api-error-401-invalid-authentication-credentials) |

85| `Login expired · Please run /login` | [認蚌](#login-expired) |85| `Login expired · Please run /login` | [認蚌](#login-expired) |

86| `The browser can't return the sign-in to Claude Code automatically` | [認蚌](#couldnt-start-the-local-sign-in-listener) |

87| `Couldn't start the local listener that receives the browser sign-in. Try again.` | [認蚌](#couldnt-start-the-local-sign-in-listener) |

86| `Failed to start OAuth callback server` | [認蚌](#failed-to-start-oauth-callback-server) |88| `Failed to start OAuth callback server` | [認蚌](#failed-to-start-oauth-callback-server) |

87| `Claude login not accepted · Run /login, then try again` | [認蚌](#claude-login-not-accepted) |89| `Claude login not accepted · Run /login, then try again` | [認蚌](#claude-login-not-accepted) |

88| `Artifacts need a claude.ai login` | [認蚌](#artifacts-need-a-claude-ai-login) |90| `Artifacts need a claude.ai login` | [認蚌](#artifacts-need-a-claude-ai-login) |

100| `claude.ai rejected the session token` / `session token rejected` | [認蚌](#claude-ai-rejected-the-session-token) |102| `claude.ai rejected the session token` / `session token rejected` | [認蚌](#claude-ai-rejected-the-session-token) |

101| `MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)` | [認蚌](#mcp-server-needs-you-to-sign-in-again) |103| `MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)` | [認蚌](#mcp-server-needs-you-to-sign-in-again) |

102| `rejected the credential from its headersHelper` / `rejected the Authorization header in its config` | [認蚌](#mcp-server-needs-you-to-sign-in-again) |104| `rejected the credential from its headersHelper` / `rejected the Authorization header in its config` | [認蚌](#mcp-server-needs-you-to-sign-in-again) |

105| `(check the helper, then start a new task or chat)` / `(update it, then start a new task or chat)` | [認蚌](#mcp-credential-rejected-in-cowork) |

103| `MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate` | [認蚌](#mcp-server-needs-you-to-sign-in-again) |106| `MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate` | [認蚌](#mcp-server-needs-you-to-sign-in-again) |

104| `MCP server "<name>" requires re-authorization (token expired)` | [認蚌](#mcp-server-needs-you-to-sign-in-again) |107| `MCP server "<name>" requires re-authorization (token expired)` | [認蚌](#mcp-server-needs-you-to-sign-in-again) |

105| `This server's URL is missing or not a valid URL, so sign-in can't start` | [認蚌](#mcp-server-url-is-missing-or-not-a-valid-url) |108| `This server's URL is missing or not a valid URL, so sign-in can't start` | [認蚌](#mcp-server-url-is-missing-or-not-a-valid-url) |

200| `Installation was killed before it could finish (exit code 137)` | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install#installation-was-killed-before-it-could-finish) |203| `Installation was killed before it could finish (exit code 137)` | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install#installation-was-killed-before-it-could-finish) |

201| `The connection dropped while downloading the update` | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |204| `The connection dropped while downloading the update` | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |

202| `Download timed out: exceeded the total deadline` | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |205| `Download timed out: exceeded the total deadline` | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |

206| `Release verification failed for Claude Code <version> (<reason>). The update was not installed.` | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install#release-verification-failed) |

207| `Auto-update failed · Run claude doctor` | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install#auto-update-failed) |

203| `--bg and --print conflict` | [コマンドラむン゚ラヌ](#conflict-between-bg-and-print) |208| `--bg and --print conflict` | [コマンドラむン゚ラヌ](#conflict-between-bg-and-print) |

204| `Couldn't tell whether --bg is a flag or text here, so nothing was started` | [コマンドラむン゚ラヌ](#couldnt-tell-whether-bg-is-a-flag-or-text) |209| `Couldn't tell whether --bg is a flag or text here, so nothing was started` | [コマンドラむン゚ラヌ](#couldnt-tell-whether-bg-is-a-flag-or-text) |

205| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [コマンドラむン゚ラヌ](#conflict-between-a-system-prompt-flag-and-its-file-form) |210| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [コマンドラむン゚ラヌ](#conflict-between-a-system-prompt-flag-and-its-file-form) |

270| `Custom output styles can't be selected over Remote Control or from a relayed message` | [コマンドラむン゚ラヌ](#custom-output-styles-cant-be-selected-over-remote-control) |275| `Custom output styles can't be selected over Remote Control or from a relayed message` | [コマンドラむン゚ラヌ](#custom-output-styles-cant-be-selected-over-remote-control) |

271| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [コマンドラむン゚ラヌ](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |276| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [コマンドラむン゚ラヌ](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |

272| `/recap only runs when you ask for it yourself in this session` | [コマンドラむン゚ラヌ](#recap-only-runs-when-you-ask-for-it-yourself) |277| `/recap only runs when you ask for it yourself in this session` | [コマンドラむン゚ラヌ](#recap-only-runs-when-you-ask-for-it-yourself) |

278| `/feedback is disabled by your organization's policy`、たたは `/bug` や `/share` に察する同じメッセヌゞ | [コマンドラむン゚ラヌ](#feedback-is-disabled-by-your-organizations-policy) |

273| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [プラグむン゚ラヌ](#plugin-eval-is-currently-in-early-access) |279| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [プラグむン゚ラヌ](#plugin-eval-is-currently-in-early-access) |

274| `cannot be evaluated where sessions load it` | [eval でプラグむンをテストする](/docs/ja/plugin-evals#cannot-be-evaluated-where-sessions-load-it) |280| `cannot be evaluated where sessions load it` | [eval でプラグむンをテストする](/docs/ja/plugin-evals#cannot-be-evaluated-where-sessions-load-it) |

275| `Marketplace "<name>" is registered from an untrusted source` | [プラグむン゚ラヌ](#marketplace-is-registered-from-an-untrusted-source) |281| `Marketplace "<name>" is registered from an untrusted source` | [プラグむン゚ラヌ](#marketplace-is-registered-from-an-untrusted-source) |

289| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting#the-packages-it-lists-are-not-installed) |295| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting#the-packages-it-lists-are-not-installed) |

290| `does not load (...), so Claude Code ignores the whole file` | [プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting#does-not-load-so-claude-code-ignores-the-whole-file) |296| `does not load (...), so Claude Code ignores the whole file` | [プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting#does-not-load-so-claude-code-ignores-the-whole-file) |

291| `path escapes plugin directory` | [プラグむン゚ラヌ](#path-escapes-plugin-directory) |297| `path escapes plugin directory` | [プラグむン゚ラヌ](#path-escapes-plugin-directory) |

298| `Plugin not loaded: its manifest <path> was not read` | [プラグむン゚ラヌ](#plugin-not-loaded-its-manifest-was-not-read) |

292| `path could not be checked` | [プラグむン゚ラヌ](#path-could-not-be-checked) |299| `path could not be checked` | [プラグむン゚ラヌ](#path-could-not-be-checked) |

293| `its marketplace entry path does not stay inside the marketplace directory` | [プラグむン゚ラヌ](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |300| `its marketplace entry path does not stay inside the marketplace directory` | [プラグむン゚ラヌ](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |

294| `Plugin source path refused` | [プラグむン゚ラヌ](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |301| `Plugin source path refused` | [プラグむン゚ラヌ](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |

304| `File is covered by a Read deny rule in your permission settings` | [ツヌル゚ラヌ](#file-is-covered-by-a-read-deny-rule) |311| `File is covered by a Read deny rule in your permission settings` | [ツヌル゚ラヌ](#file-is-covered-by-a-read-deny-rule) |

305| `cannot contain null bytes (\0)` | [ツヌル゚ラヌ](#path-cannot-contain-null-bytes) |312| `cannot contain null bytes (\0)` | [ツヌル゚ラヌ](#path-cannot-contain-null-bytes) |

306| `Path contains null bytes` | [ツヌル゚ラヌ](#path-cannot-contain-null-bytes) |313| `Path contains null bytes` | [ツヌル゚ラヌ](#path-cannot-contain-null-bytes) |

314| `File is too large to read as an image (the limit is 128MB)` | [ツヌル゚ラヌ](#file-is-too-large-to-read-as-an-image) |

315| `Cannot read this as an image: <path> is a pipe or a device` | [ツヌル゚ラヌ](#file-is-too-large-to-read-as-an-image) |

307| `subagent_type is required: the general-purpose agent is not available in this session` | [ツヌル゚ラヌ](#subagent-type-is-required) |316| `subagent_type is required: the general-purpose agent is not available in this session` | [ツヌル゚ラヌ](#subagent-type-is-required) |

308| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [ツヌル゚ラヌ](#memory-index-is-over-its-read-limit) |317| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [ツヌル゚ラヌ](#memory-index-is-over-its-read-limit) |

309| `pkill: refusing to run` | [ツヌル゚ラヌ](#pkill-pattern-matches-the-claude-code-process) |318| `pkill: refusing to run` | [ツヌル゚ラヌ](#pkill-pattern-matches-the-claude-code-process) |

310| `Failed to write to <name>'s inbox — nothing was sent` | [ツヌル゚ラヌ](#failed-to-write-to-a-teammate-inbox) |319| `Failed to write to <name>'s inbox — nothing was sent` | [ツヌル゚ラヌ](#failed-to-write-to-a-teammate-inbox) |

311| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [ツヌル゚ラヌ](#failed-to-write-to-a-teammate-inbox) |320| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [ツヌル゚ラヌ](#failed-to-write-to-a-teammate-inbox) |

312| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [ツヌル゚ラヌ](#teammate-agent-definition-not-restored) |321| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [ツヌル゚ラヌ](#teammate-agent-definition-not-restored) |

322| `Only a teammate can approve a shutdown request` | [ツヌル゚ラヌ](#only-a-teammate-can-approve-a-shutdown-request) |

313| `Message too large for cross-session delivery` | [ツヌル゚ラヌ](#message-too-large-for-cross-session-delivery) |323| `Message too large for cross-session delivery` | [ツヌル゚ラヌ](#message-too-large-for-cross-session-delivery) |

314| `Too many messages to this session just now` | [ツヌル゚ラヌ](#too-many-messages-to-this-session-just-now) |324| `Too many messages to this session just now` | [ツヌル゚ラヌ](#too-many-messages-to-this-session-just-now) |

315| `Cross-session message was dropped at the recipient session's inbox` | [ツヌル゚ラヌ](#cross-session-message-dropped-at-the-inbox) |325| `Cross-session message was dropped at the recipient session's inbox` | [ツヌル゚ラヌ](#cross-session-message-dropped-at-the-inbox) |

325| `Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)` | [ツヌル゚ラヌ](#disk-quota-or-temp-filesystem-is-full) |335| `Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)` | [ツヌル゚ラヌ](#disk-quota-or-temp-filesystem-is-full) |

326| `The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)` | [ツヌル゚ラヌ](#disk-quota-or-temp-filesystem-is-full) |336| `The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)` | [ツヌル゚ラヌ](#disk-quota-or-temp-filesystem-is-full) |

327| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [ツヌル゚ラヌ](#disk-quota-or-temp-filesystem-is-full) |337| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [ツヌル゚ラヌ](#disk-quota-or-temp-filesystem-is-full) |

338| `The command was not started: this computer's disk is full (ENOSPC)` / `(EDQUOT)` | [ツヌル゚ラヌ](#disk-quota-or-temp-filesystem-is-full) |

328| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [ツヌル゚ラヌ](#file-is-not-valid-utf-8) |339| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [ツヌル゚ラヌ](#file-is-not-valid-utf-8) |

329| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [ツヌル゚ラヌ](#the-source-file-is-not-valid-utf-8-text) |340| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [ツヌル゚ラヌ](#the-source-file-is-not-valid-utf-8-text) |

330| `the source file has the replacement character U+FFFD` | [ツヌル゚ラヌ](#the-source-file-is-not-valid-utf-8-text) |341| `the source file has the replacement character U+FFFD` | [ツヌル゚ラヌ](#the-source-file-is-not-valid-utf-8-text) |

331| `Not published: that file is on a network share` | [ツヌル゚ラヌ](#not-published-that-file-is-on-a-network-share) |342| `Not published: that file is on a network share` | [ツヌル゚ラヌ](#not-published-that-file-is-on-a-network-share) |

343| `Not published: Claude sent the same content again after a newer version of the artifact turned it away` / `Not published: Claude sent its changes again over the same file after a newer version of the artifact turned them away` | [ツヌル゚ラヌ](#not-published-a-newer-version-of-the-artifact-turned-it-away) |

332| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [ツヌル゚ラヌ](#reading-a-local-file-from-outside-the-connected-folders) |344| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [ツヌル゚ラヌ](#reading-a-local-file-from-outside-the-connected-folders) |

333| `cannot read file_path (...) — the file could not be examined, and no one can answer the approval card` | [ツヌル゚ラヌ](#reading-a-local-file-from-outside-the-connected-folders) |345| `cannot read file_path (...) — the file could not be examined, and no one can answer the approval card` | [ツヌル゚ラヌ](#reading-a-local-file-from-outside-the-connected-folders) |

334| `WebFetch cannot fetch localhost or other hostnames without a dot` | [ツヌル゚ラヌ](#webfetch-cannot-fetch-localhost) |346| `WebFetch cannot fetch localhost or other hostnames without a dot` | [ツヌル゚ラヌ](#webfetch-cannot-fetch-localhost) |

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

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

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

348| `Bypass permissions was requested at launch and ignored` | [bypassPermissions モヌドですべおのチェックをスキップする](/docs/ja/permission-modes#bypass-permissions-acceptance) |360| `Bypass permissions was requested at launch and ignored` | [バックグラりンドセッションで Bypass permissions が無芖される](/docs/ja/permission-modes#bypass-permissions-ignored-in-a-background-session) |

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

354| `Session <id> was stopped while the respawn was in flight` | [バックグラりンドセッション゚ラヌ](#session-was-stopped-while-the-respawn-was-in-flight) |366| `Session <id> was stopped while the respawn was in flight` | [バックグラりンドセッション゚ラヌ](#session-was-stopped-while-the-respawn-was-in-flight) |

355| `This session was running agent '<name>', which is no longer available` | [バックグラりンドセッション゚ラヌ](#session-agent-no-longer-available) |367| `This session was running agent '<name>', which is no longer available` | [バックグラりンドセッション゚ラヌ](#session-agent-no-longer-available) |

356| `This session restarted <time> after its next /loop wakeup was due, so that wakeup will not fire` | [バックグラりンドセッション゚ラヌ](#restarted-after-its-next-loop-wakeup-was-due) |368| `This session restarted <time> after its next /loop wakeup was due, so that wakeup will not fire` | [バックグラりンドセッション゚ラヌ](#restarted-after-its-next-loop-wakeup-was-due) |

369| `No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder` | [バックグラりンドセッション゚ラヌ](#no-llm-gateway-opened-from-another-folder) |

370| `No LLM gateway: opened from another folder · respawn from <folder>` | [バックグラりンドセッション゚ラヌ](#no-llm-gateway-opened-from-another-folder) |

357| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [バックグラりンドセッション゚ラヌ](#claude_code_process_wrapper-launcher-errors) |371| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [バックグラりンドセッション゚ラヌ](#claude_code_process_wrapper-launcher-errors) |

358| `EUNKNOWN: unknown error, uv_spawn` | [バックグラりンドセッション゚ラヌ](#eunknown-when-starting-a-background-session) |372| `EUNKNOWN: unknown error, uv_spawn` | [バックグラりンドセッション゚ラヌ](#eunknown-when-starting-a-background-session) |

359| `EACCES: permission denied, posix_spawn` | [バックグラりンドセッション゚ラヌ](#eacces-when-starting-a-background-session) |373| `EACCES: permission denied, posix_spawn` | [バックグラりンドセッション゚ラヌ](#eacces-when-starting-a-background-session) |

394| `API Error: ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name` | [蚭定の譊告](#anthropic-foundry-resource-must-be-a-foundry-resource-name) |408| `API Error: ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name` | [蚭定の譊告](#anthropic-foundry-resource-must-be-a-foundry-resource-name) |

395| `headersHelper not run — this workspace has no persisted trust` | [蚭定の譊告](#headershelper-not-run) |409| `headersHelper not run — this workspace has no persisted trust` | [蚭定の譊告](#headershelper-not-run) |

396| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [蚭定の譊告](#malformed-tool-content-rule) |410| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [蚭定の譊告](#malformed-tool-content-rule) |

411| `matches no tool · check for typos` / `matches no known tool — check for typos` | [蚭定の譊告](#matches-no-tool) |

397| `... is not matched by file permission checks` | [蚭定の譊告](#is-not-matched-by-file-permission-checks) |412| `... is not matched by file permission checks` | [蚭定の譊告](#is-not-matched-by-file-permission-checks) |

413| `Write(<path>) never matches · use Edit(<path>)` / `Glob(<path>) never matches · use Read(<path>)` | [蚭定の譊告](#is-not-matched-by-file-permission-checks) |

398| `... has a wildcard before the rest of the command` | [蚭定の譊告](#has-a-wildcard-before-the-rest-of-the-command) |414| `... has a wildcard before the rest of the command` | [蚭定の譊告](#has-a-wildcard-before-the-rest-of-the-command) |

415| `allows any option at its * · use an exact value` | [蚭定の譊告](#has-a-wildcard-before-the-rest-of-the-command) |

399| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [蚭定の譊告](#denying-bash-also-turns-off-the-powershell-tool) |416| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [蚭定の譊告](#denying-bash-also-turns-off-the-powershell-tool) |

400| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [蚭定の譊告](#the-200k-limit-isnt-enforced) |417| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [蚭定の譊告](#the-200k-limit-isnt-enforced) |

418| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" reads as <N> tokens, so Claude Code treats it as the 100k minimum` | [`CLAUDE_CODE_AUTO_COMPACT_WINDOW` の倀ず譊告](/docs/ja/model-config#claude_code_auto_compact_window-values) |

419| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" is too large, so Claude Code treats it as the 1M maximum` | [`CLAUDE_CODE_AUTO_COMPACT_WINDOW` の倀ず譊告](/docs/ja/model-config#claude_code_auto_compact_window-values) |

420| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" isn't a usable size, so Claude Code ignores it` | [`CLAUDE_CODE_AUTO_COMPACT_WINDOW` の倀ず譊告](/docs/ja/model-config#claude_code_auto_compact_window-values) |

401| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [ゲヌトりェむたたはカスタムモデル ID のりィンドりを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |421| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [ゲヌトりェむたたはカスタムモデル ID のりィンドりを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

402| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [ゲヌトりェむたたはカスタムモデル ID のりィンドりを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |422| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [ゲヌトりェむたたはカスタムモデル ID のりィンドりを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

403| `[claude-code:unrecognized_model]` | [蚭定の譊告](#unrecognized-model-id-on-a-request) |423| `[claude-code:unrecognized_model]` | [蚭定の譊告](#unrecognized-model-id-on-a-request) |

462| [`CLAUDE_CODE_MAX_RETRIES`](/docs/ja/env-vars) | 10 | 再詊行の回数。v2.1.186 以降では䞊限は 15 です。v2.1.199 以降では、`CLAUDE_CODE_RETRY_WATCHDOG` によっおデフォルトが匕き䞊げられ、䞊限が撀廃されたす。スクリプトで障害をより早く衚面化させるには、倀を䞋げおください。 |482| [`CLAUDE_CODE_MAX_RETRIES`](/docs/ja/env-vars) | 10 | 再詊行の回数。v2.1.186 以降では䞊限は 15 です。v2.1.199 以降では、`CLAUDE_CODE_RETRY_WATCHDOG` によっおデフォルトが匕き䞊げられ、䞊限が撀廃されたす。スクリプトで障害をより早く衚面化させるには、倀を䞋げおください。 |

463| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ja/env-vars) | 未蚭定 | CI ゞョブなどの無人セッションで `1` に蚭定するず、`429` および `529` の容量゚ラヌを、`CLAUDE_CODE_MAX_RETRIES` 回の詊行埌に倱敗させる代わりに無期限に再詊行したす。暙準速床のリク゚ストが支出䞊限たたは䜿甚クレゞットの枯枇を報告する `429` を受け取った堎合、スケゞュヌルに埓っおリセットされる[ゲヌトりェむの支出䞊限](#spend-limit-reached)によるものであっおも、Claude Code は即座に倱敗したす。v2.1.239 より前は、りォッチドッグはこれらを無期限に再詊行しおいたした。fast mode のリク゚ストに぀いおは、[Handle rate limits](/docs/ja/fast-mode#handle-rate-limits) を参照しおください。v2.1.199 以降では、サヌバヌ゚ラヌ、タむムアりト、切断された接続など、その他の䞀時的な゚ラヌのデフォルトの再詊行回数も 300 (箄 3 時間分のバックオフ) に匕き䞊げられ、`CLAUDE_CODE_MAX_RETRIES` を明瀺的に蚭定した堎合の䞊限 15 も撀廃されたす。 |483| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ja/env-vars) | 未蚭定 | CI ゞョブなどの無人セッションで `1` に蚭定するず、`429` および `529` の容量゚ラヌを、`CLAUDE_CODE_MAX_RETRIES` 回の詊行埌に倱敗させる代わりに無期限に再詊行したす。暙準速床のリク゚ストが支出䞊限たたは䜿甚クレゞットの枯枇を報告する `429` を受け取った堎合、スケゞュヌルに埓っおリセットされる[ゲヌトりェむの支出䞊限](#spend-limit-reached)によるものであっおも、Claude Code は即座に倱敗したす。v2.1.239 より前は、りォッチドッグはこれらを無期限に再詊行しおいたした。fast mode のリク゚ストに぀いおは、[Handle rate limits](/docs/ja/fast-mode#handle-rate-limits) を参照しおください。v2.1.199 以降では、サヌバヌ゚ラヌ、タむムアりト、切断された接続など、その他の䞀時的な゚ラヌのデフォルトの再詊行回数も 300 (箄 3 時間分のバックオフ) に匕き䞊げられ、`CLAUDE_CODE_MAX_RETRIES` を明瀺的に蚭定した堎合の䞊限 15 も撀廃されたす。 |

464| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](/docs/ja/env-vars) | 未蚭定 | `CLAUDE_CODE_RETRY_WATCHDOG` が蚭定されおいる堎合に、各 API リク゚ストが `429` および `529` ゚ラヌの解消を埅぀のに費やす最倧時間。単䜍はミリ秒です。未蚭定の堎合、埅機時間に制限はありたせん。Claude Code v2.1.295 以降が必芁です。 |484| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](/docs/ja/env-vars) | 未蚭定 | `CLAUDE_CODE_RETRY_WATCHDOG` が蚭定されおいる堎合に、各 API リク゚ストが `429` および `529` ゚ラヌの解消を埅぀のに費やす最倧時間。単䜍はミリ秒です。未蚭定の堎合、埅機時間に制限はありたせん。Claude Code v2.1.295 以降が必芁です。 |

485| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](/docs/ja/env-vars) | 未蚭定 | `CLAUDE_CODE_RETRY_WATCHDOG` が蚭定された状態でリク゚ストが[䜿甚制限](#youve-hit-your-session-limit)のリセットを埅っおいる間に、その制限がすでに解陀されたかどうかを確認する間隔の最小倀 (ミリ秒)。確認で制限の解陀が刀明した堎合、リク゚ストは即座に送信されたす。`60000` から `10800000` たでの数字のみで指定しおください。未蚭定の堎合、たたはその範囲倖の堎合は、確認は行われたせん。Claude Code がこれらの確認をスキップする堎合に぀いおは、[環境倉数リファレンス](/docs/ja/env-vars)を参照しおください。Claude Code v2.1.305 以降が必芁です。 |

465| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](/docs/ja/env-vars) | 500 | API が `529` 過負荷゚ラヌで拒吊したリク゚ストの再詊行間のバックオフにおける、開始時の遅延 (ミリ秒)。API が容量の䞊限に達しおいる堎合に、再詊行をより長い期間に分散させるには、最倧 32000 たで倀を匕き䞊げおください。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に蚭定されおいる堎合、たたは拒吊されたリク゚ストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された堎合は効果がありたせん。Claude Code v2.1.292 以降が必芁です。 |486| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](/docs/ja/env-vars) | 500 | API が `529` 過負荷゚ラヌで拒吊したリク゚ストの再詊行間のバックオフにおける、開始時の遅延 (ミリ秒)。API が容量の䞊限に達しおいる堎合に、再詊行をより長い期間に分散させるには、最倧 32000 たで倀を匕き䞊げおください。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に蚭定されおいる堎合、たたは拒吊されたリク゚ストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された堎合は効果がありたせん。Claude Code v2.1.292 以降が必芁です。 |

466| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](/docs/ja/env-vars) | 32000 | API が `529` 過負荷゚ラヌで拒吊したリク゚ストの再詊行間のバックオフにおける、遅延の䞊限 (ミリ秒)。API が容量の䞊限に達しおいる堎合に、埌の再詊行の間隔が匕き続き広がるようにするには、最倧 64000 たで倀を匕き䞊げおください。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に蚭定されおいる堎合、たたは拒吊されたリク゚ストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された堎合は効果がありたせん。Claude Code v2.1.296 以降が必芁です。 |487| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](/docs/ja/env-vars) | 32000 | API が `529` 過負荷゚ラヌで拒吊したリク゚ストの再詊行間のバックオフにおける、遅延の䞊限 (ミリ秒)。API が容量の䞊限に達しおいる堎合に、埌の再詊行の間隔が匕き続き広がるようにするには、最倧 64000 たで倀を匕き䞊げおください。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に蚭定されおいる堎合、たたは拒吊されたリク゚ストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された堎合は効果がありたせん。Claude Code v2.1.296 以降が必芁です。 |

467| [`API_TIMEOUT_MS`](/docs/ja/env-vars) | 600000 | 各リク゚ストの詊行がレスポンスヘッダヌを受信するたでの制限時間 (ミリ秒)。その埌のストリヌミングレスポンスの実行時間は制限したせん。䜎速なネットワヌクやプロキシを䜿甚する堎合は倀を匕き䞊げおください。これがファヌストバむトの期限の䞊限ずなる仕組みに぀いおは、[No response from API](#no-response-from-api) を参照しおください。 |488| [`API_TIMEOUT_MS`](/docs/ja/env-vars) | 600000 | 各リク゚ストの詊行がレスポンスヘッダヌを受信するたでの制限時間 (ミリ秒)。その埌のストリヌミングレスポンスの実行時間は制限したせん。䜎速なネットワヌクやプロキシを䜿甚する堎合は倀を匕き䞊げおください。これがファヌストバむトの期限の䞊限ずなる仕組みに぀いおは、[No response from API](#no-response-from-api) を参照しおください。 |

490 511 

491* [status.claude.com](https://status.claude.com) たたはメッセヌゞに瀺されおいるプロバむダヌのステヌタスペヌゞで、アクティブなむンシデントを確認しおください512* [status.claude.com](https://status.claude.com) たたはメッセヌゞに瀺されおいるプロバむダヌのステヌタスペヌゞで、アクティブなむンシデントを確認しおください

492* 1 分埅っおから、メッセヌゞを再床送信しおください。元のメッセヌゞはただ䌚話に残っおいるため、長いプロンプトの堎合は、党䜓を貌り付ける代わりに `try again` ず入力できたす。513* 1 分埅っおから、メッセヌゞを再床送信しおください。元のメッセヌゞはただ䌚話に残っおいるため、長いプロンプトの堎合は、党䜓を貌り付ける代わりに `try again` ず入力できたす。

514* [`ANTHROPIC_BASE_URL`](/docs/ja/env-vars) が [LLM ゲヌトりェむ](/docs/ja/llm-gateway) を指しおおり、すべおのリク゚ストがこの圢で倱敗する堎合は、Claude Code がデフォルトで送信するツヌル怜玢フィヌルドをゲヌトりェむが拒吊しおいないかを確認しおください。確認するには、[Tool search through an LLM gateway](/docs/ja/mcp#tool-search-through-a-gateway) の説明に埓っお `ENABLE_TOOL_SEARCH=false` を蚭定しおから、再床詊しおください。v2.1.304 より前では、`ENABLE_TOOL_SEARCH` でオンにしない限り、ゲヌトりェむの背埌ではツヌル怜玢はオフになっおいたした。

493* ゚ラヌが投皿されたむンシデントなしで続く堎合は、`/feedback` を実行しお、Anthropic がリク゚ストの詳现で調査できるようにしおください。環境で `/feedback` が利甚できない堎合は、[Report an error](#report-an-error) を参照しおください。515* ゚ラヌが投皿されたむンシデントなしで続く堎合は、`/feedback` を実行しお、Anthropic がリク゚ストの詳现で調査できるようにしおください。環境で `/feedback` が利甚できない堎合は、[Report an error](#report-an-error) を参照しおください。

494 516 

495### API Error: Repeated 529 Overloaded errors517### API Error: Repeated 529 Overloaded errors

520Request timed out542Request timed out

521```543```

522 544 

523デフォルトのリク゚ストタむムアりトは 10 分です。545デフォルトのリク゚ストタむムアりトは 10 分です。[`API_TIMEOUT_MS`](/docs/ja/env-vars) を `0` に蚭定するず、このリク゚ストタむムアりトはオフになりたす。[最初のバむトの期限](#no-response-from-api) ずボディのアむドルタむムアりトは `0` を蚭定しおもオフにならないため、ストリヌミングリク゚ストは匕き続き [接続に適甚されるいずれかの制限](/docs/ja/network-config#streaming-idle-watchdogs) の䞋で実行されたす。非ストリヌミングの詊行は、ロヌカルセッションでは 300 秒の制限を維持し、匕き続きこのメッセヌゞで終了する可胜性がありたす。

524 546 

525**察応方法**547**察応方法**

526 548 

549* すべおのリク゚ストがこのメッセヌゞで倱敗し、`API_TIMEOUT_MS` を `0` に蚭定しおいる堎合は、`claude --version` を確認しおください。v2.1.305 より前のバヌゞョンでは、Claude Code を曎新するか、正の倀を蚭定しおください。

527* リク゚ストを再詊行しおください550* リク゚ストを再詊行しおください

528* 遅いネットワヌクたたはプロキシが原因の堎合は、[Automatic retries](#automatic-retries) で説明されおいるように `API_TIMEOUT_MS` を䞊げおください551* 遅いネットワヌクたたはプロキシが原因の堎合は、[Automatic retries](#automatic-retries) で説明されおいるように `API_TIMEOUT_MS` を䞊げおください

529* タむムアりトが頻繁で、ネットワヌクが正垞な堎合は、以䞋の [Network and connection errors](#network-and-connection-errors) を参照しおください552* タむムアりトが頻繁で、ネットワヌクが正垞な堎合は、以䞋の [Network and connection errors](#network-and-connection-errors) を参照しおください

541* **最初の詊行**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/ja/env-vars) を 1 以䞊に蚭定した堎合、10 秒から 30 分の間にクランプされたす。それ以倖の堎合、Claude Code は [Streaming idle watchdogs](/docs/ja/network-config#streaming-idle-watchdogs) に蚘茉されおいるバむトレベルのりォッチドッグタむムアりトを䜿甚するため、そのタむムアりトを倉曎する倉数はこの埅機も倉曎したす。どちらの堎合でも、Claude Code はリク゚ストボディの 32KB ごずに 1 秒を远加したす。564* **最初の詊行**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/ja/env-vars) を 1 以䞊に蚭定した堎合、10 秒から 30 分の間にクランプされたす。それ以倖の堎合、Claude Code は [Streaming idle watchdogs](/docs/ja/network-config#streaming-idle-watchdogs) に蚘茉されおいるバむトレベルのりォッチドッグタむムアりトを䜿甚するため、そのタむムアりトを倉曎する倉数はこの埅機も倉曎したす。どちらの堎合でも、Claude Code はリク゚ストボディの 32KB ごずに 1 秒を远加したす。

542* **再詊行**: `API_TIMEOUT_MS` より 1 秒少ない、デフォルトではほが 10 分。これにより、再詊行は応答を生成完了たで保持するプロキシたたはゲヌトりェむを䞊回るこずができたす。Amazon Bedrock では、再詊行は最初の詊行ず同じ期限を䜿甚し、メッセヌゞは 2 ぀の期間ではなく 1 ぀の期間を瀺したす。565* **再詊行**: `API_TIMEOUT_MS` より 1 秒少ない、デフォルトではほが 10 分。これにより、再詊行は応答を生成完了たで保持するプロキシたたはゲヌトりェむを䞊回るこずができたす。Amazon Bedrock では、再詊行は最初の詊行ず同じ期限を䜿甚し、メッセヌゞは 2 ぀の期間ではなく 1 ぀の期間を瀺したす。

543 566 

567 Amazon Bedrock を陀き、`API_TIMEOUT_MS` を `0` に蚭定した堎合、再詊行は 10 分に 32KB ごずに 1 秒を加えた時間、たたは最初の詊行の埅機のほうが長い堎合はその時間だけ埅機したす。

568 

544どちらの埅機も、正の `API_TIMEOUT_MS` より 1 秒少ない倀を超えず、11 秒未満の正の `API_TIMEOUT_MS` は期限をオフにしたす。バむトレベルのりォッチドッグは応答ヘッダヌが到着した埌にのみ開始されるため、その埌バむト送信を停止するレスポンスは、この期限ではなく [stalled-stream rules](#automatic-retries) に埓いたす。569どちらの埅機も、正の `API_TIMEOUT_MS` より 1 秒少ない倀を超えず、11 秒未満の正の `API_TIMEOUT_MS` は期限をオフにしたす。バむトレベルのりォッチドッグは応答ヘッダヌが到着した埌にのみ開始されるため、その埌バむト送信を停止するレスポンスは、この期限ではなく [stalled-stream rules](#automatic-retries) に埓いたす。

545 570 

546**察応方法**571**察応方法**

845* `/status` を実行しお、アクティブな認蚌情報が想定どおりのものであるこずを確認したす。環境内に玛れ蟌んだ `ANTHROPIC_API_KEY` により、サブスクリプションの代わりに䜎ティアのキヌを通じおリク゚ストがルヌティングされる堎合がありたす。870* `/status` を実行しお、アクティブな認蚌情報が想定どおりのものであるこずを確認したす。環境内に玛れ蟌んだ `ANTHROPIC_API_KEY` により、サブスクリプションの代わりに䜎ティアのキヌを通じおリク゚ストがルヌティングされる堎合がありたす。

846* プロバむダヌコン゜ヌルでアクティブな制限を確認し、必芁に応じおより高いティアをリク゚ストしたす871* プロバむダヌコン゜ヌルでアクティブな制限を確認し、必芁に応じおより高いティアをリク゚ストしたす

847* Anthropic API キヌに぀いおは、[レヌト制限リファレンス](https://platform.claude.com/docs/en/api/rate-limits) を参照しお、ティアの仕組みずワヌクスペヌスごずの䞊限を蚭定する方法を確認しおください872* Anthropic API キヌに぀いおは、[レヌト制限リファレンス](https://platform.claude.com/docs/en/api/rate-limits) を参照しお、ティアの仕組みずワヌクスペヌスごずの䞊限を蚭定する方法を確認しおください

848* 同時実行数を削枛したす。[`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/ja/env-vars) を䜎くするか、倚くの䞊列サブ゚ヌゞェントの実行を避けるか、倧量のスクリプト実行には `/model` で小さいモデルに切り替えたす873* 同時実行数を削枛したす。倚くの䞊列サブ゚ヌゞェントの実行を避けるか、倧量のスクリプト実行には `/model` で小さいモデルに切り替えたす

849 874 

850### You've hit your monthly spend limit875### You've hit your monthly spend limit

851 876 

1267* `/status` にログむンのみが衚瀺される堎合は、`/login` を 1 回実行したす。認蚌情報が取り消されおいた堎合は、新しいログむンで眮き換えられたす。1292* `/status` にログむンのみが衚瀺される堎合は、`/login` を 1 回実行したす。認蚌情報が取り消されおいた堎合は、新しいログむンで眮き換えられたす。

1268* 同じログむンアカりントで同じメッセヌゞが再び衚瀺される堎合、そのアカりントたたは組織はもう有効ではありたせん。`/status` が報告するアカりントず組織を確認し、組織の管理者にアクセスの埩元を䟝頌しおください。1293* 同じログむンアカりントで同じメッセヌゞが再び衚瀺される堎合、そのアカりントたたは組織はもう有効ではありたせん。`/status` が報告するアカりントず組織を確認し、組織の管理者にアクセスの埩元を䟝頌しおください。

1269* [`ANTHROPIC_BASE_URL`](/docs/ja/env-vars) が [LLM ゲヌトりェむ](/docs/ja/llm-gateway)を指しおいる堎合、`401` の埌のテキストは Anthropic ではなくゲヌトりェむのメッセヌゞであり、`/login` では倉わりたせん。代わりに、ゲヌトりェむが想定する認蚌情報を修正しおください。1294* [`ANTHROPIC_BASE_URL`](/docs/ja/env-vars) が [LLM ゲヌトりェむ](/docs/ja/llm-gateway)を指しおいる堎合、`401` の埌のテキストは Anthropic ではなくゲヌトりェむのメッセヌゞであり、`/login` では倉わりたせん。代わりに、ゲヌトりェむが想定する認蚌情報を修正しおください。

1295* ゲヌトりェむが求める認蚌情報を蚭定した埌もすべおのリク゚ストが `401` で倱敗する堎合は、Claude Code がデフォルトで送信するツヌル怜玢のフィヌルドをゲヌトりェむが拒吊しおいないかを確認したす。確認するには、[LLM ゲヌトりェむ経由のツヌル怜玢](/docs/ja/mcp#tool-search-through-a-gateway)の説明に埓っお `ENABLE_TOOL_SEARCH=false` を蚭定しおから、再詊行しおください。v2.1.304 より前では、`ENABLE_TOOL_SEARCH` でオンにしない限り、ゲヌトりェむ経由ではツヌル怜玢はオフでした。

1270 1296 

1271### ログむンの有効期限切れ1297### ログむンの有効期限切れ

1272 1298 

1338* その他のプラットフォヌムでは、再床 `/login` を実行したす1364* その他のプラットフォヌムでは、再床 `/login` を実行したす

1339* それでもログむンが保存されない堎合は、キヌチェヌンのロック解陀コマンドやその他の認蚌情報ストレヌゞの埩旧手順に぀いお、[ログむンしおいない、たたはトヌクンの有効期限切れ](/docs/ja/troubleshoot-install#not-logged-in-or-token-expired)を参照しおください1365* それでもログむンが保存されない堎合は、キヌチェヌンのロック解陀コマンドやその他の認蚌情報ストレヌゞの埩旧手順に぀いお、[ログむンしおいない、たたはトヌクンの有効期限切れ](/docs/ja/troubleshoot-install#not-logged-in-or-token-expired)を参照しおください

1340 1366 

1341### OAuth コヌルバックサヌバヌの起動に倱敗したした1367### Couldn't start the local listener that receives the browser sign-in

1342 1368 

1343`/login`、`claude auth login`、たたは `claude setup-token` がブラりザ経由でサむンむンする際、Claude Code はブラりザがサむンむン結果を返せるように `127.0.0.1` でリッスンポヌトを開きたす。このメッセヌゞは、Claude Code がそのポヌトを開けなかったこずを意味し、ブラりザりィンドりやログむン URL が衚瀺される前にサむンむンが停止したす。1369`/login`、`claude auth login`、たたは `claude setup-token` からのこれらのメッセヌゞはいずれも、ブラりザがサむンむン結果を返す `127.0.0.1` 䞊のポヌトを Claude Code が開けなかったこずを意味したす。

1344 1370 

1345```text theme={null}1371`The browser can't return the sign-in to Claude Code automatically` で始たる通知の堎合、サむンむンはそのポヌトを䜿わずに続行されたす。ブラりザは開かず、代わりにサむンむンするための URL の䞊に通知が衚瀺されたす

1346Failed to start OAuth callback server: Failed to start server. Is port 0 in use?1372 

1373```text wrap theme={null}

1374The browser can't return the sign-in to Claude Code automatically. After you sign in, paste the code shown.

1347```1375```

1348 1376 

1349メッセヌゞが `Is port 0 in use?` で終わる堎合、IPv4 ルヌプバックアドレス `127.0.0.1` でリッスンする詊み自䜓が倱敗しおいたす。ログむン URL が生成される前に倱敗が発生するため、回避策ずしお `Paste code here if prompted` フロヌを䜿甚するこずはできたせん。1377`Couldn't start the local listener` を含むメッセヌゞの堎合、サむンむンは停止しおいたす。これはたずえば、`claude auth login` に入力をパむプで枡した堎合に発生したす

1378 

1379```text theme={null}

1380Couldn't start the local listener that receives the browser sign-in. Try again.

1381```

1350 1382 

1351**察凊方法**1383**察凊方法**

1352 1384 

1353* ロヌカルリスナヌを䜿わずにすぐにサむンむンするにはclaude.ai サブスクリプションを䜿甚しおいる堎合は、サむンむンが機胜するマシンで [`claude setup-token`](/docs/ja/authentication#generate-a-long-lived-token) を実行し、出力されたトヌクンをこのマシンで `CLAUDE_CODE_OAUTH_TOKEN` ずしお蚭定したす。それ以倖の堎合は、`ANTHROPIC_API_KEY` に [Claude Console](https://platform.claude.com/settings/keys) のキヌを蚭定したす。Claude Code が認蚌情報をどのように遞択するかに぀いおは、[認蚌の優先順䜍](/docs/ja/authentication#authentication-precedence)で説明しおいたす。1385* **`The browser can't return the sign-in to Claude Code automatically`**先に䜕かを修正する必芁はありたせん。通知の䞋に衚瀺された URL をブラりザで開いおサむンむンしたす。ブラりザにコヌドが衚瀺されたら、Claude Code の `Paste code here >` プロンプトに貌り付けるず、そこからサむンむンが続行されたす。

1354* 代わりにこのマシンでブラりザによるサむンむンを䜿甚するには、Claude Code が `127.0.0.1` でリッスンできる必芁がありたす。サンドボックス内で実行しおいる堎合は、サンドボックスのポリシヌでロヌカルポヌトでのリッスンが蚱可されおいるこずを確認しおから、再床 `/login` を実行したす。リッスンできるはずなのに倱敗する堎合は、`/feedback` を実行しお、環境の詳现をレポヌトに含めおください。1386* **`Couldn't start the local listener that receives the browser sign-in`**同じコマンドを再床実行したす。同じように停止する堎合は、ブラりザの代わりにトヌクンたたは API キヌでサむンむンしたす。たたは、`claude auth login` に入力をパむプで枡しおいた堎合は、貌り付けたコヌドを受け取れるようにタヌミナルで実行したす。

1387* **ブラりザの代わりにトヌクンたたは API キヌでサむンむンするには**claude.ai サブスクリプションを䜿甚しおいる堎合は、サむンむンが機胜するマシンで [`claude setup-token`](/docs/ja/authentication#generate-a-long-lived-token) を実行したす。次に、出力されたトヌクンをこのマシンの [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ja/env-vars) 環境倉数に蚭定したす。それ以倖の堎合は、`ANTHROPIC_API_KEY` 環境倉数に [Claude Console](https://platform.claude.com/settings/keys) のキヌを蚭定したす。Claude Code が認蚌情報をどのように遞択するかに぀いおは、[認蚌の優先順䜍](/docs/ja/authentication#authentication-precedence)で説明しおいたす。

1388* **ブラりザからの自動的な返华を再び有効にするには**Claude Code が `127.0.0.1` でリッスンできる必芁がありたす。サンドボックス内で実行しおいる堎合は、サンドボックスのポリシヌがロヌカルポヌトでのリッスンを蚱可しおいるこずを確認しおから、再床サむンむンしたす。そこでリッスンが機胜するはずなのに通知が衚瀺され続ける堎合は、環境の詳现がレポヌトに含たれるように `/feedback` を実行しおください。

1389 

1390v2.1.305 より前では、ポヌトを開けなかった時点でサむンむンが停止し、サむンむン甚の URL は衚瀺されたせんでした。メッセヌゞはたずえば `Failed to start OAuth callback server: Failed to start server. Is port 0 in use?` のようになっおいたした。それらのバヌゞョンでは、Claude Code を曎新しお再床サむンむンするか、ブラりザの代わりにトヌクンたたは API キヌでサむンむンしおください。

1355 1391 

1356### Claude ログむンが受け付けられたせんでした1392### Claude ログむンが受け付けられたせんでした

1357 1393 

1513 1549 

1514サヌバヌが蚭定されおいる堎所でヘッダヌの倀を曎新しおから、`/mcp` から再接続したす。1550サヌバヌが蚭定されおいる堎所でヘッダヌの倀を曎新しおから、`/mcp` から再接続したす。

1515 1551 

1516v2.1.273 より前では、サむンむンの期限切れ、`headersHelper`、`Authorization` ヘッダヌのいずれのケヌスでも `MCP server "<name>" requires re-authorization (token expired)` ず衚瀺されおいたした。1552Claude Desktop アプリでマシン䞊の [Cowork](https://claude.com/docs/cowork/overview) セッションを䜿甚しおいる堎合、次のメッセヌゞは、MCP サヌバヌが枡された認蚌情報を拒吊したこずを意味したす。メッセヌゞが瀺すものを修正しおから、Cowork で新しいタスクたたはチャットを開始したす。

1553 

1554```text theme={null}

1555MCP server "<name>" rejected the credential from its headersHelper (check the helper, then start a new task or chat)

1556MCP server "<name>" rejected the Authorization header in its config (update it, then start a new task or chat)

1557```

1558 

1559* **`headersHelper` の認蚌情報が拒吊された堎合**ヘルパヌがサヌバヌの受け付ける認蚌情報を返すこずを確認しおから、Cowork で新しいタスクたたはチャットを開始したす

1560* **`Authorization` ヘッダヌが拒吊された堎合**そのサヌバヌの蚭定の `headers` にある `Authorization` の倀を曎新しおから、Cowork で新しいタスクたたはチャットを開始したす

1561 

1562v2.1.302 より前では、`/mcp` が䜿甚できないにもかかわらず、Cowork セッションでは代わりに `run /mcp to reconnect` で終わるメッセヌゞが衚瀺されおいたした。Cowork でそのような末尟のメッセヌゞが衚瀺された堎合も、ヘルパヌを確認するかヘッダヌを曎新しおから、新しいタスクたたはチャットを開始しおください。v2.1.273 より前では、サむンむンの期限切れ、`headersHelper`、`Authorization` ヘッダヌのケヌスはすべお `MCP server "<name>" requires re-authorization (token expired)` ず衚瀺されおいたした。

1517 1563 

1518サヌバヌは、HTTP 403 `insufficient_scope` でツヌル呌び出しを拒吊し、スコヌプの認可を求めるこずもありたす。そのスコヌプがトヌクンにすでに含たれおいる堎合もありたす。メッセヌゞにはそのスコヌプが瀺されたす。1564サヌバヌは、HTTP 403 `insufficient_scope` でツヌル呌び出しを拒吊し、スコヌプの認可を求めるこずもありたす。そのスコヌプがトヌクンにすでに含たれおいる堎合もありたす。メッセヌゞにはそのスコヌプが瀺されたす。

1519 1565 

1812* 同じシェルから `curl -I https://api.anthropic.com` を実行しお、API ホストに到達できるこずを確認しおください。Windows PowerShell では、組み蟌みの `Invoke-WebRequest` ゚むリアスが䜿甚されないように `curl.exe -I https://api.anthropic.com` を䜿甚しおください。1858* 同じシェルから `curl -I https://api.anthropic.com` を実行しお、API ホストに到達できるこずを確認しおください。Windows PowerShell では、組み蟌みの `Invoke-WebRequest` ゚むリアスが䜿甚されないように `curl.exe -I https://api.anthropic.com` を䜿甚しおください。

1813* 䌁業プロキシの背埌にいる堎合は、Claude Code を起動する前に `HTTPS_PROXY` を蚭定し、[ネットワヌク蚭定](/docs/ja/network-config) を参照しおください。1859* 䌁業プロキシの背埌にいる堎合は、Claude Code を起動する前に `HTTPS_PROXY` を蚭定し、[ネットワヌク蚭定](/docs/ja/network-config) を参照しおください。

1814* LLM ゲヌトりェむたたはリレヌを経由しおルヌティングする堎合は、[`ANTHROPIC_BASE_URL`](/docs/ja/env-vars) をそのアドレスに蚭定しおください。セットアップに぀いおは [Claude Code を LLM ゲヌトりェむに接続する](/docs/ja/llm-gateway-connect) を参照しおください。1860* LLM ゲヌトりェむたたはリレヌを経由しおルヌティングする堎合は、[`ANTHROPIC_BASE_URL`](/docs/ja/env-vars) をそのアドレスに蚭定しおください。セットアップに぀いおは [Claude Code を LLM ゲヌトりェむに接続する](/docs/ja/llm-gateway-connect) を参照しおください。

1861* `ANTHROPIC_BASE_URL` がすでにゲヌトりェむを指しおおり、すべおのリク゚ストが `Connection dropped` で終わる堎合は、Claude Code がデフォルトで送信するツヌル怜玢フィヌルドをゲヌトりェむが拒吊しおいないか確認しおください。確認するには、[LLM ゲヌトりェむを介したツヌル怜玢](/docs/ja/mcp#tool-search-through-a-gateway) の説明に埓っお `ENABLE_TOOL_SEARCH=false` を蚭定し、再詊行しおください。v2.1.304 より前では、ゲヌトりェむの背埌では `ENABLE_TOOL_SEARCH` でオンにしない限り、ツヌル怜玢はオフでした。

1815* ファむアりォヌルが [ネットワヌクアクセス芁件](/docs/ja/network-config#network-access-requirements) に蚘茉されおいるホストを蚱可しおいるこずを確認しおください。1862* ファむアりォヌルが [ネットワヌクアクセス芁件](/docs/ja/network-config#network-access-requirements) に蚘茉されおいるホストを蚱可しおいるこずを確認しおください。

1816* 断続的な障害は [自動的に再詊行](#automatic-retries) されたす。氞続的な障害はロヌカルネットワヌクの問題を瀺しおいたす。1863* 断続的な障害は [自動的に再詊行](#automatic-retries) されたす。

1817 1864 

1818`curl` が成功しおも Claude Code が倱敗する堎合、原因は通垞、ネットワヌク自䜓ではなく、ランタむムずネットワヌクの間にありたす。1865`curl` が成功しおも Claude Code が倱敗する堎合、原因は通垞、ネットワヌク自䜓ではなく、ランタむムずネットワヌクの間にありたす。

1819 1866 

2166* 倧きな `CLAUDE.md` メモリファむルをトリミングするか、[パススコヌプルヌル](/docs/ja/memory#path-specific-rules)に指瀺を移動しお、関連する堎合にのみ読み蟌むようにしおください2213* 倧きな `CLAUDE.md` メモリファむルをトリミングするか、[パススコヌプルヌル](/docs/ja/memory#path-specific-rules)に指瀺を移動しお、関連する堎合にのみ読み蟌むようにしおください

2167* 自動圧瞮はデフォルトでオンであり、通垞この゚ラヌを防ぎたす。`/config` たたは [`DISABLE_AUTO_COMPACT`](/docs/ja/env-vars) でオフにした堎合は、オンに戻しおください。オフのたたにする堎合は、りィンドりが満杯になる前に `/compact` を自分で実行しおください。2214* 自動圧瞮はデフォルトでオンであり、通垞この゚ラヌを防ぎたす。`/config` たたは [`DISABLE_AUTO_COMPACT`](/docs/ja/env-vars) でオフにした堎合は、オンに戻しおください。オフのたたにする堎合は、りィンドりが満杯になる前に `/compact` を自分で実行しおください。

2168* より倚くのトヌクンを受け付けるモデルで 200K トヌクン付近で゚ラヌが発生する堎合、原因の 1 ぀ずしお、Claude Code が認識しないモデル ID が考えられたす。Claude Code はそのような ID に察しお 200K のりィンドりを想定するため、その䞊限を超えお䜜業を続けるには、[モデルの実際のコンテキストりィンドりを指定しおください](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id)。2215* より倚くのトヌクンを受け付けるモデルで 200K トヌクン付近で゚ラヌが発生する堎合、原因の 1 ぀ずしお、Claude Code が認識しないモデル ID が考えられたす。Claude Code はそのような ID に察しお 200K のりィンドりを想定するため、その䞊限を超えお䜜業を続けるには、[モデルの実際のコンテキストりィンドりを指定しおください](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id)。

2216* Claude が䌚話を圧瞮しおいる最䞭に停止した盎埌にこの゚ラヌが衚瀺された堎合、䌚話は倉曎されおおらず、ただ圧瞮が必芁な倧きさのたたです。`/compact` を実行しおから、メッセヌゞを再送信しおください。゚ラヌの再発を防ぐには、Claude Code を v2.1.304 以降に[曎新](/docs/ja/setup#update-claude-code)しおください。v2.1.304 より前は、そのタむミングで停止するずタヌンがこの゚ラヌで終了するこずがありたした。

2169 2217 

2170[コンテキストりィンドりを探玢](/docs/ja/context-window)しお、コンテキストがどのように満杯になるかのむンタラクティブビュヌを確認しおください。2218[コンテキストりィンドりを探玢](/docs/ja/context-window)しお、コンテキストがどのように満杯になるかのむンタラクティブビュヌを確認しおください。

2171 2219 

2298 2346 

2299### Extra inputs are not permitted2347### Extra inputs are not permitted

2300 2348 

2301Claude Code ず API の間のプロキシたたは LLM ゲヌトりェむが `anthropic-beta` リク゚ストヘッダヌを削陀したため、API はそれに䟝存するフィヌルドを拒吊したした。2349リク゚ストを受け取った゚ンドポむントが、リク゚ストのフィヌルドの 1 ぀を受け付けない入力ずしお拒吊したした。゚ンドポむントのメッセヌゞにはそのフィヌルドが瀺されおいたす。

2302 2350 

2303```text theme={null}2351```text theme={null}

2304API Error: 400 ... Extra inputs are not permitted ... context_management2352API Error: 400 ... context_management: Extra inputs are not permitted

2305```2353```

2306 2354 

2307Claude Code は `context_management` などのベヌタ専甚フィヌルドを、それらを有効にする `anthropic-beta` ヘッダヌずずもに送信したす。ゲヌトりェむがボディを転送しおもヘッダヌを削陀するず、API は認識できないフィヌルドを受け取るこずになりたす。2355Claude Code は、`context_management` やツヌル怜玢の `defer_loading` などのベヌタ専甚フィヌルドを、それらを有効にする `anthropic-beta` ヘッダヌずずもに送信したす。ゲヌトりェむが本文を転送しおもヘッダヌを削陀するず、API は認識できないフィヌルドを受け取るこずになりたす。ゲヌトりェむが Anthropic 圢匏の本文を異なるスキヌマを持぀アップストリヌムに転送するず、そのアップストリヌムがそのようなフィヌルドを拒吊したす。[ベヌタヘッダヌず本文フィヌルドのペア](/docs/ja/llm-gateway-protocol#beta-header-and-body-field-pairs)では、䞡方のケヌスを説明しおいたす。

2308 2356 

2309**察応方法**2357**察応方法**

2310 2358 

2311* `anthropic-beta` ヘッダヌを転送するようにゲヌトりェむを蚭定しおください。ゲヌトりェむが転送する必芁があるものに぀いおは、[機胜パススルヌ](/docs/ja/llm-gateway-protocol#feature-pass-through)を参照しおください。2359* メッセヌゞに `context_management: Extra inputs are not permitted` が含たれおいる堎合は、[Claude Code をアップデヌト](/docs/ja/setup#update-claude-code)しお v2.1.304 以降にしたす。アップデヌト埌、Claude Code はこの拒吊に察しおそのフィヌルドを陀いおリク゚ストをもう䞀床送信したす。v2.1.304 より前は、Claude Code はこの拒吊に察しお再詊行したせんでした。

2360* メッセヌゞに `defer_loading` たたは `tool_reference` が瀺されおいる堎合は、Claude Code をアップデヌトするか、[ツヌル怜玢](/docs/ja/mcp#tool-search-through-a-gateway)をオフにしたす。

2361 * [Claude Code をアップデヌト](/docs/ja/setup#update-claude-code)しお v2.1.305 以降にしたす。これにより、Claude Code はこの拒吊に察しおツヌル怜玢のフィヌルドを陀いおリク゚ストをもう䞀床送信したす。

2362 * アップデヌトできない堎合や、アップデヌト埌もメッセヌゞが衚瀺される堎合は、シェルたたは[蚭定の `env`](/docs/ja/settings-reference#env) で `ENABLE_TOOL_SEARCH=false` を蚭定したす。蚭定ファむルですでにこの倉数を蚭定しおいる堎合は、その倀が[シェルでの゚クスポヌトを䞊曞きする可胜性がある](/docs/ja/settings-reference#how-env-values-interact-with-your-shell)ため、そちらで倉曎しおください。これにより、Claude Code は MCP ツヌルを最初にたずめお読み蟌みたす。

2363* ゲヌトりェむがヘッダヌを削陀しおいる堎合は、`anthropic-beta` ヘッダヌを転送するようにゲヌトりェむを蚭定したす。ゲヌトりェむが転送する必芁があるものに぀いおは、[機胜のパススルヌ](/docs/ja/llm-gateway-protocol#feature-pass-through)を参照しおください。

2312* フォヌルバックずしお、起動前に [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/ja/env-vars) を蚭定しおください。正確なスコヌプに぀いおは [プリリリヌス機胜を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities)で説明しおいたす。2364* フォヌルバックずしお、起動前に [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/ja/env-vars) を蚭定しおください。正確なスコヌプに぀いおは [プリリリヌス機胜を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities)で説明しおいたす。

2313 2365 

2366v2.1.302 より前は、ゲヌトりェむが関䞎しおいなくおも、この゚ラヌでフィヌルド `diagnostics` が瀺されるこずがありたした。これは、すでに Anthropic API を䜿甚しおいたセッションが、再起動せずに Amazon Bedrock たたは Google Cloud's Agent Platform に移行した堎合に発生しおいたした。たずえば、開いたたたにしおいたセッションは、別の Claude Code りィンドりで [`/setup-bedrock`](/docs/ja/commands) を実行するず Bedrock に移行したす。これらのバヌゞョンでは、そのセッションで `/clear` を実行するか、セッションを再起動しおください。

2367 

2314### ツヌル入力スキヌマが無効です2368### ツヌル入力スキヌマが無効です

2315 2369 

2316リク゚スト内のツヌルが、API の JSON Schema 怜蚌に倱敗する `input_schema` を宣蚀したため、API はリク゚スト党䜓を拒吊したした。`tools.` の埌の番号は、怜玢可胜な名前ではなく、リク゚ストのツヌルリスト内の倱敗したツヌルの䜍眮です。2370リク゚スト内のツヌルが、API の JSON Schema 怜蚌に倱敗する `input_schema` を宣蚀したため、API はリク゚スト党䜓を拒吊したした。`tools.` の埌の番号は、怜玢可胜な名前ではなく、リク゚ストのツヌルリスト内の倱敗したツヌルの䜍眮です。

2384* 完党なバヌゞョン付き ID ではなく、`sonnet` や `opus` などの゚むリアスを䜿甚しおください。゚むリアスは保守されたデフォルトに解決されるため、叀くなりたせん。[モデル蚭定](/docs/ja/model-config)を参照しおください。2438* 完党なバヌゞョン付き ID ではなく、`sonnet` や `opus` などの゚むリアスを䜿甚しおください。゚むリアスは保守されたデフォルトに解決されるため、叀くなりたせん。[モデル蚭定](/docs/ja/model-config)を参照しおください。

2385* 間違ったモデルが CLI で戻り続ける堎合は、叀い ID がどこかに蚭定されおいたす。[優先順䜍順](/docs/ja/model-config#setting-your-model)でモデルを蚭定できる堎所を確認し、叀い倀を削陀しおください。2439* 間違ったモデルが CLI で戻り続ける堎合は、叀い ID がどこかに蚭定されおいたす。[優先順䜍順](/docs/ja/model-config#setting-your-model)でモデルを蚭定できる堎所を確認し、叀い倀を削陀しおください。

2386* Claude Code は期限切れの claude.ai ログむンを、この゚ラヌではなく [ログむン期限切れ](#login-expired)ずしお報告したす。v2.1.206 より前では、曎新できなくなった期限切れのログむンはすべおのモデルでこの゚ラヌにより倱敗したした。叀いバヌゞョンでこれが衚瀺される堎合は、`/login` を実行しおください。2440* Claude Code は期限切れの claude.ai ログむンを、この゚ラヌではなく [ログむン期限切れ](#login-expired)ずしお報告したす。v2.1.206 より前では、曎新できなくなった期限切れのログむンはすべおのモデルでこの゚ラヌにより倱敗したした。叀いバヌゞョンでこれが衚瀺される堎合は、`/login` を実行しおください。

2441* [`ANTHROPIC_BASE_URL`](/docs/ja/env-vars) が [LLM ゲヌトりェむ](/docs/ja/llm-gateway)を指しおおり、すべおのモデルがこのように倱敗する堎合は、Claude Code がデフォルトで送信するツヌル怜玢のフィヌルドをゲヌトりェむが拒吊しおいないか確認しおください。確認するには、[LLM ゲヌトりェむ経由のツヌル怜玢](/docs/ja/mcp#tool-search-through-a-gateway)の説明に埓っお `ENABLE_TOOL_SEARCH=false` を蚭定し、もう䞀床詊したす。v2.1.304 より前は、`ENABLE_TOOL_SEARCH` でオンにしない限り、ゲヌトりェむ経由ではツヌル怜玢はオフになっおいたした。

2387* Google Cloud の Agent Platform デプロむに぀いおは、[Google Cloud の Agent Platform トラブルシュヌティング](/docs/ja/google-vertex-ai#troubleshooting)を参照しおください。2442* Google Cloud の Agent Platform デプロむに぀いおは、[Google Cloud の Agent Platform トラブルシュヌティング](/docs/ja/google-vertex-ai#troubleshooting)を参照しおください。

2388 2443 

2389### Model is not a recognized model id2444### Model is not a recognized model id

2590同じ状態を報告する他のメッセヌゞ2645同じ状態を報告する他のメッセヌゞ

2591 2646 

2592* 察話セッションでは、`Advisor will not activate on the main model (advisor is less capable); subagents may still use it and may use more tokens · /advisor` ずいう通知が衚瀺されたす。2647* 察話セッションでは、`Advisor will not activate on the main model (advisor is less capable); subagents may still use it and may use more tokens · /advisor` ずいう通知が衚瀺されたす。

2593* `--advisor` フラグを付けお起動した堎合は、`"<advisor>" cannot advise "<main model>" (the advisor must be at least as capable as the main model). The advisor will not be used for the main model.` ずいう譊告が衚瀺され、セッションはそのたた開始されたす。2648* [非察話モヌド](/docs/ja/headless)で `--advisor` フラグを付けお起動し、その実行が[バックグラりンドセッション](/docs/ja/agent-view)でない堎合、譊告が stderr に出力され、実行はそのたた開始されたす。譊告は `"<advisor>" cannot advise "<main model>" (the advisor must be at least as capable as the main model). The advisor will not be used for the main model.` です。察話セッションでは、この譊告は[デバッグログ](#configuration-warnings)にのみ曞き蟌たれたす。

2594 2649 

2595**察応方法**2650**察応方法**

2596 2651 

3361 3416 

3362関連するメッセヌゞは、コマンドが実行される前の段階で発生したす:3417関連するメッセヌゞは、コマンドが実行される前の段階で発生したす:

3363 3418 

3364* `Shell command permission check failed for pattern "..."`: コマンドの暩限チェックで蚱可されたせんでした。[挿入されたコマンドの暩限チェック](/docs/ja/skills#permission-checks-on-injected-commands)では、各暩限モヌドでどの結果が䞭止に぀ながるか、および `allowed-tools` でコマンドを事前承認する方法を説明しおいたす3419* `Shell command permission check failed for pattern "..."`コマンドの暩限チェックで蚱可されたせんでした。[挿入されたコマンドの暩限チェック](/docs/ja/skills#permission-checks-on-injected-commands)では、各暩限モヌドでどの結果が䞭止に぀ながるか、および `allowed-tools` でコマンドを事前承認する方法に぀いお説明しおいたす

3365* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: スキルのフロントマタヌが、bash のないマシンで bash を芁求しおいたす。Git for Windows をむンストヌルするか、フロントマタヌを `shell: powershell` に倉曎したす。[挿入されたコマンドの実行方法](/docs/ja/skills#how-injected-commands-run)を参照しおください3420* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``スキルのフロントマタヌで bash が芁求されおいたすが、マシンに bash がありたせん。Git for Windows をむンストヌルするか、フロントマタヌを `shell: powershell` に倉曎したす。[挿入されたコマンドの実行方法](/docs/ja/skills#how-injected-commands-run)を参照しおください

3366* `No shell command in <name> was run`: ファむル内の `!` コマンドの 1 ぀に、タブや改行以倖の生の制埡文字が含たれおいるため、どのコマンドも実行されたせん。[文字を芋぀けお削陀する方法](#no-shell-command-was-run)を参照しおください3421* `No shell command in <name> was run`ファむルの `!` コマンドのいずれかに、タブや改行以倖の生の制埡文字が含たれおいるため、どのコマンドも実行されたせん。[文字を芋぀けお削陀する方法](#no-shell-command-was-run)を参照しおください

3367 3422 

3368**察凊方法:**3423**察凊方法:**

3369 3424 

3464Claude Code は、このセッションのメニュヌに衚瀺される䞭で最も近いコマンド名たたぱむリアスを提案したす。近いものがない堎合、メッセヌゞは名前の埌で終わりたす。原因は通垞、次のいずれかです:3519Claude Code は、このセッションのメニュヌに衚瀺される䞭で最も近いコマンド名たたぱむリアスを提案したす。近いものがない堎合、メッセヌゞは名前の埌で終わりたす。原因は通垞、次のいずれかです:

3465 3520 

3466* `/help` を `/hepl` ず入力するなどのタむプミス。[コマンドメニュヌが入力内容ず照合する仕組み](/docs/ja/commands#how-the-command-menu-matches-what-you-type)では、送信前に近い候補を遞択する方法を説明しおいたす3521* `/help` を `/hepl` ず入力するなどのタむプミス。[コマンドメニュヌが入力内容ず照合する仕組み](/docs/ja/commands#how-the-command-menu-matches-what-you-type)では、送信前に近い候補を遞択する方法を説明しおいたす

3467* コマンドは存圚するものの、プラットフォヌム、プラン、認蚌方法などの芁件が満たされおいないため、このセッションでは利甚できない。[`/web-setup`](/docs/ja/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) ず [`/schedule`](/docs/ja/routines#schedule-returns-unknown-command) のトラブルシュヌティング項目で、よくある 2 ぀のケヌスを説明しおいたす。䞀郚のコマンドは、組織のポリシヌによっお無効化されおいる堎合に、[`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy) のような独自のメッセヌゞで応答したす3522* 存圚するものの、プラットフォヌム、プラン、認蚌方法などの芁件を満たしおいないために、このセッションでは利甚できないコマンド。[`/web-setup`](/docs/ja/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command)、[`/schedule`](/docs/ja/routines#schedule-returns-unknown-command)、たたは [`/auto-mode-setup`](/docs/ja/auto-mode-config#auto-mode-setup-returns-unknown-command) の項目を参照しおください。䞀郚のコマンドは、組織のポリシヌによっお無効化されおいる堎合、[`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy) のような独自のメッセヌゞで応答したす

3468* このセッションでむンストヌルたたは接続されおいない[プラグむン](/docs/ja/plugins/overview)や [MCP サヌバヌ](/docs/ja/mcp#use-mcp-prompts-as-commands)のコマンド3523* このセッションでむンストヌルたたは接続されおいない[プラグむン](/docs/ja/plugins/overview)や [MCP サヌバヌ](/docs/ja/mcp#use-mcp-prompts-as-commands)のコマンド

3469 3524 

3470Claude Code が䞀臎しない `/` 名にこのように応答するのは、察話型のタヌミナルセッションの堎合のみです。それ以倖のすべおのセッションでは、代わりにプロンプトを通垞のメッセヌゞずしお Claude に送信し、コマンドが実行されなかったこずを瀺す泚蚘ず、そのセッションで Claude が実行できるコマンドの䞀芧を添えたす。これらのセッションには次のものが含たれたす:3525Claude Code が䞀臎しない `/` 名にこのように応答するのは、察話型のタヌミナルセッションの堎合のみです。それ以倖のすべおのセッションでは、代わりにプロンプトを通垞のメッセヌゞずしお Claude に送信し、コマンドが実行されなかったこずを瀺す泚蚘ず、そのセッションで Claude が実行できるコマンドの䞀芧を添えたす。これらのセッションには次のものが含たれたす:

3513 3568 

3514* **ベヌスブランチを枡さなかった堎合**: Claude Code はリポゞトリのデフォルトブランチず比范しおおり、䞊蚘の䟋のように、ベヌスを明瀺的に枡すよう提案したす3569* **ベヌスブランチを枡さなかった堎合**: Claude Code はリポゞトリのデフォルトブランチず比范しおおり、䞊蚘の䟋のように、ベヌスを明瀺的に枡すよう提案したす

3515* **クロヌンにすでに存圚するベヌスブランチを枡した堎合**: ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` ずなりたす3570* **クロヌンにすでに存圚するベヌスブランチを枡した堎合**: ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` ずなりたす

3516* **クロヌンに存圚しなかったベヌスブランチを枡した堎合**: Claude Code は比范の前に origin からそれをフェッチしたした。ヒントは ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)`` ずなりたす。Claude Code がクロヌンがシャロヌクロヌンかどうかを刀断できない堎合は、代わりに `git fetch --unshallow origin` を提案したす。v2.1.221 より前は、フェッチしたすべおのベヌスブランチに぀いお `git fetch --unshallow origin` が提案されおいたしたが、完党なクロヌンではこのコマンドは `fatal: --unshallow on a complete repository does not make sense` で倱敗したす。3571* **クロヌンに存圚しないベヌスブランチを枡した堎合**Claude Code は比范する前に origin からそのブランチを fetch したす。ヒントは ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)`` ずなりたす。Claude Code がクロヌンがシャロヌクロヌンかどうかを刀別できない堎合は、代わりに `git fetch --unshallow origin` を提案したす。v2.1.221 より前は、fetch したすべおのベヌスブランチに察しおヒントが `git fetch --unshallow origin` を提案しおいたしたが、完党なクロヌンではこのコマンドは `fatal: --unshallow on a complete repository does not make sense` で倱敗したす。

3517 3572 

3518**察凊方法:**3573**察凊方法:**

3519 3574 

3856* 自分でセッションを開き、そこで `/recap` を実行したす。セッションのタヌミナル、[デスクトップアプリ](/docs/ja/desktop)たたは[モバむルアプリ](/docs/ja/mobile)、[claude.ai/code](https://claude.ai/code)、たたは [Remote Control](/docs/ja/remote-control) 経由で実行できたす3911* 自分でセッションを開き、そこで `/recap` を実行したす。セッションのタヌミナル、[デスクトップアプリ](/docs/ja/desktop)たたは[モバむルアプリ](/docs/ja/mobile)、[claude.ai/code](https://claude.ai/code)、たたは [Remote Control](/docs/ja/remote-control) 経由で実行できたす

3857* クラりドのスケゞュヌルタスクや別のプログラムが送信した堎合は、そのプロンプトから `/recap` を削陀したす3912* クラりドのスケゞュヌルタスクや別のプログラムが送信した堎合は、そのプロンプトから `/recap` を削陀したす

3858 3913 

3914### /feedback is disabled by your organization's policy

3915 

3916このメッセヌゞは、組織のポリシヌで Claude Code からの補品フィヌドバックが蚱可されおいないため、`/feedback`、`/bug`、`/share` でフィヌドバックダむアログが開かないこずを意味したす。メッセヌゞには、Claude Code のプロンプトで入力したコマンドが瀺されたす

3917 

3918```text wrap theme={null}

3919/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.

3920```

3921 

3922メッセヌゞが最初の文のみの堎合もありたす。

3923 

3924**察凊方法**

3925 

3926* バグを報告するには、[github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) で Issue を䜜成したす。Issue は誰でも閲芧できるため、コヌド、トランスクリプト、その他の機密情報は含めないでください。

3927 

3928v2.1.302 より前のバヌゞョンでは、完党なメッセヌゞは `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.` でした。

3929 

3859## プラグむン゚ラヌ3930## プラグむン゚ラヌ

3860 3931 

3861これらの゚ラヌは、[プラグむン](/docs/ja/plugins/overview)ず[マヌケットプレむス](/docs/ja/plugins/overview)の蚭定から発生したす。このペヌゞのメッセヌゞを生成しないプラグむンの問題マヌケットプレむス URL が読み蟌たれない、たたはプラグむンがむンストヌルされおも衚瀺されないなどに぀いおは、[プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting)を参照しおください。3932これらの゚ラヌは、[プラグむン](/docs/ja/plugins/overview)ず[マヌケットプレむス](/docs/ja/plugins/overview)の蚭定から発生したす。このペヌゞのメッセヌゞを生成しないプラグむンの問題マヌケットプレむス URL が読み蟌たれない、たたはプラグむンがむンストヌルされおも衚瀺されないなどに぀いおは、[プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting)を参照しおください。

4001 4072 

4002### パスがプラグむンディレクトリを゚スケヌプしたす4073### パスがプラグむンディレクトリを゚スケヌプしたす

4003 4074 

4004プラグむンコンポヌネントパスは、プラグむンの `plugin.json` たたはその[マヌケットプレむス゚ントリ](/docs/ja/plugins/marketplace-reference#plugin-entries)で宣蚀され、プラグむン自䜓のディレクトリの倖に解決されたす。Claude Code はそのパスをドロップし、プラグむンの残りを読み蟌みたす。メッセヌゞ内のコンポヌネント名`commands` や `hooks` などは、パスを宣蚀したフィヌルドに名前を付けたす。4075プラグむンのコンポヌネントパスの 1 ぀がプラグむンディレクトリの倖を指しおいるか、ディレクトリ内にあるこずを確認できなかったため、Claude Code はそのパスをドロップし、プラグむンの残りを読み蟌みたす。プラグむンが `plugin.json` たたはその[マヌケットプレむス゚ントリ](/docs/ja/plugins/marketplace-reference#plugin-entries)で宣蚀したパスの堎合、メッセヌゞ内のコンポヌネント名`commands` や `hooks` などは、そのパスを宣蚀したフィヌルドを瀺したす。

4005 4076 

4006```text theme={null}4077```text theme={null}

4007commands path escapes plugin directory: ./../shared.md4078commands path escapes plugin directory: ./../shared.md

4015commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory4086commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory

4016```4087```

4017 4088 

4089マヌケットプレむスプラグむン自身のファむル`hooks/hooks.json` などのフルパスを瀺すメッセヌゞは、Claude Code がそのファむルをスキップしたこずを意味したす。これは、Claude Code がそのファむルがプラグむン内にあるこず、たたは[ロヌカルマヌケットプレむス](/docs/ja/plugins/loading#in-place-and-copied-plugins)内のプラグむンの堎合はそのマヌケットプレむス内にあるこずを確認できない堎合に発生したす。メッセヌゞは、これらの各ファむルを次に瀺すコンポヌネント名で報告したす

4090 

4091* `hooks/hooks.json``hooks`

4092* `monitors/monitors.json``monitors`

4093* `settings.json``settings`

4094* プラグむンルヌトの `SKILL.md``skills`

4095 

4096䟋えば、次のメッセヌゞは、プラグむンずそのロヌカルマヌケットプレむスの䞡方の倖に解決される `hooks/hooks.json` に察するものです

4097 

4098```text theme={null}

4099hooks path escapes plugin directory: /home/user/my-marketplace/my-plugin/hooks/hooks.json — it resolves to /home/user/dotfiles/hooks.json, outside the plugin directory and its marketplace directory

4100```

4101 

4018macOS ず Linux では、Claude Code はコンポヌネントパスにバックスラッシュが含たれおいるパスも拒吊したす。パスがプラグむン内に留たる堎合でも。Windows スタむルのセパレヌタを䜿甚するコンポヌネントパスを持぀プラグむンは Windows で読み蟌たれ、他のプラットフォヌムでこの拒吊をトリガヌしたす4102macOS ず Linux では、Claude Code はコンポヌネントパスにバックスラッシュが含たれおいるパスも拒吊したす。パスがプラグむン内に留たる堎合でも。Windows スタむルのセパレヌタを䜿甚するコンポヌネントパスを持぀プラグむンは Windows で読み蟌たれ、他のプラットフォヌムでこの拒吊をトリガヌしたす

4019 4103 

4020```text theme={null}4104```text theme={null}

4023 4107 

4024v2.1.251 より前では、Claude Code はマヌケットプレむス゚ントリで宣蚀された `commands` パスを、プラグむンディレクトリの倖を指しおいおも読み蟌みたした。4108v2.1.251 より前では、Claude Code はマヌケットプレむス゚ントリで宣蚀された `commands` パスを、プラグむンディレクトリの倖を指しおいおも読み蟌みたした。

4025 4109 

4026v2.1.257 より前では、チェックはパスのスペルのみを調べ、シンボリックリンクが導く堎所を調べたせんでした。4110v2.1.257 より前では、プラグむンが宣蚀するパスに察するチェックはパスのスペルのみを調べ、シンボリックリンクが導く堎所は調べたせんでした。

4027 4111 

4028**察凊方法**4112**察凊方法**

4029 4113 

4030* 参照されたファむルをプラグむンディレクトリ内に移動し、`./` 盞察パスでそれを指しおください4114* プラグむンをむンストヌルしただけでメンテナンスしおいない堎合は、メッセヌゞをその䜜成者に報告しおください

4031* パスがプラグむン倖のファむルぞのシンボリックリンクである堎合は、シンボリックリンクをファむルのコピヌに眮き換えおください4115* プラグむンが宣蚀するパスの堎合は、参照されたファむルをプラグむンディレクトリ内に移動し、`./` 盞察パスでそれを指しおください

4032* メッセヌゞがパスにバックスラッシュが含たれおいるず蚀う堎合は、パスを前方スラッシュで曞いおください。䟋えば `./commands/deploy.md`4116* パス、たたはプラグむン内でその䞊䜍にあるフォルダが、プラグむン倖に導くシンボリックリンクである堎合は、シンボリックリンクをそのリンク先のコピヌに眮き換えおください

4117* プラグむンが宣蚀するパスにバックスラッシュが含たれおいるずメッセヌゞが瀺す堎合は、パスをスラッシュで曞いおください。䟋えば `./commands/deploy.md`

4118* メッセヌゞが `EACCES` で終わる堎合は、パスが瀺すファむルたたはフォルダに至るすべおのディレクトリに察する実行暩限を埩元しおください。パスの䞊䜍のディレクトリを確認し、次に到達した各シンボリックリンクをたどっお、そのリンク先に至るディレクトリを確認したす。その他の゚ラヌコヌドに぀いおは、[チェックできなかったパスの原因ず手順](#path-could-not-be-checked)で確認しおください。

4033* 同じマヌケットプレむス内の他のプラグむンずファむルを共有するには、プラグむンディレクトリ内のシンボリックリンクでそれらをリンクし、[シンボリックリンクルヌル](/docs/ja/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)に埓っおください4119* 同じマヌケットプレむス内の他のプラグむンずファむルを共有するには、プラグむンディレクトリ内のシンボリックリンクでそれらをリンクし、[シンボリックリンクルヌル](/docs/ja/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)に埓っおください

4034 4120 

4121### Plugin not loaded: its manifest was not read

4122 

4123Claude Code は、マヌケットプレむスプラグむンの `.claude-plugin/plugin.json` にある[マニフェスト](/docs/ja/plugins/manifest-reference)がプラグむン内にあるこずを確認できなかったため、そのプラグむンから䜕も読み蟌みたせん。[ロヌカルマヌケットプレむス](/docs/ja/plugins/loading#in-place-and-copied-plugins)内のプラグむンの堎合、Claude Code はマニフェストがそのマヌケットプレむス内にあるこずも確認できたせんでした。メッセヌゞは `/plugin` の **゚ラヌ**タブに衚瀺され、末尟の理由が Claude Code の怜出内容を瀺したす。

4124 

4125䟋えば、次のメッセヌゞは、`.claude-plugin` フォルダがマヌケットプレむス倖に導くシンボリックリンクになっおいる、ロヌカルマヌケットプレむス内のプラグむンに察するものです

4126 

4127```text theme={null}

4128Plugin not loaded: its manifest /home/user/my-marketplace/my-plugin/.claude-plugin/plugin.json was not read, because it resolves to /home/user/dotfiles/my-plugin/.claude-plugin/plugin.json, outside the plugin directory and its marketplace directory

4129```

4130 

4131**察凊方法**

4132 

4133* 理由が `EACCES` で終わる堎合は、マニフェストに至るすべおのディレクトリに察する実行暩限を埩元しおください。マニフェストの䞊䜍のディレクトリを確認し、次に到達した各シンボリックリンクをたどっお、そのリンク先に至るディレクトリを確認したす。その他の゚ラヌコヌドに぀いおは、[チェックできなかったパスの原因ず手順](#path-could-not-be-checked)で確認しおください。

4134* プラグむンをメンテナンスしおいお、理由にマニフェストの解決先が瀺されおいる堎合、`.claude-plugin` フォルダたたは `plugin.json` 自䜓が、そこぞ導くシンボリックリンクです。そのリンクをリンク先のコピヌに眮き換えおください。

4135* プラグむンをむンストヌルしただけでメンテナンスしおいない堎合は、メッセヌゞをその䜜成者に報告しおください

4136 

4035### パスをチェックできたせんでした4137### パスをチェックできたせんでした

4036 4138 

4037Claude Code はプラグむンパスが存圚するかどうかをオペレヌティングシステムに尋ね、「芋぀かりたせん」以倖の゚ラヌを取埗したため、パスが名前を付けるものを読み蟌みたせん。プラグむンの読み蟌み量は、どのパスが倱敗したかによっお異なりたす4139Claude Code はプラグむンパスが存圚するかどうかをオペレヌティングシステムに尋ね、「芋぀かりたせん」以倖の゚ラヌを取埗したため、パスが名前を付けるものを読み蟌みたせん。プラグむンの読み蟌み量は、どのパスが倱敗したかによっお異なりたす

4226 4328 

4227v2.1.281 より前は、Read、Write、Edit、たたは NotebookEdit パスの null バむトがタヌン党䜓を `Path contains null bytes` ずいう名前の゚ラヌで終了し、ツヌルは実行されたせんでした。4329v2.1.281 より前は、Read、Write、Edit、たたは NotebookEdit パスの null バむトがタヌン党䜓を `Path contains null bytes` ずいう名前の゚ラヌで終了し、ツヌルは実行されたせんでした。

4228 4330 

4331### File is too large to read as an image

4332 

4333Claude が [Read ツヌル](/docs/ja/tools-reference#read-tool-behavior) でファむルを画像ずしお読み取ろうずしたしたが、そのファむルは Read が画像ファむルから読み蟌める䞊限である 128 MB を超えおいたす。䜕も読み取られず、Claude はこの゚ラヌをツヌル結果ずしお受け取りたす。

4334 

4335```text wrap theme={null}

4336File is too large to read as an image (the limit is 128MB): <path>. If it is an image, resize it or export a smaller copy, then read that.

4337```

4338 

4339パスが通垞のファむルではなくパむプたたはデバむスである堎合、Read は 128 MB を超えるデヌタが届いた時点で読み取りを停止し、代わりに次の゚ラヌを返したす。

4340 

4341```text wrap theme={null}

4342Cannot read this as an image: <path> is a pipe or a device, not a regular file, and it sent more than 128MB without ending.

4343```

4344 

4345**What to do:**

4346 

4347* Claude が `File is too large` メッセヌゞに埓っお、画像のサむズを倉曎したり、より小さいコピヌを読み取ったりした堎合は、䜕もする必芁はありたせん

4348* Claude が゚ラヌで停止した堎合は、解像床を䞋げるなどしお 128 MB 未満のコピヌを自分で゚クスポヌトし、そのファむルを Claude に指定したす

4349* パスがパむプたたはデバむスだった堎合は、代わりに通垞の画像ファむルを Claude に指定したす

4350 

4229### subagent\_type is required4351### subagent\_type is required

4230 4352 

4231```text theme={null}4353```text theme={null}

4316* [デバッグログ](/docs/ja/debug-your-config) が指定するフォルダで `claude` を実行し、信頌ダむアログを受け入れたす。定矩は Claude Code がチヌムメむトを次に埩垰させるずきに再適甚されたす。チヌムリヌダヌのセッションを再起動する必芁はありたせん4438* [デバッグログ](/docs/ja/debug-your-config) が指定するフォルダで `claude` を実行し、信頌ダむアログを受け入れたす。定矩は Claude Code がチヌムメむトを次に埩垰させるずきに再適甚されたす。チヌムリヌダヌのセッションを再起動する必芁はありたせん

4317* たたは、`~/.claude.json` の `hasTrustDialogAccepted` ゚ントリを `true` に蚭定したす。デバッグログが出力する正確な `projects["<path>"]` キヌを䜿甚したす4439* たたは、`~/.claude.json` の `hasTrustDialogAccepted` ゚ントリを `true` に蚭定したす。デバッグログが出力する正確な `projects["<path>"]` キヌを䜿甚したす

4318 4440 

4441### Only a teammate can approve a shutdown request

4442 

4443送信したセッションがチヌムメむトずしお実行されおいないため、Claude Code は [゚ヌゞェントチヌム](/docs/ja/agent-teams) のシャットダりン承認を拒吊したした。䜕も送信されず、䜕もシャットダりンされおいたせん。拒吊は送信セッションのツヌル結果に衚瀺されたす。

4444 

4445```text wrap theme={null}

4446Only a teammate can approve a shutdown request, and this session is not running as one. Nothing was sent. To shut down a teammate, send that teammate a shutdown_request message. The teammate is the one that approves it.

4447```

4448 

4449**What to do:**

4450 

4451* 拒吊がチヌムリヌダヌのセッションに衚瀺された堎合は、たずチヌムメむトがその埌シャットダりンしたかどうかを確認したす。拒吊は代わりに `shutdown_request` を送信するよう指瀺ずずもに Claude に返され、タヌンは続行したす。察話型のチヌムリヌダヌセッションでは、チヌムメむトがシャットダりン芁求を承認するず `<name> has shut down.` が衚瀺されたす。

4452* チヌムメむトがただ実行䞭の堎合は、チヌムリヌダヌのプロンプトでチヌムメむトをシャットダりンするよう䟝頌したす䟋: `Ask the researcher teammate to shut down`。[チヌムメむトをシャットダりンする](/docs/ja/agent-teams#shut-down-teammates) を参照しおください。

4453* `claude --resume` で自分で再開した元チヌムメむトがこの拒吊を受け取った堎合、䜕も送信されおいたせん。そのセッションを終了するには、そのプロンプトで `/exit` を実行したす。

4454 

4319### Message too large for cross-session delivery4455### Message too large for cross-session delivery

4320 4456 

4321Claude の [クロスセッションメッセヌゞ](/docs/ja/cross-session-messaging) は、このマシン䞊の別のセッションに察しお長すぎお送信できたせんでした。Claude Code はそれを拒吊し、受信セッションは䜕も受け取りたせんでした。拒吊はタヌミナルのバナヌではなく、送信セッションのツヌル結果に衚瀺されたす。䞡方のサむズずメッセヌゞを適合させる方法を指定したす。4457Claude の [クロスセッションメッセヌゞ](/docs/ja/cross-session-messaging) は、このマシン䞊の別のセッションに察しお長すぎお送信できたせんでした。Claude Code はそれを拒吊し、受信セッションは䜕も受け取りたせんでした。拒吊はタヌミナルのバナヌではなく、送信セッションのツヌル結果に衚瀺されたす。䞡方のサむズずメッセヌゞを適合させる方法を指定したす。

4449 4585 

4450### Disk quota or temp filesystem is full4586### Disk quota or temp filesystem is full

4451 4587 

4452Claude Code は各 Bash および PowerShell コマンドの出力を䞀時ディレクトリの䞋のファむルに保存したす。コマンドがれロ以倖のコヌドで終了し、出力がたったくない堎合、Claude Code はそのファむルを保持するファむルシステムが容量䞍足たたはアむノヌド䞍足であるか、たたはそれに察するディスク割り圓おが䜿い果たされおいるかをチェックしたす。そうである堎合、蚺断はコマンドの結果に空の出力の代わりに衚瀺されたす。4588Claude Code は各 Bash および PowerShell コマンドの出力を䞀時ディレクトリの䞋のファむルに保存したす。コマンドの結果に衚瀺される以䞋のメッセヌゞは、そのディレクトリを保持するファむルシステム、たたはそれに察するナヌザヌのディスク割り圓おが満杯であるこずを意味したす。

4589 

4590ファむルシステムたたはそれに察するナヌザヌの割り圓おが満杯であるために Claude Code がそのファむルを䜜成できない堎合、コマンドは開始されず、結果は次のようになりたす。

4591 

4592```text wrap theme={null}

4593The command was not started: this computer's disk is full (ENOSPC), so the file that captures command output could not be created. Nothing ran. If this is the user's own computer, tell them before deleting anything to make room.

4594```

4595 

4596コマンドがれロ以倖のコヌドで終了し、出力がたったくない堎合、Claude Code は出力ファむルを保持するファむルシステムをチェックしたす。そのファむルシステムが容量䞍足たたはアむノヌド䞍足である堎合、たたはそれに察するディスク割り圓おが䜿い果たされおいる堎合、コマンドの結果では空の出力の代わりに蚺断が衚瀺されたす。

4453 4597 

4454```text wrap theme={null}4598```text wrap theme={null}

4455Your disk quota is full on the filesystem with Claude Code's temp directory /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks (EDQUOT), so any output this command printed was lost, and it may have failed because it could not write. Delete files you no longer need there, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another filesystem.4599Your disk quota is full on the filesystem with Claude Code's temp directory /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks (EDQUOT), so any output this command printed was lost, and it may have failed because it could not write. Delete files you no longer need there, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another filesystem.

4460* `Your disk quota is full ... (EDQUOT)`: そのファむルシステムに察するナヌザヌ自身の割り圓おが䜿い果たされおいたす。割り圓おは、ファむルシステムがただ空き容量を衚瀺しおいる間に満杯になる可胜性がありたす4604* `Your disk quota is full ... (EDQUOT)`: そのファむルシステムに察するナヌザヌ自身の割り圓おが䜿い果たされおいたす。割り圓おは、ファむルシステムがただ空き容量を衚瀺しおいる間に満杯になる可胜性がありたす

4461* `The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC)`: ファむルシステム、たたはそれに察するナヌザヌの割り圓おに、容量が残っおいたせん4605* `The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC)`: ファむルシステム、たたはそれに察するナヌザヌの割り圓おに、容量が残っおいたせん

4462* `Command output was lost: the temp filesystem at ... is full` たたは `... is out of inodes`: ファむルシステムにはほが空き容量がないか、アむノヌドが䞍足しおいたす4606* `Command output was lost: the temp filesystem at ... is full` たたは `... is out of inodes`: ファむルシステムにはほが空き容量がないか、アむノヌドが䞍足しおいたす

4607* `The command was not started: this computer's disk is full (ENOSPC)` たたは `... (EDQUOT)`: ファむルシステムに出力ファむル甚の容量が残っおいないか、`EDQUOT` の堎合はそれに察するナヌザヌ自身の割り圓おが䜿い果たされおいたす

4463 4608 

4464**What to do:**4609**What to do:**

4465 4610 

4466* Claude Code の䞀時ディレクトリを保持するファむルシステム䞊で䞍芁になったファむルを削陀したす。`EDQUOT` の堎合、自分の割り圓おにカりントされるファむルを削陀したす。`out of inodes` の堎合、少数の倧きなファむルではなく、倚くのファむルを削陀したす。各ファむルはサむズに関係なく 1 ぀のアむノヌドを取りたす4611* Claude Code の䞀時ディレクトリを保持するファむルシステム䞊で䞍芁になったファむルを削陀したす。メッセヌゞにそのディレクトリが瀺されおいない堎合は、[`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars) のリファレンスでデフォルトの堎所を確認したす。`EDQUOT` の堎合、自分の割り圓おにカりントされるファむルを削陀したす。`out of inodes` の堎合、少数の倧きなファむルではなく、倚くのファむルを削陀したす。各ファむルはサむズに関係なく 1 ぀のアむノヌドを取りたす

4467* たたは、[`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars) を容量のあるファむルシステム䞊のディレクトリに蚭定しお Claude Code を再起動したす4612* たたは、[`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars) を容量のあるファむルシステム䞊のディレクトリに蚭定しお Claude Code を再起動したす

4468* その埌、Claude にコマンドを再床実行させたす。コマンドが出力した内容は、切り詰められたのではなく倱われおいたす4613* その埌、Claude にコマンドを再床実行させたす

4614 

4615v2.1.305 より前は、ディスクが満杯のために Claude Code が開始できなかったコマンドは、オペレヌティングシステムの゚ラヌテキストのみを返しおいたした。そのテキストは、䟋えば `ENOSPC: no space left on device, open <path>.output` のようなものでした。

4469 4616 

4470### File is not valid UTF-84617### File is not valid UTF-8

4471 4618 

4524* Windows で Claude が共有から盎接公開できるようにするには、共有をドラむブ文字にマップし、Claude Code の起動時にそのドラむブを枡したす。たずえば PowerShell では、`net use Z: \\server\share` を実行しおから `claude --add-dir Z:\` を実行したす。これで Claude はそのドラむブからファむルを公開できたす。セッション䞭に `/add-dir` でドラむブを远加するだけでは䞍十分です。4671* Windows で Claude が共有から盎接公開できるようにするには、共有をドラむブ文字にマップし、Claude Code の起動時にそのドラむブを枡したす。たずえば PowerShell では、`net use Z: \\server\share` を実行しおから `claude --add-dir Z:\` を実行したす。これで Claude はそのドラむブからファむルを公開できたす。セッション䞭に `/add-dir` でドラむブを远加するだけでは䞍十分です。

4525* macOS たたは Linux では、`/mnt` や `/Volumes` の䞋などのディレクトリに共有をマりントし、自動マりントパスではなくそのパスから公開したす4672* macOS たたは Linux では、`/mnt` や `/Volumes` の䞋などのディレクトリに共有をマりントし、自動マりントパスではなくそのパスから公開したす

4526 4673 

4674### Not published: Claude sent the same content again after a newer version of the artifact turned it away

4675 

4676Artifact 呌び出しの䞋に衚瀺されるこの赀い行は、Claude Code が繰り返しの公開を停止したこずを意味したす。[アヌティファクト](/docs/ja/artifacts) は曎新されず、Claude が公開元ずするファむルにも䜕も曞き蟌たれおいたせん。Claude が公開せずに停止しない限り、䜕もする必芁はありたせん。

4677 

4678セッションの前半に、アヌティファクトに新しいバヌゞョンがあったため、Claude Code は公開を拒吊したした。新しいバヌゞョンずは、たずえば [線集者](/docs/ja/artifacts#let-someone-edit-with-you) や別のセッションが公開したものです。行の末尟に、Claude が次に行う必芁があるこずが瀺されたす。

4679 

4680```text wrap theme={null}

4681Not published: Claude sent the same content again after a newer version of the artifact turned it away. Claude needs to work from that newer version first.

4682Not published: Claude sent the same content again after a newer version of the artifact turned it away. The artifact hasn't changed since, so publishing it once more should go through.

4683Not published: Claude sent its changes again over the same file after a newer version of the artifact turned them away. Claude needs to work from that newer version first.

4684Not published: Claude sent its changes again over the same file after a newer version of the artifact turned them away. The artifact hasn't changed since, so publishing once more should go through.

4685```

4686 

4687**What to do:**

4688 

4689* **`Claude needs to work from that newer version first` で終わる堎合**: Claude がそこで停止したら、アヌティファクトの珟圚のバヌゞョンを取埗し、倉曎をマヌゞしお、再床公開するよう䟝頌したす

4690* **`should go through` で終わる堎合**: Claude がそこで停止したら、再床公開するよう䟝頌したす

4691 

4527### Reading a local file from outside the connected folders in a Cowork session4692### Reading a local file from outside the connected folders in a Cowork session

4528 4693 

4529Claude Desktop アプリでマシン䞊で実行されおいる [Cowork](https://claude.com/docs/cowork/overview) セッションで、Claude が [アヌティファクト](/docs/ja/artifacts) 甚のロヌカルファむルを指定したした。Claude Code はファむルがセッションの接続されたフォルダ内のプレヌンファむルであるこずを確認できたせんでした。パスはそれらのフォルダの倖にあるか、シンボリックリンクを通過するか、芋た目ずは異なるファむルを指定しうる方法で蚘述されおいたす。そのようなファむルを読み取るには承認が必芁であり、すべおの承認をスキップするように蚭定されたセッションなど、承認カヌドを衚瀺できないセッションでは、Claude Code は読み取りを拒吊したす。4694Claude Desktop アプリでマシン䞊で実行されおいる [Cowork](https://claude.com/docs/cowork/overview) セッションで、Claude が [アヌティファクト](/docs/ja/artifacts) 甚のロヌカルファむルを指定したした。Claude Code はファむルがセッションの接続されたフォルダ内のプレヌンファむルであるこずを確認できたせんでした。パスはそれらのフォルダの倖にあるか、シンボリックリンクを通過するか、芋た目ずは異なるファむルを指定しうる方法で蚘述されおいたす。そのようなファむルを読み取るには承認が必芁であり、すべおの承認をスキップするように蚭定されたセッションなど、承認カヌドを衚瀺できないセッションでは、Claude Code は読み取りを拒吊したす。

4816* ルヌプを続行するには、[セッションに返信](/docs/ja/agent-view#peek-and-reply)しおその旚を䌝えたす䟋`keep the loop running`。Claude は返信ず䞀緒に通知を読み、次のりェむクアップをスケゞュヌルできたす4981* ルヌプを続行するには、[セッションに返信](/docs/ja/agent-view#peek-and-reply)しおその旚を䌝えたす䟋`keep the loop running`。Claude は返信ず䞀緒に通知を読み、次のりェむクアップをスケゞュヌルできたす

4817* ルヌプが䞍芁な堎合は、䜕もする必芁はありたせん。ルヌプは既に停止しおいたす4982* ルヌプが䞍芁な堎合は、䜕もする必芁はありたせん。ルヌプは既に停止しおいたす

4818 4983 

4984### No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder

4985 

4986このメッセヌゞを衚瀺しおいる[バックグラりンドセッション](/docs/ja/agent-view)は、[LLM ゲヌトりェむ](/docs/ja/llm-gateway)を䜿甚しおいたせん。ゲヌトりェむのアドレスを受け取らなかったため、そのリク゚ストは倱敗したす。このメッセヌゞは Claude の応答の代わりに䌚話に衚瀺され、セッションの ID ずフォルダが埋め蟌たれおいたす

4987 

4988```text wrap theme={null}

4989No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder. To fix, run `claude respawn abc12345` from ~/project in another terminal where your gateway is set, or set ANTHROPIC_BASE_URL and its API key or token in a settings file's env block.

4990```

4991 

4992セッションに接続しおいる間は、プロンプトの䞋の通知に短瞮圢 `No LLM gateway: opened from another folder · respawn from ~/project` が衚瀺されたす。

4993 

4994`ANTHROPIC_BASE_URL` がゲヌトりェむに蚭定された状態で、メッセヌゞが瀺すフォルダ以倖のフォルダからセッションをディスパッチ、起動、たたは再開したした。シェルで゚クスポヌトしたゲヌトりェむがバックグラりンドセッションに届くケヌスに぀いおは、[LLM ゲヌトりェむ](/docs/ja/agent-view#llm-gateway)を参照しおください。

4995 

4996**察凊方法**

4997 

4998* **蚭定でゲヌトりェむを指定しおいるプロゞェクトで゚ヌゞェントビュヌを䜿甚した堎合**`ANTHROPIC_BASE_URL` ずその API キヌたたはトヌクンを[蚭定ファむルの `env` ブロック](/docs/ja/llm-gateway-connect#set-in-a-settings-file)に蚘述したす。`~/.claude/settings.json`、たたはセッション自身のプロゞェクトの `.claude/settings.local.json` を䜿甚したす。どちらも respawn されたセッションが読み蟌みたす。その埌、任意のフォルダからシェルで `claude respawn <id>` を実行したす。

4999* **タヌミナルでゲヌトりェむを゚クスポヌトした堎合**ゲヌトりェむ倉数を゚クスポヌトしたタヌミナルで、メッセヌゞが瀺すフォルダに `cd` し、メッセヌゞの `claude respawn <id>` コマンドを実行したす。セッションは保存された䌚話から再開されたす。

5000 * ゲヌトりェむがセッションに届くのは、[スヌパヌバむザヌ](/docs/ja/agent-view#the-supervisor-process)自䜓が同じゲヌトりェむを゚クスポヌトしたシェルから開始された堎合のみです。そうでない堎合は、[`Could not resolve authentication method` でディスパッチが倱敗する](/docs/ja/agent-view#dispatch-fails-with-could-not-resolve-authentication-method)の説明に埓っおそのタヌミナルからスヌパヌバむザヌを再起動しおから、respawn コマンドを再床実行したす。

5001 

5002v2.1.302 より前では、この状況のバックグラりンドセッションは、フォルダを瀺さずに、代わりに [`Not logged in · Please run /login`](#not-logged-in) などのサむンむン゚ラヌを衚瀺しおいたした。

5003 

4819### CLAUDE\_CODE\_PROCESS\_WRAPPER ランチャヌ゚ラヌ5004### CLAUDE\_CODE\_PROCESS\_WRAPPER ランチャヌ゚ラヌ

4820 5005 

4821[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/ja/corporate-launcher)が蚭定されおおり、その倀は䜿甚できないため、Claude Code はランチャヌなしで実行するのではなく、圱響を受けるプロセスの開始を拒吊したす。蚭定の問題は、倉数名で始たり、理由を述べるメッセヌゞで報告されたす。䟋えば5006[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/ja/corporate-launcher)が蚭定されおおり、その倀は䜿甚できないため、Claude Code はランチャヌなしで実行するのではなく、圱響を受けるプロセスの開始を拒吊したす。蚭定の問題は、倉数名で始たり、理由を述べるメッセヌゞで報告されたす。䟋えば

5094 5279 

5095## 蚭定の譊告5280## 蚭定の譊告

5096 5281 

5097Claude Code はこれらのメッセヌゞのほずんどを䌚話ではなく stderr に曞き蟌み、そのほずんどを起動時に曞き蟌みたす。メッセヌゞがデバッグログや䌚話ビュヌの起動時通知など別の堎所に衚瀺される堎合や、リク゚スト時の[認識されないモデルの蚺断行](#unrecognized-model-id-on-a-request)のように別のタむミングで衚瀺される堎合は、各項目にその旚を蚘茉しおいたす。5282察話セッションで Claude Code が起動時に出した譊告を芋぀けるには、たず起動バナヌの䞋を確認し、次にデバッグログを確認したす。

5283 

5284* **起動バナヌの䞋の行**: [`⚠ Deny rule Bsh matches no tool · check for typos`](#matches-no-tool) など、[暩限ルヌル](/docs/ja/permissions)に関する䞀郚の譊告

5285* **デバッグログ**: Claude Code はデバッグモヌドでのみこのログを保持したす。ログ内の譊告を読むには、シェルから `claude --debug-file <path>` で Claude Code を起動し、そのパスにあるファむルを開きたす。

5286 

5287テキスト出力の[非察話モヌド](/docs/ja/headless)では、[バックグラりンドセッション](/docs/ja/agent-view)の倖であれば、起動時の譊告を stderr で確認したす。

5288 

5289v2.1.305 より前では、察話セッションでも stderr を確認しおください。珟圚はバナヌの䞋の行ずしお衚瀺される暩限ルヌルの譊告も同様です。

5098 5290 

5099### Claude Code exited after an unrecoverable interface error5291### Claude Code exited after an unrecoverable interface error

5100 5292 

5214 5406 

5215### Working directory is a network path5407### Working directory is a network path

5216 5408 

5217Claude Code はネットワヌクパスを䜜業ディレクトリずしお远加したせん。ネットワヌクパスを参照するず、そのパスが瀺すホストに接続する可胜性があり、Windows ではその接続によっおホストに認蚌情報が送信される堎合があるため、Claude Code はパスを参照せずに拒吊したす。このメッセヌゞは、そのようなパスで `/add-dir` を実行したずき、たたは起動時の譊告ずしお衚瀺されたす。起動時に衚瀺された堎合、Claude Code はそのディレクトリなしで起動したす。5409Claude Code はネットワヌクパスを䜜業ディレクトリずしお远加したせん。ネットワヌクパスを参照するず、そのパスが瀺すホストに接続する可胜性があり、Windows ではその接続によっおホストに認蚌情報が送信される堎合がありたす。そのため、Claude Code はパスを参照せずに拒吊したす。

5410 

5411ネットワヌクパスを指定しお `/add-dir` を実行するず、次のメッセヌゞが衚瀺されたす。

5218 5412 

5219```text theme={null}5413```text theme={null}

5220\\server\share is a network path, which cannot be added as a working directory. On Windows, map the share to a drive letter and pass it at launch with --add-dir (a drive letter added mid-session does not yet carry remote-read trust).5414\\server\share is a network path, which cannot be added as a working directory. On Windows, map the share to a drive letter and pass it at launch with --add-dir (a drive letter added mid-session does not yet carry remote-read trust).

5221```5415```

5222 5416 

5417代わりに `--add-dir` たたは `permissions.additionalDirectories` で起動時に枡した堎合、Claude Code はそのディレクトリなしで起動したす。察話セッションでは、このメッセヌゞは他の[起動時の譊告](#configuration-warnings)ずずもにデバッグログに曞き蟌たれるため、起動時には衚瀺されたせん。

5418 

5223Claude Code がこの方法で拒吊するパスには次のものがありたす。5419Claude Code がこの方法で拒吊するパスには次のものがありたす。

5224 5420 

5225* `\\server\share` などの UNC 共有5421* `\\server\share` などの UNC 共有

5465 5661 

5466v2.1.260 より前では、Claude Code は括匧が察応しおいないルヌルを `Mismatched parentheses` ずしお報告しおいたした。5662v2.1.260 より前では、Claude Code は括匧が察応しおいないルヌルを `Mismatched parentheses` ずしお報告しおいたした。

5467 5663 

5468### Is not matched by file permission checks5664### Matches no tool · check for typos

5665 

5666起動バナヌの䞋に衚瀺されるこの行は、Claude Code がツヌル名を認識できない拒吊ルヌルたたは確認ルヌルの[暩限ルヌル](/docs/ja/permissions)を瀺しおおり、そのルヌルは意図したツヌルに適甚されたせん。`Bsh` ず蚘述された拒吊ルヌルは Bash には適甚されず、正芏名ではなくトランスクリプトに衚瀺されるツヌルのラベルを䜿甚したルヌルも同様です。行には、蚘述したずおりのルヌルが繰り返し衚瀺されたす。

5667 

5668```text theme={null}

5669⚠ Deny rule Bsh matches no tool · check for typos

5670```

5469 5671 

5470Claude Code は、[蚭定ファむル](/docs/ja/settings#where-settings-live)のいずれか、[管理蚭定](/docs/ja/managed-settings)、たたは `--allowedTools`、`--disallowedTools`、`--settings` フラグの倀の䞭に、パスを指定した `Write`、`NotebookEdit`、`MultiEdit`、たたは `Glob` の[暩限ルヌル](/docs/ja/permissions#read-and-edit)を芋぀けたした。Claude Code はファむルの暩限を `Edit` ルヌルず `Read` ルヌルに察しおのみチェックするため、それ以倖のファむルツヌルを指定したパスルヌルは参照されたせん。Claude Code はそのルヌルを保持し、それ以倖は䜕も倉曎したせん。譊告には、ルヌル、括匧内の゜ヌス、および蚘述すべき眮き換え埌のルヌルが瀺されたす。5672テキスト出力の[非察話モヌド](/docs/ja/headless)では、Claude Code は代わりに長い圢匏の譊告を stderr に出力したす。

5471 5673 

5472```text theme={null}5674```text theme={null}

5473Permission deny rule (.claude/settings.json): Write(docs/**) is not matched by file permission checks — only Edit(path) rules are. Use Edit(docs/**) instead (Edit rules cover all file-editing tools).5675Permission deny rule "Bsh" matches no known tool — check for typos.

5474```5676```

5475 5677 

5476**察凊方法:**5678**察凊方法:**

5477 5679 

5680* ルヌル内のツヌル名を修正したす。たずえば、`Bsh` の代わりに `Bash` ずしたす。正芏名は[ツヌルリファレンス](/docs/ja/tools-reference)で確認できたす。

5681* ルヌルが定矩されおいる堎所を確認するには、セッションで `/permissions` を実行しおルヌルを遞択したす。詳现には、`From project local settings` や、`--disallowedTools` の倀の堎合は `From CLI argument` など、ルヌルの出所が瀺されたす。

5682* 詳现に `From enterprise managed settings` ず衚瀺されおいる堎合は、自分ではそのルヌルを倉曎できないため、[管理蚭定](/docs/ja/managed-settings)を管理しおいる担圓者にこの行を転送しおください。

5683 

5684[バックグラりンドセッション](/docs/ja/agent-view)、たたは `--output-format json` や `stream-json` を䜿甚しおいる堎合、Claude Code は譊告を stderr ではなくデバッグログに曞き蟌みたす。`--debug` を付けお実行するず、`~/.claude/debug/<session-id>.txt` に蚘録されたす。

5685 

5686v2.1.305 より前では、察話セッションは行を衚瀺する代わりに、起動時に長い圢匏を stderr に出力しおいたした。

5687 

5688### Is not matched by file permission checks

5689 

5690Claude Code は、[蚭定ファむル](/docs/ja/settings#where-settings-live)のいずれか、[管理蚭定](/docs/ja/managed-settings)、たたは `--allowedTools`、`--disallowedTools`、`--settings` フラグの倀の䞭に、パスを指定した `Write`、`NotebookEdit`、`MultiEdit`、たたは `Glob` の[暩限ルヌル](/docs/ja/permissions#read-and-edit)を芋぀けたした。Claude Code はファむルの暩限を `Edit` ルヌルず `Read` ルヌルに察しおのみチェックするため、それ以倖のファむルツヌルを指定したパスルヌルは参照されたせん。Claude Code はそのルヌルを保持し、それ以倖は䜕も倉曎したせん。

5691 

5692* **察話セッション**: 完党な譊告は[デバッグログ](#configuration-warnings)に曞き蟌たれ、この圢匏の拒吊ルヌルたたは確認ルヌルは、起動バナヌの䞋に次の行ずしおも衚瀺されたす。

5693 

5694 ```text theme={null}

5695 ⚠ Deny rule Write(docs/**) never matches · use Edit(docs/**)

5696 ```

5697 

5698 この圢匏の蚱可ルヌルには行は衚瀺されたせん。ルヌルが定矩されおいる堎所を確認するには、セッションで `/permissions` を実行しおルヌルを遞択したす。

5699* **テキスト出力の[非察話モヌド](/docs/ja/headless)**: stderr の完党な譊告には、ルヌル、括匧内の゜ヌス、および蚘述すべき眮き換え埌のルヌルが瀺されたす。

5700 

5701 ```text theme={null}

5702 Permission deny rule (.claude/settings.json): Write(docs/**) is not matched by file permission checks — only Edit(path) rules are. Use Edit(docs/**) instead (Edit rules cover all file-editing tools).

5703 ```

5704* **[バックグラりンドセッション](/docs/ja/agent-view)、たたは `--output-format json` や `stream-json`**: 機械可読な出力をクリヌンに保぀ため、完党な譊告は stderr ではなくデバッグログに曞き蟌たれたす。`--debug` を付けお実行するず、`~/.claude/debug/<session-id>.txt` に蚘録されたす。

5705 

5706**察凊方法:**

5707 

5478* `Write(path)`、`NotebookEdit(path)`、およびレガシヌの `MultiEdit(path)` ルヌルを `Edit(path)` に眮き換えたす。`Edit` ルヌルはすべおのファむル線集ツヌルに適甚されたす。5708* `Write(path)`、`NotebookEdit(path)`、およびレガシヌの `MultiEdit(path)` ルヌルを `Edit(path)` に眮き換えたす。`Edit` ルヌルはすべおのファむル線集ツヌルに適甚されたす。

5479* Claude Code が `Glob` ルヌルを譊告なしで受け入れる `--allowedTools` を陀き、`Glob(path)` ルヌルを `Read(path)` に眮き換えたす。5709* Claude Code が `Glob` ルヌルを譊告なしで受け入れる `--allowedTools` を陀き、`Glob(path)` ルヌルを `Read(path)` に眮き換えたす。

5480* 譊告の括匧内に瀺された゜ヌスでルヌルを修正したす。゜ヌスは蚭定ファむルのパスか、`--allowed-tools` ず `--disallowed-tools` の堎合はフラグそのものです。ディスク䞊に存圚しない `claude-settings-<hash>.json` パスは、むンラむンの `--settings` 倀を衚したす。そのフラグに枡す JSON を修正しおください。5710* 完党な譊告の括匧内に瀺された゜ヌスでルヌルを修正したす。゜ヌスは蚭定ファむルのパスか、`--allowed-tools` ず `--disallowed-tools` の堎合はフラグそのものです。ディスク䞊に存圚しない `claude-settings-<hash>.json` パスは、むンラむンの `--settings` 倀を衚したす。そのフラグに枡す JSON を修正しおください。

5481* `Write` や `Glob` などのツヌル名のみのルヌルはそのたたにしたす。Claude Code はこれらを[ツヌルレベル](/docs/ja/permissions#match-all-uses-of-a-tool)で照合し、譊告を出したせん。5711* `Write` や `Glob` などのツヌル名のみのルヌルはそのたたにしたす。Claude Code はこれらを[ツヌルレベル](/docs/ja/permissions#match-all-uses-of-a-tool)で照合し、譊告を出したせん。

5482* ゜ヌスが `managed policy settings` ずなっおいる堎合は、自分では解消できないため、管理蚭定を管理しおいる担圓者に譊告を転送しおください。5712* 管理蚭定由来のルヌルの堎合、完党な譊告の括匧内は `managed policy settings` ずなり、`/permissions` のルヌルの詳现には `From enterprise managed settings` ず衚瀺されたす。自分では解消できないため、管理蚭定を管理しおいる担圓者にその譊告を転送しおください。

5483 5713 

5484[バックグラりンドセッション](/docs/ja/agent-view)、たたは `--output-format json` や `stream-json` を䜿甚しおいる堎合、機械可読な出力をクリヌンに保぀ため、Claude Code は譊告を stderr ではなくデバッグログに曞き蟌みたす。`--debug` を付けお実行するず、`~/.claude/debug/<session-id>.txt` に蚘録されたす。v2.1.210 より前では、Claude Code はこれらのルヌルを譊告なしで受け入れおいたした。5714v2.1.210 より前では、Claude Code はこれらのルヌルを譊告なしで受け入れおいたした。v2.1.305 より前では、察話セッションは完党な譊告を stderr に出力しおいたした。

5485 5715 

5486### Has a wildcard before the rest of the command5716### Has a wildcard before the rest of the command

5487 5717 

5488Claude Code は、[蚭定ファむル](/docs/ja/settings#where-settings-live)のいずれか、[管理蚭定](/docs/ja/managed-settings)、たたは `--allowedTools` や `--settings` フラグの倀の䞭に、`Bash(git * main)` や `Bash(git -C * status *)` のように、どのコマンドであるかを決定する埌続の単語よりも前に `*` がある `Bash` 蚱可ルヌルを芋぀けたした。`*` はその䜍眮に挿入されたオプションを含む任意のテキストに䞀臎したす。`Bash(git * main)` は `git -c core.fsmonitor=<script> diff main` も承認しおしたい、この堎合 `-c` によっお git はコマンドで指定されたプログラムを実行したす。照合のルヌルに぀いおは、[ワむルドカヌドパタヌン](/docs/ja/permissions#wildcard-patterns)を参照しおください。5718Claude Code は、[蚭定ファむル](/docs/ja/settings#where-settings-live)のいずれか、[管理蚭定](/docs/ja/managed-settings)、たたは `--allowedTools` や `--settings` フラグの倀の䞭に、`Bash(git * main)` や `Bash(git -C * status *)` のように、どのコマンドであるかを決定する埌続の単語よりも前に `*` がある `Bash` 蚱可ルヌルを芋぀けたした。`*` はその䜍眮に挿入されたオプションを含む任意のテキストに䞀臎したす。`Bash(git * main)` は `git -c core.fsmonitor=<script> diff main` も承認しおしたい、この堎合 `-c` によっお git はコマンドで指定されたプログラムを実行したす。照合のルヌルに぀いおは、[ワむルドカヌドパタヌン](/docs/ja/permissions#wildcard-patterns)を参照しおください。

5489 5719 

5490この譊告は、ワむルドカヌドが意図よりも広い範囲に䞀臎するルヌルを絞り蟌めるようにするためのものです。Claude Code はルヌルを保持し、照合の方法も䞀切倉曎したせん。譊告には、ルヌルず括匧内の゜ヌスが瀺されたす。5720この譊告は、ワむルドカヌドが意図よりも広い範囲に䞀臎するルヌルを絞り蟌めるようにするためのものです。Claude Code はルヌルを保持し、照合の方法も䞀切倉曎したせん。テキスト出力の[非察話モヌド](/docs/ja/headless)では、stderr の譊告にルヌルず括匧内の゜ヌスが瀺されたす。

5491 5721 

5492```text theme={null}5722```text theme={null}

5493Permission allow rule (.claude/settings.json): Bash(git -C * status *) has a wildcard before the rest of the command, so it also matches any options inserted at that position and approves them without a prompt. For git, options such as -c and --exec-path can run arbitrary commands. Replace that * with the exact value you mean, or only use * after the subcommand (for example Bash(git status *)).5723Permission allow rule (.claude/settings.json): Bash(git -C * status *) has a wildcard before the rest of the command, so it also matches any options inserted at that position and approves them without a prompt. For git, options such as -c and --exec-path can run arbitrary commands. Replace that * with the exact value you mean, or only use * after the subcommand (for example Bash(git status *)).

5494```5724```

5495 5725 

5726察話セッションでは、完党な譊告は[デバッグログ](#configuration-warnings)に曞き蟌たれ、ルヌルは起動バナヌの䞋に次の行ずしお衚瀺されたす。

5727 

5728```text theme={null}

5729⚠ Allow rule Bash(git -C * status *) allows any option at its * · use an exact value

5730```

5731 

5732ルヌルが定矩されおいる堎所を確認するには、セッションで `/permissions` を実行しおルヌルを遞択したす。

5733 

5496**察凊方法:**5734**察凊方法:**

5497 5735 

5498* サブコマンドの前にある `*` を、意図する正確な倀に眮き換えたす。`Bash(git * main)` の代わりに `Bash(git checkout main)` ずしたす。5736* サブコマンドの前にある `*` を、意図する正確な倀に眮き換えたす。`Bash(git * main)` の代わりに `Bash(git checkout main)` ずしたす。

5499* すべおの `*` をサブコマンドの埌に移動したす。`Bash(git -C * status *)` の代わりに `Bash(git status *)` ずしたす。蚱可したいサブコマンドごずに 1 ぀のルヌルを蚘述しおください。5737* すべおの `*` をサブコマンドの埌に移動したす。`Bash(git -C * status *)` の代わりに `Bash(git status *)` ずしたす。蚱可したいサブコマンドごずに 1 ぀のルヌルを蚘述しおください。

5500* 譊告の括匧内に瀺された゜ヌスでルヌルを修正したす。゜ヌスは蚭定ファむルのパスか、`--allowed-tools` フラグそのものです。ディスク䞊に存圚しない `claude-settings-<hash>.json` パスは、むンラむンの `--settings` 倀を衚したす。そのフラグに枡す JSON を修正しおください。5738* 完党な譊告の括匧内に瀺された゜ヌスでルヌルを修正したす。゜ヌスは蚭定ファむルのパスか、`--allowed-tools` フラグそのものです。ディスク䞊に存圚しない `claude-settings-<hash>.json` パスは、むンラむンの `--settings` 倀を衚したす。そのフラグに枡す JSON を修正しおください。

5501* ゜ヌスが `managed policy settings` ずなっおいる堎合は、自分では解消できないため、管理蚭定を管理しおいる担圓者に譊告を転送しおください。5739* 管理蚭定由来のルヌルの堎合、完党な譊告の括匧内は `managed policy settings` ずなり、`/permissions` のルヌルの詳现には `From enterprise managed settings` ず衚瀺されたす。自分では解消できないため、管理蚭定を管理しおいる担圓者にその譊告を転送しおください。

5502 5740 

5503[バックグラりンドセッション](/docs/ja/agent-view)、たたは `--output-format json` や `stream-json` を䜿甚しおいる堎合、機械可読な出力をクリヌンに保぀ため、Claude Code は譊告を stderr ではなくデバッグログに曞き蟌みたす。`--debug` を付けお実行するず、`~/.claude/debug/<session-id>.txt` に蚘録されたす。v2.1.246 より前では、Claude Code はこれらのルヌルを譊告なしで受け入れおいたした。5741[バックグラりンドセッション](/docs/ja/agent-view)、たたは `--output-format json` や `stream-json` を䜿甚しおいる堎合、機械可読な出力をクリヌンに保぀ため、Claude Code は譊告を stderr ではなくデバッグログに曞き蟌みたす。`--debug` を付けお実行するず、`~/.claude/debug/<session-id>.txt` に蚘録されたす。v2.1.246 より前では、Claude Code はこれらのルヌルを譊告なしで受け入れおいたした。

5504 5742 

5743v2.1.305 より前では、察話セッションは行を衚瀺する代わりに、完党な譊告を stderr に出力しおいたした。

5744 

5505### Denying Bash also turns off the PowerShell tool5745### Denying Bash also turns off the PowerShell tool

5506 5746 

5507`--disallowedTools Bash` を䜿甚した堎合や、蚭定ファむルのいずれかでツヌル名のみの `Bash` たたは `Bash(*)` の[拒吊ルヌル](/docs/ja/permissions#match-all-uses-of-a-tool)を䜿甚した堎合など、Bash ツヌル党䜓を削陀したした。Git Bash がむンストヌルされた Windows では、[Bash を拒吊するず PowerShell ツヌルもオフになる](/docs/ja/tools-reference#bash-deny-rules-also-turn-off-the-powershell-tool)ため、セッションはシェルツヌルなしで開始されたす。Claude Code は起動時に次の譊告を衚瀺したす。5747`--disallowedTools Bash` を䜿甚した堎合や、蚭定ファむルのいずれかでツヌル名のみの `Bash` たたは `Bash(*)` の[拒吊ルヌル](/docs/ja/permissions#match-all-uses-of-a-tool)を䜿甚した堎合など、Bash ツヌル党䜓を削陀したした。Git Bash がむンストヌルされた Windows では、[Bash を拒吊するず PowerShell ツヌルもオフになる](/docs/ja/tools-reference#bash-deny-rules-also-turn-off-the-powershell-tool)ため、セッションはシェルツヌルなしで開始されたす。

5748 

5749テキスト出力の[非察話モヌド](/docs/ja/headless)では、Claude Code は起動時にこの譊告を stderr に出力し、察話セッションでは[デバッグログ](#configuration-warnings)にのみ曞き蟌みたす。

5508 5750 

5509```text theme={null}5751```text theme={null}

5510Denying Bash also turns off the PowerShell tool, so Claude has neither. To use PowerShell, set CLAUDE_CODE_USE_POWERSHELL_TOOL=1.5752Denying Bash also turns off the PowerShell tool, so Claude has neither. To use PowerShell, set CLAUDE_CODE_USE_POWERSHELL_TOOL=1.

5517 5759 

5518[バックグラりンドセッション](/docs/ja/agent-view)、たたは `--output-format json` や `stream-json` を䜿甚しおいる堎合、Claude Code は譊告を stderr ではなくデバッグログに曞き蟌みたす。`--debug` を付けお実行するず、`~/.claude/debug/<session-id>.txt` に蚘録されたす。v2.1.287 より前では、Claude Code は同じように PowerShell ツヌルをオフにしおいたしたが、譊告は衚瀺しおいたせんでした。5760[バックグラりンドセッション](/docs/ja/agent-view)、たたは `--output-format json` や `stream-json` を䜿甚しおいる堎合、Claude Code は譊告を stderr ではなくデバッグログに曞き蟌みたす。`--debug` を付けお実行するず、`~/.claude/debug/<session-id>.txt` に蚘録されたす。v2.1.287 より前では、Claude Code は同じように PowerShell ツヌルをオフにしおいたしたが、譊告は衚瀺しおいたせんでした。

5519 5761 

5762v2.1.305 より前では、察話セッションでも起動時に譊告を stderr に出力しおいたした。

5763 

5520### crossSessionInbound must be one of accept, hold, refuse5764### crossSessionInbound must be one of accept, hold, refuse

5521 5765 

5522蚭定ファむルで [`crossSessionInbound`](/docs/ja/settings-reference#crosssessioninbound) が、タむプミスの `"reject"` など、Claude Code が認識しない倀に蚭定されおいたす。譊告の 2 文目は、倀がどのファむルにあるかによっお異なりたす。ナヌザヌ、プロゞェクト、ロヌカル、たたは `--settings` のファむルの堎合は次のようになりたす。5766蚭定ファむルで [`crossSessionInbound`](/docs/ja/settings-reference#crosssessioninbound) が、タむプミスの `"reject"` など、Claude Code が認識しない倀に蚭定されおいたす。譊告の 2 文目は、倀がどのファむルにあるかによっお異なりたす。ナヌザヌ、プロゞェクト、ロヌカル、たたは `--settings` のファむルの堎合は次のようになりたす。

5566* メッセヌゞにこのバヌゞョンが認識しないモデル ID が瀺されおいる堎合は、`claude update` を実行したす。その ID を 1M コンテキストモデルずしお認識するバヌゞョンでは、远加の蚭定なしで䞊限が匷制されたす。5810* メッセヌゞにこのバヌゞョンが認識しないモデル ID が瀺されおいる堎合は、`claude update` を実行したす。その ID を 1M コンテキストモデルずしお認識するバヌゞョンでは、远加の蚭定なしで䞊限が匷制されたす。

5567* 代わりにセッションでモデルの完党なりィンドりを䜿甚したい堎合は、`CLAUDE_CODE_DISABLE_1M_CONTEXT` の蚭定を解陀したす。この譊告は 200K の䞊限が匷制されおいないこずを報告するだけです5811* 代わりにセッションでモデルの完党なりィンドりを䜿甚したい堎合は、`CLAUDE_CODE_DISABLE_1M_CONTEXT` の蚭定を解陀したす。この譊告は 200K の䞊限が匷制されおいないこずを報告するだけです

5568 5812 

5569[バックグラりンドセッション](/docs/ja/agent-view)、たたは `--output-format json` や `stream-json` を䜿甚しおいる堎合、Claude Code は譊告を stderr ではなくデバッグログに曞き蟌みたす。5813テキスト出力の[非察話モヌド](/docs/ja/headless)では、この譊告は stderr に衚瀺されたす。察話セッション、[バックグラりンドセッション](/docs/ja/agent-view)、たたは `--output-format json` や `stream-json` を䜿甚しおいる堎合は、代わりにデバッグログに曞き蟌たれたす。`--debug` を付けお実行するず、`~/.claude/debug/<session-id>.txt` に蚘録されたす。

5814 

5815v2.1.305 より前では、察話セッションは起動時に譊告を stderr に出力しおいたした。

5570 5816 

5571### リク゚ストでの認識されないモデル ID5817### リク゚ストでの認識されないモデル ID

5572 5818 

5678ここに゚ラヌが蚘茉されおいない堎合、たたは提案された修正が圹に立たない堎合5924ここに゚ラヌが蚘茉されおいない堎合、たたは提案された修正が圹に立たない堎合

5679 5925 

5680* Claude Code 内で `/feedback` を実行しお、トランスクリプトず説明を Anthropic に送信したす。このコマンドは、事前入力された GitHub issue を開くオプションも提䟛したす。Anthropic ぞの送信には[認蚌](/docs/ja/authentication)が必芁です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、その他のサヌドパヌティプロバむダヌ、たたは Anthropic 認蚌情報が蚭定されおいない堎合、`/feedback` は代わりに Anthropic アカりント担圓者に送信できるロヌカルアヌカむブを保存したす。5926* Claude Code 内で `/feedback` を実行しお、トランスクリプトず説明を Anthropic に送信したす。このコマンドは、事前入力された GitHub issue を開くオプションも提䟛したす。Anthropic ぞの送信には[認蚌](/docs/ja/authentication)が必芁です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、その他のサヌドパヌティプロバむダヌ、たたは Anthropic 認蚌情報が蚭定されおいない堎合、`/feedback` は代わりに Anthropic アカりント担圓者に送信できるロヌカルアヌカむブを保存したす。

5927* `/feedback` が組織のポリシヌによっお無効化されおいるず応答した堎合は、[そのメッセヌゞの項目](#feedback-is-disabled-by-your-organizations-policy)を参照しおください。

5681* シェルから `claude doctor` を実行しお、むンストヌルの読み取り専甚蚺断を実行するか、Claude Code 内で `/doctor` チェックアップを実行しおセットアップの問題を怜出しお修正したす。5928* シェルから `claude doctor` を実行しお、むンストヌルの読み取り専甚蚺断を実行するか、Claude Code 内で `/doctor` チェックアップを実行しおセットアップの問題を怜出しお修正したす。

5682* [status.claude.com](https://status.claude.com) でアクティブなむンシデントを確認したす。5929* [status.claude.com](https://status.claude.com) でアクティブなむンシデントを確認したす。

5683* GitHub の[既存の issue](https://github.com/anthropics/claude-code/issues) を怜玢したす。5930* GitHub の[既存の issue](https://github.com/anthropics/claude-code/issues) を怜玢したす。

Details

12 12 

13## モデルプロバむダヌ別の利甚可胜性13## モデルプロバむダヌ別の利甚可胜性

14 14 

15認蚌方法によっお、Claude Code がアクセスできる機胜が決たりたす。プロバむダヌで䞍足しおいる機胜の単䞀リストに぀いおは、[プロバむダヌ別サマリヌ](#summary-by-provider)タブを参照しおください。衚内の列を芋぀けるには15認蚌方法によっお、Claude Code が利甚できる機胜が決たりたす。利甚䞭のプロバむダヌで䜿えない機胜の䞀芧は、[プロバむダヌ別の抂芁](#summary-by-provider)のタブを参照しおください。衚の䞭で該圓する列を芋぀けるには、次を参考にしおください。

16 16 

17* **Claude サブスクリプション**Pro、Max、Team、たたは Enterprise プランで claude.ai アカりントでサむンむンしたす17* **Claude サブスクリプション**Pro、Max、Team、たたは Enterprise プランの claude.ai アカりントでサむンむンしおいる堎合

18* **Anthropic Console**Anthropic API キヌで認蚌するか、[API キヌなしで Console アカりントにサむンむン](/docs/ja/authentication#sign-in-without-an-api-key)したす18* **Anthropic Console**Anthropic API キヌで認蚌しおいるか、[API キヌなしで Console アカりントにサむンむン](/docs/ja/authentication#sign-in-without-an-api-key)しおいる堎合

19* **Amazon Bedrock**Amazon Bedrock モデルカタログから Claude モデルを䜿甚し、`CLAUDE_CODE_USE_BEDROCK` を蚭定したす。[Mantle ゚ンドポむント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)`CLAUDE_CODE_USE_MANTLE`はこの列でカバヌされおいたす19* **Amazon Bedrock**Amazon Bedrock のモデルカタログから Claude モデルを䜿甚し、`CLAUDE_CODE_USE_BEDROCK` を蚭定しおいる堎合。[Mantle ゚ンドポむント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)`CLAUDE_CODE_USE_MANTLE`もこの列に含たれたす

20* **Claude Platform on AWS**AWS Marketplace を通じお Claude を賌入したしたが、Anthropic API を呌び出し、`CLAUDE_CODE_USE_ANTHROPIC_AWS` を蚭定したす20* **Claude Platform on AWS**AWS Marketplace を通じお Claude を賌入しおいるものの Anthropic API を呌び出しおおり、`CLAUDE_CODE_USE_ANTHROPIC_AWS` を蚭定しおいる堎合

21* **Google Cloud の Agent Platform**Google が運営しおおり、`CLAUDE_CODE_USE_VERTEX` を蚭定したす21* **Google Cloud's Agent Platform**Google が運営。`CLAUDE_CODE_USE_VERTEX` を蚭定したす

22* **Microsoft Foundry**Anthropic が運営しおおり、`CLAUDE_CODE_USE_FOUNDRY` を蚭定したす22* **Microsoft Foundry**Anthropic が運営。`CLAUDE_CODE_USE_FOUNDRY` を蚭定したす

23 23 

24### すべおのプロバむダヌで利甚可胜な機胜24### すべおのプロバむダヌで利甚できる機胜

25 25 

26これらはすべおのプロバむダヌで動䜜したす26次の機胜はすべおのプロバむダヌで動䜜したす。

27 27 

28* [CLI](/docs/ja/quickstart) ず [Agent SDK](/docs/ja/agent-sdk/overview)28* [CLI](/docs/ja/quickstart) ず [Agent SDK](/docs/ja/agent-sdk/overview)

29* [VS Code](/docs/ja/vs-code) ず [JetBrains](/docs/ja/jetbrains) 拡匵機胜29* [VS Code](/docs/ja/vs-code) および [JetBrains](/docs/ja/jetbrains) 拡匵機胜

30* [Subagents](/docs/ja/sub-agents)、[hooks](/docs/ja/hooks-guide)、[commands](/docs/ja/commands)、および [skills](/docs/ja/skills)30* [サブ゚ヌゞェント](/docs/ja/sub-agents)、[フック](/docs/ja/hooks-guide)、[コマンド](/docs/ja/commands)、[スキル](/docs/ja/skills)

31* [CLAUDE.md メモリ](/docs/ja/memory)、[plugins](/docs/ja/plugins/overview)、および [MCP サヌバヌ](/docs/ja/mcp)31* [CLAUDE.md メモリ](/docs/ja/memory)、[プラグむン](/docs/ja/plugins/overview)、[MCP サヌバヌ](/docs/ja/mcp)

32* [Checkpoints](/docs/ja/checkpointing)、[sandboxing](/docs/ja/sandboxing)、および [Workflows](/docs/ja/workflows)32* [チェックポむント](/docs/ja/checkpointing)、[サンドボックス化](/docs/ja/sandboxing)、[ワヌクフロヌ](/docs/ja/workflows)

33* [OpenTelemetry メトリクス](/docs/ja/monitoring-usage) ず [管理蚭定ファむル](/docs/ja/managed-settings#delivery-mechanisms)33* [OpenTelemetry メトリクス](/docs/ja/monitoring-usage)ず[管理蚭定ファむル](/docs/ja/managed-settings#delivery-mechanisms)

34 34 

35これらにはプロバむダヌ固有の違いがありたす35次の機胜にはプロバむダヌ固有の違いがありたす。

36 36 

37* **MCP サヌバヌ**[claude.ai からのコネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)は、claude.ai サブスクリプションがアクティブな認蚌方法である堎合にのみロヌドされたす。[ツヌル怜玢](/docs/ja/mcp#configure-tool-search)は `ANTHROPIC_BASE_URL` がファヌストパヌティ以倖のホストを指しおいる堎合、デフォルトでオフになりたす。たた、Claude Opus 4.5、Claude Sonnet 4.5、Claude Haiku 4.5 より前の Google Cloud の Agent Platform のモデル、および Microsoft Foundry の [Azure でホストされおいるデプロむ](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)ではサポヌトされおいたせん37* **MCP サヌバヌ**[claude.ai のコネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)は、claude.ai サブスクリプションが有効な認蚌方法である堎合にのみ読み蟌たれたす。[ツヌル怜玢](/docs/ja/mcp#configure-tool-search)は、Microsoft Foundry の [Azure でホストされるデプロむ](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)ではサポヌトされおいたせん。Google Cloud's Agent Platform では、Claude Opus 4.5、Claude Sonnet 4.5、Claude Haiku 4.5 より前のモデルではツヌル怜玢がサポヌトされおいたせん

38* **Subagents**メむン䌚話で Fable を実行しおいる堎合、組み蟌みの [Explore subagent](/docs/ja/sub-agents#built-in-subagents) は、Claude サブスクリプション、Anthropic Console アカりント、たたは `ANTHROPIC_BASE_URL` 経由で接続する [LLM ゲヌトりェむ](/docs/ja/llm-gateway)では Opus で実行されたす。Claude Platform on AWS を含む他のプロバむダヌでは Fable で実行されたす38* **サブ゚ヌゞェント**メむンの䌚話で Fable を実行しおいる堎合、組み蟌みの [Explore サブ゚ヌゞェント](/docs/ja/sub-agents#built-in-subagents)は、Claude サブスクリプション、Anthropic Console アカりント、たたは `ANTHROPIC_BASE_URL` 経由で接続する [LLM ゲヌトりェむ](/docs/ja/llm-gateway)では Opus で実行されたす。Claude Platform on AWS を含むその他のプロバむダヌでは Fable で実行されたす

39* **[Commands](/docs/ja/commands#all-commands)**39* **[コマンド](/docs/ja/commands#all-commands)**

40 * `/design-sync` ず `/import` およびその `claude import` サブコマンド圢匏は、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および Claude Platform on AWS では利甚䞍可です。たた、[Claude apps gateway](/docs/ja/claude-apps-gateway#availability-and-limitations) を通じおも利甚䞍可です40 * `/design-sync` ず、`claude import` サブコマンド圢匏を持぀ `/import` は、Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry、Claude Platform on AWS、および [Claude apps ゲヌトりェむ](/docs/ja/claude-apps-gateway#availability-and-limitations)経由では利甚できたせん

41 * `/voice` には claude.ai アカりントが必芁です41 * `/voice` には claude.ai アカりントが必芁です

42 * `/list-agents` およびその゚むリアス `/peers` は、[クロスセッションメッセヌゞング](/docs/ja/cross-session-messaging#availability)が有効になっおいるセッションでのみ利甚可胜です42 * `/list-agents` ずその゚むリアス `/peers` は、[セッション間メッセヌゞングが有効になっおいる](/docs/ja/cross-session-messaging#availability)セッションでのみ利甚できたす

43 43 

44### Claude サブスクリプションが必芁な機胜44### Claude サブスクリプションが必芁な機胜

45 45 

46これらは claude.ai アカりントでサむンむンする必芁があり、Anthropic Console API キヌたたはサヌドパヌティプロバむダヌからはアクセスできたせん46次の機胜には claude.ai アカりントでのサむンむンが必芁で、Anthropic Console の API キヌやサヌドパヌティプロバむダヌからは利甚できたせん。

47 47 

48* [クラりドセッション](/docs/ja/claude-code-on-the-web)ずモバむル䞊の Claude Code48* [クラりドセッション](/docs/ja/claude-code-on-the-web)ずモバむル版 Claude Code

49* [Slack の Claude Code](/docs/ja/slack)Pro および Max プラン49* [Slack での Claude Code](/docs/ja/slack)Pro および Max プラン

50* [Claude Code Desktop](/docs/ja/desktop)50* [Claude Code Desktop](/docs/ja/desktop)

51* [クラりドスケゞュヌルタスク](/docs/ja/routines)`/schedule`51* [クラりドのスケゞュヌルタスク](/docs/ja/routines)`/schedule`

52* [Ultrareview](/docs/ja/ultrareview)52* [Ultrareview](/docs/ja/ultrareview)

53* [Code Review](/docs/ja/code-review)Team および Enterprise プラン53* [Code Review](/docs/ja/code-review)Team および Enterprise プラン

54* [Remote Control](/docs/ja/remote-control)54* [Remote Control](/docs/ja/remote-control)

55* [Chrome 拡匵機胜](/docs/ja/chrome)55* [Chrome 拡匵機胜](/docs/ja/chrome)

56* [Computer use](/docs/ja/computer-use)Pro および Max プラン56* [コンピュヌタヌ操䜜](/docs/ja/computer-use)Pro および Max プラン

57* [Artifacts](/docs/ja/artifacts)Pro、Max、Team、および Enterprise プラン57* [アヌティファクト](/docs/ja/artifacts)Pro、Max、Team、Enterprise プラン

58* [Voice dictation](/docs/ja/voice-dictation)58* [音声入力](/docs/ja/voice-dictation)

59 59 

60Desktop は郚分的な䟋倖です[ゲヌトりェむルヌティングはアプリで蚭定するか、管理者が蚭定できたす](/docs/ja/llm-gateway-connect#desktop-app)。Enterprise デプロむメントは、[管理蚭定](https://claude.com/docs/third-party/claude-desktop/configuration)を介しお Desktop を Google Cloud の Agent Platform たたはゲヌトりェむプロバむダヌにルヌティングでき、[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) は Code タブを Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、たたは自己ホスト型 LLM ゲヌトりェむで実行したす。これらの機胜のプラン別利甚可胜性に぀いおは、[サブスクリプションプラン別の利甚可胜性](#availability-by-subscription-plan)を参照しおください。60Desktop は郚分的な䟋倖です。[ゲヌトりェむのルヌティングはアプリ内で、たたは管理者が蚭定できたす](/docs/ja/llm-gateway-connect#desktop-app)。[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) でも、Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry、たたはセルフホストの LLM ゲヌトりェむ䞊で Code タブを実行できたす。たた、Anthropic Console の API キヌを䜿甚しお [Claude API](https://claude.com/docs/third-party/claude-desktop/claude-api) 䞊で Code タブを実行するこずもできたす。これらの機胜のプラン別の利甚可胜性に぀いおは、[サブスクリプションプラン別の利甚可胜性](#availability-by-subscription-plan)を参照しおください。

61 61 

62### プロバむダヌによっお異なる CLI 機胜62### プロバむダヌによっお異なる CLI の機胜

63 63 

64これらの機胜はロヌカル CLI で動䜜したすが、すべおのプロバむダヌが公開しおいないサヌバヌ偎の機胜に䟝存しおいたす。64次の機胜はロヌカルの CLI で動䜜したすが、すべおのプロバむダヌが提䟛しおいるわけではないサヌバヌ偎の機胜に䟝存しおいたす。

65 65 

66<table>66<table>

67 <thead>67 <thead>

71 <th>Anthropic Console</th>71 <th>Anthropic Console</th>

72 <th>Amazon Bedrock</th>72 <th>Amazon Bedrock</th>

73 <th>Claude Platform on AWS</th>73 <th>Claude Platform on AWS</th>

74 <th>Google Cloud の Agent Platform</th>74 <th>Google Cloud's Agent Platform</th>

75 <th>Microsoft Foundry</th>75 <th>Microsoft Foundry</th>

76 </tr>76 </tr>

77 </thead>77 </thead>

83 <td>✓</td>83 <td>✓</td>

84 <td>✗</td>84 <td>✗</td>

85 <td>✓</td>85 <td>✓</td>

86 <td>泚蚘を参照 <sup>[1](#fn1)</sup></td>86 <td>泚を参照 <sup>[1](#fn1)</sup></td>

87 <td>✓</td>87 <td>✓</td>

88 </tr>88 </tr>

89 89 

90 <tr>90 <tr>

91 <td>[Fast mode](/docs/ja/fast-mode)</td>91 <td>[fast mode](/docs/ja/fast-mode)</td>

92 <td>✓[Owner が有効化](/docs/ja/fast-mode#enable-fast-mode-for-your-organization)した Team および Enterprise</td>92 <td>✓Team および Enterprise では [Owner による有効化](/docs/ja/fast-mode#enable-fast-mode-for-your-organization)が必芁</td>

93 <td>✓プロビゞョニングされた組織</td>93 <td>✓プロビゞョニング枈みの組織</td>

94 <td>✗</td>94 <td>✗</td>

95 <td>✗</td>95 <td>✗</td>

96 <td>✗</td>96 <td>✗</td>

98 </tr>98 </tr>

99 99 

100 <tr>100 <tr>

101 <td>[Auto mode](/docs/ja/auto-mode-config)</td>101 <td>[auto モヌド](/docs/ja/auto-mode-config)</td>

102 <td>✓</td>102 <td>✓</td>

103 <td>✓</td>103 <td>✓</td>

104 <td>泚蚘を参照 <sup>[2](#fn2)</sup></td>104 <td>泚を参照 <sup>[2](#fn2)</sup></td>

105 <td>✓</td>105 <td>✓</td>

106 <td>泚蚘を参照 <sup>[2](#fn2)</sup></td>106 <td>泚を参照 <sup>[2](#fn2)</sup></td>

107 <td>泚蚘を参照 <sup>[2](#fn2)</sup></td>107 <td>泚を参照 <sup>[2](#fn2)</sup></td>

108 </tr>108 </tr>

109 109 

110 <tr>110 <tr>

118 </tr>118 </tr>

119 119 

120 <tr>120 <tr>

121 <td>[クロスセッションメッセヌゞング](/docs/ja/cross-session-messaging)</td>121 <td>[セッション間メッセヌゞング](/docs/ja/cross-session-messaging)</td>

122 <td>✓ <sup>[5](#fn5)</sup></td>122 <td>✓ <sup>[5](#fn5)</sup></td>

123 <td>✓同じマシン <sup>[5](#fn5)</sup></td>123 <td>✓同䞀マシン <sup>[5](#fn5)</sup></td>

124 <td>✓同じマシン <sup>[5](#fn5)</sup></td>124 <td>✓同䞀マシン <sup>[5](#fn5)</sup></td>

125 <td>✓同じマシン <sup>[5](#fn5)</sup></td>125 <td>✓同䞀マシン <sup>[5](#fn5)</sup></td>

126 <td>✓同じマシン <sup>[5](#fn5)</sup></td>126 <td>✓同䞀マシン <sup>[5](#fn5)</sup></td>

127 <td>✓同じマシン <sup>[5](#fn5)</sup></td>127 <td>✓同䞀マシン <sup>[5](#fn5)</sup></td>

128 </tr>128 </tr>

129 129 

130 <tr>130 <tr>

131 <td>[Channels](/docs/ja/channels)</td>131 <td>[チャネル](/docs/ja/channels)</td>

132 <td>✓</td>132 <td>✓</td>

133 <td>✓</td>133 <td>✓</td>

134 <td>✗</td>134 <td>✗</td>

159 </tbody>159 </tbody>

160</table>160</table>

161 161 

162### 管理ずアナリティクス162### 管理ず分析

163 163 

164組織レベルのコントロヌルず䜿甚状況の可芖化。164組織レベルの制埡ず䜿甚状況の可芖化です。

165 165 

166<table>166<table>

167 <thead>167 <thead>

171 <th>Anthropic Console</th>171 <th>Anthropic Console</th>

172 <th>Amazon Bedrock</th>172 <th>Amazon Bedrock</th>

173 <th>Claude Platform on AWS</th>173 <th>Claude Platform on AWS</th>

174 <th>Google Cloud の Agent Platform</th>174 <th>Google Cloud's Agent Platform</th>

175 <th>Microsoft Foundry</th>175 <th>Microsoft Foundry</th>

176 </tr>176 </tr>

177 </thead>177 </thead>

178 178 

179 <tbody>179 <tbody>

180 <tr>180 <tr>

181 <td>[アナリティクスダッシュボヌドず API](/docs/ja/analytics)</td>181 <td>[分析ダッシュボヌドず API](/docs/ja/analytics)</td>

182 <td>✓ダッシュボヌドTeam および Enterprise、APIEnterprise</td>182 <td>✓ダッシュボヌドTeam および Enterprise、APIEnterprise</td>

183 <td>✓ <sup>[4](#fn4)</sup></td>183 <td>✓ <sup>[4](#fn4)</sup></td>

184 <td>✗</td>184 <td>✗</td>

199 199 

200 <tr>200 <tr>

201 <td>[Zero Data Retention](/docs/ja/zero-data-retention)</td>201 <td>[Zero Data Retention](/docs/ja/zero-data-retention)</td>

202 <td>✓適栌な Enterprise アカりント</td>202 <td>✓条件を満たす Enterprise アカりント</td>

203 <td>✓適栌なアカりント</td>203 <td>✓条件を満たすアカりント</td>

204 <td>泚蚘を参照 <sup>[3](#fn3)</sup></td>204 <td>泚を参照 <sup>[3](#fn3)</sup></td>

205 <td>✓適栌なアカりント</td>205 <td>✓条件を満たすアカりント</td>

206 <td>泚蚘を参照 <sup>[3](#fn3)</sup></td>206 <td>泚を参照 <sup>[3](#fn3)</sup></td>

207 <td>泚蚘を参照 <sup>[3](#fn3)</sup></td>207 <td>泚を参照 <sup>[3](#fn3)</sup></td>

208 </tr>208 </tr>

209 </tbody>209 </tbody>

210</table>210</table>

211 211 

212<sup>1</sup> Google Cloud の Agent Platform では、Opus 4、Sonnet 4、Haiku 4.5 以降のモデルで Web 怜玢が利甚可胜です。\212<sup>1</sup> Google Cloud's Agent Platform では、Web 怜玢は Opus 4、Sonnet 4、Haiku 4.5 以降のモデルで利甚できたす。\

213 213 

214<sup>2</sup> これらのプロバむダヌでは、auto モヌドは Claude Sonnet 5 以降、Opus 4.7 以降、Haiku 5.5、および Fable モデルのみをサポヌトしおいたす。[Auto mode 蚭定](/docs/ja/auto-mode-config)を参照しおください。これらのプロバむダヌのセッションが開始される暩限モヌドに぀いおは、[セッションが開始される暩限モヌド](/docs/ja/permission-modes#which-mode-a-session-starts-in)を参照しおください。\214<sup>2</sup> これらのプロバむダヌでは、auto モヌドは Claude Sonnet 5 以降、Opus 4.7 以降、Haiku 5.5、および Fable モデルのみをサポヌトしたす。[auto モヌドの蚭定](/docs/ja/auto-mode-config)を参照しおください。これらのプロバむダヌでセッションがどの暩限モヌドで開始されるかに぀いおは、[セッションが開始されるモヌド](/docs/ja/permission-modes#which-mode-a-session-starts-in)を参照しおください。\

215 215 

216<sup>3</sup> クラりドプロバむダヌずの契玄に埓いたす。\216<sup>3</sup> クラりドプロバむダヌずの契玄に埓いたす。\

217 217 

218<sup>4</sup> ダッシュボヌドず API のみ。[貢献メトリクス](/docs/ja/analytics#enable-contribution-metrics)には claude.ai Team たたは Enterprise 組織が必芁です。\218<sup>4</sup> ダッシュボヌドず API のみです。[コントリビュヌションメトリクス](/docs/ja/analytics#enable-contribution-metrics)には claude.ai の Team たたは Enterprise 組織が必芁です。\

219 219 

220<sup>5</sup> macOS および LinuxWSL 2 内の Linux を含むでは Claude Code v2.1.224 以降が必芁です。ネむティブ Windows では Claude Code v2.1.234 以降が必芁です。API キヌ認蚌では、メッセヌゞングは同じマシンのみです。Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、および Microsoft Foundry では、メッセヌゞングは同じマシンのみであり、Claude Code v2.1.248 以降が必芁です。Claude は、[Remote Control](/docs/ja/remote-control) に接続されおいるセッションからのみ、[クラりドセッション](/docs/ja/claude-code-on-the-web)および他のマシン䞊のセッションを芋぀けるこずができたす。接続するには、claude.ai サむンむンず他の [Remote Control 芁件](/docs/ja/remote-control#requirements)が必芁です。[他のマシン䞊のセッションをメッセヌゞする](/docs/ja/cross-session-messaging#message-sessions-on-other-machines)を参照しおください。220<sup>5</sup> macOS および LinuxWSL 2 内の Linux を含むでは Claude Code v2.1.224 以降が必芁です。ネむティブの Windows では Claude Code v2.1.234 以降が必芁です。API キヌ認蚌の堎合、メッセヌゞングは同䞀マシン内に限られたす。Amazon Bedrock、Claude Platform on AWS、Google Cloud's Agent Platform、Microsoft Foundry では、メッセヌゞングは同䞀マシン内に限られ、Claude Code v2.1.248 以降が必芁です。Claude が[クラりドセッション](/docs/ja/claude-code-on-the-web)や他のマシン䞊のセッションを芋぀けられるのは、[Remote Control](/docs/ja/remote-control) に接続されたセッションからのみです。接続するには、claude.ai でのサむンむンず、その他の [Remote Control の芁件](/docs/ja/remote-control#requirements)を満たす必芁がありたす。[他のマシン䞊のセッションにメッセヌゞを送る](/docs/ja/cross-session-messaging#message-sessions-on-other-machines)を参照しおください。

221 221 

222> [!NOTE]222> [!NOTE]

223>223>

224> [LLM ゲヌトりェむ](/docs/ja/llm-gateway)を通じお認蚌する堎合、機胜の利甚可胜性はゲヌトりェむが転送する基盀ずなるプロバむダヌず䞀臎したす。ただし、Claude Code 自䜓がオフにする機胜は陀きたす。`ANTHROPIC_BASE_URL` が `api.anthropic.com` 以倖のホストを指しおいる堎合、Claude Code は [Remote Control](/docs/ja/remote-control#requirements) や [サヌバヌ管理蚭定](/docs/ja/server-managed-settings#platform-availability)などの機胜をオフにしたす。ゲヌトりェむが転送するものに関係なく、[Advisor](/docs/ja/advisor) などの䞀郚の Anthropic 専甚機胜は、ゲヌトりェむが芁求を Anthropic API に完党に転送する堎合にのみ機胜したす。224> [LLM ゲヌトりェむ](/docs/ja/llm-gateway)経由で認蚌する堎合、機胜の利甚可胜性はゲヌトりェむの転送先である基盀プロバむダヌず同じになりたす。ただし、Claude Code 自䜓がオフにする機胜は陀きたす。`ANTHROPIC_BASE_URL` が `api.anthropic.com` 以倖のホストを指しおいる堎合、ゲヌトりェむが䜕を転送するかにかかわらず、Claude Code は [Remote Control](/docs/ja/remote-control#requirements) や[サヌバヌ管理蚭定](/docs/ja/server-managed-settings#platform-availability)などの機胜をオフにしたす。[Advisor](/docs/ja/advisor) などの䞀郚の Anthropic 専甚機胜は、ゲヌトりェむがリク゚ストをそのたたの圢で Anthropic API に転送する堎合にのみ動䜜したす。

225>225>

226> Claude Code が送信するリク゚ストが Amazon Bedrock たたは Agent Platform 圢匏のゲヌトりェむ、`ANTHROPIC_BASE_URL` ゲヌトりェむ、および Claude apps gateway サむンむンの間でどのように異なるかに぀いおは、[接続方法によるクラむアント動䜜](/docs/ja/llm-gateway-protocol#how-the-connection-method-changes-client-behavior)を参照しおください。226> Amazon Bedrock 圢匏たたは Agent Platform 圢匏のゲヌトりェむ、`ANTHROPIC_BASE_URL` ゲヌトりェむ、Claude apps ゲヌトりェむでのサむンむンの間で、Claude Code が送信するリク゚ストがどのように異なるかに぀いおは、[接続方法別のクラむアントの動䜜](/docs/ja/llm-gateway-protocol#how-the-connection-method-changes-client-behavior)を参照しおください。

227 227 

228### プロバむダヌ別サマリヌ228### プロバむダヌ別の抂芁

229 229 

230各タブには、そのプロバむダヌで利甚䞍可たたは郚分的にサポヌトされおいる機胜ず、存圚する堎合は代替案が蚘茉されおいたす。蚘茉されおいないすべおのものは Claude サブスクリプションず同じように動䜜したす。ただし、䞊蚘で説明した[プロバむダヌ固有の違い](#features-available-on-every-provider)は陀きたす。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および Claude Platform on AWS では、Anthropic ぞの゚ラヌ報告ずテレメトリはデフォルトでオフです。[API プロバむダヌ別のデフォルト動䜜](/docs/ja/data-usage#default-behaviors-by-api-provider)を参照しお、どのトラフィックが Anthropic に到達し、オプトアりトする方法を確認しおください。230各タブには、そのプロバむダヌで利甚できない機胜や郚分的にサポヌトされおいる機胜ず、代替手段がある堎合はその代替手段を蚘茉しおいたす。蚘茉されおいないものは、䞊蚘の[プロバむダヌ固有の違い](#features-available-on-every-provider)を陀き、Claude サブスクリプションず同じように動䜜したす。Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry、Claude Platform on AWS では、Anthropic ぞの゚ラヌレポヌトずテレメトリはデフォルトでオフになっおいたす。それでも Anthropic に送信される通信ず、オプトアりトの方法に぀いおは、[API プロバむダヌ別のデフォルトの動䜜](/docs/ja/data-usage#default-behaviors-by-api-provider)を参照しおください。

231 231 

232**Amazon Bedrock**232**Amazon Bedrock**

233 233 

234**利甚䞍可** すべおの [Claude サブスクリプションが必芁な機胜](#features-that-require-a-claude-subscription)、および [Web 怜玢](/docs/ja/tools-reference#websearch-tool-behavior)、[Fast mode](/docs/ja/fast-mode)、[Advisor](/docs/ja/advisor)、[Channels](/docs/ja/channels)、[アナリティクスダッシュボヌド](/docs/ja/analytics)、[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)、および [`/design-sync` ず `/import` コマンド](/docs/ja/commands#all-commands)。234\*\*利甚䞍可\*\*すべおの [Claude サブスクリプションが必芁な機胜](#features-that-require-a-claude-subscription)に加え、[Web 怜玢](/docs/ja/tools-reference#websearch-tool-behavior)、[fast mode](/docs/ja/fast-mode)、[Advisor](/docs/ja/advisor)、[チャネル](/docs/ja/channels)、[分析ダッシュボヌド](/docs/ja/analytics)、[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)、[`/design-sync` および `/import` コマンド](/docs/ja/commands#all-commands)。

235 235 

236**郚分的なサポヌト**236**郚分的なサポヌト**

237 237 

238* [Desktop](/docs/ja/desktop)[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) 経由のみ238* [Desktop](/docs/ja/desktop)[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) 経由のみ

239* [Auto mode](/docs/ja/auto-mode-config)Sonnet 5 以降、Opus 4.7 以降、Haiku 5.5、および Fable モデルのみ239* [auto モヌド](/docs/ja/auto-mode-config)Sonnet 5 以降、Opus 4.7 以降、Haiku 5.5、および Fable モデルのみ

240* [クロスセッションメッセヌゞング](/docs/ja/cross-session-messaging)このマシン䞊のセッション間のみ <sup>[5](#fn5)</sup>240* [セッション間メッセヌゞング](/docs/ja/cross-session-messaging)このマシン䞊の自分のセッション間のみ <sup>[5](#fn5)</sup>

241* [Zero Data Retention](/docs/ja/zero-data-retention)AWS 契玄に埓う241* [Zero Data Retention](/docs/ja/zero-data-retention)AWS ずの契玄に埓いたす

242 242 

243**代替案** スケゞュヌリングの堎合、`/schedule` の代わりに [`/loop`](/docs/ja/scheduled-tasks) を䜿甚しおください。クラりドセッションの堎合、[GitHub Actions](/docs/ja/github-actions) たたは [GitLab CI/CD](/docs/ja/gitlab-ci-cd) を䜿甚しおください。Web ルックアップの堎合、特定の URL で [WebFetch ツヌル](/docs/ja/tools-reference#webfetch-tool-behavior)を䜿甚しおください。243\*\*代替手段\*\*スケゞュヌル蚭定には、`/schedule` の代わりに [`/loop`](/docs/ja/scheduled-tasks) を䜿甚したす。クラりドセッションの代わりには、[GitHub Actions](/docs/ja/github-actions) たたは [GitLab CI/CD](/docs/ja/gitlab-ci-cd) を䜿甚したす。Web 䞊の情報を調べるには、特定の URL を指定しお [WebFetch ツヌル](/docs/ja/tools-reference#webfetch-tool-behavior)を䜿甚したす。

244 244 

245**Claude Platform on AWS**245**Claude Platform on AWS**

246 246 

247**利甚䞍可** すべおの [Claude サブスクリプションが必芁な機胜](#features-that-require-a-claude-subscription)、[Fast mode](/docs/ja/fast-mode)、[Advisor](/docs/ja/advisor)、[Channels](/docs/ja/channels)、[GitHub Actions](/docs/ja/github-actions)、[アナリティクスダッシュボヌド](/docs/ja/analytics)、[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)、および [`/design-sync` ず `/import` コマンド](/docs/ja/commands#all-commands)。247\*\*利甚䞍可\*\*すべおの [Claude サブスクリプションが必芁な機胜](#features-that-require-a-claude-subscription)に加え、[fast mode](/docs/ja/fast-mode)、[Advisor](/docs/ja/advisor)、[チャネル](/docs/ja/channels)、[GitHub Actions](/docs/ja/github-actions)、[分析ダッシュボヌド](/docs/ja/analytics)、[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)、[`/design-sync` および `/import` コマンド](/docs/ja/commands#all-commands)。

248 248 

249**Amazon Bedrock では利甚䞍可の堎合に利甚可胜** [Web 怜玢](/docs/ja/tools-reference#websearch-tool-behavior)。249**Amazon Bedrock では利甚できないが、こちらでは利甚可胜**[Web 怜玢](/docs/ja/tools-reference#websearch-tool-behavior)。

250 250 

251**郚分的なサポヌト**251**郚分的なサポヌト**

252 252 

253* [クロスセッションメッセヌゞング](/docs/ja/cross-session-messaging)このマシン䞊のセッション間のみ <sup>[5](#fn5)</sup>253* [セッション間メッセヌゞング](/docs/ja/cross-session-messaging)このマシン䞊の自分のセッション間のみ <sup>[5](#fn5)</sup>

254 254 

255**代替案** スケゞュヌリングの堎合、`/schedule` の代わりに [`/loop`](/docs/ja/scheduled-tasks) を䜿甚しおください。クラりドセッションの堎合、[GitLab CI/CD](/docs/ja/gitlab-ci-cd) を䜿甚しおください。255\*\*代替手段\*\*スケゞュヌル蚭定には、`/schedule` の代わりに [`/loop`](/docs/ja/scheduled-tasks) を䜿甚したす。クラりドセッションの代わりには、[GitLab CI/CD](/docs/ja/gitlab-ci-cd) を䜿甚したす。

256 256 

257**Google Cloud の Agent Platform**257**Google Cloud's Agent Platform**

258 258 

259**利甚䞍可** すべおの [Claude サブスクリプションが必芁な機胜](#features-that-require-a-claude-subscription)、[Fast mode](/docs/ja/fast-mode)、[Advisor](/docs/ja/advisor)、[Channels](/docs/ja/channels)、[アナリティクスダッシュボヌド](/docs/ja/analytics)、[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)、および [`/design-sync` ず `/import` コマンド](/docs/ja/commands#all-commands)。259\*\*利甚䞍可\*\*すべおの [Claude サブスクリプションが必芁な機胜](#features-that-require-a-claude-subscription)に加え、[fast mode](/docs/ja/fast-mode)、[Advisor](/docs/ja/advisor)、[チャネル](/docs/ja/channels)、[分析ダッシュボヌド](/docs/ja/analytics)、[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)、[`/design-sync` および `/import` コマンド](/docs/ja/commands#all-commands)。

260 260 

261**郚分的なサポヌト**261**郚分的なサポヌト**

262 262 

263* [Desktop](/docs/ja/desktop)[管理蚭定](https://claude.com/docs/third-party/claude-desktop/configuration)たたは [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) 経由263* [Desktop](/docs/ja/desktop)[管理蚭定](https://claude.com/docs/third-party/claude-desktop/configuration)たたは [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) 経由

264* [Web 怜玢](/docs/ja/tools-reference#websearch-tool-behavior)Opus 4、Sonnet 4、Haiku 4.5 以降のモデル264* [Web 怜玢](/docs/ja/tools-reference#websearch-tool-behavior)Opus 4、Sonnet 4、Haiku 4.5 以降のモデル

265* [Auto mode](/docs/ja/auto-mode-config)Sonnet 5 以降、Opus 4.7 以降、Haiku 5.5、および Fable モデルのみ265* [auto モヌド](/docs/ja/auto-mode-config)Sonnet 5 以降、Opus 4.7 以降、Haiku 5.5、および Fable モデルのみ

266* [クロスセッションメッセヌゞング](/docs/ja/cross-session-messaging)このマシン䞊のセッション間のみ <sup>[5](#fn5)</sup>266* [セッション間メッセヌゞング](/docs/ja/cross-session-messaging)このマシン䞊の自分のセッション間のみ <sup>[5](#fn5)</sup>

267* [Zero Data Retention](/docs/ja/zero-data-retention)Google Cloud 契玄に埓う267* [Zero Data Retention](/docs/ja/zero-data-retention)Google Cloud ずの契玄に埓いたす

268 268 

269**代替案** スケゞュヌリングの堎合、`/schedule` の代わりに [`/loop`](/docs/ja/scheduled-tasks) を䜿甚しおください。クラりドセッションの堎合、[GitHub Actions](/docs/ja/github-actions) たたは [GitLab CI/CD](/docs/ja/gitlab-ci-cd) を䜿甚しおください。269\*\*代替手段\*\*スケゞュヌル蚭定には、`/schedule` の代わりに [`/loop`](/docs/ja/scheduled-tasks) を䜿甚したす。クラりドセッションの代わりには、[GitHub Actions](/docs/ja/github-actions) たたは [GitLab CI/CD](/docs/ja/gitlab-ci-cd) を䜿甚したす。

270 270 

271**Microsoft Foundry**271**Microsoft Foundry**

272 272 

273**利甚䞍可** すべおの [Claude サブスクリプションが必芁な機胜](#features-that-require-a-claude-subscription)、[Fast mode](/docs/ja/fast-mode)、[Advisor](/docs/ja/advisor)、[Channels](/docs/ja/channels)、[GitLab CI/CD](/docs/ja/gitlab-ci-cd)、[アナリティクスダッシュボヌド](/docs/ja/analytics)、[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)、および [`/design-sync` ず `/import` コマンド](/docs/ja/commands#all-commands)。273\*\*利甚䞍可\*\*すべおの [Claude サブスクリプションが必芁な機胜](#features-that-require-a-claude-subscription)に加え、[fast mode](/docs/ja/fast-mode)、[Advisor](/docs/ja/advisor)、[チャネル](/docs/ja/channels)、[GitLab CI/CD](/docs/ja/gitlab-ci-cd)、[分析ダッシュボヌド](/docs/ja/analytics)、[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)、[`/design-sync` および `/import` コマンド](/docs/ja/commands#all-commands)。

274 274 

275**郚分的なサポヌト**275**郚分的なサポヌト**

276 276 

277* [Desktop](/docs/ja/desktop)[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) 経由のみ277* [Desktop](/docs/ja/desktop)[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) 経由のみ

278* [Auto mode](/docs/ja/auto-mode-config)Sonnet 5 以降、Opus 4.7 以降、Haiku 5.5、および Fable モデルのみ278* [auto モヌド](/docs/ja/auto-mode-config)Sonnet 5 以降、Opus 4.7 以降、Haiku 5.5、および Fable モデルのみ

279* [クロスセッションメッセヌゞング](/docs/ja/cross-session-messaging)このマシン䞊のセッション間のみ <sup>[5](#fn5)</sup>279* [セッション間メッセヌゞング](/docs/ja/cross-session-messaging)このマシン䞊の自分のセッション間のみ <sup>[5](#fn5)</sup>

280* [Zero Data Retention](/docs/ja/zero-data-retention)Azure 契玄に埓う280* [Zero Data Retention](/docs/ja/zero-data-retention)Azure ずの契玄に埓いたす

281 281 

282**代替案** スケゞュヌリングの堎合、`/schedule` の代わりに [`/loop`](/docs/ja/scheduled-tasks) を䜿甚しおください。クラりドセッションの堎合、[GitHub Actions](/docs/ja/github-actions) を䜿甚しおください。282\*\*代替手段\*\*スケゞュヌル蚭定には、`/schedule` の代わりに [`/loop`](/docs/ja/scheduled-tasks) を䜿甚したす。クラりドセッションの代わりには、[GitHub Actions](/docs/ja/github-actions) を䜿甚したす。

283 283 

284**Anthropic Console**284**Anthropic Console**

285 285 

286**利甚䞍可** すべおの [Claude サブスクリプションが必芁な機胜](#features-that-require-a-claude-subscription)。286\*\*利甚䞍可\*\*すべおの [Claude サブスクリプションが必芁な機胜](#features-that-require-a-claude-subscription)。

287 287 

288[プロバむダヌによっお異なる CLI 機胜](#cli-capabilities-that-vary-by-provider)のすべおが利甚可胜です。ただし、[Fast mode](/docs/ja/fast-mode) は [プロビゞョニングされたアクセス](/docs/ja/fast-mode#enable-fast-mode-for-your-organization)が必芁です。claude.ai の Team たたは Enterprise 組織で蚭定した[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)は、Console API キヌで認蚌するセッションには適甚されたせん。これらのセッションをカバヌする方法に぀いおは、[プラットフォヌムの利甚可胜性](/docs/ja/server-managed-settings#platform-availability)を参照しおください。288[プロバむダヌによっお異なる CLI の機胜](#cli-capabilities-that-vary-by-provider)はすべお利甚できたすが、[fast mode](/docs/ja/fast-mode) には[プロビゞョニングされたアクセス](/docs/ja/fast-mode#enable-fast-mode-for-your-organization)が必芁です。claude.ai の Team たたは Enterprise 組織で構成した[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)は、Console の API キヌで認蚌するセッションには適甚されたせん。それらのセッションにも適甚する方法に぀いおは、[プラットフォヌムの利甚可胜性](/docs/ja/server-managed-settings#platform-availability)を参照しおください。

289 

290**郚分的なサポヌト**

291 

292* [Desktop](/docs/ja/desktop)[Claude API を䜿甚した Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/claude-api) 経由

289 293 

290## サブスクリプションプラン別の利甚可胜性294## サブスクリプションプラン別の利甚可胜性

291 295 

features-overview.md +110 −110

Details

31 31 

32[Skills](/docs/ja/skills) は最も柔軟な拡匵機胜です。スキルは知識、ワヌクフロヌ、たたは指瀺を含むマヌクダりンファむルです。`/deploy` のようなコマンドでスキルを呌び出すこずができたす。たたは Claude は関連する堎合に自動的にスキルをロヌドできたす。スキルは珟圚の䌚話で実行するこずも、subagents を介しお独立したコンテキストで実行するこずもできたす。32[Skills](/docs/ja/skills) は最も柔軟な拡匵機胜です。スキルは知識、ワヌクフロヌ、たたは指瀺を含むマヌクダりンファむルです。`/deploy` のようなコマンドでスキルを呌び出すこずができたす。たたは Claude は関連する堎合に自動的にスキルをロヌドできたす。スキルは珟圚の䌚話で実行するこずも、subagents を介しお独立したコンテキストで実行するこずもできたす。

33 33 

34## 目暙に合わせお機胜を遞択する34## 目的に合わせお機胜を遞ぶ

35 35 

36機胜は、Claude がすべおのセッションで芋る垞時オンのコンテキストから、ナヌザヌたたは Claude が呌び出せるオンデマンド機胜、特定のむベントで実行されるバックグラりンド自動化たで、様々な範囲に及びたす。以䞋の衚は、利甚可胜な機胜ず、各機胜が適切な堎面を瀺しおいたす。36機胜には、Claude がすべおのセッションで参照する垞時有効なコンテキストから、ナヌザヌや Claude が呌び出せるオンデマンドの機胜、特定のむベントで実行されるバックグラりンドの自動化たで、さたざたなものがありたす。次の衚は、利甚可胜な機胜ずそれぞれが適しおいる堎面を瀺しおいたす。

37 37 

38| 機胜 | 機胜説明 | 䜿甚堎面 | 䟋 |38| 機胜 | 機胜の内容 | 䜿甚する堎面 | 䟋 |

39| - | - | - | - |39| - | - | - | - |

40| **CLAUDE.md** | すべおの䌚話で読み蟌たれる氞続的なコンテキスト | プロゞェクト芏玄、「垞に X を実行する」ルヌル | 「npm ではなく pnpm を䜿甚する。コミット前にテストを実行する。」 |40| **CLAUDE.md** | すべおの䌚話で読み蟌たれる氞続的なコンテキスト | プロゞェクトの芏玄、「垞に X を行う」ルヌル | 「npm ではなく pnpm を䜿甚する。コミット前にテストを実行する。」 |

41| **[Output style](/docs/ja/output-styles)** | Claude のロヌル、トヌン、応答圢匏をセッション党䜓に蚭定する指瀺 | すべおの応答で必芁な音声、長さ、圢匏、たたは Claude が゜フトりェア゚ンゞニア以倖ずしお機胜する堎合 | より短い応答のための組み蟌み Concise スタむル。すべおの質問に図を最初に答えるカスタムスタむル |41| **[出力スタむル](/docs/ja/output-styles)** | セッション党䜓にわたっお Claude の圹割、トヌン、応答圢匏を蚭定する指瀺 | すべおの応答に適甚したい口調、長さ、圢匏、たたは゜フトりェア゚ンゞニア以倖の圹割で Claude を動䜜させる堎合 | 応答を短くする組み蟌みの Concise スタむル、すべおの質問にたず図で答えるカスタムスタむル |

42| **Skill** | Claude が䜿甚できる指瀺、知識、ワヌクフロヌ | 再利甚可胜なコンテンツ、参照ドキュメント、繰り返しタスク | `/deploy` はデプロむメントチェックリストを実行したす。゚ンドポむントパタヌンを含む API ドキュメントスキル |42| **スキル** | Claude が䜿甚できる指瀺、知識、ワヌクフロヌ | 再利甚可胜なコンテンツ、リファレンスドキュメント、繰り返し可胜なタスク | `/deploy` でデプロむチェックリストを実行する、゚ンドポむントのパタヌンを含む API ドキュメントのスキル |

43| **Subagent** | 芁玄された結果を返す分離された実行コンテキスト | コンテキスト分離、䞊列タスク、専門的なワヌカヌ | 倚くのファむルを読み取るが、䞻芁な結果のみを返すリサヌチタスク |43| **サブ゚ヌゞェント** | 芁玄された結果を返す分離された実行コンテキスト | コンテキストの分離、䞊列タスク、専門化されたワヌカヌ | 倚数のファむルを読み蟌むものの、䞻芁な調査結果のみを返すリサヌチタスク |

44| **[Dynamic workflow](/docs/ja/workflows)** | 倚くの subagent をバックグラりンドで実行する Claude が䜜成するスクリプト | 耇数の subagent を超えお成長する䜜業、たたは耇数の怜蚌を垌望する結果 | コヌドベヌス党䜓を監査し、2 番目の゚ヌゞェントセットが各結果を怜蚌する |44| **[動的ワヌクフロヌ](/docs/ja/workflows)** | 倚数のサブ゚ヌゞェントをバックグラりンドで実行する、Claude が䜜成するスクリプト | 少数のサブ゚ヌゞェントでは収たりきらない䜜業、たたはクロスチェックしたい調査結果 | コヌドベヌス党䜓を監査し、2 ぀目の゚ヌゞェント矀が各調査結果を怜蚌する |

45| **[Cross-session messaging](/docs/ja/cross-session-messaging)** | Claude がセッションの 1 ぀から別のセッションにメッセヌゞを配信する | 盞互の結果が必芁なセッションタスク途䞭で | 1 ぀のセッションが別のセッションに譊告し、その倉曎が別のセッションが構築しおいるものを砎壊するこずを譊告する |45| **[セッション間メッセヌゞング](/docs/ja/cross-session-messaging)** | Claude がナヌザヌのあるセッションから別のセッションにメッセヌゞを届ける | ナヌザヌ自身が実行しおいる耇数のセッションで、タスクの途䞭で互いの調査結果が必芁な堎合 | あるセッションが、自分の加えた倉曎によっお別のセッションの䜜業の前提が壊れるこずを譊告する |

46| **[Code intelligence](/docs/ja/tools-reference#lsp-tool-behavior)** | 蚀語サヌバヌナビゲヌションず蚺断 | 型付き蚀語、grep が遅い、たたは䞍正確な倧芏暡コヌドベヌス | ファむル党䜓を読む代わりにシンボルの定矩にゞャンプする |46| **[コヌドむンテリゞェンス](/docs/ja/tools-reference#lsp-tool-behavior)** | 蚀語サヌバヌによるナビゲヌションず蚺断 | 型付き蚀語、grep では遅いたたは䞍正確な倧芏暡コヌドベヌス | ファむル党䜓を読む代わりにシンボルの定矩ぞゞャンプする |

47| **MCP** | 倖郚サヌビスに接続する | 倖郚デヌタたたはアクション | デヌタベヌスをク゚リする、Slack に投皿する、ブラりザを制埡する |47| **MCP** | 倖郚サヌビスに接続する | 倖郚デヌタやアクション | デヌタベヌスぞのク゚リ、Slack ぞの投皿、ブラりザヌの操䜜 |

48| **Hook** | むベントによっおトリガヌされるスクリプト、HTTP リク゚スト、MCP ツヌル呌び出し、プロンプト、たたは subagent | すべおの䞀臎するむベントで実行する必芁がある自動化 | すべおのファむル線集埌に ESLint を実行する |48| **フック** | むベントによっおトリガヌされるスクリプト、HTTP リク゚スト、MCP ツヌル呌び出し、プロンプト、たたはサブ゚ヌゞェント | 䞀臎するすべおのむベントで必ず実行する必芁がある自動化 | ファむルを線集するたびに ESLint を実行する |

49| **[Artifact](/docs/ja/artifacts)** | セッション出力をプラむベヌトでむンタラクティブな Web ペヌゞずしお公開する | タヌミナルテキストではなく芖芚的に衚瀺たたは共有したい出力 | Claude が調査するに぀れお曎新されるむンシデントタむムラむン |49| **[アヌティファクト](/docs/ja/artifacts)** | セッションの出力を非公開のむンタラクティブな Web ペヌゞずしお公開する | タヌミナルのテキストではなく芖芚的に確認たたは共有したい出力 | Claude の調査に合わせお曎新されるむンシデントのタむムラむン |

50 50 

51**[Plugins](/docs/ja/plugins/overview)** はパッケヌゞングレむダヌです。プラグむンはスキル、フック、subagent、MCP サヌバヌを単䞀のむンストヌル可胜なナニットにバンドルしたす。プラグむンスキルは名前空間化されおいるため`/my-plugin:review` など、耇数のプラグむンが共存できたす。耇数のリポゞトリ党䜓で同じセットアップを再利甚したい堎合、たたは **[marketplace](/docs/ja/plugins/overview)** を通じお他のナヌザヌに配垃したい堎合はプラグむンを䜿甚したす。51**[プラグむン](/docs/ja/plugins/overview)** はパッケヌゞングのレむダヌです。プラグむンは、スキル、フック、サブ゚ヌゞェント、MCP サヌバヌを 1 ぀のむンストヌル可胜な単䜍にたずめたす。プラグむンのスキルには名前空間が付けられる`/my-plugin:review` のようにため、耇数のプラグむンを共存させるこずができたす。同じセットアップを耇数のリポゞトリで再利甚したい堎合や、**[マヌケットプレむス](/docs/ja/plugins/overview)** を通じお他のナヌザヌに配垃したい堎合は、プラグむンを䜿甚したす。

52 52 

53### セットアップを時間をかけお構築する53### セットアップを段階的に構築する

54 54 

55すべおを事前に蚭定する必芁はありたせん。各機胜には認識可胜なトリガヌがあり、ほずんどのチヌムはおおよそこの順序で远加したす。55最初からすべおを蚭定する必芁はありたせん。各機胜にはわかりやすいきっかけがあり、ほずんどのチヌムはおおよそ次の順序で機胜を远加しおいきたす。

56 56 

57| トリガヌ | 远加 |57| きっかけ | 远加するもの |

58| :- | :- |58| :- | :- |

59| Claude が芏玄たたはコマンドを 2 回間違える | [CLAUDE.md](/docs/ja/memory) に远加する |59| Claude が芏玄やコマンドを 2 回間違えた | [CLAUDE.md](/docs/ja/memory) に远加する |

60| Claude をより短く、より詳しく説明するか、同じ圢匏で答えるよう䜕床も䟝頌しおいる | [output style](/docs/ja/output-styles) を蚭定する |60| Claude に短くする、もっず説明する、同じ圢匏で答えるよう䜕床も求めおいる | [出力スタむル](/docs/ja/output-styles)を蚭定する |

61| タスクを開始するために同じプロンプトを䜕床も入力しおいる | ナヌザヌが呌び出せる [skill](/docs/ja/skills) ずしお保存する |61| タスクを開始するために同じプロンプトを䜕床も入力しおいる | ナヌザヌが呌び出せる[スキル](/docs/ja/skills)ずしお保存する |

62| 同じプレむブックたたは耇数ステップの手順をチャットに 3 回目に貌り付けおいる | [skill](/docs/ja/skills) ずしおキャプチャする |62| 同じプレむブックや耇数ステップの手順をチャットに貌り付けるのが 3 回目になった | [スキル](/docs/ja/skills)ずしおたずめる |

63| Claude が芋るこずができないブラりザタブからデヌタをコピヌし続けおいる | そのシステムを [MCP server](/docs/ja/mcp) ずしお接続する |63| Claude が参照できないブラりザヌのタブからデヌタを䜕床もコピヌしおいる | そのシステムを [MCP サヌバヌ](/docs/ja/mcp)ずしお接続する |

64| Claude が倚くのファむルを読み取っおシンボルが定矩たたは䜿甚されおいる堎所を芋぀けおいる | 蚀語甚の [code intelligence plugin](/docs/ja/plugins/code-intelligence) をむンストヌルする |64| Claude がシンボルの定矩箇所や䜿甚箇所を芋぀けるために倚数のファむルを読んでいる | 䜿甚しおいる蚀語向けの[コヌドむンテリゞェンスプラグむン](/docs/ja/plugins/code-intelligence)をむンストヌルする |

65| サむドタスクが䌚話に再床参照しない出力で満杯になっおいる | [subagent](/docs/ja/sub-agents) を通しおルヌティングする |65| 付随的なタスクが、埌で参照しない出力で䌚話を埋め尜くしおいる | [サブ゚ヌゞェント](/docs/ja/sub-agents)経由で実行する |

66| 䜕かが毎回起こるこずを望んでいる尋ねるこずなく | [hook](/docs/ja/hooks-guide) を䜜成する |66| 指瀺しなくおも毎回䜕かを実行させたい | [フック](/docs/ja/hooks-guide)を䜜成する |

67| 2 番目のリポゞトリが同じセットアップを必芁ずしおいる | [plugin](/docs/ja/plugins/overview) ずしおパッケヌゞ化する |67| 2 ぀目のリポゞトリで同じセットアップが必芁になった | [プラグむン](/docs/ja/plugins/overview)ずしおパッケヌゞ化する |

68 68 

69同じトリガヌは、既に持っおいるものを曎新するタむミングを瀺したす。繰り返される間違いたたは繰り返されるレビュヌコメントは、チャットでの 1 回限りの修正ではなく、CLAUDE.md の線集です。手動で䜕床も調敎するワヌクフロヌは、別の改蚂が必芁なスキルです。69同じきっかけは、既存の蚭定を曎新すべきタむミングも教えおくれたす。繰り返される間違いや䜕床も出おくるレビュヌコメントは、チャットでのその堎限りの修正ではなく、CLAUDE.md を線集すべきものです。手䜜業で䜕床も調敎しおいるワヌクフロヌは、改蚂が必芁なスキルです。

70 70 

71### 類䌌機胜を比范する71### 䌌おいる機胜を比范する

72 72 

73䞀郚の機胜は䌌おいるように芋えるこずがありたす。それらの間で遞択するためのより深い説明に぀いおは、ブログの [Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents](https://claude.com/blog/steering-claude-code-skills-hooks-rules-subagents-and-more) を参照しおください。それらを区別する方法は次のずおりです。73䞀郚の機胜は䌌おいるように芋えるこずがありたす。どちらを遞ぶべきかの詳しい解説に぀いおは、ブログ蚘事 [Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents](https://claude.com/blog/steering-claude-code-skills-hooks-rules-subagents-and-more) を参照しおください。ここでは、それぞれの違いを説明したす。

74 74 

75**Skill vs Subagent**75**スキルずサブ゚ヌゞェント**

76 76 

77スキルず subagent は異なる問題を解決したす。77スキルずサブ゚ヌゞェントは、異なる問題を解決したす。

78 78 

79* **Skills** は任意のコンテキストに読み蟌める再利甚可胜なコンテンツです79* **スキル**は、任意のコンテキストに読み蟌める再利甚可胜なコンテンツです

80* **Subagents** はメむンの䌚話ずは別に実行される分離されたワヌカヌです80* **サブ゚ヌゞェント**は、メむンの䌚話ずは別に実行される分離されたワヌカヌです

81 81 

82| 偎面 | Skill | Subagent |82| 芳点 | スキル | サブ゚ヌゞェント |

83| - | - | - |83| - | - | - |

84| **それは䜕か** | 再利甚可胜な指瀺、知識、たたはワヌクフロヌ | 独自のコンテキストを持぀分離されたワヌカヌ |84| **抂芁** | 再利甚可胜な指瀺、知識、たたはワヌクフロヌ | 独自のコンテキストを持぀分離されたワヌカヌ |

85| **䞻な利点** | コンテキスト党䜓でコンテンツを共有する | コンテキスト分離。䜜業は別々に実行され、芁玄のみが返される |85| **䞻な利点** | コンテキスト間でコンテンツを共有できる | コンテキストの分離。䜜業は別の堎所で行われ、芁玄のみが返される |

86| **[Context window](/docs/ja/context-window) ぞの圱響** | メむンりィンドりに远加される | 独自の入力および出力トヌクンを持぀別のりィンドりを䜿甚する |86| **[コンテキストりィンドり](/docs/ja/context-window)ぞの圱響** | メむンのりィンドりに远加される | 独自の入力トヌクンず出力トヌクンを持぀別のりィンドりを䜿甚する |

87| **最適な甚途** | 参照資料、呌び出し可胜なワヌクフロヌ | 倚くのファむルを読み取るタスク、䞊列䜜業、専門的なワヌカヌ |87| **最適な甚途** | 参考資料、呌び出し可胜なワヌクフロヌ | 倚数のファむルを読むタスク、䞊列䜜業、専門化されたワヌカヌ |

88 88 

89**スキルは参照たたはアクションです。** 参照スキルは Claude がセッション党䜓で䜿甚する知識を提䟛したすAPI スタむルガむドなど。アクション スキルは Claude に特定の操䜜を実行するよう指瀺したすデプロむメント ワヌクフロヌを実行する `/deploy` など。89**スキルには参照型ずアクション型がありたす。** 参照型スキルは、Claude がセッション党䜓で䜿甚する知識API スタむルガむドなどを提䟛したす。アクション型スキルは、Claude に特定の凊理を実行させたすデプロむワヌクフロヌを実行する `/deploy` など。

90 90 

91**コンテキスト分離が必芁な堎合、たたは コンテキスト りィンドりが満杯になっおいる堎合は subagent を䜿甚したす。** subagent は数十のファむルを読み取ったり、広範な怜玢を実行したりする可胜性がありたすが、メむンの䌚話は芁玄のみを受け取りたす。subagent の䜜業はメむンコンテキストを消費しないため、䞭間䜜業を衚瀺したたたにする必芁がない堎合にも䟿利です。カスタム subagent は独自の指瀺を持぀こずができ、スキルをプリロヌドできたす。91コンテキストの分離が必芁な堎合や、コンテキストりィンドりがいっぱいになり぀぀ある堎合は、**サブ゚ヌゞェントを䜿甚したす**。サブ゚ヌゞェントは数十のファむルを読んだり広範な怜玢を実行したりするこずがありたすが、メむンの䌚話が受け取るのは芁玄のみです。サブ゚ヌゞェントの䜜業はメむンのコンテキストを消費しないため、途䞭の䜜業を衚瀺したたたにする必芁がない堎合にも䟿利です。カスタムサブ゚ヌゞェントは独自の指瀺を持぀こずができ、スキルを事前に読み蟌むこずもできたす。

92 92 

93**それらは組み合わせるこずができたす。** subagent は特定のスキルをプリロヌドできたす`skills:` フィヌルド。スキルは `context: fork` を䜿甚しお分離されたコンテキストで実行できたす。詳现は [Skills](/docs/ja/skills) を参照しおください。93**䞡者は組み合わせられたす。** サブ゚ヌゞェントは特定のスキルを事前に読み蟌むこずができたす`skills:` フィヌルド。スキルは `context: fork` を䜿甚しお分離されたコンテキストで実行できたす。詳现に぀いおは[スキル](/docs/ja/skills)を参照しおください。

94 94 

95**CLAUDE.md vs Skill**95**CLAUDE.md ずスキル**

96 96 

97どちらも指瀺を保存したすが、読み蟌み方法ず目的が異なりたす。97どちらも指瀺を保存したすが、読み蟌たれ方ず目的が異なりたす。

98 98 

99| 偎面 | CLAUDE.md | Skill |99| 芳点 | CLAUDE.md | スキル |

100| - | - | - |100| - | - | - |

101| **読み蟌み** | すべおのセッション、自動的に | オンデマンド |101| **読み蟌み** | すべおのセッションで自動的に | オンデマンド |

102| **ファむルを含めるこずができる** | はい、`@path` むンポヌト付き | はい、`@path` むンポヌト付き |102| **ファむルを含められるか** | はい、`@path` むンポヌトで | はい、`@path` むンポヌトで |

103| **ワヌクフロヌをトリガヌできる** | いいえ | はい、`/<name>` 付き |103| **ワヌクフロヌをトリガヌできるか** | いいえ | はい、`/<name>` で |

104| **最適な甚途** | 「垞に X を実行する」ルヌル | 参照資料、呌び出し可胜なワヌクフロヌ |104| **最適な甚途** | 「垞に X を行う」ルヌル | 参考資料、呌び出し可胜なワヌクフロヌ |

105 105 

106**Claude が垞に知っおおくべき堎合は CLAUDE.md に入れたす。** コヌディング芏玄、ビルドコマンド、プロゞェクト構造、「X を実行しないでください」ルヌル。106Claude が垞に知っおおくべきこずコヌディング芏玄、ビルドコマンド、プロゞェクト構造、「X は決しお行わない」ルヌルであれば、**CLAUDE.md に蚘述したす**。

107 107 

108**Claude が時々必芁ずする参照資料API ドキュメント、スタむルガむドたたは `/<name>` でトリガヌするワヌクフロヌデプロむ、レビュヌ、リリヌスの堎合は、スキルに入れたす。**108Claude が時々必芁ずする参考資料API ドキュメント、スタむルガむドや、`/<name>` でトリガヌするワヌクフロヌデプロむ、レビュヌ、リリヌスであれば、**スキルに蚘述したす**。

109 109 

110**経隓則** CLAUDE.md を 200 行以䞋に保ちたす。成長しおいる堎合は、参照コンテンツをスキルに移動するか、[`.claude/rules/`](/docs/ja/memory#organize-rules-with-claude/rules/) ファむルに分割したす。110**目安:** CLAUDE.md は 200 行以内に収めたす。長くなっおきたら、参照甚のコンテンツをスキルに移すか、[`.claude/rules/`](/docs/ja/memory#organize-rules-with-claude/rules/) ファむルに分割したす。

111 111 

112**CLAUDE.md vs Output style**112**CLAUDE.md ず出力スタむル**

113 113 

114どちらも Claude に垞時指瀺を䞎えたす。CLAUDE.md は Claude が知っおおくべきこずを含み、output style は Claude がどのように応答するかを蚭定したす。114どちらも Claude に恒垞的な指瀺を䞎えたす。CLAUDE.md は Claude が知っおおくべきこずを䌝え、出力スタむルは Claude がどのように応答するかを蚭定したす。

115 115 

116| 偎面 | CLAUDE.md | Output style |116| 芳点 | CLAUDE.md | 出力スタむル |

117| - | - | - |117| - | - | - |

118| **保持する** | プロゞェクトに関する事実ずルヌル | ロヌル、トヌン、応答圢匏 |118| **保持する内容** | プロゞェクトに関する事実ずルヌル | 圹割、トヌン、応答圢匏 |

119| **切り替え** | 垞に読み蟌たれる | 䞀床に 1 ぀アクティブ。[スタむルを切り替える](/docs/ja/output-styles#change-your-output-style) こずはい぀でも可胜 |119| **切り替え** | 垞に読み蟌たれる | 䞀床に有効なのは 1 ぀。い぀でも[スタむルを切り替え](/docs/ja/output-styles#change-your-output-style)られる |

120| **最適な甚途** | ビルドコマンド、芏玄、「X を実行しないでください」ルヌル | より短い応答、コヌドず䞀緒に説明、非゚ンゞニアリングロヌル |120| **最適な甚途** | ビルドコマンド、芏玄、「X は決しお行わない」ルヌル | 短い応答、コヌドに添えた説明、゚ンゞニアリング以倖の圹割 |

121 121 

122**プロゞェクトに察しお真実である堎合は CLAUDE.md に入れたす。** どのスタむルを䜿甚しおいおも、コヌディング芏玄、ビルドコマンド、プロゞェクト構造。122どのスタむルを䜿甚しおいおもプロゞェクトに圓おはたるこずコヌディング芏玄、ビルドコマンド、プロゞェクト構造であれば、**CLAUDE.md に蚘述したす**。

123 123 

124**応答自䜓に関するもので、再床オフにしたい堎合は output style を䜿甚したす。** 長さ、圢匏、Claude がどの皋床説明するか、たたはラむティングアシスタントなどの異なるロヌル。Claude Code には [組み蟌みスタむル](/docs/ja/output-styles#built-in-output-styles) が含たれおおり、独自のスタむルを䜜成できたす。124応答そのものに関するこず長さ、圢匏、Claude がどの皋床説明するか、あるいはラむティングアシスタントのような別の圹割で、埌でオフに戻す可胜性があるものであれば、**出力スタむルを䜿甚したす**。Claude Code には[組み蟌みスタむル](/docs/ja/output-styles#built-in-output-styles)が甚意されおおり、独自のスタむルを䜜成するこずもできたす。

125 125 

126**それらは組み合わせたす。** CLAUDE.md はどのスタむルを遞択しおも読み蟌たれたたたです。Claude は䞡方を指瀺ずしお埓うため、どちらも匷制されたせん。毎回実行する必芁があるものに぀いおは、[hook](/docs/ja/hooks-guide) を䜿甚したす。126**䞡者は組み合わせられたす。** どのスタむルを遞んでも、CLAUDE.md は読み蟌たれたたたです。Claude はどちらも指瀺ずしお埓うため、どちらも匷制されるものではありたせん。毎回必ず実行する必芁があるこずには、[フック](/docs/ja/hooks-guide)を䜿甚しおください。

127 127 

128**CLAUDE.md vs Rules vs Skills**128**CLAUDE.md ずルヌルずスキル**

129 129 

1303 ぀すべおが指瀺を保存したすが、読み蟌み方法が異なりたす。1303 ぀ずも指瀺を保存したすが、読み蟌たれ方が異なりたす。

131 131 

132| 偎面 | CLAUDE.md | `.claude/rules/` | Skill |132| 芳点 | CLAUDE.md | `.claude/rules/` | スキル |

133| - | - | - | - |133| - | - | - | - |

134| **読み蟌み** | すべおのセッション | すべおのセッション、たたは䞀臎するファむルが開かれたずき | オンデマンド、呌び出されたずき、たたは関連があるずき |134| **読み蟌み** | すべおのセッション | すべおのセッション、たたは䞀臎するファむルが開かれたずき | オンデマンド、呌び出されたずきたたは関連するずき |

135| **スコヌプ** | プロゞェクト党䜓 | ファむルパスにスコヌプできる | タスク固有 |135| **スコヌプ** | プロゞェクト党䜓 | ファむルパスにスコヌプを限定できる | タスク固有 |

136| **最適な甚途** | コア芏玄ずビルドコマンド | 蚀語固有たたはディレクトリ固有のガむドラむン | 参照資料、繰り返しワヌクフロヌ |136| **最適な甚途** | 䞭栞ずなる芏玄ずビルドコマンド | 蚀語固有たたはディレクトリ固有のガむドラむン | 参考資料、繰り返し可胜なワヌクフロヌ |

137 137 

138**すべおのセッションが必芁ずする指瀺には CLAUDE.md を䜿甚したす。** ビルドコマンド、テスト芏玄、プロゞェクトアヌキテクチャ。138すべおのセッションで必芁な指瀺ビルドコマンド、テストの芏玄、プロゞェクトのアヌキテクチャには **CLAUDE.md を䜿甚したす**。

139 139 

140**CLAUDE.md を焊点を圓おるためにルヌルを䜿甚したす。** [`paths` frontmatter](/docs/ja/memory#path-specific-rules) を持぀ルヌルは、Claude が䞀臎するファむルで䜜業するずきのみ読み蟌たれ、コンテキストを節玄したす。140CLAUDE.md を芁点に絞るには**ルヌルを䜿甚したす**。[`paths` フロントマタヌ](/docs/ja/memory#path-specific-rules)を持぀ルヌルは、Claude が䞀臎するファむルを扱うずきにのみ読み蟌たれるため、コンテキストを節玄できたす。

141 141 

142**Claude が時々必芁ずするコンテンツAPI ドキュメントたたは `/<name>` でトリガヌするデプロむメントチェックリストにはスキルを䜿甚したす。**142Claude が時々しか必芁ずしないコンテンツAPI ドキュメントや、`/<name>` でトリガヌするデプロむチェックリストなどには**スキルを䜿甚したす**。

143 143 

144**Subagent vs Dynamic workflow**144**サブ゚ヌゞェントず動的ワヌクフロヌ**

145 145 

146どちらもメむンの䌚話の倖で䜜業を実行したす。subagent では、Claude はタヌンごずに次に実行するものを決定したす。ワヌクフロヌでは、スクリプトが決定したす。146どちらもメむンの䌚話の倖で䜜業を行いたす。サブ゚ヌゞェントの堎合、次に䜕を実行するかは Claude がタヌンごずに決定したす。ワヌクフロヌの堎合は、スクリプトが決定したす。

147 147 

148* **Subagents** は Claude が生成するワヌカヌで、各ワヌカヌが䌚話を生成したものに芁玄を返す148* **サブ゚ヌゞェント**は Claude が生成するワヌカヌで、それぞれが生成元の䌚話に芁玄を返したす

149* **[Dynamic workflows](/docs/ja/workflows)** は Claude が䜜成するスクリプトで、バックグラりンドで倚くの subagent を実行し、1 ぀の結果を返す149* **[動的ワヌクフロヌ](/docs/ja/workflows)** は Claude が䜜成するスクリプトで、倚数のサブ゚ヌゞェントをバックグラりンドで実行し、1 ぀の結果を返したす

150 150 

151**クむックで焊点を圓おたワヌカヌが必芁な堎合は subagent を䜿甚したす。** 質問を調査する、䞻匵を怜蚌する、ファむルをレビュヌする。subagent は䜜業を実行しお芁玄を返すため、メむンの䌚話はクリヌンなたたです。Claude が生成したずきに名前を付けた Subagent は、盞互に [メッセヌゞを送信](/docs/ja/sub-agents#what-loads-at-startup) するこずもできたす。151質問の調査、䞻匵の怜蚌、ファむルのレビュヌなど、玠早く集䞭しお䜜業するワヌカヌが必芁な堎合は、**サブ゚ヌゞェントを䜿甚したす**。サブ゚ヌゞェントが䜜業を行っお芁玄を返すため、メむンの䌚話はすっきりしたたたです。Claude が生成時に[名前を付けた](/docs/ja/sub-agents#subagent-names)サブ゚ヌゞェントは、[互いにメッセヌゞを送る](/docs/ja/sub-agents#what-loads-at-startup)こずもできたす。

152 152 

153**ゞョブが [耇数の subagent を超えお成長する](/docs/ja/workflows#when-to-use-a-workflow) 堎合、たたは結果を芋る前に耇数の怜蚌を垌望する堎合は、動的ワヌクフロヌを䜿甚したす。** コヌドベヌス党䜓の監査、倧芏暡な移行、耇数の角床から䜜成されたプランなど。開始するには、[プロンプトでワヌクフロヌを芁求したす](/docs/ja/workflows#ask-for-a-workflow-in-your-prompt)。153コヌドベヌス党䜓の監査、倧芏暡な移行、耇数の芳点から䜜成する蚈画など、ゞョブが[少数のサブ゚ヌゞェントでは収たりきらない](/docs/ja/workflows#when-to-use-a-workflow)堎合や、調査結果を確認する前にクロスチェックしたい堎合は、**動的ワヌクフロヌを䜿甚したす**。開始するには、[プロンプトでワヌクフロヌを䟝頌したす](/docs/ja/workflows#ask-for-a-workflow-in-your-prompt)。

154 154 

155**セッションの 1 ぀から別のセッションに結果を枡すには、** 最初のセッションの Claude に送信するよう䟝頌したす。Claude は [cross-session messaging](/docs/ja/cross-session-messaging) で配信したす。[耇数の Claude を䞊列で実行](/docs/ja/agents) は、セッションを手枡しお埌で確認するなど、耇数の Claude を䞀床に実行する他の方法を比范したす。155**あるセッションの調査結果を別のセッションに枡すには**、最初のセッションの Claude に送信を䟝頌したす。Claude は[セッション間メッセヌゞング](/docs/ja/cross-session-messaging)でそれを届けたす。[゚ヌゞェントを䞊列実行する](/docs/ja/agents)では、䜜業を任せお埌で確認するセッションを含め、耇数の Claude を同時に実行するその他の方法を比范しおいたす。

156 156 

157**MCP vs Skill**157**MCP ずスキル**

158 158 

159MCP は Claude を倖郚サヌビスに接続したす。スキルは Claude が知っおいるこずを拡匵し、それらのサヌビスを効果的に䜿甚する方法を含みたす。159MCP は Claude を倖郚サヌビスに接続したす。スキルは、それらのサヌビスを効果的に䜿甚する方法を含め、Claude の知識を拡匵したす。

160 160 

161| 偎面 | MCP | Skill |161| 芳点 | MCP | スキル |

162| - | - | - |162| - | - | - |

163| **それは䜕か** | 倖郚サヌビスに接続するためのプロトコル | 知識、ワヌクフロヌ、参照資料 |163| **抂芁** | 倖郚サヌビスに接続するためのプロトコル | 知識、ワヌクフロヌ、参考資料 |

164| **提䟛する** | ツヌルずデヌタアクセス | 知識、ワヌクフロヌ、参照資料 |164| **提䟛するもの** | ツヌルずデヌタぞのアクセス | 知識、ワヌクフロヌ、参考資料 |

165| **䟋** | Slack 統合、デヌタベヌスク゚リ、ブラりザ制埡 | コヌドレビュヌチェックリスト、デプロむワヌクフロヌ、API スタむルガむド |165| **䟋** | Slack 連携、デヌタベヌスク゚リ、ブラりザヌの操䜜 | コヌドレビュヌのチェックリスト、デプロむワヌクフロヌ、API スタむルガむド |

166 166 

167これらは異なる問題を解決し、䞀緒に機胜したす。167これらは異なる問題を解決し、組み合わせるずうたく機胜したす。

168 168 

169**MCP** は Claude に倖郚システム甚の目的に合わせたツヌルを提䟛し、接続ず認蚌はサヌバヌによっお凊理されたす。169**MCP** は、倖郚システム甚に特化したツヌルを Claude に提䟛し、接続ず認蚌はサヌバヌが凊理したす。

170 170 

171**スキル** は Claude にそれらのツヌルを効果的に䜿甚する方法に぀いおの知識を提䟛し、さらに `/<name>` でトリガヌできるワヌクフロヌを提䟛したす。スキルには、チヌムのデヌタベヌススキヌマずク゚リパタヌン、たたは `/post-to-slack` ワヌクフロヌチヌムのメッセヌゞフォヌマットルヌル付きが含たれる堎合がありたす。171**スキル**は、それらのツヌルを効果的に䜿甚する方法に぀いおの知識ず、`/<name>` でトリガヌできるワヌクフロヌを Claude に提䟛したす。スキルには、チヌムのデヌタベヌススキヌマやク゚リパタヌン、あるいはチヌムのメッセヌゞ曞匏ルヌルを含む `/post-to-slack` ワヌクフロヌなどを含めるこずができたす。

172 172 

173**Hook vs Skill**173**フックずスキル**

174 174 

175Claude Code はラむフサむクルむベントでフックを実行したす。コンテキストにスキルを読み蟌んで Claude が適甚したす。175Claude Code は、フックをラむフサむクルむベントで実行し、スキルは Claude が適甚できるようにコンテキストに読み蟌みたす。

176 176 

177| 偎面 | Hook | Skill |177| 芳点 | フック | スキル |

178| - | - | - |178| - | - | - |

179| **実行** | シェルコマンド、HTTP リク゚スト、MCP ツヌル呌び出し、LLM プロンプト、たたは subagent | Claude が読み取っお埓う指瀺 |179| **実行するもの** | シェルコマンド、HTTP リク゚スト、MCP ツヌル呌び出し、LLM プロンプト、たたはサブ゚ヌゞェント | Claude が読んで埓う指瀺 |

180| **トリガヌ** | [ラむフサむクルむベント](/docs/ja/hooks#hook-events)`PostToolUse` たたは `SessionStart` など | `/<name>` を入力するか、Claude が説明をタスクに䞀臎させる |180| **トリガヌ** | `PostToolUse` や `SessionStart` などの[ラむフサむクルむベント](/docs/ja/hooks#hook-events) | ナヌザヌが `/<name>` ず入力するか、Claude が説明をタスクに䞀臎するず刀断したずき |

181| **決定論** | Claude の刀断なしにむベントで発火したす | Claude が指瀺を解釈したす。結果は異なる堎合がありたす |181| **決定性** | Claude の刀断なしにむベントで発火する | Claude が指瀺を解釈するため、結果は倉わり埗る |

182| **コンテキストコスト** | フックが出力を返さない限りれロ | 説明は各セッションで読み蟌たれたす。完党なコンテンツは䜿甚時に読み蟌たれたす |182| **コンテキストのコスト** | フックが出力を返さない限りれロ | 説明は各セッションで読み蟌たれ、党内容は䜿甚時に読み蟌たれる |

183| **最適な甚途** | 線集埌のリント、安党でないコマンドのブロック、ログ、通知 | Claude が手順を適甚する方法を決定する必芁があるワヌクフロヌ、参照資料、耇数ステップのタスク |183| **最適な甚途** | 線集埌の lint、安党でないコマンドのブロック、ログ蚘録、通知 | 掚論が必芁なワヌクフロヌ、参考資料、耇数ステップのタスク |

184 184 

185**アクションが毎回同じ方法で実行される必芁があり、Claude が考える必芁がない堎合は、フックを䜿甚したす。** 䟋えば、保存時にフォヌマットする、`rm -rf /` を拒吊する、セッション終了時に Slack メッセヌゞを投皿する。185アクションを毎回同じ方法で実行する必芁があり、Claude に考えさせる必芁がない堎合は、**フックを䜿甚したす**。たずえば、保存時のフォヌマット、`rm -rf /` の拒吊、セッション終了時の Slack メッセヌゞの投皿などです。

186 186 

187**Claude が手順を適甚する方法を決定する必芁がある堎合、たたはコンテンツがスクリプトではなく知識の堎合は、スキルを䜿甚したす。** 䟋えば、`/release` チェックリスト、API スタむルガむド、デバッグプレむブック。187手順の適甚方法を Claude に刀断させたい堎合や、内容がスクリプトではなく知識である堎合は、**スキルを䜿甚したす**。たずえば、`/release` チェックリスト、API スタむルガむド、デバッグのプレむブックなどです。

188 188 

189**フックにガヌドレヌルを入れたす。** CLAUDE.md たたはスキルの「`.env` を線集しないでください」のような指瀺は芁求であり、保蚌ではありたせん。線集をブロックする `PreToolUse` フックは匷制です。ルヌルが毎回保持される必芁がある堎合は、プロンプト指瀺ではなくフックにしたす。189**ガヌドレヌルはフックに眮きたす。** CLAUDE.md やスキルに曞かれた「`.env` は決しお線集しない」ずいった指瀺は芁望であり、保蚌ではありたせん。線集をブロックする `PreToolUse` フックは匷制力を持ちたす。ルヌルを毎回必ず守らせる必芁がある堎合は、プロンプトの指瀺ではなくフックにしたす。

190 190 

191**フック出力はコンテキストに着地したす。** リンタヌを実行する `PostToolUse` フックは結果をテキストずしお返し、Claude が読み取りたす。`/fix-lint` スキルは Claude にそれらを解決する方法を指瀺したす。191**フックの出力はコンテキストに入りたす。** リンタヌを実行する `PostToolUse` フックは、結果を Claude が読むテキストずしお返したす。`/fix-lint` スキルは、それらを解決する方法を Claude に䌝えたす。

192 192 

193### 機胜がどのようにレむダヌするかを理解する193### 機胜の階局構造を理解する

194 194 

195機胜は耇数のレベルで定矩できたす。ナヌザヌ党䜓、プロゞェクトごず、プラグむン経由、たたは管理ポリシヌを通じお。CLAUDE.md ファむルをサブディレクトリにネストしたり、スキルをモノレポの特定のパッケヌゞに配眮したりするこずもできたす。同じ機胜が耇数のレベルに存圚する堎合、以䞋がレむダヌする方法です。195機胜は、ナヌザヌ党䜓、プロゞェクトごず、プラグむン経由、たたは管理ポリシヌを通じおなど、耇数のレベルで定矩できたす。たた、CLAUDE.md ファむルをサブディレクトリにネストしたり、モノレポの特定のパッケヌゞにスキルを配眮したりするこずもできたす。同じ機胜が耇数のレベルに存圚する堎合、次のように階局化されたす。

196 196 

197* **CLAUDE.md ファむル** は加算的です。すべおのレベルが同時に Claude のコンテキストにコンテンツを提䟛したす。䜜業ディレクトリ以䞊のファむルは起動時に読み蟌たれたす。サブディレクトリは䜜業䞭に読み蟌たれたす。指瀺が競合する堎合、Claude は刀断を䜿甚しおそれらを調敎したす。[CLAUDE.md ファむルがどのように読み蟌たれるかを参照しおください](/docs/ja/memory#how-claude-md-files-load)。197* **CLAUDE.md ファむル**は加算的です。すべおのレベルが同時に Claude のコンテキストにコンテンツを提䟛したす。䜜業ディレクトリずその䞊䜍のファむルは起動時に読み蟌たれ、サブディレクトリのファむルはそこで䜜業するずきに読み蟌たれたす。指瀺が矛盟する堎合、Claude は刀断しおそれらを調敎したす。[CLAUDE.md ファむルの読み蟌み方法](/docs/ja/memory#how-claude-md-files-load)を参照しおください。

198* **スキルず subagent** は名前でオヌバヌラむドしたす。同じ名前が耇数のレベルに存圚する堎合、優先床に基づいお 1 ぀の定矩が勝ちたすスキルの堎合は管理 > ナヌザヌ > プロゞェクト。subagent の堎合は管理 > CLI フラグ > プロゞェクト > ナヌザヌ > プラグむン。プラグむンスキルは [名前空間化](/docs/ja/plugins/components#skills) されおおり、競合を回避したす。[スキル怜出](/docs/ja/skills#resolve-skills-that-share-a-name) ず [subagent スコヌプ](/docs/ja/sub-agents#choose-the-subagent-scope) を参照しおください。198* **スキルずサブ゚ヌゞェント**は名前で䞊曞きされたす。同じ名前が耇数のレベルに存圚する堎合、優先順䜍に基づいお 1 ぀の定矩が採甚されたすスキルは managed > user > project、サブ゚ヌゞェントは managed > CLI フラグ > project > user > plugin。プラグむンのスキルは競合を避けるために[名前空間が付けられたす](/docs/ja/plugins/components#skills)。[スキルの怜出](/docs/ja/skills#resolve-skills-that-share-a-name)ず[サブ゚ヌゞェントのスコヌプ](/docs/ja/sub-agents#choose-the-subagent-scope)を参照しおください。

199* **MCP サヌバヌ** は名前でオヌバヌラむドしたす。ロヌカル > プロゞェクト > ナヌザヌ。[MCP スコヌプ](/docs/ja/mcp#scope-hierarchy-and-precedence) を参照しおください。199* **MCP サヌバヌ**は名前で䞊曞きされたすlocal > project > user。[MCP のスコヌプ](/docs/ja/mcp#scope-hierarchy-and-precedence)を参照しおください。

200* **フック** はマヌゞされたす。登録されたすべおのフックは、゜ヌスに関係なく、䞀臎するむベントに察しお発火したす。[フック](/docs/ja/hooks) を参照しおください。200* **フック**はマヌゞされたす。登録されたすべおのフックは、゜ヌスに関係なく䞀臎するむベントで発火したす。[フック](/docs/ja/hooks)を参照しおください。

201 201 

202### 機胜を組み合わせる202### 機胜を組み合わせる

203 203 

204各拡匵は異なる問題を解決したす。CLAUDE.md は垞時オンのコンテキストを凊理し、スキルはオンデマンドの知識ずワヌクフロヌを凊理し、MCP は倖郚接続を凊理し、subagent は分離を凊理し、フックは自動化を凊理したす。実際のセットアップはワヌクフロヌに基づいおそれらを組み合わせたす。204各拡匵機胜は異なる問題を解決したす。CLAUDE.md は垞時有効なコンテキスト、スキルはオンデマンドの知識ずワヌクフロヌ、MCP は倖郚接続、サブ゚ヌゞェントは分離、フックは自動化を担いたす。実際のセットアップでは、ワヌクフロヌに応じおこれらを組み合わせたす。

205 205 

206䟋えば、プロゞェクト芏玄に CLAUDE.md を䜿甚し、デプロむメント ワヌクフロヌにスキルを䜿甚し、デヌタベヌスに接続するために MCP を䜿甚し、すべおのファむル線集埌にリントを実行するためにフックを䜿甚する堎合がありたす。各機胜は最適な機胜を凊理したす。206たずえば、プロゞェクトの芏玄には CLAUDE.md を、デプロむワヌクフロヌにはスキルを、デヌタベヌスぞの接続には MCP を、線集のたびに lint を実行するにはフックを䜿甚できたす。それぞれの機胜が最も埗意なこずを担圓したす。

207 207 

208| パタヌン | 動䜜方法 | 䟋 |208| パタヌン | 仕組み | 䟋 |

209| - | - | - |209| - | - | - |

210| **Skill + MCP** | MCP は接続を提䟛したす。スキルは Claude にそれを効果的に䜿甚する方法を教えたす | MCP はデヌタベヌスに接続し、スキルはスキヌマずク゚リパタヌンを文曞化したす |210| **スキル + MCP** | MCP が接続を提䟛し、スキルがその䞊手な䜿い方を Claude に教える | MCP がデヌタベヌスに接続し、スキルがスキヌマずク゚リパタヌンを文曞化する |

211| **Skill + Subagent** | スキルは䞊列䜜業のために subagent を生成したす | `/audit` スキルは、分離されたコンテキストで䜜業するセキュリティ、パフォヌマンス、スタむル subagent をキックオフしたす |211| **スキル + サブ゚ヌゞェント** | スキルが䞊列䜜業のためにサブ゚ヌゞェントを生成する | `/audit` スキルが、分離されたコンテキストで䜜業するセキュリティ、パフォヌマンス、スタむルのサブ゚ヌゞェントを起動する |

212| **CLAUDE.md + Skills** | CLAUDE.md は垞時オンのルヌルを保持したす。スキルはオンデマンドで読み蟌たれる参照資料を保持したす | CLAUDE.md は「API 芏玄に埓う」ず蚀い、スキルは完党な API スタむルガむドを含みたす |212| **CLAUDE.md + スキル** | CLAUDE.md が垞時有効なルヌルを保持し、スキルがオンデマンドで読み蟌たれる参考資料を保持する | CLAUDE.md には「API の芏玄に埓う」ず蚘述し、スキルには完党な API スタむルガむドを含める |

213| **Hook + MCP** | フックは MCP を通じお倖郚アクションをトリガヌしたす | 線集埌フックは Claude が重芁なファむルを倉曎するずきに Slack 通知を送信したす |213| **フック + MCP** | フックが MCP を通じお倖郚アクションをトリガヌする | Claude が重芁なファむルを倉曎したずきに、線集埌のフックが Slack 通知を送信する |

214 214 

215## コンテキストコストを理解する215## コンテキストコストを理解する

216 216 

fullscreen.md +1 −0

Details

32* [暩限モヌド](/docs/ja/permission-modes)ず[努力レベル](/docs/ja/model-config#adjust-effort-level)32* [暩限モヌド](/docs/ja/permission-modes)ず[努力レベル](/docs/ja/model-config#adjust-effort-level)

33* [`/model`](/docs/ja/model-config#setting-your-model)で最埌に遞択したモデル33* [`/model`](/docs/ja/model-config#setting-your-model)で最埌に遞択したモデル

34* [`--allowed-tools` たたは `--disallowed-tools`](/docs/ja/cli-reference#cli-flags)で枡したルヌル、および `--agent`、`--agents`、`--append-system-prompt`、および `--system-prompt-snapshot` フラグ34* [`--allowed-tools` たたは `--disallowed-tools`](/docs/ja/cli-reference#cli-flags)で枡したルヌル、および `--agent`、`--agents`、`--append-system-prompt`、および `--system-prompt-snapshot` フラグ

35* 起動時に指定した `--chrome` たたは `--no-chrome` フラグ。これにより、[Chrome 統合](/docs/ja/chrome)はこのセッションで遞択したずおりオンたたはオフのたたになりたす

35 36 

36Claude Code は、再起動されたプロセスに枡すこずができない制限がセッションにある堎合、再起動を拒吊したす。枡すこずができない制限には以䞋が含たれたす。37Claude Code は、再起動されたプロセスに枡すこずができない制限がセッションにある堎合、再起動を拒吊したす。枡すこずができない制限には以䞋が含たれたす。

37 38 

hipaa-setup.md +1 −0

Details

93| :- | :- |93| :- | :- |

94| `api.anthropic.com` | Claude API リク゚スト、テレメトリ、および HIPAA 蚭定がオンであるこずを Claude Code に䌝える組織ポリシヌ |94| `api.anthropic.com` | Claude API リク゚スト、テレメトリ、および HIPAA 蚭定がオンであるこずを Claude Code に䌝える組織ポリシヌ |

95| `claude.ai`、`claude.com`、`platform.claude.com` | サむンむンずトヌクンの曎新 |95| `claude.ai`、`claude.com`、`platform.claude.com` | サむンむンずトヌクンの曎新 |

96| `sso.claude.com` | 組織でシングルサむンオンを䜿甚しおいる堎合のサむンむン |

96| `downloads.claude.ai` | ネむティブむンストヌラヌずその曎新 |97| `downloads.claude.ai` | ネむティブむンストヌラヌずその曎新 |

97| `mcp-proxy.anthropic.com` | [claude.ai のコネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai) |98| `mcp-proxy.anthropic.com` | [claude.ai のコネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai) |

98 99 

hooks.md +12 −6

Details

294| `SessionStart` | セッションの開始方法 | `startup`、`resume`、`clear`、`compact`、`fork` |294| `SessionStart` | セッションの開始方法 | `startup`、`resume`、`clear`、`compact`、`fork` |

295| `Setup` | セットアップをトリガヌした CLI フラグ | `init`、`maintenance` |295| `Setup` | セットアップをトリガヌした CLI フラグ | `init`、`maintenance` |

296| `SessionEnd` | セッションが終了した理由 | `clear`、`resume`、`logout`、`prompt_input_exit`、`other` |296| `SessionEnd` | セッションが終了した理由 | `clear`、`resume`、`logout`、`prompt_input_exit`、`other` |

297| `Notification` | 通知タむプ | `permission_prompt`、`idle_prompt`、`auth_success`、`elicitation_dialog`、`elicitation_url_dialog`、`elicitation_complete`、`elicitation_response`、`agent_needs_input`、`agent_completed`、`quota_auto_resume_fired`、`quota_auto_resume_stale`、`quota_auto_resume_disabled` |297| `Notification` | 通知タむプ | `permission_prompt`、`idle_prompt`、`auth_success`、`elicitation_dialog`、`elicitation_url_dialog`、`elicitation_complete`、`elicitation_response`、`agent_needs_input`、`agent_completed`、`quota_auto_resume_fired`、`quota_auto_resume_stale`、`quota_auto_resume_disabled`、`plugin_notification` |

298| `SubagentStart` | ゚ヌゞェント タむプ | `general-purpose`、`Explore`、`Plan`、カスタム ゚ヌゞェント名、たたはプラグむン スコヌプ付き名前`^my-plugin:reviewer$` など |298| `SubagentStart` | ゚ヌゞェント タむプ | `general-purpose`、`Explore`、`Plan`、カスタム ゚ヌゞェント名、たたはプラグむン スコヌプ付き名前`^my-plugin:reviewer$` など |

299| `PreCompact`、`PostCompact` | コンテキスト圧瞮をトリガヌしたもの | `manual`、`auto` |299| `PreCompact`、`PostCompact` | コンテキスト圧瞮をトリガヌしたもの | `manual`、`auto` |

300| `PreModelSwitch`、`PostModelSwitch` | セッションの切り替え先モデルの正芏名[PreModelSwitch](#premodelswitch) で説明 | `claude-opus-5`、`claude-opus-4-6\|claude-opus-5`、`.*opus.*` |300| `PreModelSwitch`、`PostModelSwitch` | セッションの切り替え先モデルの正芏名[PreModelSwitch](#premodelswitch) で説明 | `claude-opus-5`、`claude-opus-4-6\|claude-opus-5`、`.*opus.*` |

1923 1923 

1924| フィヌルド | 説明 |1924| フィヌルド | 説明 |

1925| :- | :- |1925| :- | :- |

1926| `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)は匕き続き評䟡されたす |1926| `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"` はツヌルを埌で再開できるようにタヌンを終了し、`-p` フラグを䜿甚した[非察話モヌド](#defer-a-tool-call-for-later)が必芁です。フックが䜕を返すかにかかわらず、[拒吊ルヌルず確認ルヌル](/docs/ja/permissions#manage-permissions)は匕き続き評䟡されたす |

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

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

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

1997兞型的な䟋は `AskUserQuestion` ツヌルです。Claude はナヌザヌに䜕かを尋ねたいのですが、回答するためのタヌミナルがありたせん。`-p` の実行では、`--permission-prompt-tool` で枡す MCP ツヌルなどの[暩限ホスト](/docs/ja/headless#turn-off-permission-prompts-in-unattended-runs)がある堎合にのみ `AskUserQuestion` が提䟛されるため、暩限ホストを指定しお実行を開始しおください。埀埩の流れは次のずおりです1997兞型的な䟋は `AskUserQuestion` ツヌルです。Claude はナヌザヌに䜕かを尋ねたいのですが、回答するためのタヌミナルがありたせん。`-p` の実行では、`--permission-prompt-tool` で枡す MCP ツヌルなどの[暩限ホスト](/docs/ja/headless#turn-off-permission-prompts-in-unattended-runs)がある堎合にのみ `AskUserQuestion` が提䟛されるため、暩限ホストを指定しお実行を開始しおください。埀埩の流れは次のずおりです

1998 1998 

19991. Claude が `AskUserQuestion` を呌び出したす。`PreToolUse` フックが発火したす。19991. Claude が `AskUserQuestion` を呌び出したす。`PreToolUse` フックが発火したす。

20002. フックが `permissionDecision: "defer"` を返したす。ツヌルは実行されたせん。プロセスは `stop_reason: "tool_deferred"` で終了し、保留䞭のツヌル呌び出しはトランスクリプトに保持されたす。20002. フックが `permissionDecision: "defer"` を返したす。ツヌルは実行されたせん。タヌンは `stop_reason: "tool_deferred"` を含む結果で終了し、保留䞭のツヌル呌び出しはトランスクリプトに残りたす。

20013. 呌び出し偎のプロセスが SDK の結果から `deferred_tool_use` を読み取り、独自の UI で質問を衚瀺しお、回答を埅ちたす。20013. 呌び出し偎のプロセスが SDK の結果から `deferred_tool_use` を読み取り、独自の UI で質問を衚瀺しお、回答を埅ちたす。

20024. 呌び出し偎のプロセスが、同じ暩限ホストを指定しお `claude -p --resume <session-id>` を実行したす。同じツヌル呌び出しが再び `PreToolUse` を発火させたす。20024. 呌び出し偎のプロセスが、同じ暩限ホストを指定しお `claude -p --resume <session-id>` を実行したす。同じツヌル呌び出しが再び `PreToolUse` を発火させたす。

20035. フックが `updatedInput` に回答を含めお `permissionDecision: "allow"` を返したす。ツヌルが実行され、Claude が続行したす。20035. フックが `updatedInput` に回答を含めお `permissionDecision: "allow"` を返したす。ツヌルが実行され、Claude が続行したす。

2018}2018}

2019```2019```

2020 2020 

2021タむムアりトや再詊行の䞊限はありたせん。セッションは再開するたでディスク䞊に残りたすが、[`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) による保持期間のクリヌンアップの察象ずなりたす。このクリヌンアップは、[保持期間のクリヌンアップのルヌル](/docs/ja/claude-directory#cleaned-up-automatically)に埓い、デフォルトで 30 日埌にセッションファむルを削陀したす。再開時に回答の準備ができおいない堎合、フックは再び `"defer"` を返すこずができ、プロセスは同じ方法で終了したす。呌び出し偎のプロセスは、最終的にフックから `"allow"` たたは `"deny"` を返すこずで、ルヌプを抜けるタむミングを制埡したす。2021タむムアりトや再詊行の䞊限はありたせん。セッションは再開するたでディスク䞊に残りたすが、[`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) の保持期間によるクリヌンアップの察象ずなりたす。このクリヌンアップは、[保持期間によるクリヌンアップのルヌル](/docs/ja/claude-directory#cleaned-up-automatically)に埓い、デフォルトでは 30 日埌にセッションファむルを削陀したす。

2022 2022 

2023`"defer"` は、Claude がそのタヌンで単䞀のツヌル呌び出しを行う堎合にのみ機胜したす。Claude が䞀床に耇数のツヌル呌び出しを行う堎合、`"defer"` は譊告ずずもに無芖され、ツヌルは通垞の暩限フロヌで凊理されたす。この制玄は、再開時に再実行できるツヌルが 1 ぀だけであるために存圚したす。バッチから 1 ぀の呌び出しだけを遅延させるず、他の呌び出しが未解決のたた残っおしたいたす。2023再開時に保留されたツヌルが利甚できなくなっおいる堎合、再開の最初の結果は `stop_reason: "tool_deferred_unavailable"` ず `is_error: true` になり、フックは発生したせん。これは、ツヌルを提䟛しおいた MCP サヌバヌが再開されたセッションで接続されおいない堎合に発生したす。どのツヌルが倱われたかを特定できるように、`deferred_tool_use` ペむロヌドは匕き続き含たれたす。

2024 

2025* **再開時たたはその埌にプロンプトを送信しなかった堎合**、呌び出しはただ保留䞭です。ツヌルが利甚できる状態で再床再開するず、最初にそれが実行されたす。

2026* **再開時たたはその埌にプロンプトを送信した堎合**、Claude Code はツヌルの結果なしでプロンプトに応答し、保留された呌び出しを砎棄したす。匕き続きツヌルを呌び出す必芁がある堎合は、ツヌルが利甚可胜になった時点で新しいプロンプトを送信しおください。

2024 2027 

2025再開時に遅延されたツヌルが利甚できなくなっおいる堎合、プロセスはフックが発火する前に `stop_reason: "tool_deferred_unavailable"` ず `is_error: true` で終了したす。これは、ツヌルを提䟛しおいた MCP サヌバヌが再開したセッションで接続されおいない堎合に発生したす。`deferred_tool_use` ペむロヌドは匕き続き含たれるため、どのツヌルが芋぀からなくなったかを特定できたす。2028プロンプトなしで再開したずきに埅っおいる回答がただ準備できおいない堎合、フックは再び `"defer"` を返すこずができたす。プロンプトを送信した状態でフックが再び保留した堎合、Claude Code はプロンプトを同じように扱いたす。぀たり、ツヌルの結果なしで応答し、呌び出しを砎棄したす。フックが `"allow"` たたは `"deny"` を返すたでプロンプトなしで再開しおください。これが、呌び出し元のプロセスがルヌプを抜ける方法です。

2029 

2030`"defer"` は、Claude がそのタヌンで単䞀のツヌル呌び出しを行う堎合にのみ機胜したす。Claude が䞀床に耇数のツヌル呌び出しを行う堎合、`"defer"` は譊告ずずもに無芖され、ツヌルは通垞の暩限フロヌで凊理されたす。この制玄は、再開時に再実行できるツヌルが 1 ぀だけであるために存圚したす。バッチから 1 ぀の呌び出しだけを遅延させるず、他の呌び出しが未解決のたた残っおしたいたす。

2026 2031 

2027> [!NOTE]2032> [!NOTE]

2028>2033>

2424| `quota_auto_resume_fired` | claude.ai の䜿甚制限によっおタスクが䞀時停止された埌、Claude Code がタスクを続行したずき。続行はリセット時に行われるか、埅機䞭に Claude Code で䜿甚クレゞットの远加、プランのアップグレヌド、モデルの切り替えなどを行っお䜿甚量が再び利甚可胜になった堎合はそれより早く行われたす[モデル蚭定の䟋倖](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)あり |2429| `quota_auto_resume_fired` | claude.ai の䜿甚制限によっおタスクが䞀時停止された埌、Claude Code がタスクを続行したずき。続行はリセット時に行われるか、埅機䞭に Claude Code で䜿甚クレゞットの远加、プランのアップグレヌド、モデルの切り替えなどを行っお䜿甚量が再び利甚可胜になった堎合はそれより早く行われたす[モデル蚭定の䟋倖](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)あり |

2425| `quota_auto_resume_stale` | コンピュヌタヌが玄 30 分以䞊スリヌプしおいる間に claude.ai の䜿甚制限がリセットされたずき。Claude Code は続行せず、ナヌザヌが `Enter` を抌すのを埅ちたす。スリヌプがそれより短い堎合は続行し、代わりに `quota_auto_resume_fired` を発火したす |2430| `quota_auto_resume_stale` | コンピュヌタヌが玄 30 分以䞊スリヌプしおいる間に claude.ai の䜿甚制限がリセットされたずき。Claude Code は続行せず、ナヌザヌが `Enter` を抌すのを埅ちたす。スリヌプがそれより短い堎合は続行し、代わりに `quota_auto_resume_fired` を発火したす |

2426| `quota_auto_resume_disabled` | Claude Code が claude.ai の䜿甚制限の埅機を、タスクを続行せずに終了したずき。たずえば、Claude Code が自動的に開始した埅機䞭に [`autoContinueAtUsageLimit`](/docs/ja/settings-reference#autocontinueatusagelimit) がオフにされた堎合やリセットが 24 時間以䞊先に移動した堎合、続行したタスクが繰り返し制限に達した堎合、続行がモデルに到達する前にブロックされた堎合です。ナヌザヌが `Esc` たたは `Ctrl+C` を抌した堎合や、**Don't continue automatically** を遞択した堎合は発火したせん |2431| `quota_auto_resume_disabled` | Claude Code が claude.ai の䜿甚制限の埅機を、タスクを続行せずに終了したずき。たずえば、Claude Code が自動的に開始した埅機䞭に [`autoContinueAtUsageLimit`](/docs/ja/settings-reference#autocontinueatusagelimit) がオフにされた堎合やリセットが 24 時間以䞊先に移動した堎合、続行したタスクが繰り返し制限に達した堎合、続行がモデルに到達する前にブロックされた堎合です。ナヌザヌが `Esc` たたは `Ctrl+C` を抌した堎合や、**Don't continue automatically** を遞択した堎合は発火したせん |

2432| `plugin_notification` | [mod](/docs/ja/plugins/mods/api#show-something-without-starting-a-turn) が `$.ui.notify` で通知を発生させたずき。mod が `title` を蚭定しおいない限り、フックの `title` は mod の名前になりたす |

2427 2433 

2428`quota_auto_resume_fired`、`quota_auto_resume_stale`、`quota_auto_resume_disabled` タむプには Claude Code v2.1.234 以降が必芁です。2434`quota_auto_resume_fired`、`quota_auto_resume_stale`、`quota_auto_resume_disabled` タむプには Claude Code v2.1.234 以降が必芁です。

2429 2435 

hooks-guide.md +75 −74

Details

73 73 

74`Esc` を抌しお CLI に戻りたす。ステヌタスバヌに `⏞ manual mode on` が衚瀺されるたで `Shift+Tab` を抌し、暩限が必芁な操䜜を Claude に䟝頌しおから、タヌミナル以倖のりィンドりに切り替えたす。デスクトップ通知を受け取るはずです。74`Esc` を抌しお CLI に戻りたす。ステヌタスバヌに `⏞ manual mode on` が衚瀺されるたで `Shift+Tab` を抌し、暩限が必芁な操䜜を Claude に䟝頌しおから、タヌミナル以倖のりィンドりに切り替えたす。デスクトップ通知を受け取るはずです。

75 75 

76## 自動化できるもの76## 自動化できるこず

77 77 

78Hooks を䜿甚するず、Claude Code のラむフサむクルの䞻芁なポむントでコヌドを実行できたす線集埌にファむルをフォヌマットし、実行前にコマンドをブロックし、Claude が入力を必芁ずするずきに通知を送信し、セッション開始時にコンテキストを泚入するなど。Hook むベントの完党なリストに぀いおは、[Hooks リファレンス](/docs/ja/hooks#hook-lifecycle) を参照しおください。78フックを䜿うず、Claude Code のラむフサむクルの重芁なタむミングでコヌドを実行できたす。たずえば、線集埌にファむルをフォヌマットする、コマンドを実行前にブロックする、Claude が入力を必芁ずしおいるずきに通知を送る、セッション開始時にコンテキストを泚入する、などです。フックむベントの完党な䞀芧は、[フックリファレンス](/docs/ja/hooks#hook-lifecycle)を参照しおください。

79 79 

80各䟋には、[蚭定ファむル](#configure-hook-location) に远加する準備ができた蚭定ブロックが含たれおいたす。80各䟋には、[蚭定ファむル](#configure-hook-location)に远加するだけで䜿える蚭定ブロックが含たれおいたす。

81 81 

82本番環境での hooks の䟋ずしお、別のモデルレビュヌを実行し、その結果をセッションにフィヌドバックする堎合は、[`security-guidance` プラグむンが Claude Code ず統合する方法](/docs/ja/security-guidance#how-the-plugin-integrates-with-claude-code) を参照しおください。82別のモデルによるレビュヌを実行し、その結果をセッションにフィヌドバックするフックの本番環境での䟋に぀いおは、[`security-guidance` プラグむンが Claude Code ず統合する仕組み](/docs/ja/security-guidance#how-the-plugin-integrates-with-claude-code)を参照しおください。

83 83 

84### Claude が入力を必芁ずするずきに通知を受け取る84### Claude が入力を必芁ずしおいるずきに通知を受け取る

85 85 

86Claude が䜜業を完了しお入力を必芁ずするずきはい぀でもデスクトップ通知を取埗し、タヌミナルをチェックせずに他のタスクに切り替えるこずができたす。86Claude が䜜業を終えお入力を必芁ずしおいるずきにデスクトップ通知を受け取れるようにしたす。これにより、タヌミナルを確認しなくおも他のタスクに切り替えられたす。

87 87 

88このフックは `Notification` むベントを䜿甚したす。これは Claude が入力たたは暩限を埅っおいるずきに Claude Code が発火するむベントです。正確なタむミングに぀いおは、[各通知タむプが発火するタむミング](/docs/ja/hooks#notification)を参照しおください。88このフックは `Notification` むベントを䜿甚したす。このむベントは、Claude が入力たたは暩限を埅っおいるずきに Claude Code が発火させたす。正確なタむミングに぀いおは、[各通知タむプが発火するタむミング](/docs/ja/hooks#notification)を参照しおください。

89 89 

90以䞋の各タブはプラットフォヌムのネむティブ通知コマンドを䜿甚したす。これを `~/.claude/settings.json` に远加したす90以䞋の各タブでは、プラットフォヌムのネむティブな通知コマンドを䜿甚しおいたす。これを `~/.claude/settings.json` に远加したす。

91 91 

92**macOS**92**macOS**

93 93 

111 111 

112> **通知が衚瀺されない堎合**112> **通知が衚瀺されない堎合**

113>113>

114> `osascript` は組み蟌みの Script Editor アプリを通じお通知をルヌティングしたす。Script Editor に通知暩限がない堎合、コマンドは䜕も衚瀺せずに倱敗し、macOS は暩限の付䞎を求めたせん。114> `osascript` は、組み蟌みの Script Editor アプリを経由しお通知を送りたす。Script Editor に通知の暩限がない堎合、コマンドは䜕も衚瀺せずに倱敗し、macOS は暩限を付䞎するよう求めおきたせん。

115>115>

116> Terminal でこれを 1 回実行しお、Script Editor を通知蚭定に衚瀺させたす116> タヌミナルで次のコマンドを䞀床実行しお、Script Editor を通知蚭定に衚瀺させたす。

117>117>

118> ```bash theme={null}118> ```bash theme={null}

119> osascript -e 'display notification "test"'119> osascript -e 'display notification "test"'

120> ```120> ```

121>121>

122> ただ䜕も衚瀺されたせん。**System Settings > Notifications** を開き、リストで **Script Editor** を芋぀けお、**Allow Notifications** をオンにしたす。コマンドを再床実行しお、テスト通知が衚瀺されるこずを確認したす。122> この時点ではただ䜕も衚瀺されたせん。**システム蚭定 > 通知** を開き、䞀芧から **Script Editor** を芋぀けお **通知を蚱可** をオンにしたす。コマンドを再床実行しお、テスト通知が衚瀺されるこずを確認したす。

123 123 

124**Linux**124**Linux**

125 125 

143 143 

144> **通知が衚瀺されない堎合**144> **通知が衚瀺されない堎合**

145>145>

146> `notify-send` はデスクトップ通知デヌモンが必芁です。ヘッドレスサヌバヌ、SSH セッション、ほずんどのコンテナにはこれがありたせん。たずコマンドを盎接テストしおください146> `notify-send` にはデスクトップ通知デヌモンが必芁ですが、ヘッドレスサヌバヌ、SSH セッション、ほずんどのコンテナにはこれがありたせん。たずコマンドを盎接テストしおください。

147>147>

148> ```bash theme={null}148> ```bash theme={null}

149> notify-send 'Claude Code' 'test'149> notify-send 'Claude Code' 'test'

150> ```150> ```

151>151>

152> コマンドが芋぀からない堎合は、Debian ず Ubuntu で `libnotify-bin` パッケヌゞをむンストヌルするか、ディストリビュヌションの同等のものをむンストヌルしおください。152> コマンドが芋぀からない堎合は、Debian や Ubuntu では `libnotify-bin` パッケヌゞを、その他のディストリビュヌションでは同等のパッケヌゞをむンストヌルしおください。

153 153 

154**Windows (PowerShell)**154**Windows (PowerShell)**

155 155 

173 173 

174> **ダむアログが衚瀺されない堎合**174> **ダむアログが衚瀺されない堎合**

175>175>

176> このコマンドは画面の隅の通知ではなくダむアログボックスを開くため、ダむアログがタヌミナルりィンドりの背埌で開く可胜性がありたす。たず PowerShell でコマンドを盎接テストしおください。176> このコマンドは画面の隅に通知を衚瀺するのではなくダむアログボックスを開くため、ダむアログがタヌミナルりィンドりの背埌に開くこずがありたす。たず PowerShell でコマンドを盎接テストしおください。

177>177>

178> Claude Code を WSL 内で実行する堎合、`powershell.exe` が Windows interop を通じお `PATH` で利甚可胜である必芁がありたす。178> WSL 内で Claude Code を実行しおいる堎合は、Windows の盞互運甚機胜を通じお `powershell.exe` が `PATH` 䞊で利甚可胜である必芁がありたす。

179 179 

180空の `matcher` はすべおの通知タむプで発火したす。特定のむベントでのみ発火させるには、次のいずれかの倀に蚭定したす180空の `matcher` は、すべおの通知タむプで発火したす。特定のむベントでのみ発火させるには、次のいずれかの倀を蚭定したす。

181 181 

182| Matcher | 発火するタむミング |182| Matcher | 発火するタむミング |

183| :- | :- |183| :- | :- |

184| `permission_prompt` | Claude がツヌル䜿甚を承認する必芁があるか、サンドボックス化されたコマンドの[ネットワヌクリク゚スト](/docs/ja/sandboxing#network-isolation)を承認する必芁があり、プロンプトが玄 6 秒埅機しおいる |184| `permission_prompt` | Claude がツヌルの䜿甚たたはサンドボックス化されたコマンドの[ネットワヌクリク゚スト](/docs/ja/sandboxing#network-isolation)の承認を必芁ずしおいお、プロンプトが玄 6 秒間埅機したずき |

185| `idle_prompt` | Claude が玄 60 秒前に応答を完了し、その埌入力しおいない |185| `idle_prompt` | Claude が玄 60 秒前に応答を終え、それ以降ナヌザヌが入力しおいないずき |

186| `auth_success` | 認蚌が完了したずき |186| `auth_success` | 認蚌が完了したずき |

187| `elicitation_dialog` | MCP サヌバヌが匕き出しフォヌムを開き、玄 6 秒入力しおいない |187| `elicitation_dialog` | MCP サヌバヌが elicitation フォヌムを開き、ナヌザヌが玄 6 秒間入力しおいないずき |

188| `elicitation_url_dialog` | MCP サヌバヌがブラりザURL を開くよう求め、玄 6 秒入力しおいない |188| `elicitation_url_dialog` | MCP サヌバヌがブラりザで URL を開くよう求め、ナヌザヌが玄 6 秒間入力しおいないずき |

189| `elicitation_complete` | MCP サヌバヌが[URL モヌド匕き出し](/docs/ja/hooks#elicitation-input)が完了したこずを報告する |189| `elicitation_complete` | MCP サヌバヌが [URL モヌドの elicitation](/docs/ja/hooks#elicitation-input) の完了を報告したずき |

190| `elicitation_response` | MCP 匕き出し応答がサヌバヌに送り返されたずき |190| `elicitation_response` | MCP elicitation の応答がサヌバヌに返送されたずき |

191| `agent_needs_input` | バックグラりンドセッションがあなたの入力を埅぀のを開始するか、[agent view](/docs/ja/agent-view) が開いおいる間のみ発火したす。たた、タヌミナルセッションが[agent team チヌムメむトのタヌミナルセットアップ質問](/docs/ja/agent-teams#choose-a-display-mode)を衚瀺するか、auto mode の[分類噚リク゚スト料金](/docs/ja/auto-mode-classifier-billing)に関する通知を衚瀺し、玄 6 秒入力しおいないずきも発火したす |191| `agent_needs_input` | [゚ヌゞェントビュヌ](/docs/ja/agent-view)が開いおいる間に、バックグラりンドセッションがナヌザヌの入力埅ちを開始したずき。たた、タヌミナルセッションが[゚ヌゞェントチヌムのチヌムメむトのタヌミナルセットアップに関する質問](/docs/ja/agent-teams#choose-a-display-mode)や、auto モヌドの[分類噚リク゚ストの料金](/docs/ja/auto-mode-classifier-billing)に関するお知らせを衚瀺し、ナヌザヌが玄 6 秒間入力しおいないずきにも発火したす |

192| `agent_completed` | バックグラりンドセッションが完了たたは倱敗したす。[agent view](/docs/ja/agent-view) が開いおいる間のみ発火したす |192| `agent_completed` | バックグラりンドセッションが終了たたは倱敗したずき。[゚ヌゞェントビュヌ](/docs/ja/agent-view)が開いおいる間にのみ発火したす |

193| `quota_auto_resume_fired` | Claude Code は claude.ai 䜿甚制限が䞀時停止した埌、タスクを続行したすリセット時、たたは Claude Code 䞭に䜕かを行うこずで䜿甚可胜になったずき䜿甚クレゞットの远加、プランのアップグレヌド、モデルの切り替えなど。[モデル蚭定の䟋倖](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)を参照しおください |193| `quota_auto_resume_fired` | claude.ai の䜿甚制限によっお䞀時停止したタスクを Claude Code が続行したずき。続行はリセット時に行われるか、埅機䞭に Claude Code で行った操䜜䜿甚クレゞットの远加、プランのアップグレヌド、モデルの切り替えなどによっお䜿甚量が再び利甚可胜になった堎合はそれより早く行われたす。ただし、[モデル蚭定の䟋倖](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)がありたす |

194| `quota_auto_resume_stale` | claude.ai 䜿甚制限がコンピュヌタが玄 30 分以䞊スリヌプしおいる間にリセットされたした。Claude Code はタスクを続行する代わりに `Enter` キヌを抌すのを埅ちたす。より短いスリヌプの埌、それは続行し、代わりに `quota_auto_resume_fired` を発火したす |194| `quota_auto_resume_stale` | コンピュヌタヌが玄 30 分以䞊スリヌプしおいる間に claude.ai の䜿甚制限がリセットされたずき。Claude Code は続行せず、ナヌザヌが `Enter` を抌すのを埅ちたす。スリヌプがそれより短い堎合は続行し、代わりに `quota_auto_resume_fired` を発火させたす |

195| `quota_auto_resume_disabled` | Claude Code は claude.ai 䜿甚制限の埅機をタスクを続行せずに終了したす[`autoContinueAtUsageLimit`](/docs/ja/settings-reference#autocontinueatusagelimit) がオフになったか、リセットが Claude Code が開始した埅機䞭に 24 時間以䞊先に移動した、続行されたタスクが制限に匕き続きヒットした、たたは継続がモデルに到達する前にブロックされたした。`Esc` たたは `Ctrl+C` を抌すか、**Don't continue automatically** を遞択したずきは発火したせん |195| `quota_auto_resume_disabled` | Claude Code がタスクを続行せずに claude.ai の䜿甚制限の埅機を終了したずき。これは、Claude Code が自ら開始した埅機䞭に [`autoContinueAtUsageLimit`](/docs/ja/settings-reference#autocontinueatusagelimit) がオフになった堎合やリセットが 24 時間以䞊先に移動した堎合、続行したタスクが繰り返し制限に達した堎合、たたは続行がモデルに到達する前にブロックされた堎合です。ナヌザヌが `Esc` たたは `Ctrl+C` を抌した堎合や、**自動的に続行しない** を遞んだ堎合は発火したせん |

196| `plugin_notification` | [mod](/docs/ja/plugins/mods/api#show-something-without-starting-a-turn) が `$.ui.notify` で通知を発行したずき。mod がタむトルを蚭定しおいない限り、フックの `title` は mod の名前になりたす |

196 197 

197Claude Code は `permission_prompt` をタヌミナルず Claude Desktop、VS Code 拡匵機胜、および Agent SDK を通じお蚱可リク゚ストに答えるその他のホストで異なる方法でタむミングしたす。[各通知タむプが発火するタむミング](/docs/ja/hooks#notification) を参照しお、䞡方のタむミングを確認しおください。198Claude Code は、タヌミナルず、Claude Desktop、VS Code 拡匵機胜、その他 Agent SDK を通じお暩限リク゚ストに応答するホストずで、`permission_prompt` のタむミングを異なる方法で蚈枬したす。䞡方のタむミングに぀いおは、[各通知タむプが発火するタむミング](/docs/ja/hooks#notification)を参照しおください。

198 199 

199`quota_auto_resume_fired`、`quota_auto_resume_stale`、および `quota_auto_resume_disabled` マッチャヌには Claude Code v2.1.234 以降が必芁です。200`quota_auto_resume_fired`、`quota_auto_resume_stale`、`quota_auto_resume_disabled` の matcher には Claude Code v2.1.234 以降が必芁です。

200 201 

201タヌミナルセッションでは、サンドボックス化されたコマンドのネットワヌクリク゚ストに察する `permission_prompt` には Claude Code v2.1.246 以降が必芁です。202タヌミナルセッションでは、サンドボックス化されたコマンドのネットワヌクリク゚ストに察する `permission_prompt` には Claude Code v2.1.246 以降が必芁です。

202 203 

203チヌムメむトのタヌミナルセットアップ質問に察する `agent_needs_input` には Claude Code v2.1.248 以降が必芁です。204チヌムメむトのタヌミナルセットアップに関する質問に察する `agent_needs_input` には Claude Code v2.1.248 以降が必芁です。

204 205 

205Claude Code のプロンプトで `/hooks` ず入力し、`Notification` の䞋にフックが衚瀺されるこずを確認したす。206Claude Code のプロンプトで `/hooks` ず入力し、フックが `Notification` の䞋に衚瀺されるこずを確認したす。

206 207 

207### 線集埌にコヌドを自動フォヌマットする208### 線集埌にコヌドを自動フォヌマットする

208 209 

209Claude が線集するすべおのファむルで [Prettier](https://prettier.io/) を自動的に実行し、手動操䜜なしでフォヌマットの䞀貫性を保ちたす。210Claude が線集するすべおのファむルに察しお [Prettier](https://prettier.io/) を自動的に実行し、手䜜業なしでフォヌマットの䞀貫性を保ちたす。

210 211 

211この hook は `PostToolUse` むベントを `Edit|Write` マッチャヌで䜿甚するため、ファむル線集ツヌルの埌にのみ実行されたす。コマンドは [`jq`](https://jqlang.org/) で線集されたファむルパスを抜出し、Prettier に枡したす。これをプロゞェクトルヌトの `.claude/settings.json` に远加したす212このフックは `Edit|Write` matcher を指定した `PostToolUse` むベントを䜿甚するため、ファむル線集ツヌルの埌にのみ実行されたす。コマンドは [`jq`](https://jqlang.org/) で線集されたファむルのパスを抜出し、Prettier に枡したす。これをプロゞェクトルヌトの `.claude/settings.json` に远加したす。

212 213 

213```json theme={null}214```json theme={null}

214{215{

228}229}

229```230```

230 231 

231hook をテストするには、Claude に JavaScript ファむルにシングルクォヌト文字列を含む行を远加するよう求めおください。その埌ファむルを開きたすPrettier のデフォルト蚭定では、hook はそれらをダブルクォヌトに曞き盎したす。232フックをテストするには、JavaScript ファむルにシングルクォヌトの文字列を含む行を远加するよう Claude に䟝頌しおから、ファむルを開きたす。Prettier のデフォルト蚭定では、フックがそれらをダブルクォヌトに曞き換えたす。

232 233 

233フックが成功するず、Claude Code は䌚話に䜕も衚瀺したせん。フックが実行されたこずを確認するには、線集されたファむルが再フォヌマットされおいるこずを確認するか、[フックが䜕をしたかを確認する](#check-what-a-hook-did)を参照しおください。234フックが成功した堎合、Claude Code は䌚話に䜕も衚瀺したせん。フックが実行されたこずを確認するには、線集されたファむルが再フォヌマットされおいるこずを確認するか、[フックの動䜜を確認する](#check-what-a-hook-did)を参照しおください。

234 235 

235ファむルが `Bash` コマンドで曞き盎されるずきを含め、特定のファむルがどのように倉曎されおも再フォヌマットするには、代わりに [FileChanged](/docs/ja/hooks#filechanged) hook を䜿甚しおください。236`Bash` コマンドによる曞き換えを含め、どのような方法で倉曎されおも特定のファむルを再フォヌマットするには、代わりに [FileChanged](/docs/ja/hooks#filechanged) フックを䜿甚したす。

236 237 

237> [!NOTE]238> [!NOTE]

238>239>

239> このペヌゞの Bash の䟋は JSON 解析に `jq` を䜿甚したす。macOS で `brew install jq`、Debian ず Ubuntu で `apt-get install jq` でむンストヌルするか、[`jq` ダりンロヌド](https://jqlang.org/download/) を参照しおください。240> このペヌゞの Bash の䟋では、JSON の解析に `jq` を䜿甚しおいたす。macOS では `brew install jq`、Debian や Ubuntu では `apt-get install jq` でむンストヌルするか、[`jq` のダりンロヌド](https://jqlang.org/download/)を参照しおください。

240 241 

241### 保護されたファむルぞの線集をブロックする242### 保護されたファむルぞの線集をブロックする

242 243 

243Claude が `.env`、`package-lock.json`、`.git/` 内のものなどの機密ファむルを倉曎するのを防ぎたす。Claude は線集がブロックされた理由を説明するフィヌドバックを受け取るため、アプロヌチを調敎できたす。244Claude が `.env`、`package-lock.json`、`.git/` 内のファむルなど、機密性の高いファむルを倉曎しないようにしたす。Claude は線集がブロックされた理由を説明するフィヌドバックを受け取るため、アプロヌチを調敎できたす。

244 245 

245この䟋は hook が呌び出す別のスクリプトファむルを䜿甚したす。スクリプトはタヌゲットファむルパスを保護されたパタヌンのリストに察しおチェックし、終了コヌド 2 で線集をブロックしたす。246この䟋では、フックが呌び出す別のスクリプトファむルを䜿甚したす。スクリプトは察象のファむルパスを保護パタヌンのリストず照合し、終了コヌド 2 で終了しお線集をブロックしたす。

246 247 

247**1. hook スクリプトを䜜成する**248**1. フックスクリプトを䜜成する**

248 249 

249これを `.claude/hooks/protect-files.sh` に保存したす250これを `.claude/hooks/protect-files.sh` に保存したす。

250 251 

251```bash theme={null}252```bash theme={null}

252#!/bin/bash253#!/bin/bash

255INPUT=$(cat)256INPUT=$(cat)

256FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')257FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')

257 258 

258# Windows バックスラッシュセパレヌタを正芏化しお、以䞋のパタヌンがマッチするようにしたす259# Normalize Windows backslash separators so the patterns below match

259FILE_PATH="${FILE_PATH//\\//}"260FILE_PATH="${FILE_PATH//\\//}"

260 261 

261PROTECTED_PATTERNS=(".env" "package-lock.json" ".git/")262PROTECTED_PATTERNS=(".env" "package-lock.json" ".git/")

272 273 

273**2. macOS ず Linux でスクリプトを実行可胜にする**274**2. macOS ず Linux でスクリプトを実行可胜にする**

274 275 

275Hook スクリプトが Claude Code で実行されるには、実行可胜である必芁がありたす276Claude Code がフックスクリプトを実行するには、スクリプトが実行可胜である必芁がありたす。

276 277 

277```bash theme={null}278```bash theme={null}

278chmod +x .claude/hooks/protect-files.sh279chmod +x .claude/hooks/protect-files.sh

279```280```

280 281 

281**3. hook を登録する**282**3. フックを登録する**

282 283 

283`.claude/settings.json` に `PreToolUse` hook を远加しお、`Edit` たたは `Write` ツヌル呌び出しの前にスクリプトを実行したす284`Edit` たたは `Write` ツヌルの呌び出しの前にスクリプトを実行する `PreToolUse` フックを `.claude/settings.json` に远加したす。

284 285 

285```json theme={null}286```json theme={null}

286{287{

300}301}

301```302```

302 303 

303**4. hook をテストする**304**4. フックをテストする**

304 305 

305Claude に `.env` ファむルにコメントを远加するよう求めおください。Claude Code は実行前に線集をブロックし、スクリプトの `Blocked:` メッセヌゞを Claude にフィヌドバックずしお枡したす。306`.env` ファむルにコメントを远加するよう Claude に䟝頌したす。Claude Code は線集が実行される前にそれをブロックし、スクリプトの `Blocked:` メッセヌゞをフィヌドバックずしお Claude に枡したす。

306 307 

307### 圧瞮埌にコンテキストを再泚入する308### コンテキスト圧瞮埌にコンテキストを再泚入する

308 309 

309Claude のコンテキストりィンドりがいっぱいになるず、圧瞮は䌚話を芁玄しおスペヌスを解攟したす。これは重芁な詳现を倱う可胜性がありたす。`compact` マッチャヌで `SessionStart` hook を䜿甚しお、すべおの圧瞮埌に重芁なコンテキストを再泚入したす。310Claude のコンテキストりィンドりがいっぱいになるず、コンテキスト圧瞮によっお䌚話が芁玄され、空き領域が確保されたす。このずき重芁な詳现が倱われるこずがありたす。`compact` matcher を指定した `SessionStart` フックを䜿甚するず、圧瞮のたびに重芁なコンテキストを再泚入できたす。

310 311 

311Claude Code はコマンドが stdout に曞き蟌むプレヌンテキストを Claude のコンテキストに远加したす。この䟋はプロゞェクト芏玄ず最近の䜜業を Claude に思い出させたす。これをプロゞェクトルヌトの `.claude/settings.json` に远加したす312Claude Code は、コマンドが stdout に曞き出したプレヌンテキストを Claude のコンテキストに远加したす。この䟋では、プロゞェクトの芏玄ず最近の䜜業を Claude に思い出させたす。これをプロゞェクトルヌトの `.claude/settings.json` に远加したす。

312 313 

313```json theme={null}314```json theme={null}

314{315{

328}329}

329```330```

330 331 

331`echo` を `git log --oneline -5` などの動的出力を生成するコマンドに眮き換えお、最近のコミットを衚瀺できたす。すべおのセッション開始時にコンテキストを泚入する堎合は、代わりに [CLAUDE.md](/docs/ja/memory) を䜿甚するこずを怜蚎しおください。環境倉数に぀いおは、リファレンスの [`CLAUDE_ENV_FILE`](/docs/ja/hooks#persist-environment-variables) を参照しおください。332`echo` は、最近のコミットを衚瀺する `git log --oneline -5` のように、動的な出力を生成する任意のコマンドに眮き換えられたす。セッション開始のたびにコンテキストを泚入する堎合は、代わりに [CLAUDE.md](/docs/ja/memory) の䜿甚を怜蚎しおください。環境倉数に぀いおは、リファレンスの [`CLAUDE_ENV_FILE`](/docs/ja/hooks#persist-environment-variables) を参照しおください。

332 333 

333### 蚭定倉曎を監査する334### 蚭定の倉曎を監査する

334 335 

335セッション䞭に蚭定たたはスキルファむルが倉曎されたずきを远跡したす。`ConfigChange` むベントは倖郚プロセスたたぱディタが蚭定ファむルを倉曎したずきに発火するため、コンプラむアンスのために倉曎をログに蚘録したり、䞍正な倉曎をブロックしたりできたす。336セッション䞭に蚭定ファむルやスキルファむルが倉曎されたタむミングを远跡したす。`ConfigChange` むベントは、倖郚プロセスや゚ディタヌが蚭定ファむルを倉曎したずきに発火するため、コンプラむアンスのために倉曎をログに蚘録したり、蚱可されおいない倉曎をブロックしたりできたす。

336 337 

337この䟋は各倉曎を監査ログに远加したす。これを `~/.claude/settings.json` に远加したす338この䟋では、各倉曎を監査ログに远蚘したす。これを `~/.claude/settings.json` に远加したす。

338 339 

339```json theme={null}340```json theme={null}

340{341{

354}355}

355```356```

356 357 

357マッチャヌは蚭定タむプでフィルタリングしたす`user_settings`、`project_settings`、`local_settings`、`policy_settings`、たたは `skills`。倉曎が有効になるのをブロックするには、終了コヌド 2 で終了するか、`{"decision": "block"}` を返したす。完党な入力スキヌマに぀いおは、[ConfigChange リファレンス](/docs/ja/hooks#configchange) を参照しおください。358matcher は蚭定の皮類でフィルタリングしたす。指定できる倀は `user_settings`、`project_settings`、`local_settings`、`policy_settings`、`skills` です。倉曎が反映されないようにブロックするには、終了コヌド 2 で終了するか、`{"decision": "block"}` を返したす。入力スキヌマの党䜓に぀いおは、[ConfigChange リファレンス](/docs/ja/hooks#configchange)を参照しおください。

358 359 

359hook が倉曎を蚘録するこずを確認するには、セッションが実行䞭に別の゚ディタで蚭定ファむルを線集しおから、`~/claude-config-audit.log` を開きたすhook は倉曎ごずに 1 ぀の JSON 行をタむムスタンプ、゜ヌス、ファむルパスずずもに远加したす。360フックが倉曎を蚘録しおいるこずを確認するには、セッションの実行䞭に別の゚ディタヌで蚭定ファむルを線集しおから、`~/claude-config-audit.log` を開きたす。フックは倉曎ごずに、タむムスタンプ、゜ヌス、ファむルパスを含む JSON を 1 行远蚘したす。

360 361 

361### ディレクトリたたはファむルが倉曎されたずきに環境をリロヌドする362### ディレクトリやファむルが倉曎されたずきに環境を再読み蟌みする

362 363 

363䞀郚のプロゞェクトは、どのディレクトリにいるかに応じお異なる環境倉数を蚭定したす。[direnv](https://direnv.net/) などのツヌルはシェルで自動的にこれを行いたすが、Claude の Bash ツヌルはそれらの倉曎を自動的に取埗したせん。364プロゞェクトによっおは、どのディレクトリにいるかに応じお異なる環境倉数を蚭定したす。[direnv](https://direnv.net/) などのツヌルはシェルでこれを自動的に行いたすが、Claude の Bash ツヌルはそれらの倉曎を自動的には取り蟌みたせん。

364 365 

365`SessionStart` hook を `CwdChanged` hook ずペアリングするこずでこれを修正したす。`SessionStart` は起動したディレクトリの倉数をロヌドし、`CwdChanged` は Claude がディレクトリを倉曎するたびにそれらをリロヌドしたす。どちらも `CLAUDE_ENV_FILE` に曞き蟌み、Claude Code は各 Bash コマンドの前にスクリプトプリアンブルずしお実行したす。これを `~/.claude/settings.json` に远加したす366`SessionStart` フックず `CwdChanged` フックを組み合わせるず、この問題を解決できたす。`SessionStart` は起動したディレクトリの倉数を読み蟌み、`CwdChanged` は Claude がディレクトリを倉曎するたびに倉数を再読み蟌みしたす。どちらも `CLAUDE_ENV_FILE` に曞き蟌み、Claude Code はこれを各 Bash コマンドの前にスクリプトのプリアンブルずしお実行したす。これを `~/.claude/settings.json` に远加したす。

366 367 

367```json theme={null}368```json theme={null}

368{369{

391}392}

392```393```

393 394 

394`direnv allow` をすべおのディレクトリで 1 回実行しお、direnv が `.envrc` をロヌドするこずが蚱可されるようにしたす。direnv の代わりに devbox たたは nix を䜿甚する堎合、同じパタヌンは `direnv export bash` の代わりに `devbox shellenv` たたは `devbox global shellenv` で機胜したす。395`.envrc` があるディレクトリごずに䞀床 `direnv allow` を実行し、direnv がそのファむルを読み蟌めるようにしたす。direnv の代わりに devbox や nix を䜿甚しおいる堎合は、`direnv export bash` の代わりに `devbox shellenv` たたは `devbox global shellenv` を䜿甚すれば、同じパタヌンが機胜したす。

395 396 

396すべおのディレクトリ倉曎ではなく、特定のファむルに反応するには、`FileChanged` を `matcher` で䜿甚しお、監芖するファむル名をリストしたすパむプで区切られおいたす。りォッチリストを構築するために、この倀は正芏衚珟ずしお評䟡されるのではなく、リテラルファむル名に分割されたす。[FileChanged](/docs/ja/hooks#filechanged) を参照しお、同じ倀がファむルが倉曎されたずきにどの hook グルヌプが実行されるかをフィルタリングする方法を確認しおください。この䟋は珟圚のディレクトリの `.envrc` ず `.env` を監芖したす397ディレクトリの倉曎のたびではなく特定のファむルに反応させるには、監芖するファむル名を `|` で区切っお列挙した `matcher` を指定しお `FileChanged` を䜿甚したす。監芖リストを構築する際、Claude Code はこの倀を正芏衚珟ずしお評䟡するのではなく、リテラルのファむル名に分割したす。同じ倀が、ファむルの倉曎時にどのフックグルヌプを実行するかのフィルタリングにも䜿われる仕組みに぀いおは、[FileChanged](/docs/ja/hooks#filechanged) を参照しおください。この䟋では、䜜業ディレクトリ内の `.envrc` ず `.env` を監芖したす。

397 398 

398```json theme={null}399```json theme={null}

399{400{

413}414}

414```415```

415 416 

416入力スキヌマ、`watchPaths` 出力、および `CLAUDE_ENV_FILE` の詳现に぀いおは、[CwdChanged](/docs/ja/hooks#cwdchanged) および [FileChanged](/docs/ja/hooks#filechanged) リファレンス゚ントリを参照しおください。417入力スキヌマ、`watchPaths` の出力、`CLAUDE_ENV_FILE` の詳现に぀いおは、[CwdChanged](/docs/ja/hooks#cwdchanged) ず [FileChanged](/docs/ja/hooks#filechanged) のリファレンス項目を参照しおください。

417 418 

418### 特定の蚱可プロンプトを自動承認する419### 特定の暩限プロンプトを自動承認する

419 420 

420垞に蚱可するツヌル呌び出しの承認ダむアログをスキップしたす。この䟋は `ExitPlanMode` を自動承認したす。これは Claude がプランの提瀺を終了しお続行するよう求めるずきに呌び出すツヌルです。プランが準備できるたびにプロンプトが衚瀺されるこずはありたせん。421垞に蚱可しおいるツヌル呌び出しに぀いお、承認ダむアログをスキップしたす。この䟋では、Claude が蚈画の提瀺を終えお続行の承認を求める際に呌び出すツヌルである `ExitPlanMode` を自動承認するため、蚈画が準備できるたびにプロンプトが衚瀺されるこずはなくなりたす。

421 422 

422䞊蚘の終了コヌド䟋ずは異なり、自動承認には hook が JSON 決定を stdout に曞き蟌む必芁がありたす。Claude Code は `PermissionRequest` hook を実行したす。これは Claude Code が蚱可ダむアログを衚瀺しようずするずきに実行され、hook が `"behavior": "allow"` を返すず、Claude Code はあなたの代わりにリク゚ストに答えたす。423䞊蚘の終了コヌドの䟋ずは異なり、自動承認を行うには、フックが JSON の決定を stdout に曞き出す必芁がありたす。Claude Code は暩限を求めようずするずきに `PermissionRequest` フックを実行し、フックが `"behavior": "allow"` を返した堎合は、ナヌザヌに代わっおリク゚ストに応答したす。

423 424 

424マッチャヌは hook を `ExitPlanMode` のみにスコヌプするため、他のプロンプトは圱響を受けたせん。これを `~/.claude/settings.json` に远加したす425matcher によっおフックのスコヌプが `ExitPlanMode` のみに限定されるため、他のプロンプトには圱響したせん。これを `~/.claude/settings.json` に远加したす。

425 426 

426```json theme={null}427```json theme={null}

427{428{

441}442}

442```443```

443 444 

444Hook が承認するず、Claude Code は Plan Mode を終了し、Plan Mode に入る前にアクティブだった蚱可モヌドを埩元したす。トランスクリプトは、ダむアログが衚瀺されたはずの堎所に「Allowed by PermissionRequest hook」ず衚瀺されたす。Hook パスは垞に珟圚の䌚話を保持したすダむアログができるように、コンテキストをクリアしお新しい実装セッションを開始するこずはできたせん。445フックが承認するず、Claude Code は plan モヌドを終了し、plan モヌドに入る前に有効だった暩限モヌドを埩元したす。トランスクリプトには、ダむアログが衚瀺されるはずだった堎所に「Allowed by PermissionRequest hook」ず衚瀺されたす。フックを経由する堎合は垞に珟圚の䌚話が維持されたす。ダむアログのようにコンテキストをクリアしお新しい実装セッションを開始するこずはできたせん。

445 446 

446特定の蚱可モヌドを蚭定する代わりに、hook の出力に `setMode` ゚ントリを含む `updatedPermissions` 配列を含めるこずができたす。`mode` 倀は `default`、`acceptEdits`、たたは `bypassPermissions` などの任意の蚱可モヌドであり、`destination: "session"` は珟圚のセッションのみに適甚したす。447代わりに特定の暩限モヌドを蚭定するには、フックの出力に `setMode` ゚ントリを含む `updatedPermissions` 配列を含めたす。`mode` の倀には `default`、`acceptEdits`、`bypassPermissions` などの任意の暩限モヌドを指定し、`destination: "session"` を指定するず珟圚のセッションにのみ適甚されたす。

447 448 

448> [!NOTE]449> [!NOTE]

449>450>

450> `bypassPermissions` は、セッションが既にバむパスモヌドで起動された堎合にのみ適甚されたす`--dangerously-skip-permissions`、`--permission-mode bypassPermissions`、`--allow-dangerously-skip-permissions`、たたは [ナヌザヌ、`--settings`、たたは管理蚭定](/docs/ja/settings-reference#permissions-defaultmode) の `permissions.defaultMode: "bypassPermissions"`。[`permissions.disableBypassPermissionsMode`](/docs/ja/permissions#managed-settings) で無効化されおいる堎合、たたは [制限モヌド](/docs/ja/cli-reference#cli-flags) でセッションを開始した堎合は適甚されたせん。451> `bypassPermissions` は、バむパスモヌドがすでに利甚可胜な状態でセッションを開始した堎合にのみ適甚されたす。具䜓的には、`--dangerously-skip-permissions`、`--permission-mode bypassPermissions`、`--allow-dangerously-skip-permissions`、たたは[ナヌザヌ蚭定、`--settings`、管理蚭定](/docs/ja/settings-reference#permissions-defaultmode)での `permissions.defaultMode: "bypassPermissions"` のいずれかを䜿甚した堎合です。[`permissions.disableBypassPermissionsMode`](/docs/ja/permissions#managed-settings) によっおバむパスモヌドが無効化されおいる堎合や、[制限モヌド](/docs/ja/cli-reference#cli-flags)でセッションを開始した堎合は適甚されたせん。

451>452>

452> Claude Code は `defaultMode` ずしお氞続化するこずはありたせん。453> Claude Code がこれを `defaultMode` ずしお保存するこずはありたせん。

453 454 

454セッションを `acceptEdits` に切り替えるには、hook は stdout に次の JSON を曞き蟌みたす455セッションを `acceptEdits` に切り替えるには、フックが次の JSON を stdout に曞き出したす。

455 456 

456```json theme={null}457```json theme={null}

457{458{

467}468}

468```469```

469 470 

470マッチャヌをできるだけ狭く保ちたす。`.*` でマッチングするか、マッチャヌを空のたたにするず、ファむル曞き蟌みやシェルコマンドを含むすべおの蚱可プロンプトが自動承認されたす。決定フィヌルドの完党なセットに぀いおは、[PermissionRequest リファレンス](/docs/ja/hooks#permissionrequest-decision-control) を参照しおください。471matcher はできるだけ限定的にしおください。`.*` でマッチさせたり matcher を空のたたにしたりするず、ファむルの曞き蟌みやシェルコマンドを含む、すべおのツヌルの暩限プロンプトが自動承認されおしたいたす。決定フィヌルドの党䜓に぀いおは、[PermissionRequest リファレンス](/docs/ja/hooks#permissionrequest-decision-control)を参照しおください。

471 472 

472## hooks の仕組み473## hooks の仕組み

473 474 

632 633 

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

634 635 

6354 番目の倀 `"defer"` は、`-p` フラグ付きの [非むンタラクティブモヌド](/docs/ja/headless) で利甚可胜です。プロセスを終了し、ツヌル呌び出しを保持しお、Agent SDK ラッパヌが入力を収集しお再開できるようにしたす。リファレンスの [ツヌル呌び出しを埌で延期する](/docs/ja/hooks#defer-a-tool-call-for-later) を参照しおください。6364 番目の倀 `"defer"` は、`-p` フラグ付きの [非察話モヌド](/docs/ja/headless) で利甚可胜です。これを返すず、ツヌル呌び出しを保持したたたタヌンが終了するため、Agent SDK ラッパヌが入力を収集しお再開できたす。リファレンスの [ツヌル呌び出しを埌で延期する](/docs/ja/hooks#defer-a-tool-call-for-later) を参照しおください。

636 637 

637`PreModelSwitch` hook は同じ `permissionDecision` フィヌルドを返したす`"allow"` はモデルスむッチを進行させ、`"deny"` はそれをキャンセルしたす。`"ask"` はむンタラクティブセッションで `/model` を実行するずきに確認を求めたす。他の堎所では、Claude Code は `"ask"` を拒吊ずしお扱いたす。[PreModelSwitch 決定制埡](/docs/ja/hooks#premodelswitch-decision-control) を参照しおください。638`PreModelSwitch` hook は同じ `permissionDecision` フィヌルドを返したす`"allow"` はモデルスむッチを進行させ、`"deny"` はそれをキャンセルしたす。`"ask"` はむンタラクティブセッションで `/model` を実行するずきに確認を求めたす。他の堎所では、Claude Code は `"ask"` を拒吊ずしお扱いたす。[PreModelSwitch 決定制埡](/docs/ja/hooks#premodelswitch-decision-control) を参照しおください。

638 639 

686| `SessionStart` | セッションがどのように開始されたか | `startup`、`resume`、`clear`、`compact`、`fork` |687| `SessionStart` | セッションがどのように開始されたか | `startup`、`resume`、`clear`、`compact`、`fork` |

687| `Setup` | どの CLI フラグがセットアップをトリガヌしたか | `init`、`maintenance` |688| `Setup` | どの CLI フラグがセットアップをトリガヌしたか | `init`、`maintenance` |

688| `SessionEnd` | セッションが終了した理由 | `clear`、`resume`、`logout`、`prompt_input_exit`、`other` |689| `SessionEnd` | セッションが終了した理由 | `clear`、`resume`、`logout`、`prompt_input_exit`、`other` |

689| `Notification` | 通知タむプ | `permission_prompt`、`idle_prompt`、`auth_success`、`elicitation_dialog`、`elicitation_url_dialog`、`elicitation_complete`、`elicitation_response`、`agent_needs_input`、`agent_completed`、`quota_auto_resume_fired`、`quota_auto_resume_stale`、`quota_auto_resume_disabled` |690| `Notification` | 通知タむプ | `permission_prompt`、`idle_prompt`、`auth_success`、`elicitation_dialog`、`elicitation_url_dialog`、`elicitation_complete`、`elicitation_response`、`agent_needs_input`、`agent_completed`、`quota_auto_resume_fired`、`quota_auto_resume_stale`、`quota_auto_resume_disabled`、`plugin_notification` |

690| `SubagentStart` | ゚ヌゞェントタむプ | `general-purpose`、`Explore`、`Plan`、たたはカスタム゚ヌゞェント名 |691| `SubagentStart` | ゚ヌゞェントタむプ | `general-purpose`、`Explore`、`Plan`、たたはカスタム゚ヌゞェント名 |

691| `PreCompact`、`PostCompact` | 圧瞮をトリガヌしたもの | `manual`、`auto` |692| `PreCompact`、`PostCompact` | 圧瞮をトリガヌしたもの | `manual`、`auto` |

692| `PreModelSwitch`、`PostModelSwitch` | セッションが切り替わるモデルの正芏名[PreModelSwitch](/docs/ja/hooks#premodelswitch) で説明 | `claude-opus-5`、`claude-opus-4-6\|claude-opus-5`、`.*opus.*` |693| `PreModelSwitch`、`PostModelSwitch` | セッションが切り替わるモデルの正芏名[PreModelSwitch](/docs/ja/hooks#premodelswitch) で説明 | `claude-opus-5`、`claude-opus-4-6\|claude-opus-5`、`.*opus.*` |

interactive-mode.md +23 −1

Details

18 18 

19| ショヌトカット | 説明 | コンテキスト |19| ショヌトカット | 説明 | コンテキスト |

20| :- | :- | :- |20| :- | :- | :- |

21| `Ctrl+C` | 割り蟌み、たたは入力をクリア | 実行䞭の操䜜を割り蟌みたす。䜕も実行されおいない堎合、最初のプレスはプロンプト入力をクリアし、2 番目のプレスで Claude Code を終了したす。プロンプトが空のたたの間に `Up` を抌すず、クリアされたドラフトが戻りたす。これには Claude Code v2.1.288 以降が必芁です |21| `Ctrl+C` | 割り蟌み、たたは入力をクリア | 実行䞭の操䜜を割り蟌みたす。䜕も実行されおいない堎合、最初のプレスはプロンプト入力をクリアし、2 番目のプレスで Claude Code を終了したす。クリアされたドラフトを元に戻すには、[クリアされたドラフトを元に戻す](#bring-back-a-cleared-draft)を参照しおください |

22| `Ctrl+X Ctrl+K` | このセッション内のすべおの実行䞭の[バックグラりンドサブ゚ヌゞェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)を停止し、[アヌティファクト自動返信](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own)をセッションの残りの郚分で無効にしたす。3 秒以内に 2 回抌しお確認したす。バックグラりンドサブ゚ヌゞェントの暩限プロンプトが開いおいる間も抌すこずができたす | サブ゚ヌゞェント制埡 |22| `Ctrl+X Ctrl+K` | このセッション内のすべおの実行䞭の[バックグラりンドサブ゚ヌゞェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)を停止し、[アヌティファクト自動返信](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own)をセッションの残りの郚分で無効にしたす。3 秒以内に 2 回抌しお確認したす。バックグラりンドサブ゚ヌゞェントの暩限プロンプトが開いおいる間も抌すこずができたす | サブ゚ヌゞェント制埡 |

23| `Ctrl+D` | Claude Code セッションを終了 | 最初のプレスで確認ヒントが衚瀺され、800ms 以内に 2 番目のプレスで終了したす。プロンプトにテキストがある堎合、`Ctrl+D` はカヌ゜ルの埌の文字を削陀したす |23| `Ctrl+D` | Claude Code セッションを終了 | 最初のプレスで確認ヒントが衚瀺され、800ms 以内に 2 番目のプレスで終了したす。プロンプトにテキストがある堎合、`Ctrl+D` はカヌ゜ルの埌の文字を削陀したす |

24| `Ctrl+G` たたは `Ctrl+X Ctrl+E` | デフォルトテキスト゚ディタで開く | プロンプトたたはカスタム応答をデフォルトテキスト゚ディタで線集したす。`Ctrl+X Ctrl+E` は readline ネむティブバむンディングです。`/config` で**倖郚゚ディタで最埌の応答を衚瀺**をオンにするず、Claude の前の返信を `#` コメント付きコンテキストずしおプロンプトの䞊に远加したす。Claude Code は保存時にコメントブロックを削陀したす |24| `Ctrl+G` たたは `Ctrl+X Ctrl+E` | デフォルトテキスト゚ディタで開く | プロンプトたたはカスタム応答をデフォルトテキスト゚ディタで線集したす。`Ctrl+X Ctrl+E` は readline ネむティブバむンディングです。`/config` で**倖郚゚ディタで最埌の応答を衚瀺**をオンにするず、Claude の前の返信を `#` コメント付きコンテキストずしおプロンプトの䞊に远加したす。Claude Code は保存時にコメントブロックを削陀したす |

262 262 

263`Ctrl+V` を䜿甚したブロック単䜍のビゞュアルモヌドはサポヌトされおいたせん。263`Ctrl+V` を䜿甚したブロック単䜍のビゞュアルモヌドはサポヌトされおいたせん。

264 264 

265### vim モヌドで質問をキャンセル

266 

267[Claude が尋ねる質問](/docs/ja/tools-reference#askuserquestion-tool-behavior)の `Other` 行に自分の回答を入力しおいるずきは、`Esc` を 2 回抌すず質問をキャンセルできたす。

268 

269代わりに 1 回のキヌ抌䞋でキャンセルするには、[質問をキャンセルする別のキヌをバむンド](/docs/ja/keybindings#cancel-a-question-with-one-key-press)したす。

270 

265## コマンド履歎271## コマンド履歎

266 272 

267Claude Code はあなたが入力したプロンプトの履歎を保持し、䞊矢印キヌでの呌び出しは同じプロゞェクトの過去のセッションからプロンプトを取埗したす。273Claude Code はあなたが入力したプロンプトの履歎を保持し、䞊矢印キヌでの呌び出しは同じプロゞェクトの過去のセッションからプロンプトを取埗したす。

272* 貌り付けたテキストを含むプロンプトを呌び出すず、再床送信する際に Claude Code は完党な貌り付けコンテンツを送信したす。コンテンツが [自動的にクリヌンアップ](/docs/ja/claude-directory#cleaned-up-automatically) されおいる堎合、Claude Code は文字通りの `[Pasted text #N]` 文字列を送信したせん。プロンプトに䜕が起こるかに぀いおは、[倧きなコンテンツを貌り付ける](/docs/ja/terminal-config#paste-large-content) を参照しおください278* 貌り付けたテキストを含むプロンプトを呌び出すず、再床送信する際に Claude Code は完党な貌り付けコンテンツを送信したす。コンテンツが [自動的にクリヌンアップ](/docs/ja/claude-directory#cleaned-up-automatically) されおいる堎合、Claude Code は文字通りの `[Pasted text #N]` 文字列を送信したせん。プロンプトに䜕が起こるかに぀いおは、[倧きなコンテンツを貌り付ける](/docs/ja/terminal-config#paste-large-content) を参照しおください

273* `!` を䜿甚した履歎展開はデフォルトで無効になっおいたす279* `!` を䜿甚した履歎展開はデフォルトで無効になっおいたす

274 280 

281### クリアした䞋曞きを埩元する

282 

283`Ctrl+C` でクリアした䞋曞きを埩元するには、クリアした盎埌、たたはメッセヌゞやコマンドを送信した埌に `Up` を抌したす。

284 

285* **䞋曞きをクリアした盎埌**: プロンプトが空のたたの状態で `Up` を 1 回抌したす。Claude Code v2.1.288 以降が必芁です。

286* **メッセヌゞたたはコマンドを送信した埌**: `Up` を抌しお䞋曞きたで戻りたす。Claude Code は珟圚のセッションでクリアされた盎近 10 件の䞋曞きを、貌り付けたテキストや画像ずずもに保持し、終了時に砎棄したす。Claude Code v2.1.292 以降が必芁です。

287 

275### Ctrl+R での逆方向怜玢288### Ctrl+R での逆方向怜玢

276 289 

277`Ctrl+R` を抌しおコマンド履歎をむンタラクティブに怜玢したす。[フルスクリヌンレンダリング](/docs/ja/fullscreen) では、`Ctrl+R` は怜玢ダむアログを開きたす。入力しおフィルタリングし、`Up` ず `Down` を抌しおマッチを移動し、`Ctrl+S` を抌しおスコヌプをこのセッション、このプロゞェクト、すべおのプロゞェクトの間で埪環させたす。`Enter` たたは `Tab` を抌しおマッチをプロンプト入力に配眮するか、`Esc` を抌しおキャンセルしたす。以䞋のステップは、クラシックレンダラヌのむンラむン怜玢に぀いお説明しおいたす。290`Ctrl+R` を抌しおコマンド履歎をむンタラクティブに怜玢したす。[フルスクリヌンレンダリング](/docs/ja/fullscreen) では、`Ctrl+R` は怜玢ダむアログを開きたす。入力しおフィルタリングし、`Up` ず `Down` を抌しおマッチを移動し、`Ctrl+S` を抌しおスコヌプをこのセッション、このプロゞェクト、すべおのプロゞェクトの間で埪環させたす。`Enter` たたは `Tab` を抌しおマッチをプロンプト入力に配眮するか、`Esc` を抌しおキャンセルしたす。以䞋のステップは、クラシックレンダラヌのむンラむン怜玢に぀いお説明しおいたす。

386* [`/effort`](/docs/ja/model-config#adjust-effort-level)Claude Code が[キャッシュ譊告](/docs/ja/prompt-caching#changing-effort-level)を衚瀺する堎合は、確認埌、Claude Code はそのタヌン内で次に行うリク゚ストに倉曎を適甚したす。399* [`/effort`](/docs/ja/model-config#adjust-effort-level)Claude Code が[キャッシュ譊告](/docs/ja/prompt-caching#changing-effort-level)を衚瀺する堎合は、確認埌、Claude Code はそのタヌン内で次に行うリク゚ストに倉曎を適甚したす。

387* [`/fast`](/docs/ja/fast-mode#toggle-fast-mode)Claude Code はタヌンが開始されたずきにアクティブだった fast mode 蚭定を保持するため、速床の倉曎は次のタヌンから適甚されたす。珟圚のモデルが fast mode をサポヌトしおいない堎合、それをオンにするず[モデルも切り替わり](/docs/ja/prompt-caching#turning-on-fast-mode)、Claude Code はそのタヌン内で次に行うリク゚ストから新しいモデルを䜿甚したす。400* [`/fast`](/docs/ja/fast-mode#toggle-fast-mode)Claude Code はタヌンが開始されたずきにアクティブだった fast mode 蚭定を保持するため、速床の倉曎は次のタヌンから適甚されたす。珟圚のモデルが fast mode をサポヌトしおいない堎合、それをオンにするず[モデルも切り替わり](/docs/ja/prompt-caching#turning-on-fast-mode)、Claude Code はそのタヌン内で次に行うリク゚ストから新しいモデルを䜿甚したす。

388 401 

402### メッセヌゞをキュヌに入れたたたセッションをバックグラりンドに移動する

403 

404[`←` を抌した](/docs/ja/agent-view#switch-sessions-without-leaving-the-terminal)埌にセッションがバックグラりンドに移動するず、キュヌに入れおいたメッセヌゞもセッションずずもに移動したす。Claude は移動先で、送信した順序でそれらを読みたす。

405 

406コマンドず `!` シェルコマンドは移動できたせん。たた、[IDE の遞択](/docs/ja/vs-code#the-built-in-ide-mcp-server)が付いたメッセヌゞなど、䞀郚のメッセヌゞも移動できたせん。これらのいずれかがキュヌに入っおいる間に `←` を抌すず、セッションはフォアグラりンドに留たり、`Cannot open agents` で始たる通知が衚瀺されたす。セッションをバックグラりンドに移動するには、その゚ントリをキュヌから取り陀いおから、もう䞀床 `←` を抌したす。

407 

408* **コマンドず `!` シェルコマンド**タヌンの終了時に実行されるのを埅぀か、[取り戻しお](#take-back-what-you-queued)入力ボックスをクリアしたす。他に䜕かがキュヌに入っおいる間は `!` シェルコマンドを取り戻せないため、実行されるのを埅っおください。

409* **移動できないメッセヌゞ**Claude がそれらを読むたで埅ちたす

410 

389### キュヌに入れたものを取り戻す411### キュヌに入れたものを取り戻す

390 412 

391入力ボックスの最初の行から `Up` キヌを抌すず、キュヌに入れたメッセヌゞずコマンドを取り戻すこずができたす。Claude Code はそれらをキュヌから削陀し、入力ボックスに 1 行に 1 ぀ず぀、入力しおいたテキストの前に配眮したす。テキストを線集しお `Enter` キヌを抌すず、1 ぀の゚ントリずしお再床キュヌに入れられたす。たたは、入力ボックスをクリアしお削陀したす。413入力ボックスの最初の行から `Up` キヌを抌すず、キュヌに入れたメッセヌゞずコマンドを取り戻すこずができたす。Claude Code はそれらをキュヌから削陀し、入力ボックスに 1 行に 1 ぀ず぀、入力しおいたテキストの前に配眮したす。テキストを線集しお `Enter` キヌを抌すず、1 ぀の゚ントリずしお再床キュヌに入れられたす。たたは、入力ボックスをクリアしお削陀したす。

keybindings.md +23 −0

Details

446| :- | :- | :- |446| :- | :- | :- |

447| `settings:search` | / | 怜玢モヌドに入る |447| `settings:search` | / | 怜玢モヌドに入る |

448| `settings:retry` | R | ゚ラヌ時に䜿甚デヌタの読み蟌みを再詊行 |448| `settings:retry` | R | ゚ラヌ時に䜿甚デヌタの読み蟌みを再詊行 |

449| `settings:fixUsage` | F | `/usage` フッタヌが修正を提瀺しおいる堎合に、Claude Code が適甚できる [`/usage` の掚奚事項](/docs/ja/costs#apply-recommendations-with-the-fix-shortcut) をセッションに送信したす。v2.1.305 以降が必芁 |

449| `select:accept` | Enter、Space | 遞択した蚭定を倉曎たたはそのサブメニュヌを開く |450| `select:accept` | Enter、Space | 遞択した蚭定を倉曎たたはそのサブメニュヌを開く |

450| `confirm:no` | Escape | パネルを閉じたす。倉曎は既に保存されおいたす |451| `confirm:no` | Escape | パネルを閉じたす。倉曎は既に保存されおいたす |

451 452 

688 689 

689Claude が尋ねる質問の `Other` 行では、Vim モヌドで Escape を抌しおも質問はすぐにはキャンセルされたせん。[スクリヌンリヌダヌモヌド](/docs/ja/accessibility)の堎合を陀き、この行はフォヌカスするたびに INSERT モヌドで開始されたす。`Other` 行で Escape を抌すず、行が NORMAL モヌドに切り替わるか、入力途䞭の Vim コマンドが砎棄され、質問は開いたたたになりたす。質問をキャンセルするには、NORMAL モヌドで Escape をもう䞀床抌しおください。690Claude が尋ねる質問の `Other` 行では、Vim モヌドで Escape を抌しおも質問はすぐにはキャンセルされたせん。[スクリヌンリヌダヌモヌド](/docs/ja/accessibility)の堎合を陀き、この行はフォヌカスするたびに INSERT モヌドで開始されたす。`Other` 行で Escape を抌すず、行が NORMAL モヌドに切り替わるか、入力途䞭の Vim コマンドが砎棄され、質問は開いたたたになりたす。質問をキャンセルするには、NORMAL モヌドで Escape をもう䞀床抌しおください。

690 691 

692### 1 回のキヌ操䜜で質問をキャンセルする

693 

694Vim モヌドで 1 回のキヌ操䜜で質問をキャンセルするには、`Select` コンテキストで別のキヌを `select:cancel` にバむンドしたす。この方法では、1 ぀のオプションを遞択する質問の `Other` 行からキャンセルできたす。[スクリヌンリヌダヌモヌド](/docs/ja/accessibility)や、耇数のオプションを遞択できる質問では、バむンドしたキヌではキャンセルされないため、代わりに Escape でキャンセルしおください。

695 

696Ctrl たたは Alt ず組み合わせお抌すキヌを遞んでください。修食キヌなしの文字や数字は代わりに [`Other` 行に入力され](#text-fields)、蚭定したバむンディングには届きたせん。たずえば `Ctrl+Q` をバむンドするには、`~/.claude/keybindings.json` に次の内容を远加したす。

697 

698```json theme={null}

699{

700 "bindings": [

701 {

702 "context": "Select",

703 "bindings": {

704 "ctrl+q": "select:cancel"

705 }

706 }

707 ]

708}

709```

710 

711ファむルを保存したら、1 ぀のオプションを遞択する質問の `Other` 行で `Ctrl+Q` を抌したす。行が INSERT モヌドでも NORMAL モヌドでも、質問は閉じたす。

712 

691## 怜蚌713## 怜蚌

692 714 

693Claude Code はキヌバむンディングを怜蚌し、以䞋の譊告をデバッグログに曞き蟌みたす。715Claude Code はキヌバむンディングを怜蚌し、以䞋の譊告をデバッグログに曞き蟌みたす。

694 716 

695* 解析゚ラヌ無効な JSON たたは構造717* 解析゚ラヌ無効な JSON たたは構造

696* スペルミスのあるモディファむア䟋`ctl+k`。Claude Code は認識できない郚分を削陀し、残りのキヌストロヌクにバむンディングを適甚したす。この䟋では `k` です。718* スペルミスのあるモディファむア䟋`ctl+k`。Claude Code は認識できない郚分を削陀し、残りのキヌストロヌクにバむンディングを適甚したす。この䟋では `k` です。

719* キヌ文字列内の `+` の隣にあるスペヌス䟋`ctrl+ k`。Claude Code はこの文字列を、`ctrl+` の埌に `k` が続く[コヌド](#chords)ずしお読み取りたす。`ctrl+` 単独に䞀臎するキヌ入力はないため、このバむンディングは発火したせん。スペヌスを削陀しおください。

697* 無効なコンテキスト名720* 無効なコンテキスト名

698* 無効なアクション倀アクションが文字列たたは `null` ではない堎合など721* 無効なアクション倀アクションが文字列たたは `null` ではない堎合など

699* 䞍明なアクション名登録されたアクションのタむプミスなど。Claude Code はバむンディングをスキップし、そのキヌのデフォルトバむンディングを有効に保ちたす。722* 䞍明なアクション名登録されたアクションのタむプミスなど。Claude Code はバむンディングをスキップし、そのキヌのデフォルトバむンディングを有効に保ちたす。

large-codebases.md +2 −2

Details

141* `"**/packages/legacy-*/**"`: グロブに䞀臎する名前のすべおのパッケヌゞを陀倖したす。ルヌルを含みたす141* `"**/packages/legacy-*/**"`: グロブに䞀臎する名前のすべおのパッケヌゞを陀倖したす。ルヌルを含みたす

142* `"/home/user/monorepo/legacy/CLAUDE.md"`: 絶察パスで 1 ぀の特定のファむルを陀倖したす142* `"/home/user/monorepo/legacy/CLAUDE.md"`: 絶察パスで 1 ぀の特定のファむルを陀倖したす

143 143 

144管理ポリシヌ CLAUDE.md ファむルは陀倖できないため、組織党䜓の呜什は垞に適甚されたす。`claudeMdExcludes` は任意の [蚭定スコヌプ](/docs/ja/settings#where-settings-live)で蚭定できたす。ナヌザヌ、プロゞェクト、ロヌカル、たたは管理。配列はスコヌプ党䜓でマヌゞされるため、チヌムはプロゞェクトレベルのデフォルトを蚭定でき、個人はロヌカルオヌバヌラむドを远加できたす。144`claudeMdExcludes` は任意の[蚭定スコヌプ](/docs/ja/settings#where-settings-live)ナヌザヌ、プロゞェクト、ロヌカル、たたは管理で蚭定できたす。配列はスコヌプ党䜓でマヌゞされるため、チヌムはプロゞェクトレベルのデフォルトを蚭定し、個人はロヌカルの䞊曞きを远加できたす。組織が[管理 CLAUDE.md ファむル](/docs/ja/memory#deploy-organization-wide-claude-md)をデプロむしおいる堎合、どのスコヌプでパタヌンを蚭定しおいおも、そのファむルに䞀臎するパタヌンによっおスキップされるこずはありたせん。

145 145 

146完党な陀倖ドキュメントに぀いおは、[特定の CLAUDE.md ファむルを陀倖](/docs/ja/memory#exclude-specific-claude-md-files)を参照しおください。146完党な陀倖ドキュメントに぀いおは、[特定の CLAUDE.md ファむルを陀倖](/docs/ja/memory#exclude-specific-claude-md-files)を参照しおください。

147 147 

349 349 

350別のサブディレクトリは同じ方法で異なるスキルを保持したす。`packages/web/.claude/skills/component-patterns/` はテストの代わりにフロント゚ンドのコンポヌネント芏玄を説明したす。Claude が `packages/api/` のファむルで䜜業するずき、api-testing スキルを読み蟌みたす。`packages/web/` で䜜業するずき、component-patterns を読み蟌みたす。どちらのディレクトリのスキルも他方のタスク䞭には読み蟌たれたせん。350別のサブディレクトリは同じ方法で異なるスキルを保持したす。`packages/web/.claude/skills/component-patterns/` はテストの代わりにフロント゚ンドのコンポヌネント芏玄を説明したす。Claude が `packages/api/` のファむルで䜜業するずき、api-testing スキルを読み蟌みたす。`packages/web/` で䜜業するずき、component-patterns を読み蟌みたす。どちらのディレクトリのスキルも他方のタスク䞭には読み蟌たれたせん。

351 351 

352配眮の代わりにファむルパタヌンでスキルをスコヌプするこずもできたす。[`paths` frontmatter フィヌルド](/docs/ja/skills#frontmatter-reference)はグロブパタヌンを受け取り、Claude は䞀臎するファむルで䜜業するずきのみ自動的にスキルを読み蟌みたす。これをリポゞトリルヌトの `.claude/skills/` に存圚するスキルに䜿甚しお、デヌタベヌスマむグレヌションスキルなど `**/migrations/**` にスコヌプされた特定のファむルにのみ適甚したす。352配眮の代わりにファむルパタヌンでスキルをスコヌプするこずもできたす。[`paths` フロントマタヌフィヌルド](/docs/ja/skills#frontmatter-reference)はグロブパタヌンを受け取り、Claude は䞀臎するファむルで䜜業するずきのみ自動的にスキルを読み蟌みたす。これをリポゞトリルヌトの `.claude/skills/` に存圚するスキルに䜿甚しお、デヌタベヌスマむグレヌションスキルなど `**/migrations/**` にスコヌプされた特定のファむルにのみ適甚したす。

353 353 

354スキルの䜜成ず敎理の詳现に぀いおは、[スキル](/docs/ja/skills)を参照しおください。354スキルの䜜成ず敎理の詳现に぀いおは、[スキル](/docs/ja/skills)を参照しおください。

355 355 

Details

513| `Your apiKeyHelper script is failing`、たたは非察話型モヌドで stderr に `apiKeyHelper failed:` | [`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper) 蚭定のコマンドが䜿甚可胜なキヌを生成しなかったため、リク゚ストはプレヌスホルダヌキヌを含みたす | コマンドを盎接実行しお倱敗の理由を確認し、期限切れセッションを報告する堎合は認蚌情報プロバむダヌで再認蚌したす。[゚ラヌリファレンス](/docs/ja/errors#your-apikeyhelper-script-is-failing)を参照しおください |513| `Your apiKeyHelper script is failing`、たたは非察話型モヌドで stderr に `apiKeyHelper failed:` | [`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper) 蚭定のコマンドが䜿甚可胜なキヌを生成しなかったため、リク゚ストはプレヌスホルダヌキヌを含みたす | コマンドを盎接実行しお倱敗の理由を確認し、期限切れセッションを報告する堎合は認蚌情報プロバむダヌで再認蚌したす。[゚ラヌリファレンス](/docs/ja/errors#your-apikeyhelper-script-is-failing)を参照しおください |

514| アドレスで䜕も応答しない堎合は `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)`、たたはホスト名が解決しない堎合は `Can't reach the API server — check your internet or DNS (ENOTFOUND)`。倚くの堎合、Claude Code が[バックオフで再詊行](/docs/ja/errors#automatic-retries)しおいる間の静かな䞀時停止の埌です。括匧内のコヌドは異なりたす。[Unable to connect to API](/docs/ja/errors#unable-to-connect-to-api) はコヌドのスペルず以前の衚珟をカバヌしおいたす | 基本 URL で䜕も応答したせん。アドレスが間違っおいるか、VPN たたはファむアりォヌルがゲヌトりェむぞのパスをブロックしおいたす | 䞊蚘の [curl テスト](#verify-the-connection)を実行したす。これは同じ原因で盎ちに倱敗し、URL ずネットワヌクパスをゲヌトりェむチヌムで確認したす |514| アドレスで䜕も応答しない堎合は `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)`、たたはホスト名が解決しない堎合は `Can't reach the API server — check your internet or DNS (ENOTFOUND)`。倚くの堎合、Claude Code が[バックオフで再詊行](/docs/ja/errors#automatic-retries)しおいる間の静かな䞀時停止の埌です。括匧内のコヌドは異なりたす。[Unable to connect to API](/docs/ja/errors#unable-to-connect-to-api) はコヌドのスペルず以前の衚珟をカバヌしおいたす | 基本 URL で䜕も応答したせん。アドレスが間違っおいるか、VPN たたはファむアりォヌルがゲヌトりェむぞのパスをブロックしおいたす | 䞊蚘の [curl テスト](#verify-the-connection)を実行したす。これは同じ原因で盎ちに倱敗し、URL ずネットワヌクパスをゲヌトりェむチヌムで確認したす |

515| `API returned an empty or malformed response (HTTP 200)` | ゲヌトりェむたたは䞭間プロキシが非 API レスポンス倚くの堎合 HTML ゚ラヌたたはログむンペヌゞを返したした | 䞊蚘の [curl リク゚スト](#verify-the-connection)でテストしたす。Claude API レスポンス以倖で応答するゲヌトりェむルヌトを修正したす。[゚ラヌリファレンス](/docs/ja/errors#api-returned-an-empty-or-malformed-response)はメッセヌゞが報告する詳现を説明しおいたす |515| `API returned an empty or malformed response (HTTP 200)` | ゲヌトりェむたたは䞭間プロキシが非 API レスポンス倚くの堎合 HTML ゚ラヌたたはログむンペヌゞを返したした | 䞊蚘の [curl リク゚スト](#verify-the-connection)でテストしたす。Claude API レスポンス以倖で応答するゲヌトりェむルヌトを修正したす。[゚ラヌリファレンス](/docs/ja/errors#api-returned-an-empty-or-malformed-response)はメッセヌゞが報告する詳现を説明しおいたす |

516| `context_management`、`Extra inputs are not permitted`、たたは他の認識されないフィヌルドずいう名前の `400` ゚ラヌ | ゲヌトりェむは Anthropic 圢匏゚ンドポむントに Claude Code が送信するフィヌルドを拒吊する䞊流にリク゚ストを転送したす | `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` を蚭定したす。これはほずんどのプレリリヌスフィヌルドを抑制したす。[機胜パススルヌ](/docs/ja/llm-gateway-protocol#feature-pass-through)を参照しおください。䞀郚のベヌタはこのフラグでゲヌトされおいたせん。それらに぀いおは、䞀臎する `CLAUDE_CODE_USE_*` プロバむダヌ倉数を蚭定しお、Claude Code がそのプロバむダヌが受け入れるもののみを送信するようにしたす |516| `context_management`、`Extra inputs are not permitted`、たたは他の認識されないフィヌルドずいう名前の `400` ゚ラヌ | ゲヌトりェむは Anthropic 圢匏゚ンドポむントに Claude Code が送信するフィヌルドを拒吊する䞊流にリク゚ストを転送したす | `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` を蚭定したす。これはほずんどのプレリリヌスフィヌルドを抑制したす。[機胜パススルヌ](/docs/ja/llm-gateway-protocol#feature-pass-through)を参照しおください。䞀郚のベヌタはこのフラグでゲヌトされおいたせん。それらに぀いおは、䞀臎する `CLAUDE_CODE_USE_*` プロバむダヌ倉数を蚭定しお、Claude Code がそのプロバむダヌが受け入れるもののみを送信するようにしたす。メッセヌゞが瀺すフィヌルドに応じた手順に぀いおは、[Extra inputs are not permitted](/docs/ja/errors#extra-inputs-are-not-permitted) を参照しおください |

517| `thinking` たたは `adaptive` ずいう名前の `400` ゚ラヌ`Input tag 'adaptive' found` など | 䞊流モデルビルドは、Claude Code が Claude Opus 4.6、Claude Sonnet 4.6、Claude Haiku 5.5、Claude Fable 5 以降のモデルに芁求する適応掚論を受け入れたせん | ゲヌトりェむの䞊流をアップグレヌドしたす。Opus 4.6 ず Sonnet 4.6 では、代わりに `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` が機胜したす。[モデル蚭定](/docs/ja/model-config)機胜倉数は、`CLAUDE_CODE_USE_BEDROCK` や `CLAUDE_CODE_USE_VERTEX` などのプロバむダヌ蚭定にのみ適甚され、`ANTHROPIC_BASE_URL` ゲヌトりェむの背埌には適甚されたせん |517| `thinking` たたは `adaptive` ずいう名前の `400` ゚ラヌ`Input tag 'adaptive' found` など | 䞊流モデルビルドは、Claude Code が Claude Opus 4.6、Claude Sonnet 4.6、Claude Haiku 5.5、Claude Fable 5 以降のモデルに芁求する適応掚論を受け入れたせん | ゲヌトりェむの䞊流をアップグレヌドしたす。Opus 4.6 ず Sonnet 4.6 では、代わりに `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` が機胜したす。[モデル蚭定](/docs/ja/model-config)機胜倉数は、`CLAUDE_CODE_USE_BEDROCK` や `CLAUDE_CODE_USE_VERTEX` などのプロバむダヌ蚭定にのみ適甚され、`ANTHROPIC_BASE_URL` ゲヌトりェむの背埌には適甚されたせん |

518| ゲヌトりェむ独自の蚀葉でコンテキストたたはトヌクン制限を述べる `400` ゚ラヌ`ContextWindowExceededError` たたは `prompt token count of N exceeds the limit of M` など | ゲヌトりェむはモデルのネむティブりィンドりより小さいコンテキストを匷制し、䞊流゚ラヌを曞き盎すため、Claude Code は[長すぎる゚ラヌ](/docs/ja/errors#prompt-is-too-long)ずしお認識せず、自動的にコンパクト化しお再詊行したせん | `/compact` を実行しおセッションを埩旧したす。防ぐには、`CLAUDE_CODE_AUTO_COMPACT_WINDOW` をゲヌトりェむの制限に蚭定したす。Claude Code は倀を少なくずも 100,000 トヌクン、最倧でもモデルのコンテキストりィンドりにクランプするため、100,000 未満のゲヌトりェむ制限は䞀臎できず、`/compact` はそこでの埩旧のたたです。たた、`CLAUDE_CODE_MAX_OUTPUT_TOKENS` をゲヌトりェむモデルの出力制限より䞋に蚭定したす |518| ゲヌトりェむ独自の蚀葉でコンテキストたたはトヌクン制限を述べる `400` ゚ラヌ`ContextWindowExceededError` たたは `prompt token count of N exceeds the limit of M` など | ゲヌトりェむはモデルのネむティブりィンドりより小さいコンテキストを匷制し、䞊流゚ラヌを曞き盎すため、Claude Code は[長すぎる゚ラヌ](/docs/ja/errors#prompt-is-too-long)ずしお認識せず、自動的にコンパクト化しお再詊行したせん | `/compact` を実行しおセッションを埩旧したす。防ぐには、`CLAUDE_CODE_AUTO_COMPACT_WINDOW` をゲヌトりェむの制限に蚭定したす。Claude Code は倀を少なくずも 100,000 トヌクン、最倧でもモデルのコンテキストりィンドりにクランプするため、100,000 未満のゲヌトりェむ制限は䞀臎できず、`/compact` はそこでの埩旧のたたです。たた、`CLAUDE_CODE_MAX_OUTPUT_TOKENS` をゲヌトりェむモデルの出力制限より䞋に蚭定したす |

519| Claude Code v2.1.265 から v2.1.267 で、ツヌルの入力スキヌマたたはその `pattern` を拒吊するゲヌトりェむ独自の蚀葉での `400` ゚ラヌ | これらのバヌゞョンでの段階的なロヌルアりトで、[Artifact ツヌル](/docs/ja/artifacts#availability)スキヌマは `\p{...}` Unicode 文字クラスを持぀正芏衚珟を含みたす。Anthropic API はそれを受け入れたすが、各ツヌルスキヌマの `pattern` を独自の正芏衚珟゚ンゞンでチェックするゲヌトりェむたたは䞊流は、リク゚スト党䜓を拒吊したす | v2.1.268 以降に曎新したす。これは正芏衚珟を送信したせん。圱響を受けるバヌゞョンでは、[アヌティファクトをオフにしたす](/docs/ja/artifacts#disable-artifacts)。これはツヌルずそのスキヌマをリク゚ストから削陀したす |519| Claude Code v2.1.265 から v2.1.267 で、ツヌルの入力スキヌマたたはその `pattern` を拒吊するゲヌトりェむ独自の蚀葉での `400` ゚ラヌ | これらのバヌゞョンでの段階的なロヌルアりトで、[Artifact ツヌル](/docs/ja/artifacts#availability)スキヌマは `\p{...}` Unicode 文字クラスを持぀正芏衚珟を含みたす。Anthropic API はそれを受け入れたすが、各ツヌルスキヌマの `pattern` を独自の正芏衚珟゚ンゞンでチェックするゲヌトりェむたたは䞊流は、リク゚スト党䜓を拒吊したす | v2.1.268 以降に曎新したす。これは正芏衚珟を送信したせん。圱響を受けるバヌゞョンでは、[アヌティファクトをオフにしたす](/docs/ja/artifacts#disable-artifacts)。これはツヌルずそのスキヌマをリク゚ストから削陀したす |

Details

84 84 

85アップストリヌムが Amazon Bedrock たたは Google Cloud's Agent Platform である堎合は、代わりにそのプロバむダヌのフォヌマットを公開するこずで、橋枡しを回避できたす。そのフォヌマットのクラむアント蚭定に぀いおは、[ゲヌトりェむ経由でクラりドプロバむダヌにルヌティングする](/docs/ja/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway)を参照しおください。85アップストリヌムが Amazon Bedrock たたは Google Cloud's Agent Platform である堎合は、代わりにそのプロバむダヌのフォヌマットを公開するこずで、橋枡しを回避できたす。そのフォヌマットのクラむアント蚭定に぀いおは、[ゲヌトりェむ経由でクラりドプロバむダヌにルヌティングする](/docs/ja/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway)を参照しおください。

86 86 

87## 接続方法がクラむアント動䜜にどのように圱響するか87## 接続方法によるクラむアントの動䜜の違い

88 88 

89開発者がゲヌトりェむに接続する方法によっお、Claude Code が送信するモデル ID、`anthropic-beta` 倀、リク゚ストフィヌルド、および適甚するデフォルトが決たりたす。ゲヌトりェむは、次の 3 ぀のクラむアント動䜜のいずれかを認識したす。89開発者がゲヌトりェむにどのように接続するかによっお、Claude Code が送信するモデル ID、`anthropic-beta` の倀、リク゚ストフィヌルド、および適甚するデフォルトが決たりたす。ゲヌトりェむから芋えるクラむアントの動䜜は、次の 3 ぀のいずれかです。

90 90 

91* **Amazon Bedrock たたは Agent Platform 圢匏**: 開発者が `CLAUDE_CODE_USE_BEDROCK=1` を `ANTHROPIC_BEDROCK_BASE_URL` ず共に蚭定するか、`CLAUDE_CODE_USE_VERTEX=1` を `ANTHROPIC_VERTEX_BASE_URL` ず共に蚭定しお、ゲヌトりェむを指したす。Claude Code はそのプロバむダヌのモデル ID、リク゚ストフィヌルド、およびデフォルトを䜿甚したす。91* **Amazon Bedrock たたは Agent Platform 圢匏**開発者が `CLAUDE_CODE_USE_BEDROCK=1` ず `ANTHROPIC_BEDROCK_BASE_URL`、たたは `CLAUDE_CODE_USE_VERTEX=1` ず `ANTHROPIC_VERTEX_BASE_URL` を蚭定し、ゲヌトりェむを指すようにしたす。Claude Code はそのプロバむダヌのモデル ID、リク゚ストフィヌルド、デフォルトを䜿甚したす。

92* **Anthropic Messages 圢匏**: 開発者が `ANTHROPIC_BASE_URL` をゲヌトりェむに蚭定したす。Claude Code はゲヌトりェむを Claude API ずしお扱い、どのアップストリヌムに転送するかを刀断できたせん。92* **Anthropic Messages 圢匏**開発者が `ANTHROPIC_BASE_URL` にゲヌトりェむを蚭定したす。Claude Code はゲヌトりェむを Claude API ずしお扱い、転送先のアップストリヌムを刀別できたせん。

93* **Claude apps ゲヌトりェむサむンむン**: 開発者が [Claude apps ゲヌトりェむ](/docs/ja/claude-apps-gateway) にサむンむンしたす。そのゲヌトりェむは Anthropic Messages 圢匏で通信したすが、任意のアップストリヌムにルヌティングできるため、Claude Code は Amazon Bedrock ず Agent Platform も受け入れる `anthropic-beta` 倀ずモデル機胜の仮定のみを送信したす。93* **Claude apps ゲヌトりェむぞのサむンむン**開発者が [Claude apps ゲヌトりェむ](/docs/ja/claude-apps-gateway)にサむンむンしたす。このゲヌトりェむは Anthropic Messages 圢匏を䜿甚したすが、任意のアップストリヌムにルヌティングできるため、Claude Code は Amazon Bedrock ず Agent Platform も受け付ける `anthropic-beta` の倀ずモデル機胜の前提のみを送信したす。

94 94 

95### 接続方法別のリク゚ストずデフォルト95### 接続方法ごずのリク゚ストずデフォルト

96 96 

97以䞋の衚は、3 ぀の接続方法を比范しおおり、1 行に 1 ぀の動䜜が瀺されおいたす。Microsoft Foundry ず Claude Platform on AWS は陀倖されおいたす。これらも Anthropic Messages 圢匏を䜿甚したすが、Claude Code は独自の倉数を通じおそれらに到達したす。詳现に぀いおは、[Microsoft Foundry](/docs/ja/microsoft-foundry) および [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) ペヌゞを参照しおください。97次の衚は、3 ぀の接続方法を 1 行に぀き 1 ぀の動䜜で比范したものです。Microsoft Foundry ず Claude Platform on AWS は、Anthropic Messages 圢匏を䜿甚するものの Claude Code が独自の倉数を通じお接続するため、この衚には含たれおいたせん。これらに぀いおは、[Microsoft Foundry](/docs/ja/microsoft-foundry) ず [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のペヌゞを参照しおください。

98 98 

99| 動䜜 | Amazon Bedrock たたは Agent Platform 圢匏 | Anthropic Messages 圢匏 | Claude apps ゲヌトりェむサむンむン |99| 動䜜 | Amazon Bedrock たたは Agent Platform 圢匏 | Anthropic Messages 圢匏 | Claude apps ゲヌトりェむぞのサむンむン |

100| :- | :- | :- | :- |100| :- | :- | :- | :- |

101| デフォルトでリク゚ストに含たれるモデル ID | プロバむダヌの圢匏Amazon Bedrock の `us.anthropic.claude-opus-4-8` など | Anthropic ID`claude-opus-4-8` など | Anthropic ID |101| リク゚スト内のデフォルトのモデル ID | プロバむダヌの圢匏Amazon Bedrock の `us.anthropic.claude-opus-4-8` など | Anthropic の ID`claude-opus-4-8` など | Anthropic の ID |

102| 送信される `anthropic-beta` 倀 | Amazon Bedrock ず Agent Platform が受け入れるサブセット | [機胜パススルヌ](#feature-pass-through) に蚘茉されおいる完党なセット。ただし、開発者が [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](#disable-pre-release-capabilities) を蚭定する堎合を陀く | Amazon Bedrock ず Agent Platform が受け入れるサブセット |102| 送信される `anthropic-beta` の倀 | Amazon Bedrock ず Agent Platform が受け付けるサブセット | [機胜のパススルヌ](#feature-pass-through)で説明しおいるすべおの倀開発者が [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](#disable-pre-release-capabilities) を蚭定しおいる堎合を陀く | Amazon Bedrock ず Agent Platform が受け付けるサブセット |

103| Claude Code が認識しないモデル IDゲヌトりェむ゚むリアスなどのリク゚ストフィヌルド | 適応的掚論ではなく固定予算での思考、および努力たたはコンテキスト管理フィヌルドなし | 適応的掚論、努力、コンテキスト管理を含む、珟圚の Claude モデルが Claude API で受け入れるすべおのもの。Amazon Bedrock たたは Agent Platform アップストリヌムはこれらを拒吊する可胜性がありたす | Amazon Bedrock たたは Agent Platform 圢匏ず同じ |103| Claude Code が認識しないモデル IDゲヌトりェむの゚むリアスなどに察するリク゚ストフィヌルド | アダプティブ掚論ではなく固定予算での思考を䜿甚し、effort やコンテキスト管理のフィヌルドは送信したせん。[䌚話途䞭のシステムメッセヌゞ](#feature-pass-through)は匕き続き送信したす | 珟行の Claude モデルが Claude API で受け付けるすべおのフィヌルドアダプティブ掚論、effort、コンテキスト管理を含む。Amazon Bedrock たたは Agent Platform のアップストリヌムではこれらが拒吊される堎合がありたす | Amazon Bedrock たたは Agent Platform 圢匏ず同じ |

104| 開発者がオプトむンした堎合の 1 時間の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#choose-the-ttl-yourself) | `cache_control` の `ttl` フィヌルドを通じおリク゚ストされ、ベヌタ倀なし | `ttl` フィヌルドず `anthropic-beta` の `extended-cache-ttl` 倀を通じおリク゚ストされ、転送する必芁がありたす | Claude apps ゲヌトりェむの [可甚性ず制限](/docs/ja/claude-apps-gateway#availability-and-limitations) テヌブルを参照しおください |104| 開発者がオプトむンした堎合の 1 時間の[プロンプトキャッシュ TTL](/docs/ja/prompt-caching#choose-the-ttl-yourself) | `cache_control` の `ttl` フィヌルドでリク゚ストされ、ベヌタ倀は䜿甚したせん | `ttl` フィヌルドに加えお `anthropic-beta` の `extended-cache-ttl` 倀でリク゚ストされたす。この倀は転送する必芁がありたす | Claude apps ゲヌトりェむの[利甚可胜性ず制限事項](/docs/ja/claude-apps-gateway#availability-and-limitations)の衚を参照しおください |

105| `ANTHROPIC_DEFAULT_HAIKU_MODEL` がモデルをピンしない限り、[バックグラりンドタスク](/docs/ja/costs#background-token-usage) 甚のモデル | デフォルト Sonnet モデル、たたはモデルが遞択されたら、[Amazon Bedrock](/docs/ja/amazon-bedrock#4-pin-model-versions) および [Agent Platform](/docs/ja/google-vertex-ai#5-pin-model-versions) ペヌゞで説明されおいるメむンモデル | メむンモデル、たたは `ANTHROPIC_API_KEY` たたは `apiKeyHelper` が Anthropic Console キヌを提䟛し、`ANTHROPIC_AUTH_TOKEN` が蚭定されおいない堎合のデフォルト Haiku モデル | メむンモデル |105| [バックグラりンドタスク](/docs/ja/costs#background-token-usage)のモデル`ANTHROPIC_DEFAULT_HAIKU_MODEL` でモデルを固定しおいる堎合を陀く | [Amazon Bedrock](/docs/ja/amazon-bedrock#4-pin-model-versions) ず [Agent Platform](/docs/ja/google-vertex-ai#5-pin-model-versions) のペヌゞで説明しおいるずおり、デフォルトの Sonnet モデル、たたはメむンモデルが遞択されおいる堎合はそのメむンモデル | メむンモデル。ただし、`ANTHROPIC_API_KEY` たたは `apiKeyHelper` が Anthropic Console のキヌを提䟛し、`ANTHROPIC_AUTH_TOKEN` が未蚭定の堎合はデフォルトの Haiku モデル | メむンモデル |

106 106 

107各接続がサポヌトする機胜ずデフォルトで Anthropic に送信するテレメトリに぀いおは、[機胜の可甚性](/docs/ja/feature-availability#availability-by-model-provider) および [API プロバむダヌ別のデフォルト動䜜](/docs/ja/data-usage#default-behaviors-by-api-provider) を参照しおください。107各接続方法でサポヌトされる機胜ず、デフォルトで Anthropic に送信されるテレメトリに぀いおは、[機胜の利甚可胜性](/docs/ja/feature-availability#availability-by-model-provider)ず [API プロバむダヌごずのデフォルトの動䜜](/docs/ja/data-usage#default-behaviors-by-api-provider)を参照しおください。

108 108 

109### 認識されないモデル ID の蚭定109### 認識されないモデル ID の蚭定

110 110 

1112 ぀のクラむアント偎蚭定により、開発者が䜿甚する接続方法に関係なく、Claude Code が認識しないモデル ID に察しお䜕を想定するかが倉わりたす。111開発者がどの接続方法を䜿甚しおいるかにかかわらず、Claude Code が認識しないモデル ID に぀いお想定する内容は、2 ぀のクラむアント偎の蚭定で倉曎できたす。

112 112 

113* **コンテキストりィンドり**: Claude Code は 200K を想定し、ID が `[1m]` を含む堎合は 1M を想定したす。実際のりィンドりを宣蚀するには、[ゲヌトりェむたたはカスタムモデル ID のりィンドりを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照しおください113* **コンテキストりィンドり**Claude Code は 200K を想定し、ID に `[1m]` が含たれる堎合は 1M を想定したす。実際のりィンドりサむズを宣蚀するには、[ゲヌトりェむたたはカスタムモデル ID のりィンドりを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id)を参照しおください

114* **機胜**: ゲヌトりェむ゚むリアスに背埌にあるモデルの機胜を付䞎するには、配垃する蚭定の [`modelOverrides`](/docs/ja/errors#unrecognized-model-id-on-a-request) ゚ントリを䜿甚しお、そのモデルの Anthropic ID を゚むリアスにマップしたす。`ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` 倉数が適甚される堎所に぀いおは、[機胜パススルヌ](#feature-pass-through) を参照しおください114* **機胜**ゲヌトりェむの゚むリアスに、その背埌にあるモデルの機胜を持たせるには、配垃する蚭定の [`modelOverrides`](/docs/ja/errors#unrecognized-model-id-on-a-request) ゚ントリで、そのモデルの Anthropic ID を゚むリアスにマッピングしたす。`ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` 倉数が適甚される堎面に぀いおは、[機胜のパススルヌ](#feature-pass-through)を参照しおください

115 115 

116## リク゚ストヘッダヌ116## リク゚ストヘッダヌ

117 117 

207 207 

208Claude Code は `ANTHROPIC_BASE_URL` ゲヌトりェむを Anthropic フォヌマット゚ンドポむントずしお扱い、`api.anthropic.com` に送信するベヌタヘッダヌずリク゚ストボディフィヌルドを送信したす。ただし、盎接接続甚に予玄されおいる小さな蚺断ずデフォルトのセットは陀きたす。以䞋で説明するきめ现かいツヌルストリヌミングデフォルトなど、そのセットはリリヌスごずに異なるため、その内容に䟝存しないでください。208Claude Code は `ANTHROPIC_BASE_URL` ゲヌトりェむを Anthropic フォヌマット゚ンドポむントずしお扱い、`api.anthropic.com` に送信するベヌタヘッダヌずリク゚ストボディフィヌルドを送信したす。ただし、盎接接続甚に予玄されおいる小さな蚺断ずデフォルトのセットは陀きたす。以䞋で説明するきめ现かいツヌルストリヌミングデフォルトなど、そのセットはリリヌスごずに異なるため、その内容に䟝存しないでください。

209 209 

210機胜がボディフィヌルドを远加する堎合、それらはベヌタヘッダヌず組み合わされ、ペアは䞀緒に移動したす。ヘッダヌを削陀しながらボディを枡すゲヌトりェむ、たたは Anthropic フォヌマットボディを異なるスキヌマのアップストリヌムに転送するゲヌトりェむは、ハヌド `400` ゚ラヌを生成したす。䞡方の半分が䞀緒に存圚しない堎合のみ、機胜は静かにオフになりたす。リク゚ストボディをコンテンツ怜査のために曞き盎したり線集したりするゲヌトりェむは、削陀ず同じ方法でペアリングを壊すため、倉曎せずに怜査しおください。衚は機胜がペアリングから逞脱する堎所を蚘茉しおいたす。

211 

212きめ现かいツヌルストリヌミングは盎接接続デフォルトの 1 ぀です。リク゚ストがカスタムベヌス URL を通じおルヌティングされるずきはデフォルトでオフになり、開発者が [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/docs/ja/env-vars) を蚭定するずゲヌトりェむはそれを受け取りたす。210きめ现かいツヌルストリヌミングは盎接接続デフォルトの 1 ぀です。リク゚ストがカスタムベヌス URL を通じおルヌティングされるずきはデフォルトでオフになり、開発者が [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/docs/ja/env-vars) を蚭定するずゲヌトりェむはそれを受け取りたす。

213 211 

212### ベヌタヘッダヌずボディフィヌルドのペア

213 

214機胜がボディフィヌルドを远加する堎合、それらはベヌタヘッダヌず組み合わされ、ペアは䞀緒に移動したす。ヘッダヌを削陀しながらボディを枡すゲヌトりェむ、たたは Anthropic フォヌマットボディを異なるスキヌマのアップストリヌムに転送するゲヌトりェむは、`400` ゚ラヌを生成したす。䞡方の半分が䞀緒に存圚しない堎合、機胜は静かにオフになりたす。

215 

216リク゚ストボディをコンテンツ怜査のために曞き盎したり線集したりするゲヌトりェむは、削陀ず同じ方法でペアリングを壊すため、倉曎せずに怜査しおください。衚は機胜がペアリングから逞脱する堎所を蚘茉しおいたす。

217 

214| 機胜 | ヘッダヌずボディペア | 壊れた堎合の症状 | 修埩 |218| 機胜 | ヘッダヌずボディペア | 壊れた堎合の症状 | 修埩 |

215| :- | :- | :- | :- |219| :- | :- | :- | :- |

216| [適応的掚論](/docs/ja/model-config#adjust-effort-level) | ベヌタヘッダヌなし。Claude Code は Claude Opus 4.6、Claude Sonnet 4.6、Claude Haiku 5.5、Claude Fable 5 以降のモデルに `thinking: {"type": "adaptive"}` を送信し、ゲヌトりェむ゚むリアスなど認識しないモデル名を、フィヌルドを受け取る珟圚のモデルずしお扱いたす | `thinking` フィヌルドたたは `adaptive` タグを呜名する `400`。アップストリヌムモデルビルドがそれを受け入れない堎合 | アップストリヌムをアップグレヌドしおください。Opus 4.6 および Sonnet 4.6 では、開発者は代わりに `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` を蚭定できたす |220| [適応的掚論](/docs/ja/model-config#adjust-effort-level) | ベヌタヘッダヌなし。Claude Code は Claude Opus 4.6、Claude Sonnet 4.6、Claude Haiku 5.5、Claude Fable 5 以降のモデルに `thinking: {"type": "adaptive"}` を送信し、ゲヌトりェむ゚むリアスなど認識しないモデル名を、フィヌルドを受け取る珟圚のモデルずしお扱いたす | `thinking` フィヌルドたたは `adaptive` タグを呜名する `400`。アップストリヌムモデルビルドがそれを受け入れない堎合 | アップストリヌムをアップグレヌドしおください。Opus 4.6 および Sonnet 4.6 では、開発者は代わりに `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` を蚭定できたす |

217| [コンテキスト管理](https://platform.claude.com/docs/en/build-with-claude/context-editing) | コンテキスト管理ベヌタヘッダヌは `context_management` ボディフィヌルドず組み合わされたす | `Extra inputs are not permitted` を含む `400`。ゲヌトりェむが Anthropic フォヌマットリク゚ストを受け入れるが Amazon Bedrock に転送する堎合に䞀般的です | 䞡方を転送するか、[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |221| [コンテキスト管理](https://platform.claude.com/docs/en/build-with-claude/context-editing) | コンテキスト管理ベヌタヘッダヌは `context_management` ボディフィヌルドず組み合わされたす | `Extra inputs are not permitted` を含む `400`。ゲヌトりェむが Anthropic フォヌマットリク゚ストを受け入れるが Amazon Bedrock に転送する堎合に䞀般的です。v2.1.304 以降では、Claude Code は[このペアなしで自動的に再詊行したす](#automatic-retry-and-error-forwarding) | 䞡方を転送するか、[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |

218| [拡匵コンテキスト](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model)および[むンタヌリヌブ思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | ベヌタヘッダヌのみ。ボディフィヌルドなし | ヘッダヌが削陀されるず静かに利甚䞍可。アップストリヌムは機胜リク゚ストを芋たせん | `anthropic-beta` をそのたた転送しおください |222| [拡匵コンテキスト](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model)および[むンタヌリヌブ思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | ベヌタヘッダヌのみ。ボディフィヌルドなし | ヘッダヌが削陀されるず静かに利甚䞍可。アップストリヌムは機胜リク゚ストを芋たせん | `anthropic-beta` をそのたた転送しおください |

219| ベヌタ[ツヌルフィヌルド](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | ツヌル関連ベヌタヘッダヌは `strict` および `defer_loading` などのツヌルスキヌマフィヌルドず組み合わされたす | ボディがヘッダヌなしで枡される堎合、認識されないツヌルスキヌマフィヌルドを呜名する `400` | 䞡方を転送するか、[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |223| ベヌタ[ツヌルフィヌルド](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | ツヌル関連ベヌタヘッダヌは `strict` および `defer_loading` などのツヌルスキヌマフィヌルドず組み合わされたす | ボディがヘッダヌなしで枡される堎合、認識されないツヌルスキヌマフィヌルドを呜名する `400`。`defer_loading` に぀いおは、[ツヌル怜玢なしでの再詊行](#retry-without-tool-search)を参照しおください | 䞡方を転送するか、[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |

220| [努力](https://platform.claude.com/docs/en/build-with-claude/effort)および[構造化出力](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | `output_config` ボディフィヌルドは努力、構造化出力フォヌマット、およびタスク予算蚭定を含みたす。各々は独自のベヌタヘッダヌず組み合わされたす | `output_config` を呜名する `400`。倚くの堎合 `Extra inputs are not permitted`。Amazon Bedrock および Google Cloud の Agent Platform アップストリヌム䞊 | フィヌルドずそのヘッダヌを䞀緒に転送するか、開発者に [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) を蚭定しおもらっおください。この倉数はフォヌマットずタスク予算蚭定を削陀したすが、努力は削陀したせん。フォヌマットのみを削陀するには、代わりに [`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1`](/docs/ja/env-vars) を蚭定できたす。これには v2.1.288 以降が必芁です |224| [努力](https://platform.claude.com/docs/en/build-with-claude/effort)および[構造化出力](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | `output_config` ボディフィヌルドは努力、構造化出力フォヌマット、およびタスク予算蚭定を含みたす。各々は独自のベヌタヘッダヌず組み合わされたす | `output_config` を呜名する `400`。倚くの堎合 `Extra inputs are not permitted`。Amazon Bedrock および Google Cloud の Agent Platform アップストリヌム䞊 | フィヌルドずそのヘッダヌを䞀緒に転送するか、開発者に [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) を蚭定しおもらっおください。この倉数はフォヌマットずタスク予算蚭定を削陀したすが、努力は削陀したせん。フォヌマットのみを削陀するには、代わりに [`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1`](/docs/ja/env-vars) を蚭定できたす。これには v2.1.288 以降が必芁です |

225| 䌚話䞭のシステムメッセヌゞ | ベヌタヘッダヌなし。Claude Code は Claude Opus 4.8、それ以降にリリヌスされたモデル、および認識されないモデル ID に察しお、䞀郚のリマむンダヌや添付テキストを `messages` 内の `role: "system"` ゚ントリずしお送信したす | `Unexpected role "system"` などの `400` | Claude Code は[システムメッセヌゞなしで再詊行したす](#automatic-retry-and-error-forwarding)。Claude Opus 4.8 より前にリリヌスされたモデルの゚むリアスでシステムメッセヌゞを停止するには、配垃する蚭定に [`modelOverrides` ゚ントリ](#settings-for-unrecognized-model-ids)を远加しおください |

226| [タヌンごずに蚭定される努力](/docs/ja/prompt-caching#changing-effort-level) | Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.1 では、ベヌタヘッダヌが `role: "system"` ゚ントリシステムメッセヌゞ、たたは空のコンテンツを持぀゚ントリ䞊の `output_config.effort` ず組み合わされたす | ゲヌトりェむが空の゚ントリからフィヌルドを削陀するず、`messages.N: system content must contain at least one block` を含む `400` | 䞡方を転送するか、開発者に [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) を蚭定しおもらい、フィヌルドず空の゚ントリの送信を停止しおください |

221| [プロンプトキャッシング](/docs/ja/prompt-caching) | ベヌタペアリングなし。Claude Code は `cache_control` マヌカヌを `system` ブロックおよび `messages` ゚ントリ䌚話の途䞭で远加される `role: "system"` ゚ントリを含むに付加したす | ゚ラヌなし。䌚話は毎タヌン、キャッシュされおいない入力ずしお課金されたす。`usage` でキャッシュアクティビティがほずんどたたはたったくない高い `input_tokens` ずしお衚瀺されたす | `cache_control` が衚瀺される堎所ならどこでも倉曎なしで転送し、ブロック圢匏の `system` たたはメッセヌゞコンテンツをプレヌン文字列に倉換しないでください |227| [プロンプトキャッシング](/docs/ja/prompt-caching) | ベヌタペアリングなし。Claude Code は `cache_control` マヌカヌを `system` ブロックおよび `messages` ゚ントリ䌚話の途䞭で远加される `role: "system"` ゚ントリを含むに付加したす | ゚ラヌなし。䌚話は毎タヌン、キャッシュされおいない入力ずしお課金されたす。`usage` でキャッシュアクティビティがほずんどたたはたったくない高い `input_tokens` ずしお衚瀺されたす | `cache_control` が衚瀺される堎所ならどこでも倉曎なしで転送し、ブロック圢匏の `system` たたはメッセヌゞコンテンツをプレヌン文字列に倉換しないでください |

222| [トヌクンカりント](https://platform.claude.com/docs/en/build-with-claude/token-counting) | ベヌタペアリングなし。`count_tokens` ゚ンドポむントを䜿甚したす | ゚ラヌなし。Claude Code は文字ベヌスの掚定にフォヌルバックするため、`/context` は抂算カりントを衚瀺したす | 正確なトヌクンカりントのために゚ンドポむントを公開しおください |228| [トヌクンカりント](https://platform.claude.com/docs/en/build-with-claude/token-counting) | ベヌタペアリングなし。`count_tokens` ゚ンドポむントを䜿甚したす | ゚ラヌなし。Claude Code は文字ベヌスの掚定にフォヌルバックするため、`/context` は抂算カりントを衚瀺したす | 正確なトヌクンカりントのために゚ンドポむントを公開しおください |

223 229 

225 231 

226### 自動リトラむず゚ラヌ転送232### 自動リトラむず゚ラヌ転送

227 233 

228アップストリヌム拒吊埌に Claude Code が実行する内容は、䜕が拒吊されたかによっお異なりたす234アップストリヌムがこれらの機胜のいずれかを拒吊した堎合、Claude Code は拒吊された郚分を削陀たたは倉曎しおリク゚ストを自動的に再詊行できたす

229 235 

230* アップストリヌムが `thinking` フィヌルド、䌚話䞭のシステムメッセヌゞ、たたはそのようなメッセヌゞの `cache_control` マヌカヌを拒吊する堎合、Claude Code はリク゚ストをリトラむし、拒吊された機胜を䌚話の残りの郚分で無効にしたす236* `thinking.type` の倀 `enabled` たたは `adaptive` がサポヌトされおいないず `400` が瀺す堎合、Claude Code はもう䞀方のタむプで 1 回再詊行し、`thinking` フィヌルドは維持したす。そのモデルぞの以降のリク゚ストは、Claude Code が終了するたで切り替え埌のタむプを䜿い続けたす。v2.1.121 より前では、Claude Code は再詊行しなかったため、[`thinking.type.enabled is not supported`](/docs/ja/errors#thinking-type-enabled-is-not-supported-for-this-model) が開発者に届いおいたした

237* アップストリヌムが `messages` 内の `role: "system"` ゚ントリを拒吊した堎合、Claude Code はそれらの䌚話䞭のシステムメッセヌゞを陀いお 1 回再詊行し、そのテキストを代わりにナヌザヌメッセヌゞに含めたす。䌚話内の以降のリク゚ストは、開発者が `/clear` を実行するか䌚話が圧瞮されるたでその圢匏を維持したす

238* アップストリヌムが䌚話䞭のシステムメッセヌゞの `cache_control` マヌカヌのみを拒吊した堎合、Claude Code はシステムメッセヌゞを維持し、マヌカヌを移動しお 1 回再詊行したす。その再詊行ず、Claude Code が終了するたでの以降のリク゚ストでは、マヌカヌは `messages` 内でシステムメッセヌゞではない最埌の゚ントリに付けられたす

231* アップストリヌムが[思考眲名](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)を拒吊する堎合`bound to a different conversation` ずいう `400` を含む、Claude Code はリク゚ストを以前の思考ブロックなしでリトラむし、それらを埌のすべおのリク゚ストから陀倖したす。新しい応答には䟝然ずしお思考が含たれたす239* アップストリヌムが[思考眲名](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)を拒吊する堎合`bound to a different conversation` ずいう `400` を含む、Claude Code はリク゚ストを以前の思考ブロックなしでリトラむし、それらを埌のすべおのリク゚ストから陀倖したす。新しい応答には䟝然ずしお思考が含たれたす

232* ゲヌトりェむたたはそのアップストリヌムが [advisor ツヌル](/docs/ja/advisor)゚ントリを `tools` で認識されないツヌルタむプずしお拒吊する堎合、Claude Code はその゚ントリずその `anthropic-beta` 倀なしでリク゚ストを 1 回リトラむしたす。その埌のそのベヌス URL ぞのリク゚ストは Claude Code が終了するたで advisor を陀倖し、その時間は `/advisor` は開発者に利甚䞍可です。Claude Code はこの拒吊を `Input tag` の埌にツヌルタむプを呜名するメッセヌゞを含む `400` たたは `422` レスポンスによっお認識したす。䟋えば `Input tag 'advisor_20260301'` です。v2.1.280 より前では、Claude Code はこの拒吊をリトラむしたせんでした240* ゲヌトりェむたたはそのアップストリヌムが [advisor ツヌル](/docs/ja/advisor)゚ントリを `tools` で認識されないツヌルタむプずしお拒吊する堎合、Claude Code はその゚ントリずその `anthropic-beta` 倀なしでリク゚ストを 1 回リトラむしたす。その埌のそのベヌス URL ぞのリク゚ストは Claude Code が終了するたで advisor を陀倖し、その時間は `/advisor` は開発者に利甚䞍可です。Claude Code はこの拒吊を `Input tag` の埌にツヌルタむプを呜名するメッセヌゞを含む `400` たたは `422` レスポンスによっお認識したす。䟋えば `Input tag 'advisor_20260301'` です。v2.1.280 より前では、Claude Code はこの拒吊をリトラむしたせんでした

233* アップストリヌムが `output_config.effort` を拒吊する堎合、Claude Code は努力なしでリク゚ストを再詊行し、Claude Code が終了するたでそのモデルぞの以降のリク゚ストから努力を陀倖したす。Claude Code はこの拒吊を、メッセヌゞが `Extra inputs are not permitted` ずずもに `output_config.effort` を挙げおいる、たたはモデルが努力パラメヌタヌをサポヌトしおいないず述べおいる `400` によっお認識したす241* アップストリヌムが `output_config.effort` を拒吊する堎合、Claude Code は努力なしでリク゚ストを再詊行し、Claude Code が終了するたでそのモデルぞの以降のリク゚ストから努力を陀倖したす。Claude Code はこの拒吊を、メッセヌゞが `Extra inputs are not permitted` ずずもに `output_config.effort` を挙げおいる、たたはモデルが努力パラメヌタヌをサポヌトしおいないず述べおいる `400` によっお認識したす

234* Claude Code はコンテキスト管理たたはツヌルスキヌマフィヌルド拒吊をリトラむしたせん。それらの `400` ゚ラヌは開発者に到達したす242* アップストリヌムが `context_management` フィヌルドたたはその `anthropic-beta` 倀を拒吊する堎合、ゲヌトりェむにはそれらを陀いたリク゚ストがもう䞀床届きたす。埌のリク゚ストでゲヌトりェむが再びそれらを受け取り、アップストリヌムが再び拒吊した堎合も、同じ再詊行が行われたす。Claude Code はこの拒吊をメッセヌゞによっお認識したす。たずえば `context_management: Extra inputs are not permitted` を含むメッセヌゞです。v2.1.304 より前では、Claude Code はこの拒吊を再詊行したせんでした

243* アップストリヌムが `strict` など `defer_loading` 以倖のベヌタツヌルフィヌルドを拒吊する堎合、`400` は開発者に届きたす。その前に、ゲヌトりェむには[ツヌル怜玢フィヌルドを陀いた](#retry-without-tool-search)リク゚ストが再び届くこずがありたす。このようなフィヌルドの送信を停止するには、開発者に [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) を蚭定しおもらっおください

235 244 

236`bound to a different conversation` 拒吊は API の[保存された思考](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking)チェックから来たす。これは、`system`、`tools`、たたは以前の `messages` コンテンツが思考を生成したリク゚ストず異なる堎合に倱敗したす。そのコンテンツのいずれかを曞き盎すゲヌトりェむは、拒吊自䜓を匕き起こす可胜性がありたす。[ラむブラリ、プロキシ、およびゲヌトりェむ](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#libraries-proxies-gateways)は、倉曎なしで枡すべき内容をカバヌしおいたす。245`bound to a different conversation` 拒吊は API の[保存された思考](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking)チェックから来たす。これは、`system`、`tools`、たたは以前の `messages` コンテンツが思考を生成したリク゚ストず異なる堎合に倱敗したす。そのコンテンツのいずれかを曞き盎すゲヌトりェむは、拒吊自䜓を匕き起こす可胜性がありたす。[ラむブラリ、プロキシ、およびゲヌトりェむ](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#libraries-proxies-gateways)は、倉曎なしで枡すべき内容をカバヌしおいたす。

237 246 

238リトラむロゞックはアップストリヌムの゚ラヌ文蚀に䞀臎するため、アップストリヌム゚ラヌレスポンスボディを倉曎なしで転送しおください。アップストリヌム゚ラヌを独自の゚ンベロヌプでラップするゲヌトりェむは、ステヌタスコヌドを保持する堎合でも回埩パスを壊したす。ただし、゚ンベロヌプのメッセヌゞが安定した `capability_rejected:` トヌクンを含む堎合は陀きたす。[Claude apps ゲヌトりェむはクラりドプロバむダヌの゚ラヌ文蚀をそれらのトヌクンに眮き換えたす](/docs/ja/claude-apps-gateway-config#upstream-error-messages)。䟋えば `capability_rejected: prompt_too_long` です。247この再詊行ロゞックの倧郚分はアップストリヌムの゚ラヌ文蚀に䞀臎するため、゚ラヌレスポンスボディを倉曎なしで転送しおください。アップストリヌム゚ラヌを独自の゚ンベロヌプでラップするゲヌトりェむは、ステヌタスコヌドを保持する堎合でも回埩パスを壊したす。ただし、゚ンベロヌプのメッセヌゞが安定した `capability_rejected:` トヌクンを含む堎合は陀きたす。[Claude apps ゲヌトりェむはクラりドプロバむダヌの゚ラヌ文蚀をそれらのトヌクンに眮き換えたす](/docs/ja/claude-apps-gateway-config#upstream-error-messages)。䟋えば `capability_rejected: prompt_too_long` です。

248 

249#### ツヌル怜玢なしでの再詊行

250 

251v2.1.305 以降では、[`defer_loading` フィヌルドず `tool_reference` ブロック](/docs/ja/mcp#tool-search-through-a-gateway)を含むリク゚ストは、Claude Code が原因を認識できない `400` たたは `422` の埌に、それらを陀いた圢で再び届くこずがありたす。再詊行が成功するず、以降のリク゚ストでもそれらは省略されたす。

252 

253ゲヌトりェむ偎で䜕も倉曎しなくおも開発者のリク゚ストは匕き続き機胜し、MCP ツヌルは事前に読み蟌たれたす。Claude Code は埌でツヌル怜玢を再床詊すため、ゲヌトりェむでは再び拒吊されたリク゚ストずその再詊行が芋られるこずがありたす。すべおのリク゚ストからこれらのフィヌルドを陀倖するには、開発者に `ENABLE_TOOL_SEARCH=false` を蚭定しおもらっおください。ツヌル怜玢自䜓に぀いおは、Claude Code はゲヌトりェむが `defer_loading` フィヌルドず `tool_reference` ブロックをその `anthropic-beta` 倀ずずもに転送するこずを想定しおいたす。

239 254 

240### プレリリヌス機胜を無効化255### プレリリヌス機胜を無効化

241 256 

250この倉数はすべおの `anthropic-beta` 倀を削陀するわけではありたせん。そのたた残るものには次のものがありたす265この倉数はすべおの `anthropic-beta` 倀を削陀するわけではありたせん。そのたた残るものには次のものがありたす

251 266 

252* 拡匵コンテキスト、むンタヌリヌブ思考、および努力の `anthropic-beta` 倀クラりドプロバむダヌもこれらを受け入れたす267* 拡匵コンテキスト、むンタヌリヌブ思考、および努力の `anthropic-beta` 倀クラりドプロバむダヌもこれらを受け入れたす

253* `output_config.effort` フィヌルド。これを拒吊するアップストリヌムに぀いおは、[自動リトラむず゚ラヌ転送](#automatic-retry-and-error-forwarding)を参照しおください268* 最䞊䜍の `output_config.effort` フィヌルド。これを拒吊するアップストリヌムに぀いおは、[自動リトラむず゚ラヌ転送](#automatic-retry-and-error-forwarding)を参照しおください

254* 適応的掚論の `thinking` フィヌルドベヌタヘッダヌはありたせん269* 適応的掚論の `thinking` フィヌルドベヌタヘッダヌはありたせん

270* [䌚話䞭のシステムメッセヌゞ](#feature-pass-through)を運ぶ `role: "system"` ゚ントリ

255* サブスクリプション認蚌に必芁な OAuth の `anthropic-beta` 倀271* サブスクリプション認蚌に必芁な OAuth の `anthropic-beta` 倀

256* 開発者が [`ANTHROPIC_BETAS`](/docs/ja/env-vars) たたは [`CLAUDE_CODE_EXTRA_BODY`](/docs/ja/env-vars) を通じお自分で远加したヘッダヌ倀ずボディフィヌルド272* 開発者が [`ANTHROPIC_BETAS`](/docs/ja/env-vars) たたは [`CLAUDE_CODE_EXTRA_BODY`](/docs/ja/env-vars) を通じお自分で远加したヘッダヌ倀ずボディフィヌルド

257 273 

managed-settings.md +1 −1

Details

86 * **フル VM サンドボックス内**: Claude Desktop の管理蚭定で [`requireCoworkFullVmSandbox`](https://claude.com/docs/third-party/claude-desktop/configuration#requirecoworkfullvmsandbox) が蚭定されおいる堎合、Claude Code は仮想マシン内で実行され、そこにはデバむスの MDM ポリシヌや管理蚭定ファむルが存圚したせん。86 * **フル VM サンドボックス内**: Claude Desktop の管理蚭定で [`requireCoworkFullVmSandbox`](https://claude.com/docs/third-party/claude-desktop/configuration#requirecoworkfullvmsandbox) が蚭定されおいる堎合、Claude Code は仮想マシン内で実行され、そこにはデバむスの MDM ポリシヌや管理蚭定ファむルが存圚したせん。

87 * **リモヌト Cowork セッション**: これらは Anthropic が管理する VM 䞊で実行され、Claude Code が読み取るデバむスポリシヌはありたせん。87 * **リモヌト Cowork セッション**: これらは Anthropic が管理する VM 䞊で実行され、Claude Code が読み取るデバむスポリシヌはありたせん。

88 88 

89 セッションがどこで実行されおも、claude.ai 䞊の git リポゞトリから、たたは Cowork タブの **Customize** から誰かがマヌケットプレむスを远加するず、claude.ai は管理コン゜ヌルの [`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) ず [`blockedMarketplaces`](/docs/ja/settings-reference#blockedmarketplaces) のリストを自ら適甚したす。そのチェックに぀いおは[制限の仕組み](/docs/ja/plugins/org#restrict-what-users-can-install)で説明しおいたす。[サヌフェスの察応範囲](/docs/ja/model-config#surface-coverage)の衚では、Cowork ず他のサヌフェスを比范しおいたす。89 セッションがどこで実行されおも、claude.ai 䞊の git リポゞトリから、たたは Cowork の **Customize** から誰かがマヌケットプレむスを远加するず、claude.ai は管理コン゜ヌルの [`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) ず [`blockedMarketplaces`](/docs/ja/settings-reference#blockedmarketplaces) のリストを自ら適甚したす。そのチェックに぀いおは[制限の仕組み](/docs/ja/plugins/org#restrict-what-users-can-install)で説明しおいたす。[サヌフェスの察応範囲](/docs/ja/model-config#surface-coverage)の衚では、Cowork ず他のサヌフェスを比范しおいたす。

90* **実行䞭のセッション**: ほずんどの倉曎は、[配信メカニズムの衚](#choose-a-delivery-mechanism)のスケゞュヌルに埓い、再起動なしで実行䞭のセッションに反映されたす。90* **実行䞭のセッション**: ほずんどの倉曎は、[配信メカニズムの衚](#choose-a-delivery-mechanism)のスケゞュヌルに埓い、再起動なしで実行䞭のセッションに反映されたす。

91 * [`forceRemoteSettingsRefresh`](/docs/ja/settings-reference#forceremotesettingsrefresh)、[`requiredMinimumVersion`](/docs/ja/settings-reference#requiredminimumversion)、および[䞀郚のナヌザヌが線集可胜なキヌ](/docs/ja/settings#when-edits-take-effect)ぞの倉曎は、次回のセッション開始時に有効になりたす。91 * [`forceRemoteSettingsRefresh`](/docs/ja/settings-reference#forceremotesettingsrefresh)、[`requiredMinimumVersion`](/docs/ja/settings-reference#requiredminimumversion)、および[䞀郚のナヌザヌが線集可胜なキヌ](/docs/ja/settings#when-edits-take-effect)ぞの倉曎は、次回のセッション開始時に有効になりたす。

92 * 新芏たたは倉曎された [`policyHelper`](/docs/ja/settings-reference#policyhelper) ゚ントリは、次回の起動時に有効になりたす。その起動時にサヌバヌ管理蚭定がヘルパヌを芆い隠しおいる堎合、取埗によっおそれらの蚭定の削陀が報告されるずすぐにヘルパヌが実行されたす。92 * 新芏たたは倉曎された [`policyHelper`](/docs/ja/settings-reference#policyhelper) ゚ントリは、次回の起動時に有効になりたす。その起動時にサヌバヌ管理蚭定がヘルパヌを芆い隠しおいる堎合、取埗によっおそれらの蚭定の削陀が報告されるずすぐにヘルパヌが実行されたす。

mcp.md +67 −43

Details

302リク゚ストがバックグラりンドでただ接続䞭のサヌバヌからのツヌルを必芁ずする堎合、Claude はそのサヌバヌが接続するたで埅機したす。埅機の方法は蚭定によっお異なりたす。302リク゚ストがバックグラりンドでただ接続䞭のサヌバヌからのツヌルを必芁ずする堎合、Claude はそのサヌバヌが接続するたで埅機したす。埅機の方法は蚭定によっお異なりたす。

303 303 

304* **[ツヌル怜玢](#scale-with-mcp-tool-search)デフォルトを䜿甚**: 埅機は `ToolSearch` 呌び出し内で発生したす。304* **[ツヌル怜玢](#scale-with-mcp-tool-search)デフォルトを䜿甚**: 埅機は `ToolSearch` 呌び出し内で発生したす。

305* **ツヌル怜玢なし**: Claude は代わりに `WaitForMcpServers` ツヌルを䜿甚したす。ツヌル怜玢なしの蚭定には、カスタム `ANTHROPIC_BASE_URL`、`ENABLE_TOOL_SEARCH=false`、Google Cloud の Agent Platform 䞊の Claude Opus 4.5、Claude Sonnet 4.5、Claude Haiku 4.5 より前のモデルが含たれたす。305* **ツヌル怜玢なし**: Claude は代わりに `WaitForMcpServers` ツヌルを䜿甚したす。ツヌル怜玢なしの蚭定には、`ENABLE_TOOL_SEARCH=false` ず、Google Cloud の Agent Platform 䞊の Claude Opus 4.5、Claude Sonnet 4.5、Claude Haiku 4.5 より前のモデルが含たれたす。`ANTHROPIC_BASE_URL` ゲヌトりェむに぀いおは、[LLM ゲヌトりェむ経由のツヌル怜玢](#tool-search-through-a-gateway) を参照しおください。

306* **Microsoft Foundry の [Azure でホストされたデプロむ](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)**: Claude Code はデプロむのサヌバヌ偎の拒吊を API からしか怜出できないため、Claude は `WaitForMcpServers` ではなくツヌル怜玢パスで開始したす。Claude Code がそのデプロむを [事前読み蟌み](#scale-with-mcp-tool-search) に切り替えた埌は、接続を完了したサヌバヌのツヌルが Claude の次のリク゚ストで利甚可胜になりたす。306* **Microsoft Foundry の [Azure でホストされたデプロむ](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)**: Claude Code はデプロむのサヌバヌ偎の拒吊を API からしか怜出できないため、Claude は `WaitForMcpServers` ではなくツヌル怜玢パスで開始したす。Claude Code がそのデプロむを [事前読み蟌み](#scale-with-mcp-tool-search) に切り替えた埌は、接続を完了したサヌバヌのツヌルが Claude の次のリク゚ストで利甚可胜になりたす。

307 307 

308ツヌル怜玢が有効な堎合、Claude が䜜業䞭にサヌバヌが接続を完了するず、Claude Code は同じタヌンの次のリク゚ストでそのサヌバヌのツヌル名を Claude に䌝えたす。Claude はそれらのツヌルを怜玢しお呌び出し、次のメッセヌゞを埅぀こずなく実行できたす。308ツヌル怜玢が有効な堎合、Claude が䜜業䞭にサヌバヌが接続を完了するず、Claude Code は同じタヌンの次のリク゚ストでそのサヌバヌのツヌル名を Claude に䌝えたす。Claude はそれらのツヌルを怜玢しお呌び出し、次のメッセヌゞを埅぀こずなく実行できたす。

509 509 

510プラグむンサヌバヌは `/mcp` に衚瀺され、プラグむンから来るこずを瀺すむンゞケヌタが付きたす。510プラグむンサヌバヌは `/mcp` に衚瀺され、プラグむンから来るこずを瀺すむンゞケヌタが付きたす。

511 511 

512プラグむンの stdio サヌバヌの堎合、`claude mcp get` は `Command: stdio`、空の `Args:` 行、および各環境倉数を `NAME=[REDACTED]` ずしお出力したす。倀は認蚌情報を含む可胜性があるため、隠されおいたす。512`claude mcp get` は、プラグむンの stdio サヌバヌたたは WebSocket サヌバヌに蚭定された倀を、認蚌情報を含む可胜性があるため隠したす。

513 

514* **stdio サヌバヌ**: `Command: stdio`、空の `Args:` 行、および各環境倉数を `NAME=[REDACTED]` ずしお出力したす

515* **WebSocket サヌバヌ**: `URL: ws` ず、各ヘッダヌを `<name>: [REDACTED]` ずしお出力し、`claude mcp list` は URL の代わりに `ws` を衚瀺したす

516 

517プラグむンが蚭定した内容を確認するには、[ディスク䞊でプラグむンを芋぀け](/docs/ja/plugins/loading#find-plugins-on-disk)、その `.mcp.json` たたは `plugin.json` を読んでください。

513 518 

514**プラグむン MCP ツヌル名**519**プラグむン MCP ツヌル名**

515 520 

592 597 

593セキュリティ䞊の理由から、Claude Code はむンタラクティブセッションで `.mcp.json` ファむルからプロゞェクトスコヌプのサヌバヌを䜿甚する前に承認を求めたす。これらの承認遞択をリセットするには、`claude mcp reset-project-choices` を実行しおください。598セキュリティ䞊の理由から、Claude Code はむンタラクティブセッションで `.mcp.json` ファむルからプロゞェクトスコヌプのサヌバヌを䜿甚する前に承認を求めたす。これらの承認遞択をリセットするには、`claude mcp reset-project-choices` を実行しおください。

594 599 

595`claude -p` 実行、[Agent SDK](/docs/ja/headless)セッション、および[クラりドセッション](/docs/ja/claude-code-on-the-web)では、Claude Code はそのプロンプトを衚瀺できたせん。プロゞェクトスコヌプのサヌバヌを確認なしでロヌドしたす。Claude Code はたた、ナヌザヌ蚭定たたはマネヌゞド蚭定で [`skipDangerousModePermissionPrompt`](/docs/ja/settings-reference#skipdangerousmodepermissionprompt) が蚭定された `bypassPermissions` モヌドで開始したセッションではプロンプトをスキップしたす。ずにかくサヌバヌを陀倖するには600`claude -p` 実行、[Agent SDK](/docs/ja/headless) セッション、および[プロゞェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories)倖の[クラりドセッション](/docs/ja/claude-code-on-the-web)では、Claude Code はそのプロンプトを衚瀺できたせん。プロゞェクトスコヌプのサヌバヌを確認なしでロヌドしたす。Claude Code はたた、ナヌザヌ蚭定たたは管理蚭定で [`skipDangerousModePermissionPrompt`](/docs/ja/settings-reference#skipdangerousmodepermissionprompt) が蚭定された `bypassPermissions` モヌドで開始したセッションではプロンプトをスキップしたす。それでもサヌバヌを陀倖するには

596 601 

597* [`disabledMcpjsonServers`](/docs/ja/settings-reference#disabledmcpjsonservers)に远加したす。これはすべおの暩限モヌドでそれをブロックしたす。602* [`disabledMcpjsonServers`](/docs/ja/settings-reference#disabledmcpjsonservers)に远加したす。これはすべおの暩限モヌドでそれをブロックしたす。

598* [`--setting-sources`](/docs/ja/cli-reference#cli-flags)たたは SDK の `settingSources` オプションでプロゞェクト蚭定党䜓を陀倖したす。603* [`--setting-sources`](/docs/ja/cli-reference#cli-flags)たたは SDK の `settingSources` オプションでプロゞェクト蚭定党䜓を陀倖したす。

634#### サポヌトされおいる構文639#### サポヌトされおいる構文

635 640 

636* `${VAR}` - 環境倉数 `VAR` の倀に展開されたす641* `${VAR}` - 環境倉数 `VAR` の倀に展開されたす

637* `${VAR:-default}` - `VAR` が蚭定されおいる堎合は `VAR` に展開され、そうでない堎合はデフォルトを䜿甚したす642* `${VAR:-default}``VAR` が蚭定されおいる堎合は `VAR` に展開され、そうでない堎合は `default` を䜿甚したす

638 643 

639#### 展開堎所644#### 展開堎所

640 645 

1431 1436 

1432MCP Apps UI リ゜ヌスは、`ui://` URI たたは `text/html;profile=mcp-app` メディアタむプを持぀゚ントリですClaude が読み取るコンテンツではなく、ホストアプリケヌションがレンダリングするペヌゞです。これらは `@` の提案やリ゜ヌスリストツヌルの結果に衚瀺されず、UI リ゜ヌスのみを提䟛するサヌバヌは空のリ゜ヌスリストを衚瀺したす。URI でUI リ゜ヌスを読み取るこずはただ機胜したす。1437MCP Apps UI リ゜ヌスは、`ui://` URI たたは `text/html;profile=mcp-app` メディアタむプを持぀゚ントリですClaude が読み取るコンテンツではなく、ホストアプリケヌションがレンダリングするペヌゞです。これらは `@` の提案やリ゜ヌスリストツヌルの結果に衚瀺されず、UI リ゜ヌスのみを提䟛するサヌバヌは空のリ゜ヌスリストを衚瀺したす。URI でUI リ゜ヌスを読み取るこずはただ機胜したす。

1433 1438 

1434## MCP ツヌル怜玢でスケヌリング1439## MCP ツヌル怜玢によるスケヌリング

1435 1440 

1436ツヌル怜玢は、Claude がツヌルを必芁ずするたでツヌル定矩を遅延させるこずで、MCP コンテキスト䜿甚量を䜎く保ちたす。セッション開始時にはツヌル名ずサヌバヌ指瀺のみが読み蟌たれるため、MCP サヌバヌを远加しおもコンテキストりィンドりぞの圱響は最小限です。Claude Code はサヌバヌごずの固定ツヌル䞊限を課したせん。実甚的な䞊限はコンテキストりィンドりの予算です。1441ツヌル怜玢は、Claude が必芁ずするたでツヌル定矩の読み蟌みを遅延させるこずで、MCP によるコンテキスト䜿甚量を䜎く抑えたす。セッション開始時に読み蟌たれるのはツヌル名ずサヌバヌの指瀺だけなので、MCP サヌバヌを远加しおもコンテキストりィンドりぞの圱響はごくわずかです。Claude Code はサヌバヌごずのツヌル数に固定の䞊限を蚭けおいたせん。実質的な䞊限は、コンテキストりィンドりの容量です。

1437 1442 

1438> [!NOTE]1443> [!NOTE]

1439>1444>

1440> ツヌル怜玢は Microsoft Foundry の[Azure でホストされおいるデプロむ](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)ではサポヌトされおいたせん。これらのデプロむはサヌバヌ偎でツヌル怜玢を拒吊したす。Claude Code はこの拒吊を怜出し、そのデプロむ甚に MCP ツヌルを事前に読み蟌みたす。[`ENABLE_TOOL_SEARCH`](#configure-tool-search) はデプロむ自䜓からの拒吊であるため、これを䞊曞きするこずはできたせん。1445> ツヌル怜玢は、Microsoft Foundry の [Azure でホストされるデプロむ](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)ではサポヌトされおおらず、サヌバヌ偎で拒吊されたす。Claude Code はこの拒吊を怜出し、そのデプロむでは代わりに MCP ツヌルを事前に読み蟌みたす。拒吊はデプロむ自䜓から返されるため、[`ENABLE_TOOL_SEARCH`](#configure-tool-search) でこの動䜜を䞊曞きするこずはできたせん。

1441 1446 

1442### MCP サヌバヌ䜜成者向けのツヌル怜玢1447### MCP サヌバヌ䜜成者向けのツヌル怜玢

1443 1448 

1444MCP サヌバヌを構築しおいる堎合、ツヌル怜玢が有効になるずサヌバヌ指瀺フィヌルドがより有甚になりたす。サヌバヌ指瀺は、[スキル](/docs/ja/skills)の動䜜方法ず同様に、Claude がい぀ツヌルを怜玢すべきかを理解するのに圹立ちたす。1449MCP サヌバヌを構築しおいる堎合、ツヌル怜玢が有効になっおいるず、サヌバヌの指瀺フィヌルドがより圹立぀ようになりたす。サヌバヌの指瀺は、[スキル](/docs/ja/skills)の仕組みず同様に、Claude がい぀ツヌルを怜玢すべきかを理解するのに圹立ちたす。

1445 1450 

1446以䞋を説明する明確で説明的なサヌバヌ指瀺を远加しおください。1451次の点を説明する、明確でわかりやすいサヌバヌの指瀺を远加しおください。

1447 1452 

1448* ツヌルが凊理するタスクのカテゎリ1453* ツヌルが扱うタスクのカテゎリ

1449* Claude がツヌルを怜玢すべき時期1454* Claude がツヌルを怜玢すべきタむミング

1450* サヌバヌが提䟛する䞻な機胜1455* サヌバヌが提䟛する䞻な機胜

1451 1456 

1452Claude Code は、以䞋のデフォルトの䞊限を超えるツヌル説明やサヌバヌ指瀺を切り詰めたす。Claude には切り詰められる前のテキストのみが衚瀺されたす。1457ツヌルの説明やサヌバヌの指瀺が次のデフォルトの䞊限を超えるず、Claude Code はそれを切り詰め、Claude には切り詰められた䜍眮より前の郚分のテキストだけが枡されたす。

1453 1458 

1454* **サヌバヌ指瀺、および事前に読み蟌たれるツヌルの説明**: 4,096 文字1459* **サヌバヌの指瀺、および事前に読み蟌たれるツヌルの説明**: 4,096 文字

1455* **Claude がツヌル怜玢を通じお読み蟌むツヌルの説明**: 16,384 文字1460* **Claude がツヌル怜玢を通じお読み蟌むツヌルの説明**: 16,384 文字

1456 1461 

1457説明ず指瀺は簡朔に保ち、重芁な詳现は最初の方に配眮しおください。ツヌル怜玢が Claude のク゚リをツヌルの説明ず照合する際は、短い方の䞊限内の郚分のみを読み取るため、Claude が怜玢に䜿いそうな語句も最初の方に配眮しおください。ツヌルが遅延されない堎合、たずえば[ツヌル怜玢がオフの堎合](#configure-tool-search)、ツヌルが[事前に読み蟌むようマヌクされおいる堎合](#per-tool-alwaysload)、たたはそのサヌバヌが[遅延から陀倖されおいる堎合](#exempt-a-server-from-deferral)には、ツヌルは事前に読み蟌たれ、短い方の䞊限が適甚されたす。1462説明ず指瀺は簡朔にし、重芁な詳现は冒頭近くに蚘茉しおください。ツヌル怜玢が Claude のク゚リをツヌルの説明ず照合する際は、短い方の䞊限以内の郚分だけが読み取られるため、Claude が怜玢に䜿いそうな語句も冒頭近くに眮いおください。ツヌルが遅延読み蟌みされない堎合、たずえば[ツヌル怜玢がオフ](#configure-tool-search)の堎合、ツヌルが[事前に読み蟌むようマヌクされおいる](#per-tool-alwaysload)堎合、たたはそのサヌバヌが[遅延読み蟌みの察象倖](#exempt-a-server-from-deferral)になっおいる堎合は、ツヌルは事前に読み蟌たれ、短い方の䞊限が適甚されたす。

1458 1463 

1459v2.1.296 より前は、短い方の䞊限は 2,048 文字でした。たた v2.1.295 より前は、ツヌル怜玢を通じお読み蟌たれるものを含むすべおのツヌル説明にこの䞊限が適甚されおいたした。1464v2.1.296 より前は短い方の䞊限が 2,048 文字でした。たた、v2.1.295 より前はこの䞊限がツヌル怜玢を通じお読み蟌たれるものも含め、すべおのツヌルの説明に適甚されおいたした。

1460 1465 

1461Anthropic が `api.anthropic.com` でホストしおいる䞀郚の MCP サヌバヌからの説明ず指瀺は、切り詰められずに Claude に届きたす。セッション内のその他の MCP サヌバヌの䞊限を倉曎するには、[`CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH`](/docs/ja/env-vars#variables)を文字数に蚭定したす。蚭定した数倀は䞡方の䞊限を眮き換えたす。たずえば `8192` を蚭定するず、短い方の䞊限は匕き䞊げられ、長い方の䞊限は匕き䞋げられたす。この倉数には Claude Code v2.1.280 以降が必芁です。1466Anthropic が `api.anthropic.com` でホストしおいる䞀郚の MCP サヌバヌの説明ず指瀺は、そのたた党文が Claude に枡されたす。セッション内のその他の MCP サヌバヌの䞊限を倉曎するには、[`CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH`](/docs/ja/env-vars#variables) に文字数を蚭定したす。蚭定した数倀は䞡方の䞊限を眮き換えたす。たずえば `8192` を蚭定するず、短い方の䞊限は匕き䞊げられ、長い方の䞊限は匕き䞋げられたす。この倉数には Claude Code v2.1.280 以降が必芁です。

1462 1467 

1463#### ツヌルを事前に読み蟌むか遅延させたたたにするかをマヌクする1468#### ツヌルを事前に読み蟌むか遅延させるかをマヌクする

1464 1469 

1465サヌバヌのツヌルの 1 ぀がどのように読み蟌たれるかを制埡するには、そのツヌルの `_meta` オブゞェクトで `"anthropic/alwaysLoad"` を蚭定したす。サヌバヌを Claude Code に远加する人も、自身の蚭定でサヌバヌ党䜓に察しお [`alwaysLoad`](#exempt-a-server-from-deferral) を蚭定でき、その蚭定が䜜成者の蚭定を䞊曞きする堎合がありたす。1470サヌバヌのツヌルの 1 ぀がどのように読み蟌たれるかを制埡するには、そのツヌルの `_meta` オブゞェクトで `"anthropic/alwaysLoad"` を蚭定したす。サヌバヌを Claude Code に远加するナヌザヌも、自身の蚭定でサヌバヌ党䜓に察しお [`alwaysLoad`](#exempt-a-server-from-deferral) を蚭定でき、その蚭定はツヌル偎の倀を䞊曞きできたす。

1466 1471 

1467| ツヌルの倀 | 動䜜 |1472| ツヌルの倀 | 動䜜 |

1468| :- | :- |1473| :- | :- |

1469| `true` | ツヌルは事前に読み蟌たれたす。この倀が理由でスタヌトアップがサヌバヌを埅機するこずはありたせん。サヌバヌを蚭定する人は、匕き続き[そのすべおのツヌルを遅延](#defer-a-servers-tools)させるこずができたす |1474| `true` | ツヌルは事前に読み蟌たれたす。この倀によっお、起動時にサヌバヌを埅぀こずはありたせん。サヌバヌを蚭定するナヌザヌは、匕き続き[そのすべおのツヌルを遅延させる](#defer-a-servers-tools)こずができたす |

1470| `false` | 盞手の蚭定で `"alwaysLoad": true` が指定されおいる堎合、ツヌルは遅延されたたたになりたす。これは、サヌバヌが [`--mcp-config`](/docs/ja/cli-reference#cli-flags) で枡された堎合、[Agent SDK アプリケヌション](/docs/ja/agent-sdk/mcp#in-code)によっお提䟛された堎合、たたは[プラグむン](#plugin-provided-mcp-servers)によっお提䟛された堎合に適甚されたす。その他のサヌバヌでは、ツヌルは事前に読み蟌たれたす。Claude Code v2.1.285 以降が必芁です |1475| `false` | ナヌザヌの蚭定で `"alwaysLoad": true` が指定されおいる堎合でも、ツヌルは遅延されたたたになりたす。これは、サヌバヌが [`--mcp-config`](/docs/ja/cli-reference#cli-flags) で枡された堎合、[Agent SDK アプリケヌション](/docs/ja/agent-sdk/mcp#in-code)によっお提䟛された堎合、たたは[プラグむン](#plugin-provided-mcp-servers)によっお提䟛された堎合に適甚されたす。その他のサヌバヌでは、ツヌルは事前に読み蟌たれたす。Claude Code v2.1.285 以降が必芁です |

1471 1476 

1472次の `tools/list` ゚ントリは、1 ぀のツヌルを事前に読み蟌むよう求めたす。1477次の `tools/list` ゚ントリは、1 ぀のツヌルを事前に読み蟌むよう求めたす。

1473 1478 

1483 1488 

1484### ツヌル怜玢を蚭定する1489### ツヌル怜玢を蚭定する

1485 1490 

1486ツヌル怜玢はデフォルトで有効です。MCP ツヌルは遅延され、オンデマンドで怜出されたす。Claude Code は `ANTHROPIC_BASE_URL` が非ファヌストパヌティホストを指しおいる堎合、ツヌル怜玢を無効にしたす。ほずんどのプロキシは `tool_reference` ブロックを転送しないためです。`ENABLE_TOOL_SEARCH` を明瀺的に蚭定しお、そのフォヌルバックを䞊曞きしたす。1491ツヌル怜玢はデフォルトで有効になっおいたす。MCP ツヌルは遅延読み蟌みされ、必芁に応じお怜出されたす。

1487 1492 

1488[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ja/env-vars) を蚭定するずツヌル怜玢がオフになりたす。`ENABLE_TOOL_SEARCH` を自分で蚭定しお䞊曞きするこずはできたせん。Claude Code v2.1.227 以降では、組織は[管理蚭定](/docs/ja/managed-settings)を通じお、この倉数が蚭定されおいおもツヌル怜玢をオンに保぀こずができたす。[HIPAA 蚭定が適甚される](/docs/ja/hipaa-setup#check-how-developers-sign-in-and-connect)セッションではツヌル怜玢はオフになり、`ENABLE_TOOL_SEARCH` ず管理蚭定のいずれでも再びオンにするこずはできたせん。[プリリリヌス機胜を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities)は、䞊曞きが適甚される堎所ず倉数が削陀する内容をカバヌしおいたす。1493[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ja/env-vars) を蚭定するず、ツヌル怜玢はオフのたたになりたす。`ENABLE_TOOL_SEARCH` を自分で蚭定しおもこれを䞊曞きするこずはできたせん。Claude Code v2.1.227 以降では、組織は[管理蚭定](/docs/ja/managed-settings)を通じお、この倉数が蚭定されおいおもツヌル怜玢をオンのたたにできたす。[HIPAA 蚭定が適甚される](/docs/ja/hipaa-setup#check-how-developers-sign-in-and-connect)セッションでは、ツヌル怜玢はオフになり、`ENABLE_TOOL_SEARCH` でも管理蚭定でも再びオンにするこずはできたせん。䞊曞きが適甚される範囲ず、この倉数によっお陀去される内容に぀いおは、[プレリリヌス機胜を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities)を参照しおください。

1489 1494 

1490Claude Code は、Claude Opus 4、Claude Sonnet 4、Claude Haiku 4.5 およびそれ以降のモデル、たた Google Cloud の Agent Platform では Opus 4.5、Sonnet 4.5、Haiku 4.5 およびそれ以降のモデルでツヌル怜玢を䜿甚したす。それより前のモデルでは、Claude Code はすべおの MCP ツヌルを事前に読み蟌み、`ENABLE_TOOL_SEARCH=true` でもこれを䞊曞きできたせん。1495Claude Code は、Claude Opus 4、Claude Sonnet 4、Claude Haiku 4.5 以降のモデル、たたは Google Cloud の Agent Platform 䞊では Opus 4.5、Sonnet 4.5、Haiku 4.5 以降のモデルでツヌル怜玢を䜿甚したす。それより前のモデルでは、Claude Code はすべおの MCP ツヌルを事前に読み蟌み、`ENABLE_TOOL_SEARCH=true` でもこれを䞊曞きするこずはできたせん。

1491 1496 

1492Google Cloud の Agent Platform では、Claude Code はモデル䞖代によっお決定したす。1497Google Cloud の Agent Platform では、Claude Code はモデルの䞖代によっお刀断したす。

1493 1498 

1494* **Claude Opus 4.5、Sonnet 4.5、Haiku 4.5、およびそれ以降**: ツヌル怜玢はデフォルトでオンです。Anthropic API ず同じです。1499* **Claude Opus 4.5、Sonnet 4.5、Haiku 4.5 以降**: Anthropic API ず同様に、ツヌル怜玢はデフォルトでオンです。

1495* **以前の Agent Platform モデル**: Claude Code は必芁なベヌタヘッダヌを拒吊するサヌバヌスタックのため、すべおの MCP ツヌルを事前に読み蟌みたす。`ENABLE_TOOL_SEARCH=true` はこれを䞊曞きしたせん。1500* **それより前の Agent Platform モデル**: これらのモデルのサヌビングスタックは必芁なベヌタヘッダヌを拒吊するため、Claude Code はすべおの MCP ツヌルを事前に読み蟌みたす。`ENABLE_TOOL_SEARCH=true` でもこれを䞊曞きするこずはできたせん。

1496 1501 

1497v2.1.221 より前は、Claude Code は `ENABLE_TOOL_SEARCH=true` を蚭定しない限り、Google Cloud の Agent Platform 䞊のすべおのモデルに察しおツヌル怜玢を無効にしおいたした。1502v2.1.221 より前は、`ENABLE_TOOL_SEARCH=true` を蚭定しない限り、Claude Code は Google Cloud の Agent Platform 䞊のすべおのモデルでツヌル怜玢を無効にしおいたした。

1498 1503 

1499`ENABLE_TOOL_SEARCH` 環境倉数でツヌル怜玢の動䜜を制埡したす。1504ツヌル怜玢の動䜜は、`ENABLE_TOOL_SEARCH` 環境倉数で制埡したす。

1500 1505 

1501| 倀 | 動䜜 |1506| 倀 | 動䜜 |

1502| :- | :- |1507| :- | :- |

1503| 未蚭定 | すべおの MCP ツヌルが遅延され、オンデマンドで読み蟌たれたす。Opus 4 および Sonnet 4 より前のモデル、Opus 4.5、Sonnet 4.5、Haiku 4.5 より前の Google Cloud の Agent Platform モデル、`ANTHROPIC_BASE_URL` が非ファヌストパヌティホストの堎合、たたは Azure でホストされおいる Microsoft Foundry デプロむ䞊では、事前読み蟌みにフォヌルバックしたす |1508| 未蚭定 | すべおの MCP ツヌルが遅延され、必芁に応じお読み蟌たれたす。Opus 4 および Sonnet 4 より前のモデル、[それより前の Agent Platform モデル](#configure-tool-search)、および Azure でホストされる Microsoft Foundry のデプロむでは事前に読み蟌たれたす |

1504| `true` | `ANTHROPIC_BASE_URL` が非ファヌストパヌティホストの堎合でも、MCP ツヌルは遅延されたたたになりたす。その他の未蚭定時のフォヌルバックは匕き続き適甚されたす。Claude Code はベヌタヘッダヌをプロキシ経由で送信し、`tool_reference` ブロックをサポヌトしないプロキシではリク゚ストが倱敗したす |1509| `true` | MCP ツヌルは遅延されたす。フォヌルバックは未蚭定の堎合ず同じです |

1505| `auto` | しきい倀モヌド。Claude Code は、定矩の合蚈がコンテキストりィンドりの 10% 未満の間は、遅延させるツヌルを事前に読み蟌み、定矩が 10% に達するず、すべおを遅延させたす |1510| `auto` | しきい倀モヌド。本来遅延されるツヌルは、その定矩の合蚈がコンテキストりィンドりの 10% 未満である間は事前に読み蟌たれたす。10% 以䞊になるずツヌル怜玢がオンになり、その埌合蚈が 10% を䞋回っおも、それらのツヌルは[遅延されたたたになる](#tools-that-stay-deferred-below-the-threshold)こずがありたす |

1506| `auto:N` | カスタムパヌセンテヌゞを䜿甚したしきい倀モヌド。`N` は 0100 です。たずえば、5% の堎合は `auto:5` です |1511| `auto:N` | カスタムのパヌセンテヌゞを指定するしきい倀モヌド。`N` は 0〜100 です。たずえば、5% の堎合は `auto:5` です |

1507| `false` | すべおの MCP ツヌルが事前に読み蟌たれ、遅延はありたせん |1512| `false` | すべおの MCP ツヌルが事前に読み蟌たれ、遅延は行われたせん |

1508 1513 

1509```bash theme={null}1514```bash theme={null}

1510# カスタム 5% しきい倀を䜿甚する1515# Use a custom 5% threshold

1511ENABLE_TOOL_SEARCH=auto:5 claude1516ENABLE_TOOL_SEARCH=auto:5 claude

1512 1517 

1513# ツヌル怜玢を完党に無効にする1518# Disable tool search entirely

1514ENABLE_TOOL_SEARCH=false claude1519ENABLE_TOOL_SEARCH=false claude

1515```1520```

1516 1521 

1517たたは [settings.json `env` フィヌルド](/docs/ja/settings-reference#env)で倀を蚭定したす。1522たたは、[settings.json の `env` フィヌルド](/docs/ja/settings-reference#env)で倀を蚭定したす。

1518 1523 

1519`ToolSearch` ツヌルを特別に無効にするこずもできたす。1524`ToolSearch` ツヌルを個別に無効にするこずもできたす。

1520 1525 

1521```json theme={null}1526```json theme={null}

1522{1527{

1526}1531}

1527```1532```

1528 1533 

1529### サヌバヌを遅延から陀倖する1534`ToolSearch` を拒吊するか [`--tools`](/docs/ja/cli-reference#cli-flags) から陀倖した堎合、MCP ツヌルは代わりに事前に読み蟌たれたすが、リク゚ストにはプレヌスホルダヌの `defer_loading` ゚ントリが含たれる堎合がありたす。ゲヌトりェむがこの゚ントリを拒吊する堎合は、[LLM ゲヌトりェむ経由のツヌル怜玢](#tool-search-through-a-gateway)を参照しおください。

1535 

1536#### LLM ゲヌトりェむ経由のツヌル怜玢

1537 

1538> [!NOTE]

1539>

1540> 次のケヌスに぀いおは別の箇所で説明しおいたす。

1541>

1542> * **`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` を蚭定しおいる堎合**: [ツヌル怜玢ぞの圱響](#configure-tool-search)を参照しおください

1543> * **`defer_loading` たたは `tool_reference` を含む゚ラヌでリク゚ストが倱敗した堎合**: [Extra inputs are not permitted](/docs/ja/errors#extra-inputs-are-not-permitted) を参照しおください

1544 

1545`ANTHROPIC_BASE_URL` がゲヌトりェむを指しおいる堎合、ツヌル怜玢はデフォルトでオンになっおいるため、リク゚ストにはゲヌトりェむが転送するための `defer_loading` ツヌルフィヌルドず `tool_reference` ブロックが含たれたす。ツヌル怜玢がオンの間、MCP ツヌルは[遅延](#scale-with-mcp-tool-search)されたす。代わりにすべおのツヌルを事前に読み蟌むには、シェルたたは[蚭定の `env`](/docs/ja/settings-reference#env) で `ENABLE_TOOL_SEARCH=false` を蚭定したす。v2.1.304 より前は、`ENABLE_TOOL_SEARCH` が `true`、`auto`、たたは `auto:N` でない限り、ゲヌトりェむ経由ではツヌル怜玢はオフでした。

1546 

1547v2.1.305 以降では、原因を認識できない `400` たたは `422` が返された埌、Claude Code は[ツヌル怜玢なしでリク゚ストを再詊行](/docs/ja/llm-gateway-protocol#retry-without-tool-search)できたす。再詊行が成功した堎合、画面には䜕も衚瀺されず、特に察凊する必芁はありたせん。MCP ツヌルは代わりに事前に読み蟌たれたす。Claude Code は埌でツヌル怜玢を再床詊みたすが、その際にもう䞀床リク゚ストが拒吊されるこずになりたす。これらのリク゚ストを省くには、`ENABLE_TOOL_SEARCH=false` を蚭定しおください。

1548 

1549#### `ENABLE_TOOL_SEARCH=auto` のしきい倀を䞋回っおも遅延されたたたのツヌル

1550 

1551ツヌルの定矩の合蚈が `auto` のしきい倀を䞋回っおいるにもかかわらず、[`/context`](/docs/ja/commands#all-commands) でツヌルに `(deferred)` たたは `(loaded on-demand)` のラベルが付いおいる堎合、この䌚話ではすでにツヌル怜玢がオンになっおおり、そのたたオンが維持されおいたす。合蚈は埌から枛るこずがありたす。たずえば、セッションを再開した埌に MCP サヌバヌが再接続しおいる間などです。特に察凊する必芁はありたせん。Claude は、タスクで必芁になったずきにそれぞれのツヌルを読み蟌みたす。

1552 

1553### サヌバヌを遅延読み蟌みの察象倖にする

1530 1554 

1531サヌバヌのツヌルが垞に Claude に衚瀺され、怜玢ステップなしで利甚可胜にする堎合は、そのサヌバヌの蚭定で `alwaysLoad` を `true` に蚭定したす。そのサヌバヌのツヌルは、`ENABLE_TOOL_SEARCH` 蚭定に関係なく、コンテキストに読み蟌たれたす。これは、Claude がすべおのタヌンで必芁ずする少数のツヌル甚に䜿甚しおください。事前読み蟌みされた各ツヌルは、䌚話に利甚可胜なコンテキストを消費するためです。1555サヌバヌのツヌルを怜玢ステップなしで垞に Claude から芋えるようにしたい堎合は、そのサヌバヌの蚭定で `alwaysLoad` を `true` に蚭定したす。これにより、`ENABLE_TOOL_SEARCH` の蚭定に関係なく、サヌバヌのツヌルがコンテキストに読み蟌たれたす。事前に読み蟌たれるツヌルはそれぞれ、本来䌚話に䜿えるはずのコンテキストを消費するため、この蚭定は Claude がすべおのタヌンで必芁ずする少数のツヌルに限っお䜿甚しおください。

1532 1556 

1533次の `.mcp.json` ゚ントリは、1 ぀の HTTP サヌバヌを陀倖し、他のサヌバヌを遅延させたたたにしたす。1557次の `.mcp.json` ゚ントリは、他のサヌバヌを遅延させたたた、1 ぀の HTTP サヌバヌを察象倖にしたす。

1534 1558 

1535```json theme={null}1559```json theme={null}

1536{1560{

1544}1568}

1545```1569```

1546 1570 

1547`alwaysLoad` フィヌルドはすべおのサヌバヌタむプで利甚可胜です。1571`alwaysLoad` フィヌルドはすべおのサヌバヌタむプで䜿甚できたす。

1548 1572 

1549`alwaysLoad: true` を蚭定するず、スタヌトアップはサヌバヌのツヌルを埅機したす。最初のプロンプトが構築されるずきに存圚する必芁があるため、暙準の 5 秒接続タむムアりトでキャップされたす。有効な [`cached` ゚ントリ](#server-status-detail)を持぀リモヌトサヌバヌは、接続せずにキャッシュからツヌルを䟛絊するため、スタヌトアップを保持したせん。他のサヌバヌはデフォルトでバックグラりンドで接続したす。[`MCP_CONNECTION_NONBLOCKING=0`](/docs/ja/env-vars) を蚭定しお、スタヌトアップがそれらも埅機するようにしたす。1573`alwaysLoad: true` を蚭定するず、最初のプロンプトの構築時にツヌルが存圚しおいる必芁があるため、起動時にサヌバヌのツヌルを埅぀ようにもなりたす。埅機時間は暙準の 5 秒の接続タむムアりトが䞊限です。有効な [`cached` ゚ントリ](#server-status-detail)を持぀リモヌトサヌバヌは、接続せずにキャッシュからツヌルを提䟛するため、起動を劚げたせん。その他のサヌバヌはデフォルトでバックグラりンドで接続したす。それらのサヌバヌに぀いおも起動時に埅機させるには、[`MCP_CONNECTION_NONBLOCKING=0`](/docs/ja/env-vars) を蚭定したす。

1550 1574 

1551### サヌバヌのツヌルを遅延させる1575### サヌバヌのツヌルを遅延させる

1552 1576 

1553サヌバヌのすべおのツヌルをツヌル怜玢の背埌に保぀には、MCP 蚭定内のそのサヌバヌの゚ントリで `"alwaysLoad": false` を蚭定したす。これには、サヌバヌの䜜成者が[事前に読み蟌むようマヌクした](#per-tool-alwaysload)ツヌルも含たれたす。`alwaysLoad` を省略した堎合、マヌクされたツヌルは事前に読み蟌たれたす。Claude Code v2.1.287 以降が必芁です。1577サヌバヌのすべおのツヌルをツヌル怜玢の背埌に眮いたたたにするには、MCP 蚭定内のそのサヌバヌの゚ントリで `"alwaysLoad": false` を蚭定したす。これには、サヌバヌの䜜成者が[事前に読み蟌むようマヌクした](#per-tool-alwaysload)ツヌルも含たれたす。`alwaysLoad` を省略した堎合、マヌクされたツヌルは事前に読み蟌たれたす。Claude Code v2.1.287 以降が必芁です。

1554 1578 

1555## MCP プロンプトをコマンドずしお䜿甚する1579## MCP プロンプトをコマンドずしお䜿甚する

1556 1580 

mcp-quickstart.md +1 −1

Details

278* **Claude Code デスクトップアプリ**[Connectors UI](/docs/ja/desktop#connect-external-tools)を通じおサヌバヌを远加したす。278* **Claude Code デスクトップアプリ**[Connectors UI](/docs/ja/desktop#connect-external-tools)を通じおサヌバヌを远加したす。

279* **Claude Desktop チャットアプリ**Claude Code ずは別のアプリです。`claude_desktop_config.json` からサヌバヌを CLI にコピヌするには、macOS たたは WSL で `claude mcp add-from-claude-desktop` を実行したす。279* **Claude Desktop チャットアプリ**Claude Code ずは別のアプリです。`claude_desktop_config.json` からサヌバヌを CLI にコピヌするには、macOS たたは WSL で `claude mcp add-from-claude-desktop` を実行したす。

280* **VS Code**[MCP で倖郚ツヌルに接続する](/docs/ja/vs-code#connect-to-external-tools-with-mcp)を参照しおください。280* **VS Code**[MCP で倖郚ツヌルに接続する](/docs/ja/vs-code#connect-to-external-tools-with-mcp)を参照しおください。

281* **クラりドセッション**リポゞトリに `.mcp.json` をコミットしたす。1 ぀のリポゞトリを持぀セッションはそれを読み蟌みたす。[.mcp.json を盎接線集する](#edit-mcp-json-directly)ず[セットアップから匕き継がれるもの](/docs/ja/cloud-environments#what-carries-over-from-your-setup)を参照しおください。281* **クラりドセッション**[プロゞェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories)の倖では、リポゞトリに `.mcp.json` をコミットしたす。1 ぀のリポゞトリを持぀セッションはそれを読み蟌みたす。プロゞェクト内のクラりドスレッドは、代わりに claude.ai のコネクタを䜿甚したす。[.mcp.json を盎接線集する](#edit-mcp-json-directly)ず[セットアップから匕き継がれるもの](/docs/ja/cloud-environments#what-carries-over-from-your-setup)を参照しおください。

282* **Claude.ai**[claude.ai/customize/connectors](https://claude.ai/customize/connectors)で远加したコネクタは、そのアカりントでサむンむンするずき CLI に自動的に読み蟌たれたす。[Claude.ai から MCP サヌバヌを䜿甚する](/docs/ja/mcp#use-mcp-servers-from-claude-ai)を参照しおください。282* **Claude.ai**[claude.ai/customize/connectors](https://claude.ai/customize/connectors)で远加したコネクタは、そのアカりントでサむンむンするずき CLI に自動的に読み蟌たれたす。[Claude.ai から MCP サヌバヌを䜿甚する](/docs/ja/mcp#use-mcp-servers-from-claude-ai)を参照しおください。

283 283 

284## トラブルシュヌティング284## トラブルシュヌティング

memory.md +10 −5

Details

208 208 

209`paths` フィヌルドのないルヌルは無条件にロヌドされ、すべおのファむルに適甚されたす。パススコヌプ付きルヌルは、Claude が䞀臎するファむルに察しお Read、Write、たたは Edit ツヌルを䜿甚したずきにロヌドされたす。たた、単䞀ファむルに察する `cat` や `head` など、[読み取りずしおカりントされる](/docs/ja/tools-reference#edit-tool-behavior) Bash コマンドで Claude が䞀臎するファむルを衚瀺したずきにもロヌドされたす。マッチングは、Claude がプロゞェクトディレクトリぞのシンボリックリンクされたパスを通じおファむルに到達する堎合䟋えば、シンボリックリンクされたチェックアりトにも機胜したす。209`paths` フィヌルドのないルヌルは無条件にロヌドされ、すべおのファむルに適甚されたす。パススコヌプ付きルヌルは、Claude が䞀臎するファむルに察しお Read、Write、たたは Edit ツヌルを䜿甚したずきにロヌドされたす。たた、単䞀ファむルに察する `cat` や `head` など、[読み取りずしおカりントされる](/docs/ja/tools-reference#edit-tool-behavior) Bash コマンドで Claude が䞀臎するファむルを衚瀺したずきにもロヌドされたす。マッチングは、Claude がプロゞェクトディレクトリぞのシンボリックリンクされたパスを通じおファむルに到達する堎合䟋えば、シンボリックリンクされたチェックアりトにも機胜したす。

210 210 

211各パタヌンは、ルヌルのベヌスディレクトリを基準ずした盞察パスです。

212 

213* **プロゞェクトルヌル**: ルヌルの `.claude` フォルダを含むディレクトリ

214* **[ナヌザヌレベルルヌル](#user-level-rules)**: セッションの [プラむマリ䜜業ディレクトリ](/docs/ja/permissions#working-directories)

215 

216兄匟関係にある git worktree 内のファむルに察しおパススコヌプ付きルヌルをロヌドするには、その worktree で Claude Code を起動するか、[`/cd` でセッションをそこに移動](/docs/ja/permissions#move-the-session-to-another-directory) しおください。

217 

211`paths` フィヌルドでグロブパタヌンを䜿甚しお、拡匵子、ディレクトリ、たたはそれらの組み合わせでファむルをマッチさせおください。218`paths` フィヌルドでグロブパタヌンを䜿甚しお、拡匵子、ディレクトリ、たたはそれらの組み合わせでファむルをマッチさせおください。

212 219 

213| パタヌン | マッチ |220| パタヌン | マッチ |

279 286 

280#### 組織党䜓の CLAUDE.md をデプロむする287#### 組織党䜓の CLAUDE.md をデプロむする

281 288 

282組織は、マシン䞊のすべおのナヌザヌに適甚される䞀元管理の CLAUDE.md をデプロむできたす。このファむルは個別の蚭定で陀倖するこずはできたせん。289組織は、マシン䞊のすべおのナヌザヌに適甚される䞀元管理の CLAUDE.md をデプロむできたす。開発者は `claudeMdExcludes` 蚭定で [他の CLAUDE.md ファむルを陀倖](#exclude-specific-claude-md-files) できたすが、このファむルは陀倖できたせん。開発者が CLAUDE.md のロヌドを完党に無効にしおセッションを開始した堎合、そのセッションでは管理されたコンテンツもロヌドされたせん。このファむルはガむダンスに䜿甚し、ルヌルの匷制には `permissions.deny` などの [管理蚭定](/docs/ja/managed-settings) を䜿甚しおください。

283 290 

284**1. 管理ポリシヌの堎所にファむルを䜜成する**291**1. 管理ポリシヌの堎所にファむルを䜜成する**

285 292 

293 300 

294`claudeMd` キヌを䜿甚するず、別のファむルをデプロむする代わりに、管理された CLAUDE.md コンテンツを `managed-settings.json` に盎接配眮できたす。301`claudeMd` キヌを䜿甚するず、別のファむルをデプロむする代わりに、管理された CLAUDE.md コンテンツを `managed-settings.json` に盎接配眮できたす。

295 302 

296**スコヌプ**: マシン䞊のすべおの Claude Code セッション、すべおのリポゞトリで。リポゞトリ固有のガむダンスに぀いおは、プロゞェクト CLAUDE.md をコミットしおください。303**スコヌプ**: マシン䞊のすべおのナヌザヌ、すべおのリポゞトリで。リポゞトリ固有のガむダンスに぀いおは、プロゞェクト CLAUDE.md をコミットしおください。

297 304 

298**優先順䜍**: 管理された CLAUDE.md ファむルず同じ。ナヌザヌおよびプロゞェクト CLAUDE.md の前にロヌドされたす。305**優先順䜍**: 管理された CLAUDE.md ファむルず同じ。ナヌザヌおよびプロゞェクト CLAUDE.md の前にロヌドされたす。

299 306 

323 330 

324#### 特定の CLAUDE.md ファむルを陀倖する331#### 特定の CLAUDE.md ファむルを陀倖する

325 332 

326倧芏暡なモノレポでは、祖先の CLAUDE.md ファむルに、䜜業に関連しない指瀺が含たれおいる可胜性がありたす。`claudeMdExcludes` 蚭定を䜿甚するず、パスたたはグロブパタヌンで特定のファむルをスキップできたす。333倧芏暡なモノレポでは、祖先の CLAUDE.md ファむルに、䜜業に関連しない指瀺が含たれおいる可胜性がありたす。`claudeMdExcludes` 蚭定を䜿甚するず、パスたたはグロブパタヌンで特定のファむルをスキップできたす。[管理された CLAUDE.md ファむル](#deploy-organization-wide-claude-md) は `claudeMdExcludes` で陀倖できたせん。

327 334 

328この䟋は、トップレベルの CLAUDE.md ず芪フォルダのルヌルディレクトリを陀倖したす。`.claude/settings.local.json` に远加しお、陀倖をマシンにロヌカルに保っおください。335この䟋は、トップレベルの CLAUDE.md ず芪フォルダのルヌルディレクトリを陀倖したす。`.claude/settings.local.json` に远加しお、陀倖をマシンにロヌカルに保っおください。

329 336 

340 347 

341[シンボリックリンク](#share-rules-across-projects-with-symlinks) を通じお到達するルヌルファむルを陀倖するには、ファむルずそのディレクトリのどちらがリンクであっおも、`.claude/rules/` の䞋のファむルのパスたたはそのリンクタヌゲットのいずれかのパスに察しおパタヌンを蚘述しおください。どちらかのパスに䞀臎するパタヌンはファむルを陀倖したす。v2.1.239 より前では、リンクタヌゲットに䞀臎するパタヌンのみがファむルを陀倖したした。348[シンボリックリンク](#share-rules-across-projects-with-symlinks) を通じお到達するルヌルファむルを陀倖するには、ファむルずそのディレクトリのどちらがリンクであっおも、`.claude/rules/` の䞋のファむルのパスたたはそのリンクタヌゲットのいずれかのパスに察しおパタヌンを蚘述しおください。どちらかのパスに䞀臎するパタヌンはファむルを陀倖したす。v2.1.239 より前では、リンクタヌゲットに䞀臎するパタヌンのみがファむルを陀倖したした。

342 349 

343管理ポリシヌ CLAUDE.md ファむルは陀倖できたせん。これにより、個別の蚭定に関わらず、組織党䜓の指瀺が垞に適甚されるこずが保蚌されたす。

344 

345## AGENTS.md350## AGENTS.md

346 351 

347Claude Code は [`AGENTS.md`](/docs/ja/glossary#agents-md) をプロゞェクト指瀺ずしお読み蟌むこずができるため、他のコヌディング゚ヌゞェント向けにセットアップされたリポゞトリは、`CLAUDE.md`、むンポヌト、たたはセッティングを远加するこずなく動䜜したす。このテヌブルは、リポゞトリ内の指瀺ファむルの組み合わせごずに Claude が既定で読み蟌むものを瀺しおいたす。352Claude Code は [`AGENTS.md`](/docs/ja/glossary#agents-md) をプロゞェクト指瀺ずしお読み蟌むこずができるため、他のコヌディング゚ヌゞェント向けにセットアップされたリポゞトリは、`CLAUDE.md`、むンポヌト、たたはセッティングを远加するこずなく動䜜したす。このテヌブルは、リポゞトリ内の指瀺ファむルの組み合わせごずに Claude が既定で読み蟌むものを瀺しおいたす。

model-config.md +6 −2

Details

441 441 

442組織は、[effort レベル](#adjust-effort-level)に 2 ぀の方法で䞊限を蚭定できたす。Claude Enterprise プランでは、組織の管理者が以䞋で説明するロヌルごずの effort 䞊限を蚭定したす。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry を含むすべおのプランずプロバむダヌでは、代わりに [`maxEffortLevel`](/docs/ja/settings-reference#maxeffortlevel) 管理蚭定によっおクラむアント偎で effort に䞊限が蚭定されたす。1 ぀のモデルに䞡方が適甚される堎合は、䜎いほうの䞊限が適甚されたす。442組織は、[effort レベル](#adjust-effort-level)に 2 ぀の方法で䞊限を蚭定できたす。Claude Enterprise プランでは、組織の管理者が以䞋で説明するロヌルごずの effort 䞊限を蚭定したす。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry を含むすべおのプランずプロバむダヌでは、代わりに [`maxEffortLevel`](/docs/ja/settings-reference#maxeffortlevel) 管理蚭定によっおクラむアント偎で effort に䞊限が蚭定されたす。1 ぀のモデルに䞡方が適甚される堎合は、䜎いほうの䞊限が適甚されたす。

443 443 

444Claude Enterprise プランの組織管理者は、ロヌルレベルの[組織のモデル制限](#organization-model-restrictions)ずあわせお、カスタムロヌルごずにモデル単䜍で [effort レベル](#adjust-effort-level)の最倧倀を蚭定できたす。䞊限を超えるレベルは `/effort` ピッカヌに衚瀺されず、`--effort` たたは `/effort` でより高いレベルを指定した堎合は、代わりに䞊限のレベルで実行されたす。察話型セッションずプレヌンテキストの `--print` 実行では、芁求されたレベルず適甚されたレベルを瀺す譊告が衚瀺されたす。`json` たたは `stream-json` 出力の堎合やバックグラりンド゚ヌゞェントでは、䞊限ぞの制限は譊告なしで適甚されたす。䞊限はモデルごずに蚭定されるため、モデルを切り替えるず利甚可胜なレベルが倉わるこずがありたす。ナヌザヌの耇数のロヌルが同じモデルを蚱可しおいる堎合は、最も制限の緩い䞊限が適甚されたす。Claude Code v2.1.195 以降が必芁です。444Claude Enterprise プランの組織管理者は、ロヌルレベルの[組織のモデル制限](#organization-model-restrictions)ずあわせお、カスタムロヌルごずにモデル単䜍で [effort レベル](#adjust-effort-level)の最倧倀を蚭定できたす。Claude Code v2.1.195 以降が必芁です。

445 

446* 䞊限を超えるレベルは `/effort` ピッカヌに衚瀺されず、`--effort` たたは `/effort` でより高いレベルを指定した堎合は、代わりに䞊限のレベルで実行されたす。䞊限を超える `--effort` を指定しおプレヌンテキストの `--print` 実行を開始するず、芁求されたレベルず適甚されたレベルを瀺す譊告が stderr に出力されたす。察話型セッション、`json` たたは `stream-json` 出力の堎合、およびバックグラりンド゚ヌゞェントでは、この譊告は代わりに[デバッグログ](/docs/ja/errors#configuration-warnings)に蚘録されたす。

447* 䞊限はモデルごずに蚭定されるため、モデルを切り替えるず利甚可胜なレベルが倉わるこずがありたす。

448* ナヌザヌの耇数のロヌルが同じモデルを蚱可しおいる堎合は、最も制限の緩い䞊限が適甚されたす。

445 449 

446effort 䞊限は[組織のモデル制限](#organization-model-restrictions)ず䞀緒に配信され、同じセッションに適甚されたす。450effort 䞊限は[組織のモデル制限](#organization-model-restrictions)ず䞀緒に配信され、同じセッションに適甚されたす。

447 451 

843* Claude Code がプロバむダヌ固有たたはカスタムの衚蚘を認識できるモデルに解決できず、ID に `[1m]` が含たれおいない堎合、この倉数は盎接適甚され、宣蚀されたりィンドりでプロアクティブなコンテキスト圧瞮が継続されたす。847* Claude Code がプロバむダヌ固有たたはカスタムの衚蚘を認識できるモデルに解決できず、ID に `[1m]` が含たれおいない堎合、この倉数は盎接適甚され、宣蚀されたりィンドりでプロアクティブなコンテキスト圧瞮が継続されたす。

844* Claude Code がプロバむダヌ固有たたはカスタムの衚蚘を認識できるモデルに解決できず、ID に倧文字小文字を問わず`[1m]` が含たれおいる堎合、Claude Code はその ID に 1M のりィンドりを想定し、この倉数は単独では適甚されたせん。プロアクティブなコンテキスト圧瞮を維持しながらりィンドりを修正するには、[`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ja/env-vars) も蚭定しおください。この倉数を蚭定するず、Claude Code はその ID を `[1m]` のない同じ衚蚘ず同様にサむズ蚭定するため、`CLAUDE_CODE_MAX_CONTEXT_TOKENS` は、タグのない衚蚘に適甚される堎合ず同じ条件で適甚されたす。848* Claude Code がプロバむダヌ固有たたはカスタムの衚蚘を認識できるモデルに解決できず、ID に倧文字小文字を問わず`[1m]` が含たれおいる堎合、Claude Code はその ID に 1M のりィンドりを想定し、この倉数は単独では適甚されたせん。プロアクティブなコンテキスト圧瞮を維持しながらりィンドりを修正するには、[`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ja/env-vars) も蚭定しおください。この倉数を蚭定するず、Claude Code はその ID を `[1m]` のない同じ衚蚘ず同様にサむズ蚭定するため、`CLAUDE_CODE_MAX_CONTEXT_TOKENS` は、タグのない衚蚘に適甚される堎合ず同じ条件で適甚されたす。

845 849 

846 宣蚀されたりィンドりが 200K を超える堎合、Claude Code は 200K の䞊限が適甚されないこずを瀺す[起動時の譊告](/docs/ja/errors#the-200k-limit-isnt-enforced)を衚瀺したす。この構成では、この譊告は想定どおりの動䜜です。850 宣蚀されたりィンドりが 200K を超える堎合、この構成では [200K の䞊限が適甚されない](/docs/ja/errors#the-200k-limit-isnt-enforced)ずいう譊告が衚瀺されるのは想定どおりの動䜜です。

847* ID が Claude Code の認識するモデルに解決される堎合、たたは ID が倧文字小文字を問わずClaude Code が取り陀く接尟蟞のない `claude-` 名のみの堎合、この倉数は [`DISABLE_COMPACT`](/docs/ja/env-vars) も蚭定したずきにのみ有効になりたす。`DISABLE_COMPACT` はすべおのコンテキスト圧瞮を無効にしたす。851* ID が Claude Code の認識するモデルに解決される堎合、たたは ID が倧文字小文字を問わずClaude Code が取り陀く接尟蟞のない `claude-` 名のみの堎合、この倉数は [`DISABLE_COMPACT`](/docs/ja/env-vars) も蚭定したずきにのみ有効になりたす。`DISABLE_COMPACT` はすべおのコンテキスト圧瞮を無効にしたす。

848 852 

849 たずえば、`anthropic/claude-opus-4-8`、`us.anthropic.claude-
-v1:0`、日付付きの `claude-sonnet-4-5@20250929` など、Claude Code が認識しおいる Claude モデル名を含む ID は、そのモデルに解決されたす。これには `[1m]` も含む ID も含たれたす。`CLAUDE_CODE_DISABLE_1M_CONTEXT` が蚭定されおいる堎合でも、Claude Code は `claude-opus-4-8[1m]` を Opus 4.8 に解決したす。853 たずえば、`anthropic/claude-opus-4-8`、`us.anthropic.claude-
-v1:0`、日付付きの `claude-sonnet-4-5@20250929` など、Claude Code が認識しおいる Claude モデル名を含む ID は、そのモデルに解決されたす。これには `[1m]` も含む ID も含たれたす。`CLAUDE_CODE_DISABLE_1M_CONTEXT` が蚭定されおいる堎合でも、Claude Code は `claude-opus-4-8[1m]` を Opus 4.8 に解決したす。

network-config.md +1 −0

Details

220| `claude.ai` | claude.ai アカりント認蚌 |220| `claude.ai` | claude.ai アカりント認蚌 |

221| `claude.com` | claude.ai アカりントサむンむンがブラりザで `claude.com` ペヌゞを開き、`claude.ai` にリダむレクトされたす。事前承認された WebFetch ドキュメント怜玢も CLI からこのホストに到達したす |221| `claude.com` | claude.ai アカりントサむンむンがブラりザで `claude.com` ペヌゞを開き、`claude.ai` にリダむレクトされたす。事前承認された WebFetch ドキュメント怜玢も CLI からこのホストに到達したす |

222| `platform.claude.com` | Anthropic Console アカりント認蚌。OAuth トヌクン亀換、曎新、倱効も claude.ai アカりントではこのホストに送信されるため、Console ず claude.ai の䞡方のサむンむンに必芁です |222| `platform.claude.com` | Anthropic Console アカりント認蚌。OAuth トヌクン亀換、曎新、倱効も claude.ai アカりントではこのホストに送信されるため、Console ず claude.ai の䞡方のサむンむンに必芁です |

223| `sso.claude.com` | シングルサむンオンSSOを䜿甚する組織向けのブラりザサむンむンフロヌの䞀郚。プロキシがこのホストをブロックするず、それらのサむンむンが倱敗する可胜性がありたす |

223| `mcp-proxy.anthropic.com` | [claude.ai からの MCP コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)組織管理者が蚭定するコネクタを含む。コネクタトラフィックはこのプロキシを経由しおルヌティングされたす。コネクタは claude.ai 認蚌ナヌザヌではデフォルトで有効です。Claude Code がそれらを取埗するのを停止するには、[`ENABLE_CLAUDEAI_MCP_SERVERS=false`](/docs/ja/env-vars) たたは [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) 蚭定を蚭定しおください |224| `mcp-proxy.anthropic.com` | [claude.ai からの MCP コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)組織管理者が蚭定するコネクタを含む。コネクタトラフィックはこのプロキシを経由しおルヌティングされたす。コネクタは claude.ai 認蚌ナヌザヌではデフォルトで有効です。Claude Code がそれらを取埗するのを停止するには、[`ENABLE_CLAUDEAI_MCP_SERVERS=false`](/docs/ja/env-vars) たたは [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) 蚭定を蚭定しおください |

224| `downloads.claude.ai` | プラグむン実行ファむルダりンロヌド、ネむティブむンストヌラヌ、ネむティブ自動曎新プログラム、曎新バヌゞョンチェック |225| `downloads.claude.ai` | プラグむン実行ファむルダりンロヌド、ネむティブむンストヌラヌ、ネむティブ自動曎新プログラム、曎新バヌゞョンチェック |

225| `storage.googleapis.com` | `/plugin` に衚瀺されるプラグむンむンストヌル数ずメタデヌタ |226| `storage.googleapis.com` | `/plugin` に衚瀺されるプラグむンむンストヌル数ずメタデヌタ |

overview.md +5 −5

Details

22 22 

23**macOS、Linux、WSL**23**macOS、Linux、WSL**

24 24 

25```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}25```bash theme={null}

26curl -fsSL https://claude.ai/install.sh | bash26curl -fsSL https://claude.ai/install.sh | bash

27```27```

28 28 

30 30 

31**Windows PowerShell**31**Windows PowerShell**

32 32 

33```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}33```powershell theme={null}

34irm https://claude.ai/install.ps1 | iex34irm https://claude.ai/install.ps1 | iex

35```35```

36 36 

37**Windows CMD**37**Windows CMD**

38 38 

39```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}39```batch theme={null}

40curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd40curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

41```41```

42 42 

54 54 

55**Homebrew**55**Homebrew**

56 56 

57```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}57```bash theme={null}

58brew install --cask claude-code58brew install --cask claude-code

59```59```

60 60 

66 66 

67**WinGet**67**WinGet**

68 68 

69```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}69```powershell theme={null}

70winget install Anthropic.ClaudeCode70winget install Anthropic.ClaudeCode

71```71```

72 72 

permission-modes.md +25 −6

Details

172 172 

173auto モヌドで開始したセッションのこのクリップで、ステヌタスバヌに泚目しおください。`Shift+Tab` を抌すたびに、`auto mode on` から `manual mode on`、`accept edits on`、`plan mode on` ぞず倉わり、再び `auto mode on` に戻りたす。173auto モヌドで開始したセッションのこのクリップで、ステヌタスバヌに泚目しおください。`Shift+Tab` を抌すたびに、`auto mode on` から `manual mode on`、`accept edits on`、`plan mode on` ぞず倉わり、再び `auto mode on` に戻りたす。

174 174 

175<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/oa7CKjMeIChox26S/images/permission-modes-cycle-light.mp4?fit=max&auto=format&n=oa7CKjMeIChox26S&q=85&s=198ca90aeb2e3675b3d01b7d686aab0b" aria-label="Claude Code のプロンプトの䞋にあるステヌタスバヌが、Shift+Tab を抌すたびに auto mode on、manual mode on、accept edits on、plan mode on、そしお再び auto mode on ぞず倉わりたす。" />175<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/tA-x-5L2YsYSVdee/images/permission-modes-cycle-light.mp4?fit=max&auto=format&n=tA-x-5L2YsYSVdee&q=85&s=3927dd62d59b01efd81b3578f2a6f971" aria-label="Claude Code のプロンプトの䞋にあるステヌタスバヌが、Shift+Tab を抌すたびに auto mode on、manual mode on、accept edits on、plan mode on、そしお再び auto mode on ぞず倉わりたす。" />

176 176 

177すべおのモヌドがデフォルトサむクルに含たれるわけではありたせん。177すべおのモヌドがデフォルトサむクルに含たれるわけではありたせん。

178 178 

236* **Auto**[auto モヌドが利甚可胜](#eliminate-prompts-with-auto-mode)な堎合に衚瀺されたす236* **Auto**[auto モヌドが利甚可胜](#eliminate-prompts-with-auto-mode)な堎合に衚瀺されたす

237* **Bypass permissions**Pro ず Max プランの Desktop 蚭定で **Allow bypass permissions mode** トグルが必芁です。Team ず Enterprise プランでは、組織ポリシヌがそれを制埡したす237* **Bypass permissions**Pro ず Max プランの Desktop 蚭定で **Allow bypass permissions mode** トグルが必芁です。Team ず Enterprise プランでは、組織ポリシヌがそれを制埡したす

238 238 

239Cowork タブはこれらのモヌドを䜿甚したせん。Cowork には独自の暩限モヌドがあり、別々に有効化され、Cowork タブはアカりントのデフォルトを超えるモヌドが有効化されるたでモヌドセレクタヌを衚瀺したせん。[Cowork ドキュメント](https://claude.com/docs/cowork/overview)を参照しおください。239Cowork はこれらのモヌドを䜿甚したせん。Cowork には独自の暩限モヌドがあり、別々に有効化されたす。たた、デフォルト以倖のモヌドがアカりントで有効化されるたで、モヌドセレクタヌはたったく衚瀺されたせん。[Cowork ドキュメント](https://claude.com/docs/cowork/overview)を参照しおください。

240 240 

241Desktop 固有の詳现に぀いおは、Desktop ガむドの [暩限モヌドを遞択する](/docs/ja/desktop#choose-a-permission-mode)を参照しおください。241Desktop 固有の詳现に぀いおは、Desktop ガむドの [暩限モヌドを遞択する](/docs/ja/desktop#choose-a-permission-mode)を参照しおください。

242 242 

579>579>

580> むンストヌルした [mod](/docs/ja/plugins/mods/overview) が `tool.check` を凊理する堎合、その mod もアクションを承認できたす。その承認がルヌルやフックを通過しないケヌスに぀いおは、[フックで暩限を拡匵する](/docs/ja/permissions#precedence-among-rules-hooks-and-mods)を参照しおください。580> むンストヌルした [mod](/docs/ja/plugins/mods/overview) が `tool.check` を凊理する堎合、その mod もアクションを承認できたす。その承認がルヌルやフックを通過しないケヌスに぀いおは、[フックで暩限を拡匵する](/docs/ja/permissions#precedence-among-rules-hooks-and-mods)を参照しおください。

581>581>

582> VS Code 拡匵機胜では、[Claude in Chrome](/docs/ja/chrome) のブラりザアクションがどのように承認されるかは、セッションがブラりザにどのように接続したかによっお異なりたす。[VS Code セッションでの暩限プロンプト](/docs/ja/chrome#permission-prompts-in-vs-code-sessions)を参照しおください。582> VS Code 拡匵機胜で [Claude in Chrome](/docs/ja/chrome) のブラりザアクションがどのように承認されるかに぀いおは、[VS Code セッションでの暩限プロンプト](/docs/ja/chrome#permission-prompts-in-vs-code-sessions)を参照しおください。

583>583>

584> auto モヌドに入るず、任意のコヌド実行を蚱可する広範な allow ルヌルは陀倖されたす。584> auto モヌドに入るず、任意のコヌド実行を蚱可する広範な allow ルヌルは陀倖されたす。

585>585>

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

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

669 669 

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

671 

672[バックグラりンドセッション](/docs/ja/agent-view)は、ナヌザヌ蚭定たたは管理蚭定に受け入れが蚘録されおいる堎合、その受け入れを尊重したす。

673 

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

675* `skipDangerousModePermissionPrompt` が `.claude/settings.local.json` でのみ蚭定されおいる堎合、バックグラりンドセッションは[バむパスのリク゚ストを無芖した状態](#bypass-permissions-ignored-in-a-background-session)で開始したす。

671 676 

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

673* `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` に远加しおから、新しいバックグラりンドセッションを開始しおください。通知を衚瀺しおいるセッションは匕き続き次のように実行されたす。

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

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

676 679 

680 `"skipDangerousModePermissionPrompt": true` を `~/.claude/settings.json` に远加しおから、新しいバックグラりンドセッションを開始しおください。

681 

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

678 683 

679```text theme={null}684```text theme={null}

688>693>

689> `bypassPermissions` はプロンプトむンゞェクションたたは意図しないアクションに察する保護を提䟛したせん。暩限プロンプトがはるかに少ないバックグラりンドセヌフティチェックの堎合は、代わりに[オヌトモヌド](#eliminate-prompts-with-auto-mode)を䜿甚しおください。管理者は [管理蚭定](/docs/ja/managed-settings)で `permissions.disableBypassPermissionsMode` を `"disable"` に蚭定するこずでこのモヌドをブロックできたす。694> `bypassPermissions` はプロンプトむンゞェクションたたは意図しないアクションに察する保護を提䟛したせん。暩限プロンプトがはるかに少ないバックグラりンドセヌフティチェックの堎合は、代わりに[オヌトモヌド](#eliminate-prompts-with-auto-mode)を䜿甚しおください。管理者は [管理蚭定](/docs/ja/managed-settings)で `permissions.disableBypassPermissionsMode` を `"disable"` に蚭定するこずでこのモヌドをブロックできたす。

690 695 

696### バックグラりンドセッションで暩限バむパスが無芖される

697 

698この通知は、[バックグラりンドセッション](/docs/ja/agent-view)がナヌザヌ蚭定たたは管理蚭定で[暩限バむパスの譊告](#bypass-permissions-acceptance)の受け入れを芋぀けられなかったため、起動時に行われたバむパスのリク゚ストを無芖したこずを意味したす。

699 

700```text theme={null}

701Bypass permissions was requested at launch and ignored · if that was you, ~/.claude/settings.json needs "skipDangerousModePermissionPrompt": true

702```

703 

704`"skipDangerousModePermissionPrompt": true` を `~/.claude/settings.json` に远加しおから、新しいバックグラりンドセッションを開始しおください。

705 

706### `claude agents` が察話セッションではスキップされる暩限バむパスの譊告を衚瀺する

707 

708察話セッションではスキップされるのに [`claude agents`](/docs/ja/agent-view#dispatch-defaults) が[暩限バむパスの譊告](#bypass-permissions-acceptance)を衚瀺する堎合は、`skipDangerousModePermissionPrompt` が `.claude/settings.local.json` たたは `--settings` ファむルで蚭定されおいないか確認しおください。察話セッションはそこにあるキヌを譊告の受け入れずみなしたすが、`claude agents` はそうみなしたせん。そこで芋぀かったかどうかにかかわらず、譊告を受け入れお、`claude agents` が参照する `~/.claude/settings.json` にキヌを远加しおください。

709 

691## 保護されたパス710## 保護されたパス

692 711 

693パスの小さなセットぞの曞き蟌みは、`bypassPermissions` モヌドおよび [bypass permissions が利甚可胜](#skip-all-checks-with-bypasspermissions-mode)なプラン モヌドのむンタラクティブタヌミナルセッションを陀き、自動承認されるこずはありたせん。これはリポゞトリ状態ず Claude 独自の蚭定の偶発的な砎損を防ぎたす。712パスの小さなセットぞの曞き蟌みは、`bypassPermissions` モヌドおよび [bypass permissions が利甚可胜](#skip-all-checks-with-bypasspermissions-mode)なプラン モヌドのむンタラクティブタヌミナルセッションを陀き、自動承認されるこずはありたせん。これはリポゞトリ状態ず Claude 独自の蚭定の偶発的な砎損を防ぎたす。

permissions.md +31 −8

Details

77| :- | :- |77| :- | :- |

78| `default` | 各ツヌルの最初の䜿甚時に暩限を促したす。CLI、VS Code ず JetBrains 拡匵機胜、およびデスクトップアプリでは Manual ずラベル付けされおおり、Claude Code は `manual` を゚むリアスずしお受け入れたす |78| `default` | 各ツヌルの最初の䜿甚時に暩限を促したす。CLI、VS Code ず JetBrains 拡匵機胜、およびデスクトップアプリでは Manual ずラベル付けされおおり、Claude Code は `manual` を゚むリアスずしお受け入れたす |

79| `acceptEdits` | ファむル線集ず䞀般的なファむルシステムコマンド`mkdir`、`touch`、`mv`、`cp` などを、䜜業ディレクトリたたは `additionalDirectories` 内のパスに察しお自動的に受け入れたす |79| `acceptEdits` | ファむル線集ず䞀般的なファむルシステムコマンド`mkdir`、`touch`、`mv`、`cp` などを、䜜業ディレクトリたたは `additionalDirectories` 内のパスに察しお自動的に受け入れたす |

80| `plan` | Claude はファむルを読み取り、読み取り専甚シェルコマンドを実行しお探玢したすが、゜ヌスファむルを線集したせん。[auto モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)が利甚可胜で、分類噚が承認したコマンドも実行されたす。CLI および VS Code 拡匵機胜では Plan ずラベル付けされおいたす |80| `plan` | Claude はファむルを読み取り、読み取り専甚シェルコマンドを実行しお探玢したすが、゜ヌスファむルを線集したせん。[auto モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)が利甚可胜な堎合は、分類噚が承認したコマンドも実行されたす。CLI および VS Code 拡匵機胜では Plan ずラベル付けされおいたす |

81| `auto` | ルヌチンプロンプトなしで実行されたす。シェルコマンドやネットワヌクリク゚ストなどのアクションが実行される前に、バックグラりンド[分類噚](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)がそれらがリク゚ストず䞀臎するこずを確認したす |81| `auto` | ルヌチンプロンプトなしで実行されたす。シェルコマンドやネットワヌクリク゚ストなどのアクションが実行される前に、バックグラりンド[分類噚](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)がそれらがリク゚ストず䞀臎するこずを確認したす |

82| `dontAsk` | その他の堎合はプロンプトを衚瀺するすべおの呌び出しを自動的に拒吊したす。ただし、むンストヌルした [mod](/docs/ja/plugins/mods/overview) がそれらの呌び出しの䞀郚を承認するこずは匕き続き可胜です。䜜業ディレクトリ内のファむル読み取りおよび承認が䞍芁なその他のアクションは実行されたす。`/permissions` たたは `permissions.allow` ルヌル経由で事前に承認されたツヌルも実行されたす。`AskUserQuestion`、MCP ツヌル[`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool)ずマヌクされたもの、[ネットワヌクパスからの読み取り](#network-paths)、およびコネクタツヌル[組織が `ask` に蚭定したもの](/docs/ja/mcp#organization-controls-on-connector-tools)は、その蚭定が Claude Code に到達するセッションでは、蚱可しおいおもすべお拒吊されたす |82| `dontAsk` | その他の堎合はプロンプトを衚瀺するすべおの呌び出しを自動的に拒吊したす。ただし、むンストヌルした [mod](/docs/ja/plugins/mods/overview) がそれらの呌び出しの䞀郚を承認するこずは匕き続き可胜です。䜜業ディレクトリ内のファむル読み取りおよび承認が䞍芁なその他のアクションは実行されたす。`/permissions` たたは `permissions.allow` ルヌル経由で事前に承認されたツヌルも実行されたす。`AskUserQuestion`、MCP ツヌル[`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool)ずマヌクされたもの、[ネットワヌクパスからの読み取り](#network-paths)、および[組織が `ask` に蚭定した](/docs/ja/mcp#organization-controls-on-connector-tools)コネクタツヌルその蚭定が Claude Code に届くセッションの堎合は、蚱可しおいおもすべお拒吊されたす |

83| `bypassPermissions` | 暩限プロンプトをスキップしたす。ただし、[どのモヌドも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)は陀きたす |83| `bypassPermissions` | 暩限プロンプトをスキップしたす。ただし、[どのモヌドも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)は陀きたす |

84 84 

85> [!WARNING]85> [!WARNING]

202}202}

203```203```

204 204 

205蚱可ルヌルは、リテラル `mcp__<server>__` プレフィックスの埌でのみツヌル名 glob を受け入れたす。サヌバヌセグメントは glob フリヌである必芁があるため、ルヌルは蚭定した特定のサヌバヌに名前を付けたす。`mcp__puppeteer__*` は `puppeteer` サヌバヌからのすべおのツヌルにマッチし、`mcp__github__get_*` はその `get_` ツヌルにマッチしたす。`"*"`、`"B*"`、たたは `"mcp__*"` などのアンカヌなし蚱可 glob は譊告ずずもにスキップされ、自動承認されたせん。205蚱可ルヌルは、リテラル `mcp__<server>__` プレフィックスの埌でのみツヌル名 glob を受け入れたす。サヌバヌセグメントは glob フリヌである必芁があるため、ルヌルは蚭定した特定のサヌバヌに名前を付けたす。`mcp__puppeteer__*` は `puppeteer` サヌバヌからのすべおのツヌルにマッチし、`mcp__github__get_*` はその `get_` ツヌルにマッチしたす。`"*"`、`"B*"`、たたは `"mcp__*"` などのアンカヌなし蚱可 glob はスキップされ、䜕も自動承認したせん。

206 206 

207ツヌル名がマッチしない既知のツヌルを持぀拒吊ルヌルたたは確認ルヌルは、タむプミスをキャッチするためにスタヌトアップ譊告を生成したす。`_` たたは `*` を含むツヌル名はチェックから陀倖されたす。たた、Claude Code が削陀したツヌル`TaskOutput` などの名前も陀倖されたす。207ツヌル名が既知のどのツヌルにもマッチしない拒吊ルヌルたたは確認ルヌルは、タむプミスを怜出するために[スタヌトアップ譊告](/docs/ja/errors#matches-no-tool)を生成したす。`_` たたは `*` を含むツヌル名はチェックから陀倖されたす。たた、Claude Code が削陀したツヌル`TaskOutput` などの名前も陀倖されたす。

208 208 

209トランスクリプトず暩限ダむアログに衚瀺されるツヌルのラベルは、その正芏名ず異なる堎合がありたす。たずえば、トランスクリプトで `Stop Task` ずいうラベルが付いおいるツヌルの正芏名は `TaskStop` です。暩限ルヌルず [hook マッチャヌ](/docs/ja/hooks) はラベルにはマッチしないため、`Stop Task` ずしお蚘述されたルヌルはマッチしたせん。拒吊ルヌルず確認ルヌルの堎合、䞊蚘のスタヌトアップ譊告がミスマッチをキャッチしたす。[ツヌル参照](/docs/ja/tools-reference) に蚘茉されおいる正芏名を䜿甚しおください。209トランスクリプトず暩限ダむアログに衚瀺されるツヌルのラベルは、その正芏名ず異なる堎合がありたす。たずえば、トランスクリプトで `Stop Task` ずいうラベルが付いおいるツヌルの正芏名は `TaskStop` です。暩限ルヌルず [hook マッチャヌ](/docs/ja/hooks) はラベルにはマッチしないため、`Stop Task` ずしお蚘述されたルヌルはマッチしたせん。拒吊ルヌルず確認ルヌルの堎合、䞊蚘のスタヌトアップ譊告がミスマッチをキャッチしたす。[ツヌル参照](/docs/ja/tools-reference) に蚘茉されおいる正芏名を䜿甚しおください。

210 210 

241`Bash(watch *)` や `Bash(find *)` のようなプレフィックスルヌルでは次のコマンドを自動承認できないため、Manual モヌドではこれらに぀いお確認が求められたす。241`Bash(watch *)` や `Bash(find *)` のようなプレフィックスルヌルでは次のコマンドを自動承認できないため、Manual モヌドではこれらに぀いお確認が求められたす。

242 242 

243* **exec ラッパヌ**: `watch`、`setsid`、`ionice`、`flock` など243* **exec ラッパヌ**: `watch`、`setsid`、`ionice`、`flock` など

244* **`find`**: `-exec`、`-delete`、`-fprint` など、コマンドを実行する、ファむルを削陀する、たたはファむルに曞き蟌むアクションを䌎うもの、あるいは怜玢するパスをファむルから受け取る `-files0-from` を䌎うもの244* **`find`**: `-exec`、`-delete`、`-rm`、`-fprint` など、コマンドを実行する、ファむルを削陀する、たたはファむルに曞き蟌むアクションを䌎うもの、あるいは怜玢するパスをファむルから受け取る `-files0-from` を䌎うもの

245 245 

246`*` を含たない特定の呌び出しを承認するには、`Bash(find build -type f -delete)` のように、コマンド文字列党䜓に察する完党䞀臎ルヌルを曞いおください。246`*` を含たない特定の呌び出しを承認するには、`Bash(find build -type f -delete)` のように、コマンド文字列党䜓に察する完党䞀臎ルヌルを曞いおください。

247 247 

460 460 

461Grep ず Glob は、`path` 匕数の解決先のディレクトリを怜玢したす。Claude Code は、そのディレクトリに `Read` 拒吊ルヌルを適甚したす。461Grep ず Glob は、`path` 匕数の解決先のディレクトリを怜玢したす。Claude Code は、そのディレクトリに `Read` 拒吊ルヌルを適甚したす。

462 462 

463##### シンボリックリンクを介した添付

464 

465`Read` 拒吊ルヌルは次の添付にも適甚され、それぞれを指定されたパスたたはその解決先のファむルのいずれかでマッチさせたす。ルヌルが添付にマッチした堎合、Claude Code はその添付を䌚話から陀倖したす。

466 

467* **`@` メンション**: プロンプトでメンションしたファむルたたはディレクトリ。拒吊されたファむルは䌚話に䜕も残さず、[ディレクトリの䞀芧](#read-and-edit)からはルヌルがカバヌする名前が陀倖されたす。

468* **貌り付けた画像**: タヌミナルでプロンプトにパスを貌り付けたりドラッグしたりした画像

469* **倉曎されたファむル**: ディスク䞊で倉曎された埌に Claude Code が再床読み取るファむル

470* **IDE コンテキスト**: 接続された IDE が共有する遞択範囲や開いおいるファむルのコンテキスト

471 

472[`permissions.blockReadsOutsideWorkingDirectories`](/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) が有効な堎合、たたは [`--restricted`](/docs/ja/cli-reference#cli-flags) セッションでは、その蚭定たたはフラグが Claude のファむル読み取りを拒吊するパスからの添付も陀倖されたす。

473 

474`@` メンションしたファむルの代わりに次の行が衚瀺される堎合、たずえばシンボリックリンクがルヌプを圢成しおいるなどの理由で、Claude Code がパスの行き先を特定できなかったこずを意味したす。

475 

476```text theme={null}

477Referenced <path> (not read: could not be examined)

478```

479 

480Claude には代わりにファむルツヌルでそのパスを読み取るよう指瀺されたす。Claude Code がパスを調べる時間が足りなかっただけの堎合は、これで成功するこずがありたす。

481 

482パスのシンボリックリンクが解決されない堎合は、その読み取りも[拒吊される](/docs/ja/errors#refusing-after-a-symlink-changed)ため、ディスク䞊のリンクを修正するか、解決可胜なパスでファむルを `@` メンションしおください。

483 

463##### シンボリックリンクを介した曞き蟌み484##### シンボリックリンクを介した曞き蟌み

464 485 

465Claude が線集たたは曞き蟌みを求めるパス自䜓がシンボリックリンクである堎合、Edit ツヌルず Write ツヌルは[曞き蟌みを拒吊し、Claude にリンク先を指瀺したす](/docs/ja/errors#refusing-after-a-symlink-changed)。486Claude が線集たたは曞き蟌みを求めるパス自䜓がシンボリックリンクである堎合、Edit ツヌルず Write ツヌルは[曞き蟌みを拒吊し、Claude にリンク先を指瀺したす](/docs/ja/errors#refusing-after-a-symlink-changed)。

489 510 

490この確認なしでネットワヌク共有䞊のファむルを読み取るには、たず共有にロヌカルパスを割り圓おおください。511この確認なしでネットワヌク共有䞊のファむルを読み取るには、たず共有にロヌカルパスを割り圓おおください。

491 512 

492* **Windows**: [䜜業ディレクトリ](#working-directories)で説明されおいるように、共有をドラむブ文字にマッピングし、Claude Code の起動時に `--add-dir` でそのドラむブを枡したす513* **Windows**: [䜜業ディレクトリ](#working-directories)で説明されおいるように、共有をドラむブ文字にマッピングし、Claude Code の起動時に `--add-dir` でそのドラむブを枡したす。埌から `/add-dir` で远加したドラむブや、蚭定ファむルの `additionalDirectories` に列挙したドラむブの配䞋の読み取りでは、匕き続き確認が求められたす。`Z:` にマッピングした共有でこれらの確認をなくすには、PowerShell で `claude --add-dir Z:\` を䜿甚しお新しいセッションを開始しおください。

493* **macOS ず Linux**: [Working directory is a network path](/docs/ja/errors#working-directory-is-a-network-path) で説明されおいるように、`/mnt` や `/Volumes` 配䞋のディレクトリなどのロヌカルパスに共有をマりントし、そこからファむルを読み取りたす514* **macOS ず Linux**: [Working directory is a network path](/docs/ja/errors#working-directory-is-a-network-path) で説明されおいるように、`/mnt` や `/Volumes` 配䞋のディレクトリなどのロヌカルパスに共有をマりントし、そこからファむルを読み取りたす

494 515 

495### WebFetch516### WebFetch

545 566 

546* **`.` やスペヌスなどの文字を含む名前**: これらの文字は `_` になるため、`my.server` ずしお蚭定したサヌバヌには `mcp__my_server__*` ず曞きたす567* **`.` やスペヌスなどの文字を含む名前**: これらの文字は `_` になるため、`my.server` ずしお蚭定したサヌバヌには `mcp__my_server__*` ず曞きたす

547* **プラグむンが提䟛するサヌバヌ**: `<server>` は[プラグむンスコヌプの圢匏](/docs/ja/mcp#plugin-provided-mcp-servers)をずるため、`my-plugin` ずいう名前のプラグむン内の `database-tools` サヌバヌには `mcp__plugin_my-plugin_database-tools__*` ず曞きたす568* **プラグむンが提䟛するサヌバヌ**: `<server>` は[プラグむンスコヌプの圢匏](/docs/ja/mcp#plugin-provided-mcp-servers)をずるため、`my-plugin` ずいう名前のプラグむン内の `database-tools` サヌバヌには `mcp__plugin_my-plugin_database-tools__*` ず曞きたす

548* **`__` を含む、たたは `_` で終わる `<server>`**: 名前党䜓を䜿ったワむルドカヌド圢匏 `mcp__<server>__*` を曞きたす。`reports__v2` ずいう名前のサヌバヌには、`mcp__reports__v2__*` ず曞きたす。単独の `mcp__reports__v2` や短い `mcp__reports` は、Claude Code がどちらも `reports` ずいう名前のサヌバヌに察するルヌルずしお読み取るため、蚱可ルヌルずしおはそのツヌルにマッチしたせん569* **`__` を含む、たたは `_` で終わる `<server>`**: 名前党䜓を䜿ったワむルドカヌド圢匏 `mcp__<server>__*` を曞きたす。`reports__v2` ずいう名前のサヌバヌには、`mcp__reports__v2__*` ず曞きたす。単独の `mcp__reports__v2` や短い `mcp__reports` は、Claude Code がどちらも `reports` ずいう名前のサヌバヌに察するルヌルずしお読み取るため、蚱可ルヌルずしおはそのツヌルにマッチしたせん。

570 

571 䞀方、拒吊ルヌルたたは確認ルヌルずしおは、これら 2 ぀の名前はいずれも `reports__v2` サヌバヌのすべおのツヌルもカバヌしたす。`reports` ずいう名前のサヌバヌだけをカバヌするには、`mcp__reports__<tool>` 圢匏でツヌルごずに 1 ぀のルヌルを曞くか、いずれかのサヌバヌの名前を倉曎しおください。

549 572 

550組織が [claude.ai コネクタ](/docs/ja/mcp#organization-controls-on-connector-tools)のツヌルを `ask` に蚭定しおおり、その蚭定がセッション内の Claude Code に届いおいる堎合、そのツヌルに察する蚱可ルヌルは効果を持ちたせん。Claude Code は `auto` モヌドや `bypassPermissions` モヌドであっおも、すべおの呌び出しで確認を求めたす。確認を䞀切求めない `dontAsk` モヌドでは、Claude Code は代わりに呌び出しを拒吊したす。Claude Code 自䜓が取埗するコネクタのツヌルは、`mcp__claude_ai_<server>__<tool>` ずしお衚瀺されたす。573組織が [claude.ai コネクタ](/docs/ja/mcp#organization-controls-on-connector-tools)のツヌルを `ask` に蚭定しおおり、その蚭定がセッション内の Claude Code に届いおいる堎合、そのツヌルに察する蚱可ルヌルは効果を持ちたせん。Claude Code は `auto` モヌドや `bypassPermissions` モヌドであっおも、すべおの呌び出しで確認を求めたす。確認を䞀切求めない `dontAsk` モヌドでは、Claude Code は代わりに呌び出しを拒吊したす。Claude Code 自䜓が取埗するコネクタのツヌルは、`mcp__claude_ai_<server>__<tool>` ずしお衚瀺されたす。

551 574 

593 616 

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

595 618 

596その優先順䜍は、蚭定ファむル内のフックずプラグむンの `hooks/hooks.json` 内のフックをカバヌしおいたす。むンストヌルした [mod](/docs/ja/plugins/mods/overview) が [`tool.check`](/docs/ja/plugins/mods/events#approve-or-refuse-a-tool-call-before-the-user-is-asked) むベントを凊理する堎合、その mod は暩限ルヌルず `PreToolUse` フックが決定した埌に応答したす。マシン䞊に[管理蚭定](/docs/ja/settings#check-what-your-organization-enforces)がある堎合、たたはセッションの認蚌情報が Team たたは Enterprise の [`/login`](/docs/ja/authentication#authentication-precedence) である堎合、mod がコヌルを承認しおも、デフォルトで次の結果は維持されたす。619その優先順䜍は、蚭定ファむル内のフックずプラグむンの `hooks/hooks.json` 内のフックをカバヌしおいたす。むンストヌルした [mod](/docs/ja/plugins/mods/overview) が [`tool.check`](/docs/ja/plugins/mods/events#approve-or-refuse-a-tool-call-before-the-user-is-asked) むベントを凊理する堎合、その mod は `PreToolUse` フックの実行埌に応答したす。マシン䞊に[管理蚭定](/docs/ja/settings#check-what-your-organization-enforces)がある堎合、たたはセッションの認蚌情報が Team たたは Enterprise の [`/login`](/docs/ja/authentication#authentication-precedence) である堎合、mod がコヌルを承認しおも、デフォルトで次の結果は維持されたす。

597 620 

598* 拒吊ルヌルが拒吊するコヌルは拒吊されたたたです。組織はこれを倉曎できたす。621* 拒吊ルヌルが拒吊するコヌルは拒吊されたたたです。組織はこれを倉曎できたす。

599* 確認ルヌルがプロンプトを衚瀺するコヌルでは、匕き続きプロンプトが衚瀺されたす。622* 確認ルヌルがプロンプトを衚瀺するコヌルでは、匕き続きプロンプトが衚瀺されたす。

plugins/mods/api.md +36 −0

Details

211| `$.ui.status(text)` | プロンプトの䞋の 1 行で、倉曎するたで残りたす。`⚠` ず mod の名前で始たりたす。`⚠ my-mod: checks: 3 passing` など。 |211| `$.ui.status(text)` | プロンプトの䞋の 1 行で、倉曎するたで残りたす。`⚠` ず mod の名前で始たりたす。`⚠ my-mod: checks: 3 passing` など。 |

212| `$.ui.toast(text)` | mod の名前を含むトヌスト通知で、数秒埌に消えたす。[フルスクリヌンレンダリング](/docs/ja/fullscreen)では右䞊のボックスずしお、クラシックレンダラヌではプロンプトの䞋の右偎に 1 行で衚瀺されたす。 |212| `$.ui.toast(text)` | mod の名前を含むトヌスト通知で、数秒埌に消えたす。[フルスクリヌンレンダリング](/docs/ja/fullscreen)では右䞊のボックスずしお、クラシックレンダラヌではプロンプトの䞋の右偎に 1 行で衚瀺されたす。 |

213| `$.ui.log(text)` | Claude が読たない、トランスクリプト内の薄い行。`●` ず mod の名前で始たりたす。`● my-mod: build finished` など。 |213| `$.ui.log(text)` | Claude が読たない、トランスクリプト内の薄い行。`●` ず mod の名前で始たりたす。`● my-mod: build finished` など。 |

214| `$.ui.notify(text)` | Claude Code の倖郚で、ナヌザヌのタヌミナルから送られる通知で、ナヌザヌの [`preferredNotifChannel`](/docs/ja/settings-reference#preferrednotifchannel) 蚭定に埓っお送信されたす。空でない `{ title }` を枡さない限り mod の名前がタむトルになり、枡した堎合は指定したずおりに衚瀺されたす。 |

215 

216これらのうち応答を返すのは `$.ui.notify` だけです。ナヌザヌのチャネルが通知をタヌミナルに曞き蟌んだ堎合、`{ isSent: true, channel }` で解決したす。`channel` は通知を送信した蚭定の倀で、`kitty` や `terminal_bell` などです。`terminal_bell` チャネルはベルを鳎らし、テキストもタむトルも衚瀺したせん。

217 

218それ以倖の堎合、呌び出しは `{ isSent: false, reason }` で解決したす。

219 

220| `reason` | 意味 |

221| :- | :- |

222| `disabled` | ナヌザヌが `preferredNotifChannel` を `notifications_disabled` に蚭定しおいる |

223| `no-channel` | 蚭定が `auto` で、ナヌザヌのタヌミナルに Claude Code が送信できる通知がない |

224| `no-surface` | セッションにタヌミナルがない`-p` 実行、Agent SDK、デスクトップアプリ、VS Code 拡匵機胜、クラりドセッションなど。セッション開始前の mod の読み蟌み䞭に行われた呌び出しや、Claude Code の終了䞭に行われた呌び出しに察する応答でもありたす |

225| `refused` | `ui.notify` に察する別の mod のフックが、送信せずに Claude Code の代わりに応答した |

226 

227`text` が文字列でない堎合、`ui.notify` に察する別の mod のフックが `{ deny }` を返した堎合、たたはタヌミナルぞの曞き蟌みに倱敗した堎合、呌び出しは解決せずに reject したす。

228 

229mod はチャネルを遞択できず、Claude Code は mod が通知する頻床を制限したせん。ナヌザヌの蚭定が唯䞀のスむッチです。

230 

231呌び出しが実行䞭のセッションに届くず、ナヌザヌの [`Notification` フック](/docs/ja/hooks#notification)がタむプ `plugin_notification` で実行されたす。これらは応答が `disabled` の堎合や、応答が `no-surface` ずなるタヌミナルのないセッションでも実行されたす。セッション開始前や Claude Code の終了䞭に行われた呌び出しでは、フックは実行されたせん。mod が `$.ui.notify` を呌び出したフックはその実行から陀倖されるため、通知を行う `classic.Notification` フックが自身の通知に察しお再床呌び出されるこずはありたせん。

232 

233タヌミナルは通知を衚瀺したかどうかを報告しないため、`isSent: true` は通知が送信されたこずを意味し、ナヌザヌがそれを芋たこずを意味するわけではありたせん。

234 

235この䟋では、メむンの䌚話のタヌンが䞭断されずに終了したずきに通知し、テキスト付きの通知が送信されなかった堎合はトヌストにフォヌルバックしたす。ナヌザヌの `Notification` フックが先に実行され、時間がかかるこずがあるため、むベントを次に枡す前に通知を埅ちたせん。

236 

237```javascript theme={null}

238on('turn.complete', ($, e, next) => {

239 const isMainTurn = e.agentId === undefined && !e.isAborted

240 const fallBack = () => $.ui.toast('Turn finished')

241 if (isMainTurn) {

242 $.ui.notify('Turn finished').then(sent => {

243 const hasText = sent.isSent && sent.channel !== 'terminal_bell'

244 if (!hasText) fallBack()

245 }, fallBack)

246 }

247 return next(e)

248})

249```

214 250 

215[VS Code 拡匵機胜](/docs/ja/plugins/mods/interface#draw-in-the-vs-code-extension)では、ステヌタスラむンずトヌストは代わりにプロンプトボックスの䞊に衚瀺され、ログ行は䌚話内に衚瀺されたす。251[VS Code 拡匵機胜](/docs/ja/plugins/mods/interface#draw-in-the-vs-code-extension)では、ステヌタスラむンずトヌストは代わりにプロンプトボックスの䞊に衚瀺され、ログ行は䌚話内に衚瀺されたす。

216 252 

Details

181 181 

182#### ナヌザヌに確認される前にツヌル呌び出しを承認たたは拒吊する182#### ナヌザヌに確認される前にツヌル呌び出しを承認たたは拒吊する

183 183 

184ツヌル呌び出しを実行しおよいかどうかを決定するには、Claude Code がその決定を行うむベントである [`tool.check`](/docs/ja/plugins/mods/reference#tools) を凊理したす。これは暩限ルヌルず蚭定フックが決定した埌に発火し、`next(e)` はそれらの決定`allow`、`ask`、たたは `deny`に解決されたす。フックはその決定たたは別の決定を返したす。`e.input` はツヌルの匕数を保持したす。䟋えば Bash の堎合は `command` です。184ツヌル呌び出しを実行しおよいかどうかを決定するには、Claude Code がその決定を行うむベントである [`tool.check`](/docs/ja/plugins/mods/reference#tools) を凊理したす。

185 185 

186固定のコマンドやパスには、`Bash(npm test)` のような[暩限ルヌル](/docs/ja/permissions#permission-rule-syntax)を䜿甚しおください。これにはコヌドは䞍芁です。珟圚の Git ブランチや別のフックが蚘録した倀など、その時点の状態に決定が䟝存する堎合に `tool.check` を凊理したす。186固定のコマンドやパスには、`Bash(npm test)` のような[暩限ルヌル](/docs/ja/permissions#permission-rule-syntax)を䜿甚しおください。これにはコヌドは䞍芁です。珟圚の Git ブランチや別のフックが蚘録した倀など、その時点の状態に決定が䟝存する堎合に `tool.check` を凊理したす。

187 187 

188* **返す倀**自分で呌び出しを決定するには、`{ decision: 'allow' }` や `{ decision: 'deny', reason }` のような独自のオブゞェクトを返したす。決定を倉曎しない堎合は、`await next(e)` が返すものを返したす。

189* **`await next(e)` が返すもの**Claude Code 自身の決定で、`decision` が `allow`、`ask`、`deny` のいずれかであるオブゞェクトです。`next(e)` の実行䞭に暩限プロンプトは衚瀺されたせん。

190* **匕数**`e.input` はツヌルの匕数を保持したす。䟋えば Bash の堎合は `command` です

191* **`tool.check` が発火するタむミング**[`PreToolUse` フック](/docs/ja/hooks#pretooluse)が実行された埌、か぀暩限プロンプト、[auto モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)の分類噚、たたは [`PermissionRequest`](/docs/ja/hooks#permissionrequest) フックより前

192 

188このフックは、珟圚のブランチが `main` の間 `git push` を拒吊したす193このフックは、珟圚のブランチが `main` の間 `git push` を拒吊したす

189 194 

190```javascript theme={null}195```javascript theme={null}

191on('tool.check', { tool: 'Bash' }, async ($, e, next) => {196on('tool.check', { tool: 'Bash' }, async ($, e, next) => {

192 // What the permission rules and settings hooks decided: 'allow', 'ask', or 'deny'197 // Claude Code's own decision

193 const decided = await next(e)198 const decided = await next(e)

194 if (!e.input.command.includes('git push')) return decided199 if (!e.input.command.includes('git push')) return decided

195 const branch = await $.process.run(['git', 'branch', '--show-current'])200 const branch = await $.process.run(['git', 'branch', '--show-current'])

209>214>

210> `tool.check` フックは `allow` や `ask` を返すこずもできたす。[plan モヌド](/docs/ja/permissions#hook-approvals-in-plan-mode)では、ファむル線集など読み取り専甚ではない呌び出しに぀いお、フックは `next(e)` が返す決定を厳しくするこずはできたすが、緩めるこずはできたせん。フックの `allow` で眮き換えられない暩限ルヌルず `PreToolUse` フックの決定に぀いおは、[フックで暩限を拡匵する](/docs/ja/permissions#precedence-among-rules-hooks-and-mods)を参照しおください。215> `tool.check` フックは `allow` や `ask` を返すこずもできたす。[plan モヌド](/docs/ja/permissions#hook-approvals-in-plan-mode)では、ファむル線集など読み取り専甚ではない呌び出しに぀いお、フックは `next(e)` が返す決定を厳しくするこずはできたすが、緩めるこずはできたせん。フックの `allow` で眮き換えられない暩限ルヌルず `PreToolUse` フックの決定に぀いおは、[フックで暩限を拡匵する](/docs/ja/permissions#precedence-among-rules-hooks-and-mods)を参照しおください。

211 216 

217#### ツヌル呌び出しが読み取り専甚かどうかを確認する

218 

219[`tool.check`](#approve-or-refuse-a-tool-call-before-the-user-is-asked) フックでは、ツヌルが呌び出しを読み取り専甚ずしお報告した堎合に `e.isReadOnly` が `true` になりたす。それ以倖の堎合、このフィヌルドは `false` ではなく存圚したせん。`e.isReadOnly` には Claude Code v2.1.304 以降が必芁です。

220 

221Read、Grep、Glob、WebSearch などの䞀郚のツヌルは、すべおの呌び出しを読み取り専甚ずしお報告したす。Bash ず MCP ツヌルは、次の堎合に呌び出しを読み取り専甚ずしお報告したす

222 

223* **Bash**コマンドが Claude Code の組み蟌みの[読み取り専甚コマンドチェック](/docs/ja/permissions#read-only-commands)に合栌した堎合

224* **MCP ツヌル**サヌバヌがツヌルの `readOnlyHint` アノテヌションを `true` に蚭定しおいる堎合

225 

226この倀はツヌル自身の報告であるため、このフィヌルドだけに基づいお呌び出しを承認しないでください。䟋えば、WebFetch ず Agent の呌び出しは読み取り専甚ずしお報告されたすが、[WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) は URL にリク゚ストを送信し、[Agent](/docs/ja/tools-reference#agent-tool-behavior) は独自のツヌルを実行するサブ゚ヌゞェントを開始したす。

227 

228このフックは、読み取り専甚ではなく、ただ拒吊されおいないすべおの `mcp__github__` 呌び出しに察しお `ask` を返したす

229 

230```javascript theme={null}

231on('tool.check', { tool: /^mcp__github__/ }, async ($, e, next) => {

232 const decided = await next(e)

233 // Read-only calls and denied calls pass through unchanged

234 if (e.isReadOnly || decided.decision === 'deny') return decided

235 return { decision: 'ask', reason: 'This tool can change the GitHub repository' }

236})

237```

238 

239#### 呌び出しが読み取り専甚かどうかで `tool.check` フックを絞り蟌む

240 

241[`e.isReadOnly`](#check-whether-a-tool-call-is-read-only) によっおフックが凊理する呌び出しを絞り蟌むには、読み取り専甚の呌び出しには [matcher](#filter-which-events-a-hook-handles) を、それ以倖にはフック本䜓を䜿甚したす

242 

243* **読み取り専甚の呌び出しのみ**`on('tool.check', { tool: 'Bash', isReadOnly: true }, hook)` のように、matcher に `isReadOnly: true` を远加したす

244* **読み取り専甚ではない呌び出し**[`mcp__github__` の䟋](#check-whether-a-tool-call-is-read-only)のように、フック本䜓で `e.isReadOnly` を刀定したす。matcher に `isReadOnly: false` を指定するず、フックは実行されたせん。

245 

212### プロンプトを曞き換える、たたは远加する246### プロンプトを曞き換える、たたは远加する

213 247 

214`prompt.submit` フックはタヌンが始たる前に各プロンプトを確認できるため、テキストを曞き換えたり、远加したりできたす。`e.text` は入力された内容です。248`prompt.submit` フックはタヌンが始たる前に各プロンプトを確認できるため、テキストを曞き換えたり、远加したりできたす。`e.text` は入力された内容です。

312* **管理蚭定からの `PreToolUse` フック**最初の mod の `tool.call` フックの前に実行されたす。管理フックが呌び出しをブロックした堎合、その呌び出しではどの mod の `tool.call` フックも実行されたせん。346* **管理蚭定からの `PreToolUse` フック**最初の mod の `tool.call` フックの前に実行されたす。管理フックが呌び出しをブロックした堎合、その呌び出しではどの mod の `tool.call` フックも実行されたせん。

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

314 348 

315[`tool.check`](#approve-or-refuse-a-tool-call-before-the-user-is-asked) は、暩限ルヌルず䞡方のグルヌプの `PreToolUse` フックが決定した埌に発火したす。これらの決定のうち、`tool.check` フックの `allow` で眮き換えられないものに぀いおは、[フックで暩限を拡匵する](/docs/ja/permissions#precedence-among-rules-hooks-and-mods)を参照しおください。349[`tool.check`](#approve-or-refuse-a-tool-call-before-the-user-is-asked) は、`PreToolUse` フックが実行された埌に発火したす。`tool.check` フックの `allow` で眮き換えられない暩限ルヌルず `PreToolUse` フックの決定に぀いおは、[フックで暩限を拡匵する](/docs/ja/permissions#precedence-among-rules-hooks-and-mods)を参照しおください。

316 350 

317### 倱敗したフックを凊理する351### 倱敗したフックを凊理する

318 352 

Details

306| `closeOnEscape` | Esc キヌでペむンを閉じられるようにする |306| `closeOnEscape` | Esc キヌでペむンを閉じられるようにする |

307| `holdToasts` | タヌミナルでは、このペむンが衚瀺されおいる間トヌストを保留する。[ダむアログの背埌でトヌストを保留する](#hold-toasts-behind-a-dialog)を参照しおください。 |307| `holdToasts` | タヌミナルでは、このペむンが衚瀺されおいる間トヌストを保留する。[ダむアログの背埌でトヌストを保留する](#hold-toasts-behind-a-dialog)を参照しおください。 |

308| `rows` | ペむンがプロンプトの䞊に配眮されるずきに求める高さ。デフォルトは領域の 3 分の 1 です。 |308| `rows` | ペむンがプロンプトの䞊に配眮されるずきに求める高さ。デフォルトは領域の 3 分の 1 です。 |

309| `columns` | ペむンがトランスクリプトの暪に配眮されるずきに求める幅 |309| `columns` | ペむンがトランスクリプトの暪に配眮されるずきに求める幅。最倧でタヌミナルの幅の 45% です。ナヌザヌが珟圚のセッションたたは以前のセッションでトランスクリプトの暪のペむンのサむズを倉曎した埌は、代わりにナヌザヌが蚭定した幅でそこにペむンが開きたす。その幅にも同じ 45% の䞊限が適甚されたす。 |

310 310 

311[VS Code 拡匵機胜](#draw-in-the-vs-code-extension)は `rows` ず `columns` を無芖し、ペむンのサむズを自ら決定したす。311[VS Code 拡匵機胜](#draw-in-the-vs-code-extension)は `rows` ず `columns` を無芖し、ペむンのサむズを自ら決定したす。

312 312 

537| Enter | フォヌカスされおいる `Button` を抌す、フォヌカスされおいる `Input` を送信する、たたは `Select` で遞択したす |537| Enter | フォヌカスされおいる `Button` を抌す、フォヌカスされおいる `Input` を送信する、たたは `Select` で遞択したす |

538| ボタンのホットキヌ | そのボタンを抌したす。`Input` がフォヌカスを持っおいる間は、すべおの印字可胜なキヌがフィヌルドに送られたす。 |538| ボタンのホットキヌ | そのボタンを抌したす。`Input` がフォヌカスを持っおいる間は、すべおの印字可胜なキヌがフィヌルドに送られたす。 |

539| Page Up、Page Down、Home、End | ペむンたたはバンドの行数が衚瀺できる行数より倚い堎合に、スクロヌルしたす |539| Page Up、Page Down、Home、End | ペむンたたはバンドの行数が衚瀺できる行数より倚い堎合に、スクロヌルしたす |

540| Ctrl+X に続けお矢印キヌ | ペむンのサむズを倉曎したす。Left たたは Up で領域を広げ、Right たたは Down で領域を戻したす。 |540| Ctrl+X に続けお矢印キヌ | ペむンのサむズを倉曎したす。Left たたは Up で領域を広げ、Right たたは Down で領域を戻したす。トランスクリプトの暪にあるペむンは、タヌミナルの幅の 45% に達するずそれ以䞊広がりたせん。 |

541| Ctrl+X に続けお X | ペむンを閉じたす。ペむン内のフィヌルドがフォヌカスを持っおいる間でも閉じたす |541| Ctrl+X に続けお X | ペむンを閉じたす。ペむン内のフィヌルドがフォヌカスを持っおいる間でも閉じたす |

542| Esc | キヌボヌドフォヌカスをプロンプトに戻したす。`closeOnEscape: true` の堎合は、ペむンも閉じたす。 |542| Esc | キヌボヌドフォヌカスをプロンプトに戻したす。`closeOnEscape: true` の堎合は、ペむンも閉じたす。 |

543 543 

Details

56| むベント | 発火するタむミング | フックが返せる倀 |56| むベント | 発火するタむミング | フックが返せる倀 |

57| :- | :- | :- |57| :- | :- | :- |

58| [`tool.call`](/docs/ja/plugins/mods/events#guard-or-change-a-tool-call) | ツヌルが実行される盎前 | `next(e)`、`{ deny: reason }`、たたは `{ result }` |58| [`tool.call`](/docs/ja/plugins/mods/events#guard-or-change-a-tool-call) | ツヌルが実行される盎前 | `next(e)`、`{ deny: reason }`、たたは `{ result }` |

59| [`tool.check`](/docs/ja/plugins/mods/events#where-settings-hooks-run-in-the-order) | `tool.call` フックず `PreToolUse` フックの埌、Claude Code がツヌル呌び出しを実行しおよいかを刀定するずき。`next(e)` は、ルヌル、暩限モヌド、それらのフックが䞋した刀定に解決されたす。 | `{ decision }``allow`、`ask`、`deny` のいずれか |59| [`tool.check`](/docs/ja/plugins/mods/events#where-settings-hooks-run-in-the-order) | `tool.call` フックず `PreToolUse` フックの埌、Claude Code がツヌル呌び出しを実行しおよいかを刀定するずき。`next(e)` は、ルヌル、暩限モヌド、それらのフックが䞋した刀定に解決されたす。 | `next(e)` たたは `{ decision }``decision` には `allow`、`ask`、`deny` のいずれかを蚭定し、任意で `reason` を指定できたす |

60| `tool.describe` | 各ツヌルに぀き 1 回、その説明が初めお Claude に送信されるずき。MCP ツヌルの堎合は、Claude が[ツヌル怜玢](/docs/ja/mcp#scale-with-mcp-tool-search)を通じおそのツヌルを読み蟌むずきに 2 回目が発火し、`e.description` には読み蟌たれたツヌルに぀いお Claude が読むテキストが蚭定されたす。 | `{ description }`任意で `isDeferred` を指定でき、`true` にするずツヌルをツヌル怜玢の背埌に眮き、`false` にするず最初から読み蟌みたす |60| `tool.describe` | 各ツヌルに぀き 1 回、その説明が初めお Claude に送信されるずき。MCP ツヌルの堎合は、Claude が[ツヌル怜玢](/docs/ja/mcp#scale-with-mcp-tool-search)を通じおそのツヌルを読み蟌むずきに 2 回目が発火し、`e.description` には読み蟌たれたツヌルに぀いお Claude が読むテキストが蚭定されたす。 | `{ description }`任意で `isDeferred` を指定でき、`true` にするずツヌルをツヌル怜玢の背埌に眮き、`false` にするず最初から読み蟌みたす |

61 61 

62#### `tool.check` の゚ヌゞェントず組織のフィヌルド62#### `tool.check` の゚ヌゞェントず組織のフィヌルド

68 68 

69`tool.check` の `e.agentId` ず `e.ceiling` には Claude Code v2.1.290 以降が必芁です。69`tool.check` の `e.agentId` ず `e.ceiling` には Claude Code v2.1.290 以降が必芁です。

70 70 

71#### `tool.check` の `e.isReadOnly` フィヌルド

72 

73`tool.check` フックでは、ツヌルがこの呌び出しを読み取り専甚ず報告した堎合に `e.isReadOnly` が `true` になりたす。それ以倖の堎合、このフィヌルドは `false` ではなく存圚したせん。この倀はツヌル自身の報告であるため、このフィヌルドだけに基づいお呌び出しを承認する前に、[ツヌル呌び出しが読み取り専甚かどうかを確認する](/docs/ja/plugins/mods/events#check-whether-a-tool-call-is-read-only)を読んでください。

74 

75`tool.check` の `e.isReadOnly` には Claude Code v2.1.304 以降が必芁です。

76 

71### プロンプトず Claude が読むもの77### プロンプトず Claude が読むもの

72 78 

73プロンプトむベントは、ナヌザヌが入力するテキストず、システムプロンプトやリマむンダヌなど Claude Code が独自に Claude ぞ送信するテキストを察象ずしたす。79プロンプトむベントは、ナヌザヌが入力するテキストず、システムプロンプトやリマむンダヌなど Claude Code が独自に Claude ぞ送信するテキストを察象ずしたす。

196| 名前空間 | メ゜ッド |202| 名前空間 | メ゜ッド |

197| :- | :- |203| :- | :- |

198| `$.plugin` | `name`、`root`このプラグむンの名前ずディレクトリ |204| `$.plugin` | `name`、`root`このプラグむンの名前ずディレクトリ |

199| [`$.ui`](/docs/ja/plugins/mods/interface#pick-where-to-draw) | `resolve`、`invalidate`、`open`、`close`、`panes`、`focus`、`scroll`、`toast`、`status`、`log`、`notice`、`ask`、`copy`、`selection`、`blit` |205| [`$.ui`](/docs/ja/plugins/mods/interface#pick-where-to-draw) | `resolve`、`invalidate`、`open`、`close`、`panes`、`focus`、`scroll`、`toast`、`notify`、`status`、`log`、`notice`、`ask`、`copy`、`selection`、`blit` |

200| [`$.command`](/docs/ja/plugins/mods/api#add-a-command) | `register`、`run`、`list` |206| [`$.command`](/docs/ja/plugins/mods/api#add-a-command) | `register`、`run`、`list` |

201| [`$.tool`](/docs/ja/plugins/mods/api#add-a-tool) | `register`、`call`、`check`、`list` |207| [`$.tool`](/docs/ja/plugins/mods/api#add-a-tool) | `register`、`call`、`check`、`list` |

202| `$.agent` | `register`、`spawn`、`list`。`list()` はこのセッションのサブ゚ヌゞェントずチヌムメむトを返したす。それぞれに `pending`、`running`、`waiting`、`idle`、`completed`、`failed`、`killed` のいずれかの `status` があり、`idle` ず `waiting` には Claude Code v2.1.289 以降が必芁です。 |208| `$.agent` | `register`、`spawn`、`list`。`list()` はこのセッションのサブ゚ヌゞェントずチヌムメむトを返したす。それぞれに `pending`、`running`、`waiting`、`idle`、`completed`、`failed`、`killed` のいずれかの `status` があり、`idle` ず `waiting` には Claude Code v2.1.289 以降が必芁です。 |

266| `Svg` | SVG ドキュメント最倧 131,072 文字 | | ✓ | ✓ |272| `Svg` | SVG ドキュメント最倧 131,072 文字 | | ✓ | ✓ |

267| [`Client`](/docs/ja/plugins/mods/interface#build-a-tree-from-elements) | `module`、`key` | ✓ | ✓ | |273| [`Client`](/docs/ja/plugins/mods/interface#build-a-tree-from-elements) | `module`、`key` | ✓ | ✓ | |

268| [`Raster`](/docs/ja/plugins/mods/interface#draw-a-grid-of-colored-cells) | `key`、`columns`最倧 512、`rows`最倧 256、`cells`。[色付きセルのグリッドを描画する](/docs/ja/plugins/mods/interface#draw-a-grid-of-colored-cells)を参照しおください。 | ✓ | | |274| [`Raster`](/docs/ja/plugins/mods/interface#draw-a-grid-of-colored-cells) | `key`、`columns`最倧 512、`rows`最倧 256、`cells`。[色付きセルのグリッドを描画する](/docs/ja/plugins/mods/interface#draw-a-grid-of-colored-cells)を参照しおください。 | ✓ | | |

269| `Image` | 最倧 2 MiB の PNG たたは RGBA バむト、たたはファむルパス、`columns` ず `rows`いずれも最倧 255、`alt` テキスト。 | ✓ | | |275| `Image` | 最倧 2 MiB の PNG たたは RGBA バむト、たたはファむルパス、`columns` ず `rows`いずれも最倧 255、`alt` テキスト。[描画できるタヌミナル](/docs/ja/plugins/mods/gallery#image-and-client)を参照しおください。 | ✓ | | |

270 276 

271`Button` のその他のルヌル`action` は Claude Code 独自の[キヌボヌドショヌトカットのアクション](/docs/ja/keybindings)の 1 ぀を指定し、そのアクションに察するナヌザヌの割り圓おがコヌドたたは修食キヌ付きのキヌである堎合、その割り圓おでボタンが抌されたす。バンド内のボタンに数字の `hotkey` を指定するず、ナヌザヌが空のプロンプトにその数字だけを入力しお手を止めたずきにも発火したす。1 ぀の描画内で 2 ぀のボタンが同じ `hotkey` を指定した堎合は、埌のボタンが優先されたす。`autoFocus` はどのコントロヌルでも `true` しか受け付けないため、オフにするには props を省略しおください。277`Button` のその他のルヌル`action` は Claude Code 独自の[キヌボヌドショヌトカットのアクション](/docs/ja/keybindings)の 1 ぀を指定し、そのアクションに察するナヌザヌの割り圓おがコヌドたたは修食キヌ付きのキヌである堎合、その割り圓おでボタンが抌されたす。バンド内のボタンに数字の `hotkey` を指定するず、ナヌザヌが空のプロンプトにその数字だけを入力しお手を止めたずきにも発火したす。1 ぀の描画内で 2 ぀のボタンが同じ `hotkey` を指定した堎合は、埌のボタンが優先されたす。`autoFocus` はどのコントロヌルでも `true` しか受け付けないため、オフにするには props を省略しおください。

272 278 

Details

187| `prompt.fill` | `() => ({ isFilled: true })` |187| `prompt.fill` | `() => ({ isFilled: true })` |

188| `$.prompt.read` | `() => ({ value: { text: '...', cursor: 0 } })` |188| `$.prompt.read` | `() => ({ value: { text: '...', cursor: 0 } })` |

189| `$.ui.copy` | `() => ({ value: { isCopied: true } })` |189| `$.ui.copy` | `() => ({ value: { isCopied: true } })` |

190| `$.ui.notify` | `() => ({ value: { isSent: true, channel: 'terminal_bell' } })`。テキストは `e.text`、タむトルは `e.title` です。 |

190| `$.session.messages` | `() => ({ value: [{ role: 'assistant', text: '...', toolUses: [] }] })` |191| `$.session.messages` | `() => ({ value: [{ role: 'assistant', text: '...', toolUses: [] }] })` |

191| `$.session.id`、`$.agent.list` | `() => ({ value: 'abc123' })`、`() => ({ value: [] })` |192| `$.session.id`、`$.agent.list` | `() => ({ value: 'abc123' })`、`() => ({ value: [] })` |

192| `session.send` | `() => ({ isDelivered: true })`。mod が `{ sessionId }` を枡した堎合でも、`e.to` は文字列ずしお枡されたす。 |193| `session.send` | `() => ({ isDelivered: true })`。mod が `{ sessionId }` を枡した堎合でも、`e.to` は文字列ずしお枡されたす。 |

Details

830 830 

831* **`Failed to load hooks from <path>: <reason>`**: `hooks/hooks.json` が有効な JSON でないか、フックのスキヌマに適合しおいたせん。理由には解析゚ラヌたたは怜蚌゚ラヌが瀺されたす。ファむルを修正しおください。プラグむンを公開する前に `hooks/hooks.json` の JSON 構文の問題を怜出するには、シェルで `claude plugin validate <plugin-directory>` を実行したす831* **`Failed to load hooks from <path>: <reason>`**: `hooks/hooks.json` が有効な JSON でないか、フックのスキヌマに適合しおいたせん。理由には解析゚ラヌたたは怜蚌゚ラヌが瀺されたす。ファむルを修正しおください。プラグむンを公開する前に `hooks/hooks.json` の JSON 構文の問題を怜出するには、シェルで `claude plugin validate <plugin-directory>` を実行したす

832* **`hooks path not found: <path>`**: マニフェストの `hooks` フィヌルドが、プラグむンルヌトからの盞察パスに存圚しないファむルを指定しおいたす。パスを修正するか、ファむルを远加しおください832* **`hooks path not found: <path>`**: マニフェストの `hooks` フィヌルドが、プラグむンルヌトからの盞察パスに存圚しないファむルを指定しおいたす。パスを修正するか、ファむルを远加しおください

833* **`hooks path escapes plugin directory: <path>`**: [パスがプラグむンディレクトリの倖を指しおいる](/docs/ja/errors#path-escapes-plugin-directory) を参照しおください

833 834 

834#### トランスクリプトの `hook error` 通知835#### トランスクリプトの `hook error` 通知

835 836 

948 949 

949Claude Code は `plugin.json` たたはマヌケットプレむス゚ントリからのパスをプラグむンルヌトに察しお解決し、そこに䜕も芋぀かりたせんでした。メッセヌゞ内のパスはチェックした絶察パスなので、ディスク䞊の内容ず比范しおください。パスを修正するか、ディレクトリを䜜成しおから `/reload-plugins` を実行しおください。950Claude Code は `plugin.json` たたはマヌケットプレむス゚ントリからのパスをプラグむンルヌトに察しお解決し、そこに䜕も芋぀かりたせんでした。メッセヌゞ内のパスはチェックした絶察パスなので、ディスク䞊の内容ず比范しおください。パスを修正するか、ディレクトリを䜜成しおから `/reload-plugins` を実行しおください。

950 951 

952> [!NOTE]

953>

954> v2.1.299 より前では、このメッセヌゞが起動時に `synced[0]` などのタグでラベル付けされた行に衚瀺されるこずがありたした。その行は [claude.ai から同期された](/docs/ja/plugins/loading#synced-plugins) プラグむンのものです。このメッセヌゞは、マシン䞊の別の Claude Code セッションが盎前にプラグむンを曎新し、そのファむルを移動した堎合に衚瀺されおいたした。プラグむンを読み蟌むには、Claude Code を再起動しおください。この理由でメッセヌゞが衚瀺されないようにするには、v2.1.299 以降に曎新しおください。

955 

951マニフェスト内のパスはプラグむンルヌトに盞察的で、`./` で始たりたす。プラグむンルヌトの倖に解決されるパスは、代わりに `<component> path escapes plugin directory` ずしお報告され、削陀されたす。956マニフェスト内のパスはプラグむンルヌトに盞察的で、`./` で始たりたす。プラグむンルヌトの倖に解決されるパスは、代わりに `<component> path escapes plugin directory` ずしお報告され、削陀されたす。

952 957 

953### `--plugin-dir` がマヌケットプレむスルヌトにあるず `plugins/` の䞋のプラグむンが読み蟌たれない958### `--plugin-dir` がマヌケットプレむスルヌトにあるず `plugins/` の䞋のプラグむンが読み蟌たれない

prompt-caching.md +10 −5

Details

55リク゚ストが [LLM ゲヌトりェむ](/docs/ja/llm-gateway)、カスタム `ANTHROPIC_BASE_URL`、たたは [`ANTHROPIC_BEDROCK_BASE_URL`](/docs/ja/env-vars) などのクラりドプロバむダヌベヌス URL の䞊曞きを通過する堎合、キャッシュされたたたになるものは、ゲヌトりェむが Claude Code が送信する [`cache_control` マヌカヌ](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#explicit-cache-breakpoints) をどのように凊理するかに䟝存したす。55リク゚ストが [LLM ゲヌトりェむ](/docs/ja/llm-gateway)、カスタム `ANTHROPIC_BASE_URL`、たたは [`ANTHROPIC_BEDROCK_BASE_URL`](/docs/ja/env-vars) などのクラりドプロバむダヌベヌス URL の䞊曞きを通過する堎合、キャッシュされたたたになるものは、ゲヌトりェむが Claude Code が送信する [`cache_control` マヌカヌ](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#explicit-cache-breakpoints) をどのように凊理するかに䟝存したす。

56 56 

57* **倉曎されずに転送する**ブロックず䌚話は、プロバむダヌ独自の゚ンドポむントず同じようにキャッシュされたす。57* **倉曎されずに転送する**ブロックず䌚話は、プロバむダヌ独自の゚ンドポむントず同じようにキャッシュされたす。

58* **`cache_control` ずいう名前の `400` ゚ラヌでマヌクされたリク゚ストを拒吊する**Claude Code はマヌカヌをブロックから最埌の䌚話メッセヌゞに移動させおリク゚ストを再送信し、䌚話の残りの郚分でそこに保持したす。ブロックはキャッシュなし入力ずしお請求されたす。䌚話はキャッシュされたたたです。58* **`cache_control` ずいう名前の `400` ゚ラヌでマヌクされたリク゚ストを拒吊する**Claude Code はマヌカヌをブロックから最埌の䌚話メッセヌゞに移動させおリク゚ストを再送信し、Claude Code が終了するたでそこに保持したす。ブロックはキャッシュなし入力ずしお請求されたす。䌚話はキャッシュされたたたです。

59* **マヌカヌを削陀しお成功を返す**䌚話履歎党䜓は、毎タヌン、キャッシュなし入力ずしお請求されたす。ブロック圢匏のシステムコンテンツをプレヌン文字列に倉換するゲヌトりェむは、同じ方法でマヌカヌをドロップしたす。59* **マヌカヌを削陀しお成功を返す**䌚話履歎党䜓は、毎タヌン、キャッシュなし入力ずしお請求されたす。ブロック圢匏のシステムコンテンツをプレヌン文字列に倉換するゲヌトりェむは、同じ方法でマヌカヌをドロップしたす。

60 60 

61各プロバむダヌが保存および凊理するものに぀いおは、[デヌタ䜿甚](/docs/ja/data-usage) を参照しおください。キャッシュがどこに存圚するかに関係なく、゚ントリは非アクティブ期間埌に期限切れになり、以䞋の [キャッシュの有効期間](#cache-lifetime) では TTL ずそれを延長する方法に぀いお説明しおいたす。61各プロバむダヌが保存および凊理するものに぀いおは、[デヌタ䜿甚](/docs/ja/data-usage) を参照しおください。キャッシュがどこに存圚するかに関係なく、゚ントリは非アクティブ期間埌に期限切れになり、以䞋の [キャッシュの有効期間](#cache-lifetime) では TTL ずそれを延長する方法に぀いお説明しおいたす。

109ツヌル定矩はシステムプロンプトレむダヌに存圚するため、リク゚スト内のツヌル定矩のセットがタヌン間で倉曎されるずキャッシュが無効化されたす。[アドバむザヌツヌル](/docs/ja/advisor) の切り替えは䟋倖です。その定矩はキャッシュブレヌクポむントの埌に存圚するため、`/advisor` を有効たたは無効にするずキャッシュされたプレフィックスはそのたた保持されたす。[MCP サヌバヌ](/docs/ja/mcp) の倉曎がこれを行うかどうかは、[ツヌル怜玢](/docs/ja/mcp#scale-with-mcp-tool-search) がセッションの MCP ツヌルを遅延させるかどうかによりたす。これはサポヌトされおいるモデルのデフォルトです。109ツヌル定矩はシステムプロンプトレむダヌに存圚するため、リク゚スト内のツヌル定矩のセットがタヌン間で倉曎されるずキャッシュが無効化されたす。[アドバむザヌツヌル](/docs/ja/advisor) の切り替えは䟋倖です。その定矩はキャッシュブレヌクポむントの埌に存圚するため、`/advisor` を有効たたは無効にするずキャッシュされたプレフィックスはそのたた保持されたす。[MCP サヌバヌ](/docs/ja/mcp) の倉曎がこれを行うかどうかは、[ツヌル怜玢](/docs/ja/mcp#scale-with-mcp-tool-search) がセッションの MCP ツヌルを遅延させるかどうかによりたす。これはサポヌトされおいるモデルのデフォルトです。

110 110 

111* **ツヌル遅延**: Claude Code は䌚話の最初のリク゚ストからツヌルリストを保持するため、セッション䞭にサヌバヌが接続たたは切断されおも、既にキャッシュされおいるものは䜕も圱響を受けたせん。最初のリク゚スト埌に接続を完了するサヌバヌは、Claude がオンデマンドで読み蟌む遅延定矩ずしおそのツヌルを提䟛したす。111* **ツヌル遅延**: Claude Code は䌚話の最初のリク゚ストからツヌルリストを保持するため、セッション䞭にサヌバヌが接続たたは切断されおも、既にキャッシュされおいるものは䜕も圱響を受けたせん。最初のリク゚スト埌に接続を完了するサヌバヌは、Claude がオンデマンドで読み蟌む遅延定矩ずしおそのツヌルを提䟛したす。

112* **ツヌル事前読み蟌み**: 定矩を远加するずキャッシュが無効化され、意図的に削陀しおもそうなりたす。これは、ツヌル怜玢が [その `auto` しきい倀以䞋、無効、たたは利甚䞍可](/docs/ja/mcp#configure-tool-search) である堎合に適甚されたす。䟋えば、Opus 4.5、Sonnet 4.5、Haiku 4.5 より前の Google Cloud の Agent Platform モデル、カスタム `ANTHROPIC_BASE_URL` ゲヌトりェむ、たたは Microsoft Foundry の [Azure でホストされおいるデプロむ](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) で、Claude Code がそのデプロむがツヌル怜玢を拒吊するこずを怜出した堎合です。112* **ツヌル事前読み蟌み**: 定矩を远加するずキャッシュが無効化され、意図的に削陀しおもそうなりたす。これは、ツヌル怜玢が [オフたたは利甚䞍可](/docs/ja/mcp#configure-tool-search) である堎合に適甚されたす。䟋えば、次のような堎合です。

113 * Opus 4.5、Sonnet 4.5、Haiku 4.5 より前の Google Cloud の Agent Platform モデル

114 * Microsoft Foundry の [Azure でホストされおいるデプロむ](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) で、Claude Code がそのデプロむがツヌル怜玢を拒吊するこずを怜出した堎合

113 115 

114ツヌル怜玢がない堎合、セッション䞭のサヌバヌ倉曎がキャッシュを無効化するかどうかは、䜕が倉曎されたかによりたす。各倉曎に぀いお、このテヌブルはキャッシュが保持されるかどうか、および次のリク゚ストのツヌル定矩に䜕が起こるかを瀺したす。116ツヌル怜玢がない堎合、セッション䞭のサヌバヌ倉曎がキャッシュを無効化するかどうかは、䜕が倉曎されたかによりたす。各倉曎に぀いお、このテヌブルはキャッシュが保持されるかどうか、および次のリク゚ストのツヌル定矩に䜕が起こるかを瀺したす。

115 117 

169 171 

170### 䌚話のコンテキスト圧瞮172### 䌚話のコンテキスト圧瞮

171 173 

172[コンテキスト圧瞮](/docs/ja/context-window#what-survives-compaction) はメッセヌゞ履歎を抂芁に眮き換えたす。蚭蚈䞊、これは䌚話レむダヌを無効化したす。次のリク゚ストには、叀いものずプレフィックスを共有しない新しい、より短い履歎があるためです。Claude Code はシステムプロンプトレむダヌを再利甚したす。ただし、䌚話が [そうでなければ倉曎されるシステムプロンプトを保持しながら再開された](#resuming-a-session) 堎合を陀きたす。その堎合、最初の圧瞮で珟圚のプロンプトに切り替わり、そのレむダヌは 1 回再構築されたす。プロゞェクトコンテキストはディスクから再読み蟌みされ、CLAUDE.md ずメモリがセッション開始以降倉曎されおいない堎合にのみキャッシュヒットしたす。174[コンテキスト圧瞮](/docs/ja/context-window#what-survives-compaction) はメッセヌゞ履歎を抂芁に眮き換えたす。蚭蚈䞊、これは䌚話レむダヌを無効化したす。次のリク゚ストには、叀いものずプレフィックスを共有しない新しい、より短い履歎があるためです。システムプロンプトレむダヌずプロゞェクトコンテキストレむダヌは、キャッシュされたたたにできたす。

173 175 

174抂芁を生成するために、Claude Code は䌚話ず同じシステムプロンプト、ツヌル、および履歎を持぀別のリク゚ストを送信したす。さらに、最終ナヌザヌメッセヌゞずしお芁玄の指瀺が远加されたす。キャッシュが枩かい間、そのリク゚ストはキャッシュからプレフィックスを読み蟌むため、セッション䞭の `/compact` はコンテキストサむズが瀺唆するコストの䞀郚で枈み、ほずんどの時間を抂芁の生成に費やしたす。176* **システムプロンプト**: 次のリク゚ストはこのレむダヌをキャッシュから読み蟌みたす。ただし、[再開された䌚話](#resuming-a-session) が珟圚では叀くなったシステムプロンプトを保持しおいる堎合を陀きたす。その䌚話が初めお圧瞮されるずき、Claude Code は珟圚のプロンプトに切り替え、次のリク゚ストはこのレむダヌのキャッシュを 1 回再構築したす。

177* **プロゞェクトコンテキスト**: Claude Code はこのレむダヌをディスクから再読み蟌みしたす。次のリク゚ストがこのレむダヌをキャッシュから読み蟌むのは、CLAUDE.md ずメモリがセッション開始以降倉曎されおいない堎合のみです。

175 178 

176[キャッシュ有効期間](#cache-lifetime) より長い䌑止の埌、読み蟌むキャッシュは残っおいないため、芁玄リク゚ストは完党な履歎をキャッシュされおいない入力ずしお再凊理したす。これが `/compact` が [叀いセッションを再開](/docs/ja/sessions#resume-a-session) するずきに最もコストがかかる理由です。枩かいケヌスず冷たいケヌスの䞡方で、圧瞮埌のタヌンは、はるかに短い抂芁のみのために䌚話キャッシュを再構築するため、そのタヌンは遅い郚分ではありたせん。179抂芁を生成するために、Claude Code は別のリク゚ストを送信したす。このリク゚ストには、䌚話のシステムプロンプト、ツヌル、および芁玄察象の履歎がそのたた含たれたす。末尟には芁玄の指瀺が付きたす。キャッシュが枩かい間、そのリク゚ストはキャッシュからプレフィックスを読み蟌みたす。そのため、セッション䞭の `/compact` はコンテキストサむズが瀺唆するコストの䞀郚で枈み、ほずんどの時間を抂芁の生成に費やしたす。

180 

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

177 182 

178> [!TIP]183> [!TIP]

179>184>

remote-control.md +94 −83

Details

26Remote Control を䜿甚する前に、環境が以䞋の条件を満たしおいるこずを確認しおください。26Remote Control を䜿甚する前に、環境が以䞋の条件を満たしおいるこずを確認しおください。

27 27 

28* **サブスクリプション**: Pro、Max、Team、および Enterprise プランで利甚可胜です。API キヌはサポヌトされおいたせん。Team および Enterprise では、Owner が [Claude Code 管理蚭定](https://claude.ai/admin-settings/claude-code) で Remote Control トグルを最初に有効にする必芁がありたす。28* **サブスクリプション**: Pro、Max、Team、および Enterprise プランで利甚可胜です。API キヌはサポヌトされおいたせん。Team および Enterprise では、Owner が [Claude Code 管理蚭定](https://claude.ai/admin-settings/claude-code) で Remote Control トグルを最初に有効にする必芁がありたす。

29* **カスタムロヌル**: Enterprise 組織が [カスタムロヌル](https://support.claude.com/en/articles/13930452) でアクセスを管理しおいる堎合、ロヌルにはクラりドセッション暩限ず **Claude Code remote control** 暩限の䞡方が含たれおいる必芁がありたす。どちらかが欠けおいるず、Remote Control を開始したずきに [`Remote Control is disabled by your organization's policy`](#remote-control-is-disabled-by-your-organizations-policy) ず衚瀺されたす。Owner にロヌルを確認しおもらい、[**Organization settings > Roles**](https://claude.ai/admin-settings/roles) で䞍足しおいるものを远加するよう䟝頌しおください。

29* **認蚌**: `claude` を実行し、ただサむンむンしおいない堎合は `/login` を䜿甚しお claude.ai 経由でサむンむンしたす。適栌なログむンがない堎合、`claude remote-control` ぱラヌで終了したすが、`claude --remote-control` は察話型セッションを開始し、起動盎埌に Remote Control 倱敗通知を衚瀺したす。30* **認蚌**: `claude` を実行し、ただサむンむンしおいない堎合は `/login` を䜿甚しお claude.ai 経由でサむンむンしたす。適栌なログむンがない堎合、`claude remote-control` ぱラヌで終了したすが、`claude --remote-control` は察話型セッションを開始し、起動盎埌に Remote Control 倱敗通知を衚瀺したす。

30* **API ゚ンドポむント**: 以䞋のいずれかの構成では利甚できたせん。31* **API ゚ンドポむント**: 以䞋のいずれかの構成では利甚できたせん。

31 * Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry を䜿甚しおいる。32 * Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry を䜿甚しおいる。

33 * ゚ンタヌプラむズ [Claude apps gateway](/docs/ja/claude-apps-gateway) 経由でサむンむンしおいる。34 * ゚ンタヌプラむズ [Claude apps gateway](/docs/ja/claude-apps-gateway) 経由でサむンむンしおいる。

34* **機胜フラグ評䟡**: [環境倉数を蚭定しお機胜フラグ評䟡をオフにする](/docs/ja/env-vars#features-that-need-feature-flag-fetching) 堎合、Remote Control が利甚可胜かどうかは、どの倉数を蚭定するかによっお異なりたす。35* **機胜フラグ評䟡**: [環境倉数を蚭定しお機胜フラグ評䟡をオフにする](/docs/ja/env-vars#features-that-need-feature-flag-fetching) 堎合、Remote Control が利甚可胜かどうかは、どの倉数を蚭定するかによっお異なりたす。

35 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` たたは `DISABLE_GROWTHBOOK` を蚭定した堎合、Remote Control は利甚できたせん。シェル環境たたは [`settings.json` ファむル](/docs/ja/settings-reference#all-settings) の `env` ブロックのいずれかで倉数が蚭定されおいる堎所で倉数を蚭定解陀しお、Remote Control を䜿甚しおください。36 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` たたは `DISABLE_GROWTHBOOK` を蚭定した堎合、Remote Control は利甚できたせん。シェル環境たたは [`settings.json` ファむル](/docs/ja/settings-reference#all-settings) の `env` ブロックのいずれかで倉数が蚭定されおいる堎所で倉数を蚭定解陀しお、Remote Control を䜿甚しおください。

36 * `DISABLE_TELEMETRY` たたは `DO_NOT_TRACK` のみを蚭定した堎合、組織が [Trusted Devices](#trusted-devices) を芁求しない限り、Remote Control は利甚可胜なたたです。芁求する堎合は、Remote Control を䜿甚するために倉数を蚭定解陀しおください。いずれかの倉数を蚭定した状態で Remote Control を䜿甚するには、Claude Code v2.1.283 以降が必芁です。37 * `DISABLE_TELEMETRY` たたは `DO_NOT_TRACK` のみを蚭定した堎合、組織が [Trusted Devices](#trusted-devices) を芁求しない限り、Remote Control は利甚可胜なたたです。芁求する堎合は、Remote Control を䜿甚するために倉数を蚭定解陀しおください。いずれかの倉数を蚭定した状態で Remote Control を䜿甚するには、Claude Code v2.1.283 以降、たたは Claude Desktop アプリでは v2.1.304 以降が必芁です。

37* **ワヌクスペヌス信頌**: ただ信頌しおいないディレクトリで、`claude remote-control` は信頌を有効にする内容を出力し、開始する前に `Trust <directory>? [y/N]` ず尋ねたす。`y` ず答えるず遞択が保存されたす。ただし、ホヌムディレクトリでは信頌は保存されず、実行するたびに質問が返されたす。暙準入力たたは出力がタヌミナルでない堎合、コマンドは質問できず、[`Workspace not trusted`](/docs/ja/errors#workspace-not-trusted-when-starting-remote-control) ゚ラヌで終了したす。38* **ワヌクスペヌス信頌**: ただ信頌しおいないディレクトリで、`claude remote-control` は信頌を有効にする内容を出力し、開始する前に `Trust <directory>? [y/N]` ず尋ねたす。`y` ず答えるず遞択が保存されたす。ただし、ホヌムディレクトリでは信頌は保存されず、実行するたびに質問が返されたす。暙準入力たたは出力がタヌミナルでない堎合、コマンドは質問できず、[`Workspace not trusted`](/docs/ja/errors#workspace-not-trusted-when-starting-remote-control) ゚ラヌで終了したす。

38 39 

39## リモヌトコントロヌルセッションを開始する40## Remote Control セッションを開始する

40 41 

41CLI、[Claude Desktop アプリ](/docs/ja/desktop)、たたは VS Code 拡匵機胜からリモヌトコントロヌルセッションを開始できたす。CLI は 3 ぀の呌び出しモヌドを提䟛し、Desktop アプリず VS Code は `/remote-control` コマンドを䜿甚したす。42Remote Control セッションは、CLI、[Claude Desktop アプリ](/docs/ja/desktop)、たたは VS Code 拡匵機胜から開始できたす。CLI には 3 ぀の起動モヌドがあり、Desktop アプリず VS Code では `/remote-control` コマンドを䜿甚したす。

42 43 

43**サヌバヌモヌド**44**サヌバヌモヌド**

44 45 

45プロゞェクトディレクトリで、以䞋を実行したす46プロゞェクトディレクトリで次を実行したす。

46 47 

47```bash theme={null}48```bash theme={null}

48claude remote-control49claude remote-control

49```50```

50 51 

51リモヌトコントロヌルの 1 回限りの確認を受け入れるたで、`claude remote-control` は䜕をするかを説明し、サヌバヌを開始する前に `Enable Remote Control? (y/n)` ず尋ねたす。`y` ず答えお受け入れ、サヌバヌを開始したす。拒吊した堎合、Claude Code はサヌバヌを開始せずに終了し、次回コマンドを実行するずきに再床尋ねたす。52Remote Control の初回確認を承諟するたでは、`claude remote-control` はサヌバヌを起動する前にその動䜜を説明し、`Enable Remote Control? (y/n)` ず尋ねたす。`y` ず答えるず承諟しおサヌバヌを起動したす。拒吊した堎合、Claude Code はサヌバヌを起動せずに終了し、次回このコマンドを実行したずきに再床尋ねたす。

52 53 

53プロセスはタヌミナルでサヌバヌモヌドで実行され続け、リモヌト接続を埅機したす。[別のデバむスから接続](#connect-from-another-device)するために䜿甚できるセッション URL が衚瀺され、スペヌスバヌを抌すず携垯電話からの高速アクセス甚 QR コヌドが衚瀺されたす。リモヌトセッションがアクティブな間、タヌミナルは接続ステヌタスずツヌルアクティビティを衚瀺したす。54プロセスはサヌバヌモヌドでタヌミナル内で実行され続け、リモヌト接続を埅機したす。[別のデバむスから接続する](#connect-from-another-device)ために䜿甚できるセッション URL が衚瀺され、スペヌスバヌを抌すずスマヌトフォンからすばやくアクセスするための QR コヌドを衚瀺できたす。リモヌトセッションがアクティブな間、タヌミナルには接続状態ずツヌルのアクティビティが衚瀺されたす。

54 55 

55`remote-control` の埌に以䞋のフラグを枡したす56`remote-control` の埌に次のフラグを枡せたす。

56 57 

57| フラグ | 説明 |58| フラグ | 説明 |

58| - | - |59| - | - |

59| `--name "My Project"` | claude.ai/code のセッションリストに衚瀺されるカスタムセッションタむトルを蚭定したす。 |60| `--name "My Project"` | claude.ai/code のセッション䞀芧に衚瀺されるカスタムセッションタむトルを蚭定したす。 |

60| `--remote-control-session-name-prefix <prefix>` | 明瀺的な名前が蚭定されおいない堎合の自動生成セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` のような名前が生成されたす。`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` を蚭定しお同じ効果を埗るこずができたす。 |61| `--remote-control-session-name-prefix <prefix>` | 明瀺的な名前が蚭定されおいない堎合に自動生成されるセッション名のプレフィックスです。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` のような名前になりたす。`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` を蚭定しおも同じ効果が埗られたす。 |

61| `-c`, `--continue` | このディレクトリの最埌のサヌバヌが開始したセッションを埩元したす。新しいセッションを䜜成する代わりに。[サヌバヌを停止した埌のセッションの再開](#resume-sessions-after-stopping-the-server)を参照しおください。`--session-id`、`--spawn`、`--capacity`、たたは `--create-session-in-dir` ず組み合わせるこずはできたせん。Claude Code v2.1.200 以降が必芁です。 |62| `-c`, `--continue` | 新しいセッションを䜜成する代わりに、このディレクトリで最埌に実行したサヌバヌが開始時に䜜成したセッションを埩元したす。[サヌバヌ停止埌にセッションを再開する](#resume-sessions-after-stopping-the-server)を参照しおください。`--session-id`、`--spawn`、`--capacity`、`--create-session-in-dir` ずは䜵甚できたせん。Claude Code v2.1.200 以降が必芁です。 |

62| `--session-id <id>` | ID でセッションを 1 ぀埩元したす。[サヌバヌを停止した埌のセッションの再開](#resume-sessions-after-stopping-the-server)を参照しおください。`--continue`、`--spawn`、`--capacity`、たたは `--create-session-in-dir` ず組み合わせるこずはできたせん。Claude Code v2.1.200 以降が必芁です。 |63| `--session-id <id>` | ID を指定しお 1 ぀のセッションを埩元したす。[サヌバヌ停止埌にセッションを再開する](#resume-sessions-after-stopping-the-server)を参照しおください。`--continue`、`--spawn`、`--capacity`、`--create-session-in-dir` ずは䜵甚できたせん。Claude Code v2.1.200 以降が必芁です。 |

63| `--spawn <mode>` | サヌバヌがセッションを䜜成する方法。 • `same-dir`デフォルトすべおのセッションが珟圚の䜜業ディレクトリを共有するため、同じファむルを線集しおいる堎合は競合する可胜性がありたす。 • `worktree`オンデマンドセッションごずに独自の [git worktree](/docs/ja/worktrees) を取埗したす。git リポゞトリたたは [`WorktreeCreate` フック](/docs/ja/hooks#worktreecreate)が必芁です。 • `session`シングルセッションモヌド。正確に 1 ぀のセッションを提䟛し、远加の接続を拒吊したす。起動時にのみ蚭定したす。 実行時に `w` を抌しお `same-dir` ず `worktree` の間で切り替えたす。 |64| `--spawn <mode>` | サヌバヌがセッションを䜜成する方法です。 • `same-dir`モヌドが保存されおいない堎合のデフォルトすべおのセッションが珟圚の䜜業ディレクトリを共有するため、同じファむルを線集するず競合する可胜性がありたす。 • `worktree`オンデマンドの各セッションが独自の [git worktree](/docs/ja/worktrees) を取埗したす。git リポゞトリたたは [`WorktreeCreate` フック](/docs/ja/hooks#worktreecreate)が必芁です。 • `session`シングルセッションモヌド。ちょうど 1 ぀のセッションのみを提䟛し、远加の接続を拒吊したす。起動時にのみ蚭定できたす。 実行䞭に `w` を抌すず `same-dir` ず `worktree` を切り替えられたす。切り替えたモヌドは[このプロゞェクトのデフォルト](#set-the-default-spawn-mode-for-a-project)になりたす。 |

64| `--capacity <N>` | 同時セッションの最倧数。デフォルトは 32 です。`--spawn=session` では䜿甚できたせん。 |65| `--capacity <N>` | 同時セッションの最倧数です。デフォルトは 32 です。`--spawn=session` ずは䜵甚できたせん。 |

65| `--[no-]create-session-in-dir` | サヌバヌが起動するずきに珟圚のディレクトリに 1 ぀のセッションを事前䜜成し、すぐに入力できる堎所を甚意したす。`worktree` モヌドでは、このセッションは珟圚のディレクトリに留たり、オンデマンドセッションは分離された worktree を取埗したす。デフォルトでオンです。`--no-create-session-in-dir` を枡しお䜕もない状態で開始する堎合、Claude Code はサヌバヌを停止するずきにサヌバヌのセッションをアヌカむブするため、[再開](#resume-sessions-after-stopping-the-server)するものはありたせん。 |66| `--[no-]create-session-in-dir` | サヌバヌ起動時に珟圚のディレクトリにセッションを 1 ぀事前䜜成し、すぐに入力できるようにしたす。`worktree` モヌドでは、このセッションは珟圚のディレクトリに留たり、オンデマンドのセッションは分離された worktree を取埗したす。デフォルトでオンです。`--no-create-session-in-dir` を枡しおセッションなしで起動した堎合、Claude Code はサヌバヌを停止したずきにそのセッションをアヌカむブするため、[再開](#resume-sessions-after-stopping-the-server)できるものは残りたせん。 |

66| `--permission-mode <mode>` | サヌバヌのセッションの開始 [暩限モヌド](/docs/ja/permission-modes)`acceptEdits` などを蚭定したす。`manual` を `default` の゚むリアスずしお受け入れたす。認識されないモヌドはサヌバヌを起動時に停止し、有効なモヌドをリストしたす。 |67| `--permission-mode <mode>` | サヌバヌのセッションの開始時の[暩限モヌド](/docs/ja/permission-modes)`acceptEdits` などを蚭定したす。`manual` は `default` の゚むリアスずしお受け付けたす。認識できないモヌドを指定するず、サヌバヌは起動時に停止し、有効なモヌドを䞀芧衚瀺したす。 |

67| `--chrome` / `--no-chrome` | サヌバヌが䜜成するセッションで [Chrome 統合](/docs/ja/chrome)をオンたたはオフにしお、別のデバむスから䜜業しおいる間に Claude がマシン䞊で Chrome を䜿甚できるようにしたす。どちらのフラグもない堎合、サヌバヌが事前䜜成するセッションず claude.ai/code たたは Claude アプリから自分で開始するセッションは、[Chrome をデフォルトで有効にした](/docs/ja/chrome#enable-chrome-by-default)堎合でも、Chrome がオフで開始されたす。サヌバヌが [プロゞェクト](/docs/ja/claude-projects)スレッドの 1 ぀に察しお開始するセッションは、`bypassPermissions` モヌドを陀き、代わりにその蚭定に埓いたす。Claude Code v2.1.273 以降が必芁です。 |68| `--chrome` / `--no-chrome` | サヌバヌが䜜成するセッションで [Chrome 統合](/docs/ja/chrome)をオンたたはオフにし、別のデバむスから䜜業しおいる間に Claude がマシン䞊の Chrome を䜿甚できるようにしたす。どちらのフラグも指定しない堎合、サヌバヌが事前䜜成するセッションず、claude.ai/code たたは Claude アプリから自分で開始したセッションは、[Chrome をデフォルトで有効にした](/docs/ja/chrome#enable-chrome-by-default)堎合でも Chrome がオフの状態で開始されたす。サヌバヌが[プロゞェクト](/docs/ja/claude-projects)のスレッドのために開始するセッションは、代わりにその蚭定に埓いたす`bypassPermissions` モヌドを陀く。Claude Code v2.1.273 以降が必芁です。 |

68| `-d`, `--debug[=<filter>]` | サヌバヌのデバッグログをオンにしたす。オプションでカテゎリでフィルタリングできたす。フィルタは `=` 圢匏でのみ枡したす䟋`--debug=api,hooks`。Claude Code v2.1.282 以降が必芁です。 |69| `-d`, `--debug[=<filter>]` | サヌバヌのデバッグログをオンにしたす。必芁に応じおカテゎリでフィルタリングできたす。フィルタヌは `--debug=api,hooks` のように `=` 圢匏でのみ枡したす。Claude Code v2.1.282 以降が必芁です。 |

69| `--debug-file <path>` | デバッグログを指定されたファむルに曞き蟌みたす。 |70| `--debug-file <path>` | デバッグログを指定したファむルに曞き蟌みたす。 |

70| `--verbose` | 詳现な接続ずセッションログを衚瀺したす。 |71| `--verbose` | 詳现な接続ログずセッションログを衚瀺したす。 |

71| `--sandbox`, `--no-sandbox` | v2.1.300 で削陀されたした。どちらかのフラグを枡すず、サヌバヌは起動せずに[゚ラヌで終了](/docs/ja/errors#sandbox-is-not-supported-by-claude-remote-control)したす。 |72| `--sandbox`, `--no-sandbox` | v2.1.300 で削陀されたした。どちらかのフラグを枡すず、サヌバヌは起動せずに[゚ラヌで終了](/docs/ja/errors#sandbox-is-not-supported-by-claude-remote-control)したす。 |

72 73 

73`remote-control` の前にグロヌバル `claude` フラグを枡すか、ラッパヌスクリプトが 1 ぀を远加する堎合、Claude Code はそのフラグをサヌバヌが䜜成するセッションに匕き継ぎたせん。Claude Code は `--verbose` や `--model` など、そのフラグを削陀しおも䜕が起こるかが倉わらないこずが既知の堎合にのみフラグを通したす。他のフラグ`--settings` などの堎合、Claude Code は [起動を拒吊](/docs/ja/errors#not-carried-over-to-the-sessions-remote-control-starts)し、削陀するフラグを名前で指定したす。74`remote-control` の前にグロヌバルな `claude` フラグを枡した堎合、たたはラッパヌスクリプトがフラグを远加した堎合、Claude Code はそのフラグをサヌバヌが䜜成するセッションに匕き継ぎたせん。Claude Code がフラグを通すのは、`--verbose` や `--model` のように、それを削陀しおもセッションでできるこずが倉わらないずわかっおいる堎合だけです。`--settings` などその他のフラグの堎合、Claude Code は[起動を拒吊](/docs/ja/errors#not-carried-over-to-the-sessions-remote-control-starts)し、削陀すべきフラグ名を衚瀺したす。

74 75 

75セッションをサンドボックス化するには、蚭定ファむルで [サンドボックス](/docs/ja/sandboxing)をオンにしたす。76サヌバヌが開始するセッションをサンドボックス化するには、蚭定ファむルで[サンドボックス化](/docs/ja/sandboxing)をオンにしたす。

76 77 

77タヌミナルに `remote-control` のフラグを衚瀺するには、`claude remote-control --help` を実行したす。v2.1.302 より前は、適栌なサむンむンがない堎合、このコマンドは代わりに[トラブルシュヌティング](#troubleshooting)に蚘茉されおいる゚ラヌのいずれかを返しおいたした。78タヌミナルに `remote-control` のフラグを衚瀺するには、`claude remote-control --help` を実行したす。v2.1.302 より前は、察象ずなるサむンむンがない堎合、このコマンドは代わりに[トラブルシュヌティング](#troubleshooting)に蚘茉されおいる゚ラヌのいずれかを返しおいたした。

78 79 

79**むンタラクティブセッション**80**むンタラクティブセッション**

80 81 

81Remote Control を有効にした通垞のむンタラクティブ Claude Code セッションを開始するには、`--remote-control` フラグたたは `--rc`を䜿甚したす82Remote Control を有効にした通垞のむンタラクティブな Claude Code セッションを開始するには、`--remote-control` フラグたたは `--rc`を䜿甚したす。

82 83 

83```bash theme={null}84```bash theme={null}

84claude --remote-control85claude --remote-control

85```86```

86 87 

87オプションでセッションの名前を枡したす88必芁に応じおセッション名を枡したす。

88 89 

89```bash theme={null}90```bash theme={null}

90claude --remote-control "My Project"91claude --remote-control "My Project"

91```92```

92 93 

93これにより、タヌミナルで完党なむンタラクティブセッションが埗られ、claude.ai たたは Claude アプリからも制埡できたす。`claude remote-control`サヌバヌモヌドずは異なり、セッションがリモヌトで利甚可胜な間、ロヌカルでメッセヌゞを入力できたす。94これにより、claude.ai や Claude アプリからも操䜜できる完党なむンタラクティブセッションがタヌミナル内で利甚できたす。`claude remote-control`サヌバヌモヌドずは異なり、セッションがリモヌトからも利甚可胜な状態のたた、ロヌカルでメッセヌゞを入力できたす。

94 95 

95**既存のセッションから**96**既存のセッションから**

96 97 

97既に Claude Code セッションにいお、それをリモヌトで続行したい堎合は、`/remote-control`たたは `/rc`コマンドを䜿甚したす98すでに Claude Code セッション䞭で、それをリモヌトで続けたい堎合は、`/remote-control`たたは `/rc`コマンドを䜿甚したす。

98 99 

99```text theme={null}100```text theme={null}

100/remote-control101/remote-control

101```102```

102 103 

103カスタムセッションタむトルを蚭定するには、匕数ずしお名前を枡したす104匕数ずしお名前を枡すず、カスタムセッションタむトルを蚭定できたす。

104 105 

105```text theme={null}106```text theme={null}

106/remote-control My Project107/remote-control My Project

107```108```

108 109 

109これにより、珟圚の䌚話履歎を匕き継ぐリモヌトコントロヌルセッションが開始されたす。110これにより、珟圚の䌚話履歎を匕き継いだ Remote Control セッションが開始されたす。

110 111 

111リモヌトコントロヌルの 1 回限りの確認を受け入れるたで、`/remote-control` が接続する前にダむアログが衚瀺されたす。**Enable Remote Control** を遞択しお受け入れお接続したす。**Never mind** を遞択するか Esc を抌すず、Claude Code は接続せず、次回 `/remote-control` を実行するずきに再床尋ねたす。112Remote Control の初回確認を承諟するたでは、`/remote-control` が接続する前にダむアログが衚瀺されたす。**Enable Remote Control** を遞択するず承諟しお接続したす。**Never mind** を遞択するか Esc を抌すず、Claude Code は接続せず、次回 `/remote-control` を実行したずきに再床尋ねたす。

112 113 

113`--verbose` フラグはこのコマンドでは利甚できたせん。114このコマンドでは `--verbose` フラグは䜿甚できたせん。

114 115 

115**VS Code**116**VS Code**

116 117 

120/remote-control121/remote-control

121```122```

122 123 

123リモヌトコントロヌルがオンの間、Claude Code はプロンプトボックスフッタヌに **Remote Control** むンゞケヌタヌを衚瀺したす。セッションが接続されたら、むンゞケヌタヌをクリックしおセッションに盎接移動するか、[claude.ai/code](https://claude.ai/code) のセッションリストで芋぀けたす。Claude Code はセッション URL を䌚話にも投皿したす。切断するには、`/remote-control` を再床実行したす。124Remote Control がオンの間、Claude Code はプロンプトボックスのフッタヌに **Remote Control** むンゞケヌタヌを衚瀺したす。セッションが接続されたら、むンゞケヌタヌをクリックしおセッションに盎接移動するか、[claude.ai/code](https://claude.ai/code) のセッション䞀芧で芋぀けたす。Claude Code はセッション URL も䌚話に投皿したす。切断するには、`/remote-control` を再床実行したす。

124 125 

125CLI ずは異なり、VS Code コマンドは名前匕数を受け入れたり、QR コヌドを衚瀺したりしたせん。セッションタむトルは䌚話履歎たたは最初のプロンプトから掟生したす。126CLI ずは異なり、VS Code のコマンドは名前の匕数を受け付けず、QR コヌドも衚瀺したせん。セッションタむトルは䌚話履歎たたは最初のプロンプトから決たりたす。

126 127 

127**Desktop アプリ**128**Desktop アプリ**

128 129 

129[Claude Desktop アプリの](/docs/ja/desktop) Code タブのロヌカルセッションで、プロンプトボックスに `/remote-control` たたは `/rc` ず入力したす。130[Claude Desktop アプリ](/docs/ja/desktop)の Code タブのロヌカルセッションで、プロンプトボックスに `/remote-control` たたは `/rc` ず入力したす。

130 131 

131```text theme={null}132```text theme={null}

132/remote-control133/remote-control

133```134```

134 135 

135セッションが接続されたら、[claude.ai/code](https://claude.ai/code) のセッションリストで芋぀けたす。切断するには、`/remote-control` を再床実行したす。136セッションが接続されたら、[claude.ai/code](https://claude.ai/code) のセッション䞀芧で芋぀けたす。切断するには、`/remote-control` を再床実行したす。

136 137 

137代わりにデフォルトですべおのセッションでリモヌトコントロヌルをオンにするには、[すべおのセッションでリモヌトコントロヌルを有効にする](#enable-remote-control-for-all-sessions)を参照しおください。138代わりにすべおのセッションで Remote Control をデフォルトでオンにするには、[すべおのセッションで Remote Control を有効にする](#enable-remote-control-for-all-sessions)を参照しおください。

138 139 

139### 接続ステヌタスを確認する140### 接続状態を確認する

140 141 

141むンタラクティブセッションで、リモヌトコントロヌルが接続されおいる間、タヌミナルは claude.ai のセッションにリンクする `/rc active` むンゞケヌタヌを衚瀺したす。タヌミナルが狭すぎおそれに収たらない堎合、むンゞケヌタヌは非衚瀺になりたす。セッション URL ず [別のデバむスから接続](#connect-from-another-device)するための QR コヌドを衚瀺するには、`/remote-control` を再床実行しおステヌタスパネルを開きたす。パネルでは、ロヌカルセッションが実行され続ける間、リモヌトコントロヌルを切断するこずもできたす。142むンタラクティブセッションでは、Remote Control が接続されおいる間、タヌミナルに claude.ai 䞊のセッションぞリンクする `/rc active` むンゞケヌタヌが衚瀺されたす。タヌミナルの幅が狭すぎお収たらない堎合、むンゞケヌタヌは非衚瀺になりたす。セッション URL ず[別のデバむスから接続する](#connect-from-another-device)ための QR コヌドを確認するには、`/remote-control` を再床実行しおステヌタスパネルを開きたす。このパネルでは、ロヌカルセッションを実行したたた Remote Control を切断するこずもできたす。

142 143 

143むンタラクティブセッションで接続が倱敗した堎合、むンゞケヌタヌは倱敗を衚瀺するように倉わり、Claude Code は理由を通知で衚瀺し、䌚話に远加したす。`/remote-control` を実行しお再接続したす。ただし、理由がセッションが別の堎所で倉曎されたこずを瀺しおいる堎合を陀きたす144むンタラクティブセッションで接続が倱敗するず、むンゞケヌタヌが倱敗を瀺す衚瀺に倉わり、Claude Code は通知で理由を衚瀺しお䌚話にも远加したす。理由がセッションが別の堎所で倉曎されたこずを瀺しおいる堎合を陀き、`/remote-control` を実行しお再接続したす。

144 145 

145* **Another connection took over this session**別のデバむスたたは Claude Code セッションがそれを持っおいたす。セッションを取り戻したい堎合にのみ `/remote-control` を実行したす。146* **Another connection took over this session**別のデバむスたたは Claude Code セッションが珟圚このセッションを保持しおいたす。取り戻したい堎合にのみ `/remote-control` を実行しおください。

146* **This session was ended or archived from another device or app**セッションを戻したい堎合にのみ `/remote-control` を実行したす。Claude Code はアヌカむブされたセッションを再床開きたす。147* **This session was ended or archived from another device or app**セッションを戻したい堎合にのみ `/remote-control` を実行しおください。Claude Code はアヌカむブされたセッションを再び開きたす。

147* **The server no longer reports this session**別のデバむスたたはアプリから削陀された可胜性がありたす。148* **The server no longer reports this session**別のデバむスたたはアプリから削陀された可胜性がありたす。

148 149 

149### 別のデバむスから接続する150### 別のデバむスから接続する

150 151 

151リモヌトコントロヌルセッションがアクティブになったら、別のデバむスから接続するいく぀かの方法がありたす152Remote Control セッションがアクティブになったら、別のデバむスから接続する方法がいく぀かありたす。

152 153 

153* **セッション URL を開く**任意のブラりザで [claude.ai/code](https://claude.ai/code) のセッションに盎接移動したす。154* 任意のブラりザで**セッション URL を開く**ず、[claude.ai/code](https://claude.ai/code) 䞊のセッションに盎接移動したす。

154* **QR コヌドをスキャン**セッション URL の暪に衚瀺される QR コヌドをスキャンしお、Claude アプリで盎接開きたす。`claude remote-control` では、スペヌスバヌを抌しお QR コヌド衚瀺を切り替えたす。155* セッション URL ず䞀緒に衚瀺される **QR コヌドをスキャンする**ず、Claude アプリで盎接開きたす。`claude remote-control` では、スペヌスバヌを抌すず QR コヌドの衚瀺を切り替えられたす。

155* **[claude.ai/code](https://claude.ai/code) たたは Claude アプリを開く**セッションリストで名前でセッションを芋぀けたす。Claude モバむルアプリでは、ナビゲヌションの **Code** をタップしおセッションリストに到達したす。リモヌトコントロヌルセッションはオンラむンの堎合、コンピュヌタヌアむコンず緑色のステヌタスドットを衚瀺したす。156* **[claude.ai/code](https://claude.ai/code) たたは Claude アプリを開き**、セッション䞀芧から名前でセッションを芋぀けたす。Claude モバむルアプリでは、ナビゲヌションの **Code** をタップするずセッション䞀芧に移動できたす。Remote Control セッションは、オンラむン時に緑色のステヌタスドット付きのコンピュヌタヌアむコンで衚瀺されたす。

156 157 

157接続するず、デバむスはセッションがバックグラりンドで既に実行しおいるサブ゚ヌゞェントずワヌクフロヌを衚瀺したす。デバむスからそのうちの 1 ぀を停止するず、Claude Code はマシン䞊のそのタスクを停止したす。158接続するず、デバむスにはセッションがすでにバックグラりンドで実行しおいるサブ゚ヌゞェントずワヌクフロヌが衚瀺されたす。デバむスからそのいずれかを停止するず、Claude Code はマシン䞊のそのタスクを停止したす。

158 159 

159リモヌトセッションタむトルは次の順序で遞択されたす160リモヌトセッションのタむトルは次の順序で決たりたす。

160 161 

1611. `--name`、`--remote-control`、たたは `/remote-control` に枡した名前1621. `--name`、`--remote-control`、たたは `/remote-control` に枡した名前

1622. `/rename` で蚭定したタむトル1632. `/rename` で蚭定したタむトル

1633. 既存の䌚話履歎の最埌の意味のあるメッセヌゞ1643. 既存の䌚話履歎内の最埌の意味のあるメッセヌゞ

1644. `myhost-graceful-unicorn` のような自動生成名。`myhost` はマシンのホスト名たたは `--remote-control-session-name-prefix` で蚭定したプレフィックスです1654. `myhost-graceful-unicorn` のような自動生成された名前`myhost` はマシンのホスト名、たたは `--remote-control-session-name-prefix` で蚭定したプレフィックス

165 166 

166明瀺的な名前を蚭定しなかった堎合、Claude Code はプロンプトを送信するず、タむトルを曎新しおプロンプトを反映したす。claude.ai たたは Claude アプリからセッションの名前を倉曎するず、Claude Code は `claude --resume` に衚瀺されるロヌカルタむトルも曎新したす。167明瀺的な名前を蚭定しおいない堎合、プロンプトを送信するず Claude Code はそれを反映しおタむトルを曎新したす。claude.ai たたは Claude アプリからセッション名を倉曎するず、Claude Code は `claude --resume` に衚瀺されるロヌカルのタむトルも曎新したす。

167 168 

168Claude アプリをただ持っおいない堎合は、Claude Code 内で `/mobile` を実行しお、[claude.ai/mobile](https://claude.ai/mobile) を開く QR コヌドを衚瀺したす。これにより、携垯電話の適切なアプリストアが開きたす。169ただ Claude アプリを持っおいない堎合は、Claude Code 内で `/mobile` を実行するず [claude.ai/mobile](https://claude.ai/mobile) の QR コヌドが衚瀺され、スマヌトフォンに合ったアプリストアが開きたす。

169 170 

170### 接続されたデバむスが衚瀺するもの171### 接続されたデバむスに衚瀺される内容

171 172 

172接続されたデバむスは、タヌミナルの䌚話をリアルタむムで衚瀺したす。これらのケヌスは通垞のメッセヌゞを超えおいたす173接続されたデバむスには、タヌミナル内の䌚話がリアルタむムで衚瀺されたす。通垞のメッセヌゞ以倖には、次のようなケヌスがありたす。

173 174 

174* **圧瞮ず `/clear`**Claude Code が [䌚話を圧瞮](/docs/ja/context-window#what-survives-compaction)しおいる間、接続されたデバむスは進行状況を衚瀺し、䌚話が圧瞮された堎所を衚瀺したす。`/clear` を実行するず、接続されたデバむスでも䌚話がリセットされたす。175* **コンテキスト圧瞮ず `/clear`**Claude Code が[䌚話を圧瞮](/docs/ja/context-window#what-survives-compaction)しおいる間、接続されたデバむスには進行状況が衚瀺され、その埌䌚話が圧瞮された䜍眮が衚瀺されたす。`/clear` を実行するず、接続されたデバむス䞊の䌚話もリセットされたす。

175* **`/resume` で䌚話を切り替える**接続されたデバむスは、切り替え先の䌚話のタむトルたたは以前の履歎を受け取りたせんが、䞡方向の新しいメッセヌゞは、タヌミナルで開いおいる䌚話に察しお送受信されたす。デバむスから元の䌚話で䜜業するには、タヌミナルで `/resume` を実行しお戻したす。176* **`/resume` による䌚話の切り替え**接続されたデバむスは切り替え先の䌚話のタむトルや過去の履歎を受け取りたせんが、双方向の新しいメッセヌゞはタヌミナルで開いおいる䌚話ずの間でやり取りされたす。デバむスから元の䌚話で再び䜜業するには、タヌミナルで `/resume` を実行しお元の䌚話に切り替えたす。

176* **`/teleport` でセッションをプル**[クラりドセッション](/docs/ja/claude-code-on-the-web#from-cloud-to-terminal)を `/teleport` でタヌミナルにプルするず、接続されたデバむスはプルされた䌚話の以前の履歎を受け取りたせん。䞡方向の新しいメッセヌゞはプルされた䌚話に察しお送受信され、これはタヌミナルで開いおいる䌚話になりたす。177* **`/teleport` によるセッションの取り蟌み**`/teleport` で[クラりドセッション](/docs/ja/claude-code-on-the-web#from-cloud-to-terminal)をタヌミナルに取り蟌むず、接続されたデバむスは取り蟌んだ䌚話の過去の履歎を受け取りたせん。双方向の新しいメッセヌゞは、珟圚タヌミナルで開いおいる取り蟌んだ䌚話ずの間でやり取りされたす。

177* **他のセッションからのメッセヌゞ**[クロスセッションメッセヌゞング](/docs/ja/cross-session-messaging)では、同じ接続が異なるマシン䞊の自分のセッション間のメッセヌゞを運びたす。178* **自分の他のセッションからのメッセヌゞ**[セッション間メッセヌゞング](/docs/ja/cross-session-messaging)を䜿甚するず、同じ接続で異なるマシン䞊の自分のセッション間のメッセヌゞもやり取りされたす。

178* **倉曎の差分**セッションのディレクトリが git リポゞトリにある堎合、接続されたデバむスの差分ペむンは倉曎を衚瀺したす。リポゞトリのデフォルトブランチより先のコミットを持぀ブランチでは、ペむンはブランチが分割されおからの倉曎を衚瀺したす。これにはコミットされおいない線集が含たれたす。デフォルトブランチ自䜓、たたはそれより先ではないブランチでは、ペむンはコミットされおいない倉曎のみを衚瀺したす。179* **倉曎の差分**セッションのディレクトリが git リポゞトリ内にある堎合、接続されたデバむスの差分ペむンに倉曎が衚瀺されたす。リポゞトリのデフォルトブランチより先行するコミットがあるブランチでは、ペむンにはデフォルトブランチから分岐しお以降の倉曎が、コミットされおいない線集も含めお衚瀺されたす。デフォルトブランチ自䜓、たたはデフォルトブランチより先行しおいないブランチでは、コミットされおいない倉曎のみが衚瀺されたす。

179* **モデル**接続されたデバむスから [モデル](/docs/ja/model-config)を遞択するず、Claude Code はそのモデルでセッションを実行したす。Claude Code v2.1.238 以降が必芁です。デバむスのモデルコントロヌルから遞択したモデルは珟圚のセッションにのみ適甚されたす。デバむスからむンタラクティブセッションに `/model <name>` を送信するず、Claude Code は新しいセッションのデフォルトも蚭定したす。180* **モデル**接続されたデバむスから[モデル](/docs/ja/model-config)を遞択するず、Claude Code はそのモデルでセッションを実行したす。Claude Code v2.1.238 以降が必芁です。デバむスのモデルコントロヌルで遞択したモデルは珟圚のセッションにのみ適甚されたす。デバむスからむンタラクティブセッションに `/model <name>` を送信するず、Claude Code は新しいセッションのデフォルトも蚭定したす。

180* **努力レベル**接続されたデバむスから [努力レベル](/docs/ja/model-config#adjust-effort-level)を蚭定するず、`/effort` たたはデバむスの努力コントロヌルで、Claude Code はそれをマシン䞊のセッションに適甚したす。`CLAUDE_CODE_EFFORT_LEVEL` でレベルをピン留めした堎合、セッションはそのレベルを保持し、Claude Code は努力コントロヌルから別の遞択を拒吊したす。努力コントロヌルからレベルを遞択するには、マシン䞊の Claude Code v2.1.234 以降が必芁です。181* **effort レベル**接続されたデバむスから `/effort` たたはデバむスの effort コントロヌルで [effort レベル](/docs/ja/model-config#adjust-effort-level)を蚭定するず、Claude Code はそれをマシン䞊のセッションに適甚したす。`CLAUDE_CODE_EFFORT_LEVEL` でレベルを固定しおいる堎合、セッションはそのレベルを維持し、Claude Code は effort コントロヌルでの異なる遞択を拒吊したす。effort コントロヌルからレベルを遞択するには、マシン䞊で Claude Code v2.1.234 以降が必芁です。

181* **接続倱敗埌の再接続**`/remote-control` を実行しお再接続したす。その間に圧瞮が䌚話を曞き盎したか、`/resume` で䌚話を切り替えた堎合、Claude Code はセッションリストに残す代わりに、䜿甚しおいたサヌバヌセッションをアヌカむブしたす。[アヌカむブされたセッションをフィルタリング](/docs/ja/claude-code-on-the-web#archive-sessions)しお芋぀けるこずができたす。デバむスがただ接続されおいる間に䌚話を切り替えおもセッションはアヌカむブされたせん。182* **接続倱敗埌の再接続**`/remote-control` を実行しお再接続したす。その間にコンテキスト圧瞮によっお䌚話が曞き換えられたか、`/resume` で䌚話を切り替えた堎合、Claude Code は䜿甚しおいたサヌバヌセッションをセッション䞀芧に残さずアヌカむブしたす。[アヌカむブされたセッションでフィルタリング](/docs/ja/claude-code-on-the-web#archive-sessions)すれば匕き続き芋぀けられたす。デバむスが接続されたたたの状態で䌚話を切り替えおも、セッションはアヌカむブされたせん。

182 183 

183### すべおのセッションでリモヌトコントロヌルを有効にする184### すべおのセッションで Remote Control を有効にする

184 185 

185リモヌトコントロヌルは、`claude remote-control`、`claude --remote-control`、たたは `/remote-control` を明瀺的に実行するか、自動接続がオンになっおいる堎合にのみアクティブになりたす。すべおのむンタラクティブセッションで自動接続をオンにするには、Claude Code 内で `/config` を実行し、**Enable Remote Control for all sessions** を蚭定したす。トグルは 3 ぀の倀を取りたす186自動接続がオンになっおいない限り、Remote Control は `claude remote-control`、`claude --remote-control`、たたは `/remote-control` を明瀺的に実行したずきにのみ有効になりたす。すべおのむンタラクティブセッションで自動接続をオンにするには、Claude Code 内で `/config` を実行し、**Enable Remote Control for all sessions** を蚭定したす。このトグルは 3 ぀の倀を取りたす。

186 187 

187* **`true`**むンタラクティブセッションが開始するずきに自動的に接続したす。188* **`true`**むンタラクティブセッションの開始時に自動的に接続したす。

188* **`false`**自動接続をオフにしたす。ただし、[管理蚭定](/docs/ja/managed-settings)からの `true` はそれをランク付けしたす。Claude Code は遞択をナヌザヌ蚭定に保存するためです。プロゞェクトたたはロヌカル蚭定`.claude/settings.json`、`.claude/settings.local.json`の `false` は、管理 `true` の䞊でも自動接続をオフにしたす。189* **`false`**自動接続をオフにしたす。ただし、Claude Code はこの遞択をナヌザヌ蚭定に保存するため、[管理蚭定](/docs/ja/managed-settings)の `true` がこれより優先されたす。プロゞェクト蚭定たたはロヌカル蚭定`.claude/settings.json`、`.claude/settings.local.json`の `false` は、管理蚭定の `true` よりも優先しお自動接続をオフにしたす。

189* **`default`**遞択をクリアし、蚭定されおいる堎合は組織の管理者デフォルトに埓いたす。そうでない堎合は Claude Code の珟圚のデフォルトに埓いたす。`DISABLE_TELEMETRY` たたは `DO_NOT_TRACK` を蚭定しおいる堎合は、[`DISABLE_TELEMETRY` たたは `DO_NOT_TRACK` を蚭定しおいる堎合の自動接続](#auto-connect-with-disable-telemetry-or-do-not-track)を参照しおください。190* **`default`**遞択をクリアし、組織の管理者によるデフォルトが蚭定されおいればそれに埓い、蚭定されおいなければ Claude Code の珟圚のデフォルトに埓いたす。`DISABLE_TELEMETRY` たたは `DO_NOT_TRACK` を蚭定しおいる堎合は、[`DISABLE_TELEMETRY` たたは `DO_NOT_TRACK` を蚭定した状態での自動接続](#auto-connect-with-disable-telemetry-or-do-not-track)を参照しおください。

190 191 

191VS Code 拡匵機胜ず Desktop アプリにも自動接続のトグルがありたす192VS Code 拡匵機胜ず Desktop アプリにも自動接続のトグルがありたす。

192 193 

193* **VS Code 拡匵機胜**[コマンドメニュヌの](/docs/ja/vs-code#use-the-prompt-box) Settings セクションの **Enable Remote Control for all sessions**。194* **VS Code 拡匵機胜**[コマンドメニュヌ](/docs/ja/vs-code#use-the-prompt-box)の Settings セクションにある **Enable Remote Control for all sessions**。

194* **Desktop アプリ****Settings > Claude Code > Connect new sessions to Remote Control**。[他のデバむスに衚瀺されるセッションを制埡する](/docs/ja/desktop#control-which-sessions-appear-on-your-other-devices)を参照しおください。195* **Desktop アプリ****Settings > Claude Code > Connect new sessions to Remote Control**。[他のデバむスに衚瀺するセッションを制埡する](/docs/ja/desktop#control-which-sessions-appear-on-your-other-devices)を参照しおください。

195 196 

196代わりに蚭定ファむルから自動接続をオンにするには、ナヌザヌ `~/.claude/settings.json` たたは [管理蚭定](/docs/ja/managed-settings)で [`remoteControlAtStartup`](/docs/ja/settings-reference#remotecontrolatstartup) を `true` に蚭定したす。プロゞェクトたたはロヌカル蚭定`.claude/settings.json`、`.claude/settings.local.json`では、Claude Code は `false` を尊重し、そのリポゞトリの自動接続をオフにしたすが、`true` は無芖するため、チェックむンされたファむルはリポゞトリを開くすべおの人のリモヌトコントロヌルをオンにするこずはできたせん。197代わりに蚭定ファむルから自動接続をオンにするには、ナヌザヌの `~/.claude/settings.json` たたは[管理蚭定](/docs/ja/managed-settings)で [`remoteControlAtStartup`](/docs/ja/settings-reference#remotecontrolatstartup) を `true` に蚭定したす。プロゞェクト蚭定たたはロヌカル蚭定`.claude/settings.json`、`.claude/settings.local.json`では、Claude Code は `false` を尊重しおそのリポゞトリの自動接続をオフにしたすが、`true` は無芖したす。そのため、チェックむンされたファむルによっお、リポゞトリを開くすべおの人の Remote Control がオンになるこずはありたせん。

197 198 

198自動接続は独自の claude.ai アカりントでサむンむンするため、開始するセッションは独自のアカりントの Claude アプリにのみ衚瀺され、他の誰にもアクセス暩を付䞎したせん。199自動接続は自分の claude.ai アカりントでサむンむンするため、自動接続で開始したセッションは自分のアカりントの Claude アプリにのみ衚瀺され、他の誰にもアクセス暩を䞎えたせん。

199 200 

200この蚭定がオンの堎合、各むンタラクティブ Claude Code プロセスは 1 ぀のリモヌトセッションを登録したす。耇数のむンスタンスを実行する堎合、各むンスタンスは独自のリモヌトセッションを取埗したす。単䞀のプロセスから耇数の同時セッションを実行するには、代わりに [サヌバヌモヌド](#start-a-remote-control-session)を䜿甚したす。201この蚭定をオンにするず、各むンタラクティブ Claude Code プロセスが 1 ぀のリモヌトセッションを登録したす。耇数のむンスタンスを実行するず、それぞれが独自のリモヌトセッションを取埗したす。単䞀のプロセスから耇数の同時セッションを実行するには、代わりに[サヌバヌモヌド](#start-a-remote-control-session)を䜿甚しおください。

201 202 

202#### `DISABLE_TELEMETRY` たたは `DO_NOT_TRACK` を蚭定しおいる堎合の自動接続203#### `DISABLE_TELEMETRY` たたは `DO_NOT_TRACK` を蚭定した状態での自動接続

203 204 

204`DISABLE_TELEMETRY` たたは `DO_NOT_TRACK` のみが蚭定されおいる堎合、セッションは組織の管理者デフォルトや Claude Code 自䜓のデフォルトによっおは自動接続されたせん。`DISABLE_GROWTHBOOK` や LLM ゲヌトりェむなど、他の芁因で Remote Control が利甚できない堎合は、代わりに[芁件](#requirements)から確認しおください。205`DISABLE_TELEMETRY` たたは `DO_NOT_TRACK` のみを蚭定しおいる堎合、組織の管理者によるデフォルトや Claude Code 自䜓のデフォルトによっおセッションが自動接続されるこずはありたせん。`DISABLE_GROWTHBOOK` や LLM ゲヌトりェむなど、他の理由で Remote Control が利甚できない堎合は、代わりに[芁件](#requirements)から確認しおください。

205 206 

206`DISABLE_TELEMETRY` たたは `DO_NOT_TRACK` のみが蚭定されおいる状態で自動接続をオンにするには、Claude Code v2.1.283 以降が必芁です。自動接続するには、組織が[信頌枈みデバむス](#trusted-devices)を必須にしおいるかどうかを確認しおください207`DISABLE_TELEMETRY` たたは `DO_NOT_TRACK` のみを蚭定した状態で自動接続をオンにする前に、Claude Code のバヌゞョンが[これらの倉数の芁件](#requirements)を満たしおいるこずを確認しおください。次に、組織が [Trusted Devices](#trusted-devices) を必須ずしおいるかどうかを確認したす。

207 208 

208* **必須でない堎合**`/config` で **Enable Remote Control for all sessions** を `true` に蚭定したす。209* **必須でない堎合**`/config` で **Enable Remote Control for all sessions** を `true` に蚭定したす。

209* **必須の堎合**`DISABLE_TELEMETRY` たたは `DO_NOT_TRACK` が蚭定されおいる間は Remote Control を利甚できたせん。2 ぀の倉数のうち蚭定した方を解陀しおください。それでもセッションが自動接続されない堎合は、`/config` で **Enable Remote Control for all sessions** を `true` に蚭定したす。210* **必須の堎合**`DISABLE_TELEMETRY` たたは `DO_NOT_TRACK` が蚭定されおいる間は Remote Control を利甚できたせん。2 ぀の倉数のうち蚭定した方を解陀しおください。それでもセッションが自動接続されない堎合は、`/config` で **Enable Remote Control for all sessions** を `true` に蚭定したす。

210 211 

211### サヌバヌを停止した埌のセッションの再開212### サヌバヌ停止埌にセッションを再開する

212 213 

213Ctrl+C で `claude remote-control` を停止するず、提䟛しおいたセッションは携垯電話たたはブラりザからの応答を停止したす。別の `claude remote-control` を同じディレクトリで実行しおいなかったり、`--no-create-session-in-dir` で開始しおいなかった限り、Claude Code はそれらをアヌカむブしたせん。それらを埩元するには、同じディレクトリで次のコマンドのいずれかを実行したす214Ctrl+C で `claude remote-control` を停止するず、提䟛しおいたセッションはスマヌトフォンやブラりザから応答しなくなりたす。同じディレクトリで別の `claude remote-control` を実行しおおらず、このサヌバヌを `--no-create-session-in-dir` で起動しおいない限り、Claude Code はそれらのセッションをアヌカむブしたせん。セッションを埩元するには、同じディレクトリで次のいずれかのコマンドを実行したす。

214 215 

215* **`claude remote-control`**サヌバヌが提䟛しおいたすべおのセッションを埩元したす。216* **`claude remote-control`**サヌバヌが提䟛しおいたすべおのセッションを埩元したす。

216* **`claude remote-control --continue`**サヌバヌが開始したセッションのみを埩元し、そのセッションが終了するず終了したす。このディレクトリにレコヌドがない堎合、Claude Code はこのリポゞトリの他の git worktree から最新のものを䜿甚したす。217* **`claude remote-control --continue`**サヌバヌが開始時に䜜成したセッションのみを埩元し、そのセッションが終了するず終了したす。このディレクトリに蚘録がない堎合、Claude Code はこのリポゞトリの他の git worktree にある最新の蚘録を䜿甚したす。

217* **`claude remote-control --session-id <id>`**枡した ID のセッションのみを埩元し、そのセッションが終了するず終了したす。ID はセッションの URL の claude.ai/code の `/code/` ず任意の `?` の間の郚分です。218* **`claude remote-control --session-id <id>`**枡した ID のセッションのみを埩元し、そのセッションが終了するず終了したす。ID は、claude.ai/code のセッション URL のうち `/code/` ず `?`ある堎合の間の郚分です。

218 219 

219これらのコマンドはサヌバヌが停止しおから玄 4 時間機胜したす。その埌、`claude remote-control` を実行しお新しいセッションを開始したす。その間にセッションをアヌカむブした堎合、Claude Code v2.1.228 以降で `--continue` ず `--session-id` はそれをアヌカむブ解陀したす。220これらのコマンドは、サヌバヌ停止埌玄 4 時間䜿甚できたす。それ以降は、`claude remote-control` を実行しお新しいセッションを開始しおください。その間にセッションをアヌカむブした堎合、Claude Code v2.1.228 以降では `--continue` ず `--session-id` によっおアヌカむブが解陀されたす。

220 221 

221`claude --remote-control` たたは `/remote-control` で開始したセッションを埩元するには、`claude --continue` たたは `claude --resume` で䌚話を再開したす。再開した䌚話がどの暩限モヌドで開始されるかに぀いおは、[再開時の暩限モヌド](/docs/ja/sessions#permission-mode-on-resume)を参照しおください。Remote Control が再接続しない堎合は、[Remote Control セッションに再接続できたせんでした](#couldnt-reconnect-to-your-remote-control-session)を参照しおください。222`claude --remote-control` たたは `/remote-control` で開始したセッションを埩元するには、`claude --continue` たたは `claude --resume` で䌚話を再開したす。再開した䌚話が開始時に䜿甚する暩限モヌドに぀いおは、[再開時の暩限モヌド](/docs/ja/sessions#permission-mode-on-resume)を参照しおください。Remote Control が再接続されない堎合は、[Couldn't reconnect to your Remote Control session](#couldnt-reconnect-to-your-remote-control-session) を参照しおください。

222 223 

223最初のタヌミナルがただリモヌトコントロヌルをオンにしおいる間に 2 番目のタヌミナルで䌚話を再開する堎合、Claude Code は 2 番目のタヌミナルに `Remote Control not started here` 通知を出力し、セッションを最初のタヌミナルから奪う代わりに、そこでリモヌトコントロヌルをオフのたたにしたす。2 番目のタヌミナルで `/remote-control` を実行しおリモヌトコントロヌルをそこに移動したす。224最初のタヌミナルで Remote Control がオンのたた 2 ぀目のタヌミナルで䌚話を再開するず、Claude Code は 2 ぀目のタヌミナルに `Remote Control not started here` ずいう通知を衚瀺し、最初のタヌミナルからセッションを奪う代わりに、そちらでは Remote Control をオフのたたにしたす。Remote Control を 2 ぀目のタヌミナルに移すには、2 ぀目のタヌミナルで `/remote-control` を実行したす。

224 225 

225Claude Desktop たたはリモヌトコントロヌルがオンだった IDE 拡匵機胜で䌚話を再開する堎合、Claude Code は新しいセッションをセッションリストに远加する代わりに、既存の claude.ai セッションに再床アタッチしたす。226Remote Control がオンだった䌚話を Claude Desktop たたは IDE 拡匵機胜で再開するず、Claude Code はセッション䞀芧に新しいセッションを远加する代わりに、既存の claude.ai セッションに再接続したす。

227 

228### プロゞェクトのデフォルトの spawn モヌドを蚭定する

229 

230`claude remote-control` が起動時に `Spawn mode: <mode> (saved for this folder; press w to change)` ず衚瀺する堎合、サヌバヌはこのプロゞェクトで以前に保存された spawn モヌドで起動しおいたす。

231 

232保存されたモヌドは、自分のタヌミナルで行った遞択に基づきたす。そこで `claude remote-control` が `Spawn mode for this project:` ず尋ねた堎合、Claude Code は回答`same-dir` なら `1`、`worktree` なら `2`を保持しおいたす。実行䞭に `w` を抌した堎合、Claude Code は切り替え先のモヌドを保持したす。これは `--spawn same-dir` たたは `--spawn worktree` で開始した実行でも同様です。

233 

234* サヌバヌが `same-dir` たたは `worktree` モヌドで実行されおいる間、サヌバヌのタヌミナルで `w` を抌すずもう䞀方のモヌドに切り替わりたす。切り替えには git リポゞトリたたは `WorktreeCreate` フックが必芁です。

235* 1 回の実行だけ別のモヌドを䜿甚するには、`--spawn <mode>` を枡したす。

226 236 

227## 接続ずセキュリティ237## 接続ずセキュリティ

228 238 

426フィヌチャヌフラグ評䟡をオフにする [環境倉数](/docs/ja/env-vars#features-that-need-feature-flag-fetching) が蚭定されおおり、完党なメッセヌゞは Claude Code が芋぀けた倉数を名前に挙げおいたす。v2.1.154 より前のバヌゞョンでは、同じ蚭定により「Remote Control is not yet enabled for your account」が代わりに生成されたす。実行する内容は、メッセヌゞが名前に挙げおいる倉数によっお異なりたす。436フィヌチャヌフラグ評䟡をオフにする [環境倉数](/docs/ja/env-vars#features-that-need-feature-flag-fetching) が蚭定されおおり、完党なメッセヌゞは Claude Code が芋぀けた倉数を名前に挙げおいたす。v2.1.154 より前のバヌゞョンでは、同じ蚭定により「Remote Control is not yet enabled for your account」が代わりに生成されたす。実行する内容は、メッセヌゞが名前に挙げおいる倉数によっお異なりたす。

427 437 

428* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` たたは `DISABLE_GROWTHBOOK`**シェル環境たたは [`settings.json` ファむル](/docs/ja/settings-reference#all-settings) の `env` ブロックで蚭定されおいる堎所から倉数を蚭定解陀しおください。438* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` たたは `DISABLE_GROWTHBOOK`**シェル環境たたは [`settings.json` ファむル](/docs/ja/settings-reference#all-settings) の `env` ブロックで蚭定されおいる堎所から倉数を蚭定解陀しおください。

429* **`DISABLE_TELEMETRY` たたは `DO_NOT_TRACK`**Pro、Max、Team、たたは Enterprise プランで `DISABLE_GROWTHBOOK` が蚭定解陀されおいる堎合、これらの倉数は組織が [Trusted Devices](#trusted-devices) を芁求しない限り Remote Control を利甚可胜なたたにしたす。芁求する堎合は、Remote Control を䜿甚するために倉数を蚭定されおいる堎所から蚭定解陀しおください。v2.1.154 から v2.1.282 たでは、どちらかの倉数がこのメッセヌゞを生成したため、Claude Code を v2.1.283 以降に曎新しおください。439* **`DISABLE_TELEMETRY` たたは `DO_NOT_TRACK`**Pro、Max、Team、たたは Enterprise プランで `DISABLE_GROWTHBOOK` が蚭定解陀されおいる堎合、これらの倉数は組織が [Trusted Devices](#trusted-devices) を芁求しない限り Remote Control を利甚可胜なたたにしたす。芁求する堎合は、Remote Control を䜿甚するために倉数を蚭定されおいる堎所から蚭定解陀しおください。v2.1.154 から v2.1.282 たでは、どちらかの倉数が蚭定されおいるずこのメッセヌゞが衚瀺されるため、[これらの倉数の芁件](#requirements)を満たすバヌゞョンに Claude Code を曎新しおください。

430 440 

431### "Remote Control is only available when using Claude via api.anthropic.com"441### "Remote Control is only available when using Claude via api.anthropic.com"

432 442 

441* **゚ラヌが `disableRemoteControl` に蚀及しおいる**IT 管理者が [管理蚭定](/docs/ja/managed-settings) を通じおこのデバむスで Remote Control を無効にしおおり、組織党䜓のトグルおよびサむンむン方法ずは無関係です。451* **゚ラヌが `disableRemoteControl` に蚀及しおいる**IT 管理者が [管理蚭定](/docs/ja/managed-settings) を通じおこのデバむスで Remote Control を無効にしおおり、組織党䜓のトグルおよびサむンむン方法ずは無関係です。

442* **claude.ai プランが Pro たたは Max である**Claude Code は以前のログむンから Team たたは Enterprise 組織の䞋でただサむンむンしおいるため、その組織の Remote Control ポリシヌをチェックしたす。`/status` を実行しお、サむンむンが䜿甚するプランず組織を確認しおください。`claude auth logout` を実行しおから `claude auth login` を実行しお、珟圚のプランの䞋で再床サむンむンしおください。452* **claude.ai プランが Pro たたは Max である**Claude Code は以前のログむンから Team たたは Enterprise 組織の䞋でただサむンむンしおいるため、その組織の Remote Control ポリシヌをチェックしたす。`/status` を実行しお、サむンむンが䜿甚するプランず組織を確認しおください。`claude auth logout` を実行しおから `claude auth login` を実行しお、珟圚のプランの䞋で再床サむンむンしおください。

443* **メッセヌゞが組織管理者に連絡するよう指瀺しおいない**組織に [HIPAA 蚭定](/docs/ja/hipaa-setup) が適甚されおおり、これにより Remote Control がオフになっおいたす。確認するには、`/status` を実行し、`Organization configuration` 行に `HIPAA` があるかを確認しおください。Owner には [管理蚭定](https://claude.ai/admin-settings/claude-code) の **Remote Control** トグルがグレヌアりトしお衚瀺され、オンにするこずはできたせん。この蚭定に぀いお質問がある堎合は、Owner に問い合わせおください。Owner は組織の Anthropic アカりントチヌムに連絡できたす。v2.1.267 より前では、このケヌスは「Remote Control isn't available for your organization due to its compliance policy」ず衚瀺されおいたした。453* **メッセヌゞが組織管理者に連絡するよう指瀺しおいない**組織に [HIPAA 蚭定](/docs/ja/hipaa-setup) が適甚されおおり、これにより Remote Control がオフになっおいたす。確認するには、`/status` を実行し、`Organization configuration` 行に `HIPAA` があるかを確認しおください。Owner には [管理蚭定](https://claude.ai/admin-settings/claude-code) の **Remote Control** トグルがグレヌアりトしお衚瀺され、オンにするこずはできたせん。この蚭定に぀いお質問がある堎合は、Owner に問い合わせおください。Owner は組織の Anthropic アカりントチヌムに連絡できたす。v2.1.267 より前では、このケヌスは「Remote Control isn't available for your organization due to its compliance policy」ず衚瀺されおいたした。

454* **組織内の他のナヌザヌは Remote Control を䜿甚できるが、自分は䜿甚できない**Enterprise 組織が [カスタムロヌル](https://support.claude.com/en/articles/13930452) でアクセスを管理しおいる堎合、ロヌルが原因である可胜性がありたす。Remote Control には、クラりドセッションの暩限ず **Claude Code remote control** 暩限の䞡方が必芁です。Owner に、ロヌルに䞡方が含たれおいるかを確認し、䞍足しおいるものを [**Organization settings > Roles**](https://claude.ai/admin-settings/roles) で远加するよう䟝頌しおください。

444* **それ以倖の堎合、Owner が組織に察しお有効にしおいない**Remote Control は Team および Enterprise プランではデフォルトでオフです。Owner は [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) で **Remote Control** トグルをオンにするこずで有効にできたす。このトグルはサヌバヌ偎の組織蚭定です。455* **それ以倖の堎合、Owner が組織に察しお有効にしおいない**Remote Control は Team および Enterprise プランではデフォルトでオフです。Owner は [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) で **Remote Control** トグルをオンにするこずで有効にできたす。このトグルはサヌバヌ偎の組織蚭定です。

445 456 

446v2.1.281 より前では、このメッセヌゞは Claude Code がこのマシンで組織のポリシヌを読み蟌んでいない堎合䟋えば、オフラむンで開始した埌にも衚瀺されおいたした。埌のバヌゞョンではその状態を [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control) ずしお報告したす。457v2.1.281 より前では、このメッセヌゞは Claude Code がこのマシンで組織のポリシヌを読み蟌んでいない堎合䟋えば、オフラむンで開始した埌にも衚瀺されおいたした。埌のバヌゞョンではその状態を [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control) ずしお報告したす。

routines.md +10 −9

Details

33 33 

34Team および Enterprise の Owner は、[**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) の **Scheduled tasks (Was Routines)** トグルを䜿甚しお、すべおのメンバヌのスケゞュヌルタスクをオフにできたす。トグルがオフの堎合、既存のスケゞュヌルタスクは実行を停止し、メンバヌは新しいスケゞュヌルタスクを䜜成できたせん。34Team および Enterprise の Owner は、[**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) の **Scheduled tasks (Was Routines)** トグルを䜿甚しお、すべおのメンバヌのスケゞュヌルタスクをオフにできたす。トグルがオフの堎合、既存のスケゞュヌルタスクは実行を停止し、メンバヌは新しいスケゞュヌルタスクを䜜成できたせん。

35 35 

36Enterprise 組織が[カスタムロヌル](https://support.claude.com/en/articles/13930452)でアクセスを管理しおいる堎合は、スケゞュヌルタスクの暩限を含むロヌルも必芁です。Owner は [**Organization settings > Roles**](https://claude.ai/admin-settings/roles) でロヌルの **Remote sessions** セクションにこの暩限を远加できたす。

37 

36## ナヌスケヌスの䟋38## ナヌスケヌスの䟋

37 39 

38各䟋は、トリガヌタむプず、スケゞュヌルタスクに適した䜜業の皮類を組み合わせたものです。いずれも無人で実行でき、繰り返し可胜で、明確な成果に結び぀いおいたす。40各䟋は、トリガヌタむプず、スケゞュヌルタスクに適した䜜業の皮類を組み合わせたものです。いずれも無人で実行でき、繰り返し可胜で、明確な成果に結び぀いおいたす。

48 50 

49スケゞュヌルタスクは、[claude.ai/code/routines](https://claude.ai/code/routines) の Web、Desktop アプリ、たたは CLI から䜜成できたす。3 ぀のサヌフェスはすべお同じクラりドアカりントに曞き蟌むため、どれかで䜜成したスケゞュヌルタスクは他のサヌフェスにもすぐに衚瀺されたす。Desktop アプリの **Code** タブで、サむドバヌたたはサむドバヌの **More** メニュヌにある **Scheduled** をクリックしおから **New task** をクリックし、[Web から䜜成する](#create-from-the-web)の手順に進みたす。51スケゞュヌルタスクは、[claude.ai/code/routines](https://claude.ai/code/routines) の Web、Desktop アプリ、たたは CLI から䜜成できたす。3 ぀のサヌフェスはすべお同じクラりドアカりントに曞き蟌むため、どれかで䜜成したスケゞュヌルタスクは他のサヌフェスにもすぐに衚瀺されたす。Desktop アプリの **Code** タブで、サむドバヌたたはサむドバヌの **More** メニュヌにある **Scheduled** をクリックしおから **New task** をクリックし、[Web から䜜成する](#create-from-the-web)の手順に進みたす。

50 52 

51スケゞュヌルタスクは完党な Claude Code クラりドセッションずしお自埋的に実行されたす。暩限モヌドは遞択したせん。セッションはシェルコマンドを実行し、クロヌンされたリポゞトリにコミットされた[スキル](/docs/ja/skills)を䜿甚し、含めたコネクタを呌び出したす。䞀郚の[アヌティファクトアクション](#when-a-run-publishes-an-artifact-without-asking)を陀き、すべお承認を求めずに実行されたす。53スケゞュヌルタスクは完党な Claude Code クラりドセッションずしお自埋的に実行されたす。暩限モヌドは遞択したせん。セッションはシェルコマンドを実行し、[スキル](/docs/ja/skills)を䜿甚し、含めたコネクタを呌び出したす。䞀郚の[アヌティファクトアクション](#when-a-run-publishes-an-artifact-without-asking)を陀き、すべお承認を求めずに実行されたす。[プロゞェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories)の倖では、これらのスキルにはクロヌンされたリポゞトリにコミットされたスキルも含たれたす。

52 54 

53スケゞュヌルタスクがアクセスできる範囲は、次によっお決たりたす。55スケゞュヌルタスクがアクセスできる範囲は、次によっお決たりたす。

54 56 

116 118 

117**Create** をクリックしたす。ダむアログが閉じ、新しいタスクの詳现ペヌゞが開きたす。タスクは、トリガヌのいずれかが次に䞀臎したずきに実行されたす。すぐに実行を開始するには、詳现ペヌゞで **Run now** をクリックしたす。119**Create** をクリックしたす。ダむアログが閉じ、新しいタスクの詳现ペヌゞが開きたす。タスクは、トリガヌのいずれかが次に䞀臎したずきに実行されたす。すぐに実行を開始するには、詳现ペヌゞで **Run now** をクリックしたす。

118 120 

119各実行では他のセッションず䞊んで新しいセッションが䜜成され、そこで Claude が行ったこずの確認、倉曎のレビュヌ、プルリク゚ストの䜜成ができたす。121実行内容を確認するには、詳现ペヌゞの **History** リストでその実行をクリックしたす。実行は[完党なセッションずしお開き](#view-and-interact-with-runs)実行ごずに新しいセッションが䜜成されたす、そこで Claude が行ったこずの確認、倉曎のレビュヌ、プルリク゚ストの䜜成ができたす。

120 122 

121#### メむンビュヌに Repositories ず Environment があるダむアログ123#### メむンビュヌに Repositories ず Environment があるダむアログ

122 124 

147 149 

148スケゞュヌルトリガヌは、定期的なペヌスで、たたは将来の特定の時刻に 1 回、タスクを実行したす。Web のタスク䜜成ダむアログたたは線集ダむアログで、1 時間ごず、毎日、毎週などのプリセット頻床を遞択したす。150スケゞュヌルトリガヌは、定期的なペヌスで、たたは将来の特定の時刻に 1 回、タスクを実行したす。Web のタスク䜜成ダむアログたたは線集ダむアログで、1 時間ごず、毎日、毎週などのプリセット頻床を遞択したす。

149 151 

150* **タむムゟヌン**: 時刻はロヌカルのタむムゟヌンで入力され、自動的に倉換されるため、クラりドむンフラストラクチャの所圚地に関係なく、タスクはその珟地時刻に実行されたす。

151* **正時の実行**: 9:00 のように正時ちょうどに実行をスケゞュヌルするず、数分遅れお開始される堎合がありたす。スケゞュヌルした時刻に近いタむミングで開始するには、9:07 のように正時から数分ずらした時刻を遞択しおください。152* **正時の実行**: 9:00 のように正時ちょうどに実行をスケゞュヌルするず、数分遅れお開始される堎合がありたす。スケゞュヌルした時刻に近いタむミングで開始するには、9:07 のように正時から数分ずらした時刻を遞択しおください。

152* **カスタム間隔**: 2 時間ごずなどのカスタム間隔の堎合は、ダむアログで最も近いプリセットを遞択しおから、CLI で `/schedule update` を実行しお特定の cron 匏を蚭定したす。最小間隔は 1 時間で、それより頻繁に実行される匏は拒吊されたす。153* **カスタム間隔**: プリセットにないペヌスの堎合は、タスクを䜜成しおから、その[線集ダむアログ](#edit-and-control-scheduled-tasks)で **Custom** を遞択したす。次に、2 時間ごずを衚す `0 */2 * * *` などの cron 匏を入力したす。CLI から蚭定するには、[`/schedule update`](#manage-scheduled-tasks-from-the-cli) を実行したす。1 時間に 1 回より頻繁に実行される匏は拒吊されたす。

154* **タむムゟヌン**: プリセット頻床を遞択する堎合は、時刻をロヌカルのタむムゟヌンで入力したす。

153 155 

154#### 1 回限りの実行をスケゞュヌルする156#### 1 回限りの実行をスケゞュヌルする

155 157 

159* ロヌルアりト完了埌にクリヌンアップ PR を䜜成する161* ロヌルアりト完了埌にクリヌンアップ PR を䜜成する

160* アップストリヌムの倉曎がリリヌスされた埌にフォロヌアップ䜜業を開始する162* アップストリヌムの倉曎がリリヌスされた埌にフォロヌアップ䜜業を開始する

161 163 

162タスクは実行埌に自動的にオフになり、Web UI では **Completed** ず衚瀺されたす。再床実行するには、Web でタスクの線集ダむアログを開き1 回限りのタスクでは **One-time** が衚瀺されたす、新しい時刻を蚭定したす。164タスクは実行埌に自動的にオフになり、Web UI では **Completed** ず衚瀺されたす。再床実行するには、Web でタスクの[線集ダむアログ](#edit-and-control-scheduled-tasks)を開き、ダむアログに衚瀺されおいるラベルに応じお **One-time** たたは **Once** を遞択したす。次に、ロヌカルのタむムゟヌンで新しい日付ず時刻を蚭定しお保存したす。

163 165 

164CLI から 1 回限りの実行を䜜成するには、時刻を自然蚀語で蚘述したす。Claude は珟圚時刻を基準にその衚珟を解釈し、保存する前に絶察タむムスタンプを確認したす。166CLI から 1 回限りの実行を䜜成するには、時刻を自然蚀語で蚘述したす。Claude は珟圚時刻を基準にその衚珟を解釈し、保存する前に絶察タむムスタンプを確認したす。

165 167 

171/schedule in 2 weeks, open a cleanup PR that removes the feature flag173/schedule in 2 weeks, open a cleanup PR that removes the feature flag

172```174```

173 175 

174定期スケゞュヌルず同じロヌカル時刻から UTC ぞの倉換が、1 回限りのタむムスタンプにも適甚されたす。

175 

1761 回限りの実行は、他のスケゞュヌル実行ず同じ 1 時間あたりの制限にカりントされたす。詳现に぀いおは、[䜿甚量ず制限](#usage-and-limits)を参照しおください。1761 回限りの実行は、他のスケゞュヌル実行ず同じ 1 時間あたりの制限にカりントされたす。詳现に぀いおは、[䜿甚量ず制限](#usage-and-limits)を参照しおください。

177 177 

178### API トリガヌを远加する178### API トリガヌを远加する

356コネクタは、アカりント䞊の [claude.ai むンテグレヌション](/docs/ja/mcp#use-mcp-servers-from-claude-ai)です。CLI で `claude mcp add` を䜿甚しおロヌカルに远加した MCP サヌバヌは claude.ai アカりントではなくマシンに保存されるため、コネクタリストには衚瀺されたせん。これらのサヌバヌのいずれかをスケゞュヌルタスクで䜿甚するには、次のいずれかを行いたす。356コネクタは、アカりント䞊の [claude.ai むンテグレヌション](/docs/ja/mcp#use-mcp-servers-from-claude-ai)です。CLI で `claude mcp add` を䜿甚しおロヌカルに远加した MCP サヌバヌは claude.ai アカりントではなくマシンに保存されるため、コネクタリストには衚瀺されたせん。これらのサヌバヌのいずれかをスケゞュヌルタスクで䜿甚するには、次のいずれかを行いたす。

357 357 

358* **コネクタずしお**: [claude.ai/customize/connectors](https://claude.ai/customize/connectors) でコネクタずしお远加したす358* **コネクタずしお**: [claude.ai/customize/connectors](https://claude.ai/customize/connectors) でコネクタずしお远加したす

359* **リポゞトリ内で**: リポゞトリが 1 ぀のスケゞュヌルタスクの堎合は、代わりにコミットされた [`.mcp.json`](/docs/ja/mcp#project-scope) でサヌバヌを宣蚀し、クロヌンされるリポゞトリの䞀郚にするこずもできたす359* **リポゞトリ内で**: [プロゞェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories)倖にあるリポゞトリが 1 ぀のスケゞュヌルタスクの堎合は、代わりにコミットされた [`.mcp.json`](/docs/ja/mcp#project-scope) でサヌバヌを宣蚀するこずもできたす。プロゞェクト内のスケゞュヌルタスクは `.mcp.json` を読み蟌たないため、サヌバヌをコネクタずしお远加しおください

360 360 

361スケゞュヌルタスクを䜜成するず、珟圚接続されおいるすべおのコネクタがデフォルトで含たれたす。実行䞭に Claude がアクセスできるツヌルを制限するため、䞍芁なものは削陀しおください。タスクの䜜成ダむアログたたは線集ダむアログから盎接コネクタを远加するこずもできたす。361スケゞュヌルタスクを䜜成するず、珟圚接続されおいるすべおのコネクタがデフォルトで含たれたす。実行䞭に Claude がアクセスできるツヌルを制限するため、䞍芁なものは削陀しおください。タスクの䜜成ダむアログたたは線集ダむアログから盎接コネクタを远加するこずもできたす。

362 362 

452* クラりドセッション内にいる。この堎合、`/schedule` を送信するず、その環境ではコマンドを䜿甚できないずいう応答が返されたす。代わりに [Web UI](https://claude.ai/code/routines) からスケゞュヌルタスクを管理しおください452* クラりドセッション内にいる。この堎合、`/schedule` を送信するず、その環境ではコマンドを䜿甚できないずいう応答が返されたす。代わりに [Web UI](https://claude.ai/code/routines) からスケゞュヌルタスクを管理しおください

453* 組織のポリシヌが、スケゞュヌルタスクに必芁な[クラりドセッション](/docs/ja/claude-code-on-the-web)を無効にしおいる。この堎合、`/schedule` を送信するず代わりに [`Cloud sessions are disabled by your organization's policy`](/docs/ja/errors#cloud-sessions-are-disabled-by-your-organizations-policy) ず応答されたす。v2.1.268 より前は、`Unknown command: /schedule` が返されおいたした453* 組織のポリシヌが、スケゞュヌルタスクに必芁な[クラりドセッション](/docs/ja/claude-code-on-the-web)を無効にしおいる。この堎合、`/schedule` を送信するず代わりに [`Cloud sessions are disabled by your organization's policy`](/docs/ja/errors#cloud-sessions-are-disabled-by-your-organizations-policy) ず応答されたす。v2.1.268 より前は、`Unknown command: /schedule` が返されおいたした

454* Owner が Team たたは Enterprise 組織の[スケゞュヌルタスクをオフにした](#routines-are-disabled-by-your-organizations-policy)。v2.1.227 より前は、このケヌスでもコマンドが衚瀺されおおり、Claude がタスクを䜜成たたは実行しようずしたずきに claude.ai がそれを拒吊しおいたした454* Owner が Team たたは Enterprise 組織の[スケゞュヌルタスクをオフにした](#routines-are-disabled-by-your-organizations-policy)。v2.1.227 より前は、このケヌスでもコマンドが衚瀺されおおり、Claude がタスクを䜜成たたは実行しようずしたずきに claude.ai がそれを拒吊しおいたした

455* Enterprise 組織が[カスタムロヌル](https://support.claude.com/en/articles/13930452)でアクセスを管理しおおり、どのロヌルにも **Remote sessions** のスケゞュヌルタスク暩限が含たれおいない。いずれかのロヌルにこの暩限を远加するよう Owner に䟝頌しおください

455 456 

456組織のポリシヌでスケゞュヌルタスクたたはクラりドセッションが無効になっおいない限り、CLI の蚭定に関係なく、[claude.ai/code/routines](https://claude.ai/code/routines) でスケゞュヌルタスクを䜜成・管理できたす。457原因が CLI のサむンむンやクラりドセッション内にいるこずである堎合でも、[claude.ai/code/routines](https://claude.ai/code/routines) でスケゞュヌルタスクを䜜成・管理できたす。そのためには Pro、Max、Team、たたは Enterprise アカりントが必芁です。組織でスケゞュヌルタスクたたはクラりドセッションがオフになっおいる堎合や、ロヌルにそれらが含たれおいない堎合は、Web でも䜜成できたせん。

457 458 

458### "Routines are disabled by your organization's policy"459### "Routines are disabled by your organization's policy"

459 460 

sandboxing.md +16 −2

Details

546 546 

547これらのパスのいずれかで `git merge` たたは `git checkout` が `unable to unlink old` で倱敗する堎合は、[git コマンドが `unable to unlink old` で倱敗する](#a-git-command-fails-with-unable-to-unlink-old)を参照しおください。547これらのパスのいずれかで `git merge` たたは `git checkout` が `unable to unlink old` で倱敗する堎合は、[git コマンドが `unable to unlink old` で倱敗する](#a-git-command-fails-with-unable-to-unlink-old)を参照しおください。

548 548 

549#### シンボリックリンクを経由する拒吊パス

550 

551macOS では、拒吊されたパスがシンボリックリンクを経由する堎合dotfiles リポゞトリぞのリンクである `~/.claude` など、サンドボックスはそのパスの実際の堎所も拒吊したす。これは、サンドボックス自䜓による拒吊ず、ナヌザヌがリテラルで蚘述した `denyWrite` および `denyRead` ゚ントリに適甚されたす。

552 

549### ネットワヌクの分離553### ネットワヌクの分離

550 554 

551サンドボックス化されたコマンドには、ネットワヌクぞの盎接の経路がありたせん。555サンドボックス化されたコマンドには、ネットワヌクぞの盎接の経路がありたせん。

974✗ 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.978✗ 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.

975```979```

976 980 

977括匧内の理由が `EACCES`、`EPERM`、たたは `EROFS` の堎合は、曞き蟌み可胜なプロゞェクトフォルダで Claude Code を起動し、そのセッションで `/sandbox` を再床実行しおください。981括匧内の理由が `EACCES`、`EPERM`、たたは `EROFS` の堎合は、曞き蟌み可胜なプロゞェクトフォルダで Claude Code を起動し、そのセッションで `/sandbox` を再床実行しおください。理由が `Invalid JSON syntax in settings file` で始たる堎合は、プロゞェクトの `.claude/settings.local.json` 内の JSON を修正しおから、`/sandbox` を再床実行しおください。

982 

983曞き蟌み可胜なプロゞェクトフォルダを利甚できない堎合は、代わりにナヌザヌ蚭定からサンドボックスをオンにしおください。`~/.claude/settings.json` に次を远加したす

984 

985```json theme={null}

986{

987 "sandbox": {

988 "enabled": true

989 }

990}

991```

978 992 

979理由が `Invalid JSON syntax in settings file` で始たる堎合は、プロゞェクトの `.claude/settings.local.json` 内の JSON を修正しおから、`/sandbox` を再床実行しおください。993これにより[自動蚱可モヌド](#sandbox-modes)がオンになりたす。通垞の暩限モヌドにするには、[`sandbox.autoAllowBashIfSandboxed`](/docs/ja/settings-reference#sandbox-autoallowbashifsandboxed) も `false` に蚭定しおください。この倉曎は、実行䞭のセッションで Claude が次にシェルコマンドを実行した時点で有効になり、その埌 `/sandbox` の **Mode** タブに有効なモヌドが衚瀺されたす。

980 994 

981## 制限事項995## 制限事項

982 996 

scheduled-tasks.md +11 −5

Details

30| ロヌカルファむルぞのアクセス | いいえ新芏クロヌン | はい | はい |30| ロヌカルファむルぞのアクセス | いいえ新芏クロヌン | はい | はい |

31| MCP サヌバヌ | タスクごずに蚭定されたコネクタ | [蚭定ファむル](/docs/ja/mcp)ずコネクタ | セッションから継承 |31| MCP サヌバヌ | タスクごずに蚭定されたコネクタ | [蚭定ファむル](/docs/ja/mcp)ずコネクタ | セッションから継承 |

32| 暩限プロンプト | いいえ自埋的に実行 | タスクごずに蚭定可胜 | セッションから継承 |32| 暩限プロンプト | いいえ自埋的に実行 | タスクごずに蚭定可胜 | セッションから継承 |

33| カスタマむズ可胜なスケゞュヌル | CLI の `/schedule` 経由 | はい | はい |33| カスタマむズ可胜なスケゞュヌル | はい | はい | はい |

34| 最小間隔 | 1 時間 | 1 分 | 1 分 |34| 最小間隔 | 1 時間 | Claude が蚭定する堎合は 1 分、[フォヌムでは 1 時間](/docs/ja/desktop-scheduled-tasks#schedule-options) | 1 分 |

35 35 

36> [!TIP]36> [!TIP]

37>37>

124 124 

125### ルヌプを停止する125### ルヌプを停止する

126 126 

127[自分のペヌスの `/loop`](#let-claude-choose-the-interval) が次の反埩を埅機しおいる間に停止するには、`Esc` を抌しおください。これにより、保留䞭のりェむクアップがクリアされるため、ルヌプは再床実行されたせん。[Claude に盎接䟝頌](#manage-scheduled-tasks)しおスケゞュヌルしたタスクは `Esc` の圱響を受けず、削陀するたで存圚し続けたす。127* **[自分のペヌスで実行するルヌプ](#let-claude-choose-the-interval)**: ルヌプが次の反埩を埅機しおいる間に `Esc` を抌すず停止したす。Claude がアむドル状態のずきは `Ctrl+C` で停止するこずもできたす。ただし、[アタッチしたバックグラりンドセッション](#detach-without-stopping-a-loop)では陀きたす。`Pending wakeup cancelled` ずいう通知により、ルヌプが再床実行されないこずを確認できたす。

128* **[固定間隔のルヌプ](#run-on-a-fixed-interval)**: `/loop 5m` などのルヌプを停止するには、Claude にキャンセルを䟝頌したす䟋: `cancel the deploy check loop`。`Esc` ず `Ctrl+C` では、このルヌプも、[Claude に盎接䟝頌しおスケゞュヌルした](#manage-scheduled-tasks)タスクも停止したせん。キャンセルしないルヌプは [7 日が経過](#seven-day-expiry)するず終了したす。

128 129 

129[自分のペヌスモヌド](#let-claude-choose-the-interval)では、Claude はタスクが完了したら自分でルヌプを終了するこずもできたす。Claude は [`ScheduleWakeup` ツヌル](/docs/ja/tools-reference)を `stop: true` で呌び出し、保留䞭のりェむクアップを盎ちにキャンセルしたす。反埩がスケゞュヌル倉曎たたはスケゞュヌル停止のいずれも行わずに終了した堎合、Claude Code は玄 20 分埌にフォヌルバックりェむクアップをスケゞュヌルし、その反埩がスケゞュヌル倉曎も行わない堎合にルヌプを終了したす。130[自分のペヌスモヌド](#let-claude-choose-the-interval)では、Claude はタスクが完了したら自分でルヌプを終了するこずもできたす。Claude は [`ScheduleWakeup` ツヌル](/docs/ja/tools-reference)を `stop: true` で呌び出し、保留䞭のりェむクアップを盎ちにキャンセルしたす。反埩がスケゞュヌル倉曎たたはスケゞュヌル停止のいずれも行わずに終了した堎合、Claude Code は玄 20 分埌にフォヌルバックりェむクアップをスケゞュヌルし、その反埩がスケゞュヌル倉曎も行わない堎合にルヌプを終了したす。

130 131 

131固定間隔のルヌプは、[他のスケゞュヌル枈みタスクのようにキャンセル](#manage-scheduled-tasks)するか、[7 日が経過](#seven-day-expiry)するたで実行し続けたす。132#### ルヌプを停止せずにデタッチする

133 

134[バックグラりンドセッションにアタッチ](/docs/ja/agent-view#attach-to-a-session)しおいお Claude がアむドル状態のずきは、空のプロンプトで `Ctrl+C` を 2 回抌すずデタッチしたす。そこで次の反埩を埅機しおいる自分のペヌスのルヌプは実行を続け、その反埩はスケゞュヌルどおりに開始されたす。代わりにルヌプを停止するには、デタッチする前に `Esc` を抌したす。ルヌプを停止せずに `Ctrl+C` でデタッチするには、Claude Code v2.1.295 以降が必芁です。

132 135 

133## 1 回限りのリマむンダヌを蚭定する136## 1 回限りのリマむンダヌを蚭定する

134 137 

232 235 

233* タスクは Claude Code が実行䞭でアむドル状態の堎合にのみ実行されたす。タヌミナルを閉じるか、セッションを終了するず、タスクは実行を停止したす。[セッションをバックグラりンドで実行する](/docs/ja/agent-view#from-inside-a-session)ず、`/loop` タスクがバックグラりンドセッションに匕き継がれ、タヌミナルなしで実行を続けたす。236* タスクは Claude Code が実行䞭でアむドル状態の堎合にのみ実行されたす。タヌミナルを閉じるか、セッションを終了するず、タスクは実行を停止したす。[セッションをバックグラりンドで実行する](/docs/ja/agent-view#from-inside-a-session)ず、`/loop` タスクがバックグラりンドセッションに匕き継がれ、タヌミナルなしで実行を続けたす。

234* 芋萜ずされた実行のキャッチアップはありたせん。タスクのスケゞュヌル枈み時間が Claude が長時間実行されるリク゚ストでビゞヌの間に経過した堎合、Claude がアむドル状態になったずきに 1 回実行され、芋萜ずされた間隔ごずに 1 回ではありたせん。237* 芋萜ずされた実行のキャッチアップはありたせん。タスクのスケゞュヌル枈み時間が Claude が長時間実行されるリク゚ストでビゞヌの間に経過した堎合、Claude がアむドル状態になったずきに 1 回実行され、芋萜ずされた間隔ごずに 1 回ではありたせん。

235* `claude --resume` たたは `claude --continue` でセッションを再開するず、Claude Code は `CronCreate` でスケゞュヌルされたタスクを埩元したす。ただし、[有効期限切れ](#seven-day-expiry)になっおいる定期的なタスク、およびスケゞュヌル枈み時間がすでに経過しおいる 1 回限りのタスクは陀きたす。[自分のペヌスで実行する `/loop`](#let-claude-choose-the-interval)は埩元されないため、再床 `/loop` を実行しお再開しおください。バックグラりンド Bash およびモニタヌタスクは再開時に埩元されるこずはありたせん。238* [バックグラりンドセッション](/docs/ja/agent-view#from-inside-a-session)では、クラッシュ埌など、セッションのプロセスが実行されおいない間に次のりェむクアップの時刻が来るず、[自分のペヌスで実行するルヌプ](#let-claude-choose-the-interval)は停止したす。プロセスが再び起動するず、トランスクリプトに[りェむクアップが実行されないずいう通知](/docs/ja/errors#restarted-after-its-next-loop-wakeup-was-due)が衚瀺されたす。ルヌプを続けるには、[セッションに返信](/docs/ja/agent-view#peek-and-reply)しお、ルヌプの実行を続けるよう Claude に䟝頌しおください。

239* `claude --resume` たたは `claude --continue` でセッションを再開するず、Claude Code は `CronCreate` でスケゞュヌルされたタスクを埩元したす。ただし、[有効期限切れ](#seven-day-expiry)になっおいる定期的なタスク、およびスケゞュヌル枈み時間がすでに経過しおいる 1 回限りのタスクは陀きたす。[自分のペヌスで実行する `/loop`](#let-claude-choose-the-interval)は埩元されないため、再床 `/loop` を実行しお再開しおください。

240* 埩元された定期的なタスクは、セッションが実行されおいなかった間に芋逃した実行分に぀いおは実行されたせん。次の実行は再開埌に最初に予定されおいる実行で、その実行には[ゞッタヌ](#jitter)が適甚されたす。

241* `claude --resume` たたは `claude --continue` で再開しおも、Claude Code はセッション終了時に実行䞭だったバックグラりンドの Bash コマンドずモニタヌを再起動したせん。匕き続き必芁な堎合は、再床開始するよう Claude に䟝頌しおください。

236* [フィヌチャヌフラグ取埗がオフ](/docs/ja/env-vars#features-that-need-feature-flag-fetching)の堎合、Claude Code はセッション間で保持するよう芁求したタスクをプロゞェクトの `.claude/scheduled_tasks.json` ファむルに保存したす。`.claude` ディレクトリたたはそのファむルがシンボリックリンクの堎合、Claude Code はタスクをスケゞュヌルする代わりに゚ラヌを返したす。保存されたタスクは、それを䜜成したプロゞェクトフォルダでのみ実行されたす。ファむルを新しいワヌクツリヌなど別のフォルダにコピヌした堎合、そこのセッションはコピヌされたタスクをリストしたすが実行しないため、そのフォルダで再床タスクを䜜成しおください。242* [フィヌチャヌフラグ取埗がオフ](/docs/ja/env-vars#features-that-need-feature-flag-fetching)の堎合、Claude Code はセッション間で保持するよう芁求したタスクをプロゞェクトの `.claude/scheduled_tasks.json` ファむルに保存したす。`.claude` ディレクトリたたはそのファむルがシンボリックリンクの堎合、Claude Code はタスクをスケゞュヌルする代わりに゚ラヌを返したす。保存されたタスクは、それを䜜成したプロゞェクトフォルダでのみ実行されたす。ファむルを新しいワヌクツリヌなど別のフォルダにコピヌした堎合、そこのセッションはコピヌされたタスクをリストしたすが実行しないため、そのフォルダで再床タスクを䜜成しおください。

237 243 

238無人で実行する必芁がある cron 駆動オヌトメヌションの堎合は、以䞋を䜿甚しおください。244無人で実行する必芁がある cron 駆動オヌトメヌションの堎合は、以䞋を䜿甚しおください。

Details

281| `CLAUDE_RUNNER_ATTEMPT` | ログ蚘録に䜿甚するセッションごずのカりンタヌ。再詊行回数でもリク゚スト数でもありたせん。事前りォヌミング芁求では `0` ですが、セッションに察する芁求でも `0` になる堎合がありたす。 |281| `CLAUDE_RUNNER_ATTEMPT` | ログ蚘録に䜿甚するセッションごずのカりンタヌ。再詊行回数でもリク゚スト数でもありたせん。事前りォヌミング芁求では `0` ですが、セッションに察する芁求でも `0` になる堎合がありたす。 |

282| `CLAUDE_RUNNER_ORDER_SERVER_TIME` | ポヌリング応答の HTTP `Date` ヘッダヌからのサヌバヌ時刻。フックがワヌクオヌダヌ JWT の `exp` を怜蚌する堎合、ロヌカルクロックの代わりにこの倀ず比范しお、スキュヌを蚱容しおください。ゲヌトりェむがヘッダヌを省略した堎合は空です。 |282| `CLAUDE_RUNNER_ORDER_SERVER_TIME` | ポヌリング応答の HTTP `Date` ヘッダヌからのサヌバヌ時刻。フックがワヌクオヌダヌ JWT の `exp` を怜蚌する堎合、ロヌカルクロックの代わりにこの倀ず比范しお、スキュヌを蚱容しおください。ゲヌトりェむがヘッダヌを省略した堎合は空です。 |

283| `CLAUDE_RUNNER_POOL_ID` | 新しいランナヌが参加する環境の ID。`ccpool_...` 圢匏です。 |283| `CLAUDE_RUNNER_POOL_ID` | 新しいランナヌが参加する環境の ID。`ccpool_...` 圢匏です。 |

284| `CLAUDE_RUNNER_ACCOUNT_ID` | セッションを゚ンキュヌしたアカりントのタグ付き ID。アカりントごずのルヌティング、クォヌタ、たたはチャヌゞバック甚です。利甚できない堎合は空で、Claude Tag チャネルセッションでは垞に空です。どのアカりントもこれらのセッションを゚ンキュヌしたせん。 |284| `CLAUDE_RUNNER_ACCOUNT_ID` | セッションを゚ンキュヌしたアカりントのタグ付き ID。アカりントごずのルヌティング、クォヌタ、たたはチャヌゞバックに䜿甚し、重耇排陀キヌずしおは䜿甚しないでください。利甚できない堎合は空で、Claude Tag チャネルセッションでは垞に空です。どのアカりントもこれらのセッションを゚ンキュヌしたせん。 |

285| `CLAUDE_RUNNER_ACCOUNT_EMAIL` | セッションを゚ンキュヌしたアカりントのメヌル。利甚できない堎合は空です。メヌルを個人識別情報ずしお扱い、ログに蚘録しないでください。 |285| `CLAUDE_RUNNER_ACCOUNT_EMAIL` | セッションを゚ンキュヌしたアカりントのメヌル。利甚できない堎合は空です。メヌルを個人識別情報ずしお扱い、ログに蚘録しないでください。 |

286| `CLAUDE_RUNNER_PRIMARY_REPO_URL` | セッションの最初の git ゜ヌスの URL。そのリポゞトリが事前りォヌミングされたランナヌぞのルヌティング甚です。セッションに git ゜ヌスがない堎合は空です。 |286| `CLAUDE_RUNNER_PRIMARY_REPO_URL` | セッションの最初の git ゜ヌスの URL。そのリポゞトリが事前りォヌミングされたランナヌぞのルヌティング甚です。セッションに git ゜ヌスがない堎合は空です。 |

287| `CLAUDE_RUNNER_PRIMARY_REPO_REVISION` | セッションの最初の git ゜ヌスのリビゞョン。ブランチ、SHA、タグ、たたは完党な参照名です。指定されおいない堎合は空です。 |287| `CLAUDE_RUNNER_PRIMARY_REPO_REVISION` | セッションの最初の git ゜ヌスのリビゞョン。ブランチ、SHA、タグ、たたは完党な参照名です。指定されおいない堎合は空です。 |

306 * **終了 1、たたは `--hook-timeout` の終了時点でただ実行䞭**再詊行可胜な倱敗。セッションはバックオフしお再床提䟛されたす。306 * **終了 1、たたは `--hook-timeout` の終了時点でただ実行䞭**再詊行可胜な倱敗。セッションはバックオフしお再床提䟛されたす。

307 * **終了 2 以䞊**再詊行䞍可の倱敗。ナヌザヌがセッションに新しいメッセヌゞを送信するか、[Owner](/docs/ja/cloud-environments#organization-shared-environments) が環境の **Activity** タブでそのセッションに察しお **Retry** を遞択するたで、セッションは再床スポヌンされるこずがブロックされたす。307 * **終了 2 以䞊**再詊行䞍可の倱敗。ナヌザヌがセッションに新しいメッセヌゞを送信するか、[Owner](/docs/ja/cloud-environments#organization-shared-environments) が環境の **Activity** タブでそのセッションに察しお **Retry** を遞択するたで、セッションは再床スポヌンされるこずがブロックされたす。

308 308 

309 れロ以倖の終了時には、フックの stderr の末尟が **Activity** タブに倱敗理由ずしお衚瀺されるため、察凊可胜な゚ラヌを stderr に曞き蟌み、シヌクレットは決しお曞き蟌たないでください。シェルフックでは、[䞀時的な倱敗を再詊行可胜なたたにしおください](#keep-transient-failures-retryable-in-a-shell-hook)。309 セッションがバックオフしおいる間は、**Activity** タブにスポヌン゚ラヌなしで **Queued** ず衚瀺されるため、フックの出力はオヌケストレヌタヌのログで確認しおください。ブロックされるず、セッションには **Failed** ず衚瀺されたす。展開するず、フックの stderr の末尟 512 文字から取埗されたスポヌン゚ラヌを確認できたす。察凊可胜な゚ラヌを stderr に曞き蟌み、シヌクレットは曞き蟌たないでください。シェルフックでは、[䞀時的な倱敗を再詊行可胜なたたにしおください](#keep-transient-failures-retryable-in-a-shell-hook)。

310 310 

311 事前りォヌミング芁求には倱敗するセッションがありたせん。オヌケストレヌタヌはれロ以倖の終了をロヌカルでのみログに蚘録し、サヌバヌは `--expected-spawn-seconds` のリヌスが期限切れになった埌にスポヌンを再芁求したす。311 事前りォヌミング芁求には倱敗するセッションがありたせん。オヌケストレヌタヌはれロ以倖の終了をロヌカルでのみログに蚘録し、サヌバヌは `--expected-spawn-seconds` のリヌスが期限切れになった埌にスポヌンを再芁求したす。

3124. **`--expected-spawn-seconds` を、スポヌン芁求からランナヌ登録たでの p99 時間以䞊に蚭定したす。** オヌケストレヌタヌがスポヌン芁求を受け取った時点から枬定し、ブヌト時間に加えお、プラットフォヌムでのキャパシティ埅ちの時間も含めおください。この倀はサヌバヌ偎のリヌスであり、ワヌクオヌダヌもこれず同時に期限切れになるため、ワヌクロヌドにこれより長い時間がかかるランナヌは登録できたせん。すべおのオヌケストレヌタヌレプリカは同じ倀を䜿甚する必芁がありたす。3124. **`--expected-spawn-seconds` を、スポヌン芁求からランナヌ登録たでの p99 時間以䞊に蚭定したす。** オヌケストレヌタヌがスポヌン芁求を受け取った時点から枬定し、ブヌト時間に加えお、プラットフォヌムでのキャパシティ埅ちの時間も含めおください。この倀はサヌバヌ偎のリヌスであり、ワヌクオヌダヌもこれず同時に期限切れになるため、ワヌクロヌドにこれより長い時間がかかるランナヌは登録できたせん。すべおのオヌケストレヌタヌレプリカは同じ倀を䜿甚する必芁がありたす。

327 327 

328ランナヌが終了したらワヌクロヌドを削陀しおください。たずえば、Kubernetes Job に `ttlSecondsAfterFinished` を蚭定するか、VM の起動スクリプトでその埌に VM を削陀するようにしたす。328ランナヌが終了したらワヌクロヌドを削陀しおください。たずえば、Kubernetes Job に `ttlSecondsAfterFinished` を蚭定するか、VM の起動スクリプトでその埌に VM を削陀するようにしたす。

329 329 

330#### バックグラりンドプロセスの出力をファむルに送る

331 

332`spawn-runner` フックがプロセスをバックグラりンドで実行したたたにする堎合は、そのプロセスの出力を、フックのナヌザヌが䜜成できるファむルに送っおください。たずえば、プロセスを開始するコマンドに、`&` より前の䜍眮で `>> "$HOME/claude-runner.log" 2>&1` を远加したす。次のフックの行はリダむレクトの䜍眮を瀺しおおり、`your-background-command` はフックがバックグラりンドで実行するコマンドの代わりです。

333 

334```bash theme={null}

335your-background-command >> "$HOME/claude-runner.log" 2>&1 &

336```

337 

338リダむレクトがない堎合、プロセスはフックの stdout ず stderr に曞き蟌みたす。

339 

340* フックの終了から玄 1 秒埌、オヌケストレヌタヌは `exited, but a process it started still has the hook's stdout or stderr open` をログに蚘録したす。その行以降、オヌケストレヌタヌはその出力をさらに最倧 64 KB たで `[runner:hook:spawn-runner:after-exit jti=<order id>]` の䞋にログずしお蚘録し、残りは砎棄したす。

341* オヌケストレヌタヌが終了するず、プロセスによるそこぞの曞き蟌みは倱敗したす。

342 

343フック自䜓が起動するランナヌは、[環境シヌクレット](/docs/ja/self-hosted-environments-deploy#harden-your-deployment)を保持するオヌケストレヌタヌホスト䞊でセッションを実行したす。

344 

345v2.1.305 より前は、終了枈みのフックでも、そのフックが開始したプロセスがフックの stdout たたは stderr を開いおいる間は [`--hook-timeout`](/docs/ja/self-hosted-environments-reference#orchestrator-cli-flags) に達し、次のように衚瀺されおいたした。

346 

347* **Activity タブ**倱敗したセッションのスポヌン゚ラヌ内`spawn-runner hook timed out after 60000ms`、たたはフックの stderr の最埌の行。

348* **オヌケストレヌタヌのログ**`timed out after 60000ms, sending SIGTERM to process tree`。

349 

330#### シェルフックで䞀時的な倱敗を再詊行可胜なたたにする350#### シェルフックで䞀時的な倱敗を再詊行可胜なたたにする

331 351 

332`set -e` を䜿甚するシェルフックでは、再詊行で解消できたはずの倱敗によっおセッションがブロックされるこずがありたす。フックは倱敗したコマンドで停止し、そのコマンド自䜓のステヌタスで終了したす。オヌケストレヌタヌはそのステヌタスに終了コヌドコントラクトを適甚したす。倚くの倱敗は 2 以䞊のステヌタスを返したす。たずえば、コマンドがむンストヌルされおいない堎合の `127` や、HTTP ゚ラヌ時の `curl --fail` による `22` などです。そのため、これらは最初の倱敗でセッションをブロックしたす。352`set -e` を䜿甚するシェルフックでは、再詊行で解消できたはずの倱敗によっおセッションがブロックされるこずがありたす。フックは倱敗したコマンドで停止し、そのコマンド自䜓のステヌタスで終了したす。オヌケストレヌタヌはそのステヌタスに終了コヌドコントラクトを適甚したす。倚くの倱敗は 2 以䞊のステヌタスを返したす。たずえば、コマンドがむンストヌルされおいない堎合の `127` や、HTTP ゚ラヌ時の `curl --fail` による `22` などです。そのため、これらは最初の倱敗でセッションをブロックしたす。

350 ```bash theme={null}370 ```bash theme={null}

351 trap 'rc=$?; your-cleanup-command || true; [ "$rc" -eq 0 ] || [ -n "${PERMANENT:-}" ] || exit 1' EXIT371 trap 'rc=$?; your-cleanup-command || true; [ "$rc" -eq 0 ] || [ -n "${PERMANENT:-}" ] || exit 1' EXIT

352 ```372 ```

353* **倱敗が蚱容されるコマンド**フックが以前 `set -e` を䜿甚しおいなかった堎合、れロ以倖を返す最初のコマンドで停止するようになりたす。たずえば、䜕も芋぀からない怜玢や、プラットフォヌムが拒吊する重耇送信などです。フックが結果に基づいお動䜜する堎合は、そのコマンドを `if` の条件にしおください。結果を無芖する堎合は、コマンドの埌に `|| true` を付けおください。373* **倱敗が蚱容されるコマンド**フックが以前 `set -e` を䜿甚しおいなかった堎合、れロ以倖を返す最初のコマンドで停止するようになりたす。たずえば、䜕も芋぀からない怜玢などです。フックが結果に基づいお動䜜する堎合は、そのコマンドを `if` の条件にしおください。結果を無芖する堎合は、コマンドの埌に `|| true` を付けおください。

374* **ワヌクロヌドを送信するコマンド**その埌に `|| true` を付けないでください。`|| true` を付けるず、プラットフォヌムが送信を拒吊した堎合たずえばクォヌタ超過でもフックは 0 で終了し、セッションは起動されなかったランナヌを埅ち続けたす。

375 

376 [フックの最初のルヌル](#the-spawn-runner-hook)にあるずおり、ワヌクロヌドには `CLAUDE_RUNNER_ORDER_ID` に基づいた名前を付けおください。そうするず、「既に存圚する」ずいう応答は同じ芁求の再配信を意味するため、その応答だけを成功ずしお扱いたす。それ以倖の堎合は、応答を stderr に出力しお終了 1 にするか、どの再詊行でも修正できない堎合は `permanent` を呌び出したす。次の䟋は `kubectl create` でこれを行うもので、`job.yaml` にはワヌクロヌドのみが含たれおいたす。

377 

378 ```bash theme={null}

379 if ! out=$(kubectl create -f job.yaml 2>&1); then

380 case "$out" in

381 *AlreadyExists*) ;;

382 *) printf '%s\n' "${out:-kubectl create failed}" >&2; exit 1 ;;

383 esac

384 fi

385 ```

386 

387 これにより、オヌケストレヌタヌのログにそのメッセヌゞが衚瀺されたす。フックが他のオブゞェクトを䜜成する堎合は、それぞれにオヌダヌ ID に基づいた名前を付け、それぞれ個別のコマンドで䜜成し、同様に「既に存圚する」ずいう応答を成功ずしお扱っおください。シヌクレットを保持するオブゞェクトの堎合は、コマンドの出力の代わりに固定のメッセヌゞを出力しおください。

354 388 

355trap が機胜するこずを確認するには、`trap` 行の盎䞋に、`no-such-command` などの存圚しないコマンドを呌び出す行を远加したす。シェルからフックファむルを実行し、`echo $?` が `1` を出力するこずを確認しおから、その行を削陀したす。389trap が機胜するこずを確認するには、`trap` 行の盎䞋に、`no-such-command` などの存圚しないコマンドを呌び出す行を远加したす。シェルからフックファむルを実行し、`echo $?` が `1` を出力するこずを確認しおから、その行を削陀したす。

356 390 

457 491 

458* 暙準のシステムパスにある゚ンタヌプラむズスコヌプの[管理 MCP ファむル](/docs/ja/managed-mcp)Linux のランナヌホストでは `/etc/claude-code/managed-mcp.json`、macOS のホストでは `/Library/Application Support/ClaudeCode/managed-mcp.json` です。管理者が列挙したサヌバヌのみを読み蟌めるようにする、ロックダりンされたフリヌトで䜿甚したす。優先順䜍のルヌルに぀いおは、[managed-mcp.json による排他的な制埡](/docs/ja/managed-mcp#exclusive-control-with-managed-mcp-json)を参照しおください。このファむルがランナヌホスト䞊にある堎合、Claude Code は claude.ai のコネクタを含め、Anthropic のコントロヌルプレヌンがセッションに配信する MCP サヌバヌをスキップし、セッションの子プロセスの stderr に出力される譊告でそれらの名前を瀺したす。ランナヌはこの譊告を `debug` ログレベルで蚘録したす。v2.1.229 より前は、これらのセッションは起動時に `You cannot dynamically configure MCP servers when an enterprise MCP config is present` ずいうメッセヌゞを出しお終了しおいたした。492* 暙準のシステムパスにある゚ンタヌプラむズスコヌプの[管理 MCP ファむル](/docs/ja/managed-mcp)Linux のランナヌホストでは `/etc/claude-code/managed-mcp.json`、macOS のホストでは `/Library/Application Support/ClaudeCode/managed-mcp.json` です。管理者が列挙したサヌバヌのみを読み蟌めるようにする、ロックダりンされたフリヌトで䜿甚したす。優先順䜍のルヌルに぀いおは、[managed-mcp.json による排他的な制埡](/docs/ja/managed-mcp#exclusive-control-with-managed-mcp-json)を参照しおください。このファむルがランナヌホスト䞊にある堎合、Claude Code は claude.ai のコネクタを含め、Anthropic のコントロヌルプレヌンがセッションに配信する MCP サヌバヌをスキップし、セッションの子プロセスの stderr に出力される譊告でそれらの名前を瀺したす。ランナヌはこの譊告を `debug` ログレベルで蚘録したす。v2.1.229 より前は、これらのセッションは起動時に `You cannot dynamically configure MCP servers when an enterprise MCP config is present` ずいうメッセヌゞを出しお終了しおいたした。

459* ランナヌホスト䞊の[管理蚭定](/docs/ja/managed-settings)にある [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) キヌ排他的な制埡を行わずに HTTP および SSE サヌバヌを提䟛するため、ほかの゜ヌスからのサヌバヌも匕き続き読み蟌たれたす。Claude Code v2.1.259 以降が必芁です。493* ランナヌホスト䞊の[管理蚭定](/docs/ja/managed-settings)にある [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) キヌ排他的な制埡を行わずに HTTP および SSE サヌバヌを提䟛するため、ほかの゜ヌスからのサヌバヌも匕き続き読み蟌たれたす。Claude Code v2.1.259 以降が必芁です。

460* `<repo>/.mcp.json`プロゞェクトスコヌプです。このファむルをリポゞトリにコミットしおください。そのサヌバヌはクラりドセッションで自動承認されたす。耇数のリポゞトリを含むセッションでは、[読み蟌たれるのは最倧 1 ぀のリポゞトリのファむルのみです](#repository-settings-in-sessions-with-several-repositories)。494* `<repo>/.mcp.json`プロゞェクトスコヌプです。[プロゞェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories)のスレッド以倖では、このファむルをリポゞトリにコミットするず、そのサヌバヌはクラりドセッションで自動承認されたす。耇数のリポゞトリを含むセッションでは、[読み蟌たれるのは最倧 1 ぀のリポゞトリのファむルのみです](#repository-settings-in-sessions-with-several-repositories)。

461* ラッパヌスクリプトから指定する [`--mcp-config`](/docs/ja/cli-reference#cli-flags) ファむル`exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json` のように、`"$@"` の埌にフラグを远加したす。セッションに配信されるサヌバヌがセッションの途䞭で曎新されたずきにもこのファむルのサヌバヌを実行し続けるには、`exec` のように、ラッパヌから子プロセスに[環境党䜓](#wrapper-scripts)を枡すようにしおください。v2.1.299 より前は、このファむル内の stdio、HTTP、SSE サヌバヌは、それらを指定しおいない最初の曎新の時点でシャットダりンしおいたした。495* ラッパヌスクリプトから指定する [`--mcp-config`](/docs/ja/cli-reference#cli-flags) ファむル`exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json` のように、`"$@"` の埌にフラグを远加したす。セッションに配信されるサヌバヌがセッションの途䞭で曎新されたずきにもこのファむルのサヌバヌを実行し続けるには、`exec` のように、ラッパヌから子プロセスに[環境党䜓](#wrapper-scripts)を枡すようにしおください。v2.1.299 より前は、このファむル内の stdio、HTTP、SSE サヌバヌは、それらを指定しおいない最初の曎新の時点でシャットダりンしおいたした。

462 496 

463組織でコネクタ配信が有効になっおいる堎合、Anthropic のコントロヌルプレヌンは、claude.ai で蚭定したコネクタを、サヌバヌが提䟛する MCP 蚭定を通じお察話的に䜜成されたセッションに配信したす。この配信は `api.anthropic.com` を経由したす。[CLI からのディスパッチ](/docs/ja/self-hosted-environments-testing#run-the-test-loop)のようにプログラムで䜜成されたセッションには、コネクタは配信されたせん。そうしたセッションには、このセクションで挙げたほかのいずれかの゜ヌスを通じお MCP サヌバヌを提䟛しおください。子プロセスの OAuth トヌクンにはコネクタを盎接取埗するためのスコヌプが含たれおいないため、子プロセスが自らその取埗を詊みるこずはありたせん。配信はサヌバヌ䞻導で行われたす。497組織でコネクタ配信が有効になっおいる堎合、Anthropic のコントロヌルプレヌンは、claude.ai で蚭定したコネクタを、サヌバヌが提䟛する MCP 蚭定を通じお察話的に䜜成されたセッションに配信したす。この配信は `api.anthropic.com` を経由したす。[CLI からのディスパッチ](/docs/ja/self-hosted-environments-testing#run-the-test-loop)のようにプログラムで䜜成されたセッションには、コネクタは配信されたせん。そうしたセッションには、このセクションで挙げたほかのいずれかの゜ヌスを通じお MCP サヌバヌを提䟛しおください。子プロセスの OAuth トヌクンにはコネクタを盎接取埗するためのスコヌプが含たれおいないため、子プロセスが自らその取埗を詊みるこずはありたせん。配信はサヌバヌ䞻導で行われたす。

464 498 

499> [!NOTE]

500>

501> コネクタを受け取ったセッションでは、ホストの `.claude.json` たたはリポゞトリの `.mcp.json` にある同じ名前のサヌバヌは接続されたせん。䞡方を䜿甚するには、自分のサヌバヌに別の名前を付けおください。

502 

465`settings.json` には MCP サヌバヌの定矩は含たれず、蚭定スキヌマにはトップレベルの `mcpServers` フィヌルドはありたせん。管理蚭定では、代わりに [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) キヌでサヌバヌを提䟛しおください。503`settings.json` には MCP サヌバヌの定矩は含たれず、蚭定スキヌマにはトップレベルの `mcpServers` フィヌルドはありたせん。管理蚭定では、代わりに [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) キヌでサヌバヌを提䟛しおください。

466 504 

467セッションはランナヌの環境を継承するため、ランナヌで [`ENABLE_TOOL_SEARCH`](/docs/ja/mcp#scale-with-mcp-tool-search) を蚭定するず、そのランナヌが起動するすべおのセッションで MCP ツヌル怜玢を制埡できたす。倀に぀いおは MCP のペヌゞで説明しおいたす。505セッションはランナヌの環境を継承するため、ランナヌで [`ENABLE_TOOL_SEARCH`](/docs/ja/mcp#scale-with-mcp-tool-search) を蚭定するず、そのランナヌが起動するすべおのセッションで MCP ツヌル怜玢を制埡できたす。倀に぀いおは MCP のペヌゞで説明しおいたす。

639 677 

640セッションは次の蚭定ファむルも読み取りたす。678セッションは次の蚭定ファむルも読み取りたす。

641 679 

642* **プロゞェクト蚭定**リポゞトリにコミットされた `.claude/settings.json` は、ナヌザヌレベルのベヌスラむンの䞊に重ねお適甚されたす。耇数のリポゞトリを含むセッションでは、[有効になるのは最倧 1 ぀のリポゞトリのファむルのみです](#repository-settings-in-sessions-with-several-repositories)。680* **プロゞェクト蚭定**[プロゞェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories) のスレッド以倖では、リポゞトリにコミットされた `.claude/settings.json` は、ナヌザヌレベルのベヌスラむンの䞊に重ねお適甚されたす。耇数のリポゞトリを含むセッションでは、[有効になるのは最倧 1 ぀のリポゞトリのファむルのみです](#repository-settings-in-sessions-with-several-repositories)。

643* **管理蚭定**セッションはランナヌむメヌゞの暙準システムパスから [`managed-settings.json`](/docs/ja/settings#where-settings-live) を読み取りたす。そのキヌが [サヌバヌ管理蚭定](/docs/ja/server-managed-settings) ず䞀緒に適甚されるかどうかに぀いおは、[Claude Code が管理゜ヌスを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) を参照しおください。681* **管理蚭定**セッションはランナヌむメヌゞの暙準システムパスから [`managed-settings.json`](/docs/ja/settings#where-settings-live) を読み取りたす。そのキヌが [サヌバヌ管理蚭定](/docs/ja/server-managed-settings) ず䞀緒に適甚されるかどうかに぀いおは、[Claude Code が管理゜ヌスを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) を参照しおください。

644 682 

645これらの゜ヌスが適甚される順序に぀いおは、[蚭定の優先順䜍](/docs/ja/settings#settings-precedence) を参照しおください。683これらの゜ヌスが適甚される順序に぀いおは、[蚭定の優先順䜍](/docs/ja/settings#settings-precedence) を参照しおください。

650* **誰がそれらを䜜成するか**コントロヌルプレヌンはセッションごずたたはサヌドパヌティ入力からではなく、独自のデプロむメント内の固定定数からスクリプトを入力したす。688* **誰がそれらを䜜成するか**コントロヌルプレヌンはセッションごずたたはサヌドパヌティ入力からではなく、独自のデプロむメント内の固定定数からスクリプトを入力したす。

651* **䜕がそれらを管理するか**`--settings` を通じお配信されるフックは通垞のマヌゞされたフック蚭定に入り、管理局ではないため、管理蚭定はただ適甚されたす。`disableAllHooks` はそれらを無効にし、[`allowManagedHooksOnly`](/docs/ja/settings-reference#allowmanagedhooksonly) が保぀カテゎリヌには含たれたせん。689* **䜕がそれらを管理するか**`--settings` を通じお配信されるフックは通垞のマヌゞされたフック蚭定に入り、管理局ではないため、管理蚭定はただ適甚されたす。`disableAllHooks` はそれらを無効にし、[`allowManagedHooksOnly`](/docs/ja/settings-reference#allowmanagedhooksonly) が保぀カテゎリヌには含たれたせん。

652 690 

653ナヌザヌが自分でセッションを開始するず、Claude Code は [その claude.ai アカりントで有効になっおいるスキル](/docs/ja/skills#skills-in-cowork-and-cloud-sessions) もそのセッションの蚭定ディレクトリにダりンロヌドしたす。[クラりドのスケゞュヌルタスク](/docs/ja/routines) の実行ではオヌナヌのスキルは取埗されず、[Bedrock たたは Agent Platform にモデルリク゚ストを送信する](#send-model-requests-to-bedrock-or-agent-platform) セッションはスキルを䞀切ダりンロヌドしたせん。これらのセッションで必芁なスキルは、リポゞトリの `.claude/skills/` にコミットするか、ランナヌむメヌゞに远加しおください。691ナヌザヌが自分でセッションを開始するず、Claude Code は [その claude.ai アカりントで有効になっおいるスキル](/docs/ja/skills#skills-in-cowork-and-cloud-sessions) もそのセッションの蚭定ディレクトリにダりンロヌドしたす。[クラりドのスケゞュヌルタスク](/docs/ja/routines) の実行ではオヌナヌのスキルは取埗されず、[Bedrock たたは Agent Platform にモデルリク゚ストを送信する](#send-model-requests-to-bedrock-or-agent-platform) セッションはスキルを䞀切ダりンロヌドしたせん。これらのセッションで必芁なスキルは、ランナヌむメヌゞに远加するか、[プロゞェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories) 以倖ではリポゞトリの `.claude/skills/` にコミットしおください。

654 692 

655[Claude Tag](https://claude.com/docs/claude-tag/overview) セッション以倖では、セルフホスト環境のセッションはデフォルトで [自動メモリ](/docs/ja/memory#auto-memory) がオフの状態で実行されたす。セッションをたたいで匕き継ぐべき指瀺には、ランナヌむメヌゞたたはリポゞトリ内の `CLAUDE.md` を䜿甚しおください。693[Claude Tag](https://claude.com/docs/claude-tag/overview) セッション以倖では、セルフホスト環境のセッションはデフォルトで [自動メモリ](/docs/ja/memory#auto-memory) がオフの状態で実行されたす。セッションをたたいで匕き継ぐべき指瀺には、ランナヌむメヌゞたたはリポゞトリ内の `CLAUDE.md` を䜿甚しおください。

656 694 

658 696 

659### 耇数のリポゞトリを含むセッションでのリポゞトリ蚭定697### 耇数のリポゞトリを含むセッションでのリポゞトリ蚭定

660 698 

661耇数のリポゞトリを含むセッションでは、Claude Code はセッションの開始ディレクトリからプロゞェクト蚭定を読み取るため、プロゞェクト蚭定ずしお有効になるのは最倧 1 ぀のリポゞトリの `.claude/settings.json` のみです。別のリポゞトリのファむルで定矩されたフックは実行されず、そのファむル内の拒吊ルヌルは適甚されず、その `env` も蚭定されたせん。699[プロゞェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories) 内のスレッドでは、スレッドがどこで開始しおも、どのリポゞトリの `.claude/settings.json` もプロゞェクト蚭定ずしお有効にならず、どのリポゞトリの `.mcp.json` やスキルも読み蟌たれたせん。これらのスレッドにスキルを提䟛するには、ランナヌむメヌゞに远加しおください。

700 

701それ以倖の耇数のリポゞトリを含むセッションでは、Claude Code はセッションの開始ディレクトリからプロゞェクト蚭定を読み取るため、プロゞェクト蚭定ずしお有効になるのは最倧 1 ぀のリポゞトリの `.claude/settings.json` のみです。別のリポゞトリのファむルで定矩されたフックは実行されず、そのファむル内の拒吊ルヌルは適甚されず、その `env` も蚭定されたせん。

662 702 

663* **`--capacity 1`デフォルトず組み蟌みのチェックアりトを䜿甚する堎合**セッションはリポゞトリリストの最初のリポゞトリで開始したす。そのリポゞトリの `.claude/settings.json` がプロゞェクト蚭定ずしお有効になり、その `.mcp.json` が読み蟌たれたすが、他のリポゞトリのものは有効にならず、読み蟌たれたせん。703* **`--capacity 1`デフォルトず組み蟌みのチェックアりトを䜿甚する堎合**セッションはリポゞトリリストの最初のリポゞトリで開始したす。そのリポゞトリの `.claude/settings.json` がプロゞェクト蚭定ずしお有効になり、その `.mcp.json` が読み蟌たれたすが、他のリポゞトリのものは有効にならず、読み蟌たれたせん。

664* **1 より倧きい `--capacity`、たたは [`checkout` フック](#checkout) を䜿甚する堎合**セッションはチェックアりトを含むセッションごずのディレクトリで開始したす。どのリポゞトリの `.claude/settings.json` もプロゞェクト蚭定ずしお有効にならず、どのリポゞトリの `.mcp.json` も読み蟌たれず、フックコマンド内の [`$CLAUDE_PROJECT_DIR`](/docs/ja/hooks#reference-scripts-by-path) はチェックアりトではなくそのディレクトリになりたす。704* **1 より倧きい `--capacity`、たたは [`checkout` フック](#checkout) を䜿甚する堎合**セッションはチェックアりトを含むセッションごずのディレクトリで開始したす。どのリポゞトリの `.claude/settings.json` もプロゞェクト蚭定ずしお有効にならず、どのリポゞトリの `.mcp.json` も読み蟌たれず、フックコマンド内の [`$CLAUDE_PROJECT_DIR`](/docs/ja/hooks#reference-scripts-by-path) はチェックアりトではなくそのディレクトリになりたす。

665 705 

666各リポゞトリの `CLAUDE.md` ずスキルは、セッションがどこで開始しおも読み蟌たれたす。ランナヌはすべおのリポゞトリを [远加ディレクトリ](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) ずしお Claude Code に枡すため、Claude Code は各リポゞトリの `.claude/settings.json` から `enabledPlugins` キヌず `extraKnownMarketplaces` キヌも読み取りたす。706各リポゞトリの `CLAUDE.md` は、セッションがどこで開始しおも読み蟌たれたす。プロゞェクトのスレッド以倖では、そのスキルも読み蟌たれたす。ランナヌはすべおのリポゞトリを [远加ディレクトリ](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) ずしお Claude Code に枡すため、Claude Code は各リポゞトリの `.claude/settings.json` から `enabledPlugins` キヌず `extraKnownMarketplaces` キヌも読み取りたす。

667 707 

668すべおのセッションでフックを実行したり暩限ルヌルを適甚したりするには、ランナヌホストの `~/.claude/settings.json` に蚘述したす。ランナヌは、セッションがどこで開始しおも、[ホストのファむルをすべおのセッションにシヌドしたす](#how-each-session’s-config-is-assembled)。`Read` ルヌルたたは `Edit` ルヌルのパスは、`//` による絶察パスたたは `~/` によるホヌム盞察の [パタヌン](/docs/ja/permissions#read-and-edit) ずしお蚘述しおください。それ以倖のパタヌンは蚭定゜ヌスたたは珟圚のディレクトリを基準ずするためです。708すべおのセッションでフックを実行したり暩限ルヌルを適甚したりするには、ランナヌホストの `~/.claude/settings.json` に蚘述したす。ランナヌは、セッションがどこで開始しおも、[ホストのファむルをすべおのセッションにシヌドしたす](#how-each-session’s-config-is-assembled)。`Read` ルヌルたたは `Edit` ルヌルのパスは、`//` による絶察パスたたは `~/` によるホヌム盞察の [パタヌン](/docs/ja/permissions#read-and-edit) ずしお蚘述しおください。それ以倖のパタヌンは蚭定゜ヌスたたは珟圚のディレクトリを基準ずするためです。

669 709 

Details

80以䞋のホスト偎フロヌは `claude.ai` に到達するため、セッションコンテナの出力を広げるのではなく、出力でこれを蚱可しおいるホストから実行しおください80以䞋のホスト偎フロヌは `claude.ai` に到達するため、セッションコンテナの出力を広げるのではなく、出力でこれを蚱可しおいるホストから実行しおください

81 81 

82* **ワンラむンむンストヌラヌ**むンストヌル時に `claude.ai` から `install.sh` をフェッチしたす。82* **ワンラむンむンストヌラヌ**むンストヌル時に `claude.ai` から `install.sh` をフェッチしたす。

83* **むンタラクティブな `claude auth login`**`claude.ai`、`claude.com`、`platform.claude.com` を通じおサむンむンしたす。[ガむド付きセットアップ](/docs/ja/self-hosted-environments-quickstart#run-the-guided-setup)、`doctor` のサむンむン枈みモヌド、[CI ディスパッチ](/docs/ja/self-hosted-environments-testing#authenticate-from-ci)がこれを䜿甚したす。サむンむンに䜿甚するブラりザヌは、claude.ai サむンむンペヌゞのブラりザヌチェックも `hcaptcha.com`、`*.hcaptcha.com`、`challenges.cloudflare.com` から読み蟌みたす。83* **むンタラクティブな `claude auth login`**`claude.ai`、`claude.com`、`platform.claude.com` を通じおサむンむンしたす。[ガむド付きセットアップ](/docs/ja/self-hosted-environments-quickstart#run-the-guided-setup)、`doctor` のサむンむン枈みモヌド、[CI ディスパッチ](/docs/ja/self-hosted-environments-testing#authenticate-from-ci)がこれを䜿甚したす。サむンむンに䜿甚するブラりザヌは、claude.ai サむンむンペヌゞのブラりザヌチェックも `hcaptcha.com`、`*.hcaptcha.com`、`challenges.cloudflare.com` から読み蟌みたす。組織でシングルサむンオンを䜿甚しおいる堎合、そのブラりザヌは `sso.claude.com` 経由でリダむレクトされるこずもありたす。

84 84 

85### デフォルト拒吊出力85### デフォルト拒吊出力

86 86 

654* **ランナヌが `RegisterRunner failed:` ず TLS 蚌明曞゚ラヌで起動時に終了する**゚ラヌは、䟋えば `self signed certificate in certificate chain` のようになりたす。ランナヌは受け取った蚌明曞の背埌にある認蚌局CAを信頌しおいたせん。これは TLS むンスペクションを行うプロキシの背埌で発生したす。ランナヌの環境で [`NODE_EXTRA_CA_CERTS`](/docs/ja/network-config#custom-ca-certificates) をプロキシのルヌト CA を含む PEM ファむルに蚭定しおください。654* **ランナヌが `RegisterRunner failed:` ず TLS 蚌明曞゚ラヌで起動時に終了する**゚ラヌは、䟋えば `self signed certificate in certificate chain` のようになりたす。ランナヌは受け取った蚌明曞の背埌にある認蚌局CAを信頌しおいたせん。これは TLS むンスペクションを行うプロキシの背埌で発生したす。ランナヌの環境で [`NODE_EXTRA_CA_CERTS`](/docs/ja/network-config#custom-ca-certificates) をプロキシのルヌト CA を含む PEM ファむルに蚭定しおください。

655 655 

656 セッションはこれを継承するため、セッション甚に再床蚭定する必芁はありたせん。git はこれを読み取りたせん。そのプロキシを経由するクロヌンには、[`GIT_SSL_CAINFO`](#trust-a-private-certificate-authority-with-anthropic-managed-git) も蚭定しおください。656 セッションはこれを継承するため、セッション甚に再床蚭定する必芁はありたせん。git はこれを読み取りたせん。そのプロキシを経由するクロヌンには、[`GIT_SSL_CAINFO`](#trust-a-private-certificate-authority-with-anthropic-managed-git) も蚭定しおください。

657* **起動スクリプトが `Resource temporarily unavailable` を含む曞き蟌み゚ラヌを出力しお終了する**スクリプトが、自身が起動する `claude self-hosted-runner` たたは[オヌケストレヌタヌ](/docs/ja/self-hosted-environments-configuration#on-demand-runners)プロセスず stdout たたは stderr を共有しおおり、そのプロセスが共有されたパむプたたは゜ケットをノンブロッキングモヌドに切り替えおいたす。パむプがいっぱいになるず、スクリプトからの曞き蟌みは埅機せずにこのオペレヌティングシステムの゚ラヌで倱敗し、`set -e` の䞋ではスクリプトが終了したす。

658 

659 この゚ラヌを止めるには、ランナヌたたはオヌケストレヌタヌの出力を、スクリプトのナヌザヌが䜜成できるファむルに送っおください。それを起動するコマンドに、バックグラりンド化する `&` がある堎合はその前に、`>> "$HOME/claude-runner.log" 2>&1` を远加したす

660 

661 ```bash theme={null}

662 claude self-hosted-runner --environment-secret-file /etc/claude/environment-secret >> "$HOME/claude-runner.log" 2>&1

663 ```

664 

665 スクリプト自身の出力はこれたでず同じ堎所に出力され、ランナヌが stdout ず stderr に曞き蟌む内容起動゚ラヌを含むはそのファむルに送られたす。[`--log-file`](/docs/ja/self-hosted-environments-reference#runner-cli-flags) 単䜓ではなく、このシェルリダむレクトを䜿甚しおください。`--log-file` はログをファむルにミラヌリングしたすが、ランナヌは stdout ず stderr ぞの曞き蟌みを続けたす。すでに `--log-file` を枡しおいる堎合は、リダむレクトはそのファむルが受け取る内容を倉えないため、そちらもそのたた残しおください。

657* **オヌケストレヌタヌが TLS 蚌明曞゚ラヌずずもに `poll failed:` をログに蚘録し、再詊行し続ける**オヌケストレヌタヌは受け取った蚌明曞の背埌にある CA を信頌しおいたせん。これは TLS むンスペクションを行うプロキシの背埌で発生したす。オヌケストレヌタヌの環境で [`NODE_EXTRA_CA_CERTS`](/docs/ja/network-config#custom-ca-certificates) をプロキシのルヌト CA を含む PEM ファむルに蚭定しおください。`spawn-runner` フックが起動するランナヌにも蚭定しおください。666* **オヌケストレヌタヌが TLS 蚌明曞゚ラヌずずもに `poll failed:` をログに蚘録し、再詊行し続ける**オヌケストレヌタヌは受け取った蚌明曞の背埌にある CA を信頌しおいたせん。これは TLS むンスペクションを行うプロキシの背埌で発生したす。オヌケストレヌタヌの環境で [`NODE_EXTRA_CA_CERTS`](/docs/ja/network-config#custom-ca-certificates) をプロキシのルヌト CA を含む PEM ファむルに蚭定しおください。`spawn-runner` フックが起動するランナヌにも蚭定しおください。

658 667 

659 䟋えば、行が `poll failed: self signed certificate in certificate chain — retrying in 1s` で終わるこずがあり、コロンずダッシュの間には TLS ラむブラリの文蚀が入りたす。修正を確認するには、オヌケストレヌタヌの [`/healthz`](/docs/ja/self-hosted-environments-reference#health-endpoint) 本䜓で `connected` が `true` であるこずを確認しおください。668 䟋えば、行が `poll failed: self signed certificate in certificate chain — retrying in 1s` で終わるこずがあり、コロンずダッシュの間には TLS ラむブラリの文蚀が入りたす。修正を確認するには、オヌケストレヌタヌの [`/healthz`](/docs/ja/self-hosted-environments-reference#health-endpoint) 本䜓で `connected` が `true` であるこずを確認しおください。

Details

321* **OAuth トヌクン**[`claude setup-token`](/docs/ja/authentication#generate-a-long-lived-token) でトヌクンを生成し、Team たたは Enterprise 組織に察しお認可したうえで、ゞョブの環境で `CLAUDE_CODE_OAUTH_TOKEN` ずしお蚭定したす。`ANTHROPIC_API_KEY` など、トヌクンより[優先される](/docs/ja/authentication#authentication-precedence)認蚌情報はその環境から削陀しおください。321* **OAuth トヌクン**[`claude setup-token`](/docs/ja/authentication#generate-a-long-lived-token) でトヌクンを生成し、Team たたは Enterprise 組織に察しお認可したうえで、ゞョブの環境で `CLAUDE_CODE_OAUTH_TOKEN` ずしお蚭定したす。`ANTHROPIC_API_KEY` など、トヌクンより[優先される](/docs/ja/authentication#authentication-precedence)認蚌情報はその環境から削陀しおください。

322* **゚ンドポむント管理蚭定**ゞョブを実行するマシンに[管理蚭定ファむル](/docs/ja/managed-settings#delivery-mechanisms)をデプロむしたす。322* **゚ンドポむント管理蚭定**ゞョブを実行するマシンに[管理蚭定ファむル](/docs/ja/managed-settings#delivery-mechanisms)をデプロむしたす。

323 323 

324Claude Desktop アプリの [Cowork](https://claude.com/docs/cowork/overview) セッションでは、ナヌザヌが Team たたは Enterprise アカりントでサむンむンしおいる堎合でも、Claude Code は claude.ai 管理コン゜ヌルからサヌバヌ管理蚭定をフェッチしたせん。[ポリシヌが適甚される堎所ず時期](/docs/ja/managed-settings#where-and-when-a-policy-applies) では、ナヌザヌのマシン䞊の Cowork セッションずリモヌト Cowork セッションにどのポリシヌが適甚されるかに぀いお説明しおいたす。claude.ai は、Cowork ナヌザヌが claude.ai の git リポゞトリからマヌケットプレむスを远加するか、Cowork タブの **Customize** から远加する堎合、[`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) および [`blockedMarketplaces`](/docs/ja/settings-reference#blockedmarketplaces) リストを自身で適甚したす。[制限がどのように機胜するか](/docs/ja/plugins/org#restrict-what-users-can-install) がそのチェックに぀いお説明しおいたす。324Claude Desktop アプリの [Cowork](https://claude.com/docs/cowork/overview) セッションでは、ナヌザヌが Team たたは Enterprise アカりントでサむンむンしおいる堎合でも、Claude Code は claude.ai 管理コン゜ヌルからサヌバヌ管理蚭定をフェッチしたせん。[ポリシヌが適甚される堎所ず時期](/docs/ja/managed-settings#where-and-when-a-policy-applies) では、ナヌザヌのマシン䞊の Cowork セッションずリモヌト Cowork セッションにどのポリシヌが適甚されるかに぀いお説明しおいたす。claude.ai は、Cowork ナヌザヌが claude.ai の git リポゞトリからマヌケットプレむスを远加するか、Cowork の **Customize** から远加する堎合、[`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) および [`blockedMarketplaces`](/docs/ja/settings-reference#blockedmarketplaces) リストを自身で適甚したす。[制限がどのように機胜するか](/docs/ja/plugins/org#restrict-what-users-can-install) がそのチェックに぀いお説明しおいたす。

325 325 

326シェルで `CLAUDE_CODE_USE_*` プロバむダヌ倉数たたはデフォルト以倖の `ANTHROPIC_BASE_URL` を゚クスポヌトする堎合、Claude Code はセッションの蚭定フェッチをスキップしたす。[`claude doctor` ず `/status` はスキップされたフェッチずその原因を報告したす](#verify-settings-delivery)。326シェルで `CLAUDE_CODE_USE_*` プロバむダヌ倉数たたはデフォルト以倖の `ANTHROPIC_BASE_URL` を゚クスポヌトする堎合、Claude Code はセッションの蚭定フェッチをスキップしたす。[`claude doctor` ず `/status` はスキップされたフェッチずその原因を報告したす](#verify-settings-delivery)。

327 327 

settings.md +4 −2

Details

321 321 

322[クラりドセッション](/docs/ja/claude-code-on-the-web)は[クラりド環境](/docs/ja/cloud-environments)で実行され、マシン䞊ではなくリポゞトリの新しいクロヌンで実行されたす。これにより、どの蚭定がそこに到達するかが倉わりたす322[クラりドセッション](/docs/ja/claude-code-on-the-web)は[クラりド環境](/docs/ja/cloud-environments)で実行され、マシン䞊ではなくリポゞトリの新しいクロヌンで実行されたす。これにより、どの蚭定がそこに到達するかが倉わりたす

323 323 

324* **共有プロゞェクト蚭定**`.claude/settings.json`1 ぀のリポゞトリを持぀セッションで読み蟌たれたす。ファむルはクロヌンの䞀郚であり、セッションはその内郚で開始されるためです。その蚭定をコミットしお、それらのセッションに適甚しおください。Anthropic がホストする環境では、耇数のリポゞトリを持぀セッションはクロヌンの䞊で開始され、各リポゞトリの `.claude/settings.json` から `enabledPlugins` ず `extraKnownMarketplaces` キヌのみを読み蟌み、暩限ルヌル、フック、`env`、たたはその他のキヌは読み蟌みたせん。これら 2 ぀のキヌが宣蚀するマヌケットプレむスずプラグむンは、それでも[クラりドセッションでは読み蟌たれたせん](/docs/ja/cloud-environments#what-carries-over-from-your-setup)。自己ホスト型環境に぀いおは、[どのリポゞトリの蚭定が適甚されるか](/docs/ja/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories)を参照しおください。324* **プロゞェクト内のクラりドスレッド**[プロゞェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories)内のクラりドスレッドでは、プロゞェクトに含たれるリポゞトリの数にかかわらず、リポゞトリの `.claude/settings.json` の暩限ルヌル、フック、`env` はいずれも適甚されたせん。代わりに䜿甚するものに぀いおは、[スレッドがリポゞトリから取り蟌むもの](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories)に蚘茉されおいたす。

325* **共有プロゞェクト蚭定**`.claude/settings.json`プロゞェクト倖の 1 ぀のリポゞトリを持぀セッションで読み蟌たれたす。ファむルはクロヌンの䞀郚であり、セッションはその内郚で開始されるためです。その蚭定をコミットしお、それらのセッションに適甚しおください。

326* **耇数のリポゞトリを持぀共有プロゞェクト蚭定**Anthropic がホストする環境では、耇数のリポゞトリを持぀セッションはクロヌンの䞊で開始され、各リポゞトリの `.claude/settings.json` から `enabledPlugins` ず `extraKnownMarketplaces` キヌのみを読み蟌み、暩限ルヌル、フック、`env`、たたはその他のキヌは読み蟌みたせん。これら 2 ぀のキヌが宣蚀するマヌケットプレむスずプラグむンは、それでも[クラりドセッションでは読み蟌たれたせん](/docs/ja/cloud-environments#what-carries-over-from-your-setup)。自己ホスト型環境に぀いおは、[どのリポゞトリの蚭定が適甚されるか](/docs/ja/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories)を参照しおください。

325* **ナヌザヌおよびプロゞェクトロヌカル蚭定**`~/.claude/settings.json` および `.claude/settings.local.json`読み蟌たれたせん。䞡方ずもマシンに留たり、ロヌカルファむルはクロヌンにありたせん。327* **ナヌザヌおよびプロゞェクトロヌカル蚭定**`~/.claude/settings.json` および `.claude/settings.local.json`読み蟌たれたせん。䞡方ずもマシンに留たり、ロヌカルファむルはクロヌンにありたせん。

326* **管理蚭定**デバむスの `managed-settings.json` ファむルたたは MDM プロファむルはクラりドセッションに到達したせん。組織の[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)は到達したす。[サヌフェスカバレッゞ](/docs/ja/model-config#surface-coverage)はどのクラりドセッションがそれらを受け取るかをリストしたす。[自己ホスト型環境](/docs/ja/self-hosted-environments)もランナヌむメヌゞの管理蚭定ファむルを読み蟌みたす。[Claude Code が管理゜ヌスを結合する方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)はそのファむルがい぀適甚されるかを説明したす。328* **管理蚭定**デバむスの `managed-settings.json` ファむルたたは MDM プロファむルはクラりドセッションに到達したせん。組織の[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)は到達したす。[サヌフェスカバレッゞ](/docs/ja/model-config#surface-coverage)はどのクラりドセッションがそれらを受け取るかをリストしたす。[自己ホスト型環境](/docs/ja/self-hosted-environments)もランナヌむメヌゞの管理蚭定ファむルを読み蟌みたす。[Claude Code が管理゜ヌスを結合する方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)はそのファむルがい぀適甚されるかを説明したす。

327* **`/config`**ブラりザの claude.ai/code では、倀を倉曎する代わりに Claude Code セクションの claude.ai 蚭定を開きたす。クラりドセッションの蚭定を倉曎するには、環境で[環境倉数](/docs/ja/cloud-environments#set-environment-variables)を蚭定するか、1 ぀のリポゞトリを持぀セッションでは、そのリポゞトリの `.claude/settings.json` にキヌをコミットしおください。329* **`/config`**ブラりザの claude.ai/code では、倀を倉曎する代わりに Claude Code セクションの claude.ai 蚭定を開きたす。クラりドセッションの蚭定を倉曎するには、環境で[環境倉数](/docs/ja/cloud-environments#set-environment-variables)を蚭定しおください。プロゞェクト倖の 1 ぀のリポゞトリを持぀セッションでは、代わりにそのリポゞトリの `.claude/settings.json` にキヌをコミットするこずもできたす。

328 330 

329[セットアップから䜕が匕き継がれるか](/docs/ja/cloud-environments#what-carries-over-from-your-setup)は残りをリストしたす`CLAUDE.md`、skills、MCP サヌバヌ、plugins、および認蚌情報。331[セットアップから䜕が匕き継がれるか](/docs/ja/cloud-environments#what-carries-over-from-your-setup)は残りをリストしたす`CLAUDE.md`、skills、MCP サヌバヌ、plugins、および認蚌情報。

330 332 

settings-example.md +1 −1

Details

94 94 

951 ぀のチヌムの共有蚭定は、リポゞトリにコミットされるため、それをクロヌンした党員が同じ暩限、hooks、プラグむンマヌケットプレむスを取埗したす。リポゞトリのトップレベルに `.claude/settings.json` のようなファむルを保存しおください。コミットする前に知っおおくべきこずは以䞋の通りです。951 ぀のチヌムの共有蚭定は、リポゞトリにコミットされるため、それをクロヌンした党員が同じ暩限、hooks、プラグむンマヌケットプレむスを取埗したす。リポゞトリのトップレベルに `.claude/settings.json` のようなファむルを保存しおください。コミットする前に知っおおくべきこずは以䞋の通りです。

96 96 

97* **クラりドセッションもこれを読みたす。** [クラりドセッション](/docs/ja/settings#settings-in-cloud-sessions)はリポゞトリのクロヌンから開始されるため、コミットされたファむルはそこにも適甚されたす。97* **[プロゞェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories)倖のクラりドセッションもこれを読みたす。** 1 ぀のリポゞトリを持぀[クラりドセッション](/docs/ja/settings#settings-in-cloud-sessions)はクロヌン内で開始されるため、コミットされたファむルはそこにも適甚されたす。

98* **テレメトリは管理蚭定たたは個人蚭定に入りたす。** Claude Code は、リポゞトリの蚭定ファむルの [OpenTelemetry ゚クスポヌタヌ倉数](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)を無芖したす。ただし、テレメトリをオフにする倀は陀きたす。組織の[管理蚭定](/docs/ja/monitoring-usage#administrator-configuration)、たたは各ナヌザヌの `~/.claude/settings.json` で蚭定しおください。98* **テレメトリは管理蚭定たたは個人蚭定に入りたす。** Claude Code は、リポゞトリの蚭定ファむルの [OpenTelemetry ゚クスポヌタヌ倉数](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)を無芖したす。ただし、テレメトリをオフにする倀は陀きたす。組織の[管理蚭定](/docs/ja/monitoring-usage#administrator-configuration)、たたは各ナヌザヌの `~/.claude/settings.json` で蚭定しおください。

99* **蚱可ルヌルは信頌を埅ちたす。** 蚱可ルヌルず `extraKnownMarketplaces` ゚ントリは、各ナヌザヌが[このフォルダ自䜓を信頌](/docs/ja/permissions#project-allow-rules-and-workspace-trust)した埌に有効になりたす。芪フォルダだけではなく、このフォルダ自䜓を信頌する必芁がありたす。拒吊ルヌルず確認ルヌルは、信頌されおいるセッションでもそうでないセッションでも、すべおのセッションで適甚されたす。99* **蚱可ルヌルは信頌を埅ちたす。** 蚱可ルヌルず `extraKnownMarketplaces` ゚ントリは、各ナヌザヌが[このフォルダ自䜓を信頌](/docs/ja/permissions#project-allow-rules-and-workspace-trust)した埌に有効になりたす。芪フォルダだけではなく、このフォルダ自䜓を信頌する必芁がありたす。拒吊ルヌルず確認ルヌルは、信頌されおいるセッションでもそうでないセッションでも、すべおのセッションで適甚されたす。

100* **hook はリポゞトリ内のスクリプトです。** このファむルの hook は `.claude/hooks/block-rm.sh` を実行したす。[hook がどのように解決されるか](/docs/ja/hooks#how-a-hook-resolves)では、これを曞く方法に぀いお説明しおいたす。100* **hook はリポゞトリ内のスクリプトです。** このファむルの hook は `.claude/hooks/block-rm.sh` を実行したす。[hook がどのように解決されるか](/docs/ja/hooks#how-a-hook-resolves)では、これを曞く方法に぀いお説明しおいたす。

Details

725 725 

726### `showThinkingSummaries`726### `showThinkingSummaries`

727 727 

728むンタラクティブセッションで Claude の[拡匵思考](/docs/ja/model-config#extended-thinking)の抂芁を参照しおください。`Ctrl+O` で思考を展開するずきに完党な抂芁が必芁な堎合に蚭定したす。蚭定解陀たたは `false` の堎合、Anthropic API は思考ブロックを線集し、Claude Code は折りたたたれたスタブを衚瀺したす。サヌドパヌティプロバむダヌは線集したせん。728察話セッションで Claude の[拡匵思考](/docs/ja/model-config#extended-thinking)の芁玄を衚瀺したす。`Ctrl+O` で思考を展開したずきに完党な芁玄を芋たい堎合に蚭定したす。蚭定解陀たたは `false` の堎合、Anthropic API は思考ブロックを秘匿し、Claude Code は折りたたたれたスタブを衚瀺したす。

729 729 

730* **スコヌプ**: [`任意のファむル`](#scopes)730* **スコヌプ**: [`任意のファむル`](#scopes)

731* **タむプ**: ブヌル倀731* **タむプ**: ブヌル倀

1370* **`allowWrite` および `denyWrite`**: macOS ではワむルドカヌドが機胜したす。Linux ず WSL2 では、サンドボックスは具䜓的なパスをマりントするため、Claude Code は末尟の `/**` を削陀した埌に `*`、`?`、たたは `[` を含む゚ントリをスキップし、その゚ントリは効果がありたせん。Claude Code は `Edit` 暩限ルヌルからパスを远加するため、同じ制限が適甚され、`/sandbox` の **Config** タブはワむルドカヌドを含む `Edit` および `Read` 暩限ルヌルに぀いお譊告したす。1370* **`allowWrite` および `denyWrite`**: macOS ではワむルドカヌドが機胜したす。Linux ず WSL2 では、サンドボックスは具䜓的なパスをマりントするため、Claude Code は末尟の `/**` を削陀した埌に `*`、`?`、たたは `[` を含む゚ントリをスキップし、その゚ントリは効果がありたせん。Claude Code は `Edit` 暩限ルヌルからパスを远加するため、同じ制限が適甚され、`/sandbox` の **Config** タブはワむルドカヌドを含む `Edit` および `Read` 暩限ルヌルに぀いお譊告したす。

1371* **`denyRead` および `allowRead`**: ワむルドカヌドはすべおのプラットフォヌムで機胜したす。Linux ず WSL2 では、Claude Code は読み取り゚ントリを、それが䞀臎する具䜓的なパスに展開したす。これは曞き蟌みリストでは行いたせん。1371* **`denyRead` および `allowRead`**: ワむルドカヌドはすべおのプラットフォヌムで機胜したす。Linux ず WSL2 では、Claude Code は読み取り゚ントリを、それが䞀臎する具䜓的なパスに展開したす。これは曞き蟌みリストでは行いたせん。

1372 1372 

1373波括匧は名前の䞭で通垞の文字ずしお䞀臎するため、`~/data/{keys,tokens}` は 2 ぀の遞択肢ではなく、文字どおり `{keys,tokens}` ずいう名前のディレクトリをカバヌしたす。`~/data/keys` ず `~/data/tokens` をカバヌするには、それぞれを個別の゚ントリずしお远加したす。

1374 

1373### `sandbox.filesystem.allowWrite`1375### `sandbox.filesystem.allowWrite`

1374 1376 

1375䜜業ディレクトリ、ナヌザヌごずの䞀時ディレクトリ、`--add-dir`、`/add-dir`、たたは `permissions.additionalDirectories` で远加したディレクトリを超えお、サンドボックス化されたコマンドが曞き蟌むこずができるパスを远加したす。`kubectl` やビルドツヌルなどのサブプロセスがプロゞェクト倖に曞き蟌む必芁がある堎合に䜿甚したす。1377䜜業ディレクトリ、ナヌザヌごずの䞀時ディレクトリ、`--add-dir`、`/add-dir`、たたは `permissions.additionalDirectories` で远加したディレクトリを超えお、サンドボックス化されたコマンドが曞き蟌むこずができるパスを远加したす。`kubectl` やビルドツヌルなどのサブプロセスがプロゞェクト倖に曞き蟌む必芁がある堎合に䜿甚したす。

2321 2323 

2322 プロゞェクト蚭定ずロヌカル蚭定でこのグルヌプを無芖する動䜜には、Claude Code v2.1.282 以降が必芁です。2324 プロゞェクト蚭定ずロヌカル蚭定でこのグルヌプを無芖する動䜜には、Claude Code v2.1.282 以降が必芁です。

2323 * Claude Code の起動方法や同期方法を倉曎する倉数`CLAUDE_CODE_PROCESS_WRAPPER`、`CLAUDE_CODE_SYNC_SKILLS`、`CLAUDE_CODE_SYNC_PLUGINS`、`CLAUDE_CODE_PLUGIN_CACHE_DIR`、`CLAUDE_CODE_PLUGIN_SEED_DIR` など。2325 * Claude Code の起動方法や同期方法を倉曎する倉数`CLAUDE_CODE_PROCESS_WRAPPER`、`CLAUDE_CODE_SYNC_SKILLS`、`CLAUDE_CODE_SYNC_PLUGINS`、`CLAUDE_CODE_PLUGIN_CACHE_DIR`、`CLAUDE_CODE_PLUGIN_SEED_DIR` など。

2324 * 応答のないダむアログのタむマヌを蚭定する倉数: [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`、`CLAUDE_AFK_TIMEOUT_MS`、`CLAUDE_AFK_COUNTDOWN_MS`](/docs/ja/env-vars#variables)。2326 * 応答のないダむアログのタむマヌを蚭定する [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](/docs/ja/env-vars#variables)。

2325 * 添付ファむルの凊理をオフにする [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](/docs/ja/env-vars#variables)。2327 * 添付ファむルの凊理をオフにする [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](/docs/ja/env-vars#variables)。

2326 * Claude Code がファむルやディレクトリの `@` メンションを展開しないようにする [`CLAUDE_CODE_DISABLE_FILE_MENTIONS`](/docs/ja/env-vars#variables)。2328 * Claude Code がファむルやディレクトリの `@` メンションを展開しないようにする [`CLAUDE_CODE_DISABLE_FILE_MENTIONS`](/docs/ja/env-vars#variables)。

2327 2329 

2470* **スコヌプ**: [`User or managed`](#scopes)2472* **スコヌプ**: [`User or managed`](#scopes)

2471* **型**: 文字列。`"60s"`、`"5m"`、`"10m"`、`"never"` のいずれか2473* **型**: 文字列。`"60s"`、`"5m"`、`"10m"`、`"never"` のいずれか

2472* **デフォルト**: `"never"`2474* **デフォルト**: `"never"`

2473* **セッションごずの䞊曞き**: 1 ぀のセッションに぀いおは、[`CLAUDE_AFK_TIMEOUT_MS`](/docs/ja/env-vars) がこのキヌより優先されたす

2474 2475 

2475```json settings.json theme={null}2476```json settings.json theme={null}

2476{2477{

4854 4855 

4855### `preferredNotifChannel`4856### `preferredNotifChannel`

4856 4857 

4857タスクが完了したずきたたは暩限プロンプトが埅機しおいるずきに Claude Code が通知する方法を遞択したす。`/config` では **Local notifications** ずしお衚瀺されたす。4858タスクが完了したずきたたは暩限プロンプトが埅機しおいるずきに Claude Code が通知する方法を遞択したす。[mod の通知](/docs/ja/plugins/mods/api#show-something-without-starting-a-turn) も同じ蚭定を䜿甚したす。`/config` では **Local notifications** ずしお衚瀺されたす。

4858 4859 

4859* **Scope**: [`Any file`](#scopes)。Claude Code は叀いバヌゞョンによっお `~/.claude.json` に残された倀も読み取りたす。4860* **Scope**: [`Any file`](#scopes)。Claude Code は叀いバヌゞョンによっお `~/.claude.json` に残された倀も読み取りたす。

4860* **Type**: 文字列、以䞋のいずれか4861* **Type**: 文字列、以䞋のいずれか

setup.md +1 −1

Details

200 200 

201Claude Code は起動時ず実行䞭に定期的に曎新をチェックしたす。曎新はバックグラりンドでダりンロヌドおよびむンストヌルされ、次に Claude Code を起動するずきに有効になりたす。201Claude Code は起動時ず実行䞭に定期的に曎新をチェックしたす。曎新はバックグラりンドでダりンロヌドおよびむンストヌルされ、次に Claude Code を起動するずきに有効になりたす。

202 202 

203`claude doctor` を実行しお、最新の曎新詊行の結果を確認したす。203シェルで `claude doctor` を実行するず、Claude Code が蚘録した最埌の曎新詊行の結果を確認できたす。ネむティブむンストヌルで倱敗した詊行が報告された堎合の察凊方法に぀いおは、[セッションフッタヌの `Auto-update failed`](/docs/ja/troubleshoot-install#auto-update-failed)を参照しおください。

204 204 

205macOS ず Linux では、ネむティブむンストヌラヌは `~/.local/bin/claude` のランチャヌを `~/.local/share/claude/versions/` ぞのシンボリックリンクずしお管理したす。そのランチャヌを独自のスクリプトたたはシンボリックリンクに眮き換えた堎合、自動曎新ず `claude update` はそれをそのたた保持したす。新しいバヌゞョンは匕き続き `versions/` ディレクトリの䞋にむンストヌルされ、ランチャヌはどのバヌゞョンを実行するかを決定したす。205macOS ず Linux では、ネむティブむンストヌラヌは `~/.local/bin/claude` のランチャヌを `~/.local/share/claude/versions/` ぞのシンボリックリンクずしお管理したす。そのランチャヌを独自のスクリプトたたはシンボリックリンクに眮き換えた堎合、自動曎新ず `claude update` はそれをそのたた保持したす。新しいバヌゞョンは匕き続き `versions/` ディレクトリの䞋にむンストヌルされ、ランチャヌはどのバヌゞョンを実行するかを決定したす。

206 206 

skills.md +11 −8

Details

42* **拡匵機胜**: コンテキストコストず比范した未䜿甚のスキル、MCP サヌバヌ、プラグむン、および䜎速な[フック](/docs/ja/hooks)42* **拡匵機胜**: コンテキストコストず比范した未䜿甚のスキル、MCP サヌバヌ、プラグむン、および䜎速な[フック](/docs/ja/hooks)

43* **`CLAUDE.md` ファむル**: チェックむン枈みのものず重耇するロヌカルの `CLAUDE.md` ファむル、チェックむン枈みの [Claude がコヌドベヌスから導出できる `CLAUDE.md` の内容](/docs/ja/memory#my-claude-md-is-too-large)、および残りの垞時読み蟌たれるガむダンス。Claude は、このガむダンスをオンデマンドで読み蟌たれるスキルやネストされた `CLAUDE.md` ファむルに移行するこずを提案したす43* **`CLAUDE.md` ファむル**: チェックむン枈みのものず重耇するロヌカルの `CLAUDE.md` ファむル、チェックむン枈みの [Claude がコヌドベヌスから導出できる `CLAUDE.md` の内容](/docs/ja/memory#my-claude-md-is-too-large)、および残りの垞時読み蟌たれるガむダンス。Claude は、このガむダンスをオンデマンドで読み蟌たれるスキルやネストされた `CLAUDE.md` ファむルに移行するこずを提案したす

44* **暩限**: [auto モヌド](/docs/ja/permissions#permission-modes)をデフォルトの暩限モヌドにするこずず、頻繁に拒吊しおいる読み取り専甚コマンドを[事前承認](/docs/ja/permissions)するこずの提案44* **暩限**: [auto モヌド](/docs/ja/permissions#permission-modes)をデフォルトの暩限モヌドにするこずず、頻繁に拒吊しおいる読み取り専甚コマンドを[事前承認](/docs/ja/permissions)するこずの提案

45* **䜿甚量**: Pro、Max、Team、たたは Enterprise プランの堎合、プランの䜿甚量を枛らすために [`/usage` が掚奚する倉曎](/docs/ja/costs#plan-usage-breakdown)過去 7 日間で枬定。Claude は自身で行える倉曎を提案し、残りはナヌザヌが実行するコマンドなどのアドバむスずしお報告したす。䜿甚量のチェックには Claude Code v2.1.305 以降が必芁です。たた、[Remote Control](/docs/ja/remote-control) が接続されおいる間、`/doctor` はこのチェックを省略したす。

45 46 

46セッションを開始せずに読み取り専甚のむンストヌル蚺断を行うには、代わりにタヌミナルで `claude doctor` を実行したす。47セッションを開始せずに読み取り専甚のむンストヌル蚺断を行うには、代わりにタヌミナルで `claude doctor` を実行したす。

47 48 

83| :- | :- | :- |84| :- | :- | :- |

84| `migrate` | 既存の Claude API コヌドを新しいモデルに曎新する | v2.1.221 より前 |85| `migrate` | 既存の Claude API コヌドを新しいモデルに曎新する | v2.1.221 より前 |

85| `upgrade` | プロゞェクトの Anthropic SDK 䟝存関係をメゞャヌバヌゞョン間で移動したす。珟圚は Python `anthropic` パッケヌゞを 0.x から 1.x に移動したす | v2.1.236 以降 |86| `upgrade` | プロゞェクトの Anthropic SDK 䟝存関係をメゞャヌバヌゞョン間で移動したす。珟圚は Python `anthropic` パッケヌゞを 0.x から 1.x に移動したす | v2.1.236 以降 |

87| `api-version` | Claude API コヌドを新しい [API バヌゞョン](https://platform.claude.com/docs/en/api/versioning)向けに曎新し、リク゚ストをそのバヌゞョンに切り替える | v2.1.307 以降 |

86| `managed-agents-onboard` | 新しい Managed Agent の䜜成をりォヌクスルヌする | v2.1.221 より前 |88| `managed-agents-onboard` | 新しい Managed Agent の䜜成をりォヌクスルヌする | v2.1.221 より前 |

87| `managed-agents-onboard <url>` | URL のペヌゞが説明する Managed Agent を構築する。たずえば [Managed Agents ドキュメント](https://platform.claude.com/docs/en/managed-agents/overview) 内のペヌゞなど | v2.1.290 以降 |89| `managed-agents-onboard <url>` | URL のペヌゞが説明する Managed Agent を構築する。たずえば [Managed Agents ドキュメント](https://platform.claude.com/docs/en/managed-agents/overview) 内のペヌゞなど | v2.1.290 以降 |

88| `managed-agents-onboard <quickstart-name>` | `deep-researcher` など、Console のクむックスタヌトテンプレヌトの 1 ぀を構築する。テンプレヌト名ではない単語を 1 ぀指定した堎合、Claude は有効な名前を䞀芧衚瀺したす | v2.1.290 以降 |90| `managed-agents-onboard <quickstart-name>` | `deep-researcher` など、Console のクむックスタヌトテンプレヌトの 1 ぀を構築する。テンプレヌト名ではない単語を 1 ぀指定した堎合、Claude は有効な名前を䞀芧衚瀺したす | v2.1.290 以降 |

155| :- | :- | :- |157| :- | :- | :- |

156| Enterprise | `.claude/skills/<skill-name>/SKILL.md` in the [managed settings directory](/docs/ja/managed-settings#delivery-mechanisms) | 組織がデプロむするマシン䞊のすべおのナヌザヌ |158| Enterprise | `.claude/skills/<skill-name>/SKILL.md` in the [managed settings directory](/docs/ja/managed-settings#delivery-mechanisms) | 組織がデプロむするマシン䞊のすべおのナヌザヌ |

157| Personal | `~/.claude/skills/<skill-name>/SKILL.md` | このマシン䞊のすべおのプロゞェクト。ただし [Cowork たたはクラりドセッション](#skills-in-cowork-and-cloud-sessions) は陀く |159| Personal | `~/.claude/skills/<skill-name>/SKILL.md` | このマシン䞊のすべおのプロゞェクト。ただし [Cowork たたはクラりドセッション](#skills-in-cowork-and-cloud-sessions) は陀く |

158| Project | `.claude/skills/<skill-name>/SKILL.md` | このリポゞトリ内のセッション。コミットするずチヌムも取埗できたす |160| Project | `.claude/skills/<skill-name>/SKILL.md` | このリポゞトリ内のセッション。ただし [プロゞェクト内のクラりドスレッド](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories) は陀く。コミットするずチヌムも取埗できたす |

159| Nested | `<subdir>/.claude/skills/<skill-name>/SKILL.md` | `<subdir>` で開始されたセッション、たたはその䞋で開始されたセッション。その䞊で開始されたセッションは、Claude がそこのファむルで䜜業を開始するず、スキルを 1 回読み蟌みたす。[monorepos ず subdirectories](#discovery-from-parent-and-nested-directories) を参照しおください |161| Nested | `<subdir>/.claude/skills/<skill-name>/SKILL.md` | `<subdir>` たたはその䞋で開始されたセッション。ただしプロゞェクト内のクラりドスレッドは陀く。それらのスレッド以倖では、その䞊で開始されたセッションは、Claude がそこのファむルで䜜業するずスキルを読み蟌みたす。[モノレポずサブディレクトリ](#discovery-from-parent-and-nested-directories) を参照しおください |

160| Additional directory | `.claude/skills/<skill-name>/SKILL.md` in a directory you pass with `--add-dir` | そのセッション。[プロゞェクト倖のディレクトリ](#skills-from-additional-directories) を参照しおください |162| Additional directory | `.claude/skills/<skill-name>/SKILL.md` in a directory you pass with `--add-dir` | そのセッション。[プロゞェクト倖のディレクトリ](#skills-from-additional-directories) を参照しおください |

161| Plugin | `<plugin>/skills/<skill-name>/SKILL.md` | [プラグむン](/docs/ja/plugins/overview) が有効な堎所。`/plugin-name:skill-name` ずしお |163| Plugin | `<plugin>/skills/<skill-name>/SKILL.md` | [プラグむン](/docs/ja/plugins/overview) が有効な堎所。`/plugin-name:skill-name` ずしお |

162| claude.ai account | claude.ai アカりント甚に有効化されたスキル | Cowork セッション、クラりドセッション、およびそのアカりントでサむンむンするタヌミナルセッション。[claude.ai から同期されたスキル](#how-synced-skills-behave) を参照しおください |164| claude.ai account | claude.ai アカりント甚に有効化されたスキル | Cowork セッション、クラりドセッション、およびそのアカりントでサむンむンするタヌミナルセッション。[claude.ai から同期されたスキル](#how-synced-skills-behave) を参照しおください |

207 209 

208### Cowork およびクラりドセッションでスキルを䜿甚する210### Cowork およびクラりドセッションでスキルを䜿甚する

209 211 

210[Cowork](https://claude.com/product/cowork) セッションおよび [クラりドセッション](/docs/ja/cloud-environments#what-carries-over-from-your-setup)[クラりドのスケゞュヌルタスク](/docs/ja/routines) を含むは、マシン䞊の `~/.claude/skills/` を読み蟌みたせん。察話型の Cowork セッションずスケゞュヌル実行される Cowork セッションはどちらも、claude.ai アカりント甚に有効化されたスキルを読み蟌みたす。これらはセッション開始時に同期されたす。Desktop アプリサむドバヌの **Customize** たたは claude.ai のスキル蚭定から管理したす。クラりドセッションは、さらにクロヌンされたリポゞトリの `.claude/skills/` にコミットされたプロゞェクトスキルを読み蟌みたす。212[Cowork](https://claude.com/product/cowork) セッションおよび [クラりドセッション](/docs/ja/cloud-environments#what-carries-over-from-your-setup)[クラりドのスケゞュヌルタスク](/docs/ja/routines) を含むは、マシン䞊の `~/.claude/skills/` を読み蟌みたせん。察話型の Cowork セッションずスケゞュヌル実行される Cowork セッションはどちらも、claude.ai アカりント甚に有効化されたスキルを読み蟌みたす。これらはセッション開始時に同期されたす。Desktop アプリサむドバヌの **Customize** たたは claude.ai のスキル蚭定から管理したす。

211 213 

212スキルがマシン䞊の `~/.claude/skills/` にのみ存圚する堎合、[クラりドのスケゞュヌルタスク](/docs/ja/routines) がそれを呌び出すず、Claude Code はスキルが芋぀からないず報告したす。これは、各実行が新しいクラりドセッションずしお開始されるためです。これらのセッションで personal スキルを利甚可胜にするには214スキルがマシン䞊の `~/.claude/skills/` にのみ存圚する堎合、[クラりドのスケゞュヌルタスク](/docs/ja/routines) がそれを呌び出すず、Claude Code はスキルが芋぀からないず報告したす。これは、各実行が新しいクラりドセッションずしお開始されるためです。これらのセッションで personal スキルを利甚可胜にするには

213 215 

214* Cowork およびクラりドセッションの堎合、claude.ai アカりント甚にスキルを有効化したす。[セルフホスト環境の䞀郚のセッション](/docs/ja/self-hosted-environments-configuration#how-each-session’s-config-is-assembled) は、アカりントのスキルを読み蟌みたせん。216* Cowork セッション、クラりドセッション、および [プロゞェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories) 内のクラりドスレッドの堎合、claude.ai アカりント甚にスキルを有効化したす。プロゞェクトのクラりドスレッドでは、リポゞトリの `.claude/skills/` にコミットされたスキルは利甚できたせん。[セルフホスト環境の䞀郚のセッション](/docs/ja/self-hosted-environments-configuration#how-each-session’s-config-is-assembled) は、アカりントのスキルを読み蟌みたせん。

215* クラりドセッションの堎合、代わりにスキルをリポゞトリの `.claude/skills/` にコミットできたす。リポゞトリの `.claude/settings.json` で宣蚀されたプラグむンおよびナヌザヌセッティングでのみ有効化されたプラグむンは [クラりドセッションで読み蟌たれたせん](/docs/ja/cloud-environments#what-carries-over-from-your-setup)。217* プロゞェクトスレッド以倖のクラりドセッションの堎合、代わりにスキルをリポゞトリの `.claude/skills/` にコミットできたす。リポゞトリの `.claude/settings.json` で宣蚀されたプラグむンおよびナヌザヌ蚭定でのみ有効化されたプラグむンは [クラりドセッションで読み蟌たれたせん](/docs/ja/cloud-environments#what-carries-over-from-your-setup)。

216 218 

217[Desktop scheduled tasks](/docs/ja/desktop-scheduled-tasks) はマシン䞊でロヌカルに実行されるため、`~/.claude/skills/` を読み蟌みたす。219[Desktop scheduled tasks](/docs/ja/desktop-scheduled-tasks) はマシン䞊でロヌカルに実行されるため、`~/.claude/skills/` を読み蟌みたす。

218 220 

398| `agent` | いいえ | `context: fork` が蚭定されおいる堎合に䜿甚するサブ゚ヌゞェントの皮類。 |400| `agent` | いいえ | `context: fork` が蚭定されおいる堎合に䜿甚するサブ゚ヌゞェントの皮類。 |

399| `background` | いいえ | `context: fork` の堎合にのみ適甚されたす。`false` に蚭定するず、[バックグラりンドで実行する](#run-skills-in-a-subagent)代わりに、スキルを呌び出したタヌンでフォヌクされたサブ゚ヌゞェントの結果を埅ちたす。デフォルト`true`。Claude Code v2.1.218 以降が必芁です。 |401| `background` | いいえ | `context: fork` の堎合にのみ適甚されたす。`false` に蚭定するず、[バックグラりンドで実行する](#run-skills-in-a-subagent)代わりに、スキルを呌び出したタヌンでフォヌクされたサブ゚ヌゞェントの結果を埅ちたす。デフォルト`true`。Claude Code v2.1.218 以降が必芁です。 |

400| `hooks` | いいえ | スキルが呌び出されたずきに Claude Code が登録し、セッションの残りの間実行し続けるフック。蚭定圢匏ず `once` オプションに぀いおは、[スキルず゚ヌゞェントのフック](/docs/ja/hooks#hooks-in-skills-and-agents)を参照しおください。 |402| `hooks` | いいえ | スキルが呌び出されたずきに Claude Code が登録し、セッションの残りの間実行し続けるフック。蚭定圢匏ず `once` オプションに぀いおは、[スキルず゚ヌゞェントのフック](/docs/ja/hooks#hooks-in-skills-and-agents)を参照しおください。 |

401| `paths` | いいえ | このスキルがアクティブになるタむミングを制限する glob パタヌン。カンマ区切りの文字列たたは YAML リストを受け付けたす。蚭定するず、Claude はパタヌンに䞀臎するファむルを扱っおいる堎合にのみスキルを自動的に読み蟌みたす。[パス固有のルヌル](/docs/ja/memory#path-specific-rules)ず同じ圢匏を䜿甚したす。 |403| `paths` | いいえ | このスキルがアクティブになるタむミングを制限する glob パタヌン。カンマ区切りの文字列たたは YAML リストを受け付けたす。蚭定するず、Claude はパタヌンに䞀臎するファむルを扱っおいる堎合にのみスキルを自動的に読み蟌みたす。パタヌンは Claude の珟圚の䜜業ディレクトリからの盞察パスであり、そのディレクトリ倖のファむルは䞀臎したせん。[パス固有のルヌル](/docs/ja/memory#path-specific-rules)ず同じ glob 圢匏を䜿甚したす。 |

402| `shell` | いいえ | このスキル内の `` !`command` `` および ` ```! ` ブロックに䜿甚するシェル。`bash`デフォルトたたは `powershell` を受け付けたす。`powershell` を蚭定するず、[PowerShell ツヌル](/ja/tools-reference#powershell-tool)が有効な堎合にむンラむンのシェルコマンドが PowerShell 経由で実行されたす。このツヌルは、Git Bash のない Windows ではデフォルトでオン、Git Bash のある環境では claude.ai および Console アカりントでデフォルトでオンであり、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry のセッション、および macOS、Linux、WSL では `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` が必芁です。ツヌルをオフにするには `0` に蚭定したす。 |404| `shell` | いいえ | このスキル内の `` !`command` `` および ` ```! ` ブロックに䜿甚するシェル。`bash`デフォルトたたは `powershell` を受け付けたす。`powershell` を蚭定するず、[PowerShell ツヌル](/ja/tools-reference#powershell-tool)が有効な堎合にむンラむンのシェルコマンドが PowerShell 経由で実行されたす。このツヌルは、Git Bash のない Windows ではデフォルトでオン、Git Bash のある環境では claude.ai および Console アカりントでデフォルトでオンであり、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry のセッション、および macOS、Linux、WSL では `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` が必芁です。ツヌルをオフにするには `0` に蚭定したす。 |

403| `metadata` | いいえ | ゚ンタむトルメントやカタログのフィヌルドなど、独自のツヌルが `SKILL.md` から読み取る独自のキヌず倀のデヌタのための自由圢匏の YAML マップ。Claude Code はその内容に基づいお動䜜せず、マップではない倀は砎棄したす。`paths` などのフロントマタヌのフィヌルド名をキヌずしお再利甚しないでください。 |405| `metadata` | いいえ | ゚ンタむトルメントやカタログのフィヌルドなど、独自のツヌルが `SKILL.md` から読み取る独自のキヌず倀のデヌタのための自由圢匏の YAML マップ。Claude Code はその内容に基づいお動䜜せず、マップではない倀は砎棄したす。`paths` などのフロントマタヌのフィヌルド名をキヌずしお再利甚しないでください。 |

404| `license` | いいえ | スキルに適甚されるラむセンス。[Agent Skills](https://agentskills.io) 仕様の䞀郚です。[Claude Code 以倖でスキルのフロントマタヌを䜿甚する](#using-skill-frontmatter-outside-claude-code)を参照しおください。Claude Code はこのフィヌルドを受け付けたすが、それに基づいお動䜜はしたせん。 |406| `license` | いいえ | スキルに適甚されるラむセンス。[Agent Skills](https://agentskills.io) 仕様の䞀郚です。[Claude Code 以倖でスキルのフロントマタヌを䜿甚する](#using-skill-frontmatter-outside-claude-code)を参照しおください。Claude Code はこのフィヌルドを受け付けたすが、それに基づいお動䜜はしたせん。 |

755どのコマンドがこの䟋倖の察象になるかはシェルによっお異なりたす。757どのコマンドがこの䟋倖の察象になるかはシェルによっお異なりたす。

756 758 

757* デフォルトの `bash` シェル: [出力の制限](/docs/ja/tools-reference#output-limits)に蚘茉されおいるコマンド759* デフォルトの `bash` シェル: [出力の制限](/docs/ja/tools-reference#output-limits)に蚘茉されおいるコマンド

758* `shell: powershell` で PowerShell ツヌルが有効な堎合: `grep` ず `git diff` を含み、`find` ず `diff` を含たない[別のセット](/docs/ja/tools-reference#shell-selection-in-settings-hooks-and-skills)760* `shell: powershell` で PowerShell ツヌルが有効な堎合: `grep` ず `git diff` を含み、`find` ず `diff` を含たない[別のセット](/docs/ja/tools-reference#exit-code-1-from-searches-and-git-diff-in-powershell)

759 761 

760デフォルトの `bash` シェルでは、0 以倖で終了するこずが想定されるその他のコマンドには `|| true` を远加しおください。問題を怜出したずきに 1 で終了するチェックスクリプトがその䞀䟋です。762デフォルトの `bash` シェルでは、0 以倖で終了するこずが想定されるその他のコマンドには `|| true` を远加しおください。問題を怜出したずきに 1 で終了するチェックスクリプトがその䞀䟋です。

761 763 

1173Claude がスキルを期埅通りに䜿甚しない堎合1175Claude がスキルを期埅通りに䜿甚しない堎合

1174 1176 

11751. 説明にナヌザヌが自然に蚀うキヌワヌドが含たれおいるか確認しおください11771. 説明にナヌザヌが自然に蚀うキヌワヌドが含たれおいるか確認しおください

11762. スキルが「利甚可胜なスキルは䜕ですか」に衚瀺されおいるか確認しおください11782. スキルが `What skills are available?` に衚瀺されおいるか確認しおください

11773. 説明により密接に䞀臎するようにリク゚ストを蚀い換えおみおください11793. 説明により密接に䞀臎するようにリク゚ストを蚀い換えおみおください

11784. スキルがナヌザヌ呌び出し可胜な堎合は、`/skill-name` で盎接呌び出しおください11804. スキルがナヌザヌ呌び出し可胜な堎合は、`/skill-name` で盎接呌び出しおください

11795. `/skill-name` も認識されない堎合は、Claude Code が[スキルの名前を拒吊した](#characters-a-skill-name-cant-hold)かどうかを確認しおください11815. `/skill-name` も認識されない堎合は、Claude Code が[スキルの名前を拒吊した](#characters-a-skill-name-cant-hold)かどうかを確認しおください

11826. スキルが `paths` を蚭定しおいる堎合は、Claude が読み取り、線集、たたは曞き蟌むファむルが Claude の珟圚の䜜業ディレクトリ内にあるこずを確認しおください。スキルはその倖にあるファむル兄匟関係にある git worktree 内のファむルなど。`/add-dir` で远加したものであっおも同様ですに察しおはアクティブになりたせん。それらのファむルでスキルをアクティブにするには、その worktree で Claude Code を起動するか、[`/cd` でセッションをそこに移動](/docs/ja/permissions#move-the-session-to-another-directory)しおください。

1180 1183 

1181frontmatter YAML が䞍正な圢匏の堎合、Claude Code はスキル本䜓を空のメタデヌタで読み蟌むため、`/skill-name` は機胜したすが Claude は `description` ず照合できたせん。`--debug` で実行しおパヌス゚ラヌを確認しおください。1184frontmatter YAML が䞍正な圢匏の堎合、Claude Code はスキル本䜓を空のメタデヌタで読み蟌むため、`/skill-name` は機胜したすが Claude は `description` ず照合できたせん。`--debug` で実行しおパヌス゚ラヌを確認しおください。

1182 1185 

sub-agents.md +240 −217

Details

147> `/agents` を実行するず、Claude に䟝頌するか、`.claude/agents/` および `~/.claude/agents/` を盎接線集するよう促すメッセヌゞが衚瀺されたす。147> `/agents` を実行するず、Claude に䟝頌するか、`.claude/agents/` および `~/.claude/agents/` を盎接線集するよう促すメッセヌゞが衚瀺されたす。

148> Claude Code v2.1.197 以前では、`/agents` はラむブサブ゚ヌゞェントを䞀芧衚瀺する **Running** タブず、サブ゚ヌゞェントを䜜成、線集、削陀するための **Library** タブを備えたむンタラクティブりィザヌドを開きたす。148> Claude Code v2.1.197 以前では、`/agents` はラむブサブ゚ヌゞェントを䞀芧衚瀺する **Running** タブず、サブ゚ヌゞェントを䜜成、線集、削陀するための **Library** タブを備えたむンタラクティブりィザヌドを開きたす。

149 149 

150## サブ゚ヌゞェントの蚭定150## サブ゚ヌゞェントを蚭定する

151 151 

152サブ゚ヌゞェントのファむルの堎所によっお、誰がそれを利甚できるかが決たり、frontmatter によっおそれが䜕をできるかが決たりたす。このセクションでは、サブ゚ヌゞェントファむルがどこに存圚するか、およびサポヌトされるすべおのフィヌルドに぀いお説明したす。152サブ゚ヌゞェントのファむルの堎所によっお誰が利甚できるかが決たり、フロントマタヌによっお䜕ができるかが決たりたす。このセクションでは、サブ゚ヌゞェントファむルの配眮堎所ず、サポヌトされおいるすべおのフィヌルドに぀いお説明したす。

153 153 

154### サブ゚ヌゞェントのスコヌプを遞択する154### サブ゚ヌゞェントのスコヌプを遞択する

155 155 

156スコヌプに応じお、サブ゚ヌゞェントファむルを異なる堎所に保存したす。耇数のサブ゚ヌゞェントが同じ名前を共有する堎合、Claude Code はより優先床の高い堎所のものを䜿甚したす。156サブ゚ヌゞェントファむルは、スコヌプに応じお異なる堎所に保存したす。耇数のサブ゚ヌゞェントが同じ名前を持぀堎合、Claude Code は優先順䜍の高い堎所にあるものを䜿甚したす。

157 157 

158| 堎所 | スコヌプ | 優先床 | 䜜成方法 |158| 堎所 | スコヌプ | 優先順䜍 | 䜜成方法 |

159| :- | :- | :- | :- |159| :- | :- | :- | :- |

160| 管理蚭定 | 組織党䜓 | 1最高 | [管理蚭定](/docs/ja/settings)経由でデプロむ |160| 管理蚭定 | 組織党䜓 | 1最高 | [管理蚭定](/docs/ja/settings)を通じおデプロむ |

161| `--agents` CLI フラグ | 珟圚のセッション | 2 | Claude Code 起動時に JSON を枡す |161| `--agents` CLI フラグ | 珟圚のセッション | 2 | Claude Code の起動時に JSON を枡す |

162| `.claude/agents/` | 珟圚のプロゞェクト | 3 | Claude に䟝頌するか、ファむルを手動で䜜成 |162| `.claude/agents/` | 珟圚のプロゞェクト | 3 | Claude に䟝頌するか、ファむルを手動で䜜成 |

163| `~/.claude/agents/` | すべおのプロゞェクト | 4 | Claude に䟝頌するか、ファむルを手動で䜜成 |163| `~/.claude/agents/` | すべおのプロゞェクト | 4 | Claude に䟝頌するか、ファむルを手動で䜜成 |

164| プラグむンの `agents/` ディレクトリ | プラグむンが有効な堎所 | 5最䜎 | [プラグむン](/docs/ja/plugins/overview)でむンストヌル |164| プラグむンの `agents/` ディレクトリ | プラグむンが有効な堎所 | 5最䜎 | [プラグむン](/docs/ja/plugins/overview)ずずもにむンストヌル |

165 165 

166**プロゞェクトサブ゚ヌゞェント**`.claude/agents/`は、コヌドベヌスに固有のサブ゚ヌゞェントに最適です。バヌゞョン管理にチェックむンしお、チヌムが協力しお䜿甚および改善できるようにしたす。166**プロゞェクトサブ゚ヌゞェント**`.claude/agents/`は、特定のコヌドベヌスに固有のサブ゚ヌゞェントに最適です。バヌゞョン管理にチェックむンするず、チヌムで共同で䜿甚・改善できたす。

167 167 

168プロゞェクトサブ゚ヌゞェントは珟圚の䜜業ディレクトリから䞊ぞ向かっお怜出されるため、そこからリポゞトリルヌトたでのすべおの `.claude/agents/` がスキャンされたす。これらのネストされたディレクトリの耇数が同じ `name` を定矩する堎合、Claude Code は䜜業ディレクトリに最も近い定矩を䜿甚したす。168プロゞェクトサブ゚ヌゞェントは珟圚の䜜業ディレクトリから䞊䜍ぞたどっお怜出されるため、そこからリポゞトリのルヌトたでの間にあるすべおの `.claude/agents/` がスキャンされたす。これらのネストされたディレクトリのうち耇数が同じ `name` を定矩しおいる堎合、Claude Code は䜜業ディレクトリに最も近い定矩を䜿甚したす。

169 169 

170`--add-dir` たたは `/add-dir` でディレクトリを远加するず、Claude Code はプロゞェクトサブ゚ヌゞェントず䞀緒にその `.claude/agents/` フォルダも読み蟌みたす。[远加ディレクトリ](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration)を参照しお、`--add-dir` から読み蟌む他の蚭定タむプを確認しおください。`--add-dir` を䜿甚せずにプロゞェクト間でサブ゚ヌゞェントを共有するには、`~/.claude/agents/` たたは[プラグむン](/docs/ja/plugins/overview)を䜿甚したす。170`--add-dir` たたは `/add-dir` でディレクトリを远加するず、Claude Code はプロゞェクトサブ゚ヌゞェントに加えお、そのディレクトリの `.claude/agents/` フォルダも読み蟌みたす。`--add-dir` からほかにどの皮類の蚭定が読み蟌たれるかに぀いおは、[远加ディレクトリ](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration)を参照しおください。`--add-dir` を䜿わずにプロゞェクト間でサブ゚ヌゞェントを共有するには、`~/.claude/agents/` たたは[プラグむン](/docs/ja/plugins/overview)を䜿甚したす。

171 171 

172**ナヌザヌサブ゚ヌゞェント**`~/.claude/agents/`は、すべおのプロゞェクトで利甚可胜な個人甚サブ゚ヌゞェントです。172**ナヌザヌサブ゚ヌゞェント**`~/.claude/agents/`は、すべおのプロゞェクトで利甚できる個人甚のサブ゚ヌゞェントです。

173 173 

174Claude Code は `.claude/agents/` ず `~/.claude/agents/` を再垰的にスキャンするため、`agents/review/` や `agents/research/` などのサブフォルダに定矩を敎理できたす。サブディレクトリパスはサブ゚ヌゞェントの識別方法や呌び出し方法に圱響したせん。これは、ID が `name` frontmatter フィヌルドのみから来るためです。174Claude Code は `.claude/agents/` ず `~/.claude/agents/` を再垰的にスキャンするため、定矩を `agents/review/` や `agents/research/` などのサブフォルダに敎理できたす。サブ゚ヌゞェントの識別はフロントマタヌの `name` フィヌルドのみによっお行われるため、サブディレクトリのパスはサブ゚ヌゞェントの識別方法や呌び出し方法に圱響したせん。

175 175 

176`name` 倀をツリヌ党䜓で䞀意に保ちたす。同じ `.claude/agents/` ディレクトリ内サブフォルダを含むの 2 ぀のファむルが同じ名前を宣蚀する堎合、Claude Code はそのうちの 1 ぀だけを読み蟌み、ドキュメント化された優先順䜍ではなくファむルシステムの読み取り順序で遞択されたす。ネストされたプロゞェクトディレクトリ党䜓では、䜜業ディレクトリに最も近い定矩が優先されたす䞊蚘で説明。[`/doctor`](/docs/ja/commands#all-commands) セットアップチェックアップは、同じディレクトリ内で名前を共有するファむルをレポヌトし、1 ぀を陀くすべおの名前倉曎たたは削陀を提案したす。176`name` の倀はツリヌ党䜓で䞀意にしおください。同じ `.claude/agents/` ディレクトリサブフォルダを含むの䞋にある 2 ぀のファむルが同じ名前を宣蚀しおいる堎合、Claude Code はそのうち 1 ぀だけを読み蟌みたす。どちらが遞ばれるかは文曞化された優先順䜍ではなく、ファむルシステムの読み取り順序によっお決たりたす。ネストされたプロゞェクトディレクトリ間では、前述のずおり、䜜業ディレクトリに最も近い定矩が優先されたす。[`/doctor`](/docs/ja/commands#all-commands) のセットアップチェックは、同じディレクトリ内で名前が重耇しおいるファむルを報告し、1 ぀を残しお名前を倉曎するか削陀するこずを提案したす。

177 177 

178プラグむン `agents/` ディレクトリも再垰的にスキャンされたす。プロゞェクトおよびナヌザヌスコヌプずは異なり、プラグむンの `agents/` ディレクトリ内のサブフォルダは[スコヌプ付き識別子](#invoke-subagents-explicitly)の䞀郚になりたす。プラグむン `my-plugin` の `agents/review/security.md` にあるファむルは `my-plugin:review:security` ずしお登録されたす。178プラグむンの `agents/` ディレクトリも再垰的にスキャンされたす。プロゞェクトスコヌプやナヌザヌスコヌプずは異なり、プラグむンの `agents/` ディレクトリ内のサブフォルダは[スコヌプ付き識別子](#invoke-subagents-explicitly)の䞀郚になりたす。プラグむン `my-plugin` の `agents/review/security.md` にあるファむルは `my-plugin:review:security` ずしお登録されたす。

179 179 

180**CLI 定矩サブ゚ヌゞェント**は Claude Code 起動時に JSON ずしお枡されたす。これらはそのセッションのみに存圚し、ディスクに保存されないため、クむックテストたたは自動化スクリプトに䟿利です。1 ぀の `--agents` 呌び出しで耇数のサブ゚ヌゞェントを定矩できたす。180**CLI で定矩されたサブ゚ヌゞェント**は、Claude Code の起動時に JSON ずしお枡されたす。そのセッションの間だけ存圚し、ディスクには保存されないため、簡単なテストや自動化スクリプトに䟿利です。1 回の `--agents` 呌び出しで耇数のサブ゚ヌゞェントを定矩できたす。

181 181 

182**macOS, Linux, WSL**182**macOS, Linux, WSL**

183 183 

215'@215'@

216```216```

217 217 

218[非察話モヌド](/docs/ja/headless)では、`--agents` はコマンドラむンで枡すには倧きすぎる定矩甚に、JSON ファむルを保持するパスも受け入れたす。䟋えば、`claude -p --agents ./agents.json "Review my changes"` はそのファむルから定矩を読み取りたす。察話型セッションでは、Claude Code はファむルパスを拒吊したす。ファむル圢匏には Claude Code v2.1.281 以降が必芁です。218[非察話モヌド](/docs/ja/headless)では、コマンドラむンで枡すには倧きすぎる定矩のために、`--agents` は同じオブゞェクトを含む JSON ファむルぞのパスも受け付けたす。たずえば、`claude -p --agents ./agents.json "Review my changes"` はそのファむルから定矩を読み蟌みたす。察話セッションでは、Claude Code はファむルパスを拒吊したす。ファむル圢匏には Claude Code v2.1.281 以降が必芁です。

219 219 

220JSON の各トップレベルキヌぱヌゞェントの名前で、その倀がその゚ヌゞェントの定矩です。名前を `-` で始めないでください。定矩は以䞋のフィヌルドを取りたす。220JSON の各トップレベルキヌぱヌゞェントの名前で、その倀はその゚ヌゞェントの定矩です。名前を `-` で始めないでください。定矩には次のフィヌルドを指定できたす。

221 221 

222* **`prompt`**。゚ヌゞェントのシステムプロンプト。ファむルベヌスのサブ゚ヌゞェントのマヌクダりン本䜓ず同等です。`prompt` は空にするこずができたす。空の `prompt` ず `memory` フィヌルドのない゚ヌゞェントを `--agent` でセッションの゚ヌゞェントずしお遞択する堎合、セッションのシステムプロンプトは倉曎されたせん。空の `prompt` には Claude Code v2.1.281 以降が必芁です。222* **`prompt`**: ゚ヌゞェントのシステムプロンプトです。ファむルベヌスのサブ゚ヌゞェントにおける markdown 本文に盞圓したす。`prompt` は空でもかたいたせん。`prompt` が空で `memory` フィヌルドのない゚ヌゞェントを `--agent` でセッションの゚ヌゞェントずしお遞択した堎合、セッションのシステムプロンプトは倉曎されたせん。空の `prompt` には Claude Code v2.1.281 以降が必芁です。

223* **[フロントマタヌフィヌルド](#supported-frontmatter-fields)**。`description`、`tools`、`disallowedTools`、`model`、`permissionMode`、`mcpServers`、`hooks`、`maxTurns`、`autoCompactWindow`、`skills`、`initialPrompt`、`memory`、`effort`、`background`、`omitClaudeMd`、および `isolation`。223* **[フロントマタヌフィヌルド](#supported-frontmatter-fields)**: `description`、`tools`、`disallowedTools`、`model`、`permissionMode`、`mcpServers`、`hooks`、`maxTurns`、`autoCompactWindow`、`skills`、`initialPrompt`、`memory`、`effort`、`background`、`omitClaudeMd`、`isolation`。

224* **無芖されるフィヌルド**。`color` ず `experimental` はここでは受け入れられず、拒吊されるのではなく無芖されたす。224* **無芖されるフィヌルド**: `color` ず `experimental` はここでは受け付けられず、拒吊されるのではなく無芖されたす。

225 225 

226Claude Code が読み蟌めない倀で䜕をするか、およびそのチェックをスキップするフラグず環境倉数に぀いおは、[`Invalid --agents configuration`](/docs/ja/errors#invalid-agents-configuration)を参照しおください。226Claude Code が読み蟌めない倀をどう扱うか、およびそのチェックをスキップするフラグず環境倉数に぀いおは、[`Invalid --agents configuration`](/docs/ja/errors#invalid-agents-configuration) を参照しおください。

227 227 

228**管理サブ゚ヌゞェント**は組織管理者によっおデプロむされたす。[管理蚭定ディレクトリ](/docs/ja/managed-settings#delivery-mechanisms)内の `.claude/agents/` にマヌクダりンファむルを配眮し、プロゞェクトおよびナヌザヌサブ゚ヌゞェントず同じ frontmatter 圢匏を䜿甚したす。管理定矩は同じ名前のプロゞェクトおよびナヌザヌサブ゚ヌゞェントより優先されたす。228**管理サブ゚ヌゞェント**は組織の管理者によっおデプロむされたす。[管理蚭定ディレクトリ](/docs/ja/managed-settings#delivery-mechanisms)内の `.claude/agents/` に markdown ファむルを配眮し、プロゞェクトサブ゚ヌゞェントやナヌザヌサブ゚ヌゞェントず同じフロントマタヌ圢匏を䜿甚したす。管理定矩は、同じ名前のプロゞェクトサブ゚ヌゞェントやナヌザヌサブ゚ヌゞェントよりも優先されたす。

229 229 

230**プラグむンサブ゚ヌゞェント**は、むンストヌルした[プラグむン](/docs/ja/plugins/overview)から来たす。これらはカスタムサブ゚ヌゞェントず䞀緒に自動的に読み蟌たれ、スコヌプ付き名の䞋の @-mention タむプアヘッドに衚瀺されたす。プラグむンサブ゚ヌゞェント䜜成の詳现に぀いおは、[プラグむンコンポヌネントリファレンス](/docs/ja/plugins/components#agents)を参照しおください。230**プラグむンサブ゚ヌゞェント**は、むンストヌルした[プラグむン](/docs/ja/plugins/overview)から提䟛されたす。カスタムサブ゚ヌゞェントずずもに自動的に読み蟌たれ、@ メンションの入力補完にスコヌプ付きの名前で衚瀺されたす。プラグむンサブ゚ヌゞェントの䜜成に぀いお詳しくは、[プラグむンコンポヌネントリファレンス](/docs/ja/plugins/components#agents)を参照しおください。

231 231 

232> [!NOTE]232> [!NOTE]

233>233>

234> セキュリティ䞊の理由から、プラグむンサブ゚ヌゞェントは `hooks`、`mcpServers`、たたは `permissionMode` フロントマタヌフィヌルドをサポヌトしおいたせん。これらのフィヌルドはプラグむンから゚ヌゞェントを読み蟌むずきに無芖されたす。これらが必芁な堎合は、゚ヌゞェントファむルを `.claude/agents/` たたは `~/.claude/agents/` にコピヌしおください。たた、`settings.json` たたは `settings.local.json` の [`permissions.allow`](/docs/ja/settings-reference#permissions-allow) にルヌルを远加するこずもできたすが、これらのルヌルはセッション党䜓に適甚され、プラグむンサブ゚ヌゞェントのみには適甚されたせん。234> セキュリティ䞊の理由から、プラグむンサブ゚ヌゞェントは `hooks`、`mcpServers`、`permissionMode` のフロントマタヌフィヌルドをサポヌトしおいたせん。これらのフィヌルドは、プラグむンから゚ヌゞェントを読み蟌む際に無芖されたす。これらが必芁な堎合は、゚ヌゞェントファむルを `.claude/agents/` たたは `~/.claude/agents/` にコピヌしおください。`settings.json` たたは `settings.local.json` の [`permissions.allow`](/docs/ja/settings-reference#permissions-allow) にルヌルを远加するこずもできたすが、これらのルヌルはプラグむンサブ゚ヌゞェントだけでなくセッション党䜓に適甚されたす。

235>235>

236> プラグむンの䜜成者である堎合は、代わりにフックをプラグむンの [`hooks/hooks.json`](/docs/ja/plugins/components#hooks) に、MCP サヌバヌをその [`.mcp.json`](/docs/ja/plugins/components#mcp-servers) に含めお配垃しおください。これらはサブ゚ヌゞェント内だけでなく、プラグむンが有効な堎合は垞に適甚されたす。236> プラグむンの䜜成者である堎合は、代わりにフックをプラグむンの [`hooks/hooks.json`](/docs/ja/plugins/components#hooks) に、MCP サヌバヌをプラグむンの [`.mcp.json`](/docs/ja/plugins/components#mcp-servers) に含めお配垃しおください。これらはサブ゚ヌゞェント内だけでなく、プラグむンが有効なずきは垞に適甚されたす。

237 237 

238サブ゚ヌゞェント定矩は、[゚ヌゞェントチヌム](/docs/ja/agent-teams)のチヌムメむトずしお再利甚するこずもできたす。Claude にチヌムメむトのスポヌンを䟝頌するずきにサブ゚ヌゞェントタむプを指定するず、Claude Code はその定矩の䞀郚をチヌムメむトに適甚したす。各衚瀺モヌドでどのスコヌプずどの郚分が適甚されるかに぀いおは、[チヌムメむトにサブ゚ヌゞェント定矩を䜿甚する](/docs/ja/agent-teams#use-subagent-definitions-for-teammates)を参照しおください。238サブ゚ヌゞェントの定矩を[゚ヌゞェントチヌム](/docs/ja/agent-teams)のチヌムメむトずしお再利甚するこずもできたす。Claude にチヌムメむトの生成を䟝頌するずきにサブ゚ヌゞェントの皮類を指定するず、Claude Code はその定矩の䞀郚をチヌムメむトに適甚したす。各衚瀺モヌドでどのスコヌプずどの郚分が適甚されるかに぀いおは、[チヌムメむトにサブ゚ヌゞェント定矩を䜿甚する](/docs/ja/agent-teams#use-subagent-definitions-for-teammates)を参照しおください。

239 239 

240### サブ゚ヌゞェントファむルを䜜成する240### サブ゚ヌゞェントファむルを䜜成する

241 241 

242サブ゚ヌゞェントファむルは蚭定甚の YAML frontmatter を䜿甚し、その埌にマヌクダりンのシステムプロンプトが続きたす。242サブ゚ヌゞェントファむルでは、蚭定に YAML フロントマタヌを䜿甚し、その埌に Markdown でシステムプロンプトを蚘述したす。

243 243 

244> [!NOTE]244> [!NOTE]

245>245>

246> Claude Code は `~/.claude/agents/` ず `.claude/agents/` を監芖したす。ディスク䞊のサブ゚ヌゞェントファむルを远加たたは線集するか、Claude にそれを䜜成するよう䟝頌するず、Claude Code は数秒以内に倉曎を怜出し、次の委任は再起動なしで曎新された定矩を䜿甚したす。246> Claude Code は `~/.claude/agents/` ず `.claude/agents/` を監芖しおいたす。ディスク䞊でサブ゚ヌゞェントファむルを远加たたは線集したり、Claude にファむルの䜜成を䟝頌したりするず、Claude Code は数秒以内に倉曎を怜出し、次回の委任では曎新された定矩が䜿甚されたす。再起動は必芁ありたせん。

247>247>

248> 3 ぀のケヌスではただ再起動が必芁です。248> ただし、次の 3 ぀の堎合は再起動が必芁です。

249>249>

250> * りォッチャヌはセッション開始時に存圚しおいたディレクトリのみをカバヌするため、新しい `agents` ディレクトリでスコヌプの最初の゚ヌゞェントファむルを䜜成した埌、再起動しお読み蟌みたす。250> * 監芖察象はセッション開始時に存圚しおいたディレクトリのみです。そのため、新しい `agents` ディレクトリにそのスコヌプ最初の゚ヌゞェントファむルを䜜成した埌は、再起動しお読み蟌んでください。

251> * Claude Code は `--add-dir` たたは `/add-dir` で远加されたディレクトリ内の `.claude/agents/` を監芖しないため、そこでサブ゚ヌゞェントを远加たたは線集した埌、再起動しお倉曎を読み蟌みたす。251> * Claude Code は、`--add-dir` たたは `/add-dir` で远加したディレクトリ内の `.claude/agents/` を監芖したせん。そこでサブ゚ヌゞェントを远加たたは線集した埌は、再起動しお倉曎を読み蟌んでください。

252> * `--disable-slash-commands` で開始されたセッションはこれらのディレクトリをたったく監芖したせん。252> * `--disable-slash-commands` で開始したセッションは、これらのディレクトリをたったく監芖したせん。

253 253 

254```markdown .claude/agents/code-reviewer.md theme={null}254```markdown .claude/agents/code-reviewer.md theme={null}

255---255---

263specific, actionable feedback on quality, security, and best practices.263specific, actionable feedback on quality, security, and best practices.

264```264```

265 265 

266frontmatter はサブ゚ヌゞェントのメタデヌタず蚭定を定矩したす。本䜓はサブ゚ヌゞェントの動䜜をガむドするシステムプロンプトになりたす。サブ゚ヌゞェントは、このシステムプロンプトず䜜業ディレクトリなどの基本的な環境詳现のみを受け取り、Claude Code システムプロンプトは受け取りたせん。266フロントマタヌはサブ゚ヌゞェントのメタデヌタず蚭定を定矩したす。本文はサブ゚ヌゞェントの動䜜を導くシステムプロンプトになりたす。サブ゚ヌゞェントが受け取るのはこのシステムプロンプトず、䜜業ディレクトリなどの基本的な環境情報のみで、Claude Code のシステムプロンプトは受け取りたせん。

267 267 

268[非察話モヌド](/docs/ja/headless)では、[`--append-subagent-system-prompt`](/docs/ja/cli-reference#cli-flags)を枡しお、テキストをすべおのサブ゚ヌゞェントネストされたサブ゚ヌゞェントを含むのシステムプロンプトの末尟に远加したす。ただし、[フォヌクされたサブ゚ヌゞェント](#fork-the-current-conversation)は陀きたす。これは䌚話独自のプロンプトを再利甚したす。Claude Code v2.1.205 以降が必芁です。テキストがコマンドラむンで枡すには長すぎる堎合は、ファむルに保存しお `--append-subagent-system-prompt-file` でパスを枡しおください。ファむルフラグには Claude Code v2.1.261 以降が必芁です。268[非察話モヌド](/docs/ja/headless)では、[`--append-subagent-system-prompt`](/docs/ja/cli-reference#cli-flags) を枡すず、ネストされたサブ゚ヌゞェントを含むすべおのサブ゚ヌゞェントのシステムプロンプトの末尟にテキストを远加できたす。ただし、䌚話自䜓のプロンプトを再利甚する[フォヌクされたサブ゚ヌゞェント](#fork-the-current-conversation)は陀きたす。Claude Code v2.1.205 以降が必芁です。テキストが長すぎおコマンドラむンで枡せない堎合は、ファむルに保存し、代わりに `--append-subagent-system-prompt-file` でそのパスを枡しおください。ファむルフラグには Claude Code v2.1.261 以降が必芁です。

269 269 

270サブ゚ヌゞェントはメむン䌚話の珟圚の䜜業ディレクトリで開始したす。サブ゚ヌゞェント内では、`cd` コマンドは Bash たたは PowerShell ツヌル呌び出し間で氞続化されず、メむン䌚話の䜜業ディレクトリに圱響したせん。代わりにサブ゚ヌゞェントにリポゞトリの分離されたコピヌを䞎えるには、[`isolation: worktree`](#supported-frontmatter-fields)を蚭定したす。270サブ゚ヌゞェントはメむンの䌚話の珟圚の䜜業ディレクトリで開始したす。サブ゚ヌゞェント内では、`cd` コマンドは Bash ツヌルや PowerShell ツヌルの呌び出し間で保持されず、メむンの䌚話の䜜業ディレクトリにも圱響したせん。代わりにサブ゚ヌゞェントにリポゞトリの分離されたコピヌを䞎えるには、[`isolation: worktree`](#supported-frontmatter-fields) を蚭定したす。

271 271 

272`isolation: worktree` を持぀サブ゚ヌゞェントは、その worktree 内で Bash および PowerShell コマンドを実行したす。䜜業ディレクトリが代わりにメむンチェックアりトに解決されるコマンド䟋えば、サブ゚ヌゞェント実行䞭に worktree ディレクトリが削陀された堎合ぱラヌで倱敗したす。272`isolation: worktree` を持぀サブ゚ヌゞェントは、Bash コマンドず PowerShell コマンドを自身の worktree 内で実行したす。サブ゚ヌゞェントの実行䞭に worktree ディレクトリが削陀された堎合など、䜜業ディレクトリがメむンのチェックアりトに解決されるコマンドは、゚ラヌで倱敗したす。

273 273 

274この䜜業ディレクトリチェックは、Claude Code を起動したディレクトリを含むリポゞトリ党䜓をカバヌしたす。セッションがリンクされた[worktree](/docs/ja/worktrees)で独自に実行される堎合、チェックはその worktree がリンクされおいるメむンチェックアりトもカバヌしたす。274この䜜業ディレクトリのチェックは、Claude Code を起動したディレクトリを含むリポゞトリ党䜓を察象ずしたす。セッションが独自のリンクされた [worktree](/docs/ja/worktrees) で実行されおいる堎合、チェックはその worktree のリンク元であるメむンのチェックアりトも察象ずしたす。

275 275 

276Bash コマンドの堎合、Claude Code はコマンド自䜓を 2 ぀の方法でチェックしたす。276Bash コマンドに぀いおは、Claude Code はコマンド自䜓も 2 ぀の方法でチェックしたす。

277 277 

278* git をメむンチェックアりトにリダむレクトするコマンドをブロックしたす。278* git をメむンのチェックアりトにリダむレクトするコマンドをブロックしたす。

279* コマンドテキストから、コマンドが実行する git がすべお worktree 内に留たるこずを確認できないコマンドを拒吊したす。䟋えば、コマンド名が実行時に蚈算される堎合。279* コマンドが実行する git が worktree 内にずどたるこずをコマンドテキストから怜蚌できない堎合たずえば、コマンド名が実行時に算出される堎合、そのコマンドを拒吊したす。

280 280 

281リダむレクトベクトルず圢状ルヌルは[Claude Code が分離を匷制する方法](/docs/ja/worktrees#how-claude-code-enforces-isolation)の䞋にリストされおいたす。PowerShell コマンドは䜜業ディレクトリチェックのみを取埗したす。281リダむレクトの手段ず圢匏のルヌルは、[Claude Code による分離の匷制方法](/docs/ja/worktrees#how-claude-code-enforces-isolation)に蚘茉されおいたす。PowerShell コマンドには䜜業ディレクトリのチェックのみが適甚されたす。

282 282 

283[Monitor](/docs/ja/tools-reference#monitor-tool)コマンドは Bash コマンドず同じ䜜業ディレクトリおよびコマンドコンテンツチェックを通過したす。283[Monitor](/docs/ja/tools-reference#monitor-tool) コマンドには、Bash コマンドず同じ䜜業ディレクトリずコマンド内容のチェックが適甚されたす。

284 284 

285メむン䌚話自䜓が worktree で分離されお実行される堎合、Claude Code はセッションずそれがスポヌンするすべおのサブ゚ヌゞェント`isolation: worktree` なしのサブ゚ヌゞェントを含むに同じチェックを適甚したす。[Claude Code が分離を匷制する方法](/docs/ja/worktrees#how-claude-code-enforces-isolation)を参照しおください。285メむンの䌚話自䜓が worktree で分離されお実行されおいる堎合、Claude Code は同じチェックをセッションず、`isolation: worktree` を持たないサブ゚ヌゞェントを含め、セッションが生成するすべおのサブ゚ヌゞェントに適甚したす。[Claude Code による分離の匷制方法](/docs/ja/worktrees#how-claude-code-enforces-isolation)を参照しおください。

286 286 

287### Frontmatter リファレンス287### フロントマタヌリファレンス

288 288 

289サブ゚ヌゞェントは、ファむル先頭の `---` マヌカヌで囲んだ YAML [フロントマタヌ](/docs/ja/glossary#frontmatter)で蚭定し、閉じの `---` の埌にシステムプロンプトを Markdown で蚘述したす。`name` ず `description` のみが必須です。289サブ゚ヌゞェントは、ファむル先頭の `---` マヌカヌで囲たれた YAML [フロントマタヌ](/docs/ja/glossary#frontmatter)で蚭定し、閉じの `---` の埌に Markdown でシステムプロンプトを蚘述したす。必須なのは `name` ず `description` のみです。

290 290 

291耇数単語のフィヌルド名は `maxTurns` や `disallowedTools` などの camelCase を䜿甚し、テヌブルず正確に䞀臎する必芁がありたす。Claude Code は認識しないフィヌルドを無芖し、゚ラヌを報告したせん。291耇数の単語からなるフィヌルド名は `maxTurns` や `disallowedTools` のように camelCase を䜿甚し、衚ず完党に䞀臎させる必芁がありたす。Claude Code は認識できないフィヌルドを゚ラヌを報告せずに無芖したす。

292 292 

293* 読み蟌たれたサブ゚ヌゞェントでスペルミスのあるフィヌルドを芋぀けるには、シェルで [`claude --debug`](/docs/ja/cli-reference#cli-flags) を実行し、`~/.claude/debug/<session-id>.txt` にあるデバッグログで `does not recognize or apply` を怜玢したす。デバッグログには、Claude Code が認識しないサブ゚ヌゞェントファむル内のトップレベルフィヌルドが最倧 5 ぀たで瀺され、サポヌトされおいるフィヌルドに近い堎合は意図したず思われる名前も瀺されたす。Claude Code v2.1.296 以降が必芁です。293* 読み蟌たれたサブ゚ヌゞェント内のスペルミスのあるフィヌルドを芋぀けるには、シェルで [`claude --debug`](/docs/ja/cli-reference#cli-flags) を実行し、`~/.claude/debug/<session-id>.txt` にあるデバッグログで `does not recognize or apply` を怜玢したす。デバッグログには、サブ゚ヌゞェントのファむル内で Claude Code が認識しないトップレベルフィヌルドが最倧 5 ぀瀺され、サポヌトされおいるフィヌルドに近い堎合は意図されたず思われる名前も瀺されたす。Claude Code v2.1.296 以降が必芁です。

294* サブ゚ヌゞェントファむルが読み蟌たれなかった理由を確認するには、[Claude Code がスキップするサブ゚ヌゞェントファむル](#subagent-files-claude-code-skips)を参照しおください。294* サブ゚ヌゞェントファむルが読み蟌たれなかった理由を調べるには、[Claude Code がスキップするサブ゚ヌゞェントファむル](#subagent-files-claude-code-skips)を参照しおください。

295 295 

296| フィヌルド | 必須 | 説明 |296| フィヌルド | 必須 | 説明 |

297| :- | :- | :- |297| :- | :- | :- |

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

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

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

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

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

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

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

305| `autoCompactWindow` | いいえ | このサブ゚ヌゞェントの[自動圧瞮りィンドり](#subagent-auto-compact-window)を、`100000` から `1000000` たでのトヌクン数に䞋げたす。Claude Code v2.1.296 以降が必芁です |305| `autoCompactWindow` | いいえ | このサブ゚ヌゞェントの[自動圧瞮りィンドり](#subagent-auto-compact-window)を、`100000` から `1000000` たでのトヌクン数に匕き䞋げたす。Claude Code v2.1.296 以降が必芁です |

306| `skills` | いいえ | 起動時にサブ゚ヌゞェントのコンテキストにプリロヌドする[スキル](/docs/ja/skills)。説明のみではなく、完党なスキルコンテンツが泚入されたす。サブ゚ヌゞェントは、Skill ツヌルを通じおリストされおいないプロゞェクト、ナヌザヌ、およびプラグむンスキルを呌び出すこずができたす |306| `skills` | いいえ | 起動時にサブ゚ヌゞェントのコンテキストにプリロヌドする[スキル](/docs/ja/skills)。説明だけでなく、スキルの内容党䜓が泚入されたす。サブ゚ヌゞェントは、列挙されおいないプロゞェクト、ナヌザヌ、プラグむンのスキルも Skill ツヌルを通じお匕き続き呌び出せたす |

307| `mcpServers` | いいえ | このサブ゚ヌゞェントで利甚可胜な[MCP サヌバヌ](/docs/ja/mcp)。各゚ントリは、既に蚭定されおいるサヌバヌを参照するサヌバヌ名䟋えば、`"slack"`、たたは完党な[MCP サヌバヌ蚭定](/docs/ja/mcp#installing-mcp-servers)を倀ずしお持぀サヌバヌ名をキヌずするむンラむン定矩のいずれかです。[プラグむンサブ゚ヌゞェント](#choose-the-subagent-scope)では無芖されたす |307| `mcpServers` | いいえ | このサブ゚ヌゞェントが利甚できる [MCP サヌバヌ](/docs/ja/mcp)。各゚ントリは、蚭定枈みのサヌバヌを参照するサヌバヌ名䟋: `"slack"`、たたはサヌバヌ名をキヌずし完党な [MCP サヌバヌ蚭定](/docs/ja/mcp#installing-mcp-servers)を倀ずするむンラむン定矩のいずれかです。[プラグむンサブ゚ヌゞェント](#choose-the-subagent-scope)では無芖されたす |

308| `hooks` | いいえ | このサブ゚ヌゞェントにスコヌプされた[ラむフサむクルフック](#define-hooks-for-subagents)。[プラグむンサブ゚ヌゞェント](#choose-the-subagent-scope)では無芖されたす |308| `hooks` | いいえ | このサブ゚ヌゞェントにスコヌプされた[ラむフサむクルフック](#define-hooks-for-subagents)。[プラグむンサブ゚ヌゞェント](#choose-the-subagent-scope)では無芖されたす |

309| `memory` | いいえ | [氞続メモリスコヌプ](#enable-persistent-memory)。`user`、`project`、たたは `local`。クロスセッション孊習を有効にしたす |309| `memory` | いいえ | [氞続メモリのスコヌプ](#enable-persistent-memory): `user`、`project`、たたは `local`。セッションをたたいだ孊習を有効にしたす |

310| `background` | いいえ | Claude がこのサブ゚ヌゞェントの完了を埅぀よう芁求した堎合でも、このサブ゚ヌゞェントをバックグラりンドに保぀には `true` に蚭定したす。デフォルトでは、Claude がメむン䌚話からスポヌンするサブ゚ヌゞェントは既に[バックグラりンドで開始](#run-subagents-in-foreground-or-background)されたす |310| `background` | いいえ | `true` に蚭定するず、Claude が埅機を求めた堎合でもこのサブ゚ヌゞェントをバックグラりンドに維持したす。デフォルトでは、Claude がメむンの䌚話から生成するサブ゚ヌゞェントはすでに[バックグラりンドで開始したす](#run-subagents-in-foreground-or-background) |

311| `omitClaudeMd` | いいえ | このサブ゚ヌゞェントを、[初期コンテキスト](#what-loads-at-startup)にナヌザヌ、プロゞェクト、およびロヌカルの CLAUDE.md ファむルを含めずに起動するには `true` に蚭定したす。[管理ポリシヌファむル](/docs/ja/memory#how-claude-md-files-load)は匕き続き読み蟌たれたす。ただし、[管理サブ゚ヌゞェント](#choose-the-subagent-scope)は陀きたす。委任プロンプトから必芁なすべおを取埗するサブ゚ヌゞェントに䜿甚したす。゚ヌゞェントが `--agent` たたは `agent` 蚭定経由でメむンセッション゚ヌゞェントずしお実行される堎合は無芖されたす。Claude Code v2.1.271 以降が必芁です |311| `omitClaudeMd` | いいえ | `true` に蚭定するず、このサブ゚ヌゞェントは[初期コンテキスト](#what-loads-at-startup)にナヌザヌ、プロゞェクト、ロヌカルの CLAUDE.md ファむルを含めずに開始したす。[管理ポリシヌファむル](/docs/ja/memory#how-claude-md-files-load)は匕き続き読み蟌たれたすが、[管理サブ゚ヌゞェント](#choose-the-subagent-scope)の堎合は陀きたす。必芁なものをすべお委任プロンプトから受け取るサブ゚ヌゞェントに䜿甚したす。゚ヌゞェントが `--agent` たたは `agent` 蚭定によっおメむンセッションの゚ヌゞェントずしお実行される堎合は無芖されたす。Claude Code v2.1.271 以降が必芁です |

312| `effort` | いいえ | このサブ゚ヌゞェントがアクティブな堎合の effort レベル。セッションの effort レベルを䞊曞きしたすが、[`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ja/env-vars#variables) 環境倉数は䞊曞きしたせん。オプション`low`、`medium`、`high`、`xhigh`、`max`。利甚可胜なレベルはモデルによっお異なりたす。[effort レベルを遞択する](#choose-an-effort-level)を参照しおください |312| `effort` | いいえ | このサブ゚ヌゞェントがアクティブなずきの effort レベル。セッションの effort レベルを䞊曞きしたすが、[`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ja/env-vars#variables) 環境倉数は䞊曞きしたせん。オプション: `low`、`medium`、`high`、`xhigh`、`max`。利甚可胜なレベルはモデルによっお異なりたす。[effort レベルを遞択する](#choose-an-effort-level)を参照しおください |

313| `isolation` | いいえ | サブ゚ヌゞェントを䞀時的な[git worktree](/docs/ja/worktrees)で実行するには `worktree` に蚭定したす。これにより、芪セッションの `HEAD` ではなく、デフォルトで[デフォルトブランチ](/docs/ja/worktrees#choose-the-base-branch)からブランチされたリポゞトリの分離されたコピヌが提䟛されたす。サブ゚ヌゞェントが倉曎を加えない堎合、worktree は自動的にクリヌンアップされたす |313| `isolation` | いいえ | `worktree` に蚭定するず、サブ゚ヌゞェントを䞀時的な [git worktree](/docs/ja/worktrees) で実行し、リポゞトリの分離されたコピヌを䞎えたす。このコピヌは、デフォルトでは芪セッションの `HEAD` ではなく[デフォルトブランチ](/docs/ja/worktrees#choose-the-base-branch)から分岐したす。サブ゚ヌゞェントが倉曎を加えなかった堎合、worktree は自動的にクリヌンアップされたす |

314| `color` | いいえ | タスクリストずトランスクリプトでのサブ゚ヌゞェントの衚瀺カラヌ。`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、たたは `cyan` を受け入れたす |314| `color` | いいえ | タスクリストずトランスクリプトにおけるサブ゚ヌゞェントの衚瀺カラヌ。`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、`cyan` を指定できたす |

315| `initialPrompt` | いいえ | この゚ヌゞェントがメむンセッション゚ヌゞェント`--agent` たたは `agent` 蚭定経由ずしお実行される堎合、最初のナヌザヌタヌンずしお自動送信されたす。[コマンド](/docs/ja/commands)ず[スキル](/docs/ja/skills)が凊理されたす。ナヌザヌ提䟛のプロンプトの前に付加されたす。[プラグむンサブ゚ヌゞェント](#choose-the-subagent-scope)では無芖されたす |315| `initialPrompt` | いいえ | この゚ヌゞェントがメむンセッションの゚ヌゞェントずしお`--agent` たたは `agent` 蚭定によっお実行される堎合に、最初のナヌザヌタヌンずしお自動送信されたす。[コマンド](/docs/ja/commands)ず[スキル](/docs/ja/skills)は凊理されたす。ナヌザヌが指定したプロンプトの前に付加されたす。[プラグむンサブ゚ヌゞェント](#choose-the-subagent-scope)では無芖されたす |

316| `experimental` | いいえ | 実隓的オプションのマップ。その `cacheTtl` キヌを `5m` たたは `1h` に蚭定しお、このサブ゚ヌゞェントのリク゚ストの[プロンプトキャッシュラむフタむム](/docs/ja/prompt-caching#choose-the-ttl-yourself)を遞択したす。この倀は、[キャッシュラむフタむム優先順䜍](/docs/ja/prompt-caching#choose-the-ttl-yourself)の䞭でフロントマタヌが占める䜍眮で適甚されたす。Claude Code は他の倀を無芖し、Claude サブスクリプションが䜿甚クレゞットを䜿甚しおいる間は `1h` を無芖し、サブ゚ヌゞェントファむルからのみフィヌルドを読み取りたす。Claude Code v2.1.248 以降が必芁です |316| `experimental` | いいえ | 実隓的なオプションのマップ。`cacheTtl` キヌを `5m` たたは `1h` に蚭定するず、このサブ゚ヌゞェントのリク゚ストの[プロンプトキャッシュの有効期間](/docs/ja/prompt-caching#choose-the-ttl-yourself)を遞択できたす。これは[キャッシュ有効期間の優先順䜍](/docs/ja/prompt-caching#choose-the-ttl-yourself)におけるフロントマタヌの䜍眮で適甚されたす。Claude Code はそれ以倖の倀を無芖し、Claude のサブスクリプションが䜿甚クレゞットを䜿甚しおいる間は `1h` を無芖し、このフィヌルドをサブ゚ヌゞェントファむルからのみ読み取りたす。Claude Code v2.1.248 以降が必芁です |

317 317 

318`cacheTtl` を frontmatter のトップレベルではなく、`experimental` マップ内に曞き蟌みたす。318`cacheTtl` は、フロントマタヌのトップレベルではなく、`experimental` マップ内に蚘述したす。

319 319 

320```yaml theme={null}320```yaml theme={null}

321---321---

328 328 

329#### Claude Code がスキップするサブ゚ヌゞェントファむル329#### Claude Code がスキップするサブ゚ヌゞェントファむル

330 330 

331Claude Code は、frontmatter に以䞋の問題がある堎合、プロゞェクト、ナヌザヌ、たたは管理 `agents` ディレクトリ、たたは `--add-dir` で远加したディレクトリの䞋のファむルをセッションで報告せずにスキップしたす。331プロゞェクト、ナヌザヌ、たたは管理の `agents` ディレクトリ、あるいは `--add-dir` で远加したディレクトリ配䞋の `agents` ディレクトリにあるファむルに぀いお、フロントマタヌに次のいずれかの問題がある堎合、Claude Code はセッション内で報告せずにそのファむルをスキップしたす。

332 332 

333* **`name` がない**。Claude Code はファむルを゚ヌゞェントの暪に保持されたドキュメントずしお扱いたす。333* **`name` がない**: Claude Code はそのファむルを、゚ヌゞェントず䞊べお眮かれたドキュメントずしお扱いたす。

334* **ファむルの最初の行ではない開き `---`**。Claude Code はファむルに frontmatter がないず読み取り、ドキュメントずしお扱いたす。334* **開始の `---` がファむルの 1 行目にない**: Claude Code はそのファむルをフロントマタヌのないものずしお読み取り、ドキュメントずしお扱いたす。

335* **`-` で始たる、`:` を含む、たたは 256 文字を超える `name`**。Claude Code はファむルをスキップし、デバッグログに゚ラヌを曞き蟌みたす。335* **`name` が `-` で始たる、`:` を含む、たたは 256 文字を超える**: Claude Code はそのファむルをスキップし、デバッグログに゚ラヌを曞き蟌みたす。

336* **`name` があるが `description` がない**。Claude Code はファむルをスキップし、理由をデバッグログに曞き蟌みたす。336* **`name` はあるが `description` がない**: Claude Code はそのファむルをスキップし、デバッグログに理由を曞き蟌みたす。

337* **解析されない YAML**。Claude Code はファむルからフィヌルドを読み取らず、スキップしお、解析゚ラヌをデバッグログに曞き蟌みたす。337* **YAML を解析できない**: Claude Code はそのファむルからフィヌルドを䞀切読み取らずにスキップし、デバッグログに解析゚ラヌを曞き蟌みたす。

338 338 

339デバッグログを衚瀺するには、`--debug` で Claude Code を実行したす。339デバッグログを確認するには、`--debug` を付けお Claude Code を実行したす。

340 340 

341frontmatter に `name` がない、たたは解析されない[プラグむンサブ゚ヌゞェント](/docs/ja/plugins/components#agents)は、ファむル名の䞋で匕き続き読み蟌たれたす。341フロントマタヌに `name` がないか解析できない[プラグむンサブ゚ヌゞェント](/docs/ja/plugins/components#agents)は、ファむル名で匕き続き読み蟌たれたす。

342 342 

343##### セッション前に `agents` ディレクトリをチェックする343##### セッション前に `agents` ディレクトリをチェックする

344 344 

345frontmatter が解析されない `agents` ディレクトリ内のファむルを芋぀けるには、䟋えば `.claude/agents` たたは `~/.claude/agents` に察しお `claude plugin validate` を実行したす。Claude Code は[名前を付けたディレクトリのみをチェック](/docs/ja/plugins/cli-reference#validate-a-directory)し、frontmatter が解析されるが `name` がないファむルにはフラグを立おたせん。Claude Code v2.1.233 以降が必芁です。345`agents` ディレクトリ内でフロントマタヌを解析できないファむルを芋぀けるには、`.claude/agents` や `~/.claude/agents` などのディレクトリに察しお `claude plugin validate` を実行したす。Claude Code は[指定したディレクトリ](/docs/ja/plugins/cli-reference#validate-a-directory)のみをチェックし、フロントマタヌは解析できるが `name` がないファむルは指摘したせん。Claude Code v2.1.233 以降が必芁です。

346 346 

347### モデルを遞択する347### モデルを遞択する

348 348 

349`model` フィヌルドはサブ゚ヌゞェントが䜿甚するモデルを制埡したす。349`model` フィヌルドは、サブ゚ヌゞェントが䜿甚するモデルを制埡したす。

350 350 

351* **モデル゚むリアス**。利甚可胜な゚むリアスの 1 ぀を䜿甚したす。`sonnet`、`opus`、`haiku`、たたは `fable`351* **モデル゚むリアス**: 利甚可胜な゚むリアスのいずれかを䜿甚したす: `sonnet`、`opus`、`haiku`、たたは `fable`

352* **完党なモデル ID**。`claude-opus-5-5` たたは `claude-sonnet-5` などの完党なモデル ID を䜿甚したす。`--model` フラグず同じ倀を受け入れたす352* **完党なモデル ID**: `claude-opus-5-5` や `claude-sonnet-5` などの完党なモデル ID を䜿甚したす。`--model` フラグず同じ倀を受け付けたす

353* **inherit**。メむン䌚話ず同じモデルを䜿甚したす353* **inherit**: メむンの䌚話ず同じモデルを䜿甚したす

354 354 

355Claude がサブ゚ヌゞェントを呌び出すずき、その特定の呌び出しに察しお `model` パラメヌタを枡すこずもできたす。Claude Code はサブ゚ヌゞェントのモデルをこの順序で解決したす。355Claude がサブ゚ヌゞェントを呌び出す際、その呌び出しに察しお `model` パラメヌタを枡すこずもできたす。Claude Code は次の順序でサブ゚ヌゞェントのモデルを決定したす。

356 356 

3571. 呌び出しごずの `model` パラメヌタ3571. 呌び出しごずの `model` パラメヌタ

3582. サブ゚ヌゞェント定矩の `model` frontmatter。`inherit` はメむン䌚話のモデルを遞択したす3582. サブ゚ヌゞェント定矩の `model` フロントマタヌ`inherit` はメむンの䌚話のモデルを遞択したす

3593. [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/ja/model-config#environment-variables)環境倉数。モデル゚むリアスたたはモデル ID に蚭定した堎合3593. [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/ja/model-config#environment-variables) 環境倉数モデル゚むリアスたたはモデル ID に蚭定した堎合

3604. メむン䌚話のモデル3604. メむンの䌚話のモデル

361 361 

362むンストヌル枈みの [mod](/docs/ja/plugins/mods/overview) が [`agent.spawn`](/docs/ja/plugins/mods/reference#subagents) フックでモデルを蚭定する堎合、Claude Code は呌び出しごずのパラメヌタの代わりにそのモデルを䜿甚したす。362むンストヌルされた [mod](/docs/ja/plugins/mods/overview) が [`agent.spawn`](/docs/ja/plugins/mods/reference#subagents) フックでモデルを蚭定しおいる堎合、Claude Code は呌び出しごずのパラメヌタの代わりにそのモデルを䜿甚したす。

363 363 

3642 ぀のケヌスでは、`opus` などのファミリ゚むリアスが、呌び出しごずのパラメヌタたたは frontmatter で、メむン䌚話のモデルの代わりに[゚むリアスが指す](/docs/ja/model-config#model-aliases)バヌゞョンに解決されたす。364次の 2 ぀の堎合、呌び出しごずのパラメヌタたたはフロントマタヌにおける `opus` などのファミリヌ゚むリアスは、[゚むリアスが指すバヌゞョン](/docs/ja/model-config#model-aliases)ではなくメむンの䌚話のモデルに解決されたす。

365 365 

366* **メむン䌚話のモデルがそのファミリに属する**。サブ゚ヌゞェントはメむン䌚話の正確なモデル`[1m]` サフィックスを含むで実行されるため、メむン䌚話ず同じ[拡匵コンテキスト](/docs/ja/model-config#extended-context)りィンドりを取埗したす。366* **メむンの䌚話のモデルがそのファミリヌに属しおいる堎合**: サブ゚ヌゞェントは `[1m]` サフィックスを含め、メむンの䌚話ずたったく同じモデルで実行されるため、メむンの䌚話ず同じ[拡匵コンテキスト](/docs/ja/model-config#extended-context)りィンドりを埗られたす。

367* **Claude Code がメむン䌚話のモデルファミリを刀断できない。[Anthropic API 以倖のプロバむダヌ](/docs/ja/third-party-integrations)䞊で**。これは Claude Code がバッキングモデルに解決しおいない[アプリケヌション掚論プロファむル ARN](/docs/ja/amazon-bedrock#iam-configuration)を持぀ Amazon Bedrock で発生する可胜性がありたす。このケヌスは `opus` ゚むリアスのみをカバヌし、[`ANTHROPIC_DEFAULT_OPUS_MODEL`](/docs/ja/model-config#environment-variables)を蚭定した堎合は適甚されたせん。`opus` はその埌、蚭定したモデルに解決されるため。367* **[Anthropic API 以倖のプロバむダヌ](/docs/ja/third-party-integrations)で、Claude Code がメむンの䌚話のモデルファミリヌを刀別できない堎合**: これは、Amazon Bedrock で Claude Code が基盀モデルに解決しおいない[アプリケヌション掚論プロファむル ARN](/docs/ja/amazon-bedrock#iam-configuration) を䜿甚しおいる堎合に発生するこずがありたす。このケヌスは `opus` ゚むリアスのみが察象で、[`ANTHROPIC_DEFAULT_OPUS_MODEL`](/docs/ja/model-config#environment-variables) を蚭定しおいる堎合は適甚されたせん。その堎合、`opus` は蚭定したモデルに解決されるためです。

368 368 

369`CLAUDE_CODE_SUBAGENT_MODEL` の゚むリアスは、メむン䌚話のファミリを指定しおいる堎合でも、垞に゚むリアスが指すバヌゞョンに解決されたす。この倉数を `inherit` に蚭定するこずは、蚭定しないのず同じです。369`CLAUDE_CODE_SUBAGENT_MODEL` 内の゚むリアスは、メむンの䌚話のファミリヌを指しおいる堎合でも、垞に゚むリアスが指すバヌゞョンに解決されたす。この倉数を `inherit` に蚭定するこずは、未蚭定のたたにするこずず同じです。

370 370 

371`CLAUDE_CODE_SUBAGENT_MODEL` を単独で蚭定しおも、組み蟌みの Explore および Plan サブ゚ヌゞェントが実行されるモデルは倉わりたせん。倉曎するには、[すべおのサブ゚ヌゞェントを 1 ぀のモデルで実行](#run-every-subagent-on-one-model)を参照しおください。371`CLAUDE_CODE_SUBAGENT_MODEL` を蚭定するだけでは、組み蟌みの Explore サブ゚ヌゞェントず Plan サブ゚ヌゞェントが実行されるモデルは倉わりたせん。倉曎するには、[すべおのサブ゚ヌゞェントを 1 ぀のモデルで実行する](#run-every-subagent-on-one-model)を参照しおください。

372 372 

373v2.1.251 より前では、`CLAUDE_CODE_SUBAGENT_MODEL` はこの順序で最初に来お、呌び出しごずのパラメヌタず frontmatter`model: inherit` を含むの䞡方をオヌバヌラむドしたした。373v2.1.251 より前は、`CLAUDE_CODE_SUBAGENT_MODEL` がこの順序の先頭にあり、`model: inherit` を含め、呌び出しごずのパラメヌタずフロントマタヌの䞡方を䞊曞きしおいたした。

374 374 

375Claude Code は、呌び出しごずのパラメヌタ、frontmatter、および環境倉数の倀を組織の [`availableModels`](/docs/ja/model-config#restrict-model-selection)蚱可リストに察しおチェックしたす。ブロックされた倀の堎合、別のモデルに眮き換えたす。375Claude Code は、呌び出しごずのパラメヌタ、フロントマタヌ、環境倉数の倀を組織の [`availableModels`](/docs/ja/model-config#restrict-model-selection) 蚱可リストず照合したす。ブロックされた倀に぀いおは、別のモデルで代替したす。

376 376 

377* `opus` などのファミリ゚むリアスがブロックされた堎合、Claude Code はサブ゚ヌゞェントを蚱可リストが蚱可するそのファミリの最新バヌゞョンで実行したす。`/model` ず同じ[眮換ルヌルずプロバむダヌスコヌプ](/docs/ja/model-config#restrict-model-selection)に埓いたす。v2.1.222 より前では、Claude Code はブロックされたファミリ゚むリアスに぀いおも継承されたモデルでサブ゚ヌゞェントを実行しおいたした。377* ブロックされた倀が `opus` などのファミリヌ゚むリアスである堎合、Claude Code は `/model` ず同じ[代替ルヌルずプロバむダヌの範囲](/docs/ja/model-config#restrict-model-selection)に埓い、蚱可リストで蚱可されおいるそのファミリヌの最新バヌゞョンでサブ゚ヌゞェントを実行したす。v2.1.222 より前は、ブロックされたファミリヌ゚むリアスに぀いおも、Claude Code は継承されたモデルでサブ゚ヌゞェントを実行しおいたした。

378* その他のブロックされた倀の堎合、その眮換が動䜜しないプロバむダヌ、たたは蚱可リストがファミリのバヌゞョンを蚱可しない堎合、Claude Code は代わりに継承されたモデルでサブ゚ヌゞェントを実行したす。`CLAUDE_CODE_SUBAGENT_MODEL` を蚭定した堎合、Claude Code はそのモデルを最初に詊したす。これらの同じルヌルの䞋で。378* その他のブロックされた倀の堎合、その代替が機胜しないプロバむダヌの堎合、たたは蚱可リストでそのファミリヌのどのバヌゞョンも蚱可されおいない堎合、Claude Code は代わりに継承されたモデルでサブ゚ヌゞェントを実行したす。`CLAUDE_CODE_SUBAGENT_MODEL` を蚭定しおいる堎合、Claude Code はこれらず同じルヌルの䞋でたずそのモデルを詊したす。

379 379 

380察話型セッションでは、Claude Code は芁求されたモデルずサブ゚ヌゞェントが実行されるモデルに名前を付ける譊告を衚瀺したす。どちらの眮換に぀いおも。380察話セッションでは、いずれの代替の堎合も、Claude Code は芁求されたモデルずサブ゚ヌゞェントが実際に実行されるモデルを瀺す譊告を衚瀺したす。

381 381 

382サブ゚ヌゞェントが実行されおいるモデルを確認するには、[`/tasks`](/docs/ja/commands)を実行したす。Claude Code はサブ゚ヌゞェントの行にモデル名を衚瀺し、そのサブ゚ヌゞェントに [effort レベル](/docs/ja/model-config#adjust-effort-level)が蚭定されおいる堎合はそれも远加したす。Claude Code v2.1.242 以降が必芁です。382サブ゚ヌゞェントがどのモデルで実行されおいるかを確認するには、[`/tasks`](/docs/ja/commands) を実行したす。Claude Code はサブ゚ヌゞェントの行にモデルを衚瀺し、そのサブ゚ヌゞェントに [effort レベル](/docs/ja/model-config#adjust-effort-level)が蚭定されおいる堎合はそれも衚瀺したす。Claude Code v2.1.242 以降が必芁です。

383 383 

384呌び出しごずの `model` パラメヌタは、サブ゚ヌゞェントが[再開たたは埌続メッセヌゞが送信](#resume-subagents)される堎合にも適甚されるため、サブ゚ヌゞェントはそのモデルに留たりたす。384呌び出しごずの `model` パラメヌタは、サブ゚ヌゞェントが[再開されたり、フォロヌアップメッセヌゞを送られたり](#resume-subagents)した堎合にも適甚されるため、サブ゚ヌゞェントはそのモデルのたた維持されたす。

385 385 

386v2.1.198 以降、サブ゚ヌゞェントはメむン䌚話の[拡匵思考](/docs/ja/model-config#extended-thinking)蚭定も継承したす。セッションで思考がオンの堎合、サブ゚ヌゞェントではオンになり、オフの堎合、オフのたたです。サブ゚ヌゞェントごずの思考蚭定はありたせん。v2.1.198 より前では、サブ゚ヌゞェントはメむン䌚話の蚭定に関係なく、拡匵思考が無効で実行されおいたした。386v2.1.198 以降、サブ゚ヌゞェントはメむンの䌚話の[拡匵思考](/docs/ja/model-config#extended-thinking)蚭定も継承したす。セッションで思考がオンであればサブ゚ヌゞェントでもオンになり、オフであればオフのたたです。サブ゚ヌゞェントごずの思考蚭定はありたせん。v2.1.198 より前は、メむンの䌚話の蚭定にかかわらず、サブ゚ヌゞェントは拡匵思考が無効な状態で実行されおいたした。

387 387 

388#### すべおのサブ゚ヌゞェントを 1 ぀のモデルで実行する388#### すべおのサブ゚ヌゞェントを 1 ぀のモデルで実行する

389 389 

390`CLAUDE_CODE_SUBAGENT_MODEL` はデフォルトであるため、サブ゚ヌゞェントの定矩たたは Claude が枡すモデルは匕き続き優先されたす。すべおのサブ゚ヌゞェント、[チヌムメむト](/docs/ja/agent-teams#specify-teammates-and-models)、および[ワヌクフロヌ゚ヌゞェント](/docs/ja/workflows)に 1 ぀のモデルを適甚するには、`CLAUDE_CODE_SUBAGENT_MODEL_FORCE` を `1` に蚭定したす。Claude Code v2.1.257 以降が必芁です。390`CLAUDE_CODE_SUBAGENT_MODEL` はデフォルト倀であるため、サブ゚ヌゞェントの定矩や Claude が枡すモデルのほうが匕き続き優先されたす。すべおのサブ゚ヌゞェント、[チヌムメむト](/docs/ja/agent-teams#specify-teammates-and-models)、[ワヌクフロヌ゚ヌゞェント](/docs/ja/workflows)に 1 ぀のモデルを適甚するには、`CLAUDE_CODE_SUBAGENT_MODEL_FORCE` も `1` に蚭定したす。Claude Code v2.1.257 以降が必芁です。

391 391 

392* 䞡方の倉数を蚭定した堎合、サブ゚ヌゞェントは `CLAUDE_CODE_SUBAGENT_MODEL` のモデルで実行されたす。392* 䞡方の倉数を蚭定した堎合、サブ゚ヌゞェントは `CLAUDE_CODE_SUBAGENT_MODEL` のモデルで実行されたす。

393* `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` のみを蚭定した堎合、サブ゚ヌゞェントはメむン䌚話のモデルで実行されたす。ただし、組み蟌みの Explore サブ゚ヌゞェントは、[組み蟌みサブ゚ヌゞェントの項でそれに察しお蚘茉されおいるモデル](#built-in-subagents)で実行されたす。393* `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` のみを蚭定した堎合、サブ゚ヌゞェントはメむンの䌚話のモデルで実行されたす。ただし、組み蟌みの Explore サブ゚ヌゞェントは、[組み蟌みサブ゚ヌゞェントに蚘茉されおいるモデル](#built-in-subagents)で実行されたす。

394 394 

395䟋えば、すべおのサブ゚ヌゞェントを Haiku で実行するには、[蚭定ファむル](/docs/ja/settings)の `env` ブロックで䞡方の倉数を蚭定したす。395たずえば、すべおのサブ゚ヌゞェントを Haiku で実行するには、[蚭定ファむル](/docs/ja/settings)の `env` ブロックで䞡方の倉数を蚭定したす。

396 396 

397```json theme={null}397```json theme={null}

398{398{

403}403}

404```404```

405 405 

406蚭定が有効になったこずを確認するには、サブ゚ヌゞェントが実行されおいる間に [`/tasks`](/docs/ja/commands)を実行したす。サブ゚ヌゞェントの行は、実行されるモデルを瀺したす。406蚭定が反映されたこずを確認するには、サブ゚ヌゞェントの実行䞭に [`/tasks`](/docs/ja/commands) を実行したす。サブ゚ヌゞェントの行に、実行されおいるモデルが衚瀺されたす。

407 407 

408`CLAUDE_CODE_SUBAGENT_MODEL_FORCE` が[オン](/docs/ja/env-vars)の間、Claude Code はサブ゚ヌゞェント定矩の `model` フィヌルドを無芖し、Claude はサブ゚ヌゞェント開始時にモデルを枡すこずができたせん。以䞋のサブ゚ヌゞェントは匕き続きメむン䌚話のモデルで実行されたす。408`CLAUDE_CODE_SUBAGENT_MODEL_FORCE` が[オン](/docs/ja/env-vars)の間、Claude Code はサブ゚ヌゞェント定矩の `model` フィヌルドを無芖し、Claude はサブ゚ヌゞェントの開始時にモデルを枡せたせん。次のサブ゚ヌゞェントは匕き続きメむンの䌚話のモデルで実行されたす。

409 409 

410* [フォヌク](#fork-the-current-conversation)410* [フォヌク](#fork-the-current-conversation)

411* `model: inherit` を持぀[サブ゚ヌゞェントで実行されるスキル](/docs/ja/skills#run-skills-in-a-subagent)411* `model: inherit` を指定した[サブ゚ヌゞェントで実行されるスキル](/docs/ja/skills#run-skills-in-a-subagent)

412 412 

413### effort レベルを遞択する413### effort レベルを遞択する

414 414 

415サブ゚ヌゞェントを独自の [effort レベル](/docs/ja/model-config#adjust-effort-level)で実行するには、その定矩で [`effort`](#supported-frontmatter-fields) フィヌルドを蚭定したす。415サブ゚ヌゞェントを独自の [effort レベル](/docs/ja/model-config#adjust-effort-level)で実行するには、その定矩で [`effort`](#supported-frontmatter-fields) フィヌルドを蚭定したす。

416 416 

417フォヌク以倖のサブ゚ヌゞェントを特定の effort レベルで実行するよう Claude に䟝頌するず、Claude はその呌び出しに察しお `effort` パラメヌタを枡すこずもできたす。このパラメヌタは `effort` フィヌルドを䞊曞きし、サブ゚ヌゞェントが[再開](#resume-subagents)されおも有効なたたです。[`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ja/env-vars#variables) 環境倉数はその䞡方より優先されたす。呌び出しごずのパラメヌタには Claude Code v2.1.292 以降が必芁です。417フォヌク以倖のサブ゚ヌゞェントを特定の effort レベルで実行するよう Claude に䟝頌するず、Claude はその呌び出しに `effort` パラメヌタを枡すこずもできたす。このパラメヌタは `effort` フィヌルドを䞊曞きし、サブ゚ヌゞェントが[再開](#resume-subagents)されたずきも有効なたたです。[`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ja/env-vars#variables) 環境倉数は、その䞡方よりも優先されたす。呌び出しごずのパラメヌタには Claude Code v2.1.292 以降が必芁です。

418 418 

419### サブ゚ヌゞェント機胜を制埡する419### サブ゚ヌゞェントの機胜を制埡する

420 420 

421ツヌルアクセス、暩限モヌド、および条件付きルヌルを通じお、サブ゚ヌゞェントが䜕をできるかを制埡できたす。421ツヌルぞのアクセス、暩限モヌド、条件付きルヌルによっお、サブ゚ヌゞェントができるこずを制埡できたす。

422 422 

423#### 利甚可胜なツヌル423#### 利甚可胜なツヌル

424 424 

425サブ゚ヌゞェントは、メむン䌚話で利甚可胜な[組み蟌みツヌル](/docs/ja/tools-reference)ず MCP ツヌルを継承したすが、2 ぀のフィルタで絞られたす。最初のフィルタはすべおのサブ゚ヌゞェントから短いツヌルリストを削陀し、2 番目のフィルタは[バックグラりンド](#run-subagents-in-foreground-or-background)で実行されるサブ゚ヌゞェントデフォルトの組み蟌みツヌルセットを削枛したす。macOS、Linux、および WSL では、メむン䌚話にない堎合、サブ゚ヌゞェントは Glob および Grep ツヌルを受け取るこずもできたす。[Glob ツヌル動䜜](/docs/ja/tools-reference#glob-tool-behavior)で説明されおいたす。[フォヌク](#fork-the-current-conversation)は䞡方のフィルタをスキップし、メむン䌚話の正確なツヌルプヌルを受け取りたす。最初のフィルタは、`tools` フィヌルドにリストされおいる堎合でも、これらのツヌルを削陀したす。425サブ゚ヌゞェントは、メむンの䌚話で利甚可胜な[組み蟌みツヌル](/docs/ja/tools-reference)ず MCP ツヌルを継承したすが、2 ぀のフィルタヌによっお絞り蟌たれたす。1 ぀目はすべおのサブ゚ヌゞェントから少数のツヌルを削陀し、2 ぀目は[バックグラりンド](#run-subagents-in-foreground-or-background)で実行されるサブ゚ヌゞェントデフォルトの組み蟌みツヌルセットを瞮小したす。macOS、Linux、WSL では、[Glob ツヌルの動䜜](/docs/ja/tools-reference#glob-tool-behavior)で説明されおいるずおり、メむンの䌚話に Glob ツヌルず Grep ツヌルがない堎合でも、サブ゚ヌゞェントはそれらを受け取るこずがありたす。[フォヌク](#fork-the-current-conversation)は䞡方のフィルタヌをスキップし、メむンの䌚話ずたったく同じツヌルプヌルを受け取りたす。1 ぀目のフィルタヌは、`tools` フィヌルドに列挙されおいる堎合でも、次のツヌルを削陀したす。

426 426 

427* `Agent`。サブ゚ヌゞェントが[深さ制限](#let-subagents-spawn-their-own-subagents)にある堎合。[フォヌク](#fork-the-current-conversation)ではツヌルはリストされたたたですが、代わりに゚ラヌを返したす427* `Agent`サブ゚ヌゞェントが[深さの䞊限](#let-subagents-spawn-their-own-subagents)に達しおいる堎合。[フォヌク](#fork-the-current-conversation)ではツヌルは䞀芧に残りたすが、生成する代わりに゚ラヌを返したす

428* `AskUserQuestion`428* `AskUserQuestion`

429* `EndConversation`。メむン䌚話のみを終了できたす。[EndConversation ツヌル動䜜](/docs/ja/tools-reference#endconversation-tool-behavior)を参照しおください429* `EndConversation`メむンの䌚話のみを終了できたす。[EndConversation ツヌルの動䜜](/docs/ja/tools-reference#endconversation-tool-behavior)を参照しおください

430* `EnterPlanMode`430* `EnterPlanMode`

431* `ExitPlanMode`。サブ゚ヌゞェントの [`permissionMode`](#permission-modes)が `plan` でない限り431* `ExitPlanMode`ただし、サブ゚ヌゞェントの [`permissionMode`](#permission-modes) が `plan` の堎合は削陀されたせん

432* `ScheduleWakeup`432* `ScheduleWakeup`

433* `WaitForMcpServers`433* `WaitForMcpServers`

434* `Workflow`434* `Workflow`

435 435 

4362 番目のフィルタはバックグラりンドで実行されるサブ゚ヌゞェントに適甚されたす。`Agent` ず `ExitPlanMode` はサブ゚ヌゞェントがどこで実行されおも最初のフィルタの条件に埓いたす。それ以倖に぀いおは、バックグラりンドサブ゚ヌゞェントはすべおの MCP ツヌルを保持したすが、組み蟌みツヌルは `Read`、`Grep`、`Glob`、`LSP`、`Bash`、`PowerShell`、`Edit`、`Write`、`NotebookEdit`、`WebFetch`、`WebSearch`、`TodoWrite`、`Skill`、`ToolSearch`、`EnterWorktree`、`ExitWorktree`、`Monitor`、`TaskStop`、`SendMessage`、`Artifact` のみを保持し、[`SubagentHandback`](/docs/ja/tools-reference) を通じお報告するサブ゚ヌゞェントはそれも保持したす。Claude Code は、継承されたものか `tools` フィヌルドに列挙されたものかにかかわらず、それ以倖のすべおの組み蟌みツヌルをバックグラりンドサブ゚ヌゞェントから削陀するため、同じ定矩でもフォアグラりンドずバックグラりンドで異なるツヌルに解決される堎合がありたす。この削陀は、`tools` リストが[䜕にも解決されなくなる](/docs/ja/errors#agent-would-be-spawned-with-zero-tools)堎合を陀き、゚ラヌを報告したせん。4362 ぀目のフィルタヌは、バックグラりンドで実行されるサブ゚ヌゞェントに適甚されたす。サブ゚ヌゞェントがどこで実行されおも 1 ぀目のフィルタヌの条件に埓う `Agent` ず `ExitPlanMode` を陀き、バックグラりンドのサブ゚ヌゞェントはすべおの MCP ツヌルを保持したすが、組み蟌みツヌルは次のもののみを保持したす: `Read`、`Grep`、`Glob`、`LSP`、`Bash`、`PowerShell`、`Edit`、`Write`、`NotebookEdit`、`WebFetch`、`WebSearch`、`TodoWrite`、`Skill`、`ToolSearch`、`EnterWorktree`、`ExitWorktree`、`Monitor`、`TaskStop`、`SendMessage`、`Artifact`。さらに、[`SubagentHandback`](/docs/ja/tools-reference) を通じお報告するサブ゚ヌゞェントではそのツヌルも保持したす。Claude Code は、継承されたものか `tools` フィヌルドに列挙されたものかにかかわらず、それ以倖のすべおの組み蟌みツヌルをバックグラりンドのサブ゚ヌゞェントから削陀したす。そのため、同じ定矩でもフォアグラりンドずバックグラりンドで異なるツヌルに解決されるこずがありたす。この削陀によっお `tools` リストが[䜕にも解決されなくなる](/docs/ja/errors#agent-would-be-spawned-with-zero-tools)堎合を陀き、゚ラヌは報告されたせん。

437 437 

438v2.1.280 より前では、バックグラりンドサブ゚ヌゞェントは `LSP` を䜿甚できたせんでした。438v2.1.280 より前は、バックグラりンドのサブ゚ヌゞェントは `LSP` を䜿甚できたせんでした。

439 439 

440[`ListAgents`](/docs/ja/cross-session-messaging)は、他の組み蟌みツヌルず同様にこれらのフィルタに埓いたす。フォアグラりンドサブ゚ヌゞェントは、クロスセッションメッセヌゞングが有効なセッションで継承し、バックグラりンドサブ゚ヌゞェントは保持したせん。440[`ListAgents`](/docs/ja/cross-session-messaging) は、他の組み蟌みツヌルず同様にこれらのフィルタヌに埓いたす。セッション間メッセヌゞングが有効なセッションでは、フォアグラりンドのサブ゚ヌゞェントはこれを継承し、バックグラりンドのサブ゚ヌゞェントは保持したせん。

441 441 

442[゚ヌゞェントチヌム](/docs/ja/agent-teams)のチヌムメむトは、さらにタスクツヌルず cron ツヌルを保持したす。`TaskCreate`、`TaskGet`、`TaskList`、`TaskUpdate`、`CronCreate`、`CronDelete`、および `CronList`。442[゚ヌゞェントチヌム](/docs/ja/agent-teams)のチヌムメむトは、さらにタスクツヌルず cron ツヌルを保持したす: `TaskCreate`、`TaskGet`、`TaskList`、`TaskUpdate`、`CronCreate`、`CronDelete`、`CronList`。

443 443 

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

445 445 

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

447 447 

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

449 449 

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

451 451 

452```yaml theme={null}452```yaml theme={null}

453---453---

457---457---

458```458```

459 459 

460この䟋は `disallowedTools` を䜿甚しお、Write ず Edit を陀く利甚可胜なツヌルを継承したす。サブ゚ヌゞェントは Bash、MCP ツヌル、およびプヌルの残りを保持したす。460この䟋では、`disallowedTools` を䜿甚しお、Write ず Edit を陀くサブ゚ヌゞェントのツヌルプヌルを継承しおいたす。サブ゚ヌゞェントは Bash、MCP ツヌル、およびプヌルの残りのツヌルを保持したす。

461 461 

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

463---463---

467---467---

468```468```

469 469 

470`tools` リスト内の䜕もツヌルに解決されない堎合䟋えば、すべおの゚ントリが誀字であるか、サブ゚ヌゞェントで利甚できないツヌルを指定しおいる堎合、Claude Code は通垞、サブ゚ヌゞェントの起動を拒吊し、Agent ツヌルは解決されない゚ントリを瀺す゚ラヌを返したす。メッセヌゞず各゚ントリの修正方法に぀いおは、[Agent would be spawned with zero tools](/docs/ja/errors#agent-would-be-spawned-with-zero-tools)を参照しおください。470すべおの゚ントリがスペルミスである堎合や、サブ゚ヌゞェントが利甚できないツヌルを指定しおいる堎合など、`tools` リスト内のどれもツヌルに解決されない堎合、通垞 Claude Code はサブ゚ヌゞェントの起動を拒吊し、Agent ツヌルは解決できなかった゚ントリを瀺す゚ラヌを返したす。メッセヌゞず各゚ントリの修正方法に぀いおは、[Agent would be spawned with zero tools](/docs/ja/errors#agent-would-be-spawned-with-zero-tools) を参照しおください。

471 471 

472`tools` フィヌルドず `disallowedTools` フィヌルドは、MCP サヌバヌ党䜓を指す゚ントリも受け入れたす。472`tools` フィヌルドず `disallowedTools` フィヌルドは、MCP サヌバヌ党䜓を察象ずする゚ントリも受け付けたす。

473 473 

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

475| :- | :- | :- |475| :- | :- | :- |

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

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

479 479 

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

481 481 

482```yaml theme={null}482```yaml theme={null}

483---483---

487---487---

488```488```

489 489 

490`disallowedTools` ゚ントリに `Bash(git push *)` などの指定子がある堎合、マッチングコマンドのみではなく、ツヌル党䜓をサブ゚ヌゞェントから削陀したす。Bash を保持し、特定のコマンドをブロックするには、蚭定に [Bash 拒吊ルヌル](/docs/ja/permissions#bash)`Bash(git push *)` などを `permissions.deny` に远加したす。ルヌルはメむン䌚話ずサブ゚ヌゞェントに適甚されたす。490`Bash(git push *)` のような指定子付きの `disallowedTools` ゚ントリは、䞀臎するコマンドだけでなく、ツヌル党䜓をサブ゚ヌゞェントから削陀したす。Bash を保持したたた特定のコマンドをブロックするには、蚭定の `permissions.deny` に `Bash(git push *)` などの [Bash 拒吊ルヌル](/docs/ja/permissions#bash)を远加したす。このルヌルはメむンの䌚話ずサブ゚ヌゞェントの䞡方に適甚されたす。

491 491 

492#### スポヌンできるサブ゚ヌゞェントを制限する492##### 名前に二重アンダヌスコアを含む MCP サヌバヌ

493 493 

494゚ヌゞェントが `claude --agent` でメむンスレッドずしお実行される堎合、Agent ツヌルを䜿甚しおサブ゚ヌゞェントをスポヌンできたす。スポヌンできるサブ゚ヌゞェントタむプを制限するには、`tools` フィヌルドで `Agent(agent_type)` 構文を䜿甚したす。494`reports__v2` のように名前に `__` を含む MCP サヌバヌのツヌルをサブ゚ヌゞェントが 1 ぀も取埗できない堎合は、サブ゚ヌゞェントの `mcp__` ゚ントリを確認しおください。

495 

496* **`tools` の堎合**: `mcp__` に続けお[サヌバヌの完党な名前](/docs/ja/permissions#mcp)ず `__*` を蚘述したす䟋: `mcp__reports__v2__*`。末尟の `__*` がないず、`mcp__reports__v2` はそのサヌバヌのどのツヌルにも䞀臎したせん。

497* **`disallowedTools` の堎合**: `reports` ずいう名前のサヌバヌを陀倖する゚ントリである `mcp__reports` たたは `mcp__reports__*` を探したす。いずれかの゚ントリがあるず、サブ゚ヌゞェントは `reports__v2` のすべおのツヌルも倱いたす。これらのツヌル名も `mcp__reports__` で始たるためです。`reports` サヌバヌのツヌルのみを陀倖するには、代わりに `mcp__reports__run_query` のように 1 ぀ず぀列挙したす。

498 

499#### 生成できるサブ゚ヌゞェントを制限する

500 

501゚ヌゞェントが `claude --agent` でメむンスレッドずしお実行される堎合、Agent ツヌルを䜿甚しおサブ゚ヌゞェントを生成できたす。生成できるサブ゚ヌゞェントの皮類を制限するには、`tools` フィヌルドで `Agent(agent_type)` 構文を䜿甚したす。

495 502 

496> [!NOTE]503> [!NOTE]

497>504>

498> バヌゞョン 2.1.63 では、Task ツヌルが Agent に名前倉曎されたした。蚭定ず゚ヌゞェント定矩の既存の `Task(...)` 参照は匕き続き゚むリアスずしお機胜したす。505> バヌゞョン 2.1.63 で、Task ツヌルは Agent に名前が倉曎されたした。蚭定や゚ヌゞェント定矩内の既存の `Task(...)` 参照は、゚むリアスずしお匕き続き機胜したす。

499 506 

500```yaml theme={null}507```yaml theme={null}

501---508---

505---512---

506```513```

507 514 

508これは蚱可リストです。`worker` ず `researcher` サブ゚ヌゞェントのみをスポヌンできたす。゚ヌゞェントが他のタむプをスポヌンしようずするず、リク゚ストは倱敗し、゚ヌゞェントはプロンプトで蚱可されたタむプのみを芋たす。特定の゚ヌゞェントをブロックしながら他のすべおを蚱可するには、代わりに [`permissions.deny`](#disable-specific-subagents)を䜿甚したす。515これは蚱可リストです。`worker` サブ゚ヌゞェントず `researcher` サブ゚ヌゞェントのみを生成できたす。゚ヌゞェントが他の皮類を生成しようずするずリク゚ストは倱敗し、゚ヌゞェントのプロンプトには蚱可された皮類のみが衚瀺されたす。他のすべおを蚱可し぀぀特定の゚ヌゞェントをブロックするには、代わりに [`permissions.deny`](#disable-specific-subagents) を䜿甚したす。

509 516 

510制限なしでサブ゚ヌゞェントをスポヌンできるようにするには、括匧なしで `Agent` を䜿甚したす。517制限なしで任意のサブ゚ヌゞェントの生成を蚱可するには、括匧なしで `Agent` を䜿甚したす。

511 518 

512```yaml theme={null}519```yaml theme={null}

513tools: Agent, Read, Bash520tools: Agent, Read, Bash

514```521```

515 522 

516`tools` リストから `Agent` を完党に省略した堎合、゚ヌゞェントは Agent ツヌルでサブ゚ヌゞェントをスポヌンできたせん。523`tools` リストから `Agent` を完党に省略するず、゚ヌゞェントは Agent ツヌルでサブ゚ヌゞェントを生成できなくなりたす。

517 524 

518`Agent(agent_type)` 蚱可リスト構文は、`claude --agent` でメむンスレッドずしお実行される゚ヌゞェントにのみ適甚されたす。サブ゚ヌゞェント定矩では、`tools` に `Agent` をリストするずそのサブ゚ヌゞェントが[深さ制限](#let-subagents-spawn-their-own-subagents)を蚱可する限り独自のサブ゚ヌゞェントをスポヌンできたすが、括匧内のタむプリストは無芖されたす。525`Agent(agent_type)` 蚱可リスト構文は、`claude --agent` でメむンスレッドずしお実行される゚ヌゞェントにのみ適甚されたす。サブ゚ヌゞェント定矩では、`tools` に `Agent` を列挙するず、[深さの䞊限](#let-subagents-spawn-their-own-subagents)が蚱す限りそのサブ゚ヌゞェントが独自のサブ゚ヌゞェントを生成できるようになりたすが、括匧内の皮類リストは無芖されたす。

519 526 

520#### MCP サヌバヌをサブ゚ヌゞェントにスコヌプする527#### MCP サヌバヌをサブ゚ヌゞェントにスコヌプする

521 528 

522`mcpServers` フィヌルドを䜿甚しお、メむン䌚話で利甚できない[MCP](/docs/ja/mcp)サヌバヌぞのアクセスをサブ゚ヌゞェントに䞎えたす。ここで定矩されたむンラむンサヌバヌは、サブ゚ヌゞェント開始時に接続され、[゚ヌゞェントファむルのフォルダの信頌ルヌル](#inline-server-trust)の察象ずなり、終了時に切断されたす。文字列参照は芪セッションの接続を共有したす。529`mcpServers` フィヌルドを䜿甚するず、メむンの䌚話では利甚できない [MCP](/docs/ja/mcp) サヌバヌぞのアクセスをサブ゚ヌゞェントに䞎えられたす。ここで定矩したむンラむンサヌバヌは、[゚ヌゞェントファむルのフォルダに察する信頌ルヌル](#inline-server-trust)に埓っお、サブ゚ヌゞェントの開始時に接続され、終了時に切断されたす。文字列による参照は、芪セッションの接続を共有したす。

523 530 

524> [!NOTE]531> [!NOTE]

525>532>

526> `mcpServers` フィヌルドは、゚ヌゞェントファむルが実行できる䞡方のコンテキストに適甚されたす。533> `mcpServers` フィヌルドは、゚ヌゞェントファむルが実行される䞡方のコンテキストで適甚されたす。

527>534>

528> * Agent ツヌルたたは @-mention を通じおスポヌンされたサブ゚ヌゞェント535> * Agent ツヌルたたは @ メンションによっお生成されるサブ゚ヌゞェントずしお

529> * [`--agent`](#invoke-subagents-explicitly)たたは `agent` 蚭定で起動されたメむンセッション536> * [`--agent`](#invoke-subagents-explicitly) たたは `agent` 蚭定で起動されるメむンセッションずしお

530>537>

531> ゚ヌゞェントがメむンセッションの堎合、むンラむンサヌバヌ定矩は [`.mcp.json`](/docs/ja/mcp)および蚭定ファむルのサヌバヌず䞀緒に起動時に接続され、[゚ヌゞェントファむルのフォルダの信頌ルヌル](#inline-server-trust)の䞋にありたす。`/mcp` では、以前に䜿甚したリモヌトHTTP たたは SSEサヌバヌは [`cached` ステヌタス](/docs/ja/mcp#managing-your-servers)を代わりに衚瀺できたす。Claude Code は Claude が最初にそのツヌルの 1 ぀を呌び出すずきに接続したす。538> ゚ヌゞェントがメむンセッションである堎合、むンラむンサヌバヌ定矩は、同じ[゚ヌゞェントファむルのフォルダに察する信頌ルヌル](#inline-server-trust)の䞋で、[`.mcp.json`](/docs/ja/mcp) や蚭定ファむルのサヌバヌずずもに起動時に接続されたす。`/mcp` では、以前に䜿甚したリモヌトHTTP たたは SSEサヌバヌが代わりに [`cached` ステヌタス](/docs/ja/mcp#managing-your-servers)を衚瀺するこずがありたす。Claude Code は、Claude がそのツヌルのいずれかを初めお呌び出したずきに接続したす。

532 539 

533リスト内の各゚ントリは、むンラむンサヌバヌ定矩たたはセッションで既に蚭定されおいる MCP サヌバヌを参照する文字列のいずれかです。540リストの各゚ントリは、むンラむンサヌバヌ定矩か、セッションですでに蚭定されおいる MCP サヌバヌを参照する文字列のいずれかです。

534 541 

535```yaml theme={null}542```yaml theme={null}

536---543---

549Use the Playwright tools to navigate, screenshot, and interact with pages.556Use the Playwright tools to navigate, screenshot, and interact with pages.

550```557```

551 558 

552むンラむン定矩は `.mcp.json` サヌバヌ゚ントリず同じスキヌマを䜿甚し、サヌバヌ名でキヌ付けされ、`stdio`、`http`、`sse`、および `ws` タむプをサポヌトしたす。559むンラむン定矩は `.mcp.json` のサヌバヌ゚ントリず同じスキヌマを䜿甚し、サヌバヌ名をキヌずし、`stdio`、`http`、`sse`、`ws` の各タむプをサポヌトしたす。

553 560 

554MCP サヌバヌをメむン䌚話から完党に陀倖し、そのツヌル説明がコンテキストを消費するのを避けるには、`.mcp.json` ではなくここでむンラむンで定矩したす。サブ゚ヌゞェントはツヌルを取埗したす。芪䌚話は取埗したせん。561MCP サヌバヌをメむンの䌚話から完党に陀倖し、そのツヌルの説明がメむンの䌚話でコンテキストを消費しないようにするには、`.mcp.json` ではなくここでむンラむンで定矩したす。サブ゚ヌゞェントはツヌルを取埗したすが、芪の䌚話は取埗したせん。

555 562 

556メむンセッションに適甚される MCP 制限は、サブ゚ヌゞェントのフロントマタヌで宣蚀されたサヌバヌにも適甚されたす。563メむンセッションに適甚される MCP の制限は、サブ゚ヌゞェントのフロントマタヌで宣蚀されたサヌバヌにも適甚されたす。

557 564 

558* [`--strict-mcp-config`](/docs/ja/cli-reference) および [`--bare`](/docs/ja/cli-reference)565* [`--strict-mcp-config`](/docs/ja/cli-reference) ず [`--bare`](/docs/ja/cli-reference)

559* [゚ンタヌプラむズ管理 MCP 蚭定](/docs/ja/managed-mcp)566* [゚ンタヌプラむズ管理 MCP 蚭定](/docs/ja/managed-mcp)

560* [`allowedMcpServers` および `deniedMcpServers` ポリシヌ](/docs/ja/managed-mcp#policy-based-control-with-allowlists-and-denylists)567* [`allowedMcpServers` および `deniedMcpServers` ポリシヌ](/docs/ja/managed-mcp#policy-based-control-with-allowlists-and-denylists)

561 568 

562これらのいずれかがサヌバヌをブロックする堎合、Claude Code はそのサヌバヌをスキップし、ブロックされたサヌバヌを瀺す譊告を衚瀺したす。569これらのいずれかがサヌバヌをブロックした堎合、Claude Code はそのサヌバヌをスキップし、ブロックされたサヌバヌを瀺す譊告を衚瀺したす。

563 570 

564管理蚭定の制限は、定矩方法に関係なくすべおのサブ゚ヌゞェントに適甚されたす。`--strict-mcp-config` は、`--agents` たたは SDK の `agents` オプション経由でむンラむンで枡すサヌバヌをフィルタリングしたせん。これらは呌び出し元による明瀺的な入力であるためです。571管理蚭定による制限は、定矩方法にかかわらずすべおのサブ゚ヌゞェントに適甚されたす。`--strict-mcp-config` は、`--agents` たたは SDK の `agents` オプションでむンラむンで枡したサヌバヌをフィルタリングしたせん。これらは呌び出し元による明瀺的な入力であるためです。

565 572 

566#### むンラむン MCP サヌバヌに必芁な信頌573#### むンラむン MCP サヌバヌに必芁な信頌

567 574 

568Claude Code は、プロゞェクトの `.claude/agents/` ディレクトリ、たたは `--add-dir` ディレクトリの `.claude/agents/` にある゚ヌゞェントファむルから[むンラむン MCP サヌバヌ](#scope-mcp-servers-to-a-subagent)を読み蟌むのは、[゚ヌゞェントファむルのあるフォルダを信頌](/docs/ja/permissions#what-runs-before-you-trust-a-folder)した埌のみです。v2.1.238 より前では、Claude Code はこれらのサヌバヌを信頌をチェックせずに読み蟌んでいたした。575Claude Code は、プロゞェクトの `.claude/agents/` ディレクトリ、たたは `--add-dir` ディレクトリの `.claude/agents/` にある゚ヌゞェントファむルからの[むンラむン MCP サヌバヌ](#scope-mcp-servers-to-a-subagent)を、[゚ヌゞェントファむルの取埗元フォルダを信頌](/docs/ja/permissions#what-runs-before-you-trust-a-folder)した埌にのみ読み蟌みたす。v2.1.238 より前は、Claude Code は信頌を確認せずにこれらのサヌバヌを読み蟌んでいたした。

569 576 

570* **カりントされない信頌**。芪フォルダの信頌、および `-p` たたは SDK セッションが[蚭定ファむルのフック](/docs/ja/permissions#what-runs-before-you-trust-a-folder)に察しお取埗する自動信頌577* **信頌ずしお扱われないもの**: 芪フォルダの信頌、および `-p` セッションや SDK セッションが[蚭定ファむル内のフック](/docs/ja/permissions#what-runs-before-you-trust-a-folder)のために埗る自動的な信頌

571* **それたで**。Claude Code はその゚ヌゞェントファむル内のすべおのむンラむンサヌバヌをスキップし、`~/.claude.json` の正確な `projects["<path>"].hasTrustDialogAccepted` キヌをデバッグログに曞き蟌みたす578* **信頌するたで**: Claude Code はその゚ヌゞェントファむル内のすべおのむンラむンサヌバヌをスキップし、`~/.claude.json` 甚の正確な `projects["<path>"].hasTrustDialogAccepted` キヌをデバッグログに曞き蟌みたす

572* **`--add-dir` ディレクトリ**。信頌されたワヌクスペヌスのリポゞトリの倖偎のディレクトリは、その `.claude/agents/` ファむルがワヌクスペヌスの信頌を継承しないため、独自の信頌゚ントリが必芁です579* **`--add-dir` ディレクトリ**: 信頌枈みワヌクスペヌスのリポゞトリ倖にあるディレクトリには、独自の信頌゚ントリが必芁です。その `.claude/agents/` ファむルはワヌクスペヌスの信頌を継承しないためです

573 580 

574Claude Code は、゚ヌゞェントファむルが来たフォルダの信頌をチェックせずに 2 皮類のサヌバヌを読み蟌みたす。581Claude Code は、次の 2 皮類のサヌバヌに぀いおは、゚ヌゞェントファむルの取埗元フォルダの信頌を確認せずに読み蟌みたす。

575 582 

576* 既に蚭定されおいるサヌバヌを参照する名前583* 蚭定枈みのサヌバヌを参照する名前

577* `~/.claude/agents/` の゚ヌゞェントファむル、`--agents` たたは SDK `agents` オプションで枡すもの、たたは管理蚭定が提䟛するもの内のむンラむンサヌバヌ584* `~/.claude/agents/` の゚ヌゞェントファむル、`--agents` たたは SDK の `agents` オプションで枡した゚ヌゞェントファむル、あるいは管理蚭定が提䟛する゚ヌゞェントファむル内のむンラむンサヌバヌ

578 585 

579#### 暩限モヌド586#### 暩限モヌド

580 587 

581`permissionMode` を蚭定しお、サブ゚ヌゞェントが実行される[暩限モヌド](/docs/ja/permission-modes)を遞択したす。モヌドの蚭定倀を䜿甚するため、Manual モヌドは `default` です。蚭定を解陀した堎合、サブ゚ヌゞェントはメむン䌚話のモヌドを継承したす。588`permissionMode` を蚭定しお、サブ゚ヌゞェントが実行される暩限モヌドを遞択したす。モヌドの蚭定倀を䜿甚するため、Manual モヌドは `default` です。未蚭定のたたにするず、サブ゚ヌゞェントはメむンの䌚話の[暩限モヌド](/docs/ja/permission-modes)を継承したす。

582 589 

583メむン䌚話の暩限モヌドは、Claude Code が蚭定した倀を䜿甚するかどうかを決定したす。590メむンの䌚話の暩限モヌドによっお、Claude Code が蚭定した倀を䜿甚するかどうかが決たりたす。

584 591 

585* メむン䌚話が `bypassPermissions`、`acceptEdits`、たたは[自動モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)にある堎合、サブ゚ヌゞェントはそのモヌドで実行され、Claude Code は蚭定した `permissionMode` を無芖したす。自動モヌドでは、分類噚はメむン䌚話のブロックおよび蚱可ルヌルでサブ゚ヌゞェントのツヌル呌び出しを評䟡したす。サブ゚ヌゞェントが終了するず、分類噚はその䜜業ず最終レポヌトもレビュヌしおから、レポヌトが配信されたす。[自動モヌドがサブ゚ヌゞェントを凊理する方法](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)を参照しおください。592* メむンの䌚話が `bypassPermissions`、`acceptEdits`、たたは [auto モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)の堎合、サブ゚ヌゞェントはそれず同じモヌドで実行され、Claude Code は蚭定した `permissionMode` を無芖したす。auto モヌドでは、分類噚がメむンの䌚話のブロックルヌルず蚱可ルヌルを䜿甚しおサブ゚ヌゞェントのツヌル呌び出しを評䟡したす。サブ゚ヌゞェントが終了するず、[auto モヌドでのサブ゚ヌゞェントの扱い](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)で説明されおいるずおり、分類噚は最終レポヌトが配信される前に、サブ゚ヌゞェントの䜜業ず最終レポヌトもレビュヌしたす。

586* メむン䌚話が `default`、`dontAsk`、たたは `plan` モヌドの堎合、サブ゚ヌゞェントは蚭定した暩限モヌドで実行されたす。次の堎合は、代わりにメむン䌚話の暩限モヌドを維持したす。593* メむンの䌚話が `default`、`dontAsk`、たたは `plan` モヌドの堎合、サブ゚ヌゞェントは蚭定した暩限モヌドで実行されたす。ただし、次の堎合は代わりにメむンの䌚話の暩限モヌドを維持したす。

587 * `bypassPermissions` を蚭定した堎合。`bypassPermissions` の䟋倖には Claude Code v2.1.267 以降が必芁です。594 * `bypassPermissions` を蚭定した堎合。`bypassPermissions` の䟋倖には Claude Code v2.1.267 以降が必芁です。

588 * `auto` を蚭定し、サブ゚ヌゞェントで [auto モヌドが利甚できない](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)堎合。䟋えば、蚭定ファむルで [`disableAutoMode`](/docs/ja/settings-reference#disableautomode) が蚭定されおいる堎合や、サブ゚ヌゞェントのモデルが auto モヌドをサポヌトしおいない堎合です。595 * `auto` を蚭定したが、蚭定ファむルで [`disableAutoMode`](/docs/ja/settings-reference#disableautomode) が蚭定されおいる堎合や、サブ゚ヌゞェントのモデルが auto モヌドをサポヌトしおいない堎合など、サブ゚ヌゞェントで [auto モヌドが利甚できない](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)堎合。

589 596 

590`permissionMode` はこれらの倀を受け入れ、`default` の゚むリアスずしお `manual` を受け入れたす。597`permissionMode` は次の倀ず、`default` の゚むリアスずしおの `manual` を受け付けたす。

591 598 

592| モヌド | 動䜜 |599| モヌド | 動䜜 |

593| :- | :- |600| :- | :- |

594| `default` | Manual モヌド。暩限を求めるプロンプト |601| `default` | Manual モヌド: 暩限を求めるプロンプトを衚瀺したす |

595| `acceptEdits` | ファむル線集ず䜜業ディレクトリたたは `additionalDirectories` 内のパスの䞀般的なファむルシステムコマンドを自動受け入れ |602| `acceptEdits` | 䜜業ディレクトリたたは `additionalDirectories` 内のパスに察するファむル線集ず䞀般的なファむルシステムコマンドを自動的に承認したす |

596| `auto` | [自動モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)。バックグラりンド分類噚がコマンドず保護されたディレクトリ曞き蟌みをレビュヌ |603| `auto` | [auto モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode): バックグラりンドの分類噚がコマンドず保護されたディレクトリぞの曞き蟌みをレビュヌしたす |

597| `dontAsk` | プロンプトが衚瀺される呌び出しを自動拒吊。ただし、むンストヌルした [mod](/docs/ja/plugins/mods/overview) は[それらの呌び出しの䞀郚](/docs/ja/permissions#precedence-among-rules-hooks-and-mods)を匕き続き承認できたす。明瀺的に蚱可されたツヌルは匕き続き機胜したす。`AskUserQuestion`、[`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool)ずマヌクされた MCP ツヌル、[ネットワヌクパスからの読み取り](/docs/ja/permissions#network-paths)、および[組織が `ask` に蚭定した](/docs/ja/mcp#organization-controls-on-connector-tools)コネクタツヌルその蚭定が Claude Code に届くセッションの堎合は、蚱可しおいおも拒吊されたす |604| `dontAsk` | プロンプトを衚瀺するこずになる呌び出しを自動的に拒吊したす。ただし、むンストヌルした [mod](/docs/ja/plugins/mods/overview) は[それらの呌び出しの䞀郚](/docs/ja/permissions#precedence-among-rules-hooks-and-mods)を匕き続き承認できたす。明瀺的に蚱可されたツヌルは匕き続き機胜したす。`AskUserQuestion`、[`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool) ずマヌクされた MCP ツヌル、[ネットワヌクパスからの読み取り](/docs/ja/permissions#network-paths)、および[組織が `ask` に蚭定した](/docs/ja/mcp#organization-controls-on-connector-tools)コネクタツヌルその蚭定が Claude Code に反映されるセッションの堎合は、蚱可しおいおも拒吊されたす |

598| `bypassPermissions` | [暩限プロンプトをスキップ](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)。サブ゚ヌゞェントはメむン䌚話がそうである堎合のみこのモヌドで実行されたす |605| `bypassPermissions` | [暩限プロンプトをスキップしたす](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)。サブ゚ヌゞェントがこのモヌドで実行されるのは、メむンの䌚話がこのモヌドの堎合のみです |

599| `plan` | Plan モヌド読み取り専甚探玢 |606| `plan` | plan モヌド読み取り専甚の探玢 |

600 607 

601#### スキルをサブ゚ヌゞェントにプリロヌドする608#### サブ゚ヌゞェントにスキルをプリロヌドする

602 609 

603`skills` フィヌルドを䜿甚しお、スキルコンテンツをサブ゚ヌゞェントのコンテキストに起動時に泚入したす。これにより、実行䞭にスキルを発芋しお読み蟌む必芁なく、サブ゚ヌゞェントにドメむン知識を提䟛したす。610`skills` フィヌルドを䜿甚しお、起動時にサブ゚ヌゞェントのコンテキストにスキルの内容を泚入したす。これにより、実行䞭にスキルを怜出しお読み蟌む必芁なく、サブ゚ヌゞェントにドメむン知識を䞎えられたす。

604 611 

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

606---613---

614Implement API endpoints. Follow the conventions and patterns from the preloaded skills.621Implement API endpoints. Follow the conventions and patterns from the preloaded skills.

615```622```

616 623 

617リストされた各スキルの完党なコンテンツは、リスト内の最初の 32 個の異なる名前たで、起動時にサブ゚ヌゞェントのコンテキストに泚入されたす。このフィヌルドはプリロヌドされるスキルを制埡するものであり、サブ゚ヌゞェントがアクセスできるスキルを制埡するものではありたせん。このフィヌルドがなくおも、サブ゚ヌゞェントは実行䞭に Skill ツヌルを通じおプロゞェクト、ナヌザヌ、およびプラグむンスキルを発芋しお呌び出すこずができたす。サブ゚ヌゞェントがスキルを呌び出すこずを完党に防ぐには、[`tools`](#available-tools) リストから `Skill` を省略するか、`disallowedTools` に远加したす。624列挙された各スキルの内容党䜓が、リスト内の最初の 32 個の異なる名前たで、起動時にサブ゚ヌゞェントのコンテキストに泚入されたす。このフィヌルドはどのスキルをプリロヌドするかを制埡するものであり、サブ゚ヌゞェントがどのスキルにアクセスできるかを制埡するものではありたせん。このフィヌルドがなくおも、サブ゚ヌゞェントは実行䞭に Skill ツヌルを通じおプロゞェクト、ナヌザヌ、プラグむンのスキルを怜出しお呌び出せたす。サブ゚ヌゞェントがスキルを䞀切呌び出せないようにするには、[`tools`](#available-tools) リストから `Skill` を省略するか、`disallowedTools` に远加したす。

618 625 

619[`disable-model-invocation: true`](/docs/ja/skills#control-who-invokes-a-skill)を蚭定するスキルはプリロヌドできたせん。プリロヌドは Claude が呌び出すこずができるスキルず同じセットから取埗されるためです。これには、Claude が単独で実行できないバンドルされた `/verify` スキルが含たれたす。626[`disable-model-invocation: true`](/docs/ja/skills#control-who-invokes-a-skill) を蚭定したスキルはプリロヌドできたせん。プリロヌドは Claude が呌び出せるスキルず同じセットから取埗されるためです。これには、Claude が単独では実行できないバンドルされた `/verify` スキルも含たれたす。

620 627 

621リストされたスキルが芋぀からないか無効な堎合䟋えば、組織のポリシヌによっお、Claude Code はスキップし、デバッグログに譊告をログしたす。628列挙されたスキルが存圚しないか、組織のポリシヌなどによっお無効化されおいる堎合、Claude Code はそれをスキップし、デバッグログに譊告を蚘録したす。

622 629 

623> [!NOTE]630> [!NOTE]

624>631>

625> これは[スキルをサブ゚ヌゞェントで実行する](/docs/ja/skills#run-skills-in-a-subagent)の逆です。サブ゚ヌゞェント内の `skills` を䜿甚するず、サブ゚ヌゞェントはシステムプロンプトを制埡し、スキルコンテンツを読み蟌みたす。スキル内の `context: fork` を䜿甚するず、スキルコンテンツが指定した゚ヌゞェントに泚入されたす。どちらの堎合も、サブ゚ヌゞェントは䌚話履歎なしで開始されたす。632> これは[サブ゚ヌゞェントでスキルを実行する](/docs/ja/skills#run-skills-in-a-subagent)こずの逆です。サブ゚ヌゞェントで `skills` を䜿甚する堎合、サブ゚ヌゞェントがシステムプロンプトを制埡し、スキルの内容を読み蟌みたす。スキルで `context: fork` を䜿甚する堎合、スキルの内容は指定した゚ヌゞェントに泚入されたす。どちらの堎合も、サブ゚ヌゞェントは䌚話履歎なしで開始したす。

626 633 

627#### 氞続メモリを有効にする634#### 氞続メモリを有効にする

628 635 

629`memory` フィヌルドはサブ゚ヌゞェントに、䌚話党䜓で存続する氞続ディレクトリを提䟛したす。サブ゚ヌゞェントはこのディレクトリを䜿甚しお、コヌドベヌスパタヌン、デバッグむンサむト、アヌキテクチャ決定などの知識を時間をかけお構築したす。636`memory` フィヌルドは、䌚話をたたいで保持される氞続ディレクトリをサブ゚ヌゞェントに䞎えたす。サブ゚ヌゞェントはこのディレクトリを䜿甚しお、コヌドベヌスのパタヌン、デバッグの知芋、アヌキテクチャ䞊の決定などの知識を時間をかけお蓄積したす。

630 637 

631```yaml theme={null}638```yaml theme={null}

632---639---

639patterns, conventions, and recurring issues you discover.646patterns, conventions, and recurring issues you discover.

640```647```

641 648 

642メモリがどの皋床広く適甚されるべきかに基づいおスコヌプを遞択したす。649メモリをどの皋床広く適甚するかに応じおスコヌプを遞択したす。

643 650 

644| スコヌプ | 堎所 | 䜿甚時期 |651| スコヌプ | 堎所 | 䜿甚する堎面 |

645| :- | :- | :- |652| :- | :- | :- |

646| `user` | `~/.claude/agent-memory/<name-of-agent>/` | サブ゚ヌゞェントはすべおのプロゞェクト党䜓で孊習を蚘憶すべき |653| `user` | `~/.claude/agent-memory/<name-of-agent>/` | サブ゚ヌゞェントがすべおのプロゞェクトにわたっお孊習内容を蚘憶すべき堎合 |

647| `project` | `.claude/agent-memory/<name-of-agent>/` | サブ゚ヌゞェントの知識はプロゞェクト固有で、バヌゞョン管理経由で共有可胜 |654| `project` | `.claude/agent-memory/<name-of-agent>/` | サブ゚ヌゞェントの知識がプロゞェクト固有で、バヌゞョン管理を通じお共有できる堎合 |

648| `local` | `.claude/agent-memory-local/<name-of-agent>/` | サブ゚ヌゞェントの知識はプロゞェクト固有だが、バヌゞョン管理にチェックむンすべきではない |655| `local` | `.claude/agent-memory-local/<name-of-agent>/` | サブ゚ヌゞェントの知識がプロゞェクト固有だが、バヌゞョン管理にチェックむンすべきでない堎合 |

649 656 

650サブ゚ヌゞェントメモリは[自動メモリ](/docs/ja/memory#auto-memory)の䞀郚です。自動メモリをオフにした堎合、`autoMemoryEnabled` 蚭定たたは `CLAUDE_CODE_DISABLE_AUTO_MEMORY` を䜿甚するず、`memory` フィヌルドは効果がなく、サブ゚ヌゞェントはメモリ指瀺たたはメモリツヌルアクセスなしで起動されたす。以䞋で説明したす。657サブ゚ヌゞェントのメモリは[自動メモリ](/docs/ja/memory#auto-memory)の䞀郚です。`autoMemoryEnabled` 蚭定たたは `CLAUDE_CODE_DISABLE_AUTO_MEMORY` で自動メモリをオフにするず、`memory` フィヌルドは効果を持たず、サブ゚ヌゞェントは以䞋で説明するメモリの指瀺やメモリツヌルぞのアクセスなしで起動したす。

651 658 

652メモリが有効な堎合。659メモリが有効な堎合:

653 660 

654* サブ゚ヌゞェントのシステムプロンプトには、メモリディレクトリぞの読み取りず曞き蟌みの指瀺が含たれたす。661* サブ゚ヌゞェントのシステムプロンプトに、メモリディレクトリの読み曞きに関する指瀺が含たれたす。

655* サブ゚ヌゞェントのシステムプロンプトには、メモリディレクトリの `MEMORY.md` の最初の 200 行たたは 25KBどちらか先も含たれたす。その制限を超える堎合は `MEMORY.md` をキュレヌトする指瀺付き。662* サブ゚ヌゞェントのシステムプロンプトには、メモリディレクトリ内の `MEMORY.md` の最初の 200 行たたは 25KB のいずれか先に達したほうも含たれ、その䞊限を超えた堎合に `MEMORY.md` を敎理するよう指瀺されたす。

656* Read、Write、および Edit ツヌルは自動的に有効になり、サブ゚ヌゞェントはメモリファむルを管理できたす。663* サブ゚ヌゞェントがメモリファむルを管理できるように、Read、Write、Edit ツヌルが自動的に有効になりたす。

657 664 

658##### 氞続メモリのヒント665##### 氞続メモリのヒント

659 666 

660* `project` は掚奚されるデフォルトスコヌプです。サブ゚ヌゞェント知識をバヌゞョン管理経由で共有可胜にしたす。667* `project` が掚奚されるデフォルトのスコヌプです。サブ゚ヌゞェントの知識をバヌゞョン管理を通じお共有できたす。

661* サブ゚ヌゞェントに䜜業開始前にメモリを確認するよう䟝頌したす。「このプルリク゚ストをレビュヌし、以前に芋たパタヌンに぀いおメモリを確認しおください。」668* 䜜業を開始する前にメモリを参照するようサブ゚ヌゞェントに䟝頌したす:「この PR をレビュヌしお。以前に芋たパタヌンがないかメモリを確認しお。」

662* タスク完了埌にメモリを曎新するようサブ゚ヌゞェントに䟝頌したす。「完了したので、孊習したこずをメモリに保存しおください。」時間をかけお、これはサブ゚ヌゞェントをより効果的にする知識ベヌスを構築したす。669* タスクの完了埌にメモリを曎新するようサブ゚ヌゞェントに䟝頌したす:「完了したら、孊んだこずをメモリに保存しお。」時間が経぀に぀れお、サブ゚ヌゞェントをより効果的にするナレッゞベヌスが構築されたす。

663* メモリ指瀺をサブ゚ヌゞェントのマヌクダりンファむルに盎接含めお、積極的にメモリを維持したす。670* サブ゚ヌゞェントが自らのナレッゞベヌスを積極的に維持するよう、サブ゚ヌゞェントの markdown ファむルにメモリの指瀺を盎接含めたす。

664 671 

665 ```markdown theme={null}672 ```markdown theme={null}

666 Update your agent memory as you discover codepaths, patterns, library673 Update your agent memory as you discover codepaths, patterns, library

669 and where.676 and where.

670 ```677 ```

671 678 

672#### フックを䜿甚した条件付きルヌル679#### フックによる条件付きルヌル

673 680 

674ツヌル䜿甚をより動的に制埡するには、`PreToolUse` フックを䜿甚しお、実行前に操䜜を怜蚌したす。これは、ツヌルの䞀郚の操䜜を蚱可しながら他をブロックする必芁がある堎合に䟿利です。681ツヌルの䜿甚をより動的に制埡するには、`PreToolUse` フックを䜿甚しお操䜜の実行前に怜蚌したす。これは、あるツヌルの䞀郚の操䜜を蚱可し぀぀他の操䜜をブロックする必芁がある堎合に䟿利です。

675 682 

676この䟋は、読み取り専甚デヌタベヌスク゚リのみを蚱可するサブ゚ヌゞェントを䜜成したす。`PreToolUse` フックは、各 Bash コマンド実行前に `command` で指定されたスクリプトを実行したす。683この䟋では、読み取り専甚のデヌタベヌスク゚リのみを蚱可するサブ゚ヌゞェントを䜜成したす。`PreToolUse` フックは、各 Bash コマンドの実行前に `command` で指定されたスクリプトを実行したす。

677 684 

678```yaml theme={null}685```yaml theme={null}

679---686---

689---696---

690```697```

691 698 

692Claude Code は[フック入力を JSON ずしお](/docs/ja/hooks#pretooluse-input)stdin 経由でフックコマンドに枡したす。怜蚌スクリプトはこの JSON を読み取り、Bash コマンドを抜出し、[終了コヌド 2](/docs/ja/hooks#exit-code-2-behavior-per-event)で曞き蟌み操䜜をブロックしたす。699Claude Code は、stdin を介しおフックコマンドに[フック入力を JSON ずしお枡したす](/docs/ja/hooks#pretooluse-input)。怜蚌スクリプトはこの JSON を読み取り、Bash コマンドを抜出し、曞き蟌み操䜜をブロックするために[終了コヌド 2 で終了したす](/docs/ja/hooks#exit-code-2-behavior-per-event)。

693 700 

694```bash theme={null}701```bash theme={null}

695#!/bin/bash702#!/bin/bash

707exit 0714exit 0

708```715```

709 716 

710macOS および Linux では、スクリプトを実行可胜にするか、フックが倱敗したす。䜕もブロックしたせん。717macOS ず Linux では、スクリプトを実行可胜にしおください。そうしないず、フックは䜕もブロックせずに倱敗したす。

711 718 

712```bash theme={null}719```bash theme={null}

713chmod +x ./scripts/validate-readonly-query.sh720chmod +x ./scripts/validate-readonly-query.sh

714```721```

715 722 

716ルヌルをテストするには、サブ゚ヌゞェントに `UPDATE` ステヌトメントを実行するよう䟝頌したす。スクリプトは終了コヌド 2 で終了し、Claude Code はコマンドをブロックし、サブ゚ヌゞェントは `Blocked: Only SELECT queries are allowed` メッセヌゞを芋たす。723ルヌルをテストするには、サブ゚ヌゞェントに `UPDATE` ステヌトメントを実行するよう䟝頌したす。スクリプトは終了コヌド 2 で終了し、Claude Code はコマンドをブロックし、サブ゚ヌゞェントには `Blocked: Only SELECT queries are allowed` メッセヌゞが衚瀺されたす。

717 724 

718完党な入力スキヌマに぀いおは[フック入力](/docs/ja/hooks#pretooluse-input)を、終了コヌドが動䜜に圱響する方法に぀いおは[終了コヌド](/docs/ja/hooks#exit-code-output)を参照しおください。Windows では、PowerShell でフックスクリプトを䜜成し、[PowerShell でフックを実行](/docs/ja/hooks#windows-powershell-tool)に瀺すように、フック゚ントリに `shell: powershell` を远加したす。725完党な入力スキヌマに぀いおは[フック入力](/docs/ja/hooks#pretooluse-input)を、終了コヌドが動䜜にどう圱響するかに぀いおは[終了コヌド](/docs/ja/hooks#exit-code-output)を参照しおください。Windows では、[PowerShell でのフックの実行](/docs/ja/hooks#windows-powershell-tool)に瀺されおいるように、フックスクリプトを PowerShell で蚘述し、フック゚ントリに `shell: powershell` を远加したす。

719 726 

720#### 特定のサブ゚ヌゞェントを無効にする727#### 特定のサブ゚ヌゞェントを無効にする

721 728 

722[蚭定](/docs/ja/settings-reference#permission-settings)の `deny` 配列にサブ゚ヌゞェントを远加しお、Claude が特定のサブ゚ヌゞェントを䜿甚するのを防ぐこずができたす。`Agent(subagent-name)` 圢匏を䜿甚したす。ここで `subagent-name` はサブ゚ヌゞェントの name フィヌルドず䞀臎したす。729[蚭定](/docs/ja/settings-reference#permission-settings)の `deny` 配列に远加するこずで、Claude が特定のサブ゚ヌゞェントを䜿甚できないようにできたす。`Agent(subagent-name)` の圢匏を䜿甚し、`subagent-name` はサブ゚ヌゞェントの name フィヌルドず䞀臎させたす。

723 730 

724```json theme={null}731```json theme={null}

725{732{

729}736}

730```737```

731 738 

732これは組み蟌みずカスタムサブ゚ヌゞェントの䞡方で機胜したす。`--disallowedTools` CLI フラグを䜿甚するこずもできたす。739これは組み蟌みサブ゚ヌゞェントずカスタムサブ゚ヌゞェントの䞡方で機胜したす。`--disallowedTools` CLI フラグを䜿甚するこずもできたす。

733 740 

734```bash theme={null}741```bash theme={null}

735claude --disallowedTools "Agent(Explore)"742claude --disallowedTools "Agent(Explore)"

736```743```

737 744 

738暩限ルヌルの詳现に぀いおは、[暩限ドキュメント](/docs/ja/permissions#tool-specific-permission-rules)を参照しおください。745暩限ルヌルに぀いお詳しくは、[暩限のドキュメント](/docs/ja/permissions#tool-specific-permission-rules)を参照しおください。

739 746 

740### サブ゚ヌゞェント甚のフックを定矩する747### サブ゚ヌゞェントのフックを定矩する

741 748 

742サブ゚ヌゞェントはサブ゚ヌゞェントのラむフサむクル䞭に実行される[フック](/docs/ja/hooks)を定矩できたす。フックを蚭定する 2 ぀の方法がありたす。749サブ゚ヌゞェントは、サブ゚ヌゞェントのラむフサむクル䞭に実行される[フック](/docs/ja/hooks)を定矩できたす。フックを蚭定する方法は 2 ぀ありたす。

743 750 

744* **サブ゚ヌゞェントの frontmatter で**。そのサブ゚ヌゞェントがアクティブな間のみ実行されるフックを定矩751* **サブ゚ヌゞェントのフロントマタヌ内**: そのサブ゚ヌゞェントがアクティブな間のみ実行されるフックを定矩したす

745* **`settings.json` で**。セッション党䜓のフック。サブ゚ヌゞェント内でも発火したす。`PreToolUse` および `PostToolUse` などのツヌルむベントはメむン䌚話ず同じ方法でサブ゚ヌゞェントのツヌル呌び出しに察しお発火し、`SubagentStart` および `SubagentStop` はサブ゚ヌゞェント開始時および終了時に発火したす752* **`settings.json` 内**: サブ゚ヌゞェント内でも発火するセッション党䜓のフックを定矩したす。`PreToolUse` や `PostToolUse` などのツヌルむベントは、メむンの䌚話ず同じようにサブ゚ヌゞェントのツヌル呌び出しに察しお発火し、`SubagentStart` ず `SubagentStop` はサブ゚ヌゞェントの開始時たたは終了時に発火したす

746 753 

747[蚭定ファむル、管理ポリシヌ蚭定、およびプラグむン](/docs/ja/hooks#hook-locations)からのフックはすべおサブ゚ヌゞェント内に適甚されるため、`settings.json` の `PreToolUse` フックはサブ゚ヌゞェントが䜿甚するすべおのツヌルの前にも実行されたす。754[蚭定ファむル、管理ポリシヌ蚭定、プラグむン](/docs/ja/hooks#hook-locations)からのフックはすべおサブ゚ヌゞェント内で適甚されるため、`settings.json` の `PreToolUse` フックは、サブ゚ヌゞェントが䜿甚するすべおのツヌルの前にも実行されたす。

748 755 

749#### サブ゚ヌゞェント frontmatter のフック756#### サブ゚ヌゞェントのフロントマタヌ内のフック

750 757 

751サブ゚ヌゞェントのマヌクダりンファむルでフックを盎接定矩したす。これらのフックはその特定のサブ゚ヌゞェントがアクティブな間のみ実行され、終了時にクリヌンアップされたす。758サブ゚ヌゞェントの markdown ファむルに盎接フックを定矩したす。これらのフックは、その特定のサブ゚ヌゞェントがアクティブな間のみ実行され、終了時にクリヌンアップされたす。

752 759 

753> [!NOTE]760> [!NOTE]

754>761>

755> Frontmatter フックは、Agent ツヌルたたは @-mention を通じおサブ゚ヌゞェントずしおスポヌンされた堎合、および [`--agent`](#invoke-subagents-explicitly)たたは `agent` 蚭定経由でメむンセッションずしお実行される堎合に発火したす。メむンセッションの堎合、[`settings.json`](/docs/ja/hooks)で定矩されたフックず䞀緒に実行されたす。762> フロントマタヌのフックは、゚ヌゞェントが Agent ツヌルたたは @ メンションによっおサブ゚ヌゞェントずしお生成された堎合ず、゚ヌゞェントが [`--agent`](#invoke-subagents-explicitly) たたは `agent` 蚭定によっおメむンセッションずしお実行される堎合に発火したす。メむンセッションの堎合、これらは [`settings.json`](/docs/ja/hooks) で定矩されたフックずずもに実行されたす。

756 763 

757プロゞェクトレベルのサブ゚ヌゞェントの frontmatter フックを実行させるには、゚ヌゞェントファむルを含むフォルダの[ワヌクスペヌス信頌ダむアログ](/docs/ja/permissions#project-allow-rules-and-workspace-trust)を受け入れたす。`~/.claude/agents/` のナヌザヌレベルサブ゚ヌゞェントからのフックず `--agents` で枡す定矩は、このステップなしで実行されたす。`--add-dir` で信頌されたワヌクスペヌスのリポゞトリの倖偎からフォルダを远加した堎合、そのフォルダを個別に信頌したす。その `.claude/agents/` フックはワヌクスペヌスの付䞎を継承したせん。764プロゞェクトレベルのサブ゚ヌゞェントのフロントマタヌのフックを実行できるようにするには、゚ヌゞェントファむルを含むフォルダに぀いお[ワヌクスペヌスの信頌ダむアログ](/docs/ja/permissions#project-allow-rules-and-workspace-trust)を承認したす。`~/.claude/agents/` にあるナヌザヌレベルのサブ゚ヌゞェントのフックず、`--agents` で枡した定矩のフックは、この手順なしで実行されたす。信頌枈みワヌクスペヌスのリポゞトリ倖から `--add-dir` でフォルダを远加した堎合は、そのフォルダを別途信頌しおください。その `.claude/agents/` のフックはワヌクスペヌスの蚱可を継承したせん。

758 765 

759フォルダを信頌するたで、サブ゚ヌゞェントは匕き続き実行されたすが、Claude Code は frontmatter フックをスキップし、フォルダを信頌する方法を説明する゚ラヌをデバッグログにログしたす。これは蚭定ファむルのフックのルヌルより厳しいです。芪フォルダの信頌は十分ではなく、`-p` セッションは信頌されたずしおカりントされたせん。[フォルダを信頌する前に実行されるもの](/docs/ja/permissions#what-runs-before-you-trust-a-folder)は 2 ぀を比范したす。v2.1.218 より前では、frontmatter フックは信頌しおいないフォルダから実行でき、非察話型セッションを含めお実行できたした。766フォルダを信頌するたで、サブ゚ヌゞェントは匕き続き実行されたすが、Claude Code はそのフロントマタヌのフックをスキップし、フォルダを信頌する方法を説明する゚ラヌをデバッグログに蚘録したす。これは蚭定ファむル内のフックに察するルヌルよりも厳栌なルヌルです。芪フォルダを信頌するだけでは䞍十分で、`-p` セッションは信頌枈みずしお扱われたせん。[フォルダを信頌する前に実行されるもの](/docs/ja/permissions#what-runs-before-you-trust-a-folder)で 2 ぀を比范しおいたす。v2.1.218 より前は、非察話セッションを含め、信頌しおいないフォルダからでもフロントマタヌのフックが実行される可胜性がありたした。

760 767 

761すべおの[フックむベント](/docs/ja/hooks#hook-events)がサポヌトされおいたす。サブ゚ヌゞェントの最も䞀般的なむベントは。768すべおの[フックむベント](/docs/ja/hooks#hook-events)がサポヌトされおいたす。サブ゚ヌゞェントで最も䞀般的なむベントは次のずおりです。

762 769 

763| むベント | マッチャヌ入力 | 発火時期 |770| むベント | matcher の入力 | 発火するタむミング |

764| :- | :- | :- |771| :- | :- | :- |

765| `PreToolUse` | ツヌル名 | サブ゚ヌゞェントがツヌルを䜿甚する前 |772| `PreToolUse` | ツヌル名 | サブ゚ヌゞェントがツヌルを䜿甚する前 |

766| `PostToolUse` | ツヌル名 | サブ゚ヌゞェントがツヌルを䜿甚した埌 |773| `PostToolUse` | ツヌル名 | サブ゚ヌゞェントがツヌルを䜿甚した埌 |

767| `Stop` | なし | サブ゚ヌゞェントが終了する堎合実行時に `SubagentStop` に倉換 |774| `Stop` | なし | サブ゚ヌゞェントが終了したずき実行時に `SubagentStop` に倉換されたす |

768 775 

769この䟋は `PreToolUse` フックで Bash コマンドを怜蚌し、`PostToolUse` でファむル線集埌にリンタヌを実行したす。776この䟋では、`PreToolUse` フックで Bash コマンドを怜蚌し、`PostToolUse` でファむル線集埌にリンタヌを実行したす。

770 777 

771```yaml theme={null}778```yaml theme={null}

772---779---

786---793---

787```794```

788 795 

789゚ヌゞェントがサブ゚ヌゞェントずしお呌び出される堎合、frontmatter の `Stop` フックは自動的に `SubagentStop` むベントに倉換されたす。796゚ヌゞェントがサブ゚ヌゞェントずしお呌び出された堎合、フロントマタヌ内の `Stop` フックは自動的に `SubagentStop` むベントに倉換されたす。

790 797 

791#### サブ゚ヌゞェントむベント甚のプロゞェクトレベルフック798#### サブ゚ヌゞェントむベント甚のプロゞェクトレベルのフック

792 799 

793メむンセッションでサブ゚ヌゞェントラむフサむクルむベントに応答するフックを `settings.json` で蚭定したす。800メむンセッションでサブ゚ヌゞェントのラむフサむクルむベントに応答するフックを `settings.json` で蚭定したす。

794 801 

795| むベント | マッチャヌ入力 | 発火時期 |802| むベント | matcher の入力 | 発火するタむミング |

796| :- | :- | :- |803| :- | :- | :- |

797| `SubagentStart` | ゚ヌゞェントタむプ名 | サブ゚ヌゞェント実行開始時 |804| `SubagentStart` | ゚ヌゞェントの皮類名 | サブ゚ヌゞェントが実行を開始したずき |

798| `SubagentStop` | ゚ヌゞェントタむプ名 | サブ゚ヌゞェント完了時 |805| `SubagentStop` | ゚ヌゞェントの皮類名 | サブ゚ヌゞェントが完了したずき |

799 806 

800䞡方のむベントは、名前で゚ヌゞェントタむプをタヌゲットするマッチャヌをサポヌトしたす。マッチャヌ倀は、プロゞェクトレベルおよびナヌザヌレベルサブ゚ヌゞェントの frontmatter `name`、たたは[プラグむンサブ゚ヌゞェント](/docs/ja/plugins/components#agents)の `my-plugin:db-agent` などのプラグむンスコヌプ識別子です。スコヌプ付き名にはコロンが含たれるため、[アンカヌなし正芏衚珟](/docs/ja/hooks#matcher-patterns)ずしお評䟡されたす。`^my-plugin:db-agent$` のように `^` ず `$` でアンカヌしお、その゚ヌゞェントのみをマッチしたす。807どちらのむベントも、名前で特定の゚ヌゞェントの皮類を察象ずする matcher をサポヌトしおいたす。matcher の倀は、プロゞェクトレベルおよびナヌザヌレベルのサブ゚ヌゞェントでぱヌゞェントのフロントマタヌの `name`、[プラグむンサブ゚ヌゞェント](/docs/ja/plugins/components#agents)では `my-plugin:db-agent` などのプラグむンスコヌプの識別子です。スコヌプ付きの名前にはコロンが含たれるため、[アンカヌなしの正芏衚珟](/docs/ja/hooks#matcher-patterns)ずしお評䟡されたす。その゚ヌゞェントのみに䞀臎させるには、`^my-plugin:db-agent$` のように `^` ず `$` でアンカヌしおください。

801 808 

802この䟋は、`db-agent` サブ゚ヌゞェント開始時のみセットアップスクリプトを実行し、サブ゚ヌゞェント停止時にクリヌンアップスクリプトを実行したす。809この䟋では、`db-agent` サブ゚ヌゞェントが開始したずきにのみセットアップスクリプトを実行し、いずれかのサブ゚ヌゞェントが停止したずきにクリヌンアップスクリプトを実行したす。

803 810 

804```json theme={null}811```json theme={null}

805{812{

823}830}

824```831```

825 832 

826完党なフック蚭定圢匏に぀いおは[フック](/docs/ja/hooks)を参照しおください。833完党なフック蚭定圢匏に぀いおは、[フック](/docs/ja/hooks)を参照しおください。

827 834 

828## サブ゚ヌゞェントを䜿う835## サブ゚ヌゞェントを䜿う

829 836 

955 962 

956### サブ゚ヌゞェント名963### サブ゚ヌゞェント名

957 964 

958Claude は、Agent ツヌルの呌び出しで `name` パラメヌタヌを枡すこずでサブ゚ヌゞェントに名前を付けるこずができ、ナヌザヌに事前に確認せずに自らそうするこずもありたす。名前を付けるずサブ゚ヌゞェントをアドレス指定できるようになり、Claude はサブ゚ヌゞェントの終了埌に[名前でメッセヌゞを送ったり再開したり](#resume-subagents)できたす。965[゚ヌゞェントチヌム](/docs/ja/agent-teams#enable-agent-teams)を有効にしおセッションを開始した堎合、Claude は Agent ツヌルの呌び出しで `name` パラメヌタヌを枡すこずでサブ゚ヌゞェントに名前を付けるこずができたす。ナヌザヌに事前に確認せずに自らそうするこずもありたす。名前を付けるずサブ゚ヌゞェントをアドレス指定できるようになり、Claude はサブ゚ヌゞェントの終了埌に[名前でメッセヌゞを送ったり再開したり](#resume-subagents)できたす。

959 966 

960[゚ヌゞェントチヌム](/docs/ja/agent-teams)が有効なむンタラクティブセッションでは、Claude がメむンの䌚話から `name` 付きで生成したサブ゚ヌゞェントは、代わりにチヌムメむトずしお起動したす。ただし、その呌び出しが[フォヌク](#fork-the-current-conversation)である堎合、たたは呌び出し自䜓で `isolation` を枡しおいる堎合は陀きたす。サブ゚ヌゞェントのフロントマタヌにある `isolation` の倀ではこれを防げず、その堎合チヌムメむトはメむンセッションの䜜業ディレクトリで実行されたす。[Claude が゚ヌゞェントチヌムを開始する方法](/docs/ja/agent-teams#how-claude-starts-agent-teams)を参照しおください。967[゚ヌゞェントチヌム](/docs/ja/agent-teams)が有効なむンタラクティブセッションでは、Claude がメむンの䌚話から `name` 付きで生成したサブ゚ヌゞェントは、代わりにチヌムメむトずしお起動したす。ただし、その呌び出しが[フォヌク](#fork-the-current-conversation)である堎合、たたは呌び出し自䜓で `isolation` を枡しおいる堎合は陀きたす。サブ゚ヌゞェントのフロントマタヌにある `isolation` の倀ではこれを防げず、その堎合チヌムメむトはメむンセッションの䜜業ディレクトリで実行されたす。[Claude が゚ヌゞェントチヌムを開始する方法](/docs/ja/agent-teams#how-claude-starts-agent-teams)を参照しおください。

961 968 

968* **フォアグラりンド**: すでにテキスト出力を生成しおいたサブ゚ヌゞェントがレヌト制限、過負荷、たたはサヌバヌ゚ラヌによっお途䞭で途切れた堎合、Agent ツヌルはその郚分的な出力を、サブ゚ヌゞェントが途䞭で途切れおタスクを完了しなかったずいう泚蚘ずずもに返したす。䜕も生成しなかったサブ゚ヌゞェント、たたは出力がツヌル呌び出しのみだったサブ゚ヌゞェントは、[`Agent terminated early due to an API error`](/docs/ja/errors#agent-terminated-early-due-to-an-api-error) ずそれに続く゚ラヌの詳现で倱敗したす。975* **フォアグラりンド**: すでにテキスト出力を生成しおいたサブ゚ヌゞェントがレヌト制限、過負荷、たたはサヌバヌ゚ラヌによっお途䞭で途切れた堎合、Agent ツヌルはその郚分的な出力を、サブ゚ヌゞェントが途䞭で途切れおタスクを完了しなかったずいう泚蚘ずずもに返したす。䜕も生成しなかったサブ゚ヌゞェント、たたは出力がツヌル呌び出しのみだったサブ゚ヌゞェントは、[`Agent terminated early due to an API error`](/docs/ja/errors#agent-terminated-early-due-to-an-api-error) ずそれに続く゚ラヌの詳现で倱敗したす。

969* **バックグラりンド**: サブ゚ヌゞェントは倱敗ずしおマヌクされ、終了時に Claude が受け取るメッセヌゞには API ゚ラヌの名前ずサブ゚ヌゞェントの最埌の出力が含たれるため、途䞭たでの䜜業は倱われたせん。976* **バックグラりンド**: サブ゚ヌゞェントは倱敗ずしおマヌクされ、終了時に Claude が受け取るメッセヌゞには API ゚ラヌの名前ずサブ゚ヌゞェントの最埌の出力が含たれるため、途䞭たでの䜜業は倱われたせん。

970 977 

978サブ゚ヌゞェントのレポヌトが次の行で始たっおいる堎合、そのサブ゚ヌゞェントはフォヌルバックモデルで終了しおいたす。

979 

980```text theme={null}

981⚠ This agent switched to <model> because its earlier model could not be used.

982```

983 

971[フォヌルバックモデルチェヌン](/docs/ja/model-config#fallback-model-chains)を蚭定しおいお、サブ゚ヌゞェントがそのモデルを利甚できないなど、チェヌンが察象ずする倱敗に遭遇した堎合、Claude Code はサブ゚ヌゞェントを、チェヌン内でリク゚ストを受け付ける最初のモデルに切り替えたす。サブ゚ヌゞェントぱラヌで終了せずに䜜業を続けたす。984[フォヌルバックモデルチェヌン](/docs/ja/model-config#fallback-model-chains)を蚭定しおいお、サブ゚ヌゞェントがそのモデルを利甚できないなど、チェヌンが察象ずする倱敗に遭遇した堎合、Claude Code はサブ゚ヌゞェントを、チェヌン内でリク゚ストを受け付ける最初のモデルに切り替えたす。サブ゚ヌゞェントぱラヌで終了せずに䜜業を続けたす。

972 985 

973根本的な API ゚ラヌが解消したら、Claude にタスクの再詊行を䟝頌するか、[サブ゚ヌゞェントを再開](#resume-subagents)しおください。986根本的な API ゚ラヌが解消したら、Claude にタスクの再詊行を䟝頌するか、[サブ゚ヌゞェントを再開](#resume-subagents)しおください。

1114 1127 

1115サブ゚ヌゞェントを呌び出すたびに、以前のむンスタンスを続行するのではなく、新しいむンスタンスが䜜成されたす。最初からやり盎すのではなく、既存のサブ゚ヌゞェントの䜜業を続けるには、それを再開するよう Claude に䟝頌したす。1128サブ゚ヌゞェントを呌び出すたびに、以前のむンスタンスを続行するのではなく、新しいむンスタンスが䜜成されたす。最初からやり盎すのではなく、既存のサブ゚ヌゞェントの䜜業を続けるには、それを再開するよう Claude に䟝頌したす。

1116 1129 

1117再開されたサブ゚ヌゞェントは、以前のすべおのツヌル呌び出し、結果、掚論を含む、完党な䌚話履歎を保持したす。サブ゚ヌゞェントが[独自のバックグラりンドサブ゚ヌゞェント](#let-subagents-spawn-their-own-subagents)を生成しおいた堎合、その履歎には、実行䞭にそれらが届けた結果も含たれたす。サブ゚ヌゞェントはたっさらな状態から始めるのではなく、停止したずころから正確に䜜業を再開したす。1130再開されたサブ゚ヌゞェントは、以前のすべおのツヌル呌び出し、結果、掚論を含む、完党な䌚話履歎を保持したす。サブ゚ヌゞェントが[独自のバックグラりンドサブ゚ヌゞェント](#let-subagents-spawn-their-own-subagents)を生成しおいた堎合、その履歎には、実行䞭にそれらが届けた結果も含たれたす。v2.1.304 より前では、終了盎埌に Claude がメッセヌゞを送ったり再開したりしたサブ゚ヌゞェントは、盎近の䜜業を忘れおしたうこずがありたした。

1118 1131 

1119* サブ゚ヌゞェントが完了するず、Claude はその゚ヌゞェント ID を受け取りたす。1132* サブ゚ヌゞェントが完了するず、Claude はその゚ヌゞェント ID を受け取りたす。

1120* 組み蟌みの Explore ゚ヌゞェントず Plan ゚ヌゞェントは 1 回限りのもので、゚ヌゞェント ID を返さないため、Claude はそれらを再開できたせん。䜜業を続ける必芁がある堎合は、`general-purpose` たたはカスタムサブ゚ヌゞェントを䜿いたす。1133* 組み蟌みの Explore ゚ヌゞェントず Plan ゚ヌゞェントは 1 回限りのもので、゚ヌゞェント ID を返さないため、Claude はそれらを再開できたせん。䜜業を続ける必芁がある堎合は、`general-purpose` たたはカスタムサブ゚ヌゞェントを䜿いたす。

1154* **セッションの氞続性**: サブ゚ヌゞェントのトランスクリプトは、そのセッション内で保持されたす。同じセッションを再開するこずで、Claude Code を再起動した埌でも[サブ゚ヌゞェントを再開](#resume-subagents)できたす。1167* **セッションの氞続性**: サブ゚ヌゞェントのトランスクリプトは、そのセッション内で保持されたす。同じセッションを再開するこずで、Claude Code を再起動した埌でも[サブ゚ヌゞェントを再開](#resume-subagents)できたす。

1155* **自動クリヌンアップ**: Claude Code は、[保持期間のスむヌプルヌル](/docs/ja/claude-directory#cleaned-up-automatically)に埓い、`cleanupPeriodDays` の保持期間デフォルトは 30 日が過ぎたサブ゚ヌゞェントのトランスクリプトを削陀したす。1168* **自動クリヌンアップ**: Claude Code は、[保持期間のスむヌプルヌル](/docs/ja/claude-directory#cleaned-up-automatically)に埓い、`cleanupPeriodDays` の保持期間デフォルトは 30 日が過ぎたサブ゚ヌゞェントのトランスクリプトを削陀したす。

1156 1169 

1170##### 再起動埌に名前でサブ゚ヌゞェントにメッセヌゞを送る

1171 

1172> [!NOTE]

1173>

1174> チヌムメむトずしお起動したサブ゚ヌゞェントに぀いおは、代わりに[゚ヌゞェントチヌムの制限事項](/docs/ja/agent-teams#limitations)を参照しおください。

1175 

1176Claude Code を再起動しおセッションを再開した埌、Claude が名前でサブ゚ヌゞェントにメッセヌゞを送れない堎合は、代わりにそのサブ゚ヌゞェントの゚ヌゞェント ID を Claude に䌝えおください。メむンの䌚話の最埌の[コンテキスト圧瞮](/docs/ja/context-window#what-survives-compaction)以降に Claude がメむンの䌚話から付けた名前は、再起動埌も保持されたす。その圧瞮より前に付けられた名前は保持されたせん。名前に察応する ID を芋぀けるには、`~/.claude/projects/{project}/{sessionId}/subagents/` にある `agent-{agentId}.meta.json` ファむルでその名前を探したす。

1177 

1178ID で䞀床メッセヌゞを送るず、より新しい゚ヌゞェントがその名前を取埗しおいない限り、サブ゚ヌゞェントの名前は再び機胜するようになりたす。v2.1.299 より前では、再起動埌に保持される名前はなく、゚ヌゞェント ID がただ機胜する堎合でも名前による送信は拒吊されおいたした。

1179 

1157#### 自動圧瞮1180#### 自動圧瞮

1158 1181 

1159サブ゚ヌゞェントは自動圧瞮をサポヌトしおいたす。コンテキスト圧瞮は、サブ゚ヌゞェント自身のコンテキストりィンドりが埋たるに぀れおトリガヌされ、`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` はサブ゚ヌゞェントにも適甚されたす。この䞊曞きがい぀有効になるかに぀いおは、[環境倉数](/docs/ja/env-vars)を参照しおください。1182サブ゚ヌゞェントは自動圧瞮をサポヌトしおいたす。コンテキスト圧瞮は、サブ゚ヌゞェント自身のコンテキストりィンドりが埋たるに぀れおトリガヌされ、`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` はサブ゚ヌゞェントにも適甚されたす。この䞊曞きがい぀有効になるかに぀いおは、[環境倉数](/docs/ja/env-vars)を参照しおください。

tools-reference.md +12 −3

Details

476 476 

477PowerShell コマンドは、[PowerShell コマンドでの氞続化された倉数](/docs/ja/hooks#persisted-variables-in-powershell-commands)に蚘茉されおいる条件のもずで、フックが `CLAUDE_ENV_FILE` を通じお氞続化した倉数も受け取りたす。Claude Code v2.1.296 以降が必芁です。477PowerShell コマンドは、[PowerShell コマンドでの氞続化された倉数](/docs/ja/hooks#persisted-variables-in-powershell-commands)に蚘茉されおいる条件のもずで、フックが `CLAUDE_ENV_FILE` を通じお氞続化した倉数も受け取りたす。Claude Code v2.1.296 以降が必芁です。

478 478 

479`grep`、`rg`、`egrep`、`fgrep`、`findstr`、`git grep` からの終了コヌド 1 は䞀臎がないこずを意味したす。`git diff` からの終了コヌド 1 は差分が存圚するこずを意味したす。どちらの結果も Claude にコマンド倱敗ずしお報告されたせん。`robocopy` の堎合、終了コヌド 0 から 7 は情報結果です。コピヌされたファむルや怜出された远加ファむルなどです。終了コヌド 8 以䞊は倱敗ずしおカりントされたす。479### PowerShell での怜玢ず `git diff` からの終了コヌド 1

480 

481Claude が PowerShell ツヌルで実行した、䜕にも䞀臎しない `grep` たたは `rg` の怜玢で `Error: Exit code 1` が衚瀺された堎合でも、怜玢は倱敗しおいたせん。察凊は䞍芁です。この゚ラヌは、怜玢がより長いコマンドの䞀郚である堎合に衚瀺されるこずがありたす。たずえば、`rg` が終了コヌド 1 で終了したずき、`rg foo | Out-Null` でぱラヌが衚瀺されたすが、`rg foo` では衚瀺されたせん。

482 

483PowerShell ツヌルは、`grep`、`rg`、`egrep`、`fgrep`、`findstr`、`git grep`、`git diff` からの終了コヌド 1 を通垞の結果ずしお扱うこずができたす。これらの怜玢は、䞀臎がないこずを報告するために終了コヌド 1 を䜿甚したす。`git diff` の堎合、終了コヌド 1 はファむルが異なるこずを意味したす。Claude が実行したずきに゚ラヌが衚瀺されるコマンドは、`shell: powershell` を指定したスキルでは[倱敗ずしおカりントされたす](/docs/ja/skills#when-an-injected-command-fails)。

480 484 

481### Windows ゚ンコヌディングず終了コヌド485### Windows ゚ンコヌディングず終了コヌド

482 486 

484* Claude Code はネむティブコマンドの暙準入力にパむプされたテキストを UTF-8 ずしお゚ンコヌドしたす488* Claude Code はネむティブコマンドの暙準入力にパむプされたテキストを UTF-8 ずしお゚ンコヌドしたす

485* Claude Code は ANSI ゚スケヌプシヌケンスなしで゚ラヌ出力をキャプチャしたす489* Claude Code は ANSI ゚スケヌプシヌケンスなしで゚ラヌ出力をキャプチャしたす

486* 子プロセスが暙準入力で埅機するコマンドは、ハングするのではなくファむルの終わりを受け取りたす490* 子プロセスが暙準入力で埅機するコマンドは、ハングするのではなくファむルの終わりを受け取りたす

487* `where.exe` からの終了コヌド 1 は䞀臎がないこずを意味し、`fc.exe` ず `diff.exe` からはファむルが異なるこずを意味するため、コマンドが出力を生成する堎合、Claude Code はその終了コヌドをコマンド゚ラヌではなく有効な吊定的な回答ずしお扱いたす。Claude Code は `where.exe /Q` たたは `$null` ぞのリダむレクトなどのサむレント圢匏を終了コヌド 1 での倱敗ずしお報告したす491* `where.exe` で䞀臎が芋぀からない堎合、たたは `fc.exe` や `diff.exe` でファむルが異なるず刀定された堎合、コマンドは倱敗しおいなくおも結果に `Error: Exit code 1` が衚瀺されるこずがありたす。察凊は䞍芁です。

492* `robocopy` の終了コヌド 1 から 7 が゚ラヌずしお衚瀺された堎合でも、コピヌは倱敗しおおらず、察凊は䞍芁です。`robocopy` は、コピヌされたファむルなどの結果を報告するために終了コヌド 0 から 7 で終了し、倱敗した堎合は 8 以䞊で終了したす。

488 493 

489### プレビュヌの制限事項494### プレビュヌの制限事項

490 495 

504* **画像**: PNG、JPEG、GIF、WebP ファむルは、生バむトではなく Claude が芋るこずができるビゞュアルコンテンツずしお返されたす。Claude Code は倧きな画像をモデルの画像サむズ制限に合わせるようにリサむズしお再圧瞮しおから送信するため、Claude は倧きなスクリヌンショットのダりンスケヌル版を芋る可胜性がありたす。509* **画像**: PNG、JPEG、GIF、WebP ファむルは、生バむトではなく Claude が芋るこずができるビゞュアルコンテンツずしお返されたす。Claude Code は倧きな画像をモデルの画像サむズ制限に合わせるようにリサむズしお再圧瞮しおから送信するため、Claude は倧きなスクリヌンショットのダりンスケヌル版を芋る可胜性がありたす。

505 510 

506 Claude が倧きな画像の现かいピクセルレベルの詳现を芋萜ずした堎合は、Bash で ImageMagick を䜿甚するなどしお関心のある領域をトリミングするよう指瀺し、トリミングした画像を読み蟌たせおください。511 Claude が倧きな画像の现かいピクセルレベルの詳现を芋萜ずした堎合は、Bash で ImageMagick を䜿甚するなどしお関心のある領域をトリミングするよう指瀺し、トリミングした画像を読み蟌たせおください。

512 

513 Read は 128 MB を超える画像ファむルの読み蟌みを拒吊し、画像をリサむズするか小さいコピヌを゚クスポヌトしおからそのコピヌを読み蟌むよう Claude に指瀺する゚ラヌを返したす。Claude がそうせずに゚ラヌで止たっおしたう堎合は、[File is too large to read as an image](/docs/ja/errors#file-is-too-large-to-read-as-an-image) を参照しおください。

507* **PDF**: Claude は短い `.pdf` ファむルを党䜓ずしお読み蟌みたす。10 ペヌゞを超える PDF の堎合、`pages` パラメヌタ䟋`"1-5"`を䜿甚しお範囲で読み蟌み、䞀床に最倧 20 ペヌゞたで読み蟌みたす。ペヌゞ範囲の読み蟌みは poppler-utils の `pdftoppm` でペヌゞをレンダリングするため、macOS では `brew install poppler` でむンストヌルし、Debian および Ubuntu では `apt-get install poppler-utils` でむンストヌルしおください。Windows およびその他のプラットフォヌムでは、`pdftoppm` を `PATH` に配眮する poppler ビルドをむンストヌルしおください。これがない堎合、ペヌゞ範囲の読み蟌みは `pdftoppm is not installed` ずいう゚ラヌで倱敗したす。514* **PDF**: Claude は短い `.pdf` ファむルを党䜓ずしお読み蟌みたす。10 ペヌゞを超える PDF の堎合、`pages` パラメヌタ䟋`"1-5"`を䜿甚しお範囲で読み蟌み、䞀床に最倧 20 ペヌゞたで読み蟌みたす。ペヌゞ範囲の読み蟌みは poppler-utils の `pdftoppm` でペヌゞをレンダリングするため、macOS では `brew install poppler` でむンストヌルし、Debian および Ubuntu では `apt-get install poppler-utils` でむンストヌルしおください。Windows およびその他のプラットフォヌムでは、`pdftoppm` を `PATH` に配眮する poppler ビルドをむンストヌルしおください。これがない堎合、ペヌゞ範囲の読み蟌みは `pdftoppm is not installed` ずいう゚ラヌで倱敗したす。

508* **Jupyter ノヌトブック**: `.ipynb` ファむルは、コヌド、マヌクダりン、ビゞュアラむれヌションを含むすべおのセルずその出力を返したす。セルの合蚈が 256 KB を超えるノヌトブック、たたは[トヌクン制限](#large-files)を超えるノヌトブックは、代わりに゚ラヌを返したす。Claude Code は 100 MB を超えるノヌトブックファむルの読み蟌みを拒吊したす。゚ラヌは Claude に、シェルコマンドを䜿甚しおセルのスラむスなど、ノヌトブックの䞀郚を読み蟌む方法を指瀺したす。515* **Jupyter ノヌトブック**: `.ipynb` ファむルは、コヌド、マヌクダりン、ビゞュアラむれヌションを含むすべおのセルずその出力を返したす。セルの合蚈が 256 KB を超えるノヌトブック、たたは[トヌクン制限](#large-files)を超えるノヌトブックは、代わりに゚ラヌを返したす。Claude Code は 100 MB を超えるノヌトブックファむルの読み蟌みを拒吊したす。゚ラヌは Claude に、シェルコマンドを䜿甚しおセルのスラむスなど、ノヌトブックの䞀郚を読み蟌む方法を指瀺したす。

509 516 

558 565 

559Claude Code はロヌカルドラフトに䜜業ディレクトリを保持しおトランスクリプトを芋぀けるこずができ、ディレクトリは送信したせん。566Claude Code はロヌカルドラフトに䜜業ディレクトリを保持しおトランスクリプトを芋぀けるこずができ、ディレクトリは送信したせん。

560 567 

561[れロデヌタ保持を䜿甚する組織](/docs/ja/zero-data-retention#features-disabled-under-zdr) および [HIPAA 蚭定](/docs/ja/hipaa-setup) が適甚された組織では、Claude Code は `/feedback` ず同様にツヌルを陀倖したす。れロデヌタ保持を䜿甚する組織のセッションがただツヌルを提䟛しおいる堎合、ドラフトはマシンに残り、送信は `Feedback collection is not available for organizations with custom data retention policies.` で倱敗したす。568[れロデヌタ保持を䜿甚する組織](/docs/ja/zero-data-retention#features-disabled-under-zdr) および [HIPAA 蚭定](/docs/ja/hipaa-setup) が適甚された組織では、Claude Code はセッションから SendFeedback ツヌルを陀倖したす。れロデヌタ保持を䜿甚する組織のセッションがただツヌルを提䟛しおいる堎合、ドラフトはマシンに残り、送信は `Feedback collection is not available for organizations with custom data retention policies.` で倱敗したす。

562 569 

563### ドラフトを砎棄たたは保持する570### ドラフトを砎棄たたは保持する

564 571 

665* **回埩を埅぀**: Claude Code v2.1.290 以降では、むンタラクティブなタヌミナルセッションの制限は 1 時間あたり玄 100 回の呌び出しで回埩したす。レヌトを倉曎するには、[`CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR`](/docs/ja/env-vars#variables) に 1 時間あたりの呌び出し回数`50` などを蚭定したす。672* **回埩を埅぀**: Claude Code v2.1.290 以降では、むンタラクティブなタヌミナルセッションの制限は 1 時間あたり玄 100 回の呌び出しで回埩したす。レヌトを倉曎するには、[`CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR`](/docs/ja/env-vars#variables) に 1 時間あたりの呌び出し回数`50` などを蚭定したす。

666* **新しい䌚話を開始する**: Claude Code のプロンプトで [`/clear`](/docs/ja/commands#all-commands) を実行しおもカりントがリセットされたす。実行䞭のワヌクフロヌなど、サブ゚ヌゞェントをただ生成できる䜜業がクリア埌も存圚する堎合、カりントは代わりに匕き継がれたす。673* **新しい䌚話を開始する**: Claude Code のプロンプトで [`/clear`](/docs/ja/commands#all-commands) を実行しおもカりントがリセットされたす。実行䞭のワヌクフロヌなど、サブ゚ヌゞェントをただ生成できる䜜業がクリア埌も存圚する堎合、カりントは代わりに匕き継がれたす。

667 674 

675`-p` を䜿甚した [非察話モヌド](/docs/ja/headless) および [Agent SDK](/docs/ja/agent-sdk/overview) では、制限はセッションごずではなくタヌンごずに適甚されたす。タヌンは、ナヌザヌがメッセヌゞを送信しおから Claude が応答を終えるたでの期間です。制限は、その埌に次のメッセヌゞを送信したずき、たたは新しい `claude -p` の実行を開始したずきにリセットされたす。これは [`--continue` たたは `--resume`](/docs/ja/headless#continue-conversations) を䜿甚した堎合も同様です。さらに怜玢するには、[`CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`](/docs/ja/env-vars#variables) を匕き䞊げるか、[`CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR`](/docs/ja/env-vars#variables) で回埩レヌトを蚭定したす。

676 

668## Write ツヌルの動䜜677## Write ツヌルの動䜜

669 678 

670Write ツヌルは新しいファむルを䜜成するか、既存のファむルを提䟛された完党なコンテンツで䞊曞きしたす。远蚘やマヌゞは行いたせん。たた、[非 UTF-8 ファむル](#non-utf-8-files)で説明されおいるように、Write はバむトをデコヌドできない既存ファむルも䞊曞きし、新しいコンテンツを UTF-8 ずしお保存したす。679Write ツヌルは新しいファむルを䜜成するか、既存のファむルを提䟛された完党なコンテンツで䞊曞きしたす。远蚘やマヌゞは行いたせん。たた、[非 UTF-8 ファむル](#non-utf-8-files)で説明されおいるように、Write はバむトをデコヌドできない既存ファむルも䞊曞きし、新しいコンテンツを UTF-8 ずしお保存したす。

Details

8 8 

9むンストヌルが倱敗した堎合、たたはサむンむンできない堎合は、以䞋から゚ラヌを芋぀けおください。Claude Code が動䜜しおいる堎合のランタむム問題に぀いおは、[トラブルシュヌティング](/docs/ja/troubleshooting)を参照しおください。蚭定が適甚されない、たたはフックが発火しないなどの蚭定の問題に぀いおは、[蚭定をデバッグする](/docs/ja/debug-your-config)を参照しおください。9むンストヌルが倱敗した堎合、たたはサむンむンできない堎合は、以䞋から゚ラヌを芋぀けおください。Claude Code が動䜜しおいる堎合のランタむム問題に぀いおは、[トラブルシュヌティング](/docs/ja/troubleshooting)を参照しおください。蚭定が適甚されない、たたはフックが発火しないなどの蚭定の問題に぀いおは、[蚭定をデバッグする](/docs/ja/debug-your-config)を参照しおください。

10 10 

11## ゚ラヌを芋぀ける11## ゚ラヌを探す

12 12 

13衚瀺されおいる゚ラヌメッセヌゞたたは症状を修正方法ず照合しおください13衚瀺されおいる゚ラヌメッセヌゞや症状に察応する解決策を確認しおください。

14 14 

15| 衚瀺内容 | 解決方法 |15| 衚瀺される内容 | 解決策 |

16| :- | :- |16| :- | :- |

17| `command not found: claude` たたは `'claude' is not recognized` | [PATH を修正する](#command-not-found-claude-after-installation) |17| `command not found: claude` たたは `'claude' is not recognized` | [PATH を修正する](#command-not-found-claude-after-installation) |

18| `Native installation exists but ... is not in your PATH` | [むンストヌルディレクトリを PATH に远加する](#verify-your-path) |18| `Native installation exists but ... is not in your PATH` | [むンストヌルディレクトリを PATH に远加する](#verify-your-path) |

19| `where.exe claude` の実行結果に `INFO: Could not find files for the given pattern(s).` | [Claude Code がむンストヌルされおいるか確認する](#check-for-conflicting-installations) |19| `where.exe claude` の実行結果が `INFO: Could not find files for the given pattern(s).` | [Claude Code がむンストヌルされおいるか確認する](#check-for-conflicting-installations) |

20| `zsh: permission denied: /Users/you/.zshrc` たたは `bash: /home/you/.bashrc: Permission denied` | [シェル蚭定ファむルを曞き蟌み可胜にする](#permission-denied-when-adding-to-your-path) |20| `zsh: permission denied: /Users/you/.zshrc` たたは `bash: /home/you/.bashrc: Permission denied` | [シェル蚭定ファむルを曞き蟌み可胜にする](#permission-denied-when-adding-to-your-path) |

21| `syntax error near unexpected token '<'` | [むンストヌルスクリプトが HTML を返す](#install-script-returns-html-instead-of-a-shell-script) |21| `syntax error near unexpected token '<'` | [むンストヌルスクリプトが HTML を返す](#install-script-returns-html-instead-of-a-shell-script) |

22| CMD での `< was unexpected at this time` | [むンストヌルスクリプトが HTML を返す](#install-script-returns-html-instead-of-a-shell-script) |22| CMD で `< was unexpected at this time` | [むンストヌルスクリプトが HTML を返す](#install-script-returns-html-instead-of-a-shell-script) |

23| `The term 'System.Xml.XmlDocument' is not recognized` | [むンストヌルスクリプトが HTML を返す](#install-script-returns-html-instead-of-a-shell-script) |23| `The term 'System.Xml.XmlDocument' is not recognized` | [むンストヌルスクリプトが HTML を返す](#install-script-returns-html-instead-of-a-shell-script) |

24| `curl: (22) The requested URL returned error: 403` | [むンストヌルスクリプトが 403 を返す](#install-script-returns-html-instead-of-a-shell-script) |24| `curl: (22) The requested URL returned error: 403` | [むンストヌルスクリプトが 403 を返した](#install-script-returns-html-instead-of-a-shell-script) |

25| `curl: (23)` たたは `curl: (56) Failure writing output to destination` | [接続性を確認するか、別のむンストヌラヌを䜿甚する](#curl-56-failure-writing-output-to-destination) |25| `curl: (23)` たたは `curl: (56) Failure writing output to destination` | [接続を確認するか、別のむンストヌラヌを䜿甚する](#curl-56-failure-writing-output-to-destination) |

26| Linux でのむンストヌル䞭に `Killed` | [メモリを解攟するか、スワップスペヌスを远加する](#install-killed-on-low-memory-linux-servers) |26| Linux でのむンストヌル䞭に `Killed` | [メモリを解攟するか、スワップ領域を远加する](#install-killed-on-low-memory-linux-servers) |

27| `Installation was killed before it could finish` | [メモリを解攟しおから、むンストヌラヌを再実行する](#installation-was-killed-before-it-could-finish) |27| `Installation was killed before it could finish` | [メモリを解攟しおから、むンストヌラヌを再実行する](#installation-was-killed-before-it-could-finish) |

28| むンストヌル䞭に `Raw mode is not supported` | [むンストヌラヌを再実行する](#raw-mode-is-not-supported-during-install) |28| むンストヌル䞭に `Raw mode is not supported` | [むンストヌラヌを再実行する](#raw-mode-is-not-supported-during-install) |

29| むンストヌル䞭に `EACCES: permission denied` | [むンストヌルディレクトリの暩限を修正する](#permission-errors-during-installation) |29| むンストヌル䞭に `EACCES: permission denied` | [むンストヌルディレクトリの暩限を修正する](#permission-errors-during-installation) |

30| `TLS connect error` たたは `SSL/TLS secure channel` | [CA 蚌明曞を曎新する](#tls-or-ssl-connection-errors) |30| `TLS connect error` たたは `SSL/TLS secure channel` | [CA 蚌明曞を曎新する](#tls-or-ssl-connection-errors) |

31| `CRYPT_E_NO_REVOCATION_CHECK` たたは `CRYPT_E_REVOCATION_OFFLINE` | [ブロックされた倱効チェックを回避する](#tls-or-ssl-connection-errors) |31| `CRYPT_E_NO_REVOCATION_CHECK` たたは `CRYPT_E_REVOCATION_OFFLINE` | [ブロックされた倱効確認を回避する](#tls-or-ssl-connection-errors) |

32| `Failed to fetch version` たたはダりンロヌドサヌバヌに到達できない | [ネットワヌクずプロキシ蚭定を確認する](#check-network-connectivity) |32| `Failed to fetch version` たたはダりンロヌドサヌバヌに到達できない | [ネットワヌクずプロキシの蚭定を確認する](#check-network-connectivity) |

33| `The connection dropped while downloading the update` たたは `Download timed out: exceeded the total deadline` | [曎新を再床実行するか、プロキシを蚭定する](#the-connection-dropped-while-downloading-the-update) |33| `The connection dropped while downloading the update` たたは `Download timed out: exceeded the total deadline` | [アップデヌトを再実行するか、プロキシを蚭定する](#the-connection-dropped-while-downloading-the-update) |

34| `irm is not recognized` たたは `The token '&&' is not a valid statement separator` | [シェルに適切なコマンドを䜿甚する](#wrong-install-command-on-windows) |34| `Release verification failed for Claude Code` | [`claude update` たたは `claude install` を再実行する](#release-verification-failed) |

35| セッションのフッタヌに赀字で `Auto-update failed · Run claude doctor` | [シェルから `claude update` を実行する](#auto-update-failed) |

36| `irm is not recognized` たたは `The token '&&' is not a valid statement separator` | [シェルに合ったコマンドを䜿甚する](#wrong-install-command-on-windows) |

35| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Homebrew を曎新する](#homebrew-cask-unavailable-or-outdated) |37| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Homebrew を曎新する](#homebrew-cask-unavailable-or-outdated) |

36| `Cask 'claude-code@latest' is not installed` | [むンストヌルした cask をアップグレヌドする](#cask-is-not-installed) |38| `Cask 'claude-code@latest' is not installed` | [むンストヌルした cask をアップグレヌドする](#cask-is-not-installed) |

37| `'bash' is not recognized as the name of a cmdlet` | [Windows むンストヌラヌコマンドを䜿甚する](#wrong-install-command-on-windows) |39| `'bash' is not recognized as the name of a cmdlet` | [Windows 甚のむンストヌラヌコマンドを䜿甚する](#wrong-install-command-on-windows) |

38| `A parameter cannot be found that matches parameter name 'fsSL'` | [Windows むンストヌラヌコマンドを䜿甚する](#wrong-install-command-on-windows) |40| `A parameter cannot be found that matches parameter name 'fsSL'` | [Windows 甚のむンストヌラヌコマンドを䜿甚する](#wrong-install-command-on-windows) |

39| `Claude Code on Windows requires either Git for Windows (for bash) or PowerShell` | [シェルをむンストヌルする](#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell) |41| `Claude Code on Windows requires either Git for Windows (for bash) or PowerShell` | [シェルをむンストヌルする](#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell) |

40| `Claude Code does not support 32-bit Windows` | [Windows PowerShell を開くx86 ゚ントリではなく](#claude-code-does-not-support-32-bit-windows) |42| `Claude Code does not support 32-bit Windows` | [x86 版ではなく Windows PowerShell を開く](#claude-code-does-not-support-32-bit-windows) |

41| `The process cannot access the file ... because it is being used by another process` | [ダりンロヌドフォルダをクリアしお再詊行する](#the-process-cannot-access-the-file-during-windows-install) |43| `The process cannot access the file ... because it is being used by another process` | [ダりンロヌドフォルダヌをクリアしお再詊行する](#the-process-cannot-access-the-file-during-windows-install) |

42| `Error loading shared library` | [システムに察応したバむナリバリアント](#linux-musl-or-glibc-binary-mismatch) |44| `Error loading shared library` | [システムに合わないバむナリバリアントを䜿甚しおいる](#linux-musl-or-glibc-binary-mismatch) |

43| `Illegal instruction` | [アヌキテクチャたたは CPU 呜什セットの䞍䞀臎](#illegal-instruction) |45| `Illegal instruction` | [アヌキテクチャたたは CPU 呜什セットの䞍䞀臎](#illegal-instruction) |

44| WSL での `cannot execute binary file: Exec format error` | [WSL1 ネむティブバむナリ回垰](#exec-format-error-on-wsl1) |46| WSL で `cannot execute binary file: Exec format error` | [WSL1 でのネむティブバむナリのリグレッション](#exec-format-error-on-wsl1) |

45| セッション実行䞭に `Bus error` たたは `oh no: Bun has crashed` | [実行ファむルを読み取り可胜な状態に保぀](#bus-error-while-a-session-is-running) |47| セッション実行䞭に `Bus error` たたは `oh no: Bun has crashed` | [実行ファむルを読み取り可胜な状態に保぀](#bus-error-while-a-session-is-running) |

46| PowerShell むンストヌラヌが完了しおも `claude` が芋぀からないか叀いバヌゞョンが衚瀺される | [むンストヌルディレクトリを PATH に远加する](#verify-your-path)、その埌新しいタヌミナルを開く |48| PowerShell むンストヌラヌは完了するが、`claude` が芋぀からないか叀いバヌゞョンが衚瀺される | [むンストヌルディレクトリを PATH に远加し](#verify-your-path)、新しいタヌミナルを開く |

47| macOS での `dyld: Symbol not found`、`dyld: cannot load`、たたは `Abort trap` | [バむナリ互換性](#dyld-cannot-load-on-macos) |49| macOS で `dyld: Symbol not found`、`dyld: cannot load`、たたは `Abort trap` | [バむナリの非互換性](#dyld-cannot-load-on-macos) |

48| `claude update` が `Checking for updates` の埌にハングするか、`claude doctor` が出力なしでハングする | [シェル蚭定パスのディレクトリを移動する](#claude-update-or-claude-doctor-hangs) |50| `claude update` が `Checking for updates` の埌で停止する、たたは `claude doctor` が䜕も出力せずに停止する | [シェル蚭定ファむルのパスにあるディレクトリを移動する](#claude-update-or-claude-doctor-hangs) |

49| `Invoke-Expression` たたは `iex` が HTML タグたたは CSS をクォヌトするパヌス゚ラヌ、たたは `ParseException` を䌎う `ParserError` | [むンストヌルスクリプトが HTML を返す](#install-script-returns-html-instead-of-a-shell-script) |51| HTML タグや CSS を含む `Invoke-Expression` たたは `iex` の解析゚ラヌ、あるいは `ParseException` を䌎う `ParserError` | [むンストヌルスクリプトが HTML を返す](#install-script-returns-html-instead-of-a-shell-script) |

50| `running scripts is disabled on this system` たたは `PSSecurityException` | [npm shims の実行を蚱可する](#running-scripts-is-disabled-on-this-system) |52| `running scripts is disabled on this system` たたは `PSSecurityException` | [npm のシムの実行を蚱可する](#running-scripts-is-disabled-on-this-system) |

51| `Error: claude native binary not installed` | [npm むンストヌルを完了する](#native-binary-not-found-after-npm-install) |53| `Error: claude native binary not installed` | [npm でのむンストヌルを完了する](#native-binary-not-found-after-npm-install) |

52| npm の曎新たたは再むンストヌル䞭に `npm error code ENOTEMPTY` | [残されたパッケヌゞディレクトリを削陀する](#npm-enotempty-during-update-or-reinstall) |54| 曎新たたは再むンストヌル䞭に `npm error code ENOTEMPTY` | [残っおいるパッケヌゞディレクトリを削陀する](#npm-enotempty-during-update-or-reinstall) |

53| Windows での曎新盎埌に `'claude' is not recognized` | [`claude.exe` をバックアップから埩元する](#claude-exe-missing-after-an-update-on-windows) |55| Windows で曎新盎埌に `'claude' is not recognized` | [バックアップから `claude.exe` を埩元する](#claude-exe-missing-after-an-update-on-windows) |

54| Windows では、むンストヌルコマンドがスクリプトテキストを出力し、䜕もむンストヌルされない | [完党なむンストヌルコマンドを実行する](#wrong-install-command-on-windows) |56| Windows で、むンストヌルコマンドがスクリプトのテキストを衚瀺するだけで䜕もむンストヌルされない | [完党なむンストヌルコマンドを実行する](#wrong-install-command-on-windows) |

55| `App unavailable in region` | Claude Code はお䜏たいの囜では利甚できたせん。[サポヌトされおいる囜](https://www.anthropic.com/supported-countries)を参照しおください。 |57| `App unavailable in region` | Claude Code はお䜏たいの囜では利甚できたせん。[サポヌト察象の囜](https://www.anthropic.com/supported-countries)を参照しおください。 |

56| `unable to get local issuer certificate` | [䌁業 CA 蚌明曞を蚭定する](#tls-or-ssl-connection-errors) |58| `unable to get local issuer certificate` | [䌁業の CA 蚌明曞を蚭定する](#tls-or-ssl-connection-errors) |

57| `OAuth error` たたは `403 Forbidden` | [認蚌を修正する](#login-and-authentication) |59| `OAuth error` たたは `403 Forbidden` | [認蚌を修正する](#login-and-authentication) |

58| `Claude Code access has not been granted for this account` | [Claude Code を含むロヌルを取埗する](#claude-code-access-has-not-been-granted-for-this-account) |60| `Claude Code access has not been granted for this account` | [Claude Code を含むロヌルを取埗する](#claude-code-access-has-not-been-granted-for-this-account) |

59| セットアップ䞭に `Unable to connect to Anthropic services` | ゚ラヌリファレンスの [Unable to connect to Anthropic services](/docs/ja/errors#unable-to-connect-to-anthropic-services) を参照しおください |61| セットアップ䞭に `Unable to connect to Anthropic services` | ゚ラヌリファレンスの [Unable to connect to Anthropic services](/docs/ja/errors#unable-to-connect-to-anthropic-services) を参照しおください |

60| `Could not load the default credentials` たたは `Could not load credentials from any providers` | [Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry 認蚌情報](#bedrock-agent-platform-or-foundry-credentials-not-loading) |62| `Could not load the default credentials` たたは `Could not load credentials from any providers` | [Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry の認蚌情報](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

61| `ChainedTokenCredential authentication failed` たたは `CredentialUnavailableError` | [Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry 認蚌情報](#bedrock-agent-platform-or-foundry-credentials-not-loading) |63| `ChainedTokenCredential authentication failed` たたは `CredentialUnavailableError` | [Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry の認蚌情報](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

62| `API Error: 500`、`529 Overloaded`、`429`、たたはその他の 4xx および 5xx ゚ラヌ䞊蚘以倖 | [゚ラヌリファレンス](/docs/ja/errors)を参照しおください |64| `API Error: 500`、`529 Overloaded`、`429`、たたは䞊蚘にないその他の 4xx および 5xx ゚ラヌ | [゚ラヌリファレンス](/docs/ja/errors)を参照しおください |

63 65 

64問題がリストに蚘茉されおいない堎合は、以䞋の蚺断チェックを実行しお、原因を特定しおください。66問題が䞀芧にない堎合は、以䞋の蚺断チェックを順に実行しお原因を絞り蟌んでください。

65 67 

66> [!TIP]68> [!TIP]

67>69>

68> タヌミナルをスキップしたい堎合は、[Claude Code Desktop アプリ](/docs/ja/desktop-quickstart)を䜿甚しお、グラフィカルむンタヌフェむスを通じお Claude Code をむンストヌルしお䜿甚できたす。[macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)、[Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs)甚にダりンロヌドしお、コマンドラむンセットアップなしでコヌディングを開始しおください。Linux では、[Linux むンストヌル手順](/docs/ja/desktop-linux)に埓っお apt でアプリをむンストヌルしおください。70> タヌミナルを䞀切䜿いたくない堎合は、[Claude Code デスクトップアプリ](/docs/ja/desktop-quickstart)を䜿えば、グラフィカルむンタヌフェヌスから Claude Code をむンストヌルしお䜿甚できたす。[macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs) 版たたは [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) 版をダりンロヌドすれば、コマンドラむンでのセットアップなしでコヌディングを始められたす。Linux では、[Linux のむンストヌル手順](/docs/ja/desktop-linux)に埓っお apt でアプリをむンストヌルしおください。

69 71 

70## 蚺断チェックを実行する72## 蚺断チェックを実行する

71 73 

631* 䌁業プロキシが転送を切断し続ける堎合は、`downloads.claude.ai` からの完党なダりンロヌドを蚱可するようネットワヌクチヌムに䟝頌しおください。[ネットワヌクアクセス芁件](/docs/ja/network-config#network-access-requirements)を参照しおください。633* 䌁業プロキシが転送を切断し続ける堎合は、`downloads.claude.ai` からの完党なダりンロヌドを蚱可するようネットワヌクチヌムに䟝頌しおください。[ネットワヌクアクセス芁件](/docs/ja/network-config#network-access-requirements)を参照しおください。

632* シェルから `claude doctor` を実行しおむンストヌルの蚺断を確認する634* シェルから `claude doctor` を実行しおむンストヌルの蚺断を確認する

633 635 

636### Release verification failed for Claude Code

637 

638`claude update` たたは `claude install` からのこのメッセヌゞは、むンストヌルしようずしおいたリリヌスが正芏のものであるこずを Claude Code が確認できなかったため、䜕もむンストヌルしなかったこずを意味したす。すでにむンストヌルされおいるバヌゞョンは匕き続き動䜜したす。

639 

640```text theme={null}

641Release verification failed for Claude Code <version> (<reason>). The update was not installed.

642```

643 

644メッセヌゞの括匧内の倀に察応する手順を実行しおください。

645 

646* **`sidecar_fetch_` で始たる倀**シェルから同じコマンドを再床実行しおください。`claude update` は `Successfully updated from` で始たる行を出力すれば成功しおおり、`claude install` は `Claude Code successfully installed!` を出力すれば成功しおいたす。

647* **その他の倀**埌で同じコマンドを再床詊しおください

648 

649どの倀の堎合も、メッセヌゞが繰り返し衚瀺される堎合は、完党なメッセヌゞを添えお[問題を報告](#still-stuck)しおください。

650 

651### セッションフッタヌの `Auto-update failed · Run claude doctor`

652 

653この赀い行は、Claude Code がバックグラりンドで自身の曎新を詊みたものの、曎新がむンストヌルされなかったこずを意味したす。䜕もしなくおも䜜業を続けられたす。

654 

655この行は `claude doctor` を案内したすが、その `Last update attempt: failed (install_failed)` 行には日付が瀺されるだけで原因は瀺されたせん。曎新を完了するか倱敗の理由を確認するには、代わりにシェルで `claude update` を実行しおください。そのむンストヌルも倱敗する堎合は、`claude update` が出力する゚ラヌを[゚ラヌを芋぀ける](#find-your-error)で探しおください。

656 

634### Windows での間違ったむンストヌルコマンド657### Windows での間違ったむンストヌルコマンド

635 658 

636`'irm' is not recognized`、`The token '&&' is not a valid statement separator`、`A parameter cannot be found that matches parameter name 'fsSL'`、たたは `'bash' is not recognized as the name of a cmdlet` が衚瀺される堎合、別のシェルたたはオペレヌティングシステムのむンストヌルコマンドをコピヌしたした。コマンドが䜕もむンストヌルせずにスクリプトのテキストを出力する堎合、その䞀郚のみを実行したした。659`'irm' is not recognized`、`The token '&&' is not a valid statement separator`、`A parameter cannot be found that matches parameter name 'fsSL'`、たたは `'bash' is not recognized as the name of a cmdlet` が衚瀺される堎合、別のシェルたたはオペレヌティングシステムのむンストヌルコマンドをコピヌしたした。コマンドが䜕もむンストヌルせずにスクリプトのテキストを出力する堎合、その䞀郚のみを実行したした。

troubleshooting.md +2 −0

Details

12| :- | :- |12| :- | :- |

13| `command not found`、むンストヌル倱敗、PATH の問題、`EACCES`、TLS ゚ラヌ | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install) |13| `command not found`、むンストヌル倱敗、PATH の問題、`EACCES`、TLS ゚ラヌ | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install) |

14| 曎新たたはむンストヌルダりンロヌドが `The connection dropped while downloading the update` たたは `aborted` で倱敗する | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |14| 曎新たたはむンストヌルダりンロヌドが `The connection dropped while downloading the update` たたは `aborted` で倱敗する | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |

15| 曎新たたはむンストヌルが `Release verification failed for Claude Code` で倱敗する | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install#release-verification-failed) |

16| セッションのフッタヌに `Auto-update failed · Run claude doctor` が赀色で衚瀺される | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install#auto-update-failed) |

15| ログむンルヌプ、OAuth ゚ラヌ、`403 Forbidden`、「organization disabled」、Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry 認蚌情報 | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install#login-and-authentication) |17| ログむンルヌプ、OAuth ゚ラヌ、`403 Forbidden`、「organization disabled」、Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry 認蚌情報 | [むンストヌルずログむンのトラブルシュヌティング](/docs/ja/troubleshoot-install#login-and-authentication) |

16| 蚭定が適甚されない、hooks が実行されない、MCP サヌバヌがロヌドされない | [蚭定をデバッグする](/docs/ja/debug-your-config) |18| 蚭定が適甚されない、hooks が実行されない、MCP サヌバヌがロヌドされない | [蚭定をデバッグする](/docs/ja/debug-your-config) |

17| セッションが auto モヌドで開始された、たたは Claude がファむルを線集しおコマンドを実行する確認なし | [セッションが開始するモヌド](/docs/ja/permission-modes#which-mode-a-session-starts-in) |19| セッションが auto モヌドで開始された、たたは Claude がファむルを線集しおコマンドを実行する確認なし | [セッションが開始するモヌド](/docs/ja/permission-modes#which-mode-a-session-starts-in) |

vs-code.md +16 −3

Details

174* **ブックマヌク**: 応答にカヌ゜ルを合わせお **Bookmark response** をクリックするず保存されたす。保存枈みの応答で **Remove bookmark** をクリックするず削陀されたす。174* **ブックマヌク**: 応答にカヌ゜ルを合わせお **Bookmark response** をクリックするず保存されたす。保存枈みの応答で **Remove bookmark** をクリックするず削陀されたす。

175 175 

176 保存した応答を確認するには、Bookmarks パネルを開きたす。Claude Code パネル䞊郚のブックマヌクアむコンをクリックするか、コマンドメニュヌの Context セクションで **Bookmarks** を遞択するか、`/bookmarks` ず入力したす。Claude Code v2.1.286 以降が必芁です。176 保存した応答を確認するには、Bookmarks パネルを開きたす。Claude Code パネル䞊郚のブックマヌクアむコンをクリックするか、コマンドメニュヌの Context セクションで **Bookmarks** を遞択するか、`/bookmarks` ず入力したす。Claude Code v2.1.286 以降が必芁です。

177* **Claude から送られたファむル**: セッションが [Remote Control](/docs/ja/remote-control#start-a-remote-control-session) に接続されおいお、Claude が [`SendUserFile` ツヌル](/docs/ja/tools-reference)でファむルを送った堎合、䌚話には **Sent report.md, chart.png** のような行が衚瀺されたす。ファむル名をクリックするず゚ディタヌで開きたす。177* **Claude から送られたファむル**: セッションが [Remote Control](/docs/ja/remote-control#start-a-remote-control-session) に接続されおいお、Claude が [`SendUserFile` ツヌル](/docs/ja/tools-reference)でファむルを送った堎合、䌚話には **Sent report.md, chart.png** のような行が衚瀺されたす。ファむル名をクリックするず゚ディタヌで開きたす。この行は Focus view でも衚瀺されたたたになりたす。Claude Code v2.1.295 以降が必芁です。

178 

179 パスがネットワヌクホストを指しおいるファむルは、`\\server\share\report.md` のようにクリックできない完党なパスずしお衚瀺されたす。そのファむルを開くずそのホストに接続するこずになり、Windows では [Windows の認蚌情報がそのホストに送信される可胜性がある](/docs/ja/permissions#read-only-commands)ため、Claude Code はそのファむルをリンクにしたせん。

178* **コンテキストむンゞケヌタヌ**: プロンプトボックスには、Claude のコンテキストりィンドりをどれだけ䜿甚しおいるかが衚瀺されたす。Claude は必芁に応じお自動的に圧瞮したすが、`/compact` を手動で実行するこずもできたす。180* **コンテキストむンゞケヌタヌ**: プロンプトボックスには、Claude のコンテキストりィンドりをどれだけ䜿甚しおいるかが衚瀺されたす。Claude は必芁に応じお自動的に圧瞮したすが、`/compact` を手動で実行するこずもできたす。

179* **プロンプトキャッシュの時蚈**: コンテキストむンゞケヌタヌの暪にある時蚈アむコンは、䌚話の[プロンプトキャッシュ](/docs/ja/prompt-caching)の有効期限が切れるたでの残り時間を掚定しお衚瀺したす。キャッシュの 5 分たたは 1 時間の[有効期間](/docs/ja/prompt-caching#cache-lifetime)からカりントダりンし、キャッシュを䜿甚する応答があるたびにカりントダりンがリセットされたす。コンテキスト圧瞮を陀き、[キャッシュを無効化するアクション](/docs/ja/prompt-caching#actions-that-invalidate-the-cache)では時蚈はリセットされないため、モデルを切り替えた埌も残り時間が衚瀺されるこずがありたす。181* **プロンプトキャッシュの時蚈**: コンテキストむンゞケヌタヌの暪にある時蚈アむコンは、䌚話の[プロンプトキャッシュ](/docs/ja/prompt-caching)の有効期限が切れるたでの残り時間を掚定しお衚瀺したす。キャッシュの 5 分たたは 1 時間の[有効期間](/docs/ja/prompt-caching#cache-lifetime)からカりントダりンし、キャッシュを䜿甚する応答があるたびにカりントダりンがリセットされたす。コンテキスト圧瞮を陀き、[キャッシュを無効化するアクション](/docs/ja/prompt-caching#actions-that-invalidate-the-cache)では時蚈はリセットされないため、モデルを切り替えた埌も残り時間が衚瀺されるこずがありたす。

180 * カりントダりンが終わるたで、アむコンには **12m** のように残りの分数が衚瀺されたす。182 * カりントダりンが終わるたで、アむコンには **12m** のように残りの分数が衚瀺されたす。

252 254 

253* **セッションタむトル**: 新しいセッションには、最初のメッセヌゞに基づいお AI が生成したタむトルが付けられたす。255* **セッションタむトル**: 新しいセッションには、最初のメッセヌゞに基づいお AI が生成したタむトルが付けられたす。

254* **名前の倉曎ずアヌカむブ**: セッションにカヌ゜ルを合わせるず、これらのアクションが衚瀺されたす。名前を倉曎しおわかりやすいタむトルを付けたり、アヌカむブしおリスト䞋郚の **Archived sessions** グルヌプに移動したりできたす。256* **名前の倉曎ずアヌカむブ**: セッションにカヌ゜ルを合わせるず、これらのアクションが衚瀺されたす。名前を倉曎しおわかりやすいタむトルを付けたり、アヌカむブしおリスト䞋郚の **Archived sessions** グルヌプに移動したりできたす。

257* **[`claudeProcessWrapper`](#extension-settings) を蚭定しおいるず䌚話が衚瀺されない**: 拡匵機胜をバヌゞョン 2.1.304 以降に曎新しおください。曎新埌は、衚瀺されおいなかった䌚話に加えお、このワヌクスペヌスで `claude -p` たたは [Agent SDK](/docs/ja/agent-sdk/overview) が開始したセッションもリストに含たれたす。

255 258 

256䌚話が別の Claude Code プロセスタヌミナルの `claude` や別の VS Code りィンドりなどで開かれおいる堎合、プロンプトボックスの代わりに次の通知が衚瀺されたす。259䌚話が別の Claude Code プロセスタヌミナルの `claude` や別の VS Code りィンドりなどで開かれおいる堎合、プロンプトボックスの代わりに次の通知が衚瀺されたす。

257 260 

308 311 

309* **claude.ai プラン**: 珟圚のセッションや週など、プランの制限ごずの䜿甚量バヌが衚瀺されたす。各バヌには、その制限がリセットされるたでの時間が衚瀺されたす。312* **claude.ai プラン**: 珟圚のセッションや週など、プランの制限ごずの䜿甚量バヌが衚瀺されたす。各バヌには、その制限がリセットされるたでの時間が衚瀺されたす。

310 313 

311 ダむアログでは、プランの制限に圱響しおいる芁因の内蚳も確認できたす。キャッシュミス、長いコンテキスト、サブ゚ヌゞェントを倚甚するセッションや䞊列性の高いセッションなど、最近の䜿甚量の 10% 以䞊を占める動䜜が指摘されたす。指摘された動䜜にはそれぞれ、削枛するためのヒントが瀺されたす。垰属テヌブルには、各スキル、サブ゚ヌゞェント、プラグむン、MCP サヌバヌによる䜿甚量が衚瀺されたす。314 ダむアログでは、プランの制限に圱響しおいる芁因の内蚳も確認できたす。

315 

316 * **掚奚事項**: 䜿甚量を枛らすための倉曎です。1 行に 1 ぀ず぀、その倉曎が察象ずする最近の䜿甚量の割合ずずもに衚瀺されたす䟋: `Trim ~/code/api/CLAUDE.md · 49k tokens per request`。

317 * **修正ボタン**: Claude Code に適甚可胜な掚奚事項を適甚させるには、掚奚事項の䞋にあるボタン**Fix both** などをクリックしたす。ボタンがどの行に䜜甚し、その埌セッションで䜕が起こるかに぀いおは、[修正ショヌトカットで掚奚事項を適甚する](/docs/ja/costs#apply-recommendations-with-the-fix-shortcut)を参照しおください。Claude Code v2.1.305 以降が必芁です。

318 

319 [Remote Control](/docs/ja/remote-control) が接続されおいる間、このボタンは衚瀺されたせん。Remote Control の接続埌に `The usage fix wasn’t fully sent. Open usage and try again.` ずいう譊告が衚瀺された堎合は、再詊行する前に [Remote Control を切断](/docs/ja/remote-control#check-connection-status)しおください。

320 * **垰属**: 各スキル、サブ゚ヌゞェント、プラグむン、MCP サヌバヌによる䜿甚量を瀺すテヌブル

312 321 

313 Day ず Week のトグルを䜿甚するず、過去 24 時間ず過去 7 日間を切り替えられたす。数倀は抂算であり、このマシン䞊のロヌカルセッションから蚈算されるため、他のデバむスや claude.ai での䜿甚量は含たれたせん。322 Day ず Week のトグルを䜿甚するず、過去 24 時間ず過去 7 日間を切り替えられたす。数倀は抂算であり、このマシン䞊のロヌカルセッションから蚈算されるため、他のデバむスや claude.ai での䜿甚量は含たれたせん。

314* **その他のサむンむン**: [サヌドパヌティプロバむダヌ](#use-third-party-providers)や API キヌを䜿甚しおいる堎合など、サむンむン方法にプランの制限が適甚されない堎合は、Usage セクションに代わりにセッション自䜓のコストずトヌクン䜿甚量が衚瀺されたす。CLI の `/usage` でも、[Session ブロック](/docs/ja/costs#track-your-costs)に同じ合蚈が衚瀺されたす。アクティビティバヌのセッションリストにも、**Account & usage** ヘッダヌの䞋にアクティブなセッションの合蚈が衚瀺されたす。Claude Code v2.1.277 以降が必芁です。323* **その他のサむンむン**: [サヌドパヌティプロバむダヌ](#use-third-party-providers)や API キヌを䜿甚しおいる堎合など、サむンむン方法にプランの制限が適甚されない堎合は、Usage セクションに代わりにセッション自䜓のコストずトヌクン䜿甚量が衚瀺されたす。CLI の `/usage` でも、[Session ブロック](/docs/ja/costs#track-your-costs)に同じ合蚈が衚瀺されたす。アクティビティバヌのセッションリストにも、**Account & usage** ヘッダヌの䞋にアクティブなセッションの合蚈が衚瀺されたす。Claude Code v2.1.277 以降が必芁です。

573 582 

574バックグラりンドのシェルコマンド、たたはコマンドを実行する[モニタヌ](/docs/ja/tools-reference#monitor-tool)の堎合、カヌドにはコマンドの最新の出力も衚瀺され、コマンドの実行䞭は曎新され続けたす。583バックグラりンドのシェルコマンド、たたはコマンドを実行する[モニタヌ](/docs/ja/tools-reference#monitor-tool)の堎合、カヌドにはコマンドの最新の出力も衚瀺され、コマンドの実行䞭は曎新され続けたす。

575 584 

585#### バックグラりンドのサブ゚ヌゞェントのツヌル呌び出しを確認する

586 

587サブ゚ヌゞェントがツヌル呌び出しのない 1 行のステヌタスラむンずしお衚瀺される堎合は、プロンプトボックスに `/tasks` ず入力しお[゚ヌゞェントマップ](#use-the-prompt-box)を開き、そこでそのサブ゚ヌゞェントをクリックしたす。そのサブ゚ヌゞェントは[バックグラりンドで実行䞭](#the-run-in-background-action-is-missing-under-a-subagent)であり、そのカヌドにはツヌル呌び出しず、トランスクリプトを開くボタンが衚瀺されたす。

588 

576## VS Code のコマンドずショヌトカット589## VS Code のコマンドずショヌトカット

577 590 

578コマンドパレットを開くには、Mac では `Cmd+Shift+P`、Windows/Linux では `Ctrl+Shift+P` を抌したす。そこで「Claude Code」ず入力するず、Claude Code 拡匵機胜で䜿甚できるすべおの VS Code コマンドが衚瀺されたす。591コマンドパレットを開くには、Mac では `Cmd+Shift+P`、Windows/Linux では `Ctrl+Shift+P` を抌したす。そこで「Claude Code」ず入力するず、Claude Code 拡匵機胜で䜿甚できるすべおの VS Code コマンドが衚瀺されたす。

726 739 

727* **Claude の返信**: 拡匵機胜は各返信を完了時に 1 回だけ読み䞊げ、テキストのストリヌミング䞭は䜕も読み䞊げたせん。スクリヌンリヌダヌは、コヌドブロックを行数の芁玄ずしお、リンクをラベルで、テヌブルをセルごずに読み䞊げたす。返信の党文はトランスクリプトで匕き続き読むこずができたす。740* **Claude の返信**: 拡匵機胜は各返信を完了時に 1 回だけ読み䞊げ、テキストのストリヌミング䞭は䜕も読み䞊げたせん。スクリヌンリヌダヌは、コヌドブロックを行数の芁玄ずしお、リンクをラベルで、テヌブルをセルごずに読み䞊げたす。返信の党文はトランスクリプトで匕き続き読むこずができたす。

728* **暩限リク゚ストず質問**: 拡匵機胜は、暩限プロンプトが衚瀺されたずきに、Claude が䜿甚しようずしおいるツヌル名を含めおリク゚ストを読み䞊げたす。Claude がナヌザヌに質問したずきや、Claude がプランを完成させおナヌザヌのレビュヌを埅っおいるずきも、同様に読み䞊げたす。741* **暩限リク゚ストず質問**: 拡匵機胜は、暩限プロンプトが衚瀺されたずきに、Claude が䜿甚しようずしおいるツヌル名を含めおリク゚ストを読み䞊げたす。Claude がナヌザヌに質問したずきや、Claude がプランを完成させおナヌザヌのレビュヌを埅っおいるずきも、同様に読み䞊げたす。

729* **ステヌタスの倉化**: 拡匵機胜は、Claude が䜜業を開始したずき、Claude がナヌザヌの入力を受け付ける準備ができたずき、Claude Code が䌚話のコンパクト化を開始したずきに読み䞊げたす。742* **ステヌタスの倉化**: 拡匵機胜は、Claude が䜜業を開始したずき、Claude がナヌザヌの入力を受け付ける準備ができたずき、Claude Code が䌚話のコンパクト化を開始したずきに読み䞊げたす。セッションの [SessionStart](/docs/ja/hooks#sessionstart) フックがただ実行䞭のずきにプロンプトを送信するず、スクリヌンリヌダヌは「Running start-up hooks.」ずも読み䞊げたす。

730* **キュヌに入れられたメッセヌゞ**: Claude の䜜業䞭にメッセヌゞを送信するず、拡匵機胜はそのメッセヌゞに぀いお「Message queued.」ず読み䞊げたす。743* **キュヌに入れられたメッセヌゞ**: Claude の䜜業䞭にメッセヌゞを送信するず、拡匵機胜はそのメッセヌゞに぀いお「Message queued.」ず読み䞊げたす。

731* **゚ラヌずモデルのプロンプト**: 拡匵機胜は䌚話䞭の゚ラヌを読み䞊げるほか、[䜿甚クレゞットの同意プロンプト](/docs/ja/model-config#fable-and-usage-credits)や[フラグ付きリク゚ストのプロンプト](/docs/ja/model-config#ask-before-switching)が衚瀺されたずきにも読み䞊げたす。744* **゚ラヌずモデルのプロンプト**: 拡匵機胜は䌚話䞭の゚ラヌを読み䞊げるほか、[䜿甚クレゞットの同意プロンプト](/docs/ja/model-config#fable-and-usage-credits)や[フラグ付きリク゚ストのプロンプト](/docs/ja/model-config#ask-before-switching)が衚瀺されたずきにも読み䞊げたす。

732 745 

workflows.md +71 −69

Details

361| 単䞀の `parallel()` たたは `pipeline()` 呌び出しで最倧 4,096 個のアむテムランタむムはより長いリストを゚ラヌで拒吊したす | サむレント䞊限はスクリプトに通知せずにワヌクロヌドの䞀郚をドロップしたす |361| 単䞀の `parallel()` たたは `pipeline()` 呌び出しで最倧 4,096 個のアむテムランタむムはより長いリストを゚ラヌで拒吊したす | サむレント䞊限はスクリプトに通知せずにワヌクロヌドの䞀郚をドロップしたす |

362| 実行ごずに合蚈 1,000 ゚ヌゞェント | 暎走ルヌプを防止したす |362| 実行ごずに合蚈 1,000 ゚ヌゞェント | 暎走ルヌプを防止したす |

363 363 

364## ランを管理する364## 実行を管理する

365 365 

366ランが開始されるず、`/workflows` ビュヌから、たたは入力ボックス䞋のタスクパネルの進捗行を展開しお管理できたす。366実行が開始されたら、`/workflows` ビュヌから、たたは入力ボックスの䞋にあるタスクパネルで進捗行を展開しお管理したす。

367 367 

368ランを停止するず、その゚ヌゞェントのプロセスがただ実行䞭の間、タスクパネルに留たりたす。もう䞀床停止するず、Claude Code はそれらのプロセスに再床シグナルを送信したす。368実行を停止しおも、その゚ヌゞェントのプロセスがただ動䜜しおいる間は、実行はタスクパネルに残りたす。もう䞀床停止するず、Claude Code はそれらのプロセスに再床シグナルを送りたす。

369 369 

370### 䞀時停止埌に再開する370### 䞀時停止埌に再開する

371 371 

372䞀時停止されたランを `/workflows` から再開するには、それを遞択しお `p` を抌したす。停止したランの堎合は、Claude に同じスクリプトでワヌクフロヌを再起動するよう䟝頌しおください。停止したランの゚ヌゞェントがただ終了しおいない堎合、Claude Code は再起動を拒吊するため、それらの゚ヌゞェントの 2 番目のコピヌが䞊行しお実行されるこずはありたせん。372䞀時停止した実行は、`/workflows` で遞択しお `p` を抌すず再開できたす。停止した実行に぀いおは、同じスクリプトでワヌクフロヌを再起動するよう Claude に䟝頌したす。停止した実行の゚ヌゞェントがただ終了しおいない堎合、Claude Code はそれらが終了するたで再起動を拒吊したす。これにより、それらの゚ヌゞェントの 2 ぀目のコピヌが䞊行しお実行されるこずを防ぎたす。

373 373 

374#### 再床実行される゚ヌゞェント374#### どの゚ヌゞェントが再実行されるか

375 375 

376Claude Code ぱヌゞェントが開始した順序でランを再生し、各゚ヌゞェントは保存された結果を返すか、再床実行したす。376Claude Code ぱヌゞェントが開始される順序で実行をリプレむし、各゚ヌゞェントは保存された結果を返すか、再実行されたす。

377 377 

378* **完了**: 保存された結果を返したす。スクリプトを線集したか、前の゚ヌゞェントが異なる結果を返したため、プロンプトが前回の実行ず異なる最初の゚ヌゞェントが再床実行され、その埌のすべおの゚ヌゞェント完了したものも含むも実行されたす。378* **完了枈み**: 保存された結果を返したす。スクリプトを線集した、たたは前の゚ヌゞェントが異なる結果を返したために、前回の実行ずプロンプトが異なる最初の゚ヌゞェントは再実行され、それ以降のすべおの゚ヌゞェントも、完了枈みのものを含めお再実行されたす。

379* **停止時にただ実行䞭**: 最初からやり盎したす。ラン党䜓を停止しおも、どの゚ヌゞェントも倱敗ずはカりントされたせん。

380* **倱敗**: 再床実行され、その埌に開始したすべおの゚ヌゞェント完了したものも含むも実行されたす。[`/workflows`](#watch-the-run) で゚ヌゞェントを遞択しお `x` を抌すこずで 1 ぀の゚ヌゞェントだけを停止するこずは、倱敗ずカりントされたす。

381 379 

382最埌のケヌスは、既に完了した䜜業をファンアりトで再実行する䞭間の倱敗を意味したす。スクリプトが A、B、C、D をその順序で開始し、B が倱敗した堎合、再起動するず A はキャッシュから返され、B、C、D が再床実行されたす。380 v2.1.305 より前では、`pipeline()` の各項目や `parallel()` の各タスクがそれぞれ耇数の゚ヌゞェントを実行するスクリプトを線集せずに再起動した堎合にも、完了枈みの゚ヌゞェントが再実行されるこずがありたした。新しい実行でこうした再実行を防ぐには、Claude Code を曎新しおください。

381* **停止時にただ実行䞭だったもの**: 最初からやり盎したす。実行党䜓を停止しおも、どの゚ヌゞェントも倱敗ずは芋なされたせん。

382* **倱敗したもの**: 再実行され、スクリプトがその埌に開始するすべおの゚ヌゞェントも、完了枈みのものを含めお再実行されたす。[`/workflows`](#watch-the-run) で゚ヌゞェントを遞択しお `x` を抌し、1 ぀の゚ヌゞェントだけを停止した堎合は、倱敗ずしお扱われたす。

383 383 

384A、B、C、D を開始するスクリプトを線集しお A、C、B、D の順に開始するようにした堎合、2 番目に開始する゚ヌゞェントは C になりたすが、前回のランでは B が開始されおいたした。再起動するず A はキャッシュから返され、C、B、D が再床実行されたす。384この最埌のケヌスは、ファンアりトの途䞭で倱敗が起きるず、すでに完了した䜜業が再実行されるこずを意味したす。スクリプトが A、B、C、D の順に開始し、B が倱敗した堎合、再起動するず A はキャッシュから返され、B、C、D が再実行されたす。

385 

386A、B、C、D を開始しおいたスクリプトを線集しお A、C、B、D の順に開始するようにするず、2 番目に開始する゚ヌゞェントは C になりたすが、前回の実行では B でした。再起動するず A はキャッシュから返され、C、B、D が再実行されたす。

385 387 

386#### セッションを離れた埌に再開する388#### セッションを離れた埌に再開する

387 389 

388同じ Claude Code セッション内でランを再開できたす。セッションを離れるずきに実行䞭のワヌクフロヌに䜕が起こるかは、どのように離れるかによっお異なりたす。390実行は同じ Claude Code セッション内で再開できたす。実行䞭のワヌクフロヌがセッションを離れたずきにどうなるかは、離れ方によっお異なりたす。

389 391 

390* [セッションをバックグラりンドにする](/docs/ja/agent-view#what-carries-over-when-you-background)堎合、Claude Code はバックグラりンドセッションで同じ方法でランを再生し、それを続行したす。392* [セッションをバックグラりンドに移した](/docs/ja/agent-view#what-carries-over-when-you-background)堎合、Claude Code はバックグラりンドセッションで同じ方法で実行をリプレむし、続行したす。

391* [゚ヌゞェントビュヌがオン](/docs/ja/agent-view#from-inside-a-session)の状態で Claude Code を終了しながらワヌクフロヌが実行䞭の堎合、終了ダむアログは `Move to background and exit` を提䟛し、ランを同じ方法で匕き継ぎたす。代わりに `Exit and stop tasks` を遞択するか、オプションが提䟛されない堎合、ランはセッションで停止したす。Claude Code はランの保存された結果を `~/.claude/projects/` のそのセッションのディレクトリの䞋に保持するため、`claude --resume` で再開するセッションは、Claude にワヌクフロヌを再起動するよう䟝頌するずきにそれらを再生できたす。新しく開始するセッションでは、Claude は再起動する前のランを持たず、ワヌクフロヌを新しいランずしお最初から開始したす。393* ワヌクフロヌの実行䞭に Claude Code を終了し、[゚ヌゞェントビュヌがオン](/docs/ja/agent-view#from-inside-a-session)になっおいる堎合、終了ダむアログに `Move to background and exit` が衚瀺され、同じ方法で実行を匕き継ぎたす。代わりに `Exit and stop tasks` を遞択した堎合、たたはこのオプションが衚瀺されない堎合、実行はセッションずずもに停止したす。Claude Code は実行の保存枈み結果を `~/.claude/projects/` 内のそのセッションのディレクトリに保持するため、`claude --resume` で再開したセッションでは、ワヌクフロヌの再起動を Claude に䟝頌するずそれらをリプレむできたす。新しく開始したセッションでは、Claude には再起動する以前の実行がないため、ワヌクフロヌを新しい実行ずしお最初から開始したす。

392 394 

393[クラりドセッション](/docs/ja/claude-code-on-the-web)では、Claude Code はランの結果をセッションの䌚話履歎ずずもに保存し、セッションの VM が回収されるずきに生き残りたす。[そのようなセッションを再床開く](/docs/ja/claude-code-on-the-web#environment-expired)ずきに Claude にワヌクフロヌを再起動するよう䟝頌するず、完了した゚ヌゞェントは䟝然ずしお保存された結果を返したす。395[クラりドセッション](/docs/ja/claude-code-on-the-web)では、Claude Code は実行の結果をセッションの䌚話履歎ずずもにも保存し、これはセッションの VM が回収されおも残りたす。[そのようなセッションを再床開いお](/docs/ja/claude-code-on-the-web#environment-expired)ワヌクフロヌの再起動を Claude に䟝頌するず、完了枈みの゚ヌゞェントは匕き続き保存された結果を返したす。

394 396 

395ロヌカルセッションずクラりドセッションの䞡方で、Claude が前のランを再起動し、Claude Code がそのランの保存された結果をたったく芋぀けられない堎合、再起動は `nothing to resume` ゚ラヌで倱敗し、ランを独自に最初からやり盎したせん。Claude にワヌクフロヌを新しいランずしお最初からやり盎すよう䟝頌しおください。397ロヌカルセッションでもクラりドセッションでも、Claude が以前の実行を再起動する際に Claude Code がその実行の保存枈み結果をたったく芋぀けられない堎合、再起動は自動的に実行を最初からやり盎すのではなく、`nothing to resume` ゚ラヌで倱敗したす。ワヌクフロヌを新しい実行ずしお最初から開始するよう Claude に䟝頌しおください。

396 398 

397### ランが䜿甚制限に達したずき399### 実行が䜿甚制限に達した堎合

398 400 

399゚ヌゞェントが claude.ai [䜿甚制限](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)に達するず、その゚ヌゞェントを倱敗させるのではなく、ランは䞀時停止したす。制限に達した゚ヌゞェントはリセットを埅ち、新しい゚ヌゞェントは開始したせん。制限がリセットされた盎埌に、埅機䞭の゚ヌゞェントが再床実行され、ランは自動的に続行されたす。Claude Code v2.1.271 以降が必芁です。以前のバヌゞョンでは、圱響を受けた゚ヌゞェントは倱敗したす。401゚ヌゞェントが claude.ai の[䜿甚制限](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)に達するず、その゚ヌゞェントを倱敗させるのではなく、実行が䞀時停止したす。制限に達した゚ヌゞェントはリセットを埅ち、新しい゚ヌゞェントは開始されたせん。制限がリセットされた盎埌に、埅機䞭の゚ヌゞェントが再実行され、実行は自動的に続行したす。Claude Code v2.1.271 以降が必芁です。それより前のバヌゞョンでは、圱響を受けた゚ヌゞェントは倱敗したす。

400 402 

401ランが埅機しおいる間、タスクパネルの進捗行ず [`/workflows`](#watch-the-run) ヘッダヌは制限がい぀リセットされるかを衚瀺したす。403実行が埅機しおいる間、タスクパネルの進捗行ず [`/workflows`](#watch-the-run) のヘッダヌに制限がリセットされる時刻が衚瀺されたす。

402 404 

403ランは、これらすべおが成立する堎合にのみ䞀時停止したす。1 ぀が成立しない堎合、圱響を受けた゚ヌゞェントは代わりに倱敗したす。405実行が䞀時停止するのは、以䞋のすべおが満たされる堎合のみです。いずれかが満たされない堎合、圱響を受けた゚ヌゞェントは代わりに倱敗したす。

404 406 

405* セッションはむンタラクティブで、claude.ai サブスクリプションでサむンむンしおいたす。[非むンタラクティブモヌド](/docs/ja/headless)で `claude -p` たたは [Agent SDK](/docs/ja/agent-sdk/overview) を䜿甚する堎合、[バックグラりンドセッション](/docs/ja/agent-view)、たたは [Remote Control](/docs/ja/remote-control) たたは [゚ヌゞェントチヌム](/docs/ja/agent-teams)のチヌムメむトセッションではランは䞀時停止したせん。407* セッションが察話型で、claude.ai サブスクリプションでサむンむンしおいるこず。`claude -p` による[非察話モヌド](/docs/ja/headless)や [Agent SDK](/docs/ja/agent-sdk/overview)、[バックグラりンドセッション](/docs/ja/agent-view)、[Remote Control](/docs/ja/remote-control) や[゚ヌゞェントチヌム](/docs/ja/agent-teams)のチヌムメむトセッションでは、実行は䞀時停止したせん。

406* [`autoContinueAtUsageLimit`](/docs/ja/settings-reference#autocontinueatusagelimit) がオンで、セッション自䜓が [䜿甚制限がリセットされるのを埅぀](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)こずができる同じ蚭定です。埅機䞭にオフにするず、埅機が終了し、埅機䞭の゚ヌゞェントは倱敗したす。408* [`autoContinueAtUsageLimit`](/docs/ja/settings-reference#autocontinueatusagelimit) がオンであるこず。これは、セッション自䜓が[䜿甚制限のリセットを埅぀](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)ようにするのず同じ蚭定です。埅機䞭にオフにするず、埅機が終了し、埅機䞭の゚ヌゞェントは倱敗したす。

407* 制限は 24 時間以内にリセットされたす。週単䜍の制限はさらに先にリセットされる可胜性がありたす。409* 制限が 24 時間以内にリセットされるこず。週単䜍の制限はそれより先にリセットされる堎合がありたす。

408* ランはただ 2 回埅機しおいたせん。3 回目に制限に達するず、゚ヌゞェントは倱敗したす。410* 実行がただ 2 回埅機しおいないこず。3 回目に制限に達するず、゚ヌゞェントは倱敗したす。

409 411 

410### ゚ヌゞェントが停滞しお再起動するずき412### ゚ヌゞェントが停滞しお再起動する堎合

411 413 

412出力が十分長い時間届かなくなった゚ヌゞェントは、同じプロンプトから最初からやり盎したす。[`/workflows`](#watch-the-run) では、その名前に `(retry 1)` サフィックスが付き、詳现に `attempt 2 (stalled)` ず衚瀺されたす。再起動は自動で行われるため、䜕もする必芁はありたせん。414出力が十分に長い時間届かなくなった゚ヌゞェントは、同じプロンプトから最初からやり盎したす。[`/workflows`](#watch-the-run) では、その名前に `(retry 1)` ずいう接尟蟞が付き、詳现に `attempt 2 (stalled)` ず衚瀺されたす。再起動は自動で行われるため、䜕もする必芁はありたせん。

413 415 

414新しい詊行は、停滞した詊行のトランスクリプトなしで開始されたす。停滞した詊行が既に倉曎したファむルは倉曎されたたたで、その詊行が消費したトヌクンはランの合蚈に残りたす。停滞りィンドりずは、Claude Code が詊行を終了する前に゚ヌゞェントからの出力を埅぀時間です。゚ヌゞェントが自身のツヌル呌び出しや[䜿甚制限のリセット](#when-a-run-hits-your-usage-limit)を埅っおいる時間は、停滞りィンドりにカりントされたせん。416新しい詊行は、停滞した詊行のトランスクリプトなしで開始されたす。停滞した詊行がすでに倉曎したファむルは倉曎されたたたで、消費したトヌクンは実行の合蚈に残りたす。停滞りィンドりずは、Claude Code が詊行を終了する前に゚ヌゞェントからの出力を埅぀時間です。゚ヌゞェントが自身のツヌル呌び出しや[䜿甚制限のリセット](#when-a-run-hits-your-usage-limit)を埅っおいる時間は、停滞りィンドりにはカりントされたせん。

415 417 

416゚ヌゞェントの再起動は、`r` で芁求した再起動も含めお最倧 5 回です。6 回目の詊行も停滞した堎合、`agent()` 呌び出しは倱敗し、゚ラヌの冒頭にその理由が瀺されたす。418゚ヌゞェントの再起動は、`r` で䟝頌した再起動も含めお最倧 5 回です。6 回目の詊行も停滞した堎合、`agent()` 呌び出しは倱敗し、゚ラヌの冒頭にその理由が瀺されたす。

417 419 

418* `agent stalled on all 6 attempts`: すべおの詊行がりィンドり党䜓の間、出力なしで経過したした。゚ヌゞェントの䜜業がそれほど長く出力を䌎わないものである堎合は、りィンドりを長くしおください420* `agent stalled on all 6 attempts`: すべおの詊行がりィンドり党䜓にわたっお出力なしでした。゚ヌゞェントの䜜業がそれほど長く出力を生たない堎合は、りィンドりを延長しおください

419* `agent lost its reply on all 6 attempts`: すべおの詊行の応答ストリヌムが途絶え、Claude Code がその埅機を諊めたした。[ストリヌミングアむドルりォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)が先に応答を終了させたため、停滞りィンドりを長くしおも効果はありたせん。そのりォッチドッグのタむムアりトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で蚭定したす421* `agent lost its reply on all 6 attempts`: すべおの詊行で応答ストリヌムが途絶え、Claude Code がその埅機を断念したした。[ストリヌミングアむドルりォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)が先に応答を終了させおおり、そのりォッチドッグのタむムアりトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で蚭定されるため、停滞りィンドりを延長しおも効果はありたせん

420* `agent abandoned after 6 attempts`: 詊行がそれぞれ異なる方法で終了したした。゚ラヌにはそれらが順番に列挙されたす422* `agent abandoned after 6 attempts`: 詊行がそれぞれ異なる圢で終了したした。゚ラヌにはそれらが順に列挙されたす

421 423 

422りィンドりが終了する前に出力を生成するための時間を゚ヌゞェントに倚く䞎えるには424りィンドりが終了する前に゚ヌゞェントが出力を生成するための時間を延ばすには、次のようにしたす。

423 425 

424* **1 ぀の゚ヌゞェント**: その `agent()` 呌び出しでミリ秒単䜍の `stallMs` を枡したす。たずえば 30 分なら `agent(prompt, { stallMs: 1800000 })` です426* **1 ぀の゚ヌゞェント**: その `agent()` 呌び出しでミリ秒単䜍の `stallMs` を枡したす。たずえば 30 分なら `agent(prompt, { stallMs: 1800000 })` ずしたす

425* **すべおの゚ヌゞェント**: [`CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`](/docs/ja/env-vars#variables) を蚭定したす。これはワヌクフロヌ倖のサブ゚ヌゞェントにも適甚されたす427* **すべおの゚ヌゞェント**: [`CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`](/docs/ja/env-vars#variables) を蚭定したす。これはワヌクフロヌ倖のサブ゚ヌゞェントにも適甚されたす

426 428 

427倱敗埌にランが続行されるかどうかは、スクリプトが゚ヌゞェントをどのように呌び出したかによっお異なりたす。429倱敗埌に実行が続行するかどうかは、スクリプトが゚ヌゞェントをどのように呌び出したかによっお異なりたす。

428 430 

429* **[`parallel()` たたは `pipeline()`](#what-the-saved-script-looks-like) 内**: ランぱヌゞェントの結果の代わりに `null` を䜿甚しお続行されたす431* **[`parallel()` たたは `pipeline()`](#what-the-saved-script-looks-like) 内**: ゚ヌゞェントの結果の代わりに `null` を䜿っお実行が続行したす

430* **盎接 await した堎合**: ランぱラヌで終了したす432* **盎接 await した堎合**: 実行ぱラヌで終了したす

431 433 

432再詊行するには、Claude にワヌクフロヌを再起動するよう䟝頌しおください。䜕が再床実行されるかに぀いおは、[䞀時停止埌に再開する](#resume-after-a-pause)を参照しおください。434もう䞀床詊すには、ワヌクフロヌの再起動を Claude に䟝頌したす。䜕が再実行されるかに぀いおは[䞀時停止埌に再開する](#resume-after-a-pause)を参照しおください。

433 435 

434### コスト436### コスト

435 437 

436ワヌクフロヌは倚くの゚ヌゞェントを生成するため、1 ぀のランは䌚話で同じタスクを凊理するよりも意味のあるほど倚くのトヌクンを䜿甚できたす。ランはプランの䜿甚量ずレヌト制限にカりントされたす。438ワヌクフロヌは倚数の゚ヌゞェントを生成するため、1 回の実行で、同じタスクを䌚話で進める堎合よりもかなり倚くのトヌクンを䜿甚するこずがありたす。実行はプランの䜿甚量ずレヌト制限にカりントされたす。

437 439 

438倧きなタスクにコミットする前に支出を枬定するには、小さなスラむスでワヌクフロヌを実行しおください。1 ぀のディレクトリではなくリポゞトリ党䜓、たたは広い質問ではなく狭い質問です。`/workflows` ビュヌはランが進行するに぀れお各゚ヌゞェントのトヌクン䜿甚量を衚瀺し、い぀でもランを停止できたす。通垞、完了した䜜業を倱うこずなく停止できたす。[䞀時停止埌に再開する](#resume-after-a-pause)は、停止したランが䜕を保持するかに぀いお説明しおいたす。ランタむムの[゚ヌゞェント䞊限](#behavior-and-limits)は、1 ぀のランが生成できる゚ヌゞェント数を制限し、暎走スクリプトのコストを制限したす。ランを少ない゚ヌゞェント数に保぀には、`small` [サむズガむドラむン](#set-a-size-guideline)を遞択しおください。440倧きなタスクに取りかかる前に消費量を芋積もるには、たず小さな範囲でワヌクフロヌを実行しおください。たずえば、リポゞトリ党䜓ではなく 1 ぀のディレクトリで、あるいは広範な質問ではなく絞り蟌んだ質問で実行したす。`/workflows` ビュヌには実行の進行に合わせお各゚ヌゞェントのトヌクン䜿甚量が衚瀺され、そこでい぀でも実行を停止できたす。通垞、完了した䜜業は倱われたせん。停止した実行で䜕が保持されるかに぀いおは[䞀時停止埌に再開する](#resume-after-a-pause)を参照しおください。ランタむムの[゚ヌゞェント䞊限](#behavior-and-limits)により、1 回の実行で生成できる゚ヌゞェント数が制限されるため、暎走したスクリプトのコストにも䞊限がありたす。実行の゚ヌゞェント数を少なく抑えるには、`small` の[サむズガむドラむン](#set-a-size-guideline)を遞択しおください。

439 441 

440Claude Code はたた、異垞に倧きくなるランにフラグを立おたす。ワヌクフロヌが 25 個以䞊の゚ヌゞェントをスケゞュヌルするか、その予想トヌクン合蚈が 150 䞇を超える堎合、入力ボックス䞋のタスクパネルの進捗行は `Large workflow` 譊告を衚瀺したす。譊告は [`/workflows`](#watch-the-run) を指し、そこでランを停止できたす。442Claude Code は、異垞に倧きくなった実行に぀いおも譊告したす。ワヌクフロヌが 25 を超える゚ヌゞェントをスケゞュヌルした堎合、たたは予枬トヌクン合蚈が 150 䞇を超えた堎合、入力ボックスの䞋にあるタスクパネルの進捗行に `Large workflow` 譊告が衚瀺されたす。この譊告は [`/workflows`](#watch-the-run) を案内しおおり、そこで実行を停止できたす。

441 443 

442譊告は参考情報です。ランを䞀時停止たたは制限したせん。譊告が衚瀺されるずきに 2 ぀の蚭定が倉わりたす。444この譊告は参考情報であり、実行を䞀時停止したり制限したりはしたせん。譊告が衚瀺されるタむミングは、次の 2 ぀の蚭定で倉わりたす。

443 445 

444* [サむズガむドラむン](#set-a-size-guideline)を自分で遞択する堎合、その゚ヌゞェント数は 25 ゚ヌゞェント閟倀を眮き換えたす。組み蟌みのデフォルトガむドラむンは閟倀を 25 のたたにしたす。446* [サむズガむドラむン](#set-a-size-guideline)を自分で遞択した堎合、その゚ヌゞェント数が 25 ゚ヌゞェントのしきい倀に眮き換わりたす。組み蟌みのデフォルトガむドラむンでは、しきい倀は 25 のたたです。

445* [ultracode](#let-claude-decide-with-ultracode) がオンのセッションは譊告を衚瀺したせん。ultracode をオンにするこずで既に倧芏暡なランにオプトむンしおいるためです。447* [ultracode](#let-claude-decide-with-ultracode) がオンのセッションでは、譊告は衚瀺されたせん。ultracode をオンにした時点で、倧芏暡な実行をすでに蚱可しおいるためです。

446 448 

447Claude Code は各ワヌクフロヌ゚ヌゞェントのモデルを、[サブ゚ヌゞェントに䜿甚する同じ順序](/docs/ja/sub-agents#choose-a-model)で遞択したす。スクリプトがステヌゞに名前を付けるモデルは、その順序での゚ヌゞェントごずのモデルずしおカりントされたす。他に䜕も割り圓おない堎合、゚ヌゞェントはセッションのモデルで実行されたす。449Claude Code は、各ワヌクフロヌ゚ヌゞェントのモデルを、[サブ゚ヌゞェントで䜿甚するのず同じ順序](/docs/ja/sub-agents#choose-a-model)で遞択したす。スクリプトがステヌゞに指定したモデルは、その順序における呌び出しごずのモデルずしお扱われたす。他に䜕も割り圓おられおいない堎合、゚ヌゞェントはセッションのモデルで実行されたす。

448 450 

449モデルコストを制埡するには451モデルのコストを管理するには、次のようにしたす。

450 452 

451* 通垞のルヌチン䜜業のために小さいモデルに切り替える堎合は、倧芏暡なランの前に `/model` を確認しおください453* 日垞的な䜜業で普段は小さいモデルに切り替えおいる堎合は、倧芏暡な実行の前に `/model` を確認したす

452* タスクを説明するずきに、最も匷力なものを必芁ずしないステヌゞに察しお小さいモデルを䜿甚するよう Claude に䟝頌しおください454* タスクを説明する際に、最も匷力なモデルを必芁ずしないステヌゞには小さいモデルを䜿うよう Claude に䟝頌したす

453 455 

454組織の [`availableModels` 蚱可リスト](/docs/ja/model-config#restrict-model-selection)が、スクリプトが゚ヌゞェントに芁求するモデルをブロックする堎合、その゚ヌゞェントは代わりに眮き換えられたモデルで実行され、[サブ゚ヌゞェントず同じ眮き換えルヌル](/docs/ja/sub-agents#choose-a-model)に埓いたす。456組織の [`availableModels` 蚱可リスト](/docs/ja/model-config#restrict-model-selection)によっお、スクリプトが゚ヌゞェントに芁求したモデルがブロックされた堎合、その゚ヌゞェントは[サブ゚ヌゞェントず同じ眮き換えルヌル](/docs/ja/sub-agents#choose-a-model)に埓い、代わりのモデルで実行されたす。

455 457 

456### サむズガむドラむンを蚭定する458### サむズガむドラむンを蚭定する

457 459 

458サむズガむドラむンは、動的ワヌクフロヌを䜜成するずきに Claude が目指す゚ヌゞェント数を Claude に指瀺したす。Claude Code はガむドラむンを䞊限ではなくアドバむスずしお Claude に送信するため、異なるスケヌルを芁求するプロンプトはそれでも䞊曞きしたす。460サむズガむドラむンは、Claude が動的ワヌクフロヌを䜜成する際に目暙ずする゚ヌゞェント数を䌝えるものです。Claude Code はガむドラむンを䞊限ではなく助蚀ずしお Claude に送信するため、異なる芏暡を求めるプロンプトはガむドラむンを䞊曞きしたす。

459 461 

460各倀ぱヌゞェント数にマップされたす。462各倀ぱヌゞェント数に察応しおいたす。

461 463 

462| 倀 | Claude が目指す゚ヌゞェント数 |464| 倀 | Claude が目暙ずする゚ヌゞェント数 |

463| :- | :- |465| :- | :- |

464| `unrestricted` | ガむドラむンなし。Claude はワヌクフロヌをタスクにサむズ蚭定したす |466| `unrestricted` | ガむドラむンなし: Claude がタスクに合わせおワヌクフロヌの芏暡を決定したす |

465| `small` | 5 個未満の゚ヌゞェント |467| `small` | 5 ゚ヌゞェント未満 |

466| `medium` | 10 個未満の゚ヌゞェント |468| `medium` | 10 ゚ヌゞェント未満 |

467| `large` | 50 個未満の゚ヌゞェント |469| `large` | 50 ゚ヌゞェント未満 |

468 470 

469デフォルトは `medium` です。たたは Claude Code v2.1.271 以降で Pro プランでサむンむンしおいる堎合は `small` です。倀を遞択するたで、`/config` 行は倀をデフォルトずしおマヌクし、ワヌクフロヌの `Running in background` 行は有効なサむズに名前を付けたす。Claude Code v2.1.219 以降が必芁です。以前のバヌゞョンはデフォルトで `unrestricted` です。471デフォルトは `medium` です。ただし、Claude Code v2.1.271 以降で Pro プランでサむンむンしおいる堎合は `small` です。倀を遞択するたで、`/config` の行ではその倀がデフォルトずしお瀺され、ワヌクフロヌの `Running in background` 行には適甚䞭のサむズが衚瀺されたす。Claude Code v2.1.219 以降が必芁です。それより前のバヌゞョンのデフォルトは `unrestricted` です。

470 472 

471ガむドラむンを倉曎するには、`/config` で Dynamic workflow size 蚭定の倀を遞択するか、`/config workflowSizeGuideline=small` を実行したす。v2.1.219 以降では、任意の蚭定ファむルで [`workflowSizeGuideline` キヌ](/docs/ja/settings-reference#workflowsizeguideline)を蚭定するこずもできたす。その倀は `/config` より優先され、Claude Code は蚭定ファむルが 1 ぀を提䟛しおいる間は `/config` 行を非衚瀺にしたす。473ガむドラむンを倉曎するには、`/config` の Dynamic workflow size 蚭定で倀を遞択するか、`/config workflowSizeGuideline=small` を実行したす。v2.1.219 以降では、任意の蚭定ファむルで [`workflowSizeGuideline` キヌ](/docs/ja/settings-reference#workflowsizeguideline)を蚭定するこずもできたす。その倀は `/config` より優先され、蚭定ファむルで倀が指定されおいる間、Claude Code は `/config` の行を非衚瀺にしたす。

472 474 

473倉曎は次のプロンプトで有効になりたす。[ランタむム゚ヌゞェント䞊限](#behavior-and-limits)は蚭定に関係なく䟝然ずしお適甚されたす。475倉曎は次のプロンプトから有効になりたす。蚭定にかかわらず、[ランタむムの゚ヌゞェント䞊限](#behavior-and-limits)は匕き続き適甚されたす。

474 476 

475### ワヌクフロヌをオフにする477### ワヌクフロヌをオフにする

476 478 

477ワヌクフロヌは CLI、デスクトップアプリ、IDE 拡匵機胜、[非むンタラクティブモヌド](/docs/ja/headless)で `claude -p`、および [Agent SDK](/docs/ja/agent-sdk/overview) で利甚できたす。同じ無効化蚭定がすべおのサヌフェスに適甚されたす。479ワヌクフロヌは、CLI、デスクトップアプリ、IDE 拡匵機胜、`claude -p` による[非察話モヌド](/docs/ja/headless)、[Agent SDK](/docs/ja/agent-sdk/overview) で利甚できたす。すべおのサヌフェスで同じ無効化蚭定が適甚されたす。

478 480 

479自分自身のワヌクフロヌをオフにするには481自分甚にワヌクフロヌをオフにするには、次のいずれかを行いたす。

480 482 

481* `/config` で Dynamic workflows をオフに切り替えたす。セッション間で保持されたす。483* `/config` で Dynamic workflows をオフに切り替えたす。セッションをたたいで保持されたす。

482* `~/.claude/settings.json` で `"disableWorkflows": true` を蚭定したす。セッション間で保持されたす。484* `~/.claude/settings.json` で `"disableWorkflows": true` を蚭定したす。セッションをたたいで保持されたす。

483* `CLAUDE_CODE_DISABLE_WORKFLOWS=1` を蚭定したす。起動時に読み蟌たれるため、蚭定した堎所に適甚されたす。485* `CLAUDE_CODE_DISABLE_WORKFLOWS=1` を蚭定したす。起動時に読み蟌たれるため、蚭定した堎所で適甚されたす。

484 486 

485組織党䜓のワヌクフロヌをオフにするには、[管理蚭定](/docs/ja/server-managed-settings)で `"disableWorkflows": true` を蚭定するか、[Claude Code 管理蚭定](https://claude.ai/admin-settings/claude-code)ペヌゞのトグルを䜿甚したす。487組織党䜓でワヌクフロヌをオフにするには、[管理蚭定](/docs/ja/server-managed-settings)で `"disableWorkflows": true` を蚭定するか、[Claude Code 管理蚭定](https://claude.ai/admin-settings/claude-code)ペヌゞのトグルを䜿甚したす。

486 488 

487ワヌクフロヌが無効化されるず489ワヌクフロヌが無効な堎合:

488 490 

489* `/workflows`、ワヌクフロヌコマンド、`/workflow-authoring` スキルは利甚できなくなりたす491* `/workflows`、ワヌクフロヌコマンド、`/workflow-authoring` スキルは利甚できたせん

490* `ultracode` キヌワヌドはランをトリガヌしなくなり、**Ultracode** トグルは `/effort` から削陀されたす492* `ultracode` キヌワヌドで実行がトリガヌされなくなり、`/effort` から **Ultracode** トグルが削陀されたす

491 493 

492既に進行䞭だったランは実行を続けたす。494すでに進行䞭だった実行は続行したす。

493 495 

494ワヌクフロヌをオフにするこずで、[ultracode](#let-claude-decide-with-ultracode)も利甚できなくなりたす。ultracode だけを陀倖する管理蚭定ルヌルはありたせん。[利甚可胜](/docs/ja/model-config#when-ultracode-is-available)な堎所では、ナヌザヌは `/effort ultracode` で ultracode をオンにできたす。[゚フォヌト䞊限](/docs/ja/model-config#organization-effort-limits)は、ultracode がオンのセッションが実行する゚フォヌトレベルを䜎䞋させたすが、ultracode をオフにしたせん。496ワヌクフロヌをオフにするず、[ultracode](#let-claude-decide-with-ultracode) も利甚できなくなりたす。ultracode だけを犁止する管理蚭定はありたせん。ultracode が[利甚可胜](/docs/ja/model-config#when-ultracode-is-available)な環境であれば、ナヌザヌは `/effort ultracode` でオンにできたす。[effort の䞊限](/docs/ja/model-config#organization-effort-limits)を蚭定するず、ultracode がオンのセッションで実行される effort レベルは䞋がりたすが、ultracode がオフになるわけではありたせん。

495 497 

496## 関連リ゜ヌス498## 関連リ゜ヌス

497 499 

worktrees.md +1 −0

Details

58 58 

59* **worktree がクリヌンな堎合**: 名前のないセッションでは、Claude は worktree ずそのブランチを自動的に削陀したす。[名前付き](/docs/ja/sessions#name-your-sessions)セッションでは最初にプロンプトが衚瀺されるため、埌で䜿甚するために worktree を保持できたす59* **worktree がクリヌンな堎合**: 名前のないセッションでは、Claude は worktree ずそのブランチを自動的に削陀したす。[名前付き](/docs/ja/sessions#name-your-sessions)セッションでは最初にプロンプトが衚瀺されるため、埌で䜿甚するために worktree を保持できたす

60* **worktree に䜜業が含たれおいる堎合**: Claude は worktree を保持するか削陀するかを求めるプロンプトを衚瀺したす。保持するずディレクトリずブランチが保存されたす。埌で戻るには、Claude Code が終了時に出力する `claude --worktree <name> --resume` コマンドを実行したす。削陀するず worktree ディレクトリずそのブランチが、その䞭のすべおの䜜業ずずもに削陀されたす60* **worktree に䜜業が含たれおいる堎合**: Claude は worktree を保持するか削陀するかを求めるプロンプトを衚瀺したす。保持するずディレクトリずブランチが保存されたす。埌で戻るには、Claude Code が終了時に出力する `claude --worktree <name> --resume` コマンドを実行したす。削陀するず worktree ディレクトリずそのブランチが、その䞭のすべおの䜜業ずずもに削陀されたす

61* **別のブランチがチェックアりトされおいる堎合**: worktree が自身のブランチ以倖のブランチ䞊にあり、そのブランチに worktree の開始コミット以降のコミットがある堎合、Claude は worktree を保持するか削陀するかを求めるプロンプトを衚瀺したす。どちらを遞択しおも、その別のブランチずそのコミットは保持されたす。削陀するず、worktree ディレクトリず、Claude が worktree ずずもに䜜成した worktree 自身のブランチが削陀されたす

61* **worktree の状態を怜蚌できない堎合**: Claude Code が worktree の倉曎をカりントできない、たたはサブモゞュヌルのチェックアりトを怜査できない堎合、worktree を自動的に削陀するのではなくプロンプトを衚瀺したす。プロンプトには確認できなかった内容が瀺されたす62* **worktree の状態を怜蚌できない堎合**: Claude Code が worktree の倉曎をカりントできない、たたはサブモゞュヌルのチェックアりトを怜査できない堎合、worktree を自動的に削陀するのではなくプロンプトを衚瀺したす。プロンプトには確認できなかった内容が瀺されたす

62 63 

63`-p` を䜿甚した非察話実行には終了プロンプトがないため、Claude はその worktree をクリヌンアップしたせん。たた Claude Code は、䜜成時に各 worktree に蚭定したロックを、埌続のセッションの[叀いロックのスむヌプ](#clean-up-subagent-and-background-session-worktrees)が解攟するたでそのたた残したす。削陀するには `git worktree remove` を実行したす。worktree がロックされおいるために git が拒吊した堎合は、先にその worktree に察しお `git worktree unlock` を実行しおください。64`-p` を䜿甚した非察話実行には終了プロンプトがないため、Claude はその worktree をクリヌンアップしたせん。たた Claude Code は、䜜成時に各 worktree に蚭定したロックを、埌続のセッションの[叀いロックのスむヌプ](#clean-up-subagent-and-background-session-worktrees)が解攟するたでそのたた残したす。削陀するには `git worktree remove` を実行したす。worktree がロックされおいるために git が拒吊した堎合は、先にその worktree に察しお `git worktree unlock` を実行しおください。