.cursorrules vs CLAUDE.md vs AGENTS.md：你需要哪種 AI 編碼規則檔案？

每個 AI 編碼工具都想要一個包含你專案規則的 Markdown 檔案。但它們都想要不同的 Markdown 檔案。

如果你同時使用多種 AI 工具（大多數開發者都是這樣），這會很快令人困惑。以下是確定你需要哪些檔案以及每個檔案放什麼內容的權威指南。

檔案概覽

檔案	工具	位置	範圍
AGENTS.md	通用（所有工具）	專案根目錄	所有 AI 代理的共享規則
CLAUDE.md	Claude Code	專案根目錄	Claude 專用指令
.cursor/rules/*.md	Cursor	.cursor/rules/ 目錄	Cursor 專用規則
.github/copilot-instructions.md	GitHub Copilot	.github/ 目錄	Copilot 專用指令
.windsurf/rules	Windsurf	.windsurf/ 目錄	Windsurf 專用規則
JULES.md	Google Jules	專案根目錄	Jules 專用指令

AGENTS.md：通用標準

最適合： 使用多種 AI 工具的團隊、開源專案

AGENTS.md 是我們擁有的最接近通用標準的檔案。它現在被超過 60,000 個程式碼庫使用，由 Linux 基金會的 Agentic AI Foundation 負責管理（與 MCP 和 goose 一起）。

將共享指令放在這裡——每個 AI 工具都應該知道的內容：

• 專案結構和架構
• 建構和測試命令
• 程式碼風格約定
• 常見模式和反模式
• 相依項和設定步驟

每個主要的 AI 編碼工具都會讀取 AGENTS.md，使其成為專案 AI 指令的唯一真實來源。

CLAUDE.md：Claude Code 的記憶

最適合： Claude Code 使用者、基於 Anthropic 的標準化團隊

CLAUDE.md 在每次 Claude Code 會話開始時自動讀取。它支援一些 Claude 專用功能，如記憶持久化和會話上下文。

在 CLAUDE.md 中使用：

• Claude 專用行為調整
• 只有 Claude Code 支援的功能
• 覆蓋或擴充 Claude 的 AGENTS.md

推薦模式：共享規則放在 AGENTS.md，Claude 專用補充放在 CLAUDE.md。

.cursorrules / .cursor/rules/：Cursor 的方式

最適合： Cursor 使用者、以 Cursor 為主要 IDE 的團隊

Cursor 最初使用單個 .cursorrules 檔案，後來演變為 .cursor/rules/ 目錄以實現更精細的控制。目錄中的每個檔案都是 Cursor 應用的單獨規則。

在 Cursor 規則中使用：

• Cursor 專用代理行為
• Cursor 的 Composer 和 Agent 模式規則
• 特定檔案類型的指令（例如 .tsx 與 .py 的不同規則）

copilot-instructions.md：GitHub 的約定

最適合： GitHub Copilot 使用者、以 GitHub 為中心的工作流程

GitHub Copilot 讀取 .github/copilot-instructions.md 獲取專案級指令。它遵循 GitHub 將設定放在 .github/ 目錄的約定。

推薦設定

對於大多數專案，你最多需要兩個檔案：

如果你使用一種 AI 工具：

只使用該工具的原生檔案（Claude Code 使用 CLAUDE.md，Cursor 使用 .cursor/rules/ 等）。

如果你使用多種 AI 工具：

1. AGENTS.md — 所有共享規則（架構、建構命令、約定）
2. 工具特定檔案 — 僅適用於該工具獨有功能

範例結構：

your-project/
  AGENTS.md              # 共享：建構命令、架構、約定
  CLAUDE.md              # Claude 專用：記憶偏好、工具使用
  .cursor/rules/style.md # Cursor 專用：composer 行為
  .github/copilot-instructions.md  # Copilot 專用

規則檔案中應包含什麼

根據對數千個程式碼庫的分析，最有效的指令檔案包含：

始終包含：

• 如何建構和執行專案
• 如何執行測試
• 關鍵架構決策
• 程式碼風格偏好

通常有用：

• 不應該做什麼（否定指令效果出奇地好）
• 檔案結構說明
• 常見除錯步驟
• 相依管理命令

跳過：

• 顯而易見的語言功能
• AI 已經知道的內容
• 過於詳細的規則（從最小化開始，按需新增）

用網路上下文建構你的 AI 規則

撰寫好的 AI 指令檔案通常需要引用外部文件、風格指南或架構模式。這就是以 Markdown 格式取得網路內容有所幫助的地方。

例如，如果你的專案遵循文件頁面中的特定 API 模式，你可以：

1. 使用 Save 將該文件頁面轉換為 Markdown
2. 在 AGENTS.md 中引用或摘錄相關部分
3. 你的 AI 編碼助手現在擁有完整上下文

同樣適用於框架文件、風格指南、最佳實踐文章和 Stack Overflow 解決方案。乾淨的 Markdown 是你和你的 AI 工具都能最有效使用的格式。

結論

AI 編碼規則生態系統仍在演變，但規律很清晰：一切都是 Markdown。無論你使用一種工具還是五種，你專案的 AI 指令都存在於版本控制、人類可讀、機器可解析的 Markdown 檔案中。

從 AGENTS.md 開始設定通用規則，按需新增工具特定檔案，並保持一切最小化，直到你看到值得解決的重複問題。

---

Save 將任何網頁轉換為乾淨的 Markdown——非常適合建構你的 AI 編碼助手所需的參考材料和文件上下文。免費試用 Save。