文档核实日期：2026 年 10 月 16 日。官方页面为持续更新的技术文档，未标注固定发布日期。

为什么降并发后仍然报错

Claude 官方文档说明，Messages API 的限速包括每分钟请求数、输入 token 数和输出 token 数。此外，达到使用层级的月度支出上限也会返回 429。这类错误需要等访问恢复或提高相应上限，持续重试不会解决问题。

三步判断原因

  1. 读取错误详情。 若 error.details.error_code 为 enforced_spend_limit_reached，先到控制台检查月度支出上限。官方说明这类响应没有 retry-after，但不能仅凭缺少这个响应头就断定原因。
  2. 遵守等待时间。 普通限速响应如果带有 retry-after，至少等待其中指定的秒数再重试；同时检查控制台显示的当前限额。
  3. 削平突发请求。 把批量任务放进有并发上限的队列，避免同一秒集中发送。记录是哪一种额度触发限制，再决定减少请求量、输入长度或实际输出量。

本站建议把限速和支出上限分别显示给使用者：前者可以排队等待，后者应提示管理员处理。给重试设置总次数和总等待时间，也能避免后台任务一直空转。

来源：Claude 官方文档：Rate limits。