短い答え
Claude Code で Sonnet、Opus、または他のモデルを切り替えるときは、サポートされている/model の入口または公式のモデル設定経路を優先してください。
モデルエイリアス、完全なモデル ID、プロバイダーマッピングは常に同一ではありません。Web UI に表示されるマーケティング名が、必ずしも API で認識されるモデル ID とは限りません。
サードパーティゲートウェイを使用する場合は、そのゲートウェイまたはプロバイダーのドキュメントに表示されるモデル ID を使用してください。
この情報が役立つ場面
- より安価なモデルとより高性能なモデルを切り替えたいとき
- Sonnet / Opus / Haiku のエイリアスは表示されるが、入力すべき値が分からないとき
- サードパーティの Base URL またはモデルゲートウェイを使用するとき
- Claude Code の Token コストを管理したいとき
- モデルが見つからない、またはモデル選択が反映されないとき
モデル名の 3 つの層
リクエストの成功で重要なのは、現在のプロバイダーがモデル ID を認識できるかどうかです。
推奨事項
- 現在のプロバイダーがサポートするモデルを確認します。
- Claude Code の
/modelまたは公式のモデル設定経路を使用します。 - サードパーティゲートウェイを使用する場合は、そのモデル広場から利用可能なモデル ID をコピーします。
- モデルの選択とコストをあわせて検討します。
- モデル名を手入力で推測しないでください。
BetterToken について
BetterToken 経由で Claude Code を接続する場合は、モデル広場から現在のモデル ID をコピーしてください。Claude プロバイダーと GPT プロバイダーのモデルは異なるプロトコル経路に属するため、混在させないでください。 モデル選択は品質、速度、コストに影響します。使用履歴を使うと、モデル間の実際の消費量を比較できます。関連ドキュメント
- Claude Code が多くの Token を使用する理由
- Claude Code で API Key と Base URL を設定する方法
- Claude Code の権限とフック
- OpenAI 互換 API と Anthropic 互換 API の違い