跳至主要内容

01|讓 Claude Code 記得上次做了什麼(thedotmack/claude-mem)

讓 Claude Code 記得上次做了什麼

🎯 一行簡述:自動記下每個 session 做過的事、壓縮成摘要,下次開工時把相關的部分塞回 context,不必重講。

基本資料​

項⁠目說明
出⁠自Alex Newman(GitHub 帳號 thedotmack,帳號類型為 User)。
組⁠織⁠介⁠紹個人帳號發布,GitHub 個人簡介空白。README 同時推出託管服務 cmem.ai(登入後有 30 天試用),開源部分與商業部分的界線寫在 repo 的 docs/ip-boundary.md。
動⁠機README 的說法:持久的 agent 記憶應該容易嵌進開發工具、本機 agent、MCP server 與企業系統,所以選 Apache-2.0。
目⁠的讓 Claude Code 在 session 結束或重連後,仍保有對專案的知識連續性。
使⁠用⁠方⁠法npx claude-mem install,或在 Claude Code 內 /plugin marketplace add thedotmack/claude-mem 再 /plugin install claude-mem,裝完重啟 Claude Code。

它解決什麼問題​

LLM 本身沒有記憶,新 session 一開始是空白的(見 05|記憶 / Session)。常見做法是自己在規則檔寫「專案現況」,但那要人手維護。claude-mem 的做法是讓工具自己記。

它怎麼運作​

  1. 掛在生命週期 hook 上:SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd,共 5 個,不需手動操作
  2. 記下工具使用:每次工具呼叫被整理成一筆「observation」(例如決策、修 bug、資安警示)
  3. 用 AI 壓縮成摘要,存進本機 SQLite,並建立全文與向量(Chroma)混合索引
  4. 下次 SessionStart 把相關內容注入 context,並有一個本機網頁可即時看記憶串流

搜尋:三層漸進,先看索引再取細節​

claude-mem 提供 MCP 搜尋工具,設計成省 token 的三步:

步驟工具回傳
1search精簡索引與 ID(每筆約 50–100 token)
2timeline某筆前後發生了什麼
3get_observations只對挑出的 ID 取完整內容(每筆約 500–1,000 token)

README 稱先過濾再取細節約省 10 倍 token(作者自述,未見獨立量測)。另附 mem-search Skill,用自然語言查歷史。

使用時要知道​

  • 壓縮要靠模型:安裝時會問你用哪個供應商(claude-mem 託管的 observer、自備 OpenRouter 或 Gemini 金鑰、或你的 Anthropic 方案)。這代表工具輸出會送到你選的那一家,處理客戶資料前先想清楚選哪個
  • 安裝預設會引導登入 cmem.ai;不想登入,加 --provider 參數,或設 CLAUDE_MEM_ONLINE_OPTIN=false,或在 CI/非互動 shell 執行
  • 想排除的內容:用 <private> 標籤包起來,不會被儲存
  • 設定檔:~/.claude-mem/settings.json。CLAUDE_MEM_MODE 控制工作模式與 observation 的語言,內建 code(英文)、code--zh(簡體中文)、code--ja(日文)
  • 環境需求:Node.js 20 以上;Bun 與 uv 缺的話會自動安裝
  • 別用 npm install -g claude-mem:那只裝 SDK/函式庫,不會註冊 hook 與背景服務
  • 不只 Claude Code:README 也列出 OpenCode、Codex、Gemini、Cursor 等的安裝方式
  • 版本變動快:本文寫於 v13.37.0,專案仍每天更新

什麼時候用​

  • 同一個專案要接續多個 session,不想每次重講背景
  • 想回頭查「上次為什麼這樣決定」「那個 bug 怎麼修的」

只要留幾條固定規則,規則檔(CLAUDE.md)更簡單可控;claude-mem 適合補「規則寫不完的流水帳」。