すべての設定

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 を実行して、現在の選択、アドバイザーができるモデル、およびアドバイザーなしを表示するピッカーを開きます。Claude Code は選択を ~/.claude/settings.json のこのキーに保存します。リモートコントロールクライアントから、またはリモートワーカーに接続されたセッションで選択した場合、その選択はそのセッションのみに適用され、このキーは変更されません。

アカウントが使用クレジット同意を必要とする場合は、/model fable を実行して最初に同意を受け入れます。これを行うまで、/advisor で Fable を選択しても何も保存されず、Claude Code は最初に /model fable を実行するよう指示します。

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

{
  "advisorModel": "opus"
}

このキーは、Amazon Bedrock や Claude Platform on AWS など、アドバイザーが利用できないプロバイダーには影響しません。"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 を送信します。

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

{
  "alwaysThinkingEnabled": false
}

availableModels

メインセッション、サブエージェント、スキル、およびアドバイザーで選択できるモデルを制限します。管理リストは /model、--model、および開発者自身のファイルの model キーを制限します。リスト外のモデルは選択できません。デフォルトのプレフィックスマッチングでは、これは Default オプション自体には影響しません。enforceAvailableModelsとペアにしてください。

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

この例では、Sonnet と Haiku モデルのみを選択できます:

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

"claude-opus-5" などのモデル ID エントリは、Opus 5.5 などそれを拡張する後のバージョンも許可します。これらのバージョンのいずれかをブロックするには、deniedModelsを使用します。各モデル ID エントリが名前を付けたバージョンのみを許可するようにするには、availableModelsMatchを使用します。モデル選択を制限を参照してください。

availableModelsMatch

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

• スコープ: 管理。Claude Code はユーザー、プロジェクト、ローカル設定および --settings のキーを無視し、警告を表示します
• タイプ: 文字列、以下のいずれか:
  • "prefix": モデル ID エントリはそのバージョンと、別のセグメントで拡張するモデル ID を許可します
  • "exact": モデル ID エントリは名前を付けたバージョンのみを許可します。日付付き ID を含むため、"claude-opus-5" は Opus 5 を許可しますが claude-opus-5-5 は許可しません。"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 以降が必要です。

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

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

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

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

effortLevel

保存していないモデルのデフォルト努力レベルを設定します。低いレベルは単純なタスクではより高速で安価であり、高いレベルは複雑な問題でより深く推論します。

マシン上のインタラクティブセッションで /effort low、medium、high、または xhigh を実行すると、Claude Code はレベルをファイルを編集するのではなく modelSettingsの下のアクティブなモデルに保存します。v2.1.251 より前では、/effort はこのキーを書き込みました。

同じ設定ファイル内で、Claude Code はこのキーではなくモデルの保存されたレベルを使用します。modelSettingsはクロスファイルの優先順位を述べています。

リモートワーカーに接続されたセッション、-p 実行、および Agent SDK では、/effort はそのセッションのみに適用されます。努力レベルを調整はそのセッションのみに適用されるインタラクティブな選択肢もリストします。/effort が出力するメッセージは、どちらが起こったかを示します。

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

{
  "effortLevel": "xhigh"
}

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

enforceAvailableModels

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

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

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

• スコープ: 任意のファイル
• タイプ: ブール値
  • 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 ターンを意味します。次のメッセージはプライマリモデルを最初に再度試します。

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

この例は、プライマリモデルが失敗したときに最初に 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 を実行すると fastMode: true が ~/.claude/settings.json に書き込まれ、再度実行すると高速モードをオフにするキーが削除されます。高速モードは Opus 5.5、Opus 5、および Opus 4.8 でのみ実行されます。別のモデルからオンにするとあなたを Opus に切り替え、サポートされていないモデルに切り替えるとオフになります。高速モードがオンの間にモデルを切り替えを参照してください。

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

{
  "fastMode": true
}

fastModePerSessionOptIn

通常、/fast を実行すると fastModeがユーザー設定に保存されるため、高速モードは後のすべてのセッションの開始時にオンになります。このキーを true に設定して、それを停止します。保存された fastMode: true はセッション開始時に高速モードをオンにしなくなり、各ユーザーは必要な各セッションで /fast を実行する必要があります。Claude Code は fastMode キーをファイルに残すため、このキーをオフにすると古い動作が復元されます。

