Understanding Rate Limits

Claude Code enforces rate limits to manage capacity across all users. Understanding how these limits work helps you plan your usage and avoid disruptions.

Two Rate Limit Windows

Claude Code uses two overlapping rate limit windows:

The primary rate limit is a rolling 5-hour window. Your usage within the past 5 hours is tracked as a utilization percentage. When this reaches 100%, you are rate limited until enough time passes for older usage to fall outside the window.

Key points:

The window rolls continuously - it is not a fixed 5-hour block
As time passes, older usage drops off and your utilization decreases
Heavy bursts of usage can trigger this limit quickly
Once rate limited, you typically need to wait for older usage to age out

7-Day Rolling Window

The secondary limit is a 7-day rolling window. This prevents sustained heavy usage over longer periods. Even if you stay under the 5-hour limit during individual sessions, consistently heavy usage across a week can trigger the 7-day limit.

Key points:

Tracks cumulative usage over the past 7 days
Designed to distribute capacity fairly across all users
Harder to recover from since the window is much wider
Requires pacing your usage across the week

Utilization-Based Limits

Anthropic does not publish specific token counts for rate limits. Instead, the system works with utilization percentages. When you check your rate limit status, you see a percentage representing how much of your allocation you have used within each window.

This means the actual capacity can vary. Anthropic adjusts limits based on overall system load and plan tier. The percentage is the authoritative measure of how close you are to being rate limited.

Plan Differences

Pro Plan ($20/month)

The Pro plan includes Claude Code access with standard rate limits. This tier is suitable for moderate daily usage but can be limiting for heavy, sustained coding sessions.

Max Plan ($100/month)

The Max plan at the $100/month tier provides significantly higher rate limits. Users who regularly hit Pro limits will see a meaningful improvement.

Max Plan ($200/month)

The Max plan at the $200/month tier provides the highest rate limits available. This tier is designed for power users who use Claude Code extensively throughout the day.

What Happens When You Hit the Limit

When you reach 100% utilization in either window:

Claude Code displays a rate limit message
You cannot send new prompts until utilization drops
The 5-hour window recovers as older usage ages out
The 7-day window recovers more slowly

You are not charged extra or penalized beyond the temporary restriction. The limit is purely about pacing usage.

Monitoring with My Claude

My Claude displays both windows in real time on the dashboard. The Rate Limit Alerts feature lets you set threshold notifications so you know when you are approaching the limit, and the pace calculator predicts whether your current rate of usage will cause you to hit the limit before the window resets.