Claude API「credit balance is too low」／402 insufficient_quota

此錯誤與您的程式碼無關：金鑰背後的預付餘額為空（或已觸發每月支出上限）。以下說明 Anthropic Console 與閘道之間的計費模式差異，以及能防止問題在凌晨 2 點再次發生的警示。

錯誤

response (HTTP 400 / 402)

// Anthropic Console (HTTP 400):
{"type":"error","error":{"type":"invalid_request_error",
 "message":"Your credit balance is too low to access the Anthropic API..."}}

// OpenAI-compatible gateways, e.g. Kunavo (HTTP 402):
{"error":{"message":"Wallet balance is too low for this request. Top up at https://kunavo.com/app/billing",
 "type":"insufficient_quota","code":"insufficient_quota","param":null}}

原因與解決方法一覽

原因	解決方法
預付餘額確實為零	儲值。在 Anthropic：Console → Plans & billing。在 Kunavo：/app/billing（餘額永不過期）。
自動儲值已關閉（或其卡片已過期）	啟用自動儲值／更新卡片，避免流量暴增時在無人注意的情況下耗盡餘額。
已達每月支出上限	如果支出合理，請提高或清除每個金鑰／每個工作區的上限。
使用了錯誤工作區的金鑰	金鑰會使用建立該金鑰之工作區的餘額 — 已儲值的組織不會為另一個工作區的金鑰提供資金。

確認這是餘額問題，而不是驗證問題

401 = 金鑰問題；400「credit balance too low」／402 insufficient_quota = 金錢問題。計費錯誤不需要輪替金鑰 — 新金鑰讀取的仍是同一個空錢包。

儲值後，用一次低成本呼叫驗證

Anthropic 和 Kunavo 的餘額都會立即生效 — 不需要重新部署。在解除工作程序暫停前，先使用最小請求進行驗證：

verify.sh

curl -s https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":8,"messages":[{"role":"user","content":"ok?"}]}'

在 Claude Code 中看到這個錯誤？

Claude Code 在使用 Console 餘額為空的 Anthropic API 金鑰執行時會顯示這則訊息；Pro 或 Max 登入則會遇到用量限制，不會顯示此訊息。請為 Console 儲值，或繼續使用按量付費的端點：Claude Code 原生讀取 ANTHROPIC_BASE_URL，因此只需修改幾個環境變數即可切換。請保留這四行模型設定——Claude Code 的預設模型及其 opus 和 sonnet 別名會跟隨 Anthropic 的最新模型，而 sonnet 別名會要求 Sonnet 5.5，Kunavo 尚未提供該模型。

~/.zshrc

export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

讓下一次變得平淡無奇

設定低餘額警示（電子郵件），並在提供者支援的情況下啟用自動儲值，同時設定合理的每月上限。計費在餘額耗盡時拒絕請求是正確的 — 您只需要在撞上牆之前收到警告，而不是撞上牆後才知道。

如果你透過 Kunavo 呼叫

Kunavo 在餘額為零時會明確停止請求並回傳 402 insufficient_quota（絕不含糊地回傳 500），失敗的請求不會收費；啟用中的帳戶會在餘額耗盡前收到低餘額電子郵件，其中包含依您自身消耗速度估算的可用時間。餘額採預付錢包模式，最低 $10，永不過期；可在 /app/billing 使用信用卡儲值，在印度以外地區也可使用 Apple Pay、Google Pay 或 Link，或使用 Stripe 以您的貨幣顯示的當地付款方式，例如 Pix、WeChat Pay、UPI 或 KakaoPay。一次儲值能使用多久，完全取決於您指定的模型；每個模型的費率列在 Anthropic Claude API 價格表.

常見問題

我已經儲值了 — 為什麼仍然收到這個錯誤？

確認您為建立該金鑰的同一個帳戶／工作區儲值，並確認真正的阻礙因素不是每月支出上限。餘額本身在 Anthropic 和 Kunavo 都會立即套用。

Claude API 有免費方案嗎？

沒有 — Anthropic 從第一個 token 起就會為每次 API 呼叫計費（Claude.ai 消費者方案與 API 餘額彼此獨立）。閘道同樣採隨用隨付；Kunavo 從 $10 儲值開始，費率低於公開定價。

Claude Code 中顯示「Credit balance is too low」— 但我付費訂閱了 Pro，為什麼？

因為 Claude Code 使用的是 API 金鑰，而不是您的訂閱。只要設定了 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN，Claude Code 就會向該金鑰計費，並暫停使用 Pro 或 Max 登入；該金鑰使用的是獨立的預付 Console 餘額。執行 /status 查看目前使用的認證；取消設定該變數即可回到方案，或為該金鑰的餘額儲值。

OpenClaw 顯示「API provider returned a billing error」— 這是同一件事嗎？

是。這是 OpenClaw 對模型提供者拒絕計費的說法：API 金鑰的額度已用盡或餘額不足。請為該提供者儲值，或將 OpenClaw 切換至其他提供者 — 下方的相關指南會比較各種選項。