Claude Codeのsettings.json優先順位を実測した ― permissionsは「上書き」ではなく「マージ」される

Claude Codeのsettings.jsonにおける優先順位とpermissionsの挙動について、実測に基づき解説。permissionsが「上書き」ではなく「マージ」されるという、一般的な理解と異なる挙動を明らかにしています。AIツールの設定に関する詳細な技術情報を提供。

• Claude Codeのsettings.jsonの優先順位は、コマンドライン引数、local、project、userの順で、userが最も優先度が低い。
• permissions設定は他の設定と異なり、上位スコープが下位スコープを上書きせず、「マージ」される挙動を示す。
• 環境変数(env)はキー単位でマージされるため、上位スコープで定義されていなくても下位スコープの値は有効である。
• --setting-sourcesオプションにより、読み込む設定スコープを明示的に指定・絞り込みが可能である。