DevOps / CI/CD

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

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 納入比較。

用 ProxyMac 專屬雲端 Mac,隔離測試環境

租用獨享 M4 實體 Mac,在獨立環境重現用戶端請求並整理診斷日誌。
透過 SSH、VNC 或瀏覽器連線,按需要檢查工具設定與網路狀況。