設定のスコープ（優先順位）を理解したい
5. 設定・カスタマイズコマンド / 機能
managed > user > project > local設定の階層と優先順位
概要
Claude Code の設定には4つのスコープがあり、優先順位が決まっています。managed（管理者）> user（ユーザー）> project（プロジェクト）> local（ローカル）の順で適用されます。
設定例
# スコープと設定ファイルの場所
# managed: システム管理者が配備（最高優先度）
# macOS: /Library/Application Support/Claude/managed-settings.json
# Linux: /etc/claude/managed-settings.json
# Windows: レジストリ
# user: ユーザー全体（全プロジェクト共通）
~/.claude/settings.json
# project: プロジェクト共有（git にコミット）
.claude/settings.json
# local: プロジェクト個人（gitignore 対象）
.claude/settings.local.json
# 特定スコープのみ読み込む
claude --setting-sources user,projectこんな時に使う
- どの設定ファイルが有効になっているか確認したい時
- 組織全体に設定を強制したい時（managed）
- プロジェクト固有の個人設定を gitignore したい時（local）
使い方
- 1適切なスコープのファイルに設定を記述
- 2--setting-sources で読み込むスコープを限定
- 3--settings で追加設定ファイルを指定可能
Tips
- higher priority の設定が lower priority を上書きする
- team に共有したい設定は project スコープ（.claude/settings.json）
- 個人の認証情報等は local スコープ（.claude/settings.local.json）に