使用 Claude Code — Anthropic 的 agentic 程式編碼工具 — 的開發者經常會遇到限制：「Claude usage limit reached. Your limit will reset at 7pm (Asia/Tokyo).」這段訊息引發疑問：究竟是什麼會重設、何時會發生、以及你該如何調整程式碼或基礎架構以避免突發狀況？
如果你的產品或 CI 流程仰賴 Claude Code 進行格式化、測試產生或隨需的程式碼審查，意外的限制可能破壞工作流程。了解限制究竟是短期 429（數秒到數分鐘）、工作階段重設（數小時），還是每週上限（數天），能讓你決定是否重試、進行優雅降級，或將工作排程到稍後。
什麼是 Claude Code？
Claude Code 是 Anthropic 面向開發者的程式編碼產品，直接整合進開發者的工作流程：終端機、CI、版本控制與 IDE。它能執行多檔案編輯、分類處理問題、執行測試與自動化程式碼任務——本質上是居住在你的 CLI 與工具中的具代理能力的協作夥伴。該產品是 Claude 產品家族（Web、API 與 Code）的一部分，旨在透過讓開發者直接在編輯器或終端機中以捷徑與針對程式碼的預設行為呼叫 Claude 模型，加速程式設計任務（程式碼產生、重構、說明、測試產生、除錯）；且它同時提供互動式 CLI 指令（如 /config、/status）與面向組織的管理 API。
與一般 Claude API 的主要差異：
- Claude Code 著重於開發者工作流程（工作階段/代理語義、狀態列、專案層級設定），而 Messages/Completions API 是通用的程式化推論端點。
- 組織可以使用 Admin/Usage API 擷取每日 Claude Code 使用報告（有助於儀表板與成本分攤）。
功能速查清單
- 終端機 / VS Code 整合，支援以程式碼為先的工作流程。
- 自動或手動模型切換（Opus ↔ Sonnet），在成本/吞吐之間取捨。
- 使用量計費與每個工作階段限制，防止單一使用者壟斷容量。
- 方案等級差異（Free / Pro / Max / Team / Enterprise）會改變分配與行為。
Claude Code 的使用量何時重設？
簡短回答：取決於你的方案——但最重要且實用的規則是，今天請記住：Claude Code 的工作階段使用量由一個從你開始使用該工作階段起算的滾動五小時視窗所管理，而更廣義的每週上限則分開追蹤。
Pro 與 Max 方案都對 Claude Code 提供使用限制。你能傳送的訊息數受訊息長度、對話長度與附件數影響，而 Claude Code 的使用量則受專案複雜度、程式碼庫大小與自動接受設定影響。使用運算密集的模型會讓你更快達到使用上限。
五小時工作階段如何運作（最重要的規則）
對於付費方案（Pro 與 Max），Claude Code 會追蹤一個「每五小時重設」的工作階段使用上限。實務上，這代表你的五小時配額時鐘從你在該工作階段送出第一個請求時開始——不是在午夜，也不是與日曆邊界同步。當你用完工作階段上限時，你會看到「usage limit reached」訊息，以及下一個工作階段視窗開始的時間。
API 與組織層級限制：持續補充機制
對於 API 使用者與組織級整合者，Anthropic 實作了「權杖桶（token-bucket）」速率限制與花費限制。這些速率限制會「持續補充」（不僅僅是在離散的五小時邊界），並透過回應標頭回報，例如 anthropic-ratelimit-requests-remaining、anthropic-ratelimit-tokens-remaining 與對應的 -reset 時間戳。對 API 用戶來說，這些標頭是你何時可以恢復高強度活動的權威來源。
每週硬性上限與「高用量用戶」變更
在 2025 年中，Anthropic 引入了額外的每週使用限制（7 天視窗），以抑制重度 Claude Code 使用者持續背景耗用。這些每週上限與五小時工作階段與 token-bucket 行為是分開的：如果你用盡每週上限，短暫等待五小時不會恢復你對某些功能或模型的使用，直到 7 天視窗重設（或在提供的情況下購買額外容量）。
Anthropic 對付費方案的 Claude Code 強制實施每週使用上限（滾動 7 天分配）。這些每週上限以每個模型（Sonnet 與 Opus）的預估使用小時數表達，並依方案與等級而異。
高峰時段的加速耗用（截至 2026 年 3 月 28 日）
根據 Anthropic 技術團隊於 2026 年 3 月 28 日的聲明，這項調整主要影響 Free、Pro 與 Max 訂閱者。
在太平洋時間 5:00 AM 至 11:00 AM（北京時間 8:00 PM 至 2:00 AM）的高峰時段，Claude 的五小時工作階段上限將被下調。這表示相同的操作在高峰時段會更快耗盡配額。官方估計約有 7% 的使用者（特別是大量使用權杖的 Pro 使用者）會比平常更早觸發上限警示。
Pro 與 Max（消費者層級）：實際有何差異
大量使用 Opus 且程式碼庫龐大，或同時並行多個 Claude Code 執行個體的使用者，會更快達到效能瓶頸。
Pro plan ($20/month):
- Session：每五小時約 ~45 則訊息，或每五小時約 ~10–40 個 Claude Code 提示。
- Weekly：~40–80 小時 的 Sonnet 4（Pro 方案一般不在 Claude Code 中支援 Opus）。
Max 5× ($100/month):
- Session：每五小時約 ~225 則訊息，或每五小時約 ~50–200 個 Claude Code 提示。
- Weekly：~140–280 小時 的 Sonnet 4 與 ~15–35 小時 的 Opus 4（Max 可用 Opus）。
Max 20× ($200/month):
- Session：每五小時約 ~900 則訊息，或每五小時約 ~200–800 個 Claude Code 提示。
- Weekly：~240–480 小時 的 Sonnet 4 與 ~24–40 小時 的 Opus 4。
具體情境與「重設」通常代表什麼
1.You receive a 429 with retry-after
- 發生了什麼：你觸發了請求/權杖速率限制。
- 預期行為：
retry-after標頭會告訴你要等待幾秒；Anthropic 的回應也會設定anthropic-ratelimit-*-reset標頭，內含 RFC3339 時間戳以進行精準補充。請使用這些標頭精確安排重試。
2. Interactive Claude Code session shows “Approaching 5-hour limit / reset at 7pm”
- 發生了什麼：你的互動式工作階段用完了短期配額。歷史上，工作階段具有實務上的「五小時」視窗行為，且 UI 常會將重設時間四捨五入為整點。顯示的時間可能是依你的帳戶或 UI 的在地時間，使用者回報它有時是近似值（不一定是精確的 RFC3339 時間戳）。將此類 UI 時間視為參考；若要精準，盡可能使用程式化方法。
3. 你觸發了每週 Opus/模型上限
- 發生了什麼：你或你的組織用盡了特定模型（例如 Opus 4）的每週分配。
- 預期行為：每週上限只會在七天視窗結束後補充。僅等待每小時或每分鐘的重設不會恢復每週容量。Anthropic 自 2025-08-28 起對部分訂閱者宣布了每週速率限制；Max 訂閱者在需要時可選購額外使用量。
4. 你達到你的每月支出上限
- 發生了什麼：你的組織達到了設定的日曆月支出上限。
- 預期行為：存取會受限，直到下一個日曆月（或你提高支出上限/儲值）。此機制用於避免意外超支。
真實世界的異常說明： 有公開的錯誤回報描述 UI 顯示了重設時間，但配額在該時間點並未實際更新——有時分別影響 Web 與 CLI 的體驗。若你的自動化依賴重設，請考慮納入延遲對帳的可能性。
如何以程式檢測重設狀態——程式碼範例
開發者可能需要即時以程式方式檢測何時重設，以避免工作中斷。以下是可直接用於生產工具的務實範式，用來偵測重設、做出安全反應並保留度量。
1) 使用 Messages API 的回應標頭來安排重試
當你收到 429 時，Anthropic 會在標頭中提供剩餘容量與精確的重設時間戳。以下 Python 範例示範讀取 anthropic-ratelimit-requests-reset，並在存在 Retry-After 時退回使用它：
import requests
from datetime import datetime, timezone
import time
API_URL = "https://api.anthropic.com/v1/complete" # 範例推論端點
API_KEY = "sk-...YOUR_KEY..."
HEADERS = {
"x-api-key": API_KEY,
"anthropic-version": "2023-06-01",
"content-type": "application/json",
}
payload = {
"model": "claude-opus-4",
"messages": ,
}
resp = requests.post(API_URL, headers=HEADERS, json=payload)
if resp.status_code == 429:
# 若存在，優先使用精確的 RFC3339 重設時間戳標頭
reset_time = resp.headers.get("anthropic-ratelimit-requests-reset")
retry_after = resp.headers.get("retry-after")
if reset_time:
# 將 RFC3339 風格的時間戳解析為 epoch
try:
reset_dt = datetime.fromisoformat(reset_time.replace("Z", "+00:00"))
wait_seconds = (reset_dt - datetime.now(timezone.utc)).total_seconds()
except Exception:
wait_seconds = int(retry_after or 60)
elif retry_after:
wait_seconds = int(retry_after)
else:
wait_seconds = 60 # 保守的預設值
wait_seconds = max(0, wait_seconds)
print(f"已觸發速率限制。重試前等待 {wait_seconds:.1f} 秒。")
time.sleep(wait_seconds + 1)
# 在此撰寫重試邏輯...
else:
print("回應正常：", resp.status_code)
print(resp.text)
為什麼有幫助： 讀取 anthropic-ratelimit-*-reset 可取得預期補充的 RFC3339 時間戳；retry-after 則是立即退避的權威依據。
2) 以程式方式檢查使用量（組織層級）——Admin Usage Report（cURL）
Anthropic 提供 Admin「Usage Report」端點，回傳組織等級的每日 Claude Code 指標。注意：需要管理員 API 金鑰，且此 API 面向組織（非個人帳戶）。範例（為清晰起見略作編排）：
# 將 $ANTHROPIC_ADMIN_KEY 與 starting_at 替換為你的值
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2025-08-08&limit=20" \
--header "anthropic-version: 2023-06-01" \
--header "content-type: application/json" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY"
此端點會回傳每日彙總紀錄（commits、lines_of_code、tokens、estimated cost 等），可用於儀表板與帳務對帳。
3) 使用 Claude Code CLI 的 /status 與狀態列整合於本機工具
Claude Code 的 CLI 提供斜線指令與 /status（或相關）指令來檢視剩餘互動式配額；你也可以設定自訂狀態列（/statusline）或使用 .claude/settings.json 將使用統計顯示在你的 shell 提示字元上。
哪些實用策略可降低配額摩擦？
1. 聰明地開始工作階段
在重設後立即開始大型規劃或生成步驟。若你預期將進行長時間的工作階段，讓該步驟成為你的「第一個請求」，以錨定全新的五小時視窗。
2. 策略性地進行模型切換
Opus 功能強大但在配額上較昂貴；Sonnet 成本較低。可在工作階段開始時使用 /model 或依賴自動切換，延長該視窗的可用時間。許多 Max 方案使用者會設定自動切換閾值，以最大化上線時間。
3. 與隊友協調
若多位隊友共用團隊或組織的每週上限，請協調高強度任務（例如效能測試、大規模重構），避免消耗重疊。
4. 對突發需求改用 API 或隨用隨付
若 Claude Code 在本地 UI 觸及配額，對於時間敏感的突發需求，可考慮改用 Claude API/主控台並搭配隨用隨付額度（請檢查你的方案，評估是否可行且具成本效益）。
開發者可透過 CometAPI 存取 Claude Sonnet 4.5 API 與 Claude Opus 4.1 API 等，最新的模型版本 會與官網同步更新。開始前，請先在 Playground 探索模型能力，並參考 API guide 取得詳細指引。存取前請先登入 CometAPI 並取得 API key。CometAPI 提供遠低於官方價格的方案，協助你整合。
Ready to Go?→ Sign up for CometAPI today！
若你想獲得更多 AI 技巧、指南與新聞，請追蹤我們於 VK、X 與 Discord 的帳號！
結論
了解 Claude Code 使用量何時重設至關重要——它會影響你如何規劃程式編寫工作階段、如何為訂閱資源做預算，以及你如何因應中斷。當前廣泛適用且可操作的思維模型很簡單：五小時滾動工作階段視窗，加上獨立的每週上限。使用小型輔助腳本計算重設時間，並將使用監控整合進工作流程，讓限制成為工程節奏中可預期的一部分，而不是意外。