當 Claude Code 顯示「已達到限制」時,先確認是哪一種限制:訂閱方案、API 速率、支出上限或帳戶問題。適當的處理方式可能是等待重設、啟用官方額度、減少同時請求,或修正金鑰。在完成診斷前購買另一個方案,可能會讓問題持續存在。
您看到什麼訊息?
| 症狀 | 驗證 | 適當的處理方式 |
|---|---|---|
| 已達方案配額,已顯示恢復時間 | Claude 帳戶與使用量頁面 | 等待、比較其他方案或使用點數 |
| 顯示速率資訊的 API 429 | 訊息、並行請求數與恢復標頭 | 降低速度並遵守所提供的等待時間 |
| 支出上限或付款遭拒 | 餘額、帳戶限制與計費 | 修正相關限制或付款方式 |
| API 401 或 403 | 金鑰、目標網域與權限 | 修正身分驗證或授權 |
| 對話過長 | 內容大小與確切訊息 | 摘要工作並縮減有用的內容 |
以下代碼說明 Anthropic API。如果 Claude Code 是透過其他供應商運作,也請參閱該供應商的文件:中介服務可能會顯示自己的訊息與上限。
1. 如果您使用 Claude 訂閱方案
開啟已連線帳戶的使用量設定。記下相關配額與所顯示的時間,不要根據其他地方找到的訊息推斷通用時長。也請確認 Claude Code 確實使用預期的帳戶。
Anthropic 區分了使用量與長度限制。Claude 與 Claude Code 的使用量可能共用同一個帳戶配額。因此,開啟新視窗或新對話不會建立額外配額。不過,減輕已變得龐大的內容,可以降低模型在後續呼叫中需要處理的工作量。
若要在用完包含的配額後繼續使用,符合資格的個人方案提供官方使用點數。這些點數會依 API 標準價格另行計費。在使用量設定中,確認是否已啟用、可用資金及支出上限。這是可以與等待、變更方案或使用獨立 API 帳戶比較的選項。
2. 如果 API 回傳 429
查看錯誤文字與API 限制。如果是速率限制,請降低並行工作數,並在有retry-after時遵守該等待時間。立即多次重新啟動代理程式可能會讓相同的阻塞持續存在。
429 也可能表示 API 層級的每月上限,或 Claude Code 工作區的特定支出限制。每月上限可能不會提供恢復時間。此時請檢查帳戶的計費與相關上限;重試迴圈不會提高這些上限。單獨缺少標頭不足以作出結論:也請閱讀訊息內容。
3. 如果問題涉及餘額或身分驗證
Anthropic 錯誤參考特別區分:401 表示身分驗證、403 表示權限,402 表示計費。有些支出限制也可能以 400 代碼顯示。因此,僅憑 HTTP 代碼無法取代錯誤詳細資訊。
確認請求傳送到哪個網域,以及建立金鑰的帳戶。Claude 訂閱、Console 餘額與第三方供應商的餘額彼此不可互換。在一家供應商處儲值,不會自動為其他供應商提供資金。修正後,先使用小型請求確認扣款帳戶,再繼續重要工作。
4. 使用獨立的 API 計費繼續
閘道文件說明,啟用中的閘道識別碼會取代工作階段的訂閱身分。僅設定基礎位址不會完成這項變更:已儲存的連線可能仍保持啟用。因此,請同時設定預期的位址、識別碼與模型。
Claude Code 價格與設定文件以法文說明 Kunavo 的使用方式。目前目錄顯示每百萬 token 的輸入價格為Claude Sonnet 4.6至$2.10,輸出價格為$10.50。Claude API 價格指南詳述可比較的單位。一次工作可能包含多次呼叫;其成本也取決於內容、快取與重試。
如果這種分離方式適合您,請建立 Kunavo 帳戶、設定金鑰,然後在您的使用量記錄中檢查第一次呼叫。此帳戶有自己的限制;它不會將 Claude Code 變成無限量服務。
準備有用的求助請求
如果阻塞持續存在,請保留以下資訊。這些資訊有助於區分設定問題與套用在正確帳戶上的限制,同時不公開您的密鑰:
Interface et version de Claude Code :
Compte utilisé : abonnement / Console / fournisseur tiers
Modèle et nom de domaine de l'API :
Message exact et code HTTP éventuel :
Heure de réinitialisation affichée :
En-tête retry-after, s'il existe :
Identifiant de requête, s'il existe :也請保留本機工作與工作狀態。存取權恢復後,請代理程式先檢查已修改的檔案,再重新開始,以免重複已完成的步驟或遺失修正內容。
常見問題
Claude Code 顯示「已達到限制」時該怎麼辦?
先確認提供回應的帳戶。若使用訂閱方案,請查看重設時間與使用額度的購買選項。若使用 API,請閱讀完整訊息:速率、支出上限、計費與驗證需要不同的修正方式。
429 狀態碼是否總是表示需要等待?
不是。Claude API 也會對某些支出上限使用 429。若是超過速率限制,可能需要等待並減少同時請求數;若是財務上限,則需要檢查帳戶限制與計費。訊息內容與標頭能協助你選擇正確的處理分支。
新的對話會將配額重設為零嗎?
不會。新的對話可以減少傳送的上下文,但不會重設帳戶配額。單一對話的長度限制與訂閱方案的使用量限制是兩項不同的約束。
Kunavo 金鑰會移除所有限制嗎?
不會。使用 Kunavo 金鑰的 API 設定,其帳戶與計費都與 Claude 訂閱方案分開。它仍受 Kunavo 的餘額、限制及可用模型約束。只變更基礎網址而未設定正確識別碼,不足以改變計費方式。
官方來源已於 2026 年 9 月 17 日驗證。