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

> claude-mem 是十萬星開源外掛，用 hook 自動記錄 Claude Code 的工作、用 AI 壓縮成摘要，下次開對話自動帶入前情提要。我讀了原始碼、測了 private 標籤，也整理登入、遙測與費用要注意的地方。

- 作者：Michael Kuo（https://mk-ai-notes.pages.dev/about/）
- 發布日期：2026-11-02（2026-11-02T20:08:00+08:00）
- 原文網址：https://mk-ai-notes.pages.dev/posts/skill-claude-mem/
- 分類：GitHub 飆星與 Skill 實測（https://mk-ai-notes.pages.dev/category/github/）
- 系列：MK 熱門 Skill 實測 第 8 篇／共 11 篇（https://mk-ai-notes.pages.dev/series/mk-skill-lab/）
- 標籤：Claude Code、Skill、AI 記憶、MCP、外掛
- 閱讀時間：約 9 分鐘（約 1929 字）
- 參考來源：https://github.com/thedotmack/claude-mem

![claude-mem 實測：Claude Code 跨對話記憶](https://mk-ai-notes.pages.dev/og/skill-claude-mem.png)

---

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

## 它是什麼

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

![claude-mem 的 GitHub 首頁](https://mk-ai-notes.pages.dev/img/skill-claude-mem/gh-repo-home.jpg)
*圖：claude-mem 的 GitHub 首頁。來源：[github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem)，2026-11-02 擷取。*

- 星數 109,454、Fork 9,573、Apache-2.0 授權、TypeScript、2025-08-31 建立（[GitHub API](https://api.github.com/repos/thedotmack/claude-mem)，查證日期 2026-11-02）
- 我讀的版本：commit `c239a04`（2026-11-01），`package.json` 版本 15.8.1

![README 上的介面預覽與星數成長曲線](https://mk-ai-notes.pages.dev/img/skill-claude-mem/readme-preview-star-history.jpg)
*圖：README 上的介面預覽（左）和星數成長曲線（右），2026 年起幾乎是直線往上。來源：claude-mem 官方 README（授權 Apache-2.0）。*

## 實際用起來長怎樣

![官方示範動畫抽出的三格畫面：左邊是 Claude Code，右邊是 claude-mem 的網頁檢視器](https://mk-ai-notes.pages.dev/img/skill-claude-mem/official-preview-frames.jpg)
*圖：官方示範 GIF 抽 3 格。左邊是 Claude Code 在工作，右邊是 claude-mem 的網頁檢視器，每做完一件事就多一張摘要卡片。來源：claude-mem 官方 repo `docs/public/cm-preview.gif`（授權 Apache-2.0）。*

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

## 我翻原始碼看到的

![claude-mem 掛載的 hook 事件與 private 標籤過濾的實際執行結果](https://mk-ai-notes.pages.dev/img/skill-claude-mem/claude-mem-hooks-private.png)
*圖：上半是外掛掛了哪些事件，下半是我把原始碼的標籤過濾程式拿出來跑的結果。來源：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 個零件

| 零件 | 做什麼 |
| --- | --- |
| 生命週期 hook | 對話開始、送出提示、工具執行前後、結束時把資料交出去 |
| 安裝檢查 | 確認 Bun、uv 這些相依套件，壞了可以 `npx claude-mem repair` |
| Worker 服務 | 在你電腦背景跑的 HTTP 服務，負責壓縮、搜尋，也提供網頁檢視器 |
| SQLite 資料庫 | 存對話、觀察紀錄、摘要 |
| mem-search Skill | 讓你直接問「上次那個登入 bug 怎麼修的」 |
| Chroma 向量庫 | 語意加關鍵字的混合搜尋 |

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

## 找舊紀錄：三步驟搜尋

![README 的 MCP 三步驟搜尋說明](https://mk-ai-notes.pages.dev/img/skill-claude-mem/readme-mcp-3-layer.jpg)
*圖：README 的 MCP Search Tools 段落。來源：claude-mem 官方 README（授權 Apache-2.0）。*

```text
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](https://github.com/thedotmack/claude-mem#system-requirements)）。

![README 的一行安裝指令與登入說明](https://mk-ai-notes.pages.dev/img/skill-claude-mem/readme-install.jpg)
*圖：README 的一行安裝指令，下面那段在講安裝時會請你登入。來源：claude-mem 官方 README（授權 Apache-2.0）。*

```bash
npx claude-mem install
```

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

![README 的 Claude Code 外掛市集安裝方式](https://mk-ai-notes.pages.dev/img/skill-claude-mem/readme-plugin-install.jpg)
*圖：也可以在 Claude Code 裡用外掛市集裝。來源：claude-mem 官方 README（授權 Apache-2.0）。*

```text
/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**，跟軟體功能無關，我不評論，也不建議任何人因此去投資。

![MK 影片中三步驟搜尋的白板畫面](https://mk-ai-notes.pages.dev/img/skill-claude-mem/video-frame-search.jpg)
*圖：我影片版裡講三步驟搜尋的那一格（影片版在我的 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 一路跑到合併](https://mk-ai-notes.pages.dev/posts/skill-tstack/)
- [day-trader-skill 實測：11 個交易 Skill](https://mk-ai-notes.pages.dev/posts/skill-day-trader-skill/)
- [AI 記錯一件事，能只改那一條嗎？](https://mk-ai-notes.pages.dev/posts/ep03-knowledge-edit/)
- [AI 代理會不會闖禍？](https://mk-ai-notes.pages.dev/posts/ep10-agent-safety/)

引用本文請附原文網址：https://mk-ai-notes.pages.dev/posts/skill-claude-mem/（作者：Michael Kuo）