Claude Code usage limits: the 5-hour window and weekly cap

How Claude Code's 5-hour window and weekly limit work, what makes you hit them, how to check usage, and what to do the moment Claude Code stops.

· 5 min read

On a Claude Pro or Max plan, Claude Code runs against two limits: a rolling 5-hour session window and a weekly limit. They are shared with Claude chat on claude.ai, so a long conversation there counts too. When you hit one, Claude Code tells you when it resets, and in recent versions it can wait and continue the task by itself.

#How do the 5-hour and weekly limits work?

Anthropic's help center describes it this way for Pro and Max: there is a five-hour session limit and a weekly limit, and "these limits are shared across Claude and Claude Code". Some tiers differ (for example, a separate weekly limit for certain models), and the exact amounts change, so this article gives no numbers. Your plan's page on claude.com is the source of truth.

The practical model:

  • The 5-hour window is the one you feel day to day. It is a usage allowance that refills on a rolling basis, not a count of messages.
  • The weekly limit is the backstop. Heavy days feed it; a hard Tuesday can leave less for Friday.
  • Usage is tokens, not prompts. One short prompt that makes Claude read thirty files can cost more than twenty chat messages.

On Team and Enterprise, each seat has an allowance on the same kind of rolling five-hour and weekly windows, shared with chat. Admins can add usage credits and spend limits on top.

#How do I check how much I have used?

Run /usage in Claude Code. On a subscription plan it shows plan usage bars, activity stats and a breakdown of what counted against your limits: skills, subagents, plugins and individual MCP servers, each as a percentage, plus recommendations. Press d or w to switch between the last 24 hours and the last 7 days.

Three caveats from the docs:

  • The figures are computed from session history on this machine, so usage on other devices or on claude.ai is not in the breakdown, even though it counts against your limits.
  • The Session block at the top of /usage (a dollar figure) is meant for API users. As a subscriber, ignore it for billing purposes.
  • /status shows which account and credential Claude Code is using.

If /usage shows a message like "rate limited until 3:14am", that means Claude Code cannot fetch your usage numbers until then, not that your work is blocked.

#What makes me hit the limit faster?

The docs list the causes of a session using more than your activity suggests:

  • Long context. The full conversation is sent with every request, and every tool call is another request. See Claude Code's context window.
  • Cache misses. Your first message after a break longer than the cache lifetime reprocesses everything.
  • Subagents and agent teams. Each one makes its own requests on top of the main conversation. Agent teams, where enabled, multiply this roughly by the number of teammates.
  • Scheduled tasks and loops. A /loop or other session-scoped schedule fires even while you are away, with your full context each time.
  • Parallel sessions. Five sessions is five times the burn on one plan. See running several sessions at once.
  • Extended thinking and high effort. Thinking tokens are billed as output. Lower effort with /effort for simple work.
  • The model you pick. Bigger models use more of your allowance for the same job.

/usage flags behaviors behind 10% or more of your recent usage, which is the fastest way to find your own culprit.

#What happens when I hit the limit?

You see a message such as "You've hit your session limit" or "You've hit your weekly limit", with the reset time. Switching models with /model does not help for these, because the window is shared across models. There are separate messages when a limit applies to a single model family; in that case a model outside that family keeps working.

Claude Code v2.1.234 and later add a better option. In an interactive session signed in with a claude.ai subscription, it waits and continues on its own after the reset:

Usage limit reached · limit resets 3:45pm
Continuing automatically at 3:45pm · Esc to cancel

Keep the session open. At the reset it prompts Claude to pick the task up where it stopped (it does not resend your last message). If your computer slept for more than about 30 minutes across the reset, it asks you to press Enter instead. Permissions still apply, so a task can stop on a prompt while you are away. After three automatic continuations it stops and points you to /rate-limit-options, where you can choose what to do next or pick "Don't continue automatically". An admin setting, autoContinueAtUsageLimit, controls this for a team.

Other ways out, in order of effort:

  1. Wait for the reset and do something that does not need Claude: review the diff, write the next prompt.
  2. Add usage credits with /usage-credits. It opens your usage settings on claude.ai, where you can turn credits on and set a monthly spend limit. They bill at API rates, separate from the plan.
  3. Use another account that is genuinely yours (a team seat, say). See using several Claude accounts.
  4. Change plan if it keeps happening. See Claude Pro or Max for Claude Code.

One trap: if ANTHROPIC_API_KEY is set in your environment, Claude Code uses the key after you approve it and bills the API instead of your plan. unset ANTHROPIC_API_KEY and check /status if that is not what you want.

#How do I make the window last longer?

  • /clear between unrelated tasks; /compact <focus> in long ones.
  • Match the model and effort to the job. Routine edits do not need the heaviest setting.
  • Give specific prompts and verification targets so there are fewer rework loops.
  • Use plan mode before big changes, so a wrong direction costs a plan, not an implementation.
  • Send verbose work (test runs, log digging, docs lookups) to a subagent on a smaller model.
  • Cap what runs unattended: loops, routines and background agents burn the same pool.
  • Press Esc early when Claude heads the wrong way. /rewind restores code and conversation.

Each of these takes seconds. A long session left to grow without them is what drains the window.

#In Relais

Relais runs your own Claude Code login, so everything it starts counts toward the same 5-hour window and weekly limit, exactly as in a terminal. It shows your window under your account in the sidebar with its reset time. A session stopped by the limit carries on by itself about a minute after the reset, with the computer kept awake; with a second account or organization added, it carries on there at once. Agents also stop starting new work past a share of your plan (85% by default, adjustable). More in the FAQ and on features.

Claude Code,
better organized.

$14.99 a month, everything included. Mac and Linux, on your Claude Pro or Max plan. Cancel any time.