すべての設定

Claude Code の settings.json キーの完全なリファレンス：各キーの場所、型とデフォルト値、貼り付け可能な例、およびすべてのキーのインデックス。

Back to index

このリファレンスページでは、Claude Code が設定ファイルから読み込む各キーと、代わりに ~/.claude.json に保持する短いキーグループを一覧表示しています。ファイルを選択するか、優先順位を確認するには、設定ファイルと優先順位から始めてください。

設定インデックス

以下の各キーは、それぞれの項目にリンクしています。Scope は、そのキーを記述できるファイルを示します。User は ~/.claude/settings.json、Project は .claude/settings.json、Local は .claude/settings.local.json、Managed は組織がデプロイするものです。Any file はこの 4 つすべてを意味し、Global config は ~/.claude.json を意味します。

モデルと応答

Claude Code が使用するモデルと、その応答のしかたを選択します。これらの設定が /model コマンドや環境変数とどのように相互作用するかについては、モデル設定を参照してください。

advisorModel

Claude がサーバー側の advisor ツールを呼び出したときに応答するモデルを選択します。設定を解除すると advisor はオフになります。advisor はメインモデルと同等以上の能力を持つ必要があります。受け入れられる組み合わせと、受け入れられない組み合わせを選択した場合の動作については、advisor モデルを選択するを参照してください。

通常、このキーを手動で編集することはありません。/advisor を実行すると、現在の選択、advisor として使用できるモデル、および No advisor を表示するピッカーが開きます。Claude Code は選択内容を ~/.claude/settings.json のこのキーに保存します。Remote Control クライアントから選択した場合や、リモートワーカーに接続されたセッションで選択した場合、その選択はそのセッションにのみ適用され、このキーは変更されません。

アカウントで使用クレジットへの同意が必要な場合は、まず /model fable を実行して同意してください。同意するまでは、/advisor で Fable を選択しても何も保存されず、Claude Code は先に /model fable を実行するよう案内します。

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

{
  "advisorModel": "opus"
}

このキーは、Amazon Bedrock や Claude Platform on AWS など、advisor が利用できないプロバイダーでは効果がありません。"fable" には Fable へのアクセスが必要です。

alwaysThinkingEnabled

これを false に設定すると、すべてのセッションで拡張思考がオフになります。思考はデフォルトでオンのため、true にしても何も変わりません。ほとんどのユーザーは、ファイルを編集するのではなく /config からこれを設定します。

Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable モデルなど、常に思考するモデルでは false は効果がありません。サードパーティプロバイダーでは、Claude Code は思考をオフにする代わりに thinking パラメータを省略するため、適応型推論モデルは引き続き思考する場合があります。Anthropic API で思考をオフにした場合、Claude Code は、Opus 5 などその組み合わせを受け付けないことが分かっているモデルに対して、より高いレベルではなく effort high を送信します。

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

{
  "alwaysThinkingEnabled": false
}

availableModels

メインセッション、サブエージェント、スキル、advisor でユーザーが選択できるモデルを制限します。管理されたリストは、/model、--model、および開発者自身のファイル内の model キーを制約し、リスト外のモデルは選択できません。デフォルトのプレフィックス一致では、これだけでは Default オプションには影響しません。Default オプションも制限するには、enforceAvailableModels と組み合わせてください。

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

この例では、Sonnet と Haiku のモデルのみを選択できるようにします。

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

"claude-opus-5" のようなモデル ID のエントリは、Opus 5.5 など、それを拡張する後続のバージョンも許可します。それらのバージョンのいずれかをブロックするには、deniedModels を使用します。各モデル ID のエントリが指定したバージョンのみを許可するようにするには、availableModelsMatch を使用します。モデル選択を制限するを参照してください。サードパーティプロバイダーの ID については、サードパーティデプロイ向けにモデルを固定するを参照してください。

availableModelsMatch

availableModels のエントリをモデル ID とどのように照合するかを選択します。デフォルトでは、モデル ID のエントリはそれを拡張する後続のバージョンも許可するため、"claude-opus-5" は Opus 5.5 を許可します。"exact" を指定すると、各モデル ID のエントリは指定したバージョンのみを許可するため、そのモデルの新しいバージョンは、リストに追加するまでブロックされたままになります。Claude Code v2.1.283 以降が必要です。

• スコープ: 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"

この例では、Opus 5 と Sonnet 5 を許可し、いずれの後続リリースも許可しません。

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

"exact" を指定した場合、リストに少なくとも 1 つのモデルまたはファミリーが指定されていれば、Default オプションもリスト内のモデルに制限されます。特定のモデルまたはバージョンをブロックするを参照してください。

deniedModels

availableModels 許可リストの有無にかかわらず、またそのリストで許可されている場合でも、特定のモデルをブロックします。Claude Code はブロックされたモデルを /model ピッカーに表示せず、availableModels が適用されるあらゆる場所でそのモデルを選択できなくなります。特定のモデルまたはバージョンをブロックするで説明しているとおり、Default オプションのセッションでもブロックされたモデルは実行されません。Claude Code v2.1.283 以降が必要です。

• スコープ: 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 のエントリは無視されます
• デフォルト: 未設定。ブロックされるモデルはありません

この例では、Opus と Sonnet のモデルを許可し、Opus 5.5 をブロックします。

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

特定のモデルまたはバージョンをブロックするを参照してください。

effortLevel

レベルを保存していないモデルに対して、デフォルトの effort レベルを設定します。低いレベルは単純なタスクでより高速かつ低コストになり、高いレベルは複雑な問題に対してより深く推論します。

自分のマシン上の対話セッションで /effort low、medium、high、xhigh を実行すると、Claude Code はこのキーに書き込むのではなく、アクティブなモデルのレベルを modelSettings の下に保存します。v2.1.251 より前は、/effort はこのキーに書き込んでいました。

同じ設定ファイル内では、Claude Code はこのキーよりもモデルごとに保存されたレベルを使用します。ファイル間の優先順位については modelSettings に記載しています。

リモートワーカーに接続されたセッション、-p の実行、および Agent SDK では、/effort はそのセッションにのみ適用されます。同様にそのセッションにのみ適用される対話的な選択については、effort レベルを調整するに記載しています。/effort が出力するメッセージに、どちらになったかが示されます。

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

{
  "effortLevel": "xhigh"
}

ユーザー設定ファイル ~/.claude/settings.json では、このキーは /effort がモデルごとにレベルを保存するようになる前に書き込んでいた古い形式であり、以前と同じ範囲、つまり Opus 5、Fable 5.1、およびそれ以前のモデルに引き続き適用されます。Opus 5.5 とそれ以降にリリースされたモデルはこのキーを無視し、レベルを保存するまでは独自のデフォルトで開始します。レベルは /effort によって modelSettings の下に書き込まれます。プロジェクト設定、ローカル設定、管理設定、および --settings では、このキーはすべてのモデルに適用されます。

enforceAvailableModels

/model ピッカーには Default オプションがあり、それが解決されるモデルについては default モデル設定で説明しています。availableModels 許可リストは指定できるモデルを制限しますが、デフォルトのプレフィックス一致ではアカウントタイプのデフォルトを再マッピングしないため、Default がリスト外のモデルに解決される場合があります。このキーはそのギャップを埋めます。Claude Code v2.1.175 以降が必要です。

組織が何らかの管理設定をデプロイしている場合、Claude Code はこのキーを管理ソースからのみ読み取り、他のファイル内のこのキーは無視します。

起動時のモデルチェックにこのキーがどのように適用されるかについては、Amazon Bedrock および Google Cloud's Agent Platform を参照してください。

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

この例では、名前による選択を Sonnet と Haiku のモデルに制限し、Default がそれらのうち最初に利用可能なものに解決されるようにします。

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

availableModels が未設定または空の場合、このキーは効果がありません。Default モデルに許可リストを適用するを参照してください。Claude Code v2.1.175 以降が必要です。

fallbackModel

プライマリモデルが過負荷または利用できない場合に Claude Code が順番に試すバックアップモデルを指定します。Claude Code はそのターンの残りの間、チェーン内で次に利用可能なモデルに切り替え、通知を表示します。チェーンがない場合、Claude Code は同じモデルで再試行した後にサーバーのエラーを表示し、ユーザーが自分で再試行するかモデルを切り替えることになります。

切り替えが発生すると、フォールバックモデルでは 1 ターンの間プロンプトキャッシュがコールドの状態になります。次のメッセージでは再びプライマリモデルが最初に試されます。

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

この例では、プライマリモデルが失敗した場合に、まず Sonnet 5、次に Haiku 4.5 を試します。

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

ほとんどの配列設定とは異なり、このキーは設定ファイル間でマージされません。このキーを定義している最も優先順位の高いファイルがチェーン全体を提供します。プロジェクトファイルで ["claude-sonnet-5"] を設定し、ユーザーファイルで ["claude-haiku-4-5"] を設定した場合、チェーンは ["claude-sonnet-5"] のみになります。Claude Code はリストから最大 3 つの異なる許可されたモデルを保持し、残りは無視します。フォールバックモデルチェーンを参照してください。

fastMode

利用可能なセッションで fast mode をオンにします。トークンあたりのコストが高くても速度を優先したい、迅速な反復作業やライブデバッグなどの対話的な作業向けです。通常、このキーを手動で編集することはありません。/fast を実行すると ~/.claude/settings.json に fastMode: true が書き込まれ、もう一度実行して fast mode をオフにするとキーが削除されます。

fast mode をサポートしているのは Opus 5.5、Opus 5、Opus 4.8 のみです。他のモデルで /fast を実行すると Opus に切り替わり、サポートされていないモデルに切り替えると fast mode はオフになります。fast mode がオンの状態でモデルを切り替えるを参照してください。

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

{
  "fastMode": true
}

fastModePerSessionOptIn

通常、/fast を実行すると fastMode がユーザー設定に保存されるため、サポートされているモデルでの新しいセッションは fast mode がオンの状態で開始します。このキーを true に設定するとこれを止められます。保存された fastMode: true はセッション開始時に fast mode をオンにしなくなり、各ユーザーは fast mode を使いたいセッションごとに /fast を実行する必要があります。Claude Code はユーザーのファイル内の fastMode キーを残すため、このキーをオフにすると以前の動作に戻ります。

Team プランまたは Enterprise プランのオーナーは、サーバー管理設定を通じて組織全体にデプロイできます。管理設定でこのキーが設定されている場合、対話型ターミナルセッション以外では /fast on が拒否され、組織によって fast mode が無効化されていることが通知されます。これには、非対話モード、VS Code 拡張機能、クラウドセッションが含まれます。

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

{
  "fastModePerSessionOptIn": true
}

セッションごとのオプトインを必須にするを参照してください。

language

Claude がデフォルトで英語以外の言語で応答するようにします。応答に使える言語の固定リストはありません。Claude Code はこの値を、常にその言語で応答するという指示としてそのまま Claude に渡すため、Claude が読み取れる言語名であれば何でも機能します。Claude Code は値をチェックしないため、スペルを誤った名前はエラーにならず、記述したとおりに Claude に渡されます。同じ値は、音声入力（こちらにはサポートされている音声入力言語の固定リストがあります）と、自動生成されるセッションタイトルの言語も設定します。

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

{
  "language": "japanese"
}

maxEffortLevel

セッションで使用できる effort レベルに上限を設け、それより低いレベルは使用可能なままにします。それより高いレベルは、/effort、/model ピッカー、--effort、CLAUDE_CODE_EFFORT_LEVEL、スキルやサブエージェントの effort フロントマター、またはモデル自体のデフォルトから指定されたものを含め、すべて上限のレベルで実行されます。Claude Code は各リクエストの前に自ら上限を適用するため、Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry を含むすべてのプロバイダーで上限が維持されます。Claude Code v2.1.267 以降が必要です。

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

この例では、すべてのモデルの上限を medium に設定し、Sonnet 4.6 を除外します。

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

組織がモデルに対して effort の制限も設定している場合は、2 つの上限のうち低い方が適用されます。

model

新しいセッションごとに使用するモデルを設定し、毎回 /model で選択しなくて済むようにします。ここで設定しても、セッションの途中で切り替えることはできます。管理者がユーザーの選択を上書きする組織のデフォルトモデルを設定している場合は、ユーザー設定、プロジェクト設定、ローカル設定でこのキーを設定していても、そのモデルが使用されます。

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

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

ここで設定した値は、ANTHROPIC_DEFAULT_MODEL よりも優先されます。Claude Code が ANTHROPIC_DEFAULT_MODEL を使用するのは、他に何もモデルを選択していない場合のみです。

modelOverrides

Anthropic のモデル ID を、Amazon Bedrock の推論プロファイル ARN などのプロバイダー固有のモデル ID にマッピングします。これにより、モデルピッカーの各エントリは、プロバイダー API を呼び出す際にマッピングされた値を使用します。管理者は Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry でこれを使用して、ガバナンス、コスト配分、リージョンルーティングのために、各モデルバージョンを特定の推論プロファイル、バージョン名、またはデプロイにルーティングします。

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

この例では、Opus 4.6 へのすべての呼び出しを指定した Bedrock 推論プロファイルにルーティングします。

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

バージョンごとにモデル ID を上書きするを参照してください。

modelPicker

/model ピッカーに表示するモデルを、記述した順序と選択したラベルで一覧にします。これにより、ピッカーには組織で実行しているモデルが、組み込みのラインナップの後に、またはその代わりに表示されます。各行の model はそのまま使用されるため、--model が受け付けるものは何でも指定できます。opus のようなエイリアス、Anthropic のモデル ID、または Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry、LLM ゲートウェイ向けのプロバイダー形式の ID です。Claude Code v2.1.242 以降が必要です。

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

この例では、チームが認識できる名前で、組み込みのラインナップの後に 2 つの Bedrock デプロイを追加します。

