ANTHROPIC_DEFAULT_FABLE_MODEL を設定しない限り、fable エイリアスは Fable 5.1 に解決されます。ただし Claude apps gateway のセッションでは、fable と best は Fable 5 に解決されます。

claude-fable-5-1 を提供するように設定されていないゲートウェイは、そのモデルへのリクエストを拒否します。Fable 5.1 を提供しているゲートウェイ経由で使用するには、/model claude-fable-5-1 で選択してください。

エイリアスが古いモデルに解決される場合、完全なモデル名を明示的に選択するか、ANTHROPIC_DEFAULT_OPUS_MODEL または ANTHROPIC_DEFAULT_SONNET_MODEL を設定することで、新しいモデルを利用できます。

以前のバージョンでは、これらのエイリアスはより古いモデルに解決されます。各エイリアスがどのバージョンで変更されたかについては、バージョン履歴を参照してください。

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

Fable を使用する

Claude Fable 5.1 と Claude Fable 5 は Claude Code で最も高性能なモデルであり、1 回の作業時間に収まらない規模のタスクに適しています。長時間の自律的なセッションを維持し、行動する前に調査を行い、小規模なモデルよりも頻繁に自身の作業を検証します。Fable 5.1 は新しいリリースです。

どちらの Fable モデルも、いずれのプランやプロバイダーにおいてもアカウント種別のデフォルトではありません。明示的に選択してください。

• Fable 5.1: /model fable を実行するか、claude --model fable で起動します。エイリアスが Fable 5 に解決される Claude apps gateway のセッションでは、代わりに /model claude-fable-5-1 を実行します。
• Fable 5: モデル ID で選択します。Anthropic API では、/model claude-fable-5 を実行するか、claude --model claude-fable-5 で起動します。その他のプロバイダーでは、プロバイダーの Fable 5 モデル ID を使用するか、ANTHROPIC_DEFAULT_FABLE_MODEL で固定します。

Anthropic API に直接接続していて、ユーザー設定にモデルとして claude-fable-5 または claude-fable-5[1m] が保存されている場合（たとえば v2.1.257 より前に /model ピッカーで Fable を選択した場合）、v2.1.257 以降を初めて実行したときに、Claude Code はその保存値を fable または fable[1m] エイリアスに変更します。起動時のモデル行には (auto-updated) が一度だけ表示されます。プロジェクト設定、ローカル設定、または管理設定にある claude-fable-5 の値はそのまま残ります。

Fable モデルの安全性分類器によって警告されたリクエスト（主にサイバーセキュリティや生物学の分野）は、自動モデルフォールバックをトリガーします。

Fable を最大限に活用するには:

• 手順ではなく結果を説明する: 望む結果を伝え、その道筋は Fable に計画させます。その結果に向けて作業を続けさせるには、ゴールを設定します。
• 曖昧な問題を任せる: 根本原因の調査、障害のデバッグ、アーキテクチャの決定などは、追加の調査と検証が効果を発揮する場面です。
• 検証のリマインダーを省く: Fable は少ない指示で自身の作業を検証するため、テストや確認を促すリマインダーは通常不要です。
• より大きなタスクを任せる: 通常なら分割するような作業を与えてください。Fable は長いセッションでも文脈を見失いません。

Anthropic API では、availableModels または組織のモデル制限によって除外されない限り、Fable モデルは /model ピッカーに表示されます。組織が Fable をまったく使用できない場合（たとえばゼロデータ保持の下にある場合）、その行はグレーアウトされた状態でピッカーに残り、理由が注記されます。

Fable と使用クレジット

プランやシート階層によっては、Fable の使用量がプランに含まれる上限から差し引かれるのではなく、使用クレジットに課金される場合があります。その場合、/model ピッカーの Fable の行に「Requires usage credits」と表示されます。使用クレジットを管理するには、サブスクリプションに使用クレジットを追加するを参照してください。

対話セッションでは、Fable のリクエストが使用クレジットに課金される前に、Claude Code が同意プロンプトを表示します。組織請求を利用している Enterprise プランのメンバーには、このプロンプトは表示されません。使用クレジットを使って Fable で続行するか、デフォルトモデルに切り替えることができます。プロンプトを閉じることもできます。

• /model で Fable モデルを選択した場合は、現在のモデルが維持されます。
• セッションの途中では、Claude Code はデフォルトモデルでそのターンを続行します。

使用クレジットを使って Fable で続行することを選択すると、Claude Code はそれ以降プロンプトを表示しません。

Remote Control が接続されているセッション、バックグラウンドセッション、またはエージェントチームのチームメイトのセッションでは、ターミナルの前に誰もいない可能性があるため、Claude Code はセッション途中の同意プロンプトを dialogExpiry の期限（デフォルトは 5 分）まで保持します。期限までに誰も応答しなかった場合、Claude Code はリクエストを送信せずにターンを終了し、トランスクリプトに通知を追加します。この通知は Remote Control クライアントにも表示されます。モデルの選択は変更されず、次のメッセージで Claude Code は再度同意を求めます。

プロンプトが待機している間にできることは、セッションによって異なります。

• Remote Control が接続されている場合やチームメイトのセッションでは、ターミナルで任意のキーを押すと期限がキャンセルされ、Claude Code は応答を待ちます。
• バックグラウンドセッションでは、期限までに応答してください。
• ターミナルで誰かが入力する前にリモートクライアントから新しいメッセージを送信した場合、Claude Code は同様にターンを終了し、新しいメッセージが次のターンを開始します。ターミナルで誰かが入力した後は、Claude Code は応答を待ち続け、新しいメッセージはその後ろにキューイングされます。

別のアプリケーションが Agent SDK を通じてホストしているセッションでは、プロンプトを表示するかどうかはそのアプリケーション次第です。プロンプトが表示され、同じ dialogExpiry の期限までに誰も応答しなかった場合、Claude Code はリクエストを送信せずにターンを終了します。

-p フラグを使用した非対話モードや、プロンプトを表示しない Agent SDK アプリケーションでは、Claude Code は同意を求めません。そこで Fable のリクエストが使用クレジットに課金される場合、Claude Code は確認なしで課金します。

モデルの設定

モデルはいくつかの方法で設定できます。以下は優先順位の高い順です。

1. セッション中: /model <alias|name> を使用してすぐに切り替えるか、引数なしで /model を実行してピッカーを開きます。Claude Code が切り替えの確認を求める場合を参照してください
2. 起動時: claude --model <alias|name> で起動します
3. 環境変数: ANTHROPIC_MODEL=<alias|name> を設定します
4. 設定: 設定ファイルの model フィールドで永続的に設定します
5. 新しいセッションのデフォルト: ANTHROPIC_DEFAULT_MODEL=<alias|name> を設定します

/model は、ユーザー設定の model フィールドに書き込むことで、選択内容を新しいセッションのデフォルトとして保存します。ピッカーでは次のキーを使用します。

• Enter: モデルを切り替え、デフォルトとして保存します
• s: このセッションのみモデルを切り替え、デフォルトは変更しません。別のキーを使用するには、modelPicker:thisSessionOnly を再割り当てします

/model <name> を直接入力した場合は、Enter と同じ動作になります。このセッションのみ切り替えるには、/model でピッカーを開き、そのモデルの行で s を押します。

Enterprise プランで claude.ai アカウントでログインしており、/model でデフォルトを保存した場合、Claude Code はその選択をアカウントにも記録します。これには Claude Code v2.1.280 以降が必要です。

• 管理者が組織のデフォルトモデルを設定していない場合、Default オプションは記録されたモデルに解決されることがあり、その場合はピッカーの Default 行にそのモデル名が表示されます。
• モデル制限によって記録されたモデルが除外されている場合、またはそのモデルがアカウントで利用できない場合で、かつ管理者が組織のデフォルトモデルを設定していない場合、Default オプションは何も記録されていないかのように解決されます。
• /model で Default または opusplan を選択した場合、記録された選択は変更されません。

