Claude Code 增加 AGENTS.md 作为项目指令的后备选项

如果没有 CLAUDE.md，Claude Code 现在会读取 AGENTS.md —— 这是一项期待已久的符合标准的变化

Claude Code 2.1.277（发布于 2026 年 9 月 18 日）增加了一个简单但影响深远的功能：当项目目录中不存在 CLAUDE.md 文件时，CLI 会自动回退到读取 AGENTS.md 作为其指令集。该更改可在 /config 中的 Project instructions 下进行配置，目前尚未在 Bedrock、Vertex 或 Foundry 部署中提供。

为什么这很重要

符合标准的配置 – AGENTS.md 是社区描述代理、技能和项目级提示词的事实标准。通过开箱即用地支持它，Claude Code 消除了迫使用户维护重复文件或符号链接的专有怪癖。
减少摩擦 – 开发人员现在可以删除许多为了向后兼容而保留的 CLAUDE.md → AGENTS.md 符号链接。已经使用 AGENTS.md（或较新的 .agents/ 布局）的项目无需额外步骤即可工作。
响应能力的信号 – 此更新紧随社区呼吁与更广泛的 AI 工具标准保持一致的反馈浪潮之后。它表明 Anthropic 正在倾听开发者的意见，而不是强加自己的文件命名方式。

更新日志内容

增加了对 AGENTS.md 的支持：在没有 CLAUDE.md 的项目中，Claude Code 会读取 AGENTS.md；可在 /config 中的“Project instructions”下进行更改（尚未在 Bedrock、Vertex 或 Foundry 上提供）

该功能是一个纯粹的只读后备方案；它不会改变 Claude Code 在 .agents/skills 或其他自定义目录下发现技能的方式。它仅仅是在 CLAUDE.md 缺失时替换系统提示词的来源。

Hacker News 上的社区反应

评论者	态度	关键点
@askonomm	正面	“终于做了一些符合标准的事情，而不是强迫用户使用专有工作流。”
@neverrroot	正面	“谢谢你们，你们做了正确的事。”
@bcorigliano	正面	“终于！！我们需要行业范围的标准。”
@stillpointlab	观察	指出 Claude Fable 已经创建了 `AGENTS.md` 和指向它的符号链接，暗示此更改可能是由自动项目脚手架触发的。
@TomGarden	中立	对此举表示赞赏，但称其为“绝对的最低限度”，并删除了现有的符号链接。
@mococa	批评	认为此更改仅仅是对社区愤怒的反应，而不是真正关心开发者。
@mitchitized	批评	声称较新的逻辑现在优先考虑 `settings.json` 而不是 `CLAUDE.md`，可能会覆盖用户提供的指令。
@aroman	实用	“终于，我可以删除 `sync-agent-docs.sh` 了，它之前递归地将 AGENTS.md 符号链接到 GEMINI.md 和 CLAUDE.md……”
@bluestein	幽默	“AGENTS.md 是新的 autoexec.bat。”
@chr15m	正面	“这只是显而易见的、非愚蠢的做法，就像苹果改用 USB-C 一样。”
@perganomoly	负面	“花了这么长时间才添加这样一个基本功能，简直是耻辱。”

总的来说，社区将此更改视为一种必要的修正，而非开创性的创新。许多用户表示很高兴不再需要符号链接，而少数人对 Anthropic 的动机保持怀疑。

如何使用新的后备功能

确保 AGENTS.md 位于项目根目录（或 Claude Code 扫描项目指令的子目录中）。
删除您之前用作指向 AGENTS.md 的任何 CLAUDE.md 文件或符号链接。
如果需要自定义查找位置，请编辑 /config 文件中的 Project instructions 部分：
```
{
  "projectInstructions": {
    "fallbackFile": "AGENTS.md"
  }
}
```
运行 claude --version 以确认您使用的是 2.1.277 或更高版本。

什么没有改变？

技能加载 – Claude Code 仍然不会自动从 .agents/skills 目录加载技能。这仍然是一个单独的功能请求。
Bedrock/Vertex/Foundry – 该后备功能目前在这些平台上不可用；它们仍然需要 CLAUDE.md。
现有项目 – 已经包含这两个文件的项目将继续优先使用 CLAUDE.md，除非您将其删除。

总结

Claude Code 增加 AGENTS.md 作为后备指令文件，消除了一个长期存在的摩擦点，使该工具符合社区惯例，并展示了 Anthropic 根据开发者反馈进行调整的意愿。虽然这一变化很小，但它是在可用性和标准合规性方面的一次明确胜利。