AI编码代理新手常犯的5个错误及避坑指南

AI编码代理（如Claude Code）能读取文件、运行命令并执行修改，听起来很强大。但对新手而言，它同样危险——代理会严格按你说的做，而新手往往不知道哪些话不该说。

本文梳理了五个典型错误。它们与智商无关，全是习惯问题，每个都能在20分钟内纠正。

错误一：第一天就指向真实文件

最常见的开局：装好代理，直接对准真实项目，让它干正事。结果往往是文件夹被重组得面目全非，配置文件被“清理”掉。

修复方法很枯燥但有效：建一个练习文件夹，命名为 agent-practice，放在容易找到的地方。所有操作都限制在这个文件夹内。要搞砸就搞砸练习区，别碰真实项目。

前五次会话老老实实待在沙盒里。之后切换到真实项目时，先做一次只读会话：“探索这个项目并解释结构，不要做任何修改。”这能在付出代价前发现误解。代理在沙盒里误解你的项目布局只是好笑；在真实仓库里发生同样的事，就是一个糟糕的下午。

错误二：开启自动批准来“提速”

某个教程告诉你开启自动批准，这样代理就不会在执行每条命令前反复询问。对新手来说，这个教程是错的。

“先问后做”是你最重要的设置，是阻止代理以双倍速度删错文件夹的唯一屏障。没错，它会拖慢节奏——这正是重点。学习阶段，慢就是安全，而安全就是快，因为你不用花一晚上从备份恢复。

保持“运行命令前先询问”开启，持续数月而非数天。只有针对特定的、无聊的、可逆的命令，并且在观察代理正确执行十几次之后，才考虑关闭。速度不是目标，不出事才是。

自动批准（auto-approve） 是AI编码代理的一项权限设置：开启后，代理执行文件写入、命令运行等操作时不再逐条弹出确认，而是直接执行。它的设计初衷是服务熟练用户——当代理的行为模式已被充分验证、操作范围被严格限定在可逆的沙盒中时，减少确认弹窗确实能提升效率。但对新手而言，问题在于判断力尚未建立：你还没有能力预判一条命令的后果，却提前交出了否决权。自动批准的危险具有「放大效应」——它不会让代理变笨，而是让同样的错误以更快的速度、更大的批量发生。更隐蔽的风险是「静默累积」：单条命令看似无害，但几十条叠加起来可能重构整个目录结构，等你发现时已难以回滚。因此业界通行的做法是「渐进式授权」：先用只读或逐条确认模式运行数周，确认代理在特定任务上稳定可靠后，再针对单一、可逆、无副作用的命令类型开放自动批准，而非全局开关。

错误三：写模糊的提示词

“代理在提示后毫无反应”是新手最常见的抱怨之一，几乎总是提示词的问题。对比一下：

模糊版：“看看项目里有什么，了解一下情况。” 具体版：“列出这个文件夹里的每个文件，并用一句话告诉我每个文件的作用。”

模糊版没有给代理可检查的结果，它不知道何时算完成，于是要么不动，要么乱转。具体版只有一个动作和一个明确的输出，代理能成功执行，你也能验证。

这个原则适用于所有请求。发送前，把每个请求改写成一个具体动作，附带可检查的结果。“修好这个bug”变成“找到处理登录的函数，解释它的作用，暂时不要修改。”更小的请求、更清晰的结果、更少的意外。

新手还容易合并任务：“解释项目、修复bug、更新文档。”不要合并。一次只选一件事。代理做一件事很出色，做三件事很糟糕。

错误四：跳过配置文件

Claude Code会在每次会话开始时自动读取 CLAUDE.md 文件。把它看作代理关于你和你的环境的永久指令。新手要么不知道它存在，要么一直没空写，结果每次会话代理都对他们的规则一无所知。

第一天就写一个。不需要很长。入门版本如下：

`CLAUDE.md` 属于「代理记忆文件」（agent memory file）这一机制，同类实现还包括 Cursor 的 `.cursorrules`、GitHub Copilot 的自定义指令等。其核心价值在于解决大语言模型的一个固有短板：**上下文窗口无状态**。每次新会话开始时，代理对你是谁、你的项目规则、上次犯过什么错一无所知——除非你把这些信息写进一个它每次都会自动读取的文件。这意味着配置文件具有「一次编写、永久生效」的杠杆效应：临时在提示词里叮嘱十句，不如在 `CLAUDE.md` 里写一句。实践中有几个要点：一是保持精简，过长的文件会挤占上下文预算，反而稀释关键规则的权重；二是用祈使句和明确禁令（「永远不要删除文件」）而非含糊描述；三是把它当作活文档，每当代理重复犯某个错误，就补一条规则进去，让配置随经验增长。
# 关于我
- 技能水平：新手，请边做边解释你在做什么

# 规则
- 修改前始终先展示即将更改的内容。
- 永远不要删除文件。每次都要先问我。
- 未经我对该次发送的明确批准，永远不要发送邮件、消息或在线发布任何内容。
- 如果不确定某事，停下来问我，不要猜测。
- 解释保持简短平实。不用未定义的行话。

读一遍，确保每条规则你都理解。这五行对你安全的贡献超过你将来粘贴的任何提示词，因为它们自动适用于每次会话。写一次，永不过期。

随着学习深入，逐步扩充这个文件。加入项目特定规则、代理犯过的错误、你反复强调的偏好。它会成为你教给代理的一切的活文档，并产生复利效应。

错误五：立即连接所有服务

邮箱、消息应用、社交账号、云存储。第一天的诱惑是把代理接入整个数字生活，让它“真正帮上忙”。千万别这么做。

每一个连接都是误解逃出电脑的新途径。代理误读文件只是烦人，但基于误读文件发送邮件就是你无法撤回的问题。大约一半的代理用户报告过代理发送了不该发送的内容，大多数故事的开头都是“我第一天就把它连到了邮箱”。

规则简单且永久：代理起草，人类发送。让它写邮件，你自己读，自己点发送。这条线无论你多有经验都不移动。有些事情永远手动：向他人发送任何内容、删除数据、花钱、发布任何东西。代理提议，你决定。

一次只连接一个集成，间隔数周，等代理在本地文件上证明自己之后。每次连接前问自己：“如果它在这里误解了我，最坏会发生什么？”如果答案让你不安，就再等等。

底层模式

注意这五个错误的共同点。都不是代理太笨，而是人类跑得太快：练习之前就用真实文件、安全之前就追求速度、模糊请求代替具体请求、没有常设规则、一次性连接所有服务。

修复它们的心态完全一致：从小处开始，待在沙盒里，保持先问后做，写下你的规则，缓慢扩展。20分钟的初始设置，能让你避开整个新手灾难类别。这是你与AI代理相处中回报最高的20分钟。