Claude Code 新增 AGENTS.md 支持：无 Claude.md 时自动读取

变更要点

根据 Claude Code 官方更新日志，Claude Code 现在会在项目根目录不存在 Claude.md 文件的情况下，自动读取 AGENTS.md 作为项目级指令文件。这一改动意味着使用 AGENTS.md 作为约定文件名的项目，无需再额外维护一份 Claude.md 副本即可让 Claude Code 获得项目上下文。来源

AGENTS.md 是近一年在 AI 编码工具社区中逐渐流行起来的一种约定，用于向各类编码代理（coding agent）描述项目的结构、构建命令、代码风格与注意事项。此前不同工具各用各的文件名，导致同一仓库中可能出现多份内容重复的配置文件。

社区反应

该更新在 HackerNews 上获得了 726 点与 273 条评论，是近 90 天内与 Claude 相关讨论热度最高的帖子之一。来源

另一条来自社交平台的讨论帖「Anthropic finally adds AGENTS.md support to Claude Code」同样在当天发布，获得 52 点、10 条评论，标题中的「finally」一词反映出部分开发者对这一支持已经期待了一段时间。来源

从评论热度来看，社区关注点主要集中在两个方面：一是文件名统一带来的配置收敛，二是当 Claude.md 与 AGENTS.md 同时存在时的优先级与合并行为。官方文档目前给出的规则是「无 Claude.md 时才读取 AGENTS.md」，即 Claude.md 仍然优先。

对现有项目的影响

对于已经在仓库中维护 Claude.md 的团队，本次变更不会产生破坏性影响，原有文件继续生效。对于同时维护多套 AI 编码工具配置的团队，则可以考虑将通用指令迁移到 AGENTS.md，再按需保留工具专属的补充文件，从而减少重复维护成本。来源

需要注意的是，项目级指令文件的加载行为通常还受到目录层级、文件位置以及工具版本的影响。在将配置迁移到 AGENTS.md 之前，建议先确认当前使用的 Claude Code 版本已包含该变更，并在实际仓库中验证指令是否被正确读取。

小结

本次更新属于配置层面的兼容性改进，本身不涉及模型能力变化，但降低了多工具并行使用时的配置维护负担。考虑到 AGENTS.md 在社区中的接受度持续上升，Claude Code 跟进这一约定有助于减少项目中的重复文件。后续值得关注的是，当多份指令文件共存时，各工具是否会形成更一致的优先级规范。

以上整理自 HackerNews 公开讨论，原帖见上方链接