モデル・effort・fast mode

model 設定には、モデルの別名（alias）かモデル名を指定します。モデル名は、Anthropic API なら完全なモデル名、Amazon Bedrock なら推論プロファイルの ARN、Microsoft Foundry ならデプロイ名、Google Cloud の Agent Platform ならバージョン名です。このページでは、モデルの選び方、effort（思考の深さ）、コンテキストの大きさ、fast mode、advisor、管理者が使える制限をまとめます。

• 別名（opus・sonnet など）は、プロバイダーごとの推奨バージョンに解決され、時間とともに更新される。固定するには完全なモデル名か ANTHROPIC_DEFAULT_*_MODEL を使う
• モデルは /model、--model、ANTHROPIC_MODEL、model 設定の順に強く効く
• effort は /effort や --effort で変える。既定の段階はモデルで違う
• fast mode は Opus を高速な構成で動かす研究プレビュー機能。料金が上がる
• advisor は、主モデルが重要な場面でより強いモデルに相談する実験的な機能
• 組織の管理者は availableModels などでモデルを絞れる

ANTHROPIC_BASE_URL は、リクエストの送り先を変えるだけで、どのモデルが答えるかは変えません。LLM ゲートウェイはネットワークと LLM ゲートウェイを参照してください。

モデルの別名#

opus と sonnet が指すバージョンは、プロバイダーで変わります。

• ANTHROPIC_DEFAULT_FABLE_MODEL を設定しなければ、fable は Fable 5.1 に解決される。Claude apps gateway のセッションでは fable と best は Fable 5。claude-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 は既定のモデルではなく、明示的に選びます。

• Anthropic API に直接つなぎ、ユーザー設定のモデルが claude-fable-5 か claude-fable-5[1m]（v2.1.257 より前に /model ピッカーで Fable を選んだ場合など）なら、v2.1.257 以降を初めて動かしたときに、保存された値が別名 fable か fable[1m] に変わり、起動時のモデル行に (auto-updated) が 1 回出る。プロジェクト・ローカル・管理設定の claude-fable-5 はそのまま
• Fable のセーフティ分類器（多くはサイバーセキュリティと生物学の領域）が止めたリクエストは、自動モデルフォールバックの対象になる（後述）
• Fable 5.1 は v2.1.257 以降が必要。ZDR（ゼロデータ保持）での提供はセキュリティとデータの扱いを参照

Anthropic API では、availableModels か組織のモデル制限が除外しない限り、Fable が /model ピッカーに出ます。組織が Fable を使えない場合（ゼロデータ保持など）は、理由の注記つきで灰色の行が残ります。

Fable と使用クレジット#

プランと席の種別によっては、Fable の利用がプランに含まれる枠ではなく使用クレジット（usage credits）に課金されます。その場合、/model ピッカーの Fable の行に「Requires usage credits」と出ます。

• 対話セッションでは、Fable のリクエストが使用クレジットに課金される前に、同意の確認が出る。組織課金の Enterprise プランのメンバーには出ない。使用クレジットで Fable を続けるか、既定のモデルに切り替えるかを選べ、確認を閉じることもできる。/model で Fable を選んだときに閉じると現在のモデルのまま、セッションの途中なら、そのターンは既定のモデルで続く。続けると選ぶと、以降は出ない
• Remote Control 接続中・バックグラウンドセッション・エージェントチームのチームメイトのセッションは、端末の前に誰もいないことがあるので、途中の同意確認を dialogExpiry の期限（既定 5 分）まで保留する。期限までに答えがなければ、リクエストを送らずにターンを終え、記録に通知を足す（Remote Control のクライアントにも出る）。モデルの選択は変わらず、次のメッセージでまた同意を求める
• 確認を待っている間にできることは、セッションで違う。Remote Control 接続中かチームメイトのセッションでは、端末で任意のキーを押すと期限が取り消され、答えを待つ。バックグラウンドセッションでは期限までに答える。端末で誰も入力していないうちにリモートのクライアントから新しいメッセージを送ると、同じようにターンを終え、新しいメッセージが次のターンを始める。端末で誰かが入力した後は、答えを待ち続け、新しいメッセージはその後ろに並ぶ
• Agent SDK で別のアプリが動かすセッションは、確認を出すかをそのアプリが決める。出して、同じ dialogExpiry までに誰も答えなければ、リクエストを送らずにターンを終える
• -p の非対話モードと、確認を出さない Agent SDK のアプリでは、同意を求めず、使用クレジットに課金されるリクエストはそのまま課金される

モデルを設定する#

次の順に、上のほうが強く効きます。

1. セッション中：/model <別名|名前> で即座に切り替える。引数なしの /model でピッカーが開く。確認が出る場合はコンテキストとプロンプトキャッシュを参照
2. 起動時：claude --model <別名|名前>
3. 環境変数：ANTHROPIC_MODEL=<別名|名前>
4. 設定ファイル：model フィールド
5. 新しいセッションの既定：ANTHROPIC_DEFAULT_MODEL=<別名|名前>

claude --model opus

/model sonnet

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

/model ピッカーの操作#

/model は、選んだモデルをユーザー設定の model フィールドに書き、新しいセッションの既定として保存します。

• /model <名前> と直接打つのは Enter と同じ。このセッションだけにするには、/model でピッカーを開き、そのモデルの行で s を押す
• Enterprise プランで claude.ai アカウントでログインしているとき、/model で既定を保存すると、その選択がアカウントにも記録される（v2.1.280 以降）。管理者が組織の既定モデルを設定していなければ、Default の選択肢が記録されたモデルに解決されうる。モデル制限が記録されたモデルを除外するか、アカウントで使えないときは、何も記録されていないものとして解決される。Default や opusplan を選んでも、記録は変わらない
• /model での切り替えは、メイン会話のモデルを引き継ぐサブエージェントにも及ぶ。サブエージェントのモデルは、Claude が起動するときにセッションが使っているモデルから決まるため。カスタムサブエージェントを小さいモデルに保つには、定義の model を設定する。詳しくはサブエージェント
• -p の非対話モードの /model は、現在のセッションだけに効き、既定としては保存されない（この動きは 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 の Agent Platform・Microsoft Foundry のように、Anthropic のモデル ID ではなくプロバイダー固有のデプロイ ID を使うプロバイダーでは、記録のモデルは復元されず、通常の優先順位でモデルが決まる
• 新しい起動で --model か ANTHROPIC_MODEL を指定すると、復元されるモデルより優先される。v2.1.195 以降は ANTHROPIC_DEFAULT_OPUS_MODEL 系の変数も同じ。ANTHROPIC_DEFAULT_MODEL も、その節の条件のもとで優先されることがある
• 起動時のモデルが、自分の選択ではなくプロジェクトか管理設定から来ているときは、起動時のヘッダーにどの設定ファイルかが出る。/model で上書きできるが、次の起動でプロジェクトか管理設定が再適用される
• CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST を設定して Claude Code を組み込むプラットフォームでは、ホストのモデル構成が管理設定のモデル設定より優先される。管理設定の availableModels の許可リストは、ホストが独自のものを渡さない限り有効なまま
• PreModelSwitch フックは、要求された切り替えの前に動き、ブロックしたり確認を求めたりできる（フックのリファレンス）。組織の管理プラグインが配る PreModelSwitch フックが分からないとき（管理プラグインの読み込み失敗など）、Claude Code は検査せずに適用せず、切り替えを拒否して、新しい試行のたびに確かめ直す
• Agent SDK の setModel()、デスクトップアプリのようなアプリ、Remote Control でつないだデバイスから切り替えるとき、Claude Code は切り替えの時点で値を検査する。Agent SDK かアプリでは、v2.1.268 以降、ローカルで受け付けるモデル ID（カスタムモデルの選択肢など）を除き、そのセッションが初めてそのモデルに切り替えるときにプロバイダーへ確認する。確認はすべてのプロバイダーで走り、プロバイダーが提供しない ID は次のリクエストで失敗する代わりに、切り替えの時点で拒否される。Remote Control は、Anthropic API ではローカルで値を検査し、リクエストは送らない
• --model・ANTHROPIC_MODEL・model 設定で指定した値は、事前には検査されず、打ち間違えた値は最初のリクエストで「There's an issue with the selected model」になる。メッセージはエラー一覧を参照
• 要求したモデルに退役の予定日があるか、新しいバージョンに自動で置き換えられるときは、要求したモデルを名指しした警告が出る。対話セッションでは起動時の通知として出る。v2.1.182 以降は、既定のテキスト出力形式の非対話モードでは、同じ警告が stderr にも書かれる。サブエージェントの frontmatter の model も検査対象。--output-format json と stream-json では stderr の警告が抑えられるので、実際のモデルは結果メッセージの modelUsage フィールドで読む

新しいセッションの既定モデル（ANTHROPIC_DEFAULT_MODEL）#

ANTHROPIC_DEFAULT_MODEL=<別名|名前> で、セッションが既定で始まるモデルを選べます（v2.1.236 以降）。次のどれもモデルを選んでいないときだけ、新しいセッションがこの変数のモデルで始まります。

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

/model で保存した選択は、以降の起動でもこの変数に勝ちます。ANTHROPIC_MODEL を設定した場合は、/model で何を保存していても、次の起動でその変数のモデルに戻ります。Default の選択肢も、組織の既定モデルが当てはまらない限り、この変数のモデルに解決されます（そのとき /model ピッカーの Default の行に「Set by ANTHROPIC_DEFAULT_MODEL」と出る）。

次の場合、Claude Code は変数を無視し、Default は設定しなかったものとして解決されます。

• default・inherit・opusplan・haiku を設定した
• enforceAvailableModels がオン
• 組織のモデル制限がそのモデルを除外する
• そのモデルがアカウントで使えない

新しいセッションがこの変数のモデルで始まるはずのとき、claude --resume・--continue・/resume で再開したセッションもそのモデルで始まり、記録に保存されたモデルは復元されません。それ以外では、再開のときにこの変数は使われません。

選んだのと別のモデルで新しいセッションが始まるとき#

/model で選んだのに次のセッションが別のモデルで始まる、よくある原因は次のとおりです。

• 1 セッションだけで選んだ：ピッカーで s、--model で起動、非対話モードの /model は、現在のセッションだけに効き、保存された既定は変わらない
• 優先度の高いものがモデルを決めている：プロジェクトか管理設定の model 値、シェルの ANTHROPIC_MODEL、ユーザーの選択を上書きするよう管理者が設定した組織の既定は、起動のたびに再適用される。/model の選択は保存されたまま、優先度で負けている。プロジェクトか管理設定がモデルを決めているときは、起動時のヘッダーにファイル名が出る
• Claude Code が選択を保存できなかった：/model は ~/.claude/settings.json に model を書く。別のツールが生成しているか読み取り専用のコピーへのリンクで書けないと、選んだモデルはそのセッションだけで、次の起動は古い値を読む。ファイルを生成するツールで model を設定するか、書き込めるようにする。設定ファイルの仕組みも参照
• セッションを再開した：claude --resume か --continue で再開したセッションは、通常、現在の既定ではなく、使っていたモデルを保つ

