Claude Free vs Pro usage limits: one daily cap vs eight server buckets

Most comparisons of Free vs Pro come down to a single number: Free is roughly 30 short messages, Pro is roughly 45 per rolling 5-hour window. That is the official 5x answer and it is correct as far as it goes. The thing it misses is that Pro is not just a bigger ceiling. It is a different shape: two named windows on the server, paid overage on top, model selection that changes which sub-bucket fills first. Below is what each tier actually returns from the same internal endpoint, and why upgrading is the moment you start needing a tracker.

Direct answer (verified 2026-05-09)

Claude Free is one opaque, daily-style cap (about 30 short messages, dropping to 20 to 30 the moment you attach files), Sonnet only, no Claude Code, no Projects, no model picker. Claude Pro at $20 per month is officially at least 5x the per-session usage (about 45 short messages per rolling 5-hour window), plus a separate weekly compute budget (~40 to 80 hours of Sonnet 4), plus the model selector (Opus 4.7, Sonnet, Haiku), Projects, Cowork, Research, and Claude Code. Structurally, Pro adds two named limits where Free has one. The verified numbers come from Anthropic's usage and length limits help center and the same internal endpoint claude.ai/settings/usage renders.

Side by side, every dimension that actually changes

The 5x message multiplier is one row in this table. The other nine rows are why people upgrade.

FeatureClaude Free ($0)Claude Pro ($20/mo)
Per-session message budgetRoughly 30 short messages on a daily-style reset. Long prompts and attachments halve it.Roughly 45 short messages per sliding 5-hour window. Refills continuously as old prompts age out.
Weekly compute budgetNone. Free has no weekly cap, just the daily-style budget.Roughly 40 to 80 hours of Sonnet 4 per rolling 7 days, shared across claude.ai chat, IDE, and Claude Code.
Model selectorNo. Free is Sonnet only (Sonnet 4.6 default in 2026).Yes. Opus 4.7, Sonnet, Haiku. Opus is heavier per byte against the weekly cap.
Claude Code (local agentic loops)Not available.Included. Draws from the same five_hour and seven_day buckets as the web chat.
Projects, Cowork, ResearchNot available.Included. File memory across chats, persistent context, multi-doc Research.
Priority access during peak hoursLast in line during peak.Higher priority. Peak-hour multiplier applies to the 5-hour bucket only (not weekly).
Server JSON returned by /api/organizations/{org}/usageLargely empty. Free has no rolling 5-hour and no weekly bucket to render.Eight optional fields populate. five_hour, seven_day, seven_day_sonnet, seven_day_opus, seven_day_oauth_apps, plus two undocumented sub-buckets and an extra_usage object.
Paid overage (extra usage)Not available. You hit the cap, you wait.Available on Pro. Once enabled you keep prompting after the 5-hour pegs, billed per token. Easy to spend dollars without realizing.
Where to read your live limitNowhere useful. The Free Settings, Usage page does not render meaningful progress bars.claude.ai/settings/usage renders five_hour and seven_day bars from the same JSON ClaudeMeter polls.
Price (US, 2026)$0.$20 per month.

What the server actually returns on each tier

Every time you load claude.ai/settings/usage your browser fetches /api/organizations/{org_uuid}/usage using your existing session cookie. The response shape is identical across tiers; what changes is which fields are populated. On a typical Pro account, two of the buckets are non-null. On a Free account, the response is essentially empty for quota purposes:

Pro account response

GET /api/organizations/{org_uuid}/usage (Pro)

Free account response

GET /api/organizations/{org_uuid}/usage (Free)

That is the whole structural story. Pro has rolling-window state to track. Free has a per-session cap that the server enforces but does not surface as a sliding bucket. There is nothing for a meter to render on Free, and that is not a missing feature; it is what the tier is.

The Rust struct that handles all three tiers

ClaudeMeter parses the response with one struct, eight optional fields. That is also the shape of the comparison: zero of them populate on Free, two on Pro, four to five on Max. You do not configure the tier anywhere in the app. The deserializer reads what is there and renders only the buckets that exist.

src/models.rs

Two of those fields ( seven_day_omelette and seven_day_cowork) are internal Anthropic codenames not documented anywhere public; they only appear in the JSON the Settings page itself fetches. ClaudeMeter surfaces them in the dropdown so when one of them is what blocked you, you actually see it.

Why upgrading is the moment you start needing a tracker

