返回
官网 Claude 官方博客 精选 收录 2026-08-11 10:19 44

Anthropic Claude Code团队详解Agent循环工程入门

Claude Code团队在官方博客中定义了agentic循环的概念,即智能体重复工作周期直至满足停止条件,并依据触发方式、停止条件、所用Claude Code原语和适用任务类型,将循环分为基于turn、目标驱动、基于时间和主动式等几类。文章提供了从turn-based循环逐步过渡到更复杂循环的实践指南,并讨论了在管理token消耗的同时保证代码质量的策略。作者强调并非所有任务都需要复杂循环,建议从最简单的方案开始,有选择地使用这些模式。
推荐理由:Agent循环设计是构建高效Data Agent的关键工程实践,来自Claude Code团队的官方定义与选型指南对数据领域的智能体开发有直接参考价值。
Data AgentAnthropicClaude

译文 AI 逐段翻译

循环工程:循环入门

了解Claude Code团队如何定义智能体循环,并提供从基于回合到基于目标、基于时间和主动循环的实用指导,以及何时使用每种循环。

循环入门

目前有很多关于循环工程或“设计循环”而不是提示编码智能体的讨论。如果你花时间在X上试图确定循环到底是什么,你会遇到多种不同的答案。

在Claude Code团队,我们将循环定义为智能体重复工作周期直到满足停止条件。我们根据以下因素对几种不同类型的循环进行分类:

  • 它们如何被触发
  • 它们如何被停止
  • 使用了什么Claude Code原语
  • 每种循环最适合什么类型的任务。

我们将介绍主要的循环类型、何时使用每种类型,以及如何在管理token用量的同时保持代码质量。并非所有任务都需要复杂的循环;从最简单的解决方案开始,并有选择地使用这些模式。

未找到项目。

上一页

0/5

下一页

获取Claude Code

或阅读文档

尝试Claude Code

尝试Claude Code

开发者文档

开发者文档

电子书

基于回合的循环

图表
  • 触发方式:用户提示。
  • 停止条件:Claude判断已完成任务或需要更多上下文。
  • 最佳用途:较短的任务,不属于常规流程或日程。
  • 用量管理方式:编写具体的提示,并使用技能改进验证,以减少回合数。

你发送的每个提示都会启动一个手动循环,由你指导每个回合。Claude收集上下文、采取行动、检查其工作、根据需要重复,然后响应。我们称之为智能体循环。

例如,要求Claude创建一个点赞按钮。它读取你的代码,进行编辑,运行测试,并返回它认为可行的结果。然后你手动检查工作,并编写下一个提示。

你可以通过将手动步骤编码为SKILL.md来改进验证步骤,以便Claude可以端到端地检查更多自己的工作。(有关为此类自动化选择技能、钩子和子代理的指导,请参阅我们的引导Claude Code指南。)

这应包括工具或连接器,以允许Claude查看测量交互结果。检查越量化,Claude就越容易自我验证。

例如,在你的SKILL.md文件中,你可以指定:

--- 
name: verify-frontend-change 
description: Verify any UI change end-to-end before declaring it done. 
--- 
# Verifying frontend changes 
Never report a UI change as complete based on a successful edit alone. Verify it the way a human reviewer would: 
1. Start the dev server and open the edited page in the browser. 
2. Interact with the change directly. For a new control (button, input, toggle): click it, confirm the expected state change, and screenshot before/after. 
3. Check the browser console: zero new errors or warnings. 
4. Use the Chrome Devtools MCP, run a performance trace and audit Core Web Vitals.
If any step fails, fix the issue and rerun from step 1 — do not hand back partially verified work.

基于目标的循环 (/goal)

  • 触发方式:实时手动提示。
  • 停止条件:目标达成或达到最大回合数。
  • 最佳用途:具有可验证退出标准的任务。
  • 用量管理方式:设置具体的完成标准和明确的回合上限,例如“5次尝试后停止”。

有时,一个回合是不够的,尤其是对于更复杂的任务。智能体在能够迭代时表现更好。你可以通过使用/goal定义完成的样子来扩展Claude持续迭代的时间。

当你定义成功标准时,Claude不必自行判断什么是“足够好”而过早结束循环。每次Claude尝试停止时,评估器模型都会检查你的条件,并将其发送回工作,直到达到目标或达到你定义的回合数。

这就是为什么确定性标准(例如通过的测试数量或达到某个分数阈值)如此有效。

例如:

/goal get the homepage Lighthouse score to 90 or above, stop after 5 tries.

基于时间的循环 (/loop 和 /schedule)

  • 触发方式:指定的时间间隔。
  • 停止条件:你取消它,或工作完成(PR合并,队列为空)。
  • 最佳用途:用于重复性工作,或与外部环境/系统交互。
  • 用量管理方式:设置更长的间隔,或基于事件而非时间进行反应。

某些智能体工作是重复性的:任务保持不变,只有输入变化。例如,每天早上总结Slack消息。其他工作依赖于外部系统,而与之交互的一种简单方式是按间隔检查并响应变化。例如,一个PR可能收到代码审查或CI失败。

对于这些情况,你可以使用`/loop`在Claude运行时触发,它会按间隔重新运行提示。例如:

/loop 5m check my PR, address review comments, and fix failing CI

