速率限制

限制分為兩種類型：

1. Spend limits（支出限制）設定組織每月因 API 使用而可產生的最高費用。
2. Rate limits（速率限制）設定組織在特定時間內可發出的 API 請求數量上限。

API 會在組織層級強制執行服務設定的限制，但您也可以為組織的工作區設定使用者可配置的限制。

關於速率限制

• 限制的設計目的在於防止 API 濫用，同時將對一般客戶使用模式的影響降到最低。
• 限制依 usage tier（使用層級）定義。組織會根據使用歷史與帳戶狀況自動被置於某個層級，並可隨著使用 API 的時間推移而升至更高層級。
• 新組織以及使用歷史有限的組織可能會從評估層級開始，在建立帳戶歷史期間，其限制會低於本頁所示的標準限制。這些起始限制是 Anthropic 防止詐欺與濫用的措施之一，並會隨著您的組織累積使用歷史而自動提高。
• 限制設定於組織層級。您可以在 Claude Console 的速率限制頁面（platform.claude.com/usage/limits）查看組織的層級與目前的限制。
• 您可能會在較短的時間間隔內觸及速率限制。例如，每分鐘 60 次請求（RPM）的速率可能會以每秒 1 次請求的方式強制執行。短時間內的大量請求可能會超出限制並觸發速率限制錯誤。
• 以下限制為各層級的標準限制。若您需要更高的限制，請參閱申請更高的限制。
• API 使用 token bucket algorithm（權杖桶演算法）進行速率限制。這表示您的容量會持續補充至上限，而非在固定間隔重設。
• 此處描述的所有限制代表允許的最大使用量，而非保證的最低值。這些限制旨在減少非預期的超支，並確保資源在使用者之間公平分配。

支出限制

Start、Build 和 Scale 層級各有一個每月支出上限，即您的組織每個日曆月在 API 上可支出的最高金額。您可以在 Claude Console 的帳單頁面查看組織的每月支出上限，並設定您自己的限制。

自訂層級的組織沒有每月支出上限；其限制由客戶團隊另行安排。

達到支出上限

一旦達到您所屬層級的支出上限，API 使用將暫停至下個月第一天的 00:00 UTC，除非您提前申請更高的限制。使用暫停期間，API 請求會回傳 HTTP 429：

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "You have reached your API usage limits: your organization has crossed its monthly API usage threshold, set based on your organization's API tier. You will regain access on 2026-09-01 at 00:00 UTC.",
    "details": { "error_code": "enforced_spend_limit_reached" }
  },
  "request_id": "req_018EeWyXxfu5pfWkrYcMdjWG"
}

• 錯誤類型為 rate_limit_error，與速率限制相同，但回應中沒有 retry-after 標頭。在恢復存取之前，重試（包括 SDK 的自動重試）都會失敗。
• 在 Messages API 上，error.details.error_code 為 enforced_spend_limit_reached。您可以用它來區分此回應與速率限制。
• 升級至更高層級即可恢復存取；請參閱申請更高的限制。

設定您自己的支出限制

您也可以設定低於所屬層級上限的自訂支出限制以控制成本：

1. 1

   前往「帳單」頁面

   在 Claude Console 中，前往帳單頁面（platform.claude.com/settings/billing）。

2. 2

   開啟支出限制編輯器

   在支出限額區段中，點擊調整限制（若目前尚未設定限制，則點擊設定限制）。

3. 3

   調整您的支出限制

   輸入新的數值。您的支出限制不得超過目前層級的上限。

當使用量達到您設定的支出限制時，請求會傳回 HTTP 400，錯誤類型為 invalid_request_error。訊息開頭為 You have reached your specified API usage limits，若為工作區限制則為 You have reached your specified workspace API usage limits，並說明存取何時恢復。提高或移除限制即可提前恢復存取。

Claude Code 工作區的限制會另行檢查：超出該工作區限制的 Claude Code 請求可能會改為收到帶有 retry-after 標頭的 429。

速率限制

