CC逆引きリファレンス

モデルが過負荷の時に自動でフォールバックしたい

3. モデル・思考

コマンド / 機能

--fallback-model

過負荷時の自動切り替え(print モードのみ)

概要

--fallback-model フラグを使うと、デフォルトモデルが過負荷でエラーになった時に自動で別のモデルにフォールバックします。CI/CD など自動化での安定性向上に役立ちます。

設定例

# 過負荷時に sonnet へフォールバック
claude -p --fallback-model sonnet "コードをレビューして"

# opus が混んでいる時に自動で sonnet を使用
claude -p --model opus --fallback-model sonnet "設計を提案して"
公式ドキュメントを見る

こんな時に使う

  • CI/CD でモデル過負荷によるエラーを防ぎたい時
  • 高トラフィック時でも処理を継続させたい時

使い方

  1. 1--fallback-model <モデル名> で指定
  2. 2print モード(-p)でのみ有効
  3. 3フォールバック先は sonnet などのエイリアスかフルモデル名

Tips

  • インタラクティブモードでは動作しない(print モード専用)
  • 自動化スクリプトや GitHub Actions での利用に特に有効
  • フォールバック時は速度・コストが変わる場合がある