Search the documentation
9 pages for --fallback-model.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.
Manage multiple agents with agent view
Claude Code CLI · in the page
agent-view
…--strict-mcp-config` * `--settings` * `--add-dir` * `--plugin-dir` * `--fallback-model` * `--allow-dangerously-skip-permissions` Directories you added during the session with [`/add-dir`](/docs/en/pe…
Claude Code changelog
Claude Code CLI · in the page
changelog
…SE_URL` and `ANTHROPIC_AUTH_TOKEN` * Fixed compaction not honoring `--fallback-model`: compaction now falls back to the configured fallback model chain on overload or model-availability errors * F…
CLI reference
Claude Code CLI · in the page
cli-reference
…| | `--fallback-model` | Enable automatic fallback to the specified model(s) when the primary model is ove…
Model configuration
Claude Code CLI · in the page
model-config
…val and ignores extra entries. Set a chain for one session with the `--fallback-model` flag, which accepts a comma-separated list: ```bash theme={null} claude --fallback-model sonnet,haiku ``` To p…
Manage sessions
Claude Code CLI · in the page
sessions
…he session depended on `--mcp-config`, `--settings`, `--plugin-dir`, `--fallback-model`, or directories added with `--add-dir`, pass them again when you resume; directories added mid-session with `/ad…
Claude Code settings
Claude Code CLI · in the page
settings
…hest-precedence file that defines it supplies the entire chain. The [`--fallback-model`](/docs/en/cli-reference#cli-flags) flag overrides this for one session. See [Fallback model chains](/docs/en/mod…
Claude Code settings reference
Claude Code CLI · in the page
settings-reference
…request isn't retried on another model * **Per-session overrides**: `--fallback-model` takes precedence over this key for one session This example tries Sonnet 5 first, then Haiku 4.5, when your pri…
Week 22 · May 25–29, 2026
Claude Code CLI · in the page
whats-new/2026-w22
…ayed</div> <div>Claude Code now switches to your configured <code>--fallback-model</code> for the rest of the session when the primary model is not found, instead of failing every request</div>…
Week 24 · June 8–12, 2026
Claude Code CLI · in the page
whats-new/2026-w24
…ls tried in order when the primary is overloaded or unavailable, and `--fallback-model` now applies to interactive sessions too</div> <div>Session titles are now generated in the language of your…