How Claude Code rate limits actually work

Two overlapping windows, one weekly ceiling, and the habits that burn your quota fastest.

Almost every "Claude is unusable today" complaint is a rate limit, not an outage. The limits are not a single counter — they are two windows running at once, and misunderstanding either one makes the plan feel broken.

The short window

The first limit is a rolling block of roughly five hours. Usage accumulates inside it, and when you cross the threshold you wait for the block to move, not for a reset timer you can see. This is the limit people hit on a heavy afternoon: the work is going fine, then everything stops for an hour.

Practical consequence: the block rewards pacing. Twenty short requests spread over five hours cost far less than the same twenty fired in one long agent run, because the second one stacks context on every turn.

The weekly ceiling

The second limit is a weekly cap. It exists to stop the pattern where somebody avoids the short window by staying just under it all day, every day. You will not notice it for a week and then lose most of a day to it. If your usage is steady rather than bursty, the weekly cap is the one that actually governs your plan.

What burns quota fastest

• Long agent loops on large repositories. Every iteration re-reads context. A twenty-step loop is not twenty times one step — it is closer to two hundred.
• Parallel sessions. Three sessions in one repository triple the reads and can invalidate each other's cache.
• Huge pasted files. Pasting an entire log or a 3 000-line file once is often cheaper than asking the agent to read it repeatedly — but pasting it into every new session is worse than either.
• Restarting sessions instead of continuing. A fresh session re-establishes context from scratch. If the previous session was healthy, continuing is cheaper.

How to make a smaller plan behave like a bigger one

Scope the agent before you start it: one directory, one goal, one stop condition. Ask for a plan first and approve it, so the expensive exploration happens once. Keep a scratch file with the decisions made so far, so a new session does not rediscover them. And do the cheap edits by hand — not every change deserves an agent.

When to move up a tier

If you hit the short window more than once or twice a day, or lose real work to the weekly cap, the next tier is cheaper than the interruption. If you hit it once a week, it is not. The Max 20x plan exists for the first case; most people are in the second.

Back to plans →