{
  "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 のフィールド

このキーは 2 つのフィールドを受け取ります。1 つは行そのもの用、もう 1 つはそれらの行が組み込みのラインナップを置き換えるか、追加されるかを指定するものです。

options 内のエントリには、model と並んで省略可能な behavesAs 文字列を含めることもでき、これには v2.1.257 以降が必要です。model が使用中のバージョンより新しいエントリに対して、claude-opus-4-8 など、使用中の Claude Code バージョンがすでに認識しているモデルの ID を設定します。すると Claude Code は、そのモデルを不明なモデルとして扱う代わりに、既知のモデルの機能と effort のデフォルトをそのエントリに適用します。エントリのラベルと、Claude Code がリクエストで送信するモデル ID は変わりません。

replaceBuiltInOptions がオンの場合、Claude Code は他のすべての行を非表示にします。対象は、組み込みのラインナップ、availableModels のエントリに対して追加される行、ゲートウェイ検出で見つかったモデル、および ANTHROPIC_CUSTOM_MODEL_OPTION です。オフの場合、Claude Code は組み込みのラインナップですでにカバーされているリスト内のモデルをスキップします。ラベルはピッカーの表示を変えるだけで、Claude Code が実行するモデルは変わりません。

availableModels 許可リストは、これらの行にも引き続き適用されます。リスト内のモデルを許可リストに追加する前に、マージの動作を読んでください。特定のモデル ID は、そのファミリーのワイルドカードエントリを絞り込みます。Claude Code は、ピッカーを表示する前に各行をセッションに照らしてチェックすることも行います。

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

Claude Code は解析できない行を削除し、残りを保持します。壊れた設定ファイルを修正するを参照してください。

modelPricing

表示価格ではなく、組織が実際に支払っている料金で支出を報告します。組織に契約料金がある場合に設定すると、開発者が目にする金額が請求額と一致するようになります。Claude Code はこの料金を、/usage、ステータスライン、Agent SDK の total_cost_usd、--max-budget-usd の上限、および OpenTelemetry のコストメトリクスとイベントに適用します。料金はユーザーが指定します。Claude Code が契約や Claude Console から料金を読み取ることはありません。Claude Code v2.1.242 以降が必要です。

• スコープ: 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 は表示価格で報告します

一律の割引または上乗せには multiplier のみを、モデルごとの料金には overrides のみを設定するか、両方を設定します。

この例では、Sonnet 4.6 の契約料金を設定したうえで、Sonnet の行を含むすべての金額を 15% 引き下げます。

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

すべての金額を上乗せするには、multiplier を 1 より大きく 10 以下の値に設定します。上乗せには Claude Code v2.1.271 以降が必要です。それより前のバージョンでは、1 より大きい multiplier は警告付きで無視され、設定の残りは保持されます。

料金が有効になっていることを確認する方法を含む手順については、契約料金で支出を報告するを参照してください。

modelPricing のフィールド

Claude Code は、fast mode の追加料金や米国内のみでの推論の料金を加算せず、行の料金を記述したとおりに使用します。multiplier も設定している場合、Claude Code はそれを行の料金に重ねて適用します。Claude Code は、解析できない料金を持つ行や、解析できない multiplier を削除し、残りを保持します。壊れた設定ファイルを修正するを参照してください。

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

Claude Code は、行のキーからその行がどのモデルに適用されるかを判断します。

• 組み込みモデルの 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

使用するモデルごとに effort レベルを保存します。Claude Code v2.1.251 以降が必要です。

自分のマシン上の対話セッションで、/effort または /model ピッカーの effort スライダーを使って low、medium、high、xhigh をデフォルトとして保存すると、Claude Code は使用中のモデルの下にそのレベルをここに書き込むため、このキーを自分で編集することはほとんどありません。VS Code 拡張機能のモデルピッカーでこれらのレベルのいずれかを選択した場合も、Claude Code は同じようにここに保存します。/effort がそのセッションにのみ適用されるセッションについては、effortLevel のエントリに記載しています。

保存したレベルを変更または削除するには、このキーを手動で編集します。

ここでのモデルの effortLevel は、同じ設定ファイル内のトップレベルの effortLevel よりも優先されます。ファイル間では、Claude Code はモデルごとに個別に解決します。そのモデルの effortLevel、またはそのモデルに適用されるトップレベルの effortLevel のいずれかを設定している、最も優先順位の高い設定ファイルが決定するため、管理設定の effortLevel はユーザー設定に保存したレベルよりも優先されます。起動時の --effort など、保存されたレベルを上書きできるその他の要素については、effort レベルを調整するに記載しています。

1 つのモデルのレベルを設定するのではなく effort に上限を設けるには、そのモデルのエントリに maxEffortLevel フィールドを追加します。このフィールドには Claude Code v2.1.267 以降が必要です。

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

Claude Code は各エントリを claude-opus-5-5 のようなモデルの正規名の下に書き込み、そのモデルのエイリアス、日付サフィックス付き、[1m]、および認識されたプロバイダー固有の ID を同じエントリに照合します。

この例では、他のモデルがそれぞれ保存済みまたはデフォルトのレベルを使用する一方で、Opus 5.5 を high に保ちます。

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

使用中のモデルについて保存したレベルをクリアするには、/effort auto を実行します。Claude Code は、他のエントリとトップレベルの effortLevel をそのまま残します。

outputStyle

名前で出力スタイルを選択します。出力スタイルとは、Claude の役割、トーン、出力形式を変更する指示の保存済みセットで、組み込みの Explanatory スタイルや Learning スタイル、または自分で作成したスタイルなどがあります。

セッション中にこのキーを変更すると、Claude は次のメッセージから新しいスタイルを使用します。そのメッセージのプロンプトキャッシュにおけるコストについては、出力スタイルの変更を参照してください。v2.1.251 より前は、変更は /clear を実行するか新しいセッションを開始した後にのみ適用されていました。

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

この例では、タスクの合間に教育的な解説を追加する組み込みの Explanatory スタイルを選択します。

{
  "outputStyle": "Explanatory"
}

promptCacheTtl

プロンプトキャッシュがメインの会話を保持する期間を選択します。このキーは、対話、-p、および Agent SDK のターンと、それらとインラインで Claude Code が実行するヘルパーに適用されます。1 時間の有効期間では、長めの休憩をはさんでもキャッシュがウォームな状態に保たれますが、API は 5 分の有効期間よりも高い料金で各キャッシュ書き込みを請求します。Claude Code v2.1.242 以降が必要です。

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

この例では、メインの会話を 1 時間の有効期間に保ち、サブエージェントは 5 分のままにします。

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

各有効期間のコストについては、キャッシュの有効期間を参照してください。

showThinkingSummaries

対話セッションで Claude の拡張思考の要約を表示します。Ctrl+O で思考を展開したときに完全な要約を表示したい場合に設定します。未設定または false の場合、Anthropic API は思考ブロックを編集済み（非表示）にし、Claude Code は折りたたまれたスタブを表示します。

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

{
  "showThinkingSummaries": true
}

編集による非表示化で変わるのは表示内容だけであり、モデルが生成する内容は変わりません。思考の費用を削減するには、代わりに予算を下げるか思考を無効にします。

subagentPromptCacheTtl

Claude Code がメインの会話の外で行うリクエストをプロンプトキャッシュが保持する期間を選択します。このキーは、サブエージェント、ワークフロー、およびコンテキスト圧縮やセッションタイトルなど、Claude Code 自身のバックグラウンドリクエストとヘルパーリクエストに適用されます。1 時間の有効期間では、長めの休憩をはさんでもキャッシュがウォームな状態に保たれますが、API は 5 分の有効期間よりも高い料金で各キャッシュ書き込みを請求します。Claude Code v2.1.242 以降が必要です。

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

この例では、サブエージェントとメインの会話の外で行われるその他のリクエストに 1 時間の有効期間を与えます。

{
  "subagentPromptCacheTtl": "1h"
}

このキーは promptCacheTtl が対象としないリクエストをカバーするため、両方を設定すると Claude Code が行うすべてのリクエストの有効期間を選択できます。サブエージェントのキャッシュがメインの会話のキャッシュとどのように異なるかについては、サブエージェントとキャッシュを参照してください。

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

ultracode をオンにした状態でセッションを開始します。オンにすると、Claude はユーザーからの依頼を待たずに、実質的なタスクごとにワークフローを計画します。Claude がワークフローを計画するのは、ユーザーに対して動的ワークフローが有効で、かつモデルが xhigh の effort をサポートしている場合のみです。このキーはセッションの effort レベルを変更しません。ultracode はセッションが使用しているレベルで実行されます。Claude Code はこのキーを読み取りますが、書き込むことはありません。/effort ultracode は現在のセッションに限り 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
}

セッションの effort レベルは、effortLevel、modelSettings、およびその他の effort のソースから決まります。maxEffortLevel などの effort の上限は、ultracode をオフにすることなくそのレベルを引き下げます。この動作と /effort ultracode off の形式には Claude Code v2.1.284 以降が必要です。v2.1.284 より前は、ultracode: true はセッションを xhigh の effort で実行し、xhigh 未満の effort の上限があると ultracode はオフのままでした。Agent SDK の apply_flag_settings コントロールリクエストもこのキーを受け付けます。

権限設定

Claude が何を確認なしで実行できるか、新しいセッションのデフォルトの権限モード、auto モードの分類器が何を許可するかを決定します。ルール構文と権限モデルについては、権限を設定するを参照してください。

allowManagedPermissionRulesOnly

管理設定を権限ルールの唯一の設定ソースにします。Claude Code はユーザー、プロジェクト、ローカル、および --settings ファイル内の allow、ask、deny ルールを無視し、--allowedTools を無視し、権限プロンプトで常に許可する選択肢を非表示にし、新しいルールの保存を停止します。

埋め込みホストからの親設定が適用される場合、Claude Code はそれらを管理層の一部として扱います。それらの allow ルールと additionalDirectories を削除し、deny および ask ルールは保持します。ただし、パターンが ! で始まる Read および Edit ルールは除きます。このキーを設定しているかどうかに関わらず、ホストは ! ルールで管理ルールからパスを除外することはできません。

--disallowedTools ルールと現在のセッションの deny および ask ルールは、Claude Code が設定をセッション中に再度読み込んだ後を含めて、引き続き適用されます。これらは制限のみを行うため、管理ルールが付与するものを拡大することはできません。v2.1.257 より前では、Claude Code は最初の設定再度読み込み時にそれらのコマンドラインおよびセッションルールを削除していました。

--disallowedTools またはセッションルール内の ! パターンが除外できるものについては、Read および Edit ルールを参照してください。

このキーを設定すると、Claude Code v2.1.282 以降では、次のソースにあるスキルおよび .claude/commands/ ファイルの allowed-tools フロントマターも無視されます。

• リポジトリの .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 以降で実行されている

管理設定からのスキルとバンドルスキルは allowed-tools を保持します。これらの Desktop セッション外の @inline プラグインも、anthropic-skills という名前のものを除き、それを保持します。スキルの disallowed-tools は引き続き適用されます。Claude Code がこのフィールドを無視したときに開発者に何が表示されるかについては、管理権限ルールのみが適用される場合を参照してください。

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

{
  "allowManagedPermissionRulesOnly": true
}

このキーは MCP サーバーの許可リストをロックダウンしません。そのためには、allowManagedMcpServersOnlyを設定してください。管理のみの設定を参照してください。

autoMode

auto モードの分類器がブロックおよび許可するものに独自のルールを追加します。これを使用して、分類器に組織が信頼するリポジトリ、バケット、ドメインを伝え、日常的な内部操作のブロックを停止させます。分類器には組み込みの許可および拒否ルールが付属しています。リテラル文字列 "$defaults" を配列に含めて、それらの組み込みルールをその位置に保持し、その周りに独自のルールを追加します。省略すると、それらを独自のルールに置き換えます。

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

この例は、"$defaults" を通じて組み込みの soft_deny ルールを保持し、terraform apply をブロックするルールを 1 つ追加します。

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

これらのファイルの複数が同じ配列を設定する場合、Claude Code はエントリを連結します。ルール形式と各配列の適用方法については、auto モードを設定するを参照してください。

autoMode.classifyAllShell

auto モードがアクティブな間、すべての Bash および PowerShell コマンドを auto モードの分類器に通します。デフォルトでは、auto モードは任意のコードを実行できる許可ルールのみを一時停止します。具体的には、Bash(*) などのツール全体およびワイルドカードのルールと、Bash(python *) などのインタープリタまたはシェルラッパーのプレフィックスです。Bash(npm test) など、それ以外の許可ルールに一致するコマンドは、コマンドごとの許可ドメインを持たない限り分類器をスキップします。スキップした場合、ルールのプレフィックスが想定していなかった破壊的な引数が見過ごされたまま通過する可能性があります。このキーを設定すると、セッションのすべてのシェル許可ルールが一時停止され、分類器がすべてのコマンドを確認します。Claude Code v2.1.193 以降が必要です。

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

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

すべてのシェルコマンドを分類器にルーティングするを参照してください。

disableAutoMode

auto モードを Shift+Tab サイクルから削除します。--permission-mode auto、設定ファイル、または組み込みデフォルトからauto モードで開始する可能性があるセッションは、代わりに default で開始します。管理者は管理設定で設定して、組織内の開発者が auto モードを使用するのを防ぎます。

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

{
  "disableAutoMode": "disable"
}

permissions

Claude が確認なしで使用できるツール、プロンプトを表示するツール、ブロックされるツールを制御します。また、新しいセッションのデフォルトの権限モードも設定します。以下のすべての permissions.* キーはこのオブジェクトの下にネストされます。

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

この例は npm run コマンドを確認なしで承認し、git push の前にプロンプトを表示し、.env の読み取りをブロックし、セッションを acceptEdits で開始します。

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

3 つのルール配列は 1 つの構文を共有します。permissions.allow の下の権限ルール構文を参照してください。異なるファイルからの権限ルールがどのように結合されるかについては、スコープ全体での権限ルールのマージ方法を参照してください。一般的に設定キーがどのように結合されるかについては、設定ガイドの設定の優先順位を参照してください。

useAutoModeDuringPlan

Claude Code が plan モード中にシェルコマンドを確認するために auto モードの分類器を使用するかどうかを選択します。デフォルトの true では、auto モードが利用可能な場合、分類器は計画中に各コマンドを確認し、プロンプトは表示されません。ただし、重要パスの削除を除きます。false に設定すると、組み込みの読み取り専用セット外のすべてのコマンドに対して権限プロンプトが表示されます。/config に Use auto mode during plan として表示されます。

• スコープ: User, local, or managed。リポジトリがこれをオフにすることはできません。
  • これらのファイルのいずれか、または --settings で false が設定されていると、オフになります。ただし、--setting-sources などのオプションでそのユーザーまたはローカルファイルを除外した場合は除きます。除外されたファイルを無視するには Claude Code v2.1.314 以降が必要です
• タイプ: ブール値
  • true: 未設定と同じです。auto モードが利用可能な場合、分類器は計画中にシェルコマンドを確認します
  • false: 組み込みの読み取り専用セット外のすべてのコマンドに対して権限プロンプトが表示されます
• デフォルト: true

{
  "useAutoModeDuringPlan": false
}

permissions.allow

Claude Code が確認なしで承認するツール使用をリストします。MCP ルールでは、* はツール名内の mcp__<server>__ プレフィックスの後にのみ使用できます（例：mcp__github__get_*）。サーバー名には使用できません。

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

この例は git diff を承認し、Claude Code が確認なしに .zshrc を読み取ることを許可します。

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

Claude Code はプロジェクトの .claude/settings.json から allow ルールを適用するのは、そのフォルダのワークスペース信頼ダイアログを受け入れた後のみです。

権限ルール構文

権限ルールは Tool または Tool(specifier) の形式に従います。Claude Code は deny ルールを最初に評価し、次に ask、次に allow を評価し、各ルールの具体性に関係なく最初に一致したものが結果を決定します。権限ルール評価順序を参照してください。

各行は 1 つのルール形状とそれが一致するものを示します。

ワイルドカード動作、Read、Edit、WebFetch、MCP、Agent ルールのツール固有パターン、および Bash パターンのセキュリティ制限を含む完全なルール構文については、権限ルール構文を参照してください。

permissions.ask

acceptEdits や bypassPermissions など、本来であれば承認される権限モードであっても確認を求めるツール使用をリストします。dontAsk モードでは、Claude Code は一致するツール使用に対してプロンプトを表示する代わりに拒否します。

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

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

permissions.deny

Claude Code がブロックするツール使用をリストします。API キー、シークレット、または環境値を保持するファイルに使用します。Claude Code は一致するファイルをファイル検出と検索結果から除外し、それらの読み取りを拒否し、一致するパスのEdit および Write ツールをブロックします。

Read および Edit 拒否ルールは Claude の組み込みファイルツール、Claude Code が Bash で認識するファイルコマンド（cat、head、tail、sed、tee など）、および > file や < file などの Bash リダイレクションのターゲットに適用されます。ファイル名を指定せずにファイルを読み取るコマンド（grep -r pattern . など）や任意のサブプロセスには適用されないため、OS レベルで強制するにはサンドボックスを有効にしてください。

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

この例は .env ファイル、secrets ディレクトリ、認証情報ファイルの読み取りを拒否し、curl コマンドをブロックします。

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

ツール名はグロブパターンを受け入れるため、"*" はすべてのツールを拒否し、"mcp__*" はすべての MCP ツールを拒否します。Claude Code は、他のツールがまだ Claude で利用可能である限り、EndConversationツールの拒否ルールを無視します。Bash 拒否ルールは Claude が書いたコマンドと一致するため、Bash(curl *) は /usr/bin/curl や sh -c 'curl …' を停止しません。Bash ルールが一致しないものを参照してください。このキーは非推奨の ignorePatterns 設定に置き換わるものです。

permissions.additionalDirectories

Claude に開始したディレクトリ外のディレクトリへのファイルアクセスを付与し、追加の作業ディレクトリとして使用します。ほとんどの .claude/ 設定は、これらのディレクトリから検出されません。

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

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

allow ルールと同様に、プロジェクトの .claude/settings.json のエントリは、そのフォルダのワークスペース信頼ダイアログを受け入れた後にのみ有効になります。

permissions.blockReadsOutsideWorkingDirectories

bypassPermissions を含むすべての権限モードで、Claude のファイルツールが作業ディレクトリ外の読み取りを拒否するようにします。Claude Code はそれらのパスに対する Read、Grep、Glob、LSP の呼び出しを拒否し、/add-dir でディレクトリを追加するようユーザーに求めるよう Claude に指示します。Claude Code 自体が必要とするファイル（~/.claude/ の下のスキル、プラグイン、ルール、エージェント、コマンド、CLAUDE.md メモリファイルなど）は読み取り可能なままです。Claude Code v2.1.257 以降が必要です。

Claude Code はシェルコマンドを同じ方法では拒否しません。

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

シェルパーサーが追跡できない Bash コマンド（複数回ディレクトリを変更するものやサブシェルを実行するものなど）は、auto モードおよび bypassPermissions モードでもプロンプトを表示します。プロンプトは、コマンドが作業ディレクトリ外のパスを指定していない場合でも表示されます。このプロンプトは、コマンドがサンドボックスで実行され、サンドボックスがブロックを強制する場合には適用されません。

また、作業ディレクトリ外の最初の読み取り前に表示される auto モードのプロンプトでそのような読み取りをブロックすることを選択した場合も、Claude Code はここに true を書き込みます。

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

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

ブロックを解除するには、それを設定しているすべての設定ファイルからキーを削除し、実行中の各セッションを再起動します。

--add-dir、/add-dir、またはユーザー設定や管理設定の additionalDirectories で追加したディレクトリは、ブロックにおいて作業ディレクトリとしてカウントされます。リポジトリ設定でのみ追加されたディレクトリはカウントされません。該当するのは .claude/settings.json のディレクトリと、git がそのファイルを未追跡として報告する場合を除く .claude/settings.local.json のディレクトリです。git リポジトリではないディレクトリ、または git がそのファイルを追跡している場合、Claude Code は .claude/settings.local.json をリポジトリ設定として扱うため、読み取り可能にしておきたいディレクトリは代わりにユーザー設定に配置してください。

autoMemoryDirectoryがプロジェクトの .claude/settings.json から、またはリポジトリ提供として扱われる.claude/settings.local.json から来る場合、Claude Code はそのディレクトリから自動メモリを読み込まず、そこに保存もしません。

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

サンドボックス化がオンの場合、ブロックはサンドボックス化されたコマンドにも適用されます。Claude Code はホームディレクトリおよびユーザーファイルを保持する他のルート（/Users、/home、/root、/Volumes、/mnt、/media、/run/media、/srv）への読み取りアクセスを拒否します。その後、作業ディレクトリ、Claude Code がセッション中に作成する worktree、セッションの一時ディレクトリ、およびコマンドが必要とする ~/.claude の部分（スキルやプラグインなど）を再度開きます。ブロックが有効な間、リポジトリ設定からの allowRead および allowWrite エントリはカウントされません。

セッションの作業ディレクトリがリンクされた git worktree である場合（Claude Code がセッション中に入ったものを含む）、リポジトリの共通 .git ディレクトリはサンドボックス化されたコマンドに対して読み取り可能および書き込み可能なままなので、git はそこで引き続き機能します。

次の場合、ブロックはサンドボックス化されたコマンドには及びませんが、Claude のファイルツールは引き続きそれを強制します。

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

ブロック下で、Claude Code はサンドボックス化されたコマンドに対してグローバル git 設定ファイルを再度開くため、git はユーザーのアイデンティティと設定を保持します。

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

