Anthropic 於 2026 年 9 月 18 日推出 Claude Code 2.1.277，新增對 AGENTS.md 的支援：當專案沒有 CLAUDE.md 時，Claude Code 會改讀 AGENTS.md 作為專案指令。[1]
讀取規則
官方文件說明，若專案的工作目錄或其上層目錄已有 AGENTS.md，而沒有任何 CLAUDE.md 或 CLAUDE.local.md，Claude 便會讀取 AGENTS.md；反之，只要工作目錄或上層目錄存在 CLAUDE.md、.claude/CLAUDE.md 或 CLAUDE.local.md，Claude 只會讀取 CLAUDE.md 系列檔案。[2]
需要留意的例外包括：位於 ~/.claude/CLAUDE.md 的用戶指令、企業受管理的 CLAUDE.md，以及 .claude/rules/ 內的規則，不會令 AGENTS.md 被略過，而會與之並行載入。[2]
在載入時機方面，互動 session 開始時會讀取工作目錄及其上層目錄的每個 AGENTS.md 與 .claude/AGENTS.md，並在對話中顯示類似「no CLAUDE.md found; AGENTS.md loaded」的提示行；Claude 在子目錄工作並以 Read 工具開啟檔案時，若該子目錄沒有那三類 CLAUDE.md，亦會載入子目錄的 AGENTS.md。[2]
設定選項
使用者可在 /config 的「Project instructions」設定中調整載入行為，官方列出三個可選值：claude-md-or-agents-md（預設，有 CLAUDE.md 便讀 CLAUDE.md，沒有時讀 AGENTS.md）、claude-md-and-agents-md（同時讀取兩者，每個目錄先讀 CLAUDE.md 再讀 AGENTS.md，已載入過的 AGENTS.md 不會重複讀取），以及 managed-only（只載入企業受管理的 CLAUDE.md 與自動記憶，排除專案、本地與用戶層級的 CLAUDE.md、.claude/rules/ 及所有 AGENTS.md）。[2]
與 CLAUDE.md 的差異
透過設定讀取的 AGENTS.md 與 CLAUDE.md 有幾項差異：AGENTS.md 不會出現在 /memory 及 /context 的記憶檔案清單中，使用者需依賴「AGENTS.md loaded」提示行或直接詢問 Claude 來確認；InstructionsLoaded hook 不會因直接讀取 AGENTS.md 而觸發，但若 AGENTS.md 是由 CLAUDE.md 匯入或符號連結，hook 會如常觸發；此外，以 --add-dir 加入的目錄，其 AGENTS.md 亦不會載入。[2]
若要在多個編程代理之間共用同一份指令檔，官方建議在 AGENTS.md 旁邊加入一個 CLAUDE.md，由後者以 @path 匯入 AGENTS.md；在 AGENTS.md 支援不可用的 session（例如 Amazon Bedrock，或剛安裝／升級後的首次 session），亦可採用相同做法。[2]
限制
Anthropic 的更新紀錄註明，AGENTS.md 支援目前不適用於 Amazon Bedrock、Google Vertex AI 與 Microsoft Foundry，使用者須在 /config 的「Project instructions」中更改設定；若設定中看不到該選項，即代表該 session 無法讀取 AGENTS.md。[1][2]
參考資料
[1] Claude Code 官方更新紀錄（2.1.277，2026 年 9 月 18 日）
[2] Claude Code 官方文件 — How Claude remembers your project（AGENTS.md 一節）