設定ファイル（Settings files）：置き場所と、どれが優先されるか

Anthropic の公式の説明（下の「公式のページ」）を、内容を足さずに読みやすい日本語に書き直したものです。公式の翻訳ではなく、Anthropic が作ったものでもありません。公式は予告なく変わるので、使う前に公式のページもご覧ください。

このページで分かること

• 設定ファイルを置く4つの場所と、それぞれの設定がだれに効くか
• 同じ項目を何か所かで決めたとき、どの値が使われるか（優先の順番）
• 設定の変え方と、読み込まれたかの確かめ方、効かないときに見る所

先に知っておく言葉

• 設定：Claude Code の動き方を決める項目。最初に使うモデル、聞かずに動かしてよいもの、読ませないファイル、ターミナルでの見た目などがあります
• JSON：項目の名前と値を { } の中に決まった形で並べる、文字だけのファイルの書き方
• リポジトリ・コミット：git で変更の履歴を残しているプロジェクトのフォルダと、変更をその履歴に入れること
• 管理設定（Managed settings）：会社などの組織が、まとめて配って守らせる設定。安全のための一部の例外を除き、自分やプロジェクトの設定では上書きできません
• 環境変数：Claude Code を起動する前に、パソコンの側で決めておく名前つきの値
• フック（Hook）：決まったタイミングで自動で動く、自分で決めた処理
• プラグイン（Plugin）：スキルやフックなどを1つにまとめて、入れられるようにしたもの
• フォルダの信頼（Project trust）：そのフォルダの設定を読み込む前に、フォルダを認める確認。認めるまで、一部の設定は効きません
• クラウドセッション（Cloud session）：自分のパソコンではなく、クラウドの上で動く Claude Code の会話

4つの置き場所と、効く相手

設定は JSON のファイルに書きます。ターミナルで使う版、VS Code と JetBrains の拡張機能、デスクトップアプリは、どれも同じ設定ファイルを読みます。

• ユーザー（~/.claude/settings.json）：このパソコンの、すべてのプロジェクトで、あなたにだけ効きます
• 共有プロジェクト（.claude/settings.json）：このファイルを含むフォルダで作業する全員に効きます。git のリポジトリならコミットすると、仲間のクローンにも届きます。コミットするまでは、あなたのパソコンにあるだけのファイルです
• プロジェクトのローカル（.claude/settings.local.json）：このプロジェクトだけで、あなたにだけ効きます
• 管理設定：組織が配った先のすべてのパソコン・プロジェクトに効きます

~/.claude はホームフォルダの中の .claude フォルダ（Windows では %USERPROFILE%\.claude）、~/ の付かない .claude はプロジェクトのフォルダの中の .claude フォルダです。

ファイルはいつできるか

• Claude Code を入れただけでは、設定ファイルは1つもできません
• ユーザーのファイルは、/config でテーマのようなユーザー設定の項目を初めて変えたときに、Claude Code が作ります
• ローカルのファイルは、許可の確認で「Yes, and don't ask again」のような、続けて有効な許可を初めて出したときに作られ、その許可が allow のルールとして入ります。git のリポジトリの中で Claude Code が初めて書いたときに、git のコミットに入らないようにしておきます。自分の手で作ったときは、自分で .gitignore に足します
• 共有プロジェクトのファイルは、無ければ自分で作ります
• 別に ~/.claude.json というファイルもあります。サインインの状態などを Claude Code が自分で書くもので、手で直す必要はありません

どの値が使われるか

同じ項目が何か所かにあるときは、上の段ほど優先されます。

1. 管理設定
2. コマンドライン（起動のときに付けたもの。その会話だけ）
3. プロジェクトのローカル
4. 共有プロジェクト
5. ユーザー

• リストは足し合わせ：permissions.allow のようなリストの項目は、どれか1つを選ぶのでなく、各ファイルの分がまとめて使われます。モデルを並べる項目など、別の決まりを持つ項目もあります
• 環境変数は段の外：設定の項目と環境変数の組ごとに、どちらを使うかが決まっています。たとえば、シェルで決めた ANTHROPIC_MODEL は、どのファイルの model よりも優先されます
• 安全のための例外：いくつかの項目は、管理設定より下の段にある、より厳しい値のほうが使われます

設定の変え方

• /config：ターミナルの画面で /config と打ち、Config タブで選びます。並ぶのはテーマなど個人向けの一部の項目だけです。保存先の多くはユーザーのファイルで、Show tips など一部はローカルのファイルです。一部の全体の設定は ~/.claude.json に入ります。VS Code のチャット欄とデスクトップアプリでは開かないので、設定ファイルを直すか、それぞれのアプリの設定で変えます
• ファイルを直す：エディタで開いて項目を書きます。書き方は厳しく、// の書き込みや最後の項目のあとのカンマがあると、次の起動のときに Settings Error として知らされます
• その会話だけ変える：起動のときに --settings で渡す、--model のような項目ごとのフラグを付ける、組になった環境変数を先に決める、の3つがあります。設定ファイルは変わりません

