Limits checked September 23, 2026

The Claude Code weekly limit, explained

"You've hit your weekly limit" is the message that sends people searching. Here's what the weekly cap is, how it differs from the 5-hour window and the Opus allowance, why a session that felt light used so much, and the short list of things that actually stretch it.

Advertisement

Three limits, not one

LimitApplies toResetsMessage you'll see
5-hour session windowAll models, all Claude surfaces on the plan5 hours after the first message of the window"You've hit your session limit"
Weekly capAll models; shared with Claude chat and CoworkRolling 7 days; exact time shown in /usage"You've hit your weekly limit"
Weekly Opus allowance (Max only)Opus-family models onlyRolling 7 days"You've hit your Opus limit"

The three are independent. Running out of the 5-hour window doesn't touch the weekly cap, and vice versa. The message matters: a model-specific limit ("Opus limit", "Sonnet limit") means switching to a model outside that family with /model keeps you working. A session or weekly limit is shared across all models, so switching does nothing.

Published sizes, per Anthropic's plan page: Pro gets roughly 40–80 Sonnet hours a week; Max 5x 140–280 Sonnet plus 15–35 Opus; Max 20x 240–480 Sonnet plus 24–40 Opus. The weekly limit calculator estimates which day of the week you'll run out from your hours and session intensity.

Why it's measured in hours but spent in tokens

Anthropic describes the limits in "hours of Sonnet" because that's intuitive, but the meter underneath counts tokens. That's why the published figures are ranges: an hour of short prompts on small files might cost a fifth of an hour spent in a 150,000-token conversation with tool calls flying. Four things move you between the low and high end of the range:

  • Context length. Every request resends the whole conversation. Prompt caching makes re-reading history cheap (cached tokens cost a tenth of fresh ones) but not free, and a session open since morning carries the morning with it.
  • Cache misses. After a break longer than the cache lifetime, an hour on a subscription, your next message reprocesses the full context at full price. The /usage breakdown flags "cache misses" when they're 10% or more of your recent usage.
  • Model. Opus costs about 2.5 times Sonnet per token and Fable about 5 times, so an Opus session draws the shared weekly cap proportionally faster, as well as the Opus allowance.
  • Parallelism. Subagents, agent teams and scheduled tasks each send their own context. Anthropic's docs put agent teams at roughly seven times the tokens of a normal session.

Things that use your limit while you're not typing

This is the part that surprises people. A session can draw usage while idle: scheduled tasks fire on their interval and send the full context each time; cross-session messages from another Claude Code session arrive as new turns; goal check-ins on background work start new turns (capped at three per goal); active agent teammates keep consuming until they exit. Background summarization for claude --resume uses a small amount too, usually under $0.04 of API-equivalent per session. If your weekly bar moved overnight, look for a loop or a teammate you forgot about. /usage lists the heaviest scheduled tasks by tokens.

How to see exactly where you stand

  • /usage shows plan usage bars for the 5-hour and weekly windows, a breakdown of what's consuming them (skills, subagents, MCP servers, loops), behavior flags like long context, and your usage-credit spend if credits are on. Press d or w to toggle 24 hours vs 7 days.
  • /context shows what's occupying the current context window, which is where the per-request cost comes from.
  • The status line can display context usage continuously so you notice a bloated session before it eats a window.
  • On claude.ai, Settings → Usage shows the same bars plus usage-credit balance and spend limit.

What to do when you hit it

  1. Read the message. Model-specific: switch models. Session: wait up to 5 hours. Weekly: wait for the shown reset time.
  2. Let Claude Code wait for you. Recent versions can hold the interrupted task and continue automatically when the window resets (/rate-limit-options).
  3. Turn on usage credits. /usage-credits opens Settings → Usage, where extra usage bills at standard API rates up to a monthly limit you set. Note the cache lifetime drops from an hour to five minutes while you're on credits, so long idle gaps get more expensive.
  4. Upgrade if it's the third time this month. The Pro vs Max guide has the hours math.

How to stretch it

In order of impact: /clear between unrelated tasks (with /rename first so you can /resume later); keep Sonnet as the default and reach for Opus deliberately; keep CLAUDE.md under 200 lines and move workflow instructions into skills that load on demand; disable MCP servers you aren't using; delegate log-reading and test runs to subagents so the verbose output stays out of your main context; and write specific prompts, because "improve this codebase" triggers a scan of everything. The token-saving guide goes through each with the command to run.

Estimate the day I'll hit my weekly limit →

Frequently asked questions

When does the weekly limit reset?

On a rolling seven-day cycle. /usage and the limit message show the exact time.

Is the 5-hour limit part of the weekly limit?

No. They're independent windows; you can exhaust one without touching the other.

Is the Opus limit separate?

On Max plans, yes: a smaller weekly Opus allowance alongside the all-models cap. Switching to Sonnet gets around an Opus-only limit.

Why did an idle session use my limit?

Scheduled tasks, agent teammates, cross-session messages and goal check-ins all send your full context without you typing.

Does Claude chat count against the same limit?

Yes. Chat, Cowork and Claude Code share the plan's allowance.

Can I buy more without upgrading?

Yes: usage credits bill extra usage at API rates up to a monthly limit you set.

Sources