モデル設定

Claude Code のモデル設定について学習します。opusplan などのモデルエイリアスを含みます

利用可能なモデル

Claude Code の model 設定では、以下のいずれかを設定できます。

• モデルエイリアス
• モデル名
  • Anthropic API：完全な モデル名
  • Bedrock：推論プロファイル ARN
  • Foundry：デプロイメント名
  • Vertex：バージョン名

モデルエイリアス

モデルエイリアスは、正確なバージョン番号を覚えることなくモデル設定を選択するための便利な方法を提供します。

Anthropic API および Claude Platform on AWS では、opus は Opus 4.7 に解決され、sonnet は Sonnet 4.6 に解決されます。Bedrock、Vertex、Foundry では、opus は Opus 4.6 に解決され、sonnet は Sonnet 4.5 に解決されます。より新しいモデルは、完全なモデル名を明示的に選択するか、ANTHROPIC_DEFAULT_OPUS_MODEL または ANTHROPIC_DEFAULT_SONNET_MODEL を設定することで、これらのプロバイダーで利用可能です。

エイリアスはプロバイダーの推奨バージョンを指し、時間とともに更新されます。特定のバージョンに固定するには、完全なモデル名（例：claude-opus-4-7）を使用するか、ANTHROPIC_DEFAULT_OPUS_MODEL などの対応する環境変数を設定します。

モデルの設定

モデルは、優先度順に複数の方法で設定できます。

1. セッション中 - /model <alias|name> を使用してセッション中にモデルを切り替えるか、引数なしで /model を実行してピッカーを開きます。ピッカーは、会話に以前の出力がある場合に確認を求めます。次の応答がキャッシュされたコンテキストなしで完全な履歴を再読み込みするためです
2. 起動時 - claude --model <alias|name> で起動
3. 環境変数 - ANTHROPIC_MODEL=<alias|name> を設定
4. 設定 - 設定ファイルで model フィールドを使用して永続的に設定

/model の選択はユーザー設定に保存され、再起動後も保持されます。v2.1.117 以降では、プロジェクトの .claude/settings.json が異なるモデルを指定している場合、Claude Code はあなたの選択を .claude/settings.local.json にも書き込むため、再起動後もそのプロジェクトで継続して適用されます。管理設定が優先され、次の起動時に再度適用されます。

起動時のアクティブなモデルがあなた自身の選択ではなく、プロジェクトまたは管理設定から来ている場合、起動ヘッダーはどの設定ファイルがそれを設定したかを表示します。/model を実行して、現在のセッションでオーバーライドします。

使用例：

# Opus で開始
claude --model opus

# セッション中に Sonnet に切り替え
/model sonnet

設定ファイルの例：

{
    "permissions": {
        ...
    },
    "model": "opus"
}

モデル選択の制限

エンタープライズ管理者は、管理設定またはポリシー設定 で availableModels を使用して、ユーザーが選択できるモデルを制限できます。

availableModels が設定されている場合、ユーザーは /model、--model フラグ、または ANTHROPIC_MODEL 環境変数を使用してリスト内にないモデルに切り替えることはできません。

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

デフォルトモデルの動作

モデルピッカーの Default オプションは availableModels の影響を受けません。常に利用可能であり、ユーザーのサブスクリプション層に基づいた システムのランタイムデフォルトを表します。

availableModels: [] の場合でも、ユーザーはそのティアの Default モデルで Claude Code を使用できます。

ユーザーが実行するモデルの制御

model 設定は初期選択であり、強制ではありません。セッション開始時にアクティブなモデルを設定しますが、ユーザーは /model を開いて Default を選択することができ、これはそのティアのシステムデフォルトに解決されます。model が何に設定されているかに関係なく。

モデル体験を完全に制御するには、3 つの設定を組み合わせます。

• availableModels：ユーザーが切り替えられるという名前のモデルを制限
• model：セッション開始時にアクティブなモデルを設定
• ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL：Default オプションと sonnet、opus、haiku エイリアスが解決するものを制御

この例では、ユーザーを Sonnet 4.5 で開始し、ピッカーを Sonnet と Haiku に制限し、Default を最新リリースではなく Sonnet 4.5 に解決するようにピン留めします。

