whenreset.news
Codex · 使用指南

Codex 429 Too Many Requests：重試耗盡與常見錯誤排查

排查 Codex exceeded retry limit, last status: 429 Too Many Requests，區分請求限速、API 額度、登入錯誤和連線中斷，選擇正確的恢復步驟。

核查於 約 7 分鐘閱讀5 項參考來源
Codex

先看結論

exceeded retry limit, last status: 429 Too Many Requests 本身不能證明 Codex 方案額度已用完。先確認帳戶和服務提供者，再查看底層錯誤：暫時限速可能在等待後恢復，API 餘額或支出限制則需要處理對應帳戶問題。建立新對話或設定本機倒數計時不能解決所有 429。

「exceeded retry limit」是什麼意思？

可以把這句提示分成兩個線索：用戶端停止了重試，最後一次 HTTP 回應為 429。這是對所給錯誤訊息的診斷解釋，不代表官方保證每個用戶端都採用相同的重試次數。App Server 協定 將嘗試失敗的錯誤與上游 HTTP 狀態資訊分開表達。

如果有前面的錯誤詳細資訊，一併保留。僅憑 HTTP 狀態，無法區分請求限速、API 額度或計費限制。反覆重新啟動同一任務可能增加請求，卻沒有處理實際原因。

1. 確認哪個服務拒絕了請求

在用戶端核對帳戶和工作區；CLI 可執行 codex login status。Codex 身分驗證文件 區分 ChatGPT 登入與 API key 存取。

  • ChatGPT 登入： 查看同一帳戶的 Codex 用量面板。如果某個時段額度耗盡，依 Codex 達到限額指南 處理。API 餘額不等於訂閱額度。
  • OpenAI API key： 查看回傳錯誤，以及對應 API 組織、專案的用量和計費。不要用 ChatGPT 方案的恢復時間判斷 API 限制。
  • 自訂 provider 或閘道： 確認失敗請求實際到達了哪家服務。它的限額和計費可能不同；只有該服務回傳 OpenAI API 錯誤碼時，才適用相應解釋。核對該服務自己的文件和支援管道。

2. 區分暫時限速與額度耗盡

有這些欄位時，結合 error.code、error.type 和錯誤說明判斷；欄位缺失時不要猜測原因。API 錯誤參考 區分以下情況：

  • 請求限速： 回應說明觸及速率限制，可能出現 slow_down。先減少平行任務和突發請求，再嘗試繼續。
  • 餘額不足： credit_balance_exhausted 指向 API 點數餘額。與帳戶負責人核對計費；等待 Codex 方案重置不會補充這筆餘額。
  • 支出或用量限制： organization_spend_limit_exceeded、project_spend_limit_exceeded 或 organization_usage_limit_exceeded 指向不同的限制。先和管理員確認適用週期及帳戶設定，再決定是否授權額外支出。
  • 較廣泛的額度類型： insufficient_quota 可能不如 error.code 具體。繼續讀詳細說明，不要直接當成暫時請求過快。

這些是 OpenAI API 的範例，不保證 Codex 介面逐項顯示。如果介面只有 429，應先保留「原因未確定」的判斷，直到用量資訊或更完整的錯誤能夠說明原因。

3. 只有等待有用時才重試

暫時 API 限速回傳 Retry-After 時，依它要求的時間等待。沒有該欄位時，OpenAI 建議指數退避並加入隨機延遲，也就是逐步拉長重試間隔並適當錯開時間。自行控制的重試迴圈應同時限制嘗試次數和總耗時。如果服務要求等待的時間超過預算，應延後任務，而不是縮短要求的等待時間。

對於互動式 Codex 任務，暫停反覆傳送，減少平行工作，依提示等待後僅嘗試一個小的接續步驟。不要在用戶端已有重試之上，再疊加密集的手動迴圈。餘額或支出錯誤不能靠退避修復，也不存在通用的「等五分鐘就好」。

繼續中斷任務前，先檢查檔案變更、命令結果和已經完成的外部操作。從確認過的步驟繼續，避免重試重複執行操作。

401、403、500、503 和串流中斷分別怎麼查？

根據實際提示選擇下一步；這些錯誤並不都意味著該等額度重置。可對照 API 錯誤參考 和 Codex 疑難排解。

  • 401： 核對身分驗證、所選帳戶和憑證是否有效。不要把金鑰貼到求助文章裡。
  • 403： 查看具體的存取權限、政策或地區限制。重複請求不會取得權限。
  • 500 或 503： 伺服器錯誤或暫時過載可以在等待後有限重試。持續失敗時查看對應服務的狀態資訊並回報問題。
  • Stream disconnected 或逾時： 用戶端尚未收到完整結果，連線就結束了。單憑這句話不能確認額度問題，也不能證明任務完全沒有執行。結合底層狀態、用戶端日誌和網路路徑排查，恢復前先核對任務進度。

持續報錯時保留哪些資訊？

記錄時間與時區、用戶端及版本、模型、登入方式、服務提供者、移除敏感資料後的錯誤訊息、HTTP 狀態，以及服務提供的 request ID（如有）。註明單個小請求是否也失敗、其他用戶端是否正常、做過哪些帳戶檢查。透過對應服務的支援管道分享日誌前，移除 API key、Authorization 請求標頭、Cookie 和私人任務內容。

如果證據最終確認是訂閱時段額度耗盡，請前往 Codex 重置時間指南。個人計時器 可以提醒你檢查帳戶顯示的恢復時間，但不能解除 API 限速，也不能確認存取已經恢復。