CLAUDE.mdClaude 記憶Claude Code 記憶MEMORY.mdclaude md 範例

如何透過記憶讓 Claude 更聰明?CLAUDE.md 寫法與自動記憶設定

2026年11月12日·11 分鐘閱讀

讓 Claude 透過記憶變聰明,做法是把每次都要重講的規則寫進 CLAUDE.md,讓它記下你糾正過的錯,再定期刪掉過期的記憶、合併重複的。Claude Code 每次開工都會先讀這些記憶,讀到的越精準,同樣的錯就越少犯。Anthropic 2026 年的研究也發現,記憶少而精的 Claude,表現比記得多的好。

這篇文章會說明 CLAUDE.md 放在哪裡、該寫什麼,再用 Anthropic 2026 年 11 月公布的記憶研究,加上我自己 MEMORY.md 被截掉的經驗,整理讓記憶保持精簡的做法。

透過 CLAUDE.md 與自動記憶讓 Claude 更聰明的封面

Claude Code 的記憶分成兩種

每次打開 Claude Code,它都是從一個空白的對話開始,上一次你交代過什麼,它不會自己想起來。能把東西帶到下一次對話的,只有兩個地方:你寫的 CLAUDE.md,和 Claude 自己寫的自動記憶。

CLAUDE.md:你寫給 Claude 的規則

CLAUDE.md 是一份純文字檔,用 Markdown 格式寫(井字號當標題、減號當列點的簡單寫法)。裡面放你希望 Claude 每次都遵守的事,像是「回覆一律用繁體中文」「改完檔案先跑測試」。Claude Code 每次開工都會把整份讀進去。

不知道從哪裡寫起,可以在專案裡輸入 /init,Claude 會讀完你的專案,自動產生一份起始版本,你再把它不會自己發現的規則補上去。

自動記憶:Claude 自己記的筆記

自動記憶不用你動手。你糾正過 Claude 的事、確認過的做法,它判斷以後用得到,就會自己寫成筆記。介面上出現「已保存 2 個記憶」,就是它剛寫了東西。

這些筆記存在你自己的電腦裡,每個專案一個記憶資料夾,一則記憶一個檔案,另外有一份 MEMORY.md 當目錄,每一則記憶在裡面佔一行。開工時 Claude Code 只會讀 MEMORY.md,個別的筆記檔等需要時才打開來看。

兩種記憶怎麼分工

項目CLAUDE.md自動記憶(MEMORY.md)
誰寫你Claude
放什麼規則、工作流程、專案慣例你的偏好、你糾正過它的事、程式碼裡看不出來的背景
開工時讀多少整份MEMORY.md 前 200 行或前 25KB,先到者為準
怎麼新增自己編輯,或跟 Claude 說「把這條加到 CLAUDE.md」跟 Claude 說「記住這件事」,或讓它自己判斷

兩種都可以用 /memory 打開來看。這個指令會列出所有 CLAUDE.md 的位置,也能開關自動記憶、打開記憶資料夾。

📖 延伸閱讀:Claude Code 教學:安裝、費用到資料安全一次搞懂

CLAUDE.md 怎麼寫才會被遵守

CLAUDE.md 寫了 Claude 卻沒照做,常見原因有三個:放錯位置、寫得太模糊、檔案太長。

三個存放位置

位置放在哪適合放什麼
個人層電腦使用者資料夾裡的 .claude 資料夾所有專案都適用的個人習慣
專案層專案資料夾裡的 CLAUDE.md這個專案的規則,可以分享給一起做的同事
本機層專案資料夾裡的 CLAUDE.local.md只有你自己用、不想分享給別人的設定

這幾份會一起讀進去,不會互相蓋掉。公司版還有一層由 IT 統一派發的設定,個人用不到。我自己個人層放兩條:一律用繁體中文回覆,以及花費超過 0.5 美元的動作要先給我報價單。專案層放網站的 SEO 規則和手機版排版規則。

我的個人層 CLAUDE.md 內容,寫著報價單規則與繁體中文回覆規則
我放在個人層的 CLAUDE.md,每個專案都會讀到

什麼該寫、什麼不該寫

官方文件的判斷方式是:同一件事你跟 Claude 講了第二次,就該寫進 CLAUDE.md。Claude 同一個錯犯了兩次、你在新對話又打了一次上次打過的提醒,都是同一個訊號。

不該寫的是 Claude 自己翻檔案就看得出來的東西,像資料夾裡有哪些檔案。這些寫進去只是佔位置,真正重要的規則反而更容易被漏掉。步驟很多、只有某些工作才用得到的流程,改寫成 Skill(Claude 需要時才載入的說明書)比較省。

規則要具體到能驗證

「文章要寫好」這種規則,Claude 沒辦法判斷自己有沒有做到。官方建議寫成做完能檢查的句子:

# 回覆與溝通
- 一律用繁體中文回覆
- 花費超過 US$0.5 的動作,先列報價單等我同意
# 寫文章
- 重點句用紅字標出,一篇最多五處