現在のモデルの確認#

• ステータスラインを設定していれば、そこに出る（ステータスライン）
• /status に出る。アカウント情報も一緒に出る

effort（思考の深さ）#

effort は、適応的な推論（adaptive reasoning）を制御します。タスクの複雑さに応じて、各ステップで考えるかどうか・どれだけ考えるかをモデルが決めます。低い effort は単純なタスクで速く安く、高い effort は複雑な問題でより深く推論します。使える段階はモデルで違い、一覧にないモデルは effort に対応しません。

使っているモデルが対応しない段階を設定すると、設定した段階以下で、対応する最も高い段階に落ちます（Opus 4.6 では xhigh が high で動く）。組織や自分の設定が、モデルが出す段階に上限を設けることもあります（後述の「組織の effort 上限」）。

セッションの 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 には数えられない。このキーは、モデルごとに段階を保存する前に /effort が書いた古い形で、以前と同じ範囲（Opus 5・Fable 5.1・それ以前のモデル）では効き続ける。Opus 5.5 とそれ以降のモデルは、/effort か /model ピッカーで段階を選ぶまで、そのモデル自身の既定で始まる。プロジェクト・ローカル・管理設定、または --settings で渡したトップレベルの effortLevel は、すべてのモデルに効く
• 対話セッションで low・medium・high・xhigh を設定するとき、確定のしかたで続く期間が決まる。/effort のスライダーか /model ピッカーで Enter、または /effort の後ろに段階を打つと、既定として保存され、以降のセッションに適用される。スライダーかピッカーで s を押すと、このセッションだけに適用される（v2.1.257 以降）
• 段階はモデルごとに、ユーザー設定の modelSettings キーに保存され、各モデルが自分の段階を持つ
• max は最も深い推論の段階。CLAUDE_CODE_EFFORT_LEVEL 環境変数で設定しない限り、現在のセッションにだけ適用される
• Remote Control でつないだ電話やブラウザの effort の操作で選んだ段階は、そのセッションだけに効く
• -p の実行で /effort で設定した段階は、そのセッションだけに適用され、既定としては保存されない

段階の選び方#

• Opus 5.5 と Fable 5.1 での試験では、高い段階の Claude はエッジケースを多く試し、答える前により多くの作業を検証した。判断も多く自分で下した。低い段階の Claude は出発点を早く返し、結果を毎回レビューして次の一手を導く作業に合う
• effort の目盛りはモデルごとに調整されているので、同じ段階名が、モデルをまたいで同じ値を表すわけではない
• Opus 5.5 の既定は medium で、Opus 5 の既定 high より 1 段低い。Anthropic の試験では、medium の Opus 5.5 は、コーディングと知識労働の評価で、high の Opus 5 に並ぶか上回る。同じ段階では、Opus 5.5 のほうが 1 ターンあたりによく考える傾向がある。Opus 5 から Opus 5.5 に移るときは、Opus 5 で使った段階を持ち越さず、medium から始める

ultrathink で 1 回だけ深く考えさせる#

プロンプトのどこかに ultrathink と書くと、セッションの effort 設定を変えずに、そのターンだけ深い推論を求められます。Claude Code がキーワードを認識し、コンテキストに指示を足します。API に送る effort の段階は変わりません。「think」「think hard」「think more」のようなほかの語句は、ふつうのプロンプトの文として渡され、キーワードとしては認識されません。

effort の設定方法#

• frontmatter の effort は、そのスキルかサブエージェントが動いている間、セッションの段階を上書きするが、環境変数は上書きしない。maxEffortLevel と組織の effort 上限は、スキルやサブエージェントが動く段階を引き続き制限する
• 管理設定に effortLevel を設定すると、effort の優先順位の設定の段で適用され、ユーザーは /effort と --effort で変えられる。ユーザーを特定の段階以下に保つには maxEffortLevel を設定する
• 対応するモデルを選んでいると、effort のスライダーが /model に出る。現在の effort は、セッションのヘッダーのモデル名の横にも「with low effort」のように出て、起動時と変更時にはフッターにも短く出る
• キャッシュへの影響はコンテキストとプロンプトキャッシュを参照

ultracode#

/effort のスライダーには「Ultracode」のトグルがあります。Ultracode はモデルの effort の段階ではなく Claude Code の設定です。オンにすると、重要なタスクで Claude がワークフローを組み立て、セッションが動いている effort の段階のまま動きます。永続的に設定できる場所は ultracode 設定にあります。

• /effort か ultracode 設定で ultracode をオン・オフしても、effort の段階は変わらない。--effort ultracode フラグと Agent SDK の effortLevel: "ultracode" の値は、オンにして、段階も xhigh にする。/effort のスライダーか /model ピッカーで段階を選んでも、ultracode はそのまま
• /effort ultracode で現在のセッションだけオン、/effort ultracode off でオフ。スライダーでは Tab で「Ultracode」のトグルを切り替え、Enter で適用する
• claude --effort ultracode は、xhigh の effort で ultracode をオンにして始める
• 設定ファイル・--settings・Agent SDK の制御リクエストで "ultracode": true を設定する。applyFlagSettings() のリクエストは effortLevel: "ultracode" も受け付け、オンにして段階を xhigh にする
• /effort ultracode off・スライダーのトグル・xhigh 以外の段階で ultracode をオンのままにすること・effort の上限が xhigh を下回っても使えること、は v2.1.284 以降が必要。v2.1.284 より前は、ultracode をオンにすると xhigh になり、別の段階を選ぶとオフになり、xhigh を下回る上限があると使えなかった
• --effort フラグと Agent SDK の effortLevel に ultracode を渡すには v2.1.203 以降が必要。それより前は Unknown --effort value 'ultracode' と出て、既定の effort で始まった
• 保存される effortLevel 設定と CLAUDE_CODE_EFFORT_LEVEL 環境変数は ultracode を受け付けない。CLAUDE_CODE_EFFORT_LEVEL か effort の上限がセッションの段階を決めているときは、ultracode はその段階のまま保たれる
• ワークフローがオフのとき、またはモデルが xhigh に対応しないときは使えない。そのときの --effort ultracode は、ultracode をオフにし、モデルと上限が許す最も高い段階（xhigh まで）で始まる

適応的な推論と固定の思考バジェット#

適応的な推論は、各ステップで考えるかどうかを任意にし、Claude が定型のプロンプトに速く答え、深い思考が効くステップに取っておけるようにします。現在の段階が出すより多く・少なく考えさせたいなら、プロンプトか CLAUDE.md でそう伝えます。モデルは effort の設定の範囲でその指示に従います。

• Fable 系・Sonnet 5 以降・Opus 4.7 以降は、常に適応的な推論を使う。固定の思考バジェットのモードと CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING はこれらに適用されない
• Opus 4.6 と Sonnet 4.6 では、CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 を設定すると、MAX_THINKING_TOKENS で制御する以前の固定の思考バジェットに戻せる

拡張思考（extended thinking）#

拡張思考は、Claude が応答の前に出す推論です。適応的な推論に対応するモデルでは、考える量の主な制御は effort の段階で、下の設定は、思考のオン・オフと表示の制御です。Anthropic API で思考をオフにしたとき、Claude Code は、その組み合わせを受け付けないと分かっているモデル（Opus 5 など）には、より高い段階の代わりに effort high を送ります。

• Opus 5.5・Sonnet 5.5・Fable 系のモデルでは、思考をオフにできない。セッションの切り替えと /config の行は、スイッチを出す代わりに Thinking can't be turned off と出し、保存された alwaysThinkingEnabled: false と MAX_THINKING_TOKENS=0 は効かない。これらのモデルでは、effort の段階に基づいてステップごとに考える量をモデルが決める。保存した設定は、それを受け付けるモデルに切り替えると再び効く
• Claude Code は、既定で思考の出力を折りたたむ。Ctrl+O で詳細モードを切り替えると、推論が灰色の斜体で見える。Anthropic API の対話セッションは、既定で伏せられた（redacted）思考ブロックを受け取るので、展開したときに完全な要約を使えるようにするには、設定で showThinkingSummaries: true を設定する
• 折りたたまれていても伏せられていても、生成された思考トークンはすべて課金される

コンテキストの大きさ#

Fable 5.1・Fable 5・Sonnet 5 以降・Opus 4.6 以降・Sonnet 4.6 は、大きなコードベースの長いセッション向けの 100 万トークンのコンテキストウィンドウに対応します。

• Anthropic API では、Fable 5.1・Fable 5・Sonnet 5 以降・Opus 4.7 以降が、Pro を含むすべてのプランで 1M のウィンドウで動く。これらのモデルでは [1m] 版を選ぶことも使用クレジットをオンにすることも要らない（Fable の利用自体は、プランによっては使用クレジットに課金される）
• Opus 4.6 と Sonnet 4.6 は、[1m] 版でだけ 1M に届き、その利用可否はプランで決まる

• Team の Standard 席と Premium 席を含め、Max・Team・Enterprise の各プランでは、1M コンテキストの Opus 4.6 がサブスクリプションに含まれる。Sonnet 4.6 の 1M は、Max を含むすべてのサブスクリプションで使用クレジットが必要
• Claude Code がこのプランの要件を検査するのは、Anthropic API に直接つなぐときだけ。ANTHROPIC_BASE_URL を LLM ゲートウェイに向け、保存済みの claude.ai のログインが有効な認証情報のままなら、使用クレジットは検査されない。[1m] の選択肢は /model に残り、リクエストが成功するかはゲートウェイが決める。v2.1.229 より前は、その構成でアカウントの使用クレジットを確認できないと /model sonnet[1m] が拒否された
• ANTHROPIC_BASE_URL を LLM ゲートウェイなどのプロキシに向けると、Claude Code は、認識するモデルそれぞれに、Anthropic API と同じコンテキストウィンドウを与える。Fable 5.1・Fable 5・Sonnet 5 以降・Opus 4.7 以降は 1M で、選ぶ [1m] 版はない。[1m] 版でだけ 1M に届くモデル（Opus 4.6 など）は、それなしでは 200K で動く。ゲートウェイやその後ろのサーバーが強制するより低い上限は、Claude Code に検出できない。ゲートウェイが 200K トークンを超えるリクエストを拒否するなら、Claude Code を起動する環境に CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 を設定し、すべてのモデルのセッションがその境界で圧縮されるようにする
• 1M コンテキストをオフにするには CLAUDE_CODE_DISABLE_1M_CONTEXT=1。Claude Code はモデルピッカーから 1M のモデル版を取り除く。Sonnet 5 や Fable 系のように最初から 1M のウィンドウを持つモデルでは、200K のコンテキストウィンドウとして扱う。自動圧縮がオンなら 200K の境界で圧縮し（自動圧縮のウィンドウを 200K より大きく設定しても保留は解けない。モデルのコンテキストウィンドウで上限が切られるため）、オフなら圧縮せず 200K の境界でコンテキスト上限のエラーで止まる。v2.1.223 より前は、Sonnet 5・Opus 4.8・Opus 5 のセッションだけを 200K に留めた
• 1M のウィンドウは標準のモデル料金で、200K を超えるトークンの割増はない。拡張コンテキストがサブスクリプションに含まれるプランでは、利用は引き続きサブスクリプションの範囲。使用クレジットで拡張コンテキストを使うプランでは、トークンが使用クレジットに課金される
• アカウントが 1M コンテキストに対応していれば、最新の Claude Code では /model ピッカーにその選択肢が出る。出なければ、セッションを再起動する。サードパーティプロバイダーでは、デプロイが ANTHROPIC_DEFAULT_*_MODEL 変数でモデルを固定していないかを確かめる

