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 变成可验证的结果
- 固定失败样本。记录发生时间、Cursor 当前所选模型、错误文本,以及是否启用了自带 API Key。不要连续重复点击重试,否则多个新请求会干扰对初始故障的判断。
- 确认调用路径。检查 Cursor 的模型与密钥设置,并核对应用 API 地址。判断请求是自带 Key 直连、使用内置服务,还是经过 LiteLLM;不要从 429 文案反推调用路径。
- 保留原始错误证据。直连时保存响应体、请求 ID、
retry-after和可见的anthropic-ratelimit-*字段。若客户端拿不到响应头,就明确记录“不可见”,不要补猜。 - 对齐网关日志并查模型 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 的使用入口与服务访问方式可查看 帮助页面及登录入口。