/model でモデルを切り替えると、その切り替えはメインの会話のモデルを継承するサブエージェントにも反映されます。Claude がサブエージェントを起動する際、Claude Code はセッションで使用しているモデルからそのモデルを解決するためです。Claude が調査やテスト実行をサブエージェントに委任する前に Opus に切り替えると、その作業も Opus で実行されます。カスタムサブエージェントを小さなモデルのままにするには、その定義で model を設定してください。

-p フラグを使用した非対話モードで /model によってモデルを設定した場合、選択は現在のセッションにのみ適用され、デフォルトとしては保存されません。このモードでの /model には Claude Code v2.1.205 以降が必要です。プロジェクト設定と管理設定は引き続き優先され、次回の起動時に再適用されます。管理者がユーザーの選択を上書きするように設定した組織のデフォルトモデルも、次回の起動時に再適用されます。

v2.1.144 から v2.1.152 では、/model は現在のセッションにのみ適用され、ピッカーで d を押すとデフォルトが保存されていました。

--model フラグと ANTHROPIC_MODEL 環境変数は、それらを指定して起動したセッションにのみ適用されます。異なるターミナルで異なるモデルを同時に実行するには、/model で切り替えるのではなく、それぞれ独自の --model フラグを指定して起動してください。

/model ピッカーの価格は、Claude Code が Anthropic API と直接、またはそれをプロキシする LLM ゲートウェイ経由で通信している場合に表示され、各行の価格はその行が選択するモデルの価格です。Amazon Bedrock などのサードパーティプロバイダーや Claude apps gateway では、支払う金額はプロバイダーまたはゲートウェイによって決まるため、ピッカーの行には価格が表示されません。価格は表示用のラベルにすぎず、行が選択するモデルやプロバイダーの請求額には影響しません。v2.1.206 より前は、Claude Platform on AWS とゲートウェイのセッションで Anthropic の定価が表示され、行が選択するモデルとは異なるモデルの価格が表示されることがありました。

claude --resume、--continue、または /resume ピッカーで再開したセッションは、現在の model 設定にかかわらず、トランスクリプトが保存された時点で使用していたモデルを維持します。復元されたモデルが廃止されている場合や availableModels によって除外されている場合、セッションは通常の優先順位に従います。これにより、別のセッションでの /model の選択が再開時のモデルを変更することを防ぎます。Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry など、Anthropic のモデル ID ではなくプロバイダー固有のデプロイ ID を使用するプロバイダーでは、トランスクリプトのモデルはまったく復元されず、セッションは通常の優先順位に従ってモデルを解決します。

新しい起動時に --model または ANTHROPIC_MODEL で選択したモデルは、引き続き復元されたモデルより優先されます。v2.1.195 以降は、ANTHROPIC_DEFAULT_OPUS_MODEL 系の変数も同様に優先されます。ANTHROPIC_DEFAULT_MODEL も、そのセクションに記載されている条件の下で優先されます。

起動時のアクティブなモデルが自分の選択ではなくプロジェクト設定または管理設定に由来する場合、起動時のヘッダーにどの設定ファイルで設定されたかが表示されます。上書きするには /model を実行します。プロジェクト設定または管理設定は次回の起動時に再適用されます。Claude Code を組み込み、CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST を設定しているプラットフォームでは、ホストのモデル設定が管理設定のモデル設定より優先されます。一方、管理設定の availableModels 許可リストは、ホストが独自のものを提供しない限り有効なままです。ホストがどのキーと変数を上書きするかについては、管理設定の優先順位の例外を参照してください。

ユーザーまたは組織が PreModelSwitch フックを設定している場合、それらは要求された切り替えが適用される前に実行され、切り替えをブロックしたり確認を求めたりできます。

組織の管理プラグインがどの PreModelSwitch フックを提供しているかを Claude Code が判断できない場合（たとえば管理プラグインの読み込みに失敗した場合）、Claude Code は確認されないまま切り替えを適用するのではなく切り替えを拒否し、新しい試行のたびに再度確認します。メッセージと復旧方法については、Model switch was blocked by a PreModelSwitch hook を参照してください。

Agent SDK の setModel() メソッド、デスクトップアプリなどのアプリ、または Remote Control 経由で接続されたデバイスからモデルを切り替える場合、Claude Code は切り替え時に値を確認します。

• Agent SDK またはアプリ: Claude Code v2.1.268 以降では、カスタムモデルオプションの場合のように Claude Code がモデル ID をローカルで受け入れる場合を除き、セッションがそのモデルに初めて切り替わるときにプロバイダーに ID を確認します。この確認はすべてのプロバイダーで実行され、プロバイダーが提供していない ID は、次のリクエストで失敗するのではなく切り替え時に拒否されます。
• Remote Control: Anthropic API では、Claude Code は値をローカルで確認し、リクエストは送信しません。

メッセージについては、Model is not a recognized model id および Model not found を参照してください。

--model フラグ、ANTHROPIC_MODEL 環境変数、または model 設定でモデルを設定した場合、Claude Code は事前に確認を行わないため、値を誤入力すると最初のリクエストで There's an issue with the selected model が発生します。

要求されたモデルに廃止予定日が設定されている場合、または新しいバージョンに自動的に再マッピングされる場合、Claude Code は要求されたモデル名を示す警告を表示します。対話セッションでは、起動時の通知として表示されます。v2.1.182 以降、デフォルトのテキスト出力形式を使用している場合、非対話モードでも同じ警告が stderr に書き込まれます。このチェックは、サブエージェントのフロントマターで設定された model も対象とします。--output-format json および stream-json では stderr への警告は抑制されます。代わりに、結果メッセージの modelUsage フィールドから実際のモデルを読み取ってください。

たとえば、Opus でセッションを開始します。

claude --model opus

次に、セッション内からモデルを切り替えます。

/model sonnet

設定ファイルの例:

{
    "permissions": {
        "allow": ["Bash(npm run lint)"]
    },
    "model": "opus"
}

新しいセッションのデフォルトモデルを設定する

セッションがデフォルトで開始するモデルを選択するには、ANTHROPIC_DEFAULT_MODEL=<alias|name> を設定します。Claude Code v2.1.236 以降が必要です。

Claude Code が新しいセッションをこの変数のモデルで開始するのは、次のいずれもモデルを選択していない場合のみです。

• --model フラグ
• ANTHROPIC_MODEL
• いずれかの設定ファイルにある model の値（/model で保存した選択を含む）
• 組織のデフォルトモデル

/model で保存した選択は、以降の起動でもこの変数より優先されます。代わりに ANTHROPIC_MODEL を設定している場合、/model で何を保存したかにかかわらず、Claude Code は次回の起動時にその変数のモデルに戻ります。

組織のデフォルトモデルが適用されない限り、Claude Code は Default オプションもこの変数のモデルに解決します。Default オプションがこの変数のモデルに解決される場合、/model ピッカーの Default 行には Set by ANTHROPIC_DEFAULT_MODEL というラベルが表示されます。

次の場合、Claude Code はこの変数を無視し、Default オプションは変数を設定していないかのように解決されます。

• default、inherit、opusplan、または haiku に設定している
• enforceAvailableModels がオンになっている
• 組織のモデル制限によってそのモデルが除外されている
• そのモデルがアカウントで利用できない

新しいセッションがこの変数のモデルで開始される場合、claude --resume、--continue、または /resume ピッカーで再開したセッションもそのモデルで開始されます。Claude Code はそのセッションのトランスクリプトに保存されたモデルを復元しません。それ以外の場合、セッションを再開するときに Claude Code はこの変数を使用しません。

新しいセッションが選択したものとは異なるモデルで開始される

/model でモデルを選択したのに次のセッションが別のモデルで開始される場合、通常は次のような原因があります。