`/loop`在你的计算机上运行,所以如果你关闭它,它就会停止。你可以通过使用`/schedule`创建例程将循环迁移到云端。

主动循环

  • 触发方式:事件或日程,没有实时的人类参与。
  • 停止条件:每个任务在目标达成时退出。例程本身运行直到你关闭它。
  • 最佳用途:重复出现的明确定义的工作流:错误报告、问题分类、迁移、依赖升级等。
  • 用量管理方式:将例程路由到更小、更快的模型,并使用最强大的模型进行判断。

上述原语,以及Claude Code的其他功能,如自动模式动态工作流(研究预览)可以组合成用于长期运行的循环。

例如,要处理传入的反馈,你可以使用:

  1. `/schedule`(研究预览)运行检查新报告的例程
  2. `/goal`定义完成的样子,以及技能记录如何验证
  3. 动态工作流编排代理对每个报告进行分类、修复和审查修复
  4. 自动模式使例程运行而不停下来请求权限

综合起来,提示可能如下:

/schedule every hour: check #project-feedback for bug reports. /goal: don't stop until every report found this run is triaged, actioned, and responded to. When fixing a bug, use a workflow to explore three solutions in parallel worktrees and have a judge adversarially review them.

保持代码质量

循环输出的质量取决于其周围的系统。设计系统时:

  • 保持代码库本身整洁:Claude遵循代码库中已存在的模式和约定。
  • 给Claude一种验证其工作的方法:使用技能编码你和团队认为好的样子。
  • 使文档易于访问:框架和库的文档有最新的最佳实践。
  • 使用第二个代理进行代码审查:具有新上下文的审查者偏见更少,不受主代理推理的影响。你可以使用内置的`/code-review`技能或用于Github的代码审查。编写代码的循环需要检查代码的循环——参见Anthropic如何保护AI原生的SDLC

当单个结果未达到标准时,不要停留在修复单个问题上,而应尝试将其编码,以改进系统,惠及所有未来的迭代。

管理令牌使用量

为了管理令牌使用量,循环应有明确的边界:

  • 选择合适的基础模型和模型:较小的任务不需要多个代理或循环。某些任务可以使用更便宜、更快的模型。
  • 定义明确的成功和停止标准:明确描述“完成”的样子,以便Claude能更快地达成解决方案(但不要太快)。
  • 大规模运行前先试点:动态工作流可能生成数百个代理。先在较小的工作片段上评估使用量。
  • 对确定性工作使用脚本运行脚本比逐步推理更便宜。例如,一个PDF技能可以附带一个表单填写脚本,Claude每次运行该脚本,而不是重新推导代码。
  • 不要比需要的更频繁地运行例程:将间隔与你观察的事物变化的频率相匹配。
  • 审查使用情况:`/usage`命令按技能、子代理和MCP分解最近的使用情况;不带参数的`/goal`显示到目前为止的轮次和令牌使用量;`/workflows`显示每个代理的令牌使用量,并且你可以随时停止代理。

你的模型和努力水平的选择是影响循环成本的最大杠杆之一。

入门

总结:

循环你交接何时使用使用
基于回合检查你在探索或决策时自定义验证技能
基于目标停止条件你知道完成的样子/goal
基于时间触发器工作在你的项目之外按计划进行/loop/schedule
主动式提示工作是重复且定义明确的以上所有,以及动态工作流

要开始使用循环,请查看你已有的工作。选择一个你成为瓶颈的任务,并询问你可以交接哪一部分:你能编写验证检查吗?目标是否足够清晰?工作是否按计划到达?

一旦你有了想法,运行循环,观察结果,比如它在哪里停滞或过度延伸,并不要害怕迭代它。

有关更多信息,请阅读Claude Code文档中的并行运行代理,以及循环计划目标动态工作流页面。要使你的检查跨会话可重复,请参阅在Claude Code中使用技能构建验证循环

本文由Delba de Oliveira和Michael Segner撰写

常见问题

未找到项目。

相关文章

探索更多产品新闻和最佳实践,适用于使用Claude构建的团队。

2026年8月7日

自动模式现在是Claude Code中Pro、Max和Team计划的默认模式

Claude Code

自动模式现在是Claude Code中Pro、Max和Team计划的默认模式

自动模式现在是Claude Code中Pro、Max和Team计划的默认模式

2026年8月7日

在生产环境中运行自动模式

Claude Code

在生产环境中运行自动模式

在生产环境中运行自动模式

2026年8月6日

千年和Anthropic正在利用Claude构建数字风险分析师

企业AI

千年和Anthropic正在利用Claude构建数字风险分析师

千年和Anthropic正在利用Claude构建数字风险分析师

2026年7月24日

Claude模型解析:为你的用例选择最佳模型

企业AI

Claude模型解析:为你的用例选择最佳模型

Claude模型解析:为你的用例选择最佳模型

使用Claude改变你的组织运营方式

查看定价

查看定价

联系销售

联系销售

获取开发者新闻通讯

产品更新、操作指南、社区亮点等。每月发送到你的收件箱。

谢谢!你已订阅。

抱歉,你的提交出现问题,请稍后重试。

分享这条资讯
分享海报
保存图片
iOS 也可以长按图片保存