設定ファイルと優先順位

​

設定ファイルと誰に影響するか

​

各設定ファイルのスコープを比較する

• ~/.claude/settings.json：自分のマシン上のすべてのプロジェクト。チームメイトのクローンやクラウドセッションには適用されません
• acme-app/.claude/settings.json：自分の acme-app/。バージョン管理にファイルをコミットした場合のみ、チームメイトのクローンとクラウドセッションに到達します。それまでは、ディスク上の他のファイルと同じ単なるファイルであり、他の誰も持っていません
• acme-app/.claude/settings.local.json：自分の acme-app/ のみ。Claude Code はファイルを初めて書き込むときに、グローバル git 除外に追加する���め、コミットから除外されます。手動でファイルを作成する場合は、自分で .gitignore に追加してください
• 管理設定。managed-settings.json ファイル、MDM ポリシー、または claude.ai コンソールからのサーバー管理設定：組織がデプロイするすべてのマシン、または組織アカウントでサインインするマシン上のすべてのプロジェクト。クラウドセッションに到達するのはサーバー管理設定のみです

​

設定ファイルを見つけるか作成する

• 管理：組織がデプロイします。自分で作成または編集することはありません。
• 共有プロジェクト：Claude Code を既に使用しているプロジェクトには、コミットされたものがあるかもしれません。ない場合は、プロジェクトフォルダに .claude/settings.json として作成してください。
• ユーザーおよびプロジェクトローカル：自分で作成するか、Claude Code に作成させます。テーマなど、ユーザー設定に保存される /config メニューのオプションを初めて変更するときに ~/.claude/settings.json を書き込み、Bash コマンドに対する「はい、今後は聞かないでください」など、権限プロンプトで恒久的な承認を初めて与えるときに .claude/settings.local.json を書き込みます。ヒントを表示を含むいくつかの /config オプションは、ユーザーファイルではなく .claude/settings.local.json に保存されます。

​

チームと設定を共有する

​

リポジトリから個人設定を除外する

• Claude Code もこのファイルに書き込みます。 Claude が Bash コマンドを実行する権限を求め、「はい、今後は聞かないでください」を選択すると、Claude Code はその権限の承認をここに allow ルールとして保存します。
• 手動で作成した場合を除き、自分で gitignore する必要はありません。 Claude Code が、まだこのファイルを無視していない git リポジトリでファイルを初めて書き込むときに、グローバル git 除外ファイルに **/.claude/settings.local.json を追加するため、ファイルはすべてのリポジトリでコミットから除外されます。そのファイルは、グローバル git 設定で core.excludesFile が絶対パスまたは ~ で始まるパスに設定されている場合はそのファイル、それ以外の場合は $XDG_CONFIG_HOME/git/ignore、XDG_CONFIG_HOME が設定されていない場合は ~/.config/git/ignore です。手動でファイルを作成し、Claude Code がまだそれに書き込んでいない場合は、自分で .gitignore に追加してください。
• ファイルが追跡されていない間、その許可ルールは信頼を待ちません。 ファイルはリポジトリのものではなく自分のものであるため、Claude Code はコミットされたファイルに必要なワークスペースの信頼ステップなしで、その allow ルールを適用します。ファイルが git で追跡されている場合は、信頼ステップがこのファイルにも適用されます。ローカル設定ファイルが信頼を必要とする場合を参照してください。

​

Claude Code が git リポジトリでローカルファイルを保持する場所

• ファイルが代わりに .claude/settings.json と同じ場所に置かれる場合：git リポジトリの外、リポジトリルートがホームディレクトリである場合、Windows の場合、またはリポジトリルートやその .git または .claude エントリの所有者が自分のユーザーでない場合。
• ファイル内のパスはリポジトリルートを基準にしません：/ で始まる権限ルールや相対サンドボックスパスは、代わりにセッションのプライマリ作業ディレクトリを基準にします。

​

組織が強制する内容を確認する

