Markdown 版本

AI-translated from English; not yet reviewed by a fluent editor.

# 关闭遥测时，Claude Code 可能不会加载 AGENTS.md

> Claude Code 原生支持 AGENTS.md 取决于版本、功能标记访问权限、服务提供方和文件优先级。已发布的 agents-md 插件自身的遥测记录不包含文件路径或文件内容。

By BIG CHANGE Editorial

Published: 2026-09-23T13:54:58.721Z
Updated: 2026-09-23T13:54:58.721Z
Canonical: https://bigchange.ai/blog/claude-code-agents-md-telemetry-feature-flags

![A desktop monitor shows a minimal project-instructions view with plain AGENTS.md and CLAUDE.md labels above a keyboard and mouse.](https://bigchange.ai/api/media/file/claude-code-project-instructions-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

Claude Code 2.1.277 为仓库指令增加了原生支持，可加载`AGENTS.md`。该功能有个重要限制：Anthropic 当前文档称，无法获取功能标记的会话（包括关闭遥测的会话及许多第三方服务提供方配置）只会加载`CLAUDE.md`。

已发布的`agents-md`插件会将文件加载与可选的遥测记录分开。遥测记录只包含计数和固定选项，不含路径或文件内容。依赖发生在更早一层：远程功能标记决定内置加载器是否可用。

## 重大变化

- **变化内容：**本地指令文件如今受到远程发布机制影响：能否访问功能标记，决定 Claude Code 内置的`AGENTS.md`读取器是否可用。
- **为何重要：**即使两个开发者使用同一提交，由于版本、服务提供方或隐私设置不同，他们接收的项目指令也可能不同，使团队更难复现智能体行为。
- **关注事项：**使用多个服务提供方或严格管控环境的团队，可以将指令加载视为运行时依赖，在每种配置中验证，并保留一个`CLAUDE.md`作为可移植方案。

## 正式发布说明和报告证实了什么

Anthropic 的[2.1.277 版本说明](https://github.com/anthropics/claude-code/releases/tag/v2.1.277)日期为 9 月 18 日，称 Claude Code 会读取`AGENTS.md`，前提是项目中没有`CLAUDE.md`。该版本说明还将 Bedrock、Vertex 和 Foundry 排除在此次发布之外。

当前的[项目记忆文档](https://code.claude.com/docs/en/memory)还将支持版本安装或升级后的首个会话，以及禁用内置插件的会话排除在外。

Przemek Szypowski 的[触发测试报告](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on)介绍了他在 2.1.280 版本上开展的金丝雀测试。他报告称，设置`DISABLE_TELEMETRY`和`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`后，他的`AGENTS.md`未能加载，而相邻目录中的`CLAUDE.md`则能正常工作。BIG CHANGE 未复现他在付费模型上的测试。Anthropic 当前文档现已独立说明相同的可用性条件。

## 功能可用性与遥测记录彼此独立

Anthropic 的[环境变量文档](https://code.claude.com/docs/en/env-vars)表示，任何非空的`DISABLE_TELEMETRY`值（包括`0`或`false`）都会退出遥测并禁用功能标记获取。`DO_NOT_TRACK`、`DISABLE_GROWTHBOOK`和`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`也可能阻止获取。除非嵌入式宿主设置`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`，否则第三方服务提供方会话不在适用范围内；Claude 应用网关会话也被排除。

已发布的[插件自述文件](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md)称，缺少遥测调用时，系统会丢弃相关记录，而不改变插件的其他工作。该仓库的[模块概览](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md)将遥测和`agents-md`列为彼此独立的内置插件。

源码描述的是运行中的加载器；产品文档说明会话是否能获得该加载器。模块内部的可选日志记录不会消除模块外部的可用性条件。

9 月 23 日，BIG CHANGE 获取了`agents-md` README 和[注册模块](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts)，分别来自`main`主分支和 2.1.280 标签（9 月 22 日发布）；每一对文件的字节内容完全一致。

## Claude Code 何时加载文件

对于插件可用且已启用的会话，默认模式遵循以下优先级：

| 指令文件 | 默认结果 |
| --- | --- |
| `AGENTS.md`，项目中没有 Claude 指令文件时 | `AGENTS.md`会加载 |
| 项目级`CLAUDE.md`或`.claude/CLAUDE.md`位于当前工作目录及其上级目录中的文件`CLAUDE.local.md`直接 | 加载会让位于这些文件`AGENTS.md`用户级或托管级设置 |
| 或`CLAUDE.md`这些设置不会取代`.claude/rules/` | 在`AGENTS.md` |

中更改项目指令`/config`可同时加载两类文件。对应 JSON 选项应设在用户级、`--settings`或托管设置中；项目级和本地设置文件会被忽略。

## 备用方案：显式导入

对于不支持直接加载的会话，Anthropic 建议在共享指令文件旁放置一个`CLAUDE.md`，其中包含：

`@AGENTS.md`

导入会包含该文件；只用文字要求 Claude 读取，则会把是否读取留给模型决定。

检查`claude --version`和`/config`中的项目指令。在 2.1.280 版中，`/memory`或`/context`可以列出直接加载的`AGENTS.md`；早期支持版本不会在此处列出它。

## Sources

- [Claude Code 关闭遥测时可能跳过 AGENTS.md](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) — Przemek Szypowski 报告的 2.1.280 金丝雀测试和备用方法。BIG CHANGE 未复现付费模型测试；本文将其观察与官方产品文档及源码解读区分开来。
- [Claude Code 2.1.277 版本说明](https://github.com/anthropics/claude-code/releases/tag/v2.1.277) — 官方发布记录，说明了 AGENTS.md 支持的推出，以及发布时不适用于 Bedrock、Vertex 和 Foundry 的限制。
- [Claude 如何记住你的项目](https://code.claude.com/docs/en/memory) — 当前官方文档介绍了最低版本、文件优先级、项目指令模式、不可用会话条件、诊断方法及 CLAUDE.md 导入备用方案。
- [Claude Code 环境变量](https://code.claude.com/docs/en/env-vars) — 当前官方文档说明，退出遥测也会禁用功能标记获取，因此无法直接加载 AGENTS.md；文档还列出其他受影响的会话。
- [Claude Code 2.1.280 版 agents-md 内置源码和行为](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) — 已发布源码说明指令文件模式、优先级和可选遥测记录；记录只含计数和固定选项，不含路径或文件内容。
- [Claude Code 2.1.280 版内置 mods](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) — 已发布的概览说明遥测和 agents-md 是彼此独立的内置插件，带标签的源码随 Claude Code 一同发布。
- [Claude Code 2.1.280 版 agents-md 注册模块](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) — 与自述文件一同检查的已发布注册源码。2026 年 9 月 23 日查阅时，其字节内容与 main 分支上的对应文件一致。