Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

モデルピッカーのエントリをカスタムプロバイダーモデルID（例：BedrockのInference Profile ARN）にマッピングする modelOverrides 設定を追加しました。

原文（英語） ​

Added modelOverrides setting to map model picker entries to custom provider model IDs (e.g. Bedrock inference profile ARNs)

概要 ​

modelOverrides 設定は、Claude Codeのモデルピッカーに表示される標準モデル名（Opus、Sonnetなど）を、AWS BedrockやVertex AIなどのカスタムプロバイダー固有のモデルIDやARNに対応付けるための設定です。これにより、AWS Bedrockの推論プロファイル（Inference Profile）など、特定のリソース識別子を使用するプロバイダー環境でも、モデルピッカーから直接目的のモデルを選択できるようになります。企業環境やマルチリージョン構成での利用に特に有効です。

基本的な使い方 ​

~/.claude/settings.json（グローバル設定）またはプロジェクトの .claude/settings.json に modelOverrides を追加します。

json
{
  "modelOverrides": {
    "claude-opus-4-6": "arn:aws:bedrock:us-east-1:123456789012:inference-profile/us.anthropic.claude-opus-4-6-20251101-v1:0",
    "claude-sonnet-4-6": "arn:aws:bedrock:us-west-2:123456789012:inference-profile/us.anthropic.claude-sonnet-4-6-20251101-v1:0"
  }
}

実践例 ​

AWS Bedrockで推論プロファイルARNを指定する ​

Bedrockでは特定のリージョンまたはクロスリージョンの推論プロファイルを使う場合、ARNを使って明示的に指定する必要があります。

json
{
  "modelOverrides": {
    "claude-opus-4-6": "arn:aws:bedrock:us-east-1:ACCOUNT_ID:inference-profile/us.anthropic.claude-opus-4-6-20251101-v1:0",
    "claude-haiku-4-5": "arn:aws:bedrock:ap-northeast-1:ACCOUNT_ID:inference-profile/apac.anthropic.claude-haiku-4-5-20251001-v1:0"
  }
}

Vertex AIでカスタムエンドポイントを指定する ​

Vertex AIでは特定のリージョンやカスタムモデルIDを利用する際に活用できます。

json
{
  "modelOverrides": {
    "claude-sonnet-4-6": "claude-sonnet-4-6@20251101",
    "claude-opus-4-6": "claude-opus-4-6@20251101"
  }
}

Microsoft Foundryでモデルエンドポイントをマッピングする ​

json
{
  "modelOverrides": {
    "claude-sonnet-4-6": "anthropic.claude-sonnet-4-6-20251101"
  }
}

注意点 ​

  • modelOverrides のキーにはClaude Codeのモデルピッカーで表示される標準モデル名を使用してください
  • 値にはプロバイダー固有の形式（ARN、バージョン付きモデルID等）を指定してください
  • 設定が有効になるためには、対応するプロバイダー（Bedrock, Vertex, Foundry）の認証情報が正しく設定されている必要があります
  • 設定ファイルはプロジェクトレベル（.claude/settings.json）またはグローバルレベル（~/.claude/settings.json）のどちらにも適用可能です
  • ARNや特定のIDが間違っていると接続エラーが発生するため、事前にプロバイダーのコンソールで正確なIDを確認してください

関連情報 ​