高效 AI 駕馭術
Claude Code 記憶怎麼用?MEMORY.md、auto memory 與 Codex memories 的寫法和整理(2026)
AI 寫程式工具的記憶該放什麼、跟 CLAUDE.md、AGENTS.md 和 spec 檔怎麼分工,Claude Code 的 auto memory 和 Codex 的 Memories 各怎麼運作,以及我怎麼寫、怎麼整理四十幾則記憶。
Kelvin Wang · · 10 分鐘閱讀
重點整理
- 記憶存我給過的回饋,規則檔存所有工具都要遵守的事,spec 存一個專案的完整要求清單。
- Claude Code 的記憶是一則一個檔案,MEMORY.md 當索引,每次對話載入前 200 行或 25KB。
- Codex 的 Memories 預設關閉,由背景程序產生,官方建議別拿它當規則的唯一來源。
- 一則記憶寫規則、原因和怎麼套用;重複的合併、錯的刪掉、相關的互相連結。
我把記憶當成存放回饋的地方:我審稿時說過的話、糾正過的做法,連同原因一起記下來。要讓每個工具都遵守的規則寫在 AGENTS.md 或 CLAUDE.md,一個專案的完整要求清單寫在 spec 檔,一定不能違反的寫成測試。Claude Code 會自動把記憶存成檔案,放在 ~/.claude/projects/<專案>/memory/1;Codex 也有 Memories 功能,但預設關閉,而且是背景產生的資料,不適合手動維護2。
這是 AI harness 七個部分裡的「記憶」。總覽講它是什麼,這裡講怎麼寫、怎麼整理。
記憶、CLAUDE.md、AGENTS.md、spec 檔各放什麼?
四種檔案都是寫給 AI 讀的文字,差別在誰寫、誰讀得到、管多大的範圍:
| 檔案 | 誰寫 | 誰讀得到 | 放什麼 |
|---|---|---|---|
| 記憶 | AI 自己寫,我也可以改 | 只有這台電腦上的同一個工具 | 我給過的回饋、確認過的做法、程式碼看不出來的專案狀態 |
CLAUDE.md/AGENTS.md | 我寫 | 每個讀這份檔案的工具,跟著 repo 走 | 測試指令、已經做過的決定、所有工具都要遵守的規則 |
| spec 檔 | 我和 AI 一起寫,放在 repo | 任何打開 repo 的人和工具 | 一個專案的完整要求、編號、完成狀態 |
| 測試 | 我和 AI 一起寫 | 建置流程 | 一定要成立、不能靠模型記得的規則 |
我判斷一件事要放哪裡,只問兩個問題:
- Codex 也需要知道嗎? 需要,就寫進
AGENTS.md。記憶只存在這台電腦、只有 Claude Code 讀得到1,Codex 的記憶也是它自己的本機資料2,兩邊不互通。 - 這是一條規則,還是一份清單? 規則(「算式要算完」)放記憶或規則檔;清單(交易所專區十幾條要求、哪條做完了、對應哪個 commit)放 spec 檔。記憶裡只寫一句「清單在這份 spec」。
規則檔怎麼寫在CLAUDE.md、AGENTS.md 那篇;spec 怎麼寫在先寫 Spec,再寫 Plan。
Claude Code 的 auto memory 怎麼運作?
auto memory 在本機的 session 預設開啟1。Claude 工作時會自己判斷哪些資訊下次用得到,存成四種記憶,種類寫在檔案 frontmatter 的 type:
user:你的角色、專長和工作偏好。feedback:你給的糾正,以及你確認過的做法。project:進行中的工作、期限,以及從程式碼和 git 紀錄看不出來的決定。reference:專案外的資料在哪,例如 issue 追蹤系統或儀表板。
程式碼裡就看得出來的東西(架構、檔案路徑、除錯方法)它不記,CLAUDE.md 已經寫過的也不記1。你也可以直接說「記住,測試要先開本機 Redis」,它會存進記憶;要寫進 CLAUDE.md 的話,就明說「加到 CLAUDE.md」1。
檔案的結構是一個索引加上多個主題檔:
~/.claude/projects/<專案>/memory/
├── MEMORY.md # 索引,一則記憶一行,每次對話都載入
├── fix-the-whole-class.md # 一則記憶
├── no-self-evident-copy.md # 一則記憶
└── ...
有幾個細節會影響記憶怎麼寫,都出自官方文件1:
MEMORY.md只載入前 200 行或前 25KB,先到哪個算哪個。超過的部分開工時看不到,所以索引一則一行,細節放主題檔。- 主題檔不會在開工時載入。Claude 需要時才用檔案工具去讀,所以索引那一行要寫到光看就知道什麼時候該打開它。
- 同一個 git repo 的所有 worktree 共用一個記憶資料夾,但不跨電腦,也不進雲端環境。
- subagent 讀不到主對話的記憶,fork 出來的除外。派給 subagent 的工作,該遵守的規則要寫進交代給它的說明裡。
- 檔案寫入時會自動加上
modified時間,你和 Claude 都看得出這條記憶多新。 - 舊的對話紀錄會被定期清掉,記憶檔不會,除非你或 Claude 去改或刪。
開關在對話裡的 /memory,會寫進 ~/.claude/settings.json 的 autoMemoryEnabled;只想關掉某個專案,就在那個專案的設定裡寫 "autoMemoryEnabled": false,也可以用環境變數 CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 全部關掉1。
我的網站專案目前有 45 則記憶,索引 44 行、約 6.5KB,離上限還很遠。種類分布如下:
統計 ~/.claude/projects/ 底下這個網站專案的記憶資料夾,依每個檔案 frontmatter 的 type 欄位計算。
一半以上是 feedback。對我來說,記憶最有用的地方就在這裡:審稿時講過一次的話,下次改稿還找得到。
Codex 有記憶功能嗎?
有,叫 Memories,2026-11-17 查詢時的官方文件是這樣寫的2:
- 預設關閉。桌面 app 在 Settings → Personalization 打開「Enable Codex memories」,只對這台電腦生效;CLI 在
config.toml加[features]底下的memories = true。 - 背景產生。對話閒置一段時間後,Codex 在背景把符合條件的對話整理成摘要,太短或還在進行的對話會跳過,祕密資訊會遮掉。剩餘額度低於門檻時這一輪會略過。
- 存在本機。放在
~/.codex底下(新設定是memories_v2/),跟 ChatGPT 網頁版的記憶是兩套。 - 可以逐對話控制。在對話裡用
/memories決定這次要不要用舊記憶、要不要產生新記憶;設定裡也能排除用了 MCP 或網頁搜尋的對話。 - 不建議手改。文件說這些檔案是產生出來的狀態,別把手動編輯當成主要的控制方式;要清掉就用「Delete Codex memories」整個重設。
最重要的一句是:記憶是輔助回想的那一層,不該是「每次都必須套用的規則」的唯一來源,團隊一定要遵守的事放 AGENTS.md 或 repo 裡的文件2。這跟 Claude Code 文件的說法一致:兩邊的記憶都是 context,不是強制設定1。
所以兩個工具主要差在「誰來整理」。Claude Code 的記憶是可以直接打開、編輯的 Markdown 檔;Codex 的記憶交給背景程序整理。不管用哪個,我要兩邊都遵守的規則都寫在 ~/ai-config/AGENTS.md,各自的記憶只放那個工具自己用得到的回饋。
一則記憶長什麼樣子?
下面是我其中一則記憶的格式,內容翻成中文、拿掉了 session ID 這類內部欄位(實際檔案是英文):
---
name: fix-the-whole-class
description: 指出一處問題時,把同一類全部找出來,一次改完
metadata:
type: feedback
modified: 2026-10-25T13:22:39.708Z
---
使用者指出一處問題(沒算完的算式、沒有答案的 FAQ、多餘的免責句),
當成一整類處理:掃過所有交易所文案檔和實際頁面,同一批全部改完。
**Why:** 2026-10-25 審交易所評測時,使用者逐條指出「12 × 20%」、
空的 FAQ 這類問題。之後一掃,線上還有 32 處算式、42 處沒答案、38 句免責話。
**How to apply:** 要求清單在
spec/2026-10-25-exchange-requirements-and-polish-plan.md,
新回饋先對照清單再追加。相關:[[apply-review-directly]]、[[exchange-section-state]]
每個部分各有用途:
description:索引那一行就是從這裡來的。主題檔開工時不載入,所以這一行要寫成規則本身,不寫成標題。「指出一處就改整類」可以直接照做,「審稿回饋」不行。- 規則本文:一兩句,寫要做什麼。
- Why:日期加上當時發生了什麼,最好有我的原話。規則碰到例外時,AI 要靠原因判斷該不該套用。
- How to apply:去哪裡查、跟哪一則有關。這一則把清單指向 spec 檔,本身不重抄清單。
我的 45 則記憶裡,41 則有 Why,43 則有 How to apply,42 則至少連到另一則。
兩條審稿規則怎麼變成記憶?
總覽舉過兩條我審稿的規則。這裡看它們在記憶和 spec 裡各寫了什麼。
改一個就掃整類。交易所評測的 spec 第 A2.11 條寫:「12 × 20%」要寫成「2.4 USDT」,「0.06% ×(1 − 20%)」要寫成「0.048%」。spec 記的是這一條要求;記憶記的是處理方式:這種回饋一出現,就把 28 個文案檔和實際頁面整個掃一遍。照這個方式掃,一共找出 32 處沒算完的算式、42 處答案只有「官方沒寫」的句子、38 句免責話,再分批改完。
刪掉版面已經說明的文字。Binance 事件頁的標題原本是「事件經過(新的在上)」,列表本身看得出排序,括號就是多的。我那天說的是:「這種很明顯的文案就不要放了」。記憶把它寫成一類:「這頁持續更新」「下方連結」「數字會自動更新」這種在講頁面本身的句子,上線前一律掃掉;How to apply 再指回「改一個就掃整類」。
第二則連回第一則,是因為這條規則本身就要用第一條的方式執行。
記憶要怎麼整理?
auto memory 會自己越記越多,不整理的話,同一件事會出現兩則、舊的規則會跟新的打架。官方文件也提醒,兩條指示互相矛盾時,Claude 可能隨便挑一條1。我整理的方式:
- 先找再寫。新回饋進來,先看索引有沒有同一類的記憶,有就加在那一則裡,不另開一則。一個主題一個檔案。
- 規則變了,改原本那一則,加日期。我的內容生產記憶在 11 月 3 日寫的是「寫完、審完就直接上線」,11 月 5 日我改成發布前要先問我。那則記憶沒有刪掉重寫,而是在最後加一段「2026-11-05 update」,寫清楚新規則並連到新的那一則。之後讀到的人(或 AI)看得出規則怎麼變過、現在以哪條為準。
- 範圍寫清楚,避免假矛盾。「網站改動直接 push 到 main」和「文章 push 前要問我」看起來衝突,其實範圍不同:前者是程式和版面,後者是文章。較新的那則在 Why 裡寫明範圍:push 會部署網站,push 文章就等於發布。
- 錯的直接刪。記憶檔是一般的 Markdown,可以隨時改或刪;在
/memory裡選 auto memory 資料夾就能打開1。過時的專案狀態(某個功能「還沒上線」)留著只會誤導,上線了就改掉。 - 相關的互相連結。我的記憶檔用
[[檔名]]互相指。讀到一則,順著連結就能找到同一類的其他規則,不用全部載入。 - 該給所有工具的,搬到 AGENTS.md。一條回饋如果 Codex 也要遵守,記憶就不是它的終點。
- 一定要成立的,改成測試。例如網站上每篇文章都要歸到一個主題,現在由
tests/blog-topics.test.ts擋住,不靠記憶。
我留不留一則記憶,看的是有沒有需求:會長期重複做的事,才寫成一個 Markdown 檔。目前還沒有要建完整的記憶庫,也還沒用 LangChain memory 這類工具做記憶管理。
想深入 AGENTS.md、CLAUDE.md 怎麼寫?範例+一份規則管所有 AI 寫程式工具(2026) 規則檔放哪、寫什麼不寫什麼,以及一份規則給兩個工具共用的做法。有了記憶,還需要自己審稿嗎?
需要。兩家的文件都說記憶是 context,不是強制設定12;有了它,AI 開工時比較可能做對,但不保證。
我每篇都會自己看過。記憶讓這些規則在下次改稿時還找得到,我最後再檢查稿子有沒有做到。沒做到的,再看是記憶寫得不清楚、放錯地方,還是該改成測試。
常見問題
Claude Code 的記憶會跟著 git repo 走嗎?
不會。記憶在 ~/.claude/projects/ 底下,是這台電腦的資料,不跨電腦也不進雲端環境1。換電腦或給同事用的規則,要寫進 repo 裡的 CLAUDE.md 或 AGENTS.md。
subagent 會讀到我的記憶嗎?
不會,fork 出來的 subagent 例外1。所以我派研究或寫作給 subagent 時,會把該遵守的規則寫成一份交代說明,連同檔案一起給它。平行開發的做法在subagent 平行開發那篇。
怎麼清除 Claude Code 或 Codex 的記憶?
Claude Code:/memory 打開 auto memory 資料夾,刪掉不要的檔案,並記得刪掉 MEMORY.md 裡對應的那一行1。Codex:桌面 app 選「Delete Codex memories」整個重設,或在單一對話裡用 /memories 關掉這次的使用和產生2。
資料來源