【Claude】Credit balance is too low 余额不足报错已解决

关键词：Claude Code、Credit balance、余额不足、Console 预付信用、充值、自动重载、spending cap

一、问题现象：极简的余额不足提示

终端出现：

Credit balance is too low

注意这条消息的几个特征：

• 没有 API Error 前缀，不是服务端错误；
• 消息极短，没有重置时间（不像 session limit 那样带重置时间）；
• 意味着请求立即被拒绝，没有自动重试。

二、这是什么：Console 预付信用耗尽

这个错误特指 Console（platform.anthropic.com）组织的预付信用（prepaid credits）余额为零。

Claude Code 有两种主要认证方式：

认证方式	计费模式	是否会触发这个错误
Console API Key（ANTHROPIC_API_KEY）	预付信用，用完即止	✅ 会
Claude 订阅（/login，Pro/Max/Team/Enterprise）	订阅制，按计划额度	❌ 不会（会触发 session/weekly limit）

也就是说：只有通过 Console API Key 走预付信用的用户才会看到这个错误。 如果你有 Pro/Max 订阅，遇到的是另一类额度问题。

三、根因分析

3.1 为什么用完了还没察觉

• Console 账户默认不设置自动重载，余额用光就停；
• 多个工作区（workspace）共享一个组织余额时，某个工作区的高消耗项目可能意外耗尽整个组织的余额；
• Claude Code 的 Token 消耗比预期大得多（系统提示、工具定义、长上下文），容易在没意识到的情况下消耗掉余额。

3.2 版本说明

这条消息从 Claude Code 源码的常量定义中可以确认（CREDIT_BALANCE_TOO_LOW_ERROR_MESSAGE），是 CLI 层面对 API 返回的余额不足信号的专门处理。

四、解决方案

方案一：在 Console 充值

登录 platform.claude.com/settings/billing，为组织账户充值预付信用。

充值完成后，直接重试你的请求即可，不需要重启 Claude Code 或重新登录。

方案二：开启自动重载（防止下次再断）

在 platform.claude.com/settings/billing 里找到**自动重载（Auto-reload）**选项，设置一个余额阈值，当余额低于该阈值时自动充值到指定金额。这样就不会在工作状态下突然断掉。

方案三：设置每个工作区的支出上限

如果你管理多个工作区，防止单个高消耗项目耗尽整个组织余额的方法：在 Console 里为每个工作区设置支出上限（spending cap）。超出上限后该工作区停止，其他工作区不受影响。

参考官方"有效管理成本"文档配置。

方案四：切换到订阅认证

如果你同时有 Pro/Max 订阅账户，可以改用订阅认证，绕开 Console 的预付信用：

先取消 API key 变量：

unset ANTHROPIC_API_KEY

然后用订阅登录：

/login

运行 /status 确认凭证已切为订阅。

注意：如果环境变量 ANTHROPIC_API_KEY 还在，它会覆盖订阅凭证——必须先取消设置。

五、避坑

• ❌ 不要去查速率限制或模型配置：余额不足是纯粹的钱的问题，跟 key 的 Tier、速率、模型选择无关；
• ❌ 不要以为是 session/weekly limit：订阅额度耗尽带重置时间，余额不足没有重置时间；
• ✅ 第一时间 /status 确认凭证类型：确认是 API Key 路径还是订阅路径，判断对才能对症下药；
• ✅ 开自动重载：一劳永逸，避免工作时突然断；
• ✅ 设工作区上限：多团队场景必备，防止"一个项目搞垮全组织"。

六、与相邻错误的区分

错误	含义	有重置时间？	解决
Credit balance is too low	Console 预付信用耗尽	❌ 无	充值
You've hit your session limit	订阅计划的会话额度耗尽	✅ 有	等重置 / Extra Usage
You've hit your weekly limit	订阅计划的每周额度耗尽	✅ 有（周一）	等重置 / Extra Usage

区分口诀：有重置时间 = 订阅额度；没有重置时间 + 极短消息 = Console 余额。

七、总结

Credit balance is too low 是 Console 预付信用余额归零。解法只有一个：充值（platform.claude.com/settings/billing）。配合开启自动重载和工作区支出上限，防止下次再遇到。如果你有订阅账户，可以切换到订阅认证绕开 Console 预付模式。

---

参考：Claude Code 官方《错误参考》"使用限制"章节、Console 计费文档。