Messages API 的速率限制針對每個模型類別，以每分鐘請求數（RPM）、每分鐘輸入 token 數（ITPM）和每分鐘輸出 token 數（OTPM）來衡量。 如果您超過任何速率限制，您會收到說明哪個速率限制被超過的 429 錯誤。當回應帶有 retry-after 標頭時，請等待該秒數後再重試。

快取感知的 ITPM

許多 API 供應商使用合併的「每分鐘 token 數」（TPM）限制，其中可能包括所有 token，無論是快取或未快取的、輸入或輸出的。Claude 的預設 ITPM 速率限制只計入未快取的輸入 token。 這是一項關鍵優勢，使速率限制實際上比初看之下更高。

ITPM 速率限制會在每個請求開始時進行估算，並在請求過程中調整估算值，以反映實際使用的輸入權杖數量。

以下是計入 ITPM 的項目：

• input_tokens（最後一個快取斷點之後的權杖）✓ 計入 ITPM
• cache_creation_input_tokens（正在寫入快取的權杖）✓ 計入 ITPM
• cache_read_input_tokens（從快取讀取的權杖）✗ 不計入 ITPM

範例： 在 2,000,000 ITPM 限制和 80% 快取命中率的情況下，由於快取 token 不計入速率限制，您實際上每分鐘可處理 10,000,000 個總輸入 token（2M 未快取 + 8M 快取）。這些快取 token 以快取讀取費率計費，僅為基本輸入價格的一小部分。

為了在速率限制內獲得最高吞吐量，請快取重複的內容，例如系統指示和提示、大型上下文文件、工具定義以及對話歷史；相關指引請參閱提示快取。透過有效的快取，您可以在不提高速率限制的情況下大幅提升實際吞吐量。您可以在 Claude Console 的使用量頁面監控快取命中率，以調整您的快取策略。

OTPM 速率限制會在產生輸出權杖時即時評估，僅計算實際產生的權杖。max_tokens 參數不會納入 OTPM 速率限制的計算，因此設定較高的 max_tokens 值不會對速率限制造成不利影響。

下列表格中的每一列都有各自的 RPM、ITPM 和 OTPM 限制。部分列涵蓋多個共用同一限制的模型；請參閱表格下方的附註。 您可以在 Claude Console 的速率限制頁面查看您目前的「rate limit」（速率限制）與行為，或使用速率限制 API 以程式化方式讀取已設定的限制並設定工作區限制。

^{1 Fable 速率限制為總限制，適用於 Claude Fable 5.1 和 Claude Fable 5 的合併流量。Claude Fable 5.2 擁有獨立的速率限制，不屬於此合併額度。Claude Mythos 5.2、Claude Mythos 5.1 和 Claude Mythos 5 共用另一個獨立的合併限制。}

^{2 Opus 速率限制為總限制，適用於 Claude Opus 4.8、Opus 4.7、Opus 4.6 和 Opus 4.5 的合併流量。Claude Opus 5.5 和 Claude Opus 5 各自擁有獨立的速率限制，不屬於此合併額度。}

^{3 Sonnet 4.x 速率限制為總限制，適用於 Sonnet 4.6 和 Sonnet 4.5（已棄用；請參閱模型棄用）的合併流量。Claude Sonnet 5.5 和 Claude Sonnet 5 各自擁有獨立的速率限制，不屬於此合併額度。}

Message Batches API

Message Batches API 有自己的一組速率限制，在所有模型之間共用。這些限制包括適用於所有 API 端點的每分鐘請求數（RPM）限制，以及可同時處於處理佇列中的批次請求數量限制。此處的「批次請求」是指 Message Batch 的一部分。您可以建立包含數千個批次請求的 Message Batch，每個批次請求都會計入此限制。批次請求會一直留在處理佇列中，直到模型成功處理為止。

Managed Agents

Claude Managed Agents 端點會針對每個組織進行速率限制。這些限制與本頁面前面所述的 Messages API 速率限制是分開的。

Files API

Files API 請求有其自己的每組織限制，在上傳、列出、擷取、下載與刪除操作之間共用，並與本頁前述的 Messages API 限制分開計算。目前的數值請參閱 Files API 速率限制。

快速模式速率限制

