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 模型。有人想過「記憶工具悄悄變成監控工具」這個失敗模式。

三層式檢索的把戲
我覺得設計得真正好的地方是搜尋介面。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 一個檔案櫃、一個搜尋工具,還有把事情寫下來的習慣。那些筆記現在還是不是真的,一如往常,是你的事。
相關文章
一份社群維護的點擊表,關掉了中國品牌 Android 系統裡的廣告
它不動系統,不解鎖,不刷機,只把廠商本來就留出來的開關一個個撥過去。代價是這份名單得一直有人續寫。
GPT Image 2.6 守住 token 價格,帳單卻變貴了
GPT Image 2.6 沿用 2.5 的全部 token 費率,每張圖卻更貴,因為更多工作現在花在輸出 token 上。上線十一天,定價結構說得比排行榜更多。
有人從外部重寫了 IDM,並寫下自己沒碰過的部分
Mister Download Manager 用 Rust 重寫了 Internet Download Manager 的下載流程,聲稱速度快 5 倍、支援 86 種語言。更值得細讀的,是它解釋如何在不複製任何程式碼的前提下完成重寫的那一段。
Rune 是一個 Rust UI 框架,設計初衷是讓 agent 能檢查自己的工作
Rune 能無頭繪製、匯出元素樹並接受腳本化輸入,這讓編碼 agent 拿到截圖永遠給不了的東西,一個可 diff 的訊號。這個框架仍是預先發布版,不接受 pull request。