← 返回部落格
Ai預計閱讀 7 分鐘

claude-mem 爆紅:它給 coding agent 的是一個檔案櫃,不是記憶

發布於 2026年11月2日
claude-mem 爆紅:它給 coding agent 的是一個檔案櫃,不是記憶

每個 coding agent 都有一個同樣尷尬的毛病。你花一整個下午解釋為什麼 auth middleware 不能碰、舊的 config 放在哪裡、哪兩個測試是故意不穩的。然後你闔上筆電。第二天早上,agent 像見到陌生人一樣跟你打招呼,還興沖沖地建議你把那個你叫它別動的檔案重構一下。

這個落差就是 claude-mem 想解決的事,而星數顯示很多人有同感。這個 repo 大約 11 萬顆星,過去一週多了 5,850 顆,連著好幾天排在 GitHub 週榜第一。Alex Newman 的專案自稱是 Claude Code 的「持久記憶壓縮系統」,關鍵字是壓縮,不是儲存。

到底存了什麼

機制沒有宣傳詞那麼神奇。claude-mem 掛在 Claude Code 本來就開放的生命週期 hook 上:SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、Stop、SessionEnd。每個 hook 就是一行指令,claude-mem hook claude-code <event>,由安裝器丟到 PATH 上的一個小啟動器負責執行。

你工作的過程中,工具呼叫會被轉成「observations」——關於 agent 做了什麼、發生什麼事的簡短語意筆記。一個由 Bun 管理的背景 worker 服務會把它們寫進 SQLite。新 session 開始時,最相關的 observations 會在你打字之前先被注入 context。

技術堆疊裡還有一個 Chroma 向量資料庫負責語意搜尋,配上 SQLite 的 FTS5 做關鍵字搜尋。實務上這個混合很重要:「上週二那個 migration script」是關鍵字查詢,「token 刷新會悄悄失敗的那個東西」是語意查詢,而這兩種你都會打。

有兩個細節值得提出來,因為它們說明這專案真的被人拿去實戰過。第一,<private> 標籤:包在裡面的東西永遠不會被存下來。第二,截圖是 opt-in、預設關閉,而且只有在另外開啟圖像推論時才會送給 observer 模型。有人想過「記憶工具悄悄變成監控工具」這個失敗模式。

A wooden card catalog drawer pulled open, index cards fanned out under soft blue light

三層式檢索的把戲

我覺得設計得真正好的地方是搜尋介面。claude-mem 不是把記憶一股腦倒進 context、祈禱模型自己整理,而是提供一套三段的 MCP 流程。

search 回傳一份帶 ID 的精簡索引,每筆大約 50 到 100 個 token。timeline 給你某個命中項目附近的時間軸脈絡。get_observations 抓完整細節,每筆 500 到 1,000 個 token,但只限你真正選中的那些 ID。README 說先過濾再抓取大約省下 10 倍 token,這個說法的形狀是對的:它是一筆帳,不是一個能力宣言。

這就是記憶系統和 context window 的差別。更大的 window 是每一輪都要付的固定成本。漸進式揭露是你真的去找的時候才付的成本。看過長 session 把 token 燒在一堆過期工具輸出上的人,都認得出哪一種才 scale。

安裝一行,而這就是重點

正常情況下只要一行:

npx claude-mem install

它支援 --ide opencode、--ide t3code、--ide pi、--ide antigravity 還有幾個其他的,另外有一個 Grok Bot 模式會去讀聊天紀錄,因為那個 host 沒有 hook。在 Claude Code 裡面也可以走外掛市集:

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

需要 Node 20 以上。Bun 和 uv 沒裝的話會自動被拉進來。在 Windows 上,安裝器會在 %LOCALAPPDATA%\claude-mem\bin 放一個啟動器並加進使用者 PATH;如果 hook 抱怨找不到執行檔,npx claude-mem doctor 是排查的入口。

README 裡有個值得重複一次的陷阱:npm install -g claude-mem 只裝 SDK。它不會註冊 hook、也不會設定 worker,所以什麼都不會發生,而你會以為這工具壞了。

讓我覺得不太安心的部分

安裝過程中會要求你用 email magic link 登入,不用綁卡。登入會配發一把 memory key,並解鎖一個有 30 天試用的託管 observer;試用結束後,除非你訂閱,記憶會退回你的 Anthropic 方案。你可以用 --provider、設 CLAUDE_MEM_ONLINE_OPTIN=false,或在 CI 裡跑,整段跳過。到這裡都還好。

然後,在 README 靠底部的地方,有一節叫「What About CMEM?」,說明 CMEM 是第三方發行的 token,被專案作者「正式擁抱」,還附上合約地址。

我不覺得這讓軟體變差。程式碼是 Apache-2.0,架構有文件,授權選擇也明確地被辯護成「把持久記憶嵌進開發者工具」的一場賭注。但一個記憶系統,附贈一枚 memecoin,還要你先登入它才開始記得事情,這是在索取一種特定的信任;在你把它指向私有 repo 之前,該自己決定要不要給。純本機的路徑是存在的。請刻意選它,而不是不小心走到。

記憶真的讓 agent 變強嗎?

誠實的答案是:它讓 agent 比較不重複。這兩件事不一樣。一則被記下來的 observation 是關於過去的主張,而 codebase 很可能已經動過了。如果注入的 context 說「migration 在 db/legacy.ts」,而有人三週前把那個檔案拆了,你給 agent 的不是知識,是對一個過期事實的信心。

claude-mem 自己的說法在這裡幫得上忙:observations 以 ID 引用,你可以在 worker URL 的本機檢視器裡檢查。把它們當筆記,不要當事實。能從這東西得到價值的專案,會是那些會修剪、而不只是堆積的專案。

還有個二階效應,這個我會盯。記憶會改變 agent 願意不問就做什麼。有歷史的 agent 會很樂意照著上週繼承來的假設往下走。那是生產力提升,直到它變成一場很貴的誤會為止。

誰該花這個力氣

如果你的 agent session 又短又自成一格,跳過。額外的開銷不划算,而乾淨的 context 本身就是個功能。

如果你在同一個 repo 上跑好幾天的工作、如果你一直在重講同樣的架構決策、或者你有平行 agent 需要知道其他 agent 得出什麼結論,這目前是這個想法最完整的開放實作,而一行安裝讓實驗成本只有十分鐘。

只要帶著正確的期待進場。claude-mem 沒有給你的 agent 記憶。它給你的 agent 一個檔案櫃、一個搜尋工具,還有把事情寫下來的習慣。那些筆記現在還是不是真的,一如往常,是你的事。

相關文章