AGENTS.md 是什麼？一份給 AI 看的 README，為什麼 Codex、Claude Code、Copilot 都在用

2天前

讀畢需時 7 分鐘

AGENTS.md 是一個開放、極簡的 Markdown 檔案格式，作用是把「怎麼在這個專案裡正確工作」的細節——像是建置指令、測試指令、程式碼風格、PR 規範——集中寫在一個固定位置，讓 AI 程式碼代理（coding agent）在動手改程式碼之前，能自己讀到這些脈絡，而不需要你在每次對話裡重新交代一遍。它由 OpenAI 於 2025 年 8 月釋出，2025 年 12 月 9 日與 Anthropic 的 MCP、Block 的 goose 一起被捐給 Linux Foundation 新成立的 Agentic AI Foundation（AAIF），目前已被超過 6 萬個開源專案採用。如果你的團隊已經在用 AI 寫程式，這篇文章把 AGENTS.md 到底是什麼、跟 MCP／A2A／Agent Skills 這些協定的分工在哪裡、以及 Claude Code 到底支不支援它，一次講清楚。

AGENTS.md 是什麼？為什麼不直接寫進 README.md？

根據 agents.md 官方網站的說明，AGENTS.md 可以理解成「一份寫給 Agent 看的 README」：README.md 是寫給人看的，內容是快速上手、專案介紹、貢獻指南；AGENTS.md 則是刻意獨立出來，放那些會讓 README 變得又臭又長、但 AI 代理工作時真正需要的細節，例如安裝依賴的指令、啟動開發伺服器的指令、跑測試的指令、程式碼風格規範，以及安全性注意事項。

官方刻意把兩者分開，理由有三個：讓 Agent 有一個明確、可預期的指示存放位置；讓 README 保持給人類看的簡潔；以及提供精確、以 Agent 為導向的指引，補足既有 README 與文件涵蓋不到的細節。格式上沒有強制欄位——它就是純 Markdown，你想用什麼標題都可以，Agent 只是把裡面的文字內容讀進去解析。

一份檔案，為什麼十幾種不同的 AI 工具都看得懂？

AGENTS.md 最初由 OpenAI Codex、Amp、Google Jules、Cursor、Factory 幾家工具共同推動，目的就是解決「每一種 Agent 工具都要求你寫一套自己格式的設定檔」這個麻煩。根據官方頁面列出的相容清單，目前包括 OpenAI Codex、Google Jules、Factory、Aider、goose、opencode、Zed、Warp、VS Code、Cognition 的 Devin、UiPath、JetBrains Junie、Amp、Cursor、RooCode、Google Gemini CLI、Kilo Code、GitHub Copilot 的 Coding Agent、Ona、Windsurf、Augment Code 等十幾個平台，都會直接讀取同一份 AGENTS.md。

實務上的運作規則也很單純：Agent 會自動讀取目錄樹裡離目前工作檔案最近的那一份 AGENTS.md；如果是大型 monorepo，你可以在每個子專案裡各放一份，越靠近的那份優先權越高——官方文件舉例，OpenAI 自己的主要程式庫裡就有 88 份分散在不同子目錄的 AGENTS.md。

AGENTS.md 是怎麼從一家公司的內部工具變成產業標準的？

AGENTS.md 的治理演進時間線，是這篇文章特別要提醒你注意的地方，因為它剛好發生在多數人訓練記憶的知識截止日之後：

