Claude Code Now Falls Back to a Backup Model When Yours Is Overloaded

Claude Code's June 8–12 (Week 24) update added a fallbackModel setting. When the model you normally use is overloaded or unresponsive, it automatically switches to a backup model you've defined ahead of time. Per the official docs, you can specify up to three fallback models, tried in order.

If the first model fails, it moves to the next one in order

Anthropic's official docs state that it "tries them in order when the primary model is overloaded or unavailable." If the first model doesn't work, it moves to the second, and if that fails too, on to the third — one after another.

Until now, you set a single model, and if it got blocked, the work just stopped there. With this change, you can wire up a detour ahead of time for when something goes down.

List your fallback models in order in the config file

In your settings, you add a list of backup models to the fallbackModel field, in order. The exact format is documented under fallback model chains inside model-config in the official docs.

If you just want a one-off, there's a command-line flag too. This week's change means the --fallback-model flag now applies to interactive sessions as well (previously it was mostly for non-interactive runs).

claude --fallback-model claude-sonnet-4-6,claude-haiku-4-5

The point is keeping work from stalling during peak hours

If you're working from outside the US and overlap with US peak hours, you sometimes hit overloaded responses. With a fallback chain in place, your session can continue on another model instead of stalling. For anyone working across time zones, that's a practically meaningful change.

That said, a backup model may differ from your primary one in performance or cost, so it's worth deciding ahead of time what you want as your backup. How often the fallback actually fires and how good the results are is something you'll have to judge by using it yourself.

Sources: Claude Code — Week 24 digest, Claude Code Docs — model-config

This post is a summary of an official announcement. It is not sponsored by Anthropic in any form.

---

Original with full infographics and visual structure: https://jessinvestment.com/claude-code-now-falls-back-to-a-backup-model-when-yours-is-overloaded/