管理コンソールにdenyルールを登録したのに、特定の社員の環境だけ.envが読めてしまう。原因の多くは設定の書き間違いではなく、ポリシーがそのPCに届いていないことにある。
Claude Codeの管理設定は、配布経路ごとに適用されない条件が決まっている。本記事では、エージェントガバナンスの実装として管理設定を配る中小企業が、公式ドキュメントで確認できる抜け道を5つに整理する。hooksによる監査ログの記録はClaude Codeのhooksで監査証跡を自動記録するを参照してほしい。
管理設定にはどんな配布経路があるのか
管理設定の配布経路は、サーバー配布・MDM・設定ファイル・HKCUレジストリの4種類で、端末側に置く3種は端末管理型と呼ばれる。
公式ドキュメントによれば、サーバー配布（server-managed settings）はTeamまたはEnterpriseプランが条件で、設定は起動時に取得され1時間ごとに更新される。MDMやファイル配布は端末に保存され、MDMは30分ごとに変更が確認される。
ファイルの置き場所はOSごとに決まっている。macOSは/Library/Application Support/ClaudeCode/managed-settings.json、Linuxは/etc/claude-code/managed-settings.json、WindowsはC:\Program Files\ClaudeCode\managed-settings.jsonだ。
設定が素通りされるのはどの5経路か
公式ドキュメントが挙げる素通り経路は、Bedrock等のプロバイダー変数、Console APIキー、Cowork、クラウドセッション、古いバージョンの5つである。
- プロバイダー変数:
CLAUDE_CODE_USE_BEDROCKやCLAUDE_CODE_USE_VERTEX、既定外のANTHROPIC_BASE_URLをシェルで設定すると、サーバー配布の取得自体がスキップされる - Console APIキー: Claude Consoleの組織はclaude.aiのTeam組織とは別物で、そのキーで動くCIジョブには管理コンソールの設定が届かない
- Cowork: Claude Desktop上のCoworkセッションは、Team/Enterpriseでサインインしてもサーバー配布の設定を取得しない
- クラウドセッション: Anthropic提供の環境ではMDMやファイルが読まれないため、サーバー配布が唯一の経路になる
- 古いバージョン: サーバー配布に対応する前の版は設定を取得も適用もしない
サーバー配布は端末側の制御であり、セキュリティ境界ではない。公式ドキュメントも、改変されたクライアントを動かせる利用者は回避できると明記している。
抜け道をふさぐにはどう設計すべきか
端末側にも管理設定ファイルを置き、
forceRemoteSettingsRefreshを有効にすると、取得失敗時に起動を止める運用へ切り替えられる。
対策は3層で考える。
- 端末管理型を併用する: MDMがなくてもファイル配布なら
managed-settings.jsonを置ける。ファイルが置かれた端末では、シェル変数によるサーバー配布のスキップも防げる - 失敗時に止める:
forceRemoteSettingsRefresh: trueを管理設定に入れると、取得に失敗したクライアントは起動せず終了する。api.anthropic.comへの疎通を先に確認する - 上書きを禁じる:
allowManagedPermissionRulesOnlyをtrueにすると、ユーザー・プロジェクト・ローカルの権限ルールは無視される
CI用のキーは、claude setup-tokenで発行したOAuthトークンをCLAUDE_CODE_OAUTH_TOKENに設定する方法が公式に示されている。
適用されているかをどう検証するか
検証は端末で
/statusを開き、Setting sources行のEnterprise managed settingsの括弧内を読むだけで済む。
(remote)はサーバー配布、(file)は設定ファイル、(plist)や(HKLM)はMDMを示す。この行が無ければポリシーが届いていない。サーバー配布の取得結果はclaude doctorのManaged settings (remote)行で確認でき、Claude Code v2.1.248以降が必要だ。
全社展開の前に、代表1台で/statusを確認する手順を必ず挟む。設定の設計から配布検証まで自社で回せない場合は、KuuのAI Opsで運用ごと任せる選択肢もある。
参考
まとめ
管理設定は、登録しただけでは全社員に効かない。プロバイダー変数・Console APIキー・Cowork・クラウドセッション・旧バージョンの5経路を前提に、ファイル配布の併用と/statusでの実機検証を組み合わせることが、中小企業でも実行できる最小の統制になる。配布設計の相談はKuuのAI Opsまでお問い合わせください。