Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.166 ·

fallbackModel setting in settings.json

Entry
JSON All of v2.1.166
EntryKind: in v2.1.166,
ChangesSection of the release
What

The fallback model list can now be set in settings.json as an array, not only via --fallback-model on the command line.

Usage
# Via CLI (comma-separated, as before)
claude --fallback-model sonnet,haiku

# Via settings.json (new — array form)
# In ~/.claude/settings.json or project .claude/settings.json:
# { "fallbackModel": ["sonnet", "haiku"] }
Details
  • Accepts model name aliases such as "sonnet", "haiku", or "default" (which expands to the current default model)
  • CLI --fallback-model takes precedence over the setting
  • The setting is also available in managed settings for enterprise deployments
  • Models that are not recognized or not available in the current context are silently skipped
Evidence

New fallbackModel schema field (search for 'Fallback model(s) tried in order when the primary model is overloaded or unavailable')

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

How sure we are
One source agreesOne thing we can check says the same as this entry.
Anthropic's release notes agreeAdded fallbackModel setting to configure up to three fallback models tried in order when the primary model is overloaded or unavailable…

See this entry in the whole of v2.1.166 →

Feedback