同一份檔案裡如果有兩條規則互相矛盾,Claude 可能隨便挑一條照做。可以定期請 Claude 幫你檢查 CLAUDE.md 有沒有過時或互相衝突的規則,改不改由你決定。

太長就拆成好幾份

官方建議每份 CLAUDE.md 控制在 200 行以內,檔案越長,Claude 越容易漏掉規則。只跟某類工作有關的規則,可以拆到專案裡的 .claude/rules 資料夾,一個主題一個檔案,還能指定「只有碰到文章草稿時才讀」。最簡單的做法是直接跟 Claude 說:「把寫文章的規則拆到 rules 資料夾,只在處理文章時讀。」

想確認 CLAUDE.md 有沒有被讀到,直接問 Claude「你現在讀到哪些規則檔」就好。

想每週看到 AI 工具更新整理和我的短評,可以訂閱電子報。

訂閱 Q kangber 電子報

記憶越多,Claude 不一定越聰明

Anthropic 在 2026 年 11 月 6 日發表了一篇研究〈The components of agent memory〉,用幾組實驗測試 Claude 怎麼寫記憶。結果記憶寫得比較多的模型,表現反而比較差。

寶可夢實驗:413 個檔案和 10 個檔案

研究團隊讓兩代 Claude 玩寶可夢紅版,給它們一個可以自由讀寫的記憶資料夾,各玩到大約第 1 萬步。

模型記憶檔案記憶總字數拿到的徽章
Sonnet 3.7(舊模型)413 個檔案,分在 225 個資料夾977,930 字元1 枚
Fable 5(新模型)9 個檔案加 1 份總表43,406 字元4 枚

Sonnet 3.7 每一場戰鬥、每個道具、每個角色都開一個檔案,記的大多是畫面上本來就看得到的東西,像身上有多少錢、人站在哪裡。遊戲一直在變,這些筆記很快就過期。它還曾經連續 17 步都在新增、刪除記憶檔案,遊戲完全沒往前走。

Fable 5 只記畫面上看不到的東西:目前目標、打道館的計畫、試出來的戰術。它連丟 7 顆球都抓不到鯉魚王之後,自己寫下一條規則:連續 3 次失敗就換個時機按鍵。作者的結論是,值得記的是自己摸索出來、不寫下來就會消失的東西。

Anthropic 寶可夢記憶實驗數據圖:Sonnet 3.7 寫 413 個檔案拿 1 枚徽章,Fable 5 寫 10 個檔案拿 4 枚徽章
依 Anthropic 研究數據整理:記憶檔案數和徽章數剛好相反

規則寫太死,新模型反而變差

另一組實驗是資料庫問答,每題都開新對話,唯一能帶到下一題的就是記憶資料夾。研究團隊試了兩種提示:一種只告訴 Claude 記憶是拿來做什麼的,另一種硬性規定「只能記錯誤」。

結果規定「只能記錯誤」之後,新模型 Opus 5 靠記憶多拿到的分數少了快三成。越新的模型,讓它自己判斷什麼值得記,效果比事先訂死規則好。舊模型 Sonnet 4.6 相反,它常常不讀自己的記憶,明確提醒它「先讀記憶、驗證你的猜測」之後,分數幾乎翻倍。

放到 CLAUDE.md 上,意思是規則寫「要做到什麼」就好,不用把「怎麼做」每一步都規定死。

讓 AI 趁空檔整理記憶

研究裡還有一個做法叫 dreaming(做夢),讓 Claude 在沒工作的時候回頭翻對話紀錄,修正寫錯的筆記、合併重複的內容。

寶可夢實驗裡,Claude 曾把寶可夢中心的位置記錯,以為月見山已經走完,結果被同一個單向的落差送回原路三次。做夢時對照紀錄改正筆記之後,它重新進山洞,走到了華藍市。研究團隊另外拿一大批公司文件測試,讓 Claude 先整理出一套互相連結的筆記頁,再搭配搜尋回答問題,答對率比只用搜尋高了 8 個百分點。

用 Claude Code 的人自己也能做:定期打開記憶資料夾,叫 Claude 幫你刪過期的、合併重複的。

📖 延伸閱讀:AI 為什麼總忘記你說過的話?Agent 記憶原理

MEMORY.md 超過上限會被截掉

自動記憶的目錄 MEMORY.md 有讀取上限:開工時只讀前 200 行或前 25KB,超過的部分不會載入。寫在後面的記憶,Claude 開工時根本看不到。

Claude 為什麼忘了記過的規則

我用 Claude Code 寫官網文章、查關鍵字、排 Threads 貼文,記憶累積得很快。電腦上接了兩個 Chrome,一個是公司帳號,一個是個人帳號。10 月初我就叫 Claude 記下「個人的東西用個人的 Chrome 開」,查關鍵字用的 Google Ads 就屬於個人的東西。

2026 年 10 月 13 日,Claude 又跑去公司那個 Chrome 開 Google Ads。我回頭查才發現,這條記憶排在 MEMORY.md 第 200 行之後,開工時被截掉,Claude 根本沒讀到。後來我把它移到 MEMORY.md 最上面。

