重要：Claude Code reads AGENTS.md only when telemetry is on [fixed]

Claude Code 的 AGENTS.md 支援在 Hacker News 引發大量討論：一篇技術文章指出，Claude Code 2.1.277 新增的 AGENTS.md 專案指令讀取功能，實際上會受到遠端 feature flag 與 telemetry / nonessential traffic 設定影響。當使用者關閉相關流量時，本機 AGENTS.md 可能會被靜默略過。

根據原文測試，Claude Code 在沒有 CLAUDE.md 的專案中理應讀取 AGENTS.md。但作者在只放置 AGENTS.md 的空目錄中，以 canary word 測試後發現，若環境變數 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 或 DISABLE_TELEMETRY=1 存在，AGENTS.md 並不會載入。原文指出，這與內建 agents-md plugin 的啟用方式有關：該 plugin 預設 isOnByDefault 為 false，並透過名為 tengu_agents_md_mod 的遠端 feature flag 判斷是否可用；若無法取得 flag，fallback 也是 false。

這個行為之所以受到關注，是因為 AGENTS.md 本質上只是讀取工作目錄中的本機 Markdown 檔案，照理不需要網路。原文作者認為，關閉 telemetry 應該只影響診斷資料，而不應靜默停用本機專案指令讀取功能。更嚴重的是，測試中沒有任何警告訊息提示 AGENTS.md 被略過；session 仍正常啟動，模型只是未取得專案指令。

原文也提到，將相關環境變數設為 0 並不能重新啟用功能，因為文件描述為「任何值都算啟用」。在專案 .claude/settings.json 中清除這些變數也沒有作用；session-level --settings override 則可在第二個 session 起生效。文章另指出，第三方 gateway、Bedrock 與 Vertex 也會遇到相同問題，因為 feature flag 無法解析為 true。

目前原文提供的實用 workaround 是在專案中新增一行 CLAUDE.md：

@AGENTS.md

作者測試指出，CLAUDE.md 的 @path import 不依賴該 feature flag，因此即使在 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 的情況下，仍能載入 AGENTS.md 內容。對 Claude Code 使用者而言，若你依賴 AGENTS.md 放置專案規則，且同時關閉 telemetry 或 nonessential traffic，建議立即檢查專案指令是否真的有被讀取；在確認官方修正前，可先用一行 CLAUDE.md 匯入 AGENTS.md，避免專案約束被靜默忽略。

相關連結：

• 原文：https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on/
• Hacker News 討論：https://news.ycombinator.com/item?id=49814947