settings.json

fallbackModel

プライマリモデルが過負荷または利用不可の場合に、順次試行されるフォールバックモデルのチェーンを指定します。

使い方・用途

  • 特定のモデルがダウンしている際、自動的に代替モデル(Haikuなど)に切り替えて作業を継続させたい場合に使用します。
  • 重複を除いて最大3つまで指定可能で、配列の先頭から順に試行されます。
  • エントリに"default"を含めると、アカウント既定のモデルに展開されます。
英語原文(公式ドキュメントより)

Fallback model chain tried in order when the primary model is overloaded, unavailable, or returns a non-retryable server error. Capped at three entries after deduplication; accepts model names or aliases, and "default" expands to the account-type default. Overridden by the --fallback-model CLI flag for the session. See https://code.claude.com/docs/en/model-config#fallback-model-chains

関連ドキュメント

関連する変更履歴

v2.1.166(1件)

Added
Settings
メインモデルが過負荷などで利用できない場合に、最大3つまで順番に試行するフォールバックモデルの設定機能が追加されました。また、--fallback-model フラグが対話型セッションでも利用可能になりました。
英語原文を表示
Added fallbackModel setting to configure up to three fallback models tried in order when the primary model is overloaded or unavailable; --fallback-model now also applies to interactive sessions

変更前

メインモデルが利用できない場合、手動でモデルを切り替える必要がありました。また、フォールバックモデルの指定は一部の非対話型モードに限られていました。

変更後

fallbackModel 設定により、優先順位をつけた最大3つの予備モデルを自動で試行できます。対話型セッション中もこの自動切り替えが機能するようになります。

ユーザーへの恩恵

APIの過負荷や障害が発生しても、手動で設定を変更することなく作業を継続できるため、開発の生産性が維持されます。

関連ドキュメント