すべての設定

​

設定インデックス

​

モデルと応答

​

advisorModel

• スコープ: Any file
• 型: 文字列。エイリアス "fable"、"opus"、"sonnet" のいずれか（Claude Code におけるそのモデルファミリーの現在のデフォルトバージョンに解決されます）、または "claude-opus-5-5" のような完全なモデル ID
• デフォルト: 未設定。advisor はオフです
• セッションごとの上書き: --advisor は、1 つのセッションに限りこのキーよりも優先されます。CLAUDE_CODE_DISABLE_ADVISOR_TOOL は advisor をオフにし、このキーで再びオンにすることはできません

{
  "advisorModel": "opus"
}

​

alwaysThinkingEnabled

• スコープ: Any file
• 型: Boolean
  • true: 効果なし。思考はすでにオンです
  • false: Claude Code はすべてのセッションで拡張思考をオフにします
• デフォルト: 未設定。思考をサポートするモデルでは思考がオンになります
• セッションごとの上書き: MAX_THINKING_TOKENS は、1 つのセッションに限りこのキーよりも優先されます。0 は false と同じモデルおよびプロバイダーの制限のもとで思考をオフにし、正の値はこのキーが false の場合でも思考をオンにします。適応型推論モデルでは、数値そのものは無視されます

{
  "alwaysThinkingEnabled": false
}

​

availableModels

• スコープ: Any file。組織全体に適用するには、管理設定でデプロイします。
• 型: モデルのエイリアスまたは ID の配列
• デフォルト: 未設定。すべてのモデルが利用可能です

{
  "availableModels": ["sonnet", "haiku"]
}

​

availableModelsMatch

• スコープ: Managed。Claude Code は、ユーザー設定、プロジェクト設定、ローカル設定、および --settings 内のこのキーを警告付きで無視します
• 型: 文字列。次のいずれか:
  • "prefix": モデル ID のエントリは、そのバージョンと、別のセグメントでそれを拡張するすべてのモデル ID を許可します
  • "exact": モデル ID のエントリは指定したバージョンのみを許可するため、"claude-opus-5" は Opus 5 を許可しますが、claude-opus-5-5 は許可しません。"claude-opus-4-5" のようなエントリは、日付付きの Anthropic モデル ID claude-opus-4-5-20251101 も許可します。"opus" のようなファミリーエイリアスは引き続きファミリー全体を許可し、best、opusplan、default のエントリは無視されます
• デフォルト: "prefix"

{
  "availableModels": ["claude-opus-5", "claude-sonnet-5"],
  "availableModelsMatch": "exact"
}

​

deniedModels

• スコープ: Managed。Claude Code は、ユーザー設定、プロジェクト設定、ローカル設定、および --settings 内のこのキーを警告付きで無視します
• 型: モデルのエイリアスまたは ID の配列
  • "opus" のようなファミリーエイリアスは、そのファミリーのすべてのモデルをブロックします
  • "claude-opus-5-5" のようなモデル ID は、日付付き ID やプロバイダー固有の ID を含む、あらゆる表記のそのバージョンをブロックします
  • "claude-opus-5" のようにマイナーバージョンのないモデル ID は、Opus 5.5 など後続のマイナーバージョンもブロックします。Opus 5 のみをブロックするには "claude-opus-5-0" と記述します
  • best、opusplan、default のエントリは無視されます
• デフォルト: 未設定。ブロックされるモデルはありません

{
  "availableModels": ["opus", "sonnet"],
  "deniedModels": ["claude-opus-5-5"]
}

​

effortLevel

• スコープ: Any file
• 型: 文字列。次のいずれか:
  • "low": 推論が最も少なく、知能をあまり必要としない、短く範囲の限られたレイテンシー重視のタスク向け
  • "medium": ある程度の知能と引き換えにできる、コスト重視の作業でトークン使用量を削減します
  • "high": トークン使用量と知能のバランスを取ります
  • "xhigh": より多くのトークンを消費して、より深く推論します
• デフォルト: 未設定
• セッションごとの上書き: --effort は 1 つのセッションに限りこのキーよりも優先され、CLAUDE_CODE_EFFORT_LEVEL はその両方よりも優先されます

{
  "effortLevel": "xhigh"
}

​

enforceAvailableModels

• スコープ: Any file
• 型: Boolean
  • true: Default が availableModels 外のモデルに解決される場合、Claude Code はそれをリスト内で最初に利用可能なモデルに解決します
  • false: このキーは Default の解決方法を変更しません
• デフォルト: false

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

​

fallbackModel

• スコープ: Any file
• 型: モデルのエイリアスまたは ID の配列。"default" はデフォルトモデルに展開されます
• デフォルト: 未設定。失敗したリクエストは別のモデルで再試行されません
• セッションごとの上書き: --fallback-model は、1 つのセッションに限りこのキーよりも優先されます

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

​

fastMode

• スコープ: Any file
• 型: Boolean
  • true: Claude Code は、利用可能なセッションで fast mode をオンにします
  • false: fast mode はオフのままです
