SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

Claude提示本轮工具使用限制怎么办

“本轮工具使用限制”表示Claude已用完单次响应内的工具调用次数,不代表套餐配额耗尽。发送一条消息即可开启新轮次并继续任务。

本轮工具使用限制的含义

本轮工具使用限制表示 Claude 在生成单个响应时用完了工具调用次数,因此中途停止,而不是您的账户用完了使用额度。它停止前找到的所有内容仍保留在对话中。再发送一条消息让它继续,系统就会开启新一轮,并提供新的工具调用额度。

在 Agent SDK 中,一轮是代理循环的一次迭代。Claude 生成包含工具调用的输出,客户端运行这些工具,然后将结果返回给 Claude 以便其做出下一步决策。该循环会重复执行,期间不会将控制权交还给您。当 Claude 生成不包含工具调用的响应时,循环结束。SDK 的轮次上限会统计每次迭代,包括最后一次不包含工具调用的响应。

您的套餐用量限制是独立控制项

套餐限制统计您在一个时间窗口内已使用的用量。Anthropic 的错误消息帮助中心页面于 2026 年 11 月 9 日核查时列出:接近限制时显示 Approaching session limit,超过限制后显示 5-hour limit reached - resets [time]。周用量限制也有对应消息,其中会注明重置日期和时间。无论哪种情况,消息都会给出具体时间。如果没有用量额度,等待到该时间即可恢复,期间输入任何内容都不会有帮助。如果付费套餐已启用用量额度,页面说明系统会改用额度继续处理,消息显示为 5-hour limit resets [time] - continuing with usage credits。当您达到每月消费上限,或在关闭自动充值时用尽额度余额后,这种继续处理也会结束。已验证的 Ultra 账户没有五小时会话限制,但仍受周用量限制约束。

工具使用消息的行为正好相反。它会在任务进行期间出现,您发送一条后续消息即可立即继续处理。已经发起的工具调用仍会计入套餐用量。继续处理不会重置配额;达到套餐限制后,用量额度也可以让任务继续执行。对于配额限制,Claude 提示已达到限制时的处理方法列出了可用选项,Claude 用量限制的计算方式说明了这些限制所使用的时间窗口。

为什么每一轮都要设置工具调用预算

每次工具调用都会消耗上下文。调用发出后,工具执行,完整结果再返回到对话中。读取一个大文件,或运行一个输出很长的命令,单步就可能消耗数千个 token,而且这些文本会在本次会话的剩余时间内持续占用上下文。Anthropic 的代理循环文档明确说明了这一点:上下文会在各轮之间累积,因此包含多次工具调用的会话,携带的内容远多于短会话。

为每一轮设置预算,可以停止不再取得进展的循环。代理不断搜索、读取、再次搜索,却始终找不到结果时,会一直重复,直到被中断。预算就是这个中断机制。它会在适当的节点将控制权交还给您,方便您重新指定工作方向。相比让循环一直运行到上下文窗口耗尽,这样消耗的资源要少得多。

API 中可以看到此限制的位置

Anthropic 的公开错误文档没有给出 Claude 聊天应用每轮工具调用的数量,因此您看到的任何精确数值都可能只是推测。API(应用程序编程接口)文档记录了相同类型的限制,实际行为也应以该文档为准。

Messages API 响应中的 stop_reason 字段说明生成停止的原因。文档列出的值包括 end_turn、max_tokens、stop_sequence、tool_use、pause_turn、refusal 和 model_context_window_exceeded。其中两个值对应本指南讨论的情况。

服务器使用 Web 搜索等服务器工具时,如果服务端采样循环达到迭代上限,就会返回 pause_turn。截至 2026 年 10 月 25 日,停止原因和回退页面将默认值列为每个请求 10 次迭代。文档给出的修复方法是将响应原样作为 assistant 消息发回,使 Claude 从暂停的位置继续。不要添加新的用户消息要求它继续:文档示例只发送原始用户消息,后面接暂停的 assistant 内容。

max_tokens 表示响应达到请求设置的输出 token 上限。如果响应在未完成的工具使用块中被截断,则无法执行该工具调用。文档建议提高 max_tokens 后重试。

请在停止原因和回退页面查看当前值,不要直接信任本文中的数值。该页面上的默认值可能会变化,过时的数值不如不提供数值。

聊天为何会耗尽工具调用

  • 没有自然停止点的问题。“查找所有关于 X 的内容”没有告诉模型何时搜索完成。
  • 重复读取相同材料,因为答案不在模型预期的位置。
  • 工具结果过大。一张很长的网页或一个很大的文件会占用本轮其余部分所需的空间。
  • 一条消息中包含多个相互独立的任务。每个任务都需要自己的工具调用,而所有调用共用一个预算。
  • 当前任务不需要的连接器和 MCP(模型上下文协议)服务器。加载后,每个连接器都会占用对话空间,并为模型提供更多消耗本轮预算的操作路径。

