Claude 工具使用次數達上限怎麼辦？

本次回合的工具使用限制代表什麼

本次回合的工具使用限制，表示 Claude 因該回應用完可使用的工具呼叫次數，而在回應完成前停止；這不代表您的帳戶用量已用完。Claude 停止前找到的所有內容仍保留在對話中。再傳送一則訊息要求它繼續，系統就會開啟新的回合，並提供新的工具使用額度。

一個回合是代理程式迴圈中的一次往返。Claude 產生包含工具呼叫的輸出，客戶端執行這些工具，工具結果再傳回 Claude，供它決定下一步。這個循環會持續進行，不會將控制權交還給您。當 Claude 產生不包含工具呼叫的回應時，回合就會結束。回合上限，是限制單一回答最多可進行多少次這類往返。

方案用量上限是獨立的控制項

方案上限會計算你在一段時間內的用量。Anthropic 的說明中心錯誤訊息頁面於 2026 年 8 月 18 日查閱時，將前一種情況列為 Approaching 5-hour limit.，接近上限時會顯示該訊息；超過上限後則會顯示 5-hour limit reached - resets [time].。訊息會指定時間。等到該時間即可解除問題，在此之前輸入任何內容都沒有幫助。

工具使用訊息的行為正好相反。它會在工作進行期間出現，而單一則後續訊息即可立即繼續工作。剩餘配額不會受到影響。可執行的測試是：如果等待沒有作用，但繼續操作即可恢復，你就從未達到配額上限。若是配額問題，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。其中兩個值與本指南的情境相關。

伺服器執行 web search 等伺服器工具時，若伺服器端的取樣迴圈達到迭代上限，便會回傳 pause_turn。截至 18 August 2026，handling stop reasons 頁面將預設值列為每個請求 10 次迭代。文件建議將回應原樣以 assistant 訊息送回，讓 Claude 從暫停的位置繼續執行。這相當於在聊天視窗中輸入「繼續」。

max_tokens 表示回應達到請求設定的輸出 token 上限。如果回應在未完成的工具使用區塊中遭到截斷，便無法執行該工具呼叫。文件建議提高 max_tokens 後重新嘗試。

請參閱handling stop reasons 頁面中的目前值，不要直接採用本文列出的數字。該頁面的預設值可能變更，過時的數字比沒有數字更糟。

什麼情況會讓聊天用完工具呼叫

• 沒有自然終點的問題。「找出所有關於 X 的內容」不會提供任何資訊，讓模型判斷搜尋何時完成。
• 重複讀取相同資料，因為答案不在模型預期的位置。
• 工具回傳結果過大。單一長篇網頁或大型檔案，會占用其餘回合所需的上下文空間。
• 在一則訊息中提出數個彼此獨立的工作。每項工作都需要各自的工具呼叫，但全部共用同一個額度。
• 此工作不會使用的 connectors 和 MCP (model context protocol) 伺服器。它們的工具定義會載入請求，讓模型在該回合中有更多方式消耗額度。

如何完成答案

回覆「continue」，或更好的是，直接用簡短指示說明目前缺少的內容。這會開啟新的一輪對話，並取得新的額度。先前的對話仍在上下文中，因此 Claude 會接續處理，不會重複已執行過的工具呼叫。

如果它連續兩次都停在相同位置，表示工作範圍太大，無法在一輪中完成，應將工作拆開。不要要求完整稽核整個儲存庫，先要求列出檔案清單，再逐則訊息詢問一個檔案。四輪小型工作可以完成一輪大型工作無法完成的內容。

縮小模型需要搜尋的範圍。提供確切的檔案路徑，或確切的錯誤字串；如果已經有日誌，也應直接貼上。貼上日誌只需一則訊息。讓模型自行尋找日誌則會耗用數次工具呼叫，而且可能找到錯誤的日誌。

暫時停用目前不需要的連接器。每個已連接的工具都會將其定義加入每個請求，這會消耗上下文，並擴大模型可選擇的操作範圍。相同原則也適用於長時間的程式撰寫工作；維持 Claude Code 工作階段的上下文精簡，是代理程式能否完成工作而不會中途停止的關鍵。

自行設定執行 agent 時的回合預算

如果您透過自行撰寫的程式碼驅動 Claude，每回合的預算由您自行設定。Claude Agent SDK（software development kit）在 Python 中提供 max_turns，在 TypeScript 中提供 maxTurns；文件將其定義為工具使用往返的最大次數。文件所載的預設值為不限次數。

達到此上限時，SDK 會傳回 subtype 為 error_max_turns 的結果，而單次 query() 呼叫則會擲回包含 Reached maximum number of turns 文字的錯誤。結果仍會包含 num_turns 和 session_id，因此您可以提高限制後繼續使用同一個工作階段，不必重新開始工作。

從 CLI（command line interface）使用時，相同的控制項是旗標，而且僅適用於 print mode：

claude -p --max-turns 3 "summarise the failing tests"

旗標參考文件指出，達到限制時會以錯誤結束，預設則不限次數。相同概念也有依費用設定的版本：Python 中的 max_budget_usd 和 TypeScript 中的 maxBudgetUsd 會在支出達到門檻時停止迴圈，而不是依回合次數停止；subagent 的支出也會計入總額。如果您在按月計費的伺服器上執行 agents，建議在第一次長時間執行前，先設定控制 AI agent 在 VPS 上的費用。

等待核准的暫停是另一種情況。如果 agent 停止且沒有持續產生費用，請查看 permission_mode，不要查看回合次數，因為工具正在等待永遠不會到來的人工作答覆。Claude Code 的自動模式與權限設定說明哪些模式會要求核准，以及哪些模式會直接執行。

如何自行確認目前的行為

這裡的行為可能在未公告的情況下變更，因此請將本指南中的所有數字視為當時的資料，而非固定值。以下兩個地方可顯示目前的實際情況。

• 關於停止原因的 API 文件，其中說明伺服器端工具迭代的預設值，以及超過該值後如何繼續。
• Anthropic 的錯誤訊息說明中心頁面，其中列出使用量限制的文字。該頁面於 18 August 2026 查閱，記載 five hour 與 weekly 使用量訊息，但未提及每回合工具上限。正因如此，本文不引用聊天應用程式的官方數值。

請改為測量自己的執行結果。在 Claude Code 中，/context 會以色彩網格顯示目前的 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 的結果，以及包含 Reached maximum number of turns 文字的錯誤。兩者的預設值都是不限。如果沒有設定任何上限，但執行仍然停止，請查看結果中的 stop_reason：max_tokens 表示已達到輸出上限；pause_turn 表示伺服器工具迴圈已達到反覆運算限制，並要求將回應傳回，以便繼續執行。