楽天ブラックフライデー開催中!セール会場へ

Claude Code│settings.jsonの場所と優先順位|ユーザー・プロジェクト・ローカルの違い

Claude Code の settings.json は、自分用が %USERPROFILE%\.claude\settings.json(Mac・Linux は ~/.claude/settings.json)、プロジェクト用がプロジェクトの .claude/settings.json です。

そのプロジェクトで自分だけに効かせる設定は、同じ .claude フォルダの settings.local.json に書きます。

Claude Code を入れただけでは settings.json は作られないので、無ければ自分で作ります。

  • 自分の全プロジェクトの設定:ホームフォルダの .claude/settings.json
  • チームで共有する設定:プロジェクトの .claude/settings.json
  • このプロジェクトの自分だけの設定:プロジェクトの .claude/settings.local.json
  • 強い順:組織の管理設定 → 起動時の --settings → settings.local.json → プロジェクトの settings.json → ユーザーの settings.json

Windows・Mac・Linux ごとのパスと、組織が配る管理設定の置き場所は、次の節の表にまとめました。

2026年11月19日に公式資料(日本語版)と照合し、同じ日にこのPC(Windows 11 Pro)のフォルダを確かめました。

優先順位の実行結果は9月29日のv2.1.284、既存画像は10月17日の記録で、今回は実機で再検証していません。

目次

settings.jsonの場所

種類場所効く範囲
ユーザーホームフォルダの .claude/settings.json自分の全プロジェクト
プロジェクト(共有)プロジェクトの .claude/settings.jsonそのプロジェクトの全員(Gitに入れる)
ローカルプロジェクトの .claude/settings.local.jsonそのプロジェクトの自分だけ(Gitに入れない)
組織の管理managed-settings.json・MDM・claude.aiの管理画面組織が配ったPCやアカウント全部
Claude Code公式ドキュメント「設定ファイルと優先順位」をもとに作成(2026年11月19日確認)

Windows・Mac・Linuxのパス

Windows では、ホームフォルダの .claude は %USERPROFILE%\.claude のことです。

ファイルWindowsMac・Linux
ユーザー設定%USERPROFILE%\.claude\settings.json~/.claude/settings.json
.claude.json%USERPROFILE%\.claude.json~/.claude.json
管理設定C:\Program Files\ClaudeCode\managed-settings.jsonMac:/Library/Application Support/ClaudeCode/managed-settings.json
Linux・WSL:/etc/claude-code/managed-settings.json
公式ドキュメント「設定ファイルと優先順位」「マネージド設定をデプロイする」をもとに作成(2026年11月19日確認)

管理設定のフォルダには、設定を分けて置く managed-settings.d フォルダも置けます。

Windows の古い置き場所 C:\ProgramData\ClaudeCode\managed-settings.json は、今の Claude Code では読まれません。

レジストリで配るときは、HKLM\SOFTWARE\Policies\ClaudeCode の Settings という値に JSON を入れます(公式のマネージド設定のページ、2026年11月19日確認)。

個人で使っているこのPCには、C:\Program Files\ClaudeCode フォルダがありませんでした。

管理設定は、組織が配ったPCにだけあるファイルです。

環境変数CLAUDE_CONFIG_DIRを設定している場合は、ユーザー設定・セッション履歴・プラグインなどの保存先がそのディレクトリに変わります。

見つからないときの開き方と作り方

エクスプローラーのアドレスバーに %USERPROFILE%\.claude と入れると、ユーザー設定のフォルダが開きます。

このPCでは .claude フォルダにも .claude.json にも隠し属性は付いておらず、エクスプローラーでそのまま見えました。

Claude Codeを入れただけでは、settings.json はどこにも作られません。

/configでテーマなどを初めて変えると、ユーザーの settings.json が作られます。

権限の確認で「はい、今後は聞かないでください」を選ぶと、プロジェクトの settings.local.json が作られます。

/configの「ヒントを表示」など一部の項目も、ユーザー設定ではなく settings.local.json に保存されます。

自分で作るときは、.claude フォルダに settings.json という名前のファイルを作り、中身を {} から書き始めます。

Claude Code が settings.local.json を自分で作ったときは、Git 全体の除外設定に **/.claude/settings.local.json が足されます。

手で作ったsettings.local.jsonは.gitignoreへ追加してください。

エクスプローラーで開いた練習用プロジェクトの.claudeフォルダ。settings.jsonとsettings.local.jsonが並んでいる
2026-10-17 19:49(日本時間)撮影。エクスプローラー、Windows 11 Pro (10.0.26200)。練習用の practice-project フォルダの .claude を開いたところ。練習用フォルダを一時的なドライブ(R:)に割り当てて開いています。

画像は、練習用に作った practice-project フォルダの .claude を、エクスプローラーで開いたところです。

