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

すべての開発者のマシンにマネージド設定をデプロイします。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 行にそれが記載されています:

• 配信制御: policyHelper、wslInheritsWindowsSettings、managedSourcesBehavior
• ゲートウェイログインキー: forceLoginGatewayUrl、gatewayInternalNetworks、forceLoginMethod の "gateway" 値

管理設定ファイルや MDM プロファイルでは、それが届くすべてのユーザーに 1 つのポリシーが適用されます。特定の開発者グループに異なるポリシーを適用するには、そのグループに別のファイルまたはプロファイルをデプロイします。Enterprise プランでは、サーバー管理設定でグループごとに独自の設定を指定することもできます。セルフホストの Claude apps gateway は IdP グループごとに管理設定を配信します。

複数のメカニズムが同じマシンにポリシーを配信する場合、Claude Code はデフォルトで 1 つを使用し、他は無視します。Claude Code が管理ソースを組み合わせる方法では、その順序と、すべてのソースを適用するオプトインについて説明しています。

MDM とファイルの行は、まとめてエンドポイント管理設定と呼ばれます。これは、Claude Code がポリシーを取得するサーバー管理の行とは異なり、ポリシーが開発者のデバイスに保存されるためです。

以下の表を参考に、すでに行っているデバイス管理の方法に応じてメカニズムを選択してください。

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

組織に HIPAA 設定が適用されている場合は、サンドボックス化、ネットワーク許可リスト、認証情報の保護、ローカルデータ保持を含むより充実した managed-settings.json について、設定サンプルリポジトリの settings-hipaa.json と README-hipaa.md を参照してください。

これらのいずれかと併せて managed-mcp.json を通じてデプロイする、または managedMcpServers キーを通じて提供する管理 MCP サーバーについては、管理 MCP 設定を参照してください。

ポリシーが適用される場所とタイミング

デプロイされたポリシーは、次のように開発者のセッションに反映されます:

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

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

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

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

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

  セッションがどこで実行されても、claude.ai 上の git リポジトリから、または Cowork の Customize から誰かがマーケットプレイスを追加すると、claude.ai は管理コンソールの strictKnownMarketplaces と blockedMarketplaces のリストを自ら適用します。そのチェックについては制限の仕組みで説明しています。サーフェスの対応範囲の表では、Cowork と他のサーフェスを比較しています。

• 実行中のセッション: ほとんどの変更は、配信メカニズムの表のスケジュールに従い、再起動なしで実行中のセッションに反映されます。

  • forceRemoteSettingsRefresh、requiredMinimumVersion、および一部のユーザーが編集可能なキーへの変更は、次回のセッション開始時に有効になります。
  • 新規または変更された policyHelper エントリは、次回の起動時に有効になります。その起動時にサーバー管理設定がヘルパーを覆い隠している場合、取得によってそれらの設定の削除が報告されるとすぐにヘルパーが実行されます。

• 承認が必要な変更: 次回の起動まで待機する更新を除き、フックや 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 を読み取りません。

  これらのファイルはいずれもシンボリックリンクとしてデプロイでき、Claude Code はリンク先のファイルを読み取ります。リンク先がシステムディレクトリの外にある場合や、リンク先がシステムディレクトリ内にとどまっていることを Claude Code が確認できない場合でも、ポリシーは引き続き適用されます。その場合は、そのファイル名を示す警告が /status と claude doctor に表示されます。警告を解消するには、リンクがシステムディレクトリ内のターゲットを指すようにしてください。

• Windows HKCU レジストリ: HKCU\SOFTWARE\Policies\ClaudeCode の下にある同じ Settings 値。

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

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

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 つのソースのいずれかです。HKCU レジストリはユーザーが書き込み可能であり、管理ソースには含まれません。

Claude Code は、優先度の高い順に次の順序でソースを確認します。

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

次の図は、この順位付けと、どちらの設定でも Claude Code が最初の 3 つのソースから読み取るソース横断キーの例を示しています。

管理ドキュメントが存在するとみなされる場合

管理ソースの順位付けにおいて、Claude Code は、存在する管理ドキュメントの下位にあるユーザー書き込み可能な HKCU レジストリを適用することはありません。ドキュメントは次の場合に存在するとみなされます。