Claude Code は各ファイルを個別に判断します。ファイルが、サンドボックス化されたコマンドが直接またはシンボリックリンクを通じて書き込める場所にある場合、Claude Code はそのファイルが指定するファイルを再度開きません。

Linux および WSL2 では、シンボリックリンクである設定ファイルはそれ自身のパスで読み取り不可のままになることがあり、その場合 git はそのファイルなしで実行されます。~/.git-credentials および $XDG_CONFIG_HOME/git/credentials はブロックされたままです。

再度開いたファイルがシークレット（http.extraHeader トークンなど）を保持する場合、そのパスを sandbox.filesystem.denyRead に追加してください。ファイルをカバーする denyRead エントリは、常にこの再度開く処理より優先されます。

permissions.blockWritesOutsideWorkingDirectories

bypassPermissions を含むすべての権限モードで、Write、Edit、NotebookEdit ツールが作業ディレクトリ外のパスを拒否するようにします。ただし、Claude Code 自身の一部のファイルは除きます。このキーは、シェルコマンド、MCP ツール、またはフックが実行するプログラムを制限しません。シェルコマンドの書き込み先を制限するには、サンドボックス化をオンにしてください。Claude Code v2.1.314 以降が必要です。

このキーがオンになると、Claude Code は EnterWorktree および ExitWorktree ツールも削除するか、それらへの呼び出しを拒否します。worktree での作業を続けるには、Claude に EnterWorktree ツールがないの手順に従ってください。

• スコープ: Any file。セッションが読み込むいずれかのファイルの true が適用されるため、リポジトリは自身に対してブロックをオンにできますが、ユーザーが設定したブロックを解除することはできません。クラウドセッションでは、ファイルツールがそれ自体が境界となるコンテナ内で実行されるため、Claude Code がこのキーを適用しない場合があります。
• タイプ: ブール値
  • true: ブロックをオンにします
  • false: 未設定と同じです。別のファイルが true を設定している場合、ブロックは引き続き適用されます
• デフォルト: 未設定。作業ディレクトリ外への書き込みは権限モードに従います。Claude Code が管理設定の permissions オブジェクトを読み取れない間も、ブロックはオンになります。

{
  "permissions": {
    "blockWritesOutsideWorkingDirectories": true
  }
}

ブロックをテストするには、作業ディレクトリ外にファイルを作成するために Write ツールを使用するよう Claude に依頼します（ホームディレクトリが作業ディレクトリに含まれていない場合は ~/block-test.txt など）。Claude Code はその呼び出しを拒否し、拒否メッセージには設定によって作業ディレクトリ外への書き込みがブロックされていることが示されます。

ブロックを解除するには、それを設定しているすべての設定ファイルからキーを削除し、Claude Code を再起動します。

書き込みブロックが拒否するものと書き込み可能なままのもの

Claude Code 自身の一部のファイルは書き込み可能なままです。たとえば、プランファイル、スクラッチパッド、バックグラウンドセッションの tmp ディレクトリ、このプロジェクトの自動メモリ内の .md ファイルなどです。

作業ディレクトリ外にあるユーザー自身のファイルに加えて、ブロックは次への書き込みを拒否します。

• Claude Code の設定ファイル: 設定ファイルはブロックを解除できるため、Claude Code は作業ディレクトリ内でもこれらの書き込みを拒否します。設定ファイルはユーザー自身で編集してください。
• リポジトリ設定のみが追加するディレクトリ: additionalDirectories が .claude/settings.json のみ、または git がそのファイルを未追跡として報告する場合を除き .claude/settings.local.json のみでリストしているディレクトリ
• サブエージェントの worktree: isolation: worktree サブエージェントの worktree が作業ディレクトリ外にある場合、そのファイル編集は拒否されます
• リポジトリが選択したディレクトリ内の自動メモリ: リポジトリ設定で autoMemoryDirectory が指定するディレクトリ

何を追加しても、設定ファイルへの書き込みは拒否されたままです。それ以外のいずれかのケースで書き込みを通すには、作業ディレクトリを追加します。/add-dir には存在するディレクトリが必要なため、サブエージェントの worktree については、リポジトリルートの .claude/worktrees ディレクトリを指定してください。

読み取りまたは書き込みのブロックに 1 つのディレクトリを通す

blockReadsOutsideWorkingDirectories または blockWritesOutsideWorkingDirectories が true の間に Claude がプロジェクト外の 1 つのディレクトリにアクセスできるようにするには、そのディレクトリを作業ディレクトリとして追加します。セッション内で /add-dir <directory> を実行するか、Claude Code の開始時に --add-dir <directory> を渡すか、ユーザー設定または管理設定の additionalDirectories にリストしてください。どちらのブロックについても、Claude のファイルツールを通過させる許可ルールはありません。

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

権限ルールはすべてのモードの上に重ねて適用されます。deny ルールは bypassPermissions を含むすべてのモードでブロックします。権限モードを参照してください。クラウドセッションでは、Claude Code はこのキーのうち acceptEdits、plan、default、auto のみを尊重します。VS Code 拡張機能が開始する会話については、拡張機能が開始権限モードとして読み取る設定を参照してください。

permissions.disableBypassPermissionsMode

誰も bypassPermissions モードに入れないようにします。Claude Code は --dangerously-skip-permissions フラグを拒否し、エージェント定義の permissionMode: bypassPermissions を無視するため、サブエージェントは親セッションの権限モードで実行されます。

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

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

v2.1.223 より前では、Claude Code はバイパスが無効になっていてもフロントマターの権限モードを適用していました。

skipAutoPermissionPrompt

組み込みデフォルトによってセッションが auto モードで開始された場合ではなく、ユーザー自身の設定やモードセレクターなどを通じて初めて auto モードに入ったときに Claude Code が表示する、auto モードを説明する 1 回限りの通知をスキップします。Claude Code はその通知を 1 回表示した後、表示済みであることを記録するため、このキーは通知がまだ表示されていない場合にのみ意味を持ちます。

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

{
  "skipAutoPermissionPrompt": true
}

skipDangerousModePermissionPrompt

--dangerously-skip-permissions からか defaultMode: "bypassPermissions" からかに関わらず、セッションが bypassPermissions モードに入る前に Claude Code が表示する確認ダイアログをスキップします。そのダイアログを一度受け入れると、Claude Code はユーザー設定のこのキーに true を書き込みます。

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

{
  "skipDangerousModePermissionPrompt": true
}

サンドボックス設定

Claude が実行するコマンドをファイルシステム、ネットワーク、認証情報から分離します。サンドボックスの仕組みとプラットフォーム要件については、サンドボックスを参照してください。

sandbox

サンドボックスを使用して、Claude が実行する Bash コマンドをファイルシステムとネットワークから分離します。enabled でサンドボックスをオンにしてから、filesystem、network、credentials サブオブジェクトを使用して、サンドボックス化されたコマンドが何にアクセスできるかを制限または拡大します。サンドボックスは macOS、Linux、WSL2 で実行されます。

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

これはサンドボックスをオンにし、サンドボックス化されたコマンドの権限プロンプトをスキップし、docker をサンドボックスの外で実行し、2 つの追加の書き込みパスを開き、AWS 認証情報ファイルを非表示にし、GitHub と npm を事前に許可します：

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

管理設定が enabled や failIfUnavailable などのブール値キーを設定した場合、その値は開発者が設定したものをすべて上書きします。Claude Code は配列キーをセッションが読み込む設定スコープ全体でマージするため、開発者はエントリを追加できます。管理設定専用のロックについては、ポリシーの拡大を開発者に防止させるを参照してください。組織に対してサンドボックスを必須にするには、管理設定でサンドボックスを強制するを参照してください。

sandbox.enabled

Bash コマンドのサンドボックスをオンにします。/sandbox パネルでモードを選択すると、Claude Code はこのキーを現在のプロジェクトの .claude/settings.local.json に書き込みます。~/.claude/settings.json に設定して、すべてのプロジェクトをサンドボックス化します。

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

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

Linux と WSL2 では、サンドボックスは bubblewrap と socat が必要です。Linux と WSL2 をセットアップするを参照してください。サンドボックスが起動できない場合、failIfUnavailable も設定していない限り、Claude Code はコマンドをサンドボックスなしで実行します。

sandbox.failIfUnavailable

sandbox.enabled が true であるにもかかわらず、プラットフォームが非対応であるか依存関係チェックが失敗したためにサンドボックスを起動できない場合に、Claude Code を起動時にエラーで終了させます。このキーがない場合、Claude Code はサンドボックスなしでコマンドを実行します。セキュリティゲートとしてサンドボックス化を必須とする管理されたデプロイでは、この設定を使用できます。

サンドボックスがサポートしていないプラットフォームでは、このキーがオンの場合、Claude Code は起動しません。管理設定でサンドボックスを強制するを参照してください。

• Scope: Any file（プロジェクト設定とローカル設定には制限あり）
• 型: ブール値
  • true: sandbox.enabled が true でもサンドボックスを起動できない場合、Claude Code は起動時にエラーで終了します。サンドボックスがこのチェックを通過した後に初期化に失敗した場合、セッションは実行を続け、Claude Code はサンドボックス化された各コマンドを拒否します
  • false: サンドボックスを起動できない場合、Claude Code はサンドボックスなしでコマンドを実行します
• Default: false

次の例では、管理対象のマシンでサンドボックスをオンにし、failIfUnavailable を true に設定します。

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

管理設定でサンドボックスを強制するを参照してください。

sandbox.autoAllowBashIfSandboxed

Claude Code がサンドボックス化された Bash コマンドを権限プロンプトなしで実行できるようにします。サンドボックスで実行できないコマンドは通常の権限フローを通過し、deny ルールと Bash(git push *) などのコンテンツスコープ付き ask ルールは引き続き適用されます。ベアの Bash ask ルールはサンドボックス化されたコマンドではスキップされます。これを false に設定して、サンドボックス化されたコマンドも通常の権限フローを通すようにします。これは /sandbox Mode タブが通常権限モードと呼ぶものです。

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

これはサンドボックスをオンに保ち、サンドボックス化されたコマンドを通常の権限フローを通します：

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

自動許可モードで引き続きプロンプトが表示される操作と、plan モードでの動作については、自動許可モードを参照してください。

sandbox.excludedCommands

Claude Code がサンドボックスの外で実行するコマンド（サンドボックスで動作しないツールなど）に名前を付けます。各エントリは、Bash(...) 権限ルールの内容と同じ構文を使用します：正確なコマンド、docker * などのプレフィックス、またはワイルドカードパターン。ワイルドカードを含まないパターンは完全一致となるため、docker は引数なしの docker にのみ一致します。

エントリは、Bash 呼び出しのすべてのコマンドをカバーする場合にのみ、Bash 呼び出しをサンドボックスから外します。一部の呼び出し形式はそれでもサンドボックス化されたままです。docker * エントリだけでは、npm ci && docker build . をサンドボックスから外しません。

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

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

Claude Code は、Bash 呼び出しが以下のような形状のいずれかを持つ場合、その呼び出しをサンドボックス化したままにします：

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

たとえば、cd build && docker compose up は docker * エントリの下でサンドボックス化されたままであり、cd エントリを追加してもそれは変わりません。git * エントリの下では、git clone <url> vendor/lib はサンドボックスの外で実行されますが、git clone <url> ~/tools はサンドボックス化されたままです。クローンは、宛先パスが指す場所に、実行可能なものを含む可能性のあるファイルツリー全体を書き込みます。

除外されたコマンドも通常の権限フローを通過します。除外は便宜的なものであり、セキュリティ境界ではありません。ツールが特定の場所にのみ書き込む必要がある場合は、filesystem.allowWrite を使えばサンドボックス化されたままにできます。

サンドボックスが管理者必須でない限り、セッションが読み込む設定スコープのエントリは 1 つのリストに結合されます。管理者必須の間、Claude Code は .claude/settings.json と .claude/settings.local.json のエントリを無視するため、クローンしたリポジトリがコマンドをサンドボックスの外に出すことはできません。管理設定、--settings、および ~/.claude/settings.json のエントリは引き続き適用され、このリストに対する管理設定専用のロックはありません。

sandbox.allowUnsandboxedCommands

サンドボックスによってブロックされた後、Claude が dangerouslyDisableSandbox パラメータを使用してコマンドをサンドボックスの外で再試行できるようにします。false の場合、Claude Code はそのパラメータを無視します。その結果、サンドボックスの実行中は、Claude が実行するコマンドは excludedCommands のエントリに一致しない限りサンドボックス化されます。/sandbox Overrides タブはその状態を厳密なサンドボックスモードとして表示します。管理設定で false にすると、その対象となる開発者に対して厳密なサンドボックスモードがオンになります。

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

これにより、管理設定がカバーするすべてのユーザーに対して厳密なサンドボックスモードが強制されます：

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

管理設定または --settings からの false は、サンドボックスを管理者必須にもします。ユーザー設定の false はプロジェクトの true よりも優先されますが、サンドボックスを管理者必須にはしません。プロジェクトの値よりも優先させるには Claude Code v2.1.285 以降が必要です。

サンドボックスなしの再試行を誰が承認するかは、権限モードと許可ルールによって決まります。サンドボックスなしの再試行エスケープハッチを参照してください。

! シェルモードプロンプトで自分で入力するコマンドがサンドボックス化されるときを確認するには、厳密なサンドボックスモードを参照してください。

sandbox.filesystem

サンドボックス化されたコマンドが読み取りおよび書き込みできるパスを制御します。デフォルトでは、作業ディレクトリ、ユーザーごとの一時ディレクトリ、--add-dir、/add-dir、または permissions.additionalDirectories で追加したディレクトリに書き込むことができ、認証情報ファイルを含むファイルシステムの残りの部分を読み取ることができます。4 つのパスリストで制限または拡大するか、disabled でファイルシステムレイヤーをオフにします。ファイルシステム分離のデフォルト境界を参照してください。

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

これにより、サンドボックス化されたコマンドはビルドディレクトリと kubeconfig に書き込むことができ、AWS 認証情報ファイルを非表示にします：

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

Claude Code はこれらのリストを OS サンドボックス境界で強制するため、kubectl、terraform、npm などのサンドボックス化されたコマンドが開始するすべてのサブプロセスに適用されます。Claude Code は権限ルールを同じリストに追加します：Edit 許可および拒否ルールを allowWrite および denyWrite に、Read 拒否ルールを denyRead に、WebFetch(domain:...) 許可および拒否ルールをnetworkドメインリストに追加します。

ロックが適用されない限り、Claude Code はセッションが読み込む設定ファイル全体でこれらのリストをマージします。allowManagedReadPathsOnlyは allowRead を管理設定からのエントリに制限し、allowManagedDomainsOnlyは許可されたドメインに対して同じことを行います。リポジトリロックは、リポジトリの設定ファイルからのエントリを除外します。

サンドボックスを設定するは、--setting-sources で除外するソースをカバーしています。セッション中にリストを編集すると、Claude Code は実行中のセッションに変更を適用します。

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

allowWrite、denyWrite、denyRead、allowRead、および credentials.files のパスはプレフィックスで解決されます：

絶対パスの //path プレフィックスも機能します。プロジェクト相対解決を期待して単一スラッシュ /path を使用する場合は、./path に切り替えます。この構文は、//path を絶対パスに、/path をプロジェクト相対に使用するRead および Edit 権限ルールとは異なります。サンドボックスファイルシステムパスは標準規則を使用するため、/tmp/build は絶対パスです。

Claude Code はディレクトリパスから末尾のスラッシュを削除するため、~/.aws と ~/.aws/ は同じディレクトリと一致します。v2.1.224 より前では、Claude Code は末尾のスラッシュをサンドボックスに渡していたため、末尾のスラッシュ付きで記述された denyRead または denyWrite エントリの下のパスを、Claude が引き続き読み取りまたは書き込みできました。

サンドボックスパスでワイルドカードが機能する場所

ワイルドカード *、?、** は、macOS では 4 つの sandbox.filesystem パスリストすべてで機能しますが、Linux と WSL2 では機能する場所が限られます：

