Claude Code 2.1.277 接入 AGENTS.md，指令共用仍受載入優先序與平台限制

Anthropic 於 9 月 18 日發布 Claude Code 2.1.277，讓沒有 CLAUDE.md 的專案直接載入 AGENTS.md。對交替使用不同程式代理的團隊，這可減少重複維護建置命令、測試規範與目錄說明；工程上的關鍵則是釐清哪些指令真正進入模型上下文。[版本公告](https://github.com/anthropics/claude-code/releases/tag/v2.1.277)

預設規則會檢查工作目錄與上層目錄的 CLAUDE.md，包含 .claude 子目錄中的版本；找到就不啟用替代載入。容易忽略的是，私人使用的 CLAUDE.local.md 也會觸發這個條件，因此同一份儲存庫可能在不同開發者機器上讀取不同指令。使用者家目錄的全域指令與組織管理檔，則不算這項專案判斷的依據。[載入規則](https://code.claude.com/docs/en/memory#when-claude-code-reads-agentsmd)

版本內附的 agents-md 外掛會在建立上下文時，把檔案加入「專案指令」清單，交由引擎依既有順序與格式呈現。子目錄規則在讀取文字檔時附加；已透過匯入或連結載入的內容會去重。不過，壓縮上下文後，巢狀規則要等再次讀取該目錄才重新附加，與原生指令檔的恢復流程仍有差異。[外掛實作說明](https://raw.githubusercontent.com/anthropics/claude-code/v2.1.277/mods/agents-md/README.md)

開發者可在 /config 的 Project instructions 選擇同時讀取兩類檔案，或只讀既有格式。這個選項須放在使用者、明確指定或受管理的設定中；專案與本機設定檔中的外掛選項不會生效。因此，將一份設定提交進儲存庫，尚不足以統一全團隊的載入模式。[設定範圍](https://raw.githubusercontent.com/anthropics/claude-code/v2.1.277/mods/agents-md/README.md)

版本公告指出，Bedrock、Vertex 與 Foundry 尚不支援；文件另指出，停用遙測而無法取得功能旗標，以及升級後的第一個工作階段，也可能無法啟用。既有 CLAUDE.md 中的 @AGENTS.md 匯入仍可保留，適合混合環境過渡。[可用性說明](https://code.claude.com/docs/en/memory#when-agentsmd-support-is-unavailable)

文件亦提醒，直接載入的檔案不會出現在 /memory 清單，既有依賴該清單稽核上下文的流程也得調整。遷移前應清理互相矛盾的重複規則，再用小型專案確認生效內容，避免只看檔案存在就判定設定完成。[文件說明](https://code.claude.com/docs/en/memory#where-agentsmd-differs-from-claudemd)

工程團隊接下來應驗證啟動、子目錄讀取與上下文壓縮後三種情境，並檢查載入訊息。共用檔名能降低維護成本，但指令仍屬模型上下文；權限與沙箱限制必須由執行系統落實。[記憶與指令文件](https://code.claude.com/docs/en/memory)