How the 5-hour rolling window works
Claude Code measures usage on a 5-hour rolling window. Once you start sending messages, a session begins and continues for five hours. Inside that window, every prompt, file read, tool call, and model response counts toward your allowance. When you hit the cap, you are blocked from sending more messages until the window rolls over.
There is also a separate weekly cap that prevents very heavy users from running constantly. Most people hit the 5-hour limit first.
What each plan tier covers
- Pro is the entry tier and covers light to moderate usage — short coding sessions, a few hours of focused work per day. Heavy debugging or codebase exploration will hit the limit quickly.
- Max x5 roughly multiplies your Pro allowance by five. Comfortable for full-time individual developers who use Claude Code most of their workday.
- Max x20 is the highest tier and is aimed at developers running long, context-heavy sessions across multiple projects. It is also the most expensive jump.
The right tier depends less on your seniority and more on your workflow style. Someone who runs many short, narrow prompts uses far less than someone who does long debugging sessions with lots of file reads.
Why you hit limits sooner than expected
Most usage gets eaten by content you did not write yourself: tool output, file content Claude Code reads on its own, repeated conversation history, and large search results. A single failing build or a few large file reads can use as much of your budget as a long thoughtful prompt.
For a fuller breakdown of what burns usage fastest, read our Claude Code usage guide. If you want to understand why the bill (rather than the limit) feels high, our Why is Claude Code so expensive? page covers that angle.
Stretch your plan instead of upgrading
The fastest way to avoid the next limit message is to reduce how much context Claude Code sends per turn. Headroom intercepts your prompts locally, strips out repetitive logs and boilerplate, and forwards a leaner version to the model. Same workflow, ~50% fewer tokens, your plan effectively lasts twice as long. No account migration, no quality loss.
For the full set of tools and tactics, see our Claude Code cost guide.