~/keys/*.pem では、ワイルドカードは最初のディレクトリ名より後にあります。ホームディレクトリが /home/alice の場合、最初のディレクトリ名は home です：

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

Linux と WSL2 では、セッション内の /sandbox の Config タブに、末尾の /** 以外のワイルドカードを含む Edit 権限ルールについての警告が表示されます。それらのワイルドカードは、サンドボックス化されたコマンドには機能しません。ルールが対象とすべき各パス、またはそれらを含むディレクトリを、許可ルールの場合は allowWrite に、拒否ルールの場合は denyWrite に追加してください。

角括弧、波括弧、丸括弧を含むディレクトリ名

名前に角括弧を含むディレクトリを許可またはブロックするには、./app/[slug] のように名前をそのまま記述します。このエントリでは、[slug] は角括弧を含めてディレクトリの実際の名前です：

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

このエントリはディレクトリ配下のすべてを対象とするため、末尾の /** は付けないでください。macOS、Linux、WSL2 では、サンドボックス化されたコマンドの起動時に app/[slug] ディレクトリが存在している必要があります。

• [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

作業ディレクトリ、ユーザーごとの一時ディレクトリ、--add-dir、/add-dir、または permissions.additionalDirectories で追加したディレクトリを超えて、サンドボックス化されたコマンドが書き込むことができるパスを追加します。kubectl やビルドツールなどのサブプロセスがプロジェクト外に書き込む必要がある場合に使用します。

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

これにより、ビルドは /tmp/build の下に書き込むことができ、kubectl は kubeconfig を更新できます：

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

Claude Code は allowWrite エントリと Edit(...) 許可権限ルールからのパスをセッションが読み込むすべての設定スコープ全体でマージし、permissions.blockReadsOutsideWorkingDirectoriesがオンの間、リポジトリ設定からのものを除外します。リポジトリロックによってリポジトリのエントリが除外されることもあります。allowWrite エントリは保護されたパスを解除できません。

sandbox.filesystem.denyWrite

サンドボックス化されたコマンドが特定のパスへの書き込みをブロックします。これには、別の方法で書き込み可能なディレクトリ内のパスが含まれます。

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

これにより、サンドボックス化されたコマンドがシステム設定を変更したり、バイナリをインストールしたりするのを防ぎます：

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

Claude Code はセッションが読み込むすべての設定スコープ全体でエントリをマージし、Edit(...) 拒否権限ルールからのパスを追加します。

sandbox.filesystem.denyRead

サンドボックス化されたコマンドが特定のパス（デフォルトの読み取りポリシーが公開する認証情報ファイルなど）の読み取りをブロックします。認証情報ファイルを保護し、サンドボックスプロキシを通じて使用可能に保つには、代わりに sandbox.credentials を参照してください。

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

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

Claude Code はセッションが読み込むすべての設定スコープ全体でエントリをマージし、Read(...) 拒否権限ルールからのパスを追加します。filesystem.disabledが true の場合、Claude Code はこれらのエントリを強制しません。

sandbox.filesystem.allowRead

denyReadがブロックする領域内の特定のパスの読み取りを再度開き、ワークスペースのみの読み取りアクセスを構築します。正確またはワイルドカード denyRead エントリは、より広い allowRead 内でブロックされたままです。重複テーブルが示すとおりです。ワイルドカード denyRead エントリ（~/**/.env など）がディレクトリと一致する場合、Claude Code はその内容の読み取りもブロックします。v2.1.236 より前の macOS では、Claude Code はワイルドカード denyRead エントリが一致したパスを、より広い allowRead エントリがカバーしている場所で再度開き、一致したディレクトリの内容を読み取り可能なままにしました。

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

これにより、プロジェクト自体を除くホームディレクトリの読み取りがブロックされます：

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

Claude Code は . エントリをプロジェクト設定ではプロジェクトルートに、ユーザー設定では ~/.claude に解決します。allowManagedReadPathsOnly が設定されていない限り、Claude Code はセッションが読み込む設定ファイル全体でエントリをマージし、permissions.blockReadsOutsideWorkingDirectories がオンの間はリポジトリ設定からのエントリを除外します。リポジトリロックによってリポジトリのエントリが除外されることもあります。

sandbox.filesystem.allowManagedReadPathsOnly

管理設定から来る allowRead エントリのみを尊重するため、開発者は組織がブロックしたパスへの読み取りアクセスを再度開くことができません。Claude Code は引き続きセッションが読み込むすべての設定スコープから denyRead エントリをマージします。

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

これにより、ホームディレクトリの読み取りがブロックされ、~/work が再度開かれ、開発者が他のものを再度開くのが停止されます：

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

ポリシーの拡大を開発者に防止させるを参照してください。

sandbox.filesystem.disabled

ネットワークの隔離を維持したまま、ファイルシステムの隔離をスキップします。サンドボックス化されたコマンドはホストのファイルシステムへの無制限の読み取りおよび書き込みアクセスを得ますが、ネットワークの送信先は network.allowedDomains に限定されたままです。コマンドが何を書き込むかではなく、どこに接続するかを制御するためにサンドボックスを使用する場合に使用します。

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

これにより、ファイルシステムが開かれ、ネットワーク出力が GitHub と npm に限定されます：

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

このレイヤーがオフの場合、Claude Code は denyRead や credentials.files の deny エントリを適用しませんが、credentials.envVars エントリと適用済みの mask エントリは引き続き機能します。autoAllowBashIfSandboxed のデフォルトは引き続き true であるため、プロンプトを表示し続けるには false に設定してください。これを設定できるソースの一覧と、隔離がオフのときに何が変わるかについては、ファイルシステムの隔離を無効にするを参照してください。

sandbox.ignoreViolations

コマンドがプローブして拒否されることが予想されるパスのサンドボックス違反レポートを沈黙させます（例えば、スタートアップ時に /etc/hosts をチェックするツール）。これらの拒否は違反として表示されず、Claude が見るものにも表示されません。サンドボックスはアクセスをブロックしたままです。レポートのみが抑制されます。キーはコマンドに対して一致するサブストリング（* はすべてのコマンドに一致）で、値はそのコマンドで無視する違反のサブストリング（ファイルシステムパスなど）です。

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

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

sandbox.enableWeakerNestedSandbox

Linux サンドボックスを非特権 Docker コンテナ内で実行します。bubblewrap は新しい /proc をマウントできません。代わりに、内部サンドボックスはコンテナの既存の /proc をバインドマウントします。これにより、新しいマウントが非表示にするプロセス情報が公開されます。これはセキュリティを低下させます。外部コンテナが既に必要な分離を提供する場合にのみ使用します。

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

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

Linux と WSL2 のみ。Bubblewrap がコンテナ内で起動に失敗するを参照してください。

sandbox.enableWeakerNetworkIsolation

macOS でサンドボックス化されたコマンドがシステム TLS トラストサービス com.apple.trustd.agent に到達できるようにします。gh、gcloud、terraform などの Go ベースのツールは、network.httpProxyPortを MITM プロキシとカスタム CA で使用する場合、TLS 証明書を検証するために必要です。これはトラストサービスを通じた潜在的なデータ流出パスを開くことでセキュリティを低下させます。

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

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

MITM プロキシを使用しない場合は、代わりに失敗するツールを excludedCommands にリストします。Go ベースの CLI が macOS で TLS 検証に失敗するを参照してください。

sandbox.allowAppleEvents

macOS でサンドボックス化されたコマンドが Apple Events を送信できるようにします。open、osascript、およびブラウザで URL を開くツールはこれが必要です。これがないと、エラー -600 で失敗します。これはコード実行分離を削除します。サンドボックス化されたコマンドはユーザープロンプトなしで他のアプリケーションを非サンドボックス化で起動でき、Terminal などの実行中のアプリケーションに AppleScript コマンドを送信できます。これはアプリごとの macOS オートメーション同意プロンプト（TCC）の対象です。

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

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

分離を保持しながら 1 つのそのようなツールを実行するには、代わりに excludedCommands に追加します。macOS の Apple Eventsを参照してください。

sandbox.allowNestedUserNamespaces

Linux と WSL2 上のサンドボックス化されたコマンドがユーザー名前空間を作成できるようにします。Chromium や Electron 独自のサンドボックス、入れ子の bubblewrap、unshare はこれを必要とします。このキーを true に設定すると、セキュリティ境界がオフになります。サンドボックス化されたコマンドのコードが、サンドボックスの外で実行される可能性があります。rootless の Podman や Buildah については、サンドボックスは他の方法でもそれらを停止させるため、代わりに excludedCommands を使用してください。Claude Code v2.1.305 以降が必要です。

• スコープ: 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
  }
}

このキーがオンの場合、悪意のあるコマンドを止めるために、保護されたパスや credentials.files エントリを含むサンドボックスのいかなる制限にも頼らないでください。自動許可モードでは、そのようなコマンドが権限プロンプトなしで実行される可能性があります。組織にセキュリティチームがある場合は、このキーをオンにする前に相談してください。

お使いのツールの解決方法については、Linux のサンドボックス内で Chromium または rootless Podman が失敗するを参照してください。

sandbox.ripgrep

Claude Code が使用するものの代わりに、独自の ripgrep バイナリをサンドボックスに指定します。たとえば、プラットフォームが異なる方法でビルドされた rg を必要とする場合です。

• 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

PATH の外にインストールされた bubblewrap バイナリ（エアギャップホスト上のベンダー版など）をサンドボックスに指定します。Claude Code はスタートアップ依存関係チェックと、サンドボックス化された各コマンドをラップするときの両方でパスを使用します。

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

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

Linux と WSL2 のみ。

sandbox.socatPath

PATH の外にインストールされた socat バイナリをサンドボックスネットワークプロキシに指定します。

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

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

Linux と WSL2 のみ。

sandbox.credentials

サンドボックス化されたコマンドから保護する認証情報ファイルと環境変数を宣言します。各エントリはファイル path または変数 name と mode に名前を付けます：deny はサンドボックス内の認証情報を非表示にし、mask はサンドボックス化されたコマンドにプレースホルダーを表示します。サンドボックスプロキシは送信リクエストで実際の値を置き換えます。Claude Code はリストしたエントリのみを保護します。組み込みの認証情報拒否リストはありません。

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

これにより、AWS 認証情報ファイルが非表示になり、GITHUB_TOKEN がサンドボックス化されたコマンドから削除されます：

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

deny ファイル保護はファイルシステムレイヤーの一部であるため、ファイルシステム分離を無効にする場合は適用されません。環境変数保護は引き続き適用されます。

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

管理対象の sandbox.credentials エントリが検証に失敗した場合、Claude Code は可能な限り認証情報を保護し続けます：

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

v2.1.191 以降に適用されます。v2.1.221 より前では、すべての無効なエントリが削除されました。フィールドごとの処理を持つ他の管理キーについては、管理設定の無効なエントリを参照してください。

sandbox.credentials.files

認証情報ファイルまたはディレクトリをサンドボックス化されたコマンドから保護します。"mode": "deny" の場合、Claude Code はサンドボックス内のパスの読み取りをブロックします。これは sandbox.filesystem.denyRead と同じ読み取りブロックです。"mode": "mask" の場合、Linux と WSL2 でサンドボックス化されたコマンドはファイルのセンチネルコピーを読み取り、サンドボックスプロキシはそのエントリの injectHosts への送信リクエストで実際の値を置き換えます。macOS ではファイルはサンドボックス内で読み取り不可です。"mode": "mask" には Claude Code v2.1.221 以降が必要です。

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

これにより、AWS 認証情報ファイルが非表示になり、gh ホストファイルがマスクされ、api.github.com へのリクエストでのみ実際の値が置き換えられます：

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

パスは sandbox.filesystem.* 設定と同じプレフィックスを使用し、Claude Code はセッションが読み込むすべての設定スコープから配列をマージします。認証情報を保護するは、--setting-sources で除外するソースから何が引き続き適用されるかをカバーしています。mask エントリには Claude Code v2.1.221 以降が必要です。

mask 置換はサンドボックスプロキシを通じてのみ実行されるため、sandbox.network.tlsTerminate、または プレーン HTTP テストネットワークの場合は allowPlaintextInject を設定します。mask は単一ファイルに適用されるため、各認証情報ファイルを個別にリストします。Claude Code は deny エントリの mask フィールドを受け入れますが、無視します。認証情報をマスクするはどの設定ソースが尊重されるかを、認証情報ファイルをマスクするはエントリが deny にフォールバックするときをカバーしています。

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

mask エントリはこれらの optional フィールドを受け入れます。extract または decode がない場合、Claude Code はファイル全体の内容を 1 つのセンチネルで置き換えます。ファイルシステム分離がオンの macOS では、Claude Code は extract または decode が実行される前に mask エントリを deny として適用します。認証情報ファイルをマスクするを参照してください。

これにより、gh ホストファイル内の oauth_token 値のみがマスクされ、ファイル内のそれぞれの他のコピーが置き換えられ、パターンが何も一致しない場合はファイルが読み取り不可になり、実際のトークンは 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

環境変数をサンドボックス化されたコマンドから保護します。"mode": "deny" の場合、Claude Code はサンドボックス化されたコマンドの環境から変数を削除します。"mode": "mask" の場合、サンドボックス化されたコマンドはセッションごとのセンチネル値を見て、サンドボックスプロキシはそのエントリの injectHosts への送信リクエストで実際の値を置き換えます。gh や npm などのツールは実際の認証情報を保持することなく認証を続けます。

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

これにより、NPM_TOKEN がサンドボックス化されたコマンドから削除され、GITHUB_TOKEN がマスクされ、実際の値は api.github.com へのリクエストでのみ置き換えられます：

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

name は文字または下線で始まり、文字、数字、下線のみを含む必要があります。Claude Code はセッションが読み込むすべての設定スコープから配列をマージし、同じ変数が両方のモードで表示される場合は deny を適用します。認証情報を保護するは、--setting-sources で除外するソースから何が引き続き適用されるかをカバーしています。

mask 置換はサンドボックスプロキシを通じてのみ実行されるため、sandbox.network.tlsTerminate、または プレーン HTTP テストネットワークの場合は allowPlaintextInject を設定します。認証情報をマスクするを参照してください。Claude Code は deny エントリの mask フィールドを受け入れますが、無視します。

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

mask エントリはこれらの optional フィールドを受け入れます。extract または decode がない場合、Claude Code は全体の値を 1 つのセンチネルで置き換えます。extract と decode は同じエントリで組み合わせることはできません。

これにより、DATABASE_URL 内のパスワードのみがマスクされ、パターンが何も一致しない場合は変数がアンセットされ、SERVICE_JWT の JWT がマスクされます。api_key を除くすべてのクレームは読み取り可能なままです：

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

sandbox.credentials.allowPlaintextInject

TLS 終了 HTTPS だけでなく、プレーン HTTP リクエストでも mask 置換を許可します。プレーン HTTP では、アップストリーム ID は検証されず、認証情報はクリアテキストで移動するため、信頼できるテストネットワーク外ではこれをオフのままにします。

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

{
  "sandbox": {
    "credentials": {
      "allowPlaintextInject": true
    }
  }
}

sandbox.credentials.awsPairs

マスクされた環境変数をグループ化して、認証情報が非標準の名前の変数に存在する場合、SigV4 再署名用に 1 つの AWS 認証情報を形成します。Claude Code は、従来の AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_SESSION_TOKEN トリオを全体の値をマスクする場合、自動的にリンクするため、他の名前の場合にのみこのキーが必要です。Claude Code v2.1.224 以降が必要です。

• Scope: User or managed
• Type: オブジェクトの配列。各オブジェクトは accessKeyIdVar、secretAccessKeyVar、および optional sessionTokenVar を含み、sandbox.credentials.envVars エントリに名前を付けます
• Default: 未設定。従来のトリオのみがペアになります

これにより、3 つのカスタム名の変数が 1 つの AWS 認証情報にリンクされ、再署名されます：

{
  "sandbox": {
    "credentials": {
      "awsPairs": [
        {
          "accessKeyIdVar": "MY_KEY_ID",
          "secretAccessKeyVar": "MY_SECRET_KEY",
          "sessionTokenVar": "MY_SESSION_TOKEN"
        }
      ]
    }
  }
}

各名前付き変数は sandbox.credentials.envVars の全体値 mask エントリである必要があり、extract または decode なしで、すべてのペアで 1 つのスロットのみを埋めることができます。以下のルールも適用されます：

• プロキシは、アクセスキー ID エントリの injectHosts にリストされたホストでリクエストを再署名します
• sessionTokenVar が設定されている場合、プロキシは再署名されたリクエストで実際のトークンを x-amz-security-token として送信します
• ペアで従来の変数のいずれかを指定すると、自動ペアリングが置き換えられます

sandbox.credentials.sigv4

サンドボックスプロキシが 再署名できないAWS リクエスト形式で何をするかを選択します：streaming は aws-chunked ストリーミングアップロード、presigned は事前署名 URL、sigv4a は SigV4A 非対称署名です。これは、マスクされたペアのプレースホルダーアクセスキー ID で署名されたリクエストにのみ適用されます。Claude Code v2.1.224 以降が必要です。

• Scope: User or managed
• Type: streaming、presigned、sigv4a を含むオブジェクト。各オブジェクトは以下のいずれかです：
  • "deny": プロキシはリクエストを失敗させます
  • "passthrough": プロキシはマスクされたプレースホルダーで署名されたリクエストを転送するため、ツールは AWS 自体の拒否を受け取ります
• Default: 未設定。すべての形式は "deny" です

これにより、ストリーミングアップロードはプロキシで失敗する代わりに転送されます：

{
  "sandbox": {
    "credentials": {
      "sigv4": {
        "streaming": "passthrough"
      }
    }
  }
}

deny の場合、プロキシはリクエストを失敗させます。passthrough の場合、プロキシはマスクされたプレースホルダーから計算された署名でリクエストを転送するため、AWS はそれを拒否し、呼び出しツールはプロキシエラーの代わりに AWS 自体のレスポンスを受け取ります。

sandbox.network

サンドボックス化されたコマンドが到達できるホスト、ポート、ソケットを制御します。サンドボックスは送信トラフィックをプロキシを通じてルーティングし、これらのリストを強制します。ネットワーク分離を参照して、プロキシがどのように決定するか、およびいつプロンプトするかを確認してください。

• Scope: Any file。strictAllowlist、allowManagedDomainsOnly、tlsTerminate は、それらのエントリが言うように、より少ないソースから読み取られます。
• Type: 以下のサブキーを含むオブジェクト
• Default: 未設定。ドメインは事前に許可されず、新しい各ホストをどう扱うかは権限モードによって決まります

これにより、GitHub と npm が事前に許可され、uploads.github.com がブロックされ、コマンドが localhost にバインドできます：

{
  "sandbox": {
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"],
      "deniedDomains": ["uploads.github.com"],
      "allowLocalBinding": true
    }
  }
}

Claude Code は配列サブキーを設定スコープ全体でマージするため、リポジトリロックが適用されない限り、プロジェクトはユーザーリストにドメインを追加できます。WebFetch(domain:...) 許可および拒否権限ルールは同じ許可および拒否リストをフィードします。

sandbox.network.allowUnixSockets

macOS でサンドボックス化されたコマンドが接続できる Unix ソケットパスをリストします。Claude Code は Linux と WSL2 でこのリストを無視します。seccomp フィルタはソケットパスを検査できません。代わりに allowAllUnixSockets を使用します。

