仅当遥测打开时，Claude Code 才会读取 AGENTS.md

Claude Code 2.1.277 宣布支持 AGENTS.md 。在没有 CLAUDE.md 的项目中，应该改为读取 AGENTS.md 。我在 shell 中关闭了遥测功能，并且在我的存储库中该文件从未加载。 Issue #95690 解释了原因，并且我添加了自己的测量值。这篇文章将它们收集在一个地方。门在哪里 加载程序作为一个名为agents-md 的内置插件提供。它在 2.1.280 包​​中的注册如下所示： var W = ! 1 ; var B = () => Oa ( "tengu_agents_md_mod" , W ); var H = "AGENTS.md 作为项目说明：默认加载项目没有 CLAUDE.md 的位置；..." ; W 是插件的 isOnByDefault 值，它是 false 。 B 是 isAvailable ，它询问一个名为 tengu_agents_md_mod 的远程功能标志，以 false 作为后备。当 Claude Code 无法获取标志时，插件不可用，并且永远不会读取本地文件。从工作目录读取 markdown 文件根本不需要网络，但这里它等待服务器端交换机。我如何测试它，我创建了一个空目录，其中仅包含一个 AGENTS.md，其中包含一个 canary 单词，并向 claude -p 询问该单词。每个设置都在两个会话中运行，因为新配置中的第一个会话仅获取标志，第二个会话使用它。 echo '金丝雀词是长春花。' > AGENTS.md claude -p '项目说明中的金丝雀词是什么？如果没有，请回答“无”。不要读取文件。正如问题所述，我测量的 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 阻止了该功能。 DISABLE_TELEMETRY=1 也会阻止它。无论设置哪一个变量，AGENTS.md 都不会加载，所以我必须清除这两个变量。将任一变量设置为 0 都没有帮助。该块保持在原位。环境变量文档说任何值都很重要，但是当您尝试打开某个功能时很容易错过这一点。项目 .claude/settings.json 中清除这两个变量的 env 块没有任何效果。无法为单个存储库打开该功能。会话级覆盖确实从第二个会话开始起作用： claude --settings '{"env":{"DISABLE_TELEMETRY":"","CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":""}}' 这些情况都不会打印警告。会话开始，模型在没有项目说明的情况下进行回答，并且没有任何信息告诉您文件已被跳过。该问题还指出第三方网关、Bedrock 和 Vertex 也存在同样的问题，因为该标志也无法解析为 true。解决方法 CLAUDE.md 支持 @path 导入，并且这些导入不依赖于该标志。 AGENTS.md 旁边的一行 CLAUDE.md 会在遥测关闭的情况下加载它： echo '@AGENTS.md' > CLAUDE.md 该文件就位后，相同的金丝雀测试会返回仍设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 的单词。成本是每个存储库一个额外的文件，这是 AGENTS.md 支持应该删除的内容。为什么我认为这是不可接受的，我故意关闭了遥测功能，我希望这个选择只会花费我一些诊断费用，而不会花费任何其他费用。在这里，它默默地花费了我一个从我自己的磁盘读取文件的功能。远程标志对于与服务器通信的功能很有意义，但该功能所需的唯一输入已经在工作目录中。这扇门也击中了最有可能关心 AGENTS.md 的人。为多个代理保留一个指令文件的人通常会小心每个工具发送回家的内容，而 Bedrock、Vertex 或网关上的团队通常会通过策略禁用不必要的流量。他们都获得了一项宣布可用的功能，然后什么也不做。沉默是最糟糕的部分。我用金丝雀词和通过二进制进行字符串搜索确认了原因，大多数人不会这样做。他们会得出结论，模型会忽略他们的指令，并且当文件从未到达模型时，他们会花时间在提示上。隐私设置永远不应该悄悄地关闭不相关的本地行为。如果 Anthropic 想要分阶段推出，则无法获取的标志的后备措施应该是记录的行为，或者至少是一条可见的消息，说明跳过的内容和原因。我希望看到的读取本地文件不应该依赖于遥测。如果必须保留该门以逐步推出，那么当 AGENTS.md 存在并被跳过时启动警告将节省人们在金丝雀测试上花费的时间。全局 AGENTS.md 。该插件仅在项目目录中查找 AGENTS.md 和 .claude/AGENTS.md ，并且用户 CLAUDE.md 旁边没有用户级文件。 Codex 读取一个全局的 ~/.codex/AGENTS.md ，Claude Code 中的 /import 命令可以将其复制到用户 CLAUDE.md 中，但该复制不会跟随后续的编辑。如果您为多个代理保留一组个人指令，则仍然需要在用户 CLAUDE.md 中使用 @ 导入来指向共享文件。对共享代理技能的本机支持。 Codex 从项目中的 .agents/skills 以及主目录中的 ~/.agents/skills 中读取技能。 Claude Code 2.1.280 只知道 /i 中的那些路径