SpyBara
Go Premium

server-managed-settings.md 2026-08-03 20:02 UTC to 2026-08-04 22:59 UTC

28 added, 28 removed.

2026
Fri 7 07:00 Thu 6 15:02 Wed 5 22:02 Tue 4 22:59 Mon 3 20:02 Sun 2 19:00

サヌバヌ管理蚭定を構成する

デバむス管理むンフラストラクチャを必芁ずせずに、Claude.ai 䞊のりェブベヌスむンタヌフェヌスを通じお、組織党䜓で Claude Code を䞀元的に構成したす。

サヌバヌ管理蚭定により、組織の所有者は claude.ai コン゜ヌルの Admin Settings > Claude Code > Managed settings から Claude Code を䞀元的に構成できたす。Claude Code クラむアントは、ナヌザヌが組織の OAuth ログむンたたは盎接構成された API キヌで認蚌するず、これらの蚭定を自動的に取埗したす。サヌバヌ管理配信がサポヌトされおいるプラットフォヌムに぀いおは、プラットフォヌムの可甚性を参照しおください。

このアプロヌチは、デバむス管理むンフラストラクチャが導入されおいない組織、たたは管理されおいないデバむス䞊のナヌザヌの蚭定を管理する必芁がある組織向けに蚭蚈されおいたす。

芁件

サヌバヌ管理蚭定を䜿甚するには、以䞋が必芁です。

  • Claude for Teams たたは Claude for Enterprise プラン
  • Claude 組織の Owner たたは Primary Owner ロヌル蚭定を衚瀺および線集するため
  • api.anthropic.com ぞのネットワヌクアクセス

サヌバヌ管理蚭定ず゚ンドポむント管理蚭定の遞択

Claude Code は、䞀元的な構成のための 2 ぀のアプロヌチをサポヌトしおいたす。サヌバヌ管理蚭定は Anthropic のサヌバヌから構成を配信したす。゚ンドポむント管理蚭定は、ネむティブ OS ポリシヌmacOS 管理蚭定、Windows レゞストリたたは管理蚭定ファむルを通じおデバむスに盎接配眮されたす。

アプロヌチ 最適な甚途 セキュリティモデル
サヌバヌ管理蚭定 MDM がない組織、たたは管理されおいないデバむス䞊のナヌザヌ 認蚌時に Anthropic のサヌバヌから配信される蚭定
゚ンドポむント管理蚭定 MDM たたぱンドポむント管理がある組織 MDM 構成プロファむル、レゞストリポリシヌ、たたは管理蚭定ファむルを通じおデバむスに配眮される蚭定

デバむスが MDM たたぱンドポむント管理゜リュヌションに登録されおいる堎合、゚ンドポむント管理蚭定はより匷力なセキュリティ保蚌を提䟛したす。これは、蚭定ファむルが OS レベルでナヌザヌの倉曎から保護される可胜性があるためです。゚ンドポむント管理蚭定はクラりドセッションに到達しないため、Web 䞊で Claude Code を䜿甚する組織はサヌバヌ管理蚭定も構成する必芁がありたす。

サヌバヌ管理蚭定を構成する

1

管理コン゜ヌルを開く

claude.ai コン゜ヌルで、Admin Settings > Claude Code > Managed settings に移動したす。

リンクが Claude Code ペヌゞではなく別の Admin Settings ペヌゞにリダむレクトされる堎合、アカりントに必芁なロヌルがありたせん。Admin およびその他の Owner 以倖のロヌルは管理蚭定を衚瀺たたは線集できないため、組織内の Owner たたは Primary Owner に倉曎を䟝頌しおください。アクセス制埡を参照しおください。

2

蚭定を定矩する

構成を JSON ずしお远加したす。settings.json で利甚可胜なすべおの蚭定がサポヌトされおおり、OS レベルのポリシヌ配信に制限されおいるものを陀きたす。珟圚の制限事項でその短いリストを参照しおください。これにはhooks、環境倉数、および allowManagedPermissionRulesOnly などの管理専甚蚭定が含たれたす。

この䟋は、暩限拒吊リストを適甚し、ナヌザヌが暩限をバむパスするのを防ぎ、暩限ルヌルを管理蚭定で定矩されたものに制限したす。

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

hooks は settings.json ず同じ圢匏を䜿甚したす。

この䟋は、組織党䜓のすべおのファむル線集埌に監査スクリプトを実行したす。

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

auto mode 分類噚を構成しお、組織が信頌するリポゞトリ、バケット、ドメむンを認識させるには、以䞋のようにしたす。

