9 月 18 日，Claude Code 发布 2.1.277 版，GitHub 发布页的时间戳是当天 18 时 06 分，更新日志里的一条在 Hacker News 上刷了屏。项目里没有 CLAUDE.md 时，Claude Code 会改为读取 AGENTS.md。一行字的事，社区等了一年多，GitHub 上的功能请求帖攒了四百条评论。我把官方更新日志、memory 文档和开源的实现代码都看了一遍，这篇把新行为和配置要点说清楚。
主要功能
AGENTS.md 是一个跨工具的开放标准，定位是给 AI 编程代理看的 README，由 OpenAI Codex、Google Jules、Cursor、Amp 等工具在 2025 年联合发起，现由 Linux 基金会旗下的 Agentic AI Foundation 管理。官网称已有六万个开源项目采用（自称），支持它的工具列了 23 个，包括 Gemini CLI、Aider、VS Code、Warp、GitHub Copilot coding agent。格式就是普通 Markdown，没有必填的 frontmatter，monorepo 里可以放多份，离文件最近的一份优先生效。
Claude Code 此前只认自家的 CLAUDE.md，想在多个代理工具间共享项目规则，得靠软链接或者 import 的小技巧绕。官方文档过去长期明写不读 AGENTS.md，还给过这两种绕行方案，这次更新后文档已同步改写，网上旧教程的说法可以更新了。2.1.277 之后，没写 CLAUDE.md 的项目直接读 AGENTS.md，社区呼吁的统一配置这件事算是落地了。
社区等这一天的证据很充分。GitHub 上的功能请求 issue #6235 从 2025 年 8 月开到关闭，攒下约四百条评论，后续的 #34235 仍开放，请求全局位置 ~/.agents/AGENTS.md 的 #62371 已标记完成。
配置要点
优先级规则要记牢。同一个目录下两份文件都在，CLAUDE.md 赢，AGENTS.md 只做备胎。查找范围与 CLAUDE.md 相同，从当前目录一路向上到仓库根，离被编辑文件更近的文件优先。注意只有项目级，用户级的全局配置仍然只有 ~/.claude/CLAUDE.md 一处，AGENTS.md 没有用户级位置。
文件内容怎么写。普通 Markdown 文本就是规则正文，支持用 @路径 的语法引入其他文件，最多递归五层，代码块里的 import 不会执行。frontmatter 里官方认可的有效键只有 mixins 和 permissions，写别的键会被忽略。还有个细节，小写文件名 agents.md 不会被读取，大小写要写对。
写什么最有效有章法。构建与测试命令、目录职责、代码风格约定、提交规范，这些代理每次都要问的信息值得前置。动辄几千字的叙述反而稀释重点，控制在两百行以内，条目比段落管用。
行为开关在 /config 的 Project instructions 一项。开源实现显示这个设置叫 instructionFiles，可选只读 CLAUDE.md、读 CLAUDE.md 失败后转 AGENTS.md（默认）、两份都读、只读受管文件四种模式，旧配置键 projectInstructions 依然兼容。迁移期不妨选两份都读的模式，新旧规则并行生效，等内容搬完再切回默认。对应的实现模块 mods/agents-md 已经开源，感兴趣的可以去看源码。
解决了什么需求
Hacker News 上的反应能看出这功能的分量。用户 askonomm 说，终于做了件符合标准的事，不用再强迫用户进专属工作流。vindex10 调侃这是跑去 OpenAI 仓库借来的第一个功能，玩笑归玩笑，这个标准由 Codex 阵营发起是事实。sync 指出这次实现随 Claude Code mods 机制一起开源了。hbarka 则担心自己搭的脚手架要跟着改，这条提醒有实际意义，依赖 CLAUDE.md 缺失行为做判断的脚本需要回归测试。
对多工具用户来说收益直接。一份 AGENTS.md 写好项目规范、命令约定、测试入口，Codex、Gemini CLI、Claude Code 读的都是同一份，改一处全体生效，不用维护多套说明文件。
注意事项
几个边界先知道。Bedrock、Vertex、Foundry 这三个企业渠道暂时拿不到这个特性，官方日志写明了。2.1.277 之前的版本不读 AGENTS.md，团队里有人用旧版就得保留 CLAUDE.md。已有两个 bug 被报告，root 目录的 AGENTS.md 在会话开始时可能不会自动加载（issue #89825），worktree 场景下相对路径往返可能造成重复注入（issue #87824），遇到怪行为先查这两条。
费用方面无新增，Claude Code 包含在所有付费订阅里，Pro 每月 20 美元，Max 档从 100 美元起，团队版每人每月 25 美元，重度用户也可以转控制台按 API 用量计费。
总结
一个标准文件名，换来各家代理工具的通用入口，这类小改动省下的是每个项目里重复维护说明文件的时间。已经写 CLAUDE.md 的项目不必动，新项目从 AGENTS.md 起步，以后换工具零成本。把大小写、优先级、企业渠道限制这三点记住，配置就不会踩坑。
来源
- Claude Code 官方更新日志 https://code.claude.com/docs/en/changelog
- 官方 memory 文档 https://code.claude.com/docs/en/memory
- v2.1.277 GitHub 发布页 https://github.com/anthropics/claude-code/releases/tag/v2.1.277
- 实现 PR #95409 https://github.com/anthropics/claude-code/pull/95409
- AGENTS.md 标准官网 https://agents.md/
- 功能请求 issue #6235 https://github.com/anthropics/claude-code/issues/6235
- 加载 bug #89825 https://github.com/anthropics/claude-code/issues/89825
- Hacker News 讨论 https://news.ycombinator.com/item?id=49760187
- Claude 订阅价格 https://claude.com/pricing