Skip to content
BENIBIX Learn

--fallback-model Flag

Also known as claude --fallback-model, fallbackModel

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

Think of it like

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

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.

Why it matters

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

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 code

bash
claude --fallback-model sonnet,haiku
Try Sonnet, then Haiku, if the main model is busy.
This flag sets the backup model in the drawing.

Common mistake

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

Key takeaways

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

Learn it properly