Model selection

モデルはエイリアス (別名) とモデル名のどちらでも指定でき、複数の指定方法には優先順位があります。新しいセッションの既定モデルと、プライマリモデルが使えないときに切り替えるフォールバックモデルも設定できます。

Claude Code のモデルは、次のような方法で指定でき、方法ごとに優先順位が決まっています。

• 起動時に claude --model <alias|name> で指定する
• 環境変数 ANTHROPIC_MODEL=<alias|name> を設定する
• 設定ファイルの model フィールドで恒久的に指定する

--model フラグと ANTHROPIC_MODEL は、それを付けて起動したセッションにだけ適用されます。claude --resume、--continue、/resume のピッカーで再開したセッションは、トランスクリプト保存時に使っていたモデルを維持します。

エイリアスのうち opusplan は、plan mode では opus を使い、実行時に sonnet へ切り替える特別なモードです。特定のバージョンに固定したい場合は、claude-opus-5-5 のような完全なモデル名を使うか、ANTHROPIC_DEFAULT_OPUS_MODEL などの対応する環境変数を設定します。

メインの会話のモデルを引き継ぐサブエージェントに作業を任せる前に /model で Opus に切り替えると、その作業も Opus で実行されます。ANTHROPIC_CUSTOM_MODEL_OPTION を使うと、組み込みのエイリアスを残したまま、/model のピッカーにカスタムの項目を 1 つ追加できます。

リクエストにフラグが付いたときの扱いを毎回自分で決めたい場合は、/config を実行し、Switch models when a message is flagged (メッセージにフラグが付いたときにモデルを切り替える) を選んで Ask each time (毎回確認する) を選びます。

ANTHROPIC_DEFAULT_MODEL=<alias|name> を設定すると、セッションが既定で開始するモデルを選べます。ただし、このモデルで新しいセッションを始めるのは、--model フラグ、ANTHROPIC_MODEL、設定ファイルの model の値、組織の既定モデルのいずれもモデルを選んでいない場合だけです。

• /model での選択はこの環境変数を上書きし、再起動後も保持されます。
• ピッカーの Default (既定) の行がこの環境変数のモデルになっているときは、「Set by ANTHROPIC_DEFAULT_MODEL」というラベルが表示されます。
• 値に default、inherit、opusplan、haiku を設定した場合、Claude Code はこの環境変数を無視します。

フォールバックモデルは、プライマリモデルが過負荷・利用不可のとき、またはそのほかの再試行できないサーバーエラーを返したときに使われます。切り替えたときには通知が表示されます。

• 1 つのセッションだけに設定する場合は --fallback-model フラグを使います。カンマ区切りで複数のモデルを指定できます。
• セッションをまたいで使う場合は、設定の fallbackModel に配列で指定します。
• --fallback-model フラグは fallbackModel 設定より優先されます。
• 各項目にはモデル名またはエイリアスを指定でき、"default" は既定モデルに展開されます。
• 重複を除いて 3 つを超える項目は無視されます。

切り替えは現在のターンに限られ、次のメッセージでは再びプライマリモデルから試します。起動時にチェーンの内容は確認されず、/status にも表示されません。

• 設定の model は開始時の初期選択であり、利用を強制するものではありません。
• 組織で設定したモデル制限は、モデルピッカー、--model、/model、ANTHROPIC_MODEL に適用され、制限されたモデルを選ぶと「restricted by your organization's settings」というメッセージが表示されます。
• 管理者が組織コンソールで組織の既定モデルを設定すると、ユーザーが自分で選んでいない場合に /model で「Org default」(または「Role default」) として表示されます。
• 起動時のヘッダーには、有効なモデルがプロジェクトまたは管理設定の固定によるものかどうかが表示されます。
• Bedrock と Vertex AI のセッションでは、管理者が既定モデルへのアクセスを外した場合、失敗せずに同じ階層の古い利用可能なモデルに切り替わります。
• ANTHROPIC_BASE_URL で Anthropic 互換のゲートウェイを使う場合、ゲートウェイの /v1/models からのモデル一覧の取得は CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 によるオプトインです。

セッション中にモデルを切り替える手順です。

1. セッション中に /model <alias|name> を実行すると、すぐにモデルが切り替わります。引数なしで /model を実行すると、ピッカー (選択画面) が開きます。
2. ピッカーで Enter を押すと、モデルを切り替えたうえで既定として保存します。
3. このセッションだけ切り替える場合は、/model でピッカーを開き、対象モデルの行で s を押します。
4. 現在使っているモデルは /status で確認できます。/status にはアカウント情報も表示されます。