AGENTS.md 和 CLAUDE.md 只能二选一？Claude Code 实测：两个都在时只读 CLAUDE.md，11 月 1 日实测版

仓库里同时有 AGENTS.md 和 CLAUDE.md，Claude Code 到底读哪一个？AI Parabellum 在 11 月 1 日用 Claude Code v2.1.312 实测了三种情况：只有 AGENTS.md 时读它；两个都有时只读 CLAUDE.md，AGENTS.md 会被直接跳过；想让两个都生效，在 CLAUDE.md 首行加一行 @AGENTS.md 导入，规则就都进来了。

最容易踩的坑是：团队给仓库补一个小 CLAUDE.md，以为只是加几句 Claude 专属说明，结果整份 AGENTS.md 停止加载，之前定的构建命令和代码风格全都不见了。另外个人笔记别放进 AGENTS.local.md 或 AGENTS.override.md，这两个名字 Claude Code 不读，要放 CLAUDE.local.md；也可以在会话里输 /config，把 Project instructions 改成 claude-md-and-agents-md，让它两个文件都读。

自己验证也不难：建个临时文件夹，AGENTS.md 写“函数名加 bc_ 前缀、结尾写 BEANS-OK”，CLAUDE.md 写“结尾写 MOCHA-OK”，然后问一句“我的项目指令要求什么签收词和函数名前缀？回答一行，别读文件”，看回来的词就知道它读了谁。注意先确认版本在 v2.1.277 以上，老版本还读不了 AGENTS.md。相关阅读：Claude Code 的 MCP 配置文件到底在哪、Claude Code 会话历史怎么清。

来源：AI Parabellum，原文：https://aiparabellum.com/agents-md-vs-claude-md/