[1m] の接尾辞は、別名にも完全なモデル名にも付けられます。

# opus[1m] か sonnet[1m] の別名を使う
/model opus[1m]
/model sonnet[1m]

# または完全なモデル名に [1m] を付ける
/model claude-opus-4-8[1m]

Sonnet 5.5 と Sonnet 5 のコンテキストウィンドウ#

Anthropic API では、Sonnet 5.5 と Sonnet 5 は常に 1M のコンテキストウィンドウで動きます。200K 版も [1m] の接尾辞もなく、どのプランでも使用クレジットは要りません。ウィンドウが埋まる前、既定では約 967K トークンで自動圧縮されます。別のしきい値にするには CLAUDE_CODE_AUTO_COMPACT_WINDOW を設定します。LLM ゲートウェイや独自の ANTHROPIC_BASE_URL の後ろでも、同じ 1M のウィンドウが与えられます。ウィンドウを 200K にするには、CLAUDE_CODE_DISABLE_1M_CONTEXT=1 を使います（最初から 1M のウィンドウを持つすべてのモデルのセッションを 200K に保つ。コンテキストを制限したいデプロイ向け）。

自動圧縮のウィンドウ#

自動圧縮のウィンドウは、Claude Code が会話を圧縮するまでに、コンテキストウィンドウがどこまで埋まってよいかです。圧縮で何が残るかはコンテキストとプロンプトキャッシュを参照してください。

設定の場所#

• コマンドとフラグは 100K〜1M トークンのウィンドウサイズを受け付ける。200000 のようなトークン数、500k や 1M のように k か M を付けた形、100〜1000 の数字だけ（千単位として扱い、200 は 200,000）
• 環境変数はトークン数の数字だけを受け付ける。ウィンドウは、モデルのコンテキストウィンドウで上限が切られる

既定のしきい値#

自動圧縮のウィンドウを設定しなければ、会話がモデルのコンテキスト上限に達したときに圧縮されます。次の例外があります。

• クラウドセッションは、会話がモデルの上限に近づくと圧縮される
• 拡張コンテキストなしの Sonnet 4.6 と Opus 4.6 は 200K の境界で圧縮される。Amazon Bedrock・Google Cloud の Agent Platform・Microsoft Foundry のように 200K のコンテキストウィンドウで動く Opus 4.8 以降も同じ
• CLAUDE_CODE_DISABLE_1M_CONTEXT=1 を設定すると、Sonnet 5 や Fable 系のように最初から 1M のウィンドウを持つモデルが 200K の境界で圧縮される
• 最初から 1M のウィンドウで動くモデルは、ウィンドウが埋まる前、既定では約 967K トークンで圧縮される。Anthropic API では、Sonnet 5・Fable 系・Opus 4.7 以降が当てはまる。Amazon Bedrock・Google Cloud の Agent Platform・Microsoft Foundry で、どのモデルがそのウィンドウで動くかは、後述の「サードパーティのデプロイでモデルを固定する」にある。独自の ANTHROPIC_BASE_URL の後ろでは、上のコンテキストの大きさの節にある
• LLM ゲートウェイの別名のように、Claude Code が認識しないモデル ID のセッションは、その ID に Claude Code が想定するコンテキストウィンドウで圧縮される

ゲートウェイや独自のモデル ID のウィンドウを補正する#

LLM ゲートウェイなどの独自のデプロイでは、Claude Code が、モデル ID に想定するコンテキストウィンドウが、モデルの実際のウィンドウと違うことがあります。そのときは CLAUDE_CODE_MAX_CONTEXT_TOKENS を、Claude Code に想定させたいウィンドウにします。この変数の効き方は ID で違います。

• Claude Code が、claude- で始まらない（大文字小文字を問わず）、または Google Cloud の Agent Platform の @YYYYMMDD の日付のように、ID を読むときに取り除く接尾辞を持つ ID を、プロバイダーか独自の綴りとして扱う。v2.1.259 より前は、取り除く接尾辞を数えず、日付の接尾辞が付いた未認識の claude- の ID が、接尾辞なしの素の claude- の名前として扱われた
• プロバイダーか独自の綴りを認識するモデルに解決できず、ID に [1m] を含まない：変数が直接適用され、先回りの圧縮は宣言したウィンドウで続く
• プロバイダーか独自の綴りを認識するモデルに解決できず、ID に [1m]（大文字小文字を問わず）を含む：Claude Code はそれに 1M のウィンドウを想定し、変数は単独では適用されない。先回りの圧縮を保ったままウィンドウを補正するには、CLAUDE_CODE_DISABLE_1M_CONTEXT=1 も設定する。その変数があると、Claude Code は ID を [1m] なしの同じ綴りと同様に扱うので、CLAUDE_CODE_MAX_CONTEXT_TOKENS は、その [1m] なしの綴りに適用されるときに適用される。宣言したウィンドウが 200K を超えるときは、200K の上限が強制されないという起動時の警告が出る。この構成では、警告は想定どおり
• ID が認識するモデルに解決される、または接尾辞を取り除くものがない素の claude- の名前（大文字小文字を問わず）：変数が効くのは、すべての圧縮を無効にする DISABLE_COMPACT も設定したときだけ。たとえば anthropic/claude-opus-4-8・us.anthropic.claude-…-v1:0・日付付きの claude-sonnet-4-5@20250929 のように、Claude Code が知る Claude のモデル名を含む ID は、そのモデルに解決される。[1m] も含む ID も同じで、claude-opus-4-8[1m] は CLAUDE_CODE_DISABLE_1M_CONTEXT を設定していても Opus 4.8 に解決される

Claude Code が認識しないモデル ID では、CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 を設定すると、API が、Claude Code が認識する長すぎるエラーで会話を拒んだ後でだけ圧縮します。ゲートウェイが、Claude Code が認識しない文言にエラーを書き換えると、その回復は動きません。

特別なモデルの動き#

default モデル設定#

default の動きは、アカウントの種類で決まります。

• v2.1.280 より前は、default は Pro と Team Standard で Sonnet 5 に、Max・Team Premium・Enterprise・Anthropic API・Claude Platform on AWS・Amazon Bedrock・Google Cloud の Agent Platform で（v2.1.219 以降）Opus 5 に解決された。v2.1.219 より前は、Anthropic API・Max・Team Premium・Enterprise の従量課金で v2.1.154 以降、Claude Platform on AWS・Amazon Bedrock・Google Cloud の Agent Platform で v2.1.207 以降、Opus 4.8 に解決された。v2.1.207 より前は、Claude Platform on AWS で Opus 4.7、Amazon Bedrock と Google Cloud の Agent Platform で Sonnet 4.5 に解決された
• 管理者が組織の既定モデルを設定していると、default は上のアカウントの種類の既定の代わりにそのモデルに解決される（v2.1.196 以降）。ANTHROPIC_DEFAULT_MODEL で設定したモデル（その節の条件のもとで）や、アカウントに記録されたモデルに解決されることもある
• アカウントに何も記録されておらず、管理設定が Default モデルに許可リストを強制し、アカウントの種類の既定が availableModels にないときは、default はアカウントの種類の既定ではなく、強制された Default に解決される。組織の既定と強制の両方が当てはまるときは、組織の既定が先にアカウントの種類の既定を置き換え、その後に強制が適用される。許可リストにある組織の既定は保たれ、リスト外のものは強制された Default に解決される
• Fable 系のモデルは、どのプランでもどのプロバイダーでも、アカウントの種類の既定ではない。/model で選ぶとユーザー設定に選んだモデルとして保存され、以降のセッションがそれで始まる

opusplan モデル設定#

opusplan は、自動の混成の方式です。

• プランモード：複雑な推論とアーキテクチャの判断に opus を使う
• 実行モード：コード生成と実装には、自動で sonnet に切り替える

Opus の推論による計画と、Sonnet の効率による実行を組み合わせます。

• プランモードの Opus の段階は opus のモデル設定と同じコンテキストウィンドウを使い、実行の段階は sonnet と同じウィンドウを使う。opus と sonnet が、現在のモデルのように最初から 1M のコンテキストウィンドウで動くモデルに解決されるとき（Anthropic API など）は、両方の段階がそれで動く。そうでない場合に両方の段階で 1M を要求するには、モデルを opusplan[1m]（/model opusplan[1m] など）に設定する。/model で設定するには v2.1.265 以降が必要で、それより前は --model フラグか model 設定を使う
• availableModels が最新の Opus を除き古いバージョンを許可しているとき（["sonnet", "claude-opus-4-6"] など）、opusplan は計画に許可された最新の Opus を使い、すべての Opus が除かれたときだけ Sonnet に留まる。通常はプランモードで Sonnet にアップグレードする Haiku のセッションも、許可された最新の Sonnet を使い、すべての Sonnet が除かれたときだけ Haiku に留まる。v2.1.205 より前は、アップグレード先の系統の最新が除かれていると、古いバージョンが許可されていても、プランモードはセッションのモデルに留まった
• 古い許可済みバージョンへの置き換えは、Anthropic API と Claude Platform on AWS で適用される。プロバイダー固有のモデル ID を使う Amazon Bedrock・Google Cloud の Agent Platform・Microsoft Foundry・Mantle では、アップグレード先のモデルが除かれていると、プランモードはセッションのモデルに留まる
• プランの境界ではなく、作業の途中で別のモデルに相談するかを Claude が決める混成の方式は、後述の advisor にある

フォールバックモデルの連鎖#

主モデルが過負荷・利用不可、または再試行できないサーバーエラーを返したとき、Claude Code は、リクエストを失敗させる代わりに、フォールバックのモデルに切り替えられます。認証・課金・レート制限・リクエストサイズ・通信のエラーと、組織のポリシー検査による拒否は切り替えを起こさず、通常の再試行とエラー処理になります。Amazon Bedrock か Google Cloud の Agent Platform が、アカウントが呼べないモデルを拒むとき（途中でモデルが無効になった場合）は、認証エラーではなくモデルが使えないものとして扱い、切り替えます。

