Anthropic 的 Claude Code changelog 里，2.1.277 版（2026 年 9 月 18 日）加了一行开发者等了很久的更新：「Added AGENTS.md support —— 项目中没有 CLAUDE.md 时，Claude Code 改为读取 AGENTS.md」，可在 /config 的 Project instructions 里切换；并注明 Bedrock、Vertex、Foundry 上暂不支持。这条改动在 Hacker News 上一天内就聚了几百条评论，多数人的反应是「终于不用写三遍了」。
关键事实
| 项目 | 内容 |
|---|---|
| 回答的问题 | Claude Code 开始读 AGENTS.md 了 |
| 简答 | Claude Code 2.1.277 加入 AGENTS.md 支持：项目里没有 CLAUDE.md 时改读 AGENTS.md，可在 /config 的 Project instructions 里切换。本文说清这条改动的实际意义，以及你自己的指令文件里该写什么。 |
| 阅读时长 | ~2 分钟 |
| 最后更新 | 2026-09-20 |
为什么「统一成一个文件」比听起来重要
AGENTS.md 是放在项目根目录的纯 Markdown 文件，用来告诉编码智能体在这个项目里该怎么做事：跑什么命令、遵循什么约定、避开什么。它被提出来的原因很朴素——每个客户端都想要自己的指令文件，于是同一套项目规则，团队得维护三份。
Claude Code 采用同一个文件，意味着你已经写好的规则继续有效。这在 changelog 上只是一行，但对任何「一个仓库被多个智能体碰」的团队来说，差别很大。
两个值得读第二遍的细节
- CLAUDE.md 仍然优先。AGENTS.md 只是没有 CLAUDE.md 时的回退读取。两个都留 = 两份真相来源，建议指定一个为准、另一个指向它。
- 还没全平台覆盖。changelog 明说 Bedrock、Vertex、Foundry 暂不支持，用这些平台的团队别按「有回退」来做计划。
- 它是契约，不是人设。指令文件最有用的时候，写的是可验证的规则（「提改动前先跑
npm test」），而不是感觉。
你自己的指令文件里该写什么
如果你跑的是碰你自己电脑而不是碰仓库的智能体，指令文件同样是写边界的好地方：
- 范围 —— 允许读写的文件夹。写明排除哪些，比写明包含哪些更重要。
- 硬性停手 —— 必须永远先问的动作：删除、移出项目目录、对外发送、花钱。
- 汇报 —— 什么算「完成」，以及「改了什么的记录」放在哪里。
但要说清楚：文件负责表达期望，它不是执行机制。在桌面智能体上，兜底的是审批关卡加操作日志——指令说明应该怎么做，关卡保证它真的这么做。
MOOGH 在 Windows 上就是按这个分工做的：任务计划先摆给你看，执行等你批准，事后历史可回读。下载 MOOGH，让文件负责写规则，让别的机制负责兜底。
相关阅读：