{
  "model": "claude-sonnet-4-5",
  "availableModels": ["claude-sonnet-4-5", "haiku"],
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"
  }
}

env ブロックがない場合、ユーザーがピッカーで Default を選択すると、最新の Sonnet リリースが取得され、model と availableModels のバージョンピンがバイパスされます。

マージ動作

availableModels がユーザー設定とプロジェクト設定など複数のレベルで設定されている場合、配列はマージされ、重複排除されます。厳密なアローリストを適用するには、最優先度を持つ管理設定またはポリシー設定で availableModels を設定します。

Mantle モデル ID

Bedrock Mantle エンドポイント が有効な場合、availableModels の anthropic. で始まるエントリは、カスタムオプションとして /model ピッカーに追加され、Mantle エンドポイントにルーティングされます。これは サードパーティデプロイメント用のモデルのピン留め で説明されているエイリアスのみマッチングの例外です。設定はピッカーをリストされたエントリに制限するため、標準エイリアスと一緒に Mantle ID を含めます。

特別なモデルの動作

default モデル設定

default の動作はアカウントタイプによって異なります。

• Max と Team Premium：Opus 4.7 がデフォルト
• Pro、Team Standard、Enterprise、Anthropic API：Sonnet 4.6 がデフォルト
• Bedrock、Vertex、Foundry：Sonnet 4.5 がデフォルト

Claude Code は、Opus の使用量閾値に達した場合、自動的に Sonnet にフォールバックする可能性があります。

opusplan モデル設定

opusplan モデルエイリアスは、自動化されたハイブリッドアプローチを提供します。

• Plan Mode 中 - 複雑な推論とアーキテクチャの決定用に opus を使用
• 実行モード中 - コード生成と実装用に自動的に sonnet に切り替わり

これにより、両方の長所が得られます。計画用の Opus の優れた推論と、実行用の Sonnet の効率性です。

Plan Mode の Opus フェーズは標準的な 200K コンテキストウィンドウで実行されます。拡張コンテキスト で説明されている自動 1M アップグレードは opus モデル設定に適用され、opusplan には拡張されません。

努力レベルの調整

努力レベル は適応的推論を制御し、タスクの複雑さに基づいて各ステップで思考するかどうか、どの程度思考するかをモデルが決定できるようにします。低い努力はシンプルなタスクではより高速で安価ですが、高い努力は複雑な問題に対してより深い推論を提供します。

努力は Opus 4.7、Opus 4.6、Sonnet 4.6 でサポートされています。利用可能なレベルはモデルによって異なります。

アクティブなモデルがサポートしないレベルを設定した場合、Claude Code は設定したレベル以下の最高サポートレベルにフォールバックします。例えば、xhigh は Opus 4.6 では high として実行されます。

v2.1.117 以降、Opus 4.7 のデフォルト努力は xhigh で、Opus 4.6 と Sonnet 4.6 のデフォルト努力は high です。

Opus 4.7 を初めて実行する場合、Claude Code は、以前に Opus 4.6 または Sonnet 4.6 に対して別の努力レベルを設定していても、xhigh を適用します。切り替え後に /effort を再度実行して、別のレベルを選択します。

low、medium、high、xhigh はセッション全体で保持されます。max はトークン支出に制約がない最も深い推論を提供し、CLAUDE_CODE_EFFORT_LEVEL 環境変数を通じて設定された場合を除き、現在のセッションのみに適用されます。

努力レベルの選択

各レベルはトークン支出と機能をトレードオフします。デフォルトはほとんどのコーディングタスクに適しています。別のバランスが必要な場合は調整します。

努力スケールはモデルごとに調整されるため、同じレベル名はモデル全体で同じ基盤値を表しません。

1 回限りの深い推論に ultrathink を使用

セッション設定を変更せずに 1 回限りの深い推論を行うには、プロンプトの任意の場所に ultrathink を含めます。Claude Code はキーワードを認識し、インコンテキスト命令を追加します。API に送信される努力レベルは変更されません。「think」、「think hard」、「think more」などの他のフレーズは通常のプロンプトテキストとして渡され、キーワードとして認識されません。