在 Claude Fable 5.2、Claude Mythos 5.2、Claude Opus 5.5、Claude Opus 5，或 Claude Opus 4.8 上以 speed: "fast" 使用 fast mode（快速模式）時，會套用專屬的速率限制。這些限制與標準速率限制分開計算。Claude Opus 5.5 在 Start、Build 和 Scale 層級都有預設的快速模式速率限制，因此您無需申請存取權，即可搭配此模型使用快速模式。評估層級的組織在升級至 Start、Build 或 Scale 層級後，即可搭配 Claude Opus 5.5 使用快速模式。Claude Fable 5.2 亦同。這也適用於 Claude Mythos 5.2。Claude Opus 5 和 Claude Opus 4.8 的快速模式目前處於研究預覽階段。若要查看您的快速模式速率限制，請前往 Claude Console 的速率限制頁面。超過快速模式速率限制時，API 會回傳帶有 retry-after 標頭的 429 錯誤。

回應中包含 anthropic-fast-* 標頭，用以指示您的快速模式速率限制狀態。有關這些標頭的詳情，請參閱快速模式速率限制。

在 Console 中監控您的速率限制

您可以在 Claude Console 的使用量頁面監控您的速率限制使用情況。

除了提供 token 和請求圖表外，使用量頁面還提供兩個獨立的速率限制圖表。您可以使用這些圖表查看還有多少成長空間、找出何時可能達到使用高峰、了解應申請哪些速率限制，以及學習如何提高快取率。這些圖表會將特定速率限制（例如每個模型）的多項指標視覺化：

• Rate Limit - Input Tokens（速率限制 - 輸入權杖）圖表包含：
  • 每小時的每分鐘未快取輸入權杖數最大值
  • 您目前的每分鐘輸入權杖數速率限制
  • 您輸入權杖的快取率（即從快取讀取的輸入權杖百分比）
• Rate Limit - Output Tokens（速率限制 - 輸出權杖）圖表包含：
  • 每小時的每分鐘輸出權杖數最大值
  • 您目前的每分鐘輸出權杖數速率限制

申請更高的限制

若要申請更高的速率限制或更高的每月支出上限，請使用 Claude Console 中速率限制頁面上的申請提高層級。Anthropic 支援團隊也可以提高限制；如有緊急需求，請聯繫 Anthropic 支援。

為工作區設定較低的限制

有關工作區的更多資訊，請參閱工作區。

為了保護您組織中的工作區免於潛在的過度使用，您可以為每個工作區設定自訂的支出和速率限制。

範例：若您組織的限制為每分鐘 40,000 個輸入權杖與每分鐘 8,000 個輸出權杖，您可以將某個工作區限制為每分鐘 30,000 個輸入權杖。這可保護其他工作區免於潛在的過度使用，並讓資源在您的組織中更平均地分配。其餘每分鐘 10,000 個輸入權杖，加上該工作區未用到的 30,000 個中的任何部分，仍可供其他工作區使用。

注意：

• 您無法為預設工作區設定支出限制。
• 若未設定，工作區限制會與組織的限制相同。
• 工作區限制是針對每種限制器類型設定的（例如每分鐘請求數、每分鐘輸入 token 數或每分鐘輸出 token 數）。
• 組織層級的限制始終適用，即使各工作區限制加總後超過該值亦然。

若要以程式化方式讀取您目前的組織與工作區速率限制，或設定工作區速率限制，請使用速率限制 API。

回應標頭

API 回應包含標頭，顯示所強制執行的速率限制、目前使用量，以及限制何時重設。

會回傳以下標頭：

anthropic-ratelimit-tokens-* 標頭顯示目前生效的最嚴格限制的數值。例如，若您已超出工作區的每分鐘權杖限制，標頭將包含工作區每分鐘權杖速率限制的數值。若工作區限制不適用，標頭將回傳剩餘的總權杖數，其中總數為輸入與輸出權杖的總和。若要查看某個請求計入了哪個工作區，請讀取 anthropic-workspace-id 回應標頭，其中包含您的 API 金鑰或存取權杖所解析到的工作區 ID。