• フォールバックのモデルを 1 つ以上設定すると、Claude Code は順に試し、切り替えるとき通知を出す。切り替えは現在のターンだけで、次のメッセージはまた主モデルから試す。連鎖は、重複を除いて 3 モデルまで。余分な項目は無視される
• 1 セッションだけの連鎖は、カンマ区切りの一覧を受け付ける --fallback-model フラグで設定する
• 連鎖をセッションをまたいで残すには、fallbackModel を配列で設定する。--fallback-model フラグは fallbackModel 設定より優先される。各項目はモデル名か別名を受け付け、"default" は既定のモデルに展開される
• Claude Code は、起動時に連鎖を確認せず、/status にも出さない。切り替えのときに出る通知が、フォールバックが設定されていると分かる最初の手がかり
• リクエストが切り替わるとき、Claude Code は受け付ける項目が出るまで順に試す。設定に固定した退役済みのモデルなど、到達できない項目も、同じように次へ切り替わる
• 試す前に Claude Code が取り除く項目は 2 種類：availableModels が許可しない項目（連鎖を読むときに落とす）と、圧縮中の、主モデルより小さいコンテキストウィンドウのモデル（連鎖は圧縮も対象にするが、そこで要約すると会話の一部が先に切れるため）。すべてのフォールバックが小さければ、圧縮は元のエラーを示し、再試行できる
• 連鎖はサブエージェントにも適用される。サブエージェントのリクエストが切り替わると、設定したフォールバックのモデルを順に試し、サブエージェントはリクエストを受け付けたモデルで続ける。セッションのモデルは変わらない。v2.1.247 より前は、連鎖が対象にする失敗でサブエージェントが終わった

claude --fallback-model sonnet,haiku

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

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

過負荷や利用不可による切り替えとは別に、内容に基づくフォールバックがあります。対象は Fable 系のモデル・Opus 5.5・Sonnet 5.5・Opus 5 です。これらはセーフティ分類器で動き、多くはサイバーセキュリティと生物学の内容にフラグを立てます。分類器がリクエストにフラグを立て、そのカテゴリにフォールバックのモデルがあるとき、Claude Code はそのモデルでリクエストをやり直し、記録に通知を出します。この 2 つのカテゴリで、フォールバック先は、断ったモデルで決まります。

• フォールバックの後は、セッションがフォールバック先のモデルで続く。元のモデルに戻るには /model を実行する
• カテゴリに基づくフォールバックは v2.1.219 以降が必要。それより前は、フラグが立った Fable 5 のリクエストはすべて、プロバイダーの既定の Opus モデルでやり直され、Opus 5 はフォールバックの元にならなかった
• フォールバック先は availableModels で検査される。ブロックされていればフォールバックは起きず、拒否は通常のエラーとして示され、セッションのモデルは変わらない
• Amazon Bedrock・Google Cloud の Agent Platform・Microsoft Foundry では、これらのフォールバック先がデプロイのモデル ID で解決される。関わるモデルのすべてを 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 を含むすべての元のモデルでフォールバックがオフになり、フラグが立ったリクエストは拒否で終わる）。フラグが立ったカテゴリのフォールバック先も解決できる必要がある
• どちらのモデルも特定できなければ、Claude Code は切り替えず、フラグが立ったリクエストは拒否のメッセージで終わる。/model で切り替えて再試行できる。両方を特定できるようにするには、元のモデルの固定を設定する：Fable 系は 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 自身を指す固定は、拒否のままにする）
• ANTHROPIC_DEFAULT_OPUS_MODEL を設定していると、Fable 系・Opus 5.5・Opus 5 からフラグが立ったリクエストは、フォールバックのあるすべてのカテゴリで、そのモデルでやり直される（Opus 5 の生物学のフラグは拒否のまま）。設定していなければ、サイバーセキュリティのフラグは Opus 4.8 の項目で、Fable 系か Opus 5.5 の生物学のフラグは Opus 5 の項目でやり直される。Sonnet 5.5 のサイバーセキュリティのフラグは、ANTHROPIC_DEFAULT_SONNET_MODEL に設定したモデル、設定していなければプロバイダーのモデル一覧の Sonnet 5 の項目でやり直される

フォールバックは、セッションの最初のリクエストで起きることがあります。最初のリクエストには、CLAUDE.md の内容や git status のようなワークスペースの文脈が載るためで、セキュリティや生物学の資料を含むリポジトリは、その文脈だけで分類器に引っかかりえます。カスタマイズが原因かを確かめるには、CLAUDE.md・スキル・MCP サーバー・フックなどのカスタマイズを無効にする claude --safe-mode でセッションを始めます（git status とディレクトリ名はカスタマイズではないので含まれたまま）。

毎回自動で切り替えず、リクエストにフラグが立つたびに決めたいなら、/config で「Switch models when a message is flagged」をオフにするか、設定ファイルで switchModelsOnFlag を false にします。フラグが立ったリクエストは、フォールバックのモデルに切り替えるか、プロンプトを編集して現在のモデルで再試行するかの 2 つの選択肢を出して、セッションを止めます。挙動が違う場合があります。

• フラグが立ったカテゴリにフォールバックのモデルがないとき（Opus 5 や Sonnet 5.5 の生物学のフラグなど）は、確認を出さず、リクエストは拒否で終わる
• 両方のモデルが同じリクエストにフラグを立てたときは、プロンプトを編集して再試行するか、新しいセッションを始める
• モバイルアプリのクラウドセッションでは、編集して再試行はサポートされない。モデルを切り替えるか、デスクトップのブラウザかデスクトップアプリでセッションを続ける
• 確認を出せない非対話モードと SDK の統合では、フラグが立ったリクエストは拒否でターンが終わる
• フォールバック先が availableModels にブロックされているときも確認を出さず、フラグが立ったリクエストは、自動フォールバックでフォールバック先がブロックされている場合と同じく、拒否で終わる

フォールバック後の effort#

Claude Code がセッションをフォールバックのモデルに切り替えるとき、そのモデルの既定の effort の代わりに、フラグが立ったリクエストが動いていた effort を引き継ぎます。たとえば、既定の medium で動く Opus 5.5 のセッションが Opus 4.8（既定は high）にフォールバックしても、medium のままです。

次のようなときは、別の段階が適用されます。

• 設定か組織の既定：フォールバックのモデルに当たる設定の段階、または組織がそのモデルに設定した既定の effort が、代わりに適用される
• 自分の変更：effort の段階を選ぶ、/model でモデルを選ぶ、またはあとでセッションを再開すると、フラグが立ったリクエストの段階はもう引き継がれない
• スキルの effort：スキルの effort フロントマターがフラグが立ったリクエストに設定した段階は、そのターンに適用され、以降のターンは、effort の決まる順がフォールバックのモデルに与える段階で動く

セッションのヘッダーが、モデル名の隣に有効な段階を出します。変えるには、セッションで /effort を実行します。

fast mode#

fast mode は、Claude Opus の高速な構成で、モデルをトークンあたりの費用を上げて最大 2.5 倍速くします。研究プレビュー（research preview）の機能で、機能・料金・提供は、フィードバックで変わることがあります。別のモデルではなく、速度をコスト効率より優先する別の API 構成を使う Claude Opus で、品質と能力は同じで応答が速くなります。反復の速い作業やライブのデバッグで速さが要るときにオンにし、遅延よりコストが大事なときはオフにします。

• 対応するのは Opus 5.5・Opus 5・Opus 4.8。Sonnet・Haiku・ほかのモデルでは使えない。Opus 4.7 は対応せず、切り替えると fast mode がオフになる（Opus 4.7 の fast mode は 2026-06-25 に非推奨になり、2026-07-24 に削除された）
• 入出力 100 万トークンあたりの fast mode の料金は、Opus 5.5 が $8/$40、Opus 5 と Opus 4.8 が $10/$50。1M トークンのコンテキストウィンドウの全体で一律
• サブスクリプションプラン（Pro・Max・Team・Enterprise）と Claude Console で使える。Team と Enterprise は、先にオーナーが有効にし、Console の組織はアクセスの提供が必要。サブスクリプションプランでは、使用クレジットだけで使え、サブスクリプションのレート制限には含まれない
• fast mode は、CLI では /fast、VS Code 拡張では、選んだモデルが対応するとき「Toggle fast mode」のコマンドで切り替える。切り替えは fastMode 設定に保存される
• Opus 5.5 は、Claude Code v2.1.280 以降の fast mode の既定。v2.1.280 より前は、v2.1.219 から Opus 5、v2.1.154〜v2.1.218 は Opus 4.8、v2.1.142〜v2.1.153 は Opus 4.7 が既定だった

切り替え方#

CLI では次のどちらかで切り替えます。

• /fast を実行し、Space でオン・オフを切り替え、Enter で確定する

• ユーザー設定ファイルに "fastMode": true を設定する

• 対話セッションでオンにした fast mode は、既定ではセッションをまたいで残る。セッションごとにリセットするようにもできる（後述の「セッションごとのオプトイン」）

• クラウドセッション以外で、-p の非対話モードの /fast は、--settings に fast mode を渡して起動したセッションでだけ働く（例：claude -p --settings '{"fastMode": true}'）。切り替えはそのセッションだけに適用され、既定としては保存されない。-p の形は v2.1.205 以降が必要。非対話モードのほかの場所では、fast mode は使えないと報告される

• Claude の作業中にも /fast を実行でき、Claude Code はターンの終了を待たずに切り替える。実行中のターンは元の速度で終わり、速度の変更は次のターンから効く。現在のモデルが fast mode に対応しないときは、オンにするとモデルも切り替わり、そのターンの次のリクエストから新しいモデルを使う

• コスト効率のため、会話の途中で切り替えるのではなく、セッションの最初に有効にする（コストのしくみは後述）

• オンにすると：現在のモデルが fast mode に対応しなければ Opus に切り替わる。「Fast mode ON」の確認が出る。fast mode の間、プロンプトの横に小さな ↯ のアイコンが出る。/fast をもう一度実行すると、いつでもオンかオフかを確認できる

• /fast でオフにしても Opus のまま。別のモデルにするには /model を使う

• クラウドセッション：アカウントで使えるとき、Anthropic が管理するインフラでもセルフホストのランナーでも、fast mode はクラウド（Web）のセッションで動く（セッションの環境で v2.1.271 以降が必要）。セッションで /fast on と打つとオンになり、そのセッションだけで、既定としては保存されない。claude.ai/code では、メッセージ欄のモデルのメニューからも切り替えられる（プランが fast mode を含み、選んだモデルが対応するときに表示）

fast mode を使っているときのモデルの切り替え#

fast mode は、モデルの切り替えに双方向で従います。

• 切り替えて離れる：fast mode に対応しないモデルに切り替えると、Claude Code は fast mode をオフにする。Opus 4.7 も含む（v2.1.221 より前は、Opus 4.7 に切り替えても fast mode がオンのままで、API がリクエストを拒否した）
• 戻る：対応する Opus に戻すと、保存した fast mode の設定がオンなら、fast mode が再びオンになる。モデルの切り替えが、保存した設定がオフのセッションの fast mode をオンにすることはない。セッションごとのオプトインを設定していると、戻っても自動ではオンにならず、/fast で有効にし直す
• モデルの切り替えで fast mode がオン・オフになるたびに「Fast mode ON」か「Fast mode OFF」の確認が出て、オンの間は ↯ のアイコンが出る。/model・/config model=<モデル>・Remote Control でつないだデバイスのどれで切り替えても同じ
• Claude Code は、モデルの切り替え・再接続・失敗した提供の確認の後に、セッションの fast mode の状態を、Remote Control でつないだデバイスへ送り直す

