settings.json

parentSettingsBehavior

SDKの管理設定（親階層）を継承された設定とどのようにマージするかを制御します。

使い方・用途

  • エンタープライズ環境において、IT管理者が配布した共通ポリシーと、特定のプロジェクトやSDKが提供する設定をどのように統合するかを定義します。
  • '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設定を柔軟に共存させることが可能になります。

関連ドキュメント