• 1 つのセッションのみを対象に選択した。 ピッカーで s を押す、--model で起動する、非対話モードで /model を実行する、のいずれも現在のセッションにのみ適用され、保存されたデフォルトは変更されません。
• より優先順位の高いものがモデルを設定している。 プロジェクト設定や管理設定にある model の値、シェルの ANTHROPIC_MODEL、または管理者がユーザーの選択を上書きするように設定した組織のデフォルトは、起動のたびに再適用されます。/model での選択は保存されていますが、優先順位で負けています。プロジェクト設定または管理設定がモデルを設定している場合、起動時のヘッダーにそのファイル名が表示されます。
• Claude Code が選択を保存できなかった。 /model は ~/.claude/settings.json に model を書き込みます。別のツールがそのファイルを生成している、または読み取り専用のコピーにリンクしているなどの理由でそのファイルに書き込めない場合、選択したモデルはそのセッションの間だけ有効で、次回の起動時には古い値が読み込まれます。ファイルを生成しているツールで model を設定するか、ファイルを書き込み可能にしてください。Claude Code で行った変更が新しいセッションで失われるを参照してください。
• セッションを再開した。 claude --resume または --continue で再開したセッションは、通常、現在のデフォルトではなく使用していたモデルを維持します。

モデル選択を制限する

管理者は、管理設定またはポリシー設定の availableModels を使用して、ユーザーが選択できるモデルを制限できます。エントリは、sonnet のようなモデルファミリー、claude-sonnet-4-5 のようなバージョンプレフィックス、または claude-sonnet-4-5-20250929 のような完全なモデル ID に一致します。バージョンプレフィックスは、それにさらにセグメントを付け加えた後続のモデル ID にも一致するため、claude-fable-5 は Fable 5 と Fable 5.1 の両方を許可し、claude-fable-5-1 は Fable 5.1 のみを許可します。リストが許可するモデルをブロックする方法や、各モデル ID エントリがその ID で指定されたバージョンのみを許可するようにする方法については、特定のモデルやバージョンをブロックするを参照してください。

Claude Code を組み込み、CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST を設定しているプラットフォームでは、ホストのモデル設定が管理モデル設定よりも優先されます。ただし、管理設定の availableModels 許可リストは、ホストが独自の許可リストを提供しない限り引き続き有効です。ホストがどのキーと変数を上書きするかについては、管理設定の優先順位の例外を参照してください。

availableModels が設定されている場合、許可リストはユーザーがモデルを指定できるすべての場所に適用されます。

• メインセッションのモデル: /model、--model フラグ、ANTHROPIC_MODEL 環境変数、model 設定、ANTHROPIC_DEFAULT_MODEL、およびセッションの再開時に復元されるモデル
• エイリアスの解決: ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_FABLE_MODEL 環境変数を使って、許可されたエイリアスをリスト外のモデルにリダイレクトすることはできません
• fast mode: リスト外の Opus モデルに暗黙的に切り替わる場合、/fast は "is not in your organization's allowed models" というメッセージを表示して切り替えを拒否します
• サブエージェントとチームメイトのモデル: サブエージェントのフロントマターの model フィールド、Agent ツールの model パラメータ、エージェントチームのチームメイトのモデル、CLAUDE_CODE_SUBAGENT_MODEL、および v2.1.197 以前では /agents ウィザードのモデルピッカー
• スキルとコマンドのモデル: スキルとコマンドの model フロントマター
• アドバイザーモデル: 設定された advisorModel 設定と --advisor フラグ
• バックグラウンドエージェントのモデル: Dispatch ピッカーで選択されたモデル

Anthropic API と Claude Platform on AWS では、モデルファミリーのエイリアス（opus、sonnet、haiku、fable）は、許可リストがそのモデルを許可している場合、通常のモデルに解決されます。許可リストがそのモデルをブロックしている場合、Claude Code は許可リストが許可するそのファミリーの最新バージョンに置き換え、要求されたモデルと置き換え後のモデルの両方を示す通知を表示します。たとえば ["sonnet", "claude-opus-4-6"] の場合、/model opus と --model opus はどちらも、許可されている最新の Opus である Claude Opus 4.6 を選択します。v2.1.205 より前は、最新のリリースバージョンがリスト外にあるエイリアスは、リストが古いバージョンを許可していても、他のブロックされた選択と同様に拒否または置き換えられていました。

この置き換えには、置き換え先となる許可されたバージョンが必要です。許可リストがエイリアスのファミリーのどのバージョンも許可していない場合、そのエイリアスは他のブロックされた値と同様に、以下の拒否および置き換えの動作に従います。

Claude Code は、その他のブロックされた選択を、モデルが設定された場所に応じて次のように処理します。

• /model: Claude Code はエラーを表示して切り替えを拒否します

• --model フラグ、ANTHROPIC_MODEL、または model 設定: Claude Code は起動時に値を置き換え、要求されたモデルと置き換え後のモデルの両方を示す警告を表示します。セッションはデフォルトモデルで開始されます

• ANTHROPIC_DEFAULT_MODEL: Claude Code はこの変数を無視します

• サブエージェントまたはチームメイトの上書き: Claude Code はリクエストを失敗させるのではなく、フォールバックモデルでサブエージェントまたはチームメイトを実行します。サブエージェントのフォールバックについてはモデルを選択するを、チームメイトのフォールバックについてはチームメイトとモデルを指定するを参照してください。

  インタラクティブセッションでは、このフォールバックまたは上記の許可された最新バージョンへの置き換えによってサブエージェントのモデルが置き換えられた場合、Claude Code は要求されたモデルと置き換え後のモデルを示す警告を表示します。チームメイトのフォールバックについては報告しません。

  上記の許可された最新バージョンへの置き換えが機能する環境では、ブロックされたファミリーエイリアスはそちらに従います。v2.1.222 より前は、すべてのプロバイダーで、エイリアスは他のブロックされた値と同様にフォールバックしていました

• スキルまたはコマンドの上書き: Claude Code は、ブロックされたファミリーエイリアスを含めて上書きを無視し、スキルまたはコマンドはセッションのモデルで実行されます。サブエージェントで実行されるスキルまたはコマンドは、代わりに上記のサブエージェントの動作に従います

• advisorModel 設定: そのセッションではアドバイザーが無効になります

• --advisor フラグ: Claude Code は起動時にエラーで終了します。バックグラウンドセッションでは、終了する代わりにアドバイザーなしでセッションを開始します

Claude Code は、除外されたモデルを /model ピッカーから非表示にします。リストに含めたモデル ID が独自の行も持つかどうかは、プロバイダーによって異なります。

• Anthropic API、Claude Platform on AWS、Claude apps gateway、または ANTHROPIC_BASE_URL で設定した LLM ゲートウェイ: リストに含めた Anthropic のモデル ID のうち、組み込みのピッカー行がないものは、独自のラベル付き行として表示されます。Claude Code は、リストで固定された古いバージョンなど、Opus、Sonnet、Haiku のバージョンに対してこのような行を追加します。modelPicker のラインナップで replaceBuiltInOptions を設定している場合、その行は表示されません。v2.1.199 より前は、そのような ID は /model <id> と入力することでのみ選択できました。
• Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry: リストに含めたモデル ID が anthropic. で始まらない限り、それが Anthropic のモデル ID であってもプロバイダー固有のものであっても、Claude Code はその行を追加しません。Mantle のモデル ID にはこのプレフィックスが付いています。組み込みの行がないリスト内のバージョンを表示するには、modelPicker のラインナップにも追加してください。ラインナップはプロバイダーの形式の ID を受け付けます。

Claude Code がユーザーに代わって行うモデル変更も、同じ方法でチェックされます。

