关掉遥测后 AGENTS.md 可能不加载

开发者在 Claude Code 2.1.280 里测得:关掉遥测或非必要流量后,AGENTS.md 插件等不到远程开关,本地文件被静默跳过。用一行 CLAUDE.md 引入 @AGENTS.md 可以绕开。2.1.281 说明未写移除该开关。

关掉遥测后 AGENTS.md 可能不加载

Claude Code 2.1.277 写过:项目里没有 CLAUDE.md 时,改为读取 AGENTS.md,并注明当时还没有落到 Bedrock、Vertex 和 Foundry。2026 年 9 月 23 日,Marek Šuppa 在博客里记录了另一条限制。claude code agents.md 遥测 关掉之后,这份本地文件可能根本不会被读,而且没有警告。他对照的包是 2.1.280。

作者CodePass 技术编辑

他测到的开关

博客写,加载器是内置插件 agents-md。在 2.1.280 的包里,isOnByDefault 为 false,是否可用要问远程功能开关 tengu_agents_md_mod,取不到开关时按 false。因此读一份已经在工作目录里的 markdown,仍要等一次网络结果。

他的测法是空目录里只放一份含暗号的 AGENTS.md,用 claude -p 问这个词,并要求不要去读文件。每种配置跑两轮,因为第一轮往往只去取开关。结果是:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1DISABLE_TELEMETRY=1 都会挡住加载。把变量设成 0 仍然挡住,他转述环境变量文档的说法是任意值都算打开。项目 .claude/settings.json 里用 env 清掉这两个变量没有用。会话级可以:

claude --settings '{"env":{"DISABLE_TELEMETRY":"","CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":""}}'

他写这从第二次会话起生效。Bedrock、Vertex 和第三方网关同样取不到值为 true 的开关。这些是他的测量和 issue 的转述,不是 Anthropic 发行说明里的原句。2.1.277 只写了这三个平台「尚未支持」,没有写遥测变量。

发行说明还没写修好

2.1.280 和 2.1.281 的 What's changed 里没有「AGENTS.md 不再依赖遥测」这一条。不能把博客标题里的讨论当成已经发布的修复。在说明写明之前,他给出的绕法是一行 CLAUDE.md

echo '@AGENTS.md' > CLAUDE.md

他测得在 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 仍设置时,暗号能被答出来。@ 导入不走那个远程开关。代价是每个仓库多一个文件,而 2.1.277 宣布的能力本来是为了不必再维护 CLAUDE.md。已有的回退说明见 2.1.277 读取 AGENTS.md。那篇按发行说明写「没有 CLAUDE.md 就读 AGENTS.md」。遥测关掉时的静默跳过,是这篇补上的测量,两篇要一起看。

参考资料