Claude 3.5 Sonnet 退役後,Cursor 429 怎麼定位?(2026)

先找出 HTTP 429 是由哪一層回傳,再看回應內容、限流標頭與閘道日誌;不要先增加重試。Claude 3.5 Sonnet 的 Anthropic API 版本已於 2025 年 10 月 28 日退役,舊模型 ID 造成的請求失敗,不能當成可靠重試解決的限流問題。Anthropic 官方退役紀錄
遇到 Cursor 429、但不清楚請求是否直連模型服務的開發者,可按呼叫路徑辨認責任層。
使用 LiteLLM 的工程師,可對照上游回應與閘道自身限制。
維護舊版 Claude 3.5 Sonnet 整合的團隊,則應先確認模型 ID 是否仍有效。
Claude 3.5 Sonnet API 429 排查:先分清回應邊界
狀態碼只表示收到一種 HTTP 錯誤回應,不能單憑 429 判定是 Anthropic 限流。Cursor 畫面顯示的錯誤、LiteLLM 回覆的錯誤,以及模型服務回傳的原始錯誤,可能在不同層產生。要避免把責任推錯,先找出請求經過哪些元件,並盡量保留回應本文、標頭與對應時間的日誌。
| 請求路徑 | 優先檢查 | 不能直接推定 |
|---|---|---|
| Cursor 自備 API Key 直連 | Key 路徑、所選模型、上游回應本文與標頭 | 看到 Cursor 錯誤就等於 Cursor 限流 |
| Cursor 內建模型服務 | 實際使用的模型路徑、用戶端訊息、帳戶服務狀態 | 沒有上游原始回應,就能推算帳戶 RPM 或令牌上限 |
| 經過 LiteLLM | 閘道入站紀錄、虛擬金鑰或團隊限制、上游呼叫與路由結果 | 閘道顯示 429 就一定是模型服務限流 |
Cursor 呼叫 Claude API 出現 429,怎樣判斷是否 Anthropic 限流?
先確認 Cursor 是否使用您自己的提供方 API Key,以及該請求實際送往哪個模型服務。Cursor 的 API Key 設定說明可協助確認自備金鑰路徑;若取得上游原始回應,再核對本文內容與回應標頭。Cursor API Key 設定說明 自備 Key 與 Cursor 內建服務的額度及故障責任並不相同,不能把兩種路徑的錯誤混為一談。
自備金鑰直連與內建服務
直連時,先在 Cursor 設定中核對 API Key 是否已啟用、所選模型是否與該 Key 所屬服務相符。不要把金鑰貼進公開問題或日誌;需要比對紀錄時,應先遮蔽憑證。若可從提供方取得原始回應,Anthropic 說明的限流維度包括 RPM、ITPM 與 OTPM;這些維度代表請求數、輸入令牌與輸出令牌相關限制,應以實際回應及帳戶狀態判讀,不要自行猜測帳戶上限。Anthropic API 限流說明
Claude API 429 回應中的 retry-after 和限流標頭怎樣看?
查看原始 HTTP 回應,而非只看 Cursor 的錯誤提示。若回應含有 retry-after,依服務方提供的等待指示處理;若有 Anthropic 限流狀態標頭,將其與回應本文、請求時間一併核對。標頭缺失時,不應自行補出 RPM、令牌剩餘量或重置時間。Anthropic 的限流與錯誤文件說明了 429 及相關回應資訊的使用邊界。限流文件 API 錯誤文件
若 Cursor 使用內建模型服務,開發者通常無法看到上游原始回應標頭。這時先記錄 Cursor 顯示的錯誤、所選模型與帳戶服務狀態,再向服務方確認其處理路徑及帳戶限制。沒有原始標頭,就不能從一段用戶端提示推導具體 RPM 或令牌配額。能自行核對的是模型選擇與用戶端設定;服務端限額及上游狀態則需由服務方查證。
LiteLLM 閘道回應與上游限流
請求經過 LiteLLM 時,排查要同時看閘道入口與上游結果。先確認該請求是否進入 Proxy,再比對請求使用的模型組、虛擬金鑰或團隊限制設定,以及日誌中是否記錄上游呼叫。LiteLLM 的 Proxy 架構文件描述了請求處理流程;使用者限流文件則說明可套用在閘道使用者上的限制。Proxy 請求處理流程 LiteLLM 使用者限流文件
LiteLLM 回傳 429,是閘道並發限制還是上游模型限制?
若閘道紀錄顯示請求在本地限制階段即被拒絕,應檢查虛擬金鑰、使用者或團隊層級的設定;若紀錄顯示已呼叫上游,則再核對上游回應本文與標頭。若發生路由切換或重試,也要確認各次嘗試分別回傳甚麼。LiteLLM Router 文件可用來核對路由與重試行為,但本文只用這些紀錄定位故障,不涉及部署或編寫故障轉移規則。LiteLLM Router 路由與重試說明
場景上,若 Cursor 顯示 429,而 LiteLLM 完全沒有對應入站紀錄,優先檢查 Cursor 是否走了預期的網關路徑;若有入站紀錄、沒有上游呼叫,先查閘道側限制;若有上游請求及上游 429,才有證據將問題指向提供方。這種逐層比對,比單純增加重試更能避免把流量送往錯誤的排查方向。
舊模型 ID 與真正的限流錯誤
Claude 3.5 Sonnet 退役後,舊模型 ID 仍可能留在 Cursor 選項、應用程式設定或 LiteLLM 模型映射中。先搜尋這些位置,再與 Anthropic 官方退役紀錄核對。官方列明 Claude Sonnet 3.5 API 模型已於 2025 年 10 月 28 日退役;因此,若請求仍使用已退役標識,應先處理模型狀態,而不是將錯誤當成速率限制。Anthropic 模型退役紀錄
辨認時看完整錯誤本文與請求路徑。模型不存在、已退役或模型名稱不匹配,與明確指出速率限制的回應語意不同。遇到模糊錯誤,記錄實際送出的模型 ID,再確認設定映射是否把別名導向舊模型;遷移至目前可用模型後,重新觀察用戶端回應和閘道紀錄,避免沿用舊錯誤作判斷。
舊 Claude 3.5 Sonnet 模型 ID 失敗時,怎樣核實?
在 Cursor 模型選擇、應用程式設定及 LiteLLM 模型映射中逐一搜尋舊 ID,並與官方退役紀錄比對。確認已切換到有效模型後,再發送受控請求;若錯誤仍是 429,才按直連、內建服務或閘道路徑重新檢查限流證據。
依證據選擇下一步
依照下列條件分流;不要把所有錯誤都交給重試處理。
- 若能取得上游原始回應,且本文或標頭明確指出限流,按提供方的等待指示處理,再核對帳戶與限流維度;沒有
retry-after時,不要自行猜一個等待時間。 - 若 LiteLLM 有入站紀錄,但沒有上游請求紀錄,先檢查閘道虛擬金鑰、使用者或團隊限制與模型組設定。
- 若 LiteLLM 有上游請求與上游 429 回應,再沿上游本文及限流標頭確認;不要只看 Proxy 最後輸出的狀態碼。
- 若請求使用 Claude 3.5 Sonnet 舊模型 ID,先核對退役狀態並修正模型映射,再觀察新回應。
- 若只有 Cursor 內建服務的錯誤提示,保留模型選擇與錯誤資訊,向服務方核實帳戶或上游狀態;不要從提示推算看不到的 RPM 或令牌上限。
實際操作可依次完成:確認 Cursor 的金鑰路徑;記下所選模型 ID;保存錯誤本文與可取得的回應標頭;在 LiteLLM 搜尋對應入站請求;確認有沒有上游呼叫及其結果;最後核對模型退役紀錄與帳戶服務狀態。每一步都要保留同一請求的關聯資訊,並遮蔽金鑰。若加大重試次數,請求量可能隨之增加;跨模型 fallback 也不保證回覆內容或行為一致。LiteLLM 的重試與路由說明應用於理解既有紀錄,不應取代故障來源判定。
開發環境與 API 網關的責任邊界
本機 Mac 或雲端 Mac 是執行 Cursor、程式碼與開發工具的環境;LiteLLM 是請求路由與閘道層;模型推理及其 API 限流則由上游模型服務處理。更換開發機不會直接解除上游 API 限制,租用 Mac 也不會把已退役的模型 ID 變成有效模型。
若目前在共用開發機上排查,環境睡眠、共用設定變更或遠端連線中斷,可能令重現問題更困難;但這些是開發環境的穩定性問題,不是 429 的上游成因。需要固定 macOS 開發環境或遠端連線時,可先查看 ProxyMac 支援資訊;若工作本身需要遠端 Mac,再核對 ProxyMac 方案資訊。在相同條件下,持續使用既有共用機可能有設定漂移、可用性受本機狀態影響等缺點;Mac 租用可提供獨立的遠端 macOS 工作環境,但不會修復 API 限流、上游故障或舊模型設定。若故障證據指向開發環境,而非模型 API,才值得把 ProxyMac 納入比較。