• デフォルト: 未設定。fast mode はオフです
• セッションごとの上書き: CLAUDE_CODE_DISABLE_FAST_MODE は 1 つのセッションに限り fast mode をオフにし、このキーで再びオンにすることはできません

{
  "fastMode": true
}

​

fastModePerSessionOptIn

• スコープ: Any file
• 型: Boolean
  • true: 保存された fastMode: true はセッション開始時に fast mode をオンにしなくなるため、各ユーザーは fast mode を使いたいセッションごとに /fast を実行します。--settings で渡された fastMode: true は、管理設定でこのキーが設定されていない限り、そのセッションでは引き続き有効です
  • false: 保存された fastMode: true は、以降のすべてのセッションの開始時に fast mode をオンにします
• デフォルト: false

{
  "fastModePerSessionOptIn": true
}

​

language

• スコープ: Any file
• 型: 文字列。"japanese"、"spanish"、"french" など任意の言語名。Claude Code は検証しません
• デフォルト: 未設定。その場合、セッションタイトルは会話の言語に合わせられます

{
  "language": "japanese"
}

​

maxEffortLevel

• スコープ: Any file。組織全体に適用するには、管理設定でデプロイします。複数のスコープで上限が設定されている場合は最も低いものが適用されるため、あるスコープで設定された上限を別のスコープから引き上げることはできません
• 型: 文字列。"low"、"medium"、"high"、"xhigh"、"max" のいずれか。"max" を指定すると上限は設定されません
• デフォルト: 未設定。上限は適用されません
• モデルごとの上限: モデルの modelSettings エントリに maxEffortLevel を追加します。そのエントリは、ユーザー設定や 1 つの管理ソースなど、両方を設定している設定ソース内に限り、そのモデルについてこのキーを置き換えます。そこで "max" を設定すると、そのモデルをそのソースの上限から除外できます。ただし、Claude Code は他のソースからの上限を引き続き適用します

{
  "maxEffortLevel": "medium",
  "modelSettings": {
    "claude-sonnet-4-6": {
      "maxEffortLevel": "max"
    }
  }
}

​

model

• スコープ: Any file
• 型: 文字列。モデルのエイリアスまたは完全なモデル ID
• デフォルト: 未設定。Claude Code はアカウントのデフォルトモデルを使用します
• セッションごとの上書き: --model は ANTHROPIC_MODEL よりも優先され、どちらも 1 つのセッションに限り、管理された model を含めてこのキーよりも優先されます。ただし、availableModels リストは引き続き選択に適用されます

{
  "model": "claude-sonnet-5"
}

​

modelOverrides

• スコープ: Any file
• 型: モデル ID をプロバイダーのモデル ID にマッピングするオブジェクト
• デフォルト: 未設定

{
  "modelOverrides": {
    "claude-opus-4-6": "arn:aws:bedrock:us-east-1:123456789012:inference-profile/example"
  }
}

​

modelPicker

• スコープ: User or managed。Claude Code はこのキーを管理設定、--settings、ユーザー設定から読み取り、プロジェクト設定とローカル設定では無視します。これにより、クローンしたリポジトリがピッカーのラベルを変更することはできません。これら 3 つのうちこのキーを設定している最も優先順位の高いものがラインナップ全体を提供し、Claude Code が 2 つのソースのラインナップを組み合わせることはありません。
• 型: 行の配列である options と、省略可能な Boolean の replaceBuiltInOptions を持つオブジェクト
• デフォルト: 未設定。ピッカーには組み込みのラインナップが表示されます

{
  "modelPicker": {
    "options": [
      { "model": "us.anthropic.claude-opus-4-8", "label": "Opus (production)" },
      {
        "model": "us.anthropic.claude-sonnet-4-6",
        "label": "Sonnet (production)",
        "description": "Day-to-day work"
      }
    ]
  }
}

​

modelPicker のフィールド

• 削除: 廃止されたモデルや組織がアクセスできないモデルなど、Claude Code が提供できない行
• グレーアウト: まだ選択できない行。理由とともに表示されます
• 残る行がない場合: Claude Code は組み込みのラインナップを保持し、通常どおり許可リストで絞り込みます

​

modelPricing

• スコープ: Managed。このキーは、サーバー管理設定、MDM ポリシー、managed-settings.json ファイル、またはポリシーヘルパーを通じてデプロイします。Claude Code は、ユーザー設定、プロジェクト設定、ローカル設定、--settings、および Windows ではユーザーが書き込み可能な HKCU レジストリ内のこのキーを無視します。サーバー管理設定を使用する場合、各セッションは、そのセッションの設定の取得で設定が確認されるまで、表示価格でコストを報告します。Claude Code を組み込み、CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST を設定しているホストアプリケーションは、SDK の managedSettings オプションを通じて独自の料金表を提供できます。Claude Code がこれを使用するのは、どの管理ソースもこのキーを設定していない場合のみで、Claude Code v2.1.246 以降に限られます。
• 型: 省略可能な multiplier と省略可能な overrides マップを持つオブジェクト
• デフォルト: 未設定。ホストアプリケーションが料金表を提供しない限り、Claude Code は表示価格で報告します

