---
site: "zyx.tw"
title: "CLAUDE.md 依範圍串接規則，寫好後仍要用新任務確認落實"
description: "先分清規則的作用範圍，再檢查新對話中的實際行為。"
url: "https://www.zyx.tw/map/basics/claude-md"
---

# CLAUDE.md 依範圍串接規則，寫好後仍要用新任務確認落實

紀錄 004，深讀 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 是一次請求送給模型的全部內容，規則檔會加入其中。

```text
context = []
context += read("~/.claude/CLAUDE.md")          # user
for dir in path_from_root_to(cwd):              # broad first
    context += expand(dir / "CLAUDE.md")        # follows @imports
    context += expand(dir / "CLAUDE.local.md")
context += head("MEMORY.md", lines=200)         # index only

def on_read(file):                              # later, on demand
    context += expand(dirname(file) / "CLAUDE.md")
```

Figure: Pseudo code of how instruction files load: the user file first, then each directory from the root to the working directory, then the head of the memory index; a subdirectory's file loads when a file there is read.

1. User: 個人的規則檔先載入，適用所有專案。
2. Walk: 從最外層走到工作目錄，每一層的規則檔依序接上。
3. Import: 規則檔可以用 @ 引入其他檔案，最多 4 層。
4. Memory: 記憶只載入索引的前 200 行。詳細內容用到才讀。
5. Lazy: 子資料夾的規則檔，等讀到那裡的檔案才載入。

## 任務描述之外，要補哪些判斷條件

「設備檢查頁面沒有上下置中，處理一下。」只說明要修正的問題，沒有交代驗證、詢問條件與回報方式。這些跨任務反覆需要的要求，才適合放進規則檔。

先寫明使用者的角色與正在處理的工作，幫助 Claude Code 理解任務用詞。再提供設備、專案位置與工作執行位置；細節另存，規則檔只留下查詢線索。

詢問條件可以寫成：「只有不能復原、對外、品味選擇才問，其他自行決定再回報。」這條規則交代了哪些決定需要詢問，也交代其餘決定如何處理。

完成條件可以寫成：「沒驗證就不算完成。」驗證與回報的具體要求見 怎樣才算完成。

停止條件也要明確：同一前提下的修法持續失敗時，先停下來。要求 Claude Code 寫出前提並實測，再繼續修改。

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

**Claude Code 收到的要求 只有任務描述**

任務內容:
- 「設備檢查頁面沒有上下置中，處理一下。」

尚未交代的要求:
- 修改後是否需要驗證
- 什麼情況需要詢問
- 完成後如何回報

任務描述沒有交代通用的工作要求。

**Claude Code 收到的要求 加上 CLAUDE.md**

任務內容:
- 「設備檢查頁面沒有上下置中，處理一下。」

CLAUDE.md 的通用要求:
- 「沒驗證就不算完成。」
- 「只有不能復原、對外、品味選擇才問。」
- 「回報完成要附實測。」

把通用要求寫進 CLAUDE.md。Claude Code 會在新對話載入這些規則。

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

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

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

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

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

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

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

## 來源

- [How Claude remembers your project](https://code.claude.com/docs/en/memory), Claude Code docs
- [Custom instructions with AGENTS.md](https://developers.openai.com/codex/guides/agents-md), OpenAI
- [Harness engineering: leveraging Codex in an agent-first world](https://openai.com/index/harness-engineering/), Ryan Lopopolo, OpenAI

## 地圖

- 應用：[我從家目錄啟動 Claude Code，讓跨專案工作在同一個範圍內、共用同一份記憶](https://www.zyx.tw/map/basics/start-from-home.md)
- 應用：[把糾正存成規則，保存位置依適用範圍決定](https://www.zyx.tw/map/goals/remembers-me.md)
- 應用：[我把專案規則放進 AGENTS.md，讓 Claude Code 與 Codex 共讀](https://www.zyx.tw/map/fleet/two-agents.md)
- 應用：[我用環境目錄把設備名稱接到用途、連線與詳細筆記](https://www.zyx.tw/map/machines/what-runs-where.md)
- 相關：[先確認任務缺什麼，再選擇擴充方式](https://www.zyx.tw/map/basics/four-ways-to-extend.md)
- 相關：[Skill 保存同類任務的做法，個案細節留在專案](https://www.zyx.tw/map/basics/skill-loads-on-demand.md)
- 回到：[基礎](https://www.zyx.tw/map.md)
