Pricing

Claude Code "Credit balance is too low": Causes and Fixes

Q: Why does Claude Code say Credit balance is too low on a Pro plan?

Often a stray `ANTHROPIC_API_KEY` is winning over `/login` OAuth — especially in `-p` mode, where the key is always used when present (authentication docs, verified Nov 7, 2026).

Q: How do I fix `Credit balance is too low`?

Run `/status`, unset overriding env vars if you want subscription billing, `/login` if needed, or add Console funds / auto-reload when Console billing is intentional.

Q: Is the Individual API interactive failure a known bug?

#106458 reports interactive fail with `claude -p` still working; a maintainer-confirmed fixed-in version is not published as of Nov 7, 2026.

Claude Code says "Credit balance is too low"? Subscription vs API-key confusion, Individual API plan quirks, and the documented fixes from GitHub issues.

By Engineer Foodie Desk Nov 7, 2026 ✓ Sources checked Nov 7, 2026

8 min read

Error strings quoted from Claude Code GitHub issues #99371, #98994, #94035, #106458 and #81748 (verified Nov 7, 2026). Causes and fixes checked Nov 7, 2026 in Claude Code’s error reference and authentication docs. Every source is listed at the bottom. No affiliate links on this page (how we work).

The exact error: `Credit balance is too low`

The line people paste into search, from #99371 and Anthropic’s error reference (verified Nov 7, 2026):

Credit balance is too low

The same GitHub issue also records the underlying API payload:

Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.

A shorter UI variant shows up in #106458 (verified Nov 7, 2026):

Credit balance too low · Add funds: https://platform.claude.com/settings/billing

The one-line answer: Claude Code thinks the Console credit balance is empty, or it is billing Console instead of your subscription. This is not the same string as a Pro, Max or Ultra usage-window message. Anthropic’s error reference says it outright: “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” (errors, verified Nov 7, 2026).

If your message says Claude AI usage limit reached or You've hit your session limit, that is a different post: Claude Code usage limit reached. Credit-balance is the billing/credit string only.

It feels like opening the wrong vault and finding a decoy bag of cash. You can see money somewhere in the account. Claude Code is not looking at that bag.

Which case do you have?

Read the setup before you add funds. The same string covers three different stories in the issues and docs.

Message	Likely cause	Fix
Credit balance is too low	Stray API key wins	Unset key, /status
Same, Console empty	Prepaid credits gone	Add funds / auto-reload
Credit balance too low · Add funds	Individual API quirk	See #106458 notes
Credit balance is too low. (subprocess)	Key overrides OAuth	Unset before `-p`

Causes from the issues and docs listed under each section below, verified Nov 7, 2026.

#99371 (opened Oct 4, 2026, still open as of Nov 7, 2026) is the classic: reporter on a Claude subscription, no ANTHROPIC_API_KEY / ANTHROPIC_AUTH_TOKEN / ANTHROPIC_BASE_URL / CLAUDE_CODE_OAUTH_TOKEN visible at Process/User/Machine scope, interactive sessions still usable, and claude -p "Reply with exactly OK" returns Credit balance is too low with a 400 invalid_request_error. No maintainer reply in the thread.

Anthropic’s authentication docs explain why non-interactive mode is special: credential order is cloud flags → ANTHROPIC_AUTH_TOKEN → ANTHROPIC_API_KEY (“In non-interactive mode (-p), the key is always used when present”) → apiKeyHelper → CLAUDE_CODE_OAUTH_TOKEN → profile/federation → subscription OAuth from /login (authentication, verified Nov 7, 2026). Your Pro, Max or Ultra login sits at the bottom. Anything above it can send Console billing instead.

#81748 (opened Jul 27, 2026, closed not_planned Sep 6, 2026) makes that painful: a Max subscriber watched assistant-spawned claude -p bypass a shell alias that unset ANTHROPIC_API_KEY, hit "Credit balance is too low.", and drain prepaid API balance. The issue documents the same precedence: API key above subscription OAuth, and -p always uses the key when present. That is The Big Lebowski energy: “This aggression will not stand, man” — except the prepaid balance already left the building.