多くの変更は、保存すると動いている会話にもそのまま効きます。ただし model や effortLevel のように、会話の始めに一度だけ読む項目もあり、途中で変えるときは /model や /effort を使います。

読み込まれたかを確かめる

• Claude Code の中で /status と打つと、Status タブの Setting sources の行に、読み込んだ設定ファイルが並びます。どの項目がどのファイルから来たかまでは出ません
• 対話の画面では、ファイルが壊れていると始めに知らされます。Settings Error はファイル全体の書き方か値が受け付けられないときで、Claude と直す・終える・壊れた設定を外して続ける、から選べます。Settings Warning は一部の項目だけがだめなときで、その項目だけを飛ばして残りは効きます
• はじかれた項目とエラーの詳しい中身は claude doctor で見られます

効かないときに見る所

• 上の段で決まっている：組織の管理設定が決めている値は、自分では戻せません。/status でどの管理設定が効いているかを見て、管理者に相談します
• そのファイルでは決められない値：たとえば permissions.defaultMode の auto と bypassPermissions は、共有プロジェクトとローカルのファイルでは効きません。ユーザーか管理設定に書くか、その会話だけ --permission-mode を付けます
• コミットしたのに仲間に効かない：共有のファイルでは効かない項目があります。また、permissions.allow のルールなどは、仲間それぞれがフォルダを信頼するまで効きません。deny と ask のルールはすぐ効きます
• 「Yes, and don't ask again」を選んだのにまた聞かれる：ローカルのファイルの allow は、共有プロジェクトや管理設定の ask より強くありません

クラウドセッションでは

• 共有プロジェクトのファイルは、リポジトリが1つの会話なら読まれます。リポジトリが複数の会話では、プラグインにかかわる2つの項目だけが読まれます
• ユーザーとローカルのファイルは読まれません
• 管理設定は、パソコンに置いたファイルなどは届かず、claude.ai の管理画面から配る分は、公式の一覧にある種類のクラウドセッションに届きます

公式が挙げている使いどころ

公式のページに書いてある向き・使い方だけを並べます。

• ユーザー：テーマ、標準のモデル、自分の許可のルールなど、自分の好み
• 共有プロジェクト：チームの許可、フック、プラグイン、プロジェクトに要る環境変数。コミットすると、クローンした全員が同じ許可・フック・プラグインで動けます
• ローカル：1つのプロジェクトだけの自分用の上書きと、仲間に配る前の試し。チームのファイルが決めた値を自分だけ変えたいときは、ここに書けば、ほかの人の会話は変わりません
• 管理設定：安全の方針や、組織として守る決まり
• 試すだけのとき：保存せずに試すなら、起動のときにその会話だけの値を渡します
• いつも渡しておきたい指示：設定ではなく、CLAUDE.md か --append-system-prompt を使います
• クラウドセッションの設定を変える：その環境に環境変数を決めるか、リポジトリが1つの会話なら共有プロジェクトのファイルにコミットします

あわせて読む

• モデル設定（Model configuration）：モデルの選び方と切り替え方
• 権限モード（Permission mode）：Claude に聞かずに進めさせる範囲と、切り替え方
• CLAUDE.md と自動メモリ（Auto memory）：プロジェクトの決まりごとを覚えさせる

公式のページ

• Settings files and precedence（英語・原文）code.claude.com ↗
• 設定ファイルと優先順位（公式の日本語版）code.claude.com ↗
• Glossary（用語集。上の「先に知っておく言葉」の言い換えに使いました）code.claude.com ↗

確認メモ：2026年10月1日に、公式の英語のページと日本語のページ、用語集を開いて、4つの置き場所と効く相手・優先の順番・変え方・確かめ方・クラウドセッションでの扱いを突き合わせました。公式のページに更新日の表示は無いため、この日付は「このサイトが確かめた日」です。公式のページは約4万字あり、組織の管理者向けの配り方、git のリポジトリの中でローカルのファイルが置かれる場所の細かい決まり（版ごとの違いを含む）、安全のための例外になる項目の一覧、モデルを並べる項目の細かい決まり、~/.claude.json が壊れたときの戻し方、設定の書き方の例は、このページには載せていません。「設定」「JSON」「リポジトリ・コミット」「環境変数」の言い換えは公式の用語集に無く、ふつうの意味を一言で添えたものです。用語集では、優先の順番は「Settings layers」として載っています。英語版と日本語版の内容に、大きな違いは見つかりませんでした。