managedSourcesBehavior

settings.json型string既定値first-wins記述場所管理者設定のみ

Claude Code が、組織が配布する最も優先度の高い管理ソースのみを適用するか、配布されるすべての管理ソースを結合するかを選ぶ。既定では、Claude Code はポリシーキーを運ぶ最も優先度の高いソースを採用し、残りを無視する。ポリシーキーとは、このキーと wslInheritsWindowsSettings 以外の任意の設定キーである。この既定では、サーバー管理設定や MDM ポリシーがポリシーキーを配布すると、managed-settings.json はすべての管理ソースから読み取られるキーのみを提供する。'merge' を指定すると、配布されたすべての管理ソースがそのキーを 1 つの結合ポリシーに提供する。Claude Code v2.1.242 以降が必要。

取りうる値

`first-wins`既定	ポリシーキーを運ぶ最も優先度の高いソースがポリシーを提供し、下位のソースはすべての管理ソースから読み取られるキーのみを提供する。
`merge`	配布されたすべての管理ソースがそのキーを提供し、以下のルールに従って結合される。

記述例

{
  "managedSourcesBehavior": "merge"
}

使い方・用途

組織が server-managed settings・MDM ポリシー・managed-settings.json など複数の管理ソースを同じマシンに配布しているとき、既定の最優先ソースのみ適用ではなく全管理ソースの設定を統合して適用したい場合に使う。
単一の最優先ソースに全ポリシーを集約せず、複数の管理ソースそれぞれが提供するキーを 1 つの結合ポリシーとして機能させたい場合に使う。
hooks ロックや allowManagedPermissionRulesOnly など複数のロック系設定について、最優先ソースの値ではなく各ソースが設定した中で最も厳しい値を適用させたい場合に使う。

英語原文

Choose whether Claude Code applies only the highest-priority managed source your organization delivers, or combines every admin source it delivers. By default Claude Code takes the highest-priority source that carries a policy key and ignores the rest. A policy key is any settings key other than this one and wslInheritsWindowsSettings. Under that default, once server-managed settings or an MDM policy deliver a policy key, a managed-settings.json file contributes only the keys Claude Code reads from every admin source. With "merge", every admin source you deliver contributes its keys to one combined policy. Requires Claude Code v2.1.242 or later.

managedSourcesBehavior

取りうる値

記述例

使い方・用途

関連ドキュメント

関連する変更履歴

v2.1.257(1件)