努力レベルの設定

努力は以下のいずれかを通じて変更できます。

• /effort：引数なしで /effort を実行してインタラクティブスライダーを開くか、/effort の後にレベル名を続けて直接設定するか、/effort auto を実行してモデルのデフォルトにリセット
• /model 内：モデルを選択する際に左右矢印キーを使用して努力スライダーを調整
• --effort フラグ：Claude Code を起動する際にレベル名を渡して、単一セッションのレベルを設定
• 環境変数：CLAUDE_CODE_EFFORT_LEVEL をレベル名または auto に設定
• 設定：設定ファイルで effortLevel を low、medium、high、xhigh に設定します。max は セッションのみ であり、ここでは受け入れられません
• Skill と subagent frontmatter：skill または subagent markdown ファイルで effort を設定して、その skill または subagent が実行される際の努力レベルをオーバーライド

環境変数がすべての他の方法より優先され、次に設定されたレベル、次にモデルのデフォルトが優先されます。Frontmatter 努力は、その skill または subagent がアクティブな場合に適用され、セッションレベルをオーバーライドしますが、環境変数はオーバーライドしません。

努力スライダーは、サポートされているモデルが選択されている場合、/model に表示されます。現在の努力レベルはロゴとスピナーの横にも表示されます（例：「with low effort」）。/model を開かなくても、どの設定がアクティブかを確認できます。

適応的推論と固定思考予算

適応的推論は各ステップで思考をオプションにするため、Claude はルーチンプロンプトにより速く応答でき、より深い思考から利益を得るステップのために深い思考を予約できます。現在のレベルが生成するよりも Claude がより頻繁に、またはより少なく思考することを望む場合、プロンプトまたは CLAUDE.md で直接そう言うことができます。モデルはその努力設定内でそのガイダンスに応答します。

Opus 4.7 は常に適応的推論を使用します。固定思考予算モードと CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING はそれに適用されません。

Opus 4.6 と Sonnet 4.6 では、CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 を設定して、MAX_THINKING_TOKENS で制御される以前の固定思考予算に戻すことができます。環境変数 を参照してください。

拡張思考

拡張思考は、Claude が応答する前に発する推論です。適応的推論 をサポートするモデルでは、努力レベルは思考がどの程度発生するかの主要な制御です。以下の設定は思考をオンまたはオフにし、それがどのように表示されるかを制御します。

思考出力はデフォルトで折りたたまれています。Ctrl+O を押して詳細モードをトグルし、推論をグレーのイタリック体テキストとして表示します。Anthropic API 上のインタラクティブセッションはデフォルトで編集された思考ブロックを受け取るため、展開時に完全な要約を利用可能にしたい場合は 設定 で showThinkingSummaries: true を設定します。折りたたまれたまたは編集された場合でも、生成されたすべての思考トークンに対して課金されます。

拡張コンテキスト

Opus 4.7、Opus 4.6、Sonnet 4.6 は、大規模なコードベースを持つ長いセッション用に 100 万トークンのコンテキストウィンドウ をサポートしています。

利用可能性はモデルとプランによって異なります。Max、Team、Enterprise プランでは、Opus は追加設定なしで自動的に 1M コンテキストにアップグレードされます。これは Team Standard と Team Premium の両方のシートに適用されます。Sonnet with 1M context は自動アップグレードの一部ではなく、Max を含むすべてのサブスクリプションプランで 追加使用 が必要です。

1M コンテキストを完全に無効にするには、CLAUDE_CODE_DISABLE_1M_CONTEXT=1 を設定します。これにより、1M モデルバリアントがモデルピッカーから削除されます。環境変数 を参照してください。

1M コンテキストウィンドウは標準モデル価格を使用し、200K を超えるトークンに対するプレミアムはありません。拡張コンテキストがサブスクリプションに含まれているプランでは、使用量はサブスクリプションでカバーされたままです。拡張コンテキストに追加使用でアクセスするプランでは、トークンは追加使用に請求されます。

アカウントが 1M コンテキストをサポートしている場合、オプションは Claude Code の最新バージョンのモデルピッカー（/model）に表示されます。表示されない場合は、セッションを再起動してみてください。

