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

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

重大变化

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

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

Anthropic 的2.1.277 版本说明日期为 9 月 18 日，称 Claude Code 会读取AGENTS.md，前提是项目中没有CLAUDE.md。该版本说明还将 Bedrock、Vertex 和 Foundry 排除在此次发布之外。

当前的项目记忆文档还将支持版本安装或升级后的首个会话，以及禁用内置插件的会话排除在外。

Przemek Szypowski 的触发测试报告介绍了他在 2.1.280 版本上开展的金丝雀测试。他报告称，设置DISABLE_TELEMETRY和CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC后，他的AGENTS.md未能加载，而相邻目录中的CLAUDE.md则能正常工作。BIG CHANGE 未复现他在付费模型上的测试。Anthropic 当前文档现已独立说明相同的可用性条件。

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

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

已发布的插件自述文件称，缺少遥测调用时，系统会丢弃相关记录，而不改变插件的其他工作。该仓库的模块概览将遥测和agents-md列为彼此独立的内置插件。

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

9 月 23 日，BIG CHANGE 获取了agents-md README 和注册模块，分别来自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；早期支持版本不会在此处列出它。