註冊
Claude

Claude 報錯 429 rate_limit_error 怎麼辦：速率限制、加速限制和月度花費上限三種來源，retry-after 怎麼看

Claude API 返回 429 rate_limit_error，不一定是請求太快。按官方錯誤頁和速率限制頁（2026-10 查詢），429 有速率限制、加速限制、觸到檔位月度花費上限等來源，處理辦法不同。本文講清怎麼看 retry-after 和 error_code，以及 SDK 自動重試的行為。

NNathaniel bigo··原創首發·AI 輔助撰寫
8 分鐘讀完
資料核對於 2026-10-30 · 依據官方文檔與公開資料整理 免費帳號 帳號
本文根據 Claude 官方 API 錯誤頁和速率限制頁整理，資料核對於 2026-10-30。官方沒有單獨說明 claude.ai 網頁版聊天裏出現的 429，本文講的是 API 返回的 429，在 Claude Code、Cursor 等工具裏看到的 429 多半也是它。配圖為本站整理的示意圖，不是網頁截圖。

適用於誰

  • 調用 Claude API，返回 HTTP 429、rate_limit_error 的開發者；
  • 在 Cursor、Cline 等工具裏填了自己的 Claude API Key，工具顯示 429 的人；
  • 重試了很多次還是 429，想知道到底是什麼限制的人。

結論先說

  1. 官方錯誤頁對 429 的定義是：你的組織觸到了速率限制，或用完了所在檔位的月度花費上限，或觸到了 Claude Code 工作區的花費限制。
  2. 看響應頭 retry-after：有，就等那麼多秒再重試，更早重試會失敗；沒有，且錯誤裏帶 enforced_spend_limit_reached，就是月度花費上限，重試（包括 SDK 自動重試）都會失敗，直到下月 1 日 00:00 UTC 或你申請提高。
  3. 官方還提到加速限制：組織的用量突然猛增時，也可能收到 429。辦法是逐步增加流量、保持穩定。
  4. 你自己設的花費上限觸頂，返回的是 400（invalid_request_error）而不是 429；調高或取消限額即可。
  5. 官方 SDK 預設會對 429、5xx 和連接錯誤自動重試兩次，指數退避，並遵守 retry-after。

429 的幾種來源

圖：本站根據 Claude API 錯誤頁 和 速率限制頁 整理的示意圖

一、速率限制：請求太多或 token 太多

官方說明 Messages API 的速率限制按模型類別分別計算，包括：

  • RPM：每分鐘請求數；
  • ITPM：每分鐘輸入 token 數；
  • OTPM：每分鐘輸出 token 數。

超過其中任何一項就會收到 429，錯誤訊息會說明超的是哪一項。幾個值得知道的細節：

  • 限制是按組織計的，換一個 API Key 不會增加額度；
  • 限制可能在很短的時間窗口裏生效：官方舉例，每分鐘 60 個請求可能按每秒 1 個來執行，所以突發的並發請求也會觸發；
  • 官方用令牌桶算法，容量是持續補充的，不是整點重置；
  • 對大多數模型，命中緩存讀取的輸入 token 不計入 ITPM，所以用好提示詞緩存能提高實際吞吐，緩存方法見 /guides/claude-prompt-caching；
  • max_tokens 不影響 OTPM 的計算，OTPM 按實際生成的 token 數算。

響應頭裏會帶當前限額、剩餘量和重置時間，名字以 anthropic-ratelimit- 開頭，可以按 requests、tokens、input-tokens、output-tokens 分別查看；retry-after 是還要等的秒數，官方說不是每個 429 都帶它。

二、月度花費上限：重試沒有用

官方規則：Start、Build、Scale 三檔都有月度花費上限。用到上限後，API 用量暫停到下月 1 日 00:00 UTC，期間請求返回 429。

和普通速率限制的區別：

  • 錯誤類型同樣是 rate_limit_error；
  • 沒有 retry-after 頭；
  • 消息裏寫着月度用量閾值並給出恢復時間，error.details.error_code 是 enforced_spend_limit_reached；
  • 升到更高檔位可以恢復，提高上限在控制檯的速率限制頁發起「Request tier increase」。

