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 寫出前提並實測,再繼續修改。

下圖保留同一句設備檢查頁面任務,對照只有任務描述與加上規則檔的情況,顯示驗證、詢問與回報要求分別補在哪裡。

Claude Code 收到的要求

任務內容

  • 「設備檢查頁面沒有上下置中,處理一下。」

尚未交代的要求

  • 修改後是否需要驗證
  • 什麼情況需要詢問
  • 完成後如何回報
任務描述沒有交代通用的工作要求。

把一次糾正改成可檢查的要求

先挑出需要重複交代的糾正。例如「你沒檢查就說做完了」,可以改成規則:「回報完成要附實測。」這樣才能直接從完成回報檢查是否落實。

把這條規則存進 ~/.claude/CLAUDE.md 後,開新對話並交代類似任務。檢查 Claude Code 的完成回報是否附上實測;若未照做,就把文字改得更明確。將糾正保存給新對話的做法見 記憶。

只有特定任務需要的步驟,則寫成 Skill,也就是寫給 Claude Code 的一份做法。Skill 平常只載入名字和說明,遇到那類任務才載入全文,因此不必把完整步驟都放進通用規則。

漏做時,分清文字問題與執行限制

發現漏做時,先對照規則的存放位置與工作目錄,檢查要求是否屬於適用範圍。再檢查一起生效的檔案有沒有矛盾,以及文字是否寫清楚觸發條件。

規則檔不是強制執行的設定,不能拿來保證沒有例外。持續被漏掉的要求,可改成 自動檢查;不能有例外的限制,則使用自動檢查或權限規則。

來源

讀完之後

基礎入門家目錄擴充MCPSkillPluginCLAUDE.md載入