• Scope: Any file（プロジェクト設定とローカル設定には制限あり）
• Type: 文字列の配列。各ソケットパス
• Default: 未設定。macOS サンドボックスはすべての Unix ソケットをブロックします

{
  "sandbox": {
    "network": {
      "allowUnixSockets": ["~/.ssh/agent-socket"]
    }
  }
}

ソケットパスは広いアクセスを許可できます。たとえば、/var/run/docker.sock を許可すると、サンドボックス化されたコマンドが Docker デーモンを制御できます。セキュリティ制限を参照してください。

sandbox.network.allowAllUnixSockets

サンドボックス化されたコマンドがすべての Unix ソケットに接続できるようにします。Linux と WSL2 では、サンドボックスの seccomp フィルタ は socket(AF_UNIX, ...) 呼び出しをブロックするため、これは Unix ソケットを許可する唯一の方法です。フィルタが不足している場合（/sandbox がその Dependencies タブで報告する場合）、サンドボックスは Unix ソケット呼び出しをブロックしません。Linux と WSL2 をセットアップするを参照して、フィルタがどこから来るかを確認してください。

• Scope: Any file（プロジェクト設定とローカル設定には制限あり）
• 型: ブール値
  • true: サンドボックス化されたコマンドはすべての Unix ソケットに接続できます。Linux と WSL2 では、VM ソケット（AF_VSOCK アドレスファミリー）にも接続できます
  • false: サンドボックスは Unix ソケットの接続をブロックします。macOS では allowUnixSockets 内のパスを除いてブロックし、Linux と WSL2 では seccomp フィルターが存在する場合にそれを通じてブロックします
• Default: false

{
  "sandbox": {
    "network": {
      "allowAllUnixSockets": true
    }
  }
}

WSL2 では、true は cmd.exe や powershell.exe などの Windows バイナリを起動する相互運用ソケットも再度開きます。

sandbox.network.allowLocalBinding

macOS でサンドボックス化されたコマンドがネットワークポートでリッスンし（開発サーバーの起動など）、localhost の任意のポートに接続できるようにします。ループバック以外のアドレスでリッスンするコマンドは、他のマシンからの接続を受け付けます。Linux と WSL2 では各サンドボックス化されたコマンドが独自のループバックインターフェースを持つため、このキーは効果がありません。Linux または WSL2 からホスト上のサーバーに到達するには、コマンドが localhost 上のサーバーに到達できないを参照してください。

• Scope: Any file（プロジェクト設定とローカル設定には制限あり）
• Type: ブール値
  • true: macOS でサンドボックス化されたコマンドは任意のローカルアドレスでリッスンし、localhost の任意のポートに接続できます
  • false: macOS でサンドボックス化されたコマンドはポートでリッスンすることも、localhost 上のサーバーに直接接続することもできません
• Default: false

{
  "sandbox": {
    "network": {
      "allowLocalBinding": true
    }
  }
}

sandbox.network.allowMachLookup

macOS のサンドボックスが参照できる追加の XPC および Mach サービス名を記載します。iOS Simulator や Playwright など、XPC で通信するツールは、そのサービスをここに記載する必要があります。サンドボックス化されたコマンドは、記載した各サービスにサンドボックスの外からアクセスでき、サンドボックスはそれらのサービスがコマンドのために行う処理を制限しません。

• Scope: Any file（プロジェクト設定とローカル設定には制限あり）
• Type: 文字列の配列。各サービス名。単一の末尾 * はプレフィックスと一致し、"*" だけはすべてのサービスと一致します
• Default: 未設定

次の例では、com.apple.CoreSimulator. プレフィックス配下のすべてのサービスを許可します。

{
  "sandbox": {
    "network": {
      "allowMachLookup": ["com.apple.CoreSimulator.*"]
    }
  }
}

sandbox.network.allowedDomains

サンドボックス化されたコマンドからの送信トラフィック用にドメインを事前に許可するため、サンドボックスはそれらについてプロンプトしません。*.example.com などのワイルドカードはサブドメインと一致し、optional :port サフィックスはエントリを 1 つのポートに制限します。ポートなしのエントリはすべてのポートと一致します。

• Scope: Any file（プロジェクト設定とローカル設定には制限あり）。allowManagedDomainsOnlyが設定されている場合、管理設定のみ。
• Type: 文字列の配列。各ドメイン、ワイルドカードパターン、または IP リテラル。optional :port サフィックス付き
• Default: 未設定。新しい各ホストをどう扱うかは権限モードによって決まります

これにより、GitHub がすべてのポートで事前に許可され、すべての npm サブドメイン、および 1 つの API ホストがポート 443 でのみ許可されます：

{
  "sandbox": {
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org", "api.example.com:443"]
    }
  }
}

IPv6 リテラルを括弧で囲んで書き込みます。optional ポート付き："[::1]" はすべてのポートを許可し、"[::1]:443" は 1 つのポートを許可します。括弧形式には Claude Code v2.1.229 以降が必要です。ドメインリストの IPv6 アドレスを参照してください。

sandbox.network.deniedDomains

allowedDomainsと同じワイルドカード、ポート、IPv6 構文を使用して、サンドボックス化されたコマンドからの送信トラフィック用にドメインをブロックします。拒否されたドメインは、allowedDomains エントリも一致する場合でもブロックされたままです。

• Scope: Any file
• Type: 文字列の配列。各ドメイン、ワイルドカードパターン、または IP リテラル。optional :port サフィックス付き
• Default: 未設定

{
  "sandbox": {
    "network": {
      "deniedDomains": ["sensitive.cloud.example.com"]
    }
  }
}

Claude Code はセッションが読み込むすべての設定ソースからこのリストをマージします。allowManagedDomainsOnly が設定されている場合でも、開発者は常に拒否リストを厳しくできます。IPv6 リテラルについては、ドメインリストの IPv6 アドレスを参照してください。

完全修飾ドメイン名をマークする末尾ドット（example.com. など）で書き込まれたエントリは、example.com と同じ接続をブロックします。

sandbox.network.strictAllowlist

許可リスト外のホストへのサンドボックス化されたコマンドのアクセスを、承認を求めるプロンプトを表示する代わりに拒否します。許可リストは allowedDomains と WebFetch(domain:...) 許可ルールからのドメイン、または allowManagedDomainsOnly が設定されている場合は管理設定エントリのみです。リポジトリのエントリについては、管理者必須のサンドボックスなしで適用されるロックを参照してください。Claude Code v2.1.219 以降が必要です。

• Scope: User or managed。リポジトリはそれをオンまたはオフにできません。
• Type: ブール値
  • true: Claude Code は許可リスト外のホストへのサンドボックス化されたコマンドアクセスを拒否します
  • false: 別の信頼できる設定ファイルが true を設定しない限り、Claude Code は許可リスト外のホストを即座に拒否するのではなく、権限モードに応じて判断します：auto モードではコマンドのコマンドごとの許可ドメインに対してホストをチェックし、dontAsk モードでは拒否し、bypassPermissions モードおよびバイパスが利用可能なインタラクティブターミナルの plan モードセッションでは許可し、それ以外の場合はユーザーに確認します
• Default: false

{
  "sandbox": {
    "network": {
      "strictAllowlist": true
    }
  }
}

Claude Code はサンドボックス化されたコマンドのみに対してこれを強制します。WebFetch などのインプロセスツールは引き続き権限ルールに従います。尊重されるソースのいずれかが true に設定する場合、それはオンのままです。ネットワーク分離を参照してください。Claude Code v2.1.219 以降が必要です。

sandbox.network.allowManagedDomainsOnly

ネットワーク許可リストを管理設定が定義するものにロックします。Claude Code は管理設定からの allowedDomains と WebFetch(domain:...) 許可ルールのみを尊重し、ユーザー、プロジェクト、ローカル、--settings 設定からのドメインを無視し、許可されていないドメインをプロンプトする代わりに自動的にブロックします。

• Scope: Managed
• Type: ブール値
  • true: Claude Code は管理設定からの allowedDomains と WebFetch(domain:...) 許可ルールのみを尊重し、許可されていないドメインをプロンプトする代わりにブロックします
  • false: 他の設定ファイルからのドメインも許可リストにマージされます
• Default: false

これにより、許可リストが GitHub と npm にロックされ、開発者が追加するドメインが無視されます：

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

キーが true の間、サンドボックスは管理者必須となり、プロキシポートを設定できるのは管理設定のみになります。

拒否されたドメインは引き続きセッションが読み込むすべてのソースからマージされます。ポリシーの拡大を開発者に防止させるを参照してください。

sandbox.network.httpProxyPort

Claude Code が実行するものの代わりに、独自の HTTP プロキシをサンドボックスに指定します。組織はこれを使用して、HTTPS トラフィックを検査したり、独自のフィルタリングルールを適用したり、リクエストをログに記録したりします。フィルタリングは独自のプロキシが引き継ぎ、Claude Code はそこに送信されるトラフィックにドメインリストとネットワークプロンプトを適用しなくなります。未設定の場合、Claude Code は HTTP トラフィック用に独自のプロキシを起動します。

• Scope: Any file。ただし、他のサンドボックス設定によってポートを設定できるファイルが制限される場合を除きます
• Type: 数値。ローカル TCP ポート
• Default: 未設定。Claude Code は独自のプロキシを実行します

{
  "sandbox": {
    "network": {
      "httpProxyPort": 8080
    }
  }
}

プロキシで SOCKS トラフィックも扱う場合は、socksProxyPort も設定します。2 つのうち一方のみを設定した場合、Claude Code はもう一方のプロトコル用に引き続き独自のプロキシを実行します。カスタムプロキシ設定を参照してください。

sandbox.network.socksProxyPort

Claude Code が実行するものの代わりに、独自の SOCKS5 プロキシをサンドボックスに指定します。フィルタリングは独自のプロキシが引き継ぎ、Claude Code はそこに送信されるトラフィックにドメインリストとネットワークプロンプトを適用しなくなります。未設定の場合、Claude Code は SOCKS トラフィック用に独自のプロキシを起動します。

• Scope: Any file。ただし、他のサンドボックス設定によってポートを設定できるファイルが制限される場合を除きます
• Type: 数値。ローカル TCP ポート
• Default: 未設定。Claude Code は独自のプロキシを実行します

{
  "sandbox": {
    "network": {
      "socksProxyPort": 8081
    }
  }
}

カスタムプロキシ設定を参照してください。

sandbox.network.tlsTerminate

サンドボックスプロキシが TLS を終了して、HTTPS リクエストの内容を読み取ることができるようにします。これは実験的であり、mask 認証情報置換はそれを必要とします。{} を設定してセッション用に一時的な認証局を生成するか、caCertPath と caKeyPath を設定して独自のものを使用します。

• Scope: User or managed。リポジトリはそれをオンにするか、認証局を提供できません。
• Type: optional caCertPath と caKeyPath 文字列を含むオブジェクト。各ファイルパス
• Default: 未設定。プロキシは TLS を終了または検査しません

{
  "sandbox": {
    "network": {
      "tlsTerminate": {}
    }
  }
}

複数の尊重されるソースがそれを設定する場合、Claude Code は最も優先度の高いソースからの値を使用します：管理設定、次に --settings フラグ、次にユーザー設定。

メモリとコンテキスト

Claude Code がコンテキストに読み込む内容、コンテキスト圧縮の方法、メモリとプランの保存場所を制御します。コンテキストの管理とメモリを参照してください。

autoCompactEnabled

コンテキストが上限に近づいたときに、Claude Code が会話を自動的に圧縮するようにします。/config では Auto-compact として表示され、そこで切り替えるとこのキーがユーザー設定に書き込まれます。

• スコープ: Any file
• 型: ブール値
  • true: コンテキストが上限に近づくと、Claude Code は会話を自動的に圧縮します
  • false: Claude Code は自動的に圧縮しません
• デフォルト: true
• セッションごとの上書き: DISABLE_AUTO_COMPACT は 1 つのセッションで自動圧縮をオフにします。2 つのうちどちらかがオフにした場合、もう一方でオンに戻すことはできません

{
  "autoCompactEnabled": false
}

自動圧縮がオフの間も、手動の /compact コマンドは引き続き機能します。自動圧縮をオフにすると、アイドル時のコンテキスト圧縮もオフになります。

autoCompactWindow

Claude Code が自動的に圧縮する前に、コンテキストウィンドウがどこまで埋まるかを設定します。

• スコープ: Any file
• 型: トークン数、100000 から 1000000 まで。Claude Code はこの値をモデルのコンテキストウィンドウで上限設定します。各モデルのウィンドウはモデルの概要に記載されています
• デフォルト: 未設定。この場合、Claude Code はモデルに合わせて調整されたウィンドウを選択します
• セッションごとの上書き: --autocompact は 1 つのセッションでこのキーより優先されます。また、Claude Code が変数の値を無視する場合を除き、CLAUDE_CODE_AUTO_COMPACT_WINDOW は両方より優先されます

{
  "autoCompactWindow": 500000
}

/autocompact コマンドは、現在のモデル用のウィンドウを modelSettings の下に保存します。これは、そのモデルについて同じファイル内のこのキーより優先されます。コマンド、フラグ、変数、設定がどのように相互作用するかについては、自動圧縮ウィンドウを設定するで説明しています。

autoMemoryDirectory

自動メモリを、プロジェクトごとのデフォルトではなく任意のディレクトリに保存します。

• スコープ: Any file
• 型: 文字列。絶対パス、または ~/ で始まるディレクトリパス
• デフォルト: 未設定。この場合、Claude Code は ~/.claude/projects/<project>/memory/ を使用します

{
  "autoMemoryDirectory": "~/my-memory-dir"
}

クローンしたリポジトリがプロジェクト設定やローカル設定のファイルを提供できるため、これらの設定では、Claude Code はフックと同じワークスペース信頼ルールに従ってこのキーを適用します。

autoMemoryEnabled

自動メモリをオンまたはオフにします。false の場合、Claude は自動メモリディレクトリの読み取りも書き込みも行いません。セッション中に /memory で切り替えることもでき、その場合はこのキーがユーザー設定に書き込まれます。

• スコープ: Any file
• 型: ブール値
  • true: 未設定と同じです。--bare、セーフモード、CLAUDE_CODE_DISABLE_AUTO_MEMORY など、このキーより優先されるものがセッションでオフにしない限り、自動メモリはオンのままです
  • false: Claude は自動メモリディレクトリの読み取りも書き込みも行いません
• デフォルト: true
• セッションごとの上書き: CLAUDE_CODE_DISABLE_AUTO_MEMORY は、どちらの方向でも 1 つのセッションでこのキーより優先されます

{
  "autoMemoryEnabled": false
}

bashOutputMaxChars

成功した Bash または PowerShell コマンドの出力のうち、Claude がインラインで受け取る文字数を設定します。出力が上限を超えると、Claude Code はそれをファイルに保存し、Claude は短いプレビューとファイルのパスを受け取ります。詳細なビルドやテストスイート全体のログなど、コマンドの出力がデフォルトを日常的に超え、Claude にファイルを開かずに読ませたい場合は、上限を引き上げてください。Claude Code v2.1.261 以降が必要です。

• スコープ: Any file
• 型: 文字数、正の整数。Claude Code は値を 4000 から 128000 の範囲に収めます
• デフォルト: 未設定。この場合、Claude はインラインで最大 30,000 文字を受け取ります

{
  "bashOutputMaxChars": 100000
}

このキーを設定すると、Claude Code は BASH_MAX_OUTPUT_LENGTH 環境変数を無視します。

claudeMd

別のファイルをデプロイせずに、CLAUDE.md 形式の指示を組織管理のメモリとして挿入します。Claude Code は、このテキストを管理メモリのエントリとして、ユーザーおよびプロジェクトの CLAUDE.md ファイルより先に読み込みます。

• スコープ: Managed
• 型: 文字列。CLAUDE.md ファイルのテキストです。markdown を含め、ファイルと同じように記述し、改行は \n とします
• デフォルト: 未設定

この例では、2 つのルールを短い markdown のリストとしてデプロイします。

{
  "claudeMd": "# Engineering rules\n\n- Always run make lint before committing.\n- Never push directly to main."
}

組織全体の CLAUDE.md をデプロイするを参照してください。

claudeMdExcludes

Claude Code がメモリを読み込む際に、特定の CLAUDE.md ファイルをスキップします。大規模なモノレポでは、自分の作業に関係のない他チームの CLAUDE.md ファイルをスキップするために使用します。大規模コードベースのガイドの関係のない CLAUDE.md ファイルを除外するで、このケースを詳しく説明しています。パターンは絶対ファイルパスに対してマッチします。

• スコープ: Any file
• 型: 文字列の配列。各要素は glob パターンまたは絶対パスです
• デフォルト: 未設定。この場合、Claude Code は見つかったすべての CLAUDE.md を読み込みます

{
  "claudeMdExcludes": ["**/vendor/**/CLAUDE.md"]
}

除外はユーザー、プロジェクト、ローカルのメモリファイルにのみ適用されます。管理ポリシーの CLAUDE.md ファイルは除外できません。

env

すべてのセッションと、そのセッションから Claude Code が起動するサブプロセスに環境変数を設定します。環境変数リファレンスにあるほとんどの変数はここに記述でき、これによって変数をすべてのセッションに適用したり、チームに展開したりできます。プロジェクト設定とローカル設定では、一部の変数を設定できません。

• スコープ: Any file
• 型: 変数名を文字列値にマッピングするオブジェクト
• デフォルト: 未設定

この例では、自動圧縮をオフにし、API リクエストをプロキシ経由でルーティングします。

{
  "env": {
    "DISABLE_AUTO_COMPACT": "1",
    "ANTHROPIC_BASE_URL": "https://proxy.example.com"
  }
}

