[Open Source] Claude-Mem 加持！
告別金魚腦，
開發效率倒數計時！

Claude-Mem：讓你的 Claude Code 擁有超強記憶力！台灣開發者入門指南

你是否在使用 Claude Code 開發時，常常覺得 Claude 忘記了之前的討論內容，每次都要重新解釋？這就像跟一個金魚腦的同事合作，實在讓人崩潰！現在，有了 Claude-Mem，你的 Claude Code 也能擁有像人類一樣的持久記憶，讓你事半功倍！

這篇文章將會深入淺出地介紹 Claude-Mem，讓即使是 AI 開發新手也能輕鬆上手。 我們會一步步講解 Claude-Mem 的核心概念、安裝方式、使用技巧，以及如何利用它來提升你的開發效率。

什麼是 Claude-Mem？為什麼你需要它？

簡單來說，Claude-Mem 是一個為 Claude Code 設計的「持久記憶壓縮系統」。它能自動記錄 Claude Code 的工具使用情況，生成語義摘要，並將這些資訊提供給未來的會話。

想像一下，有了 Claude-Mem，你可以：

• 無縫接續工作： 即使關閉 Claude Code，下次開啟時也能自動載入之前的上下文，不用再從頭開始。
• 輕鬆回顧過往： 透過自然語言搜尋，快速找到之前解決過的 Bug、做過的決策、修改過的文件。
• 更聰明的 AI 助手： Claude Code 能夠基於歷史資訊做出更明智的判斷，提供更精準的建議。

總之，Claude-Mem 就像是為你的 Claude Code 裝上了一個外接大腦，讓它不再是金魚腦，而是變成一個真正能夠理解你的需求、協助你解決問題的 AI 夥伴。

Claude-Mem 的核心概念：像人類大腦一樣運作

Claude-Mem 的設計靈感來自於人類大腦的記憶機制，它將記憶分為三個層次：

1. 工作記憶 (Working Memory)： 即時的上下文，用於當前會話。Claude-Mem 會將最近的觀察結果壓縮成精簡的摘要，放入工作記憶中。
2. 檔案記憶 (Archive Memory)： 完整的歷史記錄，儲存在硬碟中，用於回顧細節。Claude-Mem 會完整保存所有的工具輸出，方便你隨時查閱。
3. 索引 (Index)： 快速檢索的目錄，用於尋找相關資訊。Claude-Mem 會為每個觀察結果建立索引，方便你透過關鍵字或語義搜尋快速找到需要的資訊。

這種分層式的記憶結構，讓 Claude-Mem 能夠在保證記憶完整性的同時，最大限度地減少 Token 消耗，避免超出 Claude Code 的上下文限制。

如何開始使用 Claude-Mem？新手也能輕鬆上手！

以下是在 Claude Code 中安裝和使用 Claude-Mem 的簡單步驟：

1. 在 Claude Code 終端機中輸入以下指令：

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

   這個指令會將 Claude-Mem 從外掛商店添加到你的 Claude Code 中，並進行安裝。
   (請注意，這裡的網址是從參考資料取得的，使用時請確認 /plugin marketplace 這個指令是否還能使用，如果不行，可能需要查閱 Claude Code 的官方文件，尋找最新的外掛安裝方式。)

2. 重新啟動 Claude Code。

   完成安裝後，重新啟動 Claude Code，Claude-Mem 就會自動開始運作。

恭喜你！你已經成功安裝了 Claude-Mem！

現在，你可以像往常一樣使用 Claude Code 進行開發。Claude-Mem 會在後台默默地記錄你的工作，並在下次開啟時自動載入相關的上下文。

Claude-Mem 的主要功能：提升你的開發效率

Claude-Mem 提供了許多強大的功能，可以幫助你提升開發效率：