{
  "modelPricing": {
    "multiplier": 0.85,
    "overrides": {
      "claude-sonnet-4-6": {
        "input": 2.4,
        "output": 12,
        "cacheRead": 0.24,
        "cacheWrite": 3
      }
    }
  }
}

​

modelPricing のフィールド

​

modelPricing の行が適用されるモデル

• 組み込みモデルの ID: Claude Code 自身が組み込みモデルに使用するキーで、claude-sonnet-4-6 のようなモデル自体の ID であるか、Bedrock、Agent Platform、Foundry の ID であるかは問いません。Claude Code は、そのモデルのすべての日付付きスナップショット ID とプロバイダー固有の ID にその行を適用します。
• その他のキー: ゲートウェイのモデルエイリアスなど、組み込みモデルの ID ではないキー。Claude Code はその 1 つの ID にのみ行を適用します。モデル ID がいずれかのキーに完全に一致し、かつ組み込みモデルの ID をキーとする行にも該当する場合、Claude Code は完全一致を使用します。
• Bedrock のアプリケーション推論プロファイル: Claude Code が modelOverrides マップまたは bedrock:GetInferenceProfile による検索を通じて、プロファイルをルーティング先のモデルに解決すると、Claude Code はそのモデルの行をプロファイルに適用します。

​

modelSettings

• スコープ: Any file
• 型: モデル名を、次のいずれかのフィールドを持つオブジェクトにマッピングするオブジェクト:
  • effortLevel: "low"、"medium"、"high"、"xhigh" のいずれか
  • maxEffortLevel: モデルが実行できる最も高い effort レベル
  • autoCompactWindow: 100000 から 1000000 までのトークン数、またはモデル向けに調整されたウィンドウを表す "auto"。/autocompact はここに保存します。そのモデルについては、この値が同じ設定ファイル内のトップレベルの autoCompactWindow よりも優先されます。Claude Code v2.1.288 以降が必要です
• デフォルト: 未設定

{
  "modelSettings": {
    "claude-opus-5-5": {
      "effortLevel": "high"
    }
  }
}

​

outputStyle

• スコープ: Any file
• 型: 文字列。組み込みまたはカスタムの出力スタイルの名前
• デフォルト: 未設定。Claude Code はデフォルトのスタイルを使用します

{
  "outputStyle": "Explanatory"
}

​

promptCacheTtl

• スコープ: Any file
• 型: 文字列。次のいずれか:
  • "5m": キャッシュは 5 分間保持されます
  • "1h": キャッシュは 1 時間保持されます
• デフォルト: 未設定。メインの会話の各リクエストにはデフォルトの有効期間が適用されます
• セッションごとの上書き: FORCE_PROMPT_CACHING_5M が他のすべてよりも優先され、次に CLAUDE_CODE_PROMPT_CACHE_TTL、次にこのキー、最後に ENABLE_PROMPT_CACHING_1H の順になります

{
  "promptCacheTtl": "1h",
  "subagentPromptCacheTtl": "5m"
}

​

showThinkingSummaries

• スコープ: Any file
• 型: Boolean
  • true: Ctrl+O で思考を展開すると、完全な思考の要約が表示されます
  • false: Anthropic API は思考ブロックを編集済み（非表示）にし、Claude Code は折りたたまれたスタブを表示します
• デフォルト: false

{
  "showThinkingSummaries": true
}

​

subagentPromptCacheTtl

• スコープ: Any file
• 型: 文字列。次のいずれか:
  • "5m": キャッシュは 5 分間保持されます
  • "1h": キャッシュは 1 時間保持されます
• デフォルト: 未設定。これらの各リクエストにはデフォルトの有効期間が適用されます
• セッションごとの上書き: FORCE_PROMPT_CACHING_5M が他のすべてよりも優先され、次に CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL、次にこのキー、次にすべてのリクエストに 1 時間の有効期間を求める ENABLE_PROMPT_CACHING_1H の順になります。サブエージェント自身のフロントマターの値の優先順位については、TTL を自分で選択するを参照してください

{
  "subagentPromptCacheTtl": "1h"
}

​

switchModelsOnFlag

• スコープ: Any file。/config では Switch models when a message is flagged として表示され、オプションは Switch automatically と Ask each time です。
• 型: Boolean
  • true: Claude Code はフォールバックモデルに切り替えて続行します
  • false: 対話セッションでは、Claude Code は一時停止し、切り替えるかプロンプトを編集するかを選べるようにします。-p の実行など、ダイアログを表示できない場合は、警告されたリクエストはエラーとして終了します
• デフォルト: 未設定。Claude Code は自動的に切り替えますが、対話セッションでは先に確認する場合があります

{
  "switchModelsOnFlag": false
}

​

ultracode

• スコープ: Any file
• 型: Boolean
  • true: ユーザーに対して動的ワークフローが有効で、かつモデルが xhigh をサポートしている場合、セッションは ultracode がオンの状態で開始します
  • false: セッションは ultracode がオフの状態で開始します