• フォールバックモデルチェーン: 許可リスト外のエントリは除外されます
• plan モードのアップグレード: Anthropic API と Claude Platform on AWS では、opusplan のように除外されたモデルへのアップグレードは、アップグレード先ファミリーの許可された最新バージョンを使用します。プロバイダー固有のモデル ID を持つプロバイダーの場合、および許可されたバージョンがない場合は、アップグレードはスキップされ、計画はセッションのモデルで続行されます
• 自動モデルフォールバック: フォールバック先が除外されている場合、フォールバックは実行されないため、警告されたリクエストは代わりに拒否で終了します
• auto モードの分類器: 分類器のデフォルトである Claude Sonnet 5 は、許可リストが Sonnet 5 を許可している場合にのみ適用されます。除外されている場合、分類器はセッションのモデル（すでに許可リストの制御下にあります）で実行されるか、セッションが Fable モデルで実行されている場合は Opus モデルで実行されます。Anthropic API 以外のプロバイダーでは、その Opus フォールバックは許可リストを参照せずに、ANTHROPIC_DEFAULT_OPUS_MODEL で設定したモデル、または設定していない場合は Opus 5 で実行されます。Claude Code v2.1.210 以降が必要です
• fast mode: 有効化後にセッションが実行されるモデルが許可リスト外である場合、fast mode の有効化は拒否されます

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

サーフェスごとの適用範囲

すべてのサーフェスは、受け取った許可リストを適用します。各サーフェスに届く配信メカニズムは次のように異なります。

• Desktop アプリから開始したものを含むクラウドセッションは、デフォルトで Anthropic が管理する VM 上で実行されます。デバイスにデプロイされた設定はこれらに届かないため、許可リストはサーバー管理設定を通じて配信してください。組織がセルフホスト環境にルーティングするセッションは独自のコンピューティング上で実行され、ランナーイメージ内の管理設定ファイルも読み取ります。そのファイルがいつ適用されるかについては、Claude Code が管理ソースを組み合わせる方法を参照してください。クラウドセッションでのセッション途中のモデル切り替えは、要求されたモデルが許可リストによって除外されている場合は拒否されます。サーバー管理設定の availableModels リストが空でない場合、サーバーは、リストが除外するモデルで claude.ai/code または Desktop アプリからクラウドセッションを開始するリクエストを拒否します。
• Claude Tag セッションはクラウド環境で実行されますが、サーバー管理設定を受け取りません。セルフホスト環境では、引き続きランナーイメージ内の管理設定ファイルを読み取ります。これらのセッションのモデルを設定するには、Claude Tag 管理者ガイドのスコープのモデルを選択するを参照してください。
• Claude Desktop アプリのエージェント型作業タブである Cowork は、セッションを Claude Code 上で実行しますが、設計上、claude.ai 管理コンソールからサーバー管理設定を受け取りません。サーバー管理設定の availableModels リストが空でなく、ユーザーがリスト外のモデルを選択した場合、サーバーはリモート Cowork セッションでそのモデルを拒否します。管理設定ファイルは、セッションが実行される場所に存在する場合に Cowork セッションに適用されます。リモート Cowork セッションは Anthropic が管理する VM 上で実行され、そこにはデバイスにデプロイされたファイルは存在しません。
• Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS などのサードパーティプロバイダー上のセッションはサーバー管理設定を受け取らないため、それらの環境では MDM または管理設定ファイルを通じて許可リストを配信してください。
• サーバー管理による配信では、セッションが対象となるログインまたはキーで認証されている必要もあります。apiKeyHelper スクリプトを通じてのみキーを生成するフリートでは、MDM または管理設定ファイルを通じて許可リストを配信してください。
• Desktop の Code タブは SSH セッションもホストしており、これらは実行先のリモートホストから管理設定ファイルを読み取ります。Desktop の管理設定を参照してください。
• claude.ai および Desktop アプリのモデルピッカーは、組織の許可リストによって除外されたモデルを非表示にするかグレーアウトします。ピッカーの状態はユーザーの利便性のためのものであり、許可リストを適用するものではありません。

デフォルトモデルの動作

デフォルトのプレフィックス一致では、availableModels 単独では、enforceAvailableModels も設定するまで、Default オプションはアカウントに対するシステムのランタイムデフォルトのままになります。そのデフォルトが制限したいモデルである場合は、enforceAvailableModels も設定するか、そのモデルをブロックしてください。

availableModels: [] の場合、名前を指定したモデル選択はブロックされ、enforceAvailableModels は効果を持ちません。

Default モデルに許可リストを適用する

管理設定で、空でない availableModels とともに enforceAvailableModels: true を設定すると、許可リストが Default オプションにも適用されます。これには Claude Code v2.1.175 以降が必要です。

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

アカウントにモデルが記録されていないメンバーの場合、Default オプションはアカウントタイプのデフォルト、または管理者が設定している場合は組織のデフォルトモデルに解決されます。そのモデルが許可リストにない場合、Default オプションは代わりに、許可されていて利用可能なモデルを指定する最初の availableModels エントリに解決され、/model ピッカーの Default 行にはそのモデルが表示されます。これは、デフォルトに到達するすべての場所に適用されます。つまり、セッションの起動時、/model で Default を選択した場合、フォールバックモデルチェーンの "default" キーワード、および除外された選択が除外されたときに使用されるフォールバックです。メンバーのアカウントに記録されたモデルも availableModels に照らしてチェックされます。Default オプションがそれをどのように扱うかについては、モデルを設定するを参照してください。

enforceAvailableModels は、availableModels が空でない場合にのみ Default オプションを再マッピングします。availableModels が空でないものの、許可されていて利用可能なモデルに解決されるエントリがない場合、適用はスキップされ、--debug でのみ表示される警告が出されます。これを避けるには、確実に利用可能なエントリを少なくとも 1 つリストに含めてください。

両方のキーは、配信する管理ソースのうち最も順位の高いものに一緒にデプロイしてください。デフォルトでは Claude Code はそのソースのみを読み取るため、管理コンソールが何らかの設定を配信している場合、管理設定ファイルに配置したペアは無視されます。Claude Code が管理ソースを組み合わせる方法のオプトインのマージを使用する場合でも、Claude Code は availableModels を設定するソースより下位のソースからの modelOverrides マップを無視します。

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

model 設定は初期選択であり、適用ではありません。これはセッション開始時にどのモデルがアクティブになるかを設定しますが、ユーザーは引き続き /model を開いて Default を選択できます。Default は、enforceAvailableModels または特定のバージョンをブロックするキーが適用されない限り、model の設定値に関係なくシステムのランタイムデフォルトに解決されます。

モデルの動作を完全に制御するには、次の設定を組み合わせます。

• availableModels: ユーザーが切り替えられる名前付きモデルを制限します
• enforceAvailableModels: availableModels 許可リストを Default オプションに拡張し、Default がリスト外のモデルに解決されないようにします
• deniedModels と availableModelsMatch: availableModels エントリがなければ許可されてしまう特定のバージョンをブロックします
• model: セッション開始時の初期モデル選択を設定します
• ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL: 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 で固定されたバージョンではなくランタイムデフォルトが適用されます。この 2 つの設定は異なる範囲をカバーします。enforceAvailableModels は Default を許可リストに従わせ、env ブロックは sonnet などの許可されたエイリアスがどのバージョンに解決されるかを固定します。モデルファミリーを制限するだけで十分な場合は enforceAvailableModels のみを使用し、特定のバージョンも固定する必要がある場合は env ブロックを追加してください。

マージの動作

Claude Code が適用する管理設定で availableModels が定義されている場合、独自のものを提供するホストプラットフォームを除き、そのリストのみが適用されます。ユーザー設定、プロジェクト設定、ローカル設定のエントリでそれを拡張することはできず、Claude Code は管理ソース間で availableModels をマージすることもありません。どのソースのリストが適用されるかについては、Claude Code が管理ソースを組み合わせる方法を参照してください。それ以外の場合、ユーザー設定、プロジェクト設定、ローカル設定のリストは、他の配列設定と同様に連結され、重複が除去されます。Claude Code v2.1.175 より前は、優先順位の低いスコープのエントリは、管理リストに置き換えられるのではなく、管理リストにマージされていました。

有効なリスト内で、ファミリー内の特定のモデルを指定するエントリ（バージョンプレフィックスまたは完全なモデル ID）は、そのファミリーのワイルドカードエントリを無効にします。["sonnet", "claude-sonnet-4-5"] は、すべての Sonnet モデルではなく、Sonnet 4.5 のバージョンのみを許可します。

