Claude Code 與 AGENTS.md 的共用設定和載入方式
先了解這件事
2026 年 11 月 12 日的報導指出,Claude Code、Cursor 與 Codex 預設讀取的專案指令檔不同,可在 CLAUDE.md 開頭加入 @AGENTS.md,讓 Claude Code 匯入共用規則。
- 11 月 14 日,作者檢查 GitHub 上 3,905 份 CLAUDE.md 與 AGENTS.md,發現兩檔並存時,約 16% 的 CLAUDE.md 沒有提到 AGENTS.md。
- 部分檔案只要求助理自行讀取,或複製的規則已與原檔不同。11 月 20 日,作者查閱官方檔案並實測,稱兩檔並存時 AGENTS.md 不會因此重複載入。
- 若設定成兩種檔案都讀,也會略過已載入的檔案。作者另提到自己的 CLAUDE.md 有 1,474,604 B,但是否會完整載入尚未測量。11 月 22 日的新報導補充,從 Claude Code v2.1.277 起,若工作資料夾或上層資料夾有 CLAUDE.md、.claude/CLAUDE.md 或 CLAUDE.local.md,預設會讀取這些檔案並略過 AGENTS.md。
- 可用 @AGENTS.md 或在 /config 調整設定,以載入兩者。
根據報導自動生成 · 12 小時前更新
事件進展
- 11月22日 16:37 · 1 篇報導Claude Code 開始讀取 AGENTS.mdDev.to Top Tech:Claude Code 何時會讀取 AGENTS.md?設定方法與注意事項
- 11月20日 00:41 · 1 篇報導Claude Code 不會重複載入指令檔Dev.to Top Tech:CLAUDE.md 和 AGENTS.md 會不會重複載入?作者用檔案與實測說明
- 11月14日 18:40 · 1 篇報導研究揭示 CLAUDE.md 與 AGENTS.md 載入落差Dev.to Top Tech:研究檢查 3,905 份 GitHub 指令檔,發現 Claude Code 常讀不到 AGENTS.md
- 11月12日 00:13 · 1 篇報導介紹用 AGENTS.md 共用 AI 編碼工具指令Dev.to Top Tech:如何讓 Claude Code、Cursor 與 Codex 共用一份 AGENTS.md
報導時間線
沿著報導,瞭解事件的不同面向。
- Dev.to Top TechClaude Code 何時會讀取 AGENTS.md?設定方法與注意事項
Claude Code 有時會跳過 AGENTS.md,讓專案裡的操作規則沒有載入。文章整理了從 v2.1.277 起的讀取方式:如果工作資料夾或上層資料夾有 CLAUDE.md、.claude/CLAUDE.md 或 CLAUDE.local.md,預設就會讀這些檔案而略過 AGENTS.md。想同時載入兩者,可以在 CLAUDE.md 開頭加入 @AGENTS.md,或在 /config 裡調整設定。兩份檔案若放了重複規則,重複文字仍會佔用 token;團隊也要留意個人設定檔可能讓自己讀不到共用的 AGENTS.md。
- Dev.to Top TechCLAUDE.md 和 AGENTS.md 會不會重複載入?作者用檔案與實測說明
有人擔心 Claude Code 每次工作都會重複讀取 CLAUDE.md 和 AGENTS.md,讓指令佔掉太多上下文。作者查閱 Claude 的官方檔案並檢查自己的檔案,發現兩個檔案同時存在時,AGENTS.md 不會再被讀取;即使設定成兩種都讀,也會略過已載入的檔案。實際更大的問題是專案中的 CLAUDE.md 有 1,474,604 B,而是否會完整載入還沒有測量。若要讓 Claude Code 共用 AGENTS.md,作者建議在 CLAUDE.md 加上 @AGENTS.md,並提醒 Windows 環境使用符號連結可能遇到問題。
- Dev.to Top Tech精選研究檢查 3,905 份 GitHub 指令檔,發現 Claude Code 常讀不到 AGENTS.md
AI 程式助理可能因為沒讀到專案規則,或只讀到部分內容,而和其他助理採用不同做法。作者檢查了 3,905 份 GitHub 上的 CLAUDE.md 和 AGENTS.md,發現兩份檔案並存時,約 16% 的 CLAUDE.md 沒有提到 AGENTS.md,因此 Claude Code 不會載入它;另有一些檔案要求助理自行去讀,或是複製後內容已經不同。作者建議在 CLAUDE.md 開頭單獨加上 @AGENTS.md,讓 Claude Code 匯入共用規則。研究也指出,超過 Codex 預設讀取大小的 AGENTS.md,後段內容不會送進模型;檢查只涵蓋公開 GitHub 專案,衡量的是規則有沒有傳到助理,不代表助理一定會遵守。
- Dev.to Top Tech精選如何讓 Claude Code、Cursor 與 Codex 共用一份 AGENTS.md
Claude Code、Cursor 與 Codex 預設讀取的專案指令檔不同;在 CLAUDE.md 第一行加入 @AGENTS.md,可讓 Claude Code 匯入共用規則。
本事件熱度趨勢
當前熱度 7·可比範圍峰值 10(11月20日 01:00)·近 24 小時可比範圍變化 –
趨勢僅比較持續完整觀測到的相同主體,範圍可能小於當前熱度統計。移動指標或點選圖表檢視每小時熱度;鍵盤可用左右方向鍵切換。
讀者討論
針對此事件的各方觀點與即時反饋