具體的檔位上限金額，請看官方頁面當天的數字，本文不引用。

自己設定的上限不一樣：在控制檯帳單頁設定的花費上限觸頂時，請求返回 400，消息以「You have reached your specified API usage limits」開頭，調高或移除限額就能恢復。API Key 和控制檯的使用見 /guides/claude-api-key-console。

三、加速限制：用量突然猛增

官方在錯誤頁和速率限制頁都提醒：如果組織的用量突然大幅上升，可能因為加速限制收到 429。避免的辦法是逐步增加流量，保持穩定的使用節奏，比如批量任務從低並發開始慢慢加。官方沒有給出加速限制的具體閾值。

四、對照表：收到 429 先這樣查

收到 429 先這樣查

圖：本站根據 Claude API 速率限制頁 整理的示意圖

五、要更高的額度怎麼辦

官方提供的途徑：

  1. 控制檯「Rate limits」頁裏的 Request tier increase，可申請更高的速率限制或月度花費上限；
  2. 聯絡 Anthropic 支持，緊急情況也可以走這裏；
  3. 用工作區（Workspace）給不同項目設定更低的限額，避免某個項目佔滿整個組織的額度。官方說明預設工作區不能設花費上限；
  4. 在控制檯的 Usage 頁可以看到速率限制的圖表，了解自己的峰值和緩存命中率。

常見問題

Q：我已經等了很久還是 429，為什麼？

先看是不是花費上限：沒有 retry-after 且 error_code 是 enforced_spend_limit_reached，那就不是等幾十秒的問題，要等到下月初或申請提高。

Q：429 和 529 有什麼區別？

429 是你所在組織的限制，529 是 API 整體過載，見 /guides/claude-api-error-529-overloaded。

Q：Claude Code 裏的報錯怎麼看？

常見報錯見 /guides/claude-code-common-errors；訂閱額度不是 API 額度，兩者區別見 /guides/claude-subscription-vs-api。需要 Claude 訂閱的話，本站有 Claude Pro 充值頁。

Q：怎麼確認是官方故障？

看 /guides/claude-down-check-status-page。

參考資料

  • Claude API 錯誤 — https://platform.claude.com/docs/en/api/errors
  • Claude API 速率限制 — https://platform.claude.com/docs/en/api/rate-limits

Nathaniel 的更多內容

  1. 01

    Microsoft Copilot 官網入口在哪、怎麼下載：網頁版、Windows 應用、手機應用和工作帳號入口怎麼選

    Microsoft Copilot 有網頁版、Windows 應用、手機應用，工作或學校帳號還有單獨入口。本文按微軟支持頁面講清各入口、各自支持的登入帳號、Windows 應用從 Microsoft Store 下載，以及怎麼區分微軟的 Copilot 和 GitHub Copilot。

    其他 AI 工具0
  2. 02

    GitHub Copilot 提示無法連接到服務怎麼辦：could not connect to server、ETIMEDOUT、證書錯誤的官方排查辦法

    Copilot 提示 could not connect to server、read ETIMEDOUT 或證書錯誤，多與代理、防火牆有關。本文按 GitHub 官方網絡錯誤排查文檔，講 curl 測連通性、代理與認證限制、證書錯誤處理和公司網絡放行清單。

    GitHub Copilot0
  3. 03

    GitHub Copilot 報錯「Language model unavailable」怎麼辦：VS Code 團隊說的頭號原因，以及怎麼收集診斷資訊

    VS Code 裏 Copilot Chat 提示 Language model unavailable，官方沒有單獨說明。本文按 VS Code 團隊的說法講頭號原因（公司防火牆沒放行新端點）、怎麼看 Failed to fetch models、運行 Chat Diagnostics。

    GitHub Copilot0
  4. 04

    Windows 裏的 Copilot 是什麼軟件、能卸載嗎、怎麼關閉：卸載路徑、Copilot 鍵和 Win+C 的處理，公司電腦怎麼管

    Windows 11 新電腦上的 Copilot 是微軟的 AI 助手應用，可以卸載。本文按微軟官方文檔講清它是什麼、卸載路徑、不想被 Copilot 鍵或 Win+C 喚起怎麼改、卸載後怎麼裝回來，以及公司電腦上 IT 管理員的 AppLocker 和 PowerShell 做法。

    其他 AI 工具0
  5. 05

    Cursor 報錯「User is unauthorized」怎麼辦：官方員工給的排查順序，以及怎麼取到 Request ID 反饋

    Cursor 裏發消息時提示 User is unauthorized，官方幫助中心沒有單獨說明。本文整理官方論壇裏員工的回覆：先檢查有沒有自定義 Base URL、退出重新登入並完全重啟，仍不行就用 Report AI Action 取新的 Request ID 反饋；電郵域名被攔截的情況官方怎麼說。

    Cursor0
  6. 06

    Cursor 登入提示「Can't verify the user is human」怎麼辦：人機驗證失敗的常見原因，以及登入域名遷移後的放行清單

    Cursor 登入時提示無法驗證用戶為真人，官方幫助中心沒有這條報錯的專門說明。本文整理官方論壇裏反饋的常見情形（攔截人機驗證請求、密碼管理器自動點繼續、換瀏覽器），並按官方幫助頁說明 Cursor 登入頁正遷移到 accounts.spacex.ai 與 accounts.x.ai，公司網絡需要放行。

    Cursor0

