“Your credit balance is too low to access the Anthropic API”的意思是：你的预付额度不足以支付 Claude API 的用量。在 Claude Code 中，它显示为“Credit balance is too low”。如果你以为自己用的是 Pro 或 Max 等订阅计划却仍然看到它，常见原因是环境变量 ANTHROPIC_API_KEY 中的 API 密钥优先于你的订阅登录，于是被切换成了 API 计费。
400 invalid_request_error
Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.API 返回内容的示例。用户贴到 Claude Code 的 GitHub 上的日志中就是这种形式（2025年4月的报告、2026年8月的报告）。Anthropic 的 API 错误列表中没有收录这句原话。
原因几乎总是两种。先用 /status 区分
原因 A
Console 组织的额度用完了
适用于本来就打算用 API 密钥的人。在 Claude Console 的 Billing 中购买额度，或开启自动充值。
原因 B
API 密钥优先于你的订阅计划
适用于打算使用 Pro、Max、Team 或 Enterprise 的人。删除 ANTHROPIC_API_KEY 并重启 Claude Code。
在 Claude Code 中运行 /status，查看 API key 一行，就能知道属于哪一种（这是 Claude Code 官方错误参考中的步骤）。
本文依据 Claude Code 官方文档和 Anthropic 帮助中心（2026年10月26日确认），说明这个错误的含义、如何区分原因、两种解决方法，以及它与 Max 和 Team 附带的每月 API 额度、订阅计划的“用量额度”（usage credits）有何不同。两种原因分别用颜色标为 A 余额 和 B API 密钥。
1. 错误的含义和显示形式
Claude API 采用预付费方式，签订销售合同、按月末开票结算的组织除外。根据 Anthropic 的帮助文章，通过 Claude Console 组织使用 API、Playground 和 Claude Code 产生的费用，会从预先购买的额度中扣除，额度用完后，在充值之前无法调用 API。这个错误就是在告诉你已经进入了这种“不足”的状态。
消息末尾的“Plans & Billing”指的是 Console 的计费页面。在现在的 Console 中，可以在 Billing 页面（platform.claude.com/settings/billing）查看余额并购买额度。
| 在哪里看到 | 显示内容 |
|---|---|
| 直接调用 Claude APISDK、curl、自己的应用 | HTTP 400，错误类型 invalid_request_error，附带上方的英文消息依据用户报告中的日志 |
| Claude Code终端、VS Code 及其他扩展 | Credit balance is too low官方错误参考中的写法 |
| 旧版 Claude Code2025年4月的用户报告 | Credit balance too low · Add funds: https://console.anthropic.com/settings/billing |
来源：Anthropic“How do I pay for my Claude API usage?”；Claude Code“Error reference: Credit balance is too low”。旧消息来自 GitHub 上的报告。2026年10月26日确认。
Claude Code 官方错误参考列出了两个原因：你的 Console 组织的预付额度已用完，或者你本想使用订阅，请求却是用 Console 的 API 密钥发送的。这就是上面的原因 A 和 B。
2. 找出原因的三个问题
按顺序回答下面的问题，就知道该用哪种解决方法。
Q1 你是否打算以 Pro、Max、Team 或 Enterprise 计划使用 Claude Code？
是 转到 Q2。如果是按订阅计划运行，本不该出现这个错误否（使用 API 密钥或自己的应用） 转到 Q3Q2
/status是否显示了 API 密钥？否 查看登录方式一行。如果是用 Console 账号登录，费用从 Console 余额中支付 → 运行/login，改用订阅账号重新登录（第4节第5步）Q3 在 Console 的 Billing 中，该密钥所属的组织是否还有余额？
Q2 的依据：Claude Code 的错误参考建议看到此错误的订阅用户检查 /status 中的 API key 一行。登录方式为 Console 时如何切换，见 Anthropic“Use Claude Code with your Pro or Max plan”（如果是通过按量付费的 Console 账号登录，用 /login 切换到订阅计划）。
为 Claude Pro 等订阅计划支付的费用不能用来支付 API。Anthropic 的帮助说明，订阅计划与 Console 是不同的产品，API 单独计费（Why is Claude API usage billed separately from my paid Claude plan?）。即使有订阅，只要在用 API 密钥运行，就需要 Console 余额。
3. 原因 A 充值额度
这是使用 API 密钥的人的解决方法。只有在 Console 组织中拥有 Admin 或 Billing 角色的成员才能购买额度。如果是公司的组织，请联系管理员。
- 打开 Billing 页面 登录 Console，打开 Billing。组织的额度余额和已用金额显示在同一页面上。如果你属于多个组织，请确认选中的是创建出错密钥的那个组织。余额按组织计算，同一组织内的所有 API 密钥共用同一份余额。
- 购买额度 点击“Buy credits”，输入金额并确认。根据帮助文章，购买的额度立即可用。
- 开启自动充值（可选） 在 Credit balance 部分，通过“Set up auto-reload”输入触发充值的余额（When credit balance reaches）和充值后的余额（Bring credit balance back up to），然后点击“Turn on”。如果余额已经等于或低于该金额，按钮会变成“Turn on and purchase”，并当场完成购买。
- 重试失败的操作 在 Claude Code 中再次发送同样的指令。
来源：Anthropic“How do I pay for my Claude API usage?”（购买步骤、立即可用、自动充值设置、购买一年后过期、不予退款）。2026年10月26日确认。
购买的额度自购买之日起一年后过期，且不能退款。只买会用到的量，余额不足时交给自动充值补足，浪费可能会更少。Claude Code 的错误参考还建议在 Console 中为每个工作区（workspace）设置支出上限，以免单个项目耗尽整个组织的余额。
4. 原因 B 删除 API 密钥，改用订阅计划
这是打算使用 Pro、Max、Team 或 Enterprise 计划的人的解决方法。存在多种凭据时，Claude Code 会按固定顺序选择其一，而环境变量 ANTHROPIC_API_KEY 和设置文件中的 apiKeyHelper 排在通过 /login 完成的订阅登录之前。正如 Anthropic 的帮助所解释的，使用密钥时会按量计费到该密钥所属的组织；如果该组织没有余额，就会被这个错误拦下。
- 用 /status 检查 在 Claude Code 中运行
/status，查看 API key 一行。登录和 API 密钥同时存在时，未被使用的一方会有标记。 - 从当前 shell 中删除 在已打开的终端中删除该变量（命令见下方）。
- 删除密钥的来源 找到并删除 shell 配置文件中的
export ANTHROPIC_API_KEY=...一行、Windows 的用户环境变量，以及 PowerShell 配置文件（$PROFILE）中的相关条目。否则下次打开终端时会再次加载。根据官方错误参考，direnv 之类的工具或 IDE 的终端可能会从项目的.env文件加载密钥，所以也要检查项目文件夹中的.env。如何在 Claude Code 设置文件的env或apiKeyHelper中找到它，见我们关于“claude.ai connectors are disabled”的文章。 - 重新打开终端并启动 claude 官方帮助把不重开终端就修改环境变量列为常见错误。
- 必要时运行 /login，再次运行 /status 如果还没有用订阅账号登录，运行
/login。当/status确认没有使用 API 密钥时，就完成了。
# macOS / Linux：检查是否已设置
env | grep ANTHROPIC
# 从当前 shell 中删除
unset ANTHROPIC_API_KEY
# 查找是哪个配置文件设置了它
grep -n ANTHROPIC_API_KEY ~/.zshrc ~/.bashrc ~/.bash_profile ~/.profile 2>/dev/null
# Windows（PowerShell）：检查是否已设置
Get-ChildItem Env:ANTHROPIC*
# 从当前 shell 中删除
Remove-Item Env:ANTHROPIC_API_KEY
# Windows（命令提示符）：检查是否已设置
echo %ANTHROPIC_API_KEY%
# 从当前 shell 中删除
set ANTHROPIC_API_KEY=在 Windows 上，持久设置要从“系统属性”→“高级”→“环境变量”中的用户变量里删除。来源：Anthropic“Manage API key environment variables in Claude Code”；Claude Code“Authentication precedence”和“Error reference”（检查命令和 .env 见“Invalid API key”一项）。2026年10月26日确认。
如果不想删除密钥，也可以改为撤销批准。以交互方式启动时，Claude Code 第一次发现 ANTHROPIC_API_KEY 会询问一次是否使用，并记住你的回答。之后想更改，可以在 /config 中切换“Use custom API key”（只有设置了该变量时才会出现这个选项）。不过，在 claude -p（非交互模式）下，只要存在密钥就一定会使用。如果其他脚本需要这个密钥，只在运行那些命令时传入。
如果在 VS Code 扩展中出现
在 VS Code 的 Claude Code 扩展中，检查的内容相同。在面板中输入 /status 即可查看账号等信息（Claude Code v2.1.280 及以上）。根据官方文档，从终端用 code . 启动的 VS Code 会继承该 shell 的环境变量。如果密钥写在终端的配置文件里，也可能传到扩展中。删除密钥后，请先关闭并重新打开 VS Code 再检查。
也可以在扩展的 claudeCode.environmentVariables 设置中设定环境变量。请在 Settings 的 Extensions → Claude Code 下确认这里没有设置 ANTHROPIC_API_KEY。
来源：Claude Code“Use Claude Code in VS Code”（继承环境变量、environmentVariables 设置、/status）。2026年10月26日确认。
5. 你的用量由什么支付
被称为“额度”（credits）的东西有三种，混为一谈就容易误读这个错误：在 Console 购买的 API 额度、Max 和 Team 附带的每月 API 额度，以及用于支付超出 Pro 或 Max 计划限额部分的用量额度（usage credits）。下表列出每种使用方式可以用什么支付。
| 使用方式 | 计划内用量 | 用量额度 | 在 Console 购买的额度 | Max/Team 每月 API 额度 |
|---|---|---|---|---|
| Claude Code（以订阅计划登录） | 使用 | 超出限额后 | 不使用 | 不覆盖 |
| Claude Code（API 密钥，交互式） | 不使用 | 不使用 | 使用 | 不覆盖 |
claude -p 和 Agent SDK（自己用 API 密钥运行） | 不使用 | 不使用 | 使用 | 使用 |
| 从自己的应用调用 Claude API | 不可用 | 不可用 | 使用 | 使用 |
来源：Anthropic“Monthly API credits for Max and Team plans”（不覆盖交互式 Claude Code 和用量额度；覆盖自己用 API 密钥运行的 claude -p 和 Agent SDK）；“Manage usage credits for paid Claude plans”（用量额度在计划限额用完后同时适用于 Claude 和 Claude Code，与每月 API 额度相互独立）；“Manage API key environment variables in Claude Code”（存在 API 密钥时，按量计费到该密钥所属的组织）；“How do I pay for my Claude API usage?”。2026年10月26日确认。
与这个错误相关的是右侧两列（你的 Console 组织的余额）。从表中可以得出三点。
- 如果你以为在用订阅计划却看到这个错误，你就处在某一行 API 密钥的情况中。无论给订阅计划或用量额度（左侧两列）充多少钱都解决不了（原因 B）。
- Max 和 Team 的每月 API 额度不能用于交互式 Claude Code。即使 Console 的余额页面上还显示着计划附带的额度，也不能用来支付以 API 密钥运行的交互式 Claude Code。如何领取以及使用顺序，见我们关于 Max 和 Team API 额度的文章。
- 用量额度是 claude.ai 设置（Settings → Usage）中的另一份余额。它与 Console 余额相互独立，所以充值它对 API 密钥的使用没有帮助。
6. 相似但不同的错误
还有其他与余额或限额相关的错误。可以通过消息的开头来区分。
| 消息开头 | 含义 | 解决方法 |
|---|---|---|
You have reached your specified API usage limits | 达到了你自己为组织或工作区设置的支出上限（400）工作区上限时显示 specified workspace API usage limits。在 Claude Code 中，工作区上限也可能以 429 返回 | 在 Console 中提高或取消上限 |
You have reached your API usage limits | 达到了你的用量层级的月度上限（429） | 等到下个月初（UTC），或申请更高的层级 |
You've hit your session limit | 用完了 Pro 或 Max 的5小时用量 | 等待用量重置，或使用用量额度（我们关于用量上限的文章） |
Invalid API key、This organization has been disabled | 环境变量中的旧密钥被拒绝 | 删除密钥并运行 /login（我们关于认证和登录错误的文章） |
来源：Claude API“Rate limits”（两种支出上限错误）；Claude Code“Error reference”。2026年10月26日确认。
Claude Code 的其他错误一览，见Claude Code 常见错误及解决方法。
总结
- “Your credit balance is too low to access the Anthropic API”表示你的 Console 组织的预付额度不足。在 Claude Code 中显示为“Credit balance is too low”
- 原因要么是 A 余额确实不足，要么是 B 你本想用订阅计划，
ANTHROPIC_API_KEY却让你走了 API 计费。用/status区分 - A 的情况，在 Console 的 Billing 中购买额度。开启自动充值可减少中断
- B 的情况，从环境变量和设置文件中删除密钥，重新打开终端（或 VS Code），再用
/status确认 - Max 和 Team 的每月 API 额度不能用于交互式 Claude Code，订阅计划的用量额度也与 Console 余额相互独立
常见问题
Q. Claude API 有免费额度吗？
A. 官方帮助没有提到免费额度。创建 Console 组织后，指引是“向组织的余额中添加额度，以使用 API 和 Playground”（I created a Claude Console organization - how do I start using the Claude API?）。例外是 Max 和 Team 计划附带的每月 API 额度；Free、Pro 和 Enterprise 计划不在适用范围内。
Q. 我订阅了 Claude Pro，为什么会出现这个错误？
A. 因为 Claude Code 正在用 API 密钥运行。订阅费用不能支付 API，所以如果 API 密钥所属的组织没有余额，就会出现这个错误。用 /status 检查是否在使用 API 密钥，并按照第4节的步骤删除它。
Q. 我已经购买了额度，但仍然报错。
A. 根据帮助文章，购买的额度立即可用。首先确认创建密钥的组织与购买额度的组织是同一个。Anthropic 的状态页面记录了2026年9月1日（UTC）的一次事故：余额已归零的用户购买的额度入账延迟，部分 API 请求错误地返回了“credit balance is too low”（Delays in credit purchases）。同年10月1日，又发生了一次购买入账延迟的事故（Delayed credits on the Claude Platform）。如果组织一致且余额已显示，请到 status.claude.com 查看是否有正在发生的事故。
Q. 我的 Max 每月 API 额度还有剩余，但 Claude Code 中出现了这个错误。
A. 每月 API 额度不能用于交互式 Claude Code，无论是在终端、IDE、桌面应用还是网页版（第5节的表格）。要用订阅计划，就删除 API 密钥并使用登录；要用 API 密钥，就在 Console 购买额度。
