CLAUDE.md 會自動更新嗎、怎麼更新:自動記憶 auto memory 和 CLAUDE.md 的區別

CLAUDE.md 不會被 Claude Code 自動改寫;會自動積累筆記的是另一套機制 auto memory。本文按官方文檔講清兩者區別、auto memory 存在哪、怎麼開關,以及更新 CLAUDE.md 的辦法:讓 Claude 幫你加、/memory、/init、/doctor prompt-audit。

NNathaniel bigo··原創首發·AI 輔助撰寫
10 分鐘讀完
資料核對於 2026-11-13 · 依據官方文檔與公開資料整理 免費帳號 帳號

結論先說

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

CLAUDE.md 和自動記憶的區別

圖:本站根據 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.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。

相關教學

參考資料

  • Claude Code 官方文檔:How Claude remembers your project — https://code.claude.com/docs/en/memory

Nathaniel 的更多內容

  1. 01

    LangGraph 流式輸出(Streaming)詳解:逐字 Token 流、節點進度與自定義事件寫法

    多步智能體如果等全部節點跑完才返回,網頁前端就會白屏乾等十幾秒。本文按 LangGraph 官方文檔講清 updates、messages、custom 與 values 四種 stream_mode 的區別,以及組合訂閱逐字打字機輸出加工具內部實時進度的完整代碼。

    其他 AI 工具0
  2. 02

    LangGraph 持久化與長期記憶怎麼配:Checkpointer、Store 與 PostgreSQL 實戰

    在生產環境跑 LangGraph,單靠 InMemorySaver 一重啟就會丟失全部對話。本文按官方文檔講清線程內短期檢查點(Checkpointer)與跨線程長期記憶(Store)的分工,以及用 langgraph-checkpoint-postgres 對接 PostgreSQL 的完整步驟。

    其他 AI 工具0
  3. 03

    LangGraph 多智能體怎麼寫:Supervisor 主管包與 Subgraph 隔離子圖實戰

    在 LangGraph 裏把單個圖擴展成多智能體協作有兩條官方路線:快速原型用預置包 langgraph-supervisor,大型生產系統用原生子圖(Subgraph)嵌套。本文講清兩種寫法的完整代碼、私有狀態隔離防 Token 膨脹技巧以及檢查點傳播規則。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入審批怎麼寫:interrupt 暫停圖運行與 Command 恢復實戰

    企業之所以選 LangGraph,很大程度看中它能安全掛起等待人工審批(Human-in-the-Loop)。本文按官方最新規範講清 interrupt() 動態暫停、Checkpointer 必備條件、Command(resume=...) 恢復執行,以及防止副作用重複運行的重入規則。

    其他 AI 工具0
  5. 05

    多 Agent 協作平台怎麼選:Dify、釦子(Coze)、n8n 與 LangGraph 多智能體機制對比

    搜「多agent協作平台」時,Dify、釦子、n8n 和 LangGraph 都宣稱支持多智能體,但底層的調度方式完全不同。本文跳過基礎安裝,專門從多 Agent 角色跳轉、子代理工具調用、上下文隔離與私有化部署四個維度幫你一次選準。

    其他 AI 工具0
  6. 06

    企業微信有官方 MCP 和 CLI 嗎:@wecom/cli 安裝初始化、長連接機器人與接入教學

    搜「企業 微信 有 mcp 嗎」不用再東拼西湊民間群機器人腳本了:企業微信官方已推出 @wecom/cli 命令行工具並內置 stdio 模式的 MCP Server。本文按官方開發者文檔講清安裝、智能機器人長連接初始化、業務命令與接入 Claude Code 步驟。

    Claude其他 AI 工具0

同產品的其他教學

  1. 01

    MCP 收費嗎:開源協議免費邊界、第三方 API 帳單與隱形 Token 開銷說明

    搜「mcp 收費 嗎」的人常擔心裝多了插件會被扣費。MCP(模型上下文協議)本身和官方 SDK 採用 MIT 協議完全免費;實際使用中可能產生費用的只有兩處:掛載過多工具佔用的大模型上下文 Token,以及部分外部商業數據源自帶的 API 套餐。

    Claude其他 AI 工具0
  2. 02

    MCP 協議最新版本更新了什麼:無狀態架構、OAuth 2.1、結構化輸出與異步 Tasks 詳解

    搜「mcp 重大 更新」「mcp 協議 更新」想補齊規範演進脈絡?本文對照 modelcontextprotocol.io 官方規範更新日誌,梳理從 Streamable HTTP 到無狀態優先架構、OAuth 2.1 資源伺服器、Elicitation 交互補參與異步 Tasks 擴展的核心變化。

    Claude其他 AI 工具0
  3. 03

    A2A 和 MCP 有什麼區別:工具連接協議與智能體通信協議的邊界和配合

    很多人問「有了 MCP 為什麼還要出 A2A,兩者是不是二選一的競爭關係」。兩份官方規範都明確寫明它們是上下互補關係:MCP 負責給單個智能體掛載工具與數據源,A2A 負責讓多個獨立黑盒智能體跨團隊、跨框架互相派單協作。

    Claude其他 AI 工具0
  4. 04

    LangGraph 怎麼使用 MCP:用 langchain-mcp-adapters 接入本地與遠程工具

    想讓自建的 LangGraph 狀態圖直接調用現成的 MCP 伺服器,官方標準方案是安裝 langchain-mcp-adapters 並使用 MultiServerMCPClient。本文講清 stdio 與 streamable_http 兩種配置寫法、異步圖運行及按節點分工具技巧。

    Claude其他 AI 工具0
  5. 05

    LangGraph 入門教學:Python 安裝、核心概念與跑通第一個狀態圖智能體

    面向搜「python 安裝 langgraph」和「langgraph 中文 文檔」的初學者:本文按 LangChain 官方最新 Graph API 規範,講清安裝步驟、State/Node/Edge 四大概念,並從零寫出第一個帶工具調用循環的 StateGraph。

    Claude其他 AI 工具0
  6. 06

    Claude Agent SDK 子代理怎麼寫:AgentDefinition 配置、權限收斂與 Python/TS 示例

    在 Python 或 TypeScript 裏用 Claude Agent SDK 編排多角色協作,核心是配置 ClaudeAgentOptions 的 agents 字段與 AgentDefinition。本文講清必開的 Agent 委派權限、工具收斂、模型分級與完整代碼示例。

    Claude0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~