すべての設定

​

設定インデックス

​

モデルと応答

​

advisorModel

• スコープ: 任意のファイル
• タイプ: 文字列、エイリアス "fable"、"opus"、または "sonnet" のいずれか。これらは Claude Code の現在のデフォルトバージョンのそのモデルファミリーに解決されます。または、"claude-opus-5-5" などの完全なモデル ID
• デフォルト: 設定解除されているため、アドバイザーはオフです
• セッションごとのオーバーライド: --advisor はこのキーより優先されます。CLAUDE_CODE_DISABLE_ADVISOR_TOOLはアドバイザーをオフにし、このキーはそれをオンに戻すことはできません

{
  "advisorModel": "opus"
}

​

alwaysThinkingEnabled

• スコープ: 任意のファイル
• タイプ: ブール値
  • true: 効果なし。思考は既にオンです
  • false: Claude Code はすべてのセッションで拡張思考をオフにします
• デフォルト: 設定解除されているため、思考はそれをサポートするモデルではオンです
• セッションごとのオーバーライド: MAX_THINKING_TOKENSはこのキーより優先されます。0 は false と同じモデルおよびプロバイダーの制限の下で思考をオフにし、正の値は、このキーが false の場合でも思考をオンにします。適応推論モデルでは、数値自体は無視されます

{
  "alwaysThinkingEnabled": false
}

​

availableModels

• スコープ: 任意のファイル。組織に対して強制するために、管理設定にデプロイします。
• タイプ: モデルエイリアスまたは ID の配列
• デフォルト: 設定解除されているため、すべてのモデルが利用可能です

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

​

availableModelsMatch

• スコープ: 管理。Claude Code はユーザー、プロジェクト、ローカル設定および --settings のキーを無視し、警告を表示します
• タイプ: 文字列、以下のいずれか:
  • "prefix": モデル ID エントリはそのバージョンと、別のセグメントで拡張するモデル ID を許可します
  • "exact": モデル ID エントリは名前を付けたバージョンのみを許可します。日付付き ID を含むため、"claude-opus-5" は Opus 5 を許可しますが claude-opus-5-5 は許可しません。"opus" などのファミリーエイリアスは依然としてファミリー全体を許可し、best、opusplan、および default エントリは無視されます
• デフォルト: "prefix"

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

​

deniedModels

• スコープ: 管理。Claude Code はユーザー、プロジェクト、ローカル設定および --settings のキーを無視し、警告を表示します
• タイプ: モデルエイリアスまたは ID の配列
  • "opus" などのファミリーエイリアスはそのファミリーのすべてのモデルをブロックします
  • "claude-opus-5-5" などのモデル 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

• スコープ: 任意のファイル
• タイプ: 文字列、以下のいずれか:
  • "low": 最小限の推論。短く、スコープが限定され、レイテンシに敏感で、インテリジェンスに敏感ではないタスク用
  • "medium": コスト敏感な作業のトークン使用量を削減します。インテリジェンスをいくらか取引できます
  • "high": トークン使用量とインテリジェンスのバランスを取ります
  • "xhigh": より高いトークン支出でより深い推論
• デフォルト: 設定解除されています
• セッションごとのオーバーライド: --effort はこのキーより優先されます。CLAUDE_CODE_EFFORT_LEVELは両方より優先されます

{
  "effortLevel": "xhigh"
}

​

enforceAvailableModels

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

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

​

fallbackModel

• スコープ: 任意のファイル
• タイプ: モデルエイリアスまたは ID の配列。"default" はデフォルトモデルに展開されます
• デフォルト: 設定解除されているため、失敗したリクエストは別のモデルで再試行されません
• セッションごとのオーバーライド: --fallback-model はこのキーより優先されます

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

​

fastMode

• スコープ: 任意のファイル
• タイプ: ブール値
  • true: Claude Code は利用可能なセッションで高速モードをオンにします
  • false: 高速モードはオフのままです
• デフォルト: 設定解除されているため、高速モードはオフです
• セッションごとのオーバーライド: CLAUDE_CODE_DISABLE_FAST_MODEは 1 つのセッションで高速モードをオフにし、このキーはそれをオンに戻すことはできません

{
  "fastMode": true
}

​

fastModePerSessionOptIn

