Credit balance is too low
不是 weekly limit，是 Console 预付积分用完了
截至 2026-10-08，Credit balance is too low 有三种原因，解法各不相同。Claude Code 官方错误表列出两种：Console 组织预付积分用尽，就去 platform.claude.com/settings/billing 加积分，可开 auto-reload；你本想用订阅、Claude Code 却在用 Console API key 发请求，就运行 /status 看 API key 一行，在当前 shell unset ANTHROPIC_API_KEY 并从 shell profile 删掉后重启 claude，还没登录订阅就 /login。第三种来自 Anthropic 2026-10-07 上线的 Max / Team 月度 API 额度说明：组织里只有这笔附送额度时，它不覆盖 Claude Code，Claude Code 会显示 Credit balance too low · Add funds。官方错误表把前两种归在 Usage limits，重试都不会恢复。
更新于 2026-10-08
订阅额度用完或频繁 429？可以改用按 token 计费的 API，一把 key 接着用。
- 按 token 计费，实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
四个可单独引用的判别点
错误原文，四语都搜这一串
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 自动重试只会反复打到同一条余额检查。
官方补救入口
错误表（2026-10-07 核对）写的下一步：在 platform.claude.com/settings/billing 加 credits，并考虑打开 auto-reload，让余额在归零前自动补足；在 Console 按 workspace 设 spend cap，防止单个项目抽干组织余额。有 Pro / Max / Team / Enterprise 订阅的，先运行 /status 看 API key 一行。
这句报错在说哪一本账单
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 计费，走的就是这本账单。2026-10-07 起，Max / Team 附送的月度 API 额度也会打进你关联的那个 Console 组织（Billing 页的 Promotional credits 一栏），但官方写明这笔额度不覆盖 Claude Code。
为什么订阅用户也会看到这句
常见误判是「我已经买了 Pro / Max，怎么还会 Credit balance is too low」。Claude Code 启动时可以选订阅登录或 API key。环境里若留着 ANTHROPIC_API_KEY，客户端会走 Console 预付积分，套餐配额再多也不管这本账。HN 与 Anthropic 帮助中心都把这两套系统拆开写过：订阅限额用完是另一句话；这句原文只谈 credits。截至 2026-10-07，官方错误表已把这种情况直接列为第二种原因：环境里获批的 ANTHROPIC_API_KEY 会让请求走这把 key，而不是你的订阅。另一种情形是 2026-10-07 起才有的：Max 5x、Max 20x 与 Team 现在每月附送 API 额度（$100、$200，Team 合计最多 $500），要把一个 Console 组织关联到套餐才能领取。官方说明写明这笔额度不覆盖 Claude Code；如果这个组织里只有这笔附送额度、又用它跑 Claude Code 会话，Claude Code 会显示 Credit balance too low · Add funds: https://platform.claude.com/settings/billing。附送额度也不改变你在 Claude 或 Claude Code 里的套餐用量限额。
时间线
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 组织预付积分用尽，或你本想用订阅、Claude Code 却在用 Console API key 发请求。下一步：/status 查 API key 一行，unset ANTHROPIC_API_KEY 并从 shell profile 删掉后重启 claude，必要时 /login；或加积分、开 auto-reload。按 workspace 设 spend cap 可防止单个项目抽干组织余额。
同一原文也被报过「加完积分客户端仍缓存旧余额」以及「orphan key 仍返回这句」。截至 2026-10-07，官方表列的是两种原因（积分用尽、误用 Console API key），没有写新开会话这一步；新开会话与重新登录是社区补充的做法。
已确认 vs 常见误解
已确认
错误原文 Credit balance is too low 在 Claude Code 官方错误表的 Usage limits 一节。截至 2026-10-07，表里给出两种原因：Console 组织预付积分用尽，或你本想用订阅、Claude Code 却在用 Console API key 发请求；对应的下一步是 /status 查 API key 一行、去掉 ANTHROPIC_API_KEY，或在 Billing 加积分并开 auto-reload。帮助中心写明失败请求不扣费（2026-08-30 核对）。这与 weekly limit、5 小时窗、档位月封顶 429 不是同一条规则。另据 Anthropic 的 Max / Team 月度 API 额度说明（2026-10-07 上线，2026-10-08 核对）：附送额度覆盖 Claude API、Claude Managed Agents、Claude Agent SDK 与 playground，不覆盖 Claude Code；组织只持有这笔额度时跑 Claude Code，提示是 Credit balance too low · Add funds。
常见误解
「换个模型就能绕过」——余额按组织扣，换 Claude 家族另一个型号仍走同一本 Console 账。「等几分钟就好」——没有 retry-after，余额不会自己长回来。「我有 Pro 就不会看到这句」——只要客户端走 API key，看的就是 credits，不是套餐配额。「Max 送了 API 额度，Claude Code 就能用它」——官方表格把 Claude Code 列在不覆盖一栏。
加积分 vs 换鉴权
继续用 Console API：买 credits
打开 platform.claude.com/settings/billing，Buy credits，需要的话打开 auto-reload，让余额在归零前自动补足。加完后若客户端仍报这句，先运行 /status 确认用的是哪把 key；社区报告新开会话有时能让缓存的余额状态刷新。
你本来就有订阅：切回套餐鉴权
Pro / Max / Team / Enterprise 可以把 Claude Code 改回订阅登录，用量改打套餐配额，不再打这本预付积分。两条路径的限额文案不同，不要用这一句原文去解释 weekly limit。
三步判别（官方机制，不换平台也能用）
第一步看原文是不是 Credit balance is too low，不要和 You've hit your weekly limit、enforced_spend_limit_reached 混为一谈。第二步运行 /status 看 API key 一行：你有订阅却显示 API key，说明环境里的 ANTHROPIC_API_KEY 在接管请求——在当前 shell unset、从 shell profile 删掉后重启 claude，还没登录订阅就 /login。第三步：要继续走 API，就去 Billing 加积分并考虑开 auto-reload。
这本账单和 QCode 预付不是同一本
Credit balance is too low 说的是 Anthropic Console 组织的 usage credits。QCode 从自己的预付余额扣费，基于 token 用量计费，各模型的实时单价见 qcode.cc/models，走的是另一条计费路径。本页不声称 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 / Team，为什么还会看到这句？
截至 2026-10-08 有两种可能。其一是官方错误表单列的原因：环境里获批的 ANTHROPIC_API_KEY 会让请求走这把 key 而不是你的订阅，于是扣的是 Console 预付积分；运行 /status 看 API key 一行，在当前 shell unset 并从 shell profile 删掉后重启 claude，必要时 /login。其二是 Max / Team 附送的月度 API 额度不覆盖 Claude Code：组织里只有这笔额度时，Claude Code 会显示 Credit balance too low · Add funds: https://platform.claude.com/settings/billing，提示给出的下一步是去 Billing 加 funds（官方：附送额度先扣，之后才扣你购买的 credits）。切回订阅后，这句原文通常会换成套餐限额文案。
加完积分为什么还报 Credit balance is too low？
社区报告过：加完积分后旧会话不一定立刻刷新余额状态，新开会话或重新登录有时就好（截至 2026-10-07，官方错误表没有写这一步）。若 Billing 页已显示余额、新会话仍失败，按错误表运行 /status 看 API key 一行，再查是不是旧 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 路径，调已开通的模型，基于 token 用量计费，各模型的实时单价见 qcode.cc/models。适合 Console 积分用尽、又不想停任务的情况；它不会把钱打进你的 Anthropic Billing 页。
信息来源
错误原文、两种原因与处置步骤来自 Claude Code 官方错误参考页 Usage limits 节「Credit balance is too low」（code.claude.com/docs/en/errors，2026-10-07 抓取；2026-08-30 首次核对）。预付 usage credits、auto-reload、失败请求不扣费来自 Anthropic 帮助中心 How do I pay for my Claude API usage（2026-08-30 核对）。订阅与 API credits 分账来自 Use Claude Code with your Pro or Max plan。本页不把社区 issue 里的 orphan-key 个案写成官方机制。Max / Team 月度 API 额度不覆盖 Claude Code、以及对应提示 Credit balance too low · Add funds，来自 Anthropic 文档 API credits for Max and Team plans（platform.claude.com/docs/en/about-claude/api-credits-for-subscribers）与 2026-10-07 的 API 更新日志，2026-10-08 抓取；同日复核错误参考页，两种原因的表述未变。
相关阅读
Claude usage limit reached
订阅产品里的 5 小时窗与周配额，和本页的 Console 预付积分不是同一套规则。
enforced_spend_limit_reached
档位月美元封顶的 429：没有 retry-after，也不是 credits 为 0。
USDT 买 Claude Code credits
需要加密货币入金、走预付 API 而不是给 Console 充值时的说明。
本页是对 Anthropic 公开错误表、Max / Team API 额度说明与帮助中心的技术说明，不代表 Anthropic 官方立场；核对日期 2026-10-08，以官方页面为准。余额、auto-reload 与鉴权状态以你在 Claude Console 和 Claude Code 里看到的为准。