開發者關閉 telemetry,本意是「少上傳一些資料」。結果他順手寫好的 AGENTS.md——那份本該被 Claude Code 讀取的專案級指令檔——完全沒生效。szypowi.cz 上的這篇部落格 把程式碼拆開一看,問題更尷尬:Claude Code 讀取 AGENTS.md 的邏輯,直接掛在 telemetry 開啟的那條分支上。
Anthropic 已經修復。這件事本身不算大,但它指向一個正在浮現的工程組織問題。
事件本身:AGENTS.md 不是「設定」,是「遙測開關的副產品」
事情起點很普通。有人在 Claude Code 裡放了一份 AGENTS.md,想給模型餵專案規範、程式碼風格、提交習慣之類的指令。檔案沒報錯、日誌看起來也正常,但模型對 AGENTS.md 裡的內容完全無感。
關掉 telemetry,再開。檔案生效了。
szymon(部落格作者)覺得不對勁,就翻 Claude Code 的原始碼邏輯。結果發現:讀取 AGENTS.md 的程式路徑,確實和 telemetry 的開關耦合在一起。telemetry 關 → 走不到那段讀檔的程式碼。
這不是 bug 回報裡常見的「誤觸發」或「邊界條件沒覆蓋」。這是從程式碼組織層面看出來的一個設計決策——或者說,一個埋得太深的副作用。
Anthropic 收到回饋後修了。但修復本身不等於解釋——官方沒說「我們當初為什麼這樣寫」,也沒說「還有哪些功能在 telemetry 關閉時會被靜音」。這是後話,先來看為什麼這件事在 HN 上能拿到 374 分、211 則留言。
HN 討論連結:https://news.ycombinator.com/item?id=49814947
這個 bug 為什麼重要:遙測和功能耦合在一起
把視角從「檔案沒讀到」拉到「遙測和功能跑在同一段程式上」。
開發者關掉 telemetry,典型動機是隱私——不想讓程式碼片段、提示詞、上傳的檔案被伺服器端拿到。這是合理的,甚至是企業合規場景下必要的選擇。結果呢?關掉它,順帶把「讀取專案級指令」這個看起來毫無隱私關聯的基本功能,也一併關掉了。
更深的問題是:沒人會在產品文件裡告訴你這件事。
你打開 Claude Code 的設定面板,看到 telemetry 是個開關,大概會理所當然理解成「資料收集開關」。它不會寫「同時也會關閉專案設定檔讀取」。這種隱性耦合是信任的殺手——不是因為 Anthropic 有惡意,而是因為開發者根本沒有管道,在按下開關之前就知道這一連串後果。
類似的隱式依賴,八成不止這一處。等等會細講。
AGENTS.md 是什麼,跟 .cursorrules 又有什麼關係
先科普一下這個檔案。AGENTS.md 是 2025 年中開始流行的一個慣例:放在專案根目錄,給 AI Agent / AI 程式工具讀的專案級指令檔。格式上模仿 README.md,但內容是給模型看的,不是給人看的。
典型內容長這樣:
# AGENTS.md
## Build & Test
- pnpm install
- pnpm test
## Style
- 2-space indent
- No `any` in TypeScript
- Prefer composition over inheritance
## Don't
- 不要修改 `migrations/` 目錄下的檔案
- 不要 commit `.env`
類似機制在其他工具裡也有,只是檔名不一樣:
- Cursor:
.cursorrules,放在專案根目錄 - Aider:
CONVENTIONS.md,透過--read參數顯式載入 - Cline / Continue:透過自訂 system prompt 注入
- Claude Code:
AGENTS.md或CLAUDE.md(同一個檔,兩個名字都認)
關鍵差異在載入路徑。Cursor 和 Cline 走的是設定解析層——你打開專案、工具初始化,AGENTS.md(或同類檔案)就被讀進來,邏輯獨立於任何「遙測」或「資料上傳」開關。Aider 更直接,要你顯式傳檔路徑,也不存在耦合問題。
Claude Code 這次暴露的是另一條路徑——讀取行為掛在其他開關後面。這種組織方式在快速迭代的產品裡並不罕見,但發生在設定載入這條核心鏈路上,問題就被放大了。
社群反應:374 分、211 則留言在吵什麼
HN 上這個討論串熱度不低,大致分了三派。
第一派:Anthropic 內部程式碼組織有問題。代表觀點是——讀 AGENTS.md 是一個「應該 100% 走確定性路徑」的功能(無副作用、無隨機性),把它和 telemetry 這種「可關閉、可變」的開關綁在一起,是糟糕的程式架構。持這派觀點的多是有大廠工程背景的開發者,他們看過類似 anti-pattern 在生產環境裡引發的更嚴重事故。
第二派:open-source / CLI 工具的先天缺陷。這派覺得 Claude Code 的程式碼雖然沒完整開源,但能看到的部分也暴露了快速迭代產品的常見問題——功能加得太快,內部重構沒跟上。有個匿名用戶留言說:「這不是 bug,這是 velocity tax。」翻譯過來:你跑得越快,埋得越深。
第三派:更深的反思——AI 工具的開關到底控制了什麼。這派的討論最有趣。他們把這件事放到更大的脈絡裡:LLM 工具普遍有「遙測 / 資料收集」開關,但使用者根本不知道開關背後連著多少功能行為。某個開關可能是「資料收集」、也可能是「功能啟用」、還可能是「模型版本選擇」、甚至是「提示詞快取策略」。這種不可見性才是問題根源。
我比較認同第三派。前兩派討論的是「為什麼這次會出 bug」,第三派在問「這類 bug 怎麼系統性地避免」。
對開發者的實務影響:你現在該開還是關遙測
短期建議,如果你已經在用 Claude Code:升級到最新版本。修復已經合入,但具體哪個版號發布的,szypowi.cz 的部落格和 HN 留言裡都沒點透,建議直接查 Claude Code 的 release notes 或 GitHub commits。
怎麼驗證修復生效?最直接的方式:關掉 telemetry、啟動 Claude Code,在專案根目錄放一份測試用的 AGENTS.md,內容隨便寫一行獨特的話(例如 print("AGENTS_MD_TEST_OK")),然後問 Claude「根據 AGENTS.md 裡的指示執行一下」。如果它真的去執行了那行程式碼,代表讀取鏈路已經獨立於 telemetry 了。
遙測開關本身開不開:看你的場景。
- 開遙測:能拿到產品改進、能優先體驗新功能、想將使用資料回饋給 Anthropic。
- 關遙測:在乎程式碼片段 / 提示詞不被上傳、所在企業有合規要求、想要更可預期的行為。
我的傾向:在 AI 程式工具越來越像「協作者」而不是「工具」的當下,預設關閉資料收集、但開啟必要功能——這件事 Anthropic 們得給一個明確的承諾,開關的副作用必須在文件裡窮舉。這件事不能靠使用者自己扒程式碼。
可以關注的幾個位置(具體名稱以官方文件為準):
~/.claude/settings.json裡的 telemetry 相關設定- CLI 命令裡的 telemetry 相關 flag
- 啟動日誌裡 telemetry 狀態的輸出
編輯思考
這件事不是「Anthropic 又翻車了」那麼單純。它指向一個具體的工程問題:AI Agent 工具的「功能開關」與「資料開關」是不是該解耦?
Cursor、Aider、Cline、Claude Code 這類工具都在快速迭代——每週都有新功能、新模型、新權限。新功能往現有的「讀取設定 / 初始化環境 / 載入策略」這條鏈路上掛的時候,掛在哪裡、相依什麼狀態、是否有副作用,這些決定每一個都直接影響開發者的工作流。Claude Code 這次「設定讀取掛在 telemetry 分支上」,不是孤立事件,是這類工具普遍程式組織問題的早期訊號。
我的判斷:未來 12-18 個月,這類「隱性耦合」事件會越來越多,而不是越來越少。原因很單純——Agent 工具的產品型態還在劇烈變化,「什麼是核心功能」的定義本身在移動。今天的核心功能,明天可能變成「實驗性」;今天的實驗性,明天可能成為預設行為。在這種變動下,「哪個開關連哪個功能」就變成了一筆糊塗帳。
這件事和過去的工具 bug 不同:過去「工具出 bug」通常是功能行為出錯——輸出有偏差、計算結果有 bug。這次是元層面的問題——工具的「什麼是 bug」這個判斷標準本身,在使用者與廠商之間產生了分歧。使用者以為「AGENTS.md 必須被讀取」,但程式碼裡它不是這個語意。
短期靠稽核:使用者社群、第三方安全研究者會持續扒程式碼、提 issue、揭露問題,這是半開源工具的優勢。長期需要產業級透明度——我希望看到的是:每個開關都有明確的「影響範圍聲明」,文件裡窮舉副作用;設定載入鏈路獨立於資料收集鏈路,作為工程硬性要求;第三方稽核成為 agent 工具的標配,類似現在的 SOC2、GDPR 合規稽核。
能不能完全解決,我有保留。LLM 工具的可觀察性傳統上就比傳統軟體弱——模型本身是黑盒子,圍繞模型的產品也越來越黑盒。Claude Code 這次修了,但修復不代表這類問題消失。