Claude Code: AGENTS.md 支援在 v2.1.277 版本中因遙測功能被限制

Claude Code v2.1.277 在遙測功能關閉時，默默無法載入 AGENTS.md 專案指示。這是因為該功能被遠端功能旗標所限制，需要網路連線才能解析，導致設定 DISABLE_TELEMETRY=1 或 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 的使用者，其本機檔案讀取功能實際上被停用。

遠端功能旗標限制本機檔案存取

在 v2.1.277 版本中，agents-md 外掛程式被設定為 isOnByDefault: false。該外掛程式的可用性由名為 tengu_agents_md_mod 的遠端功能旗標決定。若 Claude Code 無法從 Anthropic 的伺服器取得此旗標——這在遙測或非必要流量被關閉時會發生——則外掛程式將保持不可用狀態，且本機的 AGENTS.md 檔案也永遠不會被讀取。

此行為對使用第三方閘道（如 Bedrock 和 Vertex）的使用者影響尤為嚴重，因為這些平台的網路政策通常會阻擋解析這些旗標所需的流量，導致該功能對這些使用者完全不可用。

影響與靜默失敗

使用者經歷了靜默失敗，模型在未載入 AGENTS.md 中的專案指示的情況下回應，且未收到任何警告或錯誤訊息。這導致部分使用者誤以為模型只是忽略他們的指示，可能浪費時間進行提示工程，而實際上該檔案根本未被載入至上下文中。

替代方案與設定

在 v2.1.281 修復前，使用者採用多種替代方案，在維持隱私設定的同時使用專案指示：

@path 匯入： 建立一個僅含 @AGENTS.md 的一行程式碼 CLAUDE.md 檔案，讓工具在不依賴功能旗標的情況下載入指示。
會話層級覆蓋： 使用 --settings 參數清除特定會話的遙測環境變數：claude --settings '{"env":{"DISABLE_TELEMETRY":"","CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":""}}'。
符號連結： 建立 AGENTS.md 到 CLAUDE.md 的符號連結（ln -s AGENTS.md CLAUDE.md）。

開發者回應與解決方案

Anthropic 工程師 (@mpoteat) 確認此問題為「人為錯誤」，與滾動發布的關閉開關實作有關。此問題已在 v2.1.281 版本中解決，移除了讀取本機檔案時對遙測的依賴。

"抱歉各位，這是滾動發布的遺留問題。我們需要一種遠端透過功能旗標關閉此功能的方式，若遙測關閉，您便無法取得這些旗標。此問題已於今日釋出的 v2.1.281 版本中修復。"

社群見解與設計批判

Hacker News 上的技術討論突顯了使用功能旗標控制本機行為的多項設計疑慮：

隱私與功能的權衡： 批評者認為，關閉遙測（隱私設定）不應靜默停用與之無關的本機功能。
直覺式編碼（vibe-coding）： 部分使用者將此描述為「vibe-coding」，暗示 AI 生成的程式碼修補可能導致細微但嚴重的錯誤，避開傳統測試。
標準化需求： 社群持續呼籲 Claude Code 完全採用 AGENTS.md 和 .agents/ 標準，而非專有格式 CLAUDE.md。
全域設定支援： 使用者指出缺乏對全域 ~/.codex/AGENTS.md 或跨專案持久化使用者層級指示檔的支援，必須手動複製。