Claude 工具使用次數達上限怎麼辦?
「本次回合的工具使用限制」不代表方案配額用完。了解單一回合的工具呼叫上限、與方案用量限制的差異,以及如何傳送訊息立即繼續工作。
這一輪的工具使用上限代表什麼
這一輪達到工具使用上限,表示 Claude 在單次回應中用完工具呼叫次數,因此中途停止;這不表示你的帳戶已用完使用額度。它停止前找到的所有內容仍保留在對話中。再傳送一則訊息要求它繼續,便會開啟新的一輪,並取得新的工具使用額度。
在 Agent SDK 中,一輪是代理程式迴圈的一次執行。Claude 產生包含工具呼叫的輸出,client 執行這些工具,再將結果傳回 Claude,供它做出下一個決策。這個循環會持續執行,不會將控制權交還給你。當 Claude 產生不含工具呼叫的回應時,迴圈便會結束。SDK 的回合上限會計入每次執行,包括最後一次不含工具呼叫的回應。
您的方案用量上限是另一項控管
方案上限會計算您在一段時間內的用量。Anthropic 的錯誤訊息說明中心頁面於 9 November 2026 查閱時,將接近上限的狀態列為 Approaching session limit,超過上限後則列為 5-hour limit reached - resets [time]。每週上限也有相應訊息,其中會標示重設日期與時間。無論是哪一種情況,訊息都會指出時間。若沒有用量點數,等待該時間到達即可解決問題;期間輸入任何內容都沒有幫助。若付費方案已啟用用量點數,該頁面表示工作會改用點數繼續執行,訊息會顯示 5-hour limit resets [time] - continuing with usage credits。當您達到每月支出上限,或在關閉自動重新載入時用完點數餘額,這種延續就會結束。已驗證的 Ultra 帳戶沒有 five hour 工作階段上限,但仍受每週上限限制。
工具使用訊息的行為則相反。它會在工作進行期間出現,而單一則後續訊息即可讓工作立即繼續。已執行的工具呼叫仍會計入方案用量。繼續工作不會重設配額;達到方案上限後,用量點數也能讓工作繼續。針對配額情況,Claude 顯示已達上限時的處理方式 列出可用選項,而 Claude 用量上限的計算方式 說明這些上限所依據的時間範圍。
為什麼每個回合都需要工具預算
每次工具呼叫都會消耗內容視窗。呼叫會送出、工具會執行,完整結果接著會回到對話中。讀取一個大型檔案,或執行一個輸出內容很長的命令,單一步驟就可能使用數千個 token,而且這些文字會在工作階段的其餘時間持續留在內容視窗中。Anthropic 的 agent loop 文件明確說明其結果:內容會在各回合中累積,因此包含許多工具呼叫的工作階段,內容量遠高於簡短的工作階段。
回合預算可以停止已不再取得進展的迴圈。代理程式搜尋、讀取、再次搜尋,仍然找不到結果時,會持續執行,直到有事件中斷它。預算就是這項中斷機制。它會在適當的時間將控制權交還給你,讓你重新導向工作;這比讓迴圈執行到內容視窗耗盡所需的成本低得多。
API 中可查看此上限的位置
Anthropic 的公開錯誤說明文件沒有提供 Claude 聊天應用程式每回合的工具呼叫數,因此你看到的任何確切數字都可能只是他人的猜測。API(application programming interface)則記錄了相同類型的上限;實際行為可在該文件中查看。
Messages API 回應中的 stop_reason 欄位會說明生成停止的原因。文件列出的值包括 end_turn、max_tokens、stop_sequence、tool_use、pause_turn、refusal 和 model_context_window_exceeded。其中有兩項與本指南的情境相關。
伺服器工具(例如網頁搜尋)執行期間,如果伺服器端的取樣迴圈達到迭代上限,就會回傳 pause_turn。截至 25 October 2026,stop reasons and fallback 頁面將預設值列為每個請求 10 次迭代。文件建議的修正方式,是將回應原樣以 assistant 訊息送回,讓 Claude 從暫停的位置繼續。不要另外新增要求繼續的 user 訊息;文件範例只會傳送原始 user 訊息,接著傳送暫停的 assistant 內容。
max_tokens 表示回應達到請求設定的輸出 token 上限。如果內容在未完成的工具使用區塊中遭到截斷,工具呼叫就無法執行;文件建議提高 max_tokens 後重新嘗試。
請在stop reasons and fallback 頁面查看目前的值,不要直接採用本文所列的數字。該頁面的預設值可能會變更,過時的數字比沒有數字更容易造成誤導。
哪些情況會讓聊天用盡工具呼叫
- 沒有自然停止點的問題。「找出所有關於 X 的內容」沒有提供任何資訊,讓模型判斷搜尋何時完成。
- 重複讀取相同資料,因為答案不在模型預期的位置。
- 大型工具結果。一個很長的網頁或大型檔案會占用本回合其餘工作所需的空間。
- 在一則訊息中交辦數項互不相關的工作。每項工作都需要自己的工具呼叫,而所有呼叫都會消耗同一份預算。
- 此工作不會使用的 connectors 與 MCP(model context protocol)伺服器。載入後,每個項目都會占用對話空間,也會讓模型有更多方式消耗本回合的預算。
如何讓答案完成
回覆「continue」,或更好的做法是提供一則簡短指示,指出目前仍缺少的內容。這會開啟一個具有新預算的新回合。先前的對話仍在上下文中,因此 Claude 會接續工作,而不會重複已執行的工具呼叫。
如果它兩次都在同一位置停滯,表示工作範圍對單一回合而言過大,應將工作拆開。不要要求它完整稽核一個 repository,而是先要求列出檔案清單,再每則訊息詢問一個檔案。四個小回合可以完成一個大型回合無法完成的工作。
縮小模型需要搜尋的範圍。提供確切的檔案路徑或確切的錯誤字串;如果你已經有 log,也直接貼上。貼上一份 log 只會消耗一則訊息。讓模型自行尋找該 log 會消耗數次工具呼叫,而且可能找到錯誤的檔案。
關閉目前不需要的 connectors。Anthropic 的說明中心表示,每個 connector 都會占用對話空間。在預設的 Auto 設定下,Claude 會決定要載入哪些 connectors;Always available 則會在開始時載入全部 connectors,而每個已載入的 connector 都會消耗上下文空間,並擴大模型可選擇的操作範圍。如果你保留大量 connectors,On demand 設定只會在 Claude 搜尋適用的 connector 後才載入。相同的原則也適用於長時間的 coding session;維持 Claude Code session 的上下文精簡,是 agent 能完成工作與中途停止的差別。
自行設定執行 agent 時的回合上限
如果您透過自行撰寫的程式碼驅動 Claude,回圈的回合上限由您自行設定。Claude Agent SDK(software development kit)在 Python 中提供 max_turns,在 TypeScript 中提供 maxTurns;這些設定會計算包含工具呼叫及最後純文字回應的回合數。文件所述的預設值為不限次數。
達到上限時,SDK 會回傳 subtype 為 error_max_turns 的結果;而單次執行的 query() 呼叫則會擲回包含 Reached maximum number of turns 文字的錯誤。Agent SDK 的 agent-loop 頁面也說明,該單次執行錯誤會使底層 Claude Code 程序以非 0 狀態碼結束。結果仍會包含 num_turns 與 session_id,因此您可以提高上限後繼續相同的工作階段,而不必重新開始工作。
在 CLI(command line interface)中,相同的控制項是旗標,而且只適用於 print mode:
claude -p --max-turns 3 "summarise the failing tests"旗標參考資料指出,預設不限次數。使用 --input-format stream-json 時,限制結束時仍在佇列中的訊息會保留在佇列中,並在新的回合中以該回合自己的上限開始處理。相同概念也有依費用限制的版本:Python 中的 max_budget_usd 與 TypeScript 中的 maxBudgetUsd 會依支出門檻而非回合數停止回圈,subagent 的支出也會計入總額。系統會在收到模型回應後檢查預算,因此達到上限的那次回應,以及停止前完成的背景 subagent,都可能使實際支出超過上限。如果您在按月付費的伺服器上執行 agent,建議在第一次長時間執行前先設定 控制 AI agent 在 VPS 上的費用。
等待核准的暫停是另一種情況。如果 agent 停止且沒有持續產生費用,請查看 permission_mode,而不是回合數;這表示工具正在等待人員回覆,但回覆尚未到達。Claude Code 的自動模式與權限設定說明哪些模式會要求核准,以及哪些模式會直接執行。
如何自行檢查目前的行為
這裡的行為可能在未公告的情況下變更,因此請將本指南中的每個數字視為當時的資料,而非固定值。以下兩處可顯示目前的實際情況。
- 關於停止原因的 API 文件,其中說明伺服器工具迭代的預設值,以及如何繼續執行。
- Anthropic 的說明中心錯誤訊息頁面,其中列出使用量上限的文字。該頁面於 9 November 2026 查閱,文件說明 five hour 與 weekly 使用量訊息,包括使用量額度接管後顯示的版本,但未提及每回合工具上限。正因如此,本文不引用聊天應用程式的官方數值。
請改為測量自己的執行結果。在 Claude Code 中,/context 會以彩色網格顯示目前的內容使用量,並指出最耗用內容空間的工具;/compact 會摘要目前為止的對話,以釋放空間。在 Agent SDK 中,每個結果都包含 num_turns,因此你可以在設定上限前,了解一般工作實際需要多少回合。來自自身工作負載的數字,比論壇文章中的數字更有參考價值。
FAQ
工具使用上限與我的 Claude 使用上限相同嗎?
不相同。使用上限計算你在一段時間內的使用量,並告知重設時間,因此等待即可解決。工具使用訊息則表示單次回應因耗盡可用的工具呼叫次數而中途停止;再次傳送訊息會開始新的回合,並立即取得新的額度。工具使用量仍會計入方案使用量。Claude 使用上限的計算方式完整說明配額相關情況。
如何讓 Claude 完成中途停止的工作?
再傳送一則訊息即可。「繼續」通常有效,但明確指出尚未完成的部分會更好,因為這能避免模型重新建立已經掌握的上下文。如果第二次仍在相同位置停止,請將工作拆成較小的部分,每則訊息處理一個部分。提供確切的檔案路徑,或直接貼上內容,也能避免再次搜尋,因而不會耗盡原本的額度。
「límite de uso de herramientas」或「limite de uso de ferramentas」是什麼意思?
這是同一則訊息的西班牙文與葡萄牙文表述,通常會顯示為「límite de uso de herramientas en este turno」或「limite de uso de ferramentas neste turno」。所有語言的意思都相同:Claude 已耗盡單次回應內允許的工具呼叫次數,與你的方案配額無關。處理方式也相同。回覆要求它繼續,或將要求拆成較小的步驟。計費上限會顯示為另一則訊息,並包含重設時間。
升級方案會提高單一回合的工具使用上限嗎?
方案等級與單回合工具額度是不同的控制項。升級方案會提高你在一段時間內可使用的總量,而這正是會顯示重設時間的上限。單次回應可執行的工具呼叫次數,取決於執行模型的迴圈;Anthropic 未公布 chat app 的這項數值。無論使用哪個方案,將工作拆成較小的回合才是實際有效的方法。
為什麼我自己的 agent 只執行幾次工具呼叫就停止?
請檢查是否設定了上限。Claude Agent SDK 在 Python 中使用 max_turns,在 TypeScript 中使用 maxTurns;command line interface 在 print mode 中使用 --max-turns。達到其中一項上限時,SDK 會傳回包含 subtype 且值為 error_max_turns 的結果;單次 query() 呼叫則會擲出包含 Reached maximum number of turns 文字的錯誤。兩者的預設值都是無限制。如果沒有設定任何上限,但執行仍然停止,請查看結果中的 stop_reason:max_tokens 表示已達到輸出上限,pause_turn 表示伺服器工具迴圈已達到反覆執行上限,並要求將回應傳回,以便繼續執行。