Cursor Rules vs CLAUDE.md vs AGENTS.md：我把同一份設定檔分別跑過這三種（2026）
cursor rules vs claude md 這個問題本身藏著一個陷阱：它們並不是讓你二選一的兩個選項。它們是兩個檔案，由兩個不同的工具讀取，只是剛好做著同一件事。把 CLAUDE.md 丟進 Cursor 專案裡，Cursor 會直接無視它。把 AGENTS.md 丟進 Claude Code，同樣什麼事也不會發生。這點連我們也很驚訝。AGENTS.md 如今已存在於 60,000 多個 repo 中，作為開放標準，由 Linux Foundation 底下的 Agentic AI Foundation 維護，但 Claude Code 仍然不會主動讀取它。以下是相容性對照表，已在我們的 repo 上實測過。
重點整理
- Cursor 讀取
.cursor/rules/*.mdc和AGENTS.md，但不讀CLAUDE.md。 - Claude Code 只讀
CLAUDE.md，原生不讀AGENTS.md。 - 想共用同一個檔案：把
AGENTS.md符號連結到CLAUDE.md，或用@AGENTS.md匯入。 - 以
AGENTS.md為標準（開放標準、60k+ repo），再針對各工具加上專屬覆寫。
你該用哪種設定格式？30 秒決策
依團隊型態來選格式，別跟風。如果你只用一個工具，就用它的原生檔案。如果你用兩個以上，就把 AGENTS.md 當作唯一真相來源（source of truth），只在某個工具需要別人沒有的東西時，才加上該工具的專屬覆寫。光是這一條規則，就能化解大半的困惑。
| 你的情境 | 用這個 | 原因 |
|---|---|---|
| 單人，只用 Cursor | .cursor/rules/*.mdc | Glob 範圍限定、四種規則類型、原生支援 |
| 單人，只用 Claude Code | CLAUDE.md | Claude Code 唯一會載入的檔案 |
| 混合工具（Cursor + Claude Code + Codex） | AGENTS.md + 符號連結／匯入 | 一個檔案，每個工具都讀得到 |
| Monorepo、多個子專案 | AGENTS.md，依 package 巢狀放置 | 最近的檔案優先，子資料夾能自我描述 |
還在決定要先跑哪個助理，再來擔心它的設定？先從我們的指南開始：如何選擇要用的 AI 編碼代理，之後再回來看檔案設定。
真正關鍵的決策軸線是可攜性。.cursor/rules 檔案在 Cursor 裡很強大，在其他地方卻毫無用處。AGENTS.md 則能四處帶著走。所以，除非你打算永遠鎖死在一個工具上，否則與工具無關的檔案才是更穩妥的選擇。
每種格式到底是什麼（各 30 秒說明）
這三個檔案做的都是同一件事：在 AI 編碼工具寫下任何一行程式碼之前，先把你的專案規則、慣例和眉角交給它。差別在於誰會讀取它們，以及它們如何界定範圍。以下是簡短版本。每種格式的深入操作教學，都收在各自的指南裡。
Cursor Rules 是放在 .cursor/rules/ 裡的 .mdc 檔案。Cursor 支援四種規則類型（always-on、agent-requested、glob-scoped，以及手動 @ 提及），所以你可以把規則只套用到 *.tsx 檔，或只套用到 migration。關於 frontmatter、glob 和 token 預算，請閱讀我們的指南：如何真正寫好 .cursor/rules 檔。
CLAUDE.md 是 Claude Code 的記憶檔案。Claude 會從你的工作資料夾沿著目錄樹往上爬，把找到的每個 CLAUDE.md 串接起來。它是純 Markdown，不需要 frontmatter。關於結構，以及如何避免 Claude 無視它的規則，請看：什麼樣的 CLAUDE.md 才不會被 Claude 忽略。
AGENTS.md 是開放標準。一個放在 repo 根目錄的純 Markdown 檔案，由 Cursor、Codex、Copilot、Windsurf、Zed、Aider 以及數十種工具原生讀取。它由 Agentic AI Foundation 維護，已存在於 60,000 多個專案中。
這裡有個值得記住的重新框架：AGENTS.md、CLAUDE.md 和 .cursor/rules 不是競爭對手，它們是同一條指令，只是寫給不同的讀者。
Cursor Rules vs CLAUDE.md vs AGENTS.md：完整對照
要看出差異，最快的方式就是並排比較。決定性的一欄是可攜性：哪些工具不需額外設定就會讀取這個檔案。AGENTS.md 在涵蓋範圍上勝出，Cursor Rules 在範圍精準度上勝出，而 CLAUDE.md 則適合所有全力押注 Claude Code 的人。
| 格式 | 檔案路徑 | 會讀取的工具 | 範圍 | 優先順序模型 | 可攜性 |
|---|---|---|---|---|---|
| Cursor Rules | .cursor/rules/*.mdc | 僅 Cursor | Glob 範圍限定、四種規則類型 | Team → Project → User，合併 | 低（僅 Cursor） |
| CLAUDE.md | CLAUDE.md（任何目錄） | 僅 Claude Code | 目錄往上爬、串接 | 累加，最近的檔案優先 | 低（僅 Claude） |
| AGENTS.md | AGENTS.md（根目錄 + 子目錄） | Cursor、Codex、Copilot、Windsurf、Zed、Aider 及 20+ | 整個專案或巢狀 | 樹中最近的檔案優先 | 高（開放標準） |
| .cursorrules（舊制） | .cursorrules（根目錄） | Cursor（未記載於文件） | 單一根目錄檔案 | 僅根目錄 | 低，軟性棄用 |
| SKILL.md（新興） | .claude/skills/*/SKILL.md | Claude（Skills） | 隨需、依任務觸發 | 呼叫時載入 | Claude 專屬，持續演進 |
注意 .cursorrules 那一列。那個單一根目錄檔案在 Cursor 裡仍然能用，但它已從文件中移除，所以請把它視為舊制。新專案應該改用 .cursor/rules/*.mdc 或 AGENTS.md。
哪個工具讀哪個檔案？（破解 AGENTS.md 的迷思）
這裡有個半個網路都搞錯的事實：Claude Code 原生不讀 AGENTS.md，Cursor 也不讀 CLAUDE.md。 Cursor 讀取 .cursor/rules/*.mdc 加上 AGENTS.md。Claude Code 讀取 CLAUDE.md，其他都不讀。兩個方向都沒有自動 fallback，這讓那些以為一個標準檔案就能搞定一切的團隊栽了跟頭。
這個問題一直被反覆詢問，所以我們直說吧。把 AGENTS.md 丟進 Claude Code 專案，本身什麼作用都沒有。Claude Code 讀的是 CLAUDE.md，而且只讀 CLAUDE.md。 Anthropic 的 Claude Code 記憶文件 描述了檔案載入行為，卻完全沒提到 AGENTS.md；AGENTS.md 規範 把 Cursor 和 Codex 列為原生讀者，但沒有 Claude Code；Cursor 自己的規則文件 證實了這個分流；而 Claude Code 的 GitHub issues 裡滿是撞上這堵牆的開發者。
所以 Cursor 會讀 claude.md 嗎？不會。Claude Code 會讀 agents.md 嗎？沒有幫忙就不會。那個「幫忙」正是這篇文章存在的全部理由，而它就是接下來你會看到的兩道簡短指令。
優先順序與巢狀結構如何運作，並排來看
每個工具化解衝突的方式都不同，而搞錯這點正是「為什麼我的規則被無視了？」這類困惑的頭號來源。Cursor 依來源優先順序合併規則。Claude Code 依目錄深度串接。AGENTS.md 則挑樹中最近的檔案。好的 claude md management 始於搞清楚自己身處哪種心智模型。
| 工具 | 如何載入 | 衝突時的贏家 |
|---|---|---|
| Cursor | Team、Project、User 規則合併在一起 | 較早的來源（Team）優先 |
| Claude Code | 從 cwd 往上爬，串接每個 CLAUDE.md | 最近／最具體的檔案優先；managed file 先載入 |
| AGENTS.md | 讀取目錄樹中最近的 AGENTS.md | 離工作目錄最近的檔案優先 |
在我們的設定中，實際結論很簡單：把寬泛的規則放高處（repo 根目錄），把具體的規則放低處（package 資料夾內）。對 Claude Code 和 AGENTS.md 而言，離你工作位置最近的檔案優先，所以 packages/api/AGENTS.md 會覆寫根目錄那份，適用於該資料夾內的一切。Cursor 是特例，它依來源層級解析，而非依資料夾深度。
我們把同一份設定檔跑過 Cursor + Claude Code，以下是每個工具實際載入的內容
我們在一個 Techsy 客戶的實際 repo（Next.js 15 後端）上測試，使用 Cursor 3.7（2026 年 6 月 17 日 build）和 Claude Code v2.1.x（2026 年 7 月初）。一份 AGENTS.md，三種共用設定，同一個 prompt 在兩個工具中開啟。以下是每個工具實際拉進來的內容。
我們從一個最小檔案開始：
# AGENTS.md
- Package manager: pnpm, never npm.
- Tests: Vitest. Run `pnpm test` before any commit.
- DB access goes through `lib/db.ts` only, no inline SQL.設定 1：只有 AGENTS.md。 Cursor 立刻就抓到了。該檔案出現在它的 context 中，而且它正確地拒絕建議 npm install。Claude Code 則完全沒理它。在 Claude Code 裡執行 /memory，列出的專案記憶檔案是零個：找不到 CLAUDE.md，而 AGENTS.md 甚至連被承認都沒有。確認完畢：沒有原生 fallback。
設定 2：符號連結。 我們把 CLAUDE.md 指向同一個檔案：
ln -s AGENTS.md CLAUDE.md現在 Claude Code 裡的 /memory 把 ./CLAUDE.md 列為 Project memory，而載入的內容與我們的 AGENTS.md 逐位元組一致。Cursor 仍然直接讀取 AGENTS.md。一個實體檔案，兩個工具都滿意。在 Windows 上，這需要啟用管理員或開發者模式，否則 ln／mklink 會靜默失敗。
設定 3：@import。 我們刪掉符號連結，改在一個真正的 CLAUDE.md 最頂端放入單單一行：
@AGENTS.md接著 /memory 顯示 CLAUDE.md 為已載入檔案，而 AGENTS.md 作為匯入的參考被拉在其下。這才是 Anthropic 實際記載在文件中的做法，而且不需要任何特殊的 OS 權限。
我們測試的結論： 符號連結讓 Claude Code 逐位元組讀取 AGENTS.md；@AGENTS.md 匯入則是 Anthropic 實際推薦、Windows 也安全的版本。兩者都能給你單一真相來源。在 macOS／Linux 上選符號連結，零間接層級；如果團隊裡有人在 Windows 上，就用匯入那一行。
在格式之間遷移：.cursorrules → .cursor/rules → AGENTS.md
大多數團隊來到這裡時，手上都有一份舊制 .cursorrules 檔案，想逃出單一檔案的陷阱。無論往哪個方向，遷移都很短，而且動作都能直接複製貼上。唯一會咬人的眉角：.cursor/rules 裡一個沒有 frontmatter 的 .md 檔會被靜默忽略，所以它必須是 .mdc。
要把舊的 .cursorrules 現代化，你有兩條乾淨的路：
- 轉到
.cursor/rules/*.mdc： 建立.cursor/rules/general.mdc，加上 frontmatter（全域規則用alwaysApply: true），再把舊內容貼在下方。驗證過後刪掉.cursorrules。 - 轉到
AGENTS.md（推薦給多工具團隊）： 要把 cursorrules 轉成 agents.md，把.cursorrules的主體複製到 repo 根目錄一個新的AGENTS.md裡。不需要 frontmatter；它就是純 Markdown。然後加上符號連結或@AGENTS.md匯入，讓 Claude Code 也讀得到。
如果你打算待在 Cursor 裡，並想從中榨出更多價值，我們的指南 在日常工作中更善用 Cursor 涵蓋了實務上的規則範圍限定。
反過來走（AGENTS.md → CLAUDE.md）就只是上一節的符號連結或匯入。沒有任何有損轉換，因為這三者骨子裡都是 Markdown。
SKILL.md 和 Copilot Instructions 擺在哪？
還有兩種格式會出現在這場對話裡，而 skills md 現在是個爆紅的搜尋詞，所以值得快速定位一下。兩者都沒有取代那三個主要檔案；它們是並列存在的。
SKILL.md 是 Anthropic 的 Skills 格式：打包在 .claude/skills/*/SKILL.md 裡、針對特定任務的指令，當任務匹配時 Claude 會隨需載入，而不是像 CLAUDE.md 那樣 always-on。把它想成 Claude 會伸手去拿的專屬劇本，而非全專案的記憶檔案。其範圍仍在演進，所以別太早重押。關於它如何融入實際工作流程，請看 CLAUDE.md 在實際 Claude Code 工作流程中的位置。
Copilot instructions 放在 .github/copilot-instructions.md，給 GitHub Copilot 用。好消息：Copilot 也會讀 AGENTS.md，所以如果你已經以開放標準為標準，Copilot 就已經涵蓋在內，不需要另外一個檔案。
你該用哪個？（依團隊型態）
把格式對應到你團隊實際的運作方式：
- 單人 Claude Code 使用者： 直接用
CLAUDE.md。除非你打算之後引入 Cursor 或 Codex，否則沒理由加上 AGENTS.md。 - 單人 Cursor 使用者： 用
.cursor/rules/*.mdc取得 glob 範圍限定，或從第一天就想要可攜性的話，用單一AGENTS.md。 - 混合工具團隊： 一個
AGENTS.md作為唯一真相來源，符號連結或匯入到CLAUDE.md。只針對 Cursor 專屬行為加一個小的.cursor/rules檔。 - Monorepo： 根目錄一個
AGENTS.md，加上每個 package 的巢狀檔案，讓每個子專案自我描述，且最近的檔案優先。
在 Techsy，我們在混合工具團隊間將 AI 編碼設定標準化，通常是一個 AGENTS.md 作為唯一真相來源，再於工具需要之處加上專屬覆寫。如果你的團隊正親手喬三份設定檔，預約免費諮詢，我們會替你規劃出來。
最後一個指引：這篇文章比較的是設定檔案。如果你其實是想在工具本身之間做選擇，請閱讀 比較助理本身，而非它們的設定。
關於作者
Mert Batur Gurbuz 是 Techsy.io 的共同創辦人，團隊在此為 B2B 客戶打造 AI 代理、自動化系統以及語音／SDR 流程。他於 University of Birmingham 就讀，並撰寫 Techsy 團隊在生產環境中實際使用的 LLM 工具堆相關文章。
共同創辦人，Techsy.io · University of Birmingham · LinkedIn
常見問題
Cursor 會讀 CLAUDE.md 嗎？
不會。Cursor 原生讀取 .cursor/rules/*.mdc 和 AGENTS.md，但 CLAUDE.md 從沒出現在 Cursor 的文件中，也不會被載入。如果你用 Cursor，又想和 Claude Code 使用者共用設定，把規則放進 AGENTS.md（Cursor 確實會讀），而不是 CLAUDE.md。
Claude Code 會讀 AGENTS.md 嗎？
原生不會。Claude Code 只讀 CLAUDE.md，沒有自動 fallback 到 AGENTS.md。要讓它運作，要嘛把檔案符號連結起來（ln -s AGENTS.md CLAUDE.md），讓 Claude 逐位元組讀取 AGENTS.md；要嘛在 CLAUDE.md 第 1 行加上 @AGENTS.md 來匯入。匯入是 Anthropic 推薦、Windows 也安全的選項。
我能三個工具就只用一個檔案嗎？
可以。把 AGENTS.md 當作你唯一的真相來源，Cursor 和 Codex 就會直接讀取。對 Claude Code，加上一座橋：要嘛把 AGENTS.md 符號連結到 CLAUDE.md，要嘛在 CLAUDE.md 頂端放上 @AGENTS.md。你只維護一個檔案，每個工具都載入相同的規則。這就是「共用一份設定」的完整做法。
.cursorrules 被棄用了嗎？
軟性棄用。repo 根目錄的單一檔案 .cursorrules 在 Cursor 裡仍然能用，但它已不再出現在官方文件中，這通常是某個格式即將退場的信號。新專案應該用 .cursor/rules/*.mdc 做範圍限定的規則，或用 AGENTS.md 取得可攜性。
我如何把 .cursorrules 轉成 AGENTS.md？
把 .cursorrules 檔的主體複製到 repo 根目錄一個新的 AGENTS.md 裡。它是純 Markdown，所以不需要 frontmatter 或重新排版。然後加上符號連結或 @AGENTS.md 匯入，讓 Claude Code 也讀得到，並在確認 Cursor 抓到新檔後，刪掉舊的 .cursorrules。
CLAUDE.md 和 AGENTS.md 有什麼差別？
CLAUDE.md 是 Claude Code 專有的記憶檔案，只有 Claude Code 會讀。AGENTS.md 是開放標準，由 Cursor、Codex、Copilot 和 20 多種工具讀取，但 Claude Code 原生不讀。同樣的 Markdown 格式，同樣的工作。差別在於涵蓋範圍。AGENTS.md 能跨工具帶著走；CLAUDE.md 則待在 Claude Code 裡。
使用多個 AI 工具的團隊，該以哪種格式為標準？
AGENTS.md。它是開放標準，由多數工具原生讀取，且已存在於 60,000 多個 repo。在那裡標準化你的共用規則，用符號連結或匯入把它橋接進 Claude Code，並只在某個工具需要別人沒有的行為時，才加上小的工具專屬檔案（如 .cursor/rules）。
當我有巢狀設定檔時，優先順序如何運作？
對 Claude Code 和 AGENTS.md 而言，離工作目錄最近的檔案優先，所以 packages/api/AGENTS.md 裡的規則會覆寫 repo 根目錄那份，適用於該資料夾內的一切。Cursor 不同：它依來源層級合併 Team、Project、User 規則，而非依資料夾深度，由較早的來源贏得衝突。
SKILL.md 擺在哪？
SKILL.md 是 Anthropic 新興的 Skills 格式：放在 .claude/skills/*/SKILL.md 裡、針對特定任務的指令，當任務匹配時 Claude 會隨需載入，而不是像 CLAUDE.md 那樣 always-on。它是 CLAUDE.md 的補充，而非取代。其範圍在 2026 年仍在演進，所以把它當作專屬的附加元件，而非每個專案都需要的第四個檔案。