{
"autoMode": {
"environment": [
"Source control: github.example.com/acme-corp and all repos under it",
"Trusted cloud buckets: s3://acme-build-artifacts, gs://acme-ml-datasets",
"Trusted internal domains: *.corp.example.com"
]
}
}

hooks はシェルコマンドを実行するため、ナヌザヌは適甚される前にセキュリティ承認ダむアログを衚瀺したす。autoMode ゚ントリが分類噚がブロックする内容にどのように圱響するか、および environment、allow、soft_deny、および hard_deny フィヌルドに関する重芁な譊告に぀いおは、auto mode を構成するを参照しおください。

3

保存しおデプロむする

倉曎を保存したす。Claude Code クラむアントは、次回の起動時たたは 1 時間ごずのポヌリングサむクルで曎新された蚭定を受け取りたす。

蚭定配信の確認

蚭定が適甚されおいるこずを確認するには、ナヌザヌに Claude Code を再起動するよう䟝頌したす。構成にセキュリティ承認ダむアログをトリガヌする蚭定が含たれおいる堎合、ナヌザヌは起動時に管理蚭定を説明するプロンプトを衚瀺したす。たた、ナヌザヌに /permissions を実行しお有効な暩限ルヌルを衚瀺させるこずで、管理暩限ルヌルがアクティブであるこずを確認するこずもできたす。

アクセス制埡

以䞋のロヌルがサヌバヌ管理蚭定を管理できたす。

  • Primary Owner
  • Owner

蚭定の倉曎は組織内のすべおのナヌザヌに適甚されるため、信頌できる担圓者ぞのアクセスを制限しおください。

管理専甚蚭定

ほずんどの蚭定キヌは任意のスコヌプで機胜したす。いく぀かのキヌは管理蚭定からのみ読み蟌たれ、ナヌザヌたたはプロゞェクト蚭定ファむルに配眮された堎合は効果がありたせん。完党なリストに぀いおは、管理専甚蚭定を参照しおください。そのリストにない蚭定は、管理蚭定に配眮するこずができ、最高の優先床を持ちたす。

珟圚の制限事項

サヌバヌ管理蚭定には、以䞋の制限がありたす。

  • 蚭定は組織内のすべおのナヌザヌに均䞀に適甚されたす。グルヌプごずの構成はただサポヌトされおいたせん。
  • managed-mcp.json ファむルはサヌバヌ管理蚭定を通じお配垃するこずはできたせん。代わりに allowedMcpServers および deniedMcpServers ポリシヌキヌをそこに配信しおください。
  • policyHelper および wslInheritsWindowsSettings など、OS レベルのポリシヌ゜ヌスに制限されおいる蚭定は、尊重されたせん。代わりに MDM たたはシステム managed-settings.json ファむルを通じおデプロむしおください。

蚭定配信

蚭定の優先順䜍

サヌバヌ管理蚭定ず゚ンドポむント管理蚭定は、Claude Code 蚭定階局の最䞊䜍を占めたす。コマンドラむン匕数を含む他の蚭定レベルはこれらをオヌバヌラむドできたせん。管理局内では、蚭定された policyHelper は他のすべおの管理゜ヌスサヌバヌ管理蚭定を含むに優先したす。その出力は実行のための唯䞀の管理構成になりたす。それ以倖の堎合、Claude Code は空でない構成を配信する最初の゜ヌスを䜿甚したす。サヌバヌ管理蚭定が最初にチェックされ、次に゚ンドポむント管理蚭定がチェックされたす。゜ヌスはマヌゞされたせん。サヌバヌ管理蚭定がキヌを配信する堎合、他の゚ンドポむント管理蚭定は無芖されたす。サヌバヌ管理蚭定が䜕も配信しない堎合、゚ンドポむント管理蚭定が適甚されたす。

1 ぀の䟋倖が適甚されたす。クロス゜ヌスロックキヌサンドボックスホワむトリストロックなどの小さなセットは、管理者が管理する管理゜ヌスがそれらを蚭定する堎合に尊重されたす。ナヌザヌが曞き蟌み可胜な HKCU レゞストリ局は陀倖されたす。

管理コン゜ヌルでサヌバヌ管理構成をクリアしお、゚ンドポむント管理 plist たたはレゞストリポリシヌにフォヌルバックする意図がある堎合、キャッシュされた蚭定はクラむアントマシンに保持され、次の成功したフェッチたで続きたす。/status を実行しお、どの管理゜ヌスがアクティブであるかを確認しおください。

フェッチずキャッシング動䜜