Team または Enterprise プランのオーナーは、サーバー管理設定を通じて組織全体にデプロイできます。管理設定がキーを設定すると、/fast on はインタラクティブターミナルセッション外で拒否され、組織が高速モードを無効にしたことを報告します。これは非インタラクティブモード、VS Code 拡張機能、およびクラウドセッションをカバーします。

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

{
  "fastModePerSessionOptIn": true
}

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

language

Claude がデフォルトで英語以外の言語で応答するようにします。応答の固定リストはありません。Claude Code は値を Claude に逐語的に、常にその言語で応答するという指示として渡すため、Claude が読むことができる言語名は機能します。Claude Code は値をチェックしないため、スペルが間違った名前はエラーを生成するのではなく、書かれたとおりに Claude に到達します。同じ値は音声ディクテーションの言語を設定します。これはサポートされているディクテーション言語の固定リストを持ち、自動生成されたセッションタイトルも設定します。

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

{
  "language": "japanese"
}

maxEffortLevel

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

• スコープ: 任意のファイル。組織に対して強制するために、管理設定にデプロイします。複数のスコープがキャップを設定する場合、最も低いものが適用されるため、1 つのスコープで設定されたキャップを別のスコープから上げることはできません
• タイプ: 文字列、"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"
    }
  }
}

組織がモデルの努力制限も設定する場合、2 つのキャップの低い方が適用されます。

model

すべての新しいセッションが使用するモデルを設定するため、毎回 /model で 1 つを選択する必要はありません。ここで設定してもセッション中に切り替えることは止まりません。管理者が組織デフォルトモデルを設定してユーザー選択をオーバーライドした場合、ユーザー、プロジェクト、またはローカル設定でこのキーを設定しても、そのモデルを取得します。

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

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

ここの値は ANTHROPIC_DEFAULT_MODELをランク付けし、Claude Code は他に何もモデルを選択しない場合にのみ使用します。

modelOverrides

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

• スコープ: 任意のファイル
• タイプ: モデル 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 の Agent Platform、Microsoft Foundry、または LLM ゲートウェイのプロバイダー形式 ID を受け入れます。Claude Code v2.1.242 以降が必要です。

• スコープ: ユーザーまたは管理。Claude Code は管理設定、--settings、およびユーザー設定からキーを読み取り、プロジェクトおよびローカル設定では無視するため、クローンするリポジトリはピッカーを再ラベルできません。これら 3 つの最も高いものがキーを設定すると、ラインアップ全体が供給され、Claude Code は 2 つのソースからラインアップをマージしません。
• タイプ: options 配列と行とオプションの 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 以降が必要です。Claude Code バージョンが既に知っている claude-opus-4-8 などのモデルの ID に設定します。model が バージョンより新しいエントリで。Claude Code はそれ以降、既知のモデルの機能と努力デフォルトをエントリに適用し、そのモデルを不明として扱いません。エントリのラベルと 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 以降が必要です。

• スコープ: 管理。サーバー管理設定、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 の契約レートを設定し、すべての数字を 15% 削減します。Sonnet 行を含む:

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

1 より上、最大 10 までマークアップするには multiplier を設定します。マークアップには Claude Code v2.1.271 以降が必要です。以前のバージョンは警告付きで 1 より上の multiplier を無視し、設定の残りを保持します。

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

modelPricing のフィールド

Claude Code はレートを書き込んだとおりに使用し、高速モード割増料金またはUS のみの推論レートを追加しません。multiplier も設定する場合、Claude Code はそれを行のレートの上に適用します。Claude Code は解析できないレートを持つ行、または解析できない multiplier を削除し、残りを保持します。壊れた設定ファイルを修正を参照してください。

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

Claude Code は行のキーから行が適用されるモデルを決定します:

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

modelSettings

使用する各モデルの努力レベルを保存します。Claude Code v2.1.251 以降が必要です。

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

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

ここで指定するモデルの effortLevel は、同じ設定ファイルの最上位 effortLevelより優先されます。ファイル間では、Claude Code は各モデルを個別に解決します。そのモデルの effortLevel またはそのモデルに適用される最上位 effortLevel のいずれかを設定する最も優先度の高い設定ファイルが決定するため、管理設定の effortLevel はユーザー設定で保存されたレベルより優先されます。努力レベルを調整は、起動時の --effort など、保存されたレベルをオーバーライドできるその他のものをリストします。

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