Mantle のモデル ID

availableModels 内の anthropic. で始まるエントリは、カスタムオプションとして /model ピッカーに追加されます。これは、サードパーティのデプロイ向けにモデルを固定するで説明されているエイリアス一致の例外です。Amazon Bedrock Mantle エンドポイントが有効な場合、Claude Code は Mantle 形式に一致するエントリをそのエンドポイントにルーティングします。この設定は引き続きピッカーをリストされたエントリに制限し、Mantle ID にはファミリー名が含まれているため、特定のエントリとしてカウントされ、そのファミリーのワイルドカードを無効にします。Mantle ID と併せて、選択可能なままにしたいバージョンプレフィックスまたは完全な ID をリストしてください。マージの動作を参照してください。

特定のモデルやバージョンをブロックする

claude-opus-5 のような availableModels エントリは、Opus 5.5 など、それを拡張する後続のリリースも、Claude Code がサポートした時点で許可します。リリースを保留するための管理設定が 2 つあり、どちらも Claude Code v2.1.283 以降が必要です。

• deniedModels: ブロックするモデルをリストします。リストされたモデルは、availableModels が許可している場合でもブロックされ、このキーは許可リストがまったくない場合でも機能します。どのエントリにもブロックされないリリースは許可されたままです
• availableModelsMatch: これを "exact" に設定すると、availableModels 内の各モデル ID は、その ID で指定されたバージョンのみを許可します。リストされたモデル ID の新しいバージョンは、リストに追加するまでブロックされたままになります

以前のバージョンはどちらのキーも無視するため、それらのバージョンが起動しないように requiredMinimumVersion も設定してください。

この例では、Opus と Sonnet のモデルを許可し、日付付きの ID やプロバイダー固有の ID を含むあらゆる表記の Opus 5.5 をブロックします。

{
  "availableModels": ["opus", "sonnet"],
  "deniedModels": ["claude-opus-5-5"]
}

ブロックされたモデル（deniedModels で指定されたもの、または "exact" リストで省略されたもの）は、許可リストが適用されるすべての場所で、ブロックされた選択として扱われます。/model ピッカーから非表示になり、/model <name> はそれを拒否します。--model、ANTHROPIC_MODEL、または model 設定でブロックされたモデル ID を指定すると、Claude Code は起動時にそれを除外し、代わりに Default オプションを解決します。フックやバックグラウンドのリクエストが deniedModels によってブロックされたモデルを指定した場合（エージェントフックの model フィールドなど）、そのリクエストは代わりにセッションのモデルで実行されます。

Default オプションも、enforceAvailableModels を設定しているかどうかにかかわらず、両方のキーに従います。空でない availableModels とともにそれを設定している場合、ブロックされたデフォルトは許可リスト外のモデルとしてカウントされます。それ以外の場合、ブロックされたモデルに解決されることになる Default オプションは、次の順序で段階的に切り替わります。

1. 同じファミリーの許可された最新バージョン
2. より低コストの各ファミリーの許可された最新モデル（順に Sonnet、次に Haiku）
3. 許可されたモデルを指定する最初の availableModels エントリ

これらのいずれも許可されていない場合、Default オプションで開始するセッションは、修正すべきキーを示すエラーとともに起動を拒否します。"exact" リストが Default オプションに影響するのは、管理設定の availableModels リストが少なくとも 1 つのモデルまたはファミリーを指定している場合のみです。

Claude Code は、両方のキーを管理設定からのみ読み取ります。ユーザー設定、プロジェクト設定、ローカル設定、または --settings でいずれかを設定した場合、Claude Code は警告を表示してそれを無視します。

組織のモデル制限

Claude Enterprise プランの組織管理者は、claude.ai 管理コンソールで個々のモデルを無効にすることで、メンバーが実行できるモデルを制限します。この制限は、Claude Code の認証時にアカウントのエンタイトルメントとともに配信され、設定内の availableModels リストとは別のものです。また、サーバーはセッション作成時に同じ制限を独立して適用します。Claude Code v2.1.187 以降が必要です。

この制限は、メンバーがサインインした場合、または自身の API キーを使用した場合に適用されます。組織サービスキーなどの組織スコープの認証情報はユーザーに紐付いていないため、制限は適用されません。

Claude Console にはモデル制限の制御機能はありません。Anthropic API を通じてメンバーが認証する組織を含め、Claude Enterprise プランを持たない組織は、代わりに管理設定の availableModels でモデルを制限し、Default オプションをカバーするために enforceAvailableModels を追加します。各サーフェスがこれらの設定をどのように受け取り適用するかについては、サーフェスごとの適用範囲を参照してください。

制限されたモデルは /model ピッカーから非表示になります。--model、ANTHROPIC_MODEL 環境変数、または model 設定で名前を指定してそれを選択すると、Model "<name>" is restricted by your organization's settings. Using <model> instead. という通知が表示され、セッションは許可されたモデルで開始されます。制限されたモデルに対して /model <name> と入力すると、Model '<name>' is restricted by your organization's settings. Run /model to choose a different model. と表示されて拒否され、セッションは現在のモデルを維持します。

opus などのモデルファミリーのエイリアスは、組織がそのモデルを許可している場合、通常のモデルに解決されます。組織がそのモデルを制限している場合、Claude Code は組織が許可するそのファミリーの最新バージョンに置き換え、同じ置き換え通知を表示します。/model <alias> が拒否されるのは、そのファミリーのすべてのバージョンが制限されている場合のみです。その場合でも、--model、ANTHROPIC_MODEL、または model 設定で設定されたエイリアスは、起動時に置き換えられます。v2.1.205 より前は、古いバージョンが許可されていても、ファミリーエイリアスは最新のリリースバージョンのみに基づいて置き換えまたは拒否されていました。

制限は組織全体またはロールごとに適用されます。

• 組織レベルでモデルを無効にすると、すべてのメンバーからそのモデルが削除されます。
• ロールレベルのアクセスでは、カスタムロールごとに異なるモデルを付与でき、複数のロールを持つメンバーは、いずれかのロールが付与するモデルを使用できます。
• Haiku モデルは常に利用可能で無効にできないため、すべてのメンバーは少なくとも 1 つの使用可能なモデルを保持します。
• アクセスの変更は、約 1 分以内に新しいリクエストに反映されます。/model ピッカーには、次回のセッション開始時に反映されます。

両方の制限は同時に適用されます。モデルが選択可能になるのは、availableModels で許可されていて、かつ組織によって制限されていない場合のみです。組織の制限が適用されるのは、Anthropic API および LLM ゲートウェイのデプロイ上のセッションのみです。その他のプロバイダーでは、代わりに availableModels を使用してください。

組織のデフォルトモデル

Claude Enterprise プランの組織管理者は、claude.ai の管理コンソールから、組織全体またはカスタムロールごとに Claude Code メンバー向けのデフォルトモデルを設定できます。設定されている場合、Default オプションはそのモデルに解決されます。Claude Code v2.1.196 以降が必要です。

/model ピッカーの Default 行には、組織のデフォルトモデルの名前が Org default というラベル付きで表示されます。管理者が組織全体に対してデフォルトを設定した場合でも、ユーザーのロールに対して設定した場合でも、ラベルは Org default と表示されます。ロールのデフォルトはそのカスタムロールのメンバーに適用され、組織全体のデフォルトよりも優先されます。ユーザーの複数のロールで異なるデフォルトが設定されている場合は、最も高性能なモデルが適用されます。

組織のデフォルトは出発点であり、制限ではありません。次の選択は組織のデフォルトよりも優先されます。

• --model フラグおよび ANTHROPIC_MODEL 環境変数
• 管理設定内の model の値、または --settings で指定された model の値
• ユーザー、プロジェクト、またはローカル設定内の model の値（/model で保存したモデルを含む）

