如果您總得一再向 Claude Code 說明相同的專案規則，不妨把它們寫進 CLAUDE.md。這是一般的 Markdown 文字檔。Claude Code 會在工作階段開始時讀取它，您的約定就會和其他上下文一起提供給它。
一開始只要寫幾條確認過的規則就夠了：在哪裡工作、如何檢查結果，以及變更時要保留什麼。
CLAUDE.md 範例
以一個簡單的卡片頁面為例。標記、樣式和 JavaScript 都放在同一個 index.html，可以直接在瀏覽器中開啟。這類專案的指示檔可以像這樣寫：
# CLAUDE.md
## 專案
- 頁面、樣式和 JavaScript 都在 `index.html` 中。
## 檢查
- 在瀏覽器中開啟 `index.html`。
- 在寬螢幕和窄螢幕上檢查頁面。
## 規則
- 保留目前的配色和卡片樣式。
- 未經確認不要刪除現有區塊。
- 完成後列出所做的修改和檢查。這裡分成三類：專案結構、結果檢查，以及彼此的約定。下次您只要說"再加一張卡片"，就不必重新列出所有規則。不過，您仍可以自行檢查頁面：指示檔不會讓代理自動取得瀏覽器的存取權，除非它有可用的瀏覽器工具。
這只是單一檔案的範例，不是通用範本。您的專案可能有不同的資料夾和啟動指令，請把實際情況寫進去。如果沒有測試，就別為了看起來完整而編造指令。
適合記錄哪些內容
先用這個問題篩選：之後處理其他任務時，還會用到這條嗎？值得記下來的有已確認的指令、重要路徑，以及代理無法可靠地從程式碼推斷出的約定。尤其是那些您已經重複說過的事。
規則要寫得明確，讓代理知道該採取什麼行動：
- "全部都檢查" → "修改卡片後，請在寬螢幕和窄螢幕上檢查頁面"；
- "重要的東西別動" → "未經確認不要刪除現有區塊，因為內容已經定案"。
第一個例子說明要做哪項檢查，第二個則指出限制範圍和原因。這比列一長串"請小心處理"之類的籠統期望更有用。
README.md 是寫給人看的，會說明這是什麼專案，以及如何開始。CLAUDE.md 則整理給代理的指示，不必把整份 README 重寫一遍。至於"卡片寬度好像讓標籤跑位了"這種假設，請留在目前任務的備註中，例如 PROJECT_NOTE.md。這只是一般檔案，檔名由您自行決定；之後繼續這項任務時，請代理讀取它。
別把猜測記成已確認的事實，也不要在這裡存放密碼或存取金鑰。共用的 CLAUDE.md 通常會加入 Git，讓同事也能隨專案取得相同的指示。
建立並檢查檔案
先從已經確定的規則開始。不必等到累積一長串錯誤，也不用事先描述所有可能發生的情況。
- 先檢查專案裡是否已有
CLAUDE.md。如果有，先讀過再補充。新檔案可以放在專案根目錄；也支援放在.claude/CLAUDE.md，但不必建立兩份。 - 手動寫幾行，或在專案資料夾中開啟 Claude Code，輸入
/init。這個指令會檢查專案並產生草稿；如果檔案已存在，則會提出改善建議。 - 讀一遍結果，對照專案確認指令和路徑，並刪除猜測。例如，如果代理寫入了專案裡不存在的測試指令，就把它移除。只有您知道的限制，請自行補上。
- 儲存檔案，然後在專案資料夾中開啟新的工作階段。輸入
/context，確認 Memory files 區段列出了 CLAUDE.md 的路徑。
接著試著做一個小修改，例如請代理新增一張卡片，看看原有配色是否保留，以及是否附上檢查報告。如果清單中看不到檔案，先檢查檔名和啟動資料夾。如果檔案有列出，但結果不符合規則，請檢查指示是否清楚，以及是否有互相矛盾的規則。
檔案出現在清單中，只能證明它已載入，不能保證代理會遵循其中規則。代理答對了，也不能單獨證明檔案已載入：它可能從其他檔案找到相關資訊。指示能引導工作，但無法在技術上阻止任何動作。
其他內容該記在哪裡
第一個專案只需要一份 CLAUDE.md。當您開始加入個人指示，或累積了許多通用規則，可以參考這張圖來選擇記錄位置：
通用規則即使只和某個資料夾有關，也可能對整個團隊都很重要。.claude/rules/ 可以依主題拆分指示；若要限制適用的特定路徑，則需另外設定。只有兩三條規則時，不必把結構弄得太複雜。
CLAUDE.local.md 適合記錄您在這個專案中的個人指示，例如偏好簡短的回答。把它加入 .gitignore，避免提交到 Git。代理仍會讀取這個本機檔案，所以同樣不要把機密資訊放進去。
自動記憶（auto memory）是另一種備註機制；如果有啟用，Claude 會在工作過程中儲存內容。重要規則別只交給它自行判斷，請明確要求將規則加入 CLAUDE.md。臨時的 bug 假設則留在任務備註中。
如果專案裡已有 AGENTS.md，就別把內容再抄到另一個檔案。在 CLAUDE.md 中，您可以用 @AGENTS.md 這一行引入同一資料夾中的檔案。加入 CLAUDE.local.md 時，這點尤其實用：個人檔案可能會影響 AGENTS.md 是否被直接讀取。其他選項請參閱文件。
何時更新規則
專案有變動時，也要一併更新檔案。把 index.html 中的樣式移到另一個檔案後，就更新描述專案結構的那一行。檢查方式改了，就替換舊指示。不要在互相矛盾的舊規則上再疊加新規則。
重複出現的修改可以交給代理處理："請在 CLAUDE.md 加上一條規則：刪除現有區塊前要先取得我的確認。"接著讀一遍修改內容，確認它只表達了您的約定，沒有自行加上其他限制。通常一行就夠了。
如果規則沒有被遵循，先找出原因，別只是再重複三次。刪除過時的內容，只留下能幫助下一項任務的規則。
GO TO FULL VERSION