Claude Code 新增 AGENTS.md 支持

如果没有 CLAUDE.md，Claude Code 会读取 AGENTS.md

核心要点： 从 2026 年 9 月 18 日的版本开始，当项目中缺少 CLAUDE.md 时，Claude Code 会回退到读取 AGENTS.md 文件。这一变更消除了强制步骤，让用户可以保持指令文件的平台无关性，并使 Claude Code 与社区对标准代理定义格式的期望保持一致。

为什么这一变更很重要

降低使用门槛 – 之前每个 Claude Code 项目都必须在仓库根目录下包含一个 CLAUDE.md。偏好更通用的 AGENTS.md（或从其他工具迁移过来）的用户不得不创建符号链接或复制文件。新的回退机制消除了额外的维护负担。
与新兴规范保持一致 – 多位开发者倡导使用中立的 AGENTS.md 名称，使其在 Claude、Codex、Gemini 以及其他 AI 代码助手之间通用。Anthropic 通过原生支持 AGENTS.md，表明其对社区标准的响应能力。
更整洁的项目结构 – 项目现在可以仅保留一份代理指令的单一来源，而无需在仓库中充斥符号链接或重复文件。

发布说明原文

2026 年 9 月 18 日 – 新增 AGENTS.md 支持：在没有 CLAUDE.md 的项目中，Claude Code 会改读 AGENTS.md；可通过 /config 中的“项目指令”进行修改（目前尚未在 Bedrock、Vertex 或 Foundry 上提供）。

此变更仅限 CLI 和 VS Code 扩展；Bedrock、Vertex 或 Foundry 上托管的云端 Claude Code 会话将在后续更新中获得该功能。

Hacker News 社区反馈

评论者	情绪	关键观点
@askonomm	积极	“终于开始做符合标准的事，而不是强迫用户使用专有流程。”
@stillpointlab	观察性	指出 Claude Fable 会自动创建 `AGENTS.md` 及其符号链接，暗示该工具早已推断出中立文件的必要性。
@neverrroot	积极	“谢谢各位，你们做对了。”
@bcorigliano	积极	庆祝向行业级标准迈进。
@TomGarden	中立	赞赏这一变更，但称此前的要求“已是最低限度”。
@mococa	批评	认为该变更来得太晚，标准本应更早采纳。
@clutter55561	警示性	提醒用户 Claude Code 仍无法检测 `.agents/skills` 中的技能。
@aroman	实用性	“终于，我可以删除 `sync-agent-docs.sh` 了，它会递归地将 `AGENTS.md` 链接到 `GEMINI.md` 和 `CLAUDE.md`……”
@jtbaker	幽默	分享一篇新闻文章，引用 Shopify 首席执行官表示可能在 Claude Code 尊重 `AGENTS.md` 前禁止其使用。
@mitchitized	怀疑	声称该变更更像是对社区压力的反应，而非真正关心开发者体验。
@perganomoly	失望	“如此基础的功能竟然拖了这么久才加入，令人羞愧。”
@albatross79	讽刺	称 Claude Code “臃肿”，并怀疑它永远无法真正尊重 `AGENTS.md` 的指令。

总体而言，情绪极为积极，大多数评论者欢迎这一简化，并视其为迈向更广泛互操作性的一步。

如何使用新行为

在项目根目录（或你工作的任意子目录）创建 AGENTS.md。使用与 CLAUDE.md 中相同的指令语法。
删除 CLAUDE.md 文件 或保持其不存在。Claude Code 会自动检测并加载 AGENTS.md。
（如需）通过 /config 面板下的 项目指令 配置回退路径 – 此设置目前仅在 CLI 和 VS Code UI 中可用，尚未在 Bedrock/Vertex/Foundry 部署中提供。
验证：运行 claude --version，然后启动会话；启动日志将显示“Reading project instructions from AGENTS.md”。

以下内容不会改变

技能加载 – Claude Code 仍然不会自动从 .agents/skills 目录加载技能。用户仍需显式注册技能，或依赖现有的 skills/ 机制。
云端会话 – 该回退机制尚未在 Bedrock、Vertex 或 Foundry 实例上启用；这些平台将在后续补丁中获得更新。
旧版行为 – 如果 CLAUDE.md 和 AGENTS.md 同时存在，CLAUDE.md 仍具有优先级，以确保现有项目的向后兼容性。

现有项目的快速检查清单

删除所有指向 CLAUDE.md → AGENTS.md 的符号链接。
确保 AGENTS.md 包含你所需的所有代理指令。
测试一次全新的 Claude Code 会话，确认文件已被正确读取。
更新内部文档，将 AGENTS.md 作为标准指令文件进行引用。

总结

Claude Code 新增的 AGENTS.md 回退支持是一项虽小但意义重大的体验改进。它消除了不必要的文件，尊重了跨多个 AI 代码助手通用的命名规范，并展示了 Anthropic 倾听开发者反馈的意愿。该功能已在 CLI 和 VS Code 扩展中上线，社区反响表明，这将被视为 AI 辅助开发生态中迈向更广泛标准化的重要一步。