• スコープ: 任意のファイル
• タイプ: ブール値
  • true: 保存された fastMode: true はセッション開始時に高速モードをオンにしなくなるため、各ユーザーは必要な各セッションで /fast を実行します。--settings で渡された fastMode: true は、管理設定がこのキーを設定しない限り、そのセッションでもカウントされます
  • false: 保存された fastMode: true は後のすべてのセッションの開始時に高速モードをオンにします
• デフォルト: false

{
  "fastModePerSessionOptIn": true
}

​

language

• スコープ: 任意のファイル
• タイプ: 文字列、"japanese"、"spanish"、"french" などの言語名。Claude Code はそれを検証しません
• デフォルト: 設定解除されています。セッションタイトルは会話の言語と一致します

{
  "language": "japanese"
}

​

maxEffortLevel

• スコープ: 任意のファイル。組織に対して強制するために、管理設定にデプロイします。複数のスコープがキャップを設定する場合、最も低いものが適用されるため、1 つのスコープで設定されたキャップを別のスコープから上げることはできません
• タイプ: 文字列、"low"、"medium"、"high"、"xhigh"、または "max" のいずれか。"max" 値はキャップを設定しません
• デフォルト: 設定解除されているため、キャップは適用されません
• モデルごとのキャップ: モデルの modelSettingsエントリに maxEffortLevel を追加します。そのエントリは、ユーザー設定や 1 つの管理ソースなど、両方を設定する設定ソース内でのみこのキーを置き換えます。そこで "max" を設定して、そのソースのキャップからモデルを除外します。Claude Code は他のソースからのキャップを依然として適用します

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

​

model

• スコープ: 任意のファイル
• タイプ: 文字列、モデルエイリアスまたは完全なモデル ID
• デフォルト: 設定解除されているため、Claude Code はアカウントのデフォルトモデルを使用します
• セッションごとのオーバーライド: --model は ANTHROPIC_MODELより優先され、両方は 1 つのセッションでこのキーより優先されます。管理 model を含む。availableModelsリストは依然として選択に適用されます

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

​

modelOverrides

• スコープ: 任意のファイル
• タイプ: モデル ID をプロバイダーモデル ID にマップするオブジェクト
• デフォルト: 設定解除されています

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

​

modelPicker

• スコープ: ユーザーまたは管理。Claude Code は管理設定、--settings、およびユーザー設定からキーを読み取り、プロジェクトおよびローカル設定では無視するため、クローンするリポジトリはピッカーを再ラベルできません。これら 3 つの最も高いものがキーを設定すると、ラインアップ全体が供給され、Claude Code は 2 つのソースからラインアップをマージしません。
• タイプ: options 配列と行とオプションの 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

• スコープ: 管理。サーバー管理設定、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 自体がモデルの独自の ID (例: claude-sonnet-4-6) またはその Bedrock、Agent Platform、または Foundry ID であるかどうかに関わらず、組み込みモデルに使用するキー。Claude Code はそのモデルのすべての日付スナップショット ID とプロバイダー固有の ID に行を適用します。
• その他のキー: 組み込みモデルの ID ではないキー。ゲートウェイモデルエイリアスなど。Claude Code はそのキーのみに行を適用します。モデル ID がキーの 1 つと正確に一致し、組み込みモデルの ID でキーされた行の下にも該当する場合、Claude Code は正確な一致を使用します。
• Bedrock アプリケーション推論プロファイル: Claude Code がプロファイルを modelOverridesマップまたは bedrock:GetInferenceProfile ルックアップを通じてルーティングするモデルに解決した後、Claude Code はそのモデルの行をプロファイルに適用します。

​

modelSettings

• スコープ: 任意のファイル
• タイプ: モデル名を、以下のいずれかのフィールドを持つオブジェクトにマッピングするオブジェクト:
  • 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

• スコープ: 任意のファイル
• タイプ: 文字列。組み込みまたはカスタム出力スタイルの名前
• デフォルト: 設定解除されているため、Claude Code はデフォルトスタイルを使用します

{
  "outputStyle": "Explanatory"
}

​

promptCacheTtl

• スコープ: 任意のファイル
• タイプ: 文字列、以下のいずれか:
  • "5m": キャッシュは 5 分間保持されます
  • "1h": キャッシュは 1 時間保持されます
• デフォルト: 設定解除されているため、各メイン会話リクエストはそのデフォルトライフタイムを取得します
• セッションごとのオーバーライド: FORCE_PROMPT_CACHING_5Mはすべてを優先し、次に CLAUDE_CODE_PROMPT_CACHE_TTL、次にこのキー、最後に ENABLE_PROMPT_CACHING_1H

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

