返回指南
故障排查·2026年7月17日·更新于 2026年11月13日·阅读约 6 分钟

Claude API “credit balance is too low” / 402 insufficient_quota — 解决方法

这个错误与代码无关:密钥背后的预付余额为空(或已触发每月支出上限)。以下介绍 Anthropic Console 与网关之间计费模式的差异,以及能够防止它在凌晨 2 点再次发生的告警机制。

最后审核于 。

这个错误与代码无关:密钥背后的预付余额为空(或已触发每月支出上限)。以下介绍 Anthropic Console 与网关之间计费模式的差异,以及能够防止它在凌晨 2 点再次发生的告警机制。

错误

响应(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 的余额都会立即生效 — 无需重新部署。在重新启用 worker 前,先使用最小请求进行验证:

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 上:读懂 402,或让它自动充值

Kunavo 钱包返回的 402 会用机器可读的形式说明原因:error.code 为 insufficient_balance,error.balance_usd 和 error.needed_usd 给出差额,error.topup_url 和 error.auto_recharge_url 会打开已预选好解决办法的账单页——这两个链接都不会扣任何费用。开启可选的自动充值后,当余额(这里指尚未减去运行中的请求和任务所预留金额的余额)低于你设定的阈值,且充值限制(包括你设定的每月上限)允许时,钱包会从已保存的银行卡按你选择的金额充值(至少 $10)。钱包余额不足以覆盖某个请求时,Kunavo 会进行这样的充值,并在答复之前再试一次该请求;如果没有充值,或充值后仍不够,请求仍会被拒绝,所以即使开启了自动充值,也可能收到 402。这笔充值仍在处理中时,402 会带上 Retry-After:请按它给出的时间重试;没有 Retry-After 的 402 就不要再重试。

如果你通过 Kunavo 调用

Kunavo 在余额为零时会明确返回 402 insufficient_quota 并停止处理(绝不会含糊地返回 500);失败的请求不计费,活跃账户会在余额耗尽前收到低余额邮件,其中包含根据自身消耗速率计算的剩余可用时间。余额是从 $10 起的预付钱包,可在 /app/billing 充值。一次充值能使用多久,完全取决于你选择的模型;各模型的费率见 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 切换到其他供应商 — 下方的相关指南会比较这些选项。

相关指南

更多错误语义请参阅 错误参考;通过 注册 和 身份验证指南 获取密钥只需一分钟。