Claude usage credits explained: both meanings

What Claude usage credits are

Claude usage credits are money you pay in advance so Claude keeps working after the usage your subscription includes has run out. The phrase points at two separate balances, and they do not share a wallet. The first is usage credits on a Pro or Max plan. This is a balance you fund inside claude.ai, spent at API rates under a monthly spending cap you set. For most models it is spent only after the plan's five-hour session limit or weekly limit is reached. Fable on Pro is the exception and is covered below. The second is API credits in the Claude Console: a balance for developers, spent from the first request. You buy it in advance and can top it up with an auto-reload threshold. Since October 2026, Max and Team plans also add monthly API credits to it. API means application programming interface, the way programs call Claude directly instead of through the chat app.

Every price and rule below was checked against Anthropic's help center, Claude Platform documentation and Claude Code documentation on 10 October 2026. Anthropic used to call the first kind "extra usage", and the same help article now says "usage credits", so both names mean the same balance. The mechanics are below. Whether to fund credits or move to a bigger plan is a separate question, and how Claude's session and weekly usage limits work is the place to start on that.

Meaning one: usage credits on a Pro or Max plan

Where it lives

Open Settings > Usage in the Claude web app and find the Usage credits section. Click Enable, add a payment method if the account has none, then choose a monthly limit with Adjust limit or pick Set to unlimited. Click Add funds and enter the amount you want to prepay. An optional auto-reload buys more when the balance falls below a threshold you set. The help center lists Pro, Max 5x and Max 20x as the eligible plans. Free accounts cannot enable it. If you pay for your plan through the iOS or Android app, you can only enable credits on the web version, after adding a payment method there. Max 20x is also the plan Anthropic gives qualifying open-source maintainers for six months at no charge, and the free Claude Max offer for open-source maintainers covers who qualifies and what changes on the bill at month six.

When the balance is spent

Apart from the Fable exception below, nothing is drawn from this balance while you are inside the plan's included usage. Credits start once you have fully used one of the plan's limits with credits enabled and funded. That means the five-hour session limit, the weekly limit or, on Max, the Fable weekly limit. From then on, the help center says, your requests switch to pay-as-you-go pricing on usage credits and keep working. That usage is billed at standard API rates, per token, until the limit resets. Session limits still reset every five hours, so the credits pay only for the gap. A token is a piece of text, roughly four characters of English. As of 10 October 2026 Anthropic's pricing page lists Claude Sonnet 5 at $2 per million input tokens and $10 per million output tokens, Claude Opus 5 at $5 and $25, and Claude Fable 5.1 at $10 and $50, so the model you pick decides how fast the balance is spent. Fable is the one exception to the rule above on Pro: the help center says Fable 5 and Fable 5.1 are not included in the Pro plan's usage limits, so on Pro they run on usage credits from the first message, while your included usage stays available for other models. On Max, Fable draws on the plan's weekly limit up to a cap of 50 percent of it, and usage credits take over once that cap is reached, even if the rest of the weekly limit is unused. These charges appear separately from the subscription charge on your bill. To keep the balance untouched for longer, know what uses up a Pro plan's limit before you enable it.

What happens at zero

The help center says usage on credits continues until you reach your monthly spend limit, or until your balance runs out with auto-reload off. With a zero balance and auto-reload off, you get the same result as a user who never enabled credits: the limit message, and a wait until the session or week resets. On Pro, Fable stops until you add funds, because its usage was never inside the plan. Auto-reload removes that gap by buying more the moment the balance drops below your threshold. The monthly limit does the opposite job. It is a ceiling on credit spend, so once you reach it credits stop being drawn for the rest of the month, even with money left in the balance, until you raise it with Adjust limit. In Claude Code on Pro or Max, reaching the spend limit with credits still available brings up a prompt to raise or remove the limit without leaving the terminal. The help page does not quote the exact message you see at that point.

Does an unused balance expire

In most regions, no. The help center says usage credits do not expire, with one stated exception: in certain jurisdictions such as Japan, credits bought on or after 10 September 2026 expire six months after purchase, and Anthropic emails you seven days before that date. You can disable usage credits at any time from Settings > Usage. Turning credits off does not cancel or refund the plan itself, and whether a Pro or Max subscription can be refunded depends on where you live and where you bought it.

How it shows next to the limit bars

