Explainer

Claude Code usage limits, explained — and what to do when you hit one

Claude Code usage limits, explained — and what to do when you hit one

Every Claude Code power user eventually meets the same message mid-task: usage limit reached. It always feels random, and it never is. Claude subscriptions run two meters at once — a 5-hour rolling window and a weekly cap — and once you can picture both, the lockouts stop being surprises and start being schedulable. Here's how the system actually behaves in July 2026, and a playbook for the moment it says no.

The two meters

The interplay is what catches people. A brutal Monday can leave your week thin by Thursday; a quiet week still won't save you from an unscoped afternoon that torches the rolling window. Neither meter cares that you were "almost done."

Why agent work burns limits faster than chat

A coding agent re-reads its world on every turn — files, diffs, tool output, its own history. Input tokens outnumber output by an order of magnitude, and your limit is spent on both. The practical levers, in descending order of impact: scope tasks tightly (an agent told exactly what to do reads less to figure it out), run /compact before long sessions drift, don't paste the world into the prompt, and route grind work to cheaper contexts — the fancy model doesn't need to write your test boilerplate. The same math drives paid-API costs, which we broke down in Fable 5's pay-per-token pricing — limits are just the subscription currency for the identical physics.

The lockout playbook

When the message lands mid-task, you have four moves:

Frequently asked questions

What are the Claude Code usage limits in 2026?

Two concurrent meters on every plan: a 5-hour rolling window and a weekly cap, both scaled by tier. The 5-hour caps doubled May 6, 2026; weekly caps ran +50% through July 13. Heavy days spend the window, heavy weeks spend the cap.

When does the limit reset?

The rolling window frees up continuously as ~5-hour-old usage falls off. The weekly cap resets on the fixed schedule shown in the lockout message.

Why did I hit the limit so fast?

Agent sessions re-read context every turn — input dominates. Unscoped sessions, giant pastes, and skipping /compact burn the meters fastest.

How do I keep working after "usage limit reached"?

Wait for the window, buy overage at API rates, switch the task to a second CLI — or hand off the session context automatically, which is what Backgrind's quota failover does.

Where Backgrind fits

Backgrind treats the lockout as an event, not a dead end. Its quota failover watches the session for usage-limit exhaustion, and the moment Claude taps out it raises a decision card on every surface — overlay, phone, Fleet board. Accept, and the session's context hands off to a Grindy agent in the same folder; the work keeps moving while your window refills. Limits become a routing decision instead of a forced break — which is the whole point of not babysitting your agents.