• サーバー管理設定。Claude Code が claude.ai 管理コンソールまたはセルフホストの Claude apps gateway から取得します
• MDM または OS レベルのポリシー、およびシステムディレクトリ内の managed-settings.json ファイル
• Claude Desktop などの埋め込みホスト。SDK の managedSettings オプションを通じて配信されます。埋め込みホストからポリシーを制御するを参照してください

​

設定を変更する

​

/config メニューを使用する

• ほとんどのオプション：~/.claude/settings.json
• ヒントを表示などのいくつかのオプション：.claude/settings.local.json
• グローバル構成オプション：~/.claude.json

​

設定ファイルを編集する

{
  "$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 つのセッションの設定を変更する

• --settings：JSON としてキーを渡します。インラインまたはファイルへのパス。Claude Code はそれをユーザー、プロジェクト、およびローカルファイルの上に適用し、管理設定の下に適用します。ユーザー設定ファイルが設定できるキーを設定できます。Managed または Global config キーを設定することはできません。
• そのキーのフラグ：いくつかのキーには独自のフラグがあります。model の --model や effortLevel と modelSettings の --effort など。
• 環境変数：model の ANTHROPIC_MODEL など、キーのペアリングされた変数をエクスポートしてから claude を実行してください。

claude --settings '{"model": "claude-opus-5-5"}'

​

編集がいつ有効になるか

• model：セッション中に切り替えるには /model を使用してください。各モデルには独自のプロンプトキャッシュがあるため、切り替え後の最初のリクエストは会話全体をキャッシュなしで再読み込みします。モデルを切り替えるを参照してください
• effortLevel および modelSettings：セッション中に努力を変更するには /effort を使用してください

​

読み込まれたものを確認する

​

壊れた設定ファイルを修正する

• 設定エラー：ユーザー、プロジェクト、またはローカルファイルに無効な JSON またはスキーマが拒否する値があります。インタラクティブセッションの開始時に Claude Code はダイアログを表示し、Claude の助けでファイルを修正するか、終了するか、壊れた設定なしで続行できます。
• 設定警告：個別のエントリのみが失敗します。不正な形式の権限ルールまたは不明な hook イベント名など。Claude Code はそれらの値をスキップし、ファイルの残りを有効に保ちます。
• 管理設定：Claude Code はファイルの残りを強制し続けます。管理設定の無効なエントリは、それが削除するものと、修正するまでどのキーがより厳密な値にフォールバックするかを説明します。有効な JSON ではない管理設定ドキュメントについては、管理設定ドキュメントを解析できませんでしたを参照してください。
• 構成エラー：~/.claude.json を解析できません。Claude Code は壊れたファイルを ~/.claude/backups/.claude.json.corrupted.<timestamp> にコピーし、終了して手動で修正するか、デフォルト構成にリセットするかを尋ねます。-p 実行はエラーを出力して終了します。以前の状態を復旧するには、~/.claude/backups/ の 5 つの最新 .claude.json.backup.<timestamp> ファイルの 1 つをコピーして戻してください。Claude Code はファイルを書き込む前に保存します。

​

設定の優先順位

1. 管理設定: 組織が managed-settings.json ファイル、MDM ポリシー、または claude.ai コンソールからのサーバー管理設定によって配布する設定です。自分の設定ファイルや --settings のどれも管理対象のキーを上書きすることはできず、--model などのフラグは組織が許可しているモデルの中からしか選択できません。管理設定の model は初期のデフォルトであり、固定するものではありません。固定するのは availableModels と deniedModels です。組織が複数の管理ソースを配布している場合、Claude Code がそれぞれから何を読み取るかは管理ティア内の優先順位のルールで決まります。
2. コマンドライン: claude の起動時に --settings <file-or-json> で渡す JSON で、そのセッションにのみ適用されます。1 つのセッションだけ設定を変更するを参照してください。ここで設定したキーはプロジェクトおよびユーザーの設定ファイルにある同じキーを上書きし、指定しなかったキーはそれらのファイルの値を維持します。--model などのその他のフラグは、セッションに対して 1 つの項目を設定するもので、このスタックには含まれません。どのフラグがキーを上書きするかは、設定リファレンスの各キーの項目に記載されています。
3. プロジェクトのローカル設定（.claude/settings.local.json）: このプロジェクトにおける個人用の設定です。
4. 共有プロジェクト設定（.claude/settings.json）: チームがソース管理にチェックインする設定です。
5. ユーザー設定（~/.claude/settings.json）: すべてのプロジェクトに適用される個人用の設定です。

​

リストは上書きではなくマージされる

• fallbackModel は位置に意味がある順序付きのチェーンであるため、Claude Code はそれを定義している最も優先順位の高いファイルから値全体を取得します。
• modelPicker は順序付きの行のリスト 1 つと置換フラグを保持するため、Claude Code は 2 つのソースの行をマージすることはありません。管理設定、--settings、ユーザー設定のうち、それを定義している最も上位のものから値全体を取得し、プロジェクト設定とローカル設定にあるこのキーは無視します。Claude Code v2.1.242 以降が必要です。
• availableModels: Claude Code が適用する管理設定でこれが定義されている場合、Claude Code はそのリストをそのまま適用し、ユーザー設定、プロジェクト設定、ローカル設定で追加したエントリを無視します。ただし、Claude Code を組み込んだアプリが独自のモデルリストを提供している場合は除きます。管理設定の優先順位の例外を参照してください。管理ソース間でもこのリストがマージされることはありません。どのソースのリストが適用されるかは、Claude Code が管理ソースを組み合わせる方法に記載されています。管理対象外のスコープ間では、Claude Code は通常どおり配列をマージします。
• modelSettings: Claude Code はこれを effortLevel と合わせて、モデルごとに解決します。どのファイルの値がモデルに適用されるかは、modelSettings の項目に記載されています。

​

優先順位の例

​

チームの設定が個人の設定を上書きする

​

組織の設定がすべてを上書きする

​

コマンドラインが 1 つのセッションに限りファイルを上書きする

​

フラグまたは環境変数が同じ項目を設定する

​

適用されない設定のトラブルシューティング

​

設定した値が無視される

• 上位のレベルが設定している。 別の設定ファイル、--settings フラグ、または管理��ースが、自分の設定より上位でそのキーを設定しています。どれが該当するかはスタックで確認できます。フラグや環境変数もそれ単独でキーを上書きすることがあり、これはキーごとに決まります。Claude Code がどちらを使用するかは設定リファレンスのキーの項目に記載されており、管理設定の env の値とシェルでのエクスポートの関係については env の項目で説明しています。
• セキュリティ関連のキーが厳格な値を維持している。 いくつかのキーについては、Claude Code はどのファイルからの制限的な値も尊重するため、disableClaudeAiConnectors をプロジェクトで true にするとオンのままになります。管理設定の優先順位の例外を参照してください。
• ファイルがその値を設定できない。 permissions.defaultMode の値 auto と bypassPermissions は、プロジェクト設定やローカル設定からは有効になりません。代わりにユーザー設定または管理設定で設定するか、1 つのセッションに限り --permission-mode を渡してください。v2.1.257 より前は、bypassPermissions はどのファイルからでも有効になっていました。 env ブロック内のテレメトリエクスポート変数も、いくつかのオフの値を除き、プロジェクト設定やローカル設定からは有効になりません。該当する変数とそれらの値は、Claude Code が env で無視する変数に一覧があります。
• ファイルが壊れている。 無効な JSON や拒否された値があると、Claude Code はそのファイルまたはエントリをスキップします。壊れた設定ファイルを修正するを参照してください。

​

Claude Code 内で行った変更が新しいセッションで失われる

​

管理設定の変更が反映されない

​

コミットしたキーがチームメイトに反映されない

• Claude Code がリポジトリファイル内のそのキーを無視している。 設定インデックスの Scope 列で、User, local, or managed、User or managed、User、Managed、または Global config を探してください。これらのキーは共有ファイルからは決して適用されません。ただし、リポジトリファイルからでもオフにできるいくつかのキーは例外で、それらの項目の Scope 行にその旨が記載されています。Global config のキーは ~/.claude.json からのみ適用されます。 env キー内でも、テレメトリエクスポート変数は、いくつかのオフの値を除き、共有ファイルからは決して適用されません。Claude Code が env で無視する変数を参照してください。
• キーが信頼を待っている。 permissions.allow ルール、permissions.additionalDirectories、extraKnownMarketplaces、およびほとんどの env の値は、各チームメイトがフォルダーを信頼した後にのみ適用されます。それまでは、チームメイトには引き続きプロンプトが表示され、ファイルで宣言されたマーケットプレイスからプラグインを取得することもありません。deny ルールと ask ルールはすぐに適用されます。

​

権限ルールが想定と異なる方法で組み合わされる

• 権限プロンプトで「Yes, and don’t ask again」を選んだのに、同じツールについて引き続きプロンプトが表示される。 その選択によって許可ルールがローカルファイルに保存されますが、そこにある allow ルールはプロジェクトファイルや管理ファイルからの ask ルールより優先されることはありません。順序については権限ルールの組み合わせ方で説明しています。VS Code 拡張機能では、承認カードで保存先のファイルを選択でき、プロジェクトの共有ファイルも選べますが、その場合はすべての人に対してルールが変わります。CLI では、Claude Code はローカルファイルにのみ書き込みます。
• 組織の許可ルールが自分のルールと並んで引き続き適用される。 これは想定どおりの動作です。組織が allowManagedPermissionRulesOnly を設定していない限り、Claude Code は permissions.allow をスコープ間でマージします。

​

管理設定の優先順位の例外

​

クラウドセッションの設定

• プロジェクト内のクラウドスレッド：プロジェクト内のクラウドスレッドでは、プロジェクトに含まれるリポジトリの数にかかわらず、リポジトリの .claude/settings.json の権限ルール、フック、env はいずれも適用されません。代わりに使用するものについては、スレッドがリポジトリから取り込むものに記載されています。
• 共有プロジェクト設定（.claude/settings.json）：プロジェクトのスレッド外の 1 つのリポジトリを持つセッションで読み込まれます。ファイルはクローンの一部であり、セッションはその内部で開始されるためです。その設定をコミットして、それらのセッションに適用してください。
• 複数のリポジトリを持つ共有プロジェクト設定：Anthropic がホストする環境では、複数のリポジトリを持つセッションはクローンの上で開始され、各リポジトリの .claude/settings.json から enabledPlugins と extraKnownMarketplaces キーのみを読み込み、権限ルール、フック、env、またはその他のキーは読み込みません。これら 2 つのキーが宣言するマーケットプレイスとプラグインは、それでもクラウドセッションでは読み込まれません。自己ホスト型環境については、ど��リポジトリの設定が適用されるかを参照してください。
• ユーザーおよびプロジェクトローカル設定（~/.claude/settings.json および .claude/settings.local.json）：読み込まれません。両方ともマシンに留まり、ローカルファイルはクローンにありません。
• 管理設定：デバイスの managed-settings.json ファイルまたは MDM プロファイルはクラウドセッションに到達しません。組織のサーバー管理設定は到達します。サーフェスカバレッジはどのクラウドセッションがそれらを受け取るかをリストします。自己ホスト型環境もランナーイメージの管理設定ファイルを読み込みます。Claude Code が管理ソースを結合する方法はそのファイルがいつ適用されるかを説明します。
• /config：ブラウザの claude.ai/code では、値を変更する代わりに claude.ai の Code または Claude Code 設定ページを開きます。クラウドセッションの設定を変更するには、環境で環境変数を設定してください。プロジェクトのスレッド外の 1 つのリポジトリを持つセッションでは、代わりにそのリポジトリの .claude/settings.json にキーをコミットすることもできます。

​

次は何か

• すべての設定：すべてのキー。設定する場所と例
• 設定ファイルの例：個人ファイル、チームファイル、および組織の管理ファイル
• 権限を構成する：allow、ask、および deny ルール。Claude Code が確認なしで実行するもの
• 環境変数：Claude Code が読み込む変数および env ブロック
• 構成をデバッグする：設定が適用されない場合
• Claude ディレクトリリファレンス：Claude Code が読み込むすべてのファイル。subagents、MCP サーバー、プラグイン、および CLAUDE.md を含む