Claude usage credits: two separate meters, and which one your tools actually spend from
Claude usage credits are how paid plans keep working past their included limits, and there are two separate buckets. First, prepaid interactive extra-usage credits: you enable them and add funds so that when you exceed your plan cap, your next requests bill at standard API rates instead of cutting off. Second, a new monthly programmatic credit pool ($20 Pro, $100 Max 5x, $200 Max 20x), effective June 15, 2026, that only the Agent SDK, claude -p, Claude Code GitHub Actions, and third-party API apps draw from. Plain chatting and running Claude Code in the terminal still come out of your normal plan limits, not the programmatic pool.
Source: Anthropic, Manage usage credits for paid Claude plans.
One word, two completely different systems
The phrase “usage credits” gets used for two things that bill differently, and conflating them is where most confusion starts. The first is the older extra-usage mechanism: a prepaid balance you opt into so a long session does not hit a wall the moment you cross your plan’s included usage. The second is the newer programmatic credit, a monthly allowance Anthropic grants for automation, which only certain surfaces are allowed to spend.
The split exists because, before it, a subscription let an automated agent burn far more compute than a person typing into a chat box. Anthropic announced on May 14, 2026 that, starting June 15, 2026, programmatic usage would draw from its own metered pool. The intent is to keep flat-rate subscription economics for humans at the keyboard while putting scripted, looped, and pipelined workloads on API-rate accounting.
- Chatting with Claude on web, desktop, mobile
- Claude Code in the terminal
- Claude Cowork
Counts against your subscription’s normal usage limits. Extra-usage credits only matter once you exceed those.
- Claude Agent SDK (Python, TypeScript)
claude -pone-shot CLI- Claude Code GitHub Actions
- Third-party apps built on the Agent SDK
Drawn from the monthly programmatic credit at API token rates. Does not roll over.
How much programmatic credit each plan gets
The monthly programmatic allowance scales with your plan. It is consumed at Anthropic’s public API rates, the same per-million-token pricing as pay-as-you-go API usage, and it resets every billing cycle without carrying over.
Pro
Monthly programmatic credit pool that the Agent SDK, claude -p, GitHub Actions, and third-party API apps draw from.
Max 5x
Five times the Pro programmatic allowance, same metered API-rate accounting, same monthly reset.
Max 20x
The largest individual programmatic pool. Heavy automated workloads exhaust even this in days, then fall to extra-usage billing.
Team and Enterprise plans carry their own per-seat programmatic allowances. Once the pool is exhausted, programmatic usage stops unless you have enabled extra-usage billing, at which point it continues at standard API rates.
“Chatting with Claude on the web, desktop, or mobile, using Claude Code in the terminal, and using Claude Cowork still count against your normal subscription limits, not the programmatic credit pool.”
Anthropic billing change, effective June 15, 2026
The question no other explainer answers: which meter does a Claude Code GUI spend from?
If you run Claude Code through a desktop app, an IDE panel, or any wrapper instead of the bare terminal, the obvious worry after this change is whether that counts as a “third-party app” and quietly drains your $20, $100, or $200 programmatic pool. The honest answer is that the UI does not decide it. The authentication mechanism does.
If the wrapper signs you in with your Claude subscription over OAuth, the same login the terminal uses, and then runs the real Claude Code agent loop, the usage is billed the way interactive Claude Code is: against your plan’s normal limits. If instead the wrapper holds an ANTHROPIC_API_KEY or talks to the Agent SDK, that traffic is API-metered and lands on the programmatic credit (or your extra-usage balance) at API rates. Two apps with identical screens can sit in different buckets purely because of how they log in.
How fazm makes the bucket explicit
fazm is a native macOS app that wraps the actual Claude Code agent loop through ACP. Because the worry above is real, the billing path is not hidden: it is a mode selected at startup, in the ACP bridge, based purely on how the process is told to authenticate. Here is the literal decision from acp-bridge/src/index.ts:
The default for people who bring their own Claude account is Mode B: no ANTHROPIC_API_KEY in the environment, so the spawned Claude Code authenticates with your subscription OAuth token, exactly like the terminal does. Usage in this mode draws from your plan’s normal limits, not the programmatic pool. Mode A supplies an API key, which is API-metered. Mode C routes to a custom Anthropic-compatible endpoint (a corporate proxy, a gateway, or your own deployment). You decide which meter you spend from by deciding which mode you run, and the code makes that choice inspectable rather than a black box.
One honesty note: Anthropic owns the final classification of any given surface, and the policy is new as of mid-2026. What is verifiable here is the mechanism: Mode B carries your subscription OAuth and no API key, so it is billed the way subscription Claude Code is, not as API-key traffic.
Practical takeaways before June 15
For every agent or coding tool you run, find out whether it uses your Claude OAuth login or an API key. OAuth-logged tools stay on your subscription limits; API-key tools move to metered credit. This single fact tells you where each tool’s spend lands.
$20 to $200 a month at API rates is a few large agent runs, not a month of unattended pipelines. If you script heavy automated workloads, plan to enable extra-usage billing or budget for API spend rather than assuming the subscription covers it.
Day-to-day, human-in-the-loop coding, whether in the terminal or in a native wrapper that uses your OAuth login, stays on the flat subscription. That is the cheapest place to run it, and it is unaffected by the programmatic split.
Claude usage credits: common questions
What are Claude usage credits?
Usage credits are how paid Claude plans (Pro, Max 5x, Max 20x) keep working past their included usage limits. There are two distinct systems. The first is interactive extra-usage credits: prepaid funds you enable so that when you hit your plan cap while chatting or running Claude Code in the terminal, your next requests bill at standard API rates instead of cutting you off. The second, effective June 15, 2026, is a separate monthly programmatic credit pool that only specific programmatic surfaces draw from. They are charged separately from your subscription and show up as additional line items on your bill.
How much programmatic credit does each plan get?
Anthropic grants $20/month to Pro, $100/month to Max 5x, and $200/month to Max 20x. These figures are corroborated across Anthropic's announcement coverage. Team and Enterprise have their own per-seat allowances. The programmatic credit is consumed at Anthropic's public API rates (per million input and output tokens), the same as pay-as-you-go API billing.
What usage counts as programmatic versus interactive?
Programmatic usage that draws from the new credit pool: the Claude Agent SDK (Python and TypeScript), the claude -p one-shot CLI command, Claude Code GitHub Actions, and third-party apps built on the Agent SDK. Interactive usage that still comes out of your normal plan limits: chatting with Claude on web, desktop, or mobile, using Claude Code in the terminal, and Claude Cowork. The dividing line is roughly automation versus a human at the keyboard.
Do Claude usage credits roll over?
No. The monthly programmatic credit resets with each billing cycle and does not carry over, so unused credit is lost at the end of the month. Interactive extra-usage credits are prepaid funds you add yourself; those persist as a balance until spent, but they only kick in after you exceed your plan's included usage.
Does my Claude Code GUI or wrapper spend from the $20 programmatic pool?
It depends entirely on how the app authenticates. If the tool logs in with your Claude subscription via OAuth (the same login the terminal uses) and runs the actual Claude Code agent loop, its usage is billed like interactive Claude Code: against your plan's normal limits, not the programmatic pool. If instead the tool uses an ANTHROPIC_API_KEY or the Agent SDK, that usage is API-metered and would draw from the programmatic credit (or your extra-usage balance) at API rates. The auth mechanism, not the UI, decides the bucket.
Which bucket does fazm land in?
fazm runs the real Claude Code agent loop through ACP and supports three billing modes, chosen at startup in acp-bridge/src/index.ts. Mode B (the default for people who bring their own Claude account) launches with your OAuth subscription token and no API key, so usage draws from your plan's normal limits like the terminal does. Mode A uses a provided API key, which is API-metered. Mode C routes to a custom Anthropic-compatible endpoint. You pick which meter you spend from by which mode you run.
How do I enable interactive extra-usage credits?
In Claude, go to Settings then Usage, find the Usage credits section, and click Enable. You then prepay by clicking Add funds and purchasing an amount. After that, once you exceed your plan's included usage, subsequent requests bill against that prepaid balance at standard API rates rather than stopping. The interactive daily redemption limit is capped (Anthropic lists a per-day ceiling in the same settings page).
Why did Anthropic split programmatic usage onto its own meter?
Before the change, subscription plans allowed near-unlimited programmatic access, so automated agents and pipelines could consume far more compute than an interactive subscriber. Anthropic announced on May 14, 2026 that starting June 15, 2026 programmatic usage would draw from a dedicated monthly credit instead, putting heavy automated workloads on metered API economics while leaving normal chat and terminal coding on the flat subscription.
Want your Claude Code usage to stay on your plan, not a metered pool?
Talk through how fazm runs the real Claude Code loop with your own Claude account, in a native Mac app with persistent sessions and one-click forking.
Free to start, open source, brings your own Claude Pro or Max account.
Related guides
What a Claude Code project actually costs
Where session loss, forking, and compacting quietly add to the bill on a real project.
Anthropic's third-party tool credit meter (May 2026)
The May 14 change that moved outside agent tools onto a separate credit allowance, and where wrappers land.
Claude Code context management
How auto-compacting drops decisions in long sessions, and how a native wrapper keeps the full history live.
Comments (••)
Leave a comment to see what others are saying.Public and anonymous. No signup.