禁用遥测的 Claude Code 用户可能需要确认,他们的项目指令是否确实传递给了模型。Przemysław Szypowicz 在 2026 年 9 月 23 日的报告中表示,当设置 DISABLE_TELEMETRY=1 或 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 时,Claude Code 2.1.280 没有读取 AGENTS.md。他的测试在 AGENTS.md 中放置了一个金丝雀词,并让一个全新的 Claude Code 会话在不读取其他文件的情况下返回该词。

标识报告所讨论产品的 Claude AI 标志
Claude AI 标志;本文关注 Claude Code 的指令加载。ja.wikipedia.org

放在开头段落之后,因为报告涉及 Claude Code 及其 AGENTS.md 行为。

报告所述机制比一般性的遥测故障更具体。Szypowicz 表示,AGENTS.md 加载器是一个内置插件,其默认启用状态为 false,并且是否可用取决于一个名为 tengu_agents_md_mod 的远程 Statsig 功能开关。如果该开关无法解析为 true,插件便不可用,本地 Markdown 文件也不会被读取。这意味着,即使只是打开工作目录中的文件这一纯本地操作,也可能受到影响,尽管该文件本身并不需要网络访问。

anthropics/claude-code 仓库中提交的 GitHub 问题独立记录了同样的高层担忧:其中描述称,Claude Code 2.1.277 引入的 AGENTS.md 支持位于一个默认关闭的远程开关之后,禁用遥测的配置以及部分第三方路由无法评估该开关。该问题由用户报告,目前仍是一份报告,而不是 Anthropic 已确认的诊断;不过,由于它托管在该产品的公共仓库中,并描述了相同的观察结果,因此是相关的补充背景。

对于管理多个仓库的读者来说,实际问题是隐私设置是否会意外改变模型能够看到的指令。根据 Szypowicz 的说法,该故障是静默发生的:Claude Code 会启动并作答,但不会警告 AGENTS.md 被跳过。这在操作上很重要,因为用户可能会花时间修改提示或调试模型行为,而缺失的上下文实际上从未进入会话。所供证据并不能确定这种情况发生的频率、哪些 Claude 模型受到影响,或每种部署路径的表现是否完全一致。

报告指出一种变通方案:在 AGENTS.md 旁边放置一个 CLAUDE.md 文件,并在其中写入单个导入行 @AGENTS.md。Szypowicz 表示,即使 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 仍然启用,这也会加载相同的指令,因为 CLAUDE.md 导入不依赖所报告的远程功能开关。代价是,团队需要重新保留 AGENTS.md 原本旨在避免的额外文件。证据还显示,通过项目级 .claude/settings.json 的 environment 块清除这些变量并没有帮助,而从第二次会话开始,会话级覆盖可以生效。

源材料没有包含 Anthropic 确认这些实现细节或确定修复版本的声明,因此最稳妥的结论比标题所暗示的范围更窄:在受测的 Claude Code 2.1.280 环境中,AGENTS.md 加载似乎取决于一个远程开关,而遥测控制可能阻止该开关成功解析。依赖 AGENTS.md 的用户应使用无害的金丝雀指令测试自己的配置,检查 CLAUDE.md 导入是否会改变结果,并避免默认认为文件存在就一定意味着它已被读取。