Claude Code 使用额度已用完怎么办?先看是哪种限制

Claude Code 提示达到限制时,先核对账户、Organization、API 路径、额度、模型家族与 Context,再决定付费或重试。

Claude Code 提示达到使用限制时,保留完整错误,先运行 /usage,并在更换模型、账户或计费方式前检查 /status。如果另一个页面看起来还有余量,应先确认当前 Claude 身份、Organization、API Credential、余额类型和提示点名的具体限制。

共享 Session / Weekly Allowance、模型家族限制、Context 警告、API 429 和 Spend Limit 需要不同处理。只使用 Anthropic 为经过授权的账户提供的路径:等待页面显示的 reset、启用符合资格的额外用量、请组织管理员检查容量、针对持续需求换套餐,或明确启用单独计费的 Console API 账户。

身份与支出限额核验日期:2026 年 10 月 12 日。 错误文案、命令、模型、限制、reset、Usage Credits 和费率都会变化。请以实时提示、/usage、/status、账户账单页和 Anthropic 官方文档为准。

明明还有余量却报错?先查这七项

先核对身份与调用方式:

  1. Claude 身份: 当前邮箱和登录方式,是否就是拥有目标套餐的身份?
  2. Organization: Claude Code 是否连接到预期的个人、Team 或 Enterprise Organization?
  3. Credential 覆盖: /status 显示订阅身份还是 API Route?检查 ANTHROPIC_API_KEY、Cloud Provider Credential 或 Gateway 设置是否优先。
  4. 余额类型: 你看到的是套餐内用量、Usage Credits,还是 Claude Console API 余额?它们不能互换。
  5. 具体 Meter: /usage 指向 Session、Weekly、模型家族,还是扩展 Context Allowance?
  6. 其他 Claude 活动: Claude Chat、Cowork 或其他受支持入口,是否共用相应额度?
  7. 服务或 API 条件: 原始提示会不会其实是 Rate Limit、Spend Limit、认证错误、Gateway 失败或服务事件?

个人还有余量,不代表组织总预算也还有余量。官方费用说明指出,Team/Enterprise 的 usage credits 行不展示整个组织的限额。如果出现 Showing last-known usage,显示的是未能刷新时保留的历史用量;先检查时间,并使用界面提供的刷新操作,不要把旧进度条当成当前可用额度。

完成检查后数字仍然不对,可以保存完整提示、时间和时区、客户端版本、模型、当前 Organization、认证方式与脱敏截图,再联系 Anthropic Support。绝不能附上 Key。

给 Claude Code 限制准确分类

提示或信号实际含义正确第一步
Session 或 Weekly Usage Limit共享套餐窗口已经耗尽查看 /usage;等待 reset 或使用符合资格的官方容量选项
点名模型家族的限制某个较窄的模型家族额度耗尽共享用量仍有余量时,选择该家族之外的可用模型
扩展 Context Entitlement当前模型或账户无法使用该 Context 选项回到支持的标准 Context,或使用经过授权的 Entitlement
Context Full当前对话无法携带更多工作历史使用 /compact,或保存交接后再 /clear
API 429当前调用方式报告限速或容量问题通过 /status 确认路由,再检查对应 Provider 限制
Spend Limit 或 API 余额不足当前计费所有者无法授权更多支出检查拥有该路由的 Console、Project 或 Gateway
服务异常服务暂时限流或失败保存工作、查看状态并有节制地退避重试

官方 Claude Code Error Reference和用量与限制说明会分别记录这些条件。清理 Context 不能补充套餐用量,等待套餐 reset 也无法解决 API Project 的 Spending Cap。

提示组织支出达到上限时

仅凭 org spend limit reached 这类搜索短语,无法判断是谁设置了限制。保留完整错误,再用 /status 确认当前账号与认证方式。Claude Code 官方认证说明解释了为什么配置的 API 凭据可能实际取代订阅登录。

当前调用方式有权限的负责人应去哪里检查
Claude Team 或 Enterprise 订阅claude.ai 的组织用量设置;核对报错点名的组织、用户组或个人预算
Claude Console APIConsole 账单与对应工作区限额;区分平台层级容量与自行设置的预算
云服务商或组织网关对应服务商的账单控制或网关管理员,而不是无关的 Claude 订阅

Anthropic 的组织费用说明区分了这些路径。订阅组织的 usage credits 支出上限,不等于 Console API 支出上限。请负责人核对报错中的预算,或等待适用的重置时间;升级个人套餐、购买另一种余额不一定能改变这个限制。

