Claude Code「Credit balance is too low」、monthly spend limit 怎么办（2026）
大约 3 分钟ClaudeClaude CodeCredit balance is too lowmonthly spend limitClaude Code报错
一句话结论
Credit balance is too low 有两种情况：Console 组织的预付 credits 用完了，或者 你有订阅，但 Claude Code 实际在用某个 Console API key。先运行 /status 看 API key 那一行，再决定是切回订阅还是去充值。
阅读说明
官方信息查阅日期：2026-10-24。来源：Claude Code 官方文档 Error reference。价格以官网为准，可能随地区和税费变化。
你看到的报错
Credit balance is too low
按顺序排查
1. 有 Pro / Max / Team / Enterprise 订阅
- 在 Claude Code 里运行
/status，看API key那一行。 - 如果显示有已批准的
ANTHROPIC_API_KEY，说明请求在走这把 key，而不是你的订阅。 - 在当前 shell 里取消这个变量，并从 shell 配置文件（如
~/.zshrc、~/.bashrc）里删掉，然后重新启动claude。 - 还没用订阅登录过的话，运行
/login。
2. 本来就是用 Console API 按量付费
- 到 Claude Console 的 Billing 页面（
platform.claude.com/settings/billing）充值； - 官方建议开启 auto-reload，余额快到零时自动补充；
- 在 Console 里给每个 workspace 设花费上限，避免一个项目把整个组织的余额用光。
相似报错：You've hit your monthly spend limit
这是订阅用户开了 usage credits（额外用量）之后，额外用量撞到了花费上限。常见写法：
You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message
You've hit your individual spend limit · ask your admin for a higher limit
You've hit your org's monthly spend limit · visit https://claude.ai/admin-settings/usage to raise it
处理方法：
- Pro / Max：在
claude.ai的 Settings > Usage 提高月度花费上限，或运行/usage-credits； - Team / Enterprise：管理计费的人在 Organization settings > Usage 调整；其他成员可以用
/usage-credits向管理员申请； - 消息里如果带了「session limit resets 3:45pm」之类的重置时间，也可以等到时间再用；
- 运行
/usage查看各个额度窗口和重置时间。
常见问题
我只买了订阅，从没充过 API，为什么提示余额不足？
最常见的原因是某个工具或 .env 文件把 ANTHROPIC_API_KEY 加进了环境变量。官方说明：已批准的 API key 优先级高于订阅登录。用 /status 确认后删掉即可。
订阅的用量用完，会提示这句吗？
不会。订阅额度用完的提示是 You've hit your session limit / weekly limit，见 Claude Code 用量与限额排错。
相关阅读
- Claude Code 最低多少钱开通
- Claude Code 报错对照
- Claude Code「Usage credits required for 1M context」
- Claude Code 登录失效、401 怎么办
参考来源（官方）
- Claude Code Docs · Error reference（Credit balance is too low；You've hit your monthly spend limit）：https://code.claude.com/docs/en/errors（查阅日期：2026-10-24）
- Claude Help · Extra usage for paid Claude plans：https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans（查阅日期：2026-10-24）