Justin McKelvey

Justin McKelvey

Fractional CTO · 15 years, 50+ products shipped

AI Tools 6 min read

Claude Code Usage Limits (2026): The Five-Hour Window, the Weekly Cap, and Why There Is No Message Count

The short answer

Claude Code does not have its own limit. It draws from one shared pool with Claude on web, desktop and mobile, that pool resets on a rolling five-hour session window, and paid plans carry weekly caps on top of it. Anthropic publishes no fixed message count, on purpose, because usage depends on how long your conversations are, which model you run, and which features you use. As of September 2026 the only scale it publishes is relative: Pro is at least 5x Free per five-hour session, and Max is 5x or 20x Pro.

If you came here after hitting a wall at 2pm, skip to the four levers. If you came here to pick a plan, the table is next. And if your bill says you owe money on a plan you already pay for, read the API key section, because that is the answer roughly every time.

What the limits actually are

Here is Anthropic's own wording from the pricing page, read today: "Every plan has usage limits that reset on a rolling five-hour session window, and paid plans add weekly limits on top. Your activity across Claude on web, desktop, mobile, and Claude Code all draws from the same pool."

Three things follow from that sentence, and each one surprises somebody every week:

  • The window is rolling, not a calendar block. It is five hours from when your session started, not "resets at midnight."
  • There are two limits, not one. The five-hour window is the one you feel; the weekly cap on paid plans is the one that ends a heavy Thursday. Anthropic also reserves the right to add monthly caps or per-model and per-feature limits "at our discretion," which is worth reading before you build a business process on top of a fixed allowance.
  • Chat competes with code. A morning of research in the web app spends the same budget as an afternoon of refactoring in the terminal.

The plans, as published

Plan Price (claude.com, September 20, 2026) Usage, as Anthropic states it
Free $0 "Everyday questions." Claude Code not included.
Pro $17/mo on annual ($200 up front), $20 monthly At least 5x Free per five-hour session
Max From $100/mo Choose 5x or 20x Pro per five-hour session
Team, Standard seat $20/seat/mo annual, $25 monthly "More than Pro"
Team, Premium seat $100/seat/mo annual, $125 monthly 5x a Standard seat
Enterprise $20/seat/mo annual + usage at API rates Pooled, reset on a rolling window

Read the multipliers carefully, because they chain off different bases. Pro is measured against Free. Max is measured against Pro. Team Premium is measured against Team Standard, and Team Standard is only ever described as "more than Pro," which is the vaguest cell in the table and the one a finance person will ask you about. The full plan-by-plan breakdown, including what each tier includes beyond raw usage, is on my Claude AI pricing page, and the chat-side caps are in Claude usage limits.

The buried arbitrage: a Team Premium seat and an individual Max 5x plan are both $100 a month. One gives you admin controls, centralized billing and seat management; the other gives you a personal plan with the 20x option available. At that price point you are choosing governance, not dollars.

The environment variable that bills you twice

This is the single most common "why am I being charged" story, and it is documented right in Anthropic's help center: if an ANTHROPIC_API_KEY environment variable is set on your system, Claude Code authenticates with that key instead of your subscription, and you are billed at API usage rates rather than drawing on the usage your plan already includes.

It usually happens to people who followed an API tutorial once, exported the key in their shell profile, and forgot. The plan looks fine. Claude Code works fine. And a Console invoice shows up for work a $20 subscription had already paid for. At Sonnet 5's published $2 per million input and $10 per million output tokens, a serious week in a large repo is not a rounding error.

The fix: unset the variable, run /logout inside Claude Code, run claude update, restart the terminal, then /login and choose the subscription account. If you want the API billing on purpose for a sprint, that is legitimate, and the plan-versus-API math is in my Claude Code pricing breakdown.

Four levers that actually stretch a session