On Free you cannot really overspend. The cap is a single number, you hit it, you stop. There is nothing a tracker would help you optimize. On Pro that changes in three ways at once:

Two limits, not one. The rolling 5-hour and the weekly compute budget are sibling fields on the same JSON. Either one independently 429s you. The 5-hour resets continuously as old prompts age out, the weekly hardly moves because seven days absorbs most idle time. People hit the 5-hour wall during a long refactor, then come back the next day and hit the weekly cap by Tuesday because Claude Code agentic loops chew through compute hours faster than chat does.

Model selection makes the buckets unequal. Opus is heavier per byte than Sonnet against the weekly cap. An Opus-heavy week pegs seven_day_opus while seven_day overall is at 60 percent. The fix (switch the model to Sonnet for the rest of the week) is invisible without a per-model breakdown.

Paid overage exists. Once you opt in to extra-usage on Pro, you keep prompting after the 5-hour pegs at 100%, but the requests draw from a separate dollar balance instead. Without a meter, this is invisible until your card statement. Free does not have this failure mode; Pro does.

What ClaudeMeter shows on each tier

Same binary, same brew install, two different outputs depending on which session cookie the extension picks up. The Pro view is what most readers came here for; the Free view is included so you know what to expect if you install before upgrading.

Pro account, mid-week

claude-meter status (Pro $20/mo)

Free account

claude-meter status (Free)

This is the honest answer to “does ClaudeMeter help on Free?” No. The data source does not exist on that tier. ClaudeMeter is a Pro and Max tool because Pro and Max are the tiers Anthropic actually exposes a quota state for.

When Free is the right answer, and when it is not

The 5x multiplier is real but it is the wrong axis to evaluate the upgrade on. The correct axis is workflow:

  • Stay on Free if your usage is occasional short prompts, no file attachments, no agentic loops, and you almost never hit the cap. Free is a generous tier for casual chat and one-off questions.
  • Upgrade to Pro ($20/mo) the moment you find yourself rationing prompts, switching to ChatGPT mid-task because Claude is locked out, attaching files (which halves the Free budget), or wanting Claude Code at all. The upgrade is rarely about the message count itself; it is about Claude Code, the model picker, and Projects.
  • Upgrade past Pro to Max ($100 or $200/mo) only when you are running Claude Code in agentic loops several hours a day and hitting the rolling 5-hour wall before lunch on a Pro plan. Max 5x is roughly 225 short messages per 5-hour window and 140 to 280 hours per week; Max 20x is roughly 900 messages per 5-hour and 240 to 480 hours per week.

Whichever paid tier you land on, the structural story is the same: more buckets, more sub-buckets, more reasons to surface the live numbers somewhere you can glance at.

The honest caveat

The /api/organizations/{org}/usage endpoint is undocumented. The published Anthropic numbers (Pro ~45 messages per 5 hours, ~40 to 80 weekly hours, Free ~30 messages on a daily-style reset) come from the Help Center as ranges, not contracts. Anthropic adjusted the weekly buckets multiple times since announcing weekly caps in mid-2025; the actual fraction the server checks is a weighted internal float with no published formula. The only thing you can really trust is the float in the JSON, which is why the data shape matters more than the headline number. ClaudeMeter declares every nullable field as Option in Rust, so when Anthropic adds, removes, or renames a sub-bucket, the next brew release patches it in one line. macOS only today (12+); Safari is not yet supported. The repo is open at github.com/m13v/claude-meter if you want to see exactly what it sends.

On the fence about upgrading? Want me to look at your week with you?

15 minutes. Walk me through how often you are hitting the Free cap and what you do when it locks. I will tell you whether Pro is the right move and which bucket would have been the actual constraint.

Frequently asked questions

How many messages does Claude Free get per 5 hours vs Claude Pro?

Free is roughly 30 short messages on a daily-style reset (Anthropic publishes it as a range, around 30 to 100 in light usage, dropping to 20 to 30 the moment you attach files or run long conversations). Pro is roughly 45 short messages per rolling 5-hour window, plus a separate weekly compute budget. Anthropic's official phrasing is that Pro provides at least 5x the usage of Free per session, and that ratio holds across most days.

Is the Free 'daily limit' actually daily?

Not exactly. Anthropic does not publish a hard 24-hour reset for the Free tier, the way it publishes a sliding 5-hour window for Pro. In practice it behaves more like a daily-style budget that refills over a 4 to 8 hour band depending on your timezone and load. The point is Free is a single opaque limit; Pro is two clearly named limits (rolling 5-hour and weekly) that you can read off a JSON object.

