設定キー一覧

Claude Code が設定ファイルから読むキーの一覧です。分類（モデル・権限・サンドボックス・メモリ・画面・Git・フック・プラグイン・MCP・エージェント・リモート・認証・更新・ツール・プライバシー・組織管理・グローバル設定）ごとに表にしています。ファイルの置き場所と優先順位は 設定ファイルの仕組み にあります。

• キー名は settings.json にそのまま書く。ドット付きのキー（sandbox.enabled など）は入れ子のオブジェクトで書く
• 「適用範囲」は説明の頭の【】で示す。【】が無いキーは、ユーザー（~/.claude/settings.json）・プロジェクト（.claude/settings.json）・ローカル（.claude/settings.local.json）・管理設定のどれにも置ける
• 【管理設定のみ】のキーは、ユーザー・プロジェクト・ローカル設定と --settings に書くと無視される。多くは警告が出るが、requiredMaximumVersion と requiredMinimumVersion は警告なしで無視される
• 【グローバル設定】のキーは settings.json でなく ~/.claude.json に置く
• 環境変数で同じことをするものは 環境変数一覧、権限ルールの書き方は 権限ルール、サンドボックスの仕組みは サンドボックス を見る

モデルと応答#

使うモデルと応答の仕方を決めます。/model や環境変数との関係は モデル・effort・fast mode を見てください。

modelPicker のフィールド#

• behavesAs は v2.1.257 以降。model が自分のバージョンより新しいときに、既知のモデルの ID（例：claude-opus-4-8）を指定すると、そのモデルの機能と effort の既定が使われる
• availableModels の許可リストはこれらの行にも適用される。サーバーが出せない行（廃止・アクセスなし）は落とされ、まだ選べない行はグレーアウトされ、1 行も残らなければ組み込みの一覧（許可リストで絞ったもの）に戻る

modelPricing のフィールド#

• 行の単価は書いたとおりに使われ、fast mode の割増や米国内推論の料金は加算されない。multiplier も指定すれば、その上に掛かる
• 組み込みモデルの ID をキーにした行は、そのモデルの日付付きスナップショットとプロバイダー固有の ID すべてに適用される。それ以外のキー（ゲートウェイのエイリアスなど）はその 1 つの ID だけ。完全一致のほうが優先される
• Bedrock のアプリケーション推論プロファイルは、modelOverrides か bedrock:GetInferenceProfile で解決されたモデルの行が適用される

権限#

ツールを聞かずに使える範囲、必ず確認するもの、ブロックするもの、セッションの開始権限モードを決めます。ルールの書き方は 権限ルール、モードの意味は 権限モード を見てください。

permissions.defaultMode の値の意味は次のとおりです。

permissions.blockReadsOutsideWorkingDirectories をオンにしてサンドボックスも有効なら、サンドボックス内のコマンドにもブロックが及びます。

