Headroom

Hit your weekly limit in Claude Code? Your options

The weekly limit message in Claude Code blocks every model until the reset shown. Why automatic continue rarely kicks in, and what you can really do.

· 6 min read

"You've hit your weekly limit" means the account has used up its weekly allowance across all models, and Claude Code blocks requests until the reset time in the message. Your real options are to wait, enable usage credits, use a limit reset if Anthropic has given you one, or upgrade. Switching models will not help, and because a weekly reset is often days away, Claude Code will not start waiting for it on its own.

What the message says

Anthropic's Claude Code error reference gives this example: "You've hit your weekly limit · resets Mon 12:00am". Claude Code "blocks further requests until the reset time shown in the message" (Claude Code errors).

The weekly limit sits alongside the five-hour session limit. Anthropic says paid plans have "a session limit that resets every five hours, and weekly limits that reset once every week" (how usage and length limits work). Usage counts against both at the same time, and the errors page notes that "A single burst of heavy activity, such as a large workflow fanout, can exhaust the weekly allowance before the session window resets." So you can reach the weekly wall on a day when your five-hour window looked fine.

Why it blocks every model

The weekly limit applies across all models: "The session and weekly limits are shared across all models, so switching models doesn't restore access." That is the opposite of a model-specific message, where switching does work. If your message names a model, see switching models when one model's limit is reached.

Claude Code and the Claude apps also draw from the same pool. Per Anthropic, usage on claude.ai, Claude Code and Claude Desktop "counts towards the same usage limit" (same source). Chat use during the week counts against your terminal.

When the reset happens

The weekly reset is not seven days after you started, and it is not your billing date. Anthropic says: "Weekly limits reset at a fixed time each week that is assigned to your account. Your reset day and time stay the same regardless of when you start using Claude or when your subscription begins." The next reset is in the message itself, in Settings > Usage on claude.ai, and in /usage in Claude Code. More on the timing in the weekly limit reset time.

Why automatic continue usually stays out of it

Claude Code can wait in an open session for a limit to lift and then carry on by itself. But the interactive mode docs say it does not start that wait on its own for a reset more than 24 hours away, because "a weekly limit can reset days out."

In that case Claude Code opens its usage-limit options menu instead (the same menu as /rate-limit-options). If you really want the session to sit and wait, pick the row that starts "Wait here, then continue automatically"; a wait you choose there keeps counting down even when the reset is more than 24 hours away. Keep the session open for it to work. The wait is not offered at all in background sessions, -p runs, or with API keys, cloud providers or usage-based billing.

Your options

Wait

Free and simple. The reset time is in the message, and Claude Code works again after it.

Turn on usage credits

On Pro, Max and Ultra, usage credits let you keep using Claude after reaching any five-hour, weekly or Fable limit. They are billed at standard API rates, separately from your subscription, and you set a monthly spend limit (manage usage credits). Run /usage-credits in Claude Code to open Settings > Usage, or go there directly. Two points matter here:

  • Credits do not shorten the wait. Anthropic says they "don't affect the reset timing".
  • Credits bought on or after December 7, 2026 generally expire 12 months after purchase; credits bought earlier do not expire.

Details and the spend-limit messages are in usage credits on Claude plans. The monthly Claude Platform credits that come with Max, Ultra and Team are a different thing and do not pay for interactive Claude Code (monthly API credits).

Use a limit reset, if you were given one

Anthropic occasionally gives eligible plans a limit reset. A weekly reset puts your weekly limit back to full right away; a Fable limit reset gives back only the weekly usage you spent on Fable models. You use it from "Reset for free" in Settings > Usage on the web, Claude Desktop or the mobile apps. Anthropic notes the button "isn't currently available in Claude Code in your terminal or IDE", but because limits are shared across your account, the restored usage applies in Claude Code too. Once used, a reset cannot be undone, and your weekly limit still resets on its usual day and time (what is a limit reset). If you have not been offered one, there is nothing to click.

Upgrade

Anthropic suggests Max for Pro users and Ultra for Max users who consistently hit limits (use Claude Code with your plan). "If you upgrade, your new plan's limits apply right away." Anthropic publishes multipliers (as of November 2026, Max gives "5x Pro usage every 5 hours and every week" and Ultra "10x Pro usage every week") but not message or token counts, so you cannot predict exactly how much more a tier gives you.

Use a Console account

Anthropic's page also lists switching to a Claude Console account and buying API credits. That is pay-as-you-go API billing with no hard stop, so set a spend limit in the Console first.

On a Team seat

Team limits are per member, and one person reaching a limit does not affect others. Usage limits "can't be transferred or shared between team members" (Team plan). On Team, usage credits are set up by the organization's owners, so the path forward runs through your admin; see hitting a limit on a Team seat.

Why it might feel early

Users have reported hitting limits sooner than expected, for instance in GitHub issues #105621 and #108661. Those are user reports, not documented behaviour. Anthropic does change limits from time to time: since September 14, 2026, Claude Code's weekly limits have been 25% higher than before the May to September promotion, per Anthropic's Help Center. It also says it "may adjust usage limits at our discretion". Anthropic does not publish a token count for the weekly limit, so nobody outside it can say exactly what 100% is.

Tracking it before it bites

The weekly wall is the one worth seeing coming, because the wait can be days. Headroom is a free Mac menu bar app that shows the weekly percentage for each Claude Code account signed in on your Mac; click a row to see the reset countdown and clock time. When an account is used up, its status changes to "Back in" followed by the time until it is usable again. It reads the sign-in Claude Code already saved on your Mac and sends no prompts, so checking costs no usage. It does not change limits or switch accounts. It is independent and not made or endorsed by Anthropic. Get it at headroom.everydaymactools.com.