Claude Code Agent Loop 研究系列（10）—— 从自动循环到通用 Agent Loop
内容提要
Claude Code Agent Loop系列总结：核心是自动循环状态机，用户回车后自主运行，通过权限批准、interrupt和maxTurns三道保险控制。错误转为可处理状态而非中断，主代理与子代理复用同一套loop。Loop管执行，Context管信息组织，二者构成完整运行机制。
延伸解读
自动循环与人工控制的平衡
文章强调，Claude Code 的自动循环并非完全失控，而是通过三道保险实现可控：权限批准在执行危险工具前暂停等待用户确认，interrupt 允许用户随时打断，maxTurns 则提供无人干预时的硬性上限。这三者分别对应执行前、运行中和最终停止，共同确保自动推进的同时保留人工干预的通道。
错误处理的设计哲学
核心思想是将错误转化为可继续处理的状态，而非直接中断循环。工具失败被转换为 tool_result 交给模型，主循环恢复需求被转换为 transition 交给下一轮。这种设计使 loop 更像主动自救的恢复引擎，只有内部恢复失败才向用户报告最终错误，体现了容错与自愈的工程理念。
Loop 与 Context 的分工
文章明确区分了 Loop 与 Context 两个系列：Loop 负责执行流程，即模型调用、工具执行、重试与停止的时机；Context 负责信息组织，包括消息装配、缓存复用、历史压缩和配置注入。两者结合才构成完整的运行机制，理解这一分工有助于分别深入掌握 Claude Code 的架构。
Q&A
Claude Code Agent Loop 的核心机制是什么？
Claude Code Agent Loop 的核心是一个自动循环状态机。用户按一次回车后，loop 自主运行，连续调用模型和工具，直到任务结束。它通过显式状态记录每轮结束后的下一步操作，并根据状态决定走正常调用、重试、压缩还是恢复分支。
Claude Code Agent Loop 如何保证自动运行的安全性？
Loop 自动运行有三道保险：权限批准（执行危险工具前等待用户确认）、interrupt（用户可随时打断）、maxTurns（达到轮数上限强制停止）。三者分别处理执行前确认、运行中制动和最终硬上限。
Claude Code Agent Loop 如何处理错误？
错误被转换成可继续处理的状态或数据，而不是直接中断 loop。工具执行失败会转换为 tool_result 交给 LLM；主循环需要恢复时转换为 transition 交给下一轮。Loop 像一个主动自救的 recovery engine，只有内部恢复失败才报告用户。
Claude Code 中主代理和子代理的 loop 实现有何关系？
主代理和子代理复用同一套 queryLoop 代码，只是各自独立运行，并通过 agentId 区分身份。这说明 loop 是通用的执行引擎，而非专门服务于聊天窗口。
Claude Code Agent Loop 与 Context 管理系列的分工是什么？
Loop 管执行，讲清事情怎么发生（何时调用模型、执行工具、重试、停止）；Context 管信息组织，讲清信息怎么组织（messages 装配、prompt cache 复用、compact 缩短历史、CLAUDE.md 注入）。二者合起来构成完整运行机制。
Claude Code Agent Loop 与普通聊天机器人（chatbot）的根本区别是什么？
Chatbot 完成一次回答就停，而 Agent 可以在一次用户输入后连续调用模型和工具，直到任务结束。Loop 是自动循环，中间通常无需用户逐步指挥，只有需要权限批准或用户主动 interrupt 时才会停下来。