env の値とシェルの相互作用

• ここで指定した値は、シェルでエクスポートされた同じ変数を上書きします。複数の設定ファイルが同じ変数を設定している場合は、優先順位が最も高いものが適用されます。プロジェクト設定とローカル設定の例外は、Claude Code が env で無視する変数に記載しています。
• Claude Desktop アプリまたはセルフホスト環境のランナーがセッションを開始する場合は、代わりにそれが構築する起動環境が優先されます。起動環境がすでに設定している変数については、Claude Code はどの設定ファイルの env の値も無視します。無視された各変数はデバッグログに記載されます。
• シェルのエクスポートを取り消すには、変数を "" に設定します。Claude Code はプロバイダーの選択において空の値を未設定として扱い、サブプロセスは空の値を継承します。
• ここで設定した NO_COLOR と FORCE_COLOR は、サブプロセスにのみ反映されます。Claude Code 自体のインターフェースのカラーを変更するには、claude を起動する前にシェルで設定してください。
• ここに記述した値は設定ファイル内のプレーンテキストであり、Claude Code が起動するすべてのサブプロセスに渡されます。ローテーションする OTLP ベアラートークンには otelHeadersHelper を、API の認証情報には apiKeyHelper を使用してください。

Claude Code が env の値を適用するタイミング

• ユーザー設定、--settings、管理設定からの値: 起動時、および保存された変更によってマージ後の env が変わったときに実行中のセッションで再度適用されます。
• プロジェクト設定とローカル設定からの値: ワークスペースを信頼した後、または信頼ダイアログを表示しない -p モードでは起動時に適用され、保存された変更によってマージ後の env が変わったときに再度適用されます。
• モデルの選択、タイムアウトと制限、機能の切り替えなど、Claude Code が安全と分類する変数: プロジェクト設定とローカル設定で設定できない変数を除き、起動時にすべての設定ファイルから適用されます。
• v2.1.246 以降で /cd でセッションを移動した後: 以前のディレクトリの値に加えて、新しいディレクトリのプロジェクトとローカルの env の値が適用されます。

Claude Code が env で無視する変数

• プロジェクト設定とローカル設定では、チェックアウトしたリポジトリが制御すべきでない変数を設定できません。これらはシェル、ユーザー設定、または管理設定で設定してください。テレメトリをオフにするいくつかの値を除き、Claude Code はこれらをそれぞれ破棄し、claude --debug で確認できる警告をログに記録します。対象には次のものが含まれます。

  • Claude Code が自身のファイルを保存または書き込む場所を選択する変数: CLAUDE_CONFIG_DIR、CLAUDE_CODE_TMPDIR、およびオペレーティングシステムのディレクトリ変数（HOME、TMPDIR、TMP、TEMP、XDG_* ファミリーなど）。

  • Claude Code が起動するプロセスのプログラムやマシン全体の設定を選択する Windows の変数（SystemRoot、ComSpec、ProgramData、LOCALAPPDATA、PATHEXT、PSModulePath、ProgramFiles ファミリーなど）。

  • セッションの内容をエクスポートする変数: OTEL_LOG_RAW_API_BODIES、および詳細なベータトレースのペアである ENABLE_BETA_TRACING_DETAILED と BETA_TRACING_ENDPOINT。

  • テレメトリをオンにする、送信先を選択する、またはキャプチャする内容を選択する OpenTelemetry エクスポーターの変数:

    • CLAUDE_CODE_ENABLE_TELEMETRY、および拡張テレメトリのベータのペアである CLAUDE_CODE_ENHANCED_TELEMETRY_BETA と ENABLE_ENHANCED_TELEMETRY_BETA
    • エクスポーターのセレクターである OTEL_LOGS_EXPORTER、OTEL_METRICS_EXPORTER、OTEL_TRACES_EXPORTER
    • 内容に関する変数である OTEL_LOG_USER_PROMPTS、OTEL_LOG_ASSISTANT_RESPONSES、OTEL_LOG_TOOL_CONTENT、OTEL_LOG_TOOL_DETAILS
    • 名前が _ENDPOINT、_HEADERS、_PROTOCOL、_CERTIFICATE、_CLIENT_KEY、または _INSECURE で終わる OTEL_EXPORTER_OTLP_* 変数（汎用形式とシグナルごとの形式の両方。OTEL_EXPORTER_OTLP_ENDPOINT や OTEL_EXPORTER_OTLP_METRICS_HEADERS など）
    • OTEL_EXPORTER_PROMETHEUS_HOST と OTEL_EXPORTER_PROMETHEUS_PORT

    プロジェクト設定とローカル設定から引き続き適用されるのは、何かをオフにする次の値のみです。3 つのエクスポーターセレクターに対する none、および OTEL_LOG_USER_PROMPTS、OTEL_LOG_TOOL_CONTENT、OTEL_LOG_TOOL_DETAILS に対する 0 などのオフの値です。このような値はユーザー設定にある同じ変数を上書きしますが、Claude Code を起動した環境、--settings ファイル、または管理設定で設定された変数は上書きしません。

    プロジェクトまたはローカルの設定ファイルがこのグループの変数を設定している場合、ローカルの対話型セッションでは起動時に通知が表示されます。/status または claude doctor を実行すると、Claude Code がどの変数を無視し、どの変数がテレメトリをオフにしたかを確認できます。どちらも名前のみを表示し、値は表示しません。-p による非対話型の実行や Agent SDK のセッションでは通知が表示されないため、アップグレード後にコレクターが引き続きデータを受信していることを確認してください。受信していない場合は、ユーザー設定、管理設定、ジョブの環境、または --settings で渡すファイルで変数を設定してください。

    プロジェクト設定とローカル設定でこのグループを無視する動作には、Claude Code v2.1.282 以降が必要です。

  • Claude Code の起動方法や同期方法を変更する変数（CLAUDE_CODE_PROCESS_WRAPPER、CLAUDE_CODE_SYNC_SKILLS、CLAUDE_CODE_SYNC_PLUGINS、CLAUDE_CODE_PLUGIN_CACHE_DIR、CLAUDE_CODE_PLUGIN_SEED_DIR など）。

  • claude.ai のサインインを設定する変数（CLAUDE_CODE_OAUTH_TOKEN、CLAUDE_CODE_OAUTH_REFRESH_TOKEN、CLAUDE_CODE_OAUTH_SCOPES など）。

  • スクリーンリーダーモードの変数 CLAUDE_AX_SCREEN_READER、および名前が CLAUDE_AX_ で始まるその他の変数（CLAUDE_AX_STARTUP_QUIET_MS など）。

  • 応答のないダイアログのタイマーを設定する CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS。

  • 添付ファイルの処理をオフにする CLAUDE_CODE_DISABLE_ATTACHMENTS。

  • Claude Code がファイルやディレクトリの @ メンションを展開しないようにする CLAUDE_CODE_DISABLE_FILE_MENTIONS。

  v2.1.251 より前は、プロジェクト設定とローカル設定でも、このリストのうち Claude Code がファイルを書き込む場所を選択する変数やセッションの内容をエクスポートする変数を設定できました（HOME と XDG_CONFIG_HOME を除く）。v2.1.290 より前は、ダイアログのタイマー変数と CLAUDE_CODE_DISABLE_ATTACHMENTS も設定できました。

• CLAUDE_CODE_REMOTE や CLAUDE_CODE_ACCOUNT_UUID など、Claude Code のホスティング環境が所有する ID 変数は、すべてのファイルで無視されます。

• Claude Code 自身がエクスポートする CLAUDE_CODE_MESSAGING_SOCKET と CLAUDE_CODE_MESSAGING_TOKEN は、すべてのファイルで無視されます。ソケット変数を無視する動作には Claude Code v2.1.224 以降が、トークンを無視する動作には v2.1.228 以降が必要です。

• Claude Code が起動環境からのみ読み取る CLAUDE_CODE_PROJECT_DIR_NAME は、すべてのファイルで無視されます。v2.1.234 以降が必要です。

• Claude Code が起動環境からのみ読み取る CLAUDE_CODE_RESTRICTED は、すべてのファイルで無視されます。

• Claude Code が起動環境からのみ読み取る CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY は、すべてのファイルで無視されます。この変数には Claude Code v2.1.283 以降が必要です。

• Claude Code が起動環境からのみ読み取る CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT、CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT、CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT、CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPT は、すべてのファイルで無視されます。

• Claude Code が起動環境からのみ読み取る CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS は、すべてのファイルで無視されます。

• Claude Code が起動環境からのみ読み取る CLAUDE_CODE_WARN_DISK_FREE_GIB と CLAUDE_CODE_WARN_MEMORY_FREE_GIB は、すべてのファイルで無視されます。これらの変数には Claude Code v2.1.304 以降が必要です。

fileCheckpointingEnabled

/rewind で復元できるよう、Claude Code が各編集の前にファイルのスナップショットを取るようにします。/config では Rewind code (checkpoints) として表示され、そこで切り替えるとこのキーがユーザー設定に書き込まれます。

• スコープ: Any file
• 型: ブール値
  • true: /rewind で復元できるよう、Claude Code は各編集の前にファイルのスナップショットを取ります
  • false: Claude Code はファイルのスナップショットを取らないため、/rewind で復元できません
• デフォルト: true
• セッションごとの上書き: CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING は 1 つのセッションでチェックポイント機能をオフにします。2 つのうちどちらかがオフにした場合、もう一方でオンに戻すことはできません

{
  "fileCheckpointingEnabled": false
}

-p の実行や Agent SDK のセッションでは、Claude Code はこのキーを無視します。SDK では enableFileCheckpointing オプションでチェックポイント機能をオンにし、単純な -p の実行では CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true が必要です。Agent SDK のファイルチェックポイント機能を参照してください。

idleCompaction

アイドル時のコンテキスト圧縮は、ユーザーが離席している長い会話を圧縮します。これにより、次のメッセージでは会話全体ではなく要約が送信されます。圧縮されると、会話に次の通知が表示されます。

• ターミナル: Compacted while idle, before the prompt cache expired で始まる行
• VS Code のチャットパネル: a summary written while you were away を含む通知
• デスクトップアプリ: 同じ通知が、ラベルに Claude Code notice を含む行の中に表示されます。その行やテキストが表示されない場合は、Verbose 表示モードに切り替えてください。

アイドル時のコンテキスト圧縮は、次のすべての条件を満たす会話に対してデフォルトでオンになっています。

• セッション: 対話型のターミナルセッション、VS Code 拡張機能のチャットパネル、またはデスクトップアプリの Code タブ（セッションがローカルマシン上または SSH 経由で実行される場合）を使用している
• 自動圧縮: autoCompactEnabled がオンになっている
• プロンプトキャッシュ: 会話が 1 時間のプロンプトキャッシュ TTL を使用している
• サイズ: 会話のコンテキストがトークンのしきい値に達している。しきい値はデフォルトの 200,000 から変更できます
• アイドル時間: 最後のリクエストから約 1 時間が経過しており、その時点までコンピューターがスリープしていない

アイドル時のコンテキスト圧縮をオフにするには、このキーを false に設定します。

• スコープ: Any file
• 型: ブール値
  • true: Claude Code は条件を満たすアイドル状態の会話を圧縮します
  • false: セッションがアイドル状態の間、Claude Code は圧縮しません
• デフォルト: true
• セッションごとの上書き: DISABLE_AUTO_COMPACT は、自動圧縮とともにアイドル時のコンテキスト圧縮もオフにします

{
  "idleCompaction": false
}

ターミナルセッション内からアイドル時のコンテキスト圧縮をオフまたはオンにするには、/config を実行して Idle compaction の行を変更します。選択内容はユーザー設定に保存され、すぐに適用されます。この行には Claude Code v2.1.302 以降が必要です。これらのバージョンを実行していて /config にこの行が表示されない場合は、次の原因を確認してください。

• 別の設定ソースがキーを設定している: 管理設定、--settings フラグ、またはプロジェクトやローカルの設定ファイルの値がユーザー設定を上書きしています。代わりにそのソースでキーを変更してください
• v2.1.314 より前のバージョンで機能フラグが利用できない: Claude Code が Anthropic から機能フラグを取得できない場合、アイドル時のコンテキスト圧縮は実行されないため、オフにする対象がありません

このキーには Claude Code v2.1.290 以降が必要です。このキーを無視する以前のバージョンでは、autoCompactEnabled をオフにしてアイドル時のコンテキスト圧縮を停止してください。

アイドル時のコンテキスト圧縮のしきい値を変更する

CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS に、アイドル時のコンテキスト圧縮が適用されるまでに会話のコンテキストが到達する必要のあるトークン数を設定します。正の整数を使用してください。100000 未満の値は、最小のしきい値である 100000 に引き上げられます。

デフォルトでは、200K のコンテキストウィンドウを使用する会話は 200,000 トークンに達する前に自動圧縮されます。この例では、しきい値を 150,000 に下げて、そうした会話が対象になるようにします。

{
  "env": {
    "CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS": "150000"
  }
}

VS Code とデスクトップアプリでのアイドル時のコンテキスト圧縮

次のような通知は、Claude Code が以前の会話を要約に置き換え、Claude が現在その要約をもとに作業していることを意味します。

Compacted using a summary written while you were away · turn off with "idleCompaction": false in settings.json

特に操作は必要ありません。アイドル時のコンテキスト圧縮をオフにするには、セッションが実行されるマシンまたは WSL ディストリビューション上の ~/.claude/settings.json、または別の設定ファイルで idleCompaction を false に設定します。

plansDirectory

plan モードで Claude Code が書き込むプランファイルの保存場所を選択します。Claude Code はプロジェクトルートを基準にパスを解決します。

• スコープ: Any file
• 型: 文字列。プロジェクトルートからの相対パス
• デフォルト: 未設定。この場合、Claude Code は ~/.claude/plans を使用します

{
  "plansDirectory": "./plans"
}

次のような場合、Claude Code は設定したディレクトリではなく ~/.claude/plans にプランを保存します。

• プロジェクトルートの外: "../plans" のように、パスがプロジェクトルートの外に解決される場合。
• macOS、Linux、WSL でのバックスラッシュ: Windows 形式の "docs\\plans" のように、解決されたパスにバックスラッシュが含まれる場合。Windows でも機能する "docs/plans" と記述してください。

skillListingBudgetFraction

Claude は各ターンで、説明付きのスキルの一覧を参照します。Claude Code はその一覧をコンテキストウィンドウの一定割合に制限します。一覧が上限を超えると、Claude Code はすべてのスキルの名前を保持しつつ、使用頻度の低いスキルの説明を削除します。そのため、Claude はそれらのスキルを引き続き呼び出せますが、自発的に選択する可能性は低くなります。ターンごとのコンテキスト消費が増える代わりに、より多くの説明を表示し続けたい場合は、このキーの値を引き上げてください。

• スコープ: Any file
• 型: 数値。0 より大きく 1 以下の割合
• デフォルト: 0.01。コンテキストウィンドウの 1% を確保します

{
  "skillListingBudgetFraction": 0.02
}

一覧が使用するコンテキストの量と、最も多くを占めているスキルを確認するには、/doctor を実行してください。

skillListingMaxDescChars

Claude は各ターンで、各スキルの description と when_to_use のテキストを示すスキルの一覧を参照します。このキーは、Claude Code がスキルごとに表示するそのテキストの文字数を制限します。これより長いテキストは上限で切り詰められます。

• スコープ: Any file
• 型: 文字数、正の整数
• デフォルト: 1536

{
  "skillListingMaxDescChars": 2048
}

ターンごとのコンテキスト消費が増える代わりに長い説明をそのまま保持したい場合は値を引き上げ、skillListingBudgetFraction の範囲内により多くのスキルを収めたい場合は値を引き下げてください。

taskOutputMaxChars

[!WARNING]

v2.1.277 で、このキーがサイズを決めていた TaskOutput ツールとともに削除されました。現在のバージョンでは設定しても効果はありません。Claude は代わりに Read でバックグラウンドタスクの出力ファイルを読み取ります。

v2.1.276 までは、Claude が TaskOutput ツールでタスクを読み取る際にインラインで受け取るバックグラウンドタスクの出力の文字数を、このキーに設定していました。

インターフェースとターミナル

ターミナルでの Claude Code の見た目と動作を変更します。テーマ、エディターモード、ステータスライン、スピナー、セッション内の通知、アクセシビリティが対象です。ターミナル設定を参照してください。

askUserQuestionTimeout

応答のない AskUserQuestion ダイアログを、一定のアイドル時間の後に自動で続行させ、その時点までに選択していたオプションを送信します。席を外している間も Claude に作業を続けさせたい場合に設定します。デフォルトでは、質問は回答するまで待機します。タイマーが一時停止する場合や開始しない場合については、Question auto-continue timeout を参照してください。

• スコープ: User or managed
• 型: 文字列。"60s"、"5m"、"10m"、"never" のいずれか
• デフォルト: "never"

{
  "askUserQuestionTimeout": "5m"
}

/config では Question auto-continue timeout として表示され、このキーをユーザー設定に書き込みます。管理設定または --settings フラグがこのキーを設定している間、Claude Code はこの行を非表示にします。

autoContinueAtUsageLimit

claude.ai の使用制限によってセッションが停止した後、開いたままのセッションで待機し、リセット後にタスクを自動的に続行します。自動続行をオフにするを参照してください。Claude Code v2.1.234 以降が必要です。

• スコープ: User or managed。ユーザー設定、--settings、管理設定からのみ読み取られます。これらのいずれもキーを設定していない場合、キーを設定しているプロジェクト設定ファイルやローカル設定ファイルは無視されるのではなく、この機能をオフにします。
• 型: Boolean
  • true: claude.ai の使用制限によってセッションが停止した後、Claude Code は開いたままのセッションで待機し、リセット後にタスクを自動的に続行します
  • false: Claude Code は自分から待機を開始しません。使用制限のオプションメニューから自分で待機を開始することは引き続き可能です
