"Credit balance is too low"
by vortwangUpdated
"Credit balance is too low" means, per the Error reference, "Your Console organization has run out of prepaid credits, or Claude Code is sending your requests with a Console API key when you meant to use your subscription." It is not a session or weekly window, so there is no reset time to wait for. On Pro, Max, Team or Enterprise, run /status and check the API key row first. It is unrelated to the account-wide resets this board records.
- Last reset
- 04 SEP 20:08Z
- Status
- OVERDUE
The gap since the last reset is past 1.5x the recent median.
- Next est.
- ANY TIME
- Days since
- 14.4
days
What does "Credit balance is too low" mean?
Console organizations pay for the API with prepaid credits. When the balance reaches zero, the API stops serving requests and Claude Code shows "Credit balance is too low". Nothing about your plan windows is involved; the docs list this under usage limits only because it looks like one.
The second cause is the one that catches subscribers: "An approved ANTHROPIC_API_KEY in your environment routes requests through that key instead of your subscription." The authentication docs describe that precedence, and /status shows which credential is active.
The fix is money or credentials, not time. Either add credits at platform.claude.com/settings/billing, where you can also enable auto-reload so the balance refills before it hits zero, or remove the key and /login with your subscription. Per-workspace spend caps in the Console prevent a single project from draining the org balance.
Which window is full?
| Window | Resets | Where to check |
|---|---|---|
| None: this is an authentication failure, not a usage window | Never; there is nothing to wait for | /status shows which credential is active |
What to do when you see it
- Run /status and read the API key row
If you have a Pro, Max, Team or Enterprise plan and see this message, an approved ANTHROPIC_API_KEY is probably routing requests through that key instead of your subscription.
- Unset the key and relaunch
Unset ANTHROPIC_API_KEY in the current shell and remove it from your shell profile, then relaunch claude. Run /login if you have not signed in with your subscription yet.
- Or add credits in the Console
For a Console organization, add credits at platform.claude.com/settings/billing and consider enabling auto-reload there so the balance refills before it hits zero.
- Set per-workspace spend caps
The docs recommend per-workspace caps in the Console to prevent a single project from draining the org balance; see Manage costs effectively.
When does it reset?
It does not reset. A prepaid balance has no five-hour or weekly clock; it changes only when credits are added. If you are a subscriber, the window that matters is your plan's session and weekly limit, which /usage shows once your subscription login is the active credential.
Account-wide resets on this board refresh claude.ai subscription windows. They do not add Console credits, and they do not change which credential Claude Code is using.
Related errors
- "Invalid API key · Fix external API key"Claude Code
- "API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com."Claude Code
- "You've hit your monthly spend limit · raise it at claude.ai/settings/usage"Claude Code
- "Not logged in · Please run /login"Claude Code
FAQ
I pay for Max. Why does Claude Code say my credit balance is too low?
Because it is not using your subscription. The docs say an approved ANTHROPIC_API_KEY in your environment routes requests through that key instead. Run /status, unset the variable, remove it from your shell profile, relaunch claude and /login.
Is this the same as "You've hit your monthly spend limit"?
No. The spend-limit message is about usage credits on a claude.ai subscription and names who can raise the limit. "Credit balance is too low" is the prepaid balance of a Console organization, refilled at platform.claude.com/settings/billing.
Will waiting for a reset help?
No. There is no window behind this message. Add credits, enable auto-reload, or switch to your subscription login. Board resets apply to subscription windows only.
How do I stop one project draining the whole balance?
The Error reference suggests per-workspace spend caps in the Claude Console, and Manage costs effectively describes setting them and enabling auto-reload.
Sources
- Claude Code docs: Error reference — "Credit balance is too low"verified 2026-09-18
- Claude Help Center: Use Claude Code with your Pro or Max plan (/status, /login, shared limits)verified 2026-09-17
- Claude Code docs: Authentication — Authentication precedenceverified 2026-09-18
- Claude Console: Billing (prepaid credits, auto-reload)verified 2026-09-18
- Claude Code docs: Manage costs effectively (/usage, shared limits)verified 2026-09-18
Want the next Claude reset on your phone?