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

​

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

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

​

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

• 配信コントロール: policyHelper、wslInheritsWindowsSettings、および managedSourcesBehavior
• ゲートウェイログインキー: forceLoginGatewayUrl および forceLoginMethod の "gateway" 値

​

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

• サーフェス: 開発者のマシン上で、ターミナル、VS Code および JetBrains 拡張機能、デスクトップアプリの Code タブ、および Agent SDK セッションはこれらのソースをすべて読み取ります。Agent SDK セッションは、settingSources がユーザー、プロジェクト、ローカルファイルを除外する場合でも、マネージド設定をロードします。
• クラウドセッション: Anthropic ホスト環境のセッションはデバイスの MDM プロファイルまたはファイルを読み取らないため、ポリシーはサーバーマネージド設定から来る必要があります。自己ホスト環境 のセッションは、デフォルトではサーバーマネージド設定がポリシーキーを配信しない場合のみ、ランナーイメージ内のマネージド設定ファイルを読み取ります。ただし、すべての管理ソースから Claude Code が読み取るキー は除きます。Claude Code がマネージドソースを組み合わせる方法 は両方を適用する opt-in について説明しています。
• 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 はデバイスポリシーを読み取ることができません。
  サーフェスカバレッジ テーブルは 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 apps gateway として。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. HKCU レジストリ、Windows 上、および WSL 上。HKLM レジストリまたは Windows マネージド設定ファイルが wslInheritsWindowsSettings をオンにし、HKCU 値もそれを設定する場合。Claude Code はそれを読み取るのは、上記のソースがポリシーキーを配信せず、ホスト提供の親設定 が制限的なキーを提供しない場合のみです

​

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

• sandbox.network.allowManagedDomainsOnly および sandbox.filesystem.allowManagedReadPathsOnly: 任意の管理ソースの true がロックをオンにします。ロックがオンの間、Claude Code は許可リストをロックします。sandbox.network.allowedDomains を WebFetch(domain:...) 許可ルール、または sandbox.filesystem.allowRead と一緒に、すべての管理ソース全体で結合します。ロックがない場合、Claude Code は許可リストを他のキーのように扱うため、"first-wins" の下では、選択されていない管理ソースの許可リストは無視されます
• allowAllClaudeAiMcps
• サンドボックスバイナリパス sandbox.bwrapPath および sandbox.socatPath
• サンドボックス ripgrep バイナリ、sandbox.ripgrep
• sandbox.filesystem.disabled および sandbox.network.strictAllowlist
• useAutoModeDuringPlan および syncClaudeAiSkills。任意の管理ソースの false が動作をオフにします。開発者のユーザーまたはローカル設定の false もそれをオフにします。各キーは拒否のみできます
• enableArtifact。任意の管理ソースの false が Artifact ツール をオフにします。開発者のユーザー、プロジェクト、またはローカル設定の false もそれをオフにし、ソースはそれをオンに戻しません。下位レベルの値がまだカウントされる を参照してください。Claude Code v2.1.242 以降が必要です
• attribution のコミットトレーラー opt-out、または非推奨の 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 値を強制し、親提供のものをブロックします。Claude Code が適用しない下位管理ソースの値は適用も、ブロックもしません。managedSourcesBehavior エントリは "merge" の下で各キーを提供するソースを示しています。v2.1.223 より前では、任意の管理ソースの値が親のものをブロックしました
• availableModels 値は allowedMcpServers と同じルールに従います

​

マネージドルールのみが適用される場合に Cowork フォルダアクセスを保持する

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

​

開発者が変更できるもの

• セッションのモデル: マネージド model はロックではなくデフォルトです。--model および ANTHROPIC_MODEL はそのセッションのモデルを選択します。availableModels をデプロイして選択を制限します。
• ローカル管理者権限: マシンの管理者である開発者はマネージドソース自体を編集できます。これが 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 で通知として報告します。

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

​

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

​

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

​

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

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

​

関連項目

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