Claude Code のサーバー管理設定:管理コンソールから組織へ一括配布

Claude Code エンジニアリング 8分で読めます

サーバー管理設定(server-managed settings)を使うと、組織の Owner が claude.ai の管理コンソールに JSON を書くだけで、メンバー全員の Claude Code に権限ルールやフック、環境変数を配れます。MDM などの端末管理の仕組みがなくても、Claude Code がサインイン時に Anthropic のサーバーから設定を取りに行くためです。この記事では、公式ドキュメント「Configure server-managed settings」に沿って、使える条件・設定手順・グループ別の配布・取得とキャッシュの挙動・承認ダイアログを説明します。

サーバー管理設定とは・必要な条件

Claude Code で組織の設定を一元管理する方法は2つあります。Anthropic のサーバーから配るサーバー管理設定と、MDM の構成プロファイルや Windows レジストリ、managed-settings.json ファイルで端末に直接置くエンドポイント管理設定です。

方式向いている組織仕組み
サーバー管理設定MDM がない組織、管理されていない端末を使うメンバーがいる組織Claude Code が起動時に Anthropic のサーバーから取得し、セッション中は1時間ごとに更新を確認する
エンドポイント管理設定MDM や端末管理を導入済みの組織MDM プロファイル・レジストリポリシー・管理設定ファイルで端末に配置する

端末が MDM に登録されているなら、設定ファイルを OS レベルでユーザーの変更から守れるエンドポイント管理設定のほうが強い保証になります。一方で、エンドポイント管理設定は Anthropic がホストするクラウドセッションには届かないため、クラウドセッションを使う組織はサーバー管理設定も併用するよう公式は勧めています。

利用に必要な条件は次の3つです。

設定の変更は組織の全員に及ぶ可能性があるため、管理できる人は信頼できる担当者に限るよう公式は注意しています。

管理コンソールでの設定と配布の確認

1. 管理コンソールを開く

claude.ai で Organization settings > Claude Code > Managed settings を開きます。アクセス権がないと表示されたら、Owner か Primary Owner に変更を依頼します。

2. 設定を JSON で書く

settings.json で使える設定は、OS レベルのポリシーでしか配れない一部のキーを除いてすべて使えます。フック、環境変数(env)、allowManagedPermissionRulesOnly のような管理設定専用のキーも含まれます。公式の例は、拒否ルールを強制し、権限のバイパスを禁止し、権限ルールを管理設定のものだけに絞る設定です。

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

なお Bash(curl *) は Claude が書いたとおりの curl にしか一致せず、/usr/bin/curl や sh -c 'curl …' は対象外です。コマンドの書き方に左右されない通信制限が必要なら、sandbox ブロックの allowManagedDomainsOnly を併用します(Bash サンドボックス設定を参照)。フックも settings.json と同じ形式で書けます。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "/usr/local/bin/audit-edit.sh" }
        ]
      }
    ]
  }
}

3. 保存して配布する

保存すると、各クライアントは次の起動時か1時間ごとの確認で新しい設定を受け取ります。エディタは公開されている JSON スキーマで内容を検査し、問題があると警告を出してボタンを Update with errors(未保存なら Add with errors)に変えますが、保存自体は止めません。スキーマは最新リリースに追いついていないことがあるため、Claude Code 側でも読み込み時に独自の検証を行います。

配布されたかを確かめる

配布のトラブルを調べるときは claude --debug-file <path> でログを出し、Remote settings を検索します。組織全体に出す前に、テスト用マシンの claude doctor で変更を確かめておくのが公式の推奨です。

グループごとに別の設定を配る

Enterprise プランでは、組織全体で1つの設定ではなく、グループごとに別の設定を配れます(Team プランでは全員に同じ設定が適用されます。HIPAA を有効にした組織ではグループ別設定はまだ使えません)。グループは IdP から SCIM で同期したものか、管理コンソールで作ったカスタムグループである必要があります。

各メンバーが受け取る設定は、どの端末でも最大1つです。設定を持つグループに属する人は、所属グループのうち最も上位に並べた設定を受け取り、それ以外の人は「Everyone else」(キャッチオール)の設定を受け取ります。設定同士や組織全体の設定とはマージされないため、全員に効かせたい制限は、すべてのグループ設定とキャッチオールの両方に書いておく必要があります。

