佛系程序员_ Claude Code 最火插件 Claude-Mem 完整解析（转载）

学习笔记

网站开发

发布日期: 2026-04-17 17:06:11

喜欢量: 5 个

阅读次数: 50

来源：https://hackmd.io/@BASHCAT/S1tqslOwWe Claude Code 最...

来源：https://hackmd.io/@BASHCAT/S1tqslOwWe

Claude Code 最火插件 Claude-Mem 完整解析：26000 顆星背後的技術與爭議
claude-mem-cover

「我們用 SQLAlchemy 而不是 Django ORM，因為……」

打到一半我停下來了。這段話我這禮拜已經講了第四次。每次開新的 Claude Code 會話，它就像被 MIB 的記憶消除器閃過一樣，上一秒還跟你討論得熱火朝天的技術細節，下一秒全忘光。

說實話，這種感覺很像帶一個每天都失憶的實習生 — 能力很強，但你得從頭教起。

我不是唯一有這種困擾的人。Twitter 上到處都是類似的抱怨：有人說花了 20 分鐘重新解釋同樣的架構；有人說每天早上開會前得先「教育」Claude 昨天做了什麼。AI 編碼助手的失憶症，已經成了開發者最大的生產力黑洞之一。

然後我發現了 claude-mem。

claude-mem-before-after

一個開發者和他的記憶引擎
claude-mem 是 Alex Newman（GitHub 上叫 @thedotmack）做的一個 Claude Code 插件。說白了，就是幫 Claude 裝上一顆「長期記憶大腦」。

它做的事情很直覺：自動記錄 Claude 在編碼過程中做的每一件事，用 AI 把這些記錄壓縮成精華摘要，然後在你下次開新會話的時候，把相關的歷史上下文悄悄塞回去。Claude 甚至不知道自己曾經忘記過 — 對它來說，好像一直都記得。

截至我寫這篇文章的時候（2026 年 2 月），這個專案在 GitHub 上已經拿到了超過 26,200 顆星，1,745 個 fork，多次衝上 GitHub Trending 第一名。安裝方式簡單到不像話：

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
兩行。重啟 Claude Code。搞定。

從下一次會話開始，你過去的編碼歷史就會自動出現在 Claude 的上下文裡。不需要手動貼上什麼東西，不需要維護任何文件，它就是安靜地在背景運作。

三層漸進式披露：這才是真正聰明的地方
好，技術人愛聽技術。claude-mem 最核心的設計哲學叫做 Progressive Disclosure（漸進式披露），用一個生活化的比喻來說：

想像你走進一間圖書館找資料。

傳統做法是把整間圖書館的書全搬到你桌上 — 這就是大多數人用 CLAUDE.md 的方式，把所有歷史一股腦塞進 context window。結果呢？Token 燒光了，真正重要的資訊反而被淹沒。

claude-mem 的做法更像一個聰明的圖書館員。你問她：「我上週處理過認證相關的 bug 嗎？」她先拿出一張索引卡片告訴你：「有的，週二和週四各有一次。」（這是第一層，大概消耗 50-100 tokens。）

你說：「週四那次是什麼情況？」她翻出時間軸，告訴你前後發生了什麼。（第二層，中等消耗。）

你說：「給我看完整記錄。」她這才把完整的觀察筆記拿出來。（第三層，500-1,000 tokens。）

claude-mem-progressive-disclosure

這套設計讓 claude-mem 實現了大約 10 倍的 token 節省。在 AI 編碼的世界裡，token 就是金錢，也是思考空間。省下的 token 意味著 Claude 可以把更多注意力放在你真正的問題上，而不是被歷史記錄塞滿腦袋。

在底層，這套系統由五個 MCP 工具驅動：search 負責搜索記憶索引、timeline 提供時間線上下文、get_observations 提取完整觀察、save_memory 手動存儲重要資訊，還有一個始終可見的 __IMPORTANT 工作流文檔。整個流程中，Claude 像一個有方法論的研究員，而不是一個什麼都往腦裡塞的考生。

引擎蓋下面：Hooks、SQLite 和向量資料庫
claude-mem 的架構不算簡單，但設計得很乾淨。

核心是六個 Hook 腳本，分別掛在 Claude Code 的五個生命週期事件上：會話開始、使用者提交提示、工具使用後、工作停止、會話結束。每個事件觸發時，claude-mem 都在背景默默做事 — 開始時注入歷史上下文，工具使用後捕獲觀察，結束時生成壓縮摘要。

存儲這端用的是雙引擎：SQLite 負責結構化資料（會話記錄、觀察、摘要），Chroma 向量資料庫負責語義搜索。搜索的時候兩邊同時查詢，既能精確匹配關鍵字，又能理解語義相似性。

中間還有一個 Worker Service 跑在本地 port 37777 上，由 Bun 管理，提供 HTTP API 和一個即時的 Web Viewer UI。你可以在瀏覽器裡打開 http://localhost:37777，即時看到 Claude 的記憶流 — 這個功能在 debug 的時候很好用。

AI 壓縮的部分用的是 @anthropic-ai/claude-agent-sdk，這是 Anthropic 官方的 Agent SDK。觀察記錄先經過 AI 處理，提取關鍵資訊，壓縮成結構化摘要，再存入資料庫。

跟 CLAUDE.md 到底差在哪？
每個 Claude Code 用戶都知道 CLAUDE.md — 它是 Claude Code 內建的記憶機制，一個靜態的 Markdown 文件，每次會話開始時會被載入 context。

怎麼說呢，CLAUDE.md 就像一本你手寫的筆記本。你記得寫什麼就有什麼，忘了寫就沒有。而 claude-mem 更像是一個隨時跟在你身邊的自動速記秘書 — 你做的每件事它都記，記完還幫你整理歸檔，下次需要的時候精準地把相關內容遞給你。

具體來說：CLAUDE.md 的內容是手動維護的，全部載入 context window，沒有搜索能力，沒有壓縮。claude-mem 則是自動捕獲、按需載入、支援語義搜索、AI 智能壓縮，還有 <private> 標籤可以排除你不想被記住的敏感內容。

兩者不是替代關係。CLAUDE.md 適合存放項目規則、編碼風格偏好這類不常變的指令；claude-mem 則負責記錄你日常的開發活動、決策過程、Bug 修復歷史。搭配使用效果最好。

Endless Mode：讓 Claude 永遠不會「忘到一半」
claude-mem 還有一個 Beta 實驗功能叫 Endless Mode（無限模式），採用所謂的「仿生記憶架構」。

問題是這樣的：Claude 的 context window 是有限的。在高強度的編碼會話中，大概執行 50 次工具操作後，context 就快爆了。到了這個時候，Claude 的表現會急劇下降 — 它開始忘記對話開頭的內容，重複問你已經回答過的問題。

Endless Mode 的解法很暴力但有效：每次工具執行完，Hook 會阻塞式地等待 Worker 處理完觀察，然後把壓縮後的摘要注入回 context，同時清除已經過時的原始內容。這樣 context 就像一條持續流動的河，而不是一個不斷被填滿的水桶。

目前 Endless Mode 還在 beta/endless-mode 分支上，需要手動切換。但這個方向是對的 — 長會話能力會是 AI 編碼工具的下一個戰場。

(更多略)

[阅读原文](https://hackmd.io/@BASHCAT/S1tqslOwWe)

yyii

https://amtb.info/show/Mzcy

本博客所有文章除特別声明外,转载请注明来源佛系程序员 !