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

🎯 一行簡述:自動記下每個 session 做過的事、壓縮成摘要,下次開工時把相關的部分塞回 context,不必重講。
- Repo:https://github.com/thedotmack/claude-mem(Apache-2.0;官網 claude-mem.ai)
基本資料
| 項目 | 說明 |
|---|---|
| 出自 | 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 的做法是讓工具自己記。
它怎麼運作
- 掛在生命週期 hook 上:SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd,共 5 個,不需手動操作
- 記下工具使用:每次工具呼叫被整理成一筆「observation」(例如決策、修 bug、資安警示)
- 用 AI 壓縮成摘要,存進本機 SQLite,並建立全文與向量(Chroma)混合索引
- 下次 SessionStart 把相關內容注入 context,並有一個本機網頁可即時看記憶串流
搜尋:三層漸進,先看索引再取細節
claude-mem 提供 MCP 搜尋工具,設計成省 token 的三步:
| 步驟 | 工具 | 回傳 |
|---|---|---|
| 1 | search | 精簡索引與 ID(每筆約 50–100 token) |
| 2 | timeline | 某筆前後發生了什麼 |
| 3 | get_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 適合補「規則寫不完的流水帳」。