Claude Code 教學：用 CLAUDE.md 讓 AI 不再失憶

你有沒有過這種經驗——跟 AI 聊了半天，好不容易讓它理解你的需求，結果下次開新對話，它又把一切忘光了？

我們用 Claude Code 幫客戶開發專案時也遇過一樣的問題。每次開新對話，都要重新交代一次：「我們的網站是用哪個工具做的」「存檔的時候備註要寫中文」「文章裡的連結點了要開新分頁」。說了十次，第十一次它還是會忘。

後來我們發現，Claude Code 其實有一套「記憶系統」，能讓它跨對話記住你的指令和偏好。關鍵就在一個叫 CLAUDE.md 的檔案。

但在講這個檔案之前，得先解釋一個東西——.md 到底是什麼。

先搞懂 .md：一種讓文字有結構的寫法

你應該用過 Word，知道怎麼把標題加粗、列出項目清單、插入連結。.md 檔案做的事情差不多，只不過它不需要打開 Word，用最普通的文字編輯器就能寫。

.md 是 Markdown 的縮寫，一種用符號來標記文字格式的寫法。舉個例子：

# 這是大標題
## 這是小標題

- 第一點
- 第二點

**這段文字會加粗**

寫出來的效果跟你在網頁上看到的標題、清單、粗體字一模一樣。

為什麼要用這種格式？因為它夠簡單。不需要安裝特別的軟體，任何地方都能打開、編輯。更重要的是——AI 讀得懂。Claude Code 就是用這種格式來讀取你給它的指令。

所以 CLAUDE.md 就是一個用 Markdown 格式寫給 Claude Code 看的指令檔。

CLAUDE.md：你交代給新人的工作備忘錄

當主管帶新人，第一天通常不會丟一本公司制度手冊給他看。你會寫一張備忘錄，把那些「制度裡沒寫但一定要知道」的事列出來：「寄信給客戶一律用敬語」「每週五下班前更新進度表」「王總的案子任何變動都要先跟我確認」。

CLAUDE.md 就是這張備忘錄，只不過你帶的新人是 AI。

每次你跟 Claude Code 開始新對話，它做的第一件事就是看這張備忘錄，把上面的規矩讀一遍。所以不管對話換了幾輪，只要寫在備忘錄上的交代，Claude Code 都會照做。

這份文件可以放什麼？

任何你希望 AI 每次都遵守的規則。我們自己的 CLAUDE.md 裡寫了這些：

專案基本資訊：

## 專案簡介

公司官網，使用 Astro 5 框架，支援繁體中文和英文。

這就像告訴新同事「我們公司是做什麼的」。Claude Code 知道了專案的背景，回答問題時就不會牛頭不對馬嘴。

常用指令速查：

## 常用指令

| 指令 | 用途 |
|------|------|
| `npm run dev` | 啟動開發環境 |
| `npm run build` | 打包上線版本 |

這就像辦公桌上貼的便利貼。Claude Code 需要跑指令時，不用猜，直接照做。

程式碼撰寫規範：

## Commit Message 規範

格式：`<類型>(<範圍>): <簡述>`，使用繁體中文。

範例：
- feat(news): 新增延伸閱讀功能
- fix(WorkCard): 修正圖片邊框問題

這是最實用的部分。我們把 commit message 的格式寫進去之後，Claude Code 每次提交程式碼都會自動遵守這個格式，不用每次都提醒。

檔案要放在哪裡？

CLAUDE.md 可以放在不同的位置，作用範圍也不一樣：

放在哪裡	影響範圍	適合放什麼
專案根目錄 ./CLAUDE.md	這個專案	專案架構、程式碼風格、常用指令
電腦根目錄 ~/.claude/CLAUDE.md	你電腦上的所有專案	個人偏好，例如「回覆用繁體中文」

用生活化的方式理解：專案的 CLAUDE.md 像是「這間辦公室的規定」，電腦根目錄的 CLAUDE.md 像是「你個人的工作習慣」。不管你換到哪個專案，個人偏好都會跟著你。

快速產生 CLAUDE.md

如果你不知道該從何寫起，Claude Code 提供了一個快速鍵：在對話中輸入 /init，它會自動掃描你的專案結構，幫你產生一份 CLAUDE.md 初稿。裡面會包含它從程式碼中發現的框架、指令和專案慣例。

你再根據實際需求修改就好，不需要從零開始。

自動記憶：AI 自己做的筆記

CLAUDE.md 是你寫給 AI 看的。但 Claude Code 還有另一套機制——自動記憶，是 AI 自己寫給自己看的筆記。

這就像你跟同事合作久了，他會記住「這個人不喜歡太長的變數名稱」「每次改完程式碼要先跑測試」。你沒有明確說過這些規則，但他從你的反應中學會了。

Claude Code 也一樣。當你在對話中糾正它——「不要用這個格式」「連結要另開分頁」——它會把這些修正記下來，存成筆記。下次開新對話，它會先翻這些筆記，避免犯同樣的錯。

