title: Claude Code 讀取 AGENTS.md 竟綁定遙測開關？開發者踢爆靜默失效，Anthropic 工程師認了「人為疏失」 --- **Category** - [AI](https://www.soft4fun.net/category/tech/ai) - [新聞](https://www.soft4fun.net/category/tech/news) - [科技](https://www.soft4fun.net/category/tech) **Tag** - [AI](https://www.soft4fun.net/tag/ai) - [Claude](https://www.soft4fun.net/tag/claude) - [Claude Code](https://www.soft4fun.net/tag/claude-code) - [CLAUDE.md](https://www.soft4fun.net/tag/claude-md) **圖片清單** - ![Claude Code 讀取 AGENTS.md 竟綁定遙測開關？開發者踢爆靜默失效，Anthropic 工程師認了「人為疏失」 b3d55d767e7796957c7c80317ff33cd1dbd164fa](https://cf.img.soft4fun.net/2026/09/b3d55d767e7796957c7c80317ff33cd1dbd164fa.jpg "b3d55d767e7796957c7c80317ff33cd1dbd164fa") --- Anthropic 旗下的命令列 [AI](https://www.soft4fun.net/tag/ai) 開發工具 [Claude Code](https://www.soft4fun.net/tag/claude-code)，才在 9 月 18 日隨 2.1.277 版正式支援業界通用的 `AGENTS.md` 專案指令檔，如今卻被獨立開發者踢爆：這項功能其實被一個遠端遙測（telemetry）開關悄悄綁架——只要使用者關閉遙測回傳，Claude Code 就會在完全沒有任何錯誤訊息的情況下，安靜地「假裝」讀不到專案目錄裡的 `AGENTS.md`。事件在 Hacker News 引爆超過 400 點讚與大量討論後，Anthropic 工程師本人親自下場認錯，坦承是「人為疏失」，並在同一天釋出修復版本。 ## 事件經過：一個「金絲雀字」測試揭穿的沉默失效 發現問題的是技術部落格 blog.szypowi.cz 的作者 Przemek Szypowicz。他在測試 Claude Code 的 `AGENTS.md` 支援時，先建立一個只含 `AGENTS.md` 的測試目錄，並在檔案裡埋入一個特定的「金絲雀字」（canary word），接著執行 `claude -p '專案指令裡的金絲雀字是什麼？'` 這類提問，藉此驗證 Claude Code 是否真的把 `AGENTS.md` 的內容讀進了模型的上下文。 在預設狀態下，Claude Code 正確讀出了金絲雀字。但當他分別加上 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` 與 `DISABLE_TELEMETRY=1` 這兩個關閉遙測回傳的環境變數後重新測試，Claude Code 卻完全「忘記」了 `AGENTS.md` 裡的內容——沒有警告、沒有錯誤訊息，就像這個檔案根本不存在一樣。Szypowicz 在部落格中直言，讀取一個純粹存在於本機硬碟上的檔案，理論上不該與任何網路遙測行為有任何關聯。 ![Claude Code 讀取 AGENTS.md 竟綁定遙測開關？開發者踢爆靜默失效，Anthropic 工程師認了「人為疏失」 b3d55d767e7796957c7c80317ff33cd1dbd164fa](https://cf.img.soft4fun.net/2026/09/b3d55d767e7796957c7c80317ff33cd1dbd164fa.jpg "Claude Code 讀取 AGENTS.md 竟綁定遙測開關？開發者踢爆靜默失效，Anthropic 工程師認了「人為疏失」 b3d55d767e7796957c7c80317ff33cd1dbd164fa") ## 問題根源：本地檔案讀取被綁在遠端 Feature Flag 上 深入追查程式碼後，Szypowicz 找到了問題核心：負責載入 `AGENTS.md` 的模組，實際上是由一個名為 `tengu_agents_md_mod`、託管在遠端 Statsig 平台上的 feature flag 所控制，而且這個開關的預設值（`isOnByDefault`）就是「關閉」。也就是說，Claude Code 每次啟動都必須先成功連上 Anthropic 的伺服器、拿到「允許讀取 AGENTS.md」的訊號，這項本機功能才會被打開；一旦遙測回傳被關閉、或者遠端開關根本無法被查詢到，系統就會直接 fallback 回「關閉」狀態——而且完全不會提示使用者。 這個設計同樣會影響透過 Bedrock、Vertex AI 或 Foundry 等第三方閘道使用 Claude Code 的企業用戶：根據 Anthropic 官方變更紀錄，`AGENTS.md` 支援在 2.1.277 版上線時就註明「尚未支援 Bedrock、Vertex 或 Foundry」，這類部署情境同樣可能因為連不上遠端開關而讓功能悄悄失效。在 Anthropic 官方 GitHub 儲存庫上，開發者 Prefee 已於 9 月 20 日提交編號 #95690 的議題，將此問題標記為「嚴重」等級，理由是使用者可能誤以為 Claude Code 正在遵循專案指令並允許它自動編輯檔案，實際上模型卻完全沒看過那些指令。 Szypowicz 也在部落格中提供了一個暫時解法：只要在專案根目錄手動建立一個僅含一行 `@AGENTS.md` 的 `CLAUDE.md` 檔案，就能繞過遠端開關、強制匯入 `AGENTS.md` 的內容，不受遙測設定影響。 ## Anthropic 工程師公開認錯：「這完全是我個人的人為疏失」 這篇部落格文章被轉貼到 Hacker News 後迅速衝上熱門版面，累計突破 412 點讚，吸引大量開發者留言討論。值得注意的是，一位以帳號 mpoteat 現身、自稱是相關功能負責工程師的 Anthropic 員工，直接在討論串裡回應並道歉：「抱歉各位，這是上線流程中的失誤（rollout artifact）——我們當初需要一個能在功能出包時透過遠端 feature flag 緊急關閉的機制，但遙測關閉時就拿不到這個訊號。這個問題已經在今天發布的 2.1.281 版中修復了。」他接著補充：「再次跟大家道歉，這完全是我個人的人為疏失，我當初應該找一個更好的方式來設計上線用的緊急開關（kill-switch）。」 mpoteat 同時公開了這個模組的原始碼連結（anthropics/claude-code 儲存庫下的 `mods/agents-md` 目錄），並說明 `AGENTS.md` 支援其實是透過 Claude Code 一套即將正式推出、名為「Mods」的新擴充系統實作而成——Mods 是一種新型態的外掛，內建所謂的「function hook」機制，未來會開放更高的客製化彈性。Hacker News 討論串上的留言反應兩極：不少開發者稱讚 Anthropic 這種「快速承認、坦率揭露」的處理方式值得尊敬；但也有人藉機批評 Claude Code 整體仍偏封閉、把本機檔案操作與雲端開關綁在一起的作法本身就有風險，尤其是在「自動接受編輯」（Accept Edits）模式下，使用者原本以為 AI 正在遵守專案規範，實際上規範卻從未被讀取。 ## 為什麼這件事值得關注 `AGENTS.md` 是近來由 OpenAI 等業界共同推動、跨工具通用的專案指令檔標準，目的是讓開發者不必為每一套 AI 程式碼代理工具各寫一份設定檔。Anthropic 在 9 月 18 日加入支援時被視為向開放標準靠攏的正面訊號，但這次事件也凸顯出一個容易被忽略的風險：當一項原本純粹屬於本機檔案系統的功能，被悄悄綁定在企業無法完全掌握、甚至無法查證是否生效的遠端開關上時，使用者很可能在毫無警覺的情況下，讓 AI 代理工具實際執行的行為與自己認知的專案規範產生落差。對於仰賴 Claude Code 進行自動化編輯、甚至授權其自動套用變更的團隊而言，這類「靜默失效」尤其值得留意——目前該問題已隨 2.1.281 版修復，但也再度提醒開發者，在導入具備檔案寫入權限的 AI 代理工具時，仍應留意其背後的遠端開關設計與遙測相依性。 #### 更多AI相關報導 - [Claude Code 讀取 AGENTS.md 竟綁定遙測開關？開發 踢爆靜默失效，Anthropic 工程師認了「人為疏失」](https://www.soft4fun.net/tech/news/claude-code-agents-md-telemetry-feature-flag-bug.htm) - [Meta 認了：AI 助理 Muse 深受 OpenClaw「啟發」，產品主管證實連設定檔名都一樣](https://www.soft4fun.net/tech/news/meta-muse-ai-agent-openclaw-inspiration-admission.htm) - [Meta AI助手Muse爆零日漏洞：本機駭客竊取語音權杖、變身電 後門，官方緊急熱修補](https://www.soft4fun.net/tech/news/meta-muse-ai-assistant-zero-day-vulnerability-backdoor.htm) - [高通發表新一代旗艦晶片 Snapdragon 8 Elite Gen 6 與 Elite Extreme Gen 6：2奈米製程、GPU效能大增44%](https://www.soft4fun.net/tech/news/qualcomm-snapdragon-8-elite-gen-6-extreme-gen-6-official-launch.htm) - [Claude Opus 5.5 指令最佳化指南：刪掉「想 楚一點」、講 楚「怎樣算完成」，長任務放手讓它跑](https://www.soft4fun.net/tech/news/claude-opus-5-5-prompting-guide.htm) 📖 延伸閱讀：AI 為你整理的 5 個重點問題[Q1. 【實用技巧】想確認手上的 AI 輔助工具到底有沒有乖乖讀取專案規範，平常可以怎麼自己動手做「金絲雀測試」？→](https://www.soft4fun.net/tech/news/claude-code-agents-md-telemetry-feature-flag-bug.htm/faq/1)[Q2. 【常見疑難】讓 AI 程式碼代理工具（Code Agent）進入「自動套用變更」模式時，該如何避免 AI 靜默忽略規範而寫出壞程式碼？→](https://www.soft4fun.net/tech/news/claude-code-agents-md-telemetry-feature-flag-bug.htm/faq/2)[Q3. 【深度解惑】最近經常聽到的 AGENTS.md 是什麼？為什麼各大 AI 工具都在開始支援這個統一標準？→](https://www.soft4fun.net/tech/news/claude-code-agents-md-telemetry-feature-flag-bug.htm/faq/3)[Q4. 【情境適用】如果團隊對資安極度敏感、習慣關閉所有遙測（Telemetry），或者在內網與離線環境下開發，使用這類 AI 終端工具該注意什麼？→](https://www.soft4fun.net/tech/news/claude-code-agents-md-telemetry-feature-flag-bug.htm/faq/4)[Q5. 【進階探索】文章中提到的「Mods」與功能鉤子（Function Hooks）是什麼？這會為未來的 AI 寫程式體驗帶來什麼全新玩法？→](https://www.soft4fun.net/tech/news/claude-code-agents-md-telemetry-feature-flag-bug.htm/faq/5)想知道這些問題的解答嗎？