SpyBara
Go Premium

managed-settings.md 2026-09-28 22:59 UTC to 2026-09-29 21:02 UTC

This page contains 96 additions and 60 deletions.

2026
Sat 12 03:02 Mon 14 22:58 Fri 18 23:58 Tue 22 23:59 Thu 24 22:57 Fri 25 23:58 Mon 28 22:59 Tue 29 21:02

マネージド設定をデプロイする

すべての開発者のマシンにマネージド設定をデプロイします。OS ごとの配信メカニズム、Claude Code がマネージドソースを組み合わせる方法、および強制の検証方法について説明します。

マネージド設定は、組織がすべての開発者のマシンにデプロイする設定です。Claude Code はこれらを他のすべてのレベルの上に適用するため、ユーザー、プロジェクト、ローカル、または --settings の値は、いくつかの セキュリティに関連する例外 を除いて、これらをオーバーライドできません。これらの例外では、下位レベルからのより厳密な値がカウントされます。

このページは、マネージド設定をデプロイするか、設定が適用されない理由をデバッグする管理者向けです。強制する内容を決定するには、強制する内容を決定する テーブルから始めてください。claude.ai コンソールパスについては、サーバーマネージド設定 を参照してください。開発者自身の値がどのファイルに入るかについては、設定 を参照してください。

マネージド設定ファイルをデプロイする

これは各マシンにポリシーを配置する最速の方法です。managed-settings.json ファイルです。マネージド設定の配信方法をまだ選択していない場合、またはデバイスが MDM 下にあるか開発者がクラウドセッションを実行している場合は、最初に 配信メカニズムを選択する を読んでください。

1

managed-settings.json を作成する

強制することを決定したキーを保持する managed-settings.json を作成します。これは settings.json と同じ JSON 形式です。強制する内容を決定する テーブルは各コントロールの背後にあるキーをリストしており、設定リファレンス の各エントリは、マネージドソースがそれを設定できるかどうかを示しています。このファイルは 2 つのファイル読み取りをブロックし、バイパスモードをオフにし、Claude Code がユーザー、プロジェクト、ローカルファイルおよび --allowedTools からの権限ルールを無視するようにします。

{
"permissions": {
"deny": [
"Read(./.env)",
"Read(./secrets/**)"
],
"disableBypassPermissionsMode": "disable"
},
"allowManagedPermissionRulesOnly": true
}

ログイン方法、モデル、MCP サーバー、マーケットプレイスを含むより多くのマネージドキーの形状を示すより完全な例については、組織のマネージド設定 を参照してください。

2

ファイルを各マシンに配置する

ファイルを managed-settings.json として、オペレーティングシステムのシステムディレクトリに保存します。フリート上のファイルを配置するために既に使用しているツールを使用します。

  • macOS: /Library/Application Support/ClaudeCode/managed-settings.json
  • Linux と WSL: /etc/claude-code/managed-settings.json
  • Windows: C:\Program Files\ClaudeCode\managed-settings.json
3

ポリシーが適用されたことを確認する

1 つのマシンで、Claude Code 内で /status を実行します。Setting sources 行は Enterprise managed settings (file) を表示します。その後、フリートの残りにロールアウトします。ポリシーが有効であることを確認する は、行が見つからない場合に何を確認するかについて説明しています。

配信メカニズムを選択する

上記のステップのファイルは、マネージド設定をマシンに取得する 4 つの方法の 1 つです。すべてのメカニズムは settings.json ファイルと同じポリシーキーを持つため、設定リファレンス はすべてに適用されます。いくつかのキーは特定のソースに関連付けられており、各エントリの Scope 行はどれかを示しています。

マネージド設定ファイル、MDM プロファイル、または claude.ai コンソールは、それが到達するすべてのユーザーに 1 つのポリシーを適用します。開発者の 1 つのグループに異なるポリシーを提供するには、異なるファイルまたはプロファイルをそのグループにデプロイします。claude.ai コンソール はまだグループをターゲットにできません。一方、自己ホスト型の Claude apps gateway は IdP グループごとにマネージド設定を配信します。

複数のメカニズムが同じマシンにポリシーを配信する場合、Claude Code はデフォルトで 1 つを使用し、他を無視します。Claude Code がマネージドソースを組み合わせる方法 は順序と適用される opt-in を示しています。

MDM とファイル行は一緒に endpoint-managed settings と呼ばれます。ポリシーが開発者のデバイスに保存されているためです。これは server-managed 行とは対照的です。Claude Code はそれをフェッチします。

下記のテーブルを使用して、デバイスを既に管理している方法に基づいてメカニズムを選択してください。

メカニズム 配信方法 Claude Code がそれを読む時期 使用する場合
サーバーマネージド設定 claude.ai 管理コンソール内、または自己ホスト型 Claude apps gateway 上 スタートアップ時にフェッチされ、1 時間ごとにポーリングされます。ポリシーが適用される場所と時期 を参照してください 各マシンに触れずに claude.ai 組織のポリシーを変更する 1 つの場所が必要な場合
MDM または OS レベルのポリシー macOS 構成プロファイルまたは Windows HKLM レジストリ値として、Jamf、Intune、グループポリシー、または同様のツール経由。各メカニズムがポリシーを保存する場所 を参照してください スタートアップ時に読み取られ、30 分ごとに変更がチェックされます MDM またはグループポリシーでデバイスを既に管理している場合
ファイルベース 各マシンのシステムディレクトリ内の managed-settings.json として。各メカニズムがポリシーを保存する場所 を参照してください スタートアップ時に読み取られ、ファイルが変更されるとリロードされます MDM なしのマシン、Linux ホスト、または自分で構築するイメージ
HKCU レジストリ、Windows と WSL Windows HKCU レジストリ値として。各メカニズムがポリシーを保存する場所 を参照してください スタートアップ時に読み取られ、30 分ごとに変更がチェックされます。Claude Code はそれを使用するのは、他の管理ドキュメントが存在しない場合 のみで、ホスト提供の親設定 が制限的なキーを提供しない場合です マシンレベルの HKLM キーを書き込むことができない場合

Jamf、Iru、Intune、グループポリシーのスターターテンプレートは、MDM 例リポジトリ にあります。

managed-mcp.json を通じてデプロイするか、managedMcpServers キーを通じて提供するマネージド MCP サーバーについては、マネージド MCP 構成 を参照してください。

ポリシーが適用される場所と時期

