結論先說
- CLAUDE.md 不會自動更新。 官方的定位是:CLAUDE.md 是「你寫的指令」,Claude 在每個會話開始時讀它。
- 會自動積累的是 auto memory(自動記憶):Claude 根據你的糾正和偏好自己記筆記,存在單獨的目錄裏,不改你的 CLAUDE.md。
- 想把某條規則寫進 CLAUDE.md,直接對 Claude 說,例如「把這條加到 CLAUDE.md」,官方文檔寫的就是這樣做。
- 用
/memory可以查看和編輯各處 CLAUDE.md 和自動記憶文件。 - 定期體檢:
/doctor prompt-audit會找過時、衝突、引用了不存在文件的指令,先給報告,不會擅自改。

圖:本站根據 Claude Code 官方文檔:How Claude remembers your project 整理的示意圖
本文根據 Claude Code 官方文檔《How Claude remembers your project》整理,資料核對於 2026-11-13。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Anthropic 官方網站。
適用於誰
- 搜「claude md 會 自動 更新 嗎」「如何 更新 claude md」的人;
- 發現 Claude Code 好像「記住了」某些習慣,不確定記在哪裏的人;
- 想讓 CLAUDE.md 保持新鮮、不過時的人。
一、兩套機制,別混
官方文檔開頭就把兩者分開:
- CLAUDE.md 文件:你寫的指令,給 Claude 持久的背景。每個會話都載入;
- Auto memory:Claude 自己寫的筆記,依據你的糾正和偏好。
官方對比表裏,CLAUDE.md 是「指令和規則」,auto memory 是「學到的習慣和模式」。想引導 Claude 的行為,用 CLAUDE.md;想讓 Claude 從你的糾正裏自己學,靠 auto memory。
二、Auto memory 是怎麼回事
官方說,auto memory 讓 Claude 不需要你寫任何東西就能跨會話積累知識,會儲存四類筆記:
user:你的角色、經驗、工作偏好;feedback:你給的糾正,和你確認過的做法;project:進行中的工作、截止時間、決策,是 Claude 從代碼或 git 歷史裏推不出來的;reference:項目之外的資訊在哪,比如問題跟蹤器、看板。
Claude 不會每個會話都存東西,只有它認為對以後的對話有用才記。它也會跳過能從代碼庫裏推出來的東西(架構、文件路徑、調試辦法),以及 CLAUDE.md 裏已經寫了的內容。
存在哪裏:每個項目有自己的目錄 ~/.claude/projects/<project>/memory/。同一個 git 倉庫下的所有工作樹和子目錄共用一個。裏面有一個 MEMORY.md 索引和若干主題文件。官方說明:這些是純 markdown,可以隨時編輯或刪除;自動記憶只在本機,不會同步到別的機器。
載入多少:每次對話開始會載入 MEMORY.md 的前 200 行,或前 25KB,以先到的為準;主題文件不在啟動時載入,Claude 需要時再讀。
怎麼開關:在會話裏打開 /memory,用裏面的開關,會把 autoMemoryEnabled 儲存到用戶設定 ~/.claude/settings.json;也可以在項目設定裏寫 "autoMemoryEnabled": false 只對一個項目關閉;或者設環境變量 CLAUDE_CODE_DISABLE_AUTO_MEMORY=1。
當你看到介面上出現「Saved 2 memories」「Recalled 2 memories」,就是 Claude 在讀寫這個目錄。
三、怎麼更新 CLAUDE.md

圖:本站根據 Claude Code 官方文檔:How Claude remembers your project 整理的示意圖
辦法一:直接讓 Claude 加。 官方文檔寫道,要把指令加到 CLAUDE.md,直接對 Claude 說,例如「add this to CLAUDE.md」,或者自己編輯文件。注意官方的區分:你說「記住,始終用 pnpm,不要用 npm」,Claude 會存進 auto memory,而不是 CLAUDE.md;想進 CLAUDE.md,要明確說「加到 CLAUDE.md」。
辦法二:/memory。 該命令列出你的 CLAUDE.md、CLAUDE.local.md 以及其他記憶文件的位置,包括用戶級和項目級中還不存在的文件;選中任何一個就用編輯器打開,不存在的會先創建。
辦法三:/init。 它會分析代碼庫,生成起始 CLAUDE.md,包含構建命令、測試說明和發現的約定。已有 CLAUDE.md 時,/init 提出改進建議,而不是覆蓋。 官方還有一個交互式的多階段流程,設環境變量 CLAUDE_CODE_NEW_INIT=1 後,它會問你要建哪些東西(CLAUDE.md、skills、hooks),用子代理探索代碼庫,給出可審閱的方案後才寫文件。
辦法四:體檢。 運行 /doctor prompt-audit,Claude 會檢查指令文件裏過時或衝突的內容,例如為舊模型寫的指令、引用了不存在的文件或命令、互相矛盾的文件,給出報告和建議修改,你要求之前不會改動任何文件。預設檢查 CLAUDE.md、CLAUDE.local.md、AGENTS.md,以及 .claude/ 和 ~/.claude/ 下的規則、技能、命令、子代理和輸出風格。
四、什麼時候該往 CLAUDE.md 裏加
官方列出的時機:
- Claude 第二次犯同一個錯;
- 代碼評審發現了 Claude 本該知道的這個代碼庫的事;
- 你在對話裏敲了和上次一樣的糾正;
- 新同事也需要同樣的背景才能上手。
寫法上,官方建議:每個文件盡量不超過 200 行,寫得具體到可以驗證(「用 2 個空格縮進」而不是「好好格式化」),用標題和列表組織,避免互相矛盾。更多寫法和模板見 /guides/claude-md-agents-md、/guides/claude-code-claude-md-templates-frontend-backend-data。
五、改完之後會生效嗎
官方在排障部分寫明:項目根目錄的 CLAUDE.md 在 /compact 之後會從磁盤重新讀取並重新注入會話,不會因壓縮而丟失;子目錄裏的 CLAUDE.md 和帶 paths 的規則則在需要時再次載入。官方沒有寫「編輯後是否立刻對當前會話生效」,保險的做法是改完新開一個會話。上下文壓縮的相關內容見 /guides/claude-code-context-compact。
六、需要付費版嗎
CLAUDE.md 和 auto memory 是 Claude Code 本身的功能,和你用哪種登入方式無關。如果你用訂閱登入 Claude Code,額度不夠或想換更大的訂閱,可以看 /chongzhi/claude-code。
常見問題
Q:Claude 說「我記住了」,那是寫進 CLAUDE.md 了嗎?
不一定。官方說你要求它記住的東西通常進 auto memory;想進 CLAUDE.md 要明確說。可以用 /memory 去看。
Q:auto memory 會不會越積越多把上下文佔滿?
只有 MEMORY.md 的前 200 行或 25KB 會在啟動時載入,超出的部分不載入,官方會提醒 Claude 精簡索引。
Q:能不能讓團隊共享 auto memory?
官方寫明 auto memory 只在本機,不會跨機器或雲環境同步。團隊共享的指令應當寫進項目裏的 CLAUDE.md。
相關教學
- /guides/claude-code-takeover-old-project-claude-md:接手老項目先寫 CLAUDE.md
- /guides/claude-code-settings-json:settings.json 怎麼配
參考資料
- Claude Code 官方文檔:How Claude remembers your project — https://code.claude.com/docs/en/memory
0 條評論
還沒有評論,來搶沙發~