Anthropic's own Claude Code guide is blunt about the mechanism: every turn resends the entire conversation so far, plus your CLAUDE.md, plus every file Claude has read. A session that has wandered through three problems pays for all three on every new message. That single fact explains most "I burned my limit by lunch" reports, and it points at four levers:

  • Clear between tasks. /clear wipes the history and keeps your CLAUDE.md and project files. Anthropic calls it the single most effective lever for both quality and cost. The test: if your next prompt would make sense in a brand-new terminal, clear first. It cannot be undone, so use /compact instead if you might still need the history.
  • Match the model to the job. Opus "uses meaningfully more of your quota" than Sonnet, and Sonnet more than Haiku. Plan with Opus, execute with Sonnet, do renames and boilerplate with Haiku. /model switches mid-session without losing the conversation.
  • Point at files, do not paste them. Anything pasted sits in context in full for the rest of the session. Note the detail most people miss: the @ prefix injects the whole file plus its CLAUDE.md tree, so a bare path is the cheaper way to reference something.
  • Use projects for anything you reuse. Per Anthropic's best-practices article, content in projects is cached and does not count against your limits when reused. If the same spec, schema or style guide goes into Claude every week, a project is a genuine discount, not a filing convenience.

One counterintuitive item: long conversations that trigger automatic context management consume more of your limit, not less. The summarization is doing work. Starting a fresh conversation is cheaper than letting one run forever.

Why there is no message count anymore

Third-party pages still print numbers like "45 messages every five hours." Anthropic's current help centre does not, and its best-practices article instead lists eight things that move your usage: message length, attachment size, conversation length, tool usage, model choice, effort level, artifact creation, and multi-step tasks like running code or browsing.

That is not evasion, it is accurate, and it changes how you should plan. A team that budgets "so many messages per developer" is budgeting a unit that does not exist. The unit that does exist is a five-hour window, and the thing you control inside it is context. As of 2026, treat your limit like a fuel tank whose consumption depends on how you drive, and check Settings then Usage before a long session rather than after.

The owner's version

If one person lives in the terminal, budget Max from $100 a month and stop agonizing. If you are buying for a team, the Team Premium seat at $100 annual is the same money as individual Max 5x with admin controls attached, and that, not the raw allowance, is the reason to choose it. If your people keep hitting caps on Pro, the cheapest fix is usually not a plan upgrade: it is teaching them /clear, projects, and model switching, which routinely buys back more than the difference between tiers. My comparison of where the caps land across ChatGPT, Claude, Gemini and Copilot is in AI usage limits.

Setting this up properly across a small team, with the right plan, the projects that actually cache, and the workflows that do not burn a window by 11am, is what my Claude for Small Business install does, from $4,500.

Next step Get the free cost sheet →

Free Resource Justin McKelvey

What your AI stack actually costs

Prices changed 3x this year. The always-current cost sheet: sticker price vs what heavy use actually costs for Cursor, Claude, Replit, Lovable, Bolt & more.

Frequently Asked Questions

