疑难排查 · Claude Code
Claude Code API Error 402 billing_error — 余额不足
当预付余额不足以支付本次请求时，Claude Code 会打印 API Error: 402 billing_error。去充值；不要把 402 当成限流去重试。
你看到的报错
API Error: 402 {"type":"error","error":{"type":"billing_error","message":"insufficient balance or key spending limit reached for this request"}}为什么会发生
- 这把密钥上的预付余额不足以支付刚刚提交的请求。
- 密钥设有消费上限并且已经达到，即使账户里还有余额。
- 未入账的充值还不能花。
如何解决
- 按任意整数美元金额充值，到账后再重试。等待本身无法消除 402。
- 如果这把密钥设了消费上限，就提高或取消它。
- 用同一把密钥读取实时余额。按 HTTP 402 和 error.type billing_error 分支。
按密钥查看余额
curl https://router.apitoken.sale/balance \
-H "x-api-key: $ANTHROPIC_API_KEY"相关搜索
claude code 402claude code insufficient balance
常见问题
402 和 429 是一回事吗？+
不是。429 是每分钟吞吐量，可以重试。402 是预付余额为空。429 遵守 Retry-After。402 去充值。
Claude Code 会自己从 402 恢复吗？+
不会。重试不会给余额充值。先充值，再发请求。
控制台里还能看到余额，请求为什么失败？+
账户余额可以还在，而这把密钥已经撞上自己的消费上限。提高密钥上限或充值。