​

showThinkingSummaries

• スコープ: 任意のファイル
• タイプ: ブール値
  • true: Ctrl+O で思考を展開するときに完全な思考概要が表示されます
  • false: Anthropic API は思考ブロックを編集し、Claude Code は折りたたまれたスタブを表示します
• デフォルト: false

{
  "showThinkingSummaries": true
}

​

subagentPromptCacheTtl

• スコープ: 任意のファイル
• タイプ: 文字列、以下のいずれか:
  • "5m": キャッシュは 5 分間保持されます
  • "1h": キャッシュは 1 時間保持されます
• デフォルト: 設定解除されているため、これらの各リクエストはそのデフォルトライフタイムを取得します
• セッションごとのオーバーライド: FORCE_PROMPT_CACHING_5Mはすべてを優先し、次に CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL、次にこのキー、次に ENABLE_PROMPT_CACHING_1H。サブエージェント独自の frontmatter 値がランク付けされる場所については、TTL を自分で選択を参照してください

{
  "subagentPromptCacheTtl": "1h"
}

​

switchModelsOnFlag

• スコープ: 任意のファイル。/config にメッセージがフラグされたときにモデルを切り替えとして表示されます。
• タイプ: ブール値
  • true: Claude Code はフォールバックモデルに切り替えて続行します
  • false: インタラクティブセッションで Claude Code は一時停止して、切り替えるかプロンプトを編集するかを選択できます。ダイアログが表示できない場所 (-p 実行など)では、フラグされたリクエストはエラーで終了します
• デフォルト: true。自動的に切り替え

{
  "switchModelsOnFlag": false
}

​

ultracode

• スコープ: 任意のファイル
• タイプ: ブール値
  • true: 動的ワークフローが有効になっており、モデルが xhigh をサポートする場合、セッションは ultracode でオンで開始されます
  • false: セッションは ultracode でオフで開始されます
• デフォルト: 設定解除されているため、ultracode はオフです
• セッションごとのオーバーライド: /effort ultracode はこのキーなしで 1 つのセッションで ultracode をオンにし、/effort ultracode off はこのキーが true の場合、1 つのセッションでそれをオフにします。--effort ultracode フラグも 1 つのセッションでそれをオンにし、xhigh 努力で、Claude Code v2.1.203 以降が必要です

{
  "ultracode": true
}

​

権限設定

​

allowManagedPermissionRulesOnly

• リポジトリの .claude/ ディレクトリ
• ~/.claude/skills/ および ~/.claude/commands/ ディレクトリ（claude.ai から同期されたスキルを含む）
• --add-dir ディレクトリ
• ~/.claude/skills/ またはプロジェクトの .claude/skills/ 内で .claude-plugin マニフェストにより宣言されたプラグイン

• スコープ: 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 はプロンプトを表示するはずのすべての呼び出しを自動的に拒否します。読み取り、承認が不要な他のアクション、事前承認されたツールは引き続き実行されます
  • "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
• Type: enabled、failIfUnavailable、autoAllowBashIfSandboxed、excludedCommands、allowUnsandboxedCommands、enableWeakerNestedSandbox、enableWeakerNetworkIsolation、allowAppleEvents、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 コマンドを権限プロンプトなしで実行します。deny ルールとコンテンツスコープ付き ask ルールの対象です。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"]
    }
  }
}

​

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

• allowWrite および denyWrite: macOS ではワイルドカードが機能します。Linux と WSL2 では、サンドボックスは具体的なパスをマウントするため、Claude Code は末尾の /** を削除した後に *、?、または [ を含むエントリをスキップし、そのエントリは効果がありません。Claude Code は Edit 権限ルールからパスを追加するため、同じ制限が適用され、/sandbox の Config タブはワイルドカードを含む Edit および Read 権限ルールについて警告します。
• denyRead および allowRead: ワイルドカードはすべてのプラットフォームで機能します。Linux と WSL2 では、Claude Code は読み取りエントリを、それが一致する具体的なパスに展開します。これは書き込みリストでは行いません。

​

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.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 を持つエントリは削除されます。
• 各ケースは警告します。エントリが低下または削除されるかどうかに関わらず、残りの有効なエントリは引き続き強制され、完全に無効な credentials 値は削除されますが、sandbox の残りは引き続き適用されます。

​

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"]
        }
      ]
    }
  }
}