• デフォルト: true

{
  "autoContinueAtUsageLimit": false
}

/config では Continue automatically at usage limit として表示され、このキーをユーザー設定に書き込みます。管理設定または --settings フラグがこのキーを設定している間、Claude Code はこの行を非表示にします。

autoScrollEnabled

フルスクリーンレンダリングで、新しい出力に合わせて会話の末尾まで追従します。オフにすると、Claude が作業を続けている間もスクロールした位置にとどまります。権限プロンプトは引き続きスクロールして表示されます。

• スコープ: Any file
• 型: Boolean
  • true: 会話が新しい出力に合わせて末尾まで追従します
  • false: Claude が作業を続けている間もスクロールした位置にとどまります。権限プロンプトは引き続きトランスクリプトの下に表示されます
• デフォルト: true

{
  "autoScrollEnabled": false
}

フルスクリーンレンダリングがオンのとき、/config に Auto-scroll として表示され、このキーをユーザー設定に書き込みます。

axScreenReader

スクリーンリーダー向けの出力をレンダリングします。装飾的な枠線やアニメーションのないフラットなテキストです。スクリーンリーダーモードはクラシックレンダラーを使用するため、有効な間は tui 設定は効果がありません。アタッチされたバックグラウンドセッションは引き続きフルスクリーンでレンダリングされます。

• スコープ: User or managed。--settings で渡すファイルでもキーを設定できます。Claude Code はプロジェクト設定とローカル設定のキーを無視するため、リポジトリも自分の .claude/settings.local.json もスクリーンリーダーモードをオンまたはオフにすることはできません。
• 型: Boolean
  • true: Claude Code はクラシックレンダラーを使用して、装飾的な枠線やアニメーションのないフラットなテキストをレンダリングします
  • false: Claude Code は通常どおりレンダリングします
• デフォルト: 未設定のため、スクリーンリーダーモードはオフです
• セッションごとの上書き: 1 つのセッションに対して、--ax-screen-reader は CLAUDE_AX_SCREEN_READER より優先され、どちらもこのキーより優先されます

{
  "axScreenReader": true
}

bashEditDiffEnabled

Bash コマンドの実行中に Git リポジトリ内で変更されたファイルを Claude Code が記録するかどうかを選択します。記録される場合、コマンドの後にターミナルでその差分が表示され、PostToolUse Bash フックは変更されたファイルのリストを受け取ります。

リストに含まれるファイルが、必ずしもそのコマンドによって変更されたものとは限りません。コマンドの実行中に別のプログラムや別の Bash 呼び出しが行った変更も含まれることがあります。

すべての権限モードで記録するには、キーを true に設定します。Claude Code v2.1.269 以降が必要です。

• スコープ: User or managed。true はユーザー設定、--settings で渡された JSON、または管理設定からのものだけが有効になるため、リポジトリの .claude/settings.json や .claude/settings.local.json にある true では記録をオンにできません。ただし、どちらかのリポジトリファイルにある false は、優先順位の高いファイルが true を設定していない限り、記録をオフにします。
• 型: Boolean
• デフォルト: 未設定。この場合、Claude Code は auto モードと bypassPermissions モードで、Bash を通じてファイルを編集するよう Claude に指示したときに変更を記録します
• セッションごとの上書き: 1 つのセッションに対して、CLAUDE_CODE_BASH_EDIT_DIFF はこのキーより優先されます

{
  "bashEditDiffEnabled": true
}

companyAnnouncements

起動時に組織のお知らせをユーザーに表示します。複数を指定した場合、Claude Code はセッションごとに 1 つをランダムに選びます。ユーザーが初めて起動したときは、最初のエントリを表示します。

• スコープ: Any file
• 型: 文字列の配列
• デフォルト: 未設定のため、お知らせは表示されません

{
  "companyAnnouncements": [
    "Welcome to Acme Corp! Review our code guidelines at docs.example.com"
  ]
}

defaultShell

入力ボックスで ! プレフィックスを付けて入力したシェルコマンド、つまり Claude Code が直接実行してセッションに追加するコマンドを、Bash と PowerShell のどちらで実行するかを選択します。

"powershell" は PowerShell ツールがオンの場合にのみ機能します。このツールは、Git Bash のない Windows ではデフォルトでオンになり、Git Bash のある Windows では claude.ai アカウントと Console アカウントでオンになります。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry のセッション、および macOS、Linux、WSL では、CLAUDE_CODE_USE_POWERSHELL_TOOL=1 を設定するとツールがオンになります。この変数を 0 に設定するとツールがオフになります。

• スコープ: Any file
• 型: 文字列。次のいずれか:
  • "bash": Claude Code は ! コマンドを Bash で実行します
  • "powershell": Claude Code は ! コマンドを PowerShell で実行します
• デフォルト: "bash"。Bash が利用できない Windows では "powershell"

{
  "defaultShell": "powershell"
}

指定したシェルが利用できない場合、Claude Code はもう一方を使用します。PowerShell ツールがオフの場合、"powershell" は Bash にフォールバックし、Bash がインストールされていない場合、"bash" は PowerShell にフォールバックします。

dialogExpiry

Remote Control や SDK ホストなど、Claude Code がリモートクライアントに転送するダイアログ、および保留中のセッション間メッセージの承認ダイアログの期限を設定します。Claude Code v2.1.236 以降では、ターミナルに誰もいない可能性のあるセッションにおいて、セッション途中の Fable 使用クレジットの同意プロンプトにも同じ期限が適用されます。期限までに回答がない場合、Claude Code はダイアログをキャンセルし、何もしないというデフォルトで続行します。Claude Code v2.1.224 以降が必要です。

• スコープ: User or managed
• 型: 文字列。"60s"、"5m"、"10m"、または期限を無効にする "never" のいずれか
• デフォルト: "5m"
• セッションごとの上書き: 1 つのセッションに対して、CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS はこのキーより優先されます

{
  "dialogExpiry": "10m"
}

権限プロンプトと AskUserQuestion の質問は独自のフローを使用するため、この期限の対象にはなりません。/config では Dialog expiry として表示され、このキーをユーザー設定に書き込みます。この行には Claude Code v2.1.232 以降が必要で、管理設定または --settings フラグがこのキーを設定している間、Claude Code はこの行を非表示にします。

editorMode

入力プロンプトのキーバインドモードを選択します。

• スコープ: Any file
• 型: 文字列。次のいずれか:
  • "normal": プロンプト入力での標準キーバインド
  • "vim": NORMAL、INSERT、VISUAL モードを備えた vim スタイルの編集
• デフォルト: "normal"

{
  "editorMode": "vim"
}

/config では Editor mode として表示され、このキーをユーザー設定に書き込みます。

emojiCompletionEnabled

プロンプト入力で : に続けてショートコードを入力すると絵文字の候補を表示し、:heart: のような完成したショートコードを対応する絵文字に置き換えます。両方をオフにするには false に設定します。

• スコープ: Any file
• 型: Boolean
  • true: Claude Code は : の後に絵文字の候補を表示し、完成したショートコードを絵文字に置き換えます
  • false: Claude Code は絵文字を候補表示せず、ショートコードも置き換えません
• デフォルト: true

{
  "emojiCompletionEnabled": false
}

絵文字ショートコードを参照してください。

fileSuggestion

組み込みのファイル候補の代わりに独自のコマンドを実行して、@ によるファイルパスのオートコンプリートを提供します。組み込みの候補は高速なファイルシステム走査を使用しますが、大規模なモノレポでは、事前構築されたファイルインデックスなどのプロジェクト固有のインデックスの方が適している場合があります。

• スコープ: Any file。ステータスラインとファイル候補のゲートのもとでは、Claude Code はコマンドをオフにするか管理設定の値のみを実行し、ユーザーの値は警告なしにスキップします。
• 型: 常に "command" である type と、実行するシェルコマンドである command を持つオブジェクト
• デフォルト: 未設定のため、Claude Code は組み込みのファイル候補を使用します

{
  "fileSuggestion": {
    "type": "command",
    "command": "~/.claude/file-suggestion.sh"
  }
}

これを保存した後、プロンプトで @ に続けてパスの一部を入力すると、候補はコマンドの出力から取得されます。

コマンドの入力と出力

Claude Code は、CLAUDE_PROJECT_DIR を含め、フックと同じ環境変数でコマンドを実行し、5 秒経過すると待機をやめます。コマンドは stdin で JSON を受け取り、その query フィールドにはそれまでに入力された内容が入っています:

{"query": "src/comp"}

改行区切りのファイルパスを stdout に出力します。Claude Code は最大 15 件を表示します:

src/components/Button.tsx
src/components/Modal.tsx
src/components/Form.tsx

次のスクリプトはクエリを読み取り、リポジトリのファイルインデックスに渡します:

#!/bin/bash
query=$(cat | jq -r '.query')
# Replace your-repo-file-index with your own file search command
your-repo-file-index --query "$query" | head -20

footerLinksRegexes

正規表現がターンの出力（ファイルの内容や取得したページを含むツール結果、および Claude 自身の応答）に一致したとき、入力ボックスの下のフッターにクリック可能な追加バッジをレンダリングします。レビューツールや課題トラッカーなど、プロジェクトの CLI が出力する ID をセッション内のリンクに変えるために使用します。

• スコープ: User or managed
• 型: オブジェクトの配列。各オブジェクトは "regex" に設定された type、正規表現の pattern、url テンプレート、およびオプションの label を持ちます。url と label 内の {name} プレースホルダーは、pattern の名前付きキャプチャグループから埋められます
• デフォルト: 未設定のため、バッジはレンダリングされません

この例では PROJ-1234 のような課題キーに一致させ、キャプチャしたキーから各リンクを作成します:

{
  "footerLinksRegexes": [
    {
      "type": "regex",
      "pattern": "\\b(?<key>PROJ-\\d+)\\b",
      "url": "https://issues.example.com/browse/{key}",
      "label": "{key}"
    }
  ]
}

これを設定すると、ツール結果や Claude の応答に PROJ-1234 が現れたとき、https://issues.example.com/browse/PROJ-1234 にリンクする PROJ-1234 バッジがフッターに表示されます。

バッジの制約

各エントリの URL、ラベル、バッジ数には次の制限があります:

ターンが完了すると、Claude Code はメインスレッドで各エントリの pattern 正規表現をターンの出力と照合するため、遅い正規表現は完了するまで UI をブロックします。(a+)+$ のようなネストした量指定子は、特定の入力に対して指数関数的に時間がかかり、セッションをフリーズさせる可能性があるため、各 pattern は線形に保ち、+ や * のネストは避けてください。

カスタムステータスラインが設定されている場合、フッターバッジはそれと並んでレンダリングされ、どちらも他方を置き換えることはありません。セッションデータから独自にコンテンツを計算するスクリプト駆動の行にはステータスラインを使用し、スクリプトなしで会話中の ID をリンクに変えるにはフッターバッジを使用します。

keybindingFlavor

[!WARNING]

v2.1.261 以降は非推奨で、効果はありません。プロンプトの単語編集キーは、Bash と同様に常に readline の慣例に従います。Claude Code は引き続き keybindingFlavor を受け付けるため、これを設定している設定ファイルは有効なままです。

v2.1.238 から v2.1.260 では、これを "readline" に設定すると、Ctrl+W は直前の単語だけを削除するのではなく、直前の空白まで戻って削除するようになりました。

• スコープ: Any file
• 型: 文字列。"classic" または "readline"
• デフォルト: 未設定

maxProseWidth

Claude の応答に含まれる文章の幅に上限を設け、幅の広いターミナルでも行を読みやすく保ちます。段落、見出し、リスト、引用ブロックはこのカラム数の範囲内で折り返され、テーブルとコードブロックはターミナルの全幅を維持します。Claude Code v2.1.282 以降が必要です。

• スコープ: Any file
• 型: ターミナルのカラム数。整数で、最小値は 40 です。Claude Code はそれ以外の値を無視します
• デフォルト: 未設定のため、文章はターミナルの端で折り返されます

{
  "maxProseWidth": 80
}

prefersReducedMotion

スピナー、シマー、フラッシュ効果などのインターフェースのアニメーションを減らすか、オフにします。/config では Reduce motion として表示されます。

• スコープ: Any file
• 型: Boolean
  • true: Claude Code はスピナー、シマー、フラッシュ効果などのインターフェースのアニメーションを減らすか、オフにします
  • false: 未設定と同じです。Claude Code はアニメーションを表示します
• デフォルト: false

{
  "prefersReducedMotion": true
}

promptSuggestionEnabled

プロンプト入力に表示されるグレーアウトされた予測であるプロンプト候補の表示・非表示を切り替えます。非表示にするには、false に設定するか、/config で Prompt suggestions をオフにします。

• スコープ: Any file
• 型: Boolean
  • true: プロンプト入力にプロンプト候補が表示されます
  • false: Claude Code はプロンプト候補を非表示にします
• デフォルト: true
• セッションごとの上書き: 1 つのセッションに対して、CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION はこのキーより優先されます

{
  "promptSuggestionEnabled": false
}

プロンプト候補には、テレメトリがオンになっている claude.ai アカウントまたは Console アカウントが必要です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry を使用している場合や、DISABLE_TELEMETRY などでテレメトリがオフになっている場合、このキーは効果がなく、CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=1 のみがプロンプト候補をオンにします。

respectGitignore

@ ファイルピッカーが .gitignore のパターンに一致するファイルを除外するかどうかを制御します。/config では Respect .gitignore in file picker として表示されます。

• スコープ: Any file。どの設定ファイルもこれを設定していない場合、Claude Code は /config のトグルが書き込む ~/.claude.json の respectGitignore にフォールバックします。
• 型: Boolean
  • true: @ ファイルピッカーは .gitignore のパターンに一致するファイルを除外します
  • false: @ ファイルピッカーは .gitignore のパターンに一致するファイルを含めます
• デフォルト: true

{
  "respectGitignore": false
}

respondToBashCommands

入力ボックスで ! プレフィックスを付けてシェルコマンドを実行した後に Claude が応答するかどうかを選択します。デフォルトでは、Claude Code はコマンドの出力を会話に追加し、Claude がそれに応答します。このキーを false に設定すると、応答なしで出力がコンテキストに追加されるため、複数のコマンドを実行してからまとめて質問できます。

• スコープ: Any file
• 型: Boolean
  • true: Claude Code はコマンドの出力を会話に追加し、Claude がそれに応答します
  • false: Claude Code は応答なしで出力をコンテキストに追加します
• デフォルト: true

{
  "respondToBashCommands": false
}

! プレフィックスによるシェルモードを参照してください。

showClearContextOnPlanAccept

plan モードで Claude がプランを完成させると、承認メニューが表示されます。プランの作成には多くのコンテキストを使用することがあるため、このキーはそのメニューに最初のオプションとして Yes, clear context and … を追加します。このオプションはプランを承認し、会話のコンテキストをクリアして、プランのみから実装を開始します。ラベルの残りの部分には、セッションが継続する権限モードの名前と、プランの作成に使用したコンテキストの量が表示されます。

• スコープ: Any file
• 型: Boolean
  • true: プラン承認メニューに、プランを承認して会話のコンテキストをクリアする最初のオプション Yes, clear context and … が追加されます
  • false: プラン承認メニューにコンテキストをクリアするオプションは表示されません
• デフォルト: false

{
  "showClearContextOnPlanAccept": true
}

showTurnDuration

各応答の後に表示される「Cooked for 1m 6s · done 6:05 PM」のようなターン所要時間メッセージの表示・非表示を切り替えます。「done」の後の時刻はターンが終了した時刻を示し、timeFormat と timeZone がその形式とタイムゾーンを制御します。/config では Show turn duration として表示されます。

• スコープ: Any file。どの設定ファイルもこれを設定していない場合、古いバージョンの ~/.claude.json にある値が適用されます。
• 型: Boolean
  • true: 各応答の後にターン所要時間メッセージが表示されます
  • false: Claude Code はターン所要時間メッセージを非表示にします
• デフォルト: true

{
  "showTurnDuration": false
}

spellcheck

インストールしたスペルチェッカーを使用して、入力中にプロンプト入力内のスペルミスに下線を引きます。Claude Code は入力ボックス内のテキストのみをチェックします。aspell、hunspell、ispell のインストール方法とチェッカーの対象範囲については、入力中のスペルチェックで説明しています。Claude Code v2.1.235 以降が必要です。

• スコープ: User or managed。これを設定している最上位の階層のブロックが全体として適用されます。
• 型: enabled（Boolean）、checker（"aspell"、"hunspell"、"ispell"、または "auto"）、language（文字列。辞書名としてチェッカーに渡されます）、color（文字列。ターミナルのカラー名、#rrggbb、rgb(r,g,b)、ansi256(n)、または ansi:<name>）を持つオブジェクト
• デフォルト: 未設定のため、スペルチェックはオフです。checker のデフォルトは "auto" で、PATH 上で最初に見つかった 3 つのうちのいずれかです。language のデフォルトはチェッカー自身の辞書です。color のデフォルトはテーマのエラーカラーです

{
  "spellcheck": { "enabled": true, "language": "en_GB" }
}

spinnerTipsEnabled

Claude が作業している間、スピナーの行には「Use Plan Mode to prepare for a complex request before making changes. Press Shift+Tab twice to enable.」のような Claude Code の機能に関する短いヒントが順番に表示されます。非表示にするには、このキーを false に設定します。/config では Show tips として表示されます。

• スコープ: Any file
• 型: Boolean
  • true: Claude の作業中にスピナーにヒントが表示されます
  • false: Claude Code はスピナーのヒントを非表示にします
