导航菜单

CLAUDE.md写好了，可Claude还在读文件、改代码、跑命令之间来回切换——你若不清楚它当前处于循环的哪一步，就只能干瞪眼。本讲帮你对齐官方Agent循环与内置工具的运作逻辑，看完你就能判断是该让它继续跑完还是需要提前介入。

 

官方文档参考

Agent循环：https://code.claude.com/docs/en/agent-loop
内置工具：https://code.claude.com/docs/en/tools

 

细节以官方页面为准；以下是结合文档和实际使用的个人笔记。

 

Agent循环的三个阶段

Claude Code的核心工作方式是一个持续循环的过程，每次循环包含三个步骤：

 

1. 理解阶段（Think）
Claude先理解你当前的任务和上下文。它会回顾之前的对话、读取相关文件、分析当前状态。这个阶段你会在终端看到类似“Reading file...”或“Analyzing...”的提示。

 

2. 决策阶段（Plan）
基于理解的结果，Claude决定下一步要做什么——是读取另一个文件、修改某段代码、还是运行一个命令。这个阶段通常会显示“Planning next action...”的提示。

 

3. 执行阶段（Act）
Claude调用相应的工具执行决策：用Read工具读取文件、用Edit工具修改代码、用Bash工具运行命令。执行完成后，它会根据结果决定是否进入下一轮循环。

 

这个过程会一直重复，直到任务完成或遇到需要你确认的关键节点。你可以在终端中清晰地看到当前处于哪个阶段，从而判断AI是否在正确推进。

 

内置工具一览

Claude Code内置了以下核心工具，用来完成实际任务：

 

Read：读取文件内容。AI会用它来理解代码、查看配置、检查日志。你可以在终端看到“Reading file: src/index.js”这样的提示。

Edit：修改文件内容。AI会用工具来改代码，改完后会展示改动内容。建议配合并排diff检查改动点。

Bash：在终端中运行命令。包括npm install、git status、测试命令等。你可以在终端实时看到命令输出。

Grep：在项目中搜索文本。AI会用这个工具快速定位代码位置，比人工搜索快得多。

Task：创建子任务。当任务比较复杂时，AI可以创建子任务来拆解工作，子任务完成后会合并结果。

 

读懂终端反馈

在终端里观察Claude Code的执行过程，以下几个关键信息值得留意：

 

• 工具调用标记：当AI调用工具时，终端会显示工具名称和参数。例如“[Tool: Read] reading src/api.ts”。
• 工具输出：工具执行的结果会直接展示在终端中，方便你追踪每一步的效果。
• 循环进度：每完成一轮循环，终端会显示进度标记或分隔线，帮助你了解当前任务的推进情况。

 

什么时候该介入

虽然Agent循环会自动运行，但以下情况建议你主动介入：

 

• 循环超过5轮还在做同一件事——可能方向有偏差。
• 工具调用频繁失败——例如文件路径错误或权限不足。
• 需要你输入决策信息时——例如多选一的情况，AI会停下来等待你的选择。

 

跟做清单

• 跑一个真实任务，在终端观察到完整的“理解→决策→执行”三阶段过程
• 分别看到过Read、Edit、Bash三种工具被调用
• 能说出一轮循环从开始到结束的步骤顺序
• 在循环超过3轮时能判断是否需要介入