Claude Code error, explained
“You’ve hit your org’s monthly spend limit” in Claude Code, and the two very different reasons you see it
The message tells you to ask your admin to raise it at claude.ai/admin-settings/usage. That advice is only right half the time. The other half, there is no org and no cap to raise.
Direct answer (verified 2026-06-19)
New requests are blocked because a monthly cap on usage credits was reached. On Team and Enterprise, only an Owner or Primary Owner can raise it at Organization settings → Usage (the page behind claude.ai/admin-settings/usage). On Pro and Max you raise or remove your own limit with /usage-credits, which needs billing access. But if you have no organization, this exact wording is a known Claude Code 2.1.119+ misnomer for a depleted five-hour usage window or a transient 429, and it clears on its own. No admin page is involved.
Source: Claude Help Center, manage usage credits and the open Claude Code issues linked below.
Before you message your admin, figure out which message this is
Almost every guide on this treats the banner as one thing: a budget ran out, go ask for more. That is correct for one of the two cases and actively wrong for the other. The message text is identical in both, so the only way to tell them apart is to look at where you saw it and what your dashboard says. The table below is the whole diagnosis.
| Feature | A real spend cap | The misnamed message (no org) |
|---|---|---|
| Where you saw it | Team or Enterprise seat, or a Pro/Max account that set a limit | Personal Pro or Max account with no organization |
| What the dashboard shows | Spend at or near the monthly cap | Plenty of usage left (often 90%+ of the period) |
| What actually ran out | The configured monthly spend ceiling on usage credits | The five-hour included-usage window, or a transient 429 |
| Claude Code version clue | Any version; the cap is real | 2.1.119 and later (the renamed-message regression) |
| The real fix | Someone with billing access raises the limit at Settings > Usage | Wait for the window reset, restart, or upgrade. No admin page involved |
| Can you fix it yourself? | Only if you have billing access on the org | Yes, it clears on its own |
The teal column is the case most articles miss entirely. If that column matches you, do not contact an admin, because there isn't one.
Case A: a real monthly spend cap was reached
This is the case the message was written for. Someone set a ceiling on how much the usage-credit pool can bill per month, spending climbed to that number, and new requests now bounce until the ceiling moves or the period resets. The location matters: on Pro and Max the limit lives on your own account and you can change it from the CLI; on Team and Enterprise it lives on the organization and only an Owner or Primary Owner can touch it. The page the banner links to, claude.ai/admin-settings/usage, is that organization usage page.
One subtlety worth knowing: raising the cap does not change the per-token rate. Everything past your included plan usage meters at standard API rates regardless of where the ceiling sits. Enterprise deployments report an average of about $0 per developer per active day on Claude Code, and a single long agent run that streams a large repo plus many tool results is usually what trips a conservative monthly cap before anyone is watching the curve.
Case B: there is no org, and the message is misnamed
If you are on a personal Pro or Max plan with no organization, the banner is, in part, a naming bug. Claude Code issue #52908 reported that starting in version 2.1.119, sending a message after your session usage was exhausted surfaced “you’ve hit your org’s monthly usage limit” for users who have no org at all. Issues #52960 and #52679 describe the same confusion. The honest translation is “this usage window is used up,” because included usage on Pro and the Max tiers refreshes on a roughly five-hour cycle.
A close cousin is issue #56035, reported on version 2.1.126 and closed as a duplicate, where the CLI claimed the limit was hit while the web dashboard showed 90% or more of the period still available. The logs there are full of 429 rate-limit responses and lock-acquisition failures, not an empty budget. In both of these, the cure is to wait for the window to reset, restart Claude Code to clear stale local state, and update to the latest version. None of that involves an admin or an org settings page.
The decision, in order
Read the exact wording and check the dashboard
Open the usage view in the Claude Console or web app before doing anything else.
If the spend bar is genuinely pinned at the cap, this is a real limit and the fix is administrative. If the dashboard shows most of the month still available, you are almost certainly looking at the misnamed session-limit message, not a budget. That single glance decides which path below you take.
Real cap, and you have billing access
Raise or remove the ceiling, then keep working.
On Pro or Max, run /usage-credits in the CLI and the prompt to raise or remove the limit appears inline. On Team or Enterprise, an Owner or Primary Owner opens Organization settings, then Usage (the page at claude.ai/admin-settings/usage), and increases the monthly spend limit or approves the pending member requests listed there.
Real cap, but it is someone else's org
You cannot lift it locally. Route around it or wait for the reset.
Ping whoever owns billing, then keep moving on a funded path you control: sign in with your own personal Pro or Max account, or point the agent at an Anthropic-API-compatible endpoint that does not sit behind the org cap. Both are covered in the section below.
No org, no cap set: the misnamed message
Treat it as a session-window message, because that is what it is.
Wait for the roughly five-hour included-usage window to reset, restart Claude Code to clear stale lock or cache state, and update to the latest version. Do not go hunting for an admin page; on a solo account there is no org to email and no ceiling to raise.
When the cap is real and you cannot raise it
The genuinely stuck case is being a member of someone else’s org, mid-task, with a cap you have no permission to lift and an admin who is offline. Asking and waiting is the official answer. The practical answer is to keep working on a path that does not draw from the capped org pool at all. Two paths exist, and a desktop tool that wraps the real Claude Code agent loop can offer both because it controls how the agent authenticates and where it sends requests.
The first is simply signing in with your own personal Pro or Max account so inference bills to your plan instead of the org. The second is more interesting, and it is the part nothing else writing about this message mentions: pointing the agent at an API endpoint you control.
The verifiable detail
In Fazm, an open-source macOS wrapper for the Claude Code agent loop, there is a setting called Custom API Endpoint. It is backed by @AppStorage("customApiEndpoint") in Desktop/Sources/MainWindow/Pages/SettingsPage.swift. When you set it, the bridge that talks to the agent restarts into what the code labels Mode C (Custom API endpoint) and overrides ANTHROPIC_BASE_URL. The setting’s own help text spells out the consequence:
“Route API calls through an Anthropic-API-compatible endpoint (e.g. local LLM bridge, corporate proxy, or GitHub Copilot bridge). [...] Fazm will not send its built-in Anthropic key or count this usage against built-in credits.”
That is the whole point for this situation. If your requests go to a corporate proxy or a gateway your team funds separately, they never touch the Console workspace that has the spend cap on it, so the cap cannot block them. The endpoint has to speak the Anthropic API format (a raw OpenAI or Gemini key will not work), and it only applies to Claude models, but within those limits it is a clean way to keep the same agent loop running on billing you actually control.
The reason switching accounts or endpoints mid-incident is not painful is that sessions live on disk. The upstream CLI keeps them under ~/.claude/projects, and a wrapper that auto-restores windows lets you resume the same conversation under whichever account or endpoint is funded. The work is a session and a git diff, not a chat you are afraid to lose.
Hitting org caps you don't control?
Talk through how a local wrapper with account switching and a custom endpoint keeps the same Claude Code agent running on billing you own.
Frequently asked questions
What does "you've hit your org's monthly spend limit" actually mean?
Literally, new requests are being refused because a monthly spend cap on usage credits has been reached. Usage credits are the pay-as-you-go pool that meters at standard API rates once your included plan usage is gone, and a spend limit is a ceiling someone set on how much that pool can bill per month. When the running spend hits the ceiling, Claude, Cowork, and Claude Code stop accepting new requests until the limit is raised or the billing period rolls over. The message points you at the usage settings page because that is where the ceiling lives. The complication, covered below, is that on a solo account with no org this same wording sometimes appears when no spend cap was ever set.
Who can raise the limit, and where exactly?
On Team and Enterprise plans, only an Owner or Primary Owner can change it. They go to Organization settings, then Usage (the page the message links to at claude.ai/admin-settings/usage), and either increase the monthly spend limit or approve individual increase requests. On Pro and Max plans you raise or remove your own limit on usage credits with the /usage-credits command directly in the CLI, and Claude Code prompts you to raise or remove it without leaving the terminal, but changing it requires billing access on the account. If you are a member of someone else's org, you cannot lift it yourself no matter what you do locally.
The dashboard says I have 90% of my usage left. Why am I blocked?
That is the tell that you are not actually at a spend cap. It is a documented mismatch (see Claude Code issue #56035, reported on version 2.1.126 and closed as a duplicate) where the CLI surfaces "you've hit your org's monthly usage limit" while the web dashboard shows most of the period unused. The logs in those reports show 429 rate-limit responses and stale local lock or cache state, not an exhausted budget. The fix is not to visit an admin page; it is to wait a few minutes for the backend to resync, restart Claude Code, or upgrade to a newer version.
I'm on a personal Pro plan with no organization. Why does it mention an org?
Because the message is partly a naming bug. Claude Code issue #52908 reported that starting in version 2.1.119, sending a message after your session usage was exhausted produced "you've hit your org's monthly usage limit" even for Pro users who have no organization. Issue #52679 and #52960 describe the same confusion. The included usage on Pro and the Max tiers refreshes on a roughly five-hour cycle, so the real meaning in that case is "this five-hour window is used up," not anything about an org or a spend cap. Waiting for the window to reset clears it.
How is a spend limit different from running out of extra usage?
They produce different banners and need different fixes. "Out of extra usage" means the prepaid overage pool emptied and the admin has to top it up or re-enable it. A spend limit is a deliberately set ceiling that stops spending before the pool is empty, so the credits may still be there, the cap is just refusing to spend past the number someone chose. We cover the out-of-extra-usage case in a separate write-up; if your banner is about extra usage rather than a spend limit, start there.
Can I keep working right now if an org I don't control owns the cap?
Yes, if you have a separate funded path. Two work: sign in to a tool with your own personal Claude Pro or Max account so usage hits your plan instead of the capped org, or route requests through an Anthropic-API-compatible endpoint you control (a corporate proxy, a gateway, or a local bridge) that does not sit behind the org's Console spend cap. The web chat will not let you swap accounts mid-session, but desktop tools that wrap the Claude Code agent loop generally do. Fazm exposes both: an account switch and a custom endpoint field that overrides the API base URL.
Does raising the spend limit cost more per token?
Raising the limit does not change the rate; it just allows more spend to occur. Everything past your included plan usage meters at standard API rates whether the limit is 50 dollars or 5,000. Enterprise deployments average around 13 dollars per developer per active day on Claude Code, and a single long agent run that streams a large repo and many tool results is what tends to push a team over a conservative monthly cap before anyone notices the slope.
If I switch accounts mid-incident, do I lose my conversation?
Not if your tool keeps sessions on disk. The upstream CLI stores sessions under ~/.claude/projects, and a desktop wrapper that auto-restores windows lets you resume the same conversation under whichever account is still funded. The unit of work is the session and the file changes are in git, so switching the account that pays for inference does not have to mean starting the task over.
Related reading
"Your org is out of extra usage. We let your admin know." What that message means
The other org-billing banner. This one is the prepaid overage pool emptying, not a deliberate spend ceiling. Different cause, different fix.
What are Claude usage credits
The pay-as-you-go pool that meters at standard API rates once included usage is gone. The thing a spend limit actually caps.
Controlling context compaction in Claude Code
Auto-compaction quietly drops decisions mid-task. Why it happens and how a wrapper that keeps full history in context avoids it.
Comments (••)
Leave a comment to see what others are saying.Public and anonymous. No signup.