All insights

Coding agents

Claude Code Pro Plan Limits: What Resets, What’s Shared, and API Costs

Claude Code Pro has shared five-hour and weekly usage limits, but Anthropic’s help documentation does not specify a fixed message or token quota. Learn where to check your usage, compare plans, and distinguish subscription use from API billing.

Illustration for Claude code pro plan limits

Short answer: Claude Code is included with an individual Pro subscription, but Anthropic’s help documentation does not specify a fixed number of Claude Code messages, tokens, requests, or coding tasks for Pro. It describes a five-hour session limit and a weekly limit instead. Claude Code, Claude on the web, and Claude Desktop share the same subscription usage allowance, so activity in one can reduce what remains for the others. Check your account’s live usage and reset times in Settings → Usage. (Pro plan; usage and length limits)

What Pro’s limits mean in practice

Limit or question What Anthropic documents What it does not specify
Five-hour session A five-hour limit applies. The window starts with your first message and the full allowance resets five hours later. A fixed number of messages, tokens, or coding tasks for that window.
Weekly usage A weekly limit applies across models. Its reset time is assigned to your account and stays fixed. A universal weekly quota or your account’s specific reset time.
Shared use Claude Code, Claude on the web, and Claude Desktop count toward the same usage limit. How much a particular prompt or task will consume.
Usage factors Usage can vary with conversation length and complexity, features used, model, and selected effort level. A reliable conversion from coding hours, repository size, or prompt count into remaining allowance.

The five-hour window is not a promise of five hours of continuous coding. It is a usage limit within a period that resets five hours after your first message. For example, if your first message is at 9:00, the full session allowance resets at 14:00. Your weekly reset is separate; find its assigned time under Settings → Usage. (Anthropic’s usage-limit guidance)

Anthropic says usage can vary with factors such as conversation length and complexity, features, model, and effort level. The documentation does not provide a formula to predict a specific project’s consumption. (Anthropic’s usage-limit guidance)

Usage limits are different from context limits. Usage limits govern how much you can use Claude over time; a context or length limit concerns how much information fits in one conversation. A large context window is not a separate usage quota. (Anthropic’s usage-limit guidance)

Should you stay on Pro or consider a higher-usage plan?

Use your own account history rather than a claimed message count or estimate based on coding hours:

  • Stay on Pro if its included usage usually covers your work and limit interruptions are acceptable. Anthropic lists Pro at $20 per month in the U.S. and offers annual billing at a discounted rate, billed once yearly. Prices may vary by region, and taxes may be included or added at checkout. Check the upgrade page or your mobile app store for current local pricing. (Pro plan pricing)
  • Wait for a reset if you hit a limit only occasionally and can pause. Check Settings → Usage to see whether the session or weekly limit is the constraint. (Anthropic’s usage-limit guidance)
  • Compare a higher-usage plan if you repeatedly hit limits and the interruptions matter. Anthropic describes Max as providing five times Pro’s usage in both the five-hour and weekly periods. That is a relative comparison—not an absolute quota or a guarantee that a particular coding workload will fit. (Max plan details)
  • Consider usage credits if you want work to continue after the included allowance is used. Pro subscribers can enable credits; usage then switches to pay-as-you-go pricing at standard API rates. Credits are a separate charge from the subscription. Anthropic’s usage-credit settings include a monthly spend limit; usage stops when that limit is reached, or when the credit balance runs out if auto-reload is off. Review the current credit and spending settings before enabling them. (Manage usage credits)

A practical decision rule: note when you hit a limit and whether it is the five-hour or weekly limit. If it happens rarely, waiting may be enough. If it happens repeatedly, compare current higher-plan terms with the cost and control of usage credits. The published Max multiplier alone cannot predict which option will cost less for your workload.

Claude Code Pro is not production API access

An individual Pro subscription includes interactive Claude products, including Claude Code, but does not include Claude API usage through the Claude Console. Anthropic treats paid Claude subscriptions and the developer Console as separate products; API use is billed separately. The monthly API-credit program also excludes Pro. (Pro plan details; API-credit eligibility)

That distinction matters when choosing for an application:

  • For a person using Claude Code interactively to work on software, Pro’s shared subscription allowance is the relevant limit.
  • For an application making programmatic model requests, plan for Claude Console/API billing and check the API’s current model availability, pricing, and rate limits for your expected request volume. Do not assume the Pro allowance covers those requests.

There is also a billing-source detail for Claude Code itself: Anthropic says that if ANTHROPIC_API_KEY is set in your environment, Claude Code will use that key instead of the subscription login, resulting in API usage charges. Check how you are signed in before attributing a limit or unexpected bill to Pro. (Use Claude Code with a Pro or Max plan)

For a production application, subscription-limit information alone is not enough to establish whether an API setup meets your requirements. Evaluate the API’s actual billing and limits against your expected volume and operational needs; this guide does not imply specific uptime, latency, or support guarantees.

Bottom line

Pro includes Claude Code, but Anthropic’s help documentation does not provide a fixed message or token quota to quote. Usage is shared with Claude on the web and Desktop, subject to five-hour and weekly limits, and affected by how you use the product. Check Settings → Usage for your account’s current consumption and reset times. Treat production API use separately: Pro does not include Claude Console API usage.

Sources

What is the Pro plan? | Claude Help Center

How do usage and length limits work? | Claude Help Center

What is the Max plan? | Claude Help Center

Manage usage credits for paid Claude plans | Claude Help Center

Monthly API credits for Max, Ultra, and Team plans | Claude Help Center

Use Claude Code with your Pro or Max plan | Claude Help Center

Contact us