• 持久記憶 (Persistent Memory)： 跨會話保存上下文，讓你無縫接續工作。
• 漸進式揭露 (Progressive Disclosure)： 分層式的記憶檢索，讓你先了解概要，再深入細節。
• 技能型搜尋 (Skill-Based Search)： 透過自然語言查詢你的專案歷史，快速找到需要的資訊。
• 網頁檢視器 (Web Viewer UI)： 透過網頁介面 (http://localhost:37777) 檢視即時的記憶流。
• 隱私控制 (Privacy Control)： 使用 <private> 標籤排除敏感內容，保護你的隱私。
• 自動運作 (Automatic Operation)： 無需手動干預，Claude-Mem 會自動記錄和管理記憶。
• 引用 (Citations)： 透過 ID 引用過去的觀察結果，方便追溯資訊來源。

如何使用 mem-search 技能？像 Google 一樣搜尋你的專案歷史

Claude-Mem 最強大的功能之一就是 mem-search 技能。它可以讓你像使用 Google 一樣，透過自然語言搜尋你的專案歷史。

使用方式非常簡單：

1. 直接向 Claude Code 提問： 例如，「上次我們修復了哪些 Bug？」、「我們是如何實作身份驗證的？」、「worker-service.ts 有哪些變更？」
2. Claude Code 會自動調用 mem-search 技能， 找到相關的上下文。

mem-search 技能支援多種搜尋方式：

• 搜尋觀察結果 (Search Observations)： 在所有的觀察結果中進行全文搜尋。
• 搜尋會話 (Search Sessions)： 在所有的會話摘要中進行全文搜尋。
• 搜尋提示詞 (Search Prompts)： 搜尋原始的使用者請求。
• 依概念 (By Concept)： 依概念標籤 (例如，探索、問題解決、模式) 尋找。
• 依檔案 (By File)： 尋找引用特定檔案的觀察結果。
• 依類型 (By Type)： 依類型 (例如，決策、Bug 修復、功能、重構、探索、變更) 尋找。
• 最近的上下文 (Recent Context)： 取得專案最近的會話上下文。
• 時間軸 (Timeline)： 取得特定時間點附近的上下文的統一時間軸。
• 依查詢的時間軸 (Timeline by Query)： 搜尋觀察結果，並取得最佳匹配項附近的時間軸上下文。

舉個例子：

如果你想知道上次修改 user.py 這個檔案做了什麼，你可以直接問 Claude Code：

"What changes were made to user.py?"

Claude-Mem 就會自動搜尋所有與 user.py 相關的觀察結果，並將結果呈現給你。

Claude-Mem 的架構：深入了解背後原理

如果你對 Claude-Mem 的運作原理感到好奇，可以參考以下架構概述：

1. 生命週期鉤子 (Lifecycle Hooks)： Claude-Mem 使用 5 個生命週期鉤子 (SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd) 來監控 Claude Code 的運行狀態，並在適當的時機執行相應的操作。
2. 工作者服務 (Worker Service)： Claude-Mem 運行一個 HTTP API (port 37777)，提供網頁檢視器 UI 和搜尋端點。
3. SQLite 資料庫： Claude-Mem 使用 SQLite 資料庫儲存會話、觀察結果和摘要。
4. mem-search 技能： Claude-Mem 透過 mem-search 技能提供自然語言查詢功能。
5. Chroma 向量資料庫： Claude-Mem 使用 Chroma 向量資料庫進行混合語義 + 關鍵字搜尋，提供更智慧的上下文檢索。

Claude-Mem 的設定：打造最適合你的開發環境

你可以透過修改 ~/.claude-mem/settings.json 檔案來調整 Claude-Mem 的設定。

以下是一些常用的設定：

• CLAUDE_MEM_MODEL：用於生成觀察結果的 AI 模型。
• CLAUDE_MEM_WORKER_PORT：工作者服務的連接埠。
• CLAUDE_MEM_DATA_DIR：資料目錄的位置。
• CLAUDE_MEM_CONTEXT_OBSERVATIONS：在 SessionStart 時注入的觀察結果數量。

你可以根據自己的需求調整這些設定，打造最適合你的開發環境。

Beta 功能：體驗 Endless Mode 的無限可能

Claude-Mem 還提供了一個 Beta 頻道，其中包含一些實驗性的功能。其中最受矚目的就是 Endless Mode (無限模式)。

Endless Mode 旨在突破 Claude Code 的上下文限制，讓你能夠進行更長時間的會話。

它透過將工具輸出壓縮成精簡的觀察結果，並即時轉換文字記錄，從而減少 Token 消耗，延長會話時間。

請注意：Endless Mode 仍然是一個實驗性的功能，可能存在 Bug 或不完整的功能。

如果你想體驗 Endless Mode，可以按照以下步驟切換到 Beta 頻道：

1. 開啟 http://localhost:37777。
2. 點擊設定 (齒輪圖示)。
3. 在 Version Channel 中，點擊 “Try Beta (Endless Mode)”。
4. 等待工作者重新啟動。

常見問題與疑難排解

在使用 Claude-Mem 的過程中，你可能會遇到一些問題。以下是一些常見問題與解決方案：

• 工作者無法啟動： 嘗試執行 npm run worker:restart。
• 沒有出現上下文： 嘗試執行 npm run test:context。
• 資料庫問題： 執行 sqlite3 ~/.claude-mem/claude-mem.db "PRAGMA integrity_check;" 檢查資料庫完整性。
• 搜尋無法運作： 檢查 FTS5 表是否存在。

你也可以參考 Claude-Mem 的官方文件，尋找更完整的疑難排解指南。

總結：Claude-Mem 是 Claude Code 開發者的最佳夥伴

Claude-Mem 是一個非常強大的工具，可以幫助你提升 Claude Code 開發效率。它透過持久記憶、自然語言搜尋和分層式的記憶結構，讓你的 Claude Code 擁有像人類一樣的智慧，成為你開發過程中不可或缺的夥伴。

無論你是 AI 開發新手還是經驗豐富的專家，都強烈建議你嘗試使用 Claude-Mem。相信它會給你帶來意想不到的驚喜！

現在就開始使用 Claude-Mem，讓你的 Claude Code 擁有超強記憶力吧！

參考閱讀

https://github.com/thedotmack/claude-mem