Pause Desktop workflows at the usage limit
CHANGELOG · original
Changed workflows in the desktop app's Code tab to pause at a usage limit and continue after it resets Open official changelog ↗ Documentation
Documentation excerpt
When a run hits your usage limit
When an agent hits your claude.ai usage limit, the run pauses rather than failing that agent. The agents that hit the limit wait for the reset, and no new agents start. Shortly after the limit resets, the waiting agents run again and the run continues on its own. Requires Claude Code v2.1.271 or later, or v2.1.319 or later in the Desktop Code tab. On earlier versions, the affected agents fail.
While the run waits, its progress line in the task panel and the /workflows header show when the limit resets. In the Code tab, the run shows a line such as Paused at usage limit · continues after 3:45 PM if the app stays open. Keep the app open.
The run pauses only when all of these hold; when one doesn't, the affected agent fails instead:
- The session is signed in with a claude.ai subscription without usage-based billing, and is one of these session types:
- An interactive terminal session. A run doesn't pause in non-interactive mode with
claude -por the Agent SDK, in a background session, or in a Remote Control or agent team teammate session. - A local session you started in the Code tab. A run doesn't pause in an SSH, WSL, Dispatch, or scheduled task session, in one started from Remote Control or through a corporate launcher, or while
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICis set.
- An interactive terminal session. A run doesn't pause in non-interactive mode with
autoContinueAtUsageLimitis on, the same setting that lets the session itself wait for a usage limit to reset. If you turn it off during a wait, the wait ends and the waiting agents fail.- In the Code tab, the Auto-continue when limits reset checkbox on a session-limit card is checked, as it is by default. If you uncheck it, runs in your Code tab sessions stop pausing, unless managed settings set
autoContinueAtUsageLimittotrue. - The limit resets within 24 hours. A weekly limit can reset further out.
- The run hasn't already waited twice. When it hits the limit a third time, the agent fails.
To finish a run whose agents failed at the limit, ask Claude to relaunch the workflow after the limit resets.
Documentation snapshot · 2026-11-20