一句话解决 Codex 经常“降智”的问题，实测有效！

最近在折腾辅助编程工具的时候，不知道大家有没有遇到过一种情况：明明是个很简单的需求，模型却突然“降智”了，要么生成的代码漏洞百出，要么直接给你甩过来一个 516 错误，体验极差。

这就好比你指挥一个熟练工干活，他突然开始说胡话或者罢工。经过多方排查和社区大佬的实测，这大概率不是你要写的代码有问题，而是模型本身的“闲聊”机制在作祟。今天就来分享一个一行代码就能缓解这个 Bug 的神技，亲测非常有效。

什么是“降智”与 516 错误？

所谓的“降智”，在 Codex 或类似模型的使用中，通常表现为：

1. 回复冗余且无效：模型不直接给代码，而是先输出一大段解释性文字，甚至在代码框外面加一堆废话。
2. 格式错乱：因为它说了太多“人话”，导致原本应该纯净的代码块被截断或格式化错误。
3. 516 错误：这是最让人头疼的，往往发生在模型生成了过多的非指令性内容后，导致无法正确解析请求或响应超时。

有数据显示，在某些极端场景下，如果不加干预，这种错误的触发率甚至能高达 80%。

神技：一行配置拯救模型

在 AGENTS.md 文件中添加一行指令即可解决问题

其实解决方法非常简单，甚至有点“反直觉”。我们不需要去修改复杂的 System Prompt，也不需要重写你的请求逻辑，只需要在你的项目根目录（或者你配置的特定目录下）找到或创建一个叫 AGENTS.md 的文件。

然后，在这个文件里加上这样一句话：

DO NOT send optional commentary
``

就这么简单！

### 为什么这一句话这么管用？

这个技巧背后的原理其实非常直观，核心在于 **Prompt Engineering（提示词工程）** 中的指令强化。

1.  **切断冗余输出**：Codex 等模型有时会因为预训练数据的习惯，试图表现得“乐于助人”，除了代码外还附带一些解释或建议（即 `commentary`）。但在自动化开发流程中，这些文本往往是噪音。
2.  **降低 Token 消耗与解析压力**：禁止可选评论后，模型被迫将计算能力集中在生成高质量的代码上。这不仅减少了输出的 Token 数量，还大幅降低了后续解析器把“废话”当成代码处理的风险。
3.  **规避触发词**：据相关调查发现，`516` 错误与模型输出特定类型的评论高度相关。屏蔽了这类输出，自然也就绕过了这个报错陷阱。

### 效果对比：从崩溃到丝滑

根据网上的实测数据，在加上这行指令之前，遇到 `516` 概率或生成无效代码的概率高达 80%。而在加入这一行配置后，这个惊人的数字直接下降到了 **20%** 左右，甚至更低。

你可以想象一下，原本十次请求有八次要重来，现在只需要偶尔重试一次，开发效率的提升肉眼可见。

### 这种方法好在哪里？

当然，解决这个问题不止这一种路子。有人选择直接修改底层的 System Prompt，但这通常需要更高的权限或更复杂的配置，一旦不小心改错了其他参数，可能引发新的问题。

相比之下，使用 `AGENTS.md` 的优势在于：

*   **侵入性小**：只需一个文件，不侵入核心配置。
*   **维护简单**：不需要写复杂的脚本或逻辑，一行指令随写随用。
*   **通用性好**：对于大多数基于 Codex 或兼容协议的辅助工具都能生效。

### 如何应用到你的项目中？

如果你正被这个问题困扰，不妨按照下面的步骤试一下：

1.  打开你的工程文件夹。
2.  检查是否存在 `AGENTS.md` 文件（这是很多 AI 编程工具会读取的配置文件）。
3.  如果没有，新建一个。
4.  将 `DO NOT send optional commentary` 粘贴进去，保存。
5.  重新触发你的代码生成任务，静候佳音。

### 总结

面对 AI 工具偶尔的“抽风”，我们往往只能干瞪眼或者去等官方修 Bug。但通过理解模型的行为模式，有时候一个小小的配置调整就能起到四两拨千斤的效果。下次遇到 Codex 变笨或者流口水，记得先看看是不是它话太多了。

希望这个小技巧能帮到正在苦逼改 Bug 的你！