我把專案規則放進 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

  • 直接讀取
在 CLAUDE.md 寫入 @AGENTS.md。Claude Code 與 Codex 就能讀取同一份規則。

記憶共用資料,不代表共用寫入流程

專案規則之外,我另行處理 記憶,也就是留給後續對話讀取的資料。我用記錄檔案修改的工具 Git,在同一個倉庫保存記憶資料夾,並讓 Codex 讀取記憶索引。

這個配置沒有讓 Codex 自動寫入記憶的路徑。

安裝來源與個人規則仍有同步成本

另一項要分開檢查的是 Skill,也就是寫給 Claude Code 的任務做法。我讓兩者從同一份 Plugin 目錄 安裝,這份目錄提供共同的安裝來源。

來源相同,安裝的 Skill 版本仍可能不同。我仍需手動更新 Skill 版本,並檢查兩邊是否一致。

個人規則是放在使用者家目錄、套用到所有專案的規則檔,若分開保存,也需要手動同步。列出這些仍有副本的內容,再逐項確認能否改用同一個檔案。

先判斷你要共用到哪個範圍

如果你在同一個專案使用兩種 agent,而且兩者有可共用的工作要求,可以採用這個配置。整理時先區分專案規則與個人規則,才能知道哪些內容能直接合併。

如果你需要記憶寫入、個人規則與 Skill 更新全部自動同步,這個配置不夠。

讀完之後

協作花費審查並行隔離Codex