設定ファイルと優先順位

​

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

​

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

• ~/.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 除外ファイルに **/.claude/settings.local.json を追加するため、ファイルはすべてのリポジトリのコミットから除外されます。そのファイルは、グローバル git 構成がそれを絶対パスまたは ~ プレフィックス付きパスに設定する場合は core.excludesFile。それ以外の場合は $XDG_CONFIG_HOME/git/ignore、または XDG_CONFIG_HOME が設定されていない場合は ~/.config/git/ignore。手動でファイルを作成し、Claude Code がまだそれに書き込んでいない場合は、自分で .gitignore に追加してください。
• ファイルが追跡されていない間、その allow ルールは信頼を待ちません。 ファイルはリポジトリのものではなくあなたのものであるため、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 は各セッションが開始するモデルを設定し、/model で切り替えることはできます。ロックは availableModels で、これは /model、--model、および独自ファイルの model キーを制限します。組織が複数の管理ソースを提供する場合、管理層内の優先順位 のルールが Claude Code が各ソースから読み込むものを指定します。
2. コマンドライン引数：ターミナルから claude を開始するときに渡すフラグで、1 つのセッション用です。1 つのセッションの設定を変更する を参照してください。Claude Code は --settings <file-or-json> で渡す JSON を他のレベルと同じルールで設定ファイルとマージします。ここで設定したキーはローカル、プロジェクト、またはユーザー設定の同じキーより優先され、省略したキーについては下位レベルの値を保持します。
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 と一緒に一度に 1 つのモデルで解決します。modelSettings エントリはどのファイルの値がモデルに適用されるかを示しています。

​

優先順位の例

​

チーム設定が個人設定をオーバーライドします

​

組織設定がすべてをオーバーライドします

​

コマンドラインが 1 つのセッションのファイルをオーバーライドします

​

フラグまたは環境変数が同じものを設定します

​

適用されない設定をトラブルシューティングします

​

設定した値が無視されます

• より高いレベルがそれを設定しています。 別の設定ファイル、--settings フラグ、または管理ソースがキーをあなたのより上に設定しています。スタック はどちらを示しています。フラグまたは環境変数もキーごとに決定されて、キーをそれ自体でオーバーライドできます。設定リファレンス のキーのエントリはどちらを Claude Code が使用するかを示し、env エントリ は管理 env 値対シェルエクスポートをカバーしています。
• セキュリティキーは厳密な値を保持しています。 いくつかのキーについて Claude Code は任意のファイルからの制限値を優先するため、プロジェクト true は disableClaudeAiConnectors のままです。管理設定の優先順位の例外 を参照してください。
• ファイルはその値を設定できません。 permissions.defaultMode の値 auto および bypassPermissions はプロジェクトまたはローカル設定から有効になりません。代わりにユーザーまたは管理設定で設定するか、1 つのセッション用に --permission-mode を渡してください。v2.1.257 より前では、bypassPermissions はどのファイルからでも有効になりました。 env ブロック内のテレメトリエクスポート変数もプロジェクトまたはローカル設定からは有効になりません。いくつかのオフ値を除きます。Claude Code が env で無視する変数 は変数とそれらの値をリストしています。
• ファイルが壊れています。 無効な JSON または拒否された値により、Claude Code はファイルまたはエントリをスキップします。壊れた設定ファイルを修正する を参照してください。

​

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

​

管理変更があなたに到達していません

​

コミットされたキーがチームメイトに到達しません

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

​

権限ルールが予想と異なる方法で結合されます

• 権限プロンプトで「はい、今後は聞かないでください」を選択しましたが、同じツールのプロンプトが表示されます。 その選択はローカルファイルに allow ルールを保存し、そこの allow ルールはプロジェクトまたは管理ファイルからの ask ルールより優先されません。権限ルールがどのように結合されるか は順序を説明しています。VS Code 拡張機能では、承認カードはプロジェクトの共有ファイルを含む宛先ファイルを選択できます。これはすべての人のルールを変更します。CLI では、Claude Code はローカルファイルにのみ書き込みます。
• 組織の許可ルールはあなたのルールと一緒に適用されます。 これは予想されています。Claude Code は permissions.allow をスコープ全体でマージします。ただし、組織が allowManagedPermissionRulesOnly を設定していない限り。

​

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

​

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

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

​

次は何か

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