modelOverrides

settings.json型object記述場所どの設定ファイルでも可

Anthropic のモデル ID を、Bedrock や Vertex AI などのプロバイダー固有のモデル ID(ARN 等)にマッピングします。

記述例

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

使い方・用途

  • AWS Bedrock の推論プロファイル(Inference Profiles)や、Google Vertex AI の特定バージョンを使用しているエンタープライズ環境で、Claude Code からそれらを呼び出せるようにします。
  • 組織で承認された特定のエンドポイントやデプロイメント名を、Claude Code の標準モデル名(opus, sonnet 等)に紐付けて透過的に利用したい場合に必須の設定です。
英語原文

Map Anthropic model IDs to provider-specific model IDs such as Bedrock inference profile ARNs, Vertex AI version names, or Foundry deployment names. Each model picker entry uses its mapped value when calling the provider API. Unknown keys are ignored. See https://code.claude.com/docs/en/model-config#override-model-ids-per-version

関連ドキュメント

関連する変更履歴

v2.1.305(1件)

モデル名が modelOverrides の値と大文字小文字や [1m] タグの違いだけで異なる場合に、/effort と /autocompact の設定が適用されない問題を修正した。
英語原文を表示
Fixed /effort and /autocompact settings not applying when the model name differed from a modelOverrides value by letter case or a [1m] tag

関連ドキュメント

v2.1.284(1件)

ANTHROPIC_DEFAULT_OPUS_MODEL や modelOverrides で Opus モデルを固定しているセッションにおける安全関連のモデル切り替えを変更した。Anthropic API では、固定されたモデルではなく API 側がフラグの種類ごとに切り替え先のモデルを選択するようになった。
英語原文を表示
Changed safety-related model switches in sessions that pin an Opus model with ANTHROPIC_DEFAULT_OPUS_MODEL or modelOverrides: on the Anthropic API, the API now picks the model to switch to for each kind of flag, not the pinned model

変更後

ANTHROPIC_DEFAULT_OPUS_MODEL や modelOverrides で Opus モデルを固定したセッションでも、安全フラグが付いたリクエストはフラグの種類ごとに適切な代替モデルへ自動的に切り替わるようになり、固定モデルへ一律で切り替わることで意図しない拒否に至る問題を回避できる。

関連ドキュメント

v2.1.233(1件)

print モードの診断機能を改善した。Claude Code が認識しないモデル ID でリクエストを送る際に、[claude-code:unrecognized_model] 行が stderr に出力される。modelOverrides でマッピングすると警告を消せる
英語原文を表示
Improved print mode diagnostics: a [claude-code:unrecognized_model] line is written to stderr when a request goes out for a model ID Claude Code doesn't recognize; map it with modelOverrides to silence

変更後

認識できないモデル ID へのリクエスト時に stderr へ診断行が出力されるため、ゲートウェイのエイリアスなど独自のモデル ID を使う場合でも、設定の誤りに気づきやすくなる。modelOverrides で ID をマッピングすれば診断行を消せるので、stderr を監視するスクリプトやハーネスでもログを汚さずに運用できる。

関連ドキュメント

v2.1.223(1件)

Anthropic のモデルIDではないキーが modelOverrides に指定された場合にセッションの正規モデルIDとして扱われてしまう不具合を修正し、仕様通り不明なキーが無視されるようにしました。
英語原文を表示
Fixed modelOverrides keys that aren't Anthropic model IDs being treated as the session's canonical model ID; unknown keys are now ignored as documented

変更後

設定ファイルの記述に不要なキーが含まれていても、エラーによる実行停止を避けて動作を維持できます。

関連ドキュメント

v2.1.73(1件)

モデル選択肢をBedrockのARNなどカスタムプロバイダーのモデルIDにマッピングする modelOverrides 設定を追加しました。
英語原文を表示
Added modelOverrides setting to map model picker entries to custom provider model IDs (e.g. Bedrock inference profile ARNs)