Credit balance is too low
不是 weekly limit,是 Console 预付积分用完了
Claude Code 错误表(2026-08-30 核对)把 Credit balance is too low 归到 Usage limits:你的 Anthropic Console 组织预付 usage credits 已经用尽。重试不会恢复;要去 platform.claude.com/settings/billing 加积分,或改走订阅鉴权 / 另一条预付计费路径。
四个可单独引用的判别点
错误原文,四语都搜这一串
Claude Code 错误表把这句原文放在 Usage limits。终端、Desktop、GitHub Action 里出现的就是这一句,不要先当成 5 小时窗或 weekly limit。
绑的是 Console 组织余额
Anthropic 帮助中心:Claude API / Workbench / 走 API 的 Claude Code 按预付 usage credits 扣费。积分为 0 就不能再调 API,失败请求不扣费。
和 429 / weekly 的分水岭
这不是带 retry-after 的速率 429,也不是订阅套餐的 5 小时窗或 weekly limit。SDK 自动重试只会反复打到同一条余额检查。
官方补救入口
错误表写的下一步:在 platform.claude.com/settings/billing 买 credits,并考虑打开 auto-reload。Pro / Max / Team / Enterprise 可以把 Claude Code 切回订阅鉴权。
这句报错在说哪一本账单
Credit balance is too low 绑定的是 Anthropic Console 组织的预付 usage credits,不是 claude.ai 套餐里的 5 小时窗,也不是 weekly limit,更不是档位月消费上限 enforced_spend_limit_reached。帮助中心写得很直:credits 必须先买再花,积分为 0 就不能再调 API 或 Workbench。Claude Code 若选了 API 计费,走的就是这本账单。
为什么订阅用户也会看到这句
常见误判是「我已经买了 Pro / Max,怎么还会 Credit balance is too low」。Claude Code 启动时可以选订阅登录或 API key。环境里若留着 ANTHROPIC_API_KEY,客户端会走 Console 预付积分,套餐配额再多也不管这本账。HN 与 Anthropic 帮助中心都把这两套系统拆开写过:订阅限额用完是另一句话;这句原文只谈 credits。
时间线
How do I pay for my Claude API usage:API / Workbench / Claude Code 的 API 用量走预付 usage credits;可在 Billing 页购买并设置余额低于阈值时 auto-reload。
Credit balance is too low:Console 组织预付积分用尽。下一步是加积分、开 auto-reload,或(若有订阅)切回订阅鉴权;可用 workspace spend limit 防止单个项目抽干组织余额。
同一原文也被报过「加完积分客户端仍缓存旧余额」以及「orphan key 仍返回这句」。官方表只覆盖余额为 0 这一种;加完积分仍失败时,错误表建议新开会话,社区补充过重新登录。
已确认 vs 常见误解
已确认
错误原文 Credit balance is too low 在 Claude Code 公开错误表里,对应 Console 预付 usage credits 用尽。官方下一步是 Billing 页加积分 / auto-reload,或改用订阅鉴权。失败请求不扣费。这与 weekly limit、5 小时窗、档位月封顶 429 不是同一条规则。
常见误解
「换个模型就能绕过」——余额按组织扣,换 Claude 家族另一个型号仍走同一本 Console 账。「等几分钟就好」——没有 retry-after,余额不会自己长回来。「我有 Pro 就不会看到这句」——只要客户端走 API key,看的就是 credits,不是套餐配额。
加积分 vs 换鉴权
继续用 Console API:买 credits
打开 platform.claude.com/settings/billing,Buy credits,需要的话打开 auto-reload(低于阈值自动补)。加完后若客户端仍报这句,按错误表新开会话,让本地缓存的余额状态刷新。
你本来就有订阅:切回套餐鉴权
Pro / Max / Team / Enterprise 可以把 Claude Code 改回订阅登录,用量改打套餐配额,不再打这本预付积分。两条路径的限额文案不同,不要用这一句原文去解释 weekly limit。
三步判别(官方机制,不换平台也能用)
第一步看原文是不是 Credit balance is too low,不要和 You've hit your weekly limit、enforced_spend_limit_reached 混为一谈。第二步看 Claude Code 当前鉴权:API key 还是订阅登录。第三步:要继续走 API 就去 Billing 加积分;要走套餐就 /login 切订阅。本页不描述绕过 Anthropic 鉴权、共享账号或伪造账单状态的做法。
这本账单和 QCode 预付不是同一本
Credit balance is too low 说的是 Anthropic Console 组织的 usage credits。QCode 按官方价 × 服务费率从自己的预付余额扣费,走另一条计费路径。本页不声称 QCode 永远不会出现余额类错误。如果你被 Console 积分卡住、任务又不能停,可以用另一把已开通的 API 密钥继续跑在售模型;需要加密货币入金时,站内有 USDT 购买说明。
常见问题
Credit balance is too low 和 weekly limit 有什么差别?
weekly limit 是订阅套餐在滚动周里的用量配额;Credit balance is too low 是 Console 预付积分用尽。一个常见于 claude.ai / 订阅登录的 Claude Code,一个常见于 API key。重置时钟也不同:前者等窗口,后者要充值。
我已经买了 Pro / Max,为什么还会看到这句?
Claude Code 若正在用环境变量或配置里的 API key,请求走 Console 预付积分,与套餐配额无关。帮助中心把「订阅限额」和「API credits」写成两套系统。用 /login 切回订阅后,这句原文通常会换成套餐限额文案。
加完积分为什么还报 Credit balance is too low?
错误表和社区都写过:Claude Code 会缓存余额状态,旧会话不一定立刻刷新。官方建议新开会话。若 Billing 页已显示余额、新会话仍失败,再查是不是旧 key、错误 workspace,或 key 已无法对活跃账户记账。
重试、换模型、减小 max_tokens 有用吗?
没有。预检在记 token 之前就会拒。换 Claude 家族里的另一个型号仍打同一本组织余额。要恢复,只能加积分、切鉴权,或换一条不计这本 Console 账的计费路径。
这和 enforced_spend_limit_reached 是一回事吗?
不是。月封顶是档位美元上限,HTTP 429、无 retry-after、error_code 为 enforced_spend_limit_reached。Credit balance is too low 是预付积分花完。一个要等下月 1 日或提档,一个要买 credits。
QCode 能代替 Anthropic Console 加积分吗?
不能给 Console 账户充值。QCode 是另一条预付 API 路径,按官方价 × 服务费率调已开通的模型。适合 Console 积分用尽、又不想停任务的情况;它不会把钱打进你的 Anthropic Billing 页。
信息来源
错误原文与处置步骤来自 Claude Code 公开错误表 Usage limits 节「Credit balance is too low」(2026-08-30 抓取)。预付 usage credits、auto-reload、失败请求不扣费来自 Anthropic 帮助中心 How do I pay for my Claude API usage(同日核对)。订阅与 API credits 分账来自 Use Claude Code with your Pro or Max plan。本页不把社区 issue 里的 orphan-key 个案写成官方机制。
相关阅读
Claude usage limit reached
订阅产品里的 5 小时窗与周配额,和本页的 Console 预付积分不是同一套规则。
enforced_spend_limit_reached
档位月美元封顶的 429:没有 retry-after,也不是 credits 为 0。
USDT 买 Claude Code credits
需要加密货币入金、走预付 API 而不是给 Console 充值时的说明。
本页是对 Anthropic 公开错误表与帮助中心的技术说明,不代表 Anthropic 官方立场。余额、auto-reload 与鉴权状态以你在 Claude Console 和 Claude Code 里看到的为准。QCode 不绕过 Anthropic 的鉴权、风控或账单控制。