CLAUDE.md:教它記住你的規矩

功能與介面更新很快，細節請以官方說明為準。

這篇你會學到

1. 為什麼 Claude Code 每次新對話都「失憶」，以及 CLAUDE.md（它的備忘錄檔案）怎麼解決這件事。
2. CLAUDE.md 該放哪裡、寫什麼：附一份可以直接複製的模板。
3. 想讓它「記住一件事」的正確方法，以及新手最常見的五個誤解。

官方原文：How Claude remembers your project（功能更新以官方為準）

先懂一件事：每次新對話都是全新開始

依官方文件〈How Claude remembers your project〉,Claude Code 的每一次對話（session）都從一個全新的上下文（context,AI 當下記得的內容範圍）開始。也就是說：你上週跟它講好的規矩、上個對話教它的寫法，開新對話時它一概不記得。

台灣創作者的實戰經驗把這個坑演得很生動：有人在前一個對話裡讓 AI 讀過角色設定檔，開新對話請它續寫故事，結果角色個性整個跑掉——因為新對話裡它根本沒讀那份設定。

官方提供兩個機制把知識帶過每一次對話（依官方文件〈How Claude remembers your project〉）：

• CLAUDE.md 檔案:你親手寫的持久指示，每次對話開始自動載入。
• 自動記憶（auto memory）:Claude 自己記的筆記，例如它學到的專案慣例，也會每次載入。

這篇先把重點放在你能完全掌控的 CLAUDE.md。

CLAUDE.md 是什麼：寫給 AI 的備忘錄

CLAUDE.md 就是一個純文字的 Markdown 檔案（用簡單符號排版的文字檔），放在你的專案資料夾裡。Claude Code 每次開始對話都會先讀它（依官方文件〈How Claude remembers your project〉）。

什麼東西該寫進去？官方的判斷標準非常實用，翻成白話是：你發現自己在對話裡重複講第二次的事，就該寫進 CLAUDE.md。官方列的時機包括：Claude 第二次犯同一個錯、你這次打的提醒上次也打過、一個新同事加入也需要知道的背景（依官方文件〈How Claude remembers your project〉）。

例如：「輸出檔名一律日期開頭」「回覆用繁體中文台灣用語」「這個資料夾裡的 final 資料夾不准動」。寫一次，以後每個新對話它都記得。

放哪裡：兩個位置就夠新手用

依官方文件〈How Claude remembers your project〉，CLAUDE.md 可以放在幾個層級，新手先記兩個：

進階備註（知道就好）：同一專案裡還可以放 CLAUDE.local.md 裝「只有你自己、不分享給團隊」的個人偏好；企業還有管理員統一部署的層級（依官方文件〈How Claude remembers your project〉）。新手先把專案層的一個檔案寫好就贏過大多數人。

建立方法零門檻：直接在對話裡說「幫我在這個專案建立 CLAUDE.md,內容是……」讓它自己建，或用任何文字編輯器手動建檔都行。

寫什麼：原則加模板

官方給的寫作原則（依官方文件〈How Claude remembers your project〉）：

1. 短:單一檔案目標 200 行以內。越長，佔用越多上下文，遵守度反而下降。
2. 具體:寫「可以驗證」的指令。官方的對比範例：「用 2 空格縮排」好過「把格式弄好」；「提交前先跑 npm test」好過「記得測試」。
3. 有結構:用標題和條列分組，不要寫成一大段散文。
4. 不互相打架:兩條規則矛盾時，Claude 可能隨便挑一條，要定期檢查清理。

以下是一份給非工程師的起手模板，直接複製到你的專案 CLAUDE.md,再改成自己的內容：

# 專案說明
這個資料夾是【例:2026 年講座課程的教材專案】。
主要產出是【例:給學員的講義 Markdown 檔與簡報】。

# 我的規矩
- 回覆一律用繁體中文(台灣用語)。
- 新檔案的檔名用日期開頭,例如 2026-07-07_講義_第一課.md。
- 修改我既有的檔案之前,先列出你要改哪裡,等我同意。
- 產出的文字不用 emoji。

# 資料夾結構
- sources/:原始資料,唯讀,不准修改。
- drafts/:草稿放這裡。
- final/:定稿放這裡,只有我說「定稿」時才能寫入。

# 工作流程
- 每次任務結束時,用三行總結你做了什麼、改了哪些檔案。

另外一個懶人起手式：在對話中輸入 /init,Claude 會分析你的專案內容，自動生成一份 CLAUDE.md 初稿；如果已經有 CLAUDE.md,它會提出改進建議而不是覆蓋（依官方文件〈How Claude remembers your project〉）。生成後記得自己讀一遍、改成你要的樣子。