settings.json と settings.local.json は同じフォルダに入り、名前の違いでプロジェクト用とローカル用を分けます。

Mac・Linux で Git リポジトリの下のフォルダから起動すると、settings.local.json はリポジトリの一番上の .claude フォルダに保存されます。

Windows では、共有の settings.json と同じ .claude フォルダに保存されます。

共有設定は起動場所にも依存するため、読み込まれたファイルは/statusで確認してください。

~/.claude.jsonは別物

ホームフォルダには、.claude.json という似た名前のファイルもあります。

.claude フォルダの中ではなく、その隣に置かれ、Windows では %USERPROFILE%\.claude.json です。

中身はアカウントの情報、フォルダを信頼したかどうか、自分だけで使うMCPサーバー、画面の切り替え設定などです。

Claude Codeが自分で書くファイルなので、手で直す必要はありません。

壊れて読めなくなったときは、~/.claude/backups に残る以前のコピーから戻せます。

MCPサーバーの登録は、Claude CodeのMCPサーバーの追加方法で説明しています。

%USERPROFILE%\.claudeフォルダの中身

ホームフォルダの .claude には、settings.json のほかに、Claude Code が使うファイルがまとまっています。

名前入っているもの
settings.jsonユーザー設定
CLAUDE.md全プロジェクトで読む指示
projects会話の記録(.jsonl)と、プロジェクトごとの自動メモリ
skills・agents・commands自分用のスキル・サブエージェント・コマンド
plugins入れたプラグイン
backups.claude.json の以前のコピー
公式ドキュメント「.claude ディレクトリを探索する」をもとに作成(2026年11月19日確認)

projects フォルダの中は、作業フォルダのパスの記号を – に置き換えた名前のフォルダに分かれています。

このPCでは、C:\Users\(ユーザー名)で起動したときの記録が、C--Users-(ユーザー名)というフォルダに入っていました。

会話の記録は、既定では30日より古いものが消え、日数は settings.json の cleanupPeriodDays で変えられます。

記録は暗号化されていない文字のファイルなので、読み込んだファイルの中身もそのまま残ります。

公式資料では、~/.claude.json・~/.claude/settings.json・~/.claude/plugins は削除しないよう案内されています(公式の .claude ディレクトリのページ、2026年11月19日確認)。

履歴やメモリを消したいときの手順は、Claude Codeの消し方まとめで紹介しています。

スポンサーリンク

あなたはどっち?どのファイルに書くかの判定フロー

設定を書く場所に迷ったときは、誰に効かせたいかで選びます。

  1. 自分の全プロジェクトに効かせたい:ホームフォルダの .claude/settings.json に書きます。
  2. そのプロジェクトの全員に効かせたい:プロジェクトの .claude/settings.json に書き、Gitに入れます。
  3. そのプロジェクトで自分だけの例外にしたい:プロジェクトの .claude/settings.local.json に書きます。Gitには入れません。
  4. その回だけ設定を変えたい:起動時の --settings で渡します。ファイルは書き換わりません。
  5. 組織として全員に強制したい:managed-settings.json・MDM・claude.aiの管理画面で配ります。これがいちばん優先されます。

単一値の項目は通常、優先順位の高い設定を使いますが、リストの結合や項目ごとの例外があります。

強い順は、組織の管理設定、起動時の --settings、settings.local.json、プロジェクトの settings.json、ユーザーの settings.json です。

優先順位を実際に確かめた

練習用のフォルダで、同じ環境変数 DEMO_LEVEL を2つのファイルに書き、どちらが使われるかを見ました。

// .claude/settings.json(プロジェクト)
{
  "env": { "DEMO_LEVEL": "project" },
  "permissions": { "allow": ["Bash(echo *)"] }
}

// .claude/settings.local.json(ローカル)
{
  "env": { "DEMO_LEVEL": "local" }
}

設定ファイルにはコメントを書けないので、上の // の行は説明のために付けています。

実際のファイルには // の行を入れず、1つのファイルに1つのJSONだけを書きます。

メモ帳で開いた練習用のプロジェクトのsettings.json。envのDEMO_LEVELがprojectで、permissionsのallowにBash(echo *)がある
2026-10-17 19:52(日本時間)撮影。メモ帳 11.2607.14.0、Windows 11 Pro (10.0.26200)。練習用のプロジェクトの .claude/settings.json(表示倍率150%)。メモ帳のフォントの都合で " が斜めに見えますが、ファイルの中身は半角の " です。ほかのタブの名前は塗りつぶしています。
メモ帳で開いた練習用のsettings.local.json。envのDEMO_LEVELがlocal
2026-10-17 19:53(日本時間)撮影。メモ帳 11.2607.14.0、Windows 11 Pro (10.0.26200)。同じ .claude フォルダの settings.local.json。同じ DEMO_LEVEL を local にしている。ほかのタブの名前は塗りつぶしています。

