我把專案規則放進 AGENTS.md,讓 Claude Code 與 Codex 共讀
經驗 L2 650 字 2 分鐘 v2.0.0 更新 2026-11-16
我在同一個專案使用 Claude Code 與 OpenAI 的 coding agent Codex。兩者讀取的規則檔不同:CLAUDE.md 是 Claude Code 在新對話開始時載入的規則檔,Codex 則讀取 AGENTS.md。
我的做法是把可共用的專案規則集中在 AGENTS.md。CLAUDE.md 只保留引用,避免相同要求各寫一份後,內容逐漸分歧。
引用讓兩個入口指向同一份內容
這個配置靠檔案引用成立:Claude Code 從 CLAUDE.md 的 @AGENTS.md 讀取規則,Codex 直接讀取 AGENTS.md。兩者的入口不同,讀取的規則內容相同。
專案的 CLAUDE.md 只留下這行:
@AGENTS.md
新專案則直接從 AGENTS.md 開始。之後加入其他 agent,也不用再搬動規則。
下圖依規則存放的位置,示範兩者如何讀取:專案檔案可以透過引用或備用檔名設定共用,分開保存的個人檔案則需要手動同步。
規則放在哪裡
Claude Code
- 從 CLAUDE.md 引用並讀取
Codex
- 直接讀取
記憶共用資料,不代表共用寫入流程
這個配置沒有讓 Codex 自動寫入記憶的路徑。
安裝來源與個人規則仍有同步成本
來源相同,安裝的 Skill 版本仍可能不同。我仍需手動更新 Skill 版本,並檢查兩邊是否一致。
個人規則是放在使用者家目錄、套用到所有專案的規則檔,若分開保存,也需要手動同步。列出這些仍有副本的內容,再逐項確認能否改用同一個檔案。
先判斷你要共用到哪個範圍
如果你在同一個專案使用兩種 agent,而且兩者有可共用的工作要求,可以採用這個配置。整理時先區分專案規則與個人規則,才能知道哪些內容能直接合併。
如果你需要記憶寫入、個人規則與 Skill 更新全部自動同步,這個配置不夠。