Anthropic’s help center adds the billing consequence: when ANTHROPIC_API_KEY is set, you get API usage charges instead of subscription usage (support 11145838, verified Nov 1, 2026).

Console account truly out of funds

Sometimes the balance really is empty. #94035 (opened Sep 13, 2026, still open) is titled Insufficient credit balance despite available funds, with the reporter saying they still had $94.97 showing. #98994 (opened Oct 2, 2026, still open) is titled Credit balance is too low with the body “Well, I have $100 in tokens, but here i am… not able to use them”. Neither thread has a maintainer fix as of Nov 7, 2026, so treat “I can see money” as a bug report, not proof the docs are wrong.

When Console billing is intentional, the error reference’s recovery path is: add credits at platform.claude.com/settings/billing, and consider enabling auto-reload so the balance refills before it hits zero; also watch per-workspace spend caps (errors, verified Nov 7, 2026). The billing URL itself is a login wall for anonymous browsers (verified Nov 7, 2026), so you have to sign into Console to see the controls.

Individual API plan: interactive fails, `claude -p` works

#106458 (opened Oct 31, 2026, still open) reports ~$199 credit on an Individual API plan with sk-ant-usr- keys. The Messages API and claude -p work; interactive claude fails with Credit balance too low · Add funds: https://platform.claude.com/settings/billing. The reporter’s curl isolation: anthropic-beta: claude-code-20250219 plus billing header cc_entrypoint=cli returned 400 Your credit balance is too low to access the Anthropic API; cc_entrypoint=sdk-cli returned 200. Whether that interactive entrypoint block is intentional is not published as of Nov 7, 2026 — only the reporter’s hypothesis is in the issue — so do not treat a “fixed-in” version as confirmed.

How to fix Claude Code Credit balance is too low, in order

Each step says where it comes from.

Run /status and read the API key row. Anthropic’s error reference says to check which auth is active first (errors, verified Nov 7, 2026). Help 11145838 also points at /status to monitor remaining allocation (verified Nov 1, 2026).
If you meant to use your subscription, unset overriding env vars. Drop ANTHROPIC_API_KEY, and check ANTHROPIC_AUTH_TOKEN / ANTHROPIC_BASE_URL / CLAUDE_CODE_OAUTH_TOKEN too. Remove them from your shell profile and any project .env, then relaunch claude. The docs say an approved ANTHROPIC_API_KEY routes through that key instead of subscription (errors, verified Nov 7, 2026).
Run /login if you are not signed in. Same recovery section: /login when subscription OAuth should win.
If Console billing is intentional, add funds or enable auto-reload. Use platform.claude.com/settings/billing as the docs name it. Also check workspace spend caps if you have them.
On Individual API plan quirks like #106458, keep the issue open in a tab. There is no maintainer-confirmed fixed-in version as of Nov 7, 2026. Prefer the paths that already work for you (claude -p / Messages API in that report) while the bug is open, and file /feedback with the full line plus version if you need a trail.
Check status.claude.com. As of Nov 7, 2026 the page showed the aggregate banner All Systems Operational (verified Nov 7, 2026). Worth a glance if many people hit the same string at once.
Still stuck? Open or watch the matching GitHub issue with the full error line, /status output (redact secrets), and Claude Code version. Cite issue URLs, not people.

What not to do: don’t farm a second account, don’t share someone else’s key, and don’t run a “bypass billing” relay. A credit-balance refusal is Anthropic saying this request is on Console credits (or a key that looks like it), and ToS workarounds just add a second problem.

Credit balance vs usage limit vs 401

Message	What it is	Read
Credit balance is too low	Console credits / key	You’re here
Usage limit reached	Plan session/week	Usage limit reached
Invalid API key	Key rejected	Invalid API key
Free-tier questions	What’s included	Is Claude Code free?

