疑难排查 · Claude Code

Claude Code 提示 Claude usage limit reached——重置时间与应对方案

订阅套餐下 Claude Code 会显示 "Claude usage limit reached. Your limit will reset at…"。这个上限到底统计什么、何时重置,以及按量付费的 API 访问有何不同。

你看到的报错

Claude usage limit reached. Your limit will reset at 3pm (America/New_York)

为什么会发生

  • 这是 Claude Pro 或 Max 的订阅上限,不是 HTTP 错误。它在 Claude Code 以订阅而非 API 密钥登录时出现。
  • 上限按滚动窗口执行——通常是五小时的会话窗口加每周总额——因此高强度使用可能在一周结束前很早就耗尽每周额度。
  • 长会话每轮都会重发全部历史,所以一个繁忙的对话消耗额度的速度远超其可见输出所显示的程度。

如何解决

  • 等到提示中说明的重置时间——消息里写明了时间,且它是滚动窗口而不是日历边界。
  • 精简每轮携带的内容:用 /compact 压缩长对话,不要拖着一个巨型会话去做不相关的任务。
  • 如果工作等不到重置,按量付费的 API 访问按 token 计费而不是按套餐额度,所以没有可耗尽的会话或每周上限。区别就是这么直白:计费方式不同,而不是绕过限制。

把 Claude Code 从订阅切换到 API 余额

export ANTHROPIC_BASE_URL="https://api.apitoken.sale"
export ANTHROPIC_AUTH_TOKEN="sk-pool-•••"
claude

相关搜索

  • claude code usage limit reached
  • claude weekly limit reached

常见问题

Claude 用量上限什么时候重置?+
在消息本身指出的时间。会话窗口按滚动方式重置(通常五小时);每周总额在填满它的使用发生一周后重置。
这和 API Error 429 是一回事吗?+
不是。用量上限是订阅额度;429 是 API 的每分钟吞吐量。它们来自不同的系统,解决方法也不同。
API 访问有同样的每周限制吗?+
没有。API 用量按 token 从余额中计量扣费,有每分钟速率限制,但没有会话或每周额度。

跳过折腾坏掉的配置

apiToken.sale 提供标准的 Anthropic API——同样的模型、同样的 SDK、一个预付余额。把你工具的 base URL 指向它,本页的配置即可原样生效。