同產品的其他教學

  1. 01

    Claude Code 官網下載在哪、怎麼安裝：原生安裝、npm、Homebrew、WinGet 怎麼選，Windows 要不要裝 Git

    搜「Claude Code 官網下載」「為什麼要裝 Git」「為什麼不推薦 npm」，官方文檔的答案是：安裝說明在 code.claude.com，原生安裝標為推薦，npm 要 Node.js 22，Windows 的 Git 是可選的。本文按官方文檔逐項說明。

    Claude0
  2. 02

    Claude Code 無法粘貼、無法讀取圖片怎麼辦：Ctrl+V 和 Alt+V 的區別，拖放和路徑三种放圖方法

    Claude Code 裏粘貼不了截圖、讀不到圖片？官方文檔給了三種把圖放進對話的方法：拖放進窗口、Ctrl+V 粘貼（Windows 和 WSL 用 Alt+V）、直接寫圖片路徑。官方沒有為「粘貼失敗」單列排查，本文把官方寫明的做法和通用排查分開講。

    Claude0
  3. 03

    Claude 報錯 529 overloaded_error 怎麼辦：API 暫時過載是什麼意思，和 429、500、504 怎麼區分

    Claude API 返回 529 overloaded_error，官方的解釋是 API 暫時過載，全體用戶高峰時都可能遇到，不是你的 Key 或餘額出了問題。本文按官方錯誤頁（2026-10 查詢）講清它和 429、500、504 的區別、SDK 怎麼自動重試、流式請求中途報錯怎麼處理。

    Claude0
  4. 04

    Claude 收費嗎：免費版能用什麼，Pro、Max、Team 官方標價是多少（2026 年 10 月官方定價頁）

    Claude 收費嗎？官方有免費套餐，也有付費套餐。按官方定價頁（2026-10 查詢）：Pro 年付摺合 17 美元每月、月付 20 美元，Max 從 100 美元每月起，Team 標準席位年付 20 美元。本文講清各檔標價、稅費、手機端價格差異，以及訂閱不含 API。

    Claude0
  5. 05

    Claude 官網入口在哪、有沒有中文版：claude.ai 和 claude.com 分別是什麼，怎麼認出假冒網站

    搜「Claude 官網入口」「Claude 官網中文版」，先分清 claude.com 是官方站點、claude.ai 是網頁版登入入口。官方介面語言列表裏沒有簡體中文，但可以直接用中文對話。本文列出官方入口、下載頁和幫助中心，並說明怎麼辨別仿冒站。

    Claude0
  6. 06

    Claude 登入報錯對照（帳號被停用以外）：There was an error logging you in、收不到登入電郵、驗證碼、Google 登入的處理

    Claude 登入不上，除了帳號被停用，還有登入出錯、收不到登入電郵、在另一台裝置點連結、想設密碼、Google 登入異常等情況。本文按官方登入幫助整理各提示的原文和處理，帳號被停用另見專門文章。

    Claude0

0 條評論

登入 後參與評論

還沒有評論，來搶沙發～