用符号链接让 AGENTS.md 和 CLAUDE.md 共用一份文档今天仍然有效，但没有任何文档为此提供保证

一份说明书喂给两个工具的流行做法

先说这件事和普通上班族有什么关系：很多团队现在靠一套书面规则管住两个 AI 助手，而这套规则今天全靠一个没人担保的”纸条”在撑着。哪天搬家，纸条可能说断就断。

背景是这样的。市面上有工具帮程序员写代码，比如 Claude Code 和 Codex。工具开工前会先读一份说明文件，里面写着”本项目的规矩”。这份文件有两个常见名字：AGENTS.md（给一部分工具看的）和 CLAUDE.md（给 Claude 看的）。内容常常一模一样，于是很多人想了个省事的办法：只写一份，另一份做成”符号链接”。符号链接就是电脑里的便利贴，上面不写内容，只写”真文件在隔壁，去那儿拿”。对使用者来说，两份文件看起来都在，其实只有一份真身。

这个办法目前能用。问题是，它只是今天恰好能用。

查了三处文件，都没有找到担保

我这次实际做了什么？翻了三份公开文档：Claude Code 的变更记录（相当于软件的日记本，改动一条条记在里面）、AGENTS.md 的官方标准页、还有 Codex 的官方说明。我想找一句话，写明”链接这种用法我们支持”。结果没有。

简单说：软件的日记本里从没写过”链接这种用法我们支持”。现在能用，只是相关文件今天还站在原位。哪天软件换了检查方式，链接就可能突然失效。CLAUDE.md 被记录提到 59 次，AGENTS.md 是 0 次，也就是说日记本里从没出现过”我们会直接读那个文件”的痕迹。当然，日记没写不等于一定没做，这一点后面单独说。

测量方法：四组实验，共跑 12 次

为了不只凭印象说话，2026 年 8 月 30 日我在一个隔离的电脑环境里做了实验，全程没有调用 AI 工具本身，只用文档检查和文件操作。

其中一组要测的是：工具规则文件有 32KiB 的大小上限（32KiB（32768 字节）的容量限制），链接的文件在算大小时会不会被当成同一份。这一组三次全部因为环境故障没能测出结果，属于空白。

搬家之后的存活差距

最关键的实验是”搬家”。把整个文件夹从 A 位置搬到 B 位置之后，链接还找得到真文件吗？

结果分三种。便利贴有两种写法：一种写”真文件在我隔壁那间房”，另一种写”真文件在某某路 351 号”。前者是相对路径，跟着整个文件夹一起走，搬家后 3 次尝试全部正常。后者是绝对路径，把搬家前的老地址原样钉死在纸上，搬完家 3 次尝试全部找不到目标，系统报出”文件不存在”的错误。第三种是干脆复制一份真文件，没有链接问题，但从此要维护两份。

这对大部分用电脑的上班族都有关系：只要项目有一天换了位置（换电脑、换服务器、换目录），用绝对路径链接的那份说明书会悄无声息地断掉。

32KiB 大小上限检查停在了哪里

链接的文件到底算不算超长，一次都没测成。原因不是内容问题，是我自己的测试脚本在启动时就报”找不到文件”，三次都死在同一个地方。所以”链接会不会被当成同一个文件来算大小”这个问题，目前既没有证实也没有否定。

本文未能核实的部分

这次没有测的：32KiB 上限下链接的真实行为，以及两个 AI 工具运行时到底会不会顺着链接读文件——本文只查了文字，没有调用过工具本身。还有两个细节没读到上下文：变更记录里 72 次提到链接指的都是什么，标准页里唯一一次出现 symbolicLink（也就是’符号链接’的英文原词）的那句话说的是禁止还是允许。下一步就是把这几个空补上，重跑失败的实验，并读一下那句话的完整内容。

这件事最后落到哪儿

把判断先亮出来：这个流行的共用办法，不是任何厂商承诺过的功能，只是文件今天还站在原位。相对路径的链接跟着文件夹走，绝对路径的链接一搬家就死——这是文件系统本身的规矩，不是谁的设计。另外要诚实一句：查了日记没找到，不能反过来证明一定没有，真正的答案要看软件实际运行时读不读。

什么情况下我会认输：如果 Claude Code 的变更记录里出现了直接读取 AGENTS.md 的条目，或者在 AGENTS.md 标准页或 Codex 文档里找到一句明确担保链接用法的文字，上面的结论就得收回。本文只依据 2026-08-30 那天的文档快照和文件测量。

最后给你两条具体建议。想退出的人：如果链接断过一次，要么换成”跟着文件夹走”的那种写法，要么干脆复制一份真文件，不要再赌便利贴。想引入的人：如果打算把这套做法定成团队规矩，规矩里别写死”用链接”这一步。可以改用一个自动程序负责创建链接，并且每天检查它还通不通。谁担保谁负责。

参考资料

1. Claude Code CHANGELOG (raw scan target) — Anthropic (raw.githubusercontent.com)
2. AGENTS.md spec page (symlink 규정 부재 확인 대상) — agents.md
3. Codex 공식 문서·README (symlink·한도 규정 부재 확인 대상) — OpenAI