VCode home

Try again by itself after a temporary model error

Agents: claude, codex, opencode · On: phone, desktop

When a turn fails because the model is overloaded, the provider has a server error or the stream drops, the tab waits and tries again by itself: after 30 seconds, then 1, 2 and 5 minutes. After four tries it stops and shows the error.

Why you would use it

You start a long task from your phone and walk away. Codex answers Selected model is at capacity or Claude's API is overloaded for a minute. The work should carry on when the provider comes back, without you noticing the failure and sending it again.

How to use it

Nothing to do. While the tab waits you can:

  1. Tap Retry now on the line to try at once.
  2. Tap Cancel to stop waiting. The error stays, with Retry beside it.
  3. Or type a message. Sending one cancels the wait: that is you taking over.

A Claude tab waiting to try again: the amber line at the end of the transcript with the countdown, Retry now and Cancel

What you see

A line at the end of the transcript with an amber ring:

Claude Code hit a temporary error. Trying again by itself, attempt 2 of 4.

Under it, in grey, the provider's own words, such as Codex's Selected model is at capacity. Please try a different model. On the right, the time left in amber (45s, 4m 05s), Retry now and Cancel.

The line close up: the sentence with the attempt, the provider's words, the countdown, Retry now and Cancel

When the time is up the line reads … Trying again now, attempt 2 of 4. and the next try starts. The tab tells the agent to continue from where it left off; your message is not sent again.

In the status bar, an amber segment counts down: ⟳ retry 45s. Tapping it shows the longer form as a toast, for example Claude Code temporary error · retry 2 of 4 at 14:21 (in 45s).

The toast after tapping the status bar's retry segment

After the fourth try fails, the line turns red and reads Claude Code hit an error. with the provider's words, as any error does.

Options and settings

Option Default What it changes
Wait before each try 30 s, 1 min, 2 min, 5 min Each wait is up to 20% shorter or longer at random, so tabs that failed together do not all come back at the same moment. Fixed; there is no setting

Limits and known gaps