Meanings from the Claude Code error reference (verified Nov 7, 2026) and the linked sister posts.

Short version: credit-balance is Console prepaid / wrong credential routing. A session or weekly cap is Claude Code usage limit reached. A dead key is Claude Code invalid API key. Plan shape and free-tier questions live in Is Claude Code free? and Claude Code usage limits.

Plan names, if an older thread still says “Max 20x”: Max is $100; Ultra is $200 (formerly Max 20x) (support 17728952, verified Nov 1, 2026).

Here’s what I’d do

Run /status. If an API key is active and you wanted Pro, Max or Ultra, unset ANTHROPIC_API_KEY (and friends), relaunch, /login once. If Console billing is what you want, add funds or turn on auto-reload at the billing URL the docs name. If you’re on the Individual API interactive quirk from #106458, treat the open issue as the source of truth and avoid inventing a workaround Anthropic never published.

If credit-balance false alarms keep eating your afternoon, it’s fair to keep a backup IDE ready. Our Claude Code alternatives list and AI coding tools compared page cover the options with dated prices.

FAQ

What does Claude Code Credit balance is too low mean? Claude Code is treating the request as Console prepaid credits that are empty, or as a Console API key overriding your subscription, per Anthropic’s error reference (verified Nov 7, 2026).

Does Credit balance is too low mean I hit my Claude usage limit? No. Usage limits show their own session or weekly messages; credit-balance is the Console credit / wrong-key string family.

Why does Claude Code say Credit balance is too low on a Pro plan? Often a stray ANTHROPIC_API_KEY is winning over /login OAuth — especially in -p mode, where the key is always used when present (authentication docs, verified Nov 7, 2026).

How do I fix Credit balance is too low? Run /status, unset overriding env vars if you want subscription billing, /login if needed, or add Console funds / auto-reload when Console billing is intentional.

Is the Individual API interactive failure a known bug? #106458 reports interactive fail with claude -p still working; a maintainer-confirmed fixed-in version is not published as of Nov 7, 2026.

Sources

Claude Code GitHub issue #99371 (Credit balance is too low; subscription vs -p; open): https://github.com/anthropics/claude-code/issues/99371 (verified 2026-11-07)
Claude Code GitHub issue #98994 (Credit balance is too low; open): https://github.com/anthropics/claude-code/issues/98994 (verified 2026-11-07)
Claude Code GitHub issue #94035 (Insufficient credit balance despite available funds; open): https://github.com/anthropics/claude-code/issues/94035 (verified 2026-11-07)
Claude Code GitHub issue #106458 (Credit balance too low · Add funds; Individual API; open): https://github.com/anthropics/claude-code/issues/106458 (verified 2026-11-07)
Claude Code GitHub issue #81748 (subprocess API-key precedence drained prepaid balance; closed not_planned): https://github.com/anthropics/claude-code/issues/81748 (verified 2026-11-07)
Claude Code error reference (§ Credit balance is too low; /status; add credits / auto-reload): https://code.claude.com/docs/en/errors (verified 2026-11-07)
Claude Code authentication (credential precedence; -p always uses key when present): https://code.claude.com/docs/en/authentication (verified 2026-11-07)
Anthropic Console billing settings URL (login wall anonymously): https://platform.claude.com/settings/billing (verified 2026-11-07)
Anthropic help, Use Claude Code with your Pro, Max or Ultra plan (ANTHROPIC_API_KEY → API charges; /status): https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-max-or-ultra-plan (verified 2026-11-01)
Anthropic help, What is the Ultra plan (Max 20x renamed Ultra): https://support.claude.com/en/articles/17728952-what-is-the-ultra-plan (verified 2026-11-01)
Claude status page: https://status.claude.com (reachable 2026-11-07; aggregate “All Systems Operational”)

The exact error: Credit balance is too low