デプロイされたポリシーは、開発者のセッションに次のように到達します。

  • サーフェス: 開発者のマシン上で、ターミナル、VS Code および JetBrains 拡張機能、デスクトップアプリの Code タブ、および Agent SDK セッションはこれらのソースをすべて読み取ります。Agent SDK セッションは、settingSources がユーザー、プロジェクト、ローカルファイルを除外する場合でも、マネージド設定をロードします。

  • クラウドセッション: Anthropic ホスト環境のセッションはデバイスの MDM プロファイルまたはファイルを読み取らないため、ポリシーはサーバーマネージド設定から来る必要があります。自己ホスト環境 のセッションは、デフォルトではサーバーマネージド設定がポリシーキーを配信しない場合のみ、ランナーイメージ内のマネージド設定ファイルを読み取ります。ただし、すべての管理ソースから Claude Code が読み取るキー は除きます。Claude Code がマネージドソースを組み合わせる方法 は両方を適用する opt-in について説明しています。

  • Claude Tag セッション: Claude Tag セッションはクラウド環境で実行されますが、サーバーマネージド設定を受け取りません。自己ホスト環境 では、ランナーイメージ内のマネージド設定ファイルを読み取ります。Claude Tag 自体は Claude Tag 管理設定 で構成します。

  • Cowork セッション: Claude Desktop アプリの Cowork は Claude Code 上でセッションを実行します。Cowork セッションでは、Claude Code は Team または Enterprise アカウントでユーザーがサインインしている場合でも、claude.ai 管理コンソールからサーバーマネージド設定をフェッチしません。したがって、どのポリシーが適用されるかはセッションが実行される場所によって異なります。

    • ユーザーのマシン上: デフォルトでは、Cowork セッションの Claude Code はそのデバイス上の MDM または OS レベルのポリシーおよびマネージド設定ファイルを読み取るため、ポリシーをそこにデプロイします。
    • 完全な VM サンドボックス内: Claude Desktop マネージド構成が requireCoworkFullVmSandbox を設定する場合、Claude Code は仮想マシン内で実行され、デバイスの MDM ポリシーおよびマネージド設定ファイルは存在しません。
    • リモート Cowork セッション: これらは Anthropic 管理 VM 上で実行され、Claude Code はデバイスポリシーを読み取ることができません。

    セッションが実行される場所に関係なく、claude.ai は管理コンソールの strictKnownMarketplaces および blockedMarketplaces リストを、誰かが claude.ai 上の git リポジトリからマーケットプレイスを追加するか、Cowork タブの Customize から追加する場合に自動的に適用します。制限がどのように機能するか はそのチェックについて説明しています。サーフェスカバレッジ テーブルは Cowork と他のサーフェスを比較しています。

  • 実行中のセッション: ほとんどの変更は、配信メカニズムテーブル のスケジュールに従って、再起動なしで実行中のセッションに到達します。

  • 承認が必要な変更: 次の起動を待つ更新 とは別に、承認が必要な 設定（フックまたは env 変数など）へのサーバーマネージド変更は、開発者がインタラクティブセッションでダイアログを受け入れるのを待ち、IDE 拡張機能または Agent SDK がホストするセッションの現在の実行に適用されます。その他のサーバーマネージド変更は次のポーリングで適用されます。

  • 長時間実行セッション: 数週間開いたままのセッションはロールアウトに遅れることができます。requiredMinimumVersion は古いバイナリが開始されるのをブロックし、既に実行中のセッションを終了しません。

各メカニズムがポリシーを保存する場所

キーはどこでも同じですが、各メカニズムはそれらを異なる場所と形状に保存します。

  • サーバーマネージド: Anthropic のサーバーまたはゲートウェイがポリシーを保持します。Claude Code はローカルキャッシュを保持し、スタートアップ時に適用し、各成功したフェッチで置き換えます。
  • macOS 構成プロファイル: com.anthropic.claudecode マネージド設定ドメイン。managed-settings.json と同じトップレベルキーを使用し、ネストされた設定は辞書として、リストは plist 配列として使用します。
  • Windows HKLM レジストリ: HKLM\SOFTWARE\Policies\ClaudeCode の下の Settings という名前の REG_SZ または REG_EXPAND_SZ 値として JSON。
  • ファイルベース: managed-settings.json、オプションの managed-settings.d/ ディレクトリ、および managed-mcp.json をシステムディレクトリに配置します。macOS では /Library/Application Support/ClaudeCode/、Linux と WSL では /etc/claude-code/、Windows では C:\Program Files\ClaudeCode\。Claude Code はレガシー Windows パス C:\ProgramData\ClaudeCode\managed-settings.json を読み取りません。
  • Windows HKCU レジストリ: HKCU\SOFTWARE\Policies\ClaudeCode の下の同じ Settings 値。

ファイルベースのポリシーをチーム間で分割する

複数のチームが 1 つのポリシーの一部を所有している場合、各部分を managed-settings.d/ 内の独自のファイルに配置します。同じシステムディレクトリ内の managed-settings.json の隣に配置し、1 つの共有ファイルを編集する代わりに使用します。

Claude Code は managed-settings.json を最初にマージし、次にディレクトリ内のすべての *.json ファイルをアルファベット順にマージします。ファイルに数値プレフィックスを付けて順序を制御します。例えば 10-telemetry.json と 20-security.json。Claude Code は隠しファイルと .json で終わらないファイルを無視します。

2 つのファイルが同じキーを設定する場合、Claude Code はこれらのルールで組み合わせます。

  • 単一値（"model": "opus" または "cleanupPeriodDays": 7 など）: 後のファイルの値が前のファイルを置き換えます
  • リスト（permissions.deny または sandbox.network.allowedDomains など）: 2 つのリストが組み合わされ、重複が削除されます
  • ネストされたブロック（env または sandbox など）: 2 つのブロックはキーごとにマージされ、内部の各キーはこれらの同じルールに従います
  • fallbackModel: 後のチェーンが前のチェーン全体を置き換えます
  • extraKnownMarketplaces および managedMcpServers: 同じ名前の後のエントリが前のエントリ全体を置き換えます
  • modelPicker: 後のラインアップが前のラインアップ全体を置き換えます

Claude Code が管理されたソースを組み合わせる方法