2026年10月17日の撮影では、練習用のファイルを作ってメモ帳で開いただけで、Claude Code は起動していません。

下の表の結果は、この記事を書いたときに Claude Code v2.1.284 で試したもので、撮影時点の版(2.1.289)では確かめ直していません。

試したことecho $DEMO_LEVEL の結果
プロジェクトとローカルの両方に書いたlocal
さらに起動時に --settings で cli を渡したcli
ローカルのファイルを消したproject

ローカルがプロジェクトに勝ち、起動時の --settings がさらにローカルに勝っています。

claude --settings '{"env":{"DEMO_LEVEL":"cli"}}'

--settings はその回だけの設定で、ファイルは書き換わりません。

組織の管理設定が最優先ですが、一部の項目では下位の設定にある制限の強い値が優先されます。

例えば disableClaudeAiConnectors は、管理設定が false でも、他の設定で true にするとその制限が適用されます(公式の管理設定の例外、2026年11月19日確認)。

2026年11月19日の時点で、この例外の表には13個の項目が載っています。

リストの設定は足し合わされる

permissions.allow のようなリストの項目は、通常、複数の設定ファイルの中身がまとめられます。

ただし fallbackModel と modelPicker は上位の設定の値を使い、availableModels と modelSettings もそれぞれ固有の規則で処理されます(公式のリスト結合と例外、2026年11月19日確認)。

チームの settings.json で許可したコマンドに、自分の settings.local.json で許可を追加する、といった使い方ができます。

単一値は通常上位の設定を使います。

ただしmodelは初期値と選択制限が別で、専用フラグや環境変数の規則も確認します。

シェルで設定した環境変数と設定項目の優先関係は、項目ごとに決まっています。

例えばシェルで ANTHROPIC_MODEL を設定すると、どのファイルの model よりも優先されます。

一方、settings.json 内の env は設定ファイルの一項目として、通常の設定の優先順位に従います(公式の設定の優先順位、2026年11月19日確認)。

環境変数の書き方は、Claude Codeの環境変数の一覧にまとめています。

よく使う設定項目

項目決めること
permissions使ってよいコマンドや読んではいけないファイル(allow・ask・deny)
envClaude Codeが使う環境変数
model使うモデル
hooks決まったタイミングで動かすコマンド
statusLine画面下の表示
cleanupPeriodDays会話の記録を残す日数
attributionコミットやプルリクエストに付ける署名
autoMemoryEnabled自動メモリのオンとオフ
claudeMdExcludes読み込まない CLAUDE.md

書き方の例です。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

1行目の $schema を書いておくと、VS Codeなどで項目名の補完と入力チェックが効きます。

ただしスキーマの更新は新しい版より遅れることがあるので、新しい項目に警告が出ても間違いとは限りません。

allow・ask・deny のルールの書き方は、Claude Codeの権限設定の使い方で説明しています。

JSONエラーと個別項目の警告を区別する

settings.json は厳密なJSONなので、コメントや末尾のカンマは書けません。

試しにプロジェクトの settings.json の末尾にカンマを付けたところ、そのファイルの設定がすべて効かなくなりました。

{
  "env": { "DEMO_LEVEL": "project", },
}
出力は空でした(`DEMO_LEVEL` は未設定です)。

不正なJSONなどはSettings Errorになります。

一方、不正な権限ルールなど個別項目のSettings Warningでは、その項目だけが除外され、残りは有効です。

管理設定には別の扱いがあります。

当時のclaude -pでは対話ダイアログは出ませんでした。

現在も非対話実行ではダイアログは出ないため、設定が反映されないときはclaude doctorで除外された内容を調べてください。

設定が効かないときの確かめ方

  1. 対話中に /status を実行し、Setting sources の行に目的のファイルが出ているかを見る
  2. JSONの書き間違い(コメント・末尾のカンマ)がないかを見る
  3. 同じ項目を上の順位のファイルで決めていないかを見る
  4. 組織の管理設定で決められていないかを見る

/statusは読み込んだ設定元を表示し、個々のキーの採用元までは示しません。

/configには全キーが並ぶわけではありません。

また--settingsで指定できるのはユーザー設定で扱えるキーで、管理専用・Global configのキーは対象外です。

/config verbose=true のように、項目と値を直接書いて変えることもできます。

設定ファイルの変更は多くの場合、そのセッションにも再読み込みされ、permissionsやhooksも対象です。

一方、modelやeffortLevelなどはファイルを書き換えるだけでは実行中のセッションへ反映されないため、途中で変えるときは/modelや/effortを使います。

