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

​

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

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

​

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

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

​

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

• サーフェス: 開発者のマシン上では、ターミナル、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 を読み取りません。
• Windows HKCU レジストリ: HKCU\SOFTWARE\Policies\ClaudeCode の下にある同じ Settings 値。

​

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

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

​

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 つではありません。

1. リモート設定。claude.ai からサーバー管理設定として、またはClaude アプリゲートウェイによって配信されます。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. Windows 上の HKCU レジストリ、および WSL 上で HKLM レジストリまたは Windows 管理設定ファイルが wslInheritsWindowsSettings をオンにし、HKCU 値もそれを設定している場合の HKCU レジストリ。Claude Code は、それより上に管理者ドキュメントが存在せず、ホスト提供の親設定が制限的なキーを提供しない場合にのみこれを読み取ります

​

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

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

​

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

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

​

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

​

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

• 出力された managedSettings オブジェクトはセッションの唯一の管理設定です。これはそれが他の方法で読み取るすべての管理者ソースからのキーを含みます。ただし、forceRemoteSettingsRefresh は独自の起動ルールを持っています。

​

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

• 任意の管理者ソースが 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 以降が必要です。
• allowedProviders の場合、選択された管理ソースのリストが親が提供するリストをブロックし、managedSourcesBehavior の "merge" オプトインの下では、任意の管理者ソースのリストがブロックします。Claude Code v2.1.285 以降が必要です
• 親が提供する blockedMarketplaces は、管理ソースが設定するブロックリストに加えて適用されます。Claude Code v2.1.282 以降が必要です。

​

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

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

​

開発者が変更できるもの

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

​

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

​

/status でソースを読む

• (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 はポリシー キーを配信する管理対象ソースを見つけませんでした。 管理対象設定ファイルをデプロイした場合、OS のパスに配置されていることを確認し、制御キーのみではなくポリシー キーが含まれていることを確認します。有効な JSON ではないファイルはこの状態を生成しません。Claude Code は代わりに起動を拒否します。 代わりにサーバー管理設定を通じてデプロイした場合は、claude doctor を実行します。これはフェッチ結果を報告します。
• 行が展開したソース以外のソースを名前で示す：高優先度のソースが存在し、Claude Code があなたのソースを無視しました。Skipped sources がそれをリストします。Claude Code が管理対象ソースを組み合わせる方法は順序を示します。

​

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

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

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

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

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

​

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

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

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

​

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 の両方を保留するため、拒否リストを修正するまで何も許可しません。

​

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

​

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

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

​

関連項目

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