組織が同じマシンに複数の管理されたソースを配信する場合、managedSourcesBehavior キーは Claude Code が他のソースに対して何を行うかを決定します。

  • "first-wins"、デフォルト: Claude Code は、少なくとも 1 つのポリシーキーを配信する最も高いランクのソースを使用し、すべての管理者ソースから読み取られるキー内のキーを除いて、残りを無視します。Claude Code はスキップするソースについて警告を表示しません。/status は使用したソースとスキップしたソースに名前を付けます。
  • "merge": Claude Code はポリシーキーを配信するすべての管理者ソースを適用し、キーの種類ごとに組み合わせます。ほとんどのキーでは高いランクのソースの値が適用され、リストは和集合、ロックは最も厳しい値を取ります。すべての管理されたソースを構成するでは、キーを設定する場所と各種類のキーがどのように組み合わされるかを説明しています。Claude Code v2.1.242 以降が必要です。

両方の設定は同じ方法でソースをランク付けします。これらの用語はこのセクション全体で繰り返されます。

  • ポリシーキー: 2 つの制御キー（wslInheritsWindowsSettings と managedSourcesBehavior）以外のすべての設定キー。これらのキーのみを含む管理設定ファイルまたは MDM ポリシーはカウントされず、Claude Code は次のソースに移動します。
  • 管理者ソース: 以下の最初の 3 つのソースの 1 つ。HKCU レジストリはユーザーが書き込み可能であり、1 つではありません。

