settings.json でフォールバックモデルを常設したい
5. 設定・カスタマイズコマンド / 機能
"fallbackModel": ["sonnet", "haiku"]過負荷時の自動切り替え先を最大3つまで設定
概要
settings.json の fallbackModel キーに配列でモデルを指定すると、デフォルトモデルが過負荷等でエラーになった際に自動でフォールバックするモデルを恒常的に設定できます。最大3つまで指定でき、記載順に試行されます。CLI の --fallback-model フラグは print モード限定ですが、こちらは通常セッションでも有効です。
設定例
// ~/.claude/settings.json または .claude/settings.json
{
"fallbackModel": ["sonnet", "haiku"]
}
// フルモデル名での指定も可能
{
"fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5-20251001"]
}こんな時に使う
- チーム全体でモデル過負荷時の挙動を統一したい時
- 特定モデルが混みやすい時間帯でも作業を止めたくない時
- CI/CDのプロジェクト設定に恒久的なフォールバック順序を持たせたい時
使い方
- 1settings.json に fallbackModel を配列で追加
- 2先頭から順に試行されるモデル名を並べる（最大3つ）
- 3エイリアス（sonnet, haiku 等）とフルモデル名のどちらも指定可能
Tips
- 配列は最大3つまで。それ以上指定してもエラーにはならないが4つ目以降は無視される
- CLIの --fallback-model は print モード専用だが、settings.json 版はモードを問わず有効
- 関連するCLIフラグの使い方は「モデルが過負荷の時に自動でフォールバックしたい」を参照