2025 年 8 月：OpenAI 釋出 AGENTS.md，起初只是為了讓 Codex 有個固定的地方讀取專案的建置與測試指令。
2025 年 12 月 9 日：Linux Foundation 宣布成立 Agentic AI Foundation（AAIF），由 OpenAI、Anthropic、Block 共同創辦，並取得 Google、Microsoft、AWS、Bloomberg、Cloudflare 的支持。三個創始專案分別是 OpenAI 捐出的 AGENTS.md、Anthropic 捐出的 Model Context Protocol（MCP）、以及 Block 捐出的開源 Agent 框架 goose。
會員結構：AAIF 的白金會員包含 Amazon Web Services、Anthropic、Block、Bloomberg、Cloudflare、Google、Microsoft、OpenAI；黃金會員包含 Adyen、Cisco、Datadog、Docker、IBM、JetBrains、Okta、Oracle、Salesforce、SAP、Shopify、Snowflake 等十八家企業；白銀會員則包含 Apify、Hugging Face、Uber、WorkOS、Zapier、Zed 等二十餘家。

換句話說，AGENTS.md 現在不是任何一家公司說了算的私有規格，而是由中立的 Linux Foundation 底下的 AAIF 治理，跟同樣捐給 AAIF 的 MCP 是「同一個治理架構下的兩個不同專案」。

AGENTS.md 跟 MCP、A2A、Agent Skills 差在哪？別再搞混了

如果你已經讀過本站介紹 MCP、A2A、Agent Skills 的文章，這四者常常被放在一起討論，但實際上分別解決完全不同層次的問題，你可以這樣記：

AGENTS.md 解決的是「靜態專案脈絡」——一次寫好、多個工具共用的建置與規範說明，本質上是一份文件，不是程式或連線。MCP（Model Context Protocol）解決的是「Agent 怎麼連上外部工具與資料」，是一套需要伺服器與用戶端的連線協定。A2A（Agent2Agent）解決的是「不同公司做出來的 Agent，怎麼互相委派任務」，是一套 Agent 對 Agent 的通訊標準。Agent Skills 解決的是「怎麼把一段可重複執行的能力打包成資料夾，讓 Agent 需要時才載入」，是一種漸進式揭露的技能封裝格式。

四者當中，AGENTS.md 是唯一一份純文字、不需要任何伺服器或執行環境就能運作的規格，這也是它能夠被十幾種完全不同架構的工具同時支援的原因。

Claude Code 到底讀不讀 AGENTS.md？

這是很多正在用 Claude Code 的開發者會問的問題，答案是：目前不會直接讀。根據 Claude Code 官方文件（code.claude.com/docs/en/memory）明確寫著：「Claude Code 讀的是 CLAUDE.md，不是 AGENTS.md。」如果你的專案已經有 AGENTS.md 給其他工具用，官方建議兩種做法讓 Claude Code 也吃得到同一份內容，而不用維護兩份重複的文件：

第一種是在 CLAUDE.md 裡用 `@AGENTS.md` 語法匯入，你還可以在匯入語法下方加上只給 Claude Code 看的專屬指示。第二種是直接建立符號連結（symlink），指令是 `ln -s AGENTS.md CLAUDE.md`，這樣兩個檔名實際上指向同一份內容；官方文件特別提醒 Windows 使用者，建立符號連結需要系統管理員權限或開發者模式，所以 Windows 上建議還是用 `@AGENTS.md` 匯入語法。

另外，官方文件也提到 Claude Code 的 `/init` 指令在產生 CLAUDE.md 時，本來就會參考 Cursor 規則、GitHub Copilot 規則；如果設定環境變數 `CLAUDE_CODE_NEW_INIT=1`，`/init` 還會進一步讀取 AGENTS.md 等其他工具的規則檔一併整合。另外還有一個 `/import` 指令可以把支援的 Agent 設定（包括 AGENTS.md）一次性匯入並合併進 CLAUDE.md，官方標註此功能需要 Claude Code v2.1.213（含）以上版本。

企業或團隊該不該導入 AGENTS.md？從哪裡開始寫

如果你的團隊同時有多個工具在用（例如一部分工程師用 Cursor、一部分用 Copilot、一部分用 Claude Code），AGENTS.md 的價值在於一份文件多工具共用，省去重複維護的麻煩。官方建議的起手式很單純：在專案根目錄建立一個 `AGENTS.md`，涵蓋幾個常見區塊：專案概觀、建置與測試指令、程式碼風格規範、測試流程說明、資安注意事項；也可以把 Commit 訊息格式、PR 規範、部署步驟這類「你會交代給新同事的事」一併寫進去。

