設定の階層(Settings layers)
がを組み合わせる順番。何なのか、どう動きどう使うのか、気をつける点まで図と例で説明します。
これは何?
は同じ設定をいくつもの場所で見つけることがあるので、どの値が勝つかを決める決まった順番が必要です。高いほうから、管理設定、--settings フラグ、.claude/settings.local.json、.claude/settings.json、~/.claude/settings.json の順です。名のような一つの値を二つの層が設定すると、上の層が勝ちます。permissions.allow のような同じリストを設定すると、Claude Code はリストをつなげるので、それぞれのファイルがほかの項目を消さずに項目を加えられます。こうして組織、チーム、一人ひとりが、一つのファイルを取り合わずにそれぞれ意見を言えます。
しくみ
-
Claude Code が全を読む
-
一つの値は上の層が勝つ
-
リストは全部の層をつなげる
-
/status で読んだファイルを見る
使い方
-
~/.claude/settings.jsonすべてのプロジェクトに使う自分の既定値。いちばん下の層です。
-
.claude/settings.jsonにするチームのファイル。そのプロジェクトではユーザーのファイルより優先されます。
-
.claude/settings.local.json一つのプロジェクトだけの自分用の上書き。チームのファイルより優先され、コミットには入りません。
-
claude --settings '{"spinnerTipsEnabled": true}'このセッションだけキーを設定します。管理設定以外のどのファイルよりも上です。
気をつけること
環境変数は層ではありません。たとえばの ANTHROPIC_MODEL は、どのファイルの model キーよりも勝ちます。いくつかののキーは、管理設定が違うことを言っていても、下の層のよりきびしい値を受け入れます。また fallbackModel のようないくつかのリストのキーは、つなげずに丸ごと使われます。
関連する用語
原文と公式ドキュメント
このページは用語をやさしい言葉で説明しています。基準は原文です。内容が違うときは原文に従ってください。
- この用語を原文で見るClaude Code Docs — Glossary Anthropic · 2026-10-19 に確認
- Anthropic — Claude Code docs: Settings files and precedence — Settings precedence(新しいウィンドウで開きます)
- Anthropic — Claude Code docs: Settings files and precedence — Lists merge instead of overriding(新しいウィンドウで開きます)
- Anthropic — Claude Code docs: Settings files and precedence — Settings files and who they affect(新しいウィンドウで開きます)
- Anthropic — Settings — Where settings live(新しいウィンドウで開きます)