コストの考え方#

• 会話で初めて fast mode をオンにしたとき、会話のコンテキスト全体に、fast mode の未キャッシュの入力トークンの全額を払う。会話の深いところほど高くなるので、最初からオンにするほうが安い。コストは会話ごとに 1 回で、オフにして後でまたオンにしても繰り返されない。しくみはコンテキストとプロンプトキャッシュにある
• fast mode の支出が出る場所は、サインインの方法で違う。まず /status を実行し、Login method の行（Claude Max account など）があれば Claude サブスクリプション、API key の行なら Claude Console の組織に課金される

いつ使うか#

fast mode は、応答の遅延がコストより大事な対話的な作業に向きます。

• コード変更の素早い反復
• ライブのデバッグ
• 期限が厳しい作業

標準モードのほうが向くのは、速さがあまり要らない長い自律タスク、バッチ処理や CI/CD のパイプライン、コストに敏感な作業です。

要件#

fast mode には次のすべてが必要です。

• Anthropic API かサブスクリプションだけ：Anthropic Console の API と、使用クレジットを使う Claude サブスクリプションプランで使える。Amazon Bedrock・Google Cloud の Agent Platform・Microsoft Foundry・Claude Platform on AWS では使えない。Console の組織は、fast mode のアクセスの提供も必要
• サブスクリプションプランで使用クレジットをオンにする：Pro・Max・Team・Enterprise では、プランに含まれる利用を超えて課金できる使用クレジットをオンにする必要がある。オンになるまで /fast は「Fast mode requires usage credits」と報告する。Pro と Max は、claude.ai の「Settings > Usage」の「Usage credits」でオンにするか、/usage-credits で開く。Team と Enterprise は、課金へのアクセスを持つメンバーが「Organization settings > Usage」で組織向けにオンにし、持たないメンバーは /usage-credits で組織の管理者に依頼を送る。fast mode の利用は、プランに残りがあっても、使用クレジットから直接引かれる
• 有料の Console の組織：Claude Console のアカウントは使用クレジットを使わず、組織がほかの API の利用と一緒にトークンごとに fast mode を払う。Console の無料の Evaluation プランでは、/fast が「Fast mode unavailable during evaluation. Please purchase credits.」と出る。解消するには、Console の課金設定でクレジットを購入する
• Team と Enterprise はオーナーの有効化：Team と Enterprise の組織では、fast mode は既定で無効。ユーザーが使えるようになる前に、オーナーが明示的に有効にする必要がある

組織の 4 つの設定が、/fast で fast mode をオンにするのを止めることがあります。

組織で fast mode を有効にする#

• Console（API の顧客）：管理者が Claude Code preferences で有効にする。fast mode は研究プレビューなので、fast mode のリクエストが成功する前に、組織が fast mode へのアクセスの提供も受ける必要がある。アクセスを得るには、アカウント担当に連絡するかウェイトリストに入る。提供されていないと、API は fast mode のリクエストごとに 429 で拒否し、Claude Code は拒否ごとを fast mode のレート制限として扱う。レート制限のクールダウンと違い、拒否はアクセスが提供されるまで続く
• Claude AI（Team と Enterprise）：オーナーが管理設定の「Organization settings > Claude Code」で有効にする
• fast mode を完全に無効にするもう 1 つの方法は CLAUDE_CODE_DISABLE_FAST_MODE=1 を設定すること（環境変数一覧）

プロキシと LLM ゲートウェイの後ろで使う#

fast mode を出す前に、Claude Code は、api.anthropic.com への直接のリクエストで、組織の fast mode の可否を確かめます。この確認は ANTHROPIC_BASE_URL に従わないので、Claude の通信を LLM ゲートウェイ経由にして api.anthropic.com への直接の外向き通信を塞ぐネットワークでは、推論リクエストが動いていても確認が失敗します。確認は設定済みの HTTP プロキシを使うので、プロキシ越しにも api.anthropic.com に届かない場合にだけ、ネットワークの遮断で失敗します。

• 確認が失敗すると、/fast は「Fast mode unavailable due to network connectivity issues」と報告し、組織で fast mode が有効でも、リクエストは標準速度で動く。過去に成功した確認はキャッシュされた結果で動き続けるので、確認の遮断が主に影響するのは新規のインストール
• 同じ接続の失敗メッセージは、開かれたネットワークでも、確認が api.anthropic.com に届いて Anthropic が拒む認証情報を示したときに出る。解決したキーが、ANTHROPIC_API_KEY に入れたか apiKeyHelper が作ったゲートウェイ発行の認証情報であるセッションは、そのキーで確認を送り、拒否されたリクエストは接続の失敗として報告される
• 直すには、ネットワークの遮断が原因なら api.anthropic.com への直接の外向き通信を許可リストに入れるか、確認の失敗のしかたに合う変数を設定する

• 2 つのゲートウェイ構成は、組織で fast mode が有効でも、接続のメッセージではなく「Fast mode has been disabled by your organization」と報告する。1 つは、ANTHROPIC_AUTH_TOKEN だけで認証するセッション（claude.ai のログインも Anthropic の API キーもなく、成功した確認のキャッシュもないとき、Claude Code はリクエストを送らずに、組織が fast mode を無効にしているものとして扱い、確認を飛ばす）。もう 1 つは、確認を横取りして自前のページで答えるプロキシ（HTTP 200 のブロックページを返す TLS 検査のプロキシなど。組織が fast mode を無効にしているという応答として読まれる）。どちらの場合も、CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1 で fast mode が戻る。CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS は、失敗した確認だけを迂回し、この 2 つは失敗ではなく無効の応答を出すので、どちらにも効かない。ベアラートークンの場合は、リクエストが送られないので、直接の外向き通信を許可しても直らない
• これらの変数が効くのはクライアント側の確認だけ。組織が fast mode を無効にしているなら、変数の有無にかかわらず、API は fast mode のリクエストを拒否する。API からの拒否は、スキップの変数を設定していても有効で、Claude Code は拒否されたリクエストを標準速度で再試行し、fast mode をオフにし、/fast は組織が fast mode を無効にしていると報告する
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC を設定しても、可否の確認は抑えられる。成功した確認のキャッシュがなければ、/fast は「Fast mode is currently unavailable」と報告する。この構成でも、2 つのスキップの変数のどちらでも fast mode が戻る

セッションごとのオプトイン#

既定では、ユーザーが対話セッションでオンにした fast mode は、セッションをまたいで残ります。変えるには、いずれかの設定ファイルで fastModePerSessionOptIn を true にします。各セッションが fast mode オフで始まり、ユーザーは /fast で明示的に有効にする必要があります。Team か Enterprise プランのオーナーは、サーバー管理設定で組織全体に配れます。

{
  "fastModePerSessionOptIn": true
}

• 同時に複数のセッションを動かす組織でコストを管理するのに役立つ。ユーザーの fast mode の設定は保存されたままなので、この設定を外すと、既定の永続の動きに戻る
• 管理設定がこのキーを設定しているときは、/fast on は対話端末のセッションでだけ働く。非対話モード・VS Code 拡張・クラウドセッションを含むほかのすべての場所では、組織が fast mode を無効にしているというメッセージで拒否される

レート制限の扱い#

fast mode のレート制限は、標準の Opus とは別です。対応するすべての Opus モデルは 1 つの fast mode のレート制限のプールを共有し、どれの利用も同じ制限から引かれます。fast mode のレート制限に達すると、次のようになります。

1. fast mode が自動で標準速度に戻る
2. ↯ のアイコンがクールダウンを示す灰色になる
3. 標準の速度と料金で作業を続けられる
4. クールダウンが終わると、fast mode が自動で再び有効になる

クールダウンを待たずに手動でオフにするには、/fast をもう一度実行します。

• セッションの途中で使用クレジットが尽きると、Claude Code は、拒否された fast mode のリクエストを標準の速度と料金で再試行するので、作業は続けられ、クールダウンはない。拒否の見え方はセッションの種類で違う
• 対話セッションでは、「Fast mode disabled · usage credits exhausted」の通知が出て、そのセッションの残りで fast mode をオフにする。保存した fast mode の設定は変わらないので、/fast で再びオンにする
• --output-format stream-json の非対話モードと Agent SDK では、使用クレジットが尽きている間、ターンごとに 1 回、同じ文を、サブタイプ notification の system メッセージとしてメッセージストリームに出す。fast mode はオンのまま（v2.1.221 以降が必要）

advisor#

advisor は、主モデルと、より強い advisor モデルを組み合わせ、Claude が作業中の重要な場面で相談するようにする機能です。実験的な機能で、Anthropic API が必要です。Amazon Bedrock・Claude Platform on AWS・Google Cloud の Agent Platform・Microsoft Foundry では使えず、挙動・料金・提供は変わることがあります。

• Claude が、方針を決める前、繰り返すエラーで詰まったとき、タスクの完了を宣言する前などに、2 つ目の、通常はより強いモデルに相談する。advisor はツール呼び出しと結果を含む会話の全体を受け取り、Claude が続ける前に適用する助言を返す
• advisor は、Anthropic のインフラ上でサーバーツールとして動き、サブスクリプションの口座にも API 課金の口座にも使える。advisor にするモデルは自分で選び、いつ呼ぶかは Claude が決める
• 向くのは、ほとんどのターンは定型でも、計画の質が結果を決める、長くて複数のステップのタスク（大きなリファクタリング・エラーが繰り返すデバッグ・Claude が終わりと言う前に独立に確認させたい作業）
• 計画することが少ない短いタスクや、毎ターンが最強のモデルを必要とする作業では価値が小さい。その場合は主モデルを切り替える

有効にする#

advisor のモデルは、3 つの方法で設定できます。

• どれも、主モデルが advisor に対応するセッションで advisor を有効にする。セッションが始まると、Advisor Tool (experimental) is on and may use more tokens · /advisor の通知が出る
• 一部のプランでは、Fable を advisor にするのにも、Fable の利用を使用クレジットに課金することへの 1 回限りの同意が要る（後述）
• /advisor を引数なしで実行すると、使える advisor モデルを並べたピッカーが開く。モデルを直接渡すこともできる（/advisor opus）。コマンドは Advisor set to に advisor のモデル名を続けて確認する。選択はユーザー設定の advisorModel に保存され、セッションをまたいで残る（advisorModel のエントリが現在のセッションだけに適用されると挙げる場合を除く）
• ターミナルのピッカーがない場所でも、-p の非対話モード・Agent SDK・デスクトップアプリ・Remote Control で動く（v2.1.260 以降が必要）。そこでは、引数なしの /advisor が現在の advisor のモデルと受け付ける別名を出し、/advisor opus のようにモデルを付けると設定し、/advisor off でオフにする
• 組織の availableModels の許可リストが除く、保存済みの advisor は呼び出さない。advisor を使うには、/advisor で許可されたモデルを選ぶ
• 現在の主モデルが対応しない advisor も、Claude Code は保存する。その advisor は、/model で互換のある主モデルに切り替えた後に有効になる。API がすでに現在の会話で保存済みの advisor を拒否していたら、モデルを切り替えても、/clear か /compact までオフのまま