管理者は、組織のデフォルトがユーザーの選択を上書きするように設定することもできます。上書きが有効な場合、組織のデフォルトはユーザー、プロジェクト、ローカル設定内の model の値よりも優先されるため、/model で保存したモデルは現在のセッションにのみ適用され、次回の起動時には組織のデフォルトに戻ります。ユーザーの選択が異なる場合、/model には Your organization's default (<model>) applies on restart と表示されます。上書きが有効な場合でも、--model フラグ、ANTHROPIC_MODEL、管理設定、--settings は引き続き優先されます。

メンバーが選択できるモデルを制限するには、代わりに組織のモデル制限または availableModels を使用してください。

Claude Code は起動時に一度だけ組織のデフォルトを読み込むため、セッション中に管理者がデフォルトを変更した場合は、次回の起動時に反映されます。

組織のデフォルトがユーザーの選択を上書きしない場合、管理者がデフォルトを変更した後の最初の対話型起動時に、ユーザー設定から model キーが一度だけ削除され、新しいデフォルトが適用されます。ファイル内のそれ以外の内容は変更されず、その起動後に /model で保存したモデルは保持されます。

組織のデフォルトは、採用される前に次の制限チェックを通過します。

• デフォルトのプレフィックスマッチングでは、availableModels 単体では組織のデフォルトに適用されないため、許可リストに含まれない組織のデフォルトも引き続き適用されます。enforceAvailableModels も設定されている場合は、許可リストに含まれない組織のデフォルトも許可リストの最初のエントリに再マッピングされます
• 組織のモデル制限によってユーザーのアカウントで拒否されている組織のデフォルトは、同じファミリー内で許可されている最新のモデルに置き換えられます。そのファミリーのすべてのバージョンが制限されている場合は、より低コストのファミリーに置き換えられます
• deniedModels または "exact" リストによってブロックされる組織のデフォルトについては、特定のモデルまたはバージョンをブロックするを参照してください
• ユーザーのアカウントでまったく利用できない組織のデフォルトはスキップされ、Default オプションは組織のデフォルトがない場合と同様に解決されます

v2.1.199 以降では、組織のデフォルトがユーザーのアカウントタイプの通常のデフォルトとは異なるモデルファミリーである場合、/model ピッカーにはその通常のファミリー用の行が別途残るため、セッション中にそのファミリーへ切り替えることもできます。v2.1.196 から v2.1.198 では、この行はピッカーに表示されません。

組織のデフォルトは、Anthropic API で認証されたセッションにのみ適用されます。LLM ゲートウェイのデプロイを含むその他の環境でデフォルトを設定するには、代わりに管理設定の model キーを使用してください。

組織の effort 上限

組織は、effort レベルに 2 つの方法で上限を設定できます。Claude Enterprise プランでは、組織の管理者が以下で説明するロールごとの effort 上限を設定します。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry を含むすべてのプランとプロバイダーでは、代わりに maxEffortLevel 管理設定によってクライアント側で effort に上限が設定されます。1 つのモデルに両方が適用される場合は、低いほうの上限が適用されます。

Claude Enterprise プランの組織管理者は、ロールレベルの組織のモデル制限とあわせて、カスタムロールごとにモデル単位で effort レベルの最大値を設定できます。上限を超えるレベルは /effort ピッカーに表示されず、--effort または /effort でより高いレベルを指定した場合は、代わりに上限のレベルで実行されます。対話型セッションとプレーンテキストの --print 実行では、要求されたレベルと適用されたレベルを示す警告が表示されます。json または stream-json 出力の場合やバックグラウンドエージェントでは、上限への制限は警告なしで適用されます。上限はモデルごとに設定されるため、モデルを切り替えると利用可能なレベルが変わることがあります。ユーザーの複数のロールが同じモデルを許可している場合は、最も制限の緩い上限が適用されます。Claude Code v2.1.195 以降が必要です。

effort 上限は組織のモデル制限と一緒に配信され、同じセッションに適用されます。

特殊なモデルの動作

`default` モデル設定

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

• Pro、Max、Team、Enterprise、Anthropic API：デフォルトは Opus 5.5
• Claude Platform on AWS、Amazon Bedrock、Google Cloud's Agent Platform：デフォルトは Opus 5.5
• Microsoft Foundry：デフォルトは Sonnet 4.5

v2.1.280 より前は、default は Pro と Team Standard では Sonnet 5 に、Max、Team Premium、Enterprise、Anthropic API では Opus 5 に解決され、Claude Platform on AWS、Amazon Bedrock、Google Cloud's Agent Platform では v2.1.219 以降 Opus 5 に解決されていました。v2.1.219 より前は、default は Anthropic API、Max、Team Premium、Enterprise の従量課金では v2.1.154 以降 Opus 4.8 に解決され、Claude Platform on AWS、Amazon Bedrock、Google Cloud's Agent Platform では v2.1.207 以降 Opus 4.8 に解決されていました。v2.1.207 より前は、default は Claude Platform on AWS では Opus 4.7 に、Amazon Bedrock と Google Cloud's Agent Platform では Sonnet 4.5 に解決されていました。

管理者が組織のデフォルトモデルを設定している場合、default は上記のアカウント種類ごとのデフォルトではなく、そのモデルに解決されます。Claude Code v2.1.196 以降が必要です。また、default は、該当セクションに記載された条件のもとで ANTHROPIC_DEFAULT_MODEL で設定したモデルに解決されることや、アカウントに記録されているモデルに解決されることもあります。

アカウントに何も記録されておらず、管理設定でDefault モデルに許可リストが強制されていて、かつアカウント種類ごとのデフォルトが availableModels に含まれていない場合、default は上記のアカウント種類ごとのデフォルトではなく、強制された Default に解決されます。組織のデフォルトと強制の両方が適用される場合は、まず組織のデフォルトがアカウント種類ごとのデフォルトを置き換え、その後に強制が適用されます。許可リストに含まれる組織のデフォルトはそのまま維持され、リスト外のものは強制された Default に解決されます。

Fable モデルは、どのプランやプロバイダーでもアカウント種類ごとのデフォルトにはなりません。/model で Fable モデルを選ぶと、ユーザー設定に選択中のモデルとして保存されるため、以降のセッションはそのモデルで開始されます。v2.1.257 で Claude Code が保存済みの Fable 5 の選択に対して行う一度限りの変更については、Fable を使用するを参照してください。

`opusplan` モデル設定

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

• plan モードの場合：複雑な推論やアーキテクチャ上の判断に opus を使用します
• 実行モードの場合：コード生成と実装のために自動的に sonnet に切り替えます

これにより、計画には Opus の推論能力を、実行には Sonnet の効率性を組み合わせられます。

plan モードの Opus フェーズは opus モデル設定と同じコンテキストウィンドウを使用し、実行フェーズは sonnet と同じウィンドウを使用します。opus と sonnet が、Anthropic API 上の現行モデルのようにデフォルトで 1M コンテキストウィンドウで動作するモデルに解決される場合は、両方のフェーズがそのウィンドウで動作します。そうでない場合に両方のフェーズで 1M コンテキストを要求するには、たとえば /model opusplan[1m] のように、モデルを opusplan[1m] に設定します。/model での設定には Claude Code v2.1.265 以降が必要です。それより前のバージョンでは、代わりに --model フラグまたは model 設定を使用してください。

availableModels が最新の Opus を除外しつつ古いバージョンを許可している場合（たとえば ["sonnet", "claude-opus-4-6"]）、opusplan は許可されている最新の Opus を計画に使用し、すべての Opus が除外されている場合にのみ Sonnet のままになります。同様に、通常は plan モードで Sonnet にアップグレードされる Haiku セッションは、許可されている最新の Sonnet を使用し、すべての Sonnet が除外されている場合にのみ Haiku のままになります。v2.1.205 より前は、アップグレード先ファミリーの最新バージョンが除外されていると、許可リストが古いバージョンを許可していても、plan モードはセッションのモデルのままでした。