用中文寫記憶要注意檔案大小

MEMORY.md 的上限有兩個,先碰到哪個就截在哪。25KB 是檔案大小。中文字比英文字佔空間,一個中文字大約是三個英文字母,25KB 大約只裝得下 8,500 個中文字。

我現在的 MEMORY.md 只有 182 行,沒超過 200 行,檔案大小卻有 28KB,已經超過 25KB。檔案大小在 Mac 上對檔案按右鍵選「取得資訊」就看得到。每一行都是「標題+連結+一句說明」,中文說明寫長一點,還沒到 200 行就先超過大小上限。用中文寫記憶,要看的是檔案大小,行數只是參考。

終端機查詢 MEMORY.md 行數與檔案大小,182 行卻有 28KB
我的 MEMORY.md:182 行,大小約 28KB,記憶資料夾共 223 個檔案

把 MEMORY.md 改成索引

我現在的 MEMORY.md 分成三個部分:

  • 最上面一區叫「每次都要先看」:放最常被忘、忘了代價最大的幾條,像兩個 Chrome 的分工、一律用繁體中文回覆
  • 細節搬到個別檔案:MEMORY.md 每條只留一行標題和一句提示,完整內容放在該則記憶的檔案裡
  • 同主題拆成子索引:n8n 工作流程、其他專案、工具參考各有一份子索引,MEMORY.md 只留一行指過去

現在記憶資料夾裡有 223 個檔案,開工時讀的只有 MEMORY.md 這一份目錄。這跟 Anthropic 研究裡 Fable 5 的做法很像:一份總表放最重要的事,其他放進資料夾,需要時再翻。

我的 MEMORY.md 索引開頭,最上面是每次都要先看的區塊
MEMORY.md 開頭的「每次都要先看」區塊,最容易忘的規則放第一行

把重複的記憶合併成一條

記憶用久了,同一件事會被記好幾次。我寫文章的結構規則,前後被記成 11 則:前言多長、H2 怎麼下、FAQ 幾題,散在不同檔案。Google Ads 關鍵字規劃工具的查法也被記了 4 則。

我請 Claude 把同主題的記憶合併成一則,現在文章結構只剩一個檔案、MEMORY.md 裡一行。合併時也順便刪掉已經過期的內容。研究裡的「做夢」是在背景自動跑,我做的是同一件事,只是手動。

📖 延伸閱讀:Claude Code Token 怎麼省?8 個減少用量的技巧

常見問題 FAQ

Q1:CLAUDE.md 和 MEMORY.md 差在哪?

CLAUDE.md 是你寫的規則,開工時整份讀進去,適合放「每次都要遵守」的事。MEMORY.md 是 Claude 自己寫的記憶目錄,只讀前 200 行或前 25KB,放的是它從你的糾正裡學到的偏好和背景。重要的規則與其等 Claude 自己記,不如直接寫進 CLAUDE.md。

Q2:CLAUDE.md 寫多長才適合?

官方建議每份控制在 200 行以內。我的經驗是越短越好,只寫 Claude 不知道就會出錯的事。超過的部分可以拆到 rules 資料夾,只在特定工作時才讀,或改寫成 Skill。

Q3:怎麼確認 Claude 有讀到 CLAUDE.md?

最簡單的方法是直接問 Claude:「你現在讀到哪些 CLAUDE.md?」它說沒讀到的話,先檢查檔案放的位置對不對、檔名有沒有打錯。放在子資料夾裡的 CLAUDE.md 不會在開工時讀,Claude 碰到那個資料夾的檔案時才會讀。

Q4:不是工程師也能設定 Claude 的記憶嗎?

可以,CLAUDE.md 就是一份寫中文也行的文字檔。最簡單的做法是直接跟 Claude 說「把『一律用繁體中文回覆』加到 CLAUDE.md」,它會幫你寫進去。自動記憶也不用設定,預設就是開的,你只要在它做錯時糾正它,它會自己判斷要不要記。

Q5:Claude 網頁版和 App 也有記憶功能嗎?

有,但跟 Claude Code 是兩套。網頁版、桌面版和手機 App 的記憶,是 Claude 從你的對話紀錄整理出摘要,免費方案也能用,可以在設定裡暫停或重設,專案裡的對話另外分開記。Claude Code 的 CLAUDE.md 和 MEMORY.md 只存在你的電腦上,兩邊的記憶不會互通。

總結

讓 Claude 越用越聰明,靠的是 CLAUDE.md 和自動記憶這兩份檔案。CLAUDE.md 放每次都要遵守的規則,寫具體、控制在 200 行內;MEMORY.md 有 200 行和 25KB 兩個上限,用中文寫的話,通常會先超過 25KB。Anthropic 的寶可夢實驗裡,記 10 個檔案的模型贏過記 413 個的。記憶要定期刪、定期合併,Claude 開工時讀得到的記憶才有用。

想讓 Claude Code 接上你的自動化流程或公司內部系統,可以找我聊聊你的需求。

參考資料

同主題文章

AI 軟體開發