Credit balance is too low
Not a weekly limit — Console prepaid credits are gone
Claude Code’s error table (checked 2026-08-30) files Credit balance is too low under Usage limits: your Anthropic Console org has spent its prepaid usage credits. Retries will not refill them. Buy credits at platform.claude.com/settings/billing, or switch Claude Code to subscription auth / another prepaid path.
Four facts you can quote on their own
The literal string people search
The Claude Code error table lists this exact sentence under Usage limits. Treat that string first; do not start from the 5-hour window or weekly limit docs.
Tied to the Console organization
Anthropic’s help center: Claude API, Workbench, and API-billed Claude Code spend prepaid usage credits. At zero you cannot call the API. Failed requests are not charged.
Not a 429 and not weekly
This is not a rate-limit 429 with retry-after, and it is not the subscription 5-hour window or weekly limit. SDK retries keep hitting the same empty-balance check.
Official next step
The error table: add credits at platform.claude.com/settings/billing and consider auto-reload. Pro / Max / Team / Enterprise can switch Claude Code back to subscription auth.
Which ledger this sentence is talking about
Credit balance is too low is the Console organization’s prepaid usage credits, not the claude.ai 5-hour window, not weekly limit, and not the tier monthly cap enforced_spend_limit_reached. The help center is blunt: buy credits before you spend them; at zero, API and Workbench stop. Claude Code on API billing uses this ledger.
Why Pro / Max subscribers still see it
The usual misread is “I already pay for Pro / Max.” Claude Code can log in with a subscription or with an API key. If ANTHROPIC_API_KEY is still in the environment, the client bills Console credits and ignores the plan pool. Anthropic’s help center and old HN threads treat those as two systems. Plan exhaustion uses a different sentence.
Timeline
How do I pay for my Claude API usage: API / Workbench / API-billed Claude Code use prepaid usage credits; buy them on Billing and optionally auto-reload below a threshold.
Credit balance is too low: the Console org is out of prepaid credits. Add funds, enable auto-reload, or (if you have a plan) switch to subscription auth. Workspace spend limits stop one project draining the org.
The same literal has also been reported when the client cached a stale zero after a top-up, and for orphaned keys. The official table only covers balance = 0. If Billing shows funds and a new session still fails, re-auth is the community extra step, not a documented API code.
Confirmed vs common mix-ups
Confirmed
The literal Credit balance is too low is in Claude Code’s public error table and means Console prepaid usage credits are exhausted. Official next steps: Billing top-up / auto-reload, or subscription auth. Failed requests are free. This is not weekly limit, the 5-hour window, or the monthly spend-cap 429.
Common mix-ups
“Switch models and it goes away” — the org is billed, not the model. “Wait a few minutes” — there is no retry-after; credits do not grow back. “Pro users never see this” — an API key still spends credits, not the plan.
Top up vs switch auth
Stay on Console API: buy credits
Open platform.claude.com/settings/billing, buy credits, turn on auto-reload if you want a floor. If the client still prints the literal after a top-up, start a new session so the cached balance state refreshes.
You already have a plan: use subscription auth
Pro / Max / Team / Enterprise can point Claude Code at subscription login so usage hits the plan pool, not this prepaid ledger. The limit copy is different; do not explain weekly limit with this literal.
Three checks (official mechanism; no platform switch required)
First: is the literal Credit balance is too low, not You've hit your weekly limit or enforced_spend_limit_reached. Second: is Claude Code on an API key or subscription login. Third: stay on API → Billing top-up; stay on the plan → /login. This page does not describe bypassing Anthropic auth, sharing accounts, or faking billing state.
This ledger is not QCode’s prepaid balance
Credit balance is too low names Anthropic Console usage credits. QCode deducts its own prepaid balance at official price × service fee — a different path. This page does not claim QCode never shows a balance error. If Console credits are empty and the job cannot wait, use another already-provisioned API key on models that are actually sold; the site has a USDT top-up note if you need crypto.
FAQ
How is Credit balance is too low different from weekly limit?
Weekly limit is the subscription pool on a rolling week. Credit balance is too low is Console prepaid credits at zero. One shows up on claude.ai / subscription Claude Code; the other on API keys. One waits for a window; the other needs a top-up.
I pay for Pro / Max. Why this sentence?
If Claude Code is using an API key from the environment or config, the request spends Console credits and ignores the plan. The help center splits “plan limits” and “API credits.” /login back to the subscription and the copy usually becomes the plan-limit sentence instead.
I added credits and still see Credit balance is too low.
The error table and community reports both say Claude Code can cache balance state. Start a new session. If Billing already shows funds and a fresh session still fails, check for a stale key, the wrong workspace, or a key that can authenticate but no longer bill an active account.
Will retrying, switching models, or shrinking max_tokens help?
No. The preflight rejects before tokens are billed. Another Claude model still hits the same org balance. Recovery is top-up, auth switch, or a billing path that is not this Console org.
Is this the same as enforced_spend_limit_reached?
No. The monthly cap is a tier dollar ceiling: HTTP 429, no retry-after, error_code enforced_spend_limit_reached. Credit balance is too low is prepaid credits at zero. One waits until the 1st or a tier bump; the other buys credits.
Can QCode add credits to my Anthropic Console?
No. QCode is a separate prepaid API path at official price × service fee for models already sold. Use it when Console credits are empty and the job cannot stop. It does not deposit into your Anthropic Billing page.
Sources
Literal and next steps: Claude Code public error table, Usage limits, “Credit balance is too low” (fetched 2026-08-30). Prepaid usage credits, auto-reload, failed requests not charged: Anthropic help center “How do I pay for my Claude API usage” (same day). Plan vs API credits: “Use Claude Code with your Pro or Max plan.” Community orphan-key issues are not treated as official mechanism.
When Console credits hit zero, delivery does not have to stop
This is the Anthropic org’s prepaid credits, not a broken key. If you need another billing path, prepaid balance at official price × service fee covers models that are actually sold.
Related
Claude usage limit reached
Subscription 5-hour window and weekly pool — not this Console prepaid ledger.
enforced_spend_limit_reached
Tier monthly dollar cap 429: no retry-after, and not credits = 0.
Buy Claude Code credits with USDT
Crypto top-up onto a prepaid API path, not a Console deposit.
Technical reading of Anthropic’s public error table and help center, not an Anthropic statement. Balance, auto-reload, and auth are whatever Claude Console and Claude Code show. QCode does not bypass Anthropic authentication, abuse controls, or billing caps.