• いずれかのポリシーキーを null 以外の値に設定している場合。Claude Code が読み取れない値であっても該当します
• 存在するものの読み取れない HKLM の値、管理設定ファイル、または managed-settings.d ディレクトリである場合

WSL では /etc/claude-code もユーザーが書き込み可能です。Windows のドキュメントがそれより上位になる条件については、wslInheritsWindowsSettings の項目を参照してください。

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

デフォルトの "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 リストは、それを設定している最上位の管理ソースから取得されます。サーバー管理のリストは、下位のソースのリストと組み合わされるのではなく、それを置き換えます。

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

  ロックがない場合、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 でもオフになります
  • useAutoModeDuringPlan については、開発者が --setting-sources などのオプションで除外したユーザーファイルまたはローカルファイルの false はカウントされません。除外されたファイルを無視するには Claude Code v2.1.314 以降が必要です

• 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 ブロック全体のみを適用していました

allowedProviders には独自のルールがあります。その項目のスコープに関する注記で、マシンで設定されたリストがサーバー管理のリストとどのように組み合わされるかを説明しています。Claude Code v2.1.285 以降が必要です。

管理ソースが allowManagedMcpServersOnly または allowedMcpServers リストを設定しているものの、その値が有効になっていない場合、/status と claude doctor はそのソースとキーを表示します。

どの管理ソースがログインキーを提供するか

MDM ポリシーまたは管理設定ファイルがあるマシンでは、リモート設定でも設定されているキーであっても、Claude Code はログインキーをそのポリシーまたはファイルから取得します。claude.ai の管理コンソールからの設定はリモート設定であるため、forceLoginOrgUUID などのログインキーは MDM ポリシーまたはファイルで設定してください。

マシンに MDM ポリシーと管理設定ファイルの両方がある場合は、MDM ポリシーを使用してください。そのポリシーがいずれかのポリシーキーを設定している場合、Claude Code は、managedSourcesBehavior: "merge" の下でも、ファイル内のログインキーを無視します。

ログインキーは次のとおりです。

• "claudeai" または "console" に設定された forceLoginOrgUUID と forceLoginMethod：ポリシーまたはファイルでいずれかのキーが省略されている場合は、リモート設定の値が適用されます。すべてのクライアントが v2.1.299 以降を実行するまでは、claude.ai のサーバー管理設定でもこれらのキーを設定してください
• ゲートウェイのログインキー：Claude Code は、ゲートウェイへのサインインにリモート設定の値を使用しません

すべての管理ソースを組み合わせる

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

"merge" では、Claude Code は permissions.allow ルールやフックなど、下位のソースのリストエントリをポリシーに追加します。そのため、最上位のソースより下位にあるすべてのソースが管理者の管理下にある場合にのみ、これをオンにしてください。

次の表は、"merge" で Claude Code が各種類のキーをどのように組み合わせるかを示しています。managedSourcesBehavior の項目では、制限用の許可リスト、値全体を取得するもの、最上位のソースからのみ読み取られるキーの 3 つの行について、すべてのキーを挙げています。

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

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

policyHelper は、MDM ポリシーまたは管理設定ファイルで指定する実行ファイルで、Claude Code は起動時にこれを実行して管理設定を算出します。選択したソースがヘルパーを構成しており、そのヘルパーが managedSettings オブジェクトを出力すると、その出力によって Claude Code が読み取る内容が変わります。

• 出力された managedSettings オブジェクトが、そのセッションの唯一の管理設定になります。これは、通常はすべての管理ソースから読み取るキーにも当てはまります。ただし、独自の起動時ルールを持つ forceRemoteSettingsRefresh は除きます

どのようなヘルパーの実行が失敗とみなされるか、また失敗した場合に 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 の値を強制し、親が提供する値をブロックします。複数の管理ソースを配信する場合は、どのソースが forceLoginOrgUUID を提供するかを参照してください。

  Claude Code v2.1.273 以降では、allowManagedMcpServersOnly がオンの間、ソース横断キーとして、それを設定している最上位の管理ソースの allowedMcpServers リストが適用され、親のリストはブロックされます。親のリストが適用されるのは、どの管理ソースもリストを設定していない場合のみです。"merge" でどのソースが各キーを提供するかについては、managedSourcesBehavior の項目を参照してください。v2.1.223 より前は、いずれかの管理ソースにある値が親の値をブロックしていました

