Claude Code 2.1.277 新增原生支援，可讀取儲存庫中的指示檔 AGENTS.md。此功能有一項重要限制：Anthropic 目前的文件指出，無法取得功能旗標的工作階段（包括關閉遙測的工作階段，以及許多第三方供應商設定）只會載入 CLAUDE.md。

已發布的agents-md 外掛將檔案載入與可選的遙測資料列分開。遙測資料列只包含計數與固定選項，不包含路徑或檔案文字。依賴發生在更前面一層：遠端旗標會決定內建載入器是否可用。

重大變化

  • 有哪些改變：本機指示檔現在受遠端推出機制影響：能否取得功能旗標，決定內建的AGENTS.md讀取器是否可用。
  • 為何重要：即使使用相同的程式碼提交版本，兩名開發者也可能收到不同的專案指示，因為版本、供應商或隱私設定各異，讓團隊更難重現代理程式的行為。
  • 後續觀察重點：使用多家供應商或受限制環境的團隊，可將指示檔載入視為執行階段相依條件，在每種環境中驗證，並保留一個CLAUDE.md匯入方式作為可攜替代方案。

版本發布說明與報導證實了什麼

Anthropic 的2.1.277 版發布說明於 9 月 18 日發布，指出 Claude Code 會讀取AGENTS.md，前提是專案中沒有CLAUDE.md。發布說明也指出，Bedrock、Vertex 與 Foundry 不在該版本的支援範圍內。

目前的專案記憶文件也排除首次安裝或升級至支援版本後的第一個工作階段，以及停用內建外掛的工作階段。

Przemek Szypowski 的觸發條件測試報告描述他在 2.1.280 版進行的金絲雀測試。他表示，DISABLE_TELEMETRY與CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC讓他的AGENTS.md無法載入；相鄰位置的CLAUDE.md匯入指示則正常運作。BIG CHANGE 未重現這項付費模型測試。Anthropic 目前的文件已獨立說明相同的可用性條件。

功能可用性與遙測記錄彼此獨立

Anthropic 的環境變數文件指出，任何非空的DISABLE_TELEMETRY值（包括0或false）都會停用遙測並停止擷取功能旗標。DO_NOT_TRACK、DISABLE_GROWTHBOOK以及CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC也可能停止擷取。除非嵌入式主機設定CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST，否則第三方供應商工作階段不在支援範圍內；Claude Apps gateway 工作階段也同樣不支援。

已發布的外掛 README指出，缺少遙測呼叫時會直接略過，不影響外掛的其他工作。儲存庫的內建模組概覽將遙測與agents-md列為不同的內建外掛。

來源程式碼說明載入器如何運作；產品文件則說明工作階段能否取得該載入器。模組內的可選記錄功能，不會消除模組外部的可用性條件。

9 月 23 日，BIG CHANGE 從agents-mdREADME 與註冊模組擷取了main以及 2.1.280 標籤中的版本；兩組檔案逐位元組完全相同。

Claude Code 何時載入指示檔

對於可用且已啟用的外掛，預設模式依照以下優先順序運作：

指示檔

預設結果

AGENTS.md沒有專案層級的 Claude 指示檔

AGENTS.md載入

專案CLAUDE.md、.claude/CLAUDE.md或CLAUDE.local.md位於工作目錄或其上層目錄中的檔案

直接AGENTS.md載入會讓位給上述檔案

使用者或受管理的CLAUDE.md，或.claude/rules/

這些檔案不會取代AGENTS.md

在/config變更 Project instructions 設定，即可同時載入兩種檔案類型。其 JSON 選項應放在使用者、--settings或受管理的設定中；專案與本機設定檔會遭忽略。

替代方案是明確加入一行匯入指示

對於不支援直接載入的工作階段，Anthropic 建議在共用指示檔旁邊加入一個CLAUDE.md，內容如下：

@AGENTS.md

這種匯入方式會直接納入該檔案；若只用文字要求 Claude 讀取，是否照做就由模型自行決定。

檢查claude --version與 Project instructions 在/config中的載入情況。在 2.1.280 版中，/memory或/context可以列出直接載入的AGENTS.md；較早的支援版本不會在此處列出。