• デフォルト: 未設定。ultracode はオフです
• セッションごとの上書き: /effort ultracode はこのキーなしで 1 つのセッションに限り ultracode をオンにし、/effort ultracode off はこのキーが true の場合に 1 つのセッションに限りオフにします。--effort ultracode フラグも、1 つのセッションに限り xhigh の effort で ultracode をオンにします

{
  "ultracode": true
}

​

権限設定

​

allowManagedPermissionRulesOnly

• リポジトリの .claude/ ディレクトリ
• ~/.claude/skills/ および ~/.claude/commands/ ディレクトリ（claude.ai から同期されたスキルを含む）
• --add-dir ディレクトリ
• ~/.claude/skills/ またはプロジェクトの .claude/skills/ 内で .claude-plugin マニフェストにより宣言されたプラグイン
• 1 つのセッションに対してのみ読み込まれ、ID が @inline で終わるプラグイン（次のすべてが満たされる場合）
  • セッションが、Claude Desktop アプリ自体が Claude Code を起動する Code セッションまたは Cowork セッションである（クラウドセッションを除く）
  • 埋め込みホストの親設定だけでなく、管理設定がこのキーを設定している
  • セッションが Claude Code v2.1.305 以降で実行されている

• スコープ: Managed
• タイプ: ブール値
  • true: 管理設定が権限ルールの唯一の設定ソースになります
  • false: Claude Code は管理ルールに加えて、ユーザー、プロジェクト、ローカル、および --settings ファイルから権限ルールを適用します
• デフォルト: 未設定。Claude Code はユーザー、プロジェクト、ローカル設定、および --settings から権限ルールを管理ルールに加えて適用します

{
  "allowManagedPermissionRulesOnly": true
}

​

autoMode

• スコープ: User or managed
• タイプ: environment、allow、soft_deny、hard_deny の散文ルール配列、および classifyAllShell ブール値を含むオブジェクト
• デフォルト: 未設定。分類器は組み込みルールのみを使用します

{
  "autoMode": {
    "soft_deny": ["$defaults", "Never run terraform apply"]
  }
}

​

autoMode.classifyAllShell

• スコープ: User or managed。autoModeが読み取られる場所で読み取られます。
• タイプ: ブール値
  • true: auto モードがアクティブな間、Claude Code はすべての Bash および PowerShell コマンドを分類器に通し、シェル許可ルールを一時停止します。auto モード外では、ルールは引き続き適用されます
  • false: auto モードは Bash(*) や Bash(python *) など、任意のコードを実行できる許可ルールのみを一時停止します。それ以外の許可ルールに一致するコマンドは、コマンドごとの許可ドメインを持たない限り分類器をスキップし、その他すべてのシェルコマンドは分類器を通ります
• デフォルト: false

{
  "autoMode": {
    "classifyAllShell": true
  }
}

​

disableAutoMode

• スコープ: Any file。管理設定で最も有用です。ユーザーはそれを上書きできません。permissions の下で permissions.disableAutoMode としても受け入れられます。
• タイプ: 文字列 "disable"
• デフォルト: 未設定

{
  "disableAutoMode": "disable"
}

​

permissions

• スコープ: Any file
• タイプ: allow、ask、deny、additionalDirectories、blockReadsOutsideWorkingDirectories、defaultMode、disableBypassPermissionsMode、disableAutoMode を含むオブジェクト
• デフォルト: 未設定

{
  "permissions": {
    "allow": ["Bash(npm run *)"],
    "ask": ["Bash(git push *)"],
    "deny": ["Read(./.env)"],
    "defaultMode": "acceptEdits"
  }
}

​

useAutoModeDuringPlan

• スコープ: User, local, or managed。リポジトリがこれをオフにすることはできません。
• タイプ: ブール値
  • true: 未設定と同じです。auto モードが利用可能な場合、分類器は計画中に各シェルコマンドを確認し、プロンプトを表示しません。ただし、重要パスの削除を除きます。これらのファイルのいずれかで false が設定されていれば、引き続きオフになります
  • false: 組み込みの読み取り専用セット外のすべてのコマンドに対して権限プロンプトが表示されます
• デフォルト: true

{
  "useAutoModeDuringPlan": false
}

​

permissions.allow

• スコープ: Any file
• タイプ: 権限ルール文字列の配列
• デフォルト: 未設定
• セッションごとの上書き: --allowedTools は 1 つのセッションに許可ルールを追加しますが、任意の設定ファイルからの拒否ルールは、それが指定するツールを引き続きブロックします

{
  "permissions": {
    "allow": ["Bash(git diff *)", "Read(~/.zshrc)"]
  }
}

​

権限ルール構文

​

permissions.ask

• スコープ: Any file
• タイプ: 権限ルール文字列の配列
• デフォルト: 未設定

{
  "permissions": {
    "ask": ["Bash(git push *)"]
  }
}

​

permissions.deny

• スコープ: Any file
• タイプ: 権限ルール文字列の配列
• デフォルト: 未設定
• セッションごとの上書き: --disallowedTools はこのキーと並行して 1 つのセッションに拒否ルールを追加します

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Bash(curl *)"
    ]
  }
}

​