• availableModels については、Claude Code は適用する管理設定にある値を強制し、親が提供するリストをブロックします

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

• allowedProviders については、選択された管理ソースにあるリストが親の提供するリストをブロックし、managedSourcesBehavior の "merge" オプトインでは、いずれかの管理ソースにあるリストがブロックします。Claude Code v2.1.285 以降が必要です

• 親が提供する 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/**)"
    ]
  }
}

ポリシーをデプロイすると、新しい Cowork セッションで Claude はそのフォルダ配下にファイルを保存できるようになります。絶対パス用の // 形式を含むパス構文については、Read および Edit ルールを参照してください。

開発者が変更できること

開発者自身の設定ファイル、--settings の値、プロジェクトファイルが管理された値を上書きすることはありません。例外は、より厳しい下位レベルの値を有効にするものに限られます。次のケースはこのルールの対象外です。

• セッションのモデル：管理された model はデフォルトであり、ロックではありません。--model と ANTHROPIC_MODEL で引き続きそのセッションのモデルを選択できるため、選択肢を制限するには availableModels をデプロイしてください。
• セッションの自動圧縮ウィンドウ：管理された autoCompactWindow もデフォルトです。--autocompact フラグと CLAUDE_CODE_AUTO_COMPACT_WINDOW 変数で、引き続きそのセッションの自動圧縮ウィンドウを設定できます。
• ローカルの管理者権限：マシンの管理者である開発者は管理ソース自体を編集できます。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/ ディレクトリ、MDM プロファイル、または HKLM レジストリ値が存在するが読み取ることができず、管理者ソースがポリシーを提供しない場合、何が起こるかは読み取りが失敗した理由によって異なります。

• オペレーティング システムが読み取りを拒否した場合（root のみが読み取れるファイルなど）、すべてのセッションはそのソースのポリシーなしで起動します。/status と claude doctor は失敗を記録し、-p を使用した実行では stderr にも出力されます。
• I/O エラーなど、その他の読み取り失敗の場合、すべてのセッションは起動時に管理者に連絡するよう求めるメッセージを表示して終了します。

ドロップされたエントリを見つけるには、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 以降が必要です。

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

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 列に、それがマネージドのみかどうかが記載されています。

[!NOTE]

Team および Enterprise プランでは、Owner が Claude Code 管理設定で組織全体の Remote Control とクラウドセッションを有効または無効にします。Owner が Remote Control をオフにすると、Claude Code v2.1.286 以降を実行している接続済みのセッションも切断されます。各セッションは、次に組織のポリシーを更新したとき（約 1 時間に 1 回）に切断されます。それらのセッションで何が起こるかについては、Remote Control was turned off by your organization's policy を参照してください。

Remote Control は disableRemoteControl 設定でデバイスごとに無効にすることもできます。クラウドセッションにはデバイスごとの管理設定キーはありません。

これらの組織設定が特定のマシンに到達したかどうかを確認するには、そこで claude doctor を実行し、Organization policy 行を読みます。この行は Claude Code がポリシーをどこから読み込んだか、または読み込まなかった理由を示します。Claude Code v2.1.261 以降が必要です。実行中のセッションでは、ポリシーが読み込まれなかった場合、/status は同じ行を表示します。

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

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 をゲートウェイを通じてルーティングする場合、プロキシとゲートウェイを構成する はこれらのセッションがこの変数を必要とする理由を示しています。

関連項目

• 組織向けに Claude Code をセットアップする: 強制する内容と方法を決定します
• サーバーマネージド設定: claude.ai コンソールまたはゲートウェイからポリシーを配信します
• マネージド MCP 構成: 開発者が使用できる MCP サーバーを制御します
• すべての設定: すべてのキー。マネージドソースがそれを設定できるかどうか
• 設定ファイルの例: マネージドキーの形状を示す完全な managed-settings.json