---
site: "zyx.tw"
title: "我把專案規則放進 AGENTS.md，讓 Claude Code 與 Codex 共讀"
description: "專案規則共用檔案，個人規則與安裝內容另查同步。"
url: "https://www.zyx.tw/map/fleet/two-agents"
---

# 我把專案規則放進 AGENTS.md，讓 Claude Code 與 Codex 共讀

紀錄 027，經驗 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，也不用再搬動規則。

下圖依規則存放的位置，示範兩者如何讀取：專案檔案可以透過引用或備用檔名設定共用，分開保存的個人檔案則需要手動同步。

**規則放在哪裡 專案的 AGENTS.md**

Claude Code:
- 從 CLAUDE.md 引用並讀取

Codex:
- 直接讀取

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

**規則放在哪裡 專案的 CLAUDE.md**

Claude Code:
- 讀取 CLAUDE.md

Codex:
- 設定備用檔名後讀取

專案只有 CLAUDE.md 時，把 CLAUDE.md 設為 Codex 的備用檔名。

**規則放在哪裡 個人的 CLAUDE.md**

Claude Code:
- 讀取個人的 CLAUDE.md

Codex:
- 讀取手動同步的個人規則

個人規則若分開存放，就需要手動同步。檢查副本是否已過時。

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

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

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

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

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

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

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

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

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

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

## 地圖

- 原理：[CLAUDE.md 依範圍串接規則，寫好後仍要用新任務確認落實](https://www.zyx.tw/map/basics/claude-md.md)
- 相關：[把糾正存成規則，保存位置依適用範圍決定](https://www.zyx.tw/map/goals/remembers-me.md)
- 回到：[協作](https://www.zyx.tw/map.md)
