settings.json

fallbackModel

型string[]記述場所どの設定ファイルでも可

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

記述例

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

使い方・用途

  • 特定のモデルがダウンしている際、自動的に代替モデル(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
メインモデルが過負荷などで利用できない場合に、最大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

変更後

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

関連ドキュメント