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: a balance you fund inside claude.ai, spent at API rates only after the plan's five-hour session limit or weekly limit is reached, under a monthly spending cap you set. The second is prepaid API credits in the Claude Console: a balance for developers, spent from the first request, topped up by an auto-reload threshold. API means application programming interface, the way programs call Claude directly instead of through the chat app.

Every price and rule below was read from Anthropic's help center on 17 September 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.

When the balance is spent

Nothing is drawn from this balance while you are inside the plan's included usage. When you reach the session limit with credits enabled and funded, Claude tells you that you have reached the limit and offers to continue. Usage from that point is billed at standard API rates, per token, until the session 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 17 September 2026 Anthropic's pricing page lists Claude Sonnet 5 at $2 per million input tokens and $10 per million output tokens, and Claude Opus 5 at $5 and $25, so the model you pick decides how fast the balance is spent. These charges appear separately from the subscription charge on your bill, and the help center sets a daily redemption limit of $2,000. 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's condition for continuing past a limit is that credits are "enabled and funded". With a zero balance and auto-reload off, that condition fails, so you get the same result as a user who never enabled credits: the limit message, and a wait until the session or week resets. 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. 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.

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 weekly limit resets, with one entry for Opus only and one for all other models. 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. 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 17 September 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 after you have gone past the plan's included limit. 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: prepaid 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.

When the balance is spent

From the first request. There is no included allowance to use up first. Every successful API call is charged to this balance at the published per-token rates. Runs in the Console playground and Claude Code sessions signed in with an API key count as API calls. 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 /cost command.

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 plan, because a Console organization has no 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.

Does it expire

Yes. Console credits expire one year from the purchase date, and the expiry cannot be extended. All credit purchases are non-refundable. 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, because there is no included limit to draw down. 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 every switch to API credits needs your explicit consent, 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. One environment variable overrides all of this: if ANTHROPIC_API_KEY is set in your shell, Claude Code uses that key instead of your subscription, and the Console is billed for every token. 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: Console.
• 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 limit resets or an owner raises it. A usage-based Enterprise plan has no usage credits, because it bills everything at API rates from the first token. 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, and they are only spent after the plan's included limit is reached. API credits live in the Claude Console under Settings > Billing, in a separate organization, and are spent from the first request. Both are charged at Anthropic's published API rates, which is the only thing they share.

Do Claude usage credits expire?

Pro and Max usage credits do not expire in most regions, as the help center read on 17 September 2026. The stated exception is certain jurisdictions such as Japan, where credits bought on or after 10 September 2026 expire six months after purchase. Console API credits expire one year from purchase and the date cannot be extended. Purchases are non-refundable.

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.

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. Setting ANTHROPIC_API_KEY also routes everything to the Console.