想讓它記住一件事，怎麼做

依官方文件〈How Claude remembers your project〉，現行做法有三種：

1. 直接用講的 在對話裡說「記住：以後一律用 pnpm,不要用 npm」這類話，Claude 會把它存進自動記憶（auto memory）。自動記憶是 Claude 自己維護的筆記，存在你電腦的 ~/.claude/projects/<專案>/memory/ 資料夾，每次對話載入其索引檔的開頭部分。

2. 指定寫進 CLAUDE.md 如果你希望這條規則進入你能完全掌控的備忘錄，直接說「把這條加進 CLAUDE.md」，或自己動手編輯檔案。

3. 用 /memory 指令檢視與編輯 在對話中輸入 /memory,會列出目前這個對話載入了哪些 CLAUDE.md 與記憶檔案，可以開啟編輯，也能開關自動記憶功能。所有記憶檔都是純文字 Markdown,你隨時可以讀、改、刪。

誠實備註：網路上不少教學提到「輸入框用 # 開頭可以快速新增記憶」的做法；我們查閱的官方記憶文件現行版本並未記載這個捷徑，所以本篇以上述三種官方寫明的方法為準。若你的版本介面有出現相關功能，以畫面與官方說明為準。

常見誤解

1. 「我寫了 CLAUDE.md,它怎麼有時候不照做？」 症狀：規則寫了，行為卻不穩定。 解法：官方明講 CLAUDE.md 是「給 Claude 的參考脈絡，不是強制設定」。先用 /memory 確認檔案真的有被載入；再把指令改具體（「檔名日期開頭」而不是「檔名整齊一點」）；檢查有沒有互相矛盾的規則。真正必須百分之百執行的事，官方建議改用 hooks（掛勾，一種在固定時機自動執行指令的機制）來強制（依官方文件〈How Claude remembers your project〉）。

2. 「規則越多越好，我把所有想到的都塞進去」 症狀：CLAUDE.md 越養越肥，結果它反而更常忽略規則。 解法：官方建議單檔 200 行以內；超過的內容，要嘛刪，要嘛移去進階機制（路徑限定規則或技能）。台灣創作者的實戰經驗也是同一個結論：備忘錄塞太多不相關規則，AI 反而難以專注眼前任務。先留「每次都用得到」的規則就好。

3. 「我上次跟它說過了，它應該記得」 症狀：開新對話後發現它忘光，以為壞掉了。 解法：這是正常設計，不是故障。每次對話都是全新開始；會留下來的只有 CLAUDE.md 和自動記憶。口頭講過但沒寫下來的事，等於沒發生。凡是重要的規矩，講完就補一句「把這條加進 CLAUDE.md」。

4. 「CLAUDE.md 是工程師的東西，我用不到」 症狀：看到 .md 副檔名就跳過這一課。 解法：它就是一個文字檔備忘錄，寫中文完全可以。上面的模板沒有任何一行是程式碼。事實上，越是非工程師，越需要它——因為你更不想每次重新解釋自己的工作習慣。

5. 「個人喜好跟專案規則，全部寫在同一個檔案」 症狀：團隊共用的專案 CLAUDE.md 裡混了你個人的口味，同事拿到很困惑。 解法：專案共通規則放專案的 CLAUDE.md;你個人跨專案的偏好放 ~/.claude/CLAUDE.md;只屬於你、又只限這個專案的偏好放 CLAUDE.local.md（依官方文件〈How Claude remembers your project〉）。

重點回顧

1. Claude Code 每次新對話都失憶，這是設計；CLAUDE.md 是你寫給它、每次開工自動載入的備忘錄。
2. 判斷標準一句話：同一件事你發現自己講第二次，就寫進 CLAUDE.md。
3. 位置先記兩個：專案資料夾的 CLAUDE.md 管單一專案，~/.claude/CLAUDE.md 管你所有專案。
4. 寫法四原則：短（200 行內）、具體可驗證、有結構、不互相矛盾；/init 可以幫你生初稿。
5. 想讓它記住一件事：直接講（進自動記憶）、指定加進 CLAUDE.md、或用 /memory 檢視編輯；要百分之百強制的事用 hooks。

下一步

• 還沒裝好？回到：安裝與第一次對話
• 從頭理解它是什麼：Claude Code 是什麼
• 想學自動化與更多客製（Skills、Hooks、MCP）：免費 L1 入門課