Anthropic 的程式設計工具 Claude Code 從 2.1.277 版起支援 AGENTS.md。規則不複雜：某個資料夾裡沒有 CLAUDE.md 時，Claude Code 會去找同一資料夾底下的 AGENTS.md，當成專案指示讀進上下文；已經有 CLAUDE.md 的地方，照舊只認 CLAUDE.md。
這個版本 9 月 18 日在 GitHub 發布。Claude Code 團隊成員 Thariq 在社群平台上宣布了這項改動：
Starting today in version 2.1.277, if there is no CLAUDE.md in a folder, Claude will check for and use AGENTS.md.
意思是從今天發布的 2.1.277 版開始，資料夾裡沒有 CLAUDE.md 時，Claude 會尋找並使用 AGENTS.md。
四檔開關
AGENTS.md 支援是以內建外掛形式做的，程式碼公開在 Claude Code 的 GitHub 儲存庫。使用者在 /config 的「Project instructions」裡切換，一共四檔：
| 模式 | 行為 |
|---|---|
| claude-md | 只讀 CLAUDE.md，等於關掉這項功能 |
| claude-md-or-agents-md（預設） | 同一資料夾有 CLAUDE.md 就忽略該處的 AGENTS.md，沒有才讀 |
| claude-md-and-agents-md | 整個目錄樹裡兩種檔案都讀 |
| managed-only | 捨棄儲存庫裡提交的與個人私有的指示檔案，只保留組織統一發布的檔案與記憶 |
預設檔是「回退」，不是「合併」。已經替 Claude Code 寫好 CLAUDE.md 的儲存庫，升級後行為不變；只有從未寫過 CLAUDE.md、先前只為其他工具準備了 AGENTS.md 的儲存庫，才會第一次把這份檔案讀進來。同一份檔案若依路徑或內容判定為重複，不會被載入兩次。
和 CLAUDE.md 還差幾處
外掛說明裡列出了幾條和 CLAUDE.md 的差異。子目錄裡的 AGENTS.md 只有在 Agent 用 Read 工具讀取該目錄下的文字檔時才會一併帶入，IDE 選取範圍、Notebook、圖片和 PDF 都不會觸發；帶入的檔案不會登記在已讀狀態裡，上下文壓縮之後不會自動恢復。/memory 指令和 # 快捷記憶都碰不到 AGENTS.md，用 --add-dir 加進來的目錄也不會提供 AGENTS.md，符號連結路徑按字面比對、不做解析。
渠道方面，AWS Bedrock、Google Vertex 和 Microsoft Foundry 暫不支援。同一版本裡還有一項和指示檔案相關的改動：SDK 和無介面模式啟動時，第一輪對話不再等待 CLAUDE.md 查找完成。
一個儲存庫，幾家 Agent
AGENTS.md 相當於寫給程式設計 Agent 看的 README：怎麼建置、怎麼跑測試、程式碼風格有什麼慣例、哪些目錄別碰。這個格式最早由 OpenAI Codex 等幾家工具在 2025 年一起推動，後來交給 Linux 基金會旗下的 Agentic AI Foundation 託管，Cursor、GitHub Copilot 等工具都能辨識。Claude Code 一直只認自家的 CLAUDE.md，混用工具的團隊只好同時維護兩份內容幾乎一樣的檔案，社群裡常見的做法是用符號連結讓兩者指向同一份。
中國團隊的工具組合往往更雜：除了 Claude Code，常見的還有 Kimi Code、Qwen Code、Cursor 和 Codex，其中不少預設讀 AGENTS.md，或允許改指示檔案名稱。預設檔下，舊儲存庫一行都不用改；想只維護一份 AGENTS.md 的團隊，可以刪掉 CLAUDE.md 把說明集中過去，但上面那幾條限制要先弄清楚，尤其是長時間對話壓縮之後，子目錄指示不會自動回來。
managed-only 這一檔面向企業管理員。儲存庫裡提交進來的指示檔案會被 Agent 當作指示執行，本身就是一個可能被下毒的入口，管理員可以靠這一檔只放行組織統一發布的規則。這一檔在大型團隊裡用起來效果如何，目前還沒有公開的使用數據。
參考來源：Claude Code GitHub 版本說明、CocoLoop、Anthropic 工程師 Thariq 公開貼文；agents-md 外掛文件核對四種模式、載入順序與限制條款。