本文根據 Claude 開發者平台官方文檔《Rate limits》整理,資料核對於 2026-11-05。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Anthropic 官方網站。
適用於誰
- 剛接入 Claude API,想知道「我有多少額度、會不會被限流」的開發者;
- 業務量上來了,想知道怎麼申請更高限額的人;
- 已經收到 429,想了解層級背景的人。429 本身的排查(retry-after、加速限制等)見 /guides/claude-api-error-429-rate-limit,本文只講層級與提額。API Key 與 Console 入口見 /guides/claude-api-key-console。
結論先說
- 限額有兩種: 花費上限(Spend limits,每月最多花多少)和速率限制(Rate limits,一段時間內最多發多少請求)。官方說限額在組織層級執行;你還可以給組織下的工作區設定更低的自定義限額。
- 按用量層級(usage tier)定。 官方說:組織會根據使用歷史和帳號狀態被自動放進某個層級,隨着使用可以升到更高層級。新組織或使用記錄很少的組織,可能從 Evaluation 層級起步,限額低於頁面上的標準限額,隨歷史積累自動提高。
- 去哪裏看自己的層級: Claude Console 的 Rate limits 頁面(
platform.claude.com/usage/limits)。 - Messages API 的速率限制按三個量度: 每分鐘請求數(RPM)、每分鐘輸入 token(ITPM)、每分鐘輸出 token(OTPM),按模型類別分別計算。
- 想要更高限額: 在 Rate limits 頁面用 Request tier increase;緊急情況聯絡 Anthropic 支持。

圖:本站根據 Claude 官方文檔:Rate limits 整理的示意圖
一、月度花費上限(按層級)
官方頁面寫明:Start、Build、Scale 三個層級各有月度花費上限,是你的組織每個自然月在 API 上最多能花的金額(2026-11-05 頁面):
| 層級 | 月度花費上限 |
|---|---|
| Start | 500 美元 |
| Build | 1,000 美元 |
| Scale | 200,000 美元 |
Custom 層級沒有月度花費上限,由你與客戶團隊約定。你可以在 Console 的 Billing 頁面(platform.claude.com/settings/billing)查看自己組織的月度上限。數值可能調整,以頁面顯示為準。
到達上限會怎樣: 官方說,API 用量會暫停,直到下個月第一天的 00:00 UTC,除非你提前申請更高上限。暫停期間請求返回 HTTP 429,錯誤體裏 error_code 是 enforced_spend_limit_reached,消息會寫明恢復訪問的時間。官方還強調:這種 429 不帶 retry-after 頭,重試沒有用。
二、自己設一個更低的花費上限
想控制成本,可以在官方允許的範圍內給自己設限(官方步驟):
- 在 Console 進入 Billing 頁面;
- 在 Spend limits 部分點擊 Adjust limit(還沒設定時是 Set limit);
- 輸入新數值,不能超過你當前層級的上限。
注意錯誤碼不同: 官方說,觸到你自己設的上限時,請求返回的是 HTTP 400,錯誤類型 invalid_request_error,消息以 You have reached your specified API usage limits 開頭(工作區上限則是 ...specified workspace API usage limits),並說明何時恢復。把上限調高或移除就能立即恢復。也就是說:觸到層級上限是 429,觸到自己設的上限是 400,別搞混。
另外官方指出,Claude Code 工作區的限額單獨檢查,超出時可能收到帶 retry-after 頭的 429。
三、速率限制:RPM、ITPM、OTPM
官方說明:超出任何一項限額,你會收到 429,告訴你超的是哪一項;響應有 retry-after 頭時,就等那麼多秒再重試。幾個要點:
- 限額可能在更短的時間片裏生效。 官方舉例:每分鐘 60 個請求可能被按每秒 1 個來執行,短時間的突發就可能觸發限流。
- 令牌桶算法。 官方說用的是 token bucket,容量會持續補充到上限,而不是按固定間隔重置。
- 這些是最大允許用量,不是保證的最低值。
- 加速限制: 如果你的用量突然大幅上升,也可能因加速限制收到 429;官方的建議是逐步增加流量並保持穩定的使用模式。
緩存讀取不佔 ITPM(大多數模型)
官方特別強調:對大多數 Claude 模型,只有未緩存的輸入 token 計入 ITPM。具體:
input_tokens(最後一個緩存斷點之後的 token):計入;cache_creation_input_tokens(寫入緩存的 token):計入;cache_read_input_tokens(從緩存讀取的 token):大多數模型不計入。
官方舉例:ITPM 限額 200 萬、緩存命中率 80% 時,實際可處理的總輸入約 1000 萬 token 每分鐘。官方同時說明一個例外:Claude Haiku 3.5 的緩存讀取也計入 ITPM。所以,如果你經常撞 ITPM,先看 /guides/claude-prompt-caching 能不能把重複前綴緩存起來。
其他接口有自己的限額
- Message Batches API: 有獨立限額,在所有模型之間共享,包括每分鐘請求數、同時處理隊列中的批量請求上限、每個批次的請求上限。官方列出 Start 層級每分鐘 1,000 個請求、隊列 20 萬、每批 10 萬;Build 為 2,000 / 30 萬 / 10 萬;Scale 為 4,000 / 50 萬 / 10 萬。
- Files API: 每個組織有自己的限額,在上載、列出、檢索、下載、刪除之間共享,具體數值見官方 Files API 頁面。
- Managed Agents: 創建類端點每分鐘 300 次,讀取類端點每分鐘 1,200 次,與 Messages API 的限額分開。
- 快速模式(fast mode): 在 Opus 5.5 等模型上有專門的限額,與標準 Opus 限額分開,具體見官方。
四、在 Console 裏看自己的用量

