AI 开发

Claude 3.5 Sonnet 退役后,Cursor 429 怎么定位?(2026)

Claude 3.5 Sonnet 退役后,Cursor 429 怎么定位?(2026)

先定位返回 429 的那一层,再看响应体、限流响应头和网关日志,区分提供方速率限制、支出上限与本地并发限制。若配置仍指向 Claude 3.5 Sonnet,先核对模型标识:Anthropic API 中的 Claude Sonnet 3.5 模型已于 2025 年 10 月 28 日退役;增加重试不能让退役模型恢复可用。(Anthropic 模型退役记录)

遇到 Cursor 429、但不确定请求是否直连模型服务的开发者,可以按调用路径定位责任层。使用 LiteLLM 的工程师,可以核对上游返回与网关自身限流的区别;维护旧版 Claude 3.5 Sonnet 集成的团队,则应先检查旧模型标识是否仍在请求链路中。

Claude 3.5 Sonnet API 429 排查:先判断状态码来自哪一层

HTTP 429 只是状态码,不能单凭它认定 Anthropic 限流。错误可能来自 Cursor 内置服务、LiteLLM 网关,也可能是上游 API 返回。代理还可能在内部重试或切换模型,因此客户端看到的最终响应未必等于最初的上游响应。

调用路径 优先核对 能支持的判断 不能据此断定
Cursor 使用自带 API Key 直连 模型、密钥设置与上游响应 是否有上游限流证据 所有 Cursor 429 都是 Anthropic 限流
Cursor 使用内置模型服务 实际选择的模型、客户端提示、账户服务状态 当前使用的服务路径及用户可见错误 具体 RPM、令牌限额或账户上限
Cursor 经 LiteLLM 网关 入站日志、网关限制检查、上游调用记录 错误是否在网关侧产生、是否到达上游 最终状态码一定等于最初上游状态码

场景案例:开发者在 Cursor 看到 429,但项目配置指向 LiteLLM。若网关日志显示请求在虚拟密钥或并发检查时被拒绝,且没有上游调用记录,先查网关限制;若已有上游请求记录和提供方错误,再对照上游响应。编辑器中的单行提示不足以划分责任层。

直连、自带密钥与内置服务:证据范围不同

使用自带 API Key 时,先核对 Cursor 的模型设置和密钥状态。Cursor 文档说明,可在模型设置中填写 API Key;但不同功能未必使用同一调用路径。因此,排查前还要确认当前功能实际使用的是自带 Key,还是内置服务。(Cursor API Key 设置说明)

能取得的证据 适合核对的内容 证据缺口
Anthropic 原始响应体与响应头 错误类型、限流信息、重试等待时间 不能解释代理之前的客户端状态
Cursor 提示,但没有上游原始响应 所选模型、Key 模式、账户服务状态 不能据提示推断具体限额
LiteLLM 入站与上游日志 网关是否拒绝、是否发出上游请求、是否重试或 fallback 未记录的字段不能事后推定

如果使用 Cursor 内置模型服务,通常拿不到上游原始响应头。此时直接把界面提示解释成具体 RPM 或账户额度,是没有证据的猜测。应记录错误文本、发生时间、所选模型和实际调用路径;服务端限额则需要向对应服务方核实。有关开发环境的使用与访问方式,可参考 ProxyMac 使用帮助,但它不能替代模型服务方的限流记录。

响应头与网关日志:各自能证明什么

Anthropic API 的 Messages 限制包括 RPM、ITPM 和 OTPM 等维度。响应中如果带有 retry-after,应按其指定时间等待;但并非每个 429 都有这个字段,支出上限导致的 429 就不带 retry-after。因此,字段缺失不能自动证明是哪一种故障。(Anthropic API 限流说明)

