实测发现 Claude Code 仅在开启遥测功能时才会读取 AGENTS.md 配置文件

开发者实测与 GitHub 议题反馈显示，Claude Code 对跨智能体标准配置文件 AGENTS.md 的读取支持依赖于远程特性开关，在关闭遥测时会导致该文件被静默忽略。

• 机制发现：根据开发者博客 blog.szypowi.cz（2026-09-23）及官方代码库 Issue #95690（2026-09-20）记录，自 2.1.277 版本起内置的 agents-md 插件受远程配置开关控制，默认处于未激活状态。
• 离线失效：当开发者设置 DISABLE_TELEMETRY=1 或禁用非必要网络流量时，客户端无法拉取远程标志位，会在无报错和提示的情况下直接跳过本地 AGENTS.md。
• 替代方案：在官方提供纯本地读取支持前，开发者可在项目根目录创建单行 CLAUDE.md 并写入 @AGENTS.md，借助本地文件引用机制绕过远程开关限制。
• 影响/看点：这一机制使得注重隐私或在内网隔离环境中工作的开发团队可能在不知情时丢失智能体提示词配置，依赖该特性的团队需要通过显式文件引用或等待官方解耦远程开关来保证配置生效。
• 资料依据:
• blog.szypowi.cz（2026-09-23）：https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on/
• GitHub anthropics/claude-code（2026-09-20）：https://github.com/anthropics/claude-code/issues/95690

本内容由 AI 生成，仅供参考，请注意甄别