Claude Code は、最初に最優先度の順でソースをチェックします。

  1. リモート設定。claude.ai からサーバー管理設定として、またはClaude アプリゲートウェイによって配信されます。Claude Code は、セッションが適格なログインまたはキーで Anthropic の API に直接認証するか、/login でゲートウェイにサインインする場合にのみこのソースをフェッチします。他のプロバイダー、または ANTHROPIC_BASE_URL が Anthropic の API 以外を指す場合、次のソースから開始します。
  2. MDM または OS レベルのポリシー: macOS plist または HKLM レジストリキー
  3. 管理設定ファイル、managed-settings.d/*.json と managed-settings.json をマージしたもの
  4. Windows 上の HKCU レジストリ、および WSL 上で HKLM レジストリまたは Windows 管理設定ファイルが wslInheritsWindowsSettings をオンにし、HKCU 値もそれを設定する場合。Claude Code はそれより上に管理者ドキュメントが存在せず、ホスト提供の親設定が制限的なキーを提供しない場合にのみ読み取ります。

Claude Code は、存在する管理者ドキュメントの下にあるユーザーが書き込み可能な HKCU レジストリを適用しません。ドキュメントは、ポリシーキーを null 以外の値に設定する場合に存在します。これは Claude Code が読み取ることができない値でも同様です。読み取ることができない HKLM 値、管理設定ファイル、または managed-settings.d ディレクトリも存在します。WSL では、/etc/claude-code もユーザーが書き込み可能であり、wslInheritsWindowsSettings エントリは Windows ドキュメントがそれより上に立つ場合を示します。

このダイアグラムはランク付けを示し、どちらの設定でも Claude Code が最初の 3 つのソースから読み取るクロスソースキーの例を示しています。

リモート設定から上部を通じて MDM、管理設定ファイル、および下部の HKCU レジストリにランク付けされた 4 つの管理設定ソースを示すダイアグラム。デフォルトではポリシーキーを持つ最初のソースがポリシーを提供し、残りはスキップされます。managedSourcesBehavior を merge に設定すると、ポリシーキーを持つすべての管理者ソースが寄与し、キーの種類ごとに組み合わされ、HKCU レジストリは除外されます。サイドパネルは、サンドボックスロック、forceRemoteSettingsRefresh、および変数ごとの env マージなどのクロスソースキーが、HKCU レジストリを除外するすべての管理者ソースから読み取られることを示しています。 リモート設定から上部を通じて MDM、管理設定ファイル、および下部の HKCU レジストリにランク付けされた 4 つの管理設定ソースを示すダイアグラム。デフォルトではポリシーキーを持つ最初のソースがポリシーを提供し、残りはスキップされます。managedSourcesBehavior を merge に設定すると、ポリシーキーを持つすべての管理者ソースが寄与し、キーの種類ごとに組み合わされ、HKCU レジストリは除外されます。サイドパネルは、サンドボックスロック、forceRemoteSettingsRefresh、および変数ごとの env マージなどのクロスソースキーが、HKCU レジストリを除外するすべての管理者ソースから読み取られることを示しています。

すべての管理者ソースから読み取られるキー

デフォルトの "first-wins" 設定では、Claude Code はほとんどのキーを選択したソースからのみ読み取り、選択したソースがそのキーを設定しないままにしている場合でも、低いランクのソースの値を無視します。

いくつかのキーは異なる動作をします。Claude Code はそれらをすべての管理者ソースから読み取るため、選択したソースが設定しない場合でも、低いランクの MDM ポリシーまたは管理設定ファイルがそれらを設定できます。Claude Code はユーザーが書き込み可能な HKCU レジストリをそのスキャンから除外します。HKCU が唯一のソースであり、ホストが親設定を提供しない場合、HKCU は選択されたソースのように適用されます。

クロスソースキーには以下が含まれます。

  • sandbox.network.allowManagedDomainsOnly と sandbox.filesystem.allowManagedReadPathsOnly: 任意の管理者ソースの true がロックをオンにします。ロックがオンの間、Claude Code はロックするアロウリスト（sandbox.network.allowedDomains と WebFetch(domain:...) アロー ルの組み合わせ、または sandbox.filesystem.allowRead）をすべての管理者ソースにまたがって和集合にします。ロックがない場合、Claude Code はアロウリストを他のキーのように扱うため、"first-wins" では選択されていない管理者ソースのアロウリストは無視されます。

  • allowAllClaudeAiMcps

  • allowManagedMcpServersOnly: 任意の管理者ソースの true が MCP アロウリストロックをオンにします。ロックがオンの間、管理された allowedMcpServers リストは、1 つを設定する最も高いランクの管理者ソースから取得されます。サーバー管理リストは、低いソースのリストと組み合わせるのではなく、置き換えます。

    管理者ソースがリストを設定しない場合、親設定がリストを提供しない限り、デニーリストを通過するすべてのサーバーが読み込まれます。

    ロックがない場合、Claude Code は適用する管理ソースから allowedMcpServers を読み取るため、"first-wins" では選択されていない管理者ソースのリストは無視されます。Claude Code v2.1.273 以降が必要です。

  • deniedMcpServers と disableClaudeAiConnectors: 任意の管理者ソースのエントリまたは true が適用されます。Claude Code v2.1.273 以降が必要です。

  • サンドボックスバイナリパス sandbox.bwrapPath と sandbox.socatPath

  • サンドボックス ripgrep バイナリ、sandbox.ripgrep

  • sandbox.filesystem.disabled と sandbox.network.strictAllowlist

  • useAutoModeDuringPlan、syncClaudeAiSkills、および syncClaudeAiPlugins。任意の管理者ソースの false が動作をオフにします。開発者のユーザーまたはローカル設定の false もそれをオフにします。各キーは拒否のみが可能です。

  • enableArtifact。任意の管理者ソースの false がArtifact ツールをオフにします。開発者のユーザー、プロジェクト、またはローカル設定の false もそれをオフにし、ソースはそれをオンに戻しません。どの下位レベルの値がまだカウントされるかを参照してください。Claude Code v2.1.242 以降が必要です。

  • maxEffortLevel。任意の管理者ソースの最も低いキャップが適用されます。開発者が自分の設定または --settings で低いキャップを設定する場合、Claude Code はそれを適用します。ソースはキャップを上げることはできません。Claude Code v2.1.267 以降が必要です。

  • attribution のコミットトレーラーオプトアウト、または非推奨の includeCoAuthoredBy から任意のティア

  • forceRemoteSettingsRefresh

  • env。管理者ソース全体で変数ごとにマージされます。各変数は、それを定義する最も高い優先度のソースから取得されるため、低いソースは高いソースが設定しないままにした変数を埋めます。いくつかの変数は独自のルールに従います。管理されたソース全体のキーごとの例外は各変数に名前を付けます。Claude Code v2.1.223 以降が必要です。v2.1.223 より前では、Claude Code は選択されたソースの全体 env ブロックのみを適用しました。

ゲートウェイログインキーは別のルールに従います。Claude Code はサーバー管理設定からそれらを読み取ることはないため、サーバー管理設定が選択されたソースである間、ポリシーキーを持つマシン上の最も高いランクの管理者ソースがそれらを提供します。それより下にランク付けされた管理者ソースの値、または HKCU レジストリの値は無視されます。

管理者ソースが allowManagedMcpServersOnly または allowedMcpServers リストを設定し、その値が実行中のものではない場合、/status と claude doctor はそのソースとキーに名前を付けます。

すべての管理されたソースを構成する

組織が配信するすべての管理者ソースを Claude Code に適用させるには、デプロイする最も高いランクのソースで managedSourcesBehavior を "merge" に設定します。Claude Code はキーまたはポリシーキーを持つ最も高いランクのソースからのみキーを読み取るため、低いソースはそれ自体をそれより上のソースとのマージにオプトインすることはできず、サーバー管理設定を受け取らないマシンは MDM プロファイルにもキーが必要です。ユーザーが書き込み可能な HKCU レジストリは別のソースとマージされることはありません。Claude Code v2.1.242 以降が必要です。

"merge" では、Claude Code は低いソースのリストエントリ（permissions.allow ルールやフック など）をポリシーに追加するため、最も高いランクより下にランク付けされたすべてのソースが管理者の制御下にある場合にのみオンにします。

この表は、"merge" の下で Claude Code が各種類のキーをどのように組み合わせるかを示しています。managedSourcesBehavior エントリは 3 つの行のすべてのキーに名前を付けます。制限アロウリスト、全体で取得される値、および最も高いランクのソースからのみ読み取られるキー。

キーの種類 Claude Code がそれを組み合わせる方法 例
リスト すべてのソースからのエントリを組み合わせます permissions.allow、hooks、sandbox.network.allowedDomains、deniedMcpServers、deniedModels
ロック 任意のソースが設定する最も厳しい値を適用します。より緩い値は最も高いランクのソースからのみ適用されます allowManagedHooksOnly、permissions.disableBypassPermissionsMode、crossSessionInbound、availableModelsMatch
制限アロウリスト それを設定する最も高いランクのソースから全体でリストを取得し、低いソースからエントリを追加しません availableModels、allowedMcpServers、strictKnownMarketplaces、allowedChannelPlugins、および fallbackModel チェーン
全体で取得される値 それを設定する最も高いランクのソースから全体で値を取得し、低いソースからエントリまたはフィールドを組み合わせません sandbox.credentials.awsPairs、sandbox.ripgrep
提供される MCP サーバー すべてのソースからサーバー名を組み合わせます。2 つのソースが同じ名前を設定する場合、最も高いランクのソースの全体エントリを適用します managedMcpServers
最も高いランクのソースからのみ読み取られるキー 最も高いランクのソースがそれを設定しないままにしている場合でも、すべての低いソースのキーを無視します apiKeyHelper などの認証情報ヘルパー、forceLoginOrgUUID などのログインピン、modelPicker、permissions.defaultMode
env 管理者ソース全体で変数ごとにマージされます。どちらの設定でも、すべての管理者ソースから読み取られるキーで説明されています
その他のすべてのキー それを設定する最も高いランクのソースから値を取得します model、cleanupPeriodDays

マシンで組み合わされたソースを確認するには、/status の Setting sources 行を読み取ります。そのセクションは各ラベルが何を意味するかを説明しています。

ヘルパープログラムでポリシーを計算する

policyHelper は MDM ポリシーまたは管理設定ファイルが名前を付ける実行可能ファイルであり、Claude Code はそれを実行して起動時に管理設定を計算します。選択されたソースが 1 つを構成し、ヘルパーが managedSettings オブジェクトを出力する場合、その出力は Claude Code が読み取る内容を変更します。

ヘルパー実行が失敗する場合、および 1 つが失敗する場合に Claude Code が何を行うかについては、ヘルパー失敗を参照してください。

埋め込みホストにポリシーを追加させる

別のアプリケーション（Claude Desktop、IDE 拡張機能、Agent SDK アプリなど）が Claude Code を起動する場合、そのホストは SDK managedSettings オプションを通じて独自の管理設定を渡すことができます。Claude Code はこれらを親設定と呼びます。

デフォルトでは、Claude Code は管理者ソースが存在する場合、親設定を無視します。サーバー管理設定、MDM または OS レベルのポリシー、または管理設定ファイル。

Claude Code が親設定を管理者ソースと並行してマージするようにするには、最も高い優先度の管理ソースで parentSettingsBehavior を "merge" に設定します。Claude Code はそのソースからのみキーを読み取ります。

Claude Code はホストの値のうち、Claude が実行できることを制限するものだけを保持します。知っておくべき 1 つのギャップがあります。allowManaged*Only ロックも設定しない限り、ホストの権限アロー ルとサンドボックスアロウリストはまだ適用されます。親設定を制限するでロックを参照してください。

policyHelper はこのキーに関係なく親マージをオフにすることができます。そのエントリは時期を示します。

Claude Code はまた、親が提供する値にこれらのチェックを適用します。

  • 任意の管理者ソースが allowManagedPermissionRulesOnly を設定する場合、Claude Code は親が提供する権限アロー ルと additionalDirectories をそれらを読み取るときにドロップします。高い優先度のソースがキーを設定しないままにしている場合でも。キーの効果は、Claude Code が適用する管理設定、または親設定がマージするように選択したものから来ます。

  • Claude Code は適用する管理設定の forceLoginOrgUUID または allowedMcpServers 値を強制し、親が提供するものをブロックします。MCP アロウリストロックの外では、Claude Code が適用しない低い管理者ソースの値は適用されず、ブロックもされません。

    Claude Code v2.1.273 以降では、allowManagedMcpServersOnly がオンの間、1 つを設定する最も高いランクの管理者ソースからの allowedMcpServers リストが適用され、親のものをブロックします。これはクロスソースキーです。親のリストは、管理者ソースがリストを設定しない場合にのみ適用されます。managedSourcesBehavior エントリは "merge" の下で各キーを提供するソースを示します。v2.1.223 より前では、任意の管理者ソースの値が親のものをブロックしました。

  • availableModels の場合、Claude Code は適用する管理設定の値を強制し、親が提供するリストをブロックします。

  • strictKnownMarketplaces の場合、Claude Code は同様に適用する管理設定のリストを強制し、親が提供するものをブロックします。親のリストは、適用された管理ソースがリストを設定しない場合にのみ適用されます。Claude Code v2.1.282 以降が必要です。

  • 親が提供する blockedMarketplaces は、管理ソースが設定するブロックリストに加えて適用されます。Claude Code v2.1.282 以降が必要です。

管理されたルールのみが適用される場合に Cowork フォルダアクセスを保持する

Claude Desktop アプリの Cowork はそのセッションを Claude Code で実行し、各セッションにそのワーキングフォルダ（ユーザーが接続するフォルダなど）へのアクセスを許可します。セッションを起動するときに提供するアロー ルを通じて。管理ポリシーが allowManagedPermissionRulesOnly を設定する場合、Claude Code は管理ポリシーのアロー ルのみを保持します。ホストが親設定として、--allowedTools として、または設定ファイルで提供するアロー ルをドロップするため、これらのフォルダへの書き込みは事前承認を失います。編集前に確認を求める Cowork セッションでは、Cowork はプロンプトを表示できず、Claude は各書き込みを保護された場所またはそれより上のパスの外のパスに解決されるため、ブロックされたと報告します。

書き込みを復元するには、Claude Code が選択するマシンの管理ソースにこれらのフォルダのアロー ルを追加します。MDM 管理フリートでは、それは別の管理設定ファイルではなく MDM ポリシーです。この例はファイル形式を使用し、MDM ポリシーは同じキーを取ります。allowManagedPermissionRulesOnly を設定したままにし、各ユーザーのホームディレクトリの CoworkProjects フォルダの下での編集を許可します。パスをユーザーが接続するフォルダに置き換えます。

{
  "allowManagedPermissionRulesOnly": true,
  "permissions": {
    "allow": [
      "Edit(~/CoworkProjects/**)"
    ]
  }
}

ポリシーをデプロイした後、Claude は新しい Cowork セッションでそのフォルダの下にファイルを保存できます。読み取りと編集ルールはパス構文（絶対パスの // 形式を含む）をカバーしています。

開発者が変更できるもの

開発者の独自の設定ファイル、--settings 値、およびプロジェクトファイルは管理値をオーバーライドしません。例外は、より厳しい下位レベルの値がカウントされることのみを許可します。これらのケースはそのルールの外にあります。

  • セッションのモデル: 管理された model はロックではなくデフォルトです。--model と ANTHROPIC_MODEL はそのセッションのモデルを選択できるため、availableModels をデプロイして選択を制限します。
  • ローカル管理者権限: マシンの管理者である開発者は、管理ソース自体を編集できます。これが MDM ツールがスケジュールでプロファイルまたはファイルを再デプロイできる理由であり、HKLM レジストリと macOS 管理設定ドメインが存在する理由です。
  • サーバー管理キャッシュ: サーバー管理設定は Anthropic のサーバーから取得され、ローカルキャッシュへの編集は次の成功したフェッチまでのみ続きます。
  • その他のツール: 管理設定は Claude Code のみをバインドします。別のツールから API を呼び出す開発者はそれらの下にはありません。

ポリシーが有効であることを確認する

開発者がポリシーが適用されていないと報告している場合、またはロールアウトがフリートへのプッシュ前に完了したことを確認したい場合があります。そのマシン上の 2 つのコマンドがこれに答えます。/status は Claude Code が選択した管理対象ソースを表示し、claude doctor はドロップしたものをリストします。

/status でソースを読む

開発者のマシンで Claude Code 内で /status を実行し、Setting sources 行を読みます。管理対象ソースが有効な場合、その行は Enterprise managed settings をリストし、括弧内に Claude Code が選択したソースを表示します。

  • (remote)：claude.ai またはゲートウェイからのサーバー管理設定
  • (plist) または (HKLM)：MDM または OS ポリシー
  • (file)、(drop-ins)、または (file + drop-ins)：managed-settings.json、ドロップイン ディレクトリ、またはその両方
  • (remote + file, merged) または別のリスト（, merged で終わる）：組織がすべての管理対象ソースを構成し、Claude Code がリストされたソースをポリシーにマージしました。下位のソースは、リストに表示されなくても env 変数を提供できます。Claude Code v2.1.242 以降が必要です
  • (HKCU)：ユーザー書き込み可能なレジストリ フォールバック
  • (parent process)：埋め込みホストが制限的な設定を提供しました
  • (helper)：選択した MDM またはファイル ソースによって構成された policyHelper

Claude Code がマシン上で管理対象ソースを見つけたが選択しなかった場合、2 番目の行 Skipped sources が各ソースを名前で示します。これを読んで、ポリシーがマシンに到達しなかった場合と、到達したが高優先度のソースがオーバーライドした場合を区別します。Claude Code v2.1.242 以降が必要です。

ポリシーが適用されていない場合、Setting sources 行は 2 つの問題のどちらがあるかを示します。

  • 行が見つかりません：Claude Code はポリシー キーを配信する管理対象ソースを見つけませんでした。

    管理対象設定ファイルをデプロイした場合、OS のパスに配置されていることを確認し、制御キーのみではなくポリシー キーが含まれていることを確認します。有効な JSON ではないファイルはこの状態を生成しません。Claude Code は代わりに起動を拒否します。

    代わりにサーバー管理設定を通じてデプロイした場合は、claude doctor を実行します。これはフェッチ結果を報告します。

  • 行が展開したソース以外のソースを名前で示す：高優先度のソースが存在し、Claude Code があなたのソースを無視しました。Skipped sources がそれをリストします。Claude Code が管理対象ソースを組み合わせる方法は順序を示します。

Claude Code がドロップしたエントリを見つける

管理対象設定ファイル、MDM プロファイル、レジストリ値、またはサーバー管理ペイロードがスキーマ検証に失敗した場合、Claude Code は最初に修復できる個別エントリ（無効なパーミッション ルールなど）をスキップし、各エントリに対して警告を表示します。Claude Code はその後、値がまだ失敗するものをドロップします。ただし、値が閉じた状態で失敗するキーのいずれかに属する場合は除きます。

Claude Code は policyHelper が出力する managedSettings に対してより厳密です。同じエントリ修復を行いますが、生き残るスキーマ違反は全体のヘルパー実行を失敗させ、起動時に Claude Code は起動を拒否します。これは非ゼロで終了するヘルパーと同じです。

管理対象設定ファイル、ドロップイン ファイル、MDM plist、または HKLM レジストリ値が存在するが JSON オブジェクトとして解析できない場合、Claude Code は起動を拒否し、別の管理者ソースが有効なポリシーを配信する場合でもソースを名前で示すエラーを出力します。各ソースは次の場合にこのように失敗します。

  • 管理対象設定ファイルまたはドロップイン ファイル：ファイルが有効な JSON ではない、またはその最上位がオブジェクトではない
  • MDM plist：macOS の plutil が plist が不正形式であると報告する、またはその変換されたコンテンツが JSON オブジェクトではない
  • HKLM レジストリ値：Settings 値が文字列ではない、空である、または JSON オブジェクトを保持していない

3 つのソース状態はこの拒否を引き起こしません。

  • 不在のファイル、プロファイル、またはレジストリ値は失敗ではありません。Claude Code はそのソースなしで実行されます。
  • 空の管理対象設定ファイルは {} としてカウントされます。
  • ユーザー書き込み可能な HKCU レジストリ キーの不正形式の値は起動をブロックしません。Claude Code は代わりに /status と claude doctor で通知として報告します。

管理対象設定ファイル、ドロップイン ファイル、または managed-settings.d/ ディレクトリを読み取ることができず、管理者ソースがポリシーを提供しない場合、claude.ai または Claude Console 認証情報でサインインしたセッションは管理者に連絡するメッセージで起動時に終了します。

ドロップされたエントリを見つけるには、3 つの場所のいずれかを確認します。

  • インタラクティブ セッションは起動時に無効なエントリをリストするダイアログを表示します。
  • -p を使用した非インタラクティブ実行は stderr に概要を出力します。
  • claude doctor は各無効なエントリをそのソースとフィールドでリストします。

閉じた状態で失敗するキー

管理対象ソースが allowManagedPermissionRulesOnly、disableAutoMode、または skipDangerousModePermissionPrompt などの単一の制限的な値を持つトップレベル キーを Claude Code が読み取ることができない値に設定した場合、キーはあなたがそれを修正するまでその値として読み取られます。レポートはキーが was present but invalid であったと言い、Claude Code が値として扱う値を名前で示します。sandbox 内のキーについては、sandbox 内の無効な値を参照してください。

これらのケースは閉じた状態で失敗しません。

  • null はキーを削除します。
  • 無効な disableAllHooks（引用符で囲まれたブール値でも）は警告とともにドロップされます。true を適用すると、独自の管理対象設定がデプロイするフックもアンロードされるためです。
  • ルールが対象とするすべての他のブール キーについて、文字列 "true" または "false" はそのブール値として読み取られ、/status に引用符を削除するよう求める通知が表示されます。

Claude Code は permissions、autoMode、worktree、および attribution ブロックをフィールドごとに修復します。全体をドロップするのではなく。

  • permissions.disableBypassPermissionsMode などのブロック内のロックはその制限的な値として読み取られます。
  • 無効な permissions.defaultMode は default として読み取られます。
  • permissions 内の deny または ask リストを全く読み取ることができない場合、Claude Code は allow と additionalDirectories を保留するため、制限が横に書かれていない限りグラントは適用されません。レポートは各保留されたグラントと読み取ることができなかったリストを名前で示します。
  • autoMode では、読み取ることができない soft_deny または hard_deny リスト、または無効なエントリを失った場合、allow と environment を同じ方法で保留します。

単一の制限的な値を持つキーの閉じた状態で失敗するルールとフィールドごとの修復には Claude Code v2.1.282 以降が必要です。

これらのキーは独自のフォールバックを持ちます。

フィールド 存在するが無効な場合の動作
allowedMcpServers ユーザーが追加する MCP サーバーが許可されないように、値が修正されるまで空のアローリストとして適用されます。組織が managedMcpServers を通じて配信するサーバーは引き続きロードされ、managed-mcp.json サーバーはサーバーの評価方法に従ってロードされます。個別の無効なエントリは削除され、有効なサブセットが適用されます。
allowedHttpHookUrls Claude Code は値を修正するまで空の管理アローリストを適用するため、HTTP フックは別の設定ファイルがその URL をリストしている場合にのみ実行されます。無効なエントリが 1 つだけの場合、Claude Code はそのエントリを削除し、残りを適用します。
httpHookAllowedEnvVars Claude Code は値を修正するまで空の管理アローリストを適用するため、ヘッダー変数は別の設定ファイルがそれを名前で示している場合にのみ補間されます。無効なエントリが 1 つだけの場合、Claude Code はそのエントリを削除し、残りを適用します。
allowedChannelPlugins 値を修正するまで空のアローリストとして適用されるため、--channels に渡されるチャネル プラグインは許可されません。無効なエントリが 1 つだけの場合、それを削除し、残りを適用します。
strictKnownMarketplaces 値が修正されるまで空のアローリストとして適用されるため、マーケットプレイス ソースは許可されません。無効なエントリ、または hostPattern 正規表現がコンパイルされないなど適用できないエントリは削除され、有効なサブセットが適用されます。
availableModels 修正されるまで空のアローリストとして適用されるため、デフォルト モデルのみが利用可能です。文字列以外のエントリは削除され、有効なサブセットが適用されます。
availableModelsMatch 値が修正されるまで exact として扱われます。
forceLoginOrgUUID 値が修正されるまで、組織がログインすることは許可されません。
gatewayInternalNetworks 無効な値が最も高い管理対象ソースから来ている場合、そのマシン上の /login は値が修正されるまで、すべての新しいクラウド ゲートウェイサインインを拒否します。
crossSessionInbound 最も制限的な値である refuse として扱われるため、値が修正されるまでクロスセッション メッセージのインバウンドは拒否されます。開発者は警告を見ます。
deniedMcpServers 個別の無効なエントリは削除され、有効なサブセットが適用されます。完全に無効な値は警告とともにドロップされます。すべてのサーバーを拒否するとポリシーが名前を付けなかったサーバーがブロックされるためです。
deniedModels 文字列以外のエントリは削除され、リストの残りが適用されます。完全に無効な値は警告とともにドロップされ、修正されるまでモデルはブロックされません。
blockedMarketplaces 個別の無効なエントリは削除され、有効なサブセットが適用されます。hostPattern 正規表現がコンパイルされないなど、解析されるが決してマッチしないエントリは警告とともに保持されます。修正されるまでは何もブロックしませんが、マーケットプレイス制限は有効なままです。完全に無効な値は警告とともにドロップされます。すべてのマーケットプレイスをブロックするとポリシーが名前を付けなかったソースがブロックされるためです。
sandbox ブロック内の 1 つの値が無効な場合、Claude Code はブロック全体をドロップしません。各種類の無効なフィールドに何が起こるかについては、sandbox 内の無効な値を参照してください。
sandbox.credentials 回復可能な無効なエントリは mode: "deny" に低下し、警告が表示されます。回復不可能なエントリは削除されます。有効なエントリは適用されたままです。管理対象設定の無効な認証情報エントリを参照してください。
strictPluginOnlyCustomization 値がブール値でも配列でもない場合、true として扱われ、4 つのサーフェスすべてをロックします。このバージョンがサーフェスとして認識しない配列エントリは何もロックしません。ステータス ノートはそのようなエントリをカウントするため、タイプミスをチェックできます。
enabledPlugins 無効なエントリは警告とともにドロップされ、他のエントリは適用されたままです。プラグイン ID のマップではない値、またはすべてのエントリが無効な値は、警告とともに全体としてドロップされます。

allowedHttpHookUrls と httpHookAllowedEnvVars は設定ファイル全体でマージされるため、管理対象リストが空の間、ユーザー、プロジェクト、またはローカル設定のエントリは引き続き適用されます。

これら 2 つのキーと allowedChannelPlugins のフォールバックには Claude Code v2.1.267 以降が必要です。以前のバージョンは、値またはエントリが無効な場合、キー全体をドロップします。strictKnownMarketplaces と blockedMarketplaces のフォールバックには Claude Code v2.1.277 以降が必要です。以前のバージョンは、値またはエントリが無効な場合、キー全体をドロップします。strictPluginOnlyCustomization と enabledPlugins のフォールバックには Claude Code v2.1.282 以降が必要です。

requiredMinimumVersion と requiredMaximumVersion は設計上オープンに失敗します。無効な値は適用されるのではなくドロップされます。

この許容度は管理対象設定にのみ適用されます。ユーザー、プロジェクト、およびローカル設定ファイルは厳密なままです。JSON またはトップレベルの形状が検証に失敗するファイルは全体として拒否され、報告されます。不正形式のパーミッション ルールなどの個別エントリが失敗する場合は、警告とともにスキップされ、ファイルの残りが適用されます。

`sandbox` 内の無効な値

管理対象 sandbox ブロック内の 1 つの値が無効な場合、Claude Code はブロック全体をドロップしません。各フィールドを独立して検証するためです。このフィールドごとの処理には Claude Code v2.1.283 以降が必要です。v2.1.283 より前のバージョンでは、credentials 以外の値が無効な場合、Claude Code は credentials を除くすべての sandbox フィールドをドロップします。

無効なフィールドに対して取得する警告は、フィールドを名前で示し、それに何が起こるかを示します。何が起こるかは、フィールドが何を制御するかによって異なります。

  • Boolean キーを引用符で囲まれた "true" または "false" に設定した場合、値はその Boolean としてカウントされます。警告の代わりに、/status は引用符を削除するよう求める通知を表示します。
  • failIfUnavailable が無効な場合、Claude Code は値をドロップするため、読み取り不可能な値はフリート全体でセッションの開始を停止しません。
  • Claude Code は他のすべての無効な Boolean を、値が修正されるまでサンドボックスを最も厳密に保つ値として扱います。enabled や network.allowManagedDomainsOnly など、サンドボックスまたはその制限の 1 つをオンにするキーは true としてカウントされます。allowUnsandboxedCommands など、それを緩和するキーは false としてカウントされます。
  • credentials 外のリスト（excludedCommands や network.allowedDomains など）では、Claude Code は無効なエントリをドロップし、リストの残りを保持します。配列ではないリスト、または有効なエントリがないリストは、まったく適用されません。
  • network.deniedDomains またはそのいずれかのエントリが無効な間、Claude Code は network.allowedDomains も保留するため、管理対象アローリストは拒否リストを修正するまで何も許可しません。
  • filesystem.denyRead、filesystem.denyWrite、またはそのいずれかのエントリが無効な間、Claude Code は filesystem.allowRead と filesystem.allowWrite の両方を保留するため、拒否リストを修正するまで何も許可しません。

マネージドソースのみが設定できるキー

Claude Code は次のキーをマネージドソースからのみ読み取ります。ユーザーまたはプロジェクト設定ファイルに配置しても効果がありません。

ほとんどはロックです。ロックが管理するキー（権限ルールまたは sandbox.network.allowedDomains など）は、任意のレベルが設定できる通常のキーであり、ロックは Claude Code にマネージド値のみを尊重するよう指示します。

テーブルは権限、プラグイン、配信コントロールをカバーしています。ここにリストされていないキーについては、設定リファレンス インデックスの Scope 列は、それがマネージドのみであるかどうかを示しています。残りのマネージドのみキーには、ゲートウェイログイン URL、バージョン、ブラウザ、モバイルシミュレーター、SSH ホスト、Desktop ローカルセッション、サンドボックスバイナリパス、モデル価格、モデル制限、CLAUDE.md コントロールが含まれます。

設定 説明
allowAllClaudeAiMcps Claude Code が自身でフェッチする claude.ai コネクタをデプロイされた managed-mcp.json と一緒にロードします。それらを抑制する代わりに
allowedChannelPlugins メッセージをプッシュできるチャネルプラグインの許可リスト。設定されている場合、デフォルト Anthropic 許可リストを置き換えます。channelsEnabled: true が必要です。実行できるチャネルプラグインを制限する を参照してください
allowManagedHooksOnly true の場合、実行するフックを制限します。allowManagedHooksOnly の下で実行するもの の完全な効果リストを参照してください
allowManagedMcpServersOnly true の場合、マネージド設定からの allowedMcpServers のみが尊重されます。deniedMcpServers はすべてのソースからマージされます。すべての管理ソースから読み取られるキー でどのマネージドソースがそれを設定できるかを参照し、マネージド MCP 構成 を参照してください
allowManagedPermissionRulesOnly マネージド設定を権限ルールの唯一の設定ソースにします。エントリは無視するすべてのソースをリストします
blockedMarketplaces マーケットプレイスソースのブロックリスト。ブロックされたソースはダウンロード前にチェックされるため、ファイルシステムに触れません。マネージドマーケットプレイス制限 を参照してください
channelsEnabled 組織の チャネル を許可します。各プランのデフォルトについては エンタープライズコントロール を参照してください
disableCommandPluginSources true の場合、command プラグインソース を完全にブロックするため、マーケットプレイス宣言コマンドは実行されません。マーケットプレイス headersHelper コマンド もブロックします。ただし、マネージド設定自体が宣言するマーケットプレイスは除きます。設定されていない場合、allowManagedHooksOnly に従います。Claude Code v2.1.229 以降が必要で、headersHelper ブロックは v2.1.238 以降が必要です
disableSideloadFlags スタートアップで --plugin-dir、--plugin-url、--agents、および --mcp-config フラグを拒否します。クラウドセッションでは、Claude Code はサーバーが --mcp-config を通じて配信した MCP サーバーをドロップします。ただし、プロセス内 type: "sdk" エントリは除き、セッションを開始します。Claude Code v2.1.193 以降が必要です
forceRemoteSettingsRefresh true の場合、リモートマネージド設定が新しくフェッチされるまで CLI スタートアップをブロックし、フェッチが失敗する場合は終了します。失敗閉じ強制 を参照してください
managedMcpServers すべてのユーザーに独自と一緒に提供されるリモート MCP サーバー。何かをロックするのではなく、サーバーを提供します。マネージド設定を通じてサーバーを提供する を参照してください。Claude Code v2.1.259 以降が必要です
managedSourcesBehavior Claude Code が最高優先度のマネージドソースのみを適用するか、それらすべてを構成する か
parentSettingsBehavior ホスト提供の親設定がマネージドポリシーの下でマージするかどうか
pluginSuggestionMarketplaces Claude Code がユーザーに提案できるプラグインのマーケットプレイス
pluginTrustMessage インストール前に表示されるプラグイン信頼警告に追加されるカスタムメッセージ
policyHelper スタートアップでマネージド設定を計算する実行可能ファイル。ポリシーヘルパーでマネージド設定を計算する を参照してください
sandbox.filesystem.allowManagedReadPathsOnly true の場合、マネージド設定からの filesystem.allowRead パスのみが尊重されます。denyRead はすべてのソースからマージされます
sandbox.network.allowManagedDomainsOnly マネージド allowedDomains および WebFetch(domain:...) 許可ルールのみを尊重します。プロンプトなしで他のドメインをブロックします
strictKnownMarketplaces ユーザーが追加してプラグインをインストールできるプラグインマーケットプレイスソースを制御します。マネージドマーケットプレイス制限 を参照してください
strictPluginOnlyCustomization ユーザーおよびプロジェクトソースからのスキル、エージェント、フック、MCP サーバーをブロックします。true はすべて 4 つをロックし、配列はどれかに名前を付けます
wslInheritsWindowsSettings HKLM レジストリまたは C:\Program Files\ClaudeCode の下のファイルに設定されている場合、WSL が Windows ポリシーチェーンを読み取り、Windows 管理ドキュメントが存在しない 場合のみ /etc/claude-code を読み取ります。エントリは順序を示しています

組織のテレメトリをオフにする

Claude Code は、Anthropic API を直接、LLM ゲートウェイを通じて、またはカスタム ANTHROPIC_BASE_URL を通じて使用するセッションで、デフォルトで Anthropic 運用 テレメトリ を送信します。API プロバイダーごとのデフォルト動作 はどのプロバイダーがそれを送信するかを示しています。すべての開発者が各人のシェルに依存することなく、マネージド設定の env ブロックを通じて DISABLE_TELEMETRY を配信することでオフにします。この例は、ポリシーが到達するすべてのユーザーに対して DISABLE_TELEMETRY を設定します。

{
  "env": {
    "DISABLE_TELEMETRY": "1"
  }
}

Claude Code は 1 の値を 承認ダイアログ を表示せずに適用します。

テレメトリをオフにする場合、Claude Code はポリシーが到達する開発者の組織の 分析ダッシュボード を供給する使用データの送信を停止します。変数は フィーチャーフラグフェッチが必要な機能 もオフにします。リモートコントロールについては、リモートコントロール要件 を参照してください。

ポリシーが適用される場所と時期 は各サーフェスに到達する配信メカニズムを示し、プラットフォーム可用性 はどのセッションがサーバーマネージド設定フェッチをスキップするかを示しています。

組織がカスタマー管理暗号化キーを使用し、Claude Code をゲートウェイを通じてルーティングする場合、プロキシとゲートウェイを構成する はこれらのセッションがこの変数を必要とする理由を示しています。

関連項目