# fallbackModel

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

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** fallbackModel setting, backup model

## Think of it like

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

## 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

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

## Example code

```json
{
  "fallbackModel": ["sonnet", "haiku"]
}
```

Try Sonnet, then Haiku, if the main model fails.

## Why it matters

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

## Common mistake

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

## Three principles

- **Backups in order.** When busy.
- **For one turn.** Then back.
- **No merging.** Highest file wins.

## Related terms

- [--fallback-model Flag](https://learn.benibix.com/term/ai/fallback-model-flag)
- [model Setting](https://learn.benibix.com/term/ai/model-setting)
- [Claude Code Settings Precedence](https://learn.benibix.com/term/ai/settings-precedence)
- [fallbackModel Option](https://learn.benibix.com/term/ai/fallback-model-option)

![When the main model is overloaded, Claude Code tries each fallback model in order for the rest of that turn.](https://learn.benibix.com/diagrams/fallback-model-chain.svg)

---

Source: https://learn.benibix.com/term/ai/fallback-model-setting
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
