settings.json

parentSettingsBehavior

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

(管理者/管理設定のみ) SDK managedSettings(親階層)が継承された設定とどう統合されるかを制御する。

取りうる値

first-wins既定管理者が配布した管理階層が存在する場合、Claude Code はホストから提供された設定を破棄する
mergeClaude Code がホストから提供された設定を制限的な項目のみに限定したフィルターを通して管理階層の下に適用する

記述例

{
  "parentSettingsBehavior": "merge"
}

使い方・用途

  • Agent SDK や IDE 拡張などの埋め込みホストが提供する管理設定(managedSettings)を、管理者が配布した管理階管理者が配布した管理階層が存在する場合にどう扱うかを制御する設定
  • デフォルトの "first-wins" では管理者設定が存在すればホスト提供の設定は破棄される
  • "merge" ではホスト提供の設定が制限的な項目のみに限定したフィルターを通して管理階層の下に適用される
  • Claude Desktop がゲートウェイの下り許可リストを配下のセッションに引き継ぎたい場合などに "merge" を設定する
  • このキーは選択された(最優先の)ソースからのみ読み込まれるため、クライアント側ソースではスニペット全体をミラーする必要がある
英語原文(公式ドキュメントより)

(Admin/managed settings only) Controls how SDK managedSettings (parent tier) merge with inherited settings. 'first-wins': first non-empty value applies (default). 'merge': merge arrays and objects. See https://code.claude.com/docs/en/server-managed-settings

関連ドキュメント

関連する変更履歴

v2.1.133(1件)

Added
Settings
管理設定の統合動作を制御する parentSettingsBehavior キーを追加し、SDKの管理設定と既存ポリシーの統合が可能になりました
英語原文を表示
Added parentSettingsBehavior admin-tier key ('first-wins' | 'merge') to let admins opt SDK managedSettings (parent tier) into the policy merge

変更前

SDKを通じて提供される管理設定と、システム上の管理設定が競合した場合の優先順位やマージ方法を管理者が詳細に制御できませんでした。

変更後

parentSettingsBehavior に 'first-wins' (最初の設定優先) または 'merge' (マージ) を指定することで、組織のポリシーに応じた設定の継承を実現できます。

ユーザーへの恩恵

エンタープライズ環境において、共通ポリシーとプロジェクト固有のSDK設定を柔軟に共存させることが可能になります。

関連ドキュメント