--- title: "Claude Code 加入 AGENTS.md 支援：多個編程代理共用同一份專案指令" url: https://sammy.hk/claude-code-%e5%8a%a0%e5%85%a5-agents-md-%e6%94%af%e6%8f%b4%ef%bc%9a%e5%a4%9a%e5%80%8b%e7%b7%a8%e7%a8%8b%e4%bb%a3%e7%90%86%e5%85%b1%e7%94%a8%e5%90%8c%e4%b8%80%e4%bb%bd%e5%b0%88%e6%a1%88%e6%8c%87/ author: Ethan published: 2026-09-21T19:36:00+08:00 modified: 2026-09-21T11:02:38+08:00 description: "Anthropic 於 2026 年 9 月 18 日推出 Claude Code 2.1.277，新增對 AGENTS.md 的支援：當專案沒有 CLAUDE.md 時，Claude Code 會改讀 AGENTS.md 作為專案指令。[1] 讀取規則 官方文件說明，若專案的工作目錄或其上層目錄已有 AGENTS.m…" categories: [AI] tags: [AGENTS.md, Anthropic, Claude Code, CLAUDE.md, "人工智能", "編程代理", "開發者工具"] source: https://sammy.hk --- ![Claude Code 加入 AGENTS.md 支援：多個編程代理共用同一份專案指令](https://sammy.hk/wp-content/uploads/2026/09/openrouter_google_gemini-3_1-flash-lite-image_20260921_105925_444f1c71.jpg)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 日）](https://code.claude.com/docs/en/changelog) \[2\] [Claude Code 官方文件 — How Claude remembers your project（AGENTS.md 一節）](https://code.claude.com/docs/en/memory) ### 相關文章： 1. [用 AI Skills 快速做更好決定：/unstuck 與 /decide 的實戰框架](https://sammy.hk/%e7%94%a8-ai-skills-%e5%bf%ab%e9%80%9f%e5%81%9a%e6%9b%b4%e5%a5%bd%e6%b1%ba%e5%ae%9a%ef%bc%9a-unstuck-%e8%88%87-decide-%e7%9a%84%e5%af%a6%e6%88%b0%e6%a1%86%e6%9e%b6/ "用 AI Skills 快速做更好決定：/unstuck 與 /decide 的實戰框架") 2. [Anthropic 發表威脅情報報告：中國實驗室被指「工業級」蒸餾攻擊，揭露七類 AI 濫用個案](https://sammy.hk/anthropic-%e7%99%bc%e8%a1%a8%e5%a8%81%e8%84%85%e6%83%85%e5%a0%b1%e5%a0%b1%e5%91%8a%ef%bc%9a%e4%b8%ad%e5%9c%8b%e5%af%a6%e9%a9%97%e5%ae%a4%e8%a2%ab%e6%8c%87%e3%80%8c%e5%b7%a5%e6%a5%ad%e7%b4%9a%e3%80%8d/ "Anthropic 發表威脅情報報告：中國實驗室被指「工業級」蒸餾攻擊，揭露七類 AI 濫用個案") 3. [OpenAI、Anthropic、Google 私下合作 AI 安全數星期 反壟斷疑慮浮現](https://sammy.hk/openai%e3%80%81anthropic%e3%80%81google-%e7%a7%81%e4%b8%8b%e5%90%88%e4%bd%9c-ai-%e5%ae%89%e5%85%a8%e6%95%b8%e6%98%9f%e6%9c%9f%e3%80%80%e5%8f%8d%e5%a3%9f%e6%96%b7%e7%96%91%e6%85%ae%e6%b5%ae%e7%8f%be/ "OpenAI、Anthropic、Google 私下合作 AI 安全數星期　反壟斷疑慮浮現") 4. [OpenAI 暫停 Pro 訂閱註冊：Astra 需求遠超預期，基建承受前所未有壓力](https://sammy.hk/openai-%e6%9a%ab%e5%81%9c-pro-%e8%a8%82%e9%96%b1%e8%a8%bb%e5%86%8a%ef%bc%9aastra-%e9%9c%80%e6%b1%82%e9%81%a0%e8%b6%85%e9%a0%90%e6%9c%9f%ef%bc%8c%e5%9f%ba%e5%bb%ba%e6%89%bf%e5%8f%97%e5%89%8d%e6%89%80/ "OpenAI 暫停 Pro 訂閱註冊：Astra 需求遠超預期，基建承受前所未有壓力")