Claude Code 終於可以直接食到 AGENTS.md。由 2.1.277 開始，只要專案冇 CLAUDE.md，Claude Code 就會將 AGENTS.md 當成專案指令讀取。1

對於同時使用多個 AI 編程工具嘅團隊，呢個改動相當實際：原本要為 Claude Code 額外整一份 CLAUDE.md、用 symbolic link，或者喺 CLAUDE.md 寫 @AGENTS.md 匯入；而家採用共享 AGENTS.md 嘅 repo，喺冇 Claude 專用檔案嘅情況下可以直接用。10

預設規則：係後備，唔係自動合併

最重要係搞清楚兩個情況：

• 冇 CLAUDE.md： Claude Code 可以讀取 AGENTS.md 作專案指令。1
• 有 CLAUDE.md： CLAUDE.md 仍然係既有嘅 Claude Code 專案指令檔；官方今次所講嘅預設行為，唔係自動將兩份檔案合併。1

可以喺 Claude Code 輸入 /config，再到 Project instructions 更改相關行為。要留意，Amazon Bedrock、Google Vertex AI 同 Azure AI Foundry 上部署嘅 Claude Code，暫時未支援呢項功能。1

AGENTS.md 係乜？

AGENTS.md 係一個開放、以 Markdown 寫成嘅程式庫指引慣例，可理解為「畀 AI agent 睇嘅 README」。內容通常包括專案背景、安裝步驟、build 同測試指令、程式碼慣例，以及貢獻規則，等 coding agent 喺同一個 codebase 做嘢時有一致依據。1932

呢個格式源自多個 AI 編程工具團隊嘅協作，包括 OpenAI Codex、Amp、Google Jules、Cursor 同 Factory；現時由 Linux Foundation 旗下嘅 Agentic AI Foundation 管理。項目表示，已有超過 60,000 個開源程式庫 採用。1921

其生態系統列出嘅支援工具包括 OpenAI Codex、Google Jules、Cursor、GitHub Copilot coding agent、Gemini CLI、Aider、Zed、Warp、VS Code、Devin、JetBrains Junie、Factory、Goose 同 OpenCode 等。19 不過各工具點樣尋找檔案、處理子目錄規則或衝突，實際做法仍可能不同；有檔案唔代表每個工具都會用完全一樣嘅方式載入。

對跨工具協作有咩好處？

以前，如果團隊以 AGENTS.md 做共享規格，Claude Code 並唔會原生讀取，常見做法係：

1. 維護一份內容重複嘅 CLAUDE.md；
2. 將 CLAUDE.md symlink 去 AGENTS.md；或
3. 用一份只包含 @AGENTS.md 嘅精簡 CLAUDE.md。

呢啲都係舊有 workaround，因為當時 Claude Code 未有原生 AGENTS.md 支援。10

2.1.277 減少咗呢層維護成本：如果 repo 唔需要 Claude 專屬規則，一份共享 AGENTS.md 就可以同時向 Claude Code 同其他兼容工具交代基本要求。對於要喺 Codex、Cursor、Copilot 或 Gemini CLI 等工具之間切換嘅開發團隊，少咗一個容易不同步嘅設定點。

但唔好因此假設所有 agent 指令系統已經統一。團隊仍應逐個確認：工具會喺邊度搵檔案、子目錄規則點樣覆蓋，以及同時出現多份指令時嘅優先次序。

AGENTS.md 同 SKILL.md 唔係競爭關係

兩者用途不同，反而可以互補：

• AGENTS.md： 程式庫級、長駐嘅工作指引，例如 build 方法、測試要求、架構規範同提交守則。1932
• SKILL.md： Agent Skill 嘅核心檔案；技能係可重用嘅檔案系統套件，可包含指令、中繼資料同輔助資源，Claude 會喺任務相關時使用，提供專門工作流程或領域知識。3337

Claude Code 表示其 skills 跟隨跨工具嘅 Agent Skills 開放標準。按 Claude Code 文件，專案技能會放喺一個目錄中，例如 .claude/skills/<name>/SKILL.md。3739

簡單講：AGENTS.md 係「喺呢個 repo 做嘢時，平時要遵守乜」；SKILL.md 係「遇到某類工作時，可以按需要拎出嚟用嘅專門工具包」。

仍然未做到全面一致

今次更新只係加入專案指令檔嘅後備支援，唔代表 Claude Code 已經完全跟齊所有 agent 慣例。

例如，Claude Code 文件列明嘅專案 skill 位置係 .claude/skills/<name>/SKILL.md。2.1.277 嘅更新公告講到 AGENTS.md 專案指令，但冇宣布會搜尋 .agents/skills/ 目錄。137

同樣地，唔應將預設後備行為當成 CLAUDE.md 加 AGENTS.md 嘅自動 merge 規則。如果一個 repo 同時需要可攜嘅通用規則，以及 Claude Code 專用行為，最好明確寫出兩者嘅關係，而唔好單靠後備機制。

已有 CLAUDE.md 嘅專案，點樣安排較穩陣？

一個實用做法係：

1. 將跨工具、通用嘅程式庫規則放入 AGENTS.md；
2. 保留 CLAUDE.md，只放 Claude Code 專屬指令；
3. 如有需要，喺 CLAUDE.md 明確引用或匯入共享規則，唔好假設兩份檔案會自動一齊載入。

咁做可以保留 AGENTS.md 嘅可攜性，同時唔會將 Claude 專用 workflow 混入所有工具都要讀嘅規則。Claude Code 2.1.277 因而係一個重要嘅互通性改善：AGENTS.md 優先嘅 repo 而家可以直接配合 Claude Code，但各種指令檔與技能目錄嘅發現規則，暫時仍未完全劃一。