{
  "advisorModel": "opus"
}

claude --advisor opus

• --advisor フラグは、そのセッションでは advisorModel 設定の代わりに使われ、保存した設定を変えない。claude --help には出ない
• 次のとき、Claude Code は起動時にエラーで終了する：セッションの主モデルが advisor に対応しない、要求したモデル（Haiku など）が advisor になれない、組織の availableModels の許可リストが要求したモデルを除く、Fable を要求して、アカウントがまだ使用クレジットの同意を必要とする
• 要求したモデルが advisor になれても、セッションの主モデルより順位が下のときは、Claude Code はセッションを始める。バックグラウンドセッション以外では、そのモデルが主モデルに cannot advise と、起動時に警告も出す
• バックグラウンドセッションを --advisor で始めてこれらのどれかに当てはまると、終了せずに advisor なしでセッションを始める

advisor のモデルを選ぶ#

Claude Code は、advisor の役割のために、モデルを能力で順位づけます。advisor は、セッションの主モデルと同じか、それより上の順位でなければなりません。行は、順位の低い主モデルから高いものへ並びます。

• Fable 5.1 は v2.1.257 以降が必要。Fable 系のモデルは Fable へのアクセスが必要。Opus 4.7 か Opus 4.8 の主モデルに Sonnet 5.5 を advisor にするには v2.1.287 以降が必要
• advisor は fable・opus・sonnet で設定する。これらの別名は、各モデルの系統について Claude Code の組み込みの既定のバージョンに解決され、新しい Claude Code のリリースで進む。claude-opus-5-5 のような完全なモデル ID も渡せる。Haiku は advisor を呼べるが、advisor にはなれない
• サブエージェントは、設定された advisor を引き継ぎ、自分のモデルについて同じ組み合わせの検査を適用する
• 主モデルより順位が低い advisor は、Claude Code が主モデルのリクエストに付けない（/advisor の出力と通知で分かる。自分のモデルが組み合わせを満たすサブエージェントは、advisor を使えることがある）
• Claude Code が付けた advisor の組み合わせを API が拒否したときは、Claude Code はそのリクエストを advisor なしで再送する。会話はそのまま advisor なしで進むので、エラーも advisor の呼び出しも出ない。そのあと /advisor で別の advisor を選ぶと、変更は /clear か /compact の後と新しいセッションで効く
• 主モデルか advisor が Claude Code の認識しないモデルのときは、advisor は付かない

Fable の advisor と使用クレジット#

一部のプランでは、Fable の利用は使用クレジットに課金され、advisor としての Fable も同じように課金されます。アカウントが、Fable の利用を使用クレジットに課金することへの 1 回限りの同意を必要とするとき、Claude Code は、/model で Fable のモデルを選んだときにそれを求め、その同意を受け入れるまで、Fable を advisor として適用しません。

• 同意の前は、/advisor fable と打つか /advisor のピッカーで Fable を選んでも、Claude Code は Fable を advisor として保存せず、/model fable を案内する。claude --advisor fable は、起動時に /model fable を案内するメッセージで終了する。バックグラウンドセッションでは、終了せず advisor なしで始まる。Fable がすでに advisorModel に保存されていれば、advisor なしでリクエストを送る。主モデルが advisor に対応する対話セッションでは、/model fable を案内する通知も出る
• 同意するには、/model fable を実行し、Fable で続けるを選ぶ。Claude Code が同意を記録し、選んだモデルとして Fable を保存する。その後、Fable を advisor に選ぶ

よくある組み合わせ#

Claude がいつ相談するか、画面での見え方#

• Claude が advisor を呼ぶタイミングを決める。方針を決める前、エラーが繰り返すとき、タスクの完了を宣言する前に相談する傾向があるが、タイミングはルールではなくモデルが決める
• プロンプトで、ほかのツールと同じように相談を頼める（consult the advisor before you continue など）。advisor の呼び出しを制限したり強制したりする設定はない。もっと頻繁に・控えめに相談させたいなら、指示でそう伝える
• Claude が advisor を呼ぶと、記録に、呼び出し中は advisor のモデル名つきの Advising の行が出る。結果が戻ると、行は助言があったかを報告する

• Claude は通常、advisor の助言に従うが、特定の主張が自分の証拠と食い違うとき（勧められた手順を試して失敗した、ファイルの内容が助言と矛盾するなど）は、無条件に従わず、食い違いを表に出す
• advisor は常に会話の全体を受け取り、タイミングは Claude が決める

費用とキャッシュ#

• Claude が advisor を呼ぶと、advisor モデルが会話を読むので、主モデルの利用に加えて、advisor モデルの料金でトークンを消費する。API 課金では、advisor のトークンに advisor モデルの入出力の料金を払う。サブスクリプションプランでは、advisor の利用はプランの利用上限に数えられる（Fable の利用が使用クレジットに課金されるプランでは、Fable の advisor も使用クレジットに課金される）
• アカウントが使用クレジットの同意を必要とするとき、Fable の advisor は、同意するまで課金されない（Claude Code が選択を適用しないため）
• Claude は毎ターンではなく判断の場面で advisor を呼ぶので、速い主モデルに強い advisor を組み合わせるほうが、強いモデルを通しで動かすより安くなるのが普通。advisor の利用は、/usage に出るセッションの合計に数えられる
• advisor をセッション中にオン・オフしても、主モデルのプロンプトキャッシュは無効にならない。モデルを切り替えるのと違い、/advisor の切り替えはキャッシュされたプレフィックスを保ち、advisor の返した助言は以降のターンで記録の一部としてキャッシュされる。advisor モデル自身の会話の読み取りはキャッシュされず、呼び出しのたびに会話の全体を新たに処理する

要件とオフにする#

advisor には次のすべてが必要です。

• Anthropic API だけ：advisor はサーバーで実行されるツール。Amazon Bedrock・Claude Platform on AWS・Google Cloud の Agent Platform・Microsoft Foundry では使えない。ANTHROPIC_BASE_URL で設定した LLM ゲートウェイ経由では、ゲートウェイがリクエストを Anthropic API へそのまま転送するかで決まる。ゲートウェイやその上流が advisor ツールを認識しないときの Claude Code の応答は、ゲートウェイのプロトコルの文書にある
• 対応する主モデル：Fable・Opus 4.6 以降・Sonnet 4.6 以降・Haiku 4.5
• フィーチャーフラグの取得：Claude Code は、Anthropic から取得するフィーチャーフラグで advisor をオンにする。DISABLE_TELEMETRY のようにフラグの取得をオフにする変数を設定したセッションでは、advisor はオフのまま

advisor を使うのをやめるには、/advisor off を実行するか、/advisor のピッカーで「No advisor」を選びます。advisor ツールを完全に無効にするには CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 を設定します。/advisor コマンドが使えなくなり、設定された advisorModel は無視され、--advisor フラグは受け付けられるが効きません。

関連する方法との比較#

advisor は、モデルの強みを組み合わせる方法の 1 つです。2 つ目のモデルをいつ関わらせたいかで選びます。

カスタムモデルの選択肢を足す#

ANTHROPIC_CUSTOM_MODEL_OPTION で、組み込みの別名を置き換えずに、/model ピッカーに 1 つのカスタムの項目を足せます。Claude Code が既定では一覧に出さないモデル ID を試すのに便利です。LLM ゲートウェイでは、CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 を設定すると、ゲートウェイの /v1/models エンドポイントからピッカーを埋められるので、この変数が要るのは、その検出が無効なときか、欲しいモデルを返さないときだけです。複数のモデルを自分の順序と好きなラベルで並べるには、modelPicker を設定します。

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"

• Claude Code は環境変数を起動時に読むので、claude を起動する前に export するか、動いているセッションを再起動する
• _NAME と _DESCRIPTION は省略できる。名前を省くと、項目は、Claude Code が ID を認識するときはモデルの名前を、そうでなければモデル ID を出す。説明を省くと Custom model (<model-id>) が使われる
• カスタムの項目は組み込みの項目の後ろに並び、modelPicker で足した行はその後ろに並ぶ
• ANTHROPIC_CUSTOM_MODEL_OPTION のモデル ID は検証されないので、API エンドポイントが受け付ける文字列なら何でも使える
• availableModels を設定しているときは、カスタムのモデル ID も許可リストに入れる。入れないと、Claude Code はカスタムの項目をピッカーから外し、--model での選択もほかの除かれたモデルと同じように拒否する
• my-gateway/claude-opus-5-5 のように系統名を含むカスタム ID は、その系統の特定の項目として数えられ、その系統のワイルドカードを無効にするので、選べるままにしたいバージョンも列挙する

管理者向け：モデルの制限#

availableModels（許可リスト）#

管理者は、管理設定かポリシー設定の 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 だけを許します。

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

availableModels を設定すると、許可リストはユーザーがモデルを指定できるあらゆる場所に適用されます。

• Anthropic API と Claude Platform on AWS では、opus・sonnet・haiku・fable の系統の別名は、許可リストがそのモデルを許すとき、通常のモデルに解決される。許可リストがそのモデルをブロックするときは、リストが許す最新のバージョンに置き換えられ、要求したモデルと置き換えたモデルの両方を名指しした通知が出る（例：["sonnet", "claude-opus-4-6"] では /model opus も --model opus も、許可された最新の Opus の Claude Opus 4.6 を選ぶ）。v2.1.205 より前は、最新のリリースが一覧の外にある別名は、一覧が古いバージョンを許していても、ほかのブロックされた選択と同じように拒否・置き換えされた。許可リストが別名の系統のどのバージョンも許さないときは、別名はほかのブロックされた値と同じ扱いになる
• そのほかのブロックされた選択は、モデルが設定された場所で扱いが変わる

• 除外されたモデルは /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 でもプロバイダー固有の ID でも、Claude Code は行を足さない。Mantle のモデル ID はその接頭辞を持つ。組み込みの行がないリストのバージョンを出すには、プロバイダーの形式の ID を受け付ける modelPicker の構成にも足す
• Claude Code があなたの代わりに行うモデルの変更も、同じように検査される：フォールバックモデルの連鎖は許可リスト外の項目を落とす。プランモードのアップグレードは、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 で、許可リストを見ずに動く。v2.1.210 以降が必要）。fast mode は、オンにした後にセッションが動くモデルが許可リスト外なら、オンにすることが拒否される
• Amazon Bedrock と Google Cloud の Agent Platform の可用性のフォールバック：セッションの途中でアカウントがモデルへのアクセスを失ったときの別のモデルへの切り替えは、除外されたモデルを飛ばす。起動時のモデルの確認（Amazon Bedrock と Google Cloud の Agent Platform）が除外されたモデルを飛ばすのは、管理設定が enforceAvailableModels も設定しているときだけ

表面ごとの適用範囲#

