Skip to the board
DIDRESET
UTC

"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

@lydiahallie

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?

Which window is full?
WindowResetsWhere to check
None: this is an authentication failure, not a usage windowNever; there is nothing to wait for/status shows which credential is active

What to do when you see it

  1. 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.

  2. 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.

  3. 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.

  4. 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.

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

  1. Claude Code docs: Error reference — "Credit balance is too low"verified 2026-09-18
  2. Claude Help Center: Use Claude Code with your Pro or Max plan (/status, /login, shared limits)verified 2026-09-17
  3. Claude Code docs: Authentication — Authentication precedenceverified 2026-09-18
  4. Claude Console: Billing (prepaid credits, auto-reload)verified 2026-09-18
  5. Claude Code docs: Manage costs effectively (/usage, shared limits)verified 2026-09-18

Want the next Claude reset on your phone?

Sponsors