手順は次のとおりです。最後の切り替えまでは組織全体の設定が配られ続けるので、先に準備と確認ができます。

  1. グループごとの設定を追加: Add configuration でグループを選び、出発点を選びます。今の設定を引き継いで少しだけ変えるなら、組織全体の設定のコピーから始めます。制限を緩めるグループには、管理コンソールで自分を追加できない IdP 同期のグループを選びます。
  2. キャッチオールを設定: Everyone else の Set で、どのグループにも当たらない人向けの JSON を入れます。省略すると、その人たちのローカルセッションにはサーバー管理設定が届きません。
  3. グループの順位を決める: ドラッグで並べ替えます。複数グループに属する人は最上位の設定だけを受け取るので、厳しいグループや具体的なグループを上に置きます。
  4. 誰に何が届くかを確認: ページ下部の Check effective settings でメンバーを検索し、各グループの人・複数グループの人・どれにも当たらない人を確かめます。
  5. グループ方式に切り替え: ページ上部のバナーの Switch to group-based configurations で確定します。おおむね1時間以内に各メンバーへ届き、同じバナーから組織全体方式へ戻すこともできます。

グループで指定したモデルの制限が効くのはローカルセッションだけです。クラウドセッションとリモートの Cowork セッションでは、キャッチオール(未設定なら組織全体の設定)の availableModels が使われます。

取得・キャッシュと優先順位の仕組み

優先順位

サーバー管理設定とエンドポイント管理設定は、どちらも Claude Code の設定階層の最上位にあります。ここで決めたキーは、ユーザー自身の設定ファイルや --settings の値より優先されます(ただしユーザーの allow ルールはマージされます)。管理設定の中では、既定で少なくとも1つのポリシーキーを配る最初のソースが使われ、サーバー管理設定が先、エンドポイント管理設定が後の順で確認されます。例外として、env ブロックは v2.1.223 以降、変数ごとに管理ソース間でマージされます。

取得とキャッシュ

取得できないときに起動させない

既定では、起動時に取得が失敗してもキャッシュ(期限内なら)で続行します。ポリシーなしでは起動させたくない場合は、管理設定に次のキーを入れます。

{
  "forceRemoteSettingsRefresh": true
}

これを有効にすると、起動時に新しい設定を取得できるまで待ち、失敗したら CLI は終了します。api.anthropic.com に届かないとユーザーが Claude Code を起動できなくなるので、事前にネットワーク設定を確認しておきます。認証切れでも再ログインできるよう、claude auth login などの claude auth サブコマンドはこの検査の対象外です。

承認ダイアログと適用されないケース

セキュリティ承認ダイアログ

危険につながりうる設定は、対話セッションでユーザーが承認するまで適用されません。対象は次のような設定です。

ダイアログでは何が設定されるかが説明され、ユーザーが拒否すると Claude Code は終了します。モデル選択やタイムアウト、UI の切り替えなど多くの環境変数は承認なしで適用されます。claudeMd キーで配る管理用 CLAUDE.md も、Claude への指示文でありコマンドではないため承認は不要です(v2.1.260 以降)。claude -p や Agent SDK のような非対話の実行ではダイアログを出せないため、承認が必要な設定はその実行に限って適用され、承認済みとしては記録されません。

サーバー管理設定が届かないケース

最後に、公式はサーバー管理設定をセキュリティ境界ではなくクライアント側の制御と位置づけています。管理されていない端末では、キャッシュファイルの改ざんや改造したクライアントで回避できるためです。より強い保証が必要な場合は、MDM に登録した端末でエンドポイント管理設定を使います。権限ルールの書き方は設定と権限、ゲートウェイ経由の構成はLLM ゲートウェイへの接続の記事も参考にしてください。

本記事は Claude Code 公式ドキュメント「Configure server-managed settings」を元に、同じく公式の Deploy managed settings で配布方式と管理設定の位置づけを照合した非公式の日本語解説です(確認日 2026-11-20)。バージョン条件や画面の文言は更新される可能性があるため、利用前に公式ドキュメントをご確認ください。