許可されている古いバージョンへの置き換えは、Anthropic API と Claude Platform on AWS に適用されます。デプロイでプロバイダー固有のモデル ID を使用する Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry、Mantle では、アップグレード先のモデルが除外されている場合、plan モードはセッションのモデルのままになります。

計画の境界で切り替えるのではなく、タスクの途中で Claude が 2 つ目のモデルに相談するタイミングを判断するハイブリッドアプローチについては、advisor ツールを参照してください。

フォールバックモデルチェーン

プライマリモデルが過負荷状態、利用不可、またはその他の再試行不可能なサーバーエラーを返した場合、Claude Code はリクエストを失敗させる代わりにフォールバックモデルに切り替えることができます。認証、請求、レート制限、リクエストサイズ、トランスポートのエラー、および組織のポリシーチェックによる拒否では切り替えは発生せず、通常の再試行とエラー処理に従います。Amazon Bedrock または Google Cloud's Agent Platform がアカウントで呼び出せないモデルを拒否した場合は切り替えが発生します。Claude Code はこれを認証エラーではなく、モデルが利用不可であるものとして扱います。

1 つ以上のフォールバックモデルを設定すると、Claude Code はそれらを順に試し、切り替え時に通知を表示します。切り替えは現在のターンにのみ有効なため、次のメッセージでは再びプライマリモデルが最初に試されます。Claude Code は重複を除いたうえでチェーンを 3 モデルまでに制限し、それを超えるエントリは無視します。

1 つのセッションにチェーンを設定するには、カンマ区切りのリストを受け付ける --fallback-model フラグを使用します。

claude --fallback-model sonnet,haiku

セッションをまたいでチェーンを保持するには、設定で fallbackModel を配列として設定します。

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

--fallback-model フラグは fallbackModel 設定より優先されます。各エントリにはモデル名またはエイリアスを指定でき、"default" はデフォルトモデルに展開されます。

Claude Code は起動時にチェーンを確認せず、/status にも表示されません。切り替えが発生したときに表示される通知が、フォールバックが設定されていることを示す最初の目に見えるサインです。

リクエストがフェイルオーバーすると、Claude Code はいずれかのエントリがリクエストを受け付けるまで、各エントリを順に試します。設定に固定された廃止済みモデルなど、到達できないエントリも同様に次のエントリへフェイルオーバーします。Claude Code は、この順次試行を始める前に 2 種類のエントリを除外します。

• 許可リスト外：Claude Code はチェーンを読み込む際に、availableModels で許可されていないエントリを除外します。
• コンテキスト圧縮中のより小さいコンテキストウィンドウ：チェーンはコンテキスト圧縮にも適用されますが、Claude Code はプライマリモデルより小さいコンテキストウィンドウを持つモデルにはフォールバックしません。そこで要約すると、会話の一部が先に切り捨てられてしまうためです。すべてのフォールバックがより小さい場合、圧縮は元のエラーを表示し、再試行できます。

Claude Code はチェーンをサブエージェントにも適用します。サブエージェントのリクエストがフェイルオーバーすると、Claude Code は設定されたフォールバックモデルを順に試し、サブエージェントはリクエストを受け付けたモデルで処理を続行します。セッションのモデルは変わりません。v2.1.247 より前は、チェーンの対象となる失敗が発生するとサブエージェントが終了していました。

自動モデルフォールバック

このセクションでは、Fable モデル、Opus 5.5、Sonnet 5.5、Opus 5 からのコンテンツに基づくフォールバックについて説明します。モデルが過負荷状態または利用不可の場合の可用性に基づくフォールバックについては、フォールバックモデルチェーンを参照してください。

Fable モデル、Opus 5.5、Sonnet 5.5、Opus 5 は安全性分類器とともに動作し、分類器が最も頻繁に警告するのはサイバーセキュリティと生物学に関するコンテンツです。分類器がリクエストを警告し、警告されたカテゴリにフォールバックモデルがある場合、Claude Code はそのモデルでリクエストを再実行し、トランスクリプトに通知を表示します。この 2 つのカテゴリについて、フォールバックモデルは拒否したモデルによって異なります。

• Fable 5.1、Fable 5、Opus 5.5：生物学で警告されたリクエストは Opus 5 で、サイバーセキュリティで警告されたリクエストは Opus 4.8 で再実行されます。
• Sonnet 5.5：サイバーセキュリティで警告されたリクエストは Sonnet 5 で再実行されます。Sonnet 5.5 には生物学のフォールバックモデルがないため、生物学で警告されたリクエストは代わりに拒否で終了します。
• Opus 5：サイバーセキュリティで警告されたリクエストは Opus 4.8 で再実行されます。Opus 5 は独自の生物学分類器をフォールバックモデルなしで実行するため、生物学で警告されたリクエストは代わりに拒否で終了します。

Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry では、Claude Code はこれらのターゲットを代わりにデプロイのモデル ID を通じて解決します。Bedrock、Agent Platform、Foundry でフォールバックを有効にするを参照してください。

フォールバック後、セッションはフォールバックモデルで続行されます。元のモデルに戻るには、/model を実行します。

カテゴリに基づくフォールバックには Claude Code v2.1.219 以降が必要です。v2.1.219 より前は、警告された Fable 5 のリクエストはすべてプロバイダーのデフォルトの Opus モデルで再実行され、Opus 5 はフォールバック元ではありませんでした。

フォールバックモデルは availableModels と照合されます。ブロックされている場合、フォールバックは発生しません。拒否は通常のエラーとして表示され、セッションのモデルは変わりません。

フォールバック後の effort レベル

Claude Code がセッションをフォールバックモデルに切り替える際は、そのモデルのデフォルトの effort ではなく、警告されたリクエストが実行されていた effort レベルを維持します。たとえば、デフォルトの medium で動作している Opus 5.5 のセッションが Opus 4.8 にフォールバックした場合、Opus 4.8 のデフォルトは high ですが、medium のままになります。

次のような場合は、別のレベルが適用されます。

• 設定または組織のデフォルト：フォールバックモデルに適用される設定内のレベル、または組織がそのモデルに設定したデフォルトの effort が代わりに適用されます。
• ユーザー自身による変更：effort レベルを選択したり、/model でモデルを選んだり、後でセッションを再開したりすると、警告されたリクエストのレベルは引き継がれなくなります。
• スキルの effort：スキルの effort フロントマターが警告されたリクエストに設定したレベルはそのターンに適用され、以降のターンは effort の解決順序がフォールバックモデルに与えるレベルで実行されます。

セッションヘッダーには、有効なレベルがモデル名の横に表示されます。変更するには、セッション内で /effort を実行します。

フォールバックのきっかけを確認する

フォールバックは、特殊な内容を何も送信する前に、セッションの最初のリクエストで発生することがあります。最初のリクエストには、CLAUDE.md の内容や git status などのワークスペースのコンテキストが含まれるためです。セキュリティや生物学に関する資料を含むリポジトリでは、そのコンテキストだけで分類器が反応することがあります。

カスタマイズがきっかけかどうかを確認するには、claude --safe-mode でセッションを開始します。これにより、CLAUDE.md、スキル、MCP サーバー、フックなどのカスタマイズが無効になります。git status やディレクトリ名はカスタマイズではないため、引き続き含まれます。

切り替える前に確認する

自動的に切り替えるのではなく、リクエストが警告されるたびにどうするかを判断したい場合は、/config を実行して Switch models when a message is flagged をオフにするか、設定ファイルで switchModelsOnFlag を false に設定します。すると、警告されたリクエストはセッションを一時停止し、フォールバックモデルに切り替えるか、プロンプトを編集して現在のモデルで再試行するかの 2 つの選択肢を表示します。

次の場合は動作が異なります。