• サンドボックス内のコマンドは、ホームディレクトリと /Users・/home・/root・/Volumes・/mnt・/media・/run/media・/srv の読み取りが拒否され、作業ディレクトリなどだけが開き直される
• 作業ディレクトリが linked git worktree のときは、リポジトリ共通の .git ディレクトリが読み書きできるままになり、git が動く
• 次の場合はサンドボックス内のコマンドにはブロックが及ばない（Claude のファイルツールでは有効）：sandbox.filesystem.disabled でファイルシステムの隔離がオフ、allowManagedReadPathsOnly が設定されている、起動ディレクトリのパスに *・?・[ が含まれる
• グローバルな git 設定（~/.gitconfig・$XDG_CONFIG_HOME/git の config・ignore・attributes・include/includeIf/core.excludesFile/core.attributesFile が指すファイル）はサンドボックス内のコマンドに開き直される。サンドボックスが書き込める場所にあるファイル（シンボリックリンク経由を含む）は開き直されない
• Linux・WSL2 ではシンボリックリンクの設定ファイルが読めないままのことがあり、git はそれなしで動く。~/.git-credentials と $XDG_CONFIG_HOME/git/credentials はブロックされたまま
• 開き直されたファイルに秘密（http.extraHeader のトークンなど）があるなら、sandbox.filesystem.denyRead にパスを足す（denyRead が常に優先）

サンドボックス#

Claude が実行する Bash コマンドを、ファイルシステムとネットワークから隔離します。仕組みと使い方は サンドボックス を見てください。まず sandbox.enabled でオンにし、filesystem・network・credentials で触れる範囲を狭めたり広げたりします。

管理設定や --settings の sandbox.allowUnsandboxedCommands: false などでサンドボックスが「admin-required」になっている間は、sandbox.excludedCommands・sandbox.failIfUnavailable・sandbox.filesystem.*・sandbox.network.* など多くのキーで、リポジトリの .claude/settings.json と .claude/settings.local.json の項目が制限される（取り込まれるのは管理設定・--settings・ユーザー設定）。sandbox.network.allowManagedDomainsOnly が true の間も同じ状態になる。詳しくは サンドボックス を見てください。

sandbox 本体#

sandbox.filesystem#

allowWrite・denyWrite・denyRead・allowRead・credentials.files のパスは、接頭辞で解決されます。

• //path の絶対パスの書き方も使える。プロジェクト相対のつもりで /path と書いたなら ./path にする（Read・Edit の権限ルールは //path が絶対、/path がプロジェクト相対で、サンドボックスのパスとは書き方が違う）
• 末尾のスラッシュは取り除かれる（~/.aws と ~/.aws/ は同じ）。v2.1.224 より前は末尾のスラッシュがそのままサンドボックスに渡り、denyRead・denyWrite の下のパスを読み書きできることがあった
• 末尾の /** も取り除かれる（~/build/** と ~/build は同じ範囲）
• ワイルドカード：allowWrite・denyWrite は macOS で使える。Linux・WSL2 では、末尾の /** を除いたあとに *・?・[ を含む項目はスキップされ効かない（Edit の権限ルールから足されるパスにも同じ制限がある）。denyRead・allowRead はどのプラットフォームでも使え、Linux・WSL2 では一致する具体的なパスに展開される

sandbox.credentials#

サンドボックス内のコマンドから守る認証情報ファイルと環境変数を宣言します。各項目は path（ファイル）か name（変数）と mode を持ちます。deny はサンドボックス内で隠し、mask はサンドボックス内のコマンドには身代わりの値を見せて、プロキシが外向きの通信でだけ本物の値に置き換えます。

ファイルのマスクのフィールド#

mask の項目に付けられる任意のフィールドです。extract も decode も無ければ、ファイルの内容全体が 1 つの身代わりの値に置き換わります。macOS でファイルシステムの隔離がオンのときは、extract・decode の前に mask が deny として適用されます。

{
  "sandbox": {
    "credentials": {
      "files": [
        {
          "path": "~/.config/gh/hosts.yml",
          "mode": "mask",
          "extract": "oauth_token:\\s*(\\S+)",
          "maskDuplicates": true,
          "onExtractNoMatch": "deny",
          "injectHosts": ["api.github.com"]
        }
      ]
    }
  }
}

環境変数のマスクのフィールド#

mask の項目に付けられる任意のフィールドです。extract も decode も無ければ、値全体が 1 つの身代わりの値に置き換わります。同じ項目で extract と decode は併用できません。

{
  "sandbox": {
    "credentials": {
      "envVars": [
        { "name": "DATABASE_URL", "mode": "mask", "extract": "://[^:]+:([^@]+)@", "onExtractNoMatch": "deny" },
        { "name": "SERVICE_JWT", "mode": "mask", "decode": "jwt", "maskClaims": ["api_key"] }
      ]
    }
  }
}

sandbox.network#

サンドボックス内のコマンドが届くホスト・ポート・ソケットを決めます。外向きの通信は、これらのリストを強制するプロキシ経由になります。

メモリとコンテキスト#

コンパクト・自動メモリ・CLAUDE.md の読み込み・環境変数・チェックポイントなどの設定です。関連：CLAUDE.md とメモリ、コンテキストとプロンプトキャッシュ、チェックポイントと巻き戻し。

env の仕組み#

env に書いた値は、シェルで export した同じ変数を上書きします。使える変数は 環境変数一覧 を見てください。

シェルとの関係#

• 複数の設定ファイルが同じ変数を設定したら、優先順位の高いものが効く。プロジェクト／ローカル設定で無視される変数は下の「env で無視される変数」
• Claude Desktop アプリやセルフホストのランナーがセッションを始める場合は、そちらが作る起動環境が優先される。起動環境がすでに設定している変数への env の値は、どの設定ファイルのものも無視される（無視した変数名はデバッグログに出る）
• シェルの export を打ち消すには、その変数を "" にする。プロバイダー選択では空は未設定として扱われ、サブプロセスは空の値を引き継ぐ
• ここで設定した NO_COLOR と FORCE_COLOR はサブプロセスにだけ届く。Claude Code 自身の画面の色を変えるなら、claude を起動する前にシェルで設定する
• 値は設定ファイルの中では平文で、Claude Code が起動するすべてのサブプロセスに届く。ローテーションする OTLP の Bearer トークンには otelHeadersHelper、API の資格情報には apiKeyHelper を使う

いつ適用されるか#

• ユーザー設定・--settings・管理設定：起動時と、保存した変更でマージ後の env が変わったとき実行中のセッションにも
• プロジェクト／ローカル設定：ワークスペースを信頼したあと（-p モードは信頼ダイアログを出さないので起動時）。保存した変更でマージ後の env が変わったときにも
• Claude Code が安全と分類する変数（モデル選択・タイムアウトと上限・機能のトグルなど）：起動時にどの設定ファイルからも（プロジェクト／ローカル設定が設定できない変数を除く）
• v2.1.246 以降で /cd でセッションを移したあと：新しいディレクトリのプロジェクト／ローカルの env が、前のディレクトリのものの上に重なる

env で無視される変数#

プロジェクト／ローカル設定は、チェックアウトしたリポジトリに握らせたくない変数を設定できません。その変数はシェル・ユーザー設定・管理設定で設定します。無視された変数は捨てられ（テレメトリをオフにする値を除く）、claude --debug で見える警告が出ます。

• Claude Code が自分のファイルを置く・書く場所を選ぶ変数：CLAUDE_CONFIG_DIR・CLAUDE_CODE_TMPDIR、OS のディレクトリ変数（HOME・TMPDIR・TMP・TEMP・XDG_*）
• セッションの内容を出力する変数：OTEL_LOG_RAW_API_BODIES、詳細ベータトレースの ENABLE_BETA_TRACING_DETAILED と BETA_TRACING_ENDPOINT
• Windows で、Claude Code が起動するプロセスのプログラムとマシン全体の設定を決める変数：SystemRoot・ComSpec・ProgramData・LOCALAPPDATA・PATHEXT・PSModulePath・ProgramFiles 系
• テレメトリをオンにする・送信先を選ぶ・取り込む内容を選ぶ OpenTelemetry の変数（v2.1.282 以降）：CLAUDE_CODE_ENABLE_TELEMETRY、拡張テレメトリベータの CLAUDE_CODE_ENHANCED_TELEMETRY_BETA と ENABLE_ENHANCED_TELEMETRY_BETA、エクスポーター選択の OTEL_LOGS_EXPORTER・OTEL_METRICS_EXPORTER・OTEL_TRACES_EXPORTER、内容の OTEL_LOG_USER_PROMPTS・OTEL_LOG_ASSISTANT_RESPONSES・OTEL_LOG_TOOL_CONTENT・OTEL_LOG_TOOL_DETAILS、名前が _ENDPOINT・_HEADERS・_PROTOCOL・_CERTIFICATE・_CLIENT_KEY・_INSECURE で終わる OTEL_EXPORTER_OTLP_*、OTEL_EXPORTER_PROMETHEUS_HOST・OTEL_EXPORTER_PROMETHEUS_PORT
• 起動や同期の仕方を変える変数：CLAUDE_CODE_PROCESS_WRAPPER・CLAUDE_CODE_SYNC_SKILLS・CLAUDE_CODE_SYNC_PLUGINS・CLAUDE_CODE_PLUGIN_CACHE_DIR・CLAUDE_CODE_PLUGIN_SEED_DIR
• 次の値だけは、何かをオフにするのでプロジェクト／ローカル設定からでも有効：3 つのエクスポーター選択の none、OTEL_LOG_USER_PROMPTS・OTEL_LOG_TOOL_CONTENT・OTEL_LOG_TOOL_DETAILS の 0 などのオフの値。ユーザー設定の同じ変数を上書きするが、起動環境・--settings・管理設定が設定したものは上書きしない
• この群をプロジェクト／ローカル設定が設定すると、ローカルの対話セッションは起動時に通知を出す。/status か claude doctor で、無視された変数とテレメトリをオフにした変数の名前（値は出ない）を確認できる。-p と Agent SDK では通知が出ないので、アップグレード後にコレクターへデータが届くか確認し、届かなければユーザー設定などに移す
• v2.1.251 より前は、プロジェクト／ローカル設定が、ファイルの置き場所を選ぶ変数とセッション内容を出力する変数（HOME と XDG_CONFIG_HOME を除く）も設定できた
• ホスティング環境が持つ ID 変数（CLAUDE_CODE_REMOTE・CLAUDE_CODE_ACCOUNT_UUID など）は、どのファイルからも無視される
• Claude Code 自身が export する CLAUDE_CODE_MESSAGING_SOCKET（v2.1.224 以降）と CLAUDE_CODE_MESSAGING_TOKEN（v2.1.228 以降）は、どのファイルからも無視される
• 起動環境からだけ読む CLAUDE_CODE_PROJECT_DIR_NAME（v2.1.234 以降）・CLAUDE_CODE_RESTRICTED・CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY（v2.1.283 以降）・CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT・CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT・CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT は、どのファイルからも無視される

画面とターミナル#

画面の表示・入力・ステータスラインなどの設定です。関連：ステータスライン、ターミナル・表示・音声入力、キーボードショートカット。

spinnerTipsOverride の tips の項目#

tips の各項目は文字列か、次のフィールドを持つオブジェクトです。

• 文字列だけのヒントは、位置ベースの id と上の既定値で読まれ、並べ替えると表示履歴がリセットされる。履歴を保つには id を付ける
• tips と tipsFile を合わせて最大 200 件まで読まれ、無効な項目はデバッグ警告つきで捨てられる（設定ファイル自体は拒否されない）
• tipsFile：同じ項目の配列（または tips 配列を持つオブジェクト）を入れたローカル JSON ファイルの絶対パスか ~/ のパス（256 KB まで）。プロセスごとに一度だけ読むので、編集は次の起動で反映される。サーバー管理設定では設定できない
• tips のオブジェクト・tipsFile・label と、プロジェクト／ローカル設定が文字列のヒントだけを出せるという規則は v2.1.247 以降。オブジェクトのヒント・tipsFile・label・excludeDefault は、ユーザー設定・--settings・管理設定からだけ有効

fileSuggestion のコマンドの入出力#

• コマンドはフックと同じ環境変数（CLAUDE_PROJECT_DIR を含む）で実行され、5 秒で待つのをやめる
• 標準入力に、いま入力した内容を持つ query フィールドの JSON が届く：{"query": "src/comp"}
• 標準出力に改行区切りのファイルパスを出す。表示は最大 15 件

#!/bin/bash
# stdin の JSON から query を取り、リポジトリのファイルインデックスに渡す（your-repo-file-index は自前のコマンド）
query=$(cat | jq -r '.query')
your-repo-file-index --query "$query" | head -20

footerLinksRegexes のバッジの制約#

Git とコミットの帰属表示#

コミットとプルリクエストに Claude Code が付ける帰属表示や、git まわりのコンテキストの設定です。

フックと自動化#

フックと動的ワークフローの設定です。フックの書き方は フックのリファレンス と フックの使い方、ワークフローは ワークフロー を見てください。

allowManagedHooksOnly の下で動くもの#

true にすると、読み込まれるフックとフック類似のコマンドが次のように変わります。/goal はフックに依存するので、このキーがあると実行できません。

• 動く：管理設定のフックと、Agent SDK がプロセス内で登録するフック
• 動く：管理設定の enabledPlugins で強制有効にしたプラグインのフック（plugin@marketplace の完全な ID で照合するので、別のマーケットプレイスの同名プラグインはブロックされたまま。審査済みのフックを組織のマーケットプレイスで配れる）。そのプラグインの mod は、組織のものとして数えられる場合にだけ読み込まれる
• ブロックされる：ユーザー・プロジェクト・ローカルのフック、ほかのインストール済みプラグインのフックと mod、エージェントのフロントマターのフック（Claude Code 組み込みの mod は動き続ける。ユーザーの mod だけを止めるなら allowManagedModsOnly）
• 無効になる：command ソースのプラグイン（管理 enabledPlugins で強制有効のものを含む。disableCommandPluginSources を明示的に false にした場合を除く）
• ブロックされる：マーケットプレイスの headersHelper コマンド（disableCommandPluginSources を明示的に false にした場合と、管理設定自身が宣言したマーケットプレイスを除く。v2.1.238 以降）
• 管理設定だけに絞られる：statusLine・fileSuggestion・subagentStatusLine

プラグインとスキル#

スキル・プラグイン・マーケットプレイスの設定です。使い方は スキル・プラグインを使う、配布側の設定は プラグインのリファレンス と 組織への導入と管理設定 を見てください。

マーケットプレイスの許可リストのソース種別（strictKnownMarketplaces・blockedMarketplaces）#

ほとんどの種類は完全一致で照合され、hostPattern と pathPattern は正規表現、github は owner のワイルドカードを使えます。

• url：ダウンロードするのは marketplace.json だけで、相対パスのプラグインファイルはそのサーバーから取らない。プラグインは相対パス以外のソース（アーカイブ URL など）にする。相対パスのプラグインには Git ベースのマーケットプレイスを使う
• hostPattern：社内の GitHub Enterprise や GitLab のサーバーの全マーケットプレイスを、リポジトリを並べずに許可する。github ソースは github.com、url ソースは URL のホスト名、git ソースは URL の形に応じて（スキーム付きは URL のホスト名、git@host:path 形式は @ と : の間）照合する。file と directory はホストを持たず、hostPattern には一致しない
• pathPattern：ネットワークソースの hostPattern と並べて、ファイルシステム上のマーケットプレイスを許可する。".*" はすべてのローカルパス、"^/opt/approved/" はそのディレクトリに限る
• 許可リストを設定すると（空でも）~/.claude/skills/ の @skills-dir プラグインが読み込まれなくなる。読み込み続けるなら { "source": "skills-dir" } を足す（この項目はこのキーと blockedMarketplaces の外では意味を持たない）
• owner のワイルドカード：github の repo が "<owner>/*" なら、その GitHub owner のすべてのリポジトリに一致する（v2.1.223 以降。strictKnownMarketplaces と blockedMarketplaces でのみ使える）。*・*/plugins・acme-corp/tools-* は無効として無視される
• 完全一致：github・git では repo/url・ref・path が完全に一致するか、両方未指定でなければならない。ref や path が違う項目は別のソース扱い
• 公式のマーケットプレイスだけを許可するには、そのリポジトリを列挙する

strictKnownMarketplaces と extraKnownMarketplaces の違い#

extraKnownMarketplaces のソース種別#

source オブジェクトは次のいずれかの形です。

• github・git ソースの clone では Git LFS の内容はダウンロードされず、LFS の対象ファイルはポインターファイルとしてチェックアウトされる。source 内の skipLfs は受け付けるが効果なし（v2.1.274 より前は "skipLfs": true を指定しないと LFS をダウンロードした）
• headersHelper は、marketplace.json を取得する前（後の更新も含む）と、そのマーケットプレイス URL の origin（スキーム・ホスト・ポートが同じ）からのプラグインアーカイブのダウンロード前に実行される。--add-dir で足したディレクトリの設定の headersHelper は無視され、固定の headers だけが送られる
• settings ソースのプラグインは GitHub や npm など外部のソースを参照しなければならず、name はマーケットプレイスのキーと一致させる。各プラグインは enabledPlugins で別にオンにする。source: 'settings' の項目で、自身の source が archive のものは、アーカイブのダウンロード用に headers（短命なら headersHelper。両方可。v2.1.238 以降）を設定できる。コマンドは、ユーザーがそのプラグインを単独でインストール・更新するときだけ実行される
• プロジェクトの .claude/settings.json・.claude/settings.local.json の項目では、ユーザーがそのフォルダも信頼したあとにだけコマンドが実行され、リクエストのルーティングとクライアント識別のヘッダー名は捨てられる（カタログの項目と --add-dir の設定の項目にも同じフィルターが適用され、ユーザー設定・--settings のファイル・管理設定の項目には適用されない）

{
  "extraKnownMarketplaces": {
    "team-tools": {
      "source": {
        "source": "settings",
        "name": "team-tools",
        "plugins": [
          { "name": "code-formatter", "source": { "source": "github", "repo": "acme-corp/code-formatter" } }
        ]
      }
    }
  }
}

キーの別名#

v2.1.232 以降、extraKnownMarketplaces は additionalMarketplaces、strictKnownMarketplaces は allowedMarketplaces とも書けます。

• 古いバージョンは別名を無視する。新旧が混在する環境の管理設定ファイルなどでは、正式なキー名で書く
• 正式なキーを受け付けるファイルでは、別名は正式なキーと同じように読まれる
• 更新時に additionalMarketplaces が extraKnownMarketplaces に書き換えられることがある
• 1 つのファイルに両方あれば、正式なキーの値が使われ別名は無視される

MCP#

MCP サーバーの許可・拒否・承認の設定です。サーバーの追加と使い方は MCP サーバーをつなぐ を見てください。

エージェント・セッション・worktree#

メインスレッドのエージェント、セッション間メッセージ、git worktree の設定です。関連：サブエージェント、エージェントビュー、worktree で並行作業、エージェントチーム、セッション間のメッセージ。

リモート・デスクトップ・通知#

Remote Control・デスクトップアプリ・通知まわりの設定です。関連：リモートコントロールとモバイル、デスクトップアプリ、アーティファクト、ディープリンク。

認証とプロバイダー#

ログイン方法・認証情報の生成・利用できるプロバイダーの制限です。関連：インストールとログイン、Bedrock・Vertex AI・Foundry、ネットワークと LLM ゲートウェイ。

allowedProviders の値の意味は次のとおりです。

管理 env でピン留めが要るエンドポイント#

ピン留め（pin）とは、管理設定の env に書いたエンドポイント変数の値です。セッションがプロバイダーのトラフィックを、そのプロバイダー自身のサービス以外へ送るとき、Claude Code はセッションの値がピンと同じ場合だけ通します。

• "customEndpoint" のセッション：ホストを指す変数（ANTHROPIC_BASE_URL や、ANTHROPIC_BEDROCK_BASE_URL のようなプロバイダーのエンドポイントの変数）
• Amazon Bedrock：Bedrock 自身のサービスの外を指す AWS SDK の AWS_ENDPOINT_URL・AWS_ENDPOINT_URL_BEDROCK・AWS_ENDPOINT_URL_BEDROCK_RUNTIME（セッションは "customEndpoint" でなく "bedrock" のまま）
• ゲートウェイのサインインの URL：セッションは "gateway" のままで、forceLoginGatewayUrl もピンとして数えられる
• マシンの管理元がリストを設定しているときは、そのマシンの管理元の env ブロックだけがピンになる。サーバー管理設定だけがリストを設定しているときは、そのサーバー管理設定の env の値もピンになる
• リストは、クラウドプロバイダーの資格情報とテナントの変数、ネットワーク経路（HTTPS_PROXY・証明書設定）を審査しない。それらは管理 env で全台に設定する

更新とバージョン#

自動更新のチャネルと、許可するバージョンの範囲です。

ツール#

デスクトップアプリのツールまわりの制限です。

プライバシーとテレメトリ#

トランスクリプトの保持・フィードバック・アンケート・通信の事前確認の設定です。関連：セキュリティとデータの扱い、利用状況の計測。

組織管理#

管理設定そのものの動きを決めるキーです。配り方と全体像は 組織への導入と管理設定 を見てください。

managedSourcesBehavior が "merge" のときの合成規則#

"merge" は、下位のソースの項目（permissions.allow など）をポリシーへ加えるので、最優先より下のすべてが管理者の管理下にあるときだけ使います。

• policyHelper：ポリシーキーを持つ最優先のソースが MDM ポリシーか管理設定ファイルのときだけ有効（サーバー管理設定では適用されない）
• modelOverrides：availableModels と対になる。設定した最優先のソースから取るが、より上位が modelOverrides なしで availableModels を設定していれば、全ソースの modelOverrides を無視する
• forceLoginGatewayUrl・gatewayInternalNetworks・forceLoginMethod の "gateway"：サーバー管理設定からは読まれない（そこでの値は適用もされず、MDM や管理設定ファイルの値を隠しもしない）。マシン上の管理元のうち、ポリシーキーを持つ最上位だけが供給する
• allowedProviders：表の規則の後も、マシン自身のリストが結果を制限する
• どのソースが合成されたかは、/status の Setting sources 行で確認できる

policyHelper の出力と失敗#

• ヘルパーは引数なしで実行され、環境に CLAUDE_CODE_VERSION が入り、標準出力の JSON エンベロープ（上限 1 MiB）を読む
• 設定は managedSettings キーの下に置く。managedSettings のない素の設定オブジェクトは何も適用されず、エラーも出ない
• ヘルパーが managedSettings を出すと、それがその実行の唯一の管理設定のソースになる（MDM・ファイル・HKCU のソースは無視され、親の設定とはマージされない）。managedSettings を省いたエンベロープで 0 終了したヘルパーは、管理設定に寄与せず、ほかのソースが通常どおり適用される
• 起動時の forceRemoteSettingsRefresh の検査は、ヘルパーより前に走り、どの管理元も読む

{
  "managedSettings": {
    "permissions": { "deny": ["Read(//etc/secrets/**)"] }
  }
}

ヘルパーの実行は、次のときに失敗します。

• path が policyHelper.path の規則を破っている、path に通常のファイルが無い（同じ timeoutMs の中で確認される）
• ヘルパーが非ゼロで終了する・timeoutMs が過ぎても実行中・起動しない（実行権限がないなど）
• 標準出力か標準エラーに 1 MiB を超えて書く
• 標準出力が単一の JSON オブジェクトでない、または managedSettings に Claude Code が直せないスキーマ違反がある

起動時の実行が失敗すると、理由を出して起動を拒否します（対話・claude -p・Agent SDK・バックグラウンドセッションと、ほとんどのサブコマンドが対象）。非ゼロ終了なら理由にヘルパーの標準エラー（空なら標準出力）が含まれ、タイムアウトなら timeoutMs の上限を示して出力は含まれません。障害への耐性が要るヘルパーは、自前でキャッシュから返して 0 で終了します。バックグラウンドの更新が失敗すると最後に成功したポリシーが保たれ、/status が失敗理由を表示します。--debug では全実行のヘルパーの標準エラーがデバッグログに出ます。policyHelper の値が無効（パスだけの文字列・最小値未満の timeoutMs）だと、その項目を捨ててヘルパーを実行せずに残りの管理設定で起動します。ヘルパーをオフにするには、設定しているソースからキーを消します。

グローバル設定#

settings.json でなく ~/.claude.json に置くキーです。ほとんどは /config から切り替えると書かれます。

関連ページ#

• 設定ファイルの仕組み：ファイルの置き場所・優先順位・設定例
• 権限ルール：permissions.allow・ask・deny の書き方
• サンドボックス：sandbox.* の仕組み
• 環境変数一覧：env に書ける変数
• 設定のデバッグ：設定が効かないとき