モデルエイリアスまたは完全なモデル名で [1m] サフィックスを使用することもできます。

# opus[1m] または sonnet[1m] エイリアスを使用
/model opus[1m]
/model sonnet[1m]

# または完全なモデル名に [1m] を追加
/model claude-opus-4-7[1m]

現在のモデルの確認

現在使用しているモデルは、複数の方法で確認できます。

1. ステータスライン 内（設定されている場合）
2. /status 内。アカウント情報も表示されます。

カスタムモデルオプションの追加

ANTHROPIC_CUSTOM_MODEL_OPTION を使用して、組み込みエイリアスを置き換えることなく、単一のカスタムエントリを /model ピッカーに追加します。これは Claude Code がデフォルトでリストしないモデル ID のテストに役立ちます。LLM ゲートウェイデプロイメントの場合、Claude Code は CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 が設定されているときにゲートウェイの /v1/models エンドポイントからピッカーを自動的に入力するため、この変数が必要なのはディスカバリーが無効になっているか、必要なモデルを返さない場合のみです。LLM ゲートウェイモデル選択を参照してください。

この例では、3 つの変数をすべて設定して、ゲートウェイルーティングされた Opus デプロイメントを選択可能にします。

export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-4-7"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"

カスタムエントリは /model ピッカーの下部に表示されます。ANTHROPIC_CUSTOM_MODEL_OPTION_NAME と ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION はオプションです。省略された場合、モデル ID は名前として使用され、説明はデフォルトで Custom model (<model-id>) になります。

Claude Code は ANTHROPIC_CUSTOM_MODEL_OPTION で設定されたモデル ID の検証をスキップするため、API エンドポイントが受け入れる任意の文字列を使用できます。

環境変数

以下の環境変数を使用できます。これらは完全な モデル名（または API プロバイダーの同等のもの）である必要があり、エイリアスがマップするモデル名を制御します。

注：ANTHROPIC_SMALL_FAST_MODEL は ANTHROPIC_DEFAULT_HAIKU_MODEL の代わりに非推奨です。

サードパーティデプロイメント用のモデルのピン留め

Bedrock、Vertex AI、Foundry、または Claude Platform on AWS を通じて Claude Code をデプロイする場合、ユーザーへのロールアウト前にモデルバージョンをピン留めします。

ピン留めなしでは、Claude Code はモデルエイリアス（sonnet、opus、haiku）を使用し、最新バージョンに解決されます。Anthropic が新しいモデルをリリースすると、新しいバージョンがまだユーザーのアカウントで有効になっていない場合、Bedrock と Vertex AI ユーザーは通知を見て、そのセッションの以前のバージョンにフォールバックしますが、Foundry ユーザーはエラーを見ます。Foundry には同等のスタートアップチェックがないためです。

プロバイダーのバージョン固有のモデル ID を使用して、以下の環境変数を使用します。

ANTHROPIC_DEFAULT_SONNET_MODEL と ANTHROPIC_DEFAULT_HAIKU_MODEL に同じパターンを適用します。すべてのプロバイダー全体の現在および従来のモデル ID については、モデル概要 を参照してください。ユーザーを新しいモデルバージョンにアップグレードするには、これらの環境変数を更新して再デプロイします。

ピン留めされたモデルの 拡張コンテキスト を有効にするには、ANTHROPIC_DEFAULT_OPUS_MODEL または ANTHROPIC_DEFAULT_SONNET_MODEL のモデル ID に [1m] を追加します。

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-7[1m]'

[1m] サフィックスは、opusplan を含むそのエイリアスのすべての使用に 1M コンテキストウィンドウを適用します。Claude Code は、モデル ID をプロバイダーに送信する前にサフィックスを削除します。Opus 4.7 や Sonnet 4.6 など、基盤となるモデルが 1M コンテキストをサポートする場合にのみ [1m] を追加します。

ピン留めされたモデルの表示と機能のカスタマイズ

サードパーティプロバイダーでモデルをピン留めする場合、プロバイダー固有の ID は /model ピッカーにそのまま表示され、Claude Code はモデルがサポートする機能を認識しない可能性があります。ピン留めされた各モデルの表示名と機能を宣言するコンパニオン環境変数でオーバーライドできます。

