サーバー管理設定(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つです。
- Claude for Teams または Claude for Enterprise プラン
- 組織での Owner または Primary Owner のロール(設定の閲覧・編集ができるのはこの2つだけ)
api.anthropic.comへのネットワーク接続
設定の変更は組織の全員に及ぶ可能性があるため、管理できる人は信頼できる担当者に限るよう公式は注意しています。
管理コンソールでの設定と配布の確認
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 Code を再起動してもらい、セッション内で
/statusを実行します。Setting sourcesの行にEnterprise managed settingsが(remote)付きで出ていれば適用されています。 - 権限ルールが効いているかは
/permissionsで実効ルールを確認します。 - 特定のマシンでの取得結果は
claude doctorのManaged settings (remote)の行で分かります(v2.1.248 以降)。「読み込めた」「組織に設定がない」「取得に失敗した(原因とキャッシュが使われているか)」「取得をスキップした(理由)」のいずれかが表示されます。
配布のトラブルを調べるときは claude --debug-file <path> でログを出し、Remote settings を検索します。組織全体に出す前に、テスト用マシンの claude doctor で変更を確かめておくのが公式の推奨です。
グループごとに別の設定を配る
Enterprise プランでは、組織全体で1つの設定ではなく、グループごとに別の設定を配れます(Team プランでは全員に同じ設定が適用されます。HIPAA を有効にした組織ではグループ別設定はまだ使えません)。グループは IdP から SCIM で同期したものか、管理コンソールで作ったカスタムグループである必要があります。
各メンバーが受け取る設定は、どの端末でも最大1つです。設定を持つグループに属する人は、所属グループのうち最も上位に並べた設定を受け取り、それ以外の人は「Everyone else」(キャッチオール)の設定を受け取ります。設定同士や組織全体の設定とはマージされないため、全員に効かせたい制限は、すべてのグループ設定とキャッチオールの両方に書いておく必要があります。
手順は次のとおりです。最後の切り替えまでは組織全体の設定が配られ続けるので、先に準備と確認ができます。
- グループごとの設定を追加: Add configuration でグループを選び、出発点を選びます。今の設定を引き継いで少しだけ変えるなら、組織全体の設定のコピーから始めます。制限を緩めるグループには、管理コンソールで自分を追加できない IdP 同期のグループを選びます。
- キャッチオールを設定: Everyone else の Set で、どのグループにも当たらない人向けの JSON を入れます。省略すると、その人たちのローカルセッションにはサーバー管理設定が届きません。
- グループの順位を決める: ドラッグで並べ替えます。複数グループに属する人は最上位の設定だけを受け取るので、厳しいグループや具体的なグループを上に置きます。
- 誰に何が届くかを確認: ページ下部の Check effective settings でメンバーを検索し、各グループの人・複数グループの人・どれにも当たらない人を確かめます。
- グループ方式に切り替え: ページ上部のバナーの Switch to group-based configurations で確定します。おおむね1時間以内に各メンバーへ届き、同じバナーから組織全体方式へ戻すこともできます。
グループで指定したモデルの制限が効くのはローカルセッションだけです。クラウドセッションとリモートの Cowork セッションでは、キャッチオール(未設定なら組織全体の設定)の availableModels が使われます。
取得・キャッシュと優先順位の仕組み
優先順位
サーバー管理設定とエンドポイント管理設定は、どちらも Claude Code の設定階層の最上位にあります。ここで決めたキーは、ユーザー自身の設定ファイルや --settings の値より優先されます(ただしユーザーの allow ルールはマージされます)。管理設定の中では、既定で少なくとも1つのポリシーキーを配る最初のソースが使われ、サーバー管理設定が先、エンドポイント管理設定が後の順で確認されます。例外として、env ブロックは v2.1.223 以降、変数ごとに管理ソース間でマージされます。
取得とキャッシュ
- キャッシュがない初回起動: 初回実行や
/logoutの後にサインインしたときは、最大5秒取得を待ってからセッションを開きます。それ以外や5秒を過ぎた場合は、取得を続けながらセッションを開くため、制限が効くまで短い時間差があります。取得に失敗するとサーバー管理設定なしで続行し、警告を出します(エンドポイント管理設定は適用されます)。 - キャッシュがある2回目以降: キャッシュ(
~/.claude/remote-settings.json)が起動直後から適用され、裏で新しい設定を取得します。ただし、プロキシ・証明書・API の接続先・認証情報など一部の環境変数は、サーバーが内容を確認するまで保留されます。キャッシュは最後の取得成功から24時間で期限切れになると考えておきます。 - 反映のタイミング: 多くの変更は実行中のセッションに再起動なしで反映されますが、
modelキー、OpenTelemetry のエクスポーター設定、envからの変数の削除などは次回起動時に反映されます。
取得できないときに起動させない
既定では、起動時に取得が失敗してもキャッシュ(期限内なら)で続行します。ポリシーなしでは起動させたくない場合は、管理設定に次のキーを入れます。
{
"forceRemoteSettingsRefresh": true
}
これを有効にすると、起動時に新しい設定を取得できるまで待ち、失敗したら CLI は終了します。api.anthropic.com に届かないとユーザーが Claude Code を起動できなくなるので、事前にネットワーク設定を確認しておきます。認証切れでも再ログインできるよう、claude auth login などの claude auth サブコマンドはこの検査の対象外です。
承認ダイアログと適用されないケース
セキュリティ承認ダイアログ
危険につながりうる設定は、対話セッションでユーザーが承認するまで適用されません。対象は次のような設定です。
- シェルコマンドを実行する設定(
apiKeyHelper、statusLine、otelHeadersHelperなど) - フックの定義(すべて)
- 実行ファイルを指すサンドボックス設定や、サンドボックスの分離を弱めたり通信を中継・認証させたりする設定
- プロキシやベース URL など、承認が必要な環境変数
ダイアログでは何が設定されるかが説明され、ユーザーが拒否すると Claude Code は終了します。モデル選択やタイムアウト、UI の切り替えなど多くの環境変数は承認なしで適用されます。claudeMd キーで配る管理用 CLAUDE.md も、Claude への指示文でありコマンドではないため承認は不要です(v2.1.260 以降)。claude -p や Agent SDK のような非対話の実行ではダイアログを出せないため、承認が必要な設定はその実行に限って適用され、承認済みとしては記録されません。
サーバー管理設定が届かないケース
- 認証方法: 配布されるのは Team / Enterprise の OAuth ログイン、
CLAUDE_CODE_OAUTH_TOKENの OAuth トークン、直接設定した API キーなどで認証したセッションです。apiKeyHelperが返すキーや Workload Identity Federation の認証情報では取得されません。 - Console の API キー: Claude Console の API キーは Console 側の組織に属するため、claude.ai の組織の設定は届きません。CI などに適用したい場合は、
claude setup-tokenで作ったトークンをCLAUDE_CODE_OAUTH_TOKENに設定するか、そのマシンに管理設定ファイルを置きます。 - 他社クラウドや独自の接続先: シェルで
CLAUDE_CODE_USE_BEDROCKなどのプロバイダー変数や既定以外のANTHROPIC_BASE_URLを export していると取得はスキップされます。Amazon Bedrock などでは、セルフホストの Claude apps gateway が同等の配布を担います(Amazon Bedrock で使うを参照)。 - Cowork: Claude Desktop の Cowork セッションでは、claude.ai 管理コンソールの設定は取得されません。
- 配布できないもの:
managed-mcp.jsonファイルは配れないため、allowedMcpServers/deniedMcpServersのキーで代替します(v2.1.259 以降はmanagedMcpServersで http / sse のリモートサーバーも配れます)。policyHelperなど OS レベル専用のキーも効きません。
最後に、公式はサーバー管理設定をセキュリティ境界ではなくクライアント側の制御と位置づけています。管理されていない端末では、キャッシュファイルの改ざんや改造したクライアントで回避できるためです。より強い保証が必要な場合は、MDM に登録した端末でエンドポイント管理設定を使います。権限ルールの書き方は設定と権限、ゲートウェイ経由の構成はLLM ゲートウェイへの接続の記事も参考にしてください。
本記事は Claude Code 公式ドキュメント「Configure server-managed settings」を元に、同じく公式の Deploy managed settings で配布方式と管理設定の位置づけを照合した非公式の日本語解説です(確認日 2026-11-20)。バージョン条件や画面の文言は更新される可能性があるため、利用前に公式ドキュメントをご確認ください。