
在一个已经接入多种编码代理的仓库里,最容易出现的混乱不是模型不会写代码,而是每个工具都有一份自己的说明文件。Codex 读AGENTS.md,Cursor 可能还有.cursorrules,Windsurf 可能有.windsurfrules,Claude Code 又主要读取CLAUDE.md。这些文件一多,团队很快会遇到一个老问题,同一条规则在不同文件里写了三遍,过了两个月,其中一份改了,另外两份没改,最后 Claude Code、Codex、Cursor 得到的项目上下文开始分叉。Claude Code 这里有一个很关键的事实,Claude Code 读取的是CLAUDE.md,不是AGENTS.md。Anthropic 官方文档把这一点写得很直接,如果仓库已经用AGENTS.md给其他 coding agent 提供指令,更推荐创建一个CLAUDE.md,在里面导入AGENTS.md,这样两类工具可以共享同一份基础规则,而不是复制粘贴两份内容。Claude Code 会在 session start 的时候加载被导入的文件,再把CLAUDE.md里剩余的内容追加到上下文后面。(Claude