• Opus 5 や Sonnet 5.5 での生物学の警告のように、警告されたカテゴリにフォールバックモデルがない場合、Claude Code は確認を表示せず、リクエストは拒否で終了します。
• 両方のモデルが同じリクエストを警告した場合は、プロンプトを編集して再試行するか、新しいセッションを開始できます。
• モバイルアプリ上のクラウドセッションでは、編集して再試行することはできません。モデルを切り替えるか、デスクトップのブラウザまたはデスクトップアプリからセッションを続行してください。
• 確認を表示できない非対話モードや SDK 統合では、警告されたリクエストは代わりに拒否でターンを終了します。
• フォールバック先が availableModels によってブロックされている場合、Claude Code は確認を表示しません。ターゲットがブロックされている場合の自動フォールバックと同様に、警告されたリクエストは拒否で終了します。

Bedrock、Agent Platform、Foundry でフォールバックを有効にする

Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry では、モデル ID がプロバイダー固有であるため、自動フォールバックは Claude Code が関係する各モデルを識別できる場合にのみ動作します。

• Claude Code が現在のモデルをフォールバック元として認識する必要があります。Fable 5.1 と Fable 5 は、モデル ID に claude-fable-5 が含まれる場合、ANTHROPIC_DEFAULT_FABLE_MODEL の値と一致する場合、または modelOverrides でマッピングされている場合に認識されます。Opus 5.5、Sonnet 5.5、Opus 5 は、プロバイダーのモデル ID または modelOverrides のマッピングによって認識されます。
• どのモデルが拒否したかにかかわらず、Opus のターゲットがデプロイで解決される必要があります。ANTHROPIC_DEFAULT_OPUS_MODEL を設定するか、プロバイダーのモデルリストに Opus 4.8 のエントリを残してください。どちらもない場合、Sonnet 5.5 を含むすべてのフォールバック元モデルでフォールバックはオフのままとなり、警告されたリクエストは拒否で終了します。
• 警告されたカテゴリのフォールバックモデルがデプロイで解決される必要があります。Fable モデル、Opus 5.5、Opus 5 からの場合、ANTHROPIC_DEFAULT_OPUS_MODEL を設定すると、フォールバックがあるすべてのカテゴリについて、警告されたリクエストはそのモデルで再実行されます。ただし、Opus 5 での生物学の警告は引き続き拒否で終了します。設定しない場合、サイバーセキュリティで警告されたリクエストは Opus 4.8 のエントリで再実行され、Fable モデルまたは Opus 5.5 からの生物学で警告されたリクエストは Opus 5 のエントリで再実行されます。Sonnet 5.5 からの場合、サイバーセキュリティで警告されたリクエストは ANTHROPIC_DEFAULT_SONNET_MODEL で設定したモデルで再実行されるか、設定しない場合はプロバイダーのモデルリストにある Sonnet 5 のエントリで再実行されます。

いずれかのモデルを識別できない場合、Claude Code は切り替えません。警告されたリクエストは拒否メッセージで終了し、/model でモデルを切り替えて再試行できます。両方のモデルを識別できるようにするには、フォールバック元モデルに応じて次の固定設定を行います。

• Fable モデル：Claude Code がフォールバック元として認識できるよう、ANTHROPIC_DEFAULT_FABLE_MODEL に Fable のモデル ID を設定します。
• すべてのフォールバック元モデル：フォールバックをオンにし、警告されたカテゴリにターゲットを与えるため、ANTHROPIC_DEFAULT_OPUS_MODEL に Opus のモデル ID を設定します。Opus ファミリー以外のモデルや、拒否したモデル自体を指定した場合は、拒否がそのまま残ります。
• Sonnet 5.5：Opus の固定設定に加えて、ANTHROPIC_DEFAULT_SONNET_MODEL を設定するか、プロバイダーのモデルリストに Sonnet 5 のエントリを残して、リクエストを再実行するモデルを用意します。Sonnet ファミリー以外のモデルや Sonnet 5.5 自体を指定した Sonnet の固定設定では、拒否がそのまま残ります。

セキュリティ研究と生物学のワークロード

ペネトレーションテスト、Capture the Flag（CTF）演習、生物学に関連するコードベースなど、攻撃的セキュリティや生物学のワークロードでは、フォールバックが頻繁に、多くの場合最初のリクエストで発生します。Fable 5.1、Fable 5、Opus 5.5 で本格的な生物学の作業を行う場合、Claude Code は最初に警告されたリクエストの時点でセッションを Opus 5 に移行し、Opus 5 には生物学のフォールバックがないため、その後の生物学で警告されたリクエストはそこで拒否となります。Opus 5 と Sonnet 5.5 では、最初に警告されたリクエストからその拒否が発生します。

これはこれらの分野における想定どおりのルーティングであり、アカウントに対する警告ではありません。組織がこの作業に Fable クラスの能力を必要とする場合は、Anthropic のアカウントチームに信頼済みアクセスプログラムについてお問い合わせください。

effort レベルを調整する

effort レベルはアダプティブ推論を制御します。アダプティブ推論では、タスクの複雑さに基づいて、各ステップで思考するかどうか、どの程度思考するかをモデルが判断します。低い effort は単純なタスクに対してより高速かつ低コストで、高い effort は複雑な問題に対してより深い推論を提供します。

利用可能な effort レベルはモデルによって異なります。ここに記載されていないモデルは effort をサポートしていません。

アクティブなモデルがサポートしていないレベルを設定した場合、Claude Code は設定したレベル以下でサポートされている最も高いレベルにフォールバックします。たとえば、Opus 4.6 では xhigh は high として動作します。組織またはユーザー自身の設定によって、モデルが提供するレベルに上限を設けることもできます。組織の effort 制限を参照してください。

Claude Code は、次の順序でセッションの effort レベルを解決し、最初に該当したものを採用します。

1. 明示的な選択：CLAUDE_CODE_EFFORT_LEVEL 環境変数、--effort を付けた起動、またはセッション内での /effort（非対話の /effort は効果の範囲が狭くなります）
2. 設定：モデルに対して保存したレベルまたは effortLevel キー。これらの間および設定ファイル間の優先順位は modelSettings に記載されています
3. モデルのデフォルトの effort：effort をサポートするすべてのモデルで high。ただし、Opus 5.5 と Sonnet 5.5 のデフォルトは medium、Opus 4.7 のデフォルトは xhigh です。また、組織が組織のデフォルトモデルにデフォルトの effort レベルを設定している場合、そのモデルを実行するときはそのレベルがデフォルトになります。自動モデルフォールバックの後に適用されるレベルについては、フォールバック後の effort レベルを参照してください

Opus 5.5 は、上記のいずれかのソースでレベルが設定されていない限り medium で開始され、ユーザー設定ファイルのトップレベルの effortLevel は Opus 5.5 には適用されません。このキーは、Claude Code がモデルごとにレベルを保存するようになる前に /effort が書き込んでいた古い形式です。Opus 5、Fable 5.1、およびそれ以前のモデルでは以前と同様に適用され続けますが、Opus 5.5 とそれ以降にリリースされたモデルは、/effort または /model ピッカーでレベルを選ぶまで、それぞれのデフォルトで開始されます。プロジェクト設定、ローカル設定、管理設定のトップレベルの effortLevel、または --settings で渡されたものは、すべてのモデルに適用されます。

自分のマシン上の対話セッションで low、medium、high、xhigh を設定する場合、確定の方法によって有効期間を選べます。

• /effort スライダーまたは /model ピッカーでの Enter、または /effort の後にレベルを入力：レベルをデフォルトとして保存し、以降のセッションにも適用します
• /effort スライダーまたは /model ピッカーでの s：このセッションにのみレベルを適用します。Claude Code v2.1.257 以降が必要です

Claude Code はユーザー設定の modelSettings キーの下にモデルごとのレベルを保存するため、各モデルはそれぞれ独自の保存済みレベルを保持します。

max は最も深い推論レベルです。CLAUDE_CODE_EFFORT_LEVEL 環境変数で設定しない限り、Claude Code は max を現在のセッションにのみ適用します。

# Use the opus[1m] or sonnet[1m] alias
/model opus[1m]
/model sonnet[1m]

# Or append [1m] to a full model name
/model claude-opus-4-8[1m]

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

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

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'

{
  "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"
  }
}