• スコープ: 任意のファイル
• タイプ: モデル名を、以下のいずれかのフィールドを持つオブジェクトにマッピングするオブジェクト:
  • 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 を実行した後またはセッションを開始した後にのみ適用されました。

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

この例は、タスク間に教育的な洞察を追加する組み込みの Explanatory スタイルを選択します:

{
  "outputStyle": "Explanatory"
}

promptCacheTtl

プロンプトキャッシュがメイン会話を保持する期間を選択します。このキーはインタラクティブ、-p、および Agent SDK ターンに適用されます。Claude Code がインラインで実行するヘルパーと一緒に。1 時間のライフタイムはより長い休憩全体でキャッシュを温かく保ち、API は各キャッシュ書き込みを 5 分のライフタイムより高いレートで請求します。Claude Code v2.1.242 以降が必要です。

• スコープ: 任意のファイル
• タイプ: 文字列、以下のいずれか:
  • "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 は折りたたまれたスタブを表示します。

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

{
  "showThinkingSummaries": true
}

編集は、モデルが生成するものではなく、表示するものだけを変更します。思考支出を削減するには、代わりに予算を低下させるか思考を無効にします。

subagentPromptCacheTtl

プロンプトキャッシュがメイン会話外で Claude Code が行うリクエストを保持する期間を選択します。このキーはサブエージェント、ワークフロー、および Claude Code 独自のバックグラウンドおよびヘルパーリクエスト (圧縮やセッションタイトルなど)に適用されます。1 時間のライフタイムはより長い休憩全体でキャッシュを温かく保ち、API は各キャッシュ書き込みを 5 分のライフタイムより高いレートで請求します。Claude Code v2.1.242 以降が必要です。

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

この例はサブエージェントとメイン会話外の他のリクエストに 1 時間のライフタイムを与えます:

{
  "subagentPromptCacheTtl": "1h"
}

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

switchModelsOnFlag

安全分類器がリクエストにフラグを立てた場合に何が起こるかを選択します。フォールバックモデルに切り替えて続行するか、切り替えるかプロンプトを編集するかを選択できるように一時停止します。

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

{
  "switchModelsOnFlag": false
}

切り替える前に確認を参照してください。

ultracode

セッションをultracodeでオンで開始します。オンの場合、Claude は、あなたが尋ねるのを待つのではなく、各実質的なタスクのワークフローを計画します。Claude は動的ワークフローが有効になっており、モデルが xhigh 努力をサポートする場合にのみワークフローを計画します。キーはセッションの努力レベルを変更しません。ultracode はセッションが使用するレベルで実行されます。Claude Code はこのキーを読み取りますが、決して書き込みません。/effort ultracode は現在のセッションのみで ultracode をオンにします。

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

{
  "ultracode": true
}

セッションの努力レベルは effortLevel、modelSettings、および他の努力ソースから来ます。maxEffortLevelなどの努力キャップはそのレベルを低下させますが、ultracode をオフにしません。これと /effort ultracode off フォームには Claude Code v2.1.284 以降が必要です。v2.1.284 より前では、ultracode: true はセッションを xhigh 努力で実行し、xhigh より下の努力キャップは 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、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 にプラン中に auto モードを使用として表示されます。

• スコープ: User, local, or managed。リポジトリがこれをオフにすることはできません。
• タイプ: ブール値
  • true: 未設定と同じです。auto モードが利用可能な場合、分類器は計画中に各シェルコマンドを確認し、プロンプトを表示しません。ただし、重要パスの削除を除きます。これらのファイルのいずれかで false が設定されていれば、引き続きオフになります
  • 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.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（プロジェクト設定とローカル設定には制限あり）
• Type: ブール値
  • true: sandbox.enabled が true であるにもかかわらずサンドボックスが起動できない場合、Claude Code はスタートアップ時にエラーで終了します
  • false: サンドボックスが起動できない場合、Claude Code はコマンドをサンドボックスなしで実行します
• Default: false

これにより、すべての管理対象マシンがコマンドをサンドボックス化するか、起動を拒否します：

