settings.json

modelOverrides

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

使い方・用途

  • 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.233(1件)

Improved
プリントモードの診断出力を改善し、Claude Code が認識していないモデル ID に対して要求が送信された際に stderr へ [claude-code:unrecognized_model] を書き出すようにしました。これは 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 が使われた場合は明示的に診断用のエラー行が標準エラー出力に出力され、必要に応じて modelOverrides を用いたマッピングを行うことでこのログを抑制できるようになります。

ユーザーへの恩恵

カスタムプロキシや最新の未登録モデルを利用した環境構築で接続がうまくいかない原因を、診断ログから即座に特定できるようになります。

関連ドキュメント

v2.1.223(1件)

Fixed
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

変更前

設定ファイル内の modelOverrides マップにおいて、公式の Anthropic モデルIDではない未定義または無効なキーを指定すると、それが誤ってセッション全体の標準モデルIDとして解釈され、推論エラーや接続失敗を引き起こしていました。

変更後

マップ内に記述された不明なキーはドキュメントの記載通り無視され、誤設定による予期せぬセッションのクラッシュを防止します。

ユーザーへの恩恵

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

関連ドキュメント

v2.1.73(1件)

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