permissions.additionalDirectories

• スコープ: Any file。ただし、プロジェクトおよびローカルのエントリが付与するサンドボックスの書き込みアクセスには制限があります
• タイプ: ディレクトリパスの配列
• デフォルト: 未設定
• セッションごとの上書き: --add-dir および /add-dir はこのキーと並行して 1 つのセッションにディレクトリを追加します

{
  "permissions": {
    "additionalDirectories": ["../docs/"]
  }
}

​

permissions.blockReadsOutsideWorkingDirectories

• どのモードでも自動承認されないアクションでは、そのようなパスを読み取るシェルコマンドがいつプロンプトを表示するかを説明しています
• ブロック下のサンドボックス化されたコマンドでは、サンドボックス化されたコマンドが何を読み取れるかを説明しています

• スコープ: Any file。いずれかのファイルの true が適用されるため、リポジトリは自身に対してブロックをオンにできますが、ユーザーが設定したブロックを解除することはできません。
• タイプ: ブール値
  • true: Claude のファイルツールは作業ディレクトリ外の読み取りを拒否します
  • false: 未設定と同じです。別のファイルが true を設定している場合、ブロックは引き続き適用されます
• デフォルト: 未設定。作業ディレクトリ外の読み取りは権限モードに従います

{
  "permissions": {
    "blockReadsOutsideWorkingDirectories": true
  }
}

​

ブロック下のサンドボックス化されたコマンド

• ファイルシステム分離が sandbox.filesystem.disabled によってオフになっている
• allowManagedReadPathsOnly が設定されている
• Claude Code を開始したディレクトリのパスに *、?、[ などのグロブ文字が含まれている

• ~/.gitconfig
• $XDG_CONFIG_HOME/git の下の config、ignore、attributes ファイル（デフォルトは ~/.config/git）
• グローバル git 設定が [include]、[includeIf]、core.excludesFile、core.attributesFile を通じて指定するファイル

​

permissions.defaultMode

• スコープ: Any file。auto および bypassPermissions はプロジェクトまたはローカル設定からは有効にならないため、代わりに ~/.claude/settings.json で設定してください。v2.1.257 より前では、bypassPermissions は任意のファイルから有効になりました。VS Code 拡張機能が開始する会話の場合、Claude Code はユーザー、管理、および --settings の値のみを読み取ります。
• タイプ: 文字列。次のいずれか：
  • "default": Claude Code は確認なしで読み取りのみを実行します
  • "acceptEdits": Claude Code は確認なしでファイル編集と mkdir や mv などの一般的なファイルシステムコマンドも実行します
  • "plan": Claude Code は読み取りと計画を行いますが、計画を承認するまで編集をブロックします
  • "auto": Claude Code は日常的なプロンプトなしで実行します。シェルコマンドやネットワークリクエストなどのアクションが実行される前に、バックグラウンドの分類器がそれらがユーザーのリクエストに沿っているかを確認します
  • "dontAsk": Claude Code はプロンプトを表示するはずのすべての呼び出しを自動的に拒否します。ただし、インストールした mod はそれらの呼び出しの一部を引き続き承認できます。作業ディレクトリ内のファイル読み取り、承認が不要な他のアクション、事前承認されたツールは引き続き実行されます。ただし、ネットワークパスからの読み取りは除きます
  • "bypassPermissions": Claude Code はすべてを確認なしで実行します
  • "manual": "default" のエイリアス
• デフォルト: 未設定
• セッションごとの上書き: --permission-mode、および bypassPermissions に相当する --dangerously-skip-permissions は、1 つのセッションにおいてこのキーより優先されます

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

​

permissions.disableBypassPermissionsMode

• スコープ: Any file。通常、組織のポリシーを強制するために管理設定で設定します。
• タイプ: 文字列 "disable"
• デフォルト: 未設定
• セッションごとの上書き: このキーは --dangerously-skip-permissions より優先されます。キーが設定されている間、Claude Code はそのフラグを拒否します

{
  "permissions": {
    "disableBypassPermissionsMode": "disable"
  }
}

​

skipAutoPermissionPrompt

• スコープ: User or managed。リポジトリがこれを設定することはできません。
• タイプ: ブール値
  • true: Claude Code は通知をスキップします
  • false: 未設定と同じです。これらのファイルのいずれかが true を設定しない限り、通知が 1 回表示されます
• デフォルト: 未設定。通知が 1 回表示されます

{
  "skipAutoPermissionPrompt": true
}

​

skipDangerousModePermissionPrompt

• スコープ: User, local, or managed。信頼されていないリポジトリがダイアログをスキップさせることはできません。
• タイプ: ブール値
  • true: Claude Code はセッションが bypassPermissions モードに入る前の確認ダイアログをスキップします
  • false: 未設定と同じです。これらのファイルのいずれかが true を設定しない限り、ダイアログが表示されます
• デフォルト: 未設定。ダイアログが表示されます

{
  "skipDangerousModePermissionPrompt": true
}

​

サンドボックス設定

​

sandbox

• Scope: Any file
• 型: enabled、failIfUnavailable、autoAllowBashIfSandboxed、excludedCommands、allowUnsandboxedCommands、enableWeakerNestedSandbox、enableWeakerNetworkIsolation、allowAppleEvents、allowNestedUserNamespaces、bwrapPath、socatPath、ignoreViolations、ripgrep に加え、filesystem、network、credentials の各オブジェクトを持つオブジェクト
• Default: 未設定。Claude Code はサンドボックスなしでコマンドを実行します

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker *"],
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

​

sandbox.enabled

• Scope: Any file（プロジェクト設定とローカル設定には制限あり）
• Type: ブール値
  • true: Claude Code は Bash コマンドをサンドボックス化します
  • false: Bash コマンドはサンドボックスなしで実行されます
• Default: false

{
  "sandbox": {
    "enabled": true
  }
}

​

sandbox.failIfUnavailable

• Scope: Any file（プロジェクト設定とローカル設定には制限あり）
• Type: ブール値
  • true: sandbox.enabled が true であるにもかかわらずサンドボックスが起動できない場合、Claude Code はスタートアップ時にエラーで終了します
  • false: サンドボックスが起動できない場合、Claude Code はコマンドをサンドボックスなしで実行します
• Default: false

{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true
  }
}

