预计字数4500 字 阅读时间15 分钟 难度等级⭐⭐小白友好配具体命令可直接操作 核心价值搞懂 Claude Code 四种 Agent 循环模式的区别——从你问一句它答一句到它自己发现问题自己执行每种都配具体命令和真实场景Claude Code 不只是帮你写代码的聊天机器人。Anthropic 在2026年4月到5月之间连续8周更新给它加了一套完整的自主运行体系。这套体系有四种模式从你问一句它做一步到它自己发现问题、自己执行、自己验证。但大多数用户只用到了第一种。今天把官方文档里的四种 Agent 循环模式全部拆开讲。每种都配具体命令和真实场景看完就能直接用。先搞懂底层什么是回合不管哪种模式Claude Code 的底层都是同一个回合循环Agentic Loop。每一个回合分三步1. 收集上下文读文件、搜索代码、理解结构2. 执行操作编辑文件、运行命令、调用工具3. 验证结果跑测试、检查输出、确认修改一个简单问题这里有哪些文件可能1-2个回合就结束。一个复杂任务重构auth模块并更新所有测试可能需要几十个回合。Claude 自己决定每个回合该做什么根据上一步的结果调整下一步。你可以在任何时刻按 Esc 打断输入修正或者让它换个方向。这就是底层机制。四种模式的不同之处在于谁来决定开始下一个回合。第一种回合循环Turn-based Loop谁启动下一回合你。这是最基础的用法。你输入指令Claude 执行一个或多个回合然后把控制权还给你。你看了结果再输入下一条指令。大部分人用 Claude Code 就是这个模式。你帮我修一下auth模块的测试 Claude[跑测试→读文件→修代码→跑测试→全部通过] Claude修好了三个测试都通过了。 你顺便把 lint 也跑一下 Claude[跑lint→修两个warning]每个回合Claude 可以调用多个工具读文件、搜索代码、编辑文件、运行命令但这些工具的结果只会影响当前回合的判断不会自动触发下一轮。你什么时候用日常问答、代码修改、问题排查。任何需要你一步步看结果再决定下一步的场景。可以不用当你能明确描述完成条件但不想手动一步步盯着的时候。这时候该用第二种。第二种目标循环Goal-based Loop谁启动下一回合一个快速小模型。这是2026年5月发布的 /goal 功能。你给 Claude 一个完成条件它自己跑完所有回合直到条件满足才停下来。每跑完一个回合一个快速小模型默认 Haiku会检查条件满足了吗没满足就继续满足了就自动停止。/goal all tests in test/auth pass and the lint step is cleanClaude 开始跑修代码→跑测试→还有两个失败→修→跑→通过了→跑lint→有warning→修→跑lint→clean了→自动停止。整个过程你不需要输入任何东西。一个有效的 goal 条件通常包含三部分1. 可衡量的终点测试全部通过、构建退出码为0、文件数量达标2. 检查方法npm test 退出0git status 是clean3. 约束条件不能修改的内容比如不改动其他测试文件更多例子/goal src/auth.ts 被拆分成多个模块每个不超过200行 /goal CHANGELOG.md 包含本周每个合并PR的记录 /goal 所有 TODO 注释都被移除 or stop after 15 turns最后一行加了回合限制防止 Claude 跑太远。和第一种的区别你不需要在每一步之间输入指令。你只需要告诉它做到什么程度算完。第三种时间循环Time-based Loop谁启动下一回合时钟。设定一个时间间隔Claude 到时间就自动执行一次任务。你不需要在场不需要输入它自己按点跑。三种用法固定间隔/loop 5m check the deploy status每5分钟检查一次部署状态把结果告诉你。动态间隔/loop check CI on my PR不给间隔Claude 自己判断间隔PR有新变化就勤快一点1-2分钟PR安静了就放慢几十分钟。内置维护循环/loop什么都不给Claude 跑内置维护任务继续未完成的工作、看当前分支的PR状态和CI结果、跑清理pass。还可以自定义维护内容。在项目根目录创建 .claude/loop.md写你自己的维护指令Claude 就会按这个文件的内容跑。三种调度方式对比/loop本地运行需要会话开着最小间隔1分钟Desktop 任务本地运行会话可以关最小间隔1分钟RoutinesAnthropic云运行不需要你在场最小间隔1小时注意/loop 创建的任务7天后自动过期防止遗忘的任务一直跑。第四种主动循环Proactive / Autonomous Loop谁启动下一回合Claude 自己。这是自主度最高的模式。Claude 不仅执行任务还自己发现需要做的事自己决定做不做自己验证结果。这个模式不是单个命令而是多个功能的组合Auto Mode自动审批按 ShiftTab 切换到 auto modeClaude 的每个工具调用都通过一个安全分类器自动审批。你不需要按允许或拒绝——常规操作自动通过破坏性操作自动拦截。配合 /goal 一起用auto mode 去掉了每个工具的确认弹窗/goal 去掉了每个回合的确认弹窗。两个加在一起 完全自主运行。Cloud Routines云端自动触发在 claude.ai/code/routines 创建一个 routine设定三种触发方式1. 定时每天9点自动跑PR审查2. GitHub 事件PR一创建就自动跑review checklist3. API调用监控系统发告警就自动拉堆栈、关联commit、开修复PR不需要你开着电脑。Claude 在 Anthropic 的云服务器上自动克隆仓库、执行操作、创建PR。后台 Agent Dashboardclaude agents打开一个dashboard可以同时dispatch多个任务修bug、review PR、查flaky test。每个任务一行你只在需要的时候才介入。子代理Subagents复杂任务拆给子代理每个子代理有自己的上下文窗口独立运行只把结果返回给主对话。副任务的中间过程不会撑爆你的主对话。四种循环什么时候用哪种场景对照表日常写代码、问问题 → 回合循环需要看每一步再决定重构一个模块 → 目标循环能明确描述完成条件盯PR的CI状态 → 时间循环需要定时检查一次性大迁移 → 目标循环条件清晰跑完即停每天自动review代码 → 主动循环Routine无人值守监控自动修复 → 主动循环RoutineAPI触发告警即响应核心原则从最简单的开始。官方文档的原话是start with the simplest approach。不要一上来就上Routine和auto mode。大部分任务用回合循环就够了。只有当你能明确说出做到什么程度算完的时候才用目标循环。只有当任务需要无人值守的时候才上主动循环。权限模式和安全相关的必知事项四种循环和权限模式是两套独立的系统。循环控制谁来启动下一回合权限模式控制这个回合里的工具能不能执行。Claude Code 有6种权限模式default每个工具调用需要你确认 → 日常使用acceptEdits文件编辑自动通过 → 需要流畅执行时plan只看方案不改文件 → 评估风险时auto分类器自动审批 → 半自主运行dontAsk只跑允许列表内的工具 → CI/自动化bypassPermissions全部自动 → 隔离环境容器/沙箱auto mode 和目标循环、主动循环搭配最紧。它让不需要人工确认的工具直接跑但会拦截有风险的比如推送到外部仓库、执行不可逆操作。一个实际例子从回合循环升级到主动循环假设任务PR的CI一直红了需要自动修复。回合循环你看一下PR #123的CI为什么失败 Claude[读CI日志] 发现是test/auth里有个casehardening的问题 你修一下 Claude[修代码→跑测试→通过] 你推送一下 Claude[推送]每次都要你手动推进。目标循环/goal PR #123 的所有CI检查通过tests passClaude 自己读CI、修代码、跑测试、推送直到全绿。你只需要等结果。主动循环Routine在 claude.ai/code/routines 创建一个 routine触发条件设为PR创建。Claude 在云端自动跑review checklist检查通过后自动合入。整个过程你不需要在电脑前。同样一个任务三种模式人工参与程度从100%降到0%。今晚就可以试不要一次学四种。从最简单的开始1. 下次用 Claude Code 写代码的时候遇到一个可以描述完成条件的任务试试 /goal比如/goal auth module 的所有测试通过看 Claude 自己跑完整个流程。感受一下不用手动推进是什么体验。2. 如果你的 PR 经常需要盯着 CI 状态试试/loop 5m check CI status on my PR3. 如果想更进一步把本地跑通的 workflow 搬到 Routines让它在你关机之后也能跑。既然看到这里了如果觉得不错随手点个赞、在看、转发三连吧如果可以给我个星标⭐将不胜感激谢谢你看我的文章我们下次再见。#Claude Code #Agent循环 #AI编程 #大象AI共学作者大象-推动 AI 共学让普通人轻松上手AI相关链接Claude Code 官方文档Agent Loophttps://code.claude.com/docs/en/agent-sdk/agent-loop.mdClaude Code 官方文档/goalhttps://code.claude.com/docs/en/goal.mdClaude Code 官方文档/loop 定时任务https://code.claude.com/docs/en/scheduled-tasks.md社群站https://daxiangnaoyang.github.io/daxiang-ai-gongxue/
Claude Code官方详解四种Agent循环——90%的人只用到了第一种
预计字数4500 字 阅读时间15 分钟 难度等级⭐⭐小白友好配具体命令可直接操作 核心价值搞懂 Claude Code 四种 Agent 循环模式的区别——从你问一句它答一句到它自己发现问题自己执行每种都配具体命令和真实场景Claude Code 不只是帮你写代码的聊天机器人。Anthropic 在2026年4月到5月之间连续8周更新给它加了一套完整的自主运行体系。这套体系有四种模式从你问一句它做一步到它自己发现问题、自己执行、自己验证。但大多数用户只用到了第一种。今天把官方文档里的四种 Agent 循环模式全部拆开讲。每种都配具体命令和真实场景看完就能直接用。先搞懂底层什么是回合不管哪种模式Claude Code 的底层都是同一个回合循环Agentic Loop。每一个回合分三步1. 收集上下文读文件、搜索代码、理解结构2. 执行操作编辑文件、运行命令、调用工具3. 验证结果跑测试、检查输出、确认修改一个简单问题这里有哪些文件可能1-2个回合就结束。一个复杂任务重构auth模块并更新所有测试可能需要几十个回合。Claude 自己决定每个回合该做什么根据上一步的结果调整下一步。你可以在任何时刻按 Esc 打断输入修正或者让它换个方向。这就是底层机制。四种模式的不同之处在于谁来决定开始下一个回合。第一种回合循环Turn-based Loop谁启动下一回合你。这是最基础的用法。你输入指令Claude 执行一个或多个回合然后把控制权还给你。你看了结果再输入下一条指令。大部分人用 Claude Code 就是这个模式。你帮我修一下auth模块的测试 Claude[跑测试→读文件→修代码→跑测试→全部通过] Claude修好了三个测试都通过了。 你顺便把 lint 也跑一下 Claude[跑lint→修两个warning]每个回合Claude 可以调用多个工具读文件、搜索代码、编辑文件、运行命令但这些工具的结果只会影响当前回合的判断不会自动触发下一轮。你什么时候用日常问答、代码修改、问题排查。任何需要你一步步看结果再决定下一步的场景。可以不用当你能明确描述完成条件但不想手动一步步盯着的时候。这时候该用第二种。第二种目标循环Goal-based Loop谁启动下一回合一个快速小模型。这是2026年5月发布的 /goal 功能。你给 Claude 一个完成条件它自己跑完所有回合直到条件满足才停下来。每跑完一个回合一个快速小模型默认 Haiku会检查条件满足了吗没满足就继续满足了就自动停止。/goal all tests in test/auth pass and the lint step is cleanClaude 开始跑修代码→跑测试→还有两个失败→修→跑→通过了→跑lint→有warning→修→跑lint→clean了→自动停止。整个过程你不需要输入任何东西。一个有效的 goal 条件通常包含三部分1. 可衡量的终点测试全部通过、构建退出码为0、文件数量达标2. 检查方法npm test 退出0git status 是clean3. 约束条件不能修改的内容比如不改动其他测试文件更多例子/goal src/auth.ts 被拆分成多个模块每个不超过200行 /goal CHANGELOG.md 包含本周每个合并PR的记录 /goal 所有 TODO 注释都被移除 or stop after 15 turns最后一行加了回合限制防止 Claude 跑太远。和第一种的区别你不需要在每一步之间输入指令。你只需要告诉它做到什么程度算完。第三种时间循环Time-based Loop谁启动下一回合时钟。设定一个时间间隔Claude 到时间就自动执行一次任务。你不需要在场不需要输入它自己按点跑。三种用法固定间隔/loop 5m check the deploy status每5分钟检查一次部署状态把结果告诉你。动态间隔/loop check CI on my PR不给间隔Claude 自己判断间隔PR有新变化就勤快一点1-2分钟PR安静了就放慢几十分钟。内置维护循环/loop什么都不给Claude 跑内置维护任务继续未完成的工作、看当前分支的PR状态和CI结果、跑清理pass。还可以自定义维护内容。在项目根目录创建 .claude/loop.md写你自己的维护指令Claude 就会按这个文件的内容跑。三种调度方式对比/loop本地运行需要会话开着最小间隔1分钟Desktop 任务本地运行会话可以关最小间隔1分钟RoutinesAnthropic云运行不需要你在场最小间隔1小时注意/loop 创建的任务7天后自动过期防止遗忘的任务一直跑。第四种主动循环Proactive / Autonomous Loop谁启动下一回合Claude 自己。这是自主度最高的模式。Claude 不仅执行任务还自己发现需要做的事自己决定做不做自己验证结果。这个模式不是单个命令而是多个功能的组合Auto Mode自动审批按 ShiftTab 切换到 auto modeClaude 的每个工具调用都通过一个安全分类器自动审批。你不需要按允许或拒绝——常规操作自动通过破坏性操作自动拦截。配合 /goal 一起用auto mode 去掉了每个工具的确认弹窗/goal 去掉了每个回合的确认弹窗。两个加在一起 完全自主运行。Cloud Routines云端自动触发在 claude.ai/code/routines 创建一个 routine设定三种触发方式1. 定时每天9点自动跑PR审查2. GitHub 事件PR一创建就自动跑review checklist3. API调用监控系统发告警就自动拉堆栈、关联commit、开修复PR不需要你开着电脑。Claude 在 Anthropic 的云服务器上自动克隆仓库、执行操作、创建PR。后台 Agent Dashboardclaude agents打开一个dashboard可以同时dispatch多个任务修bug、review PR、查flaky test。每个任务一行你只在需要的时候才介入。子代理Subagents复杂任务拆给子代理每个子代理有自己的上下文窗口独立运行只把结果返回给主对话。副任务的中间过程不会撑爆你的主对话。四种循环什么时候用哪种场景对照表日常写代码、问问题 → 回合循环需要看每一步再决定重构一个模块 → 目标循环能明确描述完成条件盯PR的CI状态 → 时间循环需要定时检查一次性大迁移 → 目标循环条件清晰跑完即停每天自动review代码 → 主动循环Routine无人值守监控自动修复 → 主动循环RoutineAPI触发告警即响应核心原则从最简单的开始。官方文档的原话是start with the simplest approach。不要一上来就上Routine和auto mode。大部分任务用回合循环就够了。只有当你能明确说出做到什么程度算完的时候才用目标循环。只有当任务需要无人值守的时候才上主动循环。权限模式和安全相关的必知事项四种循环和权限模式是两套独立的系统。循环控制谁来启动下一回合权限模式控制这个回合里的工具能不能执行。Claude Code 有6种权限模式default每个工具调用需要你确认 → 日常使用acceptEdits文件编辑自动通过 → 需要流畅执行时plan只看方案不改文件 → 评估风险时auto分类器自动审批 → 半自主运行dontAsk只跑允许列表内的工具 → CI/自动化bypassPermissions全部自动 → 隔离环境容器/沙箱auto mode 和目标循环、主动循环搭配最紧。它让不需要人工确认的工具直接跑但会拦截有风险的比如推送到外部仓库、执行不可逆操作。一个实际例子从回合循环升级到主动循环假设任务PR的CI一直红了需要自动修复。回合循环你看一下PR #123的CI为什么失败 Claude[读CI日志] 发现是test/auth里有个casehardening的问题 你修一下 Claude[修代码→跑测试→通过] 你推送一下 Claude[推送]每次都要你手动推进。目标循环/goal PR #123 的所有CI检查通过tests passClaude 自己读CI、修代码、跑测试、推送直到全绿。你只需要等结果。主动循环Routine在 claude.ai/code/routines 创建一个 routine触发条件设为PR创建。Claude 在云端自动跑review checklist检查通过后自动合入。整个过程你不需要在电脑前。同样一个任务三种模式人工参与程度从100%降到0%。今晚就可以试不要一次学四种。从最简单的开始1. 下次用 Claude Code 写代码的时候遇到一个可以描述完成条件的任务试试 /goal比如/goal auth module 的所有测试通过看 Claude 自己跑完整个流程。感受一下不用手动推进是什么体验。2. 如果你的 PR 经常需要盯着 CI 状态试试/loop 5m check CI status on my PR3. 如果想更进一步把本地跑通的 workflow 搬到 Routines让它在你关机之后也能跑。既然看到这里了如果觉得不错随手点个赞、在看、转发三连吧如果可以给我个星标⭐将不胜感激谢谢你看我的文章我们下次再见。#Claude Code #Agent循环 #AI编程 #大象AI共学作者大象-推动 AI 共学让普通人轻松上手AI相关链接Claude Code 官方文档Agent Loophttps://code.claude.com/docs/en/agent-sdk/agent-loop.mdClaude Code 官方文档/goalhttps://code.claude.com/docs/en/goal.mdClaude Code 官方文档/loop 定时任务https://code.claude.com/docs/en/scheduled-tasks.md社群站https://daxiangnaoyang.github.io/daxiang-ai-gongxue/
