CLAUDE.md 依範圍串接規則,寫好後仍要用新任務確認落實
深讀 L2 1,093 字 3 分鐘 v2.0.0 更新 2026-11-16
CLAUDE.md 保存 Claude Code 的通用工作要求,新對話開始時會載入適用的規則。規則會由外到內串接,但載入不等於必定照做。
要讓規則發揮作用,得先決定要求適用哪些工作,再寫清楚判斷條件。完成後,還要用新對話中的任務檢查行為。
啟動位置決定哪些規則一起載入
使用者層級的規則放在 ~/.claude/CLAUDE.md,從不同資料夾啟動都會載入。只供特定專案使用的規則,則放在該專案資料夾內。
新對話開始時,Claude Code 從工作目錄往上尋找每一層的 CLAUDE.md,把找到的檔案全部串接,範圍大的排在前面。內層檔案不會覆蓋外層檔案,兩份要求會同時生效。
因此,不能靠專案內再寫一條相反要求,消除外層規則。兩條規則互相矛盾時,沒有固定的優先順序,應刪除其中一條。
找不到 CLAUDE.md 時,Claude Code 會讀取備用檔名 AGENTS.md。檢查規則來源時,也要留意這個檔名。
下圖用虛擬碼呈現規則檔的載入順序。圖中的 context 是一次請求送給模型的全部內容,規則檔會加入其中。
個人的規則檔先載入,適用所有專案。
任務描述之外,要補哪些判斷條件
「設備檢查頁面沒有上下置中,處理一下。」只說明要修正的問題,沒有交代驗證、詢問條件與回報方式。這些跨任務反覆需要的要求,才適合放進規則檔。
先寫明使用者的角色與正在處理的工作,幫助 Claude Code 理解任務用詞。再提供設備、專案位置與工作執行位置;細節另存,規則檔只留下查詢線索。
詢問條件可以寫成:「只有不能復原、對外、品味選擇才問,其他自行決定再回報。」這條規則交代了哪些決定需要詢問,也交代其餘決定如何處理。
完成條件可以寫成:「沒驗證就不算完成。」驗證與回報的具體要求見 怎樣才算完成。
停止條件也要明確:同一前提下的修法持續失敗時,先停下來。要求 Claude Code 寫出前提並實測,再繼續修改。
下圖保留同一句設備檢查頁面任務,對照只有任務描述與加上規則檔的情況,顯示驗證、詢問與回報要求分別補在哪裡。
任務內容
- 「設備檢查頁面沒有上下置中,處理一下。」
尚未交代的要求
- 修改後是否需要驗證
- 什麼情況需要詢問
- 完成後如何回報
把一次糾正改成可檢查的要求
先挑出需要重複交代的糾正。例如「你沒檢查就說做完了」,可以改成規則:「回報完成要附實測。」這樣才能直接從完成回報檢查是否落實。
漏做時,分清文字問題與執行限制
發現漏做時,先對照規則的存放位置與工作目錄,檢查要求是否屬於適用範圍。再檢查一起生效的檔案有沒有矛盾,以及文字是否寫清楚觸發條件。
規則檔不是強制執行的設定,不能拿來保證沒有例外。持續被漏掉的要求,可改成 自動檢查;不能有例外的限制,則使用自動檢查或權限規則。
來源
- How Claude remembers your project Claude Code docs
- Custom instructions with AGENTS.md OpenAI
- Harness engineering: leveraging Codex in an agent-first world Ryan Lopopolo, OpenAI