大型 monorepo 的做法是在每個子專案資料夾各放一份，讓 Agent 自動套用離它最近的那一份規則，不用把所有子專案的細節塞進同一個巨大檔案裡。

導入前要注意的限制：它是脈絡，不是強制規則

在把 AGENTS.md（或 CLAUDE.md）當成企業治理工具之前，有一個限制務必先弄清楚：這類檔案的內容是以「上下文」的形式餵給模型參考，不是像防火牆規則那樣被強制執行的設定。換句話說，如果你需要的是「無論如何都要擋下某個操作」，這種需求應該交給程式碼倉庫的存取控制、審核流程或系統層級的權限管制去把關，而不是寫一行指示在 AGENTS.md 裡就期待它百分之百被遵守。

同時，由於 AGENTS.md 會被 Agent 自動讀取並當成指示的一部分，如果你的專案會拉入外部或不受信任的程式碼庫，也應該把裡面的 AGENTS.md 內容當成需要人工檢視的輸入來源，而不是預設信任，這是採用任何「Agent 自動讀取的設定檔」機制時都適用的通用注意事項，並非 AGENTS.md 獨有的漏洞。

常見問題

AGENTS.md 會取代 README.md 嗎？ 不會。官方定位很清楚，兩者分工不同：README.md 給人看，AGENTS.md 給 Agent 看，建議兩者並存而不是二選一。

專案可以同時放 AGENTS.md 又放 CLAUDE.md 嗎？ 可以，而且這是官方建議的做法。你可以在 CLAUDE.md 裡用 `@AGENTS.md` 匯入既有的 AGENTS.md 內容，下面再加 Claude Code 專屬的補充指示，兩份檔案不用各自維護一次規則。

AGENTS.md 有規定的必填欄位或固定格式嗎？ 沒有。官方 FAQ 明確寫著它就是標準 Markdown，你想用什麼標題結構都可以，Agent 只是解析裡面的文字內容。

如果 AGENTS.md 裡的指示跟你在聊天視窗裡臨時給的指令衝突，以誰為準？ 依官方 FAQ，離目前編輯檔案最近的那份 AGENTS.md 優先權最高；但使用者在對話裡明確給出的指令，會凌駕所有 AGENTS.md 裡寫的內容。

Claude Code 現在到底支不支援 AGENTS.md？ 目前是不直接讀取，但官方提供 `@AGENTS.md` 匯入語法與符號連結兩種相容做法，另外 v2.1.213 以上版本可用 `/import` 指令把 AGENTS.md 內容一次性併入 CLAUDE.md。

企業導入 AGENTS.md 對資安或法遵有沒有風險？ AGENTS.md 本身只是文字指示、不具備強制執行力，企業如果需要不可繞過的操作限制，仍須另外透過系統權限、審核流程等機制把關；若專案會引入外部程式碼庫，建議將其中的 AGENTS.md 內容視為需要審視的輸入來源。實際合規需求建議另行諮詢企業內部法務或資安團隊，本文不構成法律意見。

資料來源聲明

本文所有規格、時間點與會員名單均查證自以下官方頁面（查證日期：2026-09-15）：agents.md 官方網站（https://agents.md/）；The Linux Foundation 官方新聞稿《Linux Foundation Announces the Formation of the Agentic AI Foundation (AAIF)》（發布日期 2025-12-09，https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation）；OpenAI 官方部落格《OpenAI co-founds the Agentic AI Foundation under the Linux Foundation》（發布日期 2025-12-09，https://openai.com/index/agentic-ai-foundation/）；Claude Code 官方文件〈How Claude remembers your project〉AGENTS.md 專節（https://code.claude.com/docs/en/memory）。