字段或日志线索 可用于判断 注意边界
retry-after 上游提供的重试等待时间 只在字段存在时按其值等待
anthropic-ratelimit-requests-* 请求限制、剩余额度与重置时间 需确认响应来自 Anthropic 且字段未被代理隐藏
anthropic-ratelimit-tokens-* 令牌限制与剩余额度相关状态 客户端提示不能替代原始响应头
LiteLLM 入站检查与上游记录 请求是否到达上游、是否经过网关限制或路由 必须关联同一请求,不能只看最终状态码

Anthropic 官方错误文档说明,429 可能表示组织触及速率限制或支出上限等情况;需结合错误体及响应头判断,不能把所有 429 都当成短暂流量峰值。若客户端拿不到原始响应,记录这一证据缺口,并保留可见的请求 ID 与错误内容。(Anthropic API 错误说明)

经过 LiteLLM 时,把入站校验与上游请求记录分开检查。LiteLLM 网关可在路由到上游前检查虚拟密钥、用户、团队和服务器的 RPM、TPM 等限制;Router 则负责路由、重试与 fallback。(LiteLLM 请求处理流程) 如果网关没有上游调用记录,先查本地限制;若有上游响应,再检查其错误内容。网关自身还可为密钥、用户或团队设置 RPM、TPM 和并发限制,具体配置项可对照 LiteLLM 限流文档。

四步定位:把一次 429 变成可验证的结果

  1. 固定失败样本。记录发生时间、Cursor 当前所选模型、错误文本,以及是否启用了自带 API Key。不要连续重复点击重试,否则多个新请求会干扰对初始故障的判断。
  2. 确认调用路径。检查 Cursor 的模型与密钥设置,并核对应用 API 地址。判断请求是自带 Key 直连、使用内置服务,还是经过 LiteLLM;不要从 429 文案反推调用路径。
  3. 保留原始错误证据。直连时保存响应体、请求 ID、retry-after 和可见的 anthropic-ratelimit-* 字段。若客户端拿不到响应头,就明确记录“不可见”,不要补猜。
  4. 对齐网关日志并查模型 ID。用同一请求的时间、请求 ID 等线索查 LiteLLM 入站记录,确认是否通过密钥、团队或并发检查,是否发出上游请求,以及有没有重试或 fallback。再搜索 Cursor 选择、应用配置与网关模型映射中的 claude-3-5-sonnet-20240620 和 claude-3-5-sonnet-20241022。

旧模型 ID 请求失败,不等于速率限制。Anthropic 的退役记录列明上述两个模型 ID 已退役;若错误是模型不存在、已退役或请求无效,应先核实并更正模型映射,再观察新请求的响应。不要对无效模型 ID 反复重试。

常见问题

Cursor 429 怎样判断是不是 Anthropic API 限流?

先确认 Cursor 是否使用自带 API Key,以及请求是否确实直连 Anthropic。若能取得上游响应,查看错误体、请求 ID、retry-after 和 anthropic-ratelimit-* 响应头;若只有 Cursor 的界面提示,没有上游证据,就先核实调用路径和账户服务状态。仅凭 429 不能判定是 Anthropic 限流。

Claude API 的 retry-after 和限流响应头怎么看?

retry-after 表示建议等待的秒数;字段存在时按其值等待。anthropic-ratelimit-requests-* 和 anthropic-ratelimit-tokens-* 可提供限制、剩余额度及重置时间相关信息。并非每个 429 都带 retry-after,支出上限导致的 429 不包含该字段;代理也可能隐藏上游响应头。

LiteLLM 的 429 是网关限制还是上游限制?

将同一请求的网关入站日志与上游调用结果关联。若请求在虚拟密钥、用户、团队或并发限制检查处被拒绝,且没有上游调用记录,优先排查网关;若存在上游请求及其错误,则继续检查提供方响应。若 Router 有重试或 fallback,最终返回给客户端的状态码可能无法单独说明初始故障来自哪一层。(LiteLLM Router 路由与重试说明)

Claude 3.5 Sonnet 退役后,旧模型 ID 失败怎么核实?

