claude --fallback-model when overloaded: Sume paid calls
--fallback-model switches Claude Code to another model when the main one is overloaded. Sume's spend caps and idempotency keys are independent of the model.

--fallback-model makes Claude Code switch to a named model when the primary is overloaded. A fallback changes who writes the next turn, not what Sume does: max_spend_usd, idempotency_key and the job you already started are unchanged, so a mid-run switch cannot double-bill a render if the agent reuses the idempotency_key or reads the job it already started.
What does the flag do?
The CLI reference lists --fallback-model as automatic fallback to the specified model or models when the primary is overloaded. It says nothing about what the second model remembers, so assume it reads the same conversation and nothing more.
| Flag | Effect |
|---|---|
| --fallback-model | Automatic fallback to the specified model(s) when the primary is overloaded |
What can go wrong with Sume jobs?
The risk is a model that re-runs a create it did not see finish. Two guards cover it on Sume:
- Every paid or write MCP call needs
idempotency_key. Use a key derived from the task, not from the turn. - Print the job id as soon as a create returns, so the next model waits on it with
jobs_waitinstead of submitting again.
Does the fallback model need the same tools?
The tools come from the MCP config, not the model. Whether a given Sume model is available to your agent is a separate question: the catalog is read with catalog_list. Do not assume a model name from a changelog is in it.
Which cap protects you?
Claude Code's budget flag is a client-side estimate. The Sume cap is max_spend_usd on the call. Use both; see MCP tools and gates.
Sources
Related posts
More in Agents
- Stopped a Sume MCP call in Claude Code? The job still runs
Stopping a long Sume MCP wait in Claude Code does not stop the render. The job keeps running and billing; find the job id, then wait again, read or cancel.
- Claude Motion makes MP4s from code: when a Sume Agent run fits instead
Claude Motion (beta, 2026-10-08) animates text and charts as code. Sume Agent Completions generate footage and return media URLs. Which fits which job.
- Codex worktrees run agents in parallel: one Sume queue
Codex CLI 0.162.0 adds managed worktree tools. Parallel agents in worktrees still share one Sume workspace: plan concurrency, queue and 429 queue_full apply.
- Daily Sume schedule: skipped and canceled runs send no webhook
A Sume run webhook fires only on completed or failed. For a daily schedule, a skipped or canceled run is silent, so add a list-runs check each morning.
Written by Sume