# --fallback-model Flag

> It names backup models for when the main one is busy.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** claude --fallback-model, fallbackModel

## Think of it like

It is like you call your dad if your mom does not pick up.

## Definition

--fallback-model names models to use when the main one is too busy or gone. Give a list with commas, such as sonnet,haiku. They are tried in that order. The fallbackModel setting keeps a list for all sessions. This flag wins over it for one session.

## Example

Jack's night job uses the biggest model. With --fallback-model sonnet, a busy hour just slows it down. The whole run does not fail.

## Example code

```bash
claude --fallback-model sonnet,haiku
```

Try Sonnet, then Haiku, if the main model is busy.

## Why it matters

A run keeps going on a busy day, which matters most when no one is there to restart it.

## Common mistake

Not noticing the switch. The answer may come from a smaller model, so check which one ran when quality matters.

## Three principles

- **A list.** Tried in order.
- **When busy or gone.** Not on a bad answer.
- **Flag beats setting.** For this session.

## Related terms

- [Model Fallback](https://learn.benibix.com/term/development/model-fallback)
- [Claude Code Model Alias](https://learn.benibix.com/term/ai/claude-code-model-alias)

## Taught in

- [Models, Goals and Folders](https://learn.benibix.com/learn/ai-claude-code-commands/models-goals-and-folders): Claude Code Commands, 6/17

![A call goes to the first model and fails with an error. The app sends the same call to a backup model, which answers.](https://learn.benibix.com/diagrams/dev-model-fallback.svg)

---

Source: https://learn.benibix.com/term/ai/fallback-model-flag
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-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
