Learn
Claude Code Subscription vs API Pricing: Opus 5 Guide
Claude Code can draw from a plan limit, paid usage credits, a standard API account, or Fast mode. Match the meter to your workload and budget.
Clarify the spend threshold before you commit. Use this page when the core product is familiar and the real question is whether to stay free, upgrade, or switch pricing tracks.
Editorial guide
Guide
Start with the spend threshold and the conditions that change the pricing decision.
Claude Code does not have one universal price meter. The same command-line product can draw from an included subscription allocation, paid usage credits after that allocation, a Console or API account billed from the first token, or Fast mode at a premium rate. The active credential and mode decide which budget pays; the fact that the work happens in a terminal does not.
Start by identifying the meter
Purchase path | When billing begins | What controls usage | Best fit |
|---|---|---|---|
Paid plan allocation | With the Pro, Max, Team, or applicable seat purchase | Shared plan limits across Claude and Claude Code | Human-steered coding with a fixed subscription budget |
Plan usage credits | After the included plan or seat limit is reached and the user elects to continue | A separate credit balance billed at standard API rates in standard mode; Fast mode has its own premium rate | Occasional interactive overflow without changing the Claude Code workflow |
Standard API or Console | From the first API-key request | Model tokens, caching, tools, rate limits, and account spend controls | CI, products, agents, shared automation, and measurable per-task cost |
Fast mode | From the first Fast-mode token, even when subscription allocation remains | Premium Opus token rates and a separate Fast-mode limit | Latency-sensitive debugging or rapid iteration where speed has a clear value |
A paid Claude plan can include Claude Code while still not including Claude Console or API access. Those statements are compatible because the subscription login and the API-key login are separate commercial routes. Before comparing prices, run /status and check whether Claude Code is using subscription OAuth, a Console credential, an API key, or a cloud provider. An approved ANTHROPIC_API_KEY can take precedence over a saved subscription login.
Use Claude Code pricing for the canonical plan and access-route facts. Use Claude Pro/Max vs API pricing when the narrower decision is an individual Claude plan versus developer-platform billing.
Subscription limits are not API token packages
Claude Code is included in paid individual plans and Team seats. Interactive usage shares the same allowance as Claude on the web, desktop, and mobile. Anthropic describes rolling five-hour limits and additional weekly limits for paid plans, but it does not publish one fixed message, task, or token quota that applies to every user. Repository size, conversation length, model, effort, tools, and parallel work all change how quickly the allowance is consumed.
Max 5x and Max 20x describe usage relative to Pro; they are not grants of a stated number of API tokens. Team Standard and Premium seats likewise carry different plan allowances without becoming a pooled API wallet. Usage-based Enterprise is a different case: Anthropic says consumption is billed at API rates from the first token, so buyers should not treat that arrangement as a seat with an included Claude Code quota.
Opus 5 is an active Claude model. In Claude Code, the opus alias resolves to Opus 5 on the Anthropic API, and Opus 5 requires Claude Code 2.1.219 or later. Provider routing, account availability, and an administrator's allowed-model policy can still change what appears in /model, so verify the actual picker before buying a plan specifically to use Opus 5.
Anthropic also paused the announced separate monthly Agent SDK credit. Its Help Center says Claude Agent SDK, claude -p, and third-party app usage continue to draw from subscription usage limits for now. Do not put a proposed credit into a budget or treat it as an available plan allowance.
Usage credits are paid overflow
Outside Fast mode, usage credits for Pro, Max, Team, and seat-based Enterprise are not part of the subscription price. When an included limit is reached, an eligible user can choose to continue, and the subsequent usage is charged separately at standard API rates. The normal plan limit still resets on its own schedule; buying credits does not enlarge or convert the included allowance.
For an individual, usage credits are the simplest route when coding is still interactive and overflow is occasional. Enable a conservative monthly cap, avoid unlimited auto-reload during the first measurement period, and compare the observed overage with the cost of moving to a higher plan. For Team and seat-based Enterprise, an owner can control organization and user spend. If the work is consistently over the plan limit, repeated overage is a signal to compare a higher seat or a direct API workflow rather than assuming the subscription is unlimited.
Usage credits also do not grant a general-purpose API entitlement to a paid Claude plan. A developer building an application or integration still needs separate Console access and an API credential. The overflow route keeps a person working in Claude or Claude Code; the API route funds software.
Standard API billing starts with the first request
Direct API billing is the clean default when a job is unattended, scheduled, shared, embedded in a product, or required to report cost per run. Claude API and Workbench customers generally fund a Console balance with prepaid credits, and usage is then applied at the published model rates. A paid Claude subscription does not include that Console balance or API access.
For Opus 5, the published base rate is $5 per million input tokens and $25 per million output tokens. If a measured workload uses I million input tokens and O million output tokens, its base standard-API estimate is 5I + 25O dollars. For example, 10 million input tokens and 2 million output tokens produce a $100 base estimate before prompt-caching charges or discounts, tool charges, data-residency modifiers, and other applicable features.
That formula is useful for an API budget, but it must never be translated into a Claude Code subscription allowance. The subscription meter is a variable plan limit, not a token balance. Run a representative pilot, collect actual input, cache, and output usage, then set organization and workspace controls around the measured workload.
Fast mode is a separate premium meter
Fast mode is a research-preview configuration for Opus 5 and Opus 4.8 that prioritizes response speed. It is not a different model and it is not included in Pro, Max, Team, or Enterprise subscription rate limits. Claude Code subscribers need usage credits, and Fast-mode tokens are charged from the first token even when included plan usage remains.
The published Fast-mode rate for Opus 5 is $10 per million input tokens and $50 per million output tokens, or twice the standard Opus 5 base token rate. The same 10-million-input and 2-million-output example therefore produces a $200 base estimate before other modifiers. Fast mode is available on the first-party Claude API, not partner-operated cloud routes, and it is unavailable with the Batch API.
Use /fast only when lower latency has a measurable value, such as a live debugging window, rapid pair-programming loop, or deadline-sensitive incident. Standard mode is the better budget default for long autonomous runs, CI, batch work, and any task where completion time matters less than token cost. Enabling Fast mode late in a long conversation can also make the existing context expensive, so start a fresh or already-Fast session when practical.
Choose by workload and budget
Use the subscription allocation when one person actively steers the work, values a fixed plan price, and can pause, reset, or switch tasks when the plan limit arrives. Start at the lowest plan that covers the required product and governance features. Move up only after usage history shows repeated limit pressure; a hypothetical token conversion cannot prove the upgrade.
Use plan usage credits when the same person needs occasional continuity beyond a plan limit. Set a hard monthly cap, measure at least a few representative heavy sessions, and compare total subscription-plus-overflow spend with the next plan or seat. This route is poor for an always-on workload because human overflow controls are not a production capacity plan.
Use the standard API route when software initiates the work, concurrency can grow, several systems share the budget, or per-task cost and rate controls are required. Estimate with observed tokens, not repository size or message count, and keep API credentials and billing ownership separate from personal subscriptions.
Use Fast mode only when the value of saved time is greater than the roughly twofold Opus 5 base token premium. If the work can run in the background, keep standard mode. If people use Claude Code interactively while services also call Claude, buy seats for the people and budget API usage for the software as two explicit lines. That split is usually safer than forcing both workloads through one credential or pretending one meter covers the other.
Evidence boundary
Official sources
Editorial guidance grounded in official product sources.
- Claude Code by Anthropic | AI Coding Agent, Terminal, IDE
- Claude plans and API pricing
- Overview - Claude Code Docs
- Claude official site
- Home | Claude Help Center
- Claude API pricing reference
- ChatGPT Pricing | OpenAI
- Use Claude Code with Pro or Max
- Use Claude Code with Team or Enterprise
- Claude usage and length limits
- Manage usage credits for paid Claude plans
- Manage Team and seat-based Enterprise usage credits
- Claude subscriptions and API billing are separate
- Pay for Claude API usage
- Claude Code model configuration
- Claude Code Fast mode
- Paused Claude Agent SDK plan credit
FAQ
Common questions
Does Claude Pro or Max include Claude Code and Claude API credits?
Paid individual plans include Claude Code, but a paid Claude subscription does not include Claude Console or general API access. Pro and Max usage is governed by shared plan limits. Normal usage-credit overflow is a separate charge at standard API rates; Fast mode is a separate premium exception, not an included API-token allowance.
Is Opus 5 available in Claude Code?
Opus 5 is an active model, and current Claude Code documentation maps the opus alias to Opus 5 on the Anthropic API. Claude Code 2.1.219 or later is required. Actual access can still depend on the provider, account, and an organization's allowed-model policy, so check /model on the account that will pay.
How many Claude Code tasks does a subscription include?
Anthropic does not publish one fixed task, message, or token count for every subscriber. Claude and Claude Code share rolling usage limits, with paid plans also subject to weekly limits. Consumption changes with conversation length, repository context, model, effort, tools, and parallel sessions, so use the account's usage display instead of converting API token prices into a plan quota.
What happens when Claude Code reaches a paid-plan limit?
You can wait for the plan window to reset, move to a higher plan or seat, or enable usage credits when the account is eligible. Standard-mode usage after the limit is then billed separately at standard API rates and can be controlled with spend limits. The credits do not change the plan's reset schedule or create general API access.
Is Claude Code Fast mode included in a subscription?
No. Fast mode is a research-preview Opus configuration available to subscription users through usage credits, not through the included plan allocation. Opus 5 Fast mode is billed at $10 per million input tokens and $50 per million output tokens from the first Fast-mode token, compared with standard Opus 5 base rates of $5 and $25.
Should CI or production automation use a Claude subscription or an API key?
Use an API key and a separately governed API budget when software runs unattended, serves multiple users, scales concurrency, or needs per-workspace spend controls. Anthropic's announced separate monthly Agent SDK credit was paused, so do not budget around it. Interactive Claude Code can stay on a subscription while CI, agents, and product integrations use direct API billing.
Next steps
Take the next buying step
Use these next pages to confirm the plan, tool, or alternate route that fits once the spend boundary is clear.