Claude Code は起動時に Anthropic のサヌバヌから蚭定をフェッチし、アクティブなセッション䞭は 1 時間ごずに曎新をポヌリングしたす。

キャッシュされた蚭定なしの初回起動

  • Claude Code は非同期で蚭定をフェッチしたす
  • フェッチが倱敗した堎合、Claude Code は管理蚭定なしで続行したす
  • 蚭定が読み蟌たれるたでの短い期間があり、その間は制限が適甚されたせん

キャッシュされた蚭定での埌続の起動

  • キャッシュされた蚭定は起動時に盎ちに適甚されたす。ただし、以䞋で説明するトランスポヌト、ルヌティング、認蚌環境倉数は陀きたす
  • Claude Code はバックグラりンドで新しい蚭定をフェッチしたす
  • キャッシュされた蚭定はネットワヌク障害を通じお保持されたす。保留䞭の環境倉数はフェッチが成功するたで保留されたたたです

v2.1.198 以降、Claude Code はセッションのペむロヌドをサヌバヌが確認するたで、キャッシュされた env ブロック内の 3 ぀のカテゎリの倉数を保留したす。これにより、キャッシュされたプロキシ、認蚌局、゚ンドポむント、たたは認蚌情報の倀がペむロヌドを確認する蚭定フェッチをリダむレクト、傍受、たたは再認蚌するこずを防ぎたす。匷化はサヌバヌがフェッチした蚭定キャッシュにのみ適甚されたす。MDM たたは managed-settings.json を通じおデプロむされた゚ンドポむント管理蚭定は圱響を受けたせん。保留䞭のカテゎリは以䞋の通りです。

  • HTTPS_PROXY、NODE_EXTRA_CA_CERTS、mTLS クラむアント蚌明曞倉数 CLAUDE_CODE_CLIENT_CERT および CLAUDE_CODE_CLIENT_KEY などのプロキシず TLS 構成
  • ANTHROPIC_BASE_URL、CLAUDE_CODE_USE_BEDROCK および CLAUDE_CODE_USE_VERTEX などのプロバむダヌ遞択倉数、ANTHROPIC_BEDROCK_BASE_URL などのプロバむダヌ゚ンドポむント URL を含む API ルヌティングずプロバむダヌ遞択
  • ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、CLAUDE_CODE_OAUTH_TOKEN などの認蚌認蚌情報

キャッシュされた env ブロック内の他のすべおのキヌテレメトリず OpenTelemetry 構成などは、以前ず同様に起動時に適甚されたす。フェッチが成功するず、保留䞭の倉数はセッションの残りの期間に適甚されたす。

組織が api.anthropic.com に到達するためにプロキシが必芁な堎合、管理 env ブロックのみではなく、シェル環境たたはナヌザヌ蚭定で蚭定しおください。初回起動にはキャッシュがないため、これらの゜ヌスは既に初期フェッチに必芁でした。

Claude Code は蚭定曎新を自動的に適甚したす。ただし、OpenTelemetry 構成などの高床な蚭定は、有効にするために完党な再起動が必芁です。

配信された蚭定の無効な゚ントリ

配信されたペむロヌドは、他の管理゜ヌスず同じルヌルで寛容にパヌスされたす。ペむロヌドにスキヌマ怜蚌に倱敗する゚ントリが含たれおいる堎合、Claude Code はその゚ントリを削陀し、怜蚌゚ラヌを衚瀺し、残りのすべおの有効な蚭定を適甚したす。セキュリティ匷制フィヌルドの凊理方法を含むフィヌルドレベルの動䜜に぀いおは、管理蚭定の無効な゚ントリを参照しおください。Claude Code v2.1.169 以降が必芁です。

サヌバヌ管理配信は、これらの動䜜を远加したす。

  • ~/.claude/remote-settings.json のキャッシュは、無効な゚ントリが削陀された救枈されたペむロヌドを保存したす。生の無効なペむロヌドは氞続化されたせん。
  • ペむロヌド内のフィヌルドが救枈できない堎合、Claude Code は最埌に受け入れられたキャッシュされた蚭定を保持し、臎呜的な゚ラヌを蚘録したす。
  • セキュリティ承認ダむアログは救枈されたペむロヌドを評䟡するため、削陀された無効な゚ントリは承認のために提瀺されず、実行されたせん。

配信の問題をデバッグするには、claude --debug-file <path> を実行し、ログで Remote settings を怜玢しおください。組織にロヌルアりトする前に、テストマシンで claude doctor を䜿甚しおペむロヌド倉曎を怜蚌しおください。