对于直接调用 API,官方限额说明还区分了:

  • 平台层级的月支出上限: 返回 429、enforced_spend_limit_reached,且没有 retry-after;反复重试不能恢复访问。
  • 自行设置的预算: 通常返回 400,提示会说明具体限制与恢复时间。
  • Claude Code 专用工作区的例外: 达到它的限额可能返回带 retry-after 的 429。因此,有这个响应头也不能单独证明是短时请求限速。

结合详细错误和实际计费页面判断。调整预算必须由有权限的负责人批准,不删除管理控制,也不换用别人的 Key。等到提示的重置时间,或获批调整生效后,先在预期路径上测试一个小请求,再恢复中断的任务。

如果共享 Session 或 Weekly Allowance 已耗尽

以 /usage 或错误中显示的重置时间为准。切换 Claude 模型不能恢复已经完全耗尽的共享窗口。

受支持的下一步可能包括:

  • 等待显示的 reset;
  • 在设置 Spending Cap 后启用符合资格的 Usage Credits;
  • 请 Team 或 Enterprise 管理员检查容量控制;
  • 代表性工作反复触顶时,更换更合适的套餐;
  • 有意识地启用拥有独立预算和政策的 Console API Route。

Claude Code 价格指南比较这些商业路径;Claude Code 工作流指南则解释另一个问题:如何选择 Workspace。等待期间不要重复提交同一个 Prompt,应先检查文件与部分产出。

如果只有点名的模型家族受限

模型家族限制可能比共享 Session 与 Weekly Window 更窄。如果 /usage 显示共享用量仍有余量,而且原始提示明确点名一个家族,可以用 /model 选择该家族之外、当前可用的模型。

先确认新模型已获授权并适合任务。从一项边界清楚、可逆的步骤开始,重新运行相关测试。如果提示点名的是共享额度,就不要把换模型当成解决办法。

Usage Credits 与 Console API 不是同一张账单

Anthropic 的 Usage Credits 说明介绍了绑定在符合资格付费套餐上的额外用量。是否可用、余额、标准 API 费率和支出控制,都取决于实时账户。

Claude Console API Key 则是独立 Credential 和账单。更换路由前:

  • 运行 /status 确认当前方式;
  • 检查环境变量与 Managed Settings 是否覆盖 Credential;
  • 确认谁拥有 Console Organization,谁有消费权限;
  • 设置预算与 Rate Limit;
  • 把 Key 存进获批的 Secret Manager;
  • 明白套餐 Usage Credits 不会给 Console API 余额充值。

不要借用他人的 Key 或共享登录。那会改变授权和风险,并没有解决原账户的合法容量问题。

Context 与服务错误需要另一套处理

/compact 会总结对话历史,让同一任务使用更少 Context 继续;/clear 会删除对话历史,只有在保存必要决定和交接后才适合使用。这两个命令都不会补充套餐用量。

遇到 API 429 时,先确认请求走 Anthropic、Cloud Provider 还是 Gateway,检查详细错误是否指向支出上限,再按该调用方式的规则决定是否重试。遇到 Spend Limit 时,检查当前路由的计费所有者。暂时性服务事件则应先保存工作并有节制地重试,不要运行高频循环。

重试前保护已经完成的工作

开始下一次请求前:

  • 检查已保存文件与当前 diff;
  • 保留测试输出与未解决决定;
  • 确认是否已经执行外部动作;
  • 记录最后一项通过验收的步骤;
  • 只重试缺失且边界清楚的动作。

容量恢复后,通过收窄无关上下文、指向准确文件、精简指令、关闭未使用集成和检查部分产出,减少浪费。用量取决于模型、Context、工具、并行 Session 和修复循环,不是通用 Prompt 数量。

Macshop 能改变什么,不能改变什么

Macshop 可以保存项目文件、Session,以及受支持 Agent 之间经过 Review 的交接。Macshop 工作方式说明会分别解释工作空间连续性与 Anthropic 用量。

它不会补充 Claude 额度、授予扩展 Context Entitlement、授权借来的 Key 或绕过 Anthropic 账户规则。选择 Macshop 是独立的产品与计费决定。

可以先比较 Macshop 当前套餐;如果页面展示的模型访问、付费选项与工作空间工作流符合需求,再注册 Macshop 账户。