如何让你的 AI 编码 agent 不跑偏：先探索，再规划，最后构建

人们第一次使用像 Claude Code 或 Cursor 这样的 agent 式编码工具时，往往会敲一行请求然后碰运气。有时它管用。但更常见的是，agent 信心十足地构建出错误的东西——解决了一个你没问的问题、动了你没预料到的文件，或者跳过了真正要紧的边界情况。

解决之道不是更聪明的模型，而是一套工作流：先探索，再规划，最后构建。这正是 Anthropic 在其官方 Claude Code 最佳实践指南中推荐的模式，而同样的思路适用于任何能在编辑之前先读你仓库的 agent。

为什么直接跳到写代码会失败

AI agent 工作在一个有限的上下文窗口内——也就是你对话的实时记录，加上它读的每个文件、运行的每条命令。跳过规划会带来两个问题：

1. agent 会去猜意图。 它读不了你的心思，所以模糊的提示会换来一个貌似合理却错误的实现。
2. 错误会悄悄滚雪球。 一旦 agent 开始编辑，第一步里的一个错误假设会在你察觉之前，被另外十处改动埋起来。

把思考和动手分开，能在错误假设还很便宜就能修的时候抓住它——只需一句纠正，而不是回退 12 个文件。

第 1 步：在只读模式下探索

如今大多数正经 agent 都有一种模式：它们可以阅读和分析，但什么都不能改。在 Claude Code 中这叫 plan mode：一种只读状态，agent 读文件、回答问题，但不编辑、不运行会改变状态的命令、不提交。

先让 agent 去理解代码，而不是改它：

Read /src/auth and explain how we handle sessions and login.
Also look at how we manage environment variables for secrets.

你是在建立共享的上下文，并在信任 agent 修改代码之前，验证它确实理解了你的代码库。

第 2 步：要一份计划，然后对它发问

agent 探索完之后，在写任何代码之前，先要一份具体的计划：

I want to add Google OAuth login. What files need to change?
What's the session flow? Write a step-by-step plan — don't write code yet.

agent 会返回一份带编号的计划：它会动哪些文件、新的会话流程、它会把 token 存在哪里。现在，别接受第一稿。这是纠偏成本最低的时刻。针对缺口发问：

• "如果 OAuth 回调进行到一半失败了会怎样？"
• "我们在 src/auth/tokens.ts 里已经有一个 refreshToken 辅助函数了——复用它，别再写一个新的。"
• "把范围只限定在登录流程上。别动现有的密码重置代码。"

在这里花几分钟打磨计划，能省下后面解开一个错误实现的一个小时。

第 3 步：在能验证的前提下构建

只有到现在，你才让 agent 写代码——并且给它一个能检查自身工作的方式。任何提示中最有力的单项补充，就是一个 agent 能自己运行的验证步骤：

Implement the OAuth flow from your plan. Write a test for the callback
handler covering the failure case, run the test suite, and fix any failures.

没有一个它能运行的检查——测试、一次构建、一张用于对比的截图——"看起来完成了"就是 agent 唯一拥有的信号，而你则成了它每一个错误的检测器。有了检查，循环就能自己闭合：agent 写代码、跑测试、读结果，反复迭代直到通过。让它展示实际的测试输出，而不是只声称成功了。

第 4 步：知道何时该跳过规划

规划是有开销的，而且它并不总是值得。如果改动很小、范围一目了然——改个错别字、加一行日志、重命名一个变量——那就直接让 agent 去做。Anthropic 指南里有一条好用的经验法则：如果你能用一句话描述这个 diff，就跳过规划。 把探索-规划-构建这个循环，留给那些跨多个文件、用了你拿不准的方案，或者触及你不熟悉的代码的工作。

一张安全网：尽早纠偏，并使用 checkpoint

即便有一份好计划，agent 也会漂移。两个习惯能让你保持掌控：

• 它一跑偏就立刻打断。 别等 agent 把一个错误方案做完。在 Claude Code 中，Esc 能在保留上下文的情况下中途叫停它，方便你重新引导。
• 用 checkpoint 来放心地做实验。 Claude Code 会在每次改动前给你的文件拍快照，所以你可以让 agent 去试一些有风险的东西，如果不奏效，就回退（Esc Esc 或 /rewind）再换个方案。（checkpoint 跟踪的是 agent 自己的编辑，而不是外部进程——它是一种便利，而非 git 的替代品。）

而如果你发现自己在纠正同一个错误超过两次，那上下文很可能已经被失败的尝试污染了。清空它，用一个更犀利、把你刚学到的东西吸收进去的提示重新开始——一个干净的会话配上更好的提示，几乎总能胜过一个塞满死胡同的长会话。

要点

探索、规划、构建、验证。第一个任务上它感觉更慢，到第二个任务就把成本赚回来了。你不再得到信心十足却错误的代码，而开始得到一个能构建出你真正想要的那个东西的 agent。