620| [`autoScrollEnabled`](#autoscrollenabled) | フルスクリーンレンダリングで[新しい出力に従う](/docs/ja/fullscreen#auto-follow)ことを有効にします | Interface and terminal | Any file |620| [`autoScrollEnabled`](#autoscrollenabled) | フルスクリーンレンダリングで[新しい出力に従う](/docs/ja/fullscreen#auto-follow)ことを有効にします | Interface and terminal | Any file |
621| [`autoUpdatesChannel`](#autoupdateschannel) | 最新ではなく安定した[リリースチャネル](/docs/ja/setup#configure-release-channel)に従います | Updates and versioning | Any file |621| [`autoUpdatesChannel`](#autoupdateschannel) | 最新ではなく安定した[リリースチャネル](/docs/ja/setup#configure-release-channel)に従います | Updates and versioning | Any file |
622| [`availableModels`](#availablemodels) | [ユーザーが選択できるモデルを制限](/docs/ja/model-config#restrict-model-selection)します | Model and responses | Any file |622| [`availableModels`](#availablemodels) | [ユーザーが選択できるモデルを制限](/docs/ja/model-config#restrict-model-selection)します | Model and responses | Any file |
623| [`availableModelsMatch`](#availablemodelsmatch) | 各 `availableModels` モデル ID エントリが[それが名前を付けるバージョンのみを許可](/docs/ja/model-config#block-specific-models-or-versions)するようにします | Model and responses | Managed |
623| [`awaySummaryEnabled`](#awaysummaryenabled) | ターミナルに戻ったときに表示される[セッション要約](/docs/ja/interactive-mode#session-recap)をオフにします | Remote, desktop, and notifications | Any file |624| [`awaySummaryEnabled`](#awaysummaryenabled) | ターミナルに戻ったときに表示される[セッション要約](/docs/ja/interactive-mode#session-recap)をオフにします | Remote, desktop, and notifications | Any file |
624| [`awsAuthRefresh`](#awsauthrefresh) | 独自のコマンドで `.aws` の期限切れ[Bedrock 認証情報](/docs/ja/amazon-bedrock#advanced-credential-configuration)をリフレッシュします | Authentication and providers | Any file |625| [`awsAuthRefresh`](#awsauthrefresh) | 独自のコマンドで `.aws` の期限切れ[Bedrock 認証情報](/docs/ja/amazon-bedrock#advanced-credential-configuration)をリフレッシュします | Authentication and providers | Any file |
625| [`awsCredentialExport`](#awscredentialexport) | 独自のコマンドから JSON として[Bedrock 認証情報](/docs/ja/amazon-bedrock#advanced-credential-configuration)を提供します | Authentication and providers | Any file |626| [`awsCredentialExport`](#awscredentialexport) | 独自のコマンドから JSON として[Bedrock 認証情報](/docs/ja/amazon-bedrock#advanced-credential-configuration)を提供します | Authentication and providers | Any file |
629| [`blockedMarketplaces`](#blockedmarketplaces) | 組織の[プラグインマーケットプレイス](/docs/ja/plugins/overview)ソースをブロックします | Plugins and skills | Managed |630| [`blockedMarketplaces`](#blockedmarketplaces) | 組織の[プラグインマーケットプレイス](/docs/ja/plugins/overview)ソースをブロックします | Plugins and skills | Managed |
630| [`browserExternalPageTools`](#browserexternalpagetools) | [デスクトップ](/docs/ja/desktop)ブラウザペインの外部ページで Claude のツールをオフにします | Tools | Managed |631| [`browserExternalPageTools`](#browserexternalpagetools) | [デスクトップ](/docs/ja/desktop)ブラウザペインの外部ページで Claude のツールをオフにします | Tools | Managed |
631| [`channelsEnabled`](#channelsenabled) | 組織の[チャネル](/docs/ja/channels#enable-channels-for-your-organization)を許可します | Plugins and skills | Managed |632| [`channelsEnabled`](#channelsenabled) | 組織の[チャネル](/docs/ja/channels#enable-channels-for-your-organization)を許可します | Plugins and skills | Managed |
633| [`claudeInChromeDefaultEnabled`](#claudeinchromedefaultenabled) | `--chrome` を渡さずにすべてのインタラクティブ CLI セッションで[Chrome 統合](/docs/ja/chrome)をオンにします | Global config settings | Global config |
632| [`claudeMd`](#claudemd) | マネージド設定から組織全体の[CLAUDE.md](/docs/ja/memory#deploy-organization-wide-claude-md)指示を注入します | Memory and context | Managed |634| [`claudeMd`](#claudemd) | マネージド設定から組織全体の[CLAUDE.md](/docs/ja/memory#deploy-organization-wide-claude-md)指示を注入します | Memory and context | Managed |
633| [`claudeMdExcludes`](#claudemdexcludes) | メモリがロードされるときに特定の[CLAUDE.md](/docs/ja/memory#exclude-specific-claude-md-files)ファイルをスキップします | Memory and context | Any file |635| [`claudeMdExcludes`](#claudemdexcludes) | メモリがロードされるときに特定の[CLAUDE.md](/docs/ja/memory#exclude-specific-claude-md-files)ファイルをスキップします | Memory and context | Any file |
634| [`cleanupPeriodDays`](#cleanupperioddays) | Claude Code が[トランスクリプト](/docs/ja/data-usage#data-retention)を削除する前に保持する日数を選択します | Privacy and telemetry | Any file |636| [`cleanupPeriodDays`](#cleanupperioddays) | Claude Code が[トランスクリプト](/docs/ja/data-usage#data-retention)を削除する前に保持する日数を選択します | Privacy and telemetry | Any file |
635| [`companyAnnouncements`](#companyannouncements) | スタートアップ時に組織のアナウンスメントを表示します | Interface and terminal | Any file |637| [`companyAnnouncements`](#companyannouncements) | スタートアップ時に組織のアナウンスメントを表示します | Interface and terminal | Any file |
638| [`copyFullResponse`](#copyfullresponse) | [`/copy`](/docs/ja/commands)がコードブロックピッカーを表示せずに完全な応答をコピーするようにします | Global config settings | Global config |
636| [`copyOnSelect`](#copyonselect) | [フルスクリーンレンダリング](/docs/ja/fullscreen#use-the-mouse)およびエージェントビューでマウスで選択したテキストの自動コピーをオフにします | Global config settings | Global config |639| [`copyOnSelect`](#copyonselect) | [フルスクリーンレンダリング](/docs/ja/fullscreen#use-the-mouse)およびエージェントビューでマウスで選択したテキストの自動コピーをオフにします | Global config settings | Global config |
637| [`crossSessionInbound`](#crosssessioninbound) | Claude Code が[他のセッションからのメッセージ](/docs/ja/cross-session-messaging#control-inbound-messages)を配信するか、配信せずに通知を表示するか、または拒否するかを選択します | Agents, sessions, and worktrees | Any file |640| [`crossSessionInbound`](#crosssessioninbound) | Claude Code が[他のセッションからのメッセージ](/docs/ja/cross-session-messaging#control-inbound-messages)を配信するか、配信せずに通知を表示するか、または拒否するかを選択します | Agents, sessions, and worktrees | Any file |
638| [`defaultShell`](#defaultshell) | [`!` プレフィックス](/docs/ja/interactive-mode#shell-mode-with-prefix)で入力したシェルコマンドを実行する Bash または PowerShell を選択します | Interface and terminal | Any file |641| [`defaultShell`](#defaultshell) | [`!` プレフィックス](/docs/ja/interactive-mode#shell-mode-with-prefix)で入力したシェルコマンドを実行する Bash または PowerShell を選択します | Interface and terminal | Any file |
642| [`defaultToAgentsView`](#defaulttoagentsview) | 引数なしで `claude` を実行するときに新しい会話の代わりに[エージェントビュー](/docs/ja/agent-view)を開きます | Global config settings | Global config |
639| [`deniedMcpServers`](#deniedmcpservers) | URL、コマンド、または名前で特定の[MCP サーバー](/docs/ja/mcp)をブロックします | MCP | Any file |643| [`deniedMcpServers`](#deniedmcpservers) | URL、コマンド、または名前で特定の[MCP サーバー](/docs/ja/mcp)をブロックします | MCP | Any file |
644| [`deniedModels`](#deniedmodels) | [特定のモデルをブロック](/docs/ja/model-config#block-specific-models-or-versions)します。`availableModels` が許可するものでも | Model and responses | Managed |
640| [`desktopSessionCleanupPeriodDays`](#desktopsessioncleanupperioddays) | [Claude Desktop および Cowork トランスクリプト](/docs/ja/claude-directory#cleaned-up-automatically)の経過日数制限を設定します | Privacy and telemetry | User or managed |645| [`desktopSessionCleanupPeriodDays`](#desktopsessioncleanupperioddays) | [Claude Desktop および Cowork トランスクリプト](/docs/ja/claude-directory#cleaned-up-automatically)の経過日数制限を設定します | Privacy and telemetry | User or managed |
641| [`dialogExpiry`](#dialogexpiry) | Claude Code が[リモートコントロール](/docs/ja/remote-control)または SDK ホストが転送されたダイアログに答えるのを待つ時間を設定します | Interface and terminal | User or managed |646| [`dialogExpiry`](#dialogexpiry) | Claude Code が[リモートコントロール](/docs/ja/remote-control)または SDK ホストが転送されたダイアログに答えるのを待つ時間を設定します | Interface and terminal | User or managed |
642| [`diffTool`](#difftool) | Claude の提案されたファイル変更が[VS Code](/docs/ja/vs-code)または[JetBrains](/docs/ja/jetbrains#features)差分ビューアで開くか、ターミナルに留まるかを選択します | Global config settings | Global config |647| [`diffTool`](#difftool) | Claude の提案されたファイル変更が[VS Code](/docs/ja/vs-code)または[JetBrains](/docs/ja/jetbrains#features)差分ビューアで開くか、ターミナルに留まるかを選択します | Global config settings | Global config |
690| [`isolatePeerMachines`](#isolatepeermachines) | Claude が[別のマシンのセッションの 1 つにメッセージを送信](/docs/ja/cross-session-messaging#require-approval-for-cross-machine-messages)する前に確認を求めます | Agents, sessions, and worktrees | Any file |695| [`isolatePeerMachines`](#isolatepeermachines) | Claude が[別のマシンのセッションの 1 つにメッセージを送信](/docs/ja/cross-session-messaging#require-approval-for-cross-machine-messages)する前に確認を求めます | Agents, sessions, and worktrees | Any file |
691| [`keybindingFlavor`](#keybindingflavor) | 非推奨で効果がありません。単語編集ショートカットは常に[readline 規約に従う](/docs/ja/interactive-mode#make-ctrl-w-delete-back-to-whitespace)ます | Interface and terminal | Any file |696| [`keybindingFlavor`](#keybindingflavor) | 非推奨で効果がありません。単語編集ショートカットは常に[readline 規約に従う](/docs/ja/interactive-mode#make-ctrl-w-delete-back-to-whitespace)ます | Interface and terminal | Any file |
692| [`language`](#language) | Claude が英語以外の言語で応答するようにします | Model and responses | Any file |697| [`language`](#language) | Claude が英語以外の言語で応答するようにします | Model and responses | Any file |
698| [`leftArrowOpensAgents`](#leftarrowopensagents) | [バックグラウンドセッションとエージェントビューを開く](/docs/ja/agent-view#switch-sessions-without-leaving-the-terminal)ショートカット `←` をオフにします | Global config settings | Global config |
693| [`managedMcpServers`](#managedmcpservers) | ユーザーが追加するものと一緒にすべてのユーザーにリモート[MCP サーバー](/docs/ja/managed-mcp#provide-servers-through-managed-settings)を提供します | MCP | Managed |699| [`managedMcpServers`](#managedmcpservers) | ユーザーが追加するものと一緒にすべてのユーザーにリモート[MCP サーバー](/docs/ja/managed-mcp#provide-servers-through-managed-settings)を提供します | MCP | Managed |
694| [`managedSourcesBehavior`](#managedsourcesbehavior) | デプロイするすべての[マネージドソース](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)を構成する代わりに、最優先のものだけを使用します | Enterprise and managed settings | Managed |700| [`managedSourcesBehavior`](#managedsourcesbehavior) | デプロイするすべての[マネージドソース](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)を構成する代わりに、最優先のものだけを使用します | Enterprise and managed settings | Managed |
695| [`maxEffortLevel`](#maxeffortlevel) | すべてのモデルまたはモデルごと、すべてのプロバイダーで[努力レベル](/docs/ja/model-config#adjust-effort-level)をキャップします | Model and responses | Any file |701| [`maxEffortLevel`](#maxeffortlevel) | すべてのモデルまたはモデルごと、すべてのプロバイダーで[努力レベル](/docs/ja/model-config#adjust-effort-level)をキャップします | Model and responses | Any file |
702| [`maxProseWidth`](#maxprosewidth) | 広いターミナルで Claude の応答内の散文がどのくらい広く実行されるかをキャップします | Interface and terminal | Any file |
696| [`minimumVersion`](#minimumversion) | [自動更新](/docs/ja/setup#pin-a-minimum-version)がバージョン以下のものをインストールするのを防ぎます | Updates and versioning | Any file |703| [`minimumVersion`](#minimumversion) | [自動更新](/docs/ja/setup#pin-a-minimum-version)がバージョン以下のものをインストールするのを防ぎます | Updates and versioning | Any file |
697| [`model`](#model) | Claude Code が開始する[モデル](/docs/ja/model-config#set-a-default-model-for-new-sessions)を変更します | Model and responses | Any file |704| [`model`](#model) | Claude Code が開始する[モデル](/docs/ja/model-config#set-a-default-model-for-new-sessions)を変更します | Model and responses | Any file |
698| [`modelOverrides`](#modeloverrides) | [モデル ID をマップ](/docs/ja/model-config#override-model-ids-per-version)して、Bedrock ARN などのプロバイダーの ID にします | Model and responses | Any file |705| [`modelOverrides`](#modeloverrides) | [モデル ID をマップ](/docs/ja/model-config#override-model-ids-per-version)して、Bedrock ARN などのプロバイダーの ID にします | Model and responses | Any file |
724| [`processWrapper`](#processwrapper) | Claude Code のバックグラウンドプロセスを macOS および Linux の[企業ランチャー](/docs/ja/corporate-launcher)を通して実行します | Agents, sessions, and worktrees | User or managed |731| [`processWrapper`](#processwrapper) | Claude Code のバックグラウンドプロセスを macOS および Linux の[企業ランチャー](/docs/ja/corporate-launcher)を通して実行します | Agents, sessions, and worktrees | User or managed |
725| [`promptCacheTtl`](#promptcachettl) | メイン会話の[プロンプトキャッシュライフタイム](/docs/ja/prompt-caching#cache-lifetime)を選択します | Model and responses | Any file |732| [`promptCacheTtl`](#promptcachettl) | メイン会話の[プロンプトキャッシュライフタイム](/docs/ja/prompt-caching#cache-lifetime)を選択します | Model and responses | Any file |
726| [`promptSuggestionEnabled`](#promptsuggestionenabled) | 入力ボックスのグレーアウトされた[プロンプト提案](/docs/ja/interactive-mode#prompt-suggestions)を非表示にします | Interface and terminal | Any file |733| [`promptSuggestionEnabled`](#promptsuggestionenabled) | 入力ボックスのグレーアウトされた[プロンプト提案](/docs/ja/interactive-mode#prompt-suggestions)を非表示にします | Interface and terminal | Any file |
734| [`prStatusFooterEnabled`](#prstatusfooterenabled) | プロンプトフッターの[PR レビューステータス](/docs/ja/interactive-mode#pr-review-status)バッジとその背後にあるプルリクエストチェックをオフにします | Global config settings | Global config |
727| [`prUrlTemplate`](#prurltemplate) | PR リンクを github.com ではなく内部コードレビューツールにポイントします | Git and attribution | Any file |735| [`prUrlTemplate`](#prurltemplate) | PR リンクを github.com ではなく内部コードレビューツールにポイントします | Git and attribution | Any file |
728| [`remote.defaultEnvironmentId`](#remote-defaultenvironmentid) | `claude --cloud` のデフォルト[クラウド環境](/docs/ja/cloud-environments)を選択します。自己ホスト型 `ccpool_` ID はユーザーおよびマネージド設定および `--settings` からのみ読み取られます | Remote, desktop, and notifications | Any file |736| [`remote.defaultEnvironmentId`](#remote-defaultenvironmentid) | `claude --cloud` のデフォルト[クラウド環境](/docs/ja/cloud-environments)を選択します。自己ホスト型 `ccpool_` ID はユーザーおよびマネージド設定および `--settings` からのみ読み取られます | Remote, desktop, and notifications | Any file |
729| [`remoteControlAtStartup`](#remotecontrolatstartup) | セッション開始時に[リモートコントロール](/docs/ja/remote-control#enable-remote-control-for-all-sessions)に自動的に接続します | Remote, desktop, and notifications | Any file |737| [`remoteControlAtStartup`](#remotecontrolatstartup) | セッション開始時に[リモートコントロール](/docs/ja/remote-control#enable-remote-control-for-all-sessions)に自動的に接続します | Remote, desktop, and notifications | Any file |
833 `advisorModel`841 `advisorModel`
834</h3>842</h3>
835 843
836Claude がサーバー側の[アドバイザーツール](/docs/ja/advisor)を呼び出すときに回答するモデルを選択します。アドバイザーをオフにするには、これを設定解除します。アドバイザーは少なくともメインモデルと同じくらい有能である必要があります。受け入れられるペアリングと受け入れられないペアリングを選択した場合の動作については、[アドバイザーモデルを選択](/docs/ja/advisor#choose-an-advisor-model)を参照してください。844Claude がサーバー側の[アドバイザーツール](/docs/ja/advisor)を呼び出すときに回答するモデルを選択します。これを設定解除するとアドバイザーがオフになります。アドバイザーはメインモデル以上の能力を持つ必要があります。受け入れられるペアリングと受け入れられないペアリングを選択した場合の動作については、[アドバイザーモデルを選択](/docs/ja/advisor#choose-an-advisor-model)を参照してください。
837 845
838通常、このキーを手動で編集することはありません。`/advisor` を実行して、現在の選択、アドバイザーができるモデル、および**アドバイザーなし**を表示するピッカーを開きます。Claude Code は選択を `~/.claude/settings.json` のこのキーに保存します。[リモートコントロール](/docs/ja/remote-control)クライアントから、またはリモートワーカーに接続されたセッションでピッカーから選択した場合、その選択はそのセッションのみに適用され、このキーは変更されません。846通常、このキーを手動で編集することはありません。`/advisor` を実行して、現在の選択、アドバイザーができるモデル、および**アドバイザーなし**を表示するピッカーを開きます。Claude Code は選択を `~/.claude/settings.json` のこのキーに保存します。[リモートコントロール](/docs/ja/remote-control)クライアントから、またはリモートワーカーに接続されたセッションで選択した場合、その選択はそのセッションのみに適用され、このキーは変更されません。
839 847
840アカウントが[使用クレジット同意](/docs/ja/advisor#fable-advisor-and-usage-credits)を必要とする場合は、`/model fable` を実行して最初にそれを受け入れます。そうするまで、`/advisor` で Fable を選択しても何も保存されず、Claude Code は最初に `/model fable` を実行するよう指示します。848アカウントが[使用クレジット同意](/docs/ja/advisor#fable-advisor-and-usage-credits)を必要とする場合は、`/model fable` を実行して最初に同意を受け入れます。これを行うまで、`/advisor` で Fable を選択しても何も保存されず、Claude Code は最初に `/model fable` を実行するよう指示します。
841 849
842* **スコープ**: [`任意のファイル`](#scopes)850* **スコープ**: [`任意のファイル`](#scopes)
843* **タイプ**: 文字列、エイリアス `"fable"`、`"opus"`、または `"sonnet"` のいずれか。これらはそのモデルファミリーの Claude Code の現在のデフォルトバージョンに解決されます。または `"claude-opus-5-5"` などの完全なモデル ID851* **タイプ**: 文字列、エイリアス `"fable"`、`"opus"`、または `"sonnet"` のいずれか。これらは Claude Code の現在のデフォルトバージョンのそのモデルファミリーに解決されます。または、`"claude-opus-5-5"` などの完全なモデル ID
844* **デフォルト**: 設定解除されているため、アドバイザーはオフです852* **デフォルト**: 設定解除されているため、アドバイザーはオフです
845* **セッションごとのオーバーライド**: `--advisor` はこのキーより優先されます。[`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/ja/env-vars)はアドバイザーをオフにし、このキーはそれをオンに戻すことはできません853* **セッションごとのオーバーライド**: `--advisor` はこのキーより優先されます。[`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/ja/env-vars)はアドバイザーをオフにし、このキーはそれをオンに戻すことはできません
846 854
856 `alwaysThinkingEnabled`864 `alwaysThinkingEnabled`
857</h3>865</h3>
858 866
859これを `false` に設定して、すべてのセッションで[拡張思考](/docs/ja/model-config#extended-thinking)をオフにします。思考はデフォルトでオンなので、`true` は何も変わりません。ほとんどの人はファイルを編集するのではなく `/config` を通じてこれを設定します。867このキーを `false` に設定して、すべてのセッションで[拡張思考](/docs/ja/model-config#extended-thinking)をオフにします。思考はデフォルトでオンなので、`true` は何も変わりません。ほとんどの人はファイルを編集するのではなく `/config` を通じてこれを設定します。
860 868
861Opus 5.5 や Fable モデルなど、常に思考するモデルでは、`false` は効果がありません。[サードパーティプロバイダー](/docs/ja/third-party-integrations)では、Claude Code は思考をオフにするのではなく `thinking` パラメータを省略するため、適応推論モデルは依然として思考する可能性があります。Anthropic API で思考がオフになっている場合、Claude Code は、Opus 5 など[その組み合わせを受け入れない](/docs/ja/errors#effort-isnt-available-with-thinking-turned-off)ことが分かっているモデルに対して、より高いレベルではなく努力 `high` を送信します。869Opus 5.5、Sonnet 5.5、Fable モデルなど、常に思考するモデルでは、`false` は効果がありません。[サードパーティプロバイダー](/docs/ja/third-party-integrations)では、Claude Code は思考をオフにするのではなく `thinking` パラメータを省略するため、適応推論モデルは依然として思考する可能性があります。Anthropic API で思考をオフにした場合、Claude Code は、Opus 5 など[その組み合わせを受け入れない](/docs/ja/errors#effort-isnt-available-with-thinking-turned-off)ことが分かっているモデルに、より高いレベルではなく努力 `high` を送信します。
862 870
863* **スコープ**: [`任意のファイル`](#scopes)871* **スコープ**: [`任意のファイル`](#scopes)
864* **タイプ**: ブール値872* **タイプ**: ブール値
865 * `true`: 効果なし。思考は既にオンです873 * `true`: 効果なし。思考は既にオンです
866 * `false`: Claude Code はすべてのセッションで拡張思考をオフにします874 * `false`: Claude Code はすべてのセッションで拡張思考をオフにします
867* **デフォルト**: 設定解除されているため、思考はそれをサポートするモデルではオンです875* **デフォルト**: 設定解除されているため、思考はそれをサポートするモデルではオンです
868* **セッションごとのオーバーライド**: [`MAX_THINKING_TOKENS`](/docs/ja/env-vars)はこのキーより優先されます。1 つのセッション: `0` は思考をオフにし、`false` と同じモデルおよびプロバイダーの制限下で、正の値はこのキーが `false` の場合でも思考をオンにします。適応推論モデルでは、数値自体は無視されます876* **セッションごとのオーバーライド**: [`MAX_THINKING_TOKENS`](/docs/ja/env-vars)はこのキーより優先されます。`0` は `false` と同じモデルおよびプロバイダーの制限の下で思考をオフにし、正の値は、このキーが `false` の場合でも思考をオンにします。適応推論モデルでは、数値自体は無視されます
869 877
870```json settings.json theme={null}878```json settings.json theme={null}
871{879{
877 `availableModels`885 `availableModels`
878</h3>886</h3>
879 887
880メインセッション、[サブエージェント](/docs/ja/sub-agents)、[スキル](/docs/ja/skills)、および[アドバイザー](/docs/ja/advisor)に対して、人々が選択できるモデルを制限します。管理対象リストは `/model`、`--model`、および開発者自身のファイルの `model` キーを制限します。リスト外のモデルは選択できません。それ自体では Default オプションには影響しません。[`enforceAvailableModels`](#enforceavailablemodels)とペアにしてください。888メインセッション、[サブエージェント](/docs/ja/sub-agents)、[スキル](/docs/ja/skills)、および[アドバイザー](/docs/ja/advisor)で選択できるモデルを制限します。管理リストは `/model`、`--model`、および開発者自身のファイルの `model` キーを制限します。リスト外のモデルは選択できません。デフォルトのプレフィックスマッチングでは、これは Default オプション自体には影響しません。[`enforceAvailableModels`](#enforceavailablemodels)とペアにしてください。
881 889
882* **スコープ**: [`任意のファイル`](#scopes)。組織に対して強制するために、管理設定にデプロイします。890* **スコープ**: [`任意のファイル`](#scopes)。組織に対して強制するために、管理設定にデプロイします。
883* **タイプ**: モデルエイリアスまたは ID の配列891* **タイプ**: モデルエイリアスまたは ID の配列
884* **デフォルト**: 設定解除されているため、すべてのモデルが利用可能です892* **デフォルト**: 設定解除されているため、すべてのモデルが利用可能です
885 893
886この例では、人々は Sonnet と Haiku モデルのみを選択できます:894この例では、Sonnet と Haiku モデルのみを選択できます:
887 895
888```json settings.json theme={null}896```json settings.json theme={null}
889{897{
891}899}
892```900```
893 901
894[モデル選択を制限](/docs/ja/model-config#restrict-model-selection)を参照してください。902`"claude-opus-5"` などのモデル ID エントリは、Opus 5.5 などそれを拡張する後のバージョンも許可します。これらのバージョンのいずれかをブロックするには、[`deniedModels`](#deniedmodels)を使用します。各モデル ID エントリが名前を付けたバージョンのみを許可するようにするには、[`availableModelsMatch`](#availablemodelsmatch)を使用します。[モデル選択を制限](/docs/ja/model-config#restrict-model-selection)を参照してください。
903
904<h3 id="availablemodelsmatch">
905 `availableModelsMatch`
906</h3>
907
908[`availableModels`](#availablemodels)エントリがモデル ID とどのように一致するかを選択します。デフォルトでは、モデル ID エントリはそれを拡張する後のバージョンも許可するため、`"claude-opus-5"` は Opus 5.5 を許可します。`"exact"` では、各モデル ID エントリは名前を付けたバージョンのみを許可するため、そのモデルの新しいバージョンはリストに追加されるまでブロックされたままです。Claude Code v2.1.283 以降が必要です。
909
910* **スコープ**: [`管理`](#scopes)。Claude Code はユーザー、プロジェクト、ローカル設定および `--settings` のキーを無視し、警告を表示します
911* **タイプ**: 文字列、以下のいずれか:
912 * `"prefix"`: モデル ID エントリはそのバージョンと、別のセグメントで拡張するモデル ID を許可します
913 * `"exact"`: モデル ID エントリは名前を付けたバージョンのみを許可します。日付付き ID を含むため、`"claude-opus-5"` は Opus 5 を許可しますが `claude-opus-5-5` は許可しません。`"opus"` などのファミリーエイリアスは依然としてファミリー全体を許可し、`best`、`opusplan`、および `default` エントリは無視されます
914* **デフォルト**: `"prefix"`
915
916この例は Opus 5 と Sonnet 5 を許可し、どちらの後のリリースも許可しません:
917
918```json managed-settings.json theme={null}
919{
920 "availableModels": ["claude-opus-5", "claude-sonnet-5"],
921 "availableModelsMatch": "exact"
922}
923```
924
925`"exact"` では、リストが少なくとも 1 つのモデルまたはファミリーを名前付けするときはいつでも、Default オプションもリストされたモデルに制限されます。[特定のモデルまたはバージョンをブロック](/docs/ja/model-config#block-specific-models-or-versions)を参照してください。
926
927<h3 id="deniedmodels">
928 `deniedModels`
929</h3>
930
931[`availableModels`](#availablemodels)許可リストの有無にかかわらず、特定のモデルをブロックし、そのリストがそれらを許可する場合でもブロックします。Claude Code はブロックされたモデルを `/model` ピッカーから非表示にし、`availableModels` が強制される場所ではどこでもモデルを選択できません。Default オプションのセッションは、[特定のモデルまたはバージョンをブロック](/docs/ja/model-config#block-specific-models-or-versions)で説明されているように、ブロックされたモデルも実行しません。Claude Code v2.1.283 以降が必要です。
932
933* **スコープ**: [`管理`](#scopes)。Claude Code はユーザー、プロジェクト、ローカル設定および `--settings` のキーを無視し、警告を表示します
934* **タイプ**: モデルエイリアスまたは ID の配列
935 * `"opus"` などのファミリーエイリアスはそのファミリーのすべてのモデルをブロックします
936 * `"claude-opus-5-5"` などのモデル ID は、日付付きおよびプロバイダー固有の ID を含むすべてのスペルでそのバージョンをブロックします
937 * `"claude-opus-5"` などのマイナーバージョンなしのモデル ID は、Opus 5.5 などの後のマイナーバージョンもブロックします。Opus 5 のみをブロックするには `"claude-opus-5-0"` を記述します
938 * `best`、`opusplan`、および `default` エントリは無視されます
939* **デフォルト**: 設定解除されているため、モデルはブロックされません
940
941この例は Opus と Sonnet モデルを許可し、Opus 5.5 をブロックします:
942
943```json managed-settings.json theme={null}
944{
945 "availableModels": ["opus", "sonnet"],
946 "deniedModels": ["claude-opus-5-5"]
947}
948```
949
950[特定のモデルまたはバージョンをブロック](/docs/ja/model-config#block-specific-models-or-versions)を参照してください。
895 951
896<h3 id="effortlevel">952<h3 id="effortlevel">
897 `effortLevel`953 `effortLevel`
898</h3>954</h3>
899 955
900レベルを保存していないモデルのデフォルト[努力レベル](/docs/ja/model-config#adjust-effort-level)を設定します。低いレベルは単純なタスクではより高速で安価であり、高いレベルは複雑な問題でより深く推論します。956保存していないモデルのデフォルト[努力レベル](/docs/ja/model-config#adjust-effort-level)を設定します。低いレベルは単純なタスクではより高速で安価であり、高いレベルは複雑な問題でより深く推論します。
901 957
902マシン上のインタラクティブセッションで `/effort low`、`medium`、`high`、または `xhigh` を実行すると、Claude Code はレベルを [`modelSettings`](#modelsettings)の下のアクティブなモデルに保存するのではなく、このキーに書き込みます。v2.1.251 より前では、`/effort` はこのキーに書き込みました。958マシン上のインタラクティブセッションで `/effort low`、`medium`、`high`、または `xhigh` を実行すると、Claude Code はレベルをファイルを編集するのではなく [`modelSettings`](#modelsettings)の下のアクティブなモデルに保存します。v2.1.251 より前では、`/effort` はこのキーを書き込みました。
903 959
904同じ設定ファイル内では、Claude Code はこのキーではなくモデルの保存されたレベルを使用します。[`modelSettings`](#modelsettings)はクロスファイルの優先順位を示します。960同じ設定ファイル内で、Claude Code はこのキーではなくモデルの保存されたレベルを使用します。[`modelSettings`](#modelsettings)はクロスファイルの優先順位を述べています。
905 961
906リモートワーカーに接続されたセッション、`-p` 実行、および Agent SDK では、`/effort` はそのセッションのみに適用されます。[努力レベルを調整](/docs/ja/model-config#adjust-effort-level)はそのセッションのみに適用される対話的な選択肢も一覧表示します。`/effort` が出力するメッセージは、どちらが発生したかを示します。962リモートワーカーに接続されたセッション、`-p` 実行、および Agent SDK では、`/effort` はそのセッションのみに適用されます。[努力レベルを調整](/docs/ja/model-config#adjust-effort-level)はそのセッションのみに適用されるインタラクティブな選択肢もリストします。`/effort` が出力するメッセージは、どちらが起こったかを示します。
907 963
908* **スコープ**: [`任意のファイル`](#scopes)964* **スコープ**: [`任意のファイル`](#scopes)
909* **タイプ**: 文字列、以下のいずれか:965* **タイプ**: 文字列、以下のいずれか:
910 * `"low"`: 最小限の推論。短く、スコープが限定され、レイテンシに敏感で、知能に敏感ではないタスク用966 * `"low"`: 最小限の推論。短く、スコープが限定され、レイテンシに敏感で、インテリジェンスに敏感ではないタスク用
911 * `"medium"`: コスト敏感な作業の場合、トークン使用量を削減し、知能をトレードオフできます967 * `"medium"`: コスト敏感な作業のトークン使用量を削減します。インテリジェンスをいくらか取引できます
912 * `"high"`: トークン使用量と知能のバランス968 * `"high"`: トークン使用量とインテリジェンスのバランスを取ります
913 * `"xhigh"`: より高いトークン支出でより深い推論969 * `"xhigh"`: より高いトークン支出でより深い推論
914* **デフォルト**: 設定解除されています970* **デフォルト**: 設定解除されています
915* **セッションごとのオーバーライド**: `--effort` はこのキーより優先されます。1 つのセッション、および [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ja/env-vars)は両方より優先されます971* **セッションごとのオーバーライド**: `--effort` はこのキーより優先されます。[`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ja/env-vars)は両方より優先されます
916 972
917```json settings.json theme={null}973```json settings.json theme={null}
918{974{
920}976}
921```977```
922 978
923ユーザー設定ファイル `~/.claude/settings.json` では、このキーは `/effort` が書き込んだ古い形式であり、Opus 5、Fable 5.1、および以前のモデルに対してそれが以前に適用されたところに適用され続けます。Opus 5.5 およびそれ以降にリリースされたモデルはそれを無視し、独自のデフォルトで開始します。これは [`modelSettings`](#modelsettings)の下でレベルを保存するまで続きます。プロジェクト、ローカル、および管理設定、および `--settings` では、このキーはすべてのモデルに適用されます。979ユーザー設定ファイル `~/.claude/settings.json` では、このキーは `/effort` が保存する前の古い形式です。モデルごとにレベルを保存し、以前に適用された場所に適用され続けます。Opus 5、Fable 5.1、および以前のモデルで。Opus 5.5 およびそれ以降にリリースされたモデルはそれを無視し、[`modelSettings`](#modelsettings)の下でレベルを保存するまで独自のデフォルトで開始します。これは `/effort` が書き込みます。プロジェクト、ローカル、管理設定、および `--settings` では、このキーはすべてのモデルに適用されます。
924 980
925<h3 id="enforceavailablemodels">981<h3 id="enforceavailablemodels">
926 `enforceAvailableModels`982 `enforceAvailableModels`
927</h3>983</h3>
928 984
929`/model` ピッカーには、適用される場合は[組織デフォルトモデル](/docs/ja/model-config#organization-default-model)に解決される **Default** オプション、またはそれ以外の場合はアカウントタイプのデフォルトがあります。[`availableModels`](#availablemodels)許可リストはあなたが名前を付けることができるモデルを制限しますが、それ自体では **Default** には影響しないため、**Default** はリスト外のモデルに解決される可能性があります。このキーはそのギャップを埋めます。Claude Code v2.1.175 以降が必要です。985`/model` ピッカーには**Default**オプションがあり、[`default` モデル設定](/docs/ja/model-config#default-model-setting)はそれが解決するモデルを説明します。[`availableModels`](#availablemodels)許可リストは名前を付けることができるモデルを制限しますが、デフォルト[プレフィックスマッチング](#availablemodelsmatch)では、アカウントタイプのデフォルトを再マップしないため、**Default**はリスト外のモデルに解決できます。このキーはそのギャップを閉じます。Claude Code v2.1.175 以降が必要です。
930 986
931組織が管理設定をデプロイすると、Claude Code はこのキーを管理ソースからのみ読み取り、他のファイルでは無視します。987組織が管理設定をデプロイすると、Claude Code はこのキーを管理ソースからのみ読み取り、他のファイルでは無視します。
932 988
933* **スコープ**: [`任意のファイル`](#scopes)989* **スコープ**: [`任意のファイル`](#scopes)
934* **タイプ**: ブール値990* **タイプ**: ブール値
935 * `true`: **Default** が `availableModels` 外のモデルに解決される場合、Claude Code はそれをリスト内の最初の利用可能なモデルに解決します991 * `true`: **Default**が `availableModels` 外のモデルに解決される場合、Claude Code はそれをリスト内の最初の利用可能なモデルに解決します
936 * `false`: **Default** は通常通り解決され、`availableModels` 外のモデルにも解決される可能性があります992 * `false`: このキーは**Default**の解決方法を変更しません
937* **デフォルト**: `false`993* **デフォルト**: `false`
938 994
939この例では、名前付き選択を Sonnet と Haiku モデルに制限し、**Default** をそれらの最初の利用可能なモデルに解決します:995この例は、名前付き選択を Sonnet と Haiku モデルに制限し、**Default**を利用可能なそれらの最初のものに解決します:
940 996
941```json settings.json theme={null}997```json settings.json theme={null}
942{998{
945}1001}
946```1002```
947 1003
948`availableModels` が設定解除されているか空の場合、このキーは効果がありません。[Default モデルの許可リストを強制](/docs/ja/model-config#enforce-the-allowlist-for-the-default-model)を参照してください。Claude Code v2.1.175 以降が必要です。1004このキーは `availableModels` が設定解除されているか空の場合は効果がありません。[Default モデルの許可リストを強制](/docs/ja/model-config#enforce-the-allowlist-for-the-default-model)を参照してください。Claude Code v2.1.175 以降が必要です。
949 1005
950<h3 id="fallbackmodel">1006<h3 id="fallbackmodel">
951 `fallbackModel`1007 `fallbackModel`
952</h3>1008</h3>
953 1009
954プライマリモデルがオーバーロードされているか利用できない場合に、Claude Code が順番に試すバックアップモデルに名前を付けます。Claude Code はターンの残りの間、チェーン内の次の利用可能なモデルに切り替え、通知を表示します。チェーンがない場合、Claude Code は同じモデルを再試行してからサーバーのエラーを表示し、あなたが再試行するか、モデルを自分で切り替えます。1010プライマリモデルがオーバーロードされているか利用できない場合に、Claude Code が順番に試すバックアップモデルに名前を付けます。Claude Code はターンの残りの間、チェーン内の次の利用可能なモデルに切り替え、通知を表示します。チェーンがない場合、Claude Code は同じモデルを再試行してからサーバーのエラーを表示し、再試行するか自分でモデルを切り替えます。
955 1011
956切り替えは、フォールバックモデルで 1 つのターンを意味します。[プロンプトキャッシュ](/docs/ja/prompt-caching#switching-models)は冷たく、次のメッセージはプライマリモデルを最初に再度試します。1012切り替えは、フォールバックモデルでコールド[プロンプトキャッシュ](/docs/ja/prompt-caching#switching-models)を使用した 1 ターンを意味します。次のメッセージはプライマリモデルを最初に再度試します。
957 1013
958* **スコープ**: [`任意のファイル`](#scopes)1014* **スコープ**: [`任意のファイル`](#scopes)
959* **タイプ**: モデルエイリアスまたは ID の配列。`"default"` はデフォルトモデルに展開されます1015* **タイプ**: モデルエイリアスまたは ID の配列。`"default"` はデフォルトモデルに展開されます
960* **デフォルト**: 設定解除されているため、失敗したリクエストは別のモデルで再試行されません1016* **デフォルト**: 設定解除されているため、失敗したリクエストは別のモデルで再試行されません
961* **セッションごとのオーバーライド**: `--fallback-model` はこのキーより優先されます。1 つのセッション1017* **セッションごとのオーバーライド**: `--fallback-model` はこのキーより優先されます
962 1018
963この例では、プライマリモデルが失敗したときに最初に Sonnet 5 を試し、次に Haiku 4.5 を試します:1019この例は、プライマリモデルが失敗したときに最初に Sonnet 5 を試し、次に Haiku 4.5 を試します:
964 1020
965```json settings.json theme={null}1021```json settings.json theme={null}
966{1022{
968}1024}
969```1025```
970 1026
971ほとんどの配列設定とは異なり、このキーは設定ファイル全体でマージされません。最も優先度の高いファイルがそれを定義すると、チェーン全体が供給されます。プロジェクトファイルが `["claude-sonnet-5"]` を設定し、ユーザーファイルが `["claude-haiku-4-5"]` を設定する場合、チェーンは `["claude-sonnet-5"]` のみです。Claude Code はリストから最大 3 つの異なる許可モデルを保持し、残りを無視します。[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)を参照してください。1027ほとんどの配列設定とは異なり、このキーは設定ファイル全体でマージされません。最も優先度の高いファイルがそれを定義すると、チェーン全体が供給されます。プロジェクトファイルが `["claude-sonnet-5"]` を設定し、ユーザーファイルが `["claude-haiku-4-5"]` を設定する場合、チェーンは `["claude-sonnet-5"]` のみです。Claude Code はリストから最大 3 つの異なる許可されたモデルを保持し、残りを無視します。[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)を参照してください。
972 1028
973<h3 id="fastmode">1029<h3 id="fastmode">
974 `fastMode`1030 `fastMode`
975</h3>1031</h3>
976 1032
977利用可能な場合、セッションで[高速モード](/docs/ja/fast-mode)をオンにします。これは、速度をより高いトークンあたりのコストで望む迅速な反復やライブデバッグなどのインタラクティブな作業用です。通常、このキーを手動で編集することはありません。`/fast` を実行すると `fastMode: true` が `~/.claude/settings.json` に書き込まれ、再度実行すると高速モードがオフになります。高速モードは Opus 5.5、Opus 5、および Opus 4.8 でのみ実行されます。別のモデルからオンにすると Opus に切り替わり、サポートされていないモデルに切り替えるとオフになります。[高速モードがオンの場合にモデルを切り替える](/docs/ja/fast-mode#switch-models-while-fast-mode-is-on)を参照してください。1033利用可能なセッションで[高速モード](/docs/ja/fast-mode)をオンにします。高速反復やライブデバッグなどのインタラクティブな作業用で、トークンあたりのコストが高い速度が必要な場合。通常、このキーを手動で編集することはありません。`/fast` を実行すると `fastMode: true` が `~/.claude/settings.json` に書き込まれ、再度実行すると高速モードをオフにするキーが削除されます。高速モードは Opus 5.5、Opus 5、および Opus 4.8 でのみ実行されます。別のモデルからオンにするとあなたを Opus に切り替え、サポートされていないモデルに切り替えるとオフになります。[高速モードがオンの間にモデルを切り替え](/docs/ja/fast-mode#switch-models-while-fast-mode-is-on)を参照してください。
978 1034
979* **スコープ**: [`任意のファイル`](#scopes)1035* **スコープ**: [`任意のファイル`](#scopes)
980* **タイプ**: ブール値1036* **タイプ**: ブール値
993 `fastModePerSessionOptIn`1049 `fastModePerSessionOptIn`
994</h3>1050</h3>
995 1051
996通常、`/fast` を実行すると [`fastMode`](#fastmode)がユーザー設定に保存されるため、高速モードは後のすべてのセッションの開始時にオンになります。このキーを `true` に設定して、それを停止します。保存された `fastMode: true` はセッション開始時に高速モードをオンにしなくなり、各ユーザーは高速モードを望む各セッションで `/fast` を実行する必要があります。Claude Code は `fastMode` キーをファイルに残すため、このキーをオフにすると古い動作が復元されます。1052通常、`/fast` を実行すると [`fastMode`](#fastmode)がユーザー設定に保存されるため、高速モードは後のすべてのセッションの開始時にオンになります。このキーを `true` に設定して、それを停止します。保存された `fastMode: true` はセッション開始時に高速モードをオンにしなくなり、各ユーザーは必要な各セッションで `/fast` を実行する必要があります。Claude Code は `fastMode` キーをファイルに残すため、このキーをオフにすると古い動作が復元されます。
997 1053
998Team または Enterprise プランのオーナーは、[サーバー管理設定](/docs/ja/server-managed-settings)を通じて組織全体にデプロイできます。管理設定がキーを設定すると、`/fast on` はインタラクティブターミナルセッション外で拒否され、組織が高速モードを無効にしたことを報告します。これは[非インタラクティブモード](/docs/ja/headless)、[VS Code 拡張機能](/docs/ja/vs-code)、および[クラウドセッション](/docs/ja/claude-code-on-the-web)をカバーします。1054Team または Enterprise プランのオーナーは、[サーバー管理設定](/docs/ja/server-managed-settings)を通じて組織全体にデプロイできます。管理設定がキーを設定すると、`/fast on` はインタラクティブターミナルセッション外で拒否され、組織が高速モードを無効にしたことを報告します。これは[非インタラクティブモード](/docs/ja/headless)、[VS Code 拡張機能](/docs/ja/vs-code)、および[クラウドセッション](/docs/ja/claude-code-on-the-web)をカバーします。
999 1055
1000* **スコープ**: [`任意のファイル`](#scopes)1056* **スコープ**: [`任意のファイル`](#scopes)
1001* **タイプ**: ブール値1057* **タイプ**: ブール値
1002 * `true`: 保存された `fastMode: true` はセッション開始時に高速モードをオンにしなくなるため、各ユーザーは高速モードを望む各セッションで `/fast` を実行します。`--settings` で渡された `fastMode: true` は、管理設定がこのキーを設定しない限り、そのセッションでもカウントされます1058 * `true`: 保存された `fastMode: true` はセッション開始時に高速モードをオンにしなくなるため、各ユーザーは必要な各セッションで `/fast` を実行します。`--settings` で渡された `fastMode: true` は、管理設定がこのキーを設定しない限り、そのセッションでもカウントされます
1003 * `false`: 保存された `fastMode: true` は後のすべてのセッションの開始時に高速モードをオンにします1059 * `false`: 保存された `fastMode: true` は後のすべてのセッションの開始時に高速モードをオンにします
1004* **デフォルト**: `false`1060* **デフォルト**: `false`
1005 1061
1015 `language`1071 `language`
1016</h3>1072</h3>
1017 1073
1018Claude がデフォルトで英語以外の言語で応答するようにします。応答に固定リストはありません。Claude Code は値を Claude に逐語的に指示として渡し、常にその言語で応答するため、Claude が読める任意の言語名が機能します。Claude Code は値をチェックしないため、スペルが間違った名前は書かれたままエラーを生成するのではなく Claude に到達します。同じ値は[音声ディクテーション](/docs/ja/voice-dictation#change-the-dictation-language)の言語を設定します。これには[サポートされているディクテーション言語](/docs/ja/voice-dictation#change-the-dictation-language)の固定リストがあり、自動生成されたセッションタイトルもあります。1074Claude がデフォルトで英語以外の言語で応答するようにします。応答の固定リストはありません。Claude Code は値を Claude に逐語的に、常にその言語で応答するという指示として渡すため、Claude が読むことができる言語名は機能します。Claude Code は値をチェックしないため、スペルが間違った名前はエラーを生成するのではなく、書かれたとおりに Claude に到達します。同じ値は[音声ディクテーション](/docs/ja/voice-dictation#change-the-dictation-language)の言語を設定します。これは[サポートされているディクテーション言語](/docs/ja/voice-dictation#change-the-dictation-language)の固定リストを持ち、自動生成されたセッションタイトルも設定します。
1019 1075
1020* **スコープ**: [`任意のファイル`](#scopes)1076* **スコープ**: [`任意のファイル`](#scopes)
1021* **タイプ**: 文字列、`"japanese"`、`"spanish"`、`"french"` などの任意の言語名。Claude Code はそれを検証しません1077* **タイプ**: 文字列、`"japanese"`、`"spanish"`、`"french"` などの言語名。Claude Code はそれを検証しません
1022* **デフォルト**: 設定解除されています。セッションタイトルは会話の言語と一致します1078* **デフォルト**: 設定解除されています。セッションタイトルは会話の言語と一致します
1023 1079
1024```json settings.json theme={null}1080```json settings.json theme={null}
1031 `maxEffortLevel`1087 `maxEffortLevel`
1032</h3>1088</h3>
1033 1089
1034セッションが使用できる[努力レベル](/docs/ja/model-config#adjust-effort-level)をキャップし、低いレベルを利用可能なままにします。より高いレベルはキャップで実行されます。これには `/effort`、`/model` ピッカー、`--effort`、[`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ja/env-vars)、スキルまたはサブエージェントの `effort` frontmatter、またはモデル自体のデフォルトからのものが含まれます。Claude Code はキャップを各リクエストの前に自分で適用するため、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry を含むすべてのプロバイダーで保持されます。Claude Code v2.1.267 以降が必要です。1090セッションが使用できる[努力レベル](/docs/ja/model-config#adjust-effort-level)をキャップし、低いレベルを利用可能なままにします。より高いレベルはキャップで実行されます。`/effort`、`/model` ピッカー、`--effort`、[`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ja/env-vars)、スキルまたはサブエージェントの `effort` frontmatter、またはモデル自体のデフォルトから。Claude Code はリクエストの前にキャップ自体を適用するため、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry を含むすべてのプロバイダーで保持されます。Claude Code v2.1.267 以降が必要です。
1035 1091
1036* **スコープ**: [`任意のファイル`](#scopes)。組織に対して強制するために、管理設定にデプロイします。複数のスコープがキャップを設定する場合、最も低いものが適用されるため、1 つのスコープで設定されたキャップを別のスコープから上げることはできません1092* **スコープ**: [`任意のファイル`](#scopes)。組織に対して強制するために、管理設定にデプロイします。複数のスコープがキャップを設定する場合、最も低いものが適用されるため、1 つのスコープで設定されたキャップを別のスコープから上げることはできません
1037* **タイプ**: 文字列、`"low"`、`"medium"`、`"high"`、`"xhigh"`、または `"max"` のいずれか。`"max"` 値はキャップを設定しません1093* **タイプ**: 文字列、`"low"`、`"medium"`、`"high"`、`"xhigh"`、または `"max"` のいずれか。`"max"` 値はキャップを設定しません
1038* **デフォルト**: 設定解除されているため、キャップは適用されません1094* **デフォルト**: 設定解除されているため、キャップは適用されません
1039* **ultracode への影響**: `xhigh` より低いキャップは、キャップが適用されるモデルで[ultracode](#ultracode)を利用できなくします1095* **モデルごとのキャップ**: モデルの [`modelSettings`](#modelsettings)エントリに `maxEffortLevel` を追加します。そのエントリは、ユーザー設定や 1 つの[管理ソース](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)など、両方を設定する設定ソース内でのみこのキーを置き換えます。そこで `"max"` を設定して、そのソースのキャップからモデルを除外します。Claude Code は他のソースからのキャップを依然として適用します
1040* **モデルごとのキャップ**: モデルの [`modelSettings`](#modelsettings)エントリに `maxEffortLevel` を追加します。そのエントリは、ユーザー設定や 1 つの[管理ソース](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)など、両方を設定する設定ソース内でのみ、そのモデルのこのキーを置き換えます。そこで `"max"` を設定して、そのソースのキャップからモデルを除外します。Claude Code は他のソースからのキャップを依然として適用します
1041 1096
1042この例では、すべてのモデルを `medium` でキャップし、Sonnet 4.6 を除外します:1097この例はすべてのモデルを `medium` でキャップし、Sonnet 4.6 を除外します:
1043 1098
1044```json settings.json theme={null}1099```json settings.json theme={null}
1045{1100{
1052}1107}
1053```1108```
1054 1109
1055組織が[努力制限](/docs/ja/model-config#organization-effort-limits)をモデルに対して設定する場合、2 つのキャップの低い方が適用されます。1110組織がモデルの[努力制限](/docs/ja/model-config#organization-effort-limits)も設定する場合、2 つのキャップの低い方が適用されます。
1056 1111
1057<h3 id="model">1112<h3 id="model">
1058 `model`1113 `model`
1059</h3>1114</h3>
1060 1115
1061すべての新しいセッションが使用するモデルを設定して、毎回 `/model` でモデルを選択する必要がないようにします。ここで設定しても、セッション中にモデルを切り替えることはできます。管理者がユーザー選択をオーバーライドするために[組織デフォルトモデル](/docs/ja/model-config#organization-default-model)を設定した場合、ユーザー、プロジェクト、またはローカル設定でこのキーを設定しても、そのモデルが取得されます。1116すべての新しいセッションが使用するモデルを設定するため、毎回 `/model` で 1 つを選択する必要はありません。ここで設定してもセッション中に切り替えることは止まりません。管理者が[組織デフォルトモデル](/docs/ja/model-config#organization-default-model)を設定してユーザー選択をオーバーライドした場合、ユーザー、プロジェクト、またはローカル設定でこのキーを設定しても、そのモデルを取得します。
1062 1117
1063* **スコープ**: [`任意のファイル`](#scopes)1118* **スコープ**: [`任意のファイル`](#scopes)
1064* **タイプ**: 文字列、モデルエイリアスまたは完全なモデル ID1119* **タイプ**: 文字列、モデルエイリアスまたは完全なモデル ID
1065* **デフォルト**: 設定解除されているため、Claude Code はアカウントのデフォルトモデルを使用します1120* **デフォルト**: 設定解除されているため、Claude Code はアカウントのデフォルトモデルを使用します
1066* **セッションごとのオーバーライド**: `--model` は [`ANTHROPIC_MODEL`](/docs/ja/env-vars)より優先され、両方は 1 つのセッションのこのキーより優先されます。管理 `model` を含む。[`availableModels`](#availablemodels)リストは依然として選択に適用されます1121* **セッションごとのオーバーライド**: `--model` は [`ANTHROPIC_MODEL`](/docs/ja/env-vars)より優先され、両方は 1 つのセッションでこのキーより優先されます。管理 `model` を含む。[`availableModels`](#availablemodels)リストは依然として選択に適用されます
1067 1122
1068```json settings.json theme={null}1123```json settings.json theme={null}
1069{1124{
1071}1126}
1072```1127```
1073 1128
1074ここの値は [`ANTHROPIC_DEFAULT_MODEL`](/docs/ja/model-config#set-a-default-model-for-new-sessions)をランク付けし、Claude Code はモデルを選択するものが他にない場合にのみ使用します。1129ここの値は [`ANTHROPIC_DEFAULT_MODEL`](/docs/ja/model-config#set-a-default-model-for-new-sessions)をランク付けし、Claude Code は他に何もモデルを選択しない場合にのみ使用します。
1075 1130
1076<h3 id="modeloverrides">1131<h3 id="modeloverrides">
1077 `modelOverrides`1132 `modelOverrides`
1078</h3>1133</h3>
1079 1134
1080Anthropic モデル ID をプロバイダー固有のモデル ID(Amazon Bedrock 推論プロファイル ARN など)にマップします。各モデルピッカーエントリは、プロバイダー API を呼び出すときにマップされた値を使用します。管理者は[Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry](/docs/ja/model-config#override-model-ids-per-version)でこれを使用して、各モデルバージョンを特定の推論プロファイル、バージョン名、またはデプロイメントにルーティングします。これはガバナンス、コスト配分、または地域ルーティング用です。1135Anthropic モデル ID をプロバイダー固有のモデル ID (Amazon Bedrock 推論プロファイル ARN など)にマップします。各モデルピッカーエントリは、プロバイダー API を呼び出すときにマップされた値を使用します。管理者は[Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry](/docs/ja/model-config#override-model-ids-per-version)でこれを使用して、各モデルバージョンを特定の推論プロファイル、バージョン名、またはガバナンス、コスト配分、または地域ルーティングのためのデプロイメントにルーティングします。
1081 1136
1082* **スコープ**: [`任意のファイル`](#scopes)1137* **スコープ**: [`任意のファイル`](#scopes)
1083* **タイプ**: モデル ID をプロバイダーモデル ID にマップするオブジェクト1138* **タイプ**: モデル ID をプロバイダーモデル ID にマップするオブジェクト
1084* **デフォルト**: 設定解除されています1139* **デフォルト**: 設定解除されています
1085 1140
1086この例では、Opus 4.6 のすべての呼び出しを名前付き Bedrock 推論プロファイルにルーティングします:1141この例は、Opus 4.6 のすべての呼び出しを名前付き Bedrock 推論プロファイルにルーティングします:
1087 1142
1088```json settings.json theme={null}1143```json settings.json theme={null}
1089{1144{
1099 `modelPicker`1154 `modelPicker`
1100</h3>1155</h3>
1101 1156
1102`/model` ピッカーが提供するモデルを、書き込む順序で、選択するラベルの下にリストします。これにより、ピッカーは組織が実行するモデルを、組み込みラインアップの後または代わりにリストします。各行の `model` は逐語的に取得されるため、`--model` が受け入れるもの(`opus` などのエイリアス、Anthropic モデル ID、または Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または LLM ゲートウェイのプロバイダー形式 ID)を受け入れます。Claude Code v2.1.242 以降が必要です。1157`/model` ピッカーが提供するモデルを、書き込む順序で、選択するラベルの下にリストします。ピッカーは組織が実行するモデルをリストします。組み込みラインアップの後または代わりに。各行の `model` は逐語的に取得されるため、`--model` が受け入れるもの、`opus` などのエイリアス、Anthropic モデル ID、または Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または LLM ゲートウェイのプロバイダー形式 ID を受け入れます。Claude Code v2.1.242 以降が必要です。
1103 1158
1104* **スコープ**: [`ユーザーまたは管理`](#scopes)。Claude Code は管理設定、`--settings`、およびユーザー設定からキーを読み取り、プロジェクトおよびローカル設定では無視します。クローンするリポジトリはピッカーをリラベルできません。これら 3 つの最も優先度の高いものがキーを設定すると、ラインアップ全体が供給され、Claude Code は 2 つのソースからラインアップをマージすることはありません。1159* **スコープ**: [`ユーザーまたは管理`](#scopes)。Claude Code は管理設定、`--settings`、およびユーザー設定からキーを読み取り、プロジェクトおよびローカル設定では無視するため、クローンするリポジトリはピッカーを再ラベルできません。これら 3 つの最も高いものがキーを設定すると、ラインアップ全体が供給され、Claude Code は 2 つのソースからラインアップをマージしません。
1105* **タイプ**: `options` 配列と行を持つオブジェクト、およびオプションの `replaceBuiltInOptions` ブール値1160* **タイプ**: `options` 配列と行とオプションの `replaceBuiltInOptions` ブール値を持つオブジェクト
1106* **デフォルト**: 設定解除されているため、ピッカーは組み込みラインアップを表示します1161* **デフォルト**: 設定解除されているため、ピッカーは組み込みラインアップを表示します
1107 1162
1108この例では、2 つの Bedrock デプロイメントを組み込みラインアップの後に追加し、チームが認識する名前の下に:1163この例は、組み込みラインアップの後に 2 つの Bedrock デプロイメントを追加し、チームが認識する名前の下に:
1109 1164
1110```json managed-settings.json theme={null}1165```json managed-settings.json theme={null}
1111{1166{
1134 1189
1135| フィールド | タイプ | 動作 |1190| フィールド | タイプ | 動作 |
1136| :- | :- | :- |1191| :- | :- | :- |
1137| `options` | 各行に必須の `model` とオプションの `label` および `description` を持つ行の配列 | ピッカーが表示する行。この順序で。ただし、グレーアウトされた行は下部に移動します。`label` がない場合、Claude Code は既知のモデルの組み込み名でタイトルを付けるか、モデル ID でそれ以外の場合。`description` がない場合、汎用の 2 行目を書き込みます |1192| `options` | 必須の `model` とオプションの `label`、`description`、および `behavesAs` を持つ行の配列 | ピッカーが表示する行。この順序で。グレーアウトされた行は下部に移動します。`label` がない場合、Claude Code は既知のモデルの組み込み名でタイトルを付けるか、モデル ID でタイトルを付けます。`description` がない場合は、一般的な 2 行目を書き込みます |
1138| `replaceBuiltInOptions` | ブール値、デフォルト `false` | これらの行のみ、**Default**、およびセッションが既に使用しているモデルの行を表示するには `true` に設定します。組み込みラインアップの後にこれらの行を追加するには、設定解除のままにします |1193| `replaceBuiltInOptions` | ブール値、デフォルト `false` | これらの行のみ、**Default**、およびセッションが既に使用しているモデルの行を表示するには `true` に設定します。これらの行を組み込みラインアップの後に追加するには、設定解除のままにします |
1194
1195`options` のエントリは、その `model` の横にオプションの `behavesAs` 文字列を持つこともできます。これには v2.1.257 以降が必要です。Claude Code バージョンが既に知っている `claude-opus-4-8` などのモデルの ID に設定します。`model` が バージョンより新しいエントリで。Claude Code はそれ以降、既知のモデルの機能と努力デフォルトをエントリに適用し、そのモデルを不明として扱いません。エントリのラベルと Claude Code がリクエストで送信するモデル ID は変わりません。
1139 1196
1140`replaceBuiltInOptions` がオンの場合、Claude Code はすべての他の行を非表示にします。組み込みラインアップ、[`availableModels`](#availablemodels)エントリ用に追加する行、[ゲートウェイディスカバリー](/docs/ja/llm-gateway-protocol#model-discovery)が見つけたモデル、および [`ANTHROPIC_CUSTOM_MODEL_OPTION`](/docs/ja/model-config#add-a-custom-model-option)。オフの場合、Claude Code は組み込みラインアップが既にカバーしているリストされたモデルをスキップします。ラベルはピッカーが表示するものを変更し、Claude Code が実行するモデルではありません。1197`replaceBuiltInOptions` がオンの場合、Claude Code はすべての他の行を非表示にします。組み込みラインアップ、[`availableModels`](#availablemodels)エントリ用に追加する行、[ゲートウェイディスカバリー](/docs/ja/llm-gateway-protocol#model-discovery)が見つけたモデル、および [`ANTHROPIC_CUSTOM_MODEL_OPTION`](/docs/ja/model-config#add-a-custom-model-option)。オフの場合、Claude Code は組み込みラインアップが既にカバーするリストされたモデルをスキップします。ラベルはピッカーが表示するものを変更し、Claude Code が実行するモデルではありません。
1141 1198
1142[`availableModels`](#availablemodels)許可リストは依然としてこれらの行に適用されます。リストされたモデルを許可リストに追加する前に、[マージ動作](/docs/ja/model-config#merge-behavior)を読んでください。特定のモデル ID はそのファミリーのワイルドカード エントリを絞り込みます。Claude Code はピッカーを表示する前に各行をセッションに対してチェックします:1199[`availableModels`](#availablemodels)許可リストはこれらの行に依然として適用されます。リストされたモデルを許可リストに追加する前に、[マージ動作](/docs/ja/model-config#merge-behavior)を読んでください。特定のモデル ID はそのファミリーのワイルドカード エントリを絞ります。Claude Code はピッカーを表示する前に各行をセッションに対してチェックします:
1143 1200
1144* **削除**: Claude Code が提供できない行。廃止されたモデルや、組織がアクセスできないモデルなど1201* **削除**: Claude Code が提供できない行。廃止されたモデルや組織がアクセスできないモデルなど
1145* **グレーアウト**: まだ選択できない行。理由とともに表示されます1202* **グレーアウト**: まだ選択できない行。理由を示して表示されます
1146* **行が生き残らない**: Claude Code は組み込みラインアップを保持し、通常どおり許可リストでフィルタリングされます1203* **行が生き残らない**: Claude Code は通常どおり許可リストでフィルタリングされた組み込みラインアップを保持します
1147 1204
1148Claude Code は解析できない行を削除し、残りを保持します。[壊れた設定ファイルを修正](/docs/ja/settings#fix-a-broken-settings-file)を参照してください。1205Claude Code は解析できない行を削除し、残りを保持します。[壊れた設定ファイルを修正](/docs/ja/settings#fix-a-broken-settings-file)を参照してください。
1149 1206
1151 `modelPricing`1208 `modelPricing`
1152</h3>1209</h3>
1153 1210
1154組織が支払うレートでリスト価格の代わりに支出を報告します。組織が契約レートを持っている場合、これを設定して、開発者が見るドル数字が請求書と一致するようにします。Claude Code は `/usage`、[ステータスライン](/docs/ja/statusline)、Agent SDK の `total_cost_usd`、[`--max-budget-usd`](/docs/ja/cli-reference)制限、および[OpenTelemetry](/docs/ja/monitoring-usage)コストメトリックとイベントでレートを適用します。レートを提供します。Claude Code は契約またはClaude Console から読み取りません。Claude Code v2.1.242 以降が必要です。1211組織が支払うレートでリスト価格の代わりに支出を報告します。組織が契約レートを持っている場合に設定するため、開発者が見るドル数字は請求書と一致します。Claude Code は `/usage`、[ステータスライン](/docs/ja/statusline)、Agent SDK の `total_cost_usd`、[`--max-budget-usd`](/docs/ja/cli-reference)制限、および[OpenTelemetry](/docs/ja/monitoring-usage)コストメトリックとイベントのレートを適用します。レートを供給します。Claude Code は契約またはClaude Console から読み取りません。Claude Code v2.1.242 以降が必要です。
1155 1212
1156* **スコープ**: [`管理`](#scopes)。サーバー管理設定、MDM ポリシー、`managed-settings.json` ファイル、または[ポリシーヘルパー](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)を通じてキーをデプロイします。Claude Code はユーザー、プロジェクト、およびローカル設定、`--settings`、および Windows のユーザー書き込み可能な[HKCU レジストリ](/docs/ja/managed-settings#where-each-mechanism-stores-the-policy)では無視します。サーバー管理設定では、各セッションはそのセッションの[設定フェッチ](/docs/ja/server-managed-settings#fetch-and-caching-behavior)が設定を確認するまでリスト価格でコストを報告します。Claude Code を埋め込み、[`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ja/env-vars)を設定するホストアプリケーションは、SDK [`managedSettings`](/docs/ja/agent-sdk/typescript#options)オプションを通じて独自のテーブルを提供できます。Claude Code はキーを設定する管理ソースがなく、Claude Code v2.1.246 以降の場合にのみ使用します。1213* **スコープ**: [`管理`](#scopes)。サーバー管理設定、MDM ポリシー、`managed-settings.json` ファイル、または[ポリシーヘルパー](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)を通じてキーをデプロイします。Claude Code はユーザー、プロジェクト、ローカル設定、`--settings`、および Windows のユーザー書き込み可能な[HKCU レジストリ](/docs/ja/managed-settings#where-each-mechanism-stores-the-policy)では無視します。サーバー管理設定では、各セッションはそのセッションの[設定フェッチ](/docs/ja/server-managed-settings#fetch-and-caching-behavior)が設定を確認するまでリスト価格でコストを報告します。Claude Code を埋め込み、[`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ja/env-vars)を設定するホストアプリケーションは、SDK [`managedSettings`](/docs/ja/agent-sdk/typescript#options)オプションを通じて独自のテーブルを供給でき、Claude Code はマネージドソースがキーを設定しない場合にのみ使用し、Claude Code v2.1.246 以降でのみ使用します。
1157* **タイプ**: オプションの `multiplier` とオプションの `overrides` マップを持つオブジェクト1214* **タイプ**: オプションの `multiplier` とオプションの `overrides` マップを持つオブジェクト
1158* **デフォルト**: 設定解除されているため、Claude Code はホストアプリケーションがテーブルを提供しない限りリスト価格を報告します1215* **デフォルト**: 設定解除されているため、Claude Code はリスト価格を報告します。ホストアプリケーションがテーブルを供給しない限り
1159 1216
1160`multiplier` のみを設定して定額割引またはマークアップ、`overrides` のみをモデルごとのレート、または両方を設定します。1217`multiplier` のみを設定して定額割引またはマークアップ、`overrides` のみをモデルごとのレート、または両方を設定します。
1161 1218
1162この例では、Sonnet 4.6 の契約レートを設定し、すべての数字(Sonnet 行を含む)を 15% 削減します:1219この例は Sonnet 4.6 の契約レートを設定し、すべての数字を 15% 削減します。Sonnet 行を含む:
1163 1220
1164```json managed-settings.json theme={null}1221```json managed-settings.json theme={null}
1165{1222{
1177}1234}
1178```1235```
1179 1236
1180すべての数字をマークアップするには `multiplier` を 1 より上、最大 10 に設定します。マークアップには Claude Code v2.1.271 以降が必要です。以前のバージョンは警告付きで 1 より上の `multiplier` を無視し、設定の残りを保持します。12371 より上、最大 10 までマークアップするには `multiplier` を設定します。マークアップには Claude Code v2.1.271 以降が必要です。以前のバージョンは警告付きで 1 より上の `multiplier` を無視し、設定の残りを保持します。
1181 1238
1182手順(レートが有効であることを確認する方法を含む)については、[契約レートで支出を報告](/docs/ja/costs#report-spend-at-your-contracted-rates)を参照してください。1239手順を含む、レートが有効であることを確認する方法については、[契約レートで支出を報告](/docs/ja/costs#report-spend-at-your-contracted-rates)を参照してください。
1183 1240
1184<span id="modelpricing-multiplier" />1241<span id="modelpricing-multiplier" />
1185 1242
1192| フィールド | タイプ | 動作 |1249| フィールド | タイプ | 動作 |
1193| :- | :- | :- |1250| :- | :- | :- |
1194| `multiplier` | 0 より大きく最大 10 の数値 | Claude Code が計算するすべてのコストをスケーリングします。`overrides` 行がカバーするかどうかに関わらず。1 未満は割引、1 より上はマークアップです |1251| `multiplier` | 0 より大きく最大 10 の数値 | Claude Code が計算するすべてのコストをスケーリングします。`overrides` 行がカバーするかどうかに関わらず。1 未満は割引、1 より上はマークアップです |
1195| `overrides` | モデル ID を `input`、`output`、`cacheRead`、`cacheWrite` を持つレートオブジェクトにマップします。各 0 から 10000 | そのモデルの USD-per-million-token レート。すべて 4 つ必須。`cacheWrite` は 5 分と 1 時間のキャッシュ書き込みの両方をカバーします。[どのモデルが行に適用されるか](#which-models-a-modelpricing-row-applies-to)を参照してください |1252| `overrides` | モデル ID をそれぞれ 0 から 10000 の `input`、`output`、`cacheRead`、および `cacheWrite` を持つレートオブジェクトにマップします | そのモデルの USD-per-million-token レート。すべて 4 つが必要です。`cacheWrite` は 5 分と 1 時間のキャッシュ書き込みの両方をカバーします。[どのモデルが行に適用されるか](#which-models-a-modelpricing-row-applies-to)を参照してください |
1196 1253
1197Claude Code は行のレートを書き込んだとおりに使用し、高速モードサージまたは[US のみの推論レート](https://platform.claude.com/docs/en/about-claude/pricing)を追加しません。`multiplier` も設定する場合、Claude Code はそれを行のレートの上に適用します。Claude Code は解析できないレート、または解析できない `multiplier` を持つ行を削除し、残りを保持します。[壊れた設定ファイルを修正](/docs/ja/settings#fix-a-broken-settings-file)を参照してください。1254Claude Code はレートを書き込んだとおりに使用し、高速モード割増料金または[US のみの推論レート](https://platform.claude.com/docs/en/about-claude/pricing)を追加しません。`multiplier` も設定する場合、Claude Code はそれを行のレートの上に適用します。Claude Code は解析できないレートを持つ行、または解析できない `multiplier` を削除し、残りを保持します。[壊れた設定ファイルを修正](/docs/ja/settings#fix-a-broken-settings-file)を参照してください。
1198 1255
1199<h4 id="which-models-a-modelpricing-row-applies-to">1256<h4 id="which-models-a-modelpricing-row-applies-to">
1200 `modelPricing` 行が適用されるモデル1257 どのモデルが `modelPricing` 行に適用されるか
1201</h4>1258</h4>
1202 1259
1203Claude Code は行のキーから行が適用されるモデルを決定します:1260Claude Code は行のキーから行が適用されるモデルを決定します:
1204 1261
1205* **組み込みモデルの ID**: Claude Code 自体がモデルに使用するキー。そのキーがモデル自体の ID(`claude-sonnet-4-6` など)であるか、Bedrock、Agent Platform、または Foundry ID であるかに関わらず。Claude Code はそのモデルのすべての日付スナップショット ID とプロバイダー固有の ID に行を適用します。1262* **組み込みモデルの ID**: Claude Code 自体がモデルの独自の ID (例: `claude-sonnet-4-6`) またはその Bedrock、Agent Platform、または Foundry ID であるかどうかに関わらず、組み込みモデルに使用するキー。Claude Code はそのモデルのすべての日付スナップショット ID とプロバイダー固有の ID に行を適用します。
1206* **その他のキー**: 組み込みモデルの ID ではないキー。ゲートウェイモデルエイリアスなど。Claude Code はそのキーのみに行を適用します。モデル ID がキーの 1 つと正確に一致し、組み込みモデルの ID でキーされた行の下にも該当する場合、Claude Code は正確な一致を使用します。1263* **その他のキー**: 組み込みモデルの ID ではないキー。ゲートウェイモデルエイリアスなど。Claude Code はそのキーのみに行を適用します。モデル ID がキーの 1 つと正確に一致し、組み込みモデルの ID でキーされた行の下にも該当する場合、Claude Code は正確な一致を使用します。
1207* **Bedrock アプリケーション推論プロファイル**: Claude Code がプロファイルをルーティング先のモデルに解決した後。[`modelOverrides`](#modeloverrides)マップまたは[`bedrock:GetInferenceProfile` ルックアップ](/docs/ja/amazon-bedrock#iam-configuration)を通じて、Claude Code はそのモデルの行をプロファイルに適用します。1264* **Bedrock アプリケーション推論プロファイル**: Claude Code がプロファイルを [`modelOverrides`](#modeloverrides)マップまたは [`bedrock:GetInferenceProfile` ルックアップ](/docs/ja/amazon-bedrock#iam-configuration)を通じてルーティングするモデルに解決した後、Claude Code はそのモデルの行をプロファイルに適用します。
1208 1265
1209<h3 id="modelsettings">1266<h3 id="modelsettings">
1210 `modelSettings`1267 `modelSettings`
1212 1269
1213使用する各モデルの[努力レベル](/docs/ja/model-config#adjust-effort-level)を保存します。Claude Code v2.1.251 以降が必要です。1270使用する各モデルの[努力レベル](/docs/ja/model-config#adjust-effort-level)を保存します。Claude Code v2.1.251 以降が必要です。
1214 1271
1215マシン上のインタラクティブセッションで、`/effort` または `/model` ピッカーの努力スライダーで `low`、`medium`、`high`、または `xhigh` をデフォルトとして保存すると、Claude Code はそのレベルを使用しているモデルの下にここに書き込みます。通常、このキーを自分で編集することはありません。[VS Code 拡張機能のモデルピッカー](/docs/ja/vs-code#use-the-prompt-box)でこれらのレベルの 1 つを選択すると、Claude Code は同じ方法でここに保存します。[`effortLevel`](#effortlevel)エントリは `/effort` がそのセッションのみに適用されるセッションをリストします。1272マシン上のインタラクティブセッションで、`/effort` または `/model` ピッカーの努力スライダーで `low`、`medium`、`high`、または `xhigh` をデフォルトとして保存すると、Claude Code はそれを使用しているモデルの下にここにそのレベルを書き込むため、このキーを自分で編集することはめったにありません。[VS Code 拡張機能のモデルピッカー](/docs/ja/vs-code#use-the-prompt-box)でこれらのレベルのいずれかを選択すると、Claude Code は同じ方法でここに保存します。[`effortLevel`](#effortlevel)エントリは `/effort` がそのセッションのみに適用されるセッションをリストします。
1216 1273
1217キーを手動で編集して、保存したレベルを変更または削除します。1274レベルを変更または削除するには、キーを手動で編集します。
1218 1275
1219ここのモデルの `effortLevel` は、同じ設定ファイルのトップレベル [`effortLevel`](#effortlevel)より優先されます。ファイル全体では、Claude Code は各モデルを個別に解決します。そのモデルの `effortLevel` またはそのモデルに[適用される](#effortlevel)トップレベル `effortLevel` を設定する最も優先度の高い[設定ファイル](/docs/ja/settings#settings-precedence)が決定するため、管理設定の `effortLevel` はユーザー設定で保存したレベルをランク付けします。[努力レベルを調整](/docs/ja/model-config#adjust-effort-level)は、`--effort` 起動時など、保存されたレベルをオーバーライドできるものをリストします。1276このモデルの `effortLevel` ここは同じ設定ファイルの最上位 [`effortLevel`](#effortlevel)より優先されます。ファイル全体で、Claude Code は各モデルを個別に解決します。そのモデルの `effortLevel` または[そのモデルに適用される](/docs/ja/model-config#adjust-effort-level)最上位 `effortLevel` のいずれかを設定する最も優先度の高い[設定ファイル](/docs/ja/settings#settings-precedence)が決定するため、管理設定の `effortLevel` はユーザー設定で保存されたレベルをランク付けします。[努力レベルを調整](/docs/ja/model-config#adjust-effort-level)は、`--effort` 起動など、保存されたレベルをオーバーライドできるその他のものをリストします。
1220 1277
12211 つのモデルの努力をキャップするのではなく、そのモデルのエントリに [`maxEffortLevel`](#maxeffortlevel)フィールドを追加します。フィールドには Claude Code v2.1.267 以降が必要です。12781 つのモデルの努力をキャップするのではなく、そのモデルのエントリに [`maxEffortLevel`](#maxeffortlevel)フィールドを追加します。フィールドには Claude Code v2.1.267 以降が必要です。
1222 1279
1223* **スコープ**: [`任意のファイル`](#scopes)1280* **スコープ**: [`任意のファイル`](#scopes)
1224* **タイプ**: モデル名を `effortLevel` フィールド(`"low"`、`"medium"`、`"high"`、または `"xhigh"` のいずれか)、[`maxEffortLevel`](#maxeffortlevel)フィールド、またはその両方を持つオブジェクトにマップするオブジェクト1281* **タイプ**: モデル名を `effortLevel` フィールド (1 つの `"low"`、`"medium"`、`"high"`、または `"xhigh"`)、[`maxEffortLevel`](#maxeffortlevel)フィールド、またはその両方を持つオブジェクトにマップするオブジェクト
1225* **デフォルト**: 設定解除されています1282* **デフォルト**: 設定解除されています
1226 1283
1227Claude Code は各エントリを `claude-opus-5-5` などのモデルの正規名の下に書き込み、そのモデルのエイリアス、日付サフィックス、`[1m]`、および認識されたプロバイダー固有の ID を同じエントリと一致させます。1284Claude Code は各エントリを `claude-opus-5-5` などのモデルの正規名の下に書き込み、そのモデルのエイリアス、日付サフィックス、`[1m]`、および認識されたプロバイダー固有の ID を同じエントリと一致させます。
1228 1285
1229この例では、Opus 5.5 を `high` に保持しながら、他のモデルは独自の保存またはデフォルトレベルを使用します:1286この例は Opus 5.5 を `high` に保ちながら、他のモデルは独自の保存またはデフォルトレベルを使用します:
1230 1287
1231```json settings.json theme={null}1288```json settings.json theme={null}
1232{1289{
1238}1295}
1239```1296```
1240 1297
1241`/effort auto` を実行して、使用しているモデルの保存されたレベルをクリアします。Claude Code は他のエントリとトップレベルの `effortLevel` をそのままにします。1298`/effort auto` を実行して、使用しているモデルの保存されたレベルをクリアします。Claude Code は他のエントリと最上位の `effortLevel` をそのままにします。
1242 1299
1243<h3 id="outputstyle">1300<h3 id="outputstyle">
1244 `outputStyle`1301 `outputStyle`
1245</h3>1302</h3>
1246 1303
1247[出力スタイル](/docs/ja/output-styles)を名前で選択します。出力スタイルは、Claude の役割、トーン、出力形式を変更する保存された指示セットです。組み込みの Explanatory および Learning スタイルや、自分で書いたものなど。1304[出力スタイル](/docs/ja/output-styles)を名前で選択します。出力スタイルは、Claude の役割、トーン、出力形式を変更する保存された指示のセットです。組み込みの Explanatory および Learning スタイルや自分で書いたものなど。
1248 1305
1249セッション中にこのキーを変更すると、Claude は次のメッセージから新しいスタイルを使用します。そのメッセージがプロンプトキャッシングでコストするものについては、[出力スタイルを変更](/docs/ja/prompt-caching#changing-output-style)を参照してください。v2.1.251 より前では、編集は `/clear` を実行した後またはセッションを開始した後にのみ適用されました。1306セッション中にこのキーを変更すると、Claude は次のメッセージから新しいスタイルを使用します。そのメッセージがプロンプトキャッシュでコストするものについては、[出力スタイルを変更](/docs/ja/prompt-caching#changing-output-style)を参照してください。v2.1.251 より前では、編集は `/clear` を実行した後またはセッションを開始した後にのみ適用されました。
1250 1307
1251* **スコープ**: [`任意のファイル`](#scopes)1308* **スコープ**: [`任意のファイル`](#scopes)
1252* **タイプ**: 文字列。[組み込み](/docs/ja/output-styles#built-in-output-styles)または[カスタム](/docs/ja/output-styles#create-a-custom-output-style)出力スタイルの名前1309* **タイプ**: 文字列。[組み込み](/docs/ja/output-styles#built-in-output-styles)または[カスタム](/docs/ja/output-styles#create-a-custom-output-style)出力スタイルの名前
1253* **デフォルト**: 設定解除されているため、Claude Code はデフォルトスタイルを使用します1310* **デフォルト**: 設定解除されているため、Claude Code はデフォルトスタイルを使用します
1254 1311
1255この例では、組み込みの Explanatory スタイルを選択します。これはタスク間に教育的な洞察を追加します:1312この例は、タスク間に教育的な洞察を追加する組み込みの Explanatory スタイルを選択します:
1256 1313
1257```json settings.json theme={null}1314```json settings.json theme={null}
1258{1315{
1270* **タイプ**: 文字列、以下のいずれか:1327* **タイプ**: 文字列、以下のいずれか:
1271 * `"5m"`: キャッシュは 5 分間保持されます1328 * `"5m"`: キャッシュは 5 分間保持されます
1272 * `"1h"`: キャッシュは 1 時間保持されます1329 * `"1h"`: キャッシュは 1 時間保持されます
1273* **デフォルト**: 設定解除されているため、各メイン会話リクエストは[デフォルトライフタイム](/docs/ja/prompt-caching#which-ttl-each-request-gets)を取得します1330* **デフォルト**: 設定解除されているため、各メイン会話リクエストは[そのデフォルトライフタイム](/docs/ja/prompt-caching#which-ttl-each-request-gets)を取得します
1274* **セッションごとのオーバーライド**: [`FORCE_PROMPT_CACHING_5M`](/docs/ja/env-vars)はすべてより優先されます。次に[`CLAUDE_CODE_PROMPT_CACHE_TTL`](/docs/ja/env-vars)、次にこのキー、最後に[`ENABLE_PROMPT_CACHING_1H`](/docs/ja/env-vars)1331* **セッションごとのオーバーライド**: [`FORCE_PROMPT_CACHING_5M`](/docs/ja/env-vars)はすべてを優先し、次に [`CLAUDE_CODE_PROMPT_CACHE_TTL`](/docs/ja/env-vars)、次にこのキー、最後に [`ENABLE_PROMPT_CACHING_1H`](/docs/ja/env-vars)
1275 1332
1276この例では、メイン会話を 1 時間のライフタイムに保持し、サブエージェントを 5 分のままにします:1333この例はメイン会話を 1 時間のライフタイムに保ち、サブエージェントを 5 分のままにします:
1277 1334
1278```json settings.json theme={null}1335```json settings.json theme={null}
1279{1336{
1288 `showThinkingSummaries`1345 `showThinkingSummaries`
1289</h3>1346</h3>
1290 1347
1291インタラクティブセッションで Claude の[拡張思考](/docs/ja/model-config#extended-thinking)の概要を参照してください。`Ctrl+O` で思考を展開するときに完全な概要を表示したい場合は、それを設定します。設定解除または `false` の場合、Anthropic API は思考ブロックを編集し、Claude Code は折りたたまれたスタブを表示します。サードパーティプロバイダーは編集しません。1348インタラクティブセッションで Claude の[拡張思考](/docs/ja/model-config#extended-thinking)の概要を参照してください。`Ctrl+O` で思考を展開するときに完全な概要が必要な場合に設定します。設定解除または `false` の場合、Anthropic API は思考ブロックを編集し、Claude Code は折りたたまれたスタブを表示します。サードパーティプロバイダーは編集しません。
1292 1349
1293* **スコープ**: [`任意のファイル`](#scopes)1350* **スコープ**: [`任意のファイル`](#scopes)
1294* **タイプ**: ブール値1351* **タイプ**: ブール値
1302}1359}
1303```1360```
1304 1361
1305編集は、モデルが生成するものではなく、表示するものだけを変更します。思考支出を削減するには、代わりに[予算を下げるか思考を無効にする](/docs/ja/model-config#extended-thinking)してください。1362編集は、モデルが生成するものではなく、表示するものだけを変更します。思考支出を削減するには、代わりに[予算を低下させるか思考を無効にします](/docs/ja/model-config#extended-thinking)。
1306 1363
1307<h3 id="subagentpromptcachettl">1364<h3 id="subagentpromptcachettl">
1308 `subagentPromptCacheTtl`1365 `subagentPromptCacheTtl`
1309</h3>1366</h3>
1310 1367
1311[プロンプトキャッシュ](/docs/ja/prompt-caching)がメイン会話外で Claude Code が行うリクエストを保持する期間を選択します。このキーは[サブエージェント](/docs/ja/sub-agents)、[ワークフロー](/docs/ja/workflows)、および Claude Code 独自のバックグラウンドおよびヘルパーリクエスト(圧縮やセッションタイトルなど)に適用されます。1 時間のライフタイムはより長い休憩全体でキャッシュを温かく保ち、API は[各キャッシュ書き込みを 5 分のライフタイムより高いレートで請求します](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing)。Claude Code v2.1.242 以降が必要です。1368[プロンプトキャッシュ](/docs/ja/prompt-caching)がメイン会話外で Claude Code が行うリクエストを保持する期間を選択します。このキーは[サブエージェント](/docs/ja/sub-agents)、[ワークフロー](/docs/ja/workflows)、および Claude Code 独自のバックグラウンドおよびヘルパーリクエスト (圧縮やセッションタイトルなど)に適用されます。1 時間のライフタイムはより長い休憩全体でキャッシュを温かく保ち、API は[各キャッシュ書き込みを 5 分のライフタイムより高いレートで請求します](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing)。Claude Code v2.1.242 以降が必要です。
1312 1369
1313* **スコープ**: [`任意のファイル`](#scopes)1370* **スコープ**: [`任意のファイル`](#scopes)
1314* **タイプ**: 文字列、以下のいずれか:1371* **タイプ**: 文字列、以下のいずれか:
1315 * `"5m"`: キャッシュは 5 分間保持されます1372 * `"5m"`: キャッシュは 5 分間保持されます
1316 * `"1h"`: キャッシュは 1 時間保持されます1373 * `"1h"`: キャッシュは 1 時間保持されます
1317* **デフォルト**: 設定解除されているため、これらの各リクエストは[デフォルトライフタイム](/docs/ja/prompt-caching#which-ttl-each-request-gets)を取得します1374* **デフォルト**: 設定解除されているため、これらの各リクエストは[そのデフォルトライフタイム](/docs/ja/prompt-caching#which-ttl-each-request-gets)を取得します
1318* **セッションごとのオーバーライド**: [`FORCE_PROMPT_CACHING_5M`](/docs/ja/env-vars)はすべてより優先されます。次に[`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`](/docs/ja/env-vars)、次にこのキー、次に[`ENABLE_PROMPT_CACHING_1H`](/docs/ja/env-vars)。これはすべてのリクエストで 1 時間のライフタイムを要求します。サブエージェント独自の frontmatter 値がランク付けされる場所については、[TTL を自分で選択](/docs/ja/prompt-caching#choose-the-ttl-yourself)を参照してください1375* **セッションごとのオーバーライド**: [`FORCE_PROMPT_CACHING_5M`](/docs/ja/env-vars)はすべてを優先し、次に [`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`](/docs/ja/env-vars)、次にこのキー、次に [`ENABLE_PROMPT_CACHING_1H`](/docs/ja/env-vars)。サブエージェント独自の frontmatter 値がランク付けされる場所については、[TTL を自分で選択](/docs/ja/prompt-caching#choose-the-ttl-yourself)を参照してください
1319 1376
1320この例では、サブエージェントおよびメイン会話外の他のリクエストに 1 時間のライフタイムを提供します:1377この例はサブエージェントとメイン会話外の他のリクエストに 1 時間のライフタイムを与えます:
1321 1378
1322```json settings.json theme={null}1379```json settings.json theme={null}
1323{1380{
1331 `switchModelsOnFlag`1388 `switchModelsOnFlag`
1332</h3>1389</h3>
1333 1390
1334[安全分類器がリクエストにフラグを立てた](/docs/ja/model-config#automatic-model-fallback)場合に何が起こるかを選択します。フォールバックモデルに切り替えて続行するか、プロンプトを切り替えるか編集するかを選択できるように一時停止します。1391[安全分類器がリクエストにフラグを立てた](/docs/ja/model-config#automatic-model-fallback)場合に何が起こるかを選択します。フォールバックモデルに切り替えて続行するか、切り替えるかプロンプトを編集するかを選択できるように一時停止します。
1335 1392
1336* **スコープ**: [`任意のファイル`](#scopes)。`/config` に**メッセージがフラグされたときにモデルを切り替える**として表示されます。1393* **スコープ**: [`任意のファイル`](#scopes)。`/config` に**メッセージがフラグされたときにモデルを切り替え**として表示されます。
1337* **タイプ**: ブール値1394* **タイプ**: ブール値
1338 * `true`: Claude Code はフォールバックモデルに切り替えて続行します1395 * `true`: Claude Code はフォールバックモデルに切り替えて続行します
1339 * `false`: インタラクティブセッションでは Claude Code は一時停止して、切り替えるかプロンプトを編集するかを選択できます。ダイアログが表示できない場所(`-p` 実行など)では、フラグされたリクエストはエラーで終了します1396 * `false`: インタラクティブセッションで Claude Code は一時停止して、切り替えるかプロンプトを編集するかを選択できます。ダイアログが表示できない場所 (`-p` 実行など)では、フラグされたリクエストはエラーで終了します
1340* **デフォルト**: `true`。自動的に切り替えます1397* **デフォルト**: `true`。自動的に切り替え
1341 1398
1342```json settings.json theme={null}1399```json settings.json theme={null}
1343{1400{
1351 `ultracode`1408 `ultracode`
1352</h3>1409</h3>
1353 1410
1354セッションを[ultracode](/docs/ja/workflows#let-claude-decide-with-ultracode)でオンで開始します。オンの場合、Claude は、あなたが尋ねるのを待つのではなく、各実質的なタスクのワークフローを計画します。Claude は[動的ワークフロー](/docs/ja/workflows)が有効になっている場合、モデルが `xhigh` 努力をサポートし、`xhigh` より低い[努力キャップ](/docs/ja/model-config#organization-effort-limits)が適用されない場合にのみワークフローを計画します。いずれにせよ、`ultracode: true` はセッションを `xhigh` 努力で実行するか、努力キャップが低い場合はキャップで実行します。Claude Code はこのキーを読み取りますが、決して書き込みません。`/effort ultracode` は現在のセッションのみで ultracode をオンにします。1411セッションを[ultracode](/docs/ja/workflows#let-claude-decide-with-ultracode)でオンで開始します。オンの場合、Claude は、あなたが尋ねるのを待つのではなく、各実質的なタスクのワークフローを計画します。Claude は[動的ワークフロー](/docs/ja/workflows)が有効になっており、モデルが `xhigh` 努力をサポートする場合にのみワークフローを計画します。キーはセッションの努力レベルを変更しません。ultracode はセッションが使用するレベルで実行されます。Claude Code はこのキーを読み取りますが、決して書き込みません。`/effort ultracode` は現在のセッションのみで ultracode をオンにします。
1355 1412
1356* **スコープ**: [`任意のファイル`](#scopes)1413* **スコープ**: [`任意のファイル`](#scopes)
1357* **タイプ**: ブール値1414* **タイプ**: ブール値
1358 * `true`: セッションは `xhigh` 努力で開始され、動的ワークフローが有効になっている場合、モデルが `xhigh` をサポートし、努力キャップが `xhigh` より低くない場合、ultracode はオンになります1415 * `true`: 動的ワークフローが有効になっており、モデルが `xhigh` をサポートする場合、セッションは ultracode でオンで開始されます
1359 * `false`: セッションは ultracode をオフで開始します1416 * `false`: セッションは ultracode でオフで開始されます
1360* **デフォルト**: 設定解除されているため、ultracode はオフです1417* **デフォルト**: 設定解除されているため、ultracode はオフです
1361* **セッションごとのオーバーライド**: `/effort ultracode` はこのキーなしで 1 つのセッションで ultracode をオンにします。`--effort ultracode` フラグもそれを 1 つのセッションでオンにし、Claude Code v2.1.203 以降が必要です1418* **セッションごとのオーバーライド**: `/effort ultracode` はこのキーなしで 1 つのセッションで ultracode をオンにし、`/effort ultracode off` はこのキーが `true` の場合、1 つのセッションでそれをオフにします。`--effort ultracode` フラグも 1 つのセッションでそれをオンにし、`xhigh` 努力で、Claude Code v2.1.203 以降が必要です
1362 1419
1363```json settings.json theme={null}1420```json settings.json theme={null}
1364{1421{
1366}1423}
1367```1424```
1368 1425
1369Ultracode はセッションを `xhigh` 努力で実行し、`effortLevel` および [`modelSettings`](#modelsettings)エントリより優先されます。`xhigh` より低い[努力キャップ](/docs/ja/model-config#organization-effort-limits)([`maxEffortLevel`](#maxeffortlevel)設定など)がモデルに適用される場合、セッションは代わりにキャップで実行され、ultracode はオフのままです。Claude はそれ自体でワークフローを計画せず、`/effort` は `ultracode` を提供しません。Agent SDK `apply_flag_settings` コントロールリクエストもキーを受け入れます。1426セッションの努力レベルは [`effortLevel`](#effortlevel)、[`modelSettings`](#modelsettings)、および他の[努力ソース](/docs/ja/model-config#adjust-effort-level)から来ます。[`maxEffortLevel`](#maxeffortlevel)などの[努力キャップ](/docs/ja/model-config#organization-effort-limits)はそのレベルを低下させますが、ultracode をオフにしません。これと `/effort ultracode off` フォームには Claude Code v2.1.284 以降が必要です。v2.1.284 より前では、`ultracode: true` はセッションを `xhigh` 努力で実行し、`xhigh` より下の努力キャップは ultracode をオフに保ちました。Agent SDK `apply_flag_settings` コントロールリクエストもキーを受け入れます。
1370 1427
1371<h2 id="permission-settings">1428<h2 id="permission-settings">
1372 権限設定1429 権限設定
1489 `useAutoModeDuringPlan`1546 `useAutoModeDuringPlan`
1490</h3>1547</h3>
1491 1548
1492Claude Code がプランモード中にシェルコマンドを確認するために自動モード分類器を使用するかどうかを選択します。デフォルトの `true` では、自動モードが利用可能で、プロンプトが表示されない場合、分類器は計画中に各コマンドを確認します。`false` に設定して、組み込みの読み取り専用セット外のすべてのコマンドに対して権限プロンプトを取得します。`/config` に**プラン中に自動モードを使用**として表示されます。1549Claude Code がプランモード中にシェルコマンドを確認するために自動モード分類器を使用するかどうかを選択します。デフォルトの `true` では、自動モードが利用可能で、プロンプトが表示されない場合、分類器は計画中に各コマンドを確認します。ただし、[重要パスの削除](/docs/ja/permission-modes#critical-paths)を除きます。`false` に設定して、組み込みの読み取り専用セット外のすべてのコマンドに対して権限プロンプトを取得します。`/config` に**プラン中に自動モードを使用**として表示されます。
1493 1550
1494* **スコープ**: [`User, local, or managed`](#scopes)。リポジトリはそれをオフにすることはできません。1551* **スコープ**: [`User, local, or managed`](#scopes)。リポジトリはそれをオフにすることはできません。
1495* **タイプ**: ブール値1552* **タイプ**: ブール値
1496 * `true`: 未設定と同じです。自動モードが利用可能な場合、分類器はプランニング中に各シェルコマンドを確認し、プロンプトを表示しません。これらのファイルのいずれかで `false` でもそれをオフにします1553 * `true`: 未設定と同じです。自動モードが利用可能な場合、分類器はプランニング中に各シェルコマンドを確認し、プロンプトを表示しません。ただし、[重要パスの削除](/docs/ja/permission-modes#critical-paths)を除きます。これらのファイルのいずれかで `false` でもそれをオフにします
1497 * `false`: 組み込みの読み取り専用セット外のすべてのコマンドに対して権限プロンプトを取得します1554 * `false`: 組み込みの読み取り専用セット外のすべてのコマンドに対して権限プロンプトを取得します
1498* **デフォルト**: `true`1555* **デフォルト**: `true`
1499 1556
1617 `permissions.blockReadsOutsideWorkingDirectories`1674 `permissions.blockReadsOutsideWorkingDirectories`
1618</h3>1675</h3>
1619 1676
1620Claude が Read、Grep、Glob、LSP ツールを使用してセッションの[作業ディレクトリ](/docs/ja/permissions#working-directories)外のパスを読み取るのを停止します。`bypassPermissions` を含むすべての権限モード。Claude Code が認識するファイルコマンド(`cat` など)を通じて一致するパスを読み取る Bash コマンドは、自動モードおよび `bypassPermissions` モードでもプロンプトを表示します。Claude Code v2.1.257 以降が必要です。1677Claude のファイルツールがセッションの[作業ディレクトリ](/docs/ja/permissions#working-directories)外のパスを読み取るのを拒否します。`bypassPermissions` を含むすべての権限モード。Claude Code は `Read`、`Grep`、`Glob`、`LSP` 呼び出しをそれらのパスで拒否し、Claude に `/add-dir` でディレクトリを追加するよう求めるよう指示します。Claude Code 自体が必要とするファイル(`~/.claude/` の下のスキル、プラグイン、ルール、エージェント、コマンド、`CLAUDE.md` メモリファイルなど)は読み取り可能なままです。Claude Code v2.1.257 以降が必要です。
1678
1679Claude Code はシェルコマンドを同じ方法で拒否しません。
1680
1681* [モードが自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)は、そのようなパスを読み取るシェルコマンドがいつプロンプトを表示するかをカバーします
1682* [ブロック下のサンドボックス化されたコマンド](#sandboxed-commands-under-the-block)は、サンドボックス化されたコマンドが何を読み取れるかをカバーします
1621 1683
1622シェルパーサーが追跡できない Bash コマンド(複数回ディレクトリを変更するか、サブシェルを実行するなど)は、自動モードおよび `bypassPermissions` モードでもプロンプトを表示します。プロンプトは、コマンドが作業ディレクトリ外のパスを名前で指定しない場合でも表示されます。このプロンプトは、コマンドが[サンドボックス](/docs/ja/sandboxing)で実行され、サンドボックスがブロックを強制する場合には適用されません。1684シェルパーサーが追跡できない Bash コマンド(複数回ディレクトリを変更するか、サブシェルを実行するなど)は、自動モードおよび `bypassPermissions` モードでもプロンプトを表示します。プロンプトは、コマンドが作業ディレクトリ外のパスを名前で指定しない場合でも表示されます。このプロンプトは、コマンドが[サンドボックス](/docs/ja/sandboxing)で実行され、サンドボックスがブロックを強制する場合には適用されません。
1623 1685
1624Claude Code は、[作業ディレクトリ外の最初の読み取り前の自動モードのプロンプト](/docs/ja/permission-modes#first-read-outside-the-working-directories)でそのような読み取りをブロックすることを選択した場合、ここに `true` を書き込みます。1686Claude Code は、[作業ディレクトリ外の最初の読み取り前の自動モードのプロンプト](/docs/ja/permission-modes#first-read-outside-the-working-directories)でそのような読み取りをブロックすることを選択した場合、ここに `true` を書き込みます。
1625 1687
1626* **スコープ**: [`Any file`](#scopes)。任意の設定ソースが `true` を設定する場合、ブロックが適用されるため、リポジトリのチェックイン済みファイルはプロジェクトのブロックをオンにできますが、設定したブロックを解除することはできません。1688* **スコープ**: [`Any file`](#scopes)。任意のファイルが `true` を設定する場合、ブロックが適用されるため、リポジトリはプロジェクトのブロックをオンにできますが、設定したブロックを解除することはできません。
1627* **タイプ**: ブール値1689* **タイプ**: ブール値
1628 * `true`: 作業ディレクトリ外のファイル読み取りがブロックされます1690 * `true`: Claude のファイルツールは作業ディレクトリ外の読み取りを拒否します
1629 * `false`: 未設定と同じです。他の設定ファイルの `true` でもブロックします1691 * `false`: 未設定と同じです。ブロックは別のファイルが `true` を設定する場合でも適用されます
1630* **デフォルト**: 未設定。作業ディレクトリ外の読み取りは権限モードとルールに従います1692* **デフォルト**: 未設定。作業ディレクトリ外の読み取りは[権限モード](/docs/ja/permission-modes)に従います
1631 1693
1632```json settings.json theme={null}1694```json settings.json theme={null}
1633{1695{
1637}1699}
1638```1700```
1639 1701
1640リポジトリのチェックイン済み設定ファイルのみがディレクトリを追加する場合、ブロックはそこでの読み取りに引き続き適用されます。[`autoMemoryDirectory`](#automemorydirectory)がプロジェクトの `.claude/settings.json` から、または[リポジトリ提供として扱われる](/docs/ja/permissions#when-your-local-settings-file-needs-trust)`.claude/settings.local.json` から来る場合、Claude Code はそのディレクトリから[自動メモリ](/docs/ja/memory#storage-location)を読み込まず、そこに保存しません。Claude Code 自体が必要とするファイル(`~/.claude/` の下のスキル、プラグイン、ルール、エージェント、コマンド、`CLAUDE.md` メモリファイルなど)は読み取り可能なままです。1702`--add-dir`、`/add-dir`、またはユーザーまたは管理設定の `additionalDirectories` で追加するディレクトリは、ブロックの作業ディレクトリとしてカウントされます。リポジトリ設定でのみ追加されるディレクトリはカウントされません。`.claude/settings.json` のディレクトリ、および git がファイルを追跡されていないとして報告する場合を除き、`.claude/settings.local.json` のディレクトリ。ディレクトリが git リポジトリではない場合、またはファイルを git が追跡する場合、Claude Code は `.claude/settings.local.json` をリポジトリ提供設定として扱うため、代わりにユーザー設定にディレクトリを配置してください。
1641 1703
1642[サンドボックス](/docs/ja/sandboxing)がオンの場合、ブロックはサンドボックス化されたコマンドに対して、作業ディレクトリ外のホームディレクトリとマウントされたボリュームルートへの読み取りアクセスも拒否します。[サンドボックス外で実行](/docs/ja/sandboxing#the-unsandboxed-retry-escape-hatch)するために承認が必要な再試行は、`bypassPermissions` モードでもプロンプトを表示します。ツールがホームディレクトリから読み取るファイル(`~/.gitconfig` など)は残りと一緒に拒否されます。ツールが必要な場合は、[`sandbox.filesystem.allowRead`](#sandbox-filesystem-allowread)で特定のパスを再度開きます。1704[`autoMemoryDirectory`](#automemorydirectory)がプロジェクトの `.claude/settings.json` から、または[リポジトリ提供として扱われる](/docs/ja/permissions#when-your-local-settings-file-needs-trust)`.claude/settings.local.json` から来る場合、Claude Code はそのディレクトリから[自動メモリ](/docs/ja/memory#storage-location)を読み込まず、そこに保存しません。
1705
1706ブロックを解除するには、それを設定するすべての設定ファイルからキーを削除し、新しいセッションを開始します。
1707
1708<h4 id="sandboxed-commands-under-the-block">
1709 ブロック下のサンドボックス化されたコマンド
1710</h4>
1643 1711
1644セッションの作業ディレクトリが Claude Code がセッション中に入力したリンク済み [git worktree](/docs/ja/worktrees) である場合、リポジトリの共通 `.git` ディレクトリはサンドボックス化されたコマンドに対して読み取り可能および書き込み可能なままなので、git はそこで機能し続けます。1712[サンドボックス](/docs/ja/sandboxing)がオンの場合、ブロックはサンドボックス化されたコマンドにも適用されます。Claude Code はホームディレクトリおよびユーザーファイルを保持する他のルート(`/Users`、`/home`、`/root`、`/Volumes`、`/mnt`、`/media`、`/run/media`、`/srv`)への読み取りアクセスを拒否します。その後、作業ディレクトリ、[worktrees](/docs/ja/worktrees) Claude Code がセッション中に作成するもの、セッション一時ディレクトリ、およびコマンドが必要とする `~/.claude` の部分(スキルやプラグインなど)を再度開きます。ブロックが有効な間、リポジトリ設定からの `allowRead` および `allowWrite` エントリはカウントされません。
1713
1714セッションの作業ディレクトリがリンク済み [git worktree](/docs/ja/worktrees) である場合(Claude Code がセッション中に入力したものを含む)、リポジトリの共通 `.git` ディレクトリはサンドボックス化されたコマンドに対して読み取り可能および書き込み可能なままなので、git はそこで機能し続けます。
1715
1716これらの場合、ブロックはサンドボックス化されたコマンドに到達しませんが、Claude のファイルツールは引き続きそれを強制します。
1717
1718* ファイルシステム分離は [`sandbox.filesystem.disabled`](#sandbox-filesystem-disabled) を通じてオフになっています
1719* [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) が設定されています
1720* Claude Code を開始したディレクトリのパスに `*`、`?`、`[` などのグロブ文字が含まれています
1721
1722ブロック下で、Claude Code はサンドボックス化されたコマンドにグローバル git 設定ファイルを再度開くため、`git` はアイデンティティと設定を保持します。
1723
1724* `~/.gitconfig`
1725* `$XDG_CONFIG_HOME/git` の下の `config`、`ignore`、`attributes` ファイル。デフォルトは `~/.config/git`
1726* グローバル git 設定が `[include]`、`[includeIf]`、`core.excludesFile`、`core.attributesFile` を通じて名前を付けるファイル
1727
1728Claude Code は各ファイルを個別に判断します。ファイルがサンドボックス化されたコマンドが直接または symlink を通じて書き込める場所にある場合、Claude Code はそれが名前を付けるファイルを再度開きません。
1729
1730Linux および WSL2 では、symlink である設定ファイルは独自のパスで読み取り不可のままにすることができ、`git` はそれなしで実行されます。`~/.git-credentials` および `$XDG_CONFIG_HOME/git/credentials` はブロックされたままです。
1731
1732再度開いたファイルがシークレット(`http.extraHeader` トークンなど)を保持する場合、そのパスを [`sandbox.filesystem.denyRead`](#sandbox-filesystem-denyread) に追加します。ファイルをカバーする `denyRead` エントリは常にこの再度開きより優先されます。
1645 1733
1646<h3 id="permissions-defaultmode">1734<h3 id="permissions-defaultmode">
1647 `permissions.defaultMode`1735 `permissions.defaultMode`
1744* **Type**: `enabled`、`failIfUnavailable`、`autoAllowBashIfSandboxed`、`excludedCommands`、`allowUnsandboxedCommands`、`enableWeakerNestedSandbox`、`enableWeakerNetworkIsolation`、`allowAppleEvents`、`bwrapPath`、`socatPath`、`ignoreViolations`、`ripgrep` を含むオブジェクト、および `filesystem`、`network`、`credentials` オブジェクト1832* **Type**: `enabled`、`failIfUnavailable`、`autoAllowBashIfSandboxed`、`excludedCommands`、`allowUnsandboxedCommands`、`enableWeakerNestedSandbox`、`enableWeakerNetworkIsolation`、`allowAppleEvents`、`bwrapPath`、`socatPath`、`ignoreViolations`、`ripgrep` を含むオブジェクト、および `filesystem`、`network`、`credentials` オブジェクト
1745* **Default**: 未設定。Claude Code はサンドボックスなしでコマンドを実行します1833* **Default**: 未設定。Claude Code はサンドボックスなしでコマンドを実行します
1746 1834
1747これはサンドボックスをオンにし、サンドボックス化されたコマンドの権限プロンプトをスキップし、`docker` をサンドボックスの外で実行し、2 つの追加書き込みパスを開き、AWS 認証情報ファイルを非表示にし、GitHub と npm を事前に許可します:1835これはサンドボックスをオンにし、サンドボックス化されたコマンドの権限プロンプトをスキップし、`docker` をサンドボックスの外で実行し、2 つの追加の書き込みパスを開き、AWS 認証情報ファイルを非表示にし、GitHub と npm を事前に許可します:
1748 1836
1749```json settings.json theme={null}1837```json settings.json theme={null}
1750{1838{
1763}1851}
1764```1852```
1765 1853
1766Claude Code はブール値キーの値を最も優先度の高い設定スコープから取得するため、管理対象の `enabled` または `failIfUnavailable` は開発者が設定したものをオーバーライドします。配列キーはセッションが読み込むすべての設定スコープ全体でマージされるため、開発者はエントリを追加できます。管理対象のみのロックについては、[開発者がポリシーを拡大するのを防ぐ](/docs/ja/sandboxing#keep-developers-from-widening-the-policy)を参照してください。組織に対してサンドボックスを必須にするには、[管理設定でサンドボックスを強制する](/docs/ja/sandboxing#enforce-sandboxing-with-managed-settings)を参照してください。1854Claude Code はブール値キーの値を、それを設定する最も優先度の高い設定スコープから取得するため、管理対象の `enabled` または `failIfUnavailable` は開発者が設定したものをオーバーライドします。配列キーはセッションが読み込むすべての設定スコープ全体でマージされるため、開発者はエントリを追加できます。[ポリシーの拡大を開発者に防止させる](/docs/ja/sandboxing#keep-developers-from-widening-the-policy)については、管理対象のみのロックを参照してください。組織に対してサンドボックスを必須にするには、[管理設定でサンドボックスを強制する](/docs/ja/sandboxing#enforce-sandboxing-with-managed-settings)を参照してください。
1767 1855
1768<h3 id="sandbox-enabled">1856<h3 id="sandbox-enabled">
1769 `sandbox.enabled`1857 `sandbox.enabled`
1791 `sandbox.failIfUnavailable`1879 `sandbox.failIfUnavailable`
1792</h3>1880</h3>
1793 1881
1794`sandbox.enabled` が `true` だがサンドボックスが起動できない場合(依存関係が不足しているか、プラットフォームがサポートされていない場合)、Claude Code が起動時にエラーで終了するようにします。これがない場合、Claude Code は警告を表示し、コマンドはサンドボックスなしで実行されます。組織がサンドボックスを厳密に必須とする場合は、管理設定で使用してください。1882`sandbox.enabled` が `true` であるにもかかわらずサンドボックスが起動できない場合(依存関係が不足しているか、プラットフォームがサポートされていない場合)、Claude Code がスタートアップ時にエラーで終了するようにします。これがない場合、Claude Code は警告を表示し、コマンドはサンドボックスなしで実行されます。組織がサンドボックスを厳密な要件として必要とする場合は、管理設定で使用します。
1795 1883
1796* **Scope**: [`Any file`](#scopes)1884* **Scope**: [`Any file`](#scopes)
1797* **Type**: ブール値1885* **Type**: ブール値
1798 * `true`: `sandbox.enabled` が `true` だがサンドボックスが起動できない場合、Claude Code は起動時にエラーで終了します1886 * `true`: `sandbox.enabled` が `true` であるにもかかわらずサンドボックスが起動できない場合、Claude Code はスタートアップ時にエラーで終了します
1799 * `false`: Claude Code は警告を表示し、コマンドはサンドボックスなしで実行されます1887 * `false`: Claude Code は警告を表示し、コマンドはサンドボックスなしで実行されます
1800* **Default**: `false`1888* **Default**: `false`
1801 1889
1821* **Scope**: [`Any file`](#scopes)1909* **Scope**: [`Any file`](#scopes)
1822* **Type**: ブール値1910* **Type**: ブール値
1823 * `true`: Claude Code はサンドボックス化された Bash コマンドを権限プロンプトなしで実行します。`deny` ルールとコンテンツスコープ付き `ask` ルールの対象です。`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` は自動許可をオフにします1911 * `true`: Claude Code はサンドボックス化された Bash コマンドを権限プロンプトなしで実行します。`deny` ルールとコンテンツスコープ付き `ask` ルールの対象です。`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` は自動許可をオフにします
1824 * `false`: サンドボックス化されたコマンドは通常の権限フローを通るため、許可ルールと権限モードが決定します。`/sandbox` **Mode** タブはこれを通常権限モードと呼びます1912 * `false`: サンドボックス化されたコマンドは通常の権限フローを通過するため、許可ルールと権限モードが決定します。`/sandbox` **Mode** タブはこれを通常権限モードと呼びます
1825* **Default**: `true`1913* **Default**: `true`
1826 1914
1827これはサンドボックスをオンに保ち、サンドボックス化されたコマンドを通常の権限フローを通します:1915これはサンドボックスをオンに保ち、サンドボックス化されたコマンドを通常の権限フローを通します:
1841 `sandbox.excludedCommands`1929 `sandbox.excludedCommands`
1842</h3>1930</h3>
1843 1931
1844Claude Code が常にサンドボックスの外で実行するコマンド(それの下で動作しないツールなど)に名前を付けます。各エントリは、`Bash(...)` [権限ルール](/docs/ja/permissions#permission-rule-syntax)の内容と同じ構文を使用します:正確なコマンド、`docker *` などのプレフィックス、またはワイルドカードパターン。1932Claude Code がサンドボックスの外で実行するコマンド(サンドボックスで動作しないツールなど)に名前を付けます。各エントリは、`Bash(...)` [権限ルール](/docs/ja/permissions#permission-rule-syntax)の内容と同じ構文を使用します:正確なコマンド、`docker *` などのプレフィックス、またはワイルドカードパターン。
1845 1933
1846エントリはそれをカバーするすべてのコマンドがある場合にのみ、Bash 呼び出しをサンドボックスから外します。一部の呼び出し形状はそれでもサンドボックス化されたままです。`docker *` エントリだけでは、`npm ci && docker build .` をサンドボックスから外しません。1934エントリは、Bash 呼び出しのすべてのコマンドをカバーする場合にのみ、Bash 呼び出しをサンドボックスから外します。一部の呼び出し形式はそれでもサンドボックス化されたままです。`docker *` エントリだけでは、`npm ci && docker build .` をサンドボックスから外しません。
1847 1935
1848* **Scope**: [`Any file`](#scopes)1936* **Scope**: [`Any file`](#scopes)
1849* **Type**: コマンドパターンの配列1937* **Type**: コマンドパターンの配列
1857}1945}
1858```1946```
1859 1947
1860Claude Code は Bash 呼び出しをサンドボックス化されたままにします。これらの形状の 1 つがある場合:1948Claude Code は、以下の形状の 1 つを持つ場合、Bash 呼び出しをサンドボックス化したままにします:
1861 1949
1862* `sudo`、`eval`、`xargs` で始まるコマンド1950* `sudo`、`eval`、または `xargs` で始まるコマンド
1863* `cd`、`pushd`、`popd`。呼び出しのどこにでも表示される1951* `cd`、`pushd`、または `popd`(呼び出しのどこにでも出現)
1864* コマンド置換、サブシェル、`if` または `for` などの制御フロー ブロック1952* コマンド置換、サブシェル、または `if` や `for` などの制御フロー ブロック
1865* `docker build . > build.log` のような `2>&1` のようなファイル記述子を複製するもの以外のリダイレクト1953* `docker build . > build.log` など、ファイル記述子を複製するもの以外のリダイレクト(`2>&1` など)
1866* 変数から来るコマンド名1954* 変数から来るコマンド名
1867 1955
1868たとえば、`cd build && docker compose up` は `docker *` エントリの下でサンドボックス化されたままで、`cd` エントリを追加してもそれは変わりません。1956たとえば、`cd build && docker compose up` は `docker *` エントリの下でサンドボックス化されたままであり、`cd` エントリを追加してもそれは変わりません。
1869 1957
1870除外されたコマンドは通常の権限フローを通過します。除外はセキュリティ境界ではなく、便宜です。ツールが特定の場所にのみ書き込む必要がある場合は、[`filesystem.allowWrite`](#sandbox-filesystem-allowwrite)を優先してください。Claude Code はセッションが読み込むすべての設定スコープ全体でエントリをマージし、このリストに対する管理対象のみのロックはないため、管理対象リストは狭く保ってください。1958除外されたコマンドは通常の権限フローを通過します。除外は便宜的なものであり、セキュリティ境界ではありません。ツールが特定の場所にのみ書き込む必要がある場合は、[`filesystem.allowWrite`](#sandbox-filesystem-allowwrite)を優先してください。Claude Code はセッションが読み込むすべての設定スコープ全体でエントリをマージし、このリストに対する管理対象のみのロックはないため、管理対象リストを狭く保ちます。
1871 1959
1872<h3 id="sandbox-allowunsandboxedcommands">1960<h3 id="sandbox-allowunsandboxedcommands">
1873 `sandbox.allowUnsandboxedCommands`1961 `sandbox.allowUnsandboxedCommands`
1874</h3>1962</h3>
1875 1963
1876Claude がサンドボックスによってブロックされた後、`dangerouslyDisableSandbox` パラメータを使用してコマンドをサンドボックスの外で再試行できるようにします。これを `false` に設定して、Claude Code がそのパラメータを完全に無視し、Claude が実行するすべてのコマンドがサンドボックス化されるか、[`excludedCommands`](#sandbox-excludedcommands)に表示されるようにします。`/sandbox` **Overrides** タブはその状態を**厳密なサンドボックスモード**として表示します。厳密なサンドボックスを必須とするポリシーの場合は、管理設定で `false` を使用してください。1964Claude がサンドボックスによってブロックされた後、`dangerouslyDisableSandbox` パラメータを使用してコマンドをサンドボックスの外で再試行できるようにします。これを `false` に設定して、Claude Code がそのパラメータを完全に無視し、Claude が実行するすべてのコマンドがサンドボックス化されるか、[`excludedCommands`](#sandbox-excludedcommands)に表示されるようにします。`/sandbox` **Overrides** タブはその状態を**厳密なサンドボックスモード**として表示します。厳密なサンドボックスを必要とするポリシーの場合は、管理設定で `false` を使用します。
1877 1965
1878* **Scope**: [`Any file`](#scopes)1966* **Scope**: [`Any file`](#scopes)
1879* **Type**: ブール値1967* **Type**: ブール値
1880 * `true`: Claude がサンドボックスによってブロックされた後、`dangerouslyDisableSandbox` パラメータを使用してコマンドをサンドボックスの外で再試行できます1968 * `true`: Claude がサンドボックスによってブロックされた後、`dangerouslyDisableSandbox` パラメータを使用してコマンドをサンドボックスの外で再試行できます
1881 * `false`: Claude Code はそのパラメータを無視するため、Claude が実行するすべてのコマンドはサンドボックス化されるか `excludedCommands` に表示されます1969 * `false`: Claude Code はそのパラメータを無視するため、Claude が実行するすべてのコマンドはサンドボックス化されるか、`excludedCommands` に表示されます
1882* **Default**: `true`1970* **Default**: `true`
1883 1971
1884これにより、管理設定がカバーするすべてのユーザーに対して厳密なサンドボックスモードが強制されます:1972これにより、管理設定がカバーするすべてのユーザーに対して厳密なサンドボックスモードが強制されます:
1892}1980}
1893```1981```
1894 1982
1895サンドボックスなしの再試行は通常の権限フローを通り、マニュアルモードではプロンプトが表示されます。[サンドボックスなしの再試行エスケープハッチ](/docs/ja/sandboxing#the-unsandboxed-retry-escape-hatch)を参照してください。1983サンドボックスなしの再試行は通常の権限フローを通過し、マニュアルモードではプロンプトが表示されます。[サンドボックスなしの再試行エスケープハッチ](/docs/ja/sandboxing#the-unsandboxed-retry-escape-hatch)を参照してください。
1896 1984
1897[`!` シェルモードプロンプト](/docs/ja/interactive-mode#shell-mode-with-prefix)で自分で入力したコマンドがサンドボックス化されて実行される場合を確認するには、[厳密なサンドボックスモード](/docs/ja/sandboxing#the-unsandboxed-retry-escape-hatch)を参照してください。1985[`!` シェルモードプロンプト](/docs/ja/interactive-mode#shell-mode-with-prefix)で自分で入力するコマンドがサンドボックス化されるときを確認するには、[厳密なサンドボックスモード](/docs/ja/sandboxing#the-unsandboxed-retry-escape-hatch)を参照してください。
1898 1986
1899<h3 id="sandbox-filesystem">1987<h3 id="sandbox-filesystem">
1900 `sandbox.filesystem`1988 `sandbox.filesystem`
1901</h3>1989</h3>
1902 1990
1903サンドボックス化されたコマンドが読み取りおよび書き込みできるパスを制御します。デフォルトでは、作業ディレクトリ、セッション一時ディレクトリ、`--add-dir`、`/add-dir`、または `permissions.additionalDirectories` で追加したディレクトリに書き込むことができ、認証情報ファイルを含むファイルシステムの残りの部分を読み取ることができます。4 つのパスリストでこれを拡大または縮小するか、`disabled` でファイルシステムレイヤーをオフにします。デフォルトの境界については、[ファイルシステム分離](/docs/ja/sandboxing#filesystem-isolation)を参照してください。1991サンドボックス化されたコマンドが読み取りおよび書き込みできるパスを制御します。デフォルトでは、作業ディレクトリ、ユーザーごとの一時ディレクトリ、`--add-dir`、`/add-dir`、または `permissions.additionalDirectories` で追加したディレクトリに書き込むことができ、認証情報ファイルを含むファイルシステムの残りの部分を読み取ることができます。4 つのパスリストで制限または拡大するか、`disabled` でファイルシステムレイヤーをオフにします。[ファイルシステム分離](/docs/ja/sandboxing#filesystem-isolation)のデフォルト境界を参照してください。
1904 1992
1905* **Scope**: [`Any file`](#scopes)1993* **Scope**: [`Any file`](#scopes)
1906* **Type**: `allowWrite`、`denyWrite`、`denyRead`、`allowRead` 配列を含むオブジェクト、および `allowManagedReadPathsOnly` と `disabled` ブール値1994* **Type**: `allowWrite`、`denyWrite`、`denyRead`、`allowRead` 配列を含むオブジェクト、および `allowManagedReadPathsOnly` と `disabled` ブール値
1919}2007}
1920```2008```
1921 2009
1922Claude Code はこれらのリストを OS サンドボックス境界で強制するため、`kubectl`、`terraform`、`npm` などのサンドボックス化されたコマンドが開始するすべてのサブプロセスに適用されます。Claude Code は[権限ルール](/docs/ja/sandboxing#permission-rules)をこれらのリストに追加します:`Edit` 許可および拒否ルールを `allowWrite` および `denyWrite` に、`Read` 拒否ルールを `denyRead` に、`WebFetch(domain:...)` 許可および拒否ルールを[`network`](#sandbox-network)ドメインリストに追加します。2010Claude Code はこれらのリストを OS サンドボックス境界で強制するため、`kubectl`、`terraform`、`npm` などのサンドボックス化されたコマンドが開始するすべてのサブプロセスに適用されます。Claude Code は[権限ルール](/docs/ja/sandboxing#permission-rules)を同じリストに追加します:`Edit` 許可および拒否ルールを `allowWrite` および `denyWrite` に、`Read` 拒否ルールを `denyRead` に、`WebFetch(domain:...)` 許可および拒否ルールを[`network`](#sandbox-network)ドメインリストに追加します。
1923 2011
1924管理対象のみのロックが設定されていない限り、Claude Code はセッションが読み込む設定ファイル全体ですべてのリストをマージします。[`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly)は `allowRead` を管理設定からのエントリに制限し、[`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly)は許可されたドメインに対して同じことを行います。2012管理対象のみのロックが設定されていない限り、Claude Code はセッションが読み込む設定ファイル全体ですべてのリストをマージします。[`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly)は `allowRead` を管理設定からのエントリに制限し、[`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly)は許可されたドメインに対して同じことを行います。
1925 2013
1926[サンドボックスを設定する](/docs/ja/sandboxing#configure-sandboxing)は `--setting-sources` で除外するソースをカバーしています。セッション中にリストを編集すると、Claude Code は[実行中のセッションに変更を適用します](/docs/ja/settings#when-edits-take-effect)。2014[サンドボックスを設定する](/docs/ja/sandboxing#configure-sandboxing)は、`--setting-sources` で除外するソースをカバーしています。セッション中にリストを編集すると、Claude Code は[実行中のセッションに変更を適用](/docs/ja/settings#when-edits-take-effect)します。
1927 2015
1928<h4 id="sandbox-path-prefixes">2016<h4 id="sandbox-path-prefixes">
1929 サンドボックスパスプレフィックス2017 サンドボックスパスプレフィックス
1930</h4>2018</h4>
1931 2019
1932`allowWrite`、`denyWrite`、`denyRead`、`allowRead`、および [`credentials.files`](#sandbox-credentials-files) のパスは、プレフィックスで解決されます:2020`allowWrite`、`denyWrite`、`denyRead`、`allowRead`、および [`credentials.files`](#sandbox-credentials-files) のパスはプレフィックスで解決されます:
1933 2021
1934| プレフィックス | 意味 | 例 |2022| プレフィックス | 意味 | 例 |
1935| :- | :- | :- |2023| :- | :- | :- |
1937| `~/` | ホームディレクトリに相対 | `~/.kube` は `$HOME/.kube` になります |2025| `~/` | ホームディレクトリに相対 | `~/.kube` は `$HOME/.kube` になります |
1938| `./` またはプレフィックスなし | プロジェクト設定ではプロジェクトルートに相対、ユーザー設定では `~/.claude` に相対 | `.claude/settings.json` の `./output` は `<project-root>/output` に解決されます |2026| `./` またはプレフィックスなし | プロジェクト設定ではプロジェクトルートに相対、ユーザー設定では `~/.claude` に相対 | `.claude/settings.json` の `./output` は `<project-root>/output` に解決されます |
1939 2027
1940絶対パスの `//path` プレフィックスも機能します。プロジェクト相対解決を期待して単一スラッシュ `/path` を使用する場合は、`./path` に切り替えてください。この構文は、`//path` を絶対パスに、`/path` をプロジェクト相対に使用する[読み取りおよび編集権限ルール](/docs/ja/permissions#read-and-edit)とは異なります。サンドボックスファイルシステムパスは標準規約を使用するため、`/tmp/build` は絶対パスです。2028絶対パスの `//path` プレフィックスも機能します。プロジェクト相対解決を期待して単一スラッシュ `/path` を使用する場合は、`./path` に切り替えます。この構文は、`//path` を絶対パスに、`/path` をプロジェクト相対に使用する[Read および Edit 権限ルール](/docs/ja/permissions#read-and-edit)とは異なります。サンドボックスファイルシステムパスは標準規則を使用するため、`/tmp/build` は絶対パスです。
1941 2029
1942Claude Code はディレクトリパスから末尾のスラッシュを削除するため、`~/.aws` と `~/.aws/` は同じディレクトリと一致します。v2.1.224 より前では、Claude Code は末尾のスラッシュをサンドボックスに渡し、Claude は末尾のスラッシュで書かれた `denyRead` または `denyWrite` エントリの下のパスを読み取りまたは書き込みできました。2030Claude Code はディレクトリパスから末尾のスラッシュを削除するため、`~/.aws` と `~/.aws/` は同じディレクトリと一致します。v2.1.224 より前では、Claude Code は末尾のスラッシュをサンドボックスに渡し、Claude は `denyRead` または `denyWrite` エントリで書き込まれたパスの下のパスを読み取りまたは書き込みできました。
1943 2031
1944Claude Code は末尾の `/**` も削除するため、`~/build/**` と `~/build` は同じディレクトリをカバーします。`*` などのワイルドカードが機能するかどうかは、エントリがどのリストにあるか、およびプラットフォームに依存します:2032Claude Code は末尾の `/**` も削除するため、`~/build/**` と `~/build` は同じディレクトリをカバーします。`*` などのワイルドカードが機能するかどうかは、エントリがどのリストにあるか、およびプラットフォームに依存します:
1945 2033
1946* **`allowWrite` および `denyWrite`**: macOS ではワイルドカードが機能します。Linux と WSL2 では、サンドボックスは具体的なパスをマウントするため、Claude Code は末尾の `/**` を削除した後に `*`、`?`、または `[` を含むエントリをスキップし、そのエントリは効果がありません。Claude Code は `Edit` 権限ルールからパスをこれらのリストに追加するため、同じ制限が適用され、`/sandbox` の **Config** タブはワイルドカードを含む `Edit` および `Read` 権限ルールについて警告します。2034* **`allowWrite` および `denyWrite`**: macOS ではワイルドカードが機能します。Linux と WSL2 では、サンドボックスは具体的なパスをマウントするため、Claude Code は末尾の `/**` を削除した後に `*`、`?`、または `[` を含むエントリをスキップし、そのエントリは効果がありません。Claude Code は `Edit` 権限ルールからパスを追加するため、同じ制限が適用され、`/sandbox` の **Config** タブはワイルドカードを含む `Edit` および `Read` 権限ルールについて警告します。
1947* **`denyRead` および `allowRead`**: ワイルドカードはすべてのプラットフォームで機能します。Linux と WSL2 では、Claude Code は読み取りエントリを、それが一致する具体的なパスに展開します。これは書き込みリストに対しては行いません。2035* **`denyRead` および `allowRead`**: ワイルドカードはすべてのプラットフォームで機能します。Linux と WSL2 では、Claude Code は読み取りエントリを、それが一致する具体的なパスに展開します。これは書き込みリストでは行いません。
1948 2036
1949<h3 id="sandbox-filesystem-allowwrite">2037<h3 id="sandbox-filesystem-allowwrite">
1950 `sandbox.filesystem.allowWrite`2038 `sandbox.filesystem.allowWrite`
1951</h3>2039</h3>
1952 2040
1953作業ディレクトリ、セッション一時ディレクトリ、`--add-dir`、`/add-dir`、または `permissions.additionalDirectories` で追加したディレクトリを超えて、サンドボックス化されたコマンドが書き込みできるパスを追加します。`kubectl` やビルドツールなどのサブプロセスがプロジェクト外に書き込む必要がある場合に使用します。2041作業ディレクトリ、ユーザーごとの一時ディレクトリ、`--add-dir`、`/add-dir`、または `permissions.additionalDirectories` で追加したディレクトリを超えて、サンドボックス化されたコマンドが書き込むことができるパスを追加します。`kubectl` やビルドツールなどのサブプロセスがプロジェクト外に書き込む必要がある場合に使用します。
1954 2042
1955* **Scope**: [`Any file`](#scopes)2043* **Scope**: [`Any file`](#scopes)
1956* **Type**: [サンドボックスパスプレフィックス](#sandbox-path-prefixes)を使用するパス文字列の配列2044* **Type**: [サンドボックスパスプレフィックス](#sandbox-path-prefixes)を使用するパス文字列の配列
1957* **Default**: 未設定。サンドボックス化されたコマンドは、作業ディレクトリ、セッション一時ディレクトリ、`--add-dir` または `/add-dir` で追加したディレクトリ、および [`permissions.additionalDirectories`](#permissions-additionaldirectories) のディレクトリに書き込むことができます2045* **Default**: 未設定。サンドボックス化されたコマンドは、作業ディレクトリ、ユーザーごとの一時ディレクトリ、`--add-dir` または `/add-dir` で追加したディレクトリ、および [`permissions.additionalDirectories`](#permissions-additionaldirectories) のディレクトリに書き込むことができます
1958 2046
1959これにより、ビルドが `/tmp/build` の下に書き込むことができ、`kubectl` が kubeconfig を更新できます:2047これにより、ビルドは `/tmp/build` の下に書き込むことができ、`kubectl` は kubeconfig を更新できます:
1960 2048
1961```json settings.json theme={null}2049```json settings.json theme={null}
1962{2050{
1968}2056}
1969```2057```
1970 2058
1971Claude Code はセッションが読み込むすべての設定スコープ全体でエントリをマージします:ユーザー、プロジェクト、ローカル、管理対象パスは相互に置き換わるのではなく組み合わされ、Claude Code は `Edit(...)` 許可権限ルールからパスを追加します。`allowWrite` エントリは[保護されたパス](/docs/ja/sandboxing#protected-paths)を解除することはできません。2059Claude Code は `allowWrite` エントリと `Edit(...)` 許可権限ルールからのパスをセッションが読み込むすべての設定スコープ全体でマージし、[`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block)がオンの間、リポジトリ設定からのものを除外します。`allowWrite` エントリは[保護されたパス](/docs/ja/sandboxing#protected-paths)を解除できません。
1972 2060
1973<h3 id="sandbox-filesystem-denywrite">2061<h3 id="sandbox-filesystem-denywrite">
1974 `sandbox.filesystem.denyWrite`2062 `sandbox.filesystem.denyWrite`
1992}2080}
1993```2081```
1994 2082
1995Claude Code はセッションが読み込むすべての設定スコープ全体でエントリをマージし、`Edit(...)` 拒否権限ルールからパスを追加します。2083Claude Code はセッションが読み込むすべての設定スコープ全体でエントリをマージし、`Edit(...)` 拒否権限ルールからのパスを追加します。
1996 2084
1997<h3 id="sandbox-filesystem-denyread">2085<h3 id="sandbox-filesystem-denyread">
1998 `sandbox.filesystem.denyRead`2086 `sandbox.filesystem.denyRead`
1999</h3>2087</h3>
2000 2088
2001サンドボックス化されたコマンドが特定のパス(デフォルトの読み取りポリシーが公開する認証情報ファイルなど)を読み取るのをブロックします。認証情報ファイルを保護し、サンドボックスプロキシを通じて使用可能に保つには、代わりに [`sandbox.credentials`](#sandbox-credentials) を参照してください。2089サンドボックス化されたコマンドが特定のパス(デフォルトの読み取りポリシーが公開する認証情報ファイルなど)の読み取りをブロックします。認証情報ファイルを保護し、サンドボックスプロキシを通じて使用可能に保つには、代わりに [`sandbox.credentials`](#sandbox-credentials) を参照してください。
2002 2090
2003* **Scope**: [`Any file`](#scopes)2091* **Scope**: [`Any file`](#scopes)
2004* **Type**: [サンドボックスパスプレフィックス](#sandbox-path-prefixes)を使用するパス文字列の配列2092* **Type**: [サンドボックスパスプレフィックス](#sandbox-path-prefixes)を使用するパス文字列の配列
2014}2102}
2015```2103```
2016 2104
2017Claude Code はセッションが読み込むすべての設定スコープ全体でエントリをマージし、`Read(...)` 拒否権限ルールからパスを追加します。[`filesystem.disabled`](#sandbox-filesystem-disabled)が `true` の場合、Claude Code はこれらのエントリを強制しません。2105Claude Code はセッションが読み込むすべての設定スコープ全体でエントリをマージし、`Read(...)` 拒否権限ルールからのパスを追加します。[`filesystem.disabled`](#sandbox-filesystem-disabled)が `true` の場合、Claude Code はこれらのエントリを強制しません。
2018 2106
2019<h3 id="sandbox-filesystem-allowread">2107<h3 id="sandbox-filesystem-allowread">
2020 `sandbox.filesystem.allowRead`2108 `sandbox.filesystem.allowRead`
2026* **Type**: [サンドボックスパスプレフィックス](#sandbox-path-prefixes)を使用するパス文字列の配列2114* **Type**: [サンドボックスパスプレフィックス](#sandbox-path-prefixes)を使用するパス文字列の配列
2027* **Default**: 未設定2115* **Default**: 未設定
2028 2116
2029これはホームディレクトリの読み取りをブロックしますが、プロジェクト自体は除きます:2117これにより、プロジェクト自体を除くホームディレクトリの読み取りがブロックされます:
2030 2118
2031```json settings.json theme={null}2119```json settings.json theme={null}
2032{2120{
2039}2127}
2040```2128```
2041 2129
2042Claude Code は `.` エントリをプロジェクト設定ではプロジェクトルートに、ユーザー設定では `~/.claude` に解決します。Claude Code はセッションが読み込むすべての設定ファイル全体でエントリをマージします。[`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly)が設定されていない限り。2130Claude Code は `.` エントリをプロジェクト設定ではプロジェクトルートに、ユーザー設定では `~/.claude` に解決します。Claude Code はセッションが読み込むすべての設定ファイル全体でエントリをマージします。[`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly)が設定されていない限り、[`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block)がオンの間、リポジトリ設定からのエントリを除外します。
2043 2131
2044<h3 id="sandbox-filesystem-allowmanagedreadpathsonly">2132<h3 id="sandbox-filesystem-allowmanagedreadpathsonly">
2045 `sandbox.filesystem.allowManagedReadPathsOnly`2133 `sandbox.filesystem.allowManagedReadPathsOnly`
2046</h3>2134</h3>
2047 2135
2048管理設定から来る [`allowRead`](#sandbox-filesystem-allowread) エントリのみを尊重するため、開発者は組織がブロックしたパスへの読み取りアクセスを再度開くことはできません。Claude Code は引き続き、セッションが読み込むすべての設定スコープから `denyRead` エントリをマージします。2136管理設定から来る [`allowRead`](#sandbox-filesystem-allowread) エントリのみを尊重するため、開発者は組織がブロックしたパスへの読み取りアクセスを再度開くことができません。Claude Code は引き続きセッションが読み込むすべての設定スコープから `denyRead` エントリをマージします。
2049 2137
2050* **Scope**: [`Managed`](#scopes)2138* **Scope**: [`Managed`](#scopes)
2051* **Type**: ブール値2139* **Type**: ブール値
2053 * `false`: `allowRead` エントリはセッションが読み込むすべての設定スコープからマージされます2141 * `false`: `allowRead` エントリはセッションが読み込むすべての設定スコープからマージされます
2054* **Default**: `false`2142* **Default**: `false`
2055 2143
2056これはホームディレクトリの読み取りをブロックし、`~/work` を再度開き、開発者が他のものを再度開くのを防ぎます:2144これにより、ホームディレクトリの読み取りがブロックされ、`~/work` が再度開かれ、開発者が他のものを再度開くのが停止されます:
2057 2145
2058```json managed-settings.json theme={null}2146```json managed-settings.json theme={null}
2059{2147{
2067}2155}
2068```2156```
2069 2157
2070[開発者がポリシーを拡大するのを防ぐ](/docs/ja/sandboxing#keep-developers-from-widening-the-policy)を参照してください。2158[ポリシーの拡大を開発者に防止させる](/docs/ja/sandboxing#keep-developers-from-widening-the-policy)を参照してください。
2071 2159
2072<h3 id="sandbox-filesystem-disabled">2160<h3 id="sandbox-filesystem-disabled">
2073 `sandbox.filesystem.disabled`2161 `sandbox.filesystem.disabled`
2074</h3>2162</h3>
2075 2163
2076ネットワーク分離を保持しながらファイルシステム分離をスキップします。サンドボックス化されたコマンドはホストファイルシステムへの無制限の読み取りおよび書き込みアクセスを取得し、それらのネットワーク出力は [`network.allowedDomains`](#sandbox-network-alloweddomains) に限定されたままです。コマンドが接続する場所を制御するためにサンドボックスを使用する場合に使用します。書き込む内容ではなく。Claude Code v2.1.216 以降が必要です。2164ネットワーク分離を保持しながらファイルシステム分離をスキップします。サンドボックス化されたコマンドはホストファイルシステムへの無制限の読み取りおよび書き込みアクセスを取得し、それらのネットワーク出力は [`network.allowedDomains`](#sandbox-network-alloweddomains) に限定されたままです。コマンドが何を書き込むかではなく、どこに接続するかを制御するためにサンドボックスを使用する場合に使用します。Claude Code v2.1.216 以降が必要です。
2077 2165
2078* **Scope**: [`User or managed`](#scopes)。管理設定が `sandbox.filesystem` をまったく設定する場合、または `"mode": "deny"` の `sandbox.credentials.files` エントリをリストする場合、管理設定のみがそれを設定できます。2166* **Scope**: [`User or managed`](#scopes)。管理設定が `sandbox.filesystem` をまったく設定する場合、または `"mode": "deny"` を持つ `sandbox.credentials.files` エントリをリストする場合、管理設定のみがそれを設定できます。
2079* **Type**: ブール値2167* **Type**: ブール値
2080 * `true`: Claude Code はファイルシステム分離をスキップし、ネットワーク分離を保持します2168 * `true`: Claude Code はファイルシステム分離をスキップし、ネットワーク分離を保持します
2081 * `false`: ファイルシステム分離は有効なままです2169 * `false`: ファイルシステム分離は有効なままです
2082* **Default**: `false`。ファイルシステム分離は有効なままです2170* **Default**: `false`。ファイルシステム分離は有効なままです
2083 2171
2084これはファイルシステムを開いたままにし、ネットワーク出力を GitHub と npm に限定します:2172これにより、ファイルシステムが開かれ、ネットワーク出力が GitHub と npm に限定されます:
2085 2173
2086```json settings.json theme={null}2174```json settings.json theme={null}
2087{2175{
2097}2185}
2098```2186```
2099 2187
2100レイヤーがオフの場合、Claude Code は `denyRead` または `credentials.files` `deny` エントリを強制しませんが、`credentials.envVars` エントリと適用された `mask` エントリは機能し続けます。[`autoAllowBashIfSandboxed`](#sandbox-autoallowbashifsandboxed)は引き続き `true` にデフォルト設定されるため、プロンプトを続けるには `false` に設定してください。[ファイルシステム分離を無効にする](/docs/ja/sandboxing#disable-filesystem-isolation)を参照して、それを設定できるソースの完全なリストと、分離がオフの場合に何が変わるかを確認してください。Claude Code v2.1.216 以降が必要です。2188レイヤーがオフの場合、Claude Code は `denyRead` または `credentials.files` `deny` エントリを強制しませんが、`credentials.envVars` エントリと適用された `mask` エントリは引き続き機能します。[`autoAllowBashIfSandboxed`](#sandbox-autoallowbashifsandboxed)は引き続き `true` にデフォルト設定されるため、プロンプトを続けるには `false` に設定します。[ファイルシステム分離を無効にする](/docs/ja/sandboxing#disable-filesystem-isolation)を参照して、それを設定できるソースの完全なリストと、分離がオフの場合に何が変わるかを確認してください。Claude Code v2.1.216 以降が必要です。
2101 2189
2102<h3 id="sandbox-ignoreviolations">2190<h3 id="sandbox-ignoreviolations">
2103 `sandbox.ignoreViolations`2191 `sandbox.ignoreViolations`
2104</h3>2192</h3>
2105 2193
2106コマンドが `/etc/hosts` をスタートアップで確認するツールなど、プローブされて拒否されることが予想されるパスのサンドボックス違反レポートをサイレンスします。これらの拒否が違反として表示されたり、Claude が見たりしないようにします。サンドボックスはアクセスをブロックしたままです。レポートのみが抑制されます。キーはコマンドと照合するサブストリング(`*` はすべてのコマンドと一致)で、値はそのコマンドで無視する違反のサブストリング(ファイルシステムパスなど)です。2194コマンドがプローブして拒否されることが予想されるパスのサンドボックス違反レポートを沈黙させます(例えば、スタートアップ時に `/etc/hosts` をチェックするツール)。これらの拒否は違反として表示されず、Claude が見るものにも表示されません。サンドボックスはアクセスをブロックしたままです。レポートのみが抑制されます。キーはコマンドに対して一致するサブストリング(`*` はすべてのコマンドに一致)で、値はそのコマンドで無視する違反のサブストリング(ファイルシステムパスなど)です。
2107 2195
2108* **Scope**: [`Any file`](#scopes)2196* **Scope**: [`Any file`](#scopes)
2109* **Type**: コマンドサブストリングを違反サブストリングの配列にマップするオブジェクト。通常はパス2197* **Type**: コマンドサブストリングを違反サブストリングの配列にマップするオブジェクト(通常はパス)
2110* **Default**: 未設定。すべての違反が報告されます2198* **Default**: 未設定。すべての違反が報告されます
2111 2199
2112```json settings.json theme={null}2200```json settings.json theme={null}
2123 `sandbox.enableWeakerNestedSandbox`2211 `sandbox.enableWeakerNestedSandbox`
2124</h3>2212</h3>
2125 2213
2126Linux サンドボックスを非特権 Docker コンテナ内で実行します。bubblewrap は新しい `/proc` をマウントできません。代わりに、内部サンドボックスはコンテナの既存の `/proc` をバインドマウントします。これは、新しいマウントが非表示にするプロセス情報を公開します。これはセキュリティを低下させます。外部コンテナが既に必要な分離を提供する場合にのみ使用してください。2214Linux サンドボックスを非特権 Docker コンテナ内で実行します。bubblewrap は新しい `/proc` をマウントできません。代わりに、内部サンドボックスはコンテナの既存の `/proc` をバインドマウントします。これにより、新しいマウントが非表示にするプロセス情報が公開されます。これはセキュリティを低下させます。外部コンテナが既に必要な分離を提供する場合にのみ使用します。
2127 2215
2128* **Scope**: [`Any file`](#scopes)2216* **Scope**: [`Any file`](#scopes)
2129* **Type**: ブール値2217* **Type**: ブール値
2146 `sandbox.enableWeakerNetworkIsolation`2234 `sandbox.enableWeakerNetworkIsolation`
2147</h3>2235</h3>
2148 2236
2149macOS でサンドボックス化されたコマンドがシステム TLS 信頼サービス `com.apple.trustd.agent` に到達できるようにします。`gh`、`gcloud`、`terraform` などの Go ベースのツールは、[`network.httpProxyPort`](#sandbox-network-httpproxyport) を MITM プロキシとカスタム CA で使用する場合、TLS 証明書を検証するために必要です。これはセキュリティを低下させます。信頼サービスを通じた潜在的なデータ流出パスを開きます。2237macOS でサンドボックス化されたコマンドがシステム TLS トラストサービス `com.apple.trustd.agent` に到達できるようにします。`gh`、`gcloud`、`terraform` などの Go ベースのツールは、[`network.httpProxyPort`](#sandbox-network-httpproxyport)を MITM プロキシとカスタム CA で使用する場合、TLS 証明書を検証するために必要です。これはトラストサービスを通じた潜在的なデータ流出パスを開くことでセキュリティを低下させます。
2150 2238
2151* **Scope**: [`Any file`](#scopes)2239* **Scope**: [`Any file`](#scopes)
2152* **Type**: ブール値2240* **Type**: ブール値
2153 * `true`: macOS でサンドボックス化されたコマンドは `com.apple.trustd.agent` に到達できます2241 * `true`: macOS でサンドボックス化されたコマンドは `com.apple.trustd.agent` に到達できます
2154 * `false`: macOS でサンドボックス化されたコマンドはシステム TLS 信頼サービスに到達できません2242 * `false`: macOS でサンドボックス化されたコマンドはシステム TLS トラストサービスに到達できません
2155* **Default**: `false`2243* **Default**: `false`
2156 2244
2157```json settings.json theme={null}2245```json settings.json theme={null}
2163}2251}
2164```2252```
2165 2253
2166MITM プロキシを使用しない場合は、代わりに失敗するツールを [`excludedCommands`](#sandbox-excludedcommands) にリストしてください。[Go ベースの CLI が macOS で TLS 検証に失敗する](/docs/ja/sandboxing#troubleshooting)を参照してください。2254MITM プロキシを使用しない場合は、代わりに失敗するツールを [`excludedCommands`](#sandbox-excludedcommands) にリストします。[Go ベースの CLI が macOS で TLS 検証に失敗する](/docs/ja/sandboxing#troubleshooting)を参照してください。
2167 2255
2168<h3 id="sandbox-allowappleevents">2256<h3 id="sandbox-allowappleevents">
2169 `sandbox.allowAppleEvents`2257 `sandbox.allowAppleEvents`
2170</h3>2258</h3>
2171 2259
2172macOS でサンドボックス化されたコマンドが Apple Events を送信できるようにします。`open`、`osascript`、およびブラウザで URL を開くツールが必要です。これがないと、エラー `-600` で失敗します。これはコード実行分離を削除します:サンドボックス化されたコマンドはユーザープロンプトなしで他のアプリケーションをサンドボックスなしで起動でき、Terminal などの実行中のアプリケーションに AppleScript コマンドを送信できます。アプリごとの macOS オートメーション同意プロンプト(TCC)の対象です。2260macOS でサンドボックス化されたコマンドが Apple Events を送信できるようにします。`open`、`osascript`、およびブラウザで URL を開くツールはこれが必要です。これがないと、エラー `-600` で失敗します。これはコード実行分離を削除します。サンドボックス化されたコマンドはユーザープロンプトなしで他のアプリケーションを非サンドボックス化で起動でき、Terminal などの実行中のアプリケーションに AppleScript コマンドを送信できます。これはアプリごとの macOS オートメーション同意プロンプト(TCC)の対象です。
2173 2261
2174* **Scope**: [`User or managed`](#scopes)2262* **Scope**: [`User or managed`](#scopes)
2175* **Type**: ブール値2263* **Type**: ブール値
2186}2274}
2187```2275```
2188 2276
2189分離を保持しながら 1 つのそのようなツールを実行するには、代わりに [`excludedCommands`](#sandbox-excludedcommands) に追加してください。[macOS の Apple Events](/docs/ja/sandboxing#security-limitations)を参照してください。2277分離を保持しながら 1 つのそのようなツールを実行するには、代わりに [`excludedCommands`](#sandbox-excludedcommands) に追加します。[macOS の Apple Events](/docs/ja/sandboxing#security-limitations)を参照してください。
2190 2278
2191<h3 id="sandbox-ripgrep">2279<h3 id="sandbox-ripgrep">
2192 `sandbox.ripgrep`2280 `sandbox.ripgrep`
2193</h3>2281</h3>
2194 2282
2195Claude Code が使用するものの代わりに、独自の ripgrep バイナリをサンドボックスに指定します。たとえば、プラットフォームが異なる方法で構築された `rg` が必要な場合。2283Claude Code が使用するものの代わりに、独自の ripgrep バイナリをサンドボックスに指定します。たとえば、プラットフォームが異なる方法で構築された `rg` が必要な場合です。
2196 2284
2197* **Scope**: [`User or managed`](#scopes)2285* **Scope**: [`User or managed`](#scopes)
2198* **Type**: ripgrep バイナリへのパスである `command` を含むオブジェクト、および前置する引数の配列である optional `args`2286* **Type**: ripgrep バイナリへのパスである `command` を含むオブジェクト、および前置する引数の配列である optional `args`
2199* **Default**: 未設定。サンドボックスは Claude Code と同じ ripgrep バイナリを使用します。[`USE_BUILTIN_RIPGREP`](/docs/ja/env-vars)を `0` に設定しない限り、バンドルされたバイナリです2287* **Default**: 未設定。サンドボックスは Claude Code と同じ ripgrep バイナリを使用します。[`USE_BUILTIN_RIPGREP`](/docs/ja/env-vars)を `0` に設定しない限り、これはバンドルされたバイナリです
2200 2288
2201```json settings.json theme={null}2289```json settings.json theme={null}
2202{2290{
2215`PATH` の外にインストールされた bubblewrap バイナリ(エアギャップホスト上のベンダー版など)をサンドボックスに指定します。Claude Code はスタートアップ依存関係チェックと、サンドボックス化された各コマンドをラップするときの両方でパスを使用します。2303`PATH` の外にインストールされた bubblewrap バイナリ(エアギャップホスト上のベンダー版など)をサンドボックスに指定します。Claude Code はスタートアップ依存関係チェックと、サンドボックス化された各コマンドをラップするときの両方でパスを使用します。
2216 2304
2217* **Scope**: [`Managed`](#scopes)。Claude Code はユーザー、プロジェクト、またはローカルファイルがサンドボックスを別のバイナリに指定できないように、管理設定からのみ読み取ります。2305* **Scope**: [`Managed`](#scopes)。Claude Code はユーザー、プロジェクト、またはローカルファイルがサンドボックスを別のバイナリに指定できないように、管理設定からのみ読み取ります。
2218* **Type**: 文字列。絶対パス。Claude Code は相対パスをドロップし、`PATH` ルックアップにフォールバックします2306* **Type**: 文字列。絶対パス。Claude Code は相対パスを削除し、`PATH` ルックアップにフォールバックします
2219* **Default**: 未設定。Claude Code は `PATH` で `bwrap` を見つけます2307* **Default**: 未設定。Claude Code は `PATH` で `bwrap` を見つけます
2220 2308
2221```json managed-settings.json theme={null}2309```json managed-settings.json theme={null}
2236`PATH` の外にインストールされた `socat` バイナリをサンドボックスネットワークプロキシに指定します。2324`PATH` の外にインストールされた `socat` バイナリをサンドボックスネットワークプロキシに指定します。
2237 2325
2238* **Scope**: [`Managed`](#scopes)2326* **Scope**: [`Managed`](#scopes)
2239* **Type**: 文字列。絶対パス。Claude Code は相対パスをドロップし、`PATH` ルックアップにフォールバックします2327* **Type**: 文字列。絶対パス。Claude Code は相対パスを削除し、`PATH` ルックアップにフォールバックします
2240* **Default**: 未設定。Claude Code は `PATH` で `socat` を見つけます2328* **Default**: 未設定。Claude Code は `PATH` で `socat` を見つけます
2241 2329
2242```json managed-settings.json theme={null}2330```json managed-settings.json theme={null}
2260* **Type**: `files`、`envVars`、`allowPlaintextInject`、`awsPairs`、`sigv4` を含むオブジェクト2348* **Type**: `files`、`envVars`、`allowPlaintextInject`、`awsPairs`、`sigv4` を含むオブジェクト
2261* **Default**: 未設定。認証情報は保護されません2349* **Default**: 未設定。認証情報は保護されません
2262 2350
2263これは AWS 認証情報ファイルを非表示にし、サンドボックス化されたコマンドから `GITHUB_TOKEN` を削除します:2351これにより、AWS 認証情報ファイルが非表示になり、`GITHUB_TOKEN` がサンドボックス化されたコマンドから削除されます:
2264 2352
2265```json settings.json theme={null}2353```json settings.json theme={null}
2266{2354{
2273}2361}
2274```2362```
2275 2363
2276`deny` ファイル保護はファイルシステムレイヤーの一部であるため、[ファイルシステム分離を無効にする](/docs/ja/sandboxing#disable-filesystem-isolation)場合は適用されません。環境変数保護は引き続き行われます。2364`deny` ファイル保護はファイルシステムレイヤーの一部であるため、[ファイルシステム分離を無効にする](/docs/ja/sandboxing#disable-filesystem-isolation)場合は適用されません。環境変数保護は引き続き適用されます。
2277 2365
2278<h4 id="invalid-credential-entries-in-managed-settings">2366<h4 id="invalid-credential-entries-in-managed-settings">
2279 管理設定の無効な認証情報エントリ2367 管理設定の無効な認証情報エントリ
2281 2369
2282管理対象の `sandbox.credentials` エントリが検証に失敗した場合、Claude Code は可能な限り認証情報を保護し続けます:2370管理対象の `sandbox.credentials` エントリが検証に失敗した場合、Claude Code は可能な限り認証情報を保護し続けます:
2283 2371
2284* `files` または `envVars` のエントリで、有効な `path` または `name` と `mask` または `deny` の `mode` を持つもの(キャプチャグループのない `extract` パターンなど)は、警告とともに `mode: "deny"` に低下します。認証情報はマスクされず、エントリを修正するまでブロックされたままです。低下した `files` エントリは [`filesystem.disabled`](/docs/ja/sandboxing#disable-filesystem-isolation) を明示的な `deny` エントリのようにピンします。警告は、管理設定がファイルシステム分離をオフにした場合、その読み取りブロックが強制されないことを記します。2372* `files` または `envVars` のエントリで、有効な `path` または `name` と `mask` または `deny` の `mode` を持つもの(キャプチャグループがない `extract` パターンなど)は、警告とともに `mode: "deny"` に低下されるため、認証情報はマスクされず、エントリを修正するまでブロックされたままです。低下した `files` エントリは、明示的な `deny` エントリのように [`filesystem.disabled`](/docs/ja/sandboxing#disable-filesystem-isolation) をピンします。警告は、管理設定がファイルシステム分離をオフにする場合、その読み取りブロックが強制されないことを記します。
2285* 不明な `mode` または無効な `path` または `name` を持つエントリは削除されます。2373* 不明な `mode` または無効な `path` または `name` を持つエントリは削除されます。
2286* 各ケースは警告します。エントリが低下または削除されるかどうかに関わらず、残りの有効なエントリは引き続き強制され、完全に無効な `credentials` 値は削除されますが、`sandbox` の残りは引き続き適用されます。2374* 各ケースは警告します。エントリが低下または削除されるかどうかに関わらず、残りの有効なエントリは引き続き強制され、完全に無効な `credentials` 値は削除されますが、`sandbox` の残りは引き続き適用されます。
2287 2375
2291 `sandbox.credentials.files`2379 `sandbox.credentials.files`
2292</h3>2380</h3>
2293 2381
2294認証情報ファイルまたはディレクトリをサンドボックス化されたコマンドから保護します。`"mode": "deny"` の場合、Claude Code はサンドボックス内のパスの読み取りをブロックします。これは [`sandbox.filesystem.denyRead`](#sandbox-filesystem-denyread) と同じ読み取りブロックです。` "mode": "mask"` の場合、Linux と WSL2 でサンドボックス化されたコマンドはファイルのセンチネルコピーを読み取り、サンドボックスプロキシはそのエントリの `injectHosts` への送信リクエストで実際の値を置き換えます。macOS ではファイルはサンドボックス内で読み取り不可です。`"mode": "mask"` は Claude Code v2.1.221 以降が必要です。2382認証情報ファイルまたはディレクトリをサンドボックス化されたコマンドから保護します。`"mode": "deny"` の場合、Claude Code はサンドボックス内のパスの読み取りをブロックします。これは [`sandbox.filesystem.denyRead`](#sandbox-filesystem-denyread) と同じ読み取りブロックです。`"mode": "mask"` の場合、Linux と WSL2 でサンドボックス化されたコマンドはファイルのセンチネルコピーを読み取り、サンドボックスプロキシはそのエントリの `injectHosts` への送信リクエストで実際の値を置き換えます。macOS ではファイルはサンドボックス内で読み取り不可です。`"mode": "mask"` には Claude Code v2.1.221 以降が必要です。
2295 2383
2296* **Scope**: [`Any file`](#scopes)。Claude Code はプロジェクト `.claude/settings.json` とローカル `.claude/settings.local.json` から `mask` エントリを削除します。2384* **Scope**: [`Any file`](#scopes)。Claude Code はプロジェクト `.claude/settings.json` とローカル `.claude/settings.local.json` から `mask` エントリを削除します。
2297* **Type**: オブジェクトの配列。各オブジェクトは `path` と `"deny"` または `"mask"` の `mode`、および optional [ファイルのマスクフィールド](#mask-fields-for-files)2385* **Type**: オブジェクトの配列。各オブジェクトは `path` と `"deny"` または `"mask"` の `mode`、および optional [ファイルのマスクフィールド](#mask-fields-for-files)を含みます
2298* **Default**: 未設定。認証情報ファイルは保護されません2386* **Default**: 未設定。認証情報ファイルは保護されません
2299 2387
2300これは AWS 認証情報ファイルを非表示にし、`gh` ホストファイルをマスクします。実際の値は `api.github.com` へのリクエストでのみ置き換えられます:2388これにより、AWS 認証情報ファイルが非表示になり、`gh` ホストファイルがマスクされ、`api.github.com` へのリクエストでのみ実際の値が置き換えられます:
2301 2389
2302```json settings.json theme={null}2390```json settings.json theme={null}
2303{2391{
2312}2400}
2313```2401```
2314 2402
2315パスは `sandbox.filesystem.*` 設定と同じ[プレフィックス](#sandbox-path-prefixes)を使用し、Claude Code はセッションが読み込むすべての設定スコープから配列をマージします。[認証情報を保護する](/docs/ja/sandboxing#protect-credentials)は `--setting-sources` で除外するソースから何が引き続き適用されるかをカバーしています。`mask` エントリは v2.1.221 以降が必要です。2403パスは `sandbox.filesystem.*` 設定と同じ[プレフィックス](#sandbox-path-prefixes)を使用し、Claude Code はセッションが読み込むすべての設定スコープから配列をマージします。[認証情報を保護する](/docs/ja/sandboxing#protect-credentials)は、`--setting-sources` で除外するソースから何が引き続き適用されるかをカバーしています。`mask` エントリには Claude Code v2.1.221 以降が必要です。
2316 2404
2317`mask` 置き換えはサンドボックスプロキシを通じてのみ実行されるため、[`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate) を設定するか、プレーン HTTP テストネットワークの場合は [`allowPlaintextInject`](#sandbox-credentials-allowplaintextinject) を設定してください。`mask` は単一ファイルに適用されるため、各認証情報ファイルを個別にリストしてください。Claude Code は `deny` エントリの `mask` フィールドを受け入れますが無視します。[認証情報ファイルをマスクする](/docs/ja/sandboxing#mask-credential-files)は、どの設定ソースが尊重されるか、およびエントリが `deny` にフォールバックするときをカバーしています。2405`mask` 置換はサンドボックスプロキシを通じてのみ実行されるため、[`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate)、または プレーン HTTP テストネットワークの場合は [`allowPlaintextInject`](#sandbox-credentials-allowplaintextinject) を設定します。`mask` は単一ファイルに適用されるため、各認証情報ファイルを個別にリストします。Claude Code は `deny` エントリの `mask` フィールドを受け入れますが、無視します。[認証情報ファイルをマスクする](/docs/ja/sandboxing#mask-credential-files)は、どの設定ソースが尊重されるか、およびエントリが `deny` にフォールバックするときをカバーしています。
2318 2406
2319<span id="sandbox-credentials-files-extract" />2407<span id="sandbox-credentials-files-extract" />
2320 2408
2336 2424
2337| フィールド | 型 | 何をするか |2425| フィールド | 型 | 何をするか |
2338| :- | :- | :- |2426| :- | :- | :- |
2339| `extract` | 文字列。少なくとも 1 つのキャプチャグループを持つ正規表現 | 各マッチのグループ 1 でキャプチャされたテキストのみをマスクします。ファイルの残りは解析可能なままです。`decode` も設定されている場合、Claude Code は各キャプチャを置き換える代わりに、可能な JWT として確認します。v2.1.221 以降が必要です |2427| `extract` | 文字列。少なくとも 1 つのキャプチャグループを持つ正規表現 | 各一致のグループ 1 でキャプチャされたテキストのみをマスクするため、ファイルの残りは解析可能なままです。`decode` も設定されている場合、Claude Code は各キャプチャを置き換える前に、可能な JWT として確認します。v2.1.221 以降が必要です |
2340| `onExtractNoMatch` | `"warn"`、`"deny"`、または `"error"`。デフォルト `"warn"` | `extract` または `decode` がマスクするものを見つけられない場合に何が起こるか。`warn` はファイルを読み取り可能なままにします。サンドボックス内で、`deny` は読み取り不可にし、`error` は設定を修正するまでサンドボックスセットアップを停止します。Claude Code は、読み取りブロックが強制されない場合、`deny` を `error` として扱います。[ファイルシステム分離を無効にする](/docs/ja/sandboxing#disable-filesystem-isolation)か、[`sandbox.filesystem.allowRead`](#sandbox-filesystem-allowread)エントリがパスを再度開く場合。v2.1.221 以降が必要です。`decode` ケースは v2.1.224 以降が必要です |2428| `onExtractNoMatch` | `"warn"`、`"deny"`、または `"error"`。デフォルト `"warn"` | `extract` または `decode` がマスクするものを見つけられない場合に何が起こるか。`warn` はファイルをサンドボックス内で読み取り可能なままにし、`deny` は読み取り不可にし、`error` は設定を修正するまでサンドボックスセットアップを停止します。Claude Code は、読み取りブロックが強制されない場合、`deny` を `error` として扱います。[ファイルシステム分離を無効にする](/docs/ja/sandboxing#disable-filesystem-isolation)か、[`sandbox.filesystem.allowRead`](#sandbox-filesystem-allowread)エントリがパスを再度開く場合です。v2.1.221 以降が必要です。`decode` ケースには v2.1.224 以降が必要です |
2341| `decode` | 文字列 `"jwt"` | ファイル内の JSON Web Token(JWT)を見つけ、組み込みパターンまたは設定されている場合は `extract` で、各候補を検証し、構造的に有効な偽トークンで置き換えます。サンドボックス内のコードがトークンをデコードし続けるようにします。候補が検証されない場合、`onExtractNoMatch` が結果を管理します。v2.1.224 以降が必要です |2429| `decode` | 文字列 `"jwt"` | ファイル内の JSON Web Token(JWT)を見つけます。組み込みパターンまたは設定されている場合は `extract` を使用して、各候補を検証し、構造的に有効な偽のトークンで置き換えます。サンドボックス内のコードがトークンをデコードし続けるようにします。候補が検証されない場合、`onExtractNoMatch` が結果を管理します。v2.1.224 以降が必要です |
2342| `maskClaims` | 文字列の配列。少なくとも 1 つのクレーム名。`decode` が必要 | 各検証済み JWT 内の名前付きトップレベルペイロードクレームのみをマスクし、変更されたペイロードの周りにトークンを再構築します。他のクレームは読み取り可能なままです。名前付きクレームが一致しない場合、`onExtractNoMatch` が結果を管理します。v2.1.224 以降が必要です |2430| `maskClaims` | 文字列の配列。少なくとも 1 つのクレーム名。`decode` が必要 | 各検証済み JWT 内の名前付きトップレベルペイロードクレームのみをマスクし、変更されたペイロードの周りにトークンを再構築します。他のクレームは読み取り可能なままです。名前付きクレームが一致しない場合、`onExtractNoMatch` が結果を管理します。v2.1.224 以降が必要です |
2343| `maskDuplicates` | ブール値。デフォルト `false` | ファイル内の他の場所にある各マスク値の逐語的コピーも置き換えます。コメントに貼り付けられたシークレットなど。Claude Code は生のサブストリングと照合するため、長く、高エントロピーのシークレット用に予約してください。`extract` または `decode` が設定されている場合にのみ参照されます。v2.1.221 以降が必要です |2431| `maskDuplicates` | ブール値。デフォルト `false` | 各マスクされた値の逐語的なコピーをファイル内の他の場所でも置き換えます。例えば、コメントに貼り付けられたシークレット。Claude Code は生のサブストリングと一致するため、長く、高エントロピーのシークレット用に予約します。`extract` または `decode` が設定されている場合にのみ参照されます。v2.1.221 以降が必要です |
2344| `injectHosts` | 文字列の配列。各ホストは [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) も認めます | サンドボックスプロキシが実際の値を置き換えるホストを絞ります。未設定の場合、プロキシは `sandbox.network.allowedDomains` のすべてのホストへのリクエストで置き換えます。v2.1.221 以降が必要です |2432| `injectHosts` | 文字列の配列。各ホストは [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) も認めます | サンドボックスプロキシが実際の値を置き換えるホストを絞ります。未設定の場合、プロキシは `sandbox.network.allowedDomains` のすべてのホストへのリクエストで置き換えます。v2.1.221 以降が必要です |
2345 2433
2346これは `gh` ホストファイルの `oauth_token` 値のみをマスクし、ファイル内のそれぞれの他のコピーを置き換え、パターンが何も一致しない場合はファイルを読み取り不可にし、実際のトークンは `api.github.com` へのリクエストでのみ置き換えます:2434これにより、`gh` ホストファイル内の `oauth_token` 値のみがマスクされ、ファイル内のそれぞれの他のコピーが置き換えられ、パターンが何も一致しない場合はファイルが読み取り不可になり、実際のトークンは `api.github.com` へのリクエストでのみ置き換えられます:
2347 2435
2348```json settings.json theme={null}2436```json settings.json theme={null}
2349{2437{
2368 `sandbox.credentials.envVars`2456 `sandbox.credentials.envVars`
2369</h3>2457</h3>
2370 2458
2371環境変数をサンドボックス化されたコマンドから保護します。`"mode": "deny"` の場合、Claude Code はサンドボックス化されたコマンドの環境から変数を削除します。` "mode": "mask"` の場合、サンドボックス化されたコマンドはセッションごとのセンチネル値を見て、サンドボックスプロキシはそのエントリの `injectHosts` への送信リクエストで実際の値を置き換えます。`gh` と `npm` などのツールは実際の認証情報を保持することなく認証を続けます。`"mode": "mask"` は Claude Code v2.1.199 以降が必要です。2459環境変数をサンドボックス化されたコマンドから保護します。`"mode": "deny"` の場合、Claude Code はサンドボックス化されたコマンドの環境から変数を削除します。`"mode": "mask"` の場合、サンドボックス化されたコマンドはセッションごとのセンチネル値を見て、サンドボックスプロキシはそのエントリの `injectHosts` への送信リクエストで実際の値を置き換えます。`gh` や `npm` などのツールは実際の認証情報を保持することなく認証を続けます。`"mode": "mask"` には Claude Code v2.1.199 以降が必要です。
2372 2460
2373* **Scope**: [`Any file`](#scopes)。Claude Code はプロジェクト `.claude/settings.json` とローカル `.claude/settings.local.json` から `mask` エントリを削除します。2461* **Scope**: [`Any file`](#scopes)。Claude Code はプロジェクト `.claude/settings.json` とローカル `.claude/settings.local.json` から `mask` エントリを削除します。
2374* **Type**: オブジェクトの配列。各オブジェクトは `name` と `"deny"` または `"mask"` の `mode`、および optional [環境変数のマスクフィールド](#mask-fields-for-environment-variables)2462* **Type**: オブジェクトの配列。各オブジェクトは `name` と `"deny"` または `"mask"` の `mode`、および optional [環境変数のマスクフィールド](#mask-fields-for-environment-variables)を含みます
2375* **Default**: 未設定。環境変数は保護されません2463* **Default**: 未設定。環境変数は保護されません
2376 2464
2377これは `NPM_TOKEN` をサンドボックス化されたコマンドから削除し、`GITHUB_TOKEN` をマスクします。実際の値は `api.github.com` へのリクエストでのみ置き換えられます:2465これにより、`NPM_TOKEN` がサンドボックス化されたコマンドから削除され、`GITHUB_TOKEN` がマスクされ、実際の値は `api.github.com` へのリクエストでのみ置き換えられます:
2378 2466
2379```json settings.json theme={null}2467```json settings.json theme={null}
2380{2468{
2389}2477}
2390```2478```
2391 2479
2392`name` は文字、アンダースコアで始まり、文字、数字、アンダースコアのみを含む必要があります。Claude Code はセッションが読み込むすべての設定スコープから配列をマージし、同じ変数が両方のモードで表示される場合は `deny` を適用します。[認証情報を保護する](/docs/ja/sandboxing#protect-credentials)は `--setting-sources` で除外するソースから何が引き続き適用されるかをカバーしています。`mask` エントリは v2.1.199 以降が必要です。2480`name` は文字または下線で始まり、文字、数字、下線のみを含む必要があります。Claude Code はセッションが読み込むすべての設定スコープから配列をマージし、同じ変数が両方のモードで表示される場合は `deny` を適用します。[認証情報を保護する](/docs/ja/sandboxing#protect-credentials)は、`--setting-sources` で除外するソースから何が引き続き適用されるかをカバーしています。`mask` エントリには Claude Code v2.1.199 以降が必要です。
2393 2481
2394`mask` 置き換えはサンドボックスプロキシを通じてのみ実行されるため、[`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate) を設定するか、プレーン HTTP テストネットワークの場合は [`allowPlaintextInject`](#sandbox-credentials-allowplaintextinject) を設定してください。[環境変数をマスクする](/docs/ja/sandboxing#mask-environment-variables)を参照してください。Claude Code は `deny` エントリの `mask` フィールドを受け入れますが無視します。2482`mask` 置換はサンドボックスプロキシを通じてのみ実行されるため、[`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate)、または プレーン HTTP テストネットワークの場合は [`allowPlaintextInject`](#sandbox-credentials-allowplaintextinject) を設定します。[環境変数をマスクする](/docs/ja/sandboxing#mask-environment-variables)を参照してください。Claude Code は `deny` エントリの `mask` フィールドを受け入れますが、無視します。
2395 2483
2396<span id="sandbox-credentials-envvars-extract" />2484<span id="sandbox-credentials-envvars-extract" />
2397 2485
2407 環境変数のマスクフィールド2495 環境変数のマスクフィールド
2408</h4>2496</h4>
2409 2497
2410`mask` エントリはこれらの optional フィールドを受け入れます。`extract` または `decode` がない場合、Claude Code は値全体を 1 つのセンチネルで置き換えます。`extract` と `decode` は同じエントリで組み合わせることはできません。2498`mask` エントリはこれらの optional フィールドを受け入れます。`extract` または `decode` がない場合、Claude Code は全体の値を 1 つのセンチネルで置き換えます。`extract` と `decode` は同じエントリで組み合わせることはできません。
2411 2499
2412| フィールド | 型 | 何をするか |2500| フィールド | 型 | 何をするか |
2413| :- | :- | :- |2501| :- | :- | :- |
2414| `extract` | 文字列。少なくとも 1 つのキャプチャグループを持つ正規表現 | 各マッチのグループ 1 でキャプチャされたテキストのみをマスクします。`DATABASE_URL` 接続文字列内のパスワードなど。値の残りは解析可能なままです。v2.1.224 以降が必要です |2502| `extract` | 文字列。少なくとも 1 つのキャプチャグループを持つ正規表現 | 各一致のグループ 1 でキャプチャされたテキストのみをマスクします。例えば、`DATABASE_URL` 接続文字列内のパスワード。値の残りは解析可能なままです。v2.1.224 以降が必要です |
2415| `onExtractNoMatch` | `"warn"`、`"deny"`、または `"error"`。デフォルト `"warn"`。`decode` を含むエントリでは、`"warn"` のみが受け入れられます | `extract` が何も一致しない場合に何が起こるか。`warn` は変数をマスクなしで渡し、`deny` はサンドボックス内でそれをアンセットし、`error` は設定を修正するまでサンドボックスセットアップを停止します。v2.1.224 以降が必要です |2503| `onExtractNoMatch` | `"warn"`、`"deny"`、または `"error"`。デフォルト `"warn"`。`decode` を持つエントリでは、`"warn"` のみが受け入れられます | `extract` が何も一致しない場合に何が起こるか。`warn` は変数をマスクなしで渡し、`deny` はサンドボックス内でそれをアンセットし、`error` は設定を修正するまでサンドボックスセットアップを停止します。v2.1.224 以降が必要です |
2416| `decode` | 文字列 `"jwt"` | 値全体が JWT であることを検証し、構造的に有効な偽トークンで置き換えます。サンドボックス内のコードがトークンをデコードし続けるようにします。プロキシは出力時に実際のトークン全体を置き換えます。検証されない値はマスクなしで警告とともに渡されます。v2.1.224 以降が必要です |2504| `decode` | 文字列 `"jwt"` | 全体の値が JWT であることを検証し、構造的に有効な偽のトークンで置き換えます。サンドボックス内のコードがトークンをデコードし続けるようにします。プロキシは出力時に全体の実際のトークンを置き換えます。検証されない値は警告とともにマスクなしで渡されます。v2.1.224 以降が必要です |
2417| `maskClaims` | 文字列の配列。少なくとも 1 つのクレーム名。`decode` が必要 | デコードされた JWT 内の名前付きトップレベルペイロードクレームのみをマスクし、変更されたペイロードの周りにトークンを再構築します。他のクレームは読み取り可能なままです。名前付きクレームが一致しない場合、変数は警告とともにマスクなしで渡されます。v2.1.224 以降が必要です |2505| `maskClaims` | 文字列の配列。少なくとも 1 つのクレーム名。`decode` が必要 | デコードされた JWT 内の名前付きトップレベルペイロードクレームのみをマスクし、変更されたペイロードの周りにトークンを再構築します。他のクレームは読み取り可能なままです。名前付きクレームが一致しない場合、変数は警告とともにマスクなしで渡されます。v2.1.224 以降が必要です |
2418| `injectHosts` | 文字列の配列。各ホストは [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) も認めます | サンドボックスプロキシが実際の値を置き換えるホストを絞ります。未設定の場合、プロキシは `sandbox.network.allowedDomains` のすべてのホストへのリクエストで置き換えます。IPv6 宛先を括弧で囲まれた形式ではなく、`"::1"` などの裸の圧縮アドレスとして書きます。[`injectHosts` の IPv6 宛先](/docs/ja/sandboxing#ipv6-destinations-in-injecthosts)を参照してください。v2.1.199 以降が必要です |2506| `injectHosts` | 文字列の配列。各ホストは [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) も認めます | サンドボックスプロキシが実際の値を置き換えるホストを絞ります。未設定の場合、プロキシは `sandbox.network.allowedDomains` のすべてのホストへのリクエストで置き換えます。IPv6 宛先を裸の圧縮アドレスとして書き込みます。例えば、`"::1"`。括弧形式ではなく。[`injectHosts` の IPv6 宛先](/docs/ja/sandboxing#ipv6-destinations-in-injecthosts)を参照してください。v2.1.199 以降が必要です |
2419 2507
2420これは `DATABASE_URL` 内のパスワードのみをマスクし、パターンが何も一致しない場合は変数をアンセットし、`SERVICE_JWT` の JWT をマスクします。`api_key` を除くすべてのクレームは読み取り可能なままです:2508これにより、`DATABASE_URL` 内のパスワードのみがマスクされ、パターンが何も一致しない場合は変数がアンセットされ、`SERVICE_JWT` の JWT がマスクされます。`api_key` を除くすべてのクレームは読み取り可能なままです:
2421 2509
2422```json settings.json theme={null}2510```json settings.json theme={null}
2423{2511{
2446 `sandbox.credentials.allowPlaintextInject`2534 `sandbox.credentials.allowPlaintextInject`
2447</h3>2535</h3>
2448 2536
2449TLS 終了 HTTPS だけでなく、プレーン HTTP リクエストでも `mask` 置き換えを許可します。プレーン HTTP では上流の ID は未検証で、認証情報はクリアテキストで移動するため、信頼できるテストネットワーク外ではこれをオフのままにしてください。Claude Code v2.1.199 以降が必要です。2537TLS 終了 HTTPS だけでなく、プレーン HTTP リクエストでも `mask` 置換を許可します。プレーン HTTP では、アップストリーム ID は検証されず、認証情報はクリアテキストで移動するため、信頼できるテストネットワーク外ではこれをオフのままにします。Claude Code v2.1.199 以降が必要です。
2450 2538
2451* **Scope**: [`User or managed`](#scopes)2539* **Scope**: [`User or managed`](#scopes)
2452* **Type**: ブール値2540* **Type**: ブール値
2453 * `true`: Claude Code は TLS 終了 HTTPS だけでなく、プレーン HTTP リクエストでも `mask` 置き換えを許可します2541 * `true`: Claude Code はプレーン HTTP リクエストと TLS 終了 HTTPS の両方で `mask` 置換を許可します
2454 * `false`: Claude Code は TLS 終了 HTTPS でのみ `mask` 置き換えを許可します2542 * `false`: Claude Code は TLS 終了 HTTPS でのみ `mask` 置換を許可します
2455* **Default**: `false`2543* **Default**: `false`
2456 2544
2457```json settings.json theme={null}2545```json settings.json theme={null}
2470 `sandbox.credentials.awsPairs`2558 `sandbox.credentials.awsPairs`
2471</h3>2559</h3>
2472 2560
2473マスクされた環境変数をグループ化して、認証情報が非標準の名前の変数に存在する場合、[SigV4 再署名](/docs/ja/sandboxing#re-sign-aws-requests)用に 1 つの AWS 認証情報を形成します。Claude Code は、従来の `AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、`AWS_SESSION_TOKEN` トリオを自動的にリンクします。値全体をマスクする場合、他の名前の場合にのみこのキーが必要です。Claude Code v2.1.224 以降が必要です。2561マスクされた環境変数をグループ化して、認証情報が非標準の名前の変数に存在する場合、[SigV4 再署名](/docs/ja/sandboxing#re-sign-aws-requests)用に 1 つの AWS 認証情報を形成します。Claude Code は、従来の `AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、`AWS_SESSION_TOKEN` トリオを全体の値をマスクする場合、自動的にリンクするため、他の名前の場合にのみこのキーが必要です。Claude Code v2.1.224 以降が必要です。
2474 2562
2475* **Scope**: [`User or managed`](#scopes)2563* **Scope**: [`User or managed`](#scopes)
2476* **Type**: オブジェクトの配列。各オブジェクトは `accessKeyIdVar`、`secretAccessKeyVar`、および optional `sessionTokenVar` を含み、`sandbox.credentials.envVars` エントリに名前を付けます2564* **Type**: オブジェクトの配列。各オブジェクトは `accessKeyIdVar`、`secretAccessKeyVar`、および optional `sessionTokenVar` を含み、`sandbox.credentials.envVars` エントリに名前を付けます
2477* **Default**: 未設定。従来のトリオのみがペアになります2565* **Default**: 未設定。従来のトリオのみがペアになります
2478 2566
2479これは 3 つのカスタム名の変数を 1 つの AWS 認証情報にリンクして再署名します:2567これにより、3 つのカスタム名の変数が 1 つの AWS 認証情報にリンクされ、再署名されます:
2480 2568
2481```json settings.json theme={null}2569```json settings.json theme={null}
2482{2570{
2494}2582}
2495```2583```
2496 2584
2497各名前付き変数は [`sandbox.credentials.envVars`](#sandbox-credentials-envvars) の全値 `mask` エントリである必要があり、`extract` または `decode` なしで、すべてのペアで 1 つのスロットのみを埋めることができます。2585各名前付き変数は [`sandbox.credentials.envVars`](#sandbox-credentials-envvars) の全体値 `mask` エントリである必要があり、`extract` または `decode` なしで、すべてのペアで 1 つのスロットのみを埋めることができます。
2498 2586
2499<h3 id="sandbox-credentials-sigv4">2587<h3 id="sandbox-credentials-sigv4">
2500 `sandbox.credentials.sigv4`2588 `sandbox.credentials.sigv4`
2501</h3>2589</h3>
2502 2590
2503サンドボックスプロキシが[再署名できない](/docs/ja/sandboxing#re-sign-aws-requests)AWS リクエストフォームで何をするかを選択します:`streaming` は aws-chunked ストリーミングアップロード、`presigned` は事前署名 URL、`sigv4a` は SigV4A 非対称署名。これは、マスクされたペアのプレースホルダーアクセスキー ID で署名されたリクエストにのみ適用されます。Claude Code v2.1.224 以降が必要です。2591サンドボックスプロキシが [再署名できない](/docs/ja/sandboxing#re-sign-aws-requests)AWS リクエスト形式で何をするかを選択します:`streaming` は aws-chunked ストリーミングアップロード、`presigned` は事前署名 URL、`sigv4a` は SigV4A 非対称署名です。これは、マスクされたペアのプレースホルダーアクセスキー ID で署名されたリクエストにのみ適用されます。Claude Code v2.1.224 以降が必要です。
2504 2592
2505* **Scope**: [`User or managed`](#scopes)2593* **Scope**: [`User or managed`](#scopes)
2506* **Type**: `streaming`、`presigned`、`sigv4a` を含むオブジェクト。各オブジェクトは以下のいずれか:2594* **Type**: `streaming`、`presigned`、`sigv4a` を含むオブジェクト。各オブジェクトは以下のいずれかです:
2507 * `"deny"`: プロキシはリクエストを失敗させます2595 * `"deny"`: プロキシはリクエストを失敗させます
2508 * `"passthrough"`: プロキシはマスクされたプレースホルダーで署名されたリクエストを転送するため、ツールは AWS 自体の拒否を受け取ります2596 * `"passthrough"`: プロキシはマスクされたプレースホルダーで署名されたリクエストを転送するため、ツールは AWS 自体の拒否を受け取ります
2509* **Default**: 未設定。すべてのフォームは `"deny"` です2597* **Default**: 未設定。すべての形式は `"deny"` です
2510 2598
2511これはストリーミングアップロードを失敗させる代わりに転送します:2599これにより、ストリーミングアップロードはプロキシで失敗する代わりに転送されます:
2512 2600
2513```json settings.json theme={null}2601```json settings.json theme={null}
2514{2602{
2522}2610}
2523```2611```
2524 2612
2525`deny` の場合、プロキシはリクエストを失敗させます。`passthrough` の場合、プロキシはマスクされたプレースホルダーで署名されたリクエストを転送するため、AWS はそれを拒否し、呼び出しツールはプロキシエラーの代わりに AWS 自体の応答を受け取ります。2613`deny` の場合、プロキシはリクエストを失敗させます。`passthrough` の場合、プロキシはマスクされたプレースホルダーから計算された署名でリクエストを転送するため、AWS はそれを拒否し、呼び出しツールはプロキシエラーの代わりに AWS 自体の応答を受け取ります。
2526 2614
2527<h3 id="sandbox-network">2615<h3 id="sandbox-network">
2528 `sandbox.network`2616 `sandbox.network`
2534* **Type**: 以下のサブキーを含むオブジェクト2622* **Type**: 以下のサブキーを含むオブジェクト
2535* **Default**: 未設定。ドメインは事前に許可されず、サンドボックスは各新しいホストについてプロンプトします2623* **Default**: 未設定。ドメインは事前に許可されず、サンドボックスは各新しいホストについてプロンプトします
2536 2624
2537これは GitHub と npm を事前に許可し、`uploads.github.com` をブロックし、コマンドが localhost にバインドできるようにします:2625これにより、GitHub と npm が事前に許可され、`uploads.github.com` がブロックされ、コマンドが localhost にバインドできます:
2538 2626
2539```json settings.json theme={null}2627```json settings.json theme={null}
2540{2628{
2554 `sandbox.network.allowUnixSockets`2642 `sandbox.network.allowUnixSockets`
2555</h3>2643</h3>
2556 2644
2557macOS でサンドボックス化されたコマンドが接続できる Unix ソケットパスをリストします。Claude Code は Linux と WSL2 でこのリストを無視します。seccomp フィルタはソケットパスを検査できません。代わりに [`allowAllUnixSockets`](#sandbox-network-allowallunixsockets) を使用してください。2645macOS でサンドボックス化されたコマンドが接続できる Unix ソケットパスをリストします。Claude Code は Linux と WSL2 でこのリストを無視します。seccomp フィルタはソケットパスを検査できません。代わりに [`allowAllUnixSockets`](#sandbox-network-allowallunixsockets) を使用します。
2558 2646
2559* **Scope**: [`Any file`](#scopes)2647* **Scope**: [`Any file`](#scopes)
2560* **Type**: 文字列の配列。各文字列はソケットパス2648* **Type**: 文字列の配列。各ソケットパス
2561* **Default**: 未設定。macOS サンドボックスはすべての Unix ソケットをブロックします2649* **Default**: 未設定。macOS サンドボックスはすべての Unix ソケットをブロックします
2562 2650
2563```json settings.json theme={null}2651```json settings.json theme={null}
2570}2658}
2571```2659```
2572 2660
2573ソケットパスは広いアクセスを許可できます:`/var/run/docker.sock` を許可すると、たとえば、サンドボックス化されたコマンドが Docker デーモンを制御できます。[セキュリティ制限](/docs/ja/sandboxing#security-limitations)を参照してください。2661ソケットパスは広いアクセスを許可できます。たとえば、`/var/run/docker.sock` を許可すると、サンドボックス化されたコマンドが Docker デーモンを制御できます。[セキュリティ制限](/docs/ja/sandboxing#security-limitations)を参照してください。
2574 2662
2575<h3 id="sandbox-network-allowallunixsockets">2663<h3 id="sandbox-network-allowallunixsockets">
2576 `sandbox.network.allowAllUnixSockets`2664 `sandbox.network.allowAllUnixSockets`
2577</h3>2665</h3>
2578 2666
2579サンドボックス化されたコマンドがすべての Unix ソケットに接続できるようにします。Linux と WSL2 では、サンドボックスの [seccomp フィルタ](/docs/ja/sandboxing#set-up-linux-and-wsl2)は `socket(AF_UNIX, ...)` 呼び出しをブロックするため、これが Unix ソケットを許可する唯一の方法です。フィルタが不足している場合(`/sandbox` がその Dependencies タブで報告します)、サンドボックスは Unix ソケット呼び出しをブロックしません。[Linux と WSL2 をセットアップする](/docs/ja/sandboxing#set-up-linux-and-wsl2)を参照して、フィルタがどこから来るかを確認してください。2667サンドボックス化されたコマンドがすべての Unix ソケットに接続できるようにします。Linux と WSL2 では、サンドボックスの [seccomp フィルタ](/docs/ja/sandboxing#set-up-linux-and-wsl2) は `socket(AF_UNIX, ...)` 呼び出しをブロックするため、これは Unix ソケットを許可する唯一の方法です。フィルタが不足している場合(`/sandbox` がその Dependencies タブで報告する場合)、サンドボックスは Unix ソケット呼び出しをブロックしません。[Linux と WSL2 をセットアップする](/docs/ja/sandboxing#set-up-linux-and-wsl2)を参照して、フィルタがどこから来るかを確認してください。
2580 2668
2581* **Scope**: [`Any file`](#scopes)2669* **Scope**: [`Any file`](#scopes)
2582* **Type**: ブール値2670* **Type**: ブール値
2583 * `true`: サンドボックス化されたコマンドはすべての Unix ソケットに接続できます2671 * `true`: サンドボックス化されたコマンドはすべての Unix ソケットに接続できます
2584 * `false`: サンドボックスは Unix ソケット接続をブロックします:macOS では `allowUnixSockets` のパスを除き、Linux と WSL2 では seccomp フィルタが存在する場合はそれを通じて2672 * `false`: サンドボックスは Unix ソケット接続をブロックします:macOS では `allowUnixSockets` のパスを除き、Linux と WSL2 ではフィルタが存在する場合は seccomp フィルタを通じて
2585* **Default**: `false`2673* **Default**: `false`
2586 2674
2587```json settings.json theme={null}2675```json settings.json theme={null}
2594}2682}
2595```2683```
2596 2684
2597WSL2 では、`true` は `cmd.exe` と `powershell.exe` などの Windows バイナリを起動する相互運用ソケットも再度開きます。2685WSL2 では、`true` は `cmd.exe` や `powershell.exe` などの Windows バイナリを起動する相互運用ソケットも再度開きます。
2598 2686
2599<h3 id="sandbox-network-allowlocalbinding">2687<h3 id="sandbox-network-allowlocalbinding">
2600 `sandbox.network.allowLocalBinding`2688 `sandbox.network.allowLocalBinding`
2601</h3>2689</h3>
2602 2690
2603macOS でサンドボックス化されたコマンドが localhost ポートにバインドできるようにします。たとえば、開発サーバーを起動するため。2691macOS でサンドボックス化されたコマンドが localhost ポートにバインドできるようにします。例えば、開発サーバーを起動するためです。
2604 2692
2605* **Scope**: [`Any file`](#scopes)2693* **Scope**: [`Any file`](#scopes)
2606* **Type**: ブール値2694* **Type**: ブール値
2622 `sandbox.network.allowMachLookup`2710 `sandbox.network.allowMachLookup`
2623</h3>2711</h3>
2624 2712
2625macOS サンドボックスが検索できる追加の XPC および Mach サービス名をリストします。iOS Simulator または Playwright などの XPC を通じて通信するツールは、ここにサービスをリストする必要があります。2713macOS サンドボックスが検索できる追加の XPC および Mach サービス名をリストします。iOS Simulator や Playwright などの XPC を通じて通信するツールは、ここにサービスをリストする必要があります。
2626 2714
2627* **Scope**: [`Any file`](#scopes)2715* **Scope**: [`Any file`](#scopes)
2628* **Type**: 文字列の配列。各文字列はサービス名。単一の末尾 `*` はプレフィックスと一致し、`"*"` 単独はすべてのサービスと一致します2716* **Type**: 文字列の配列。各サービス名。単一の末尾 `*` はプレフィックスと一致し、`"*"` だけはすべてのサービスと一致します
2629* **Default**: 未設定2717* **Default**: 未設定
2630 2718
2631これは `com.apple.coresimulator.` プレフィックスの下のすべてのサービスを許可します:2719これにより、`com.apple.coresimulator.` プレフィックスの下のすべてのサービスが許可されます:
2632 2720
2633```json settings.json theme={null}2721```json settings.json theme={null}
2634{2722{
2644 `sandbox.network.allowedDomains`2732 `sandbox.network.allowedDomains`
2645</h3>2733</h3>
2646 2734
2647サンドボックス化されたコマンドからの送信トラフィックのドメインを事前に許可し、サンドボックスがそれらについてプロンプトしないようにします。`*.example.com` などのワイルドカードはサブドメインと一致し、optional `:port` サフィックスはエントリを 1 つのポートに制限します。ポートのないエントリはすべてのポートと一致します。2735サンドボックス化されたコマンドからの送信トラフィック用にドメインを事前に許可するため、サンドボックスはそれらについてプロンプトしません。`*.example.com` などのワイルドカードはサブドメインと一致し、optional `:port` サフィックスはエントリを 1 つのポートに制限します。ポートなしのエントリはすべてのポートと一致します。
2648 2736
2649* **Scope**: [`Any file`](#scopes)。[`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly)が設定されている場合、管理設定のみ。2737* **Scope**: [`Any file`](#scopes)。[`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly)が設定されている場合、管理設定のみ。
2650* **Type**: 文字列の配列。各文字列はドメイン、ワイルドカードパターン、または IP リテラル。optional `:port` サフィックス2738* **Type**: 文字列の配列。各ドメイン、ワイルドカードパターン、または IP リテラル。optional `:port` サフィックス付き
2651* **Default**: 未設定。サンドボックスは新しいホストに初めて到達するときにプロンプトします2739* **Default**: 未設定。サンドボックスは新しいホストに初めて到達するときにプロンプトします
2652 2740
2653これは GitHub をすべてのポートで事前に許可し、すべての npm サブドメイン、および 1 つの API ホストをポート 443 のみで事前に許可します:2741これにより、GitHub がすべてのポートで事前に許可され、すべての npm サブドメイン、および 1 つの API ホストがポート 443 でのみ許可されます:
2654 2742
2655```json settings.json theme={null}2743```json settings.json theme={null}
2656{2744{
2662}2750}
2663```2751```
2664 2752
2665IPv6 リテラルを括弧で囲んで書き、optional ポート:`"[::1]"` はすべてのポートを許可し、`"[::1]:443"` は 1 つのポートを許可します。括弧で囲まれた形式は Claude Code v2.1.229 以降が必要です。[ドメインリストの IPv6 アドレス](/docs/ja/sandboxing#ipv6-addresses-in-domain-lists)を参照してください。2753IPv6 リテラルを括弧で囲んで書き込みます。optional ポート付き:`"[::1]"` はすべてのポートを許可し、`"[::1]:443"` は 1 つのポートを許可します。括弧形式には Claude Code v2.1.229 以降が必要です。[ドメインリストの IPv6 アドレス](/docs/ja/sandboxing#ipv6-addresses-in-domain-lists)を参照してください。
2666 2754
2667<h3 id="sandbox-network-denieddomains">2755<h3 id="sandbox-network-denieddomains">
2668 `sandbox.network.deniedDomains`2756 `sandbox.network.deniedDomains`
2669</h3>2757</h3>
2670 2758
2671[`allowedDomains`](#sandbox-network-alloweddomains)と同じワイルドカード、ポート、IPv6 構文を使用して、サンドボックス化されたコマンドからの送信トラフィックのドメインをブロックします。拒否されたドメインは、`allowedDomains` エントリも一致する場合でもブロックされたままです。2759[`allowedDomains`](#sandbox-network-alloweddomains)と同じワイルドカード、ポート、IPv6 構文を使用して、サンドボックス化されたコマンドからの送信トラフィック用にドメインをブロックします。拒否されたドメインは、`allowedDomains` エントリも一致する場合でもブロックされたままです。
2672 2760
2673* **Scope**: [`Any file`](#scopes)2761* **Scope**: [`Any file`](#scopes)
2674* **Type**: 文字列の配列。各文字列はドメイン、ワイルドカードパターン、または IP リテラル。optional `:port` サフィックス2762* **Type**: 文字列の配列。各ドメイン、ワイルドカードパターン、または IP リテラル。optional `:port` サフィックス付き
2675* **Default**: 未設定2763* **Default**: 未設定
2676 2764
2677```json settings.json theme={null}2765```json settings.json theme={null}
2684}2772}
2685```2773```
2686 2774
2687Claude Code は `allowManagedDomainsOnly` が設定されている場合でも、セッションが読み込むすべての設定ソースからこのリストをマージするため、開発者は常に拒否リストを厳しくできます。IPv6 リテラルについては、[ドメインリストの IPv6 アドレス](/docs/ja/sandboxing#ipv6-addresses-in-domain-lists)を参照してください。2775Claude Code はセッションが読み込むすべての設定ソースからこのリストをマージします。`allowManagedDomainsOnly` が設定されている場合でも、開発者は常に拒否リストを厳しくできます。IPv6 リテラルについては、[ドメインリストの IPv6 アドレス](/docs/ja/sandboxing#ipv6-addresses-in-domain-lists)を参照してください。
2688 2776
2689完全修飾ドメイン名をマークする末尾ドット(`example.com.` など)で書かれたエントリは、`example.com` と同じ接続をブロックします。2777完全修飾ドメイン名をマークする末尾ドット(`example.com.` など)で書き込まれたエントリは、`example.com` と同じ接続をブロックします。
2690 2778
2691<h3 id="sandbox-network-strictallowlist">2779<h3 id="sandbox-network-strictallowlist">
2692 `sandbox.network.strictAllowlist`2780 `sandbox.network.strictAllowlist`
2693</h3>2781</h3>
2694 2782
2695許可リスト外のホストへのアクセスをプロンプトする代わりにサンドボックス化されたコマンドを拒否します。許可リストは [`allowedDomains`](#sandbox-network-alloweddomains) プラス `WebFetch(domain:...)` 許可ルールからのドメイン、または [`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly)が設定されている場合は管理設定エントリのみです。Claude Code v2.1.219 以降が必要です。2783許可リスト外のホストへのアクセスをプロンプトする代わりにブロックします。許可リストは [`allowedDomains`](#sandbox-network-alloweddomains) と `WebFetch(domain:...)` 許可ルールからのドメイン、または [`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly) が設定されている場合は管理設定エントリのみです。Claude Code v2.1.219 以降が必要です。
2696 2784
2697* **Scope**: [`User or managed`](#scopes)。リポジトリはそれをオンまたはオフにすることはできません。2785* **Scope**: [`User or managed`](#scopes)。リポジトリはそれをオンまたはオフにできません。
2698* **Type**: ブール値2786* **Type**: ブール値
2699 * `true`: Claude Code は許可リスト外のホストへのサンドボックス化されたコマンドアクセスを拒否します2787 * `true`: Claude Code は許可リスト外のホストへのサンドボックス化されたコマンドアクセスを拒否します
2700 * `false`: 別の信頼できる設定ファイルが `true` を設定しない限り、Claude Code は許可リスト外のホストを権限モードの代わりに拒否する代わりに決定します:自動モードでコマンドの[コマンドごとの許可ドメイン](/docs/ja/sandboxing#per-command-allowed-domains-in-auto-mode)に対して確認し、`dontAsk` モードで拒否し、`bypassPermissions` モードで許可し、インタラクティブターミナルプランモードセッションでバイパスが利用可能な場合、それ以外の場合は尋ねます2788 * `false`: 別の信頼できる設定ファイルが `true` を設定しない限り、Claude Code は許可リスト外のホストを権限モードの代わりに決定します:自動モードではコマンドの[コマンドごとの許可ドメイン](/docs/ja/sandboxing#per-command-allowed-domains-in-auto-mode)に対してホストをチェックし、`dontAsk` モードではブロックし、`bypassPermissions` モードおよび バイパスが利用可能なインタラクティブターミナルプランモードセッションでは許可し、それ以外の場合は尋ねます
2701* **Default**: `false`2789* **Default**: `false`
2702 2790
2703```json settings.json theme={null}2791```json settings.json theme={null}
2710}2798}
2711```2799```
2712 2800
2713Claude Code はサンドボックス化されたコマンドに対してのみこれを強制します。`WebFetch` などのインプロセスツールは引き続き[権限ルール](/docs/ja/sandboxing#permission-rules)に従います。尊重されるソースのいずれかが `true` に設定する場合、それはオンのままです。[ネットワーク分離](/docs/ja/sandboxing#network-isolation)を参照してください。Claude Code v2.1.219 以降が必要です。2801Claude Code はサンドボックス化されたコマンドのみに対してこれを強制します。`WebFetch` などのインプロセスツールは引き続き[権限ルール](/docs/ja/sandboxing#permission-rules)に従います。尊重されるソースのいずれかが `true` に設定する場合、それはオンのままです。[ネットワーク分離](/docs/ja/sandboxing#network-isolation)を参照してください。Claude Code v2.1.219 以降が必要です。
2714 2802
2715<h3 id="sandbox-network-allowmanageddomainsonly">2803<h3 id="sandbox-network-allowmanageddomainsonly">
2716 `sandbox.network.allowManagedDomainsOnly`2804 `sandbox.network.allowManagedDomainsOnly`
2720 2808
2721* **Scope**: [`Managed`](#scopes)2809* **Scope**: [`Managed`](#scopes)
2722* **Type**: ブール値2810* **Type**: ブール値
2723 * `true`: Claude Code は管理設定からの `allowedDomains` と `WebFetch(domain:...)` 許可ルールのみを尊重し、許可されていないドメインをプロンプトする代わりにブロックします2811 * `true`: Claude Code は管理設定からの `allowedDomains` と `WebFetch(domain:...)` 許可ルールのみを尊重し、許可されていないドメインをブロックする代わりにプロンプトします
2724 * `false`: ユーザー、プロジェクト、ローカル、`--settings` 設定からのドメインが許可リストにマージされます2812 * `false`: ユーザー、プロジェクト、ローカル、`--settings` 設定からのドメインが許可リストにマージされます
2725* **Default**: `false`2813* **Default**: `false`
2726 2814
2727これは許可リストを GitHub と npm にロックし、開発者が追加するドメインを無視します:2815これにより、許可リストが GitHub と npm にロックされ、開発者が追加するドメインが無視されます:
2728 2816
2729```json managed-settings.json theme={null}2817```json managed-settings.json theme={null}
2730{2818{
2737}2825}
2738```2826```
2739 2827
2740拒否されたドメインはセッションが読み込むすべてのソースからマージされます。[開発者がポリシーを拡大するのを防ぐ](/docs/ja/sandboxing#keep-developers-from-widening-the-policy)を参照してください。2828拒否されたドメインはセッションが読み込むすべてのソースからマージされます。[ポリシーの拡大を開発者に防止させる](/docs/ja/sandboxing#keep-developers-from-widening-the-policy)を参照してください。
2741 2829
2742<h3 id="sandbox-network-httpproxyport">2830<h3 id="sandbox-network-httpproxyport">
2743 `sandbox.network.httpProxyPort`2831 `sandbox.network.httpProxyPort`
2744</h3>2832</h3>
2745 2833
2746Claude Code が実行するものの代わりに、独自の HTTP プロキシをサンドボックスに指定します。組織はこれを行って HTTPS トラフィックを検査し、独自のフィルタリングルールを適用するか、すべてのリクエストをログします。未設定の場合、Claude Code は HTTP トラフィック用に独自のプロキシを起動します。2834Claude Code が実行するものの代わりに、独自の HTTP プロキシをサンドボックスに指定します。組織はこれを行って、HTTPS トラフィックを検査し、独自のフィルタリングルールを適用するか、すべてのリクエストをログします。未設定の場合、Claude Code は HTTP トラフィック用に独自のプロキシを起動します。
2747 2835
2748* **Scope**: [`Any file`](#scopes)2836* **Scope**: [`Any file`](#scopes)
2749* **Type**: 数値。ローカル TCP ポート2837* **Type**: 数値。ローカル TCP ポート
2759}2847}
2760```2848```
2761 2849
2762プロキシが SOCKS トラフィックも実行する場合は、[`socksProxyPort`](#sandbox-network-socksproxyport)も設定してください。2 つのうち 1 つだけが設定されている場合、Claude Code は他のプロトコル用に独自のプロキシを実行します。[カスタムプロキシ設定](/docs/ja/sandboxing#custom-proxy-configuration)を参照してください。2850プロキシが SOCKS トラフィックも実行する場合は、[`socksProxyPort`](#sandbox-network-socksproxyport)も設定します。2 つのうち 1 つだけが設定されている場合、Claude Code は他のプロトコル用に独自のプロキシを実行します。[カスタムプロキシ設定](/docs/ja/sandboxing#custom-proxy-configuration)を参照してください。
2763 2851
2764<h3 id="sandbox-network-socksproxyport">2852<h3 id="sandbox-network-socksproxyport">
2765 `sandbox.network.socksProxyPort`2853 `sandbox.network.socksProxyPort`
2787 `sandbox.network.tlsTerminate`2875 `sandbox.network.tlsTerminate`
2788</h3>2876</h3>
2789 2877
2790サンドボックスプロキシが TLS を終了して HTTPS リクエストの内容を読み取ることができるようにします。これは実験的で、`mask` [認証情報置き換え](/docs/ja/sandboxing#mask-credentials)はそれを必要とします。`{}` を設定してセッション用に一時的な認証局を生成するか、`caCertPath` と `caKeyPath` を設定して独自のものを使用します。2878サンドボックスプロキシが TLS を終了して、HTTPS リクエストの内容を読み取ることができるようにします。これは実験的であり、`mask` [認証情報置換](/docs/ja/sandboxing#mask-credentials)はそれを必要とします。`{}` を設定してセッション用に一時的な認証局を生成するか、`caCertPath` と `caKeyPath` を設定して独自のものを使用します。
2791 2879
2792* **Scope**: [`User or managed`](#scopes)。リポジトリはそれをオンにするか、認証局を提供することはできません。2880* **Scope**: [`User or managed`](#scopes)。リポジトリはそれをオンにするか、認証局を提供できません。
2793* **Type**: optional `caCertPath` と `caKeyPath` 文字列を含むオブジェクト。各文字列はファイルパス2881* **Type**: optional `caCertPath` と `caKeyPath` 文字列を含むオブジェクト。各ファイルパス
2794* **Default**: 未設定。プロキシは TLS を終了または検査しません2882* **Default**: 未設定。プロキシは TLS を終了または検査しません
2795 2883
2796```json settings.json theme={null}2884```json settings.json theme={null}
3015* [`CLAUDE_CODE_MESSAGING_SOCKET` と `CLAUDE_CODE_MESSAGING_TOKEN`](/docs/ja/env-vars#variables)。Claude Code 自体がエクスポートするものは、すべてのファイルから無視されます。ソケット変数を無視するには Claude Code v2.1.224 以降が必要で、トークンを無視するには v2.1.228 以降が必要です。3103* [`CLAUDE_CODE_MESSAGING_SOCKET` と `CLAUDE_CODE_MESSAGING_TOKEN`](/docs/ja/env-vars#variables)。Claude Code 自体がエクスポートするものは、すべてのファイルから無視されます。ソケット変数を無視するには Claude Code v2.1.224 以降が必要で、トークンを無視するには v2.1.228 以降が必要です。
3016* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ja/sessions#name-the-project-directory-yourself)。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。v2.1.234 以降が必要です。3104* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ja/sessions#name-the-project-directory-yourself)。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。v2.1.234 以降が必要です。
3017* [`CLAUDE_CODE_RESTRICTED`](/docs/ja/env-vars#variables)。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。3105* [`CLAUDE_CODE_RESTRICTED`](/docs/ja/env-vars#variables)。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。
3106* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](/docs/ja/env-vars#variables)。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。この変数には Claude Code v2.1.283 以降が必要です。
3107* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` と `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`](/docs/ja/env-vars#variables)。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。
3018 3108
3019<h3 id="filecheckpointingenabled">3109<h3 id="filecheckpointingenabled">
3020 `fileCheckpointingEnabled`3110 `fileCheckpointingEnabled`
3109 `askUserQuestionTimeout`3199 `askUserQuestionTimeout`
3110</h3>3200</h3>
3111 3201
3112回答されていない [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログがアイドル時間の経過後に自動的に続行し、既に選択していたオプションを送信するようにします。席を離れて Claude に続行させたい場合に設定します。デフォルトでは、質問は回答されるまで待機します。Claude Code v2.1.200 以降が必要です。3202回答されていない[`AskUserQuestion`](/docs/ja/tools-reference)ダイアログがアイドル時間の経過後に自動的に続行し、既に選択していたオプションを送信するようにします。席を離れて Claude に続行させたい場合に設定します。デフォルトでは、質問は回答されるまで待機します。Claude Code v2.1.200 以降が必要です。
3113 3203
3114* **スコープ**: [`ユーザーまたはマネージド`](#scopes)3204* **スコープ**: [`ユーザーまたはマネージド`](#scopes)
3115* **タイプ**: 文字列、`"60s"`、`"5m"`、`"10m"`、または `"never"` のいずれか3205* **タイプ**: 文字列、`"60s"`、`"5m"`、`"10m"`、または `"never"` のいずれか
3122}3212}
3123```3213```
3124 3214
3125`/config` に **Question auto-continue timeout** として表示され、このキーをユーザー設定に書き込みます。マネージド設定または `--settings` フラグがキーを設定している場合、Claude Code は行を非表示にします。Claude Code v2.1.200 以降が必要です。3215`/config` に**質問の自動続行タイムアウト**として表示され、このキーをユーザー設定に書き込みます。マネージド設定または `--settings` フラグがキーを設定している場合、Claude Code は行を非表示にします。Claude Code v2.1.200 以降が必要です。
3126 3216
3127<h3 id="autocontinueatusagelimit">3217<h3 id="autocontinueatusagelimit">
3128 `autoContinueAtUsageLimit`3218 `autoContinueAtUsageLimit`
3130 3220
3131claude.ai の使用制限がセッションを停止した後、開いているセッションで待機し、リセット後にタスクを自動的に続行します。[自動続行をオフにする](/docs/ja/interactive-mode#turn-automatic-continue-off)を参照してください。Claude Code v2.1.234 以降が必要です。3221claude.ai の使用制限がセッションを停止した後、開いているセッションで待機し、リセット後にタスクを自動的に続行します。[自動続行をオフにする](/docs/ja/interactive-mode#turn-automatic-continue-off)を参照してください。Claude Code v2.1.234 以降が必要です。
3132 3222
3133* **スコープ**: [`ユーザーまたはマネージド`](#scopes)。ユーザー設定、`--settings`、およびマネージド設定からのみ読み取ります。これらのいずれもキーを設定しない場合、プロジェクトまたはローカル設定ファイルがキーを設定すると、無視されるのではなく機能がオフになります。3223* **スコープ**: [`ユーザーまたはマネージド`](#scopes)。ユーザー設定、`--settings`、およびマネージド設定からのみ読み取ります。これらのいずれもキーを設定しない場合、プロジェクトまたはローカル設定ファイルがキーを設定すると、機能は無視されるのではなくオフになります。
3134* **タイプ**: ブール値3224* **タイプ**: ブール値
3135 * `true`: claude.ai の使用制限がセッションを停止した後、Claude Code は開いているセッションで待機し、リセット後にタスクを自動的に続行します3225 * `true`: claude.ai の使用制限がセッションを停止した後、Claude Code は開いているセッションで待機し、リセット後にタスクを自動的に続行します
3136 * `false`: Claude Code は独自に待機を開始しません。[使用制限オプションメニューから自分で待機を開始](/docs/ja/interactive-mode#start-a-wait-yourself)できます3226 * `false`: Claude Code は独自に待機を開始しません。[使用制限オプションメニューから自分で待機を開始](/docs/ja/interactive-mode#start-a-wait-yourself)できます
3142}3232}
3143```3233```
3144 3234
3145`/config` に **Continue automatically at usage limit** として表示され、このキーをユーザー設定に書き込みます。マネージド設定または `--settings` フラグがキーを設定している場合、Claude Code は行を非表示にします。3235`/config` に**使用制限で自動的に続行**として表示され、このキーをユーザー設定に書き込みます。マネージド設定または `--settings` フラグがキーを設定している場合、Claude Code は行を非表示にします。
3146 3236
3147<h3 id="autoscrollenabled">3237<h3 id="autoscrollenabled">
3148 `autoScrollEnabled`3238 `autoScrollEnabled`
3149</h3>3239</h3>
3150 3240
3151[フルスクリーンレンダリング](/docs/ja/fullscreen)で会話の下部に新しい出力を追従します。スクロールした場所に留まりながら Claude が作業を続けるようにするにはオフにします。権限プロンプトは引き続き表示されます。3241[フルスクリーンレンダリング](/docs/ja/fullscreen)で会話の下部に新しい出力を追従します。オフにすると、Claude が作業を続ける間、スクロールした場所に留まります。権限プロンプトは引き続き表示されます。
3152 3242
3153* **スコープ**: [`任意のファイル`](#scopes)3243* **スコープ**: [`任意のファイル`](#scopes)
3154* **タイプ**: ブール値3244* **タイプ**: ブール値
3162}3252}
3163```3253```
3164 3254
3165`/config` に **Auto-scroll** として表示されます(フルスクリーンレンダリングがオンの場合)。このキーをユーザー設定に書き込みます。3255`/config` にフルスクリーンレンダリングがオンの場合**自動スクロール**として表示され、このキーをユーザー設定に書き込みます。
3166 3256
3167<h3 id="axscreenreader">3257<h3 id="axscreenreader">
3168 `axScreenReader`3258 `axScreenReader`
3169</h3>3259</h3>
3170 3260
3171スクリーンリーダーフレンドリーな出力をレンダリングします。装飾的なボーダーやアニメーションのないフラットテキストです。スクリーンリーダーモードはクラシックレンダラーを使用するため、アクティブな間は `tui` 設定は効果がありません。アタッチされた[バックグラウンドセッション](/docs/ja/agent-view)は引き続きフルスクリーンでレンダリングされます。3261スクリーンリーダーフレンドリーな出力をレンダリングします。装飾的なボーダーやアニメーションのないフラットテキストです。スクリーンリーダーモードはクラシックレンダラーを使用するため、アクティブな間は `tui` 設定は効果がありません。接続された[バックグラウンドセッション](/docs/ja/agent-view)は引き続きフルスクリーンでレンダリングされます。
3172 3262
3173* **スコープ**: [`任意のファイル`](#scopes)3263* **スコープ**: [`任意のファイル`](#scopes)
3174* **タイプ**: ブール値3264* **タイプ**: ブール値
3175 * `true`: Claude Code は装飾的なボーダーやアニメーションのないフラットテキストをレンダリングし、クラシックレンダラーを使用します3265 * `true`: Claude Code は装飾的なボーダーやアニメーションのないフラットテキストをレンダリングし、クラシックレンダラーを使用します
3176 * `false`: Claude Code は通常通りレンダリングします3266 * `false`: Claude Code は通常通りレンダリングします
3177* **デフォルト**: 未設定のため、スクリーンリーダーモードはオフです3267* **デフォルト**: 未設定、スクリーンリーダーモードはオフです
3178* **セッションごとのオーバーライド**: [`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) は [`CLAUDE_AX_SCREEN_READER`](/docs/ja/env-vars) より優先され、両方ともこのキーより優先されます3268* **セッションごとのオーバーライド**: [`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) は [`CLAUDE_AX_SCREEN_READER`](/docs/ja/env-vars) より優先され、両方ともこのキーより優先されます
3179 3269
3180```json settings.json theme={null}3270```json settings.json theme={null}
3187 `bashEditDiffEnabled`3277 `bashEditDiffEnabled`
3188</h3>3278</h3>
3189 3279
3190Bash コマンドが Git リポジトリで変更するファイルを Claude Code が記録するかどうかを選択します。記録する場合、コマンド後にターミナルでそれらのファイルの diff が表示され、[PostToolUse Bash フック](/docs/ja/hooks#bash)は変更されたファイルのリストを受け取ります。3280Bash コマンドの実行中に Git リポジトリで変更されたファイルを Claude Code が記録するかどうかを選択します。記録する場合、コマンド後にターミナルでそれらの diff が表示され、[PostToolUse Bash フック](/docs/ja/hooks#bash)は変更されたファイルのリストを受け取ります。
3191 3281
3192リストされたファイルは常にコマンドが変更したものとは限りません。コマンドの実行中に別のプログラムまたは別の Bash 呼び出しが行った変更もそこに表示される可能性があります。3282リストされたファイルは常にコマンドが変更したものとは限りません。コマンドの実行中に別のプログラムまたは別の Bash 呼び出しが行った変更もそこに表示される可能性があります。
3193 3283
3194キーを `true` に設定して、すべての権限モードで記録します。Claude Code v2.1.269 以降が必要です。3284キーを `true` に設定して、すべての権限モードで記録します。Claude Code v2.1.269 以降が必要です。
3195 3285
3196* **スコープ**: [`ユーザーまたはマネージド`](#scopes)。`true` はユーザー設定、`--settings` で渡された JSON、または[マネージド設定](/docs/ja/managed-settings)からのみカウントされるため、リポジトリの `.claude/settings.json` または `.claude/settings.local.json` の `true` は記録をオンにできません。リポジトリファイルの `false` は、[より高い優先度](/docs/ja/settings#settings-precedence)のファイルが `true` を設定しない限り、引き続きオフになります。3286* **スコープ**: [`ユーザーまたはマネージド`](#scopes)。`true` はユーザー設定、`--settings` で渡された JSON、または[マネージド設定](/docs/ja/managed-settings)からのみカウントされるため、リポジトリの `.claude/settings.json` または `.claude/settings.local.json` の `true` は記録をオンにできません。リポジトリファイルの `false` は[より高い優先度](/docs/ja/settings#settings-precedence)のファイルが `true` を設定しない限り、引き続きオフになります。
3197* **タイプ**: ブール値3287* **タイプ**: ブール値
3198* **デフォルト**: 未設定のため、Claude Code は自動モードと `bypassPermissions` モードで Claude がファイルを Bash で編集するように指示する場合に変更を記録します3288* **デフォルト**: 未設定、Claude Code は自動モードと `bypassPermissions` モードで Claude が Bash を通じてファイルを編集するように指示する場合に変更を記録します
3199* **セッションごとのオーバーライド**: [`CLAUDE_CODE_BASH_EDIT_DIFF`](/docs/ja/env-vars) はこのキーより優先されます3289* **セッションごとのオーバーライド**: [`CLAUDE_CODE_BASH_EDIT_DIFF`](/docs/ja/env-vars) はこのキーより優先されます
3200 3290
3201```json settings.json theme={null}3291```json settings.json theme={null}
3212 3302
3213* **スコープ**: [`任意のファイル`](#scopes)3303* **スコープ**: [`任意のファイル`](#scopes)
3214* **タイプ**: 文字列の配列3304* **タイプ**: 文字列の配列
3215* **デフォルト**: 未設定のため、アナウンスメントは表示されません3305* **デフォルト**: 未設定、アナウンスメントは表示されません
3216 3306
3217```json settings.json theme={null}3307```json settings.json theme={null}
3218{3308{
3226 `defaultShell`3316 `defaultShell`
3227</h3>3317</h3>
3228 3318
3229入力ボックスで [`!` プレフィックス](/docs/ja/interactive-mode#shell-mode-with-prefix)で入力するシェルコマンド、Claude Code が直接実行してセッションに追加するコマンドを実行するかどうかを選択します。Bash または PowerShell。3319入力ボックスで[`!` プレフィックス](/docs/ja/interactive-mode#shell-mode-with-prefix)で入力したシェルコマンド、Claude Code が直接実行してセッションに追加するコマンドを実行するかどうかを選択します。Bash または PowerShell。
3230 3320
3231`"powershell"` は [PowerShell ツール](/docs/ja/tools-reference#powershell-tool)がオンの場合のみ機能します。このツールは Git Bash がない Windows ではデフォルトでオンであり、Git Bash がある Windows では claude.ai および Console アカウント用にオンです。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry セッション、および macOS、Linux、WSL では、`CLAUDE_CODE_USE_POWERSHELL_TOOL=1` を設定してツールをオンにします。その変数を `0` に設定してツールをオフにします。3321`"powershell"` は[PowerShell ツール](/docs/ja/tools-reference#powershell-tool)がオンの場合のみ機能します。このツールは Git Bash のない Windows ではデフォルトでオンであり、Git Bash を使用する Windows では claude.ai および Console アカウント用にオンです。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry セッション、および macOS、Linux、WSL では、`CLAUDE_CODE_USE_POWERSHELL_TOOL=1` を設定してツールをオンにします。そのツールをオフにするには、その変数を `0` に設定します。
3232 3322
3233* **スコープ**: [`任意のファイル`](#scopes)3323* **スコープ**: [`任意のファイル`](#scopes)
3234* **タイプ**: 文字列、以下のいずれか:3324* **タイプ**: 文字列、以下のいずれか:
3242}3332}
3243```3333```
3244 3334
3245指定したシェルが利用できない場合、Claude Code は他のシェルを使用します。`"powershell"` は PowerShell ツールがオフの場合 Bash にフォールバックし、`"bash"` は Bash がインストールされていない場合 PowerShell にフォールバックします。3335指定したシェルが利用できない場合、Claude Code は他方を使用します。`"powershell"` は PowerShell ツールがオフの場合 Bash にフォールバックし、`"bash"` は Bash がインストールされていない場合 PowerShell にフォールバックします。
3246 3336
3247<h3 id="dialogexpiry">3337<h3 id="dialogexpiry">
3248 `dialogExpiry`3338 `dialogExpiry`
3249</h3>3339</h3>
3250 3340
3251Claude Code が[リモートクライアントに転送する](/docs/ja/remote-control#limitations)ダイアログ(Remote Control または SDK ホストなど)および[保留中のクロスセッションメッセージ](/docs/ja/cross-session-messaging#control-inbound-messages)の承認ダイアログの期限を設定します。Claude Code v2.1.236 以降では、同じ期限がセッション内の[Fable 使用クレジット同意プロンプト](/docs/ja/model-config#fable-and-usage-credits)をバウンドします。ターミナルに誰もいない可能性があるセッションです。期限前に回答が到着しない場合、Claude Code はダイアログをキャンセルし、デフォルトのアクションなしで続行します。Claude Code v2.1.224 以降が必要です。3341Claude Code が[リモートクライアントに転送](/docs/ja/remote-control#limitations)するダイアログ(Remote Control または SDK ホストなど)および[保留中のクロスセッションメッセージ](/docs/ja/cross-session-messaging#control-inbound-messages)の承認ダイアログの期限を設定します。Claude Code v2.1.236 以降では、同じ期限が誰もターミナルにいない可能性があるセッションの途中の[Fable 使用クレジット同意プロンプト](/docs/ja/model-config#fable-and-usage-credits)を制限します。期限前に回答が到着しない場合、Claude Code はダイアログをキャンセルし、デフォルトのアクションなしで続行します。Claude Code v2.1.224 以降が必要です。
3252 3342
3253* **スコープ**: [`ユーザーまたはマネージド`](#scopes)3343* **スコープ**: [`ユーザーまたはマネージド`](#scopes)
3254* **タイプ**: 文字列、`"60s"`、`"5m"`、`"10m"`、または期限を無効にする `"never"` のいずれか3344* **タイプ**: 文字列、`"60s"`、`"5m"`、`"10m"`、または期限を無効にする `"never"` のいずれか
3261}3351}
3262```3352```
3263 3353
3264権限プロンプトと [`AskUserQuestion`](/docs/ja/tools-reference#askuserquestion-tool-behavior) の質問は独自のフローを使用し、この期限の対象ではありません。` /config` に **Dialog expiry** として表示されます。このキーをユーザー設定に書き込みます。行には Claude Code v2.1.232 以降が必要であり、マネージド設定または `--settings` フラグがキーを設定している場合、Claude Code は行を非表示にします。3354権限プロンプトと[`AskUserQuestion`](/docs/ja/tools-reference#askuserquestion-tool-behavior)質問は独自のフローを使用し、この期限の対象ではありません。Claude Code v2.1.232 以降では `/config` に**ダイアログの有効期限**として表示され、このキーをユーザー設定に書き込みます。行には Claude Code v2.1.232 以降が必要であり、マネージド設定または `--settings` フラグがキーを設定している場合、Claude Code は行を非表示にします。
3265 3355
3266<h3 id="editormode">3356<h3 id="editormode">
3267 `editorMode`3357 `editorMode`
3281}3371}
3282```3372```
3283 3373
3284`/config` に **Editor mode** として表示され、このキーをユーザー設定に書き込みます。3374`/config` に**エディタモード**として表示され、このキーをユーザー設定に書き込みます。
3285 3375
3286<h3 id="emojicompletionenabled">3376<h3 id="emojicompletionenabled">
3287 `emojiCompletionEnabled`3377 `emojiCompletionEnabled`
3288</h3>3378</h3>
3289 3379
3290プロンプト入力で `:` とショートコードを入力するときに絵文字の提案を表示し、`:heart:` などの完成したショートコードをその絵文字に置き換えます。`false` に設定して両方をオフにします。3380プロンプト入力で `:` とショートコードを入力するときに絵文字の提案を表示し、`:heart:` などの完成したショートコードを絵文字に置き換えます。`false` に設定して両方をオフにします。
3291 3381
3292* **スコープ**: [`任意のファイル`](#scopes)3382* **スコープ**: [`任意のファイル`](#scopes)
3293* **タイプ**: ブール値3383* **タイプ**: ブール値
3294 * `true`: Claude Code は `:` の後に絵文字の提案を表示し、完成したショートコードをその絵文字に置き換えます3384 * `true`: Claude Code は `:` の後に絵文字の提案を表示し、完成したショートコードを絵文字に置き換えます
3295 * `false`: Claude Code は絵文字を提案せず、ショートコードを置き換えません3385 * `false`: Claude Code は絵文字を提案せず、ショートコードを置き換えません
3296* **デフォルト**: `true`3386* **デフォルト**: `true`
3297 3387
3309 `fileSuggestion`3399 `fileSuggestion`
3310</h3>3400</h3>
3311 3401
3312組み込みのファイル提案の代わりに、`@` ファイルパスオートコンプリートを提供する独自のコマンドを実行します。組み込みの提案は高速なファイルシステムトラバーサルを使用します。大規模なモノレポは、事前構築されたファイルインデックスなどのプロジェクト固有のインデックスでより良い結果が得られる場合があります。3402組み込みのファイル提案の代わりに、`@` ファイルパスオートコンプリートを提供する独自のコマンドを実行します。組み込み提案は高速ファイルシステムトラバーサルを使用します。大規模なモノレポは事前構築されたファイルインデックスなどのプロジェクト固有のインデックスでより良い結果が得られる場合があります。
3313 3403
3314* **スコープ**: [`任意のファイル`](#scopes)。[ステータスラインとファイル提案ゲート](#status-line-and-file-suggestion-gates)の下では、Claude Code はコマンドをオフにするか、マネージド値のみを実行し、警告なしにあなたのコマンドをスキップします。3404* **スコープ**: [`任意のファイル`](#scopes)。[ステータスラインとファイル提案ゲート](#status-line-and-file-suggestion-gates)の下では、Claude Code はコマンドをオフにするか、マネージド値のみを実行し、警告なしにあなたのコマンドをスキップします。
3315* **タイプ**: `type`(常に `"command"`)と実行するシェルコマンドである `command` を持つオブジェクト3405* **タイプ**: `type`(常に `"command"`)と `command`(実行するシェルコマンド)を持つオブジェクト
3316* **デフォルト**: 未設定のため、Claude Code は組み込みのファイル提案を使用します3406* **デフォルト**: 未設定、Claude Code は組み込みのファイル提案を使用します
3317 3407
3318```json settings.json theme={null}3408```json settings.json theme={null}
3319{3409{
3324}3414}
3325```3415```
3326 3416
3327これを保存した後、プロンプトで `@` に続けてパスの一部を入力します。提案はコマンドの出力から来ます。3417これを保存した後、プロンプトで `@` に続けてパスの一部を入力します。提案はコマンドの出力から取得されます。
3328 3418
3329<h4 id="command-input-and-output">3419<h4 id="command-input-and-output">
3330 コマンド入力と出力3420 コマンド入力と出力
3331</h4>3421</h4>
3332 3422
3333Claude Code はコマンドを[フック](/docs/ja/hooks)と同じ環境変数(`CLAUDE_PROJECT_DIR` を含む)で実行し、5 秒後に待機を停止します。コマンドは stdin で `query` フィールドを持つ JSON を受け取ります。これまでに入力したものを保持します:3423Claude Code は[フック](/docs/ja/hooks)と同じ環境変数(`CLAUDE_PROJECT_DIR` を含む)でコマンドを実行し、5 秒後に待機を停止します。コマンドは stdin で `query` フィールドを持つ JSON を受け取ります。これまでに入力したものを保持します:
3334 3424
3335```json theme={null}3425```json theme={null}
3336{"query": "src/comp"}3426{"query": "src/comp"}
3337```3427```
3338 3428
3339stdout に改行で区切られたファイルパスを出力します。Claude Code は最大 15 個を表示します:3429stdout にニューラインで区切られたファイルパスを出力します。Claude Code は最大 15 個を表示します:
3340 3430
3341```text theme={null}3431```text theme={null}
3342src/components/Button.tsx3432src/components/Button.tsx
3359 `footerLinksRegexes`3449 `footerLinksRegexes`
3360</h3>3450</h3>
3361 3451
3362ターンの出力(ツール結果(ファイルコンテンツと取得されたページを含む)および Claude 自身の応答)に正規表現がマッチするときに、入力ボックスの下のフッターに追加のクリック可能なバッジをレンダリングします。プロジェクト CLI によって出力される ID(レビューツールと問題トラッカーなど)をセッションリンクに変換するために使用します。3452ターン出力(ツール結果(ファイルコンテンツと取得されたページを含む)および Claude 自身の応答)に正規表現がマッチするときに、入力ボックスの下のフッターに追加のクリック可能なバッジをレンダリングします。プロジェクト CLI によって出力される ID(レビューツールおよび問題トラッカーなど)をセッションリンクに変換するために使用します。
3363 3453
3364* **スコープ**: [`ユーザーまたはマネージド`](#scopes)3454* **スコープ**: [`ユーザーまたはマネージド`](#scopes)
3365* **タイプ**: オブジェクトの配列。各オブジェクトは `type` を `"regex"` に設定し、`pattern` 正規表現、`url` テンプレート、およびオプションの `label` を持ちます。`url` と `label` の `{name}` プレースホルダーは `pattern` の名前付きキャプチャグループから入力されます3455* **タイプ**: オブジェクトの配列。各オブジェクトは `type` を `"regex"` に設定し、`pattern` 正規表現、`url` テンプレート、およびオプションの `label` を持ちます。`url` および `label` の `{name}` プレースホルダーは `pattern` の名前付きキャプチャグループから入力されます
3366* **デフォルト**: 未設定のため、バッジはレンダリングされません3456* **デフォルト**: 未設定、バッジはレンダリングされません
3367 3457
3368この例は `PROJ-1234` などの問題キーにマッチし、キャプチャされたキーから各リンクを構築します:3458この例は `PROJ-1234` などの問題キーにマッチし、キャプチャされたキーから各リンクを構築します:
3369 3459
3386 バッジの制約3476 バッジの制約
3387</h4>3477</h4>
3388 3478
3389各エントリの URL、ラベル、およびバッジ数は以下のようにバウンドされます:3479各エントリの URL、ラベル、およびバッジ数は次のように制限されます:
3390 3480
3391| 制約 | 動作 |3481| 制約 | 動作 |
3392| :- | :- |3482| :- | :- |
3396| ラベル | マッチしたテキストにデフォルト設定され、28 表示列に切り詰められます |3486| ラベル | マッチしたテキストにデフォルト設定され、28 表示列に切り詰められます |
3397| バッジ数 | 最大 5 個のバッジがレンダリングされます。最も古いものは新しいマッチに置き換えられ、`/clear` はそれらを削除します |3487| バッジ数 | 最大 5 個のバッジがレンダリングされます。最も古いものは新しいマッチに置き換えられ、`/clear` はそれらを削除します |
3398 3488
3399ターンが完了すると、Claude Code は各エントリの `pattern` 正規表現をメインスレッドのターン出力に対してマッチングするため、遅い正規表現は完了するまで UI をブロックします。`(a+)+$` などのネストされた量指定子は特定の入力に対して指数関数的に長くかかり、セッションをフリーズさせる可能性があるため、各 `pattern` を線形に保ち、`+` または `*` のネストを避けてください。3489ターンが完了すると、Claude Code はメインスレッドでターン出力に対して各エントリの `pattern` 正規表現をマッチングするため、遅い正規表現は完了するまで UI をブロックします。`(a+)+$` などのネストされた量指定子は特定の入力に対して指数関数的に長くかかり、セッションをフリーズさせる可能性があるため、各 `pattern` を線形に保ち、`+` または `*` のネストを避けてください。
3400 3490
3401フッターバッジは[カスタムステータスライン](/docs/ja/statusline)が設定されている場合、それと並んでレンダリングされます。どちらも他方を置き換えません。ステータスラインはセッションデータから独自のコンテンツを計算するスクリプト駆動行に使用し、フッターバッジは会話から ID をリンクに変換するために使用します。スクリプトなし。3491フッターバッジは[カスタムステータスライン](/docs/ja/statusline)が設定されている場合と並んでレンダリングされます。どちらも他方を置き換えません。セッションデータから独自のコンテンツを計算するスクリプト駆動行にはステータスラインを使用し、会話から ID をリンクに変換するにはフッターバッジを使用します。スクリプトなし。
3402 3492
3403<h3 id="keybindingflavor">3493<h3 id="keybindingflavor">
3404 `keybindingFlavor`3494 `keybindingFlavor`
3408 v2.1.261 以降非推奨であり、効果がありません。プロンプトのワード編集キーは常に[readline 規約に従います](/docs/ja/interactive-mode#make-ctrl-w-delete-back-to-whitespace)。Bash のように。Claude Code は引き続き `keybindingFlavor` を受け入れるため、それを設定する設定ファイルは有効なままです。3498 v2.1.261 以降非推奨であり、効果がありません。プロンプトのワード編集キーは常に[readline 規約に従います](/docs/ja/interactive-mode#make-ctrl-w-delete-back-to-whitespace)。Bash のように。Claude Code は引き続き `keybindingFlavor` を受け入れるため、それを設定する設定ファイルは有効なままです。
3409</Warning>3499</Warning>
3410 3500
3411v2.1.238 から v2.1.260 では、`"readline"` に設定すると `Ctrl+W` は前の単語だけでなく前の空白文字まで削除されます。3501v2.1.238 から v2.1.260 では、`"readline"` に設定すると `Ctrl+W` は前の単語だけでなく前の空白文字に戻って削除されました。
3412 3502
3413* **スコープ**: [`任意のファイル`](#scopes)3503* **スコープ**: [`任意のファイル`](#scopes)
3414* **タイプ**: 文字列、`"classic"` または `"readline"`3504* **タイプ**: 文字列、`"classic"` または `"readline"`
3415* **デフォルト**: 未設定3505* **デフォルト**: 未設定
3416 3506
3507<h3 id="maxprosewidth">
3508 `maxProseWidth`
3509</h3>
3510
3511Claude の応答の散文の幅を制限して、行が広いターミナルで読みやすく保ちます。段落、見出し、リスト、およびブロック引用はこの多くの列内でラップされ、テーブルとコードブロックはターミナルの全幅を保ちます。Claude Code v2.1.282 以降が必要です。
3512
3513* **スコープ**: [`任意のファイル`](#scopes)
3514* **タイプ**: ターミナル列の数、整数、最小 `40`。Claude Code は他の値を無視します
3515* **デフォルト**: 未設定、散文はターミナルエッジでラップされます
3516
3517```json settings.json theme={null}
3518{
3519 "maxProseWidth": 80
3520}
3521```
3522
3417<h3 id="prefersreducedmotion">3523<h3 id="prefersreducedmotion">
3418 `prefersReducedMotion`3524 `prefersReducedMotion`
3419</h3>3525</h3>
3420 3526
3421スピナー、シマー、フラッシュエフェクトなどのインターフェースアニメーションを削減またはオフにします。`/config` に **Reduce motion** として表示されます。3527スピナー、シマー、フラッシュエフェクトなどのインターフェースアニメーションを削減またはオフにします。`/config` に**モーションを削減**として表示されます。
3422 3528
3423* **スコープ**: [`任意のファイル`](#scopes)3529* **スコープ**: [`任意のファイル`](#scopes)
3424* **タイプ**: ブール値3530* **タイプ**: ブール値
3436 `promptSuggestionEnabled`3542 `promptSuggestionEnabled`
3437</h3>3543</h3>
3438 3544
3439[プロンプト提案](/docs/ja/interactive-mode#prompt-suggestions)を表示または非表示にします。プロンプト入力に表示される灰色の予測です。`false` に設定するか、`/config` で **Prompt suggestions** をオフにして非表示にします。3545[プロンプト提案](/docs/ja/interactive-mode#prompt-suggestions)を表示または非表示にします。プロンプト入力に表示される灰色の予測です。`false` に設定するか、`/config` で**プロンプト提案**をオフにして非表示にします。
3440 3546
3441* **スコープ**: [`任意のファイル`](#scopes)3547* **スコープ**: [`任意のファイル`](#scopes)
3442* **タイプ**: ブール値3548* **タイプ**: ブール値
3451}3557}
3452```3558```
3453 3559
3454プロンプト提案には、テレメトリがオンの claude.ai または Console アカウントが必要です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または [`DISABLE_TELEMETRY`](/docs/ja/env-vars) によってテレメトリがオフになっている場合、このキーは効果がなく、`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=1` のみがそれらをオンにします。3560プロンプト提案には、テレメトリがオンの claude.ai または Console アカウントが必要です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または [`DISABLE_TELEMETRY`](/docs/ja/env-vars) によるテレメトリがオフの場合、このキーは効果がなく、`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=1` のみがそれらをオンにします。
3455 3561
3456<h3 id="respectgitignore">3562<h3 id="respectgitignore">
3457 `respectGitignore`3563 `respectGitignore`
3458</h3>3564</h3>
3459 3565
3460`@` ファイルピッカーが `.gitignore` パターンにマッチするファイルを除外するかどうかを制御します。`/config` に **Respect .gitignore in file picker** として表示されます。3566`@` ファイルピッカーが `.gitignore` パターンにマッチするファイルを除外するかどうかを制御します。`/config` に**ファイルピッカーで .gitignore を尊重**として表示されます。
3461 3567
3462* **スコープ**: [`任意のファイル`](#scopes)。設定ファイルがそれを設定しない場合、Claude Code は `~/.claude.json` の `respectGitignore` にフォールバックします。これは `/config` トグルが書き込みます。3568* **スコープ**: [`任意のファイル`](#scopes)。設定ファイルがそれを設定しない場合、Claude Code は `~/.claude.json` の `respectGitignore` にフォールバックします。これは `/config` トグルが書き込みます。
3463* **タイプ**: ブール値3569* **タイプ**: ブール値
3475 `respondToBashCommands`3581 `respondToBashCommands`
3476</h3>3582</h3>
3477 3583
3478入力ボックスで [`!` プレフィックス](/docs/ja/interactive-mode#shell-mode-with-prefix)でシェルコマンドを実行した後、Claude が応答するかどうかを選択します。デフォルトでは、Claude Code はコマンドの出力を会話に追加し、Claude がそれに応答します。このキーを `false` に設定して、応答なしでコンテキストに出力を追加し、複数のコマンドを実行して一緒に質問できるようにします。3584入力ボックスで[`!` プレフィックス](/docs/ja/interactive-mode#shell-mode-with-prefix)でシェルコマンドを実行した後、Claude が応答するかどうかを選択します。デフォルトでは、Claude Code はコマンドの出力を会話に追加し、Claude がそれに応答します。このキーを `false` に設定して、応答なしでコンテキストに出力を追加し、複数のコマンドを実行して一緒に質問できるようにします。
3479 3585
3480* **スコープ**: [`任意のファイル`](#scopes)3586* **スコープ**: [`任意のファイル`](#scopes)
3481* **タイプ**: ブール値3587* **タイプ**: ブール値
3489}3595}
3490```3596```
3491 3597
3492[シェルモード(`!` プレフィックス付き)](/docs/ja/interactive-mode#shell-mode-with-prefix)を参照してください。3598[`!` プレフィックスでシェルモード](/docs/ja/interactive-mode#shell-mode-with-prefix)を参照してください。
3493 3599
3494<h3 id="showclearcontextonplanaccept">3600<h3 id="showclearcontextonplanaccept">
3495 `showClearContextOnPlanAccept`3601 `showClearContextOnPlanAccept`
3496</h3>3602</h3>
3497 3603
3498Claude が[プランモード](/docs/ja/permission-modes#review-and-approve-a-plan)でプランを完了すると、承認メニューが表示されます。計画は多くのコンテキストを使用できるため、このキーはそのメニューに最初のオプション **Yes, clear context and …** を追加します。これはプランを承認し、会話コンテキストをクリアし、プランだけから実装を開始します。ラベルの残りはセッションが続行する権限モードに名前を付け、計画がコンテキストをどの程度使用したかを示します。3604Claude が[プランモード](/docs/ja/permission-modes#review-and-approve-a-plan)でプランを完了すると、承認メニューが表示されます。計画は多くのコンテキストを使用できるため、このキーはそのメニューに最初のオプション**はい、コンテキストをクリアして…** を追加します。これはプランを承認し、会話コンテキストをクリアし、プランだけから実装を開始します。ラベルの残りはセッションが続く権限モードに名前を付け、計画がコンテキストをどの程度使用したかを示します。
3499 3605
3500* **スコープ**: [`任意のファイル`](#scopes)3606* **スコープ**: [`任意のファイル`](#scopes)
3501* **タイプ**: ブール値3607* **タイプ**: ブール値
3502 * `true`: プラン承認メニューは最初のオプション **Yes, clear context and …** を取得します。これはプランを承認し、会話コンテキストをクリアします3608 * `true`: プラン承認メニューは最初のオプション**はい、コンテキストをクリアして…** を取得します。これはプランを承認し、会話コンテキストをクリアします
3503 * `false`: プラン承認メニューはクリアコンテキストオプションを表示しません3609 * `false`: プラン承認メニューはクリアコンテキストオプションを表示しません
3504* **デフォルト**: `false`3610* **デフォルト**: `false`
3505 3611
3513 `showTurnDuration`3619 `showTurnDuration`
3514</h3>3620</h3>
3515 3621
3516各応答後のターン期間メッセージを表示または非表示にします。例えば「Cooked for 1m 6s · done 6:05 PM」。「done」の後の時計はターンが完了した時刻を示します。[`timeFormat`](#timeformat) と [`timeZone`](#timezone) はその形式とゾーンを制御します。`/config` に **Show turn duration** として表示されます。3622各応答後のターン期間メッセージを表示または非表示にします。例えば「Cooked for 1m 6s · done 6:05 PM」。「done」の後の時計はターンが完了した時刻を示します。[`timeFormat`](#timeformat) と [`timeZone`](#timezone) はその形式とゾーンを制御します。`/config` に**ターン期間を表示**として表示されます。
3517 3623
3518* **スコープ**: [`任意のファイル`](#scopes)。設定ファイルがそれを設定しない場合、古いバージョンの `~/.claude.json` の値が適用されます。3624* **スコープ**: [`任意のファイル`](#scopes)。古いバージョンの `~/.claude.json` の値は、設定ファイルがそれを設定しない場合に適用されます。
3519* **タイプ**: ブール値3625* **タイプ**: ブール値
3520 * `true`: 各応答後のターン期間メッセージが表示されます3626 * `true`: 各応答後にターン期間メッセージが表示されます
3521 * `false`: Claude Code はターン期間メッセージを非表示にします3627 * `false`: Claude Code はターン期間メッセージを非表示にします
3522* **デフォルト**: `true`3628* **デフォルト**: `true`
3523 3629
3531 `spellcheck`3637 `spellcheck`
3532</h3>3638</h3>
3533 3639
3534入力中にプロンプト入力の誤字をアンダーラインで示します。インストールするスペルチェッカーを使用します。Claude Code はプロンプト入力ボックスのテキストのみをチェックします。[入力中にスペルをチェック](/docs/ja/interactive-mode#check-spelling-as-you-type)は aspell、hunspell、または ispell をインストールし、チェッカーがカバーするものについて説明します。Claude Code v2.1.235 以降が必要です。3640入力時にプロンプト入力でスペルミスのある単語に下線を引きます。インストールするスペルチェッカーを使用します。Claude Code はプロンプト入力ボックスのテキストのみをチェックします。[入力時にスペルをチェック](/docs/ja/interactive-mode#check-spelling-as-you-type)は aspell、hunspell、または ispell のインストールとチェッカーがカバーするものについて説明しています。Claude Code v2.1.235 以降が必要です。
3535 3641
3536* **スコープ**: [`ユーザーまたはマネージド`](#scopes)。それを設定する最高層からのブロック全体が全体として適用されます。3642* **スコープ**: [`ユーザーまたはマネージド`](#scopes)。それを設定する最高層のブロックが全体として適用されます。
3537* **タイプ**: `enabled`(ブール値)、`checker`(`"aspell"`、`"hunspell"`、`"ispell"`、または `"auto"`)、`language`(文字列、チェッカーの辞書名として渡される)、および `color`(文字列、ターミナルカラー名、`#rrggbb`、`rgb(r,g,b)`、`ansi256(n)`、または `ansi:<name>`)を持つオブジェクト3643* **タイプ**: `enabled`(ブール値)、`checker`(`"aspell"`、`"hunspell"`、`"ispell"`、または `"auto"`)、`language`(文字列、チェッカーの辞書名として渡される)、および `color`(文字列、ターミナルカラー名、`#rrggbb`、`rgb(r,g,b)`、`ansi256(n)`、または `ansi:<name>`)を持つオブジェクト
3538* **デフォルト**: 未設定のため、スペルチェックはオフです。`checker` はデフォルトで `"auto"`(`PATH` で見つかった最初の 3 つ)です。`language` はデフォルトでチェッカー自身の辞書です。`color` はデフォルトでテーマのエラーカラーです3644* **デフォルト**: 未設定、スペルチェックはオフです。`checker` はデフォルトで `"auto"`、`PATH` で見つかった最初の 3 つです。`language` はデフォルトでチェッカー自身の辞書です。`color` はデフォルトでテーマのエラーカラーです
3539 3645
3540```json settings.json theme={null}3646```json settings.json theme={null}
3541{3647{
3547 `spinnerTipsEnabled`3653 `spinnerTipsEnabled`
3548</h3>3654</h3>
3549 3655
3550Claude が作業している間、スピナーラインは「Plan Mode を使用して複雑なリクエストに備えてから変更を加えます。Shift+Tab を 2 回押して有効にします」などの Claude Code 機能に関する短いヒントをローテーションします。このキーを `false` に設定して非表示にします。`/config` に **Show tips** として表示されます。3656Claude が作業している間、スピナーラインは「Plan Mode を使用して複雑なリクエストに備えてから変更を加えます。Shift+Tab を 2 回押して有効にします」などの Claude Code 機能に関する短いヒントをローテーションします。このキーを `false` に設定して非表示にします。`/config` に**ヒントを表示**として表示されます。
3551 3657
3552* **スコープ**: [`任意のファイル`](#scopes)3658* **スコープ**: [`任意のファイル`](#scopes)
3553* **タイプ**: ブール値3659* **タイプ**: ブール値
3565 `spinnerTipsOverride`3671 `spinnerTipsOverride`
3566</h3>3672</h3>
3567 3673
3568Claude Code が Claude の作業中に表示する[スピナーヒント](#spinnertipsenabled)に独自のヒントを追加するか、組み込みヒントを自分のヒントに置き換えます。Claude Code はあなたのヒントを組み込みヒントと同じローテーションに入れます。最も長く表示されていないヒントを選択し、クールダウン中のヒントをスキップし、優先度でタイを破ります。3674Claude Code が Claude の作業中に表示する[スピナーヒント](#spinnertipsenabled)に独自のヒントを追加するか、組み込みヒントを置き換えます。Claude Code はあなたのヒントを組み込みのものと同じローテーションに入れます。最も長く表示されていないヒントを選択し、クールダウン中のヒントをスキップし、優先度でタイを破ります。
3569 3675
3570[`spinnerTipsEnabled`](#spinnertipsenabled) を `false` に設定すると、Claude Code はすべてのヒント(あなたのヒントを含む)を非表示にします。3676[`spinnerTipsEnabled`](#spinnertipsenabled) を `false` に設定すると、Claude Code はすべてのヒント(あなたのものを含む)を非表示にします。
3571 3677
3572* **スコープ**: [`任意のファイル`](#scopes)。Claude Code はヒントオブジェクト、`tipsFile`、`label`、および `excludeDefault` をユーザー設定、`--settings` フラグ、およびマネージド設定から尊重します。プロジェクトおよびローカル設定からは、プレーンな文字列ヒントのみを読み取ります。3678* **スコープ**: [`任意のファイル`](#scopes)。Claude Code はヒントオブジェクト、`tipsFile`、`label`、および `excludeDefault` をユーザー設定、`--settings` フラグ、およびマネージド設定から尊重します。プロジェクトおよびローカル設定からは、プレーン文字列ヒントのみを読み取ります。
3573* **タイプ**: `tips`、`tipsFile`、`label`、および `excludeDefault` フィールドを持つオブジェクト。各フィールドはオプションです3679* **タイプ**: `tips`、`tipsFile`、`label`、および `excludeDefault` フィールドを持つオブジェクト。各フィールドはオプションです
3574* **デフォルト**: 未設定のため、Claude Code は組み込みヒントのみを表示します3680* **デフォルト**: 未設定、Claude Code は組み込みヒントのみを表示します
3575 3681
3576ヒントオブジェクト、`tipsFile`、`label`、およびスコープ行のルール(プロジェクトおよびローカル設定はプレーンな文字列のみを提供)には Claude Code v2.1.247 以降が必要です。以前のバージョンでは、プロジェクトまたはローカルファイルの `excludeDefault` も適用されます。3682ヒントオブジェクト、`tipsFile`、`label`、およびスコープ行のルール(プロジェクトおよびローカル設定がプレーン文字列のみを提供)には Claude Code v2.1.247 以降が必要です。以前のバージョンでは、プロジェクトまたはローカルファイルの `excludeDefault` も適用されます。
3577 3683
3578各 `tips` エントリはプレーンな文字列またはこれらのフィールドを持つオブジェクトです:3684各 `tips` エントリはプレーン文字列またはこれらのフィールドを持つオブジェクトです:
3579 3685
3580| フィールド | 必須 | 説明 |3686| フィールド | 必須 | 説明 |
3581| :- | :- | :- |3687| :- | :- | :- |
3582| `id` | はい | 最大 64 文字、数字、`.`、`_`、または `-`。Claude Code はヒントの表示履歴をキーにするため、ヒントのクールダウンはリストの並べ替えを生き残ります。同じ id を持つ 2 つのエントリのうち、Claude Code は最初のものを使用します |3688| `id` | はい | 最大 64 文字、数字、`.`、`_`、または `-`。Claude Code はヒントの表示履歴をキーにするため、ヒントのクールダウンはリストの並べ替えを生き残ります。同じ id を持つ 2 つのエントリのうち、Claude Code は最初のものを使用します |
3583| `text` | はい | ヒント、最大 500 文字の 1 行。Claude Code は ANSI エスケープと制御文字を削除し、空白を折りたたみます |3689| `text` | はい | ヒント、最大 500 文字の 1 行。Claude Code は ANSI エスケープと制御文字を削除し、空白を折りたたみます |
3584| `cooldownSessions` | いいえ | Claude Code がヒントを再度表示する前に待機するセッション数。`0` から `1000`。デフォルト `0` |3690| `cooldownSessions` | いいえ | Claude Code がヒントを再度表示する前に待機するセッション数、`0` から `1000`、デフォルト `0` |
3585| `priority` | いいえ | 同じ期間表示されていないヒント間の順序。より高い最初。`-10` から `10`。デフォルト `0` |3691| `priority` | いいえ | 同じ期間表示されていないヒント間の順序、より高い最初、`-10` から `10`、デフォルト `0` |
3586 3692
3587Claude Code はプレーンな文字列をこれらのデフォルトを持つヒントとして読み取り、位置ベースの id を読み取るため、リストを並べ替えるとその表示履歴がリセットされます。ヒントに `id` を付けて、編集全体で履歴を保持します。3693Claude Code はプレーン文字列をこれらのデフォルトを持つヒントとして読み取り、位置ベースの id を読み取るため、リストを並べ替えるとその表示履歴がリセットされます。ヒントに `id` を付けて、編集全体で履歴を保持します。
3588 3694
3589Claude Code は `tips` と `tipsFile` 全体で最大 200 個のヒントを読み取り、設定ファイルを拒否する代わりに、デバッグ警告で無効なエントリを削除します。3695Claude Code は `tips` と `tipsFile` 全体で最大 200 個のヒントを読み取り、設定ファイルを拒否する代わりに、デバッグ警告で無効なエントリを削除します。
3590 3696
3591残りのフィールドを使用して、ヒントファイルに名前を付け、プレフィックスを設定し、組み込みヒントを非表示にします:3697残りのフィールドを使用して、ヒントファイルに名前を付け、プレフィックスを設定し、組み込みヒントを非表示にします:
3592 3698
3593* `tipsFile`: ローカル JSON ファイルへの絶対パスまたは `~/` パス。同じエントリの配列を保持するか、`tips` 配列を持つオブジェクト。最大 256 KB。Claude Code はプロセスごとに 1 回ファイルを読み取るため、次の起動時に編集が読み込まれます。[サーバー管理設定](/docs/ja/server-managed-settings)を通じて設定することはできません。インライン `tips` をそこに展開するか、オンディスク `managed-settings.json` にパスを展開します。3699* `tipsFile`: ローカル JSON ファイルへの絶対パスまたは `~/` パス。同じエントリの配列、またはオブジェクト(`tips` 配列を持つ)を保持します。最大 256 KB。Claude Code はプロセスごとに 1 回ファイルを読み取るため、次の起動時に編集が読み込まれます。[サーバー管理設定](/docs/ja/server-managed-settings)を通じて設定することはできません。インライン `tips` をそこに展開するか、オンディスク `managed-settings.json` にパスを展開します。
3594* `label`: Claude Code がユーザー、`--settings`、およびマネージド設定からのヒントの前に表示するプレフィックス。最大 40 文字。デフォルトは `Tip`(組み込みヒントと同じプレフィックス)であり、プロジェクトおよびローカル設定からのヒントは常にそれを使用します。3700* `label`: Claude Code がユーザー、`--settings`、およびマネージド設定からのヒントの前に表示するプレフィックス。最大 40 文字。デフォルトは `Tip`、組み込みヒントと同じプレフィックスであり、プロジェクトおよびローカル設定からのヒントは常にそれを使用します。
3595* `excludeDefault`: `true` に設定して、組み込みヒントを非表示にし、あなたのヒントのみを表示します。Claude Code があなたのヒントのいずれかを読み込めない場合(例えば、`tipsFile` が存在しないか、すべてのエントリが無効な場合)、空のスピナーの代わりに組み込みローテーションを保持します。3701* `excludeDefault`: `true` に設定して、組み込みヒントを非表示にし、あなたのヒントのみを表示します。Claude Code がヒントを読み込めない場合(例えば `tipsFile` が存在しないか、すべてのエントリが無効な場合)、空のスピナーの代わりに組み込みローテーションを保持します。
3596 3702
3597複数の設定ファイルがキーを設定する場合、Claude Code はすべてのファイルからヒントを表示し、マネージド設定、`--settings` フラグ、およびユーザー設定のうち、各を設定する最高優先度のものから `tipsFile`、`label`、および `excludeDefault` を取得します。3703複数の設定ファイルがキーを設定する場合、Claude Code はすべてのファイルからヒントを表示し、マネージド設定、`--settings` フラグ、およびユーザー設定のうち、各 `tipsFile`、`label`、および `excludeDefault` を設定する最高優先度のものから取得します。
3598 3704
3599この例(ユーザー設定内)は、プレーンな文字列ヒントとオブジェクトヒントを `Acme tip` プレフィックスの下のローテーションに追加します:3705この例(ユーザー設定)は、プレーン文字列ヒントとオブジェクトヒントを `Acme tip` プレフィックスの下のローテーションに追加します:
3600 3706
3601```json settings.json theme={null}3707```json settings.json theme={null}
3602{3708{
3617 3723
3618例の各フィールドは Claude Code がヒントを表示する方法の 1 つを変更します:3724例の各フィールドは Claude Code がヒントを表示する方法の 1 つを変更します:
3619 3725
3620* `label`: Claude Code は両方のヒントを `Acme tip: ...` として表示します。`Tip: ...` の代わりに。3726* `label`: Claude Code は両方のヒントを `Tip: ...` の代わりに `Acme tip: ...` として表示します。
3621* プレーンな文字列: Claude Code はデフォルトを付与するため、次のセッションで再度表示される可能性があります。3727* プレーン文字列: Claude Code はデフォルトを付与するため、次のセッションで再度表示される可能性があります。
3622* `id`: Claude Code は `gateway-errors` の 2 番目のヒントの表示履歴をキーにするため、ヒントを追加または並べ替えた後もそのクールダウンが適用されます。3728* `id`: Claude Code は 2 番目のヒントの表示履歴を `gateway-errors` にキーにするため、そのクールダウンはヒントを追加または並べ替えた後も適用されます。
3623* `cooldownSessions`: Claude Code が `gateway-errors` ヒントを表示した後、5 セッション後までそのヒントを再度表示しません。3729* `cooldownSessions`: Claude Code が `gateway-errors` ヒントを表示した後、そのヒントを 5 セッション後まで再度表示しません。
3624* `priority`: `gateway-errors` ヒントと別のヒントが同じ数のセッション(例えば、どちらも表示されていない場合)で表示されていない場合、Claude Code は `gateway-errors` を最初に表示します。プレーンな文字列はデフォルトの優先度 `0` を持ちます。3730* `priority`: `gateway-errors` ヒントと別のヒントが同じ期間表示されていない場合(例えば、どちらも表示されていない場合)、Claude Code は `gateway-errors` を最初に表示します。プレーン文字列はデフォルト優先度 `0` を持ちます。
3625 3731
3626Claude が作業している間、Claude Code はあなたのプレフィックス(例えば `Acme tip: Run /review before opening a PR`)でスピナーにあなたのヒントを表示します。3732Claude が作業している間、Claude Code はあなたのプレフィックス(例えば `Acme tip: Run /review before opening a PR`)でスピナーにあなたのヒントを表示します。
3627 3733
3629 `spinnerVerbs`3735 `spinnerVerbs`
3630</h3>3736</h3>
3631 3737
3632ターンが進行中の間、スピナーは「Accomplishing」、「Architecting」、または「Baking」などの回転する動詞を表示します。このキーを使用して、そのローテーションに独自の動詞を追加するか、組み込みリストを自分のリストに置き換えます。3738ターンが進行中の間、スピナーは「Accomplishing」、「Architecting」、または「Baking」などのローテーション動詞を表示します。このキーを使用して、そのローテーションに独自の動詞を追加するか、組み込みリストを置き換えます。
3633 3739
3634* **スコープ**: [`任意のファイル`](#scopes)3740* **スコープ**: [`任意のファイル`](#scopes)
3635* **タイプ**: `verbs` 文字列の配列と `mode` を持つオブジェクト。以下のいずれか:3741* **タイプ**: `verbs` 文字列の配列と `mode` を持つオブジェクト。以下のいずれか:
3636 * `"append"`: Claude Code は組み込みセットにあなたの動詞を追加します3742 * `"append"`: Claude Code は組み込みセットに動詞を追加します
3637 * `"replace"`: Claude Code はあなたの動詞のみを表示します3743 * `"replace"`: Claude Code はあなたの動詞のみを表示します
3638* **デフォルト**: 未設定のため、Claude Code は組み込み動詞を使用します3744* **デフォルト**: 未設定、Claude Code は組み込み動詞を使用します
3639 3745
3640この例は 2 つの動詞を組み込みセットに追加します:3746この例は 2 つの動詞を組み込みセットに追加します:
3641 3747
3654 `statusLine`3760 `statusLine`
3655</h3>3761</h3>
3656 3762
3657独自のコマンドを実行して、プロンプトの下に[ステータスライン](/docs/ja/statusline)をレンダリングします。モデル、コスト、git ブランチなどのコンテキストを使用します。オプションのフィールドは間隔を調整し、定期的な再実行を追加し、スクリプト自体が `vim.mode` をレンダリングする場合は組み込みの vim モードインジケーターを非表示にします。3763[ステータスライン](/docs/ja/statusline)をプロンプトの下にレンダリングする独自のコマンドを実行します。モデル、コスト、git ブランチなどのコンテキストを含みます。オプションのフィールドは間隔を調整し、定期的な再実行を追加し、スクリプトが `vim.mode` 自体をレンダリングする場合は組み込みの vim モードインジケーターを非表示にします。
3658 3764
3659* **スコープ**: [`任意のファイル`](#scopes)。[`allowManagedHooksOnly`](#allowmanagedhooksonly) がオンの場合、または [`disableAllHooks`](#disableallhooks) がマネージド設定の外で設定されている場合、マネージド設定値のみが実行されます。3765* **スコープ**: [`任意のファイル`](#scopes)。[`allowManagedHooksOnly`](#allowmanagedhooksonly) がオンの場合、または [`disableAllHooks`](#disableallhooks) がマネージド設定の外で設定されている場合、マネージド設定値のみが実行されます。
3660* **タイプ**: `type` を `"command"` に設定し、`command` 文字列を持つオブジェクト。オプションで `padding` を文字数として、`refreshInterval` を秒数として(最小 `1`)、`hideVimModeIndicator` をブール値として3766* **タイプ**: `type` を `"command"` に設定し、`command` 文字列を持つオブジェクト。オプションで `padding` を文字数として、`refreshInterval` を秒数として(最小 `1`)、`hideVimModeIndicator` をブール値として
3661* **デフォルト**: 未設定のため、ステータスラインはありません3767* **デフォルト**: 未設定、ステータスラインなし
3662 3768
3663この例はモデル名とコンテキスト使用量を出力し、2 文字の水平間隔を追加します:3769この例はモデル名とコンテキスト使用量を出力し、2 文字の水平間隔を追加します:
3664 3770
3672}3778}
3673```3779```
3674 3780
3675この例には [`jq`](https://jqlang.org/) がインストールされている必要があり、シェルで実行されます。PowerShell および Git Bash の同等物については、[Windows 設定](/docs/ja/statusline#windows-configuration)を参照してください。完全なセットアップについては、[ステータスラインを手動で設定](/docs/ja/statusline#manually-configure-a-status-line)を参照してください。3781例には[`jq`](https://jqlang.org/)がインストールされている必要があり、シェルで実行されます。PowerShell および Git Bash の同等物については、[Windows 設定](/docs/ja/statusline#windows-configuration)を参照してください。完全なセットアップについては、[ステータスラインを手動で設定](/docs/ja/statusline#manually-configure-a-status-line)を参照してください。
3676 3782
3677<h3 id="subagentstatusline">3783<h3 id="subagentstatusline">
3678 `subagentStatusLine`3784 `subagentStatusLine`
3679</h3>3785</h3>
3680 3786
3681Claude が[サブエージェント](/docs/ja/sub-agents)を実行する場合、Claude Code はプロンプトの下のタスク表示にそれらをリストします。1 行あたり 1 つのサブエージェント。`name · description · token count` を表示します。このキーを使用すると、独自のコマンドを実行してそれらの行を書き直すことができます。例えば、各サブエージェントのコンテキスト使用量をパーセンテージとして表示します。各更新時に、Claude Code は表示されている行を 1 つの JSON オブジェクトとして stdin に送信します。各サブエージェントの `id`、`name`、`status`、`model`、`tokenCount` などを持つ `tasks` 配列を使用します。`id` として書き直した各行を `{"id", "content"}` 行として置き換えます。書き直さない行はデフォルトレンダリングを保持します。3787Claude が[サブエージェント](/docs/ja/sub-agents)を実行する場合、Claude Code はプロンプトの下のタスク表示にそれらをリストします。サブエージェントごとに 1 行。`name · description · token count` を表示します。このキーを使用すると、独自のコマンドを実行してそれらの行を書き直すことができます。例えば、各サブエージェントのコンテキスト使用量をパーセンテージとして表示します。各リフレッシュで、Claude Code は表示されている行を 1 つの JSON オブジェクトとして stdin に送信します。`tasks` 配列は各サブエージェントの `id`、`name`、`status`、`model`、`tokenCount` などを含みます。書き直した各 `id` の行を `{"id", "content"}` 行として置き換えます。書き直さない行はデフォルトレンダリングを保持します。
3682 3788
3683* **スコープ**: [`任意のファイル`](#scopes)。[`allowManagedHooksOnly`](#allowmanagedhooksonly) がオンの場合、または [`disableAllHooks`](#disableallhooks) がマネージド設定の外で設定されている場合、マネージド設定値のみが実行されます。3789* **スコープ**: [`任意のファイル`](#scopes)。[`allowManagedHooksOnly`](#allowmanagedhooksonly) がオンの場合、または [`disableAllHooks`](#disableallhooks) がマネージド設定の外で設定されている場合、マネージド設定値のみが実行されます。
3684* **タイプ**: `type` を `"command"` に設定し、`command` 文字列を持つオブジェクト3790* **タイプ**: `type` を `"command"` に設定し、`command` 文字列を持つオブジェクト
3685* **デフォルト**: 未設定のため、Claude Code はデフォルト行をレンダリングします3791* **デフォルト**: 未設定、Claude Code はデフォルト行をレンダリングします
3686 3792
3687```json settings.json theme={null}3793```json settings.json theme={null}
3688{3794{
3699 `syntaxHighlightingDisabled`3805 `syntaxHighlightingDisabled`
3700</h3>3806</h3>
3701 3807
3702Claude Code は、ターミナルに表示する diff、コードブロック、ファイルプレビューで言語別にコードを色付けします。組み込みハイライターを使用します。プラグインまたは言語サーバーは関係ありません。このキーを `true` に設定してプレーンテキストとして表示します。例えば、色がターミナルテーマと衝突する場合やスクリーンリーダーを遅くする場合。3808Claude Code は組み込みハイライターを使用して、ターミナルに表示される diff、コードブロック、ファイルプレビューで言語別にコードを色付けします。プラグインまたは言語サーバーは関与しません。このキーを `true` に設定して、代わりにプレーンテキストとして表示します。例えば、色がターミナルテーマと競合する場合やスクリーンリーダーを遅くする場合。
3703 3809
3704* **スコープ**: [`任意のファイル`](#scopes)3810* **スコープ**: [`任意のファイル`](#scopes)
3705* **タイプ**: ブール値3811* **タイプ**: ブール値
3717 `terminalProgressBarEnabled`3823 `terminalProgressBarEnabled`
3718</h3>3824</h3>
3719 3825
3720一部のターミナルは、それらで実行されているプログラムのタブまたはタスクバーに進捗インジケーターを表示できます。Claude が作業している間、Claude Code は進行中の状態をターミナルに報告するため、別のタブまたはウィンドウからセッションがまだビジーかどうかを確認できます。[バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)または[動的ワークフロー](/docs/ja/workflows)がまだ実行されている間、インジケーターはターンの終了後も表示されたままになり、セッションがアイドル状態になるとクリアされます。3826一部のターミナルは、それらで実行されているプログラムのタブまたはタスクバーに進捗インジケーターを表示できます。Claude が作業している間、Claude Code はターミナルに進行中の状態を報告するため、別のタブまたはウィンドウからセッションがまだビジーかどうかを確認できます。[バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)または[動的ワークフロー](/docs/ja/workflows)がまだ実行されている間、インジケーターはターンの終了後も表示されたままになり、セッションがアイドル状態になるとクリアされます。
3721 3827
3722Claude Code はインジケーターをサポートするターミナルでのみ報告します。ConEmu、Ghostty 1.2.0 以降、および iTerm2 3.6.6 以降。このキーを `false` に設定して、Claude Code がそれを報告するのを停止します。`/config` に **Terminal progress bar** として表示されます。3828Claude Code はインジケーターをサポートするターミナルでのみ報告します。ConEmu、Ghostty 1.2.0 以降、および iTerm2 3.6.6 以降。このキーを `false` に設定して、Claude Code がそれを報告するのを停止します。`/config` に**ターミナル進捗バー**として表示されます。
3723 3829
3724* **スコープ**: [`任意のファイル`](#scopes)。設定ファイルがそれを設定しない場合、古いバージョンの `~/.claude.json` の値が適用されます。3830* **スコープ**: [`任意のファイル`](#scopes)。古いバージョンの `~/.claude.json` の値は、設定ファイルがそれを設定しない場合に適用されます。
3725* **タイプ**: ブール値3831* **タイプ**: ブール値
3726 * `true`: サポートするターミナルでターミナル進捗バーが表示されます3832 * `true`: サポートするターミナルでターミナル進捗バーが表示されます
3727 * `false`: Claude Code はターミナル進捗バーを非表示にします3833 * `false`: Claude Code はターミナル進捗バーを非表示にします
3737 `terminalTitleFromRename`3843 `terminalTitleFromRename`
3738</h3>3844</h3>
3739 3845
3740Claude Code はターミナルタブのタイトルを設定します。デフォルトでは、会話から生成されたタイトルを使用し、`/rename` または `--name` でセッションに[名前を付ける](/docs/ja/sessions#name-your-sessions)と、タブはその名前を代わりに表示します。このキーを `false` に設定して、セッションに名前を付けた後も、生成されたタイトルをタブに保持します。名前自体は引き続き適用されるため、`/resume <name>` とセッションピッカーはそれを見つけます。3846Claude Code はターミナルタブのタイトルを設定します。デフォルトでは、会話から生成されたタイトルを使用し、`/rename` または `--name` で[セッションに名前を付ける](/docs/ja/sessions#name-your-sessions)と、タブはその名前を代わりに表示します。このキーを `false` に設定して、セッションに名前を付けた後も、生成されたタイトルをタブに保持します。名前自体は引き続き適用されるため、`/resume <name>` とセッションピッカーはそれを見つけます。
3741 3847
3742* **スコープ**: [`任意のファイル`](#scopes)3848* **スコープ**: [`任意のファイル`](#scopes)
3743* **タイプ**: ブール値3849* **タイプ**: ブール値
3744 * `true`: ターミナルタブのタイトルは設定したセッション名を表示します3850 * `true`: ターミナルタブのタイトルは設定したセッション名を表示します
3745 * `false`: タブは Claude Code が会話から生成したタイトルを保持します3851 * `false`: タブは会話から生成された Claude Code のタイトルを保持します
3746* **デフォルト**: `true`3852* **デフォルト**: `true`
3747 3853
3748```json settings.json theme={null}3854```json settings.json theme={null}
3757 `theme`3863 `theme`
3758</h3>3864</h3>
3759 3865
3760インターフェースのカラーテーマを選択します。`/config` に **Theme** として表示されます。3866インターフェースのカラーテーマを選択します。`/config` に**テーマ**として表示されます。
3761 3867
3762* **スコープ**: [`任意のファイル`](#scopes)。設定ファイルがそれを設定しない場合、古いバージョンの `~/.claude.json` の値が適用されます。3868* **スコープ**: [`任意のファイル`](#scopes)。古いバージョンの `~/.claude.json` の値は、設定ファイルがそれを設定しない場合に適用されます。
3763* **タイプ**: 文字列、以下のいずれか:3869* **タイプ**: 文字列、以下のいずれか:
3764 * `"auto"`: ターミナルの明るいまたは暗い背景に一致します3870 * `"auto"`: ターミナルの明るいまたは暗い背景に一致します
3765 * `"dark"`: ダークテーマ3871 * `"dark"`: ダークテーマ
3783 `timeFormat`3889 `timeFormat`
3784</h3>3890</h3>
3785 3891
3786Claude Code がインターフェースに表示する時刻の書き方を選択します。例えば、各ターン期間メッセージの終わりの `done 6:05 PM` と[トランスクリプトビューア](/docs/ja/interactive-mode#transcript-viewer)のタイムスタンプ。プリセットを選択するには、`/config` を実行して **Time format** を設定します。Claude Code v2.1.257 以降が必要です。3892Claude Code がインターフェースに表示する時刻の書き方を選択します。例えば、各ターン期間メッセージの終わりの `done 6:05 PM` と[トランスクリプトビューアー](/docs/ja/interactive-mode#transcript-viewer)のタイムスタンプ。プリセットを選択するには、`/config` を実行して**時間形式**を設定します。Claude Code v2.1.257 以降が必要です。
3787 3893
3788* **スコープ**: [`任意のファイル`](#scopes)3894* **スコープ**: [`任意のファイル`](#scopes)
3789* **タイプ**: 文字列、以下のいずれか:3895* **タイプ**: 文字列、以下のいずれか:
3790 * `"auto"`: 未設定と同じです。各時刻は組み込み形式を保持します。ターン期間メッセージではロケールに従います3896 * `"auto"`: 未設定と同じです。各時刻は組み込み形式を保持し、ターン期間メッセージではロケールに従います
3791 * `"12-hour"`: 12 時間制3897 * `"12-hour"`: 12 時間制
3792 * `"24-hour"`: 24 時間制3898 * `"24-hour"`: 24 時間制
3793 * `"24-hour-utc"`: UTC での 24 時間制。分の後に `Z` が付きます。例えば `18:05Z`。Claude Code はこのプリセットの [`timeZone`](#timezone) を無視します3899 * `"24-hour-utc"`: UTC での 24 時間制。分の後に `Z` が付きます。例えば `18:05Z`。Claude Code はこのプリセットの [`timeZone`](#timezone) を無視します
3794 * `"%H:%M"` などの strftime パターン: Claude Code は各時刻をパターンで書きます。`%` を含む値はパターンであり、プリセット外の他の値は `"auto"` としてカウントされます3900 * `"%H:%M"` などの strftime パターン: Claude Code はパターンで各時刻を書きます。`%` を含む値はパターンであり、プリセット外の他の値は `"auto"` としてカウントされます
3795* **デフォルト**: `"auto"`3901* **デフォルト**: `"auto"`
3796 3902
3797```json settings.json theme={null}3903```json settings.json theme={null}
3808}3914}
3809```3915```
3810 3916
3811ターン期間メッセージとトランスクリプトビューアは `18:05` などの時刻を表示します。トランスクリプトビューアでは、パターンはタイムスタンプ全体であるため、日付を含めたい場合は日付ディレクティブを追加します。この例は時計の前に日付を置きます:3917ターン期間メッセージとトランスクリプトビューアーは `18:05` などの時刻を表示します。トランスクリプトビューアーでは、パターンはタイムスタンプ全体であるため、日付をそこに含める場合は日付ディレクティブを追加します。この例は時計の前に日付を配置します:
3812 3918
3813```json settings.json theme={null}3919```json settings.json theme={null}
3814{3920{
3822 `timeZone`3928 `timeZone`
3823</h3>3929</h3>
3824 3930
3825インターフェースの時刻をシステムのタイムゾーン以外のタイムゾーンで表示します。[IANA タイムゾーン名](https://www.iana.org/time-zones)(例えば `"UTC"` または `"Europe/Dublin"`)に設定します。[`timeFormat`](#timeformat) が制御する時刻はこのゾーンで表示されます。`timeFormat` が `"24-hour-utc"` の場合、時刻は UTC のままであり、Claude Code はこのキーを無視します。`/config` にはこのキーの行がないため、設定ファイルで設定します。Claude Code v2.1.257 以降が必要です。3931インターフェースの時刻をシステムの時刻以外のタイムゾーンで表示します。[IANA タイムゾーン名](https://www.iana.org/time-zones)(`"UTC"` または `"Europe/Dublin"` など)に設定します。[`timeFormat`](#timeformat) が制御する時刻はこのゾーンで表示されます。`timeFormat` が `"24-hour-utc"` の場合、時刻は UTC のままであり、Claude Code はこのキーを無視します。`/config` にはこのキーの行がないため、設定ファイルで設定します。Claude Code v2.1.257 以降が必要です。
3826 3932
3827* **スコープ**: [`任意のファイル`](#scopes)3933* **スコープ**: [`任意のファイル`](#scopes)
3828* **タイプ**: 文字列、IANA タイムゾーン名。Claude Code が名前を認識しない場合、システムタイムゾーンを使用します3934* **タイプ**: 文字列、IANA タイムゾーン名。Claude Code が名前を認識しない場合、システムタイムゾーンを使用します
3829* **デフォルト**: 未設定のため、時刻はシステムタイムゾーンで表示されます3935* **デフォルト**: 未設定、時刻はシステムタイムゾーンで表示されます
3830 3936
3831```json settings.json theme={null}3937```json settings.json theme={null}
3832{3938{
3838 `tui`3944 `tui`
3839</h3>3945</h3>
3840 3946
3841ターミナル UI レンダラーを選択します。ちらつきのない[alt-screen レンダラー](/docs/ja/fullscreen)を使用する場合は `"fullscreen"` を使用します。仮想スクロールバック付き。クラシックメインスクリーンレンダラーの場合は `"default"` を使用します。`/tui fullscreen` または `/tui default` を実行すると、このキーが自動的に書き込まれます。3947ターミナル UI レンダラーを選択します。ちらつきのない[alt-screen レンダラー](/docs/ja/fullscreen)を仮想スクロールバックで使用するには `"fullscreen"` を使用するか、クラシックメインスクリーンレンダラーには `"default"` を使用します。`/tui fullscreen` または `/tui default` を実行すると、このキーが書き込まれます。
3842 3948
3843* **スコープ**: [`任意のファイル`](#scopes)3949* **スコープ**: [`任意のファイル`](#scopes)
3844* **タイプ**: 文字列、以下のいずれか:3950* **タイプ**: 文字列、以下のいずれか:
3845 * `"default"`: クラシックメインスクリーンレンダラー3951 * `"default"`: クラシックメインスクリーンレンダラー
3846 * `"fullscreen"`: 仮想スクロールバック付きのちらつきのない alt-screen レンダラー3952 * `"fullscreen"`: 仮想スクロールバック付きのちらつきのない alt-screen レンダラー
3847* **デフォルト**: 未設定のため、Claude Code は[レンダラーを自動的に選択](/docs/ja/fullscreen#fullscreen-by-default)します3953* **デフォルト**: 未設定、Claude Code は[レンダラーを自動的に選択](/docs/ja/fullscreen#fullscreen-by-default)します
3848* **セッションごとのオーバーライド**: [`CLAUDE_CODE_NO_FLICKER`](/docs/ja/env-vars) と [`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`](/docs/ja/env-vars) はこのキーより優先されます。`CLAUDE_CODE_NO_FLICKER=1` はフルスクリーンをオンにし、`CLAUDE_CODE_NO_FLICKER=0` または `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1` はオフにします。両方が設定されている場合、Claude Code はオフにします3954* **セッションごとのオーバーライド**: [`CLAUDE_CODE_NO_FLICKER`](/docs/ja/env-vars) と [`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`](/docs/ja/env-vars) はこのキーより優先されます。`CLAUDE_CODE_NO_FLICKER=1` はフルスクリーンをオンにし、`CLAUDE_CODE_NO_FLICKER=0` または `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1` はオフにします。両方が設定されている場合、Claude Code はオフにします
3849 3955
3850```json settings.json theme={null}3956```json settings.json theme={null}
3853}3959}
3854```3960```
3855 3961
3856tmux `-CC` の下またはWindows への SSH 経由では、Claude Code は `CLAUDE_CODE_NO_FLICKER=1` を設定しない限りクラシックレンダラーを保持します。[エージェントビュー](/docs/ja/agent-view)から開かれたバックグラウンドセッションは、この設定に関係なく常にフルスクリーンレンダラーを使用します。3962tmux `-CC` の下または Windows への SSH 経由では、Claude Code は `CLAUDE_CODE_NO_FLICKER=1` を設定しない限りクラシックレンダラーを保持します。[エージェントビュー](/docs/ja/agent-view)から開かれたバックグラウンドセッションは、この設定に関係なく常にフルスクリーンレンダラーを使用します。
3857 3963
3858<h3 id="verbose">3964<h3 id="verbose">
3859 `verbose`3965 `verbose`
3860</h3>3966</h3>
3861 3967
3862デフォルトでは、トランスクリプトは各ツール呼び出しを短い要約に折りたたみます。例えば、Claude が実行したコマンドと出力の行数。詳細が必要な場合は `Ctrl+O` を押してトランスクリプト全体を展開ビューに切り替えます。このキーを `true` に設定して、すべてのツール呼び出しの完全な入力と出力をインラインで表示します。フック、MCP サーバー、または長いシェルコマンドをデバッグする場合に便利です。`/config` に **Verbose output** として表示されます。3968デフォルトでは、トランスクリプトは各ツール呼び出しを短い要約に折りたたみます。例えば、Claude が実行したコマンドと出力の行数。詳細を表示したい場合は `Ctrl+O` を押してトランスクリプト全体を展開ビューに切り替えます。このキーを `true` に設定して、すべてのツール呼び出しの完全な入力と出力をインラインで表示します。フック、MCP サーバー、または長いシェルコマンドをデバッグする場合に便利です。`/config` に**詳細出力**として表示されます。
3863 3969
3864* **スコープ**: [`任意のファイル`](#scopes)。設定ファイルがそれを設定しない場合、古いバージョンの `~/.claude.json` の値が適用されます。3970* **スコープ**: [`任意のファイル`](#scopes)。古いバージョンの `~/.claude.json` の値は、設定ファイルがそれを設定しない場合に適用されます。
3865* **タイプ**: ブール値3971* **タイプ**: ブール値
3866 * `true`: 完全なツール出力が表示されます3972 * `true`: 完全なツール出力が表示されます
3867 * `false`: ツール出力の切り詰められた要約が表示されます3973 * `false`: ツール出力の切り詰められた要約が表示されます
3886* **タイプ**: 文字列、以下のいずれか:3992* **タイプ**: 文字列、以下のいずれか:
3887 * `"default"`: 切り詰められたツール出力を持つ通常のトランスクリプト3993 * `"default"`: 切り詰められたツール出力を持つ通常のトランスクリプト
3888 * `"verbose"`: 完全なツール出力を持つトランスクリプト3994 * `"verbose"`: 完全なツール出力を持つトランスクリプト
3889 * `"focus"`: 最後のプロンプトのみ。編集 diffstat を持つツール呼び出しの 1 行の要約。最終応答。フォーカスビューは[フルスクリーンレンダラー](#tui)が必要です3995 * `"focus"`: 最後のプロンプトのみ、ツール呼び出しの 1 行の要約(編集 diffstats を含む)、および最終応答。フォーカスビューは[フルスクリーンレンダラー](#tui)が必要です
3890* **デフォルト**: 未設定のため、`verbose` 設定と最後の `/focus` 選択が適用されます3996* **デフォルト**: 未設定、`verbose` 設定と最後の `/focus` 選択が適用されます
3891* **セッションごとのオーバーライド**: [`--verbose`](/docs/ja/cli-reference#cli-flags) はこのキーより優先されます3997* **セッションごとのオーバーライド**: [`--verbose`](/docs/ja/cli-reference#cli-flags) はこのキーより優先されます
3892 3998
3893```json settings.json theme={null}3999```json settings.json theme={null}
3923[音声ディクテーション](/docs/ja/voice-dictation)をオンにし、ディクテーションキーの動作を選択します。Claude Code は `/voice` を実行するとこのオブジェクトを書き込みます。4029[音声ディクテーション](/docs/ja/voice-dictation)をオンにし、ディクテーションキーの動作を選択します。Claude Code は `/voice` を実行するとこのオブジェクトを書き込みます。
3924 4030
3925* **スコープ**: [`任意のファイル`](#scopes)4031* **スコープ**: [`任意のファイル`](#scopes)
3926* **タイプ**: `enabled` をブール値として、`autoSubmit` をホールドモードのみに適用するブール値として、`mode` を以下のいずれかとするオブジェクト:4032* **タイプ**: `enabled` をブール値として、`autoSubmit` をホールドモードのみに適用するブール値として、`mode` を以下のいずれかとして持つオブジェクト:
3927 * `"hold"`: ディクテーションキーを話している間押し続け、停止するために離します4033 * `"hold"`: ディクテーションキーを話している間押し続け、停止するために離します
3928 * `"tap"`: キーを 1 回タップして記録を開始し、もう一度タップして送信します4034 * `"tap"`: キーを 1 回タップして記録を開始し、もう一度タップして送信します
3929* **デフォルト**: 未設定のため、ディクテーションはオフです。`enabled` が `true` で `mode` が未設定の場合、Claude Code は `"hold"` を使用します4035* **デフォルト**: 未設定、ディクテーションはオフです。`enabled` が `true` で `mode` が未設定の場合、Claude Code は `"hold"` を使用します
3930 4036
3931この例はディクテーションをオンにし、キーを 1 回タップして記録を開始し、もう一度タップして送信するようにします:4037この例はディクテーションをオンにし、キーを 1 回タップして記録を開始し、もう一度タップして送信するようにします:
3932 4038
3949 v2.1.92 以降非推奨。[`voice`](#voice) オブジェクトが置き換えました。Claude Code は引き続きそれを読み取るため、古い設定ファイルは機能し続けますが、新しい設定は `voice.enabled` を設定する必要があります。4055 v2.1.92 以降非推奨。[`voice`](#voice) オブジェクトが置き換えました。Claude Code は引き続きそれを読み取るため、古い設定ファイルは機能し続けますが、新しい設定は `voice.enabled` を設定する必要があります。
3950</Warning>4056</Warning>
3951 4057
3952`voice` オブジェクトの前の単一ブール値形式で音声ディクテーションをオンにします。両方が設定されている場合、`voice.enabled` が適用されます。4058`voice` オブジェクトより前の単一ブール値形式で音声ディクテーションをオンにします。両方が設定されている場合、`voice.enabled` が適用されます。
3953 4059
3954* **スコープ**: [`任意のファイル`](#scopes)4060* **スコープ**: [`任意のファイル`](#scopes)
3955* **タイプ**: ブール値4061* **タイプ**: ブール値
3956 * `true`: claude.ai アカウントでログインしており、組織のポリシーが音声を許可している場合、音声ディクテーションはオンです。`voice.enabled` が設定されていない限り4062 * `true`: claude.ai アカウントでログインしており、組織のポリシーが音声を許可している場合、音声ディクテーションはオンです。`voice.enabled` が設定されていない限り
3957 * `false`: `voice.enabled` が設定されていない限り、音声ディクテーションはオフです4063 * `false`: 音声ディクテーションはオフです。`voice.enabled` が設定されていない限り
3958* **デフォルト**: 未設定4064* **デフォルト**: 未設定
3959 4065
3960```json settings.json theme={null}4066```json settings.json theme={null}
3967 `wheelScrollAccelerationEnabled`4073 `wheelScrollAccelerationEnabled`
3968</h3>4074</h3>
3969 4075
3970[フルスクリーンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling)での高速スクロール中にマウスホイールスクロール速度を加速します。ホイールノッチあたりの一定のスクロール速度の場合は `false` に設定します。4076[フルスクリーンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling)での高速スクロール中にマウスホイールスクロール速度を加速します。ホイールノッチごとに一定のスクロール速度を使用するには `false` に設定します。
3971 4077
3972* **スコープ**: [`任意のファイル`](#scopes)4078* **スコープ**: [`任意のファイル`](#scopes)
3973* **タイプ**: ブール値4079* **タイプ**: ブール値
3974 * `true`: Claude Code は高速スクロール中にマウスホイールスクロール速度を加速します4080 * `true`: Claude Code は高速スクロール中にマウスホイールスクロール速度を加速します
3975 * `false`: Claude Code はホイールノッチあたり一定の速度でスクロールします4081 * `false`: Claude Code はホイールノッチごとに一定の速度でスクロールします
3976* **デフォルト**: `true`4082* **デフォルト**: `true`
3977 4083
3978```json settings.json theme={null}4084```json settings.json theme={null}
4088 4194
4089* **スコープ**: [`Any file`](#scopes)4195* **スコープ**: [`Any file`](#scopes)
4090* **タイプ**: 文字列4196* **タイプ**: 文字列
4091* **デフォルト**: 未設定。Claude Code は `Co-Authored-By: <name> <noreply@anthropic.com>` を追加します。名前はセッションのアクティブなモデル(`Claude Sonnet 5` など)です。4197* **デフォルト**: 未設定。Claude Code は `Co-Authored-By: <name> <noreply@anthropic.com>` を追加します。名前はコミットが作成されるときに使用されているモデル(`Claude Sonnet 5` など)です。[subagent](/docs/ja/sub-agents) がコミットを作成する場合、トレーラーは subagent のモデルに名前を付けます。
4092 * Claude Code がモデルを Claude モデルとして認識しているが、その正確なバージョンを確認できない場合、`Claude` のみを書き込みます。4198 * Claude Code がモデルを Claude モデルとして認識しているが、その正確なバージョンを確認できない場合、`Claude` のみを書き込みます。
4093 * モデル ID をカスタム [`ANTHROPIC_BASE_URL`](/docs/ja/env-vars) を通じて提供されるサードパーティモデルなど、Claude モデルと一致させることができない場合、`Claude Code` を書き込みます。4199 * モデル ID をカスタム [`ANTHROPIC_BASE_URL`](/docs/ja/env-vars) を通じて提供されるサードパーティモデルなど、Claude モデルと一致させることができない場合、`Claude Code` を書き込みます。
4094 4200
5078 `allowManagedMcpServersOnly`5184 `allowManagedMcpServersOnly`
5079</h3>5185</h3>
5080 5186
5081管理対象ホワイトリストのみを適用対象にします。Claude Code は、ユーザー、プロジェクト、ローカル設定の [`allowedMcpServers`](#allowedmcpservers) を無視し、管理設定からのみ [`allowedMcpServers`](#allowedmcpservers) を読み込みます。[`deniedMcpServers`](#deniedmcpservers)は引き続きすべての設定スコープからマージされるため、ユーザーは自分自身のためにサーバーをブロックできます。管理者は、ユーザー自身の設定が管理対象ホワイトリストが許可するものを拡大できないようにするために、これを設定します。5187管理対象ホワイトリストのみを適用対象にします。Claude Code は、ユーザー、プロジェクト、ローカル設定の `allowedMcpServers` を無視し、管理設定からのみ [`allowedMcpServers`](#allowedmcpservers) を読み込みます。[`deniedMcpServers`](#deniedmcpservers)は引き続きすべての設定スコープからマージされるため、ユーザーは自分自身のためにサーバーをブロックできます。管理者は、ユーザー自身の設定が管理対象ホワイトリストが許可するものを拡大できないようにするために、これを設定します。
5082 5188
5083* **スコープ**: [`Managed`](#scopes)5189* **スコープ**: [`Managed`](#scopes)
5084* **タイプ**: ブール値5190* **タイプ**: ブール値
5123 `disableClaudeAiConnectors`5229 `disableClaudeAiConnectors`
5124</h3>5230</h3>
5125 5231
5126Claude Code が自身で取得する[claude.ai MCP コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)をオフにして、取得も接続もしません。任意の設定ファイルで `true` が適用されます。チェックインされたプロジェクト `.claude/settings.json` はリポジトリをこれらのコネクタから除外できますが、プロジェクトレベルの `false` はユーザーレベルまたは管理レベルの `true` をオーバーライドできません。5232[Claude Code が自身で取得する](/docs/ja/mcp#how-connectors-reach-claude-code)[claude.ai MCP コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)をオフにして、取得も接続もしません。任意の設定ファイルで `true` が適用されます。チェックインされたプロジェクト `.claude/settings.json` はリポジトリをこれらのコネクタから除外できますが、プロジェクトレベルの `false` はユーザーレベルまたは管理レベルの `true` をオーバーライドできません。
5127 5233
5128* **スコープ**: [`Any file`](#scopes)5234* **スコープ**: [`Any file`](#scopes)
5129* **タイプ**: ブール値5235* **タイプ**: ブール値
5687* **Type**: Boolean5793* **Type**: Boolean
5688 * `true`: Claude Code は各対話セッションの開始時に Remote Control を自動的に接続します5794 * `true`: Claude Code は各対話セッションの開始時に Remote Control を自動的に接続します
5689 * `false`: Claude Code は `/remote-control` を待ちます5795 * `false`: Claude Code は `/remote-control` を待ちます
5690* **Default**: 未設定なので、自動接続は設定されている場合は組織の管理デフォルトに従い、そうでない場合は Claude Code の現在のデフォルトに従います5796* **Default**: 未設定なので、[自動接続デフォルト](/docs/ja/remote-control#enable-remote-control-for-all-sessions) が適用されます
5691* **Per-session overrides**: `--remote-control` はこのキーが `false` の場合でも 1 つのセッションに対して Remote Control をオンにし、フラグは 1 つのセッションに対してそれをオフにしません5797* **Per-session overrides**: `--remote-control` はこのキーが `false` の場合でも 1 つのセッションに対して Remote Control をオンにし、フラグは 1 つのセッションに対してそれをオフにしません
5692 5798
5693```json settings.json theme={null}5799```json settings.json theme={null}
5839 5945
5840`/login` クラウドゲートウェイ画面が接続するゲートウェイ URL を設定して、ユーザーがアドレスを入力せずに [クラウドゲートウェイ](/docs/ja/claude-apps-gateway)に到達できるようにします。画面には URL フィールドがありません。このキーが設定されている場合、ゲートウェイ URL を表示し、ユーザーが Enter キーを押すと接続します。設定されていない場合、IT 管理者に連絡するよう指示します。5946`/login` クラウドゲートウェイ画面が接続するゲートウェイ URL を設定して、ユーザーがアドレスを入力せずに [クラウドゲートウェイ](/docs/ja/claude-apps-gateway)に到達できるようにします。画面には URL フィールドがありません。このキーが設定されている場合、ゲートウェイ URL を表示し、ユーザーが Enter キーを押すと接続します。設定されていない場合、IT 管理者に連絡するよう指示します。
5841 5947
5842このキーまたは `forceLoginMethod: "gateway"` のいずれかがマシンをゲートウェイのみにするため、`/login` はログイン方法ピッカーなしでクラウドゲートウェイ画面で開きます。残されたファーストパーティログインまたは API キーに何が起こるかについては、[管理者ポリシーがクラウドゲートウェイサインインを必要とします](/docs/ja/errors#administrator-policy-requires-a-cloud-gateway-sign-in)を参照してください。画面がエラーを表示する代わりに接続するように、両方のキーを設定します。5948このキーまたは `forceLoginMethod: "gateway"` のいずれかがマシンをゲートウェイのみにするため、`CLAUDE_CODE_USE_*` でクラウドプロバイダーを選択するセッションを除き、`/login` はログイン方法ピッカーなしでクラウドゲートウェイ画面で開きます。残されたファーストパーティログインまたは API キーに何が起こるかについては、[管理者ポリシーがクラウドゲートウェイサインインを必要とします](/docs/ja/errors#administrator-policy-requires-a-cloud-gateway-sign-in)を参照してください。画面がエラーを表示する代わりに接続するように、両方のキーを設定します。
5843 5949
5844* **スコープ**: [`Managed`](#scopes)。マシン上のソースからのみ読み取ります。`managed-settings.json`、macOS plist または Windows HKLM レジストリ、またはポリシーヘルパー。Claude Code は HKCU およびサーバー管理設定では無視します。5950* **スコープ**: [`Managed`](#scopes)。マシン上のソースからのみ読み取ります。`managed-settings.json`、macOS plist または Windows HKLM レジストリ、またはポリシーヘルパー。Claude Code は HKCU およびサーバー管理設定では無視します。
5845* **タイプ**: 文字列、スキームを含む完全な URL5951* **タイプ**: 文字列、スキームを含む完全な URL
6092 `cleanupPeriodDays`6198 `cleanupPeriodDays`
6093</h3>6199</h3>
6094 6200
6095Claude Code が [セッショントランスクリプトおよび他のアプリケーションデータ](/docs/ja/claude-directory#cleaned-up-automatically) を削除する前に保持する日数を設定します。Claude Code はセッション開始後にバックグラウンド削除を実行します。保持期間を安全に判定できる限り実行されます。6201Claude Code が [セッショントランスクリプトおよび他のアプリケーションデータ](/docs/ja/claude-directory#cleaned-up-automatically) を削除する前に保持する日数を設定します。Claude Code はセッション開始後にバックグラウンド削除を実行します。保持期間を安全に判定できる限り実行されます。削除スイープはメッセージを表示せずにトランスクリプトを削除するため、保持期間より長く使用していないセッションは [`/resume`](/docs/ja/sessions#resume-a-session) ピッカーに表示されなくなります。
6096 6202
6097* **スコープ**: [`Any file`](#scopes)6203* **スコープ**: [`Any file`](#scopes)
6098* **タイプ**: 日数、整数、最小値 `1`6204* **タイプ**: 日数、整数、最小値 `1`
6189 エンタープライズおよび管理設定6295 エンタープライズおよび管理設定
6190</h2>6296</h2>
6191 6297
6192組織がマネージド設定を計算、更新、および組み合わせるために使用するキー。[マネージド設定の設定](/docs/ja/admin-setup)を参照してください。6298組織が管理設定を計算、更新、および組み合わせるために使用するキー。[管理設定の設定](/docs/ja/admin-setup)を参照してください。
6193 6299
6194<h3 id="disablesideloadflags">6300<h3 id="disablesideloadflags">
6195 `disableSideloadFlags`6301 `disableSideloadFlags`
6196</h3>6302</h3>
6197 6303
6198起動時に `--plugin-dir`、`--plugin-url`、`--agents`、および `--mcp-config` CLI フラグを拒否します。ユーザーはこれらのフラグを渡して、単一の実行で [`strictKnownMarketplaces`](#strictknownmarketplaces) をバイパスできます。Claude Code はエラーで終了し、拒否されたフラグを名前で指定します。また、これらのフラグで CLI を内部的に開始するサーフェスに同じチェックを適用します。現在、デスクトップアプリの [Cowork](/docs/ja/desktop) ローカルセッションです。[クラウドセッション](/docs/ja/claude-code-on-the-web)では、Claude Code はサーバーが `--mcp-config` を通じて配信した MCP サーバーをドロップします。ただし、プロセス内の `type: "sdk"` エントリを除きます。セッションを開始します。Claude Code v2.1.193 以降が必要です。6304起動時に `--plugin-dir`、`--plugin-url`、`--agents`、および `--mcp-config` CLI フラグを拒否します。これらのフラグは、ユーザーが [`strictKnownMarketplaces`](#strictknownmarketplaces) を単一実行でバイパスするために渡す可能性があります。Claude Code はエラーで終了し、拒否されたフラグを名前で指定します。また、これらのフラグで CLI を内部的に開始するサーフェスに同じチェックを適用します。現在、デスクトップアプリの [Cowork](/docs/ja/desktop) ローカルセッションです。[クラウドセッション](/docs/ja/claude-code-on-the-web)では、Claude Code は `--mcp-config` を通じてサーバーが配信した MCP サーバーをドロップします。ただし、プロセス内 `type: "sdk"` エントリは除きます。セッションを開始します。Claude Code v2.1.193 以降が必要です。
6199 6305
6200* **スコープ**: [`Managed`](#scopes)6306* **スコープ**: [`Managed`](#scopes)
6201* **タイプ**: ブール値6307* **タイプ**: ブール値
6202 * `true`: Claude Code は起動時に `--plugin-dir`、`--plugin-url`、`--agents`、および `--mcp-config` を拒否し、エラーで終了して名前を指定します。ただし、クラウドセッションではサーバーが `--mcp-config` を通じて配信した MCP サーバーをドロップします。プロセス内の `type: "sdk"` エントリを除き、セッションを開始します6308 * `true`: Claude Code は起動時に `--plugin-dir`、`--plugin-url`、`--agents`、および `--mcp-config` を拒否し、エラーで終了して名前を指定します。ただし、クラウドセッションでは、サーバーが `--mcp-config` を通じて配信した MCP サーバーをドロップします。プロセス内 `type: "sdk"` エントリは除きます。セッションを開始します
6203 * `false`: Claude Code はこれらのフラグを受け入れます6309 * `false`: Claude Code はこれらのフラグを受け入れます
6204* **デフォルト**: `false`6310* **デフォルト**: `false`
6205 6311
6209}6315}
6210```6316```
6211 6317
6212Claude Code は、サーバーがすべてプロセス内の `type: "sdk"` エントリである `--mcp-config` を受け入れます。これにより、Agent SDK と VS Code 拡張機能は動作し続けます。ユーザーは `claude mcp add` またはファイル `.mcp.json` でサーバーを追加できます。サーバーごとの制御については、[`allowedMcpServers`](/docs/ja/managed-mcp) も設定してください。Claude Code v2.1.193 以降が必要です。6318Claude Code は、サーバーがすべてプロセス内 `type: "sdk"` エントリである `--mcp-config` を受け入れます。これにより、Agent SDK と VS Code 拡張機能は動作し続けます。ユーザーは `claude mcp add` またはファイル `.mcp.json` でサーバーを追加できます。サーバーごとの制御については、[`allowedMcpServers`](/docs/ja/managed-mcp) も設定してください。Claude Code v2.1.193 以降が必要です。
6213 6319
6214[`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ja/env-vars#variables) 環境変数で名前が付けられたプラグインフォルダーも同じチェックの対象です。Claude Code v2.1.280 以降が必要です。変数がフォルダーに名前を付ける場合、Claude Code は同じエラーで終了し、エラーは変数をアンセットするように指示します。6320同じチェックは、[`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ja/env-vars#variables) 環境変数で名前が付けられたプラグインフォルダをカバーします。これには Claude Code v2.1.280 以降が必要です。変数がフォルダを名前で指定する場合、Claude Code は同じエラーで終了し、エラーは変数をアンセットするように指示します。
6215 6321
6216クラウドセッションでは、Claude Code はサーバー配信のセッション中 MCP 更新も無視します。これはクラウドセッション構成と、セッションに到達する SDK `setMcpServers()` 呼び出しの背後にあるパスです。プロセス内の `type: "sdk"` エントリはそこでも除外されたままです。v2.1.239 より前では、サーバー配信の `--mcp-config` はクラウドセッションの開始をブロックしていました。6322クラウドセッションでは、Claude Code はセッション中の MCP 更新も無視します。これは、クラウドセッション構成と SDK `setMcpServers()` 呼び出しの背後にあるパスです。プロセス内 `type: "sdk"` エントリはそこでも除外されたままです。v2.1.239 より前では、サーバーが配信した `--mcp-config` はクラウドセッションの開始をブロックしていました。
6217 6323
6218<h3 id="forceremotesettingsrefresh">6324<h3 id="forceremotesettingsrefresh">
6219 `forceRemoteSettingsRefresh`6325 `forceRemoteSettingsRefresh`
6220</h3>6326</h3>
6221 6327
6222Claude Code が [サーバー管理設定](/docs/ja/server-managed-settings) を新たに取得するまで CLI 起動をブロックします。取得に失敗した場合、Claude Code はキャッシュされた設定または設定なしで続行する代わりに終了します。環境がマネージドポリシーなしでセッションが実行される短い時間枠を受け入れられない場合に設定します。6328Claude Code が [サーバー管理設定](/docs/ja/server-managed-settings) を新たに取得するまで CLI 起動をブロックします。取得に失敗した場合、Claude Code はキャッシュされた設定または設定なしで続行する代わりに終了します。環境が管理ポリシーなしでセッションが実行される短い時間枠を受け入れられない場合に設定します。
6223 6329
6224キーが設定されていない場合、Claude Code は取得時に起動をブロックしません。ただし、開発者が起動時にサインインする場合、取得を最大 5 秒間待機します。Cloud ゲートウェイセッションは常に待機し、ゲートウェイに到達できない場合は終了します。6330キーが設定されていない場合、Claude Code は取得時に起動をブロックしません。ただし、開発者が起動時にサインインする場合、取得を最大 5 秒間待機します。Cloud ゲートウェイセッションは常に待機し、ゲートウェイに到達できない場合は終了します。
6225 6331
6226* **スコープ**: [`Managed`](#scopes)。Claude Code は、最優先度のソースでなくても、管理者制御のマネージドソースから `true` を受け入れます。6332* **スコープ**: [`Managed`](#scopes)。Claude Code は、最優先度のソースでなくても、管理者が制御する管理ソースからの `true` を尊重します。
6227* **タイプ**: ブール値6333* **タイプ**: ブール値
6228 * `true`: Claude Code は起動をブロックして、サーバー管理設定を新たに取得するまで待機し、取得に失敗した場合は終了します6334 * `true`: Claude Code は起動をブロックして、サーバー管理設定を新たに取得するまで待機し、取得に失敗した場合は終了します
6229 * `false`: Claude Code は取得時に起動をブロックしません。ただし、サインイン起動では最大 5 秒間待機します6335 * `false`: Claude Code は取得時に起動をブロックしません。ただし、サインイン起動では最大 5 秒間待機します
6235}6341}
6236```6342```
6237 6343
6238MDM プロファイルまたはマネージド設定ファイルで設定して、最初のサーバーペイロードが到着する前に失敗時閉鎖起動を強制します。Claude Code は、サーバー管理設定を取得するセッションでのみチェックを適用します。[それらを取得しないセッション](/docs/ja/server-managed-settings#platform-availability)は待機せずに開始します。`claude auth` サブコマンドは除外されるため、ユーザーは期限切れの認証情報が取得失敗の原因である場合に再認証できます。[失敗時閉鎖起動を強制する](/docs/ja/server-managed-settings#enforce-fail-closed-startup)を参照してください。6344MDM プロファイルまたは管理設定ファイルで設定して、最初のサーバーペイロードが到着する前に失敗時閉鎖起動を強制します。Claude Code は、サーバー管理設定を取得するセッションでのみチェックを適用します。[それらを取得しないセッション](/docs/ja/server-managed-settings#platform-availability)は待機なしで開始します。`claude auth` サブコマンドは除外されるため、ユーザーは期限切れの認証情報が取得に失敗する理由である場合に再認証できます。[失敗時閉鎖起動を強制する](/docs/ja/server-managed-settings#enforce-fail-closed-startup)を参照してください。
6239 6345
6240<h3 id="managedsourcesbehavior">6346<h3 id="managedsourcesbehavior">
6241 `managedSourcesBehavior`6347 `managedSourcesBehavior`
6242</h3>6348</h3>
6243 6349
6244Claude Code が、組織が配信する最優先度の [マネージドソース](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) のみを適用するか、配信するすべての管理者ソースを組み合わせるかを選択します。デフォルトでは、Claude Code は [ポリシーキー](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) を含む最優先度のソースを取得し、残りを無視します。ポリシーキーは、このキーと `wslInheritsWindowsSettings` 以外のすべての設定キーです。サーバー管理設定または MDM ポリシーがポリシーキーを配信すると、`managed-settings.json` ファイルは [Claude Code がすべての管理者ソースから読み取るキー](/docs/ja/managed-settings#keys-read-from-every-admin-source) のみを提供します。`"merge"` を使用すると、配信するすべての管理者ソースがそのキーを 1 つの組み合わせたポリシーに提供します。Claude Code v2.1.242 以降が必要です。6350Claude Code が、組織が配信する最優先度の [管理ソース](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) のみを適用するか、配信するすべての管理者ソースを組み合わせるかを選択します。デフォルトでは、Claude Code は [ポリシーキー](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) を含む最優先度のソースを取得し、残りを無視します。ポリシーキーは、このキーと `wslInheritsWindowsSettings` 以外の設定キーです。そのデフォルトでは、サーバー管理設定または MDM ポリシーがポリシーキーを配信すると、`managed-settings.json` ファイルは [Claude Code がすべての管理ソースから読み取るキー](/docs/ja/managed-settings#keys-read-from-every-admin-source) のみを提供します。`"merge"` を使用すると、配信するすべての管理ソースがそのキーを 1 つの組み合わせたポリシーに提供します。Claude Code v2.1.242 以降が必要です。
6245 6351
6246`"merge"` は、[ランク付けされた](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) 最優先度のソースの下のすべてのソースが管理者の制御下にある場合にのみ設定してください。Claude Code は、`permissions.allow` ルールなどの下位のソースからエントリを追加するためです。6352`"merge"` は、[ランク付けされた](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) 最優先度のソースの下のすべてのソースが管理者の制御下にある場合にのみ設定してください。Claude Code は、`permissions.allow` ルールなどの下位ソースからのエントリをポリシーに追加します。
6247 6353
6248* **スコープ**: [`Managed`](#scopes)。Claude Code はこのキーを、このキーまたはポリシーキーを含む最優先度のソースから読み取り、ランク付けされた下位のすべてのソースでこのキーを無視します。下位のソースはそれ自体を上記のソースとの組み合わせにオプトインできません。Windows HKCU レジストリも [埋め込みホストからの親設定](/docs/ja/managed-settings#let-an-embedding-host-add-policy) も、マージに参加しません。6354* **スコープ**: [`Managed`](#scopes)。Claude Code はこのキーを、このキーまたはポリシーキーを含む最優先度のソースから読み取り、ランク付けされた下位のすべてのソースでこのキーを無視します。下位ソースは、上位のソースとの組み合わせにオプトインできません。Windows HKCU レジストリも [埋め込みホストからの親設定](/docs/ja/managed-settings#let-an-embedding-host-add-policy) も、マージに参加しません。
6249* **タイプ**: 文字列、次のいずれか:6355* **タイプ**: 文字列、次のいずれか:
6250 * `"first-wins"`: ポリシーキーを含む最優先度のソースがポリシーを提供し、下位のソースは [Claude Code がすべての管理者ソースから読み取るキー](/docs/ja/managed-settings#keys-read-from-every-admin-source) のみを提供します6356 * `"first-wins"`: ポリシーキーを含む最優先度のソースがポリシーを提供し、下位ソースは [Claude Code がすべての管理ソースから読み取るキー](/docs/ja/managed-settings#keys-read-from-every-admin-source) のみを提供します
6251 * `"merge"`: 配信するすべての管理者ソースがそのキーを提供し、以下のルールで組み合わせられます6357 * `"merge"`: 配信するすべての管理ソースがそのキーを提供し、以下のルールで組み合わせられます
6252* **デフォルト**: `"first-wins"`6358* **デフォルト**: `"first-wins"`
6253 6359
6254最優先度のソースでキーを配信します。サーバー管理設定を受け取らないマシンは、Claude Code がこのキーまたはポリシーキーを含む最優先度のソースからキーを読み取るため、MDM プロファイルにもキーが必要です。`managed-settings.json` ファイルは最下位のランク付けされた管理者ソースであるため、そこに設定された `"merge"` は、それと組み合わせる下位のソースがありません。サーバー管理設定では、キーは次のようになります:6360デプロイする最優先度のソースでキーを配信します。サーバー管理設定を受け取らないマシンは、Claude Code がこのキーまたはポリシーキーを含む最優先度のソースからキーを読み取るため、MDM プロファイルにもキーが必要です。`managed-settings.json` ファイルは最下位の管理ソースであるため、そこに設定された `"merge"` は、それと組み合わせる下位ソースがありません。サーバー管理設定では、キーは次のようになります:
6255 6361
6256```json theme={null}6362```json theme={null}
6257{6363{
6259}6365}
6260```6366```
6261 6367
6262`"merge"` では、Claude Code は各キーをそのタイプで組み合わせます。このテーブルは各タイプのルールを示します。制限許可リスト、値全体取得、および最優先度ソースのみの行は、それらがカバーするすべてのキーを名前で指定し、他の行は例を示します:6368`"merge"` では、Claude Code は各キーをそのタイプで組み合わせます。このテーブルは各タイプのルールを示します。制限許可リスト、値全体取得、および最優先度ソースのみの行は、カバーするすべてのキーを名前で指定し、他の行は例を示します:
6263 6369
6264| キーのタイプ | Claude Code がそれを組み合わせる方法 | キー |6370| キーのタイプ | Claude Code がそれを組み合わせる方法 | キー |
6265| :- | :- | :- |6371| :- | :- | :- |
6266| リスト | すべてのソースからエントリを組み合わせます | [`permissions.allow`](#permissions-allow)、[`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains)、およびその他のリストキー |6372| リスト | すべてのソースからのエントリを組み合わせます | [`permissions.allow`](#permissions-allow)、[`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains)、およびその他のリストキー |
6267| ロック | いずれかのソースが設定する最も厳密な値を適用します。ソースが厳密な値を設定しない場合、最優先度のソースからのみより緩い値を適用します | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly)、[`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode)、およびその他のブール値または列挙型ロック |6373| ロック | ソースが設定する最も厳密な値を適用します。ソースが厳密な値を設定しない場合、最優先度のソースからのみより緩い値を適用します | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly)、[`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode)、およびその他のブール値または列挙型ロック |
6268| 制限許可リスト | 下位のソースからエントリを追加せずに、最優先度のソースから全体としてリストを取得します。最優先度のソースが設定しない場合、次のソースから全体として取得します | [`availableModels`](#availablemodels)、[`allowedMcpServers`](#allowedmcpservers)、[`strictKnownMarketplaces`](#strictknownmarketplaces)、[`allowedChannelPlugins`](#allowedchannelplugins)、および [`fallbackModel`](#fallbackmodel) チェーン |6374| 制限許可リスト | 下位ソースからのエントリを追加せずに、それを設定する最優先度のソースから全体を取得します。最優先度のソースが設定しない場合、次のソースから全体を取得します | [`availableModels`](#availablemodels)、[`allowedMcpServers`](#allowedmcpservers)、[`strictKnownMarketplaces`](#strictknownmarketplaces)、[`allowedChannelPlugins`](#allowedchannelplugins)、および [`fallbackModel`](#fallbackmodel) チェーン |
6269| 値全体取得 | 下位のソースからエントリまたはフィールドを組み合わせずに、最優先度のソースから全体として値を取得します。最優先度のソースが設定しない場合、次のソースから全体として取得します | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs)、[`sandbox.ripgrep`](#sandbox-ripgrep) |6375| 値全体取得 | 下位ソースからのエントリまたはフィールドを組み合わせずに、それを設定する最優先度のソースから全体を取得します。最優先度のソースが設定しない場合、次のソースから全体を取得します | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs)、[`sandbox.ripgrep`](#sandbox-ripgrep) |
6270| 提供される MCP サーバー | すべてのソースからサーバー名を組み合わせます。2 つのソースが同じ名前を設定する場合、上位のソースの全体エントリを適用します | [`managedMcpServers`](#managedmcpservers) |6376| 提供される MCP サーバー | すべてのソースからサーバー名を組み合わせます。2 つのソースが同じ名前を設定する場合、上位ソースの全体エントリを適用します | [`managedMcpServers`](#managedmcpservers) |
6271| 最優先度のソースからのみ読み取ります | ポリシーキーを含む最優先度のソースからのみキーを読み取るため、最優先度のソースが何も設定しない場合でも下位のソースの値は無視されます | [`apiKeyHelper`](#apikeyhelper)、[`awsAuthRefresh`](#awsauthrefresh)、[`awsCredentialExport`](#awscredentialexport)、[`gcpAuthRefresh`](#gcpauthrefresh)、[`otelHeadersHelper`](#otelheadershelper)、`proxyAuthHelper`、[`forceLoginOrgUUID`](#forceloginorguuid)、[`forceLoginMethod`](#forceloginmethod) の `"claudeai"` および `"console"` 値、[`parentSettingsBehavior`](#parentsettingsbehavior)、[`modelPicker`](#modelpicker)、[`policyHelper`](#policyhelper)、[`permissions.defaultMode`](#permissions-defaultmode) |6377| 最優先度のソースからのみ読み取ります | ポリシーキーを含む最優先度のソースからのみキーを読み取るため、最優先度のソースが何も設定しない場合でも、下位ソースの値は無視されます | [`apiKeyHelper`](#apikeyhelper)、[`awsAuthRefresh`](#awsauthrefresh)、[`awsCredentialExport`](#awscredentialexport)、[`gcpAuthRefresh`](#gcpauthrefresh)、[`otelHeadersHelper`](#otelheadershelper)、`proxyAuthHelper`、[`forceLoginOrgUUID`](#forceloginorguuid)、[`forceLoginMethod`](#forceloginmethod) の `"claudeai"` および `"console"` 値、[`parentSettingsBehavior`](#parentsettingsbehavior)、[`modelPicker`](#modelpicker)、[`policyHelper`](#policyhelper)、[`permissions.defaultMode`](#permissions-defaultmode) |
6272| `env` | [管理者ソース全体で変数ごとにマージします](/docs/ja/managed-settings#keys-read-from-every-admin-source)。`"first-wins"` と `"merge"` の両方の下で | [`env`](#env) |6378| `env` | [管理ソース全体で変数ごとにマージします](/docs/ja/managed-settings#keys-read-from-every-admin-source)。`"first-wins"` と `"merge"` の両方で | [`env`](#env) |
6273| その他のすべてのキー | それを設定する最優先度のソースから値を取得します | [`cleanupPeriodDays`](#cleanupperioddays)、[`model`](#model) |6379| その他のすべてのキー | それを設定する最優先度のソースから値を取得します | [`cleanupPeriodDays`](#cleanupperioddays)、[`model`](#model) |
6274 6380
6275`sandbox.credentials.awsPairs` と `sandbox.ripgrep` を全体として取得するには、Claude Code v2.1.257 以降が必要です。6381`sandbox.credentials.awsPairs` と `sandbox.ripgrep` を全体で取得するには、Claude Code v2.1.257 以降が必要です。
6276 6382
6277これらのキーの 3 つは独自の条件を追加します:6383いくつかのキーは、テーブルが示さない条件を追加します:
6278 6384
6279* **[`policyHelper`](#policyhelper)**: Claude Code はポリシーキーを含む最優先度のソースが MDM ポリシーまたはマネージド設定ファイルである場合にのみそれを受け入れます。サーバー管理設定では適用されません。6385* **[`policyHelper`](#policyhelper)**: Claude Code は、ポリシーキーを含む最優先度のソースが MDM ポリシーまたは管理設定ファイルである場合にのみそれを尊重します。サーバー管理設定では適用されません。
6280* **[`modelOverrides`](#modeloverrides)**: `availableModels` とペアになります。Claude Code は `modelOverrides` をそれを設定する最優先度のソースから取得します。ただし、上位のソースが `modelOverrides` なしで `availableModels` を設定する場合を除きます。その場合、すべてのソースから `modelOverrides` を無視します。6386* **[`modelOverrides`](#modeloverrides)**: `availableModels` とペアになります。Claude Code は、それを設定する最優先度のソースから `modelOverrides` を取得します。ただし、上位ソースが `modelOverrides` なしで `availableModels` を設定する場合は除きます。その場合、すべてのソースから `modelOverrides` を無視します。
6281* **[`forceLoginGatewayUrl`](#forcelogingatewayurl)、[`gatewayInternalNetworks`](#gatewayinternalnetworks)、および [`forceLoginMethod`](#forceloginmethod) の `"gateway"` 値**: Claude Code はサーバー管理設定からこれらを読み取ることはありません。そのため、そこの値は適用されず、MDM ポリシーまたはマネージド設定ファイルで設定された値も隠しません。マシン上の管理者ソースの中で、ポリシーキーを含む最優先度のソースのみがそれらを提供します。サーバー管理設定も存在するかどうかに関わらず。6387* **[`forceLoginGatewayUrl`](#forcelogingatewayurl)、[`gatewayInternalNetworks`](#gatewayinternalnetworks)、および [`forceLoginMethod`](#forceloginmethod) の `"gateway"` 値**: Claude Code はサーバー管理設定からそれらのいずれも読み取りません。そのため、そこでの値は適用されず、MDM ポリシーまたは管理設定ファイルで設定されたものを隠しません。マシン上の管理ソースの中で、ポリシーキーを含む最優先度のソースのみがそれらを提供します。サーバー管理設定も存在するかどうかに関わらず。
6282 6388
6283マシンで組み合わされたソースを確認するには、`/status` を実行し、[`Setting sources` 行を読み取ります](/docs/ja/managed-settings#read-the-source-in-/status)。6389マシンで組み合わせたソースを確認するには、`/status` を実行し、[`Setting sources` 行を読んでください](/docs/ja/managed-settings#read-the-source-in-/status)。
6284 6390
6285<h3 id="parentsettingsbehavior">6391<h3 id="parentsettingsbehavior">
6286 `parentSettingsBehavior`6392 `parentSettingsBehavior`
6287</h3>6393</h3>
6288 6394
6289Claude Code が埋め込みホストプロセス(Agent SDK または IDE 拡張機能など)によって提供されるマネージド設定を適用するかどうかを選択します。管理者がデプロイしたマネージド層も存在する場合。`"first-wins"` では、Claude Code はホスト提供の設定をドロップします。`"merge"` では、制限のみのフィルターを通じて管理者層の下で適用します。ホストが起動するセッションに独自の制限を渡す必要がある場合、`"merge"` を設定します。たとえば、Claude Desktop がゲートウェイの出力許可リストを配信する場合。6395Claude Code が、Agent SDK または IDE 拡張機能などの埋め込みホストプロセスによって提供される管理設定を適用するかどうかを選択します。管理者がデプロイした管理層も存在する場合。`"first-wins"` では、Claude Code はホスト提供の設定をドロップします。`"merge"` では、制限のみのフィルターを通じて管理層の下で適用します。ホストが起動するセッションに独自の制限を渡す必要がある場合、`"merge"` を設定します。たとえば、Claude Desktop がゲートウェイの出力許可リストを配信する場合。
6290 6396
6291* **スコープ**: [`Managed`](#scopes)。Claude Code は最優先度の管理者制御マネージドソースから読み取ります。6397* **スコープ**: [`Managed`](#scopes)。Claude Code はそれを最優先度の管理者制御管理ソースから読み取ります。
6292* **タイプ**: 文字列、次のいずれか:6398* **タイプ**: 文字列、次のいずれか:
6293 * `"first-wins"`: Claude Code は管理者がデプロイしたマネージド層が存在する場合、ホスト提供の設定をドロップします6399 * `"first-wins"`: Claude Code は、管理者がデプロイした管理層が存在する場合、ホスト提供の設定をドロップします
6294 * `"merge"`: Claude Code は制限のみのフィルターを通じて管理者層の下でホスト提供の設定を適用します6400 * `"merge"`: Claude Code は、制限のみのフィルターを通じて管理層の下でホスト提供の設定を適用します
6295* **デフォルト**: `"first-wins"`6401* **デフォルト**: `"first-wins"`
6296 6402
6297```json managed-settings.json theme={null}6403```json managed-settings.json theme={null}
6300}6406}
6301```6407```
6302 6408
6303管理者がデプロイしたマネージド層が存在しない場合、このキーは効果がありません。ホストの設定は唯一のマネージド層として適用され、制限値にフィルターされます。フィルターの制限とマネージドソースの相互作用については、[埋め込みホストからの親設定](/docs/ja/managed-settings#parent-settings-from-embedding-hosts) と [親設定を制限する](/docs/ja/claude-apps-gateway#restrict-parent-settings) を参照してください。6409管理者がデプロイした管理層が存在しない場合、このキーは効果がありません。ホストの設定は、唯一の管理層として適用されます。制限値にフィルターされたままです。フィルターの制限と管理ソースの相互作用については、[埋め込みホストからの親設定](/docs/ja/managed-settings#parent-settings-from-embedding-hosts) および [親設定を制限する](/docs/ja/claude-apps-gateway#restrict-parent-settings) を参照してください。
6304 6410
6305<span id="compute-managed-settings-with-a-policy-helper" />6411<span id="compute-managed-settings-with-a-policy-helper" />
6306 6412
6308 `policyHelper`6414 `policyHelper`
6309</h3>6415</h3>
6310 6416
6311起動時にマネージド設定を計算するデプロイ可能な実行可能ファイルを実行して、デバイスの状態、ID、またはリモートサービスから静的ファイルの代わりにポリシーを導出できます。Claude Code は最初のプロンプトを受け入れる前にヘルパーを実行し、それが出力する設定をセッションのマネージド設定として扱います。6417起動時に管理設定を計算するためにデプロイする実行可能ファイルを実行します。デバイスの状態、ID、またはリモートサービスから静的ファイルの代わりにポリシーを導出できます。Claude Code はヘルパーを実行してから最初のプロンプトを受け入れ、それが出力する設定をセッションの管理設定として扱います。
6312 6418
6313* **スコープ**: [`Managed`](#scopes)。macOS plist、Windows HKLM レジストリ、またはマネージド設定ファイルから読み取ります。Claude Code は [ポリシーキー](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) を含む最優先度のマネージドソースからキーを読み取り、そのソースが 3 つのうちの 1 つである場合にのみヘルパーを実行します。サーバー管理設定、HKCU レジストリ、およびホスト提供の親設定ではキーを無視します。6419* **スコープ**: [`Managed`](#scopes)。macOS plist、Windows HKLM レジストリ、または管理設定ファイルから読み取ります。Claude Code は、[ポリシーキー](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) を含む最優先度の管理ソースからキーを読み取り、そのソースが 3 つのうちの 1 つである場合にのみヘルパーを実行します。サーバー管理設定、HKCU レジストリ、およびホスト提供の親設定ではキーを無視します。
6314* **タイプ**: `path`、`timeoutMs`、および `refreshIntervalMs` を含むオブジェクト6420* **タイプ**: `path`、`timeoutMs`、および `refreshIntervalMs` を含むオブジェクト
6315* **デフォルト**: 設定されていないため、ヘルパーは実行されません6421* **デフォルト**: 設定されていないため、ヘルパーは実行されません
6316 6422
6317サーバー管理設定が起動時にポリシーを配信する場合、ヘルパーのソースより優先され、ヘルパーは実行されません。6423サーバー管理設定が起動時にポリシーを配信する場合、ヘルパーのソースより優先され、ヘルパーは実行されません。
6318 6424
6319後のセッション取得がサーバー管理設定が削除されたことを報告する場合、Claude Code はその時点でヘルパーを実行します。次の起動を待つ代わりに。その出力はセッションの残りを管理し、失敗した実行は [失敗した起動実行](#helper-failures) と同じメッセージでセッションを終了します。6425後の設定取得がサーバー管理設定が削除されたことを報告する場合、Claude Code はその時点でヘルパーを実行します。次の起動を待つ代わりに。その出力はセッションの残りを管理し、失敗した実行は [失敗した起動実行](#helper-failures) と同じメッセージでセッションを終了します。
6320 6426
6321この例は、5 秒のタイムアウトでヘルパーを実行し、5 分ごとに再実行します:6427この例は、5 秒のタイムアウトでヘルパーを実行し、5 分ごとに再実行します:
6322 6428
6336 6442
6337Claude Code はヘルパーを引数なしで実行し、その環境に `CLAUDE_CODE_VERSION` を設定し、stdout から JSON エンベロープを読み取ります。1 MiB でキャップされます。6443Claude Code はヘルパーを引数なしで実行し、その環境に `CLAUDE_CODE_VERSION` を設定し、stdout から JSON エンベロープを読み取ります。1 MiB でキャップされます。
6338 6444
6339設定を `managedSettings` キーの下に配置します。`managedSettings` キーのない単なる設定オブジェクトは、`managedSettings` が未定義で何も適用されず、Claude Code はエラーを報告しません:6445設定を `managedSettings` キーの下に配置します。`managedSettings` キーのない裸の設定オブジェクトは、`managedSettings` が未定義で何も適用されず、Claude Code はエラーを報告しません:
6340 6446
6341```json theme={null}6447```json theme={null}
6342{6448{
6346}6452}
6347```6453```
6348 6454
6349ヘルパーが `managedSettings` を出力する場合、そのオブジェクトは実行のための唯一のマネージド設定ソースになります。Claude Code は MDM、ファイル、および HKCU ソースを無視し、[クロスソースキー](/docs/ja/managed-settings#keys-read-from-every-admin-source) をヘルパーの出力からのみ読み取り、[親設定](/docs/ja/managed-settings#parent-settings-from-embedding-hosts) をマージしません。6455ヘルパーが `managedSettings` を出力する場合、そのオブジェクトは実行の唯一の管理設定ソースになります。Claude Code は MDM、ファイル、および HKCU ソースを無視し、[クロスソースキー](/docs/ja/managed-settings#keys-read-from-every-admin-source) をヘルパーの出力からのみ読み取り、[親設定](/docs/ja/managed-settings#parent-settings-from-embedding-hosts) をマージしません。
6350 6456
6351起動 `forceRemoteSettingsRefresh` チェックはヘルパーの前に実行され、任意の管理者ソースを読み取ります。ヘルパーが `managedSettings` を省略したエンベロープで 0 で終了する場合、マネージド設定を提供しません。他のソースは通常どおり適用されます。6457起動 `forceRemoteSettingsRefresh` チェックはヘルパーの前に実行され、任意の管理ソースを読み取ります。ヘルパーが `managedSettings` を省略するエンベロープで `0` で終了する場合、管理設定を提供しません。他のソースは通常どおり適用されます。
6352 6458
6353<h4 id="helper-failures">6459<h4 id="helper-failures">
6354 ヘルパー失敗6460 ヘルパーの失敗
6355</h4>6461</h4>
6356 6462
6357ヘルパー実行は次の場合に失敗します:6463ヘルパー実行は次の場合に失敗します:
6358 6464
6359* `path` は [`policyHelper.path`](#policyhelper-path) のルールを破ります。6465* `path` は [`policyHelper.path`](#policyhelper-path) のルールを破ります。
6360* `path` に通常ファイルがありません。Claude Code は同じ `timeoutMs` 予算内でヘルパーを開始する前にファイルをチェックするため、応答しないネットワークマウントは実行を失敗させる可能性があります。6466* `path` に通常ファイルがありません。Claude Code は、同じ `timeoutMs` 予算内でヘルパーを開始する前にファイルをチェックするため、応答しないネットワークマウントは実行を失敗させる可能性があります。
6361* ヘルパーが 0 以外で終了し、`timeoutMs` が経過してもまだ実行中であるか、まったく開始されません。たとえば、実行可能でないため。6467* ヘルパーが 0 以外で終了し、`timeoutMs` が経過してもまだ実行中であるか、まったく開始しません。たとえば、実行可能でないため。
6362* ヘルパーが stdout または stderr に 1 MiB 以上を書き込みます。6468* ヘルパーが stdout または stderr に 1 MiB 以上を書き込みます。
6363* stdout は単一の JSON オブジェクトではないか、その `managedSettings` に [Claude Code が修復できないスキーマ違反](/docs/ja/managed-settings#find-entries-claude-code-dropped) があります。6469* stdout は単一の JSON オブジェクトではないか、その `managedSettings` に [Claude Code が修復できないスキーマ違反](/docs/ja/managed-settings#find-entries-claude-code-dropped) があります。
6364 6470
6365起動実行が失敗する場合、Claude Code は理由を出力し、起動を拒否します。0 以外の終了後、理由にはヘルパーの stderr が含まれます。stderr が空の場合は stdout が含まれます。タイムアウト後、理由は `timeoutMs` 制限を名前で指定し、ヘルパーの出力は含まれません。拒否はインタラクティブセッション、`claude -p`、Agent SDK セッション、[バックグラウンドセッション](/docs/ja/agent-view)、およびほとんどのサブコマンドをカバーします。6471起動実行が失敗する場合、Claude Code は理由を出力し、起動を拒否します。0 以外の終了後、理由にはヘルパーの stderr が含まれます。stderr が空の場合は stdout が含まれます。タイムアウト後、理由は `timeoutMs` 制限を名前で指定し、ヘルパーの出力は含まれません。拒否は、対話型セッション、`claude -p`、Agent SDK セッション、[バックグラウンドセッション](/docs/ja/agent-view)、およびほとんどのサブコマンドをカバーします。
6366 6472
6367拒否は意図的なため、アウテージ復元力が必要なヘルパーは独自のキャッシュから提供し、0 で終了する必要があります。6473拒否は意図的なため、停止復旧が必要なヘルパーは独自のキャッシュから提供し、`0` で終了する必要があります。
6368 6474
6369バックグラウンド更新が失敗する場合、Claude Code は最後に成功したポリシーを有効に保ち、`/status` は更新が成功するまで失敗した更新とその理由を表示します。各更新は起動実行と同じ `timeoutMs` および失敗ルールの下で実行されます。6475バックグラウンド更新が失敗する場合、Claude Code は最後に成功したポリシーを有効に保ち、`/status` は失敗した更新をその理由とともに表示します。更新が成功するまで。各更新は、起動実行と同じ `timeoutMs` および失敗ルールの下で実行されます。
6370 6476
6371`--debug` を使用すると、Claude Code はすべての実行からヘルパーの stderr を [デバッグログ](/docs/ja/debug-your-config) に書き込みます。6477`--debug` を使用すると、Claude Code はすべての実行からヘルパーの stderr を [デバッグログ](/docs/ja/debug-your-config) に書き込みます。
6372 6478
6373Claude Code は無効な `policyHelper` 値を [ドロップされたエントリ](/docs/ja/managed-settings#find-entries-claude-code-dropped) として報告し、残りのマネージド設定でセッションを開始し、ヘルパーを実行しません。無効な値には、単なるパス文字列と [その最小値](#policyhelper-timeoutms) より低い `timeoutMs` が含まれます。6479Claude Code は無効な `policyHelper` 値を [ドロップされたエントリ](/docs/ja/managed-settings#find-entries-claude-code-dropped) として報告し、残りの管理設定でセッションを開始します。ヘルパーを実行しません。無効な値には、裸のパス文字列と [その最小値](#policyhelper-timeoutms) より低い `timeoutMs` が含まれます。
6374 6480
6375ヘルパーをオフにするには、それを設定するソースからキーを削除します。6481ヘルパーをオフにするには、それを設定するソースからキーを削除します。
6376 6482
6378 `policyHelper.path`6484 `policyHelper.path`
6379</h3>6485</h3>
6380 6486
6381Claude Code が実行するヘルパー実行可能ファイルに名前を付けます。パスがルールを破った場合の動作については、[ヘルパー失敗](#helper-failures) を参照してください。6487Claude Code が実行するヘルパー実行可能ファイルに名前を付けます。パスがルールを破る場合に何が起こるかについては、[ヘルパーの失敗](#helper-failures) を参照してください。
6382 6488
6383* **スコープ**: [`Managed`](#scopes)。macOS plist、Windows HKLM レジストリ、またはマネージド設定ファイルから読み取ります。[`policyHelper`](#policyhelper) が読み取られる場所。6489* **スコープ**: [`Managed`](#scopes)。macOS plist、Windows HKLM レジストリ、または管理設定ファイルから読み取ります。[`policyHelper`](#policyhelper) が読み取られる場所。
6384* **タイプ**: 文字列、`.` または `..` セグメントのない正規化された形式の絶対パス。Windows では、`.exe` で終わるドライブレターまたは UNC パス6490* **タイプ**: 文字列、正規化された形式の絶対パス。`.` または `..` セグメントなし。Windows では、`.exe` で終わるドライブレターまたは UNC パス
6385* **デフォルト**: なし。`policyHelper` が設定されている場合は必須6491* **デフォルト**: なし。`policyHelper` が設定されている場合は必須
6386 6492
6387```json managed-settings.json theme={null}6493```json managed-settings.json theme={null}
6396 `policyHelper.timeoutMs`6502 `policyHelper.timeoutMs`
6397</h3>6503</h3>
6398 6504
6399Claude Code がヘルパーを待機する期間を設定してから、実行を失敗として扱います。タイムアウトした実行は 0 以外の終了と同じ方法で失敗するため、起動時に Claude Code は起動を拒否します。6505Claude Code がヘルパーを待機する時間を設定してから、実行を失敗として扱います。タイムアウトした実行は 0 以外の終了と同じ方法で失敗するため、起動時に Claude Code は起動を拒否します。
6400 6506
6401* **スコープ**: [`Managed`](#scopes)。macOS plist、Windows HKLM レジストリ、またはマネージド設定ファイルから読み取ります。[`policyHelper`](#policyhelper) が読み取られる場所。6507* **スコープ**: [`Managed`](#scopes)。macOS plist、Windows HKLM レジストリ、または管理設定ファイルから読み取ります。[`policyHelper`](#policyhelper) が読み取られる場所。
6402* **タイプ**: 整数、ミリ秒、最小 `1000`6508* **タイプ**: 整数、ミリ秒、最小 `1000`
6403* **デフォルト**: `10000`6509* **デフォルト**: `10000`
6404 6510
6415 `policyHelper.refreshIntervalMs`6521 `policyHelper.refreshIntervalMs`
6416</h3>6522</h3>
6417 6523
6418Claude Code がバックグラウンドでヘルパーを間隔で再実行して、ポリシーの変更が実行中のセッションに到達するようにします。更新が成功する場合、その出力は前のマネージド設定を再起動なしで置き換えます。更新が失敗する場合、Claude Code は既に持っているポリシーを保ちます。6524Claude Code がバックグラウンドでヘルパーを間隔で再実行するようにして、ポリシーの変更が実行中のセッションに到達するようにします。更新が成功する場合、その出力は前の管理設定を再起動なしで置き換えます。更新が失敗する場合、Claude Code は既に持っているポリシーを保ちます。
6419 6525
6420* **スコープ**: [`Managed`](#scopes)。macOS plist、Windows HKLM レジストリ、またはマネージド設定ファイルから読み取ります。[`policyHelper`](#policyhelper) が読み取られる場所。6526* **スコープ**: [`Managed`](#scopes)。macOS plist、Windows HKLM レジストリ、または管理設定ファイルから読み取ります。[`policyHelper`](#policyhelper) が読み取られる場所。
6421* **タイプ**: 整数、ミリ秒: 更新を無効にするには `0`、それ以外は最低 `60000`6527* **タイプ**: 整数、ミリ秒: 更新を無効にするには `0`。それ以外の場合は最小 `60000`
6422* **デフォルト**: 設定されていないため、Claude Code はヘルパーを起動時に 1 回実行します6528* **デフォルト**: 設定されていないため、Claude Code はヘルパーを起動時に 1 回実行します
6423 6529
6424この例は、5 分ごとにヘルパーを再実行します:6530この例は、5 分ごとにヘルパーを再実行します:
6436 `wslInheritsWindowsSettings`6542 `wslInheritsWindowsSettings`
6437</h3>6543</h3>
6438 6544
6439WSL 上の Claude Code が Windows ポリシーチェーンからマネージド設定を読み取るようにします。HKLM と Windows マネージド設定ファイルが `/etc/claude-code` と下の HKCU より優先されます。チェーンがオンの間、Claude Code は `C:\Program Files\ClaudeCode\` の下のマネージド設定ファイルまたはドロップインが [ポリシーキー](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) を配信しない場合にのみ `/etc/claude-code` を読み取ります。Windows に既にデプロイしたポリシーを WSL セッションに拡張するように設定して、同じマシン上のホストセッションと同じルールに従うようにします。Claude Code はそれを HKLM レジストリキーまたは `C:\Program Files\ClaudeCode\` の下のマネージド設定ファイルまたはドロップインで設定した場合にのみ受け入れます。どちらも Windows 管理者が書き込む必要があります。6545WSL 上の Claude Code が Windows ポリシーチェーンから管理設定を読み取るようにします。HKLM と Windows 管理設定ファイルが `/etc/claude-code` と下の HKCU より優先されます。チェーンがオンの間、Claude Code は [Windows 管理ドキュメントが存在しない](/docs/ja/managed-settings#present-admin-documents) 場合にのみ `/etc/claude-code` を読み取ります。HKLM レジストリ値または `C:\Program Files\ClaudeCode\` フォルダ内。Windows に既にデプロイしているポリシーを WSL セッションに拡張するために設定します。同じマシン上で、ホストセッションと同じルールに従うようにします。Claude Code は、HKLM レジストリキーまたは管理設定ファイルまたは `C:\Program Files\ClaudeCode\` の下のドロップインで設定されている場合にのみそれを尊重します。どちらも Windows 管理者が書き込む必要があります。
6440 6546
6441* **スコープ**: [`Managed`](#scopes)。管理者制御の Windows ソースで。6547* **スコープ**: [`Managed`](#scopes)。管理者制御の Windows ソースで。
6442* **タイプ**: ブール値6548* **タイプ**: ブール値
6443 * `true`: WSL 上の Claude Code は Windows ポリシーチェーンからマネージド設定を読み取り、`C:\Program Files\ClaudeCode\` の下のマネージド設定ファイルまたはドロップインが [ポリシーキー](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) を配信しない場合にのみ `/etc/claude-code` を読み取ります6549 * `true`: WSL 上の Claude Code は Windows ポリシーチェーンから管理設定を読み取り、Windows 管理ドキュメントが存在しない場合にのみ `/etc/claude-code` を読み取ります
6444 * `false`: WSL は `/etc/claude-code` のみを読み取ります6550 * `false`: WSL は `/etc/claude-code` のみを読み取ります
6445* **デフォルト**: `false`。WSL は `/etc/claude-code` のみを読み取ります6551* **デフォルト**: `false`。WSL は `/etc/claude-code` のみを読み取ります
6446 6552
6450}6556}
6451```6557```
6452 6558
6453管理者ソースがチェーンをオンにすると、HKCU ポリシーは HKCU もキーを `true` に設定する場合にのみ WSL に参加します。そのコピーはそれ自体でチェーンをオンにしません。このキーのみを含む Windows ソースはポリシーソースとしてカウントされないため、下位優先度のソースはポリシーを提供します。このキーはネイティブ Windows に効果がありません。6559管理ソースがチェーンをオンにすると、HKCU ポリシーは HKCU もキーを `true` に設定する場合にのみ WSL に参加します。そのコピーはチェーンをそれ自体でオンにしません。このキーのみを含む Windows ソース。`true` または `false` に設定されている場合、ポリシーソースとしてカウントされません。下位優先度のソースはまだポリシーを提供します。このキーはネイティブ Windows に効果がありません。
6560
6561Claude Code は `true` と `false` を引用符の有無にかかわらず読み取り、`null` をキーの削除として読み取ります。他の値を保持する管理者制御の Windows ソースは、[存在する管理ドキュメント](/docs/ja/managed-settings#present-admin-documents) としてカウントされます。チェーンがオンの場合: `/etc/claude-code` も HKCU も適用されず、起動警告がキーを名前で指定します。読み取ることができない HKLM 値または Windows フォルダファイルも、チェーンがオンかどうかに関わらず `/etc/claude-code` が適用されるのを防ぎます。Claude Code v2.1.282 以降が必要です。
6454 6562
6455<h2 id="global-config-settings">6563<h2 id="global-config-settings">
6456 グローバル設定6564 グローバル設定
6500 6608
6501Claude Code は `settings.json` でこのキーを無視します。6609Claude Code は `settings.json` でこのキーを無視します。
6502 6610
6611<h3 id="claudeinchromedefaultenabled">
6612 `claudeInChromeDefaultEnabled`
6613</h3>
6614
6615[Chrome 統合](/docs/ja/chrome)をオンにして、毎回 `--chrome` を渡さずにすべてのインタラクティブ CLI セッションを開始します。[`claude remote-control`](/docs/ja/remote-control) を実行する場合、[プロジェクト](/docs/ja/claude-projects)スレッドの 1 つに対して開始するセッションもこのキーに従います。ただし、`bypassPermissions` モードの場合は除きます。`/chrome` を実行して **Enabled by default** を選択すると、[Chrome をデフォルトで有効にする](/docs/ja/chrome#enable-chrome-by-default)で説明されているように、このキーが設定されます。`/config` に **Claude in Chrome enabled by default** として表示されます。
6616
6617* **スコープ**: [`グローバル設定`](#scopes)
6618* **タイプ**: ブール値
6619 * `true`: Claude Code は `--chrome` を渡すときと同様に、インタラクティブ CLI セッションが開始するときに Chrome 統合をオンにします
6620 * `false`: インタラクティブ CLI セッションは Chrome 統合をオフで開始し、Claude Code は[セットアップを提案するのを停止](/docs/ja/chrome#install-the-extension-when-claude-asks)します。1 つのインタラクティブセッションでオンにするには `--chrome` を渡してください
6621* **デフォルト**: 未設定。Chrome 統合はオフで、Claude Code はセットアップを提案できます
6622* **セッションごとのオーバーライド**: `--chrome` と [`--no-chrome`](/docs/ja/cli-reference) はこのキーより優先され、1 つのインタラクティブセッションで機能します
6623
6624```json ~/.claude.json theme={null}
6625{
6626 "claudeInChromeDefaultEnabled": true
6627}
6628```
6629
6630Claude Code は `settings.json` でこのキーを無視します。
6631
6632<h3 id="copyfullresponse">
6633 `copyFullResponse`
6634</h3>
6635
6636[`/copy`](/docs/ja/commands) が応答に含まれるコードブロックがある場合に表示するピッカーなしで、毎回完全な応答をコピーします。そのピッカーで **Always copy full response** を選択すると、このキーが `true` に設定されます。`/config` に **Skip the /copy picker** として表示されます。
6637
6638* **スコープ**: [`グローバル設定`](#scopes)
6639* **タイプ**: ブール値
6640 * `true`: `/copy` はピッカーを表示せずに完全な応答をコピーします
6641 * `false`: 応答にコードブロックが含まれている場合、`/copy` はピッカーを表示し、1 つのコードブロックまたは完全な応答を選択できます
6642* **デフォルト**: `false`
6643
6644```json ~/.claude.json theme={null}
6645{
6646 "copyFullResponse": true
6647}
6648```
6649
6650Claude Code は `settings.json` でこのキーを無視します。
6651
6503<h3 id="copyonselect">6652<h3 id="copyonselect">
6504 `copyOnSelect`6653 `copyOnSelect`
6505</h3>6654</h3>
6520 6669
6521Claude Code は `settings.json` でこのキーを無視します。6670Claude Code は `settings.json` でこのキーを無視します。
6522 6671
6672<h3 id="defaulttoagentsview">
6673 `defaultToAgentsView`
6674</h3>
6675
6676引数なしで `claude` を実行するときに、新しい会話の代わりに[エージェントビュー](/docs/ja/agent-view)を開きます。エージェントビューが[オフ](#disableagentview)になっていない限り、`/config` に **Open agents view by default** として表示されます。
6677
6678* **スコープ**: [`グローバル設定`](#scopes)
6679* **タイプ**: ブール値
6680 * `true`: 引数なしの `claude` はエージェントビューを開きます。ただし、エージェントビューが[オフ](#disableagentview)になっている場合は除きます
6681 * `false`: 引数なしの `claude` は新しい会話を開始します
6682* **デフォルト**: `false`
6683
6684```json ~/.claude.json theme={null}
6685{
6686 "defaultToAgentsView": true
6687}
6688```
6689
6690Claude Code は `settings.json` でこのキーを無視します。
6691
6523<h3 id="difftool">6692<h3 id="difftool">
6524 `diffTool`6693 `diffTool`
6525</h3>6694</h3>
6574 6743
6575Claude Code は `settings.json` でこのキーを無視します。6744Claude Code は `settings.json` でこのキーを無視します。
6576 6745
6746<h3 id="leftarrowopensagents">
6747 `leftArrowOpensAgents`
6748</h3>
6749
6750空のプロンプトで `←` を押して、[セッションをバックグラウンドにしてエージェントビューを開き](/docs/ja/agent-view#switch-sessions-without-leaving-the-terminal)ます。このキーを `false` に設定してショートカットをオフにします。エージェントビューが利用可能な場合、`/config` に **← opens agents** として表示されます。
6751
6752* **スコープ**: [`グローバル設定`](#scopes)
6753* **タイプ**: ブール値
6754 * `true`: ターミナルで開始したセッションの空のプロンプトで `←` を押すと、セッションがバックグラウンドになり、エージェントビューが開きます
6755 * `false`: Claude Code はショートカットをオフにします。[エージェントビューから接続した](/docs/ja/agent-view#attach-to-a-session)セッションでは、空のプロンプトで `←` を押すと切断されます
6756* **デフォルト**: `true`
6757
6758```json ~/.claude.json theme={null}
6759{
6760 "leftArrowOpensAgents": false
6761}
6762```
6763
6764Claude Code は `settings.json` でこのキーを無視します。
6765
6577<h3 id="permissionexplainerenabled">6766<h3 id="permissionexplainerenabled">
6578 `permissionExplainerEnabled`6767 `permissionExplainerEnabled`
6579</h3>6768</h3>
6588* **タイプ**: ブール値6777* **タイプ**: ブール値
6589* **デフォルト**: `true`6778* **デフォルト**: `true`
6590 6779
6780<h3 id="prstatusfooterenabled">
6781 `prStatusFooterEnabled`
6782</h3>
6783
6784現在のブランチのオープンなプルリクエストまたはマージリクエストのバッジをプロンプトフッターに表示し、その[ステータス](/docs/ja/interactive-mode#pr-review-status)を示す色付きの下線を表示します。`/config` に **Show PR status footer** として表示されます。
6785
6786* **スコープ**: [`グローバル設定`](#scopes)
6787* **タイプ**: ブール値
6788 * `true`: フッターは [PR レビューステータス](/docs/ja/interactive-mode#pr-review-status)の条件下でバッジを表示します
6789 * `false`: Claude Code はフッターのプルリクエストおよびマージリクエストチェックをスキップし、そのバッジを表示しません。[エージェントビューから接続した](/docs/ja/agent-view#attach-to-a-session)セッションは、[リンクされた](/docs/ja/agent-view#pull-request-status)プルリクエストへのプレーンリンクを表示できます
6790* **デフォルト**: `true`
6791
6792```json ~/.claude.json theme={null}
6793{
6794 "prStatusFooterEnabled": false
6795}
6796```
6797
6798Claude Code は `settings.json` でこのキーを無視します。
6799
6591<h3 id="teammatedefaultmodel">6800<h3 id="teammatedefaultmodel">
6592 `teammateDefaultModel`6801 `teammateDefaultModel`
6593</h3>6802</h3>