変更が新しいセッションで消える場合は、一時指定だったか、上位の設定があるかに加えて、保存先のユーザー設定ファイルへ書き込めるかも確認してください。

/config はターミナルの画面だけの機能で、VS Codeの拡張機能やデスクトップアプリでは開けません。

書くファイルが合っていても、項目自体がそのスコープに対応していなければ適用されません。

例えばpermissions.defaultModeのautoとbypassPermissionsは、プロジェクト共有・ローカル設定からは有効になりません。

必要な権限を検討したうえで、公式設定一覧のScope欄と、その項目を設定できる場所を確認してください。

共有ファイルのpermissions.allowや多くのenv値などは、利用者がフォルダーを信頼するまで適用されない一方、denyとaskはすぐに適用されます。

ローカルへallowを追加しても別の設定のaskを打ち消せないため、継続的に許可したのに確認が出る場合はaskルールも調べてください。

CLAUDE.mdとの使い分け

settings.json の権限ルールは、対象のツールやパスに一致した操作を制御します。

ただし、Readの拒否ルールだけで、すべての経路からのファイル読み取りを防げるわけではありません。

CLAUDE.md に書いたことは、指示として読まれるだけで、守られないこともあります。

この権限の適用範囲は2026年10月14日に公式資料で確認したもので、本記事のv2.1.284での設定優先順位の実測とは別です。

間接的な読み取りを含む拒否動作は、今回実機では検証していません。

ツールの許可・確認・拒否は settings.json に、書き方の好みは CLAUDE.md に書きます。

公式のRead/Edit仕様では、組み込みのファイル操作や認識可能なシェルのファイル操作にルールを適用する一方、PythonやNodeなどの子プロセスが間接的に読む場合などは対象外とされています。

OSレベルのアクセス制限が必要な場合は、利用環境に対応したサンドボックスとファイル権限も確認してください。

CLAUDE.md の置き場所と読み込まれる順番は、Claude CodeのCLAUDE.mdの書き方と置き場所で紹介しています。

よくある質問:settings.jsonで迷ったときのチェックリスト

settings.jsonが見つからないのはなぜですか?

Claude Codeを入れただけでは作られないためです。

/configの変更や権限の承認で作られるのを待つか、自分で .claude フォルダに作ります。

~/.claude.jsonとは別のファイルですか?

別物です。

.claude.json はClaude Codeが状態を書き込むファイルで、自分で決める設定は settings.json に書きます。

%USERPROFILE%\.claude\projectsには何が入っていますか?

作業フォルダごとの会話の記録と、自動メモリが入っています。

過去のセッションの再開に使われるので、消すとその会話は続けられなくなります。

settings.jsonにコメントを書いてもよいですか?

書けません。

コメントや末尾のカンマはJSONの構文エラーになり、そのファイルの設定が効かなくなります。

claude doctorで内容を確認してください。

permissions.allowのようなリストは、上書きされますか?

通常は上書きされず、複数の設定ファイルの中身がまとめられます。

ただし fallbackModel と modelPicker は上位の設定の値を使うなど、一部に例外があります。

スポンサーリンク

まとめ

  • 自分用は %USERPROFILE%\.claude\settings.json(Mac・Linux は ~/.claude/settings.json)、チーム用はプロジェクトの .claude/settings.json
  • 自分だけの例外は .claude/settings.local.json に書く
  • 組織の管理設定は Windows なら C:\Program Files\ClaudeCode にある
  • 強い順は、組織 → --settings → ローカル → プロジェクト → ユーザー
  • リストは通常まとめられ、値が1つの項目は強いほうが使われる(モデル選択など一部に例外あり)
  • JSONエラーと個別警告を分け、/statusとclaude doctorで確かめる

次は、権限設定で確認の回数を減らすか、CLAUDE.mdに作業の決まりを書くと、settings.json と役割を分けられます。

参考:Claude Code公式ドキュメント「設定ファイルと優先順位」「.claude ディレクトリを探索する」「マネージド設定をデプロイする」(2026年11月19日に確認)。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

須澤 元貴のアバター 須澤 元貴 代表社員

MOTOKI合同会社 代表社員。
アニメ・映像業界とゲーム業界で、2D・UI・3D・アニメーション制作、映像編集、ツール制作に携わってきました。
現在はWordPressを中心にWebサイトの制作とカスタマイズを手がけています。
著書に『Unity デザイナーズ・バイブル』『Unityゲーム プログラミング・バイブル 2nd Generation』(ボーンデジタル)。
岡山県出身、埼玉県在住。

次に学ぶ・作業環境を選ぶ

学習を続けたい方や、作業環境を整えたい方は、目的に合うガイドをご覧ください。

生成AIのおすすめ書籍

周辺機器の優先度

目次