Claude Code 支援 AGENTS.md 了，還需要 CLAUDE.md 嗎？
Claude Code 從 2.1.277 開始支援 AGENTS.md，預設會在專案沒有 CLAUDE.md 等指令檔時作為備援載入，並提供選項切換載入模式。對於原本就以 AGENTS.md 為主的專案，現在可以直接使用，不必另外建立轉接檔。
我在前一篇〈AGENTS.md 怎麼寫？從整理 CLAUDE.md 談 Agent 指令檔的最佳實務〉中曾整理過兩者的差異。當時 Claude Code 尚未原生讀取 AGENTS.md，必須仰賴匯入語法或軟連結讓工具共用規範。
2026 年 9 月 18 日，Claude Code 團隊成員 Thariq 宣布加入支援，v2.1.277 更新紀錄也確認了這項變更。工具支援跟上之後，既有專案是否有必要搬遷？若 AGENTS.md 可以跨工具共用，不同工具的 Skills 又該如何整合？
Claude Code 支援 AGENTS.md，預設會怎麼讀？
這次更新最需要注意的細節是載入優先權。
根據 Claude Code 官方文件，只要工作目錄或上層目錄已經存在專案的 CLAUDE.md、.claude/CLAUDE.md 或 CLAUDE.local.md，預設就不會透過備援機制載入 AGENTS.md（家目錄的 ~/.claude/CLAUDE.md 不在此限）。也就是說，在已有這些指令檔的專案裡，光是新增一份 AGENTS.md，不會讓它自動生效。若想自動載入兩種檔案，可以調整 /config 的「Project instructions」；也可以保留預設設定，在 CLAUDE.md 裡用 @AGENTS.md 明確匯入。
此外，版本號並非唯一條件。發布紀錄註明 Bedrock、Vertex 與 Foundry 等託管環境尚未同步支援；另一方面，檔案能被工具讀取，也不等於模型在每次執行時都會百分之百遵循。在環境支援完備且經過驗收之前，不建議貿然刪除既有的轉接設定。
已經有兩份指令檔，該怎麼整合？
整合的方式取決於兩份檔案目前的內容分配。
若專案像本站一樣，AGENTS.md 僅作為純文字指標，提示完整規範位於 CLAUDE.md，實際內容始終集中在一處，就不存在同步問題。
真正需要處理的，是兩份檔案都包含完整規範、且內容已經各自演化的情況。例如 AGENTS.md 規定使用 pnpm，CLAUDE.md 卻寫著 npm；或是一份要求補寫測試，另一份卻載明無測試環境。此時單純將兩份檔案合併載入，只會造成規則衝突。
整理既有指令檔時，建議依序處理：
清理衝突與過時內容。 對照專案現行的指令與架構，先剔除失效資訊，不要直接拼接兩份文字，也不應預設較晚更新的檔案一定正確。
確立單一共用來源。 若專案同時由多種 agent 操作，建議將套件管理、建置指令、架構限制等跨工具共用的規範集中放在
AGENTS.md，後續只在這裡維護。CLAUDE.md 僅保留專屬補充。 若專案仍有 Claude Code 專用的指示，可保留
CLAUDE.md，並在檔案開頭透過@AGENTS.md匯入共用規範，避免重複貼上。確認有讀到，再考慮刪除轉接檔。 當
CLAUDE.md只剩一行匯入，且團隊所有工作環境都確認能直接讀取AGENTS.md時，再評估是否移除該檔。
整理後的架構如下：
AGENTS.md → 共用的建置、測試與專案規範
CLAUDE.md → 匯入 AGENTS.md，再放 Claude Code 專用補充CLAUDE.md 的內容即為：
@AGENTS.md
## Claude Code 補充
<!-- 只放此工具需要的補充指示，不重複共用規範。 -->這是 官方建議的共用方式。但若原本是由 AGENTS.md 指向 CLAUDE.md，調整方向時需同步清除舊的參照文字，避免兩邊形成循環參照。
要確認檔案有沒有讀到，採用 @ 匯入時可查看 /context 的 Memory files；若採用預設的備援模式，則依官方文件查看 AGENTS.md loaded 提示。兩者的確認位置不同，檢查時需留意區別。
整理完之後，怎麼避免又養出兩份規範？
劃分規則歸屬的原則很單純：換一個 agent 接手，這條規則是否依然需要遵守？
只要是專案層級的硬性要求（例如文章 frontmatter 必填欄位、建置 scripts），都應收在共用的 AGENTS.md；只有工具特有的操作機制，才留在個別的補充檔中。
開發者個人的操作習慣應放置於全域個人設定，不該寫入專案檔案；權限控管與連線憑證則維持各工具的原生機制，不屬於指令檔範疇。
維護時機應與程式碼變更同步。修改了 script 就在同一個 PR 更新相關文件，搬動了目錄就修正路徑。先前整理 CLAUDE.md 時，我就發現裡面對 Layout.vue 的描述已經過時。把這段文字搬入 AGENTS.md，內容也不會自動變正確；共用來源讓我們只需要維護一處，仍然要有人確認內容。
對於本站這類規範本就單一的專案，改用新檔名能省下的維護成本有限。新專案可優先採用 AGENTS.md；既有專案運作正常時，沒有單純為了變更檔名而全面搬遷的必要。
AGENTS.md 可以共用，Skills 呢？
除了指令檔，Skills 的跨工具相容性也是實務上的重點。過去常將 Skills 視為特定工具的專有擴充，但目前 Agent Skills 已形成開放標準。
該標準規範使用包含 SKILL.md 的目錄來打包特定任務，並可隨附腳本與參考文件。目前 Claude Code 與 Codex 官方文件 皆已支援這套格式。
在專案分工上，AGENTS.md 提供適用範圍內常用的規範，例如專案架構與建置方式；校稿 Skill 則整理發布前的格式與詞彙檢查，等需要校稿時再載入。這些內容都是給模型遵循的指示，需要強制執行的限制，仍要交給測試、CI 或權限設定處理。
即使共用格式，實際使用時仍有幾個差別。
同一份內容，工具找得到嗎？
目前 Codex 預設尋找專案 Skills 的路徑是 .agents/skills，Claude Code 則是 .claude/skills。雖然兩者都識別 SKILL.md，但搜尋路徑並不一致。
雖然 Agent Skills 實作指南 建議工具支援 .agents/skills，但尚未成為強制規範。現行做法可建立單一的 Skill 目錄，再以軟連結（Symlink）對應至各工具的預設目錄，但需確保團隊的作業系統與環境能正常處理符號連結。
找得到之後，裡面的步驟都能執行嗎？
共用性取決於 Skill 依賴的功能範圍。
文字校對、規範檢查或操作說明等通用流程，通常較容易跨工具共用，仍須確認格式、觸發方式與執行環境。若使用了工具的專屬功能，更要逐項確認另一個工具是否支援。
例如 Claude Code 支援在 Skill 中設定 context: fork 以啟動獨立子代理執行，此類延伸設定在其他工具中便可能失效。若需宣告 Skill 同時支援多套工具，應在各環境中以代表性任務實際跑過，不能僅以目錄結構與格式合規作為判斷標準。
未來會更容易共用嗎？
開放標準確實降低了跨工具的維護摩擦，但在預設目錄、載入優先權與工具延伸屬性完全統一前，工具間的差異依然客觀存在。
現階段，我會先確保共用規範只維護一份。新專案若使用的工具與環境都支援，可以直接採用 AGENTS.md；既有專案若已維持單一來源，也能繼續使用原本的配置。若決定改以 AGENTS.md 為主，可先讓 CLAUDE.md 透過 @AGENTS.md 匯入，等團隊使用的環境都確認能直接載入，而且沒有工具專用的補充內容需要保留時，再移除轉接檔。