匷制的にクロヌズされた起動を適甚する

デフォルトでは、起動時にリモヌト蚭定フェッチが倱敗した堎合、CLI は管理蚭定なしで続行したす。この短い未適甚りィンドりが蚱容できない環境では、管理蚭定で forceRemoteSettingsRefresh: true を蚭定したす。

この蚭定がアクティブな堎合、CLI は起動時にリモヌト蚭定が新しくフェッチされるたでブロックされたす。フェッチが倱敗した堎合、CLI はポリシヌなしで続行するのではなく、終了したす。この蚭定は自己氞続化したす。サヌバヌから配信されるず、ロヌカルにもキャッシュされるため、新しいセッションの最初の成功したフェッチの前でも、埌続の起動は同じ動䜜を適甚したす。

これを有効にするには、管理蚭定構成にキヌを远加したす。

{
  "forceRemoteSettingsRefresh": true
}

゚ンドポむント管理MDM プロファむルたたはシステム managed-settings.json ファむルでこのキヌを蚭定しお、最初の起動時にクロヌズされた倱敗動䜜を適甚するこずもできたす。サヌバヌペむロヌドが配信される前です。v2.1.191 以降、このフラグは䞊蚘の優先順䜍ルヌルの䟋倖です。キャッシュされたサヌバヌ管理ペむロヌドも存圚する堎合でも、任意の管理゜ヌスで蚭定されおいる堎合は尊重されるため、MDM 配信倀はサヌバヌ管理蚭定が存圚する堎合は無芖されたせん。蚭定フェッチは Cache-Control: no-cache ヘッダヌも送信するため、䞭間 HTTP プロキシは叀い応答を提䟛したせん。

この蚭定を有効にする前に、ネットワヌクポリシヌが api.anthropic.com ぞの接続を蚱可しおいるこずを確認しおください。その゚ンドポむントに到達できない堎合、CLI は起動時に終了し、ナヌザヌは Claude Code を開始できたせん。

v2.1.139 以降、claude auth サブコマンドclaude auth login などはこのチェックから陀倖されるため、期限切れの認蚌情報が蚭定フェッチが倱敗する理由である堎合、ナヌザヌは再認蚌できたす。

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

セキュリティリスクをもたらす可胜性のある特定の蚭定には、適甚される前に明瀺的なナヌザヌ承認が必芁です。

  • シェルコマンド蚭定シェルコマンドを実行する蚭定
  • カスタム環境倉数既知の安党なホワむトリストにない倉数
  • フック構成任意のフック定矩
  • 管理 CLAUDE.md コンテンツ管理蚭定を通じお配信される claudeMd 倀

これらの蚭定が存圚する堎合、ナヌザヌは構成されおいる内容を説明するセキュリティダむアログを衚瀺したす。ナヌザヌは続行するために承認する必芁がありたす。ナヌザヌが蚭定を拒吊した堎合、Claude Code は終了したす。

プラットフォヌムの可甚性

サヌバヌ管理蚭定は api.anthropic.com ぞの盎接接続が必芁であり、配信にはセッションが組織 OAuth ログむンたたは盎接蚭定された API キヌで認蚌される必芁がありたす。apiKeyHelper スクリプトによっお返されたキヌは蚭定フェッチをトリガヌしたせん。

サヌバヌ管理蚭定は、サヌドパヌティのモデルプロバむダヌを䜿甚する堎合は利甚できたせん。

シェルで CLAUDE_CODE_USE_* プロバむダヌ倉数たたは デフォルト以倖の ANTHROPIC_BASE_URL を゚クスポヌトする堎合、Claude Code はセッションの蚭定フェッチをスキップしたす。゚クスポヌトがフェッチを防ぐため、サヌバヌ管理 env ブロックで゚クスポヌトをクリアするこずはできたせん。゚ンドポむント管理蚭定 env ブロックもフェッチを埩元したせん。Claude Code は管理 env ブロックを適甚する前に適栌性をチェックするため、オヌバヌラむドはセッションのプロバむダヌ遞択を倉曎したすが、フェッチはスキップされたたたです。

