Guide
When does Claude Code usage reset?
Claude Code usage resets on two separate timers: a 5-hour session window that starts when you send your first message, and a 7-day rolling weekly cap. Understanding both is key to planning your work.
The 5-hour session window
Every time you start using Claude Code, a 5-hour countdown begins from your first message. Within this window, you have a fixed amount of usage (tokens, messages, and tool calls). Once you hit the limit, Claude Code pauses until the 5-hour window expires.
You can check your remaining quota and exact reset time by running
/usage inside Claude Code. For a more detailed view:
npx vusage limits VibeUsage shows both your 5-hour and 7-day windows with exact reset timestamps.
The 7-day weekly cap
Separately from the 5-hour window, Anthropic tracks a rolling 7-day usage cap. If you exhaust this weekly budget, even a fresh 5-hour window will not restore your access — you need to wait for the oldest usage to roll off.
This mainly affects heavy users who run Claude Code for many hours every day. Most developers on a Pro plan hit the 5-hour limit occasionally but never reach the weekly cap.
Pro vs Max plan limits
| Plan | 5-hour window | 7-day cap | Best for |
|---|---|---|---|
| Pro ($20/mo) | Standard | Standard | Light to moderate use |
| Max 5x ($100/mo) | 5x larger | 5x larger | Daily heavy use |
| Max 20x ($200/mo) | 20x larger | 20x larger | Full-time AI-assisted coding |
Tips to stay within limits
- Use
/compactto compress conversation context when it gets long — saves tokens. - Start new sessions for unrelated tasks instead of continuing one long session.
- Use
npx vusageto understand your usage patterns — you might find that 40% of your tokens go to file reads that could be replaced with targeted Grep calls. - Batch similar tasks — context switching between topics wastes tokens on re-explanation.
Frequently asked questions
How often does Claude Code usage reset?
Claude Code usage resets every 5 hours from the time you send your first message in a session. There is also a separate 7-day weekly cap that resets on a rolling basis.
How do I check when my Claude Code usage resets?
Run /usage in Claude Code to see your current usage and reset time. You can also use the open-source CLI tool VibeUsage (npx vusage limits) for a detailed breakdown of both 5-hour and 7-day windows.
What happens when I hit the Claude Code usage limit?
When you hit the 5-hour session limit, Claude Code tells you to wait until the window resets. If you hit the 7-day weekly cap, you need to wait for the oldest usage to roll off. Upgrading from Pro to Max increases both limits.
Does upgrading to Claude Max help with usage limits?
Yes. Claude Max plans (5x and 20x) provide significantly higher usage limits than Pro. The 20x Max plan gives roughly 20 times the usage of the Pro plan for both session and weekly windows.
Track your usage with VibeUsage
Open-source CLI that shows sessions, tokens, rate limits, and personalized tips.
npx vusage Want real-time monitoring in your MacBook notch? Try Vibe Island.