Which models do Free users get vs Pro users?

Free is Claude Sonnet only (Sonnet 4.6 as of 2026), with no model picker. Pro adds the model selector and unlocks Opus 4.7 (heavier per byte, the model agentic loops actually want for hard refactors) and Haiku for cheap drafting. The model you pick on Pro materially affects which weekly sub-bucket fills first; Opus byte for byte fills seven_day_opus faster than Sonnet does seven_day_sonnet.

Does the Free plan include Claude Code?

No. Claude Code is a Pro and Max feature. If you are on Free and want to run Claude as a local coding agent, you have to upgrade to Pro at $20 per month or use the API separately (the API is metered and not covered by either Pro or Max). The moment you turn on Claude Code is also the moment the rolling 5-hour bucket starts mattering, because agentic loops are the workload that pegs it before lunch.

Can a Free user even see their usage live?

Not in any useful way. claude.ai/settings/usage exists for Free accounts but the underlying /api/organizations/{org_uuid}/usage endpoint largely does not populate the bucket fields a Free user has. The Pro account version of that endpoint returns a JSON object with five_hour and seven_day populated; the Free version returns mostly empty. There is no rolling window to render because Free does not have one.

What does Pro actually return that Free does not?

Eight optional fields on the same JSON object. ClaudeMeter's Rust deserializer at src/models.rs lines 18 to 28 names them: five_hour, seven_day, seven_day_sonnet, seven_day_opus, seven_day_oauth_apps, seven_day_omelette, seven_day_cowork, plus an extra_usage object for paid overage. On a typical Pro account, two of those populate (five_hour, seven_day). On a Max account with Claude Code, four to five populate. On Free, zero of them populate in any meaningful way. That structural difference, not the message-count multiplier, is what changes about your day.

Is Pro at $20 per month actually 5x Free?

By Anthropic's official phrasing, Pro is 'at least 5x' the usage of Free per session, plus a weekly compute budget that Free does not have at all. In practice it lands closer to 5x to 10x depending on what you do. A heavy claude.ai writer who only sends short prompts gets a clean 5x. A Claude Code user who triggers agentic loops with attachments and Opus selected gets much more value out of Pro because Free literally cannot run those workflows.

Why does upgrading to Pro mean I suddenly need a usage tracker?

Because Pro replaces one opaque ceiling with two named ceilings (5-hour, weekly) plus paid overage. On Free you cannot really overspend; you hit the cap, you stop. On Pro you can: blow through the rolling 5-hour and not realize you have crossed onto metered overage until your card statement; or run an Opus-heavy week that pegs seven_day_opus on a Tuesday afternoon while seven_day overall is at 60 percent. ClaudeMeter exists for that gap. Free users do not need it (nothing to track); Pro users do (eight buckets, two undocumented).

Does Anthropic peak-hour throttling apply to Free or Pro?

Anthropic's March 2026 statement says the company is adjusting the rolling 5-hour window during peak hours of 5 to 11 a.m. Pacific on weekdays, while leaving overall weekly limits unchanged. That multiplier applies to Pro and Max five_hour buckets specifically, because those are the buckets that exist. Free users feel peak hour load mostly as 'priority access goes to paid users first,' not as a quota multiplier; the Free limit itself is not weighted hour by hour.

Can ccusage replace ClaudeMeter for telling me about Free vs Pro limits?

No. ccusage walks ~/.claude/projects/*.jsonl on disk and totals input_tokens + output_tokens on this machine. That is local Claude Code spend; it is a different question from server quota. ccusage cannot tell you whether you are on Free or Pro, cannot read either the 5-hour or the 7-day bucket, and cannot see browser-chat usage that is depleting the same buckets. Run ccusage for cost, run ClaudeMeter for limits. They answer different questions; many people on Pro run both.

Should I upgrade from Free to Pro just for the higher limit?

If your Free workflow is occasional short prompts and you almost never run into the cap, no. If you find yourself rationing prompts, switching to ChatGPT mid-task because Claude is locked, attaching files and watching the daily cap halve, or wanting Claude Code at all, yes. Pro is $20 per month for at least 5x the per-session usage, the model picker, Projects, and Claude Code. The honest reason most people upgrade is Claude Code, not the message count.