Shopify執行長Tobi Lütke在8月25日公開表示,正考慮在公司內部禁用Claude Code,除非Anthropic改變立場,讓它讀取AGENTS.md和.agents/skills這類檔案。他給出的理由是,Claude Code堅持只讀CLAUDE.md,導致團隊成員使用不同工具時會出現「認知分裂」,他將這稱為一筆原本不必付的複雜度稅。
爭的是一個Markdown檔案
AGENTS.md是OpenAI在2025年8月推出的約定:把專案層級的建置指令、測試方式、安全規範寫進儲存庫根目錄的一個Markdown檔案,讓程式設計agent讀取後理解程式碼庫。到2025年底,公開資料顯示已有超過六萬個開源專案採用這個檔案,標準本身後來也移交給Linux基金會旗下的Agentic AI Foundation。Codex、Cursor、Gemini CLI、GitHub Copilot、Jules、VS Code全部都支援它。
Claude Code用的則是自家的CLAUDE.md。對個人專案來說,這只是多寫一個檔案的事;但對Shopify這種數千人共用一個大型儲存庫的組織而言,問題就變了樣:同一個目錄下如果只放了其中一份,用另一套工具的同事拿到的內容脈絡就是不完整的。
掛了一年的請求
要求Claude Code原生支援AGENTS.md的GitHub issue從2025年8月就存在,累積將近5000個讚,是該儲存庫裡回響最大的相容性訴求之一。後續幾個類似的issue陸續被關閉,其中一個給出的結論是「目前沒有計畫」。開發者在底下留了數百則留言,官方卻始終沒有正式說法。
社群的變通做法早就跑通了:把CLAUDE.md做成指向AGENTS.md的符號連結,或是乾脆在CLAUDE.md裡寫一句「去讀AGENTS.md」。這樣做得通,但每個儲存庫都得重做一遍。
Anthropic終於給出理由
就在Lütke發聲當天,Anthropic的Thariq在底下回覆,表示團隊正在讓Claude Code變得更容易客製化,之後將能方便地使用AGENTS.md、或是直接修改系統提示詞,準備好後會再公布細節。他也首度說明先前拒絕的理由:他們不認為不同模型家族可以互換使用,系統提示詞對效能的影響很大——Claude Code內部是按模型分別維護系統提示詞的,這部分的維護量並不小。
這個理由在技術上站得住腳。同一段指令餵給不同廠商的模型,效果確實會有明顯落差,針對特定模型調校過的提示詞能拉開清楚的表現差距。只是這解釋了CLAUDE.md為什麼該獨立存在,卻沒解釋為什麼不能順手也讀一遍AGENTS.md,這兩件事其實並不衝突。
情境檔案成了新的兵家必爭之地
一份涵蓋2926個GitHub儲存庫的統計顯示,情境檔案已經是開發者對程式設計agent下指令最常用的方式。這個位置一旦被某家廠商的私有格式占住,遷移成本就會落到使用者頭上——今天可能只是多維護一個檔案,明天卻可能演變成把技能、子agent、權限設定整套都鎖進同一家廠商的目錄結構裡。
就工程量來看,這場僵局其實有點不成比例。讓Claude Code在找不到CLAUDE.md時回頭去讀AGENTS.md,只是幾十行的檔案查找邏輯,跟「按模型分別維護系統提示詞」根本是兩個層次的事。真要擔心通用指令拉低效果,加一行提示說明就解決了。過去一年裡社群反覆提出的,正是這個折衷方案:預設讀CLAUDE.md,找不到就讀AGENTS.md,兩者都存在時以CLAUDE.md優先。
Lütke的公開施壓之所以奏效,道理也很簡單。Shopify是Claude Code的大型使用者,一家上市公司的執行長在公開平台上說要封殺,分量遠高於5000個匿名的讚。對Anthropic來說,Claude Code目前的領先靠的是產品體驗,而不是靠格式綁定;在開發者早已普遍多工具並用的當下,把相容性做成一個開關,比死守一個檔名要划算得多。
參考來源:The New Stack、GitHub、CocoLoop、Hacker News;AGENTS.md採用規模、issue按讚數與Anthropic方面的表態,均已依公開可查頁面核實。