​

sandbox.autoAllowBashIfSandboxed

• Scope: Any file
• Type: ブール値
  • true: Claude Code はサンドボックス化された Bash コマンドを権限プロンプトなしで実行します。ただし、自動許可モードで説明されているケースを除きます。CLAUDE_CODE_SUBPROCESS_ENV_SCRUB は自動許可をオフにします
  • false: サンドボックス化されたコマンドは通常の権限フローを通過するため、許可ルールと権限モードが決定します。/sandbox Mode タブはこれを通常権限モードと呼びます
• Default: true

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": false
  }
}

​

sandbox.excludedCommands

• Scope: Any file（プロジェクト設定とローカル設定には制限あり）
• Type: コマンドパターンの配列
• Default: 未設定。コマンドは除外されません

{
  "sandbox": {
    "excludedCommands": ["docker *"]
  }
}

• sudo、eval、または xargs で始まるコマンド
• cd、pushd、または popd（呼び出しのどこにでも出現）
• コマンド置換、サブシェル、または if や for などの制御フロー ブロック
• docker build . > build.log など、ファイル記述子を複製するもの以外のリダイレクト（2>&1 など）
• 変数から来るコマンド名
• パス引数が絶対パスである、~ で始まる、または .. セグメントを含む git clone、git init、git worktree add、git worktree move、または git bundle create

​

sandbox.allowUnsandboxedCommands

• Scope: Any file（プロジェクト設定とローカル設定には制限あり）
• Type: ブール値
  • true: Claude がサンドボックスによってブロックされた後、dangerouslyDisableSandbox パラメータを使用してコマンドをサンドボックスの外で再試行できます
  • false: Claude Code はそのパラメータを無視するため、サンドボックスの実行中は、Claude が実行するコマンドは excludedCommands のエントリに一致しない限りサンドボックス化されます
• Default: true

{
  "sandbox": {
    "enabled": true,
    "allowUnsandboxedCommands": false
  }
}

​

sandbox.filesystem

• Scope: Any file
• Type: allowWrite、denyWrite、denyRead、allowRead 配列を含むオブジェクト、および allowManagedReadPathsOnly と disabled ブール値
• Default: 未設定。デフォルトの読み取りおよび書き込み境界が適用されます

{
  "sandbox": {
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    }
  }
}

​

サンドボックスパスプレフィックス