The same Settings > Usage page carries a Plan usage limits section at the top. Current session is a progress bar for the five-hour session limit, with the time left in the session. Weekly limits shows when the plan's weekly limit resets, with one entry for all models and one for Fable if your plan includes it. There is no separate Opus-only weekly limit: Fable draws from the same weekly budget as every other model, and the Fable entry tracks the share of it you may spend on Fable. The usage credits section sits below those bars and reports credit consumption on its own, so the page separates included plan usage from paid usage. Usage from the web app and from Claude Code counts toward the same bars, and so does Claude Desktop. The bars and the credit balance belong to the account, not the person, so two people on one login drain both, which is the practical problem with sharing one Claude Pro account even before the consumer terms rule it out. Usage credits cover Claude Code sessions signed in with the plan as well as chat. When a bar is full and the balance is empty, what to do when Claude says the limit is reached covers the options.

Usage bundles: cheaper funding for the same balance

The Usage credits section also carries a Buy usage button. A usage bundle is a prepaid block of usage credits sold at a discount, and it tops up the same balance described above. The help center lists 3 bundle sizes on 10 October 2026.

[
  {
    "label": "$50 bundle",
    "face_value_usd": 50,
    "price_paid_usd": 45,
    "discount_pct": 10
  },
  {
    "label": "$250 bundle",
    "face_value_usd": 250,
    "price_paid_usd": 200,
    "discount_pct": 20
  },
  {
    "label": "$1,000 bundle",
    "face_value_usd": "1,000",
    "price_paid_usd": 700,
    "discount_pct": 30
  }
]

The smallest bundle costs $45 for $50 of usage, a 10 percent discount. The largest costs $700 for $1,000 of usage, 30 percent off. Pro and Max subscribers can buy up to $2,000 of bundles per month, and usage beyond that is billed at the standard rate with no discount. Bundle credits follow the same rule as plain usage credits: they apply only once you are past the plan's included limit and drawing on usage credits. The bundle balance is one pool across the Claude web app, Claude Desktop, the mobile apps, Claude Code, Cowork and third-party products signed in with your account. The bundle article does not state an expiry. The usage credits article, which covers the balance the bundles top up, says credits do not expire except in the jurisdictions above.

Meaning two: API credits in the Claude Console

Where it lives

The Claude Console at platform.claude.com is the developer side of Anthropic. It has its own organization and its own balance, managed on its own Settings > Billing page. Sign in with an Admin or Billing role, open Settings > Billing, click Buy credits, and enter an amount. Auto-reload lives on the same page: click Edit in the Auto-reload section. Set the minimum balance that triggers a purchase and the amount to reload to. Those two fields are the "thresholds" people ask about.

Since 7 October 2026 a Console balance can also be fed by a subscription. Max and Team plans include monthly API credits: $100 a month on Max 5x, $200 on Max 20x, and on Team $20 per Standard seat and $100 per Premium seat, pooled and capped at $500. Pro, Free and Enterprise plans are not eligible. You claim them on claude.ai under Settings > Billing (Max) or Organization settings > Billing (Team) by linking one Console organization, and new subscribers can claim after seven days on the plan. These credits pay for the Claude API, Claude Managed Agents, the Agent SDK and the playground. They do not pay for interactive Claude Code or for usage credits in the Claude apps, and they do not change the plan's own limits. The monthly API credits on Max and Team covers the claim in detail.

When the balance is spent

From the first request. Every successful API call is charged to this balance at the published per-token rates. In an organization linked to a Max or Team plan, the monthly API credits are spent first and purchased credits after them. Without that link, there is no included allowance to use up first. Runs in the Console playground and Claude Code sessions signed in with an API key count as API calls, although the monthly plan credits do not cover interactive Claude Code. Failed requests are not charged. One exception the help center calls out: if your client disconnects or times out in the middle of a request that was going to succeed, that request is still charged. Claude Code signed in with an API key shows the running spend for the current session with the /usage command, and /cost still works as an alias for it.

What happens at zero

The help center is direct: when credits run out, you can no longer call the API or use the playground until you add more. There is no grace period and no fallback to a Claude plan. Even an organization linked to Max or Team only receives that plan's monthly API credits. Once those and any purchased credits are gone, requests stop until the next monthly grant arrives, and Anthropic says the usage is never charged to the plan. Auto-reload is the only setting that prevents an empty balance from stopping an integration, which is why a production key should have it on and a hobby key can have it off with a small balance. Auto-reload watches only the purchased balance, so it can reload while monthly plan credits remain.

Does it expire

Yes. Purchased Console credits expire one year from the purchase date, and the expiry cannot be extended. All credit purchases are non-refundable. Monthly API credits from a Max or Team plan expire sooner, at the end of each billing cycle, with no rollover. This is the biggest difference from Pro and Max usage credits, which in most regions do not expire at all.

How consumption shows