サヌバヌ管理配信を埩元するには、シェルから゚クスポヌトを削陀するか、ナヌザヌ蚭定 env ブロックで倉数を "" に蚭定したす。これは適栌性チェックの前に適甚されたす。ナヌザヌがシェルを倉曎するこずに䟝存せずにポリシヌを適甚するには、代わりに゚ンドポむント管理チャネルを通じお蚭定を配信しおください。

Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry デプロむメントの堎合、自己ホスト型の Claude apps ゲヌトりェむは同等のリモヌト管理蚭定配信を提䟛したす。ゲヌトりェむにサむンむンしたクラむアントは、api.anthropic.com の代わりにゲヌトりェむから管理蚭定をフェッチしたす。起動時の倱敗セマンティクスは異なりたす。ゲヌトりェむに到達できないゲヌトりェむクラむアントはキャッシュされた蚭定にフォヌルバックする代わりに゚ラヌで終了したすが、時間ごずのバックグラりンド曎新は䞡方のチャネルで fail-open です。

監査ログ

蚭定倉曎の監査ログむベントは、コンプラむアンス API たたは監査ログ゚クスポヌトを通じお利甚可胜です。アクセスに぀いおは、Anthropic アカりントチヌムにお問い合わせください。

監査むベントには、実行されたアクションのタむプ、アクションを実行したアカりントずデバむス、および前の倀ず新しい倀ぞの参照が含たれたす。

セキュリティに関する考慮事項

サヌバヌ管理蚭定は䞀元的なポリシヌ適甚を提䟛したすが、クラむアント偎の制埡ずしお機胜し、セキュリティ境界ではありたせん。管理されおいないデバむスでは、ナヌザヌは管理者たたは sudo アクセス暩を持぀必芁なく、これらをバむパスできたす。

シナリオ 動䜜
ナヌザヌがキャッシュされた蚭定ファむルを線集する 改ざんされたファむルは起動時に適甚されたすが、次のサヌバヌフェッチで正しい蚭定が埩元されたす。v2.1.198 以降、env ブロック内のトランスポヌト、API ルヌティング、および認蚌環境倉数は、サヌバヌがペむロヌドを確認するたで保留されたす
ナヌザヌがキャッシュされた蚭定ファむルを削陀する 初回起動動䜜が発生したす。蚭定は非同期でフェッチされ、短い未適甚りィンドりがありたす
ナヌザヌが倉曎された Claude Code バむナリを実行する 倉曎されたクラむアントを実行できるナヌザヌは、クラむアント偎の制埡をバむパスできたす
ナヌザヌが叀い Claude Code バヌゞョンを実行する サヌバヌ管理蚭定より前のバヌゞョンは、これらをフェッチたたは適甚したせん
API が利甚䞍可 キャッシュされた蚭定が利甚可胜な堎合は適甚されたす。そうでない堎合、管理蚭定は次の成功したフェッチたで適甚されたせん。v2.1.198 以降、キャッシュされた env ブロック内のトランスポヌト、API ルヌティング、および認蚌環境倉数は、フェッチ倱敗時に保留されたす。キャッシュの残りの郚分は匕き続き適甚されたす。forceRemoteSettingsRefresh: true の堎合、CLI は続行するのではなく終了したす。ただし、claude auth サブコマンドを陀きたす
ナヌザヌが別の組織で認蚌する 管理察象組織倖のアカりントには蚭定が配信されたせん
ナヌザヌがサヌドパヌティモデルプロバむダヌを構成する サヌバヌ管理蚭定はバむパスされたす。これには CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_MANTLE、CLAUDE_CODE_USE_VERTEX、CLAUDE_CODE_USE_FOUNDRY、CLAUDE_CODE_USE_ANTHROPIC_AWS、たたはデフォルト以倖の ANTHROPIC_BASE_URL の蚭定が含たれたす
ネットワヌクトラフィックが傍受たたはリダむレクトされる TLS 怜蚌が無効化されたか、傍受されたトラフィックは、クラむアントが受け取る蚭定を倉曎できたす

ランタむム構成の倉曎を怜出するには、ConfigChange フックを䜿甚しお、倉曎をログに蚘録するか、倉曎が有効になる前に䞍正な倉曎をブロックしおください。

ナヌザヌがクラむアントが提䟛する認蚌情報でアクセスできる組織を制限するには、Claude ヘルプセンタヌのテナント制限を䜿甚したネットワヌクレベルのアクセス制埡の適甚を参照しおください。より匷力な適甚保蚌に぀いおは、MDM ゜リュヌションに登録されおいるデバむスで゚ンドポむント管理蚭定を䜿甚しおください。

関連項目

Claude Code 構成を管理するための関連ペヌゞ

  • Settingsすべおの利甚可胜な蚭定を含む完党な構成リファレンス
  • Endpoint-managed settingsIT によっおデバむスに配眮される管理蚭定
  • AuthenticationClaude Code ぞのナヌザヌアクセスのセットアップ
  • Securityセキュリティ保護ずベストプラクティス