どの表面も、受け取った許可リストを強制します。どの配布の仕組みがどの表面に届くかは違います。

• クラウドセッション（デスクトップアプリから始めたものを含む）は、既定では Anthropic が管理する VM で動くので、デバイスに配備した設定は届かない。許可リストはサーバー管理設定で届ける。セルフホスト環境へ回されるセッションは自分の計算資源で動き、ランナーイメージの管理設定ファイルも読む。クラウドセッションの途中のモデル切り替えは、要求したモデルが許可リストに除かれていると拒否される
• Claude Tag のセッションはクラウド環境で動くが、サーバー管理設定を受け取らない。そのセッションのモデルを設定するには、Claude Tag の管理者向けガイドを見る
• Cowork は Claude Code でセッションを動かすが、設計上、claude.ai の管理コンソールのサーバー管理設定を受け取らない。サーバー管理設定の availableModels が空でなく、ユーザーがその外のモデルを選ぶと、サーバーがリモートの Cowork セッションでそのモデルを拒否する。管理設定ファイルは、セッションが動く場所にあれば適用される（リモートの Cowork セッションは Anthropic が管理する VM で動くので、デバイスに配備したファイルはそこにない）
• Amazon Bedrock・Google Cloud の Agent Platform・Microsoft Foundry・Claude Platform on AWS のようなサードパーティプロバイダーのセッションは、サーバー管理設定を受け取らないので、許可リストは MDM か管理設定ファイルで届ける
• サーバー管理の配布には、セッションが対象のログインかキーで認証することも必要。apiKeyHelper スクリプトだけでキーを作る場合は、MDM か管理設定ファイルで配布する
• デスクトップの Code タブは SSH セッションも持ち、それは動いているリモートホストから管理設定ファイルを読む
• claude.ai とデスクトップアプリのモデルピッカーは、組織の許可リストが除くモデルを隠すか灰色にする。ピッカーの状態はユーザー向けの便宜で、許可リストを強制するものではない

Default の扱いと関連する管理設定#

• 既定の接頭辞の一致では、availableModels だけでは、enforceAvailableModels も設定するまで、Default の選択肢はシステムの実行時の既定のままになる。その既定が制限したいモデルなら、enforceAvailableModels も設定するか、そのモデルをブロックする
• availableModels: [] では、名指しのモデルの選択はブロックされ、enforceAvailableModels は効かない
• model 設定は、強制ではなく最初の選択。ユーザーは /model を開いて Default を選べ、それはシステムの実行時の既定に解決される（enforceAvailableModels か特定のバージョンをブロックするキーが当てはまる場合を除く）

• enforceAvailableModels: true では、記録されたモデルのないメンバーの Default の選択肢は、アカウントの種類の既定（管理者が設定していれば組織の既定モデル）に解決される。そのモデルが許可リストにないときは、許可されて使える availableModels の最初の項目に解決され、/model ピッカーの Default の行がそのモデルを示す。この置き換えは、セッションの起動・/model で Default を選ぶとき・フォールバックの連鎖の "default" キーワード・除外された選択を落としたときのフォールバックで、既定に届く場所のどこでも働く。availableModels が空でないのに許可され使える項目に解決されるものがないときは、強制は飛ばされ、警告が --debug でだけ見える。それを避けるには、必ず使える項目を 1 つはリストに残す。両方のキーは、配るなかで最も上位の管理ソースに一緒に置く
• 例：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 に固定したバージョンではなく実行時の既定になる。enforceAvailableModels は Default が許可リストに従うようにし、env ブロックは sonnet のような許可された別名が解決するバージョンを固定する。モデルの系統の制限だけで足りるなら enforceAvailableModels だけを使い、特定のバージョンも固定するなら env ブロックも足す
• マージの動き：Claude Code が適用する管理設定が availableModels を定義すると、そのリストだけが適用される（ホストプラットフォームが独自のものを渡す場合を除く）。ユーザー・プロジェクト・ローカルの設定の項目は拡張できず、複数の管理ソースをまたいでもマージされない。それ以外では、ユーザー・プロジェクト・ローカルの設定のリストは、ほかの配列設定と同様に連結され重複が除かれる。有効なリストの中で、系統の特定のモデル（バージョンの接頭辞か完全なモデル ID）を名指しする項目は、その系統のワイルドカードの項目を無効にする（["sonnet", "claude-sonnet-4-5"] が許すのは Sonnet 4.5 の各バージョンだけで、すべての Sonnet ではない）
• availableModels の anthropic. で始まる項目は、カスタムの選択肢として /model ピッカーに足される。これは「サードパーティのデプロイ向けにモデルを固定する」で説明した別名の照合の例外。Amazon Bedrock の Mantle エンドポイントが有効なときは、Mantle の形式に合う項目を、Claude Code がそのエンドポイントに送る。設定はピッカーをリストの項目に絞り、Mantle の ID は系統名を埋め込むので特定の項目として数えられ、その系統のワイルドカードを無効にする。Mantle の ID と並べて、選べるままにしたいバージョンの接頭辞か完全な ID を列挙する
• deniedModels の例：Opus と Sonnet を許し、日付つきやプロバイダー固有の ID を含むあらゆる綴りの Opus 5.5 をブロックする

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

• ブロックされたモデル（deniedModels が名指しするか、"exact" のリストが省くもの）は、許可リストが適用されるすべての場所で、ブロックされた選択として扱われる。/model ピッカーから隠れ、/model <名前> は拒否する。--model・ANTHROPIC_MODEL・model 設定でブロックされたモデル ID を指定すると、Claude Code は起動時にそれを落とし、Default の選択肢を解決する。フックやバックグラウンドのリクエスト（エージェントフックの model フィールドなど）が deniedModels のブロックするモデルを指定すると、そのリクエストはセッションのモデルで動く
• Default の選択肢は、enforceAvailableModels の設定にかかわらず、両方のキーにも従う。空でない availableModels と一緒に設定すると、ブロックされた既定は許可リスト外のモデルとして数えられる。そうでなければ、ブロックされたモデルに解決されるはずの Default は、次の順で下がる：同じ系統の許可された最新のバージョン、低コストの各系統（Sonnet、次に Haiku）の許可された最新のモデル、許可されたモデルを名指しする availableModels の最初の項目。どれも許可されていなければ、Default の選択肢で始まるセッションは、直すキーを名指しするエラーで起動を拒否する。"exact" のリストが Default の選択肢に影響するのは、管理設定の availableModels のリストが、モデルか系統を 1 つ以上名指ししているときだけ
• Claude Code は、deniedModels と availableModelsMatch を管理設定からだけ読む。ユーザー・プロジェクト・ローカルの設定や --settings で設定すると、警告を出して無視する。それより前のバージョンは両方のキーを無視する
• availableModels の claude-opus-5 のような項目は、Claude Code が対応し次第、Opus 5.5 のような、それを延ばす後のリリースも許す。2 つの管理設定が、リリースを留めておける

組織のモデル制限と組織の既定モデル#

Claude Enterprise プランの組織の管理者は、claude.ai の管理コンソールで個々のモデルを無効にして、メンバーが動かせるモデルを制限できます（v2.1.187 以降が必要）。この制限は、Claude Code が認証するときに、アカウントの権限として配られ、設定の availableModels とは別で、セッションが作られるときサーバーも独立に同じ制限を強制します。

• 制限は、メンバーがサインインするか自分の API キーを使うときに適用される。組織のサービスキーのような組織スコープの認証情報はユーザーに結びつかないので、制限は適用されない
• Claude Console にはモデル制限の制御がない。Claude Enterprise プランのない組織（メンバーが Anthropic API で認証する組織を含む）は、管理設定の 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 のような系統の別名は、組織が許すとき通常のモデルに解決される。組織がそのモデルを制限するときは、組織が許す系統の最新のバージョンに置き換えられ、同じ置き換えの通知が出る。/model <別名> が拒否されるのは、その系統のすべてのバージョンが制限されたときだけで、--model・ANTHROPIC_MODEL・model 設定で設定した別名は、その場合も起動時に置き換えられる。v2.1.205 より前は、系統の別名が、古いバージョンが許されていても、最新のリリースだけで置き換えや拒否が決まった
• 制限は組織全体か役割ごと：組織レベルでモデルを無効にすると全メンバーから消える。役割レベルのアクセスは、カスタムの役割ごとに別のモデルを許し、複数の役割を持つメンバーは、どれかの役割が許すモデルを使える。Haiku は常に使え、無効にできないので、全メンバーに使えるモデルが 1 つは残る。アクセスの変更は約 1 分以内に新しいリクエストで効き、/model ピッカーには次のセッション開始時に反映される
• 両方の制限が合わせて適用される：モデルを選べるのは、availableModels が許可し、組織が制限していないときだけ。組織の制限が届くのは Anthropic API と LLM ゲートウェイのデプロイのセッションだけで、ほかのプロバイダーでは availableModels を使う

Claude Enterprise プランの組織の管理者は、claude.ai の管理コンソールで、組織全体か役割ごとに、Claude Code のメンバーの既定のモデルを設定できます（v2.1.196 以降が必要）。設定されると、Default の選択肢がそのモデルに解決されます。

• /model ピッカーの Default の行には、組織の既定の名前と「Org default」のラベルが出る。管理者が組織全体か自分の役割に設定したかにかかわらず、ラベルは Org default。役割の既定は、そのカスタムの役割のメンバーに及び、組織全体の既定より優先される。複数の役割が別の既定を設定しているときは、最も高性能なモデルが適用される
• 組織の既定は出発点で、制限ではない。次の選択が、それに優先する：--model フラグと ANTHROPIC_MODEL、管理設定か --settings で渡した model 値、ユーザー・プロジェクト・ローカルの設定の model 値（/model で保存したモデルを含む）
• 管理者は、組織の既定がユーザーの選択を上書きするよう設定することもできる。上書きをオンにすると、ユーザー・プロジェクト・ローカルの設定の model 値より優先されるので、/model で保存したモデルは現在のセッションに適用され、組織の既定が次の起動で戻る。選択が違うとき、/model は Your organization's default (<model>) applies on restart と出す。--model フラグ・ANTHROPIC_MODEL・管理設定・--settings は、上書きがオンでも優先される
• 組織の既定は起動時に 1 度だけ読まれるので、管理者がセッションの途中で変えた既定は、次の起動で効く。組織の既定がユーザーの選択を上書きしないとき、管理者が変えた後の最初の対話の起動は、新しい既定が適用されるように、ユーザー設定の model キーを 1 度だけ消す。ファイルのほかは何も変えず、その後に /model で保存したモデルは保たれる
• 組織の既定は、採用される前に次の制限の検査を通る：既定の接頭辞の一致では、availableModels だけは組織の既定に適用されないので、許可リスト外の組織の既定もそのまま適用される。enforceAvailableModels も設定されていると、許可リスト外の組織の既定も許可リストの最初の項目に置き換えられる。組織のモデル制限がアカウントについて拒否する組織の既定は、その系統の許可された最新のモデルか、そのすべてのバージョンが制限されているときは低コストの系統に置き換えられる。deniedModels か "exact" のリストがブロックする組織の既定は、上の deniedModels の説明に従う。アカウントでまったく使えない組織の既定は飛ばされ、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 出力、またはバックグラウンドエージェントでは、制限は黙って適用される
• 上限はモデルごとなので、モデルを切り替えると使える段階が変わりうる。複数の役割が同じモデルを許すときは、最も制限の少ないものが使われる。effort の上限はモデルの制限と合わせて届き、同じセッションに届く