圖:本站根據官方文檔整理的示意圖
官方說可以在 Console 的 Usage 頁面監控限額使用。除了 token 和請求圖表,頁面有兩張速率限制圖:
- Rate Limit - Input Tokens: 小時內最大未緩存輸入 token 每分鐘、你當前的 ITPM 限額、輸入 token 的緩存命中率;
- Rate Limit - Output Tokens: 小時內最大輸出 token 每分鐘、你當前的 OTPM 限額。
官方的用法:用這些圖判斷自己還有多少增長餘量、什麼時候接近峰值、該申請多高的限額,以及怎麼提高緩存命中率。
響應頭裏也有實時資訊:retry-after(多少秒後可重試,不是每個 429 都有,層級花費上限的 429 一定沒有)、anthropic-ratelimit-requests-limit / -remaining / -reset、anthropic-ratelimit-tokens-limit / -remaining / -reset,以及輸入 token、輸出 token 對應的同類頭。reset 是 RFC 3339 格式的時間。
五、怎麼申請提額
官方的做法:在 Console 的 Rate limits 頁面用 Request tier increase,可以申請更高的速率限制,或更高的月度花費上限。Anthropic 支持也可以提高限額,緊急需求聯絡 Anthropic 支持。需要高於 Scale 層級的限額,官方說是通過同一頁面聯絡銷售(Custom 層級)。
申請前建議自己先整理好:
- 需要提高的是哪個模型、哪一項(RPM、ITPM 還是 OTPM);
- 從 Usage 頁面看到的峰值 token 每分鐘;
- 緩存命中率大概多少。
(這三條整理項是本站的建議;官方在 Claude Platform on AWS 的說明裏提到申請時要包含需要提高的模型、各模型輸入輸出 token 每分鐘的峰值,以及輸入中緩存或重複上下文的大致佔比,思路一致。)
Claude Platform on AWS: 官方說沒有 Request tier increase 流程,需聯絡你的 Anthropic 客戶代表或 Anthropic 支持;帳單走 AWS Marketplace,起始層級也不同。
六、給工作區設更低限額
官方說明,為了保護組織內其他工作區免受某一個工作區過度使用的影響,可以給每個工作區設自定義的花費和速率限制。要點:
- 不能給預設工作區設花費上限;
- 不設定時,工作區限額等於組織限額;
- 工作區限額按每種限制類型(RPM、ITPM、OTPM)分別設定;
- 組織級限額始終生效,即使各工作區限額加起來更多;
- 也可以用官方的 Rate Limits API 以編程方式讀取或設定。
官方舉例:組織限額是每分鐘 4 萬輸入 token、8000 輸出 token,你可以把某個工作區限制在每分鐘 3 萬輸入 token,其餘未用的額度仍可被別的工作區使用。
常見問題
Q:我想直接升到 Build 或 Scale 層級,要怎麼做?
官方只說層級根據使用歷史和帳號狀態自動安排;頁面沒有寫具體金額門檻,本文不猜。需要更高限額就走第五節的申請。
Q:限額數字在哪看?
官方頁面有分層級、分模型的 RPM、ITPM、OTPM 表格;你自己的實際數值看 Console 的 Rate limits 頁面,以那裏為準。
Q:Batch 能繞開普通限額嗎?
批量接口有獨立限額,但不是無限;聯網搜尋在批量裏還會被額外限流,見 /guides/claude-api-web-search-tool。
相關教學
- /guides/claude-api-error-429-rate-limit:429 的幾種來源與處理
- /guides/claude-prompt-caching:提示詞緩存,降低 ITPM 佔用
- /guides/claude-api-key-console:API Key 與 Console
參考資料
- Claude 開發者平台文檔:Rate limits — https://platform.claude.com/docs/en/api/rate-limits
0 條評論
還沒有評論,來搶沙發~