There are no session or weekly bars on the Console. Monthly API credits from a linked plan show in a Promotional credits section on the Billing page, with the amount and expiry date. The Billing page shows the charges for the current period, and Invoice history holds earlier periods. Some organizations arrange monthly invoicing through Anthropic's sales team instead of prepaying; they are billed in arrears at the same pay-as-you-go rates. Whether the per-token bill or the subscription is cheaper for a given workload is a separate question, covered in API pay-as-you-go against a subscription.

Where the two get mixed up: Claude Code

Claude Code signed in with a Pro or Max plan draws on the plan's limit, shared with the chat app. When that limit is reached and Claude Code also holds Console credentials, it offers to continue on API credits. That offer means the Console balance, billed at API rates, not the plan's usage credits. The help center says Claude Code keeps strict user control over billing decisions, so declining keeps you inside the plan. To stop the offer appearing at all, run /logout inside Claude Code, run /login, and sign in with only your plan account, without adding Console credentials. Also keep ANTHROPIC_API_KEY unset, because the help center says Claude Code prioritizes an API key in the environment over a signed-in subscription. When the key is set, Claude Code handles it like this. In interactive mode, Claude Code asks you once whether to use that key and remembers your answer. Approve it and Claude Code uses the key instead of your subscription, so the Console is billed for every token; decline it and you stay on the plan. You can change the choice later with the Use custom API key toggle in /config, and /status shows which credential is active. In non-interactive mode (claude -p) the key is always used when present, with no prompt. The key does not override everything: cloud provider settings for Bedrock, Vertex or Foundry and ANTHROPIC_AUTH_TOKEN rank above it, and Claude Code cloud sessions ignore it and always use your subscription. The two sign-in paths are compared in signing in to Claude Code with a subscription or an API key.

How to tell which balance you are looking at

• The page is claude.ai/settings/usage, with Current session and Weekly limits bars above it: this is Pro or Max usage credits.
• The page is Settings > Billing inside platform.claude.com, with a Buy credits button and an Invoice history: this is the Console balance.
• The balance came with a stated expiry one year out: purchased Console credits.
• The balance sits under Promotional credits and expires at the end of the billing cycle: Console, the monthly API credits from a Max or Team plan.
• The controls are Adjust limit and Set to unlimited: Pro or Max.
• The controls are a minimum balance and a reload-to amount: Console.

Team and Enterprise plans use the same words

Team and seat-based Enterprise plans have usage credits too, managed by an Owner or Primary Owner under Organization settings > Usage. Team owners prepay and set spend limits for the organization or for individual members. Seat-based Enterprise organizations are billed monthly for the credits their members used, and when a member's spend limit is exceeded they cannot use Claude products until the next billing period or until an owner raises the limit. A usage-based Enterprise plan has no usage credits, because it bills everything at API rates from the first token. Team plans also get the monthly Console API credits described above, which are a separate balance from the team's usage credits. Plan prices and included limits are collected in what the Pro plan costs and includes and how Enterprise pricing works, and the reset schedule for the larger plans is in when Max plan limits reset.

FAQ

Are Claude usage credits the same as API credits?

No. Usage credits on a Pro or Max plan are funded and shown at claude.ai under Settings > Usage. For most models they are only spent after the plan's included limit is reached, but Fable on Pro uses them from the first message. API credits live in the Claude Console under Settings > Billing, in a separate organization, and are spent from the first request. That balance can be bought or, on Max and Team, partly included each month. Both are charged at Anthropic's published API rates, which is the only thing they share, and the monthly API credits included with Max cannot pay for usage credits.

Do Claude usage credits expire?

Pro and Max usage credits do not expire in most regions, as the help center read on 10 October 2026. The stated exception is certain jurisdictions such as Japan, where credits bought on or after 10 September 2026 expire six months after purchase. Purchased Console API credits expire one year from purchase and the date cannot be extended, and purchases are non-refundable. Monthly API credits from a Max or Team plan expire at the end of each billing cycle.

What happens when my usage credits reach zero?

On a Pro or Max plan, continuing past a limit requires credits that are enabled and funded, so an empty balance puts you back on the plan's normal limit until the session or week resets or you add funds. Auto-reload avoids the gap. In the Console, an empty balance stops every API call and the playground until you buy more credits or the next monthly plan credits arrive.

Do usage credits work in Claude Code?

Yes, when Claude Code is signed in with the Pro or Max plan. It shares the plan's limit with the chat app, and usage credits cover Claude Code once that limit is reached. If Claude Code offers "API credits" instead, it is pointing at a Console balance, and accepting bills that organization at API rates. An ANTHROPIC_API_KEY in your shell also routes Claude Code to the Console, once you approve the key at the prompt, and always in non-interactive -p mode, so keep it unset to stay on the plan.