サードパーティのデプロイでモデルを固定する#

Amazon Bedrock・Google Cloud の Agent Platform・Microsoft Foundry・Claude Platform on AWS で Claude Code を配るときは、ユーザーに展開する前にモデルのバージョンを固定します。固定しないと、Claude Code は fable・opus・sonnet・haiku のような別名を使い、それはプロバイダーごとの組み込みの既定のモデル ID に解決されます。その既定は最新の Anthropic のリリースに遅れることがあり、指すモデルがユーザーのアカウントでまだ有効になっていないこともあります。

• 既定が使えないとき、Amazon Bedrock と Google Cloud の Agent Platform のユーザーには通知が出て、セッションは既定のモデルの以前のバージョン、または既定が Opus で Opus のバージョンが使えないときは既定の Sonnet にフォールバックする。Microsoft Foundry には同等の起動時の検査がないので、エラーが出る
• Amazon Bedrock と Google Cloud の Agent Platform で、--model・ANTHROPIC_MODEL・model 設定で特定の Sonnet か Opus のバージョンでセッションを始めたユーザーは、対応する別名のセッションの既定としてそのバージョンを固定したことになり、起動時の検査は、置き換わる組み込みの既定を飛ばし、フォールバックの通知も出さない。v2.1.211 より前は、セッションのモデルが明示的に設定されていても、検査が動き、通知が出ることがあった

• ANTHROPIC_DEFAULT_FABLE_MODEL・ANTHROPIC_DEFAULT_SONNET_MODEL・ANTHROPIC_DEFAULT_HAIKU_MODEL にも同じ形を使う。新しいモデルのバージョンへ上げるには、これらの環境変数を更新して再配備する
• 固定したモデルで拡張コンテキストを有効にするには、ANTHROPIC_DEFAULT_OPUS_MODEL・ANTHROPIC_DEFAULT_SONNET_MODEL・ANTHROPIC_DEFAULT_FABLE_MODEL のモデル ID に [1m] を付ける（例：export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8[1m]'）。[1m] を付けると、1M のコンテキストウィンドウが、opusplan のプランモードの Opus の段階や、model frontmatter でその別名を名指しするサブエージェントを含む、固定した別名のすべての利用に適用される
• Claude Code は、プロバイダーにモデル ID を送る前に接尾辞を取り除く。付けるのは、基盤のモデルが 1M コンテキストに対応するときだけ。接尾辞はモデルごとではなく変数ごとに読まれる：Amazon Bedrock・Google Cloud の Agent Platform・Microsoft Foundry では、[1m] なしでモデル ID を書いた変数は、別の変数が接尾辞つきで同じモデルを設定していても 200K のコンテキストで動く。Sonnet 5 は、これらのプロバイダーで常に 1M のウィンドウで動き、接尾辞は要らない
• ANTHROPIC_DEFAULT_*_MODEL 変数を設定すると、/model ピッカーには、その系統の組み込みの行（1M コンテキストの行を含む）の代わりに、そのモデルの行が 1 つ出る。変数に接尾辞を付けずに 1M のウィンドウを使うには、ユーザーが /model opus[1m] を実行すると、Claude Code が変数の名指すモデルに接尾辞を適用する。/model sonnet[1m] も同様
• MDM か管理設定ファイルで配った availableModels の許可リストは、サードパーティプロバイダーでも適用される（サーバー管理設定はそこには配られない）。絞り込みは、opus のようなモデルの別名・claude-opus-4-8 のようなバージョンの接頭辞・プロバイダー形式の完全なモデル ID に一致する。us.anthropic. のようなプロバイダー固有の接頭辞は取り除かれないので、特定のモデルを許すには、プロバイダー形式の完全な ID を列挙するか、modelOverrides で対応づける。固定したモデルでは、その ID は ANTHROPIC_DEFAULT_*_MODEL 変数に設定した値。[1m] の接尾辞は、許可リストの項目と要求したモデルの両方から、一致の前に取り除かれる

固定したモデルの表示と機能#

サードパーティプロバイダーでモデルを固定すると、/model ピッカーのその行は、Claude Code が固定した ID を認識するときはモデルの名前を、そうでなければ生の ID を出します。

• 認識される：Anthropic API の ID か、プロバイダーやゲートウェイの形の ID など、Claude Code が知るモデルの正確な ID（[1m] 接尾辞の有無を問わない）。us.anthropic.claude-sonnet-4-5-20250929-v1:0 を固定すると、行は Sonnet 4.5 と出る
• 認識されない：アプリケーション推論プロファイルの ARN や、Claude Code の知らないモデルのバージョンなど、そのほかの ID（modelOverrides の項目がモデルをその正確な文字列に対応づけている場合を除く）。Microsoft Foundry ではデプロイ名がユーザー定義なので、固定した ID は、対応づけてあっても Claude Code が認識することはなく、行は既定でデプロイ名を出す
• 行がモデルの名前を出すとき、既定の説明には固定した ID が含まれ、どの ID を固定したかが分かる

Claude Code は、固定したモデルが対応する機能も認識できないことがあります。表示名と説明を自分で設定し、固定したモデルごとに、対になる環境変数で機能を宣言できます。これらの変数は、Amazon Bedrock・Google Cloud の Agent Platform・Microsoft Foundry のようなサードパーティプロバイダーで効きます。_NAME と _DESCRIPTION の変数は、ANTHROPIC_BASE_URL が LLM ゲートウェイを指しているときも効きます。api.anthropic.com に直接つなぐときは効きません。

• ANTHROPIC_DEFAULT_SONNET_MODEL・ANTHROPIC_DEFAULT_HAIKU_MODEL・ANTHROPIC_DEFAULT_FABLE_MODEL・ANTHROPIC_CUSTOM_MODEL_OPTION にも、同じ _NAME・_DESCRIPTION・_SUPPORTED_CAPABILITIES の接尾辞が使える
• Claude Code は、モデル ID を既知のパターンと照合して、effort の段階や拡張思考のような機能を有効にする。Amazon Bedrock の ARN やカスタムのデプロイ名のようなプロバイダー固有の ID はこのパターンに合わないことが多く、対応する機能が無効のままになる。_SUPPORTED_CAPABILITIES で、モデルが実際に対応する機能を Claude Code に伝える

_SUPPORTED_CAPABILITIES を設定すると、Claude Code は、対応する固定したモデルについて、挙げた機能を有効にし、挙げていない機能を無効にします。変数が未設定なら、Claude Code はモデル ID に基づく組み込みの検出に戻ります。

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 を上書きする（modelOverrides）#

系統ごとの環境変数は、系統の別名につき 1 つのモデル ID を設定します。同じ系統の複数のバージョンを別々のプロバイダーの ID に対応づける必要があるときは、modelOverrides 設定を使います。modelOverrides は、個々の Anthropic のモデル ID を、Claude Code がプロバイダーの API に送るプロバイダー固有の文字列に対応づけます。ユーザーが /model ピッカーで対応づけたモデルを選ぶと、Claude Code は組み込みの既定ではなく、設定した値を使います。管理者が、ガバナンス・コスト配分・リージョンのルーティングのため、各モデルのバージョンを、特定の Amazon Bedrock の推論プロファイルの ARN・Google Cloud の Agent Platform のバージョン名・Microsoft Foundry のデプロイ名に回せます。

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

• キーは、Models overview に載っている Anthropic のモデル ID にする。日付つきのモデル ID は、そこにあるとおりに日付の接尾辞を含める。未知のキーは無視される
• ゲートウェイの別名のような ID で、[claude-code:unrecognized_model] の診断行を止めるには、その ID を値にした項目を足す
• 上書きは、/model ピッカーの各項目を支える組み込みのモデル ID を置き換える。Amazon Bedrock では、modelOverrides の項目が、Claude Code が起動時に自動で見つける推論プロファイルより優先される。すでにプロバイダー固有の値（Amazon Bedrock の推論プロファイルの ARN や Microsoft Foundry のデプロイ名）は、そのままプロバイダーに渡される
• 上書きは、Anthropic のモデル ID を --model・ANTHROPIC_MODEL・ANTHROPIC_DEFAULT_*_MODEL 環境変数で直接渡したときにも適用される。Amazon Bedrock・Google Cloud の Agent Platform・Mantle では、modelOverrides の項目がない Anthropic のモデル ID は、プロバイダーがそのバージョンに対応するとき、そのバージョンの /model ピッカーの行と同じプロバイダー固有の ID に解決される。Mantle は一部のバージョンに対応する。その範囲外の Anthropic のモデル ID は、modelOverrides の項目が覆わない限り、対応づけずに生の ID を Mantle に送る。v2.1.200 より前は、--model と環境変数の値は、上書きの対応づけを通らず、そのままプロバイダーに届いた
• modelOverrides は availableModels と併用できる。許可リストは上書きの値ではなく Anthropic のモデル ID で評価されるので、availableModels の "opus" は、Opus のバージョンが ARN に対応づけられていても一致し続ける。管理設定で enforceAvailableModels を設定しているとき、強制された Default は、管理設定の modelOverrides だけで解決される。管理者の対応づけ（バージョンを推論プロファイルの ARN に固定するなど）は、強制された Default でも尊重される。ユーザーやプロジェクトの設定の上書きは影響しない
• 管理設定で availableModels を設定しているとき、--model や上の環境変数で直接渡した Anthropic のモデル ID には、管理設定の modelOverrides だけが適用される。Claude Code は、そうした ID についてユーザー設定やプロジェクト設定の上書きを無視し、管理されたリストが除く ID は、どの設定ソースの modelOverrides でも解決しない。この管理ソースの制限は v2.1.200 以降が必要

モデルに関する環境変数#

別名が指すモデル名を制御するのに、次の環境変数を使います。値は、完全なモデル名か、API プロバイダーの同等の識別子にします。セッションが始まるモデルを選ぶには ANTHROPIC_DEFAULT_MODEL を設定します（この表にはない）。

• ANTHROPIC_SMALL_FAST_MODEL は非推奨で、ANTHROPIC_DEFAULT_HAIKU_MODEL に置き換えられた
• 変数の全体は環境変数一覧にある

プロンプトキャッシュの設定#

Claude Code は、性能を上げ費用を下げるために、自動でプロンプトキャッシュを使います。全体か、特定のモデルの階層ごとに無効にできます。

メイン会話とサブエージェントのキャッシュの TTL を別々に選ぶ方法と、キャッシュミスの原因は、コンテキストとプロンプトキャッシュを参照してください。

別名の切り替わり#

各別名が解決するモデルが変わった Claude Code のバージョンです。新しいものから並べています。