Sweep 19 Sep 2026 · 02:36Z Build v2.1.278 500 read Stable v2.1.267 Latest v2.1.278 Next v2.1.278 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.267 ·

Headless served-model-catalog fetch now backs off exponentially after failures

Headless mode now backs off from re-fetching the model catalog after a recent failure instead of retrying every time

TierYou'll noticehow much it should matter to you
Useful2my rating, 1 to 5
Signal1worth watching, 1 to 5
AreaModel Catalogwhat it touches
KindImprovementsin v2.1.267,
You'll notice

Headless mode now backs off from re-fetching the model catalog after a recent failure instead of retrying every time

What

When Claude Code starts in headless (non-interactive, scripted) mode, it fetches a catalog of available models over the network. Now, before doing that fetch, it checks a saved marker recording whether a recent headless fetch failed. If a failure was recorded recently, it skips the network call entirely and falls back to the built-in model list, recording the reason as headless_held_off.

Success and failure are tracked in a new .headless-failed.json marker file, and repeated failures make Claude Code wait longer before trying again (exponential backoff).

Why

This avoids repeatedly hitting a failing network endpoint on every headless run, which previously could slow down or delay each invocation. If the model catalog can't be reached, headless runs now fail fast and fall back to a known-good default list instead of retrying every time.

See this entry in the whole of v2.1.267 →