What are the Claude Code usage limits?
As of September 2026, Anthropic's pricing page states it plainly: every plan has usage limits that reset on a rolling five-hour session window, and paid plans add weekly limits on top. Your activity across Claude on web, desktop, mobile and Claude Code all draws from the same pool. There is deliberately no fixed message count, because how much you get depends on conversation length and complexity, which model you pick, and which features you use. The relative scale Anthropic does publish: Pro gives at least 5x more usage per five-hour session than Free, and Max gives 5x or 20x more than Pro.
Is Claude Code included in my Claude plan?
Yes, on every paid plan. Anthropic's pricing page says Claude Code is included in all paid plans and shares the same usage limits as the rest of your plan, so terminal work and chats draw from one pool. It is not included on Free. If you want Claude Code metered separately from your chats, the way to do that is a Console account billed at pay-as-you-go API rates, which is a different account, not a setting.
Why is Claude Code charging me when I already pay for Pro?
Almost always one thing: an ANTHROPIC_API_KEY environment variable set on your machine. Anthropic's help center says that when that variable exists, Claude Code authenticates with the API key instead of your subscription, which means API usage charges rather than the usage already included in your plan. People hit this after following an API tutorial months ago and never unsetting it, then wonder why a $20 plan is generating a Console invoice. Unset the variable, run /logout, then /login and pick your subscription account.
Does using Claude Code in VS Code or Cursor count against the same limit?
Yes. Anthropic's help center states that your Pro or Max plan covers Claude Code in supported IDEs, including VS Code, Cursor and other VS Code forks, and JetBrains IDEs like IntelliJ and PyCharm, and that IDE usage counts toward the same usage limits shared across Claude and Claude Code. There is no separate IDE allowance. The terminal, the IDE extension, the desktop app and claude.ai are four doors into one budget.
What happens when I hit the Claude Code limit?
You get a message telling you when it resets, and you have four options per Anthropic's own list: wait for the reset, move to a higher plan, turn on usage credits so you keep working at standard API rates, or switch to a Console account and buy API credits outright for an intensive sprint. Usage credits are the one most people miss, because it means a hard stop is optional on any paid plan. Check Settings then Usage to see where you stand before you plan a long session.
Which plan should a small business buy for Claude Code?
If one person codes with it daily, Max is the honest floor: from $100 a month for 5x or 20x Pro's five-hour allowance. If a team needs it, note the thing the plan table buries: a Team Premium seat is $100 per seat per month on annual billing and gives 5x a Standard seat, which is the same $100 as an individual Max 5x plan. So at the $100 line you are choosing between an individual plan and a managed seat with admin controls, not between two amounts of money. Pro at $17 a month on annual billing is enough for occasional coding, not for a working day in the terminal.

More on AI for Business

ChatGPT Business vs Plus (2026): Which One a Small Business Should Actually Pay For

ChatGPT Plus vs Business, as of September 2026: Plus is $20 a month for one person and OpenAI may train on your chats unless you opt out; Business is $20 a seat billed annually or $25 monthly, two seats minimum, with no training by default, admin controls, shared projects for groups, and the Company Knowledge plugin. The side-by-side from OpenAI's pages, and three owner scenarios with a verdict each.

6 min

ChatGPT for Customer Service (2026): What Works, What Breaks, and What It Costs a Small Business

ChatGPT for customer service, as of September 2026: it drafts replies, answers policy questions from your own documents, and triages an inbox for $20 to $25 a seat a month on ChatGPT Business. It can't look up an order, issue a refund, or remember a customer unless you connect the system that holds them. The honest capability line, the plan you need, a setup in six steps, the failure modes, and the point where a real agent takes over.

7 min

ChatGPT Pulse (2026): What It Was, Why OpenAI Retired It, and How to Get the Morning Brief for Your Business

ChatGPT Pulse, the daily research cards OpenAI previewed for Pro users in September 2025, was sunset on June 17, 2026 with a 14-day wind-down. What it did, which plans ever had it, why scheduled tasks replaced it, and how an owner rebuilds the morning brief on a Plus or Business seat without handing ChatGPT the wrong things.

7 min

Claude Slides (2026): What It Does, Which Plans Get It, and When to Use PowerPoint Instead

Claude Slides launched September 16, 2026: ask Claude for a presentation and it drafts the deck, which you edit, present from Claude, or download as PowerPoint or PDF. It is a beta on paid plans, rolling out to Pro ($20) and Max first; Team and Free come later. Here is what it does, who has it today, and when the PowerPoint add-in is the better tool.

4 min
Justin McKelvey, Fractional CTO and AI consultant in Austin, TX

Written by

Justin McKelvey

Fractional CTO & AI consultant in Austin, TX. 15 years building software, 50+ products shipped, $53M+ in client revenue generated. I help $1M–$50M founders ship production software and automate operations with AI — without hiring a full-time executive team.

Work with me