Claude Code monthly spend limit 怎么办？“You’ve hit your monthly spend limit” 实测解决办法

先说结论：Claude Code monthly spend limit 这条提示，也就是 You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message，意思是套餐自带的额度已经不够这次请求用，而你给额外用量（usage credits）设的每月花费上限也到了。Pro 或 Max 用户去 claude.ai 的 Settings > Usage 调高上限，或者在 Claude Code 里运行 /usage-credits。调之前先看这行字的末尾：如果有 · your session limit resets 3:45pm 这类内容，说明是套餐的某个额度窗口用完了，等到那个时间也能恢复。另外，上限满了的时候充值没用。下面的原文和处理办法以 Claude Code 官方报错文档 为准（2026 年 10 月 29 日核对）。真实账号的月度上限我们没法触发，所以实测用的是模拟接口，细节写在下面。

Claude Code 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
You've hit your team's shared budget · ask your admin to raise it at https://claude.ai/admin-settings/usage
You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings

按用量计费的组织里，spend limit 会换成 usage limit。帮助中心文章里有一句很关键：开了额外用量后，会一直用到达到每月花费上限，或者在关闭自动充值时余额用完为止。也就是说，“上限”和“余额”是两回事。

实测：模拟接口下的 Claude Code monthly spend limit 提示

要看到真实的月度上限提示，得有一个额外用量刚好顶到上限的 claude.ai 订阅账号，我们手上没有这种状态的账号。伪造一个本地保存的 Pro 登录也不行：Claude Code 会尝试刷新，然后报 Failed to authenticate: OAuth session expired and could not be refreshed。所以上面 Pro/Max 那一行原文来自文档，不是我们屏幕上的输出。

我们能做的是：用 ANTHROPIC_BASE_URL 把 Claude Code 2.1.312 指向本地模拟接口，设一个测试用的 CLAUDE_CODE_OAUTH_TOKEN，让接口返回 429 和 CLI 会读取的用量响应头。把 5 小时窗口标为用完、额外用量标为已到上限后，claude -p hi 输出：

You've hit your individual spend limit · ask your admin to raise it at https://claude.ai/admin-settings/usage · your 5-hour limit resets Nov 3, 12:20am (Asia/Shanghai)

环境变量里的令牌不带套餐类型，所以 Claude Code 用了 individual 的写法，指向管理员页面；文档也说这段文字会随套餐和你有没有账单权限而变。重置时间是模拟接口给的，按测试机时区显示。同样返回 429、但把原因换成额外用量余额用完（而不是到了上限）时，提示变成 You've hit your 5-hour limit · resets Nov 3, 12:20am (Asia/Shanghai)。之前的两次测试里还有两个长得像的：网关式 429 显示 API Error: Request rejected (429) · spend limit reached (daily; resets 2026-10-29 00:00 UTC)，没有余额的 Console key 显示 Credit balance is too low。

Claude Code monthly spend limit 怎么解决

• 先看提示末尾：有 · your ... limit resets ... 的，到点就能恢复，不用调任何东西。运行 /usage 可以看到每个额度窗口什么时候重置。
• Pro / Max：在 claude.ai 的 Settings > Usage 里，Usage credits 部分点 “Adjust limit” 调高上限；或者在 Claude Code 里运行 /usage-credits。
• 在 iOS 或安卓 App 里订阅的：帮助中心说，额外用量只能在网页版 Claude 上开启，要先在网页上添加付款方式。
• Team / Enterprise：有账单权限的，在 Organization settings > Usage 里调高；没有的，运行 /usage-credits，它会替你向管理员发申请。
• 频道上限：由组织所有者或该频道的管理员在 claude.ai 上调高，组织里其他频道可能还有预算。
• 无人值守的任务：文档说遇到花费上限的 429 会直接失败，开了 CLAUDE_CODE_RETRY_WATCHDOG=1 也一样，靠重试等不过去。

先确认真是 Claude Code monthly spend limit

带 “limit” 的提示不少，处理办法各不相同：

• 只有 You've hit your session limit 或 weekly limit：只是套餐额度窗口用完了，怎么计算可以看 Claude 额度怎么算。
• 小写的 spend limit reached：Claude apps 网关管理员设的上限，只有他们能调，见 文档的网关部分。
• Credit balance is too low：Console API key 没有预付余额，或者环境里多了一个 ANTHROPIC_API_KEY，把请求从订阅改走了 key。用 /status 查一下。
• 只有 Request rejected (429)：这是限流，见 Claude Code 429 限流怎么办。

另外，Max 套餐每月附带的 API 额度是另一笔钱，帮助中心说它不能用来支付 Claude Code 里的额外用量，见 Claude Max 每月 API 额度。

GitHub 上的用户反馈

• #75730（未关闭，v2.1.204）：一个子代理因为这条提示中断，报告者说其实只是 5 小时窗口用完了，到重置时间就恢复了。按现在的文档，额外用量同时到了上限时出现这条提示是正常的，末尾的重置时间就是提示。
• #101270（未关闭，v2.1.296）：报告者两次各买了 100 美元额外用量，都能接着用；第三次账户里明明还有余额，Claude Code 仍提示已到月度上限。这和帮助中心说的“余额和上限分开算”对得上：再充钱之前，先看上限。
• #101923（未关闭）：一位 Ultra（原 Max 20x）用户说 10 月 7 日被拒了 18 次，而 Settings > Usage 现在显示 “No spend limit”（他说之前设过上限，还在核对设置和取消的时间）。当天状态页发了 “Issue with spend limits” 故障说明，写的是部分组织被“错误地以达到花费上限为由暂停”。上限明明没问题却看到这条提示的，先看状态页，再决定要不要花钱。

更多报错见 Claude Code 报错大全。

常见问题

Claude Code monthly spend limit 会自己重置吗？

帮助中心把它描述为每月花费的上限。如果提示里还写了套餐窗口的重置时间，到点就能恢复，不需要有人调高上限。

充值能解决吗？

上限满了的话不能，要先调高上限。充值只在余额用完时有用。

能不能不设上限？

帮助中心说调整时可以选 “Set to unlimited”，前提是你能接受没有花费封顶。

这是限流吗？

不是。限流是短时间的节流，这条提示是计费问题，重试没用。