~/keys/*.pem              the entry
/home/alice/keys/*.pem    its full path
 ^^^^                     the first directory name, home

app/
└── [slug]/
    └── page.tsx

• [slug] のような角括弧: macOS ではすべてのリストで、Linux と WSL2 では denyRead と allowRead で、./app/[slug] の角括弧はパターンとしても扱われます。その場合、このエントリは app/s や app/g など、app 配下にある、slug のうち 1 文字を名前とするパスにも一致します。このエントリが allowRead にある場合、または macOS で allowWrite にある場合、サンドボックス化されたコマンドはそれらのパスにもアクセスできます。アクセスさせるべきでないものは名前を変更してください。
• [user-id] や [post-id] のように、ハイフンの左側の文字が右側の文字より後にソートされる角括弧: ./app/[user-id] は、すべてのプラットフォームのすべてのリストで、その名前と完全に一致するディレクトリのみを対象とします。v2.1.304 より前は、denyRead または allowRead にそのようなエントリがあると、Linux と WSL2 でサンドボックス化されたコマンドの起動に失敗していました。
• 波括弧と丸括弧: これらは通常の文字であるため、~/data/{keys,tokens} は 2 つの選択肢ではなく、{keys,tokens} という名前の 1 つのディレクトリを対象とします。~/data/keys と ~/data/tokens を対象とするには、それぞれを個別のエントリとして追加してください。

​

sandbox.filesystem.allowWrite

• Scope: Any file（プロジェクト設定とローカル設定には制限あり）
• Type: サンドボックスパスプレフィックスを使用するパス文字列の配列
• Default: 未設定。サンドボックス化されたコマンドは、作業ディレクトリ、ユーザーごとの一時ディレクトリ、--add-dir または /add-dir で追加したディレクトリ、および permissions.additionalDirectories のディレクトリに書き込むことができます

{
  "sandbox": {
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"]
    }
  }
}

​

sandbox.filesystem.denyWrite

• Scope: Any file
• Type: サンドボックスパスプレフィックスを使用するパス文字列の配列
• Default: 未設定

{
  "sandbox": {
    "filesystem": {
      "denyWrite": ["/etc", "/usr/local/bin"]
    }
  }
}

​

sandbox.filesystem.denyRead

• Scope: Any file
• Type: サンドボックスパスプレフィックスを使用するパス文字列の配列
• Default: 未設定。サンドボックス化されたコマンドはデフォルト読み取りアクセスを保持します。これには ~/.aws/credentials などの認証情報ファイルが含まれます

{
  "sandbox": {
    "filesystem": {
      "denyRead": ["~/.aws/credentials"]
    }
  }
}

​

sandbox.filesystem.allowRead

• Scope: Any file（プロジェクト設定とローカル設定には制限あり）
• Type: サンドボックスパスプレフィックスを使用するパス文字列の配列
• Default: 未設定

{
  "sandbox": {
    "filesystem": {
      "denyRead": ["~/"],
      "allowRead": ["."]
    }
  }
}

​

sandbox.filesystem.allowManagedReadPathsOnly

• Scope: Managed
• Type: ブール値
  • true: Claude Code は管理設定からの allowRead エントリのみを尊重します
  • false: 他の設定ファイルからの allowRead エントリもマージされます
• Default: false

{
  "sandbox": {
    "filesystem": {
      "denyRead": ["~/"],
      "allowRead": ["~/work"],
      "allowManagedReadPathsOnly": true
    }
  }
}

​

sandbox.filesystem.disabled

• Scope: User or managed。管理設定が sandbox.filesystem をまったく設定する場合、または "mode": "deny" を持つ sandbox.credentials.files エントリをリストする場合、管理設定のみがそれを設定できます。
• Type: ブール値
  • true: Claude Code はファイルシステム分離をスキップし、ネットワーク分離を保持します
  • false: ファイルシステム分離は有効なままです
• Default: false。ファイルシステム分離は有効なままです

{
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "disabled": true
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

​

sandbox.ignoreViolations

• Scope: Any file（プロジェクト設定とローカル設定には制限あり）
• Type: コマンドサブストリングを違反サブストリングの配列にマップするオブジェクト（通常はパス）
• Default: 未設定。すべての違反が報告されます

{
  "sandbox": {
    "ignoreViolations": {
      "*": ["/etc/hosts"]
    }
  }
}

​

sandbox.enableWeakerNestedSandbox

• Scope: Any file（プロジェクト設定とローカル設定には制限あり）
• Type: ブール値
  • true: 内部サンドボックスは新しい /proc をマウントする代わりに、コンテナの既存の /proc をバインドマウントします
  • false: サンドボックスは新しい /proc をマウントします。これは非特権 Docker コンテナでは機能しません
• Default: false

{
  "sandbox": {
    "enabled": true,
    "enableWeakerNestedSandbox": true
  }
}

​

sandbox.enableWeakerNetworkIsolation

• Scope: Any file（プロジェクト設定とローカル設定には制限あり）
• Type: ブール値
  • true: macOS でサンドボックス化されたコマンドは com.apple.trustd.agent に到達できます
  • false: macOS でサンドボックス化されたコマンドはシステム TLS トラストサービスに到達できません
• Default: false

{
  "sandbox": {
    "enabled": true,
    "enableWeakerNetworkIsolation": true
  }
}

​

sandbox.allowAppleEvents

• Scope: User or managed
• Type: ブール値
  • true: macOS でサンドボックス化されたコマンドは Apple Events を送信できます
  • false: macOS でサンドボックス化されたコマンドは Apple Events を送信できないため、open と osascript はエラー -600 で失敗します
• Default: false

{
  "sandbox": {
    "enabled": true,
    "allowAppleEvents": true
  }
}

​

sandbox.allowNestedUserNamespaces

• スコープ: User or managed。true は、~/.claude/settings.json、--settings で渡された JSON、または管理設定からのものが有効になります。Claude Code は、プロジェクトの .claude/settings.json または .claude/settings.local.json にある true を無視します。CLAUDE_CODE_SUBPROCESS_ENV_SCRUB が 1 に設定されたセッションでは、Claude Code はすべてのソースからの true を無視します。false は、設定の優先順位に従い、任意のファイルからのものが有効になります。
• 型: ブール値
  • true: サンドボックス化されたコマンドはユーザー名前空間を作成できます
  • false: このキーによって追加で許可されるものはなく、サンドボックスのデフォルトが適用されます
• デフォルト: false

{
  "sandbox": {
    "enabled": true,
    "allowNestedUserNamespaces": true
  }
}

​

sandbox.ripgrep

• Scope: User or managed
• Type: ripgrep バイナリへのパスである command を含むオブジェクト、および前置する引数の配列である optional args
• Default: 未設定。サンドボックスは Claude Code と同じ ripgrep バイナリを使用します。USE_BUILTIN_RIPGREPを 0 に設定しない限り、これはバンドルされたバイナリです

{
  "sandbox": {
    "ripgrep": {
      "command": "/usr/local/bin/rg"
    }
  }
}

​

sandbox.bwrapPath

• Scope: Managed。Claude Code はユーザー、プロジェクト、またはローカルファイルがサンドボックスを別のバイナリに指定できないように、管理設定からのみ読み取ります。
• Type: 文字列。絶対パス。Claude Code は相対パスを削除し、PATH ルックアップにフォールバックします
• Default: 未設定。Claude Code は PATH で bwrap を見つけます

{
  "sandbox": {
    "enabled": true,
    "bwrapPath": "/opt/admin/bwrap"
  }
}

​

sandbox.socatPath

• Scope: Managed
• Type: 文字列。絶対パス。Claude Code は相対パスを削除し、PATH ルックアップにフォールバックします
• Default: 未設定。Claude Code は PATH で socat を見つけます

{
  "sandbox": {
    "enabled": true,
    "socatPath": "/opt/admin/socat"
  }
}

​

sandbox.credentials

• Scope: Any file。Claude Code は mask エントリ、allowPlaintextInject、awsPairs、sigv4 をユーザー設定、管理設定、--settings フラグからのみ尊重します。
• Type: files、envVars、allowPlaintextInject、awsPairs、sigv4 を含むオブジェクト
• Default: 未設定。認証情報は保護されません

{
  "sandbox": {
    "credentials": {
      "files": [{ "path": "~/.aws/credentials", "mode": "deny" }],
      "envVars": [{ "name": "GITHUB_TOKEN", "mode": "deny" }]
    }
  }
}

​

管理設定の無効な認証情報エントリ

• files または envVars のエントリで、有効な path または name と mask または deny の mode を持つもの（キャプチャグループがない extract パターンなど）は、警告とともに mode: "deny" に低下されるため、認証情報はマスクされず、エントリを修正するまでブロックされたままです。低下した files エントリは、明示的な deny エントリのように filesystem.disabled をピンします。警告は、管理設定がファイルシステム分離をオフにする場合、その読み取りブロックが強制されないことを記します。
• 不明な mode または無効な path または name を持つエントリは削除されます。
• 各ケースは警告します。エントリが低下または削除されるかどうかに関わらず、残りの有効なエントリは引き続き強制されます。

​

sandbox.credentials.files

• Scope: Any file。Claude Code はプロジェクト .claude/settings.json とローカル .claude/settings.local.json から mask エントリを削除します。
• Type: オブジェクトの配列。各オブジェクトは path と "deny" または "mask" の mode、および optional ファイルのマスクフィールドを含みます
• Default: 未設定。認証情報ファイルは保護されません

{
  "sandbox": {
    "credentials": {
      "files": [
        { "path": "~/.aws/credentials", "mode": "deny" },
        { "path": "~/.config/gh/hosts.yml", "mode": "mask", "injectHosts": ["api.github.com"] }
      ]
    }
  }
}

​

ファイルのマスクフィールド

{
  "sandbox": {
    "credentials": {
      "files": [
        {
          "path": "~/.config/gh/hosts.yml",
          "mode": "mask",
          "extract": "oauth_token:\\s*(\\S+)",
          "maskDuplicates": true,
          "onExtractNoMatch": "deny",
          "injectHosts": ["api.github.com"]
        }
      ]
    }
  }
}

​

sandbox.credentials.envVars

• Scope: Any file。Claude Code はプロジェクト .claude/settings.json とローカル .claude/settings.local.json から mask エントリを削除します。
• Type: オブジェクトの配列。各オブジェクトは name と "deny" または "mask" の mode、および optional 環境変数のマスクフィールドを含みます
• Default: 未設定。環境変数は保護されません

{
  "sandbox": {
    "credentials": {
      "envVars": [
        { "name": "NPM_TOKEN", "mode": "deny" },
        { "name": "GITHUB_TOKEN", "mode": "mask", "injectHosts": ["api.github.com"] }
      ]
    }
  }
}

​

環境変数のマスクフィールド

{
  "sandbox": {
    "credentials": {
      "envVars": [
        {
          "name": "DATABASE_URL",
          "mode": "mask",
          "extract": "://[^:]+:([^@]+)@",
          "onExtractNoMatch": "deny"
        },
        {
          "name": "SERVICE_JWT",
          "mode": "mask",
          "decode": "jwt",
          "maskClaims": ["api_key"]
        }
      ]
    }
  }
}

​

sandbox.credentials.allowPlaintextInject

• Scope: User or managed
• Type: ブール値
  • true: Claude Code はプレーン HTTP リクエストと TLS 終了 HTTPS の両方で mask 置換を許可します
  • false: Claude Code は TLS 終了 HTTPS でのみ mask 置換を許可します
• Default: false