利用可能なモデル
Claude Code の model 設定では、以下のいずれかを設定できます。
- モデルエイリアス
- モデル名
- Anthropic API:完全な モデル名
- Bedrock:推論プロファイル ARN
- Foundry:デプロイメント名
- Vertex:バージョン名
ANTHROPIC_BASE_URL は、リクエストの送信先を変更しますが、どのモデルが応答するかは変更しません。Claude を LLM ゲートウェイ経由でルーティングするには、LLM ゲートウェイ設定を参照してください。
モデルエイリアス
モデルエイリアスは、正確なバージョン番号を覚えることなくモデル設定を選択するための便利な方法を提供します。
| モデルエイリアス | 動作 |
|---|
default | 特別な値で、モデルオーバーライドをクリアし、アカウントタイプに応じた推奨モデルに戻します。それ自体はモデルエイリアスではありません |
best | 組織がアクセスできる場合は Fable 5 を使用し、そうでない場合は最新の Opus モデルを使用 |
fable | 最も難しく、実行時間が長いタスク用に Claude Fable 5 を使用 |
sonnet | 日常的なコーディングタスク用に最新の Sonnet モデルを使用 |
opus | 複雑な推論タスク用に最新の Opus モデルを使用 |
haiku | シンプルなタスク用に高速で効率的な Haiku モデルを使用 |
sonnet[1m] | 長いセッション用に 100 万トークンのコンテキストウィンドウ を備えた Sonnet を使用 |
opus[1m] | 長いセッション用に 100 万トークンのコンテキストウィンドウ を備えた Opus を使用 |
opusplan | Plan Mode 中は opus を使用し、実行中は sonnet に自動的に切り替わる特別なモード |
Anthropic API では、opus は Opus 4.8 に解決され、sonnet は Sonnet 4.6 に解決されます。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-8)を使用するか、ANTHROPIC_DEFAULT_OPUS_MODEL などの対応する環境変数を設定します。
Opus 4.8 には Claude Code v2.1.154 以降が必要です。claude update を実行してアップグレードしてください。
Fable 5 を使用する
Claude Fable 5 は Claude Code で最も高性能なモデルで、1 回のセッションより大きなタスクに適しています。長い自律的なセッションを維持し、行動する前に調査し、より小さなモデルよりも頻繁に作業を検証します。
Fable 5 はデフォルトモデルではありません。/model fable で選択してください。安全性分類器がフラグを立てるリクエスト(最も多くの場合、サイバーセキュリティと生物学の領域)は、自動モデルフォールバックをトリガーします。
Fable 5 を最大限に活用するには:
- 結果を説明し、ステップではなく:望む結果を渡し、パスを計画させます。その結果が成立するまで作業を続けさせるには、目標を設定してください。
- 曖昧な問題を渡す:根本原因の調査、障害のデバッグ、アーキテクチャの決定は、追加の調査と検証が役に立つ場所です。
- 検証リマインダーをスキップ:独自の作業を検証するため、テストまたはチェックのリマインダーは通常不要です。
- より大きなタスクをサイズアップ:通常は複数の部分に分割する作業を与えます。長いセッションを保持し、スレッドを失いません。
Fable 5 には Claude Code v2.1.170 以降が必要です。古いバージョンではモデルピッカーに Fable 5 が表示されず、選択できません。claude update を実行してアップグレードしてください。Fable 5 は ゼロデータ保持 では利用できません。ここで /model ピッカーはそれを省略するか、無効として表示します。
モデルの設定
モデルは、優先度順に複数の方法で設定できます。
- セッション中 -
/model <alias|name> を使用してセッション中にモデルを切り替えるか、引数なしで /model を実行してピッカーを開きます。ピッカーは、会話に以前の出力がある場合に確認を求めます。次の応答がキャッシュされたコンテキストなしで完全な履歴を再読み込みするためです
- 起動時 -
claude --model <alias|name> で起動
- 環境変数 -
ANTHROPIC_MODEL=<alias|name> を設定
- 設定 - 設定ファイルで
model フィールドを使用して永続的に設定
v2.1.153 以降では、/model はあなたの選択をデフォルトとして新しいセッションに保存し、ユーザー設定の model フィールドに書き込みます。ピッカーでは以下のようになります。
Enter:モデルを切り替えてデフォルトとして保存
s:このセッションのみモデルを切り替え
/model <name> を直接入力すると、Enter のように動作します。プロジェクトおよび管理設定は引き続き優先され、次の起動時に再度適用されます。
v2.1.144 から v2.1.152 では、/model は現在のセッションにのみ適用され、ピッカーで d を押すとデフォルトが保存されました。
--model フラグと ANTHROPIC_MODEL 環境変数は、それらで起動したセッションにのみ適用されます。異なるターミナルで異なるモデルを同時に実行するには、/model で切り替えるのではなく、各ターミナルを独自の --model フラグで起動します。
claude --resume、--continue、または /resume ピッカーで開始された再開セッションは、現在の model 設定に関係なく、トランスクリプトが保存されたときに使用していたモデルを保持します。そのモデルが廃止されている場合、セッションは通常の優先度順序にフォールスルーします。これにより、別のセッションの /model 選択が再開時のモデルを変更するのを防ぎます。
起動時のアクティブなモデルがあなた自身の選択ではなく、プロジェクトまたは管理設定から来ている場合、起動ヘッダーはどの設定ファイルがそれを設定したかを表示します。/model を実行してオーバーライドします。プロジェクトまたは管理設定は次の起動時に再度適用されます。
要求されたモデルにスケジュール済みの廃止日がある場合、または自動的に新しいバージョンに再マップされる場合、Claude Code は要求されたモデルに名前を付ける警告を表示します。インタラクティブセッションはそれをスタートアップ通知として表示します。v2.1.182 以降では、デフォルトのテキスト出力形式を使用して 非インタラクティブモード で stderr に同じ警告が書き込まれます。チェックは サブエージェントフロントマター に設定された model もカバーします。stderr 警告は --output-format json および stream-json に対して抑制されます。代わりに 結果メッセージ の modelUsage フィールドから実際のモデルを読み取ります。
使用例:
# Opus で開始
claude --model opus
# セッション中に Sonnet に切り替え
/model sonnet
設定ファイルの例:
{
"permissions": {
...
},
"model": "opus"
}
モデル選択の制限
エンタープライズ管理者は、管理設定またはポリシー設定 で availableModels を使用して、ユーザーが選択できるモデルを制限できます。
availableModels が設定されている場合、アローリストはユーザーがモデルを指定できるすべての場所に適用されます。
- メインセッションモデル:
/model、--model フラグ、および ANTHROPIC_MODEL 環境変数
- エイリアス解決:
ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL、および ANTHROPIC_DEFAULT_FABLE_MODEL 環境変数は、許可されたエイリアスをリスト外のモデルにリダイレクトすることはできません
- 高速モード:
/fast は、リスト外の Opus モデルに暗黙的に切り替わる場合、「is not in your organization’s allowed models」というメッセージで切り替えを拒否します
- サブエージェントモデル:サブエージェント frontmatter の
model フィールド、Agent ツールの model パラメータ、/agents のモデルピッカー、および CLAUDE_CODE_SUBAGENT_MODEL
- アドバイザーモデル:設定された
advisorModel 設定
- フォールバックチェーン:フォールバックモデルチェーン のリスト外の要素は削除されます
/model でブロックされたモデルに切り替えるとエラーで拒否されますが、ブロックされた --model フラグまたは ANTHROPIC_MODEL 値は起動時に警告とともに置き換えられ、要求されたモデルと置き換えられたモデルの両方を名前で示し、セッションはデフォルトモデルで開始されます。ブロックされたサブエージェントまたはアドバイザーのオーバーライドは、リクエストを失敗させるのではなく、継承またはデフォルトモデルにフォールバックします。
{
"availableModels": ["sonnet", "haiku"]
}
デフォルトモデルの動作
デフォルトでは、モデルピッカーの Default オプションは availableModels の影響を受けません。常に利用可能であり、ユーザーのサブスクリプション層に基づいた システムのランタイムデフォルトを表します。
アローリストを Default オプションに拡張するには、空でない availableModels リストと一緒に、管理設定またはポリシー設定で enforceAvailableModels を true に設定します。ティアのデフォルトがアローリストにない場合、Default はティアのデフォルトではなく、最初に許可されたエントリに解決されます。これには Claude Code v2.1.175 以降が必要です。
空の availableModels 配列は強制を実行しません。availableModels: [] の場合でも、ユーザーは enforceAvailableModels に関係なく、そのティアの Default モデルで Claude Code を使用できます。
ユーザーが実行するモデルの制御
model 設定は初期選択であり、強制ではありません。セッション開始時にアクティブなモデルを設定しますが、ユーザーは /model を開いて Default を選択することができ、これは model が何に設定されているかに関係なく、そのティアのシステムデフォルトに解決されます。
モデル体験を完全に制御するには、これらの設定を組み合わせます。
availableModels:ユーザーが切り替えられる名前付きモデルを制限
enforceAvailableModels:availableModels アローリストを Default オプションに拡張し、Default がリスト外のモデルに解決されないようにします
model:セッション開始時の初期モデル選択を設定
ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL:Default オプションと sonnet、opus、haiku、fable エイリアスが解決するものを制御
この例では、ユーザーを Sonnet 4.5 で開始し、ピッカーを Sonnet と Haiku に制限し、Default がティアのデフォルトではなくアローリスト上のモデルに解決されるようにします。
{
"model": "claude-sonnet-4-5",
"availableModels": ["claude-sonnet-4-5", "haiku"],
"enforceAvailableModels": true,
"env": {
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"
}
}
enforceAvailableModels または env ブロックがない場合、ユーザーがピッカーで Default を選択すると、そのティアの最新リリースが取得され、model と availableModels のバージョンピンがバイパスされます。2 つの設定は異なるスコープをカバーします。enforceAvailableModels は Default がアローリストに従うようにし、env ブロックは sonnet などの許可されたエイリアスが解決する特定のバージョンをピン留めします。モデルファミリーの制限で十分な場合は enforceAvailableModels のみを使用し、特定のバージョンをピン留めする必要がある場合は env ブロックを追加します。
マージ動作
availableModels がユーザー、プロジェクト、ローカル設定のみで設定されている場合、配列はこれらのレベル全体でマージされ、重複排除されます。
availableModels が管理設定またはポリシー設定で設定されている場合、管理設定またはポリシー設定の値がマージされた結果全体を置き換えます。ユーザー設定またはプロジェクト設定で追加されたエントリはそれを拡張することはできません。管理設定とポリシー設定は enforceAvailableModels の下位優先度の値を同じ方法で置き換えます。Claude Code v2.1.175 以降では、これが厳密なアローリストを適用する唯一の方法です。以前のバージョンでは、管理リストを下位優先度のエントリとマージします。
Mantle モデル ID
Bedrock Mantle エンドポイント が有効な場合、availableModels の anthropic. で始まるエントリは、カスタムオプションとして /model ピッカーに追加され、Mantle エンドポイントにルーティングされます。設定はピッカーをリストされたエントリに制限するため、標準エイリアスと一緒に Mantle ID を含めます。
特別なモデルの動作
default モデル設定
default の動作はアカウントタイプによって異なります。
- Max、Team Premium、Enterprise 従量課金、Anthropic API:Opus 4.8 がデフォルト
- AWS 上の Claude Platform:Opus 4.7 がデフォルト
- Pro、Team Standard、Enterprise サブスクリプションシート:Sonnet 4.6 がデフォルト
- Bedrock、Vertex、Foundry:Sonnet 4.5 がデフォルト
Enterprise 従量課金とは、サブスクリプションシートではなく使用量で請求される Enterprise 組織を意味します。
Fable 5 はどのアカウントタイプでもデフォルトモデルではありません。セッションは /model fable、model 設定、または Fable 5 が利用可能な best エイリアスで選択した後にのみ Fable 5 を使用します。/model で選択すると、ユーザー設定で選択されたモデルとして保存されるため、モデルを変更するまで後続のセッションは Fable 5 で開始されます。
opusplan モデル設定
opusplan モデルエイリアスは、自動化されたハイブリッドアプローチを提供します。
- Plan Mode 中 - 複雑な推論とアーキテクチャの決定用に
opus を使用
- 実行モード中 - コード生成と実装用に自動的に
sonnet に切り替わり
これにより、両方の長所が得られます。計画用の Opus の優れた推論と、実行用の Sonnet の効率性です。
Plan Mode の Opus フェーズは opus モデル設定と同じコンテキストウィンドウを使用します。自動アップグレードで Opus が 1M コンテキストに自動アップグレードされるサブスクリプション層では、opusplan も Plan Mode でアップグレードを受け取ります。自動アップグレード層にない場合に両方のフェーズで 1M コンテキストを強制するには、モデルを opusplan[1m] に設定します。
availableModelsが Opus を除外する場合、opusplan は Plan Mode で切り替える代わりに Sonnet に留まります。Sonnet が除外される場合の暗黙的な Haiku から Sonnet への Plan Mode アップグレードにも同じことが適用されます。
Claude が Plan の境界ではなくタスク途中で 2 番目のモデルを参照するかどうかを決定するハイブリッドアプローチについては、advisor toolを参照してください。
フォールバックモデルチェーン
プライマリモデルが過負荷状態、利用不可、または別の再試行不可能なサーバーエラーを返す場合、Claude Code はリクエストを失敗させる代わりにフォールバックモデルに切り替えることができます。認証、請求、レート制限、リクエストサイズ、トランスポートエラーは切り替えをトリガーしません。これらは通常の再試行とエラー処理に従います。
1 つ以上のフォールバックモデルを設定し、Claude Code は順番に試行し、切り替え時に通知を表示します。切り替えは現在のターンのみ続くため、次のメッセージはプライマリモデルを最初に再度試行します。チェーンは重複排除後 3 つのモデルに制限され、余分なエントリは無視されます。
--fallback-model フラグを使用して 1 つのセッション用にチェーンを設定します。これはカンマ区切りリストを受け入れます。
claude --fallback-model sonnet,haiku
セッション全体でチェーンを保持するには、settingsで fallbackModel を配列として設定します。
{
"fallbackModel": ["claude-sonnet-4-6", "claude-haiku-4-5"]
}
--fallback-model フラグは fallbackModel 設定より優先されます。各要素はモデル名またはエイリアスを受け入れ、"default" はデフォルトモデルに展開されます。
要素がスキップされる 2 つのケース:
- 利用不可能なモデル:設定にピン留めされた廃止されたモデルなど、到達できないモデルはスキップされ、Claude Code は次の要素に続きます。
- 許可リストの外:
availableModelsで許可されていない要素は、チェーンが読み込まれるときにドロップされ、試行されません。
自動モデルフォールバック
このセクションは Fable 5 からのコンテンツベースのフォールバックをカバーしています。モデルが過負荷状態または利用不可の場合の可用性ベースのフォールバックについては、フォールバックモデルチェーンを参照してください。
Fable 5 はサイバーセキュリティと生物学コンテンツ用のセーフティ分類器で実行されます。分類器がリクエストにフラグを立てると、Claude Code はそのリクエストをデフォルト Opus モデルで再実行し、トランスクリプトに通知を表示します。Anthropic API とLLM gatewayデプロイメント上の Opus 4.8、またはClaude Platform on AWS上の Opus 4.7。
セッションはその Opus モデルで続行されます。Fable 5 に戻るには、/model fable を実行します。
フォールバックをトリガーしたものを確認
フォールバックはセッションの最初のリクエストで、何か異常を送信する前にトリガーできます。最初のリクエストは CLAUDE.md コンテンツと git ステータスなどのワークスペースコンテキストを含むためです。セキュリティまたは生物学資料を含むリポジトリは、そのコンテキストだけで分類器をトリガーできます。
カスタマイズがトリガーかどうかを確認するには、claude --safe-mode でセッションを開始します。これは CLAUDE.md、skills、MCP サーバー、hooks などのカスタマイズを無効にします。Git ステータスとディレクトリ名はカスタマイズではなく、引き続き含まれます。
切り替え前に確認
リクエストにフラグが立てられるたびに何が起こるかを決定するには、自動的に切り替える代わりに /config を実行し、「メッセージにフラグが立てられたときにモデルを切り替える」をオフにします。フラグが立てられたリクエストはセッションを一時停止し、2 つのオプションがあります。Opus モデルに切り替えるか、プロンプトを編集して Fable 5 で再試行します。
いくつかのケースは異なる動作をします。
- 両方のモデルが同じリクエストにフラグを立てた場合、プロンプトを編集して再試行するか、新しいセッションを開始できます。
- モバイルClaude Code on the webセッションでは、編集と再試行はサポートされていません。モデルを切り替えるか、デスクトップブラウザまたはデスクトップアプリからセッションを続行します。
- 非対話モードと、プロンプトを表示できない SDK 統合では、フラグが立てられたリクエストは拒否で終了します。
Bedrock、Vertex AI、Foundry でフォールバックを有効化
Amazon Bedrock、Google Vertex AI、Microsoft Foundryでは、モデル ID はプロバイダー固有であるため、自動フォールバックは Claude Code が関連する両方のモデルを識別できる場合にのみ動作します。
- Claude Code は現在のモデルを Fable 5 として認識する必要があります。モデル ID に
claude-fable-5 が含まれるか、ANTHROPIC_DEFAULT_FABLE_MODEL の値と一致するか、modelOverridesでマップされています。
- フォールバックターゲットは Opus モデルに解決される必要があります。
ANTHROPIC_DEFAULT_OPUS_MODEL が設定されている場合はその値、それ以外はプロバイダーのモデルリストの Opus 4.8 エントリ。
どちらかのモデルが識別できない場合、Claude Code は自動的に切り替わりません。フラグが立てられたリクエストは拒否メッセージで終了し、/modelでモデルを切り替えて再試行できます。これらのプロバイダーで自動フォールバックを有効にするには、ANTHROPIC_DEFAULT_FABLE_MODEL を Fable 5 モデル ID に、ANTHROPIC_DEFAULT_OPUS_MODEL を Opus 4.8 モデル ID に設定します。
セキュリティ研究と生物学ワークロード
攻撃的なセキュリティまたは生物学のワークロード(ペネトレーションテスト、Capture the Flag(CTF)演習、生物学隣接コードベースを含む)は頻繁にフォールバックをトリガーし、多くの場合最初のリクエストで。実質的な生物学作業の場合、ほぼすべてのリクエストが再ルーティングされることを期待してください。
これはこれらのドメイン用の予想されるルーティングであり、アカウントフラグではありません。組織がこの作業に Fable クラスの機能を必要とする場合、信頼されたアクセスプログラムについて Anthropic アカウントチームに問い合わせてください。
努力レベルの調整
努力レベルは適応的推論を制御し、タスクの複雑さに基づいて各ステップで思考するかどうか、どの程度思考するかをモデルが決定できるようにします。低い努力はシンプルなタスクではより高速で安価ですが、高い努力は複雑な問題に対してより深い推論を提供します。
利用可能な努力レベルはモデルによって異なります。ここに記載されていないモデルは努力をサポートしていません。
| モデル | レベル |
|---|
| Fable 5 | low、medium、high、xhigh、max |
| Opus 4.8 と Opus 4.7 | low、medium、high、xhigh、max |
| Opus 4.6 と Sonnet 4.6 | low、medium、high、max |
アクティブなモデルがサポートしないレベルを設定した場合、Claude Code は設定したレベル以下の最高サポートレベルにフォールバックします。例えば、xhigh は Opus 4.6 では high として実行されます。
デフォルト努力は Fable 5、Opus 4.8、Opus 4.6、Sonnet 4.6 では high で、Opus 4.7 では xhigh です。
Fable 5、Opus 4.8、または Opus 4.7 を初めて実行する場合、Claude Code は、別のモデルに対して以前に異なるレベルを設定していても、そのモデルのデフォルト努力を適用します。Fable 5 と Opus 4.8 では high、Opus 4.7 では xhigh です。切り替え後に /effort を再度実行して、別のレベルを選択します。
low、medium、high、xhigh はセッション全体で保持されます。max はトークン支出に制約がない最も深い推論を提供し、CLAUDE_CODE_EFFORT_LEVEL 環境変数を通じて設定された場合を除き、現在のセッションのみに適用されます。
/effort メニューは ultracode も提供します。Ultracode はモデル努力レベルではなく Claude Code 設定です。モデルに xhigh を送信し、さらに Claude が実質的なタスク用に動的ワークフローをオーケストレートします。現在のセッションのみに適用されます。/effort を通じて設定するか、--settings または Agent SDK 制御リクエストを通じて "ultracode": true を渡します。これは effortLevel 設定、--effort フラグ、CLAUDE_CODE_EFFORT_LEVEL の一部ではありません。
努力レベルの選択
各レベルはトークン支出と機能をトレードオフします。デフォルトはほとんどのコーディングタスクに適しています。別のバランスが必要な場合は調整します。
| レベル | 使用する場合 |
|---|
low | インテリジェンスに敏感でない短くスコープされたレイテンシに敏感なタスク用に予約 |
medium | インテリジェンスをトレードオフできるコスト敏感な作業のトークン使用量を削減 |
high | トークン使用量とインテリジェンスのバランス。Fable 5、Opus 4.8、Opus 4.6、Sonnet 4.6 でのデフォルト |
xhigh | より高いトークン支出での深い推論。Opus 4.7 でのデフォルト |
max | 難しいタスクのパフォーマンスを改善できますが、収益逓減を示す可能性があり、過度な思考の傾向があります。広く採用する前にテスト |
ultracode | 各実質的なタスク用に xhigh ごとのメッセージ推論で動的ワークフローを計画する Claude Code 設定。セッションのみ |
努力スケールはモデルごとに調整されるため、同じレベル名はモデル全体で同じ基盤値を表しません。
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 と ultracode はセッションのみであり、ここでは受け入れられません
- Skill と subagent frontmatter:skillまたはsubagentmarkdown ファイルで
effort を設定して、その skill または subagent が実行される際の努力レベルをオーバーライド
環境変数がすべての他の方法より優先され、次に設定されたレベル、次にモデルのデフォルトが優先されます。Frontmatter 努力は、その skill または subagent がアクティブな場合に適用され、セッションレベルをオーバーライドしますが、環境変数はオーバーライドしません。
努力スライダーは、サポートされているモデルが選択されている場合、/model に表示されます。現在の努力レベルはロゴとスピナーの横にも表示されます(例:「with low effort」)。/model を開かなくても、どの設定がアクティブかを確認できます。
適応的推論と固定思考予算
適応的推論は各ステップで思考をオプションにするため、Claude はルーチンプロンプトにより速く応答でき、より深い思考から利益を得るステップのために深い思考を予約できます。現在のレベルが生成するよりも Claude がより頻繁に、またはより少なく思考することを望む場合、プロンプトまたは CLAUDE.md で直接そう言うことができます。モデルはその努力設定内でそのガイダンスに応答します。
Opus 4.7 以降は常に適応的推論を使用します。Fable 5 も同様です。固定思考予算モードと CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING はそれに適用されません。
Opus 4.6 と Sonnet 4.6 では、CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 を設定して、MAX_THINKING_TOKENS で制御される以前の固定思考予算に戻すことができます。環境変数を参照してください。
拡張思考
拡張思考は、Claude が応答する前に発する推論です。適応的推論をサポートするモデルでは、努力レベルは思考がどの程度発生するかの主要な制御です。以下の設定は思考をオンまたはオフにし、それがどのように表示されるかを制御します。
| 制御 | 設定方法 |
|---|
| 現在のセッションのトグル | macOS では Option+T、Windows と Linux では Alt+T を押します |
| グローバルデフォルトを設定 | /config を実行して思考モードをトグルします。~/.claude/settings.json に alwaysThinkingEnabled として保存されます |
| 努力に関係なく無効化 | MAX_THINKING_TOKENS=0を設定します。これは Anthropic API 上の Fable 5 を除いて思考をオフにします。サードパーティプロバイダーではこれは thinking パラメータを省略し、適応的推論モデルは引き続き思考する可能性があります。他の値は固定思考予算でのみ適用されます |
思考は Fable 5 でオフにすることはできません。セッショントグル、alwaysThinkingEnabled、MAX_THINKING_TOKENS=0 はそこに効果がなく、Fable 5 は努力レベルに基づいて各ステップでどの程度思考するかを決定します。
思考出力はデフォルトで折りたたまれています。Ctrl+O を押して詳細モードをトグルし、推論をグレーのイタリック体テキストとして表示します。Anthropic API 上のインタラクティブセッションはデフォルトで編集された思考ブロックを受け取るため、展開時に完全な要約を利用可能にしたい場合は設定で showThinkingSummaries: true を設定します。折りたたまれたまたは編集された場合でも、生成されたすべての思考トークンに対して課金されます。
拡張コンテキスト
Fable 5、Opus 4.6 以降、Sonnet 4.6 は、大規模なコードベースを持つ長いセッション用に100 万トークンのコンテキストウィンドウをサポートしています。
利用可能性はモデルとプランによって異なります。Max、Team、Enterprise プランでは、Opus は追加設定なしで自動的に 1M コンテキストにアップグレードされます。これは Team Standard と Team Premium の両方のシートに適用されます。Anthropic API では、Fable 5、Opus 4.8、Opus 4.7 は常に 1M ウィンドウで実行されます。Sonnet with 1M context は自動アップグレードの一部ではなく、Max を含むすべてのサブスクリプションプランで使用クレジットが必要です。
| プラン | Opus with 1M context | Sonnet with 1M context |
|---|
| Max、Team、Enterprise | サブスクリプションに含まれる | 使用クレジットが必要 |
| Pro | 使用クレジットが必要 | 使用クレジットが必要 |
| API と従量課金 | フルアクセス | フルアクセス |
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-8[1m]
現在のモデルの確認
現在使用しているモデルは、複数の方法で確認できます。
- ステータスライン 内(設定されている場合)
/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_DEFAULT_FABLE_MODEL | fable に使用するモデル、および Claude Code が 自動モデルフォールバック でサードパーティプロバイダーが Fable 5 として認識するモデル ID |
ANTHROPIC_DEFAULT_OPUS_MODEL | opus に使用するモデル、または Plan Mode がアクティブな場合の opusplan に使用するモデル。 |
ANTHROPIC_DEFAULT_SONNET_MODEL | sonnet に使用するモデル、または Plan Mode がアクティブでない場合の opusplan に使用するモデル。 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | haiku に使用するモデル、または バックグラウンド機能 に使用するモデル |
CLAUDE_CODE_SUBAGENT_MODEL | すべての subagents と agent teams に使用するモデル。呼び出しごとの model パラメータと subagent 定義の model frontmatter をオーバーライドします。inherit に設定して、代わりに通常のモデル解決を使用します |
注:ANTHROPIC_SMALL_FAST_MODEL は ANTHROPIC_DEFAULT_HAIKU_MODEL の代わりに非推奨です。
サードパーティデプロイメント用のモデルのピン留め
Bedrock、Vertex AI、Foundry、または Claude Platform on AWS を通じて Claude Code をデプロイする場合、ユーザーへのロールアウト前にモデルバージョンをピン留めします。
ピン留めなしでは、Claude Code は fable、opus、sonnet、haiku などのモデルエイリアスを使用し、各プロバイダーの組み込みデフォルトモデル ID に解決されます。そのデフォルトは最新の Anthropic リリースより遅れる可能性があり、それが指すモデルはまだユーザーのアカウントで有効になっていない可能性があります。デフォルトが利用できない場合、Bedrock と Vertex AI ユーザーは通知を見て、そのセッションの以前のバージョンにフォールバックしますが、Foundry ユーザーはエラーを見ます。Foundry には同等のスタートアップチェックがないためです。
初期セットアップの一部として、モデル環境変数を特定のバージョン ID に設定します。ピン留めにより、ユーザーが新しいモデルに移行するタイミングを制御できます。
プロバイダーのバージョン固有のモデル ID を使用して、以下の環境変数を使用します。
| プロバイダー | 例 |
|---|
| Bedrock | export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8' |
| Vertex AI | export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8' |
| Foundry | export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8' |
ANTHROPIC_DEFAULT_FABLE_MODEL、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-8[1m]'
[1m] サフィックスは、opus と sonnet エイリアスのすべての使用に 1M コンテキストウィンドウを適用します。これには opusplan の plan-mode Opus フェーズが含まれます。
- Claude Code は、モデル ID をプロバイダーに送信する前にサフィックスを削除します。
- 基盤となるモデルが 1M コンテキストをサポート する場合にのみ
[1m] を追加します。
- サフィックスはモデルごとではなく、変数ごとに読み取られます。Bedrock、Vertex、Foundry では、1 つの変数で
[1m] なしのモデル ID は、別の変数が同じモデルをサフィックス付きで設定している場合でも、200K コンテキストを使用します。
settings.availableModels アローリストは、サードパーティプロバイダーを使用する場合でも適用されます。フィルタリングは opus、sonnet、haiku、fable などのモデルエイリアス、claude-opus-4-8 などのバージョンプレフィックス、または完全なモデル ID で一致します。任意の [1m] サフィックスはアローリストエントリと要求されたモデルの両方から削除されるため、claude-opus-4-8 のエントリは標準と 1M コンテキスト Opus の両方の行を許可します。us.anthropic. などのプロバイダー固有のプレフィックスは削除されません。ピッカーが表示する同じ形式を availableModels にリストするか、modelOverrides を通じてマップします。
ピン留めされたモデルの表示と機能のカスタマイズ
サードパーティプロバイダーでモデルをピン留めする場合、プロバイダー固有の ID は /model ピッカーにそのまま表示され、Claude Code はモデルがサポートする機能を認識しない可能性があります。ピン留めされた各モデルの表示名と機能を宣言するコンパニオン環境変数でオーバーライドできます。
これらの変数は、Bedrock、Vertex AI、Foundry などのサードパーティプロバイダーでのみ有効です。ANTHROPIC_BASE_URL が LLM ゲートウェイ を指す場合、_NAME と _DESCRIPTION 変数も有効です。api.anthropic.com に直接接続する場合は効果がありません。
| 環境変数 | 説明 |
|---|
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME | /model ピッカーでピン留めされた Opus モデルの表示名。設定されていない場合はモデル ID がデフォルト |
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION | /model ピッカーでピン留めされた Opus モデルの表示説明。設定されていない場合は Custom Opus model がデフォルト |
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES | ピン留めされた Opus モデルがサポートする機能のカンマ区切りリスト |
同じ _NAME、_DESCRIPTION、_SUPPORTED_CAPABILITIES サフィックスは ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_FABLE_MODEL、ANTHROPIC_CUSTOM_MODEL_OPTION で利用可能です。
Claude Code は、モデル ID を既知のパターンと照合することで、努力レベル や 拡張思考 などの機能を有効にします。Bedrock ARN やカスタムデプロイメント名などのプロバイダー固有の ID は、これらのパターンと一致しないことが多く、サポートされている機能が無効のままになります。_SUPPORTED_CAPABILITIES を設定して、Claude Code にモデルが実際にサポートする機能を伝えます。
| 機能値 | 有効にするもの |
|---|
effort | 努力レベル と /effort コマンド |
xhigh_effort | xhigh 努力レベル |
max_effort | max 努力レベル |
thinking | 拡張思考 |
adaptive_thinking | タスクの複雑さに基づいて思考を動的に割り当てる適応的推論 |
interleaved_thinking | ツール呼び出し間の思考 |
_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 | 1 に設定して、すべてのモデルのプロンプトキャッシングを無効にします。モデル固有の設定より優先されます |
DISABLE_PROMPT_CACHING_HAIKU | 1 に設定して、Haiku モデルのみのプロンプトキャッシングを無効にします |
DISABLE_PROMPT_CACHING_SONNET | 1 に設定して、Sonnet モデルのみのプロンプトキャッシングを無効にします |
DISABLE_PROMPT_CACHING_OPUS | 1 に設定して、Opus モデルのみのプロンプトキャッシングを無効にします |
DISABLE_PROMPT_CACHING_FABLE | 1 に設定して、Fable モデルのみのプロンプトキャッシングを無効にします |
キャッシュ TTL を変更する方法、またはキャッシュミスをトリガーするものについて詳しくは、Claude Code がプロンプトキャッシングを使用する方法 を参照してください。