claude-mem 實測：Claude Code 跨對話記憶

用 Claude Code 久了一定遇過：每次開新對話，又要重新跟它講一次「這個專案在做什麼、昨天改到哪」。claude-mem 就是來解決這件事的外掛，它會把你上次做過的事記下來，下次自動帶進新對話。我把原始碼 clone 下來翻了一輪，也把它過濾 <private> 標籤的那段程式拿出來實際跑，下面是我的心得和幾個要注意的地方。

它是什麼

claude-mem 是 Alex Newman（thedotmack）做的記憶外掛。你工作時它在背景記下用了哪些工具、做了哪些事，用 AI 壓縮成摘要存在自己電腦的資料庫，下次開新對話再把相關的前情提要自動塞進來。

圖：claude-mem 的 GitHub 首頁。來源：github.com/thedotmack/claude-mem，2026-11-02 擷取。

• 星數 109,454、Fork 9,573、Apache-2.0 授權、TypeScript、2025-08-31 建立（GitHub API，查證日期 2026-11-02）
• 我讀的版本：commit c239a04（2026-11-01），package.json 版本 15.8.1

圖：README 上的介面預覽（左）和星數成長曲線（右），2026 年起幾乎是直線往上。來源：claude-mem 官方 README（授權 Apache-2.0）。

實際用起來長怎樣

圖：官方示範 GIF 抽 3 格。左邊是 Claude Code 在工作，右邊是 claude-mem 的網頁檢視器，每做完一件事就多一張摘要卡片。來源：claude-mem 官方 repo docs/public/cm-preview.gif（授權 Apache-2.0）。

從官方動畫可以看得很清楚：你在左邊照常跟 Claude Code 工作，右邊的檢視器會自動長出一張張卡片，標著「功能」「變更」「發現」這類分類，裡面是 AI 整理過的重點。下次開新對話時，這些卡片的精華就會變成前情提要。

我翻原始碼看到的

圖：上半是外掛掛了哪些事件，下半是我把原始碼的標籤過濾程式拿出來跑的結果。來源：MK 實測，2026-11-02。

1. 它是靠 hook 自動記錄的。 設定檔 plugin/hooks/hooks.json 一共掛了 9 種事件：Setup、SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、PostToolUseFailure、Stop、SubagentStop、SessionEnd。也就是說你每送一句話、每次工具執行前後，它都收得到，所以才能做到「完全不用手動」。

2. <private> 標籤真的有用。 我把 src/utils/tag-stripping.ts 原封不動拿出來，用 Node 22 跑了三個例子：

• 句子中間包住的帳號密碼整段被拿掉，前後的話都還在
• 只有開頭、沒有結尾的 <private> 不會被誤刪（程式註解有特別說明這是刻意的）
• 整句都包起來，存下來就是空字串

3. 規模比我想像的大。 整個 repo 大約 1,850 個 TypeScript 檔，內建 30 個 Skill（查記憶的 mem-search 就是其中之一）、36 個模式檔。其中 code--zh 是簡體中文模式，我沒看到繁體中文的。

運作架構：6 個零件

所以它不是單純一個 Skill 檔，而是「hook＋背景服務＋資料庫」一整套。好處是全自動，代價是電腦多一個常駐程式，出問題時要會用 npx claude-mem doctor 看診斷。

找舊紀錄：三步驟搜尋

圖：README 的 MCP Search Tools 段落。來源：claude-mem 官方 README（授權 Apache-2.0）。

search(query="authentication bug", type="bugfix", limit=10)   # 先拿索引，每筆約 50–100 token
timeline(...)                                                  # 看前後發生什麼
get_observations(ids=[123, 456])                               # 只抓需要的細節，每筆約 500–1,000 token

先看索引再抓細節，README 說大約能省 10 倍 token。這是作者的估算，我自己沒有量過，但邏輯上說得通：大部分時候你只需要其中兩三筆。

安裝

前置需求：Node.js 20 以上；Bun 和 uv 沒有的話會自動幫你裝（README）。

圖：README 的一行安裝指令，下面那段在講安裝時會請你登入。來源：claude-mem 官方 README（授權 Apache-2.0）。

npx claude-mem install

這裡要特別注意下面那段小字：安裝程式會開瀏覽器請你登入 claude-mem 帳號，送你 30 天免費試用的雲端「observer」；試用結束後改吃你的 Anthropic 方案額度，或你自己選 OpenRouter／Gemini 金鑰。不想登入的話，加 --provider 參數或設 CLAUDE_MEM_ONLINE_OPTIN=false 就能跳過。

圖：也可以在 Claude Code 裡用外掛市集裝。來源：claude-mem 官方 README（授權 Apache-2.0）。

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

裝完重開 Claude Code 就會生效。README 還特別提醒：npm install -g claude-mem 只會裝函式庫、不會掛 hook，別用錯。不想用了，有 npx claude-mem uninstall 可以移除。想要中文摘要，在 ~/.claude-mem/settings.json 設 "CLAUDE_MEM_MODE": "code--zh"。

我這次沒有把它長期裝在自己的主力專案上，主要是從原始碼和官方示範了解它怎麼運作；想試的人照上面一行指令裝，用一個不敏感的小專案先玩一週，最準。

注意事項

• 使用統計預設是開的：原始碼 telemetry.ts 寫明匿名使用統計是 opt-out，可以用 npx claude-mem telemetry disable 或設 DO_NOT_TRACK=1 關掉。
• 壓縮要花 token：摘要是 AI 做的，試用期過後就是你的方案額度或 API 費用在付。
• 隱私：它看得到你的提示和工具輸出。公司專案先確認公司規定，敏感內容記得用 <private> 包起來。選官方雲端 observer，代表摘要是在對方的服務產生；跨裝置雲端同步（cmem.ai Pro）會上傳完整提示文字，官方文件也直說「內容必須留在本機就別開」。截圖保存預設是關的。
• README 最後一段提到第三方代幣 CMEM，跟軟體功能無關，我不評論，也不建議任何人因此去投資。

圖：我影片版裡講三步驟搜尋的那一格（影片版在我的 FB Reels）。來源：MK 自製影片。

MK 觀點：適合誰、不適合誰

適合：長期維護同一個專案、常常隔天接著做的人；願意多花一點 token，換「不用每次重講背景」的人。

不適合：處理客戶機密、不能讓任何工具記錄內容的人；只是偶爾開 Claude Code 問個小問題的人；不想多一個背景程式和帳號的人。老實說，如果你只是要固定的專案背景，先把專案的 CLAUDE.md 寫好可能就夠用了。

常見問題

Q1：claude-mem 免費嗎？ 程式本身免費（Apache-2.0），但摘要會吃模型額度；官方雲端 observer 只有 30 天免費試用。

Q2：資料存在哪？ 預設在你自己電腦的 ~/.claude-mem/（SQLite 資料庫加 Chroma 向量庫）；跨裝置雲端同步是 cmem.ai Pro 功能，要另外開。

Q3：除了 Claude Code 還能用在哪？ 安裝程式支援 Codex CLI、Cursor、OpenCode、Copilot CLI、Antigravity 等十幾種；Gemini 目前主要是拿來產生摘要的模型選項。

Q4：會拖慢 Claude Code 嗎？ hook 大多是非同步或有逾時設定，但多跑一個背景 worker，比較舊的電腦可能會感覺得到。

延伸閱讀

• tstack 實測：讓 AI 把 PR 一路跑到合併
• day-trader-skill 實測：11 個交易 Skill
• AI 記錯一件事，能只改那一條嗎？
• AI 代理會不會闖禍？