モデルが過負荷の時に自動でフォールバックしたい
3. モデル・思考コマンド / 機能
--fallback-model / settings.json fallbackModel過負荷・失敗時の自動モデル切り替え（最大3つまで順に試行）
概要
--fallback-model フラグまたは settings.json の fallbackModel で、モデルが過負荷等でエラーになった時に自動で別のモデルにフォールバックできます。カンマ区切りまたは配列で最大3つまでのモデルを順に試行します。CI/CD など自動化での安定性向上に役立ちます。
設定例
# 過負荷時に sonnet → haiku の順でフォールバック
claude -p --fallback-model sonnet,haiku "コードをレビューして"
# opus が混んでいる時に自動で sonnet を使用
claude -p --model opus --fallback-model sonnet "設計を提案して"
# settings.json での設定（最大3つまで順に試行）
{
"fallbackModel": ["sonnet", "haiku"]
}こんな時に使う
- CI/CD でモデル過負荷によるエラーを防ぎたい時
- 高トラフィック時でも処理を継続させたい時
- settings.json で恒常的にフォールバック順序を設定したい時
使い方
- 1--fallback-model <モデル名>[,<モデル名>...] で指定（カンマ区切りで最大3つ）
- 2または settings.json の fallbackModel 配列で恒常的に設定
- 3フォールバック先は sonnet などのエイリアスかフルモデル名
Tips
- CLI の --fallback-model フラグは print モード（-p）専用。インタラクティブモードで恒常的に使うには settings.json の fallbackModel を使う
- settings.json の fallbackModel は最大3つまでのモデルを配列で順に試行
- 自動化スクリプトや GitHub Actions での利用に特に有効
- フォールバック時は速度・コストが変わる場合がある