CLAUDE.md 與 AGENTS.md在 Mac 上閱讀、編輯與審閱。

這些檔案告訴 Claude Code 與 Codex 如何在你的專案中工作。DotMD 會把它們顯示成頁面、保留每個版本,還能加入讓代理把規格送給你審閱的幾行文字。

需要 macOS 14 或以上版本。閱讀免費;編輯與審閱為一次付費。

快速解答

CLAUDE.md 與 AGENTS.md 是一般的 Markdown 檔案,所以 DotMD 會像開啟任何 .md 一樣開啟它們:排版呈現、附大綱,並保留每個版本。在 Settings → MCP → Agent rules 中,Add to Claude Code 或 Add to Codex 會把 DotMD 的審閱規則放進 ~/.claude/CLAUDE.md 或 ~/.codex/AGENTS.md,讓代理把每份規格送給你,並等候你的註解。

開啟並編輯 CLAUDE.md 與 AGENTS.md

按下 ⌘O 並選擇專案資料夾:它的 CLAUDE.md 與 AGENTS.md 會和其他 Markdown 一起出現在側邊欄,並以附大綱的頁面開啟。側邊欄不會顯示隱藏資料夾,所以要開啟 ~/.claude/CLAUDE.md,請按 ⌘O,再在面板中按 ⇧⌘G 並輸入路徑。

要修改檔案,請按 ⌘E。頁面會變成邊輸入邊排版的文字,每項修改都會立即存入檔案。編輯屬於 DotMD Editor。

當代理編輯檔案時

當 Claude Code、Codex 或 git 修改工作區中的檔案時,開啟的頁面會自動重新載入,並用橫幅顯示 Changed on disk 與新增、刪除的行數。Show Changes 會開啟版本記錄;有了 DotMD Reviewer,舊文字會以紅色、新文字以綠色顯示。

如果你正在輸入時檔案被修改,DotMD 會詢問 Load from Disk 或 Keep My Version,不論選哪個,你的文字都會存入記錄。

想逐一檢查代理的修正,請見審閱代理的變更。

一鍵加入 DotMD 的審閱規則

模型對你自己的 CLAUDE.md 與 AGENTS.md 的重視,高於工具對自己的描述,所以 DotMD 可以把讓代理使用審閱的幾行文字放進去。開啟 Settings → MCP,展開 Agent rules,按下 Add to Claude Code 或 Add to Codex。規則會寫入 ~/.claude/CLAUDE.md 或 ~/.codex/AGENTS.md:

<!-- dotmd:begin (added by DotMD; DotMD can update or remove this block) -->
## DotMD
- When you create or substantially change a spec, plan, design doc or any Markdown document for the user, your LAST step is to call the DotMD MCP tool `request_review` with the file's path and wait for the answer. While it says the user is still reviewing, call it again. Never end your turn by just saying the file is ready.
- Fix each review comment, call `resolve_review_comments`, then `request_review` again until the user approves.
- When you review a file for the user, leave your remarks with `add_review_comments` and finish with `complete_review`.
<!-- dotmd:end -->

DotMD 只會修改它的兩行標記之間的部分,並在第一次修改前保留檔案的副本,檔名以 .dotmd-backup 結尾。Update 會在較新的 DotMD 有更好的規則時取代該區塊,Remove 則會移除它。

若是專案自己的檔案,或是 Cursor 與其他代理,請在同一處按下 Copy,再把這幾行貼到代理讀取規則的地方。Claude Code 與 Codex 的指南也提供一組較短的版本可以使用。

代理會怎麼運用這些規則

有了這些規則,代理會把它寫的每份規格、計畫或設計文件送給你(request_review),在你註解時等候,修正每則註解,並再次送出,直到你核准。透過 MCP 與代理進行審閱屬於 DotMD Reviewer。

關於 CLAUDE.md 與 AGENTS.md 的常見問題

CLAUDE.md 與 AGENTS.md 是什麼?

給程式碼代理的 Markdown 指示檔案。Claude Code 讀取 CLAUDE.md,Codex 讀取 AGENTS.md,可放在你的專案中,或放在 ~/.claude 與 ~/.codex 供所有專案使用。

DotMD 會自己修改我的 CLAUDE.md 嗎?

不會。只有在你於 Settings → MCP → Agent rules 按下 Add 或 Update 時,DotMD 才會寫入檔案,而且只在它的兩行標記之間。寫入前會先把檔案複製成 .dotmd-backup。

代理執行時,我可以在 DotMD 中編輯 CLAUDE.md 嗎?

可以。代理修改檔案時,頁面會重新載入。如果你剛好正在輸入,DotMD 會詢問要從磁碟載入檔案,還是保留你的版本。

編輯這些檔案需要 DotMD Reviewer 嗎?

不需要。開啟它們免費,編輯屬於 DotMD Editor(一次付費 $14.99)。規則要求代理使用的、透過 MCP 與代理進行的審閱,屬於 DotMD Reviewer(一次付費 $39.99)。

更多問題