Claude Code 終於可以直接食到 AGENTS.md。由 2.1.277 開始，只要專案冇 CLAUDE.md，Claude Code 就會將 AGENTS.md 當成專案指令讀取。1

對於同時使用多個 AI 編程工具嘅團隊，呢個改動相當實際：原本要為 Claude Code 額外整一份 CLAUDE.md、用 symbolic link，或者喺 CLAUDE.md 寫 @AGENTS.md 匯入；而家採用共享 AGENTS.md 嘅 repo，喺冇 Claude 專用檔案嘅情況下可以直接用。10

預設規則：係後備，唔係自動合併

最重要係搞清楚兩個情況：

• 冇 CLAUDE.md： Claude Code 可以讀取 AGENTS.md 作專案指令。1
• 有 CLAUDE.md： CLAUDE.md 仍然係既有嘅 Claude Code 專案指令檔；官方今次所講嘅預設行為，唔係自動將兩份檔案合併。1

可以喺 Claude Code 輸入 /config，再到 Project instructions 更改相關行為。要留意，Amazon Bedrock、Google Vertex AI 同 Azure AI Foundry 上部署嘅 Claude Code，暫時未支援呢項功能。1

AGENTS.md 係乜？

AGENTS.md 係一個開放、以 Markdown 寫成嘅程式庫指引慣例，可理解為「畀 AI agent 睇嘅 README」。內容通常包括專案背景、安裝步驟、build 同測試指令、程式碼慣例，以及貢獻規則，等 coding agent 喺同一個 codebase 做嘢時有一致依據。1932

呢個格式源自多個 AI 編程工具團隊嘅協作，包括 OpenAI Codex、Amp、Google Jules、Cursor 同 Factory；現時由 Linux Foundation 旗下嘅 Agentic AI Foundation 管理。項目表示，已有超過 60,000 個開源程式庫 採用。1921

其生態系統列出嘅支援工具包括 OpenAI Codex、Google Jules、Cursor、GitHub Copilot coding agent、Gemini CLI、Aider、Zed、Warp、VS Code、Devin、JetBrains Junie、Factory、Goose 同 OpenCode 等。19 不過各工具點樣尋找檔案、處理子目錄規則或衝突，實際做法仍可能不同；有檔案唔代表每個工具都會用完全一樣嘅方式載入。

對跨工具協作有咩好處？

以前，如果團隊以 AGENTS.md 做共享規格，Claude Code 並唔會原生讀取，常見做法係：

1. 維護一份內容重複嘅 CLAUDE.md；
2. 將 CLAUDE.md symlink 去 AGENTS.md；或
3. 用一份只包含 @AGENTS.md 嘅精簡 CLAUDE.md。

呢啲都係舊有 workaround，因為當時 Claude Code 未有原生 AGENTS.md 支援。10

2.1.277 減少咗呢層維護成本：如果 repo 唔需要 Claude 專屬規則，一份共享 AGENTS.md 就可以同時向 Claude Code 同其他兼容工具交代基本要求。對於要喺 Codex、Cursor、Copilot 或 Gemini CLI 等工具之間切換嘅開發團隊，少咗一個容易不同步嘅設定點。

但唔好因此假設所有 agent 指令系統已經統一。團隊仍應逐個確認：工具會喺邊度搵檔案、子目錄規則點樣覆蓋，以及同時出現多份指令時嘅優先次序。

AGENTS.md 同 SKILL.md 唔係競爭關係

兩者用途不同，反而可以互補：

• AGENTS.md： 程式庫級、長駐嘅工作指引，例如 build 方法、測試要求、架構規範同提交守則。1932
• SKILL.md： Agent Skill 嘅核心檔案；技能係可重用嘅檔案系統套件，可包含指令、中繼資料同輔助資源，Claude 會喺任務相關時使用，提供專門工作流程或領域知識。3337

Claude Code 表示其 skills 跟隨跨工具嘅 Agent Skills 開放標準。按 Claude Code 文件，專案技能會放喺一個目錄中，例如 .claude/skills/<name>/SKILL.md。3739

簡單講：AGENTS.md 係「喺呢個 repo 做嘢時，平時要遵守乜」；SKILL.md 係「遇到某類工作時，可以按需要拎出嚟用嘅專門工具包」。

仍然未做到全面一致

今次更新只係加入專案指令檔嘅後備支援，唔代表 Claude Code 已經完全跟齊所有 agent 慣例。

例如，Claude Code 文件列明嘅專案 skill 位置係 .claude/skills/<name>/SKILL.md。2.1.277 嘅更新公告講到 AGENTS.md 專案指令，但冇宣布會搜尋 .agents/skills/ 目錄。137

同樣地，唔應將預設後備行為當成 CLAUDE.md 加 AGENTS.md 嘅自動 merge 規則。如果一個 repo 同時需要可攜嘅通用規則，以及 Claude Code 專用行為，最好明確寫出兩者嘅關係，而唔好單靠後備機制。

已有 CLAUDE.md 嘅專案，點樣安排較穩陣？

一個實用做法係：

1. 將跨工具、通用嘅程式庫規則放入 AGENTS.md；
2. 保留 CLAUDE.md，只放 Claude Code 專屬指令；
3. 如有需要，喺 CLAUDE.md 明確引用或匯入共享規則，唔好假設兩份檔案會自動一齊載入。

咁做可以保留 AGENTS.md 嘅可攜性，同時唔會將 Claude 專用 workflow 混入所有工具都要讀嘅規則。Claude Code 2.1.277 因而係一個重要嘅互通性改善：AGENTS.md 優先嘅 repo 而家可以直接配合 Claude Code，但各種指令檔與技能目錄嘅發現規則，暫時仍未完全劃一。