• デフォルト: true

{
  "spinnerTipsEnabled": false
}

spinnerTipsOverride

Claude の作業中に Claude Code が表示するスピナーのヒントに独自のヒントを追加するか、組み込みのヒントを独自のものに置き換えます。Claude Code は独自のヒントを組み込みのヒントと同じローテーションに入れます。

spinnerTipsEnabled を false に設定すると、Claude Code は独自のものを含むすべてのヒントを非表示にします。

• スコープ: Any file。Claude Code は、ユーザー設定、--settings フラグ、管理設定からのヒントオブジェクト、tipsFile、label、excludeDefault を受け付けます。プロジェクト設定とローカル設定からはプレーンな文字列のヒントのみを読み取ります。
• 型: tips、tipsFile、label、excludeDefault フィールドを持つオブジェクト。各フィールドはオプションです
• デフォルト: 未設定のため、Claude Code は組み込みのヒントのみを表示します

ヒントオブジェクト、tipsFile、label、およびプロジェクト設定とローカル設定はプレーンな文字列のみを提供するというスコープ行のルールには、Claude Code v2.1.247 以降が必要です。

各 tips エントリは、プレーンな文字列か、次のフィールドを持つオブジェクトです:

Claude Code はプレーンな文字列を、これらのデフォルト値と位置に基づく id を持つヒントとして読み取るため、リストを並べ替えるとその表示履歴はリセットされます。編集しても履歴を維持するには、ヒントに id を付けてください。

Claude Code は tips と tipsFile を合わせて最大 200 個のヒントを読み取り、無効なエントリは設定ファイルを拒否するのではなく、デバッグ警告を出して破棄します。

残りのフィールドを使用して、ヒントファイルの指定、プレフィックスの設定、組み込みヒントの非表示を行います:

• tipsFile: 同じエントリの配列、または tips 配列を持つオブジェクトを含むローカル JSON ファイルへの絶対パスまたは ~/ パス。最大 256 KB です。Claude Code はプロセスごとに 1 回ファイルを読み取るため、編集内容は次回の起動時に読み込まれます。サーバー管理設定では設定できません。そこではインラインの tips をデプロイするか、ディスク上の managed-settings.json にパスをデプロイしてください。
• label: ユーザー設定、--settings、管理設定からのヒントの前に Claude Code が表示するプレフィックス。最大 40 文字です。デフォルトは組み込みヒントと同じプレフィックスである Tip で、プロジェクト設定とローカル設定からのヒントは常にこれを使用します。
• excludeDefault: 組み込みヒントを非表示にして独自のヒントのみを表示するには、true に設定します。tipsFile が存在しない、またはすべてのエントリが無効であるなどの理由で Claude Code が独自のヒントを 1 つも読み込めない場合は、スピナーを空にするのではなく、組み込みのローテーションを維持します。

複数の設定ファイルがこのキーを設定している場合、Claude Code はそれらすべてのヒントを表示し、tipsFile、label、excludeDefault については、管理設定、--settings フラグ、ユーザー設定のうち、それぞれを設定している最も優先順位の高いものから取得します。

ユーザー設定に記述したこの例では、プレーンな文字列のヒントとオブジェクトのヒントを Acme tip プレフィックスでローテーションに追加します:

{
  "spinnerTipsOverride": {
    "label": "Acme tip",
    "tips": [
      "Run /review before opening a PR",
      {
        "id": "gateway-errors",
        "text": "Seeing 5xx errors? Check the gateway status page first",
        "cooldownSessions": 5,
        "priority": 2
      }
    ]
  }
}

例の各フィールドは、Claude Code によるヒントの表示方法をそれぞれ 1 点ずつ変更します:

• label: Claude Code は両方のヒントを Tip: ... ではなく Acme tip: ... として表示します。
• プレーンな文字列: Claude Code はデフォルト値を与えるため、すぐ次のセッションで再び表示されることがあります。
• id: Claude Code は 2 つ目のヒントの表示履歴を gateway-errors をキーとして管理するため、ヒントを追加したり並べ替えたりしてもクールダウンは引き続き適用されます。
• cooldownSessions: Claude Code は gateway-errors ヒントを表示した後、5 セッション後まで再び表示しません。
• priority: gateway-errors ヒントと別のヒントが同じセッション数だけ未表示である場合（たとえばどちらもまだ表示されていない場合）、Claude Code は gateway-errors を先に表示します。プレーンな文字列はデフォルトの優先度 0 を持ちます。

Claude の作業中、Claude Code は Acme tip: Run /review before opening a PR のように、独自のプレフィックス付きでヒントをスピナーに表示します。

spinnerVerbs

ターンの進行中、スピナーには「Accomplishing」「Architecting」「Baking」などの動詞が順番に表示されます。このキーを使用して、そのローテーションに独自の動詞を追加するか、組み込みのリストを独自のものに置き換えます。

• スコープ: Any file
• 型: 文字列の verbs 配列と mode を持つオブジェクト。mode は次のいずれか:
  • "append": Claude Code は独自の動詞を組み込みのセットに追加します
  • "replace": Claude Code は独自の動詞のみを表示します
• デフォルト: 未設定のため、Claude Code は組み込みの動詞を使用します

この例では、組み込みのセットに 2 つの動詞を追加します:

{
  "spinnerVerbs": {
    "mode": "append",
    "verbs": ["Pondering", "Crafting"]
  }
}

"replace" モードで verbs 配列が空の場合、Claude Code は組み込みの動詞を維持します。

statusLine

独自のコマンドを実行して、モデル、コスト、git ブランチなどのコンテキストを含むステータスラインをプロンプトの下にレンダリングします。オプションのフィールドで、間隔の調整、定期的な再実行の追加、スクリプト自身が vim.mode をレンダリングする場合の組み込み vim モードインジケーターの非表示を行えます。

• スコープ: Any file。allowManagedHooksOnly がオンの場合、または管理設定以外で disableAllHooks が設定されている場合は、管理設定の値のみが実行されます。
• 型: "command" に設定された type と command 文字列、およびオプションで文字数を表す数値の padding、秒数を表す数値（最小 1）の refreshInterval、Boolean の hideVimModeIndicator を持つオブジェクト
• デフォルト: 未設定のため、ステータスラインはありません

この例では、モデル名とコンテキスト使用量を出力し、水平方向に 2 文字分の間隔を追加します:

{
  "statusLine": {
    "type": "command",
    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'",
    "padding": 2
  }
}

この例には jq のインストールが必要で、シェルで実行されます。PowerShell と Git Bash での同等の設定については、Windows での設定を参照してください。セットアップ全体については、ステータスラインを手動で設定するを参照してください。

subagentStatusLine

Claude がサブエージェントを実行すると、Claude Code はプロンプトの下のタスク表示にそれらを一覧表示し、サブエージェントごとに name · description · token count を示す行を 1 つずつ表示します。このキーを使用すると、独自のコマンドを実行してそれらの行を書き換えることができます。たとえば、各サブエージェントのコンテキスト使用量をパーセンテージで表示できます。更新のたびに、Claude Code は表示中の行を 1 つの JSON オブジェクトとして stdin に送信します。このオブジェクトの tasks 配列には、各サブエージェントの id、name、status、model、tokenCount などが含まれます。Claude Code は、{"id", "content"} 行として書き戻した各 id の行を置き換えます。書き戻さなかった行はデフォルトのレンダリングのままです。

• スコープ: Any file。allowManagedHooksOnly がオンの場合、または管理設定以外で disableAllHooks が設定されている場合は、管理設定の値のみが実行されます。
• 型: "command" に設定された type と command 文字列を持つオブジェクト
• デフォルト: 未設定のため、Claude Code はデフォルトの行をレンダリングします

{
  "subagentStatusLine": {
    "type": "command",
    "command": "jq -c '.tasks[] | {id, content: \"\\(.name): \\(.tokenCount) tokens\"}'"
  }
}

サブエージェントのステータスラインを参照してください。

syntaxHighlightingDisabled

Claude Code は、ターミナルに表示する差分、コードブロック、ファイルプレビューのコードを、組み込みのハイライターで言語ごとに色分けします。プラグインや言語サーバーは関与しません。代わりにプレーンテキストとして表示するには、このキーを true に設定します。たとえば、色がターミナルのテーマと合わない場合や、スクリーンリーダーの動作が遅くなる場合に使用します。

• スコープ: Any file
• 型: Boolean
  • true: Claude Code は差分、コードブロック、ファイルプレビューのシンタックスハイライトをオフにします
  • false: Claude Code はシンタックスハイライトを行います
• デフォルト: false

{
  "syntaxHighlightingDisabled": true
}

terminalProgressBarEnabled

一部のターミナルでは、内部で実行中のプログラムについて、タブやタスクバーに進行状況インジケーターを表示できます。Claude が作業している間、Claude Code は進行中の状態をターミナルに報告するため、別のタブやウィンドウからセッションがまだ処理中かどうかを確認できます。インジケーターは、ターンの終了後もバックグラウンドサブエージェントや動的ワークフローがまだ実行中であれば表示されたままになり、セッションがアイドル状態になると消えます。

Claude Code は、インジケーターをサポートするターミナル（ConEmu、Ghostty 1.2.0 以降、iTerm2 3.6.6 以降）でのみこれを報告します。Claude Code による報告を停止するには、このキーを false に設定します。/config では Terminal progress bar として表示されます。

• スコープ: Any file。どの設定ファイルもこれを設定していない場合、古いバージョンの ~/.claude.json にある値が適用されます。
• 型: Boolean
  • true: サポートしているターミナルでターミナルのプログレスバーが表示されます
  • false: Claude Code はターミナルのプログレスバーを非表示にします
• デフォルト: true

{
  "terminalProgressBarEnabled": false
}

terminalTitleFromRename

Claude Code はターミナルタブのタイトルを設定します。デフォルトでは会話から生成したタイトルを使用し、/rename または --name でセッションに名前を付けると、タブには代わりにその名前が表示されます。セッションに名前を付けた後も生成されたタイトルをタブに残すには、このキーを false に設定します。名前自体は引き続き適用されるため、/resume <name> やセッションピッカーで見つけられます。

• スコープ: Any file
• 型: Boolean
  • true: ターミナルタブのタイトルに、設定したセッション名が表示されます
  • false: タブには Claude Code が会話から生成したタイトルが残ります
• デフォルト: true

{
  "terminalTitleFromRename": false
}

Claude Code によるターミナルタイトルの更新を完全に停止するには、代わりに CLAUDE_CODE_DISABLE_TERMINAL_TITLE を 1 に設定します。

theme

インターフェースのカラーテーマを選択します。/config では Theme として表示されます。

• スコープ: Any file。どの設定ファイルもこれを設定していない場合、古いバージョンの ~/.claude.json にある値が適用されます。
• 型: 文字列。次のいずれか:
  • "auto": ターミナルの明るい背景または暗い背景に合わせます
  • "dark": ダークテーマ
  • "light": ライトテーマ
  • "dark-daltonized": 色覚多様性に配慮した色を使用するダークテーマ
  • "light-daltonized": 色覚多様性に配慮した色を使用するライトテーマ
  • "dark-ansi": ターミナルの ANSI カラーパレットのみを使用するダークテーマ
  • "light-ansi": ターミナルの ANSI カラーパレットのみを使用するライトテーマ
  • "custom:<slug>" または "custom:<plugin-name>:<slug>": ~/.claude/themes/ またはプラグインのカスタムテーマ
• デフォルト: "dark"

{
  "theme": "light-daltonized"
}

カスタムテーマを作成するを参照してください。

timeFormat

各ターン所要時間メッセージの末尾にある done 6:05 PM やトランスクリプトビューアーのタイムスタンプなど、Claude Code がインターフェースに表示する時刻の書式を選択します。プリセットを選ぶには、/config を実行して Time format を設定します。Claude Code v2.1.257 以降が必要です。

• スコープ: Any file
• 型: 文字列。次のいずれか:
  • "auto": 未設定と同じです。各時刻は組み込みの書式を維持し、ターン所要時間メッセージではロケールに従います
  • "12-hour": 12 時間制
  • "24-hour": 24 時間制
  • "24-hour-utc": 18:05Z のように分の後に Z を付けた UTC の 24 時間制。このプリセットでは Claude Code は timeZone を無視します
  • "%H:%M" のような strftime パターン: Claude Code は各時刻をそのパターンで書き出します。% を含む値はすべてパターンとして扱われ、プリセット以外のその他の値は "auto" として扱われます
• デフォルト: "auto"

{
  "timeFormat": "24-hour"
}

/config ではプリセットのみが提供されるため、strftime パターンを使用するには、設定ファイルにキーを追加します。この例では、各時刻を 2 桁の 24 時間制で表示します:

{
  "timeFormat": "%H:%M"
}

すると、ターン所要時間メッセージとトランスクリプトビューアーには 18:05 のような時刻が表示されます。トランスクリプトビューアーではパターンがタイムスタンプ全体になるため、日付を表示したい場合は日付のディレクティブを追加します。この例では、時刻の前に日付を置きます:

{
  "timeFormat": "%Y-%m-%d %H:%M"
}

すると、同じ箇所に 2026-09-01 18:05 のような時刻が表示されます。

timeZone

インターフェースの時刻を、システムとは異なるタイムゾーンで表示します。"UTC" や "Europe/Dublin" のような IANA タイムゾーン名を設定します。すると、timeFormat が制御する時刻がこのタイムゾーンで表示されます。timeFormat が "24-hour-utc" の場合、時刻は UTC のままで、Claude Code はこのキーを無視します。/config にはこのキーの行がないため、設定ファイルで設定してください。Claude Code v2.1.257 以降が必要です。

• スコープ: Any file
• 型: 文字列。IANA タイムゾーン名です。Claude Code が名前を認識できない場合は、システムのタイムゾーンを使用します
• デフォルト: 未設定のため、時刻はシステムのタイムゾーンで表示されます

{
  "timeZone": "Europe/Dublin"
}

tui

ターミナル UI のレンダラーを選択します。仮想化されたスクロールバックを備えたちらつきのない代替画面レンダラーには "fullscreen" を、クラシックなメイン画面レンダラーには "default" を使用します。/tui fullscreen または /tui default を実行すると、このキーが自動的に書き込まれます。

• スコープ: Any file
• 型: 文字列。次のいずれか:
  • "default": クラシックなメイン画面レンダラー
  • "fullscreen": 仮想化されたスクロールバックを備えた、ちらつきのない代替画面レンダラー
• デフォルト: 未設定のため、Claude Code がレンダラーを選択します
• セッションごとの上書き: 1 つのセッションに対して、CLAUDE_CODE_NO_FLICKER と CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN はこのキーより優先されます。CLAUDE_CODE_NO_FLICKER=1 はフルスクリーンをオンにし、CLAUDE_CODE_NO_FLICKER=0 または CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 はオフにします。両方が設定されている場合、Claude Code はオフにします

{
  "tui": "fullscreen"
}

tmux -CC 環境下や、Windows への SSH 接続時には、CLAUDE_CODE_NO_FLICKER=1 を設定しない限り、Claude Code はクラシックレンダラーを維持します。エージェントビューから開いたバックグラウンドセッションは、この設定にかかわらず常にフルスクリーンレンダラーを使用します。

verbose

デフォルトでは、トランスクリプトは各ツール呼び出しを、Claude が実行したコマンドやその出力の行数などの短い概要に折りたたみます。詳細を見たいときは Ctrl+O を押すと、トランスクリプト全体が展開表示に切り替わります。このキーを true に設定すると、すべてのツール呼び出しの完全な入力と出力が発生と同時にインラインで表示されます。これは、フック、MCP サーバー、または長いシェルコマンドをデバッグするときに便利です。/config では Verbose output として表示されます。

• スコープ: Any file。どの設定ファイルもこれを設定していない場合、古いバージョンの ~/.claude.json にある値が適用されます。
• 型: Boolean
  • true: ツールの完全な出力が表示されます
  • false: ツール出力の切り詰められた概要が表示されます
• デフォルト: false
• セッションごとの上書き: 1 つのセッションに対して、--verbose はこのキーより優先されます

{
  "verbose": true
}

viewMode の値、または保持された /focus の選択は、すべてのセッションでこのキーを上書きします。

viewMode

Claude Code が起動時に使用するトランスクリプトビューを "default"、"verbose"、"focus" のいずれかに設定します。設定すると、保持された /focus の選択と verbose 設定の両方を上書きします。

• スコープ: Any file
• 型: 文字列。次のいずれか:
  • "default": ツール出力が切り詰められた通常のトランスクリプト
  • "verbose": ツールの完全な出力を含むトランスクリプト
  • "focus": 最後のプロンプト、編集の diffstat を含むツール呼び出しの 1 行の概要、および最終的な応答のみ。フォーカスビューにはフルスクリーンレンダラーが必要です
• デフォルト: 未設定のため、verbose 設定と最後の /focus の選択が適用されます
• セッションごとの上書き: 1 つのセッションに対して、--verbose はこのキーより優先されます

{
  "viewMode": "focus"
}

vimInsertModeRemaps

vim エディターモードで、2 キーの INSERT モードのシーケンスを Escape にマッピングします。各キーは順に入力されるちょうど 2 つの印字可能文字で、サポートされるターゲットは "<Esc>" のみです。Claude Code はその他のエントリを無視します。

• スコープ: User or managed。リポジトリがユーザーのキー入力を再マッピングすることはできません。
• 型: 2 文字のシーケンスを "<Esc>" にマッピングするオブジェクト
• デフォルト: 未設定

{
  "vimInsertModeRemaps": {
    "jj": "<Esc>"
  }
}

editorMode が "vim" でない限り、効果はありません。INSERT モードのキーシーケンスを再マッピングするを参照してください。