claude code credit balance is too low 怎么办？Pro/Max 用户 3 步解决

Claude Code 弹出 Credit balance is too low，意思是这次请求走的 Claude Console 账户没有预付额度了。如果你买的是 Pro 或 Max，订阅本身不会出这个错，问题几乎都出在环境里还留着一个 ANTHROPIC_API_KEY：Claude Code 用了这把 API key，扣的是那个 API 账户的余额。处理办法是三步：跑 /status 看当前用的是哪种凭据，unset ANTHROPIC_API_KEY 并从 shell 配置文件里删掉，重开 Claude Code 后用 /login 登录订阅账号。这篇讲的 claude code credit balance is too low 处理办法同样适用于 VS Code 插件。下面的报错原文和步骤都按 Claude Code 官方报错文档 核对过（2026 年 11 月 4 日）。

claude code credit balance is too low 是什么意思

报错原文只有一行：

Credit balance is too low

官方文档给了两种原因：

• 你的 Claude Console 组织预付额度用完了；
• 你本想用订阅，Claude Code 却在用 Console 的 API key 发请求。

第二种是 Pro、Max 用户最常碰到的。很多人以前为了调 API 或跑别的工具，在 ~/.zshrc、~/.bashrc 里写过 export ANTHROPIC_API_KEY=...，后来开了订阅就忘了这回事。那个 API 账户早就没钱了，Claude Code 一调用就报余额不足。

为什么买了 Pro/Max 还是走 API key

Claude Code 选凭据有固定顺序。按 官方认证文档，ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY、apiKeyHelper 都排在 /login 得到的订阅凭据前面，订阅排在最后。

• 交互模式下，Claude Code 第一次发现 ANTHROPIC_API_KEY 会问你要不要用，你点过同意，之后就一直用它。
• claude -p 非交互模式下，只要环境里有这个变量就直接用，不会问。
• VS Code 插件同样读这个变量，所以插件里报 credit balance is too low 也按下面的办法处理。

claude code credit balance is too low 怎么解决

第 1 步：用 /status 确认凭据

在 Claude Code 里输入 /status，看 API key 那一行。登录和 API key 同时存在时，/status 会标出没在用的那一个。如果显示正在用的是 API key，就是这个原因。

第 2 步：去掉 ANTHROPIC_API_KEY

macOS、Linux、WSL 在当前终端执行：

unset ANTHROPIC_API_KEY

Windows PowerShell：

Remove-Item Env:ANTHROPIC_API_KEY

这只对当前窗口生效。要彻底去掉，打开 ~/.zshrc、~/.bashrc 或 ~/.profile，删掉 export ANTHROPIC_API_KEY=... 那行；Windows 还要查 $PROFILE 和”用户环境变量”。可以用这条命令找一找是哪个文件写的：

grep -n "ANTHROPIC_API_KEY" ~/.zshrc ~/.bashrc ~/.profile 2>/dev/null

第 3 步：重开 Claude Code，再 /login

关掉 Claude Code 重新运行 claude。还没用订阅账号登录过的话，输入 /login，选 Claude 订阅账号登录。最后再跑一次 /status，确认用的是订阅登录。

如果你暂时不想删变量，也可以在 /config 里关掉 “Use custom API key”，这个开关只在环境里有 ANTHROPIC_API_KEY 时出现。注意 claude -p 不看这个开关，变量在就用。

你本来就在用 API：充值

如果你就是想用 API key 按量付费，那这个报错就是余额真的不够了：

• 去 platform.claude.com/settings/billing 充值，可以顺手开自动充值（auto-reload），余额见底前自动补；
• 在 Console 给每个工作区设花费上限，免得一个项目把整个组织的余额用光。

API 账户的花费上限报错和这个不同，见 Claude Code 月度花费上限报错处理。订阅用户的用量规则见 Claude 额度怎么算。

排查顺序速查

1. /status 显示在用 API key → 按上面三步去掉变量、重新登录。
2. /status 显示在用订阅，还报这个错 → 检查有没有 apiKeyHelper 或 ANTHROPIC_AUTH_TOKEN（我们的推断：它们同样排在订阅前面，官方报错页只点名了 ANTHROPIC_API_KEY）。
3. 只在 claude -p、CI、脚本里报 → 检查脚本运行环境里的变量，非交互模式不会问你。
4. 确实在用 API → 充值。

登录过期、401 这类报错见 Claude Code API Error 401 OAuth token has expired 处理，其他报错可以查 Claude Code 报错总表。

常见问题

我有 Max，为什么还要充值？

不用充。订阅和 Claude Console 是两套账单，Max 的额度不会出现在 API 余额里。去掉 ANTHROPIC_API_KEY 后，Claude Code 会改用订阅额度。

unset 之后重开终端又报了

unset 只管当前窗口。新终端会重新读 shell 配置文件，要把文件里的 export 行删掉。

公司给的 API key 能和个人订阅一起用吗？

可以同时存在，但同一时刻只用一种。用订阅时把变量去掉；要切回 API key，重新 export 并在 /config 里打开 “Use custom API key”。