在 Cursor 的模型选择、应用配置和 LiteLLM 模型映射中搜索旧 ID,并与 Anthropic 官方退役记录核对。API 中的 Claude 3.5 Sonnet 模型于 2025 年 10 月 28 日退役;确认仍在请求旧 ID 后,应迁移到官方当前可用的模型标识,再观察新响应。模型已退役时,反复重试不会修复调用。

按证据选择下一步

  • 若请求确实到达 Anthropic,且响应带有 retry-after 或限流响应头,按响应指示等待,并核对对应限制维度。
  • 若 LiteLLM 在入站检查阶段拒绝请求,且没有上游调用记录,检查虚拟密钥、用户、团队、RPM、TPM 或并发设置。
  • 若只有 Cursor 内置服务的提示,没有上游原始响应,先确认模型选择与账户服务状态;具体服务端限额需向服务方核实。
  • 若请求仍指向已退役模型 ID,先修正模型配置,再用新请求复测,不要将模型不可用当成限流。

不要把增加重试作为默认修复。有限流证据时,依照上游指示等待;没有证据时,先确认模型状态、调用路径和网关设置。Router 的重试与 fallback 可能放大请求量,而切换到其他模型也不保证输出行为相同。

若排查结果显示问题不在模型 API,而在开发环境与网关的运行边界,云端 Mac 可以承担 macOS 开发环境的角色,但不能解除模型服务的 API 限流。相比本地机器,它可提供独立的开发环境;相比通用 VPS,是否合适取决于项目是否需要 macOS 工具链。若需要临时使用 macOS 环境,可评估租赁 ProxyMac;如果任务是长期、稳定的重负载,或必须连接本地物理设备,自购设备可能更合适。ProxyMac 的使用入口与服务访问方式可查看 帮助页面及登录入口。

常见问题

Cursor 调 Claude API 报 429,怎样确认是不是 Anthropic 限流?+
先确认 Cursor 是否启用了自己的 Anthropic API Key,并检查请求是否实际直连 Anthropic。若能拿到上游原始响应,查看错误体、request-id、retry-after 和 anthropic-ratelimit 响应头;若错误只出现在 Cursor 界面且没有上游响应证据,就先核实调用路径与账户状态,不要仅凭 429 判定 Anthropic 限流。
Claude API 的 retry-after 和限流响应头分别说明什么?+
retry-after 表示等待多少秒后再试;若存在,应按该时间等待,提前重试可能继续失败。anthropic-ratelimit-requests-* 与 anthropic-ratelimit-*-tokens-* 可用于查看相应限制、剩余额度和重置时间。响应头可能被客户端或代理隐藏;Anthropic 也说明,支出上限导致的 429 不带 retry-after。
LiteLLM 的 429 是网关并发限制还是上游限制?+
把同一请求的 LiteLLM 入站日志与上游调用记录对齐:若请求在虚拟密钥、团队、RPM、TPM 或并发校验处被拒绝,且没有上游调用,优先查网关限制;若已有上游请求与提供方错误,再核对上游响应。若触发了重试或 fallback,最终返回给 Cursor 的状态不一定能单独说明最初故障来自哪一层。
Claude 3.5 Sonnet 退役后,旧模型 ID 请求失败该怎么核实?+
检查 Cursor 的模型选择、应用配置和 LiteLLM 的模型映射,搜索 claude-3-5-sonnet-20240620 与 claude-3-5-sonnet-20241022。Anthropic 已于 2025 年 10 月 28 日退役这两个 API 模型;请求退役模型会失败。先对照官方模型生命周期记录并迁移到当前可用标识,再观察新的响应,别把旧模型不可用误判成限流。

为排查工作准备一台专属云端 Mac

ProxyMac 提供独享 Apple M4 云端 Mac,方便你在稳定、独立的 macOS 环境中复现问题并留存排查记录。
支持 SSH、VNC 和浏览器多端连接,无论身在何处,都能快速访问开发环境。