來看看實際的記憶長什麼樣子

我們專案裡有一筆自動記憶是這樣的：

---
name: 外連連結另開分頁
type: feedback
---

文章內的外部連結一律另開瀏覽器分頁。

Why: 避免讀者點擊外連後離開文章頁面，影響閱讀體驗。

這筆記憶的起源是：我們有一次發現 Claude Code 寫文章時，外部連結沒有設定另開分頁，讀者點了就直接跳走。我們糾正了一次，它就記住了。之後每篇文章，它都會自動把外部連結設成另開分頁。

另一筆更複雜的記憶是關於簡報製作流程：

---
name: 簡報製作流程
type: feedback
---

當使用者說要「做簡報」時，使用 Marp 工具將文章轉為簡報格式。

流程：
1. 讀取文章內容，整理出簡報大綱
2. 使用公司設計好的簡報主題
3. 最後一頁加上 QR Code
4. 在文章中嵌入簡報

我們只教過它一次完整的簡報製作流程，它就把每個步驟都記下來了。現在我們只要說「幫這篇文章做簡報」，它就知道該怎麼做，不用再從頭教一遍。

你也可以主動叫它記住

除了被動學習，你也可以直接告訴 Claude Code：「記住，我們的網域是 codotx.com，不要用其他網址。」

它會把這條規則存進自動記憶裡。下次遇到需要填入網址的情境，它就會自動用正確的網域。

記憶存在哪裡？

自動記憶存在你電腦的 ~/.claude/projects/ 資料夾底下，每個專案有自己的記憶區。裡面是一般的文字檔，你隨時可以打開來看、修改，甚至刪除不需要的記憶。

記憶的入口是一個叫 MEMORY.md 的索引檔，Claude Code 每次開對話都會讀它的前 200 行。這個索引檔會連結到其他更細節的筆記。如果某條記憶過時了或寫錯了，你直接改掉就好。

除了記憶之外，Claude Code 還有一個叫 .claude/rules/ 的資料夾，可以放更細緻的規則檔案。

用主管的角度來理解：CLAUDE.md 像是你在新人第一天交代的通用規矩，而 rules 像是你針對不同業務線寫的 SOP。每份 SOP 各自獨立一個檔案，一個主題寫一份，檔名就用主題來命名。整個資料夾結構大概長這樣：

你的專案/
├── .claude/
│   ├── CLAUDE.md              # 通用規矩
│   └── rules/
│       ├── 寫作風格.md         # 文章怎麼寫
│       ├── 客戶溝通.md         # 跟客戶互動的規範
│       └── 報表格式.md         # 報表該長什麼樣子

Rules 分成兩種。通用型的沒有指定適用範圍，每次開對話就會自動載入，跟 CLAUDE.md 一樣——就像貼在公佈欄上的公告，所有人都會看到。

指定範圍型的則只在 AI 碰到相關工作時才會載入。你可以在規則檔案的開頭標註「這份 SOP 只在處理某類工作時適用」，AI 平常不會去翻它，碰到那類工作時才會自動拿出來看。就像你告訴新人：「處理 A 客戶的案子，去第三層櫃子拿那份 SOP 來照著做。」

如果你有多個專案都要遵守同一套規則，也不用每個專案都複製一份。你可以用「捷徑」的方式，讓不同專案的 rules 資料夾都指向同一組規則檔案。改了一個地方，所有專案就會同步更新。

這樣做的好處是節省空間。CLAUDE.md 建議控制在 200 行以內，把所有規則都塞進去很快就滿了。拆到 rules 資料夾之後，AI 只在需要的時候才會去讀對應的規則，既不浪費空間，遵守率也更高。

想快速查看目前有哪些記憶？在對話中輸入 /memory，Claude Code 會列出所有已載入的指令檔和記憶檔，你可以直接點開編輯。

CLAUDE.md 跟自動記憶的差別

兩套系統聽起來很像，實際上分工很清楚：

	CLAUDE.md	自動記憶
誰來寫	你自己寫	Claude Code 自動寫
內容是什麼	明確的規則和指令	它從你的回饋中學到的習慣
什麼時候用	你一開始就知道的規矩	合作過程中慢慢累積的默契
怎麼改	直接編輯檔案	在對話中糾正，或手動改檔案

用個比喻：CLAUDE.md 是員工手冊，自動記憶是工作筆記。員工手冊是公司發的，寫的是正式規定；工作筆記是同事自己記的，寫的是「上次主管說不喜歡這樣做」之類的實戰經驗。

兩者配合起來，AI 就不只是一個「每次見面都像陌生人」的工具，而是一個越用越順手的工作夥伴。

寫好 CLAUDE.md 的幾個建議

根據我們的實際使用經驗，加上官方文件的建議，分享幾個讓 CLAUDE.md 更有效的做法：

