lucasrosati/claude-code-memory-setup

它解決的問題

此專案提供一個全面的設定，讓 Claude Code 擁有持久的長期記憶與程式碼庫意識。它解決了兩個主要問題：「記憶缺失」（在不同會話之間，使用者必須重新解釋專案）以及因 Claude 每次新會話都必須重新讀取整個程式碼庫以理解結構，導致高額的 token 消耗。

如何運作

系統採用多層次方法來管理上下文：

• 持久記憶： 一個 Obsidian Zettelkasten 倉庫作為「第二個大腦」，儲存決策、架構與會話記錄。Claude Code 透過 CLAUDE.md 檔案與自訂指令（如 /resume 和 /save）與此倉庫互動。
• 程式碼庫地圖： 整合 Graphify，將程式碼轉換為可查詢的知識圖譜。Claude 不再讀取原始檔案，而是查詢基於 AST 的結構地圖，大幅降低 token 使用量。
• 聊天管道： 一個基於 Python 的匯入管道，將 Claude 的對話（來自 CLI 和 Web 應用程式）匯出為索引筆記，存入 Obsidian 倉庫。
• 自動儲存安全網： 一個註冊為 Claude Code 中 SessionEnd 鈎子的 Python 指令碼，會自動提取會話重點，並在使用者忘記手動儲存時，將最小化的記錄寫入倉庫。

適用對象

使用 Claude Code 的開發者，希望降低 API 成本（token）並在多個會話之間維持一個連續且可搜尋的專案決策與程式碼結構知識庫。

特色

• token 效率： 聲稱透過以圖譜查詢取代完整檔案讀取，每會話可減少最多 71.5 倍的 token 使用量。
• Zettelkasten 整合： 使用 Obsidian 中原子化且相互連結的筆記，實現宣告式記憶。
• 本地處理： 程式碼庫圖譜透過 tree-sitter AST 在本地處理，預設模式下確保程式碼內容不會離開機器。
• 自動同步： 包含排程的 cron 指令碼，可將聊天記錄自動同步至知識倉庫。

這是一個真正能讓 Claude Code 擁有長期記憶的系統，透過知識圖譜取代重複讀取程式碼，大幅降低 token 消耗。— @handle