如何让答案完成

回复“继续”,或者更好的是,给出一条简短指令,明确说明还缺少什么。这样会开启一个具有新预算的新一轮对话。之前的对话仍在上下文中,因此 Claude 会从中断处继续,而不会重复已经执行过的工具调用。

如果它两次都在同一位置停滞,说明任务范围太大,无法在一轮中完成,应将任务拆分。不要要求一次性完成整个代码仓库的审计,而应先请求文件列表,再每条消息询问一个文件。四个小回合可以完成一个大回合无法完成的工作。

缩小模型需要查找的范围。提供确切的文件路径,或者确切的错误字符串;如果已有日志,则直接粘贴。粘贴日志只占用一条消息。让模型自行查找日志会消耗多次工具调用,而且可能找到错误的日志。

关闭当前不需要的连接器。Anthropic 的帮助中心说明,每个连接器都会占用对话空间。在默认的 Auto 设置下,Claude 会决定加载哪些连接器;Always available 会在开始时加载所有连接器,每个已加载的连接器都会消耗上下文,并扩大模型可选择的操作范围。如果连接器数量较多,On demand 设置只会在 Claude 搜索到合适的连接器后加载它们。同样的原理也适用于长时间的编码会话:保持 Claude Code 会话的上下文较小,决定了代理能否完成任务,而不是中途停止。

运行代理时自行设置轮次上限

如果您通过自己的代码驱动 Claude,循环的轮次上限由您设置。Claude Agent SDK(软件开发套件)在 Python 中提供 max_turns,在 TypeScript 中提供 maxTurns。这两个参数统计包含工具调用的轮次,以及最后一次仅返回文本的响应。文档所述的默认值为不限制。

达到上限后,SDK 会返回一个结果,其中 subtype 为 error_max_turns;单次执行的 query() 调用则会引发错误,错误文本包含 Reached maximum number of turns。Agent SDK 的代理循环页面还说明,单次执行出现该错误时,底层 Claude Code 进程会以非零退出码结束。结果仍包含 num_turns 和 session_id,因此您可以提高上限后继续使用同一会话,而不必重新开始任务。

在 CLI(命令行界面)中,相同的控制项是一个标志,并且仅适用于打印模式:

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

标志参考文档说明,默认不设上限。使用 --input-format stream-json 时,达到上限并结束轮次后仍在队列中的消息会保留,并在新轮次中处理;新轮次使用自己的上限。还有一种按成本限制的对应方式:Python 中的 max_budget_usd 和 TypeScript 中的 maxBudgetUsd 会根据支出阈值而不是轮次数量停止循环,子代理的支出也计入该总额。预算会在收到模型响应后检查,因此,达到上限的响应,以及在停止前完成的后台子代理,都可能使实际支出超过上限。如果您在按月计费的服务器上运行代理,建议在首次长时间运行前设置 控制 AI 代理在 VPS 上的成本。

等待批准的暂停是另一种情况。如果代理停止运行且没有产生任何支出,请查看 permission_mode,而不是轮次数量,因为此时工具正在等待人类回答,但回答始终未到达。Claude Code 的自动模式和权限设置介绍了哪些模式会请求批准,以及哪些模式会直接运行。

如何自行检查当前行为

这里的行为可能在没有公告的情况下发生变化,因此请将本指南中的所有数字视为截至相应日期的记录,而不是固定值。以下两个位置可以显示当前情况。

  • 关于停止原因的 API 文档。该文档说明了服务器端工具迭代的默认值,以及如何在达到该值后继续执行。
  • Anthropic 的错误消息帮助中心页面。该页面列出了使用量限制的提示文本。截至 9 November 2026,该页面记录了五小时和每周使用量提示,包括使用量额度接管后显示的版本,但没有提到每轮工具调用上限。正因如此,本文不引用聊天应用的官方数值。

请改为测量您自己的运行结果。在 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 未公布聊天应用使用的具体数值。无论使用哪个套餐,将任务拆分为多个更小的轮次才是真正有效的方法。

为什么我自己的代理只执行几次工具调用就停止了?

检查您是否设置了上限。Claude Agent SDK 在 Python 中使用 max_turns,在 TypeScript 中使用 maxTurns;命令行界面在 print 模式下使用 --max-turns。达到其中一个上限后,SDK 会返回一个结果,其 subtype 为 error_max_turns;单次执行的 query() 调用随后会抛出错误,其中包含文本 Reached maximum number of turns。两者的默认值都是不限制。如果没有设置任何上限,但运行仍然停止,请读取结果中的 stop_reason:max_tokens 表示已达到输出上限,pause_turn 表示服务器工具循环已达到迭代上限,并要求将响应发回,以便继续执行。

这篇文章对您有帮助吗?