Skip to content
BENIBIX Learn

fallbackModel

AI⌨️ Claude CodeConfiguration

Also known as fallbackModel setting, backup model

A list of backup models for when the main one is busy.

Think of it like

It is like a spare tire. You use it when the main one goes flat.

Example

Jack's long jobs kept stopping when Opus was busy. He sets a fallback chain, and the work goes on with Sonnet.

Why it matters

Without it, a busy model stops the turn with an error.

Definition

fallbackModel is a settings key that lists backup models to try, in order, when the main model is busy or down. Claude Code moves to the next one for the rest of that turn and shows a note. Your next message tries the main model first again. It does not merge across files: the highest file gives the whole list.

Example code

json
{
  "fallbackModel": ["sonnet", "haiku"]
}
Try Sonnet, then Haiku, if the main model fails.
The chain is tried in order, for one turn only.

Common mistake

Expecting chains from two files to join. The highest file's list is used on its own.

Key takeaways

  1. 1
    Backups in order. When busy.
  2. 2
    For one turn. Then back.
  3. 3
    No merging. Highest file wins.