Anthropic 美國時間 9 月 18 日推出 Claude Code 2.1.277 版，專案裡沒有 CLAUDE.md 時會改讀 AGENTS.md，也能在 /config 設成兩份一起讀。
（前情提要：Anthropic 自曝過度約束：Claude 5 世代，管得越少越好用）
（背景補充：Harness Engineering 是什麼？拆解 AI Agent 真正落地的 7 大工程模組(AI 駕馭工程)）
重點摘要
- Claude Code 2.1.277 版起，沒有 CLAUDE.md 時改讀 AGENTS.md
- Shopify 執行長 8 月 25 日揚言禁用，24 天後支援上線
- AGENTS.md 已有逾 6 萬個開源專案採用，Codex、Cursor 都支援
人工智慧公司 Anthropic 美國時間 9 月 18 日發布 Claude Code 2.1.277 版，更新日誌第一條就是 AGENTS.md 支援。專案裡沒有 CLAUDE.md 時，Claude Code 會改讀 AGENTS.md。使用者也可以在 /config 的「Project instructions」選項，改成兩份一起讀。這項功能暫時不適用 Amazon Bedrock、Google Vertex AI 與 Microsoft Foundry 三個雲端管道。
AGENTS.md 是寫給 AI 程式代理看的專案說明檔，通常放建置指令、測試方式和程式碼規範，代理開工前會先讀。CLAUDE.md 的用途相同，只是 Claude Code 專用。OpenAI 在 2025 年 8 月推出 AGENTS.md，同年 12 月把它捐給 Linux 基金會新成立的 Agentic AI Foundation（AAIF）。
AAIF 當時公布，已有超過 6 萬個開源專案與代理框架採用，Codex、Cursor、Gemini CLI、GitHub Copilot 都支援。
同一天捐進 AAIF 的還有 Anthropic 自家的 MCP（模型上下文協定），Anthropic 也是基金會的白金會員。從那時算起，Claude Code 又過了 9 個月才開始讀 AGENTS.md。開發者早在 2025 年 8 月就在 GitHub 提案要求支援。
Shopify 執行長點名「只認 CLAUDE.md」
Shopify 執行長 Tobi Lütke 在 8 月底公開抱怨，他正考慮讓 Shopify 禁用 Claude Code，「直到他們改變心意，去讀 AGENTS.md 和 .agents/skills 這些檔案」。他說只堅持讀 CLAUDE.md，在團隊成員用不同工具時，有時會讓大家拿到兩套不同的規則，「完全沒必要」。
Tobi Lütke 隨後補充，Shopify 有數千名開發者在同一個 monorepo（單一大型程式碼庫）裡工作，兩種說明檔都會沿著目錄樹逐層套用。他說，總會有某個目錄漏掉其中一份，「這代表有一部分開發者，是在被切除腦葉的狀態下工作」。Shopify 目前用自動化程式補這個洞，Tobi Lütke 稱這是「一筆愚蠢的複雜度稅，本來就不該付」。
Anthropic 原本的理由是模型不能互換
Claude Code 工程師 Thariq Shihipar 當天稍晚回覆，說團隊正在讓 Claude Code 更容易客製，之後可以直接使用 AGENTS.md，也能修改其他系統提示詞。他解釋，Claude Code 只讀 CLAUDE.md，是因為 Anthropic 認為「不同模型家族不能互換，系統提示詞對表現影響很大」。Claude Code 內部也替每個模型準備不同的系統提示詞。
Thariq Shihipar 在回覆裡附上自己 7 月 24 日的貼文，內容是 Anthropic 替新一代模型刪掉 Claude Code 約 8 成系統提示詞後，整理出的提示詞、Skills 與 CLAUDE.md 寫法。他也承認，這需要不少維護，「不見得每個人都覺得值得」。短期內，他建議使用者在 CLAUDE.md 裡用「@AGENTS.md」把 AGENTS.md 匯入。
做成內建 mod，原始碼放上 GitHub
Thariq Shihipar 9 月 18 日宣布更新時表示，AGENTS.md 支援是用 Claude Code 的「mods」做成的，mods 是 Anthropic 即將推出、用來客製 Claude Code 運作方式的機制。他說這次是內建的 mod，開發者之後也能依自己的需要，做出不同版本的專案指令載入方式。這則宣布貼文有超過 273 萬次瀏覽。
Anthropic 同時在 GitHub 公開 agents-md mod 的原始碼，同一個目錄還有 diff、telemetry 與 sec-default 三個內建 mod。說明文件列出四種模式，分別是只讀 CLAUDE.md、沒有 CLAUDE.md 才讀 AGENTS.md（預設）、兩份一起讀，以及只保留企業統一派發的說明檔。這個選項要寫在使用者或企業的設定檔裡，專案目錄內的設定檔不會被讀取。
依說明文件，預設模式下只要從根目錄到工作目錄之間有任何一份 CLAUDE.md，Claude Code 就不會讀 AGENTS.md。Shopify 這類兩種檔案並存的程式碼庫，要切到「兩份一起讀」，才能同時吃到兩邊的規則。這個模式會略過已經被 CLAUDE.md 匯入或連結的 AGENTS.md，同一份內容不會載入兩次。
常見問題
Claude Code 可以讀 AGENTS.md 嗎？
可以。Claude Code 從 2.1.277 版起，專案沒有 CLAUDE.md 時會自動改讀 AGENTS.md，也能在 /config 的 Project instructions 改成兩份一起讀。這項功能暫不適用 Bedrock、Vertex 與 Foundry。
AGENTS.md 和 CLAUDE.md 有什麼不同？
兩者都是寫給 AI 程式代理的專案說明檔。AGENTS.md 由 OpenAI 在 2025 年 8 月推出，已有逾 6 萬個開源專案採用，Codex、Cursor、Gemini CLI 都支援；CLAUDE.md 則是 Claude Code 專用格式。
📍相關報導📍
Claude Code 預設改為 Auto Mode 開啟，因為人類只會按 yes