{
  "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 など、ファイル記述子を複製するもの以外のリダイレクト（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 が引き続き読み取りまたは書き込みできました。

Claude Code は末尾の /** も削除するため、~/build/** と ~/build は同じディレクトリをカバーします。* などのワイルドカードが機能するかどうかは、エントリがどのリストにあるか、およびプラットフォームに依存します：

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

波括弧は名前の中で通常の文字として一致するため、~/data/{keys,tokens} は 2 つの選択肢ではなく、文字どおり {keys,tokens} という名前のディレクトリをカバーします。~/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 に限定されたままです。コマンドが何を書き込むかではなく、どこに接続するかを制御するためにサンドボックスを使用する場合に使用します。Claude Code v2.1.216 以降が必要です。

• 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 に設定します。ファイルシステム分離を無効にするを参照して、それを設定できるソースの完全なリストと、分離がオフの場合に何が変わるかを確認してください。Claude Code v2.1.216 以降が必要です。

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_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_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 で始まる行が表示されます。

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

• セッション: 対話型のターミナルセッションを使用している
• 自動圧縮: autoCompactEnabled がオンになっている
• プロンプトキャッシュ: 会話が 1 時間のプロンプトキャッシュ TTL を使用している
• 機能フラグ: Claude Code が Anthropic から機能フラグを取得できる
• サイズ: 会話のコンテキストがトークンのしきい値に達している。しきい値はデフォルトの 200,000 から変更できます
• アイドル時間: 最後のリクエストから約 54 分が経過しており、その時点でコンピューターがスリープしていない

アイドル時のコンテキスト圧縮をオフにするには、このキーを 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 フラグ、またはプロジェクトやローカルの設定ファイルの値がユーザー設定を上書きしています。代わりにそのソースでキーを変更してください
• 機能フラグが利用できない: 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"
  }
}

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 に作業を続けさせたい場合に設定します。デフォルトでは、質問は回答されるまで待機します。タイマーが一時停止する場合や開始しない場合については、質問の自動続行タイムアウトを参照してください。

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

Claude Code が Remote Control や SDK ホストなどのリモートクライアントに転送するダイアログ、および保留されたクロスセッションメッセージの承認ダイアログの期限を設定します。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
}

絵文字ショートコードを参照してください。Claude Code v2.1.217 以降が必要です。

fileSuggestion

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

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

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

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

コマンドの入力と出力

Claude Code は、CLAUDE_PROJECT_DIR を含め、フックと同じ環境変数でコマンドを実行し、5 秒後に待機を打ち切ります。コマンドは、それまでに入力された内容を保持する query フィールドを含む JSON を stdin で受け取ります。

{"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 の作業中、スピナーの行には Claude Code の機能に関する短いヒント（「Use Plan Mode to prepare for a complex request before making changes. Press Shift+Tab twice to enable.」など）が順に表示されます。これらを非表示にするには、このキーを 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 を持つオブジェクト:
  • "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、秒数を表すオプションの refreshInterval（最小値 1）、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 に送信します。このオブジェクトには、各サブエージェントの id、name、status、model、tokenCount などを含む tasks 配列が含まれます。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": UTC の 24 時間制で、18:05Z のように分の後に Z が付きます。このプリセットでは 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 モードのキーシーケンスを再マッピングするを参照してください。

voice

音声入力をオンにし、音声入力キーの動作を選択します。/voice を実行すると、Claude Code がこのオブジェクトを自動で書き込みます。

• スコープ: Any file
• 型: Boolean である enabled、ホールドモードでのみ適用される Boolean である autoSubmit、および次のいずれかである mode を持つオブジェクト:
  • "hold": 話している間は音声入力キーを押し続け、離すと停止します
  • "tap": キーを 1 回タップすると録音が開始され、もう 1 回タップすると送信されます
• デフォルト: 未設定。音声入力はオフです。enabled が true で mode が未設定の場合、Claude Code は "hold" を使用します

この例では、音声入力をオンにし、キーを 1 回タップすると録音を開始し、もう 1 回タップすると送信するようにします。

{
  "voice": {
    "enabled": true,
    "mode": "tap"
  }
}

autoSubmit は、ホールドモードでキーを離したときにプロンプトを送信します。音声入力には claude.ai アカウントが必要です。

voiceEnabled

[!WARNING]

v2.1.92 で voice オブジェクトに置き換えられて以降、非推奨です。古い設定ファイルが引き続き機能するように Claude Code は引き続きこれを読み取りますが、新しい設定では voice.enabled を設定してください。

voice オブジェクトより前から存在する単一の Boolean 形式で、音声入力をオンにします。両方が設定されている場合は voice.enabled が適用されます。

• スコープ: Any file
• 型: Boolean
  • true: voice.enabled が設定されていない限り、claude.ai アカウントでログインしていて組織のポリシーで音声が許可されている場合に、音声入力がオンになります
  • false: voice.enabled が設定されていない限り、音声入力はオフです
• デフォルト: 未設定

{
  "voiceEnabled": true
}

wheelScrollAccelerationEnabled

フルスクリーンレンダリングで、高速スクロール時にマウスホイールのスクロール速度を加速します。ホイールの 1 ノッチごとに一定の速度でスクロールさせるには、false に設定します。

• スコープ: Any file
• 型: Boolean
  • true: Claude Code は高速スクロール時にマウスホイールのスクロール速度を加速します
  • false: Claude Code はホイールの 1 ノッチごとに一定の速度でスクロールします
• デフォルト: true

{
  "wheelScrollAccelerationEnabled": false
}

Git とアトリビューション

Claude Code がコミットとプルリクエストに追加するアトリビューションを制御し、git との連携方法を設定します。

attribution

Claude Code が git コミットとプルリクエストに追加するアトリビューションをカスタマイズします。コミットはデフォルトで Co-Authored-By などの git トレーラー を取得します。プルリクエストの説明はプレーンテキストを取得します。以下のサブキーを使用して各部分を個別に設定します。

• スコープ: Any file
• タイプ: commit と pr 文字列および sessionUrl ブール値を含むオブジェクト、または全てのアトリビューションを非表示にする false。false 値には Claude Code v2.1.281 以降が必要です。それより前のバージョンはこれを拒否し、それを含むユーザー、プロジェクト、またはローカル設定ファイル全体をスキップします
• デフォルト: 未設定。Claude Code は各サブキーの下に表示される標準アトリビューションを使用します

全てのアトリビューションを非表示にするには、attribution を false に設定します。それより前のバージョンも読み込む設定ファイルでは、commit と pr を空の文字列に設定し、sessionUrl を false に設定してください。

この例はコミットアトリビューションを置き換え、プルリクエストアトリビューションを削除し、セッションリンクを削除します。

{
  "attribution": {
    "commit": "Generated with AI\n\nCo-Authored-By: AI <ai@example.com>",
    "pr": "",
    "sessionUrl": false
  }
}

commit または pr を設定すると、Claude Code は非推奨の includeCoAuthoredBy 設定を無視し、設定しなかった方のデフォルトテキストを使用します。

Claude Code は、CLAUDE.md または memory ルールなど、アトリビューションに関するカスタマー独自の命令が、managed settings で設定されている場合を除き、これらのコミットおよび PR 行より優先されることを Claude に伝えます。

includeCoAuthoredBy

[!WARNING]

v2.0.62 以降非推奨。attribution に置き換えられました。Claude Code はまだこれを読み込みますが、新しい設定は attribution を設定する必要があります。

このキーを置き換える attribution を代わりに使用してください。これにより、コミットトレーラー、プルリクエストテキスト、セッションリンクを個別に変更または非表示にできます。Claude Code は attribution より前の設定ファイルからの includeCoAuthoredBy: false を引き続き尊重しますが、attribution.commit または attribution.pr を設定すると無視します。

• スコープ: Any file
• タイプ: ブール値
  • true: 未設定と同じ。Claude Code はコミットトレーラーとプルリクエストアトリビューションテキストを追加します
  • false: Claude Code はコミットトレーラーとプルリクエストアトリビューションテキストの両方を省略します。ただし、attribution が commit または pr を設定する場合は、attribution ルールが適用されます
• デフォルト: true

{
  "includeCoAuthoredBy": false
}

全てのアトリビューションを非表示にするには、attribution を参照してください。

includeGitInstructions

Claude Code は git 関連の 2 つの部分をコンテキストとして Claude に提供します。Bash ツールの説明にあるコミットとプルリクエストの書き方に関する組み込み命令と、リポジトリの git ステータススナップショット（現在のブランチ、メインブランチ、git status 出力、最近のコミット）です。Claude Code はコンバーセーション開始時にスナップショットを読み込みます。

このキーを false に設定して両方を除外します。例えば、独自の git ワークフロースキルを使用する場合などです。

• スコープ: Any file
• タイプ: ブール値
  • true: Claude Code は組み込みのコミットおよびプルリクエストワークフロー命令と git ステータススナップショットを含めます。クラウドセッションはスナップショットを含めません
  • false: Claude Code は両方を除外します
• デフォルト: true
• セッションごとのオーバーライド: CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS はこのキーより優先されます（1 セッション）