只寫 AI 自己查不到的東西。 這是最重要的一點。專案裡有哪些檔案、用了什麼工具、程式碼的結構長怎樣——這些 AI 在工作的時候會自己去翻，不需要你事先告訴它。CLAUDE.md 應該放的是「它讀遍整個專案也讀不出來的東西」：你個人的工作習慣、團隊約定的格式規範、特殊的流程要求。

舉個例子：「存檔備註要用繁體中文」這件事，AI 看程式碼是看不出來的，所以要寫進去。但「這個專案有哪些頁面」這種資訊，它自己就能找到，寫了只是浪費空間。

控制在 200 行以內。 太長的話，AI 讀起來反而會抓不到重點。就像你不會給新人一本 500 頁的員工手冊——重點越精簡，遵守率越高。

寫得越具體越好。 「程式碼要寫好」這種指令沒有用。「縮排用 2 個空格」「變數名稱用英文」這種才有用。AI 跟人一樣，模糊的指令只會讓它自由發揮。

避免互相矛盾。 如果一個地方寫「用 Tab 縮排」，另一個地方寫「用空格縮排」，AI 會隨機挑一個照做。定期檢查一下，把過時或衝突的規則清掉。

善用標題和清單。 用 Markdown 的標題（##）和清單（-）把指令分組。有結構的文件比一大段文字容易被正確理解。

對話紀錄不會消失，但 AI 不會主動翻舊帳

你可能會擔心：「關掉 Claude Code 之後，之前的對話不就沒了？」

其實不會。Claude Code 會把每次對話的完整紀錄存在你的電腦裡。你隨時可以用 claude --continue 回到上一次對話繼續聊，或用 claude --resume 從清單裡挑一個過去的對話接著做。

但這裡有個容易誤會的地方：對話紀錄雖然還在，AI 卻不會主動去翻它。

每次開新對話，Claude Code 的工作記憶是全新的——就像同事昨天跟你開了三小時的會，但今天早上進辦公室，他不會自動記得昨天會議的每個細節。除非你提醒他「我們昨天討論過 X」，或者他自己有做會議紀錄。

這就是 CLAUDE.md 和自動記憶的價值所在。

對話紀錄是「可以查閱的會議錄音」，你想回去聽隨時可以。但 CLAUDE.md 是「貼在螢幕上的便利貼」，AI 每天上班第一件事就會看到。自動記憶則是它自己的筆記本，記錄著「上次老闆說不喜歡這樣做」之類的經驗。

所以，與其每次開新對話都重複同樣的話，不如花十分鐘把那些規則寫進 CLAUDE.md。讓 AI 幫你做筆記的同時，也幫它建立一份讀得懂的工作手冊。

你會發現，當 AI 不再失憶，工作效率的提升比你想像的明顯得多。

常見問題

Q：我不會寫程式，也能用 CLAUDE.md 嗎？

可以。CLAUDE.md 就是一個純文字檔，你用記事本就能打開編輯。裡面寫的是中文指令，不是程式碼。只要你會打字、會列清單，就能寫。

Q：CLAUDE.md 一定要自己寫嗎？

不用，你可以直接用講的。但要注意你怎麼說，會決定指令被存到哪裡：

• 說「記住，以後報表格式都要用這個樣式」→ 存進自動記憶
• 說「把這條加到 CLAUDE.md」→ 存進 CLAUDE.md

差別在哪？CLAUDE.md 每次開對話都會完整載入，遵守率比較高。自動記憶則是 AI 自己判斷什麼時候要翻出來看，偶爾可能會漏掉。所以如果是很重要、希望它每次都照做的規則，建議明確跟它說「加到 CLAUDE.md」。

Q：CLAUDE.md 寫錯了會不會搞壞專案？

不會。CLAUDE.md 只是給 AI 看的參考指令，不是系統設定檔。寫錯了頂多是 AI 照著錯誤的指令做事，你把內容改回來就好。

Q：自動記憶會不會記到奇怪的東西？

有可能。AI 根據它自己的判斷決定什麼值得記住，偶爾會記下不太準確或已經過時的內容。你可以在對話中輸入 /memory 查看所有記憶，看到不對的直接刪掉或修改。

Q：我寫了 CLAUDE.md，但 AI 有時候還是不照做？

這是正常的。CLAUDE.md 是「建議」而不是「強制」。根據官方說明，指令越具體、越簡短，AI 的遵守率越高。如果某條規則經常被忽略，試試把它寫得更明確，或檢查是不是跟其他規則互相矛盾了。

Q：CLAUDE.md 跟自動記憶衝突的話，AI 聽誰的？

兩者都會被載入，但 CLAUDE.md 的優先權比較高。如果你發現自動記憶裡存了跟 CLAUDE.md 矛盾的內容，直接把那筆記憶刪掉就好。

參考連結

• Claude Code 官方文件：記憶機制 — 完整說明 CLAUDE.md 和自動記憶的運作方式
• Markdown 基礎語法指南 — 學習 .md 檔案的寫法