これらの変数は、Bedrock、Vertex AI、Foundry などのサードパーティプロバイダーでのみ有効です。ANTHROPIC_BASE_URL が LLM ゲートウェイ を指す場合、_NAME と _DESCRIPTION 変数も有効です。api.anthropic.com に直接接続する場合は効果がありません。

同じ _NAME、_DESCRIPTION、_SUPPORTED_CAPABILITIES サフィックスは ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_CUSTOM_MODEL_OPTION で利用可能です。

Claude Code は、モデル ID を既知のパターンと照合することで、努力レベル や 拡張思考 などの機能を有効にします。Bedrock ARN やカスタムデプロイメント名などのプロバイダー固有の ID は、これらのパターンと一致しないことが多く、サポートされている機能が無効のままになります。_SUPPORTED_CAPABILITIES を設定して、Claude Code にモデルが実際にサポートする機能を伝えます。

_SUPPORTED_CAPABILITIES が設定されている場合、リストされた機能は有効になり、リストされていない機能はマッチングされたピン留めされたモデルに対して無効になります。変数が設定されていない場合、Claude Code はモデル ID に基づいた組み込み検出にフォールバックします。

この例では、Bedrock カスタムモデル ARN に Opus をピン留めし、フレンドリーな名前を設定し、その機能を宣言します。

export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'
export ANTHROPIC_DEFAULT_OPUS_MODEL_NAME='Opus via Bedrock'
export ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION='Opus 4.7 routed through a Bedrock custom endpoint'
export ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES='effort,xhigh_effort,max_effort,thinking,adaptive_thinking,interleaved_thinking'

バージョンごとのモデル ID のオーバーライド

上記のファミリーレベルの環境変数は、ファミリーエイリアスごとに 1 つのモデル ID を設定します。同じファミリー内の複数のバージョンを異なるプロバイダー ID にマップする必要がある場合は、代わりに modelOverrides 設定を使用します。

modelOverrides は個別の Anthropic モデル ID をプロバイダー固有の文字列にマップし、Claude Code がプロバイダーの API に送信します。ユーザーが /model ピッカーでマップされたモデルを選択すると、Claude Code は組み込みのデフォルトの代わりに設定された値を使用します。

これにより、エンタープライズ管理者は、ガバナンス、コスト配分、または地域的なルーティングのために、各モデルバージョンを特定の Bedrock 推論プロファイル ARN、Vertex AI バージョン名、または Foundry デプロイメント名にルーティングできます。

設定ファイル で modelOverrides を設定します。

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-sonnet-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  }
}

キーは モデル概要 にリストされている Anthropic モデル ID である必要があります。日付付きモデル ID の場合、そこに表示されるとおりに日付サフィックスを含めます。不明なキーは無視されます。

オーバーライドは、/model ピッカーの各エントリをサポートする組み込みモデル ID を置き換えます。Bedrock では、オーバーライドは Claude Code が起動時に自動的に検出する推論プロファイルより優先されます。ANTHROPIC_MODEL、--model、または ANTHROPIC_DEFAULT_*_MODEL 環境変数を通じて直接提供される値は、プロバイダーにそのまま渡され、modelOverrides によって変換されません。

modelOverrides は availableModels と一緒に機能します。アローリストは Anthropic モデル ID に対して評価され、オーバーライド値に対してではないため、availableModels の "opus" などのエントリは、Opus バージョンが ARN にマップされている場合でも一致し続けます。

プロンプトキャッシング設定

Claude Code は プロンプトキャッシング を自動的に使用してパフォーマンスを最適化し、コストを削減します。プロンプトキャッシングをグローバルに、または特定のモデルティアに対して無効にできます。

これらの環境変数は、プロンプトキャッシング動作に対する細かい制御を提供します。グローバル DISABLE_PROMPT_CACHING 設定はモデル固有の設定より優先され、必要に応じてすべてのキャッシングをすばやく無効にできます。モデル固有の設定は、特定のモデルをデバッグする場合や、異なるキャッシング実装を持つ可能性があるクラウドプロバイダーと連携する場合など、選択的な制御に役立ちます。