外觀

語言

高效 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 分鐘閱讀

重點整理

  1. 記憶存我給過的回饋,規則檔存所有工具都要遵守的事,spec 存一個專案的完整要求清單。
  2. Claude Code 的記憶是一則一個檔案,MEMORY.md 當索引,每次對話載入前 200 行或 25KB。
  3. Codex 的 Memories 預設關閉,由背景程序產生,官方建議別拿它當規則的唯一來源。
  4. 一則記憶寫規則、原因和怎麼套用;重複的合併、錯的刪掉、相關的互相連結。

我把記憶當成存放回饋的地方:我審稿時說過的話、糾正過的做法,連同原因一起記下來。要讓每個工具都遵守的規則寫在 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 一起寫建置流程一定要成立、不能靠模型記得的規則

我判斷一件事要放哪裡,只問兩個問題:

  1. Codex 也需要知道嗎? 需要,就寫進 AGENTS.md。記憶只存在這台電腦、只有 Claude Code 讀得到1,Codex 的記憶也是它自己的本機資料2,兩邊不互通。
  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,離上限還很遠。種類分布如下:

我的網站專案記憶,依種類 則;2026-11-17
  • feedback(我給的回饋) 24
  • project(專案狀態) 17
  • reference(外部資料在哪) 3
  • user(我是誰) 1

統計 ~/.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。

資料來源

  1. 1. How Claude remembers your project · Claude Code Docs · 2026-11-17 查詢
  2. 2. Memories · OpenAI Codex Docs · 2026-11-17 查詢

關於作者

Kelvin Wang

電機工程師,和 AI Agent 做工具,分享工程與投資的實作筆記。

更多關於我