Claude Code 持久化内存解决方案：claude-mem 工具

Claude Code 持久化内存解决方案：claude-mem 工具 | 前端进阶之旅

Full translation

完整中文译文

仅 48 小时就获得了 4.6 万个 GitHub Star。

问题：Claude Code 会忘记一切

每次启动新的 Claude Code 会话时，一切都会被清空。你的编码风格偏好、项目架构决策、昨天的调试过程——全都不复存在。

你不得不反复说明：“我们用的是 Supabase，不是 Firebase。Edge Functions 位于 supabase/functions/。不要使用虚假数据。”

claude-mem 通过为不同会话提供持久化记忆，解决了这个问题。它发布后仅 48 小时，GitHub Star 数就达到了 4.6 万。我安装了它，也先自己做了一个轻量级替代方案。下面是我的发现。

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

这是一个赋予 Claude Code 长期记忆能力的插件。它会自动记录你在会话中的操作，并在之后的对话中注入相关上下文。

5 个生命周期 Hook：SessionStart / UserPromptSubmit / PostToolUse / Stop / SessionEnd

SQLite + Chroma：混合搜索（关键词 + 向量相似度）

Bun HTTP Worker：运行在 localhost:37777 上的后台服务

MCP Tools：三层渐进式披露（search → timeline → get_observations）

Web UI：可视化记忆浏览器

npx claude-mem install
npx claude-mem start  # Requires Bun

我最先构建的 DIY 替代方案

在发现 claude-mem 之前，我只用两个 PowerShell 脚本和 Claude Code 原生的 Hooks API，构建了一个极简记忆系统。

PostToolUse Hook（auto-capture.ps1）

每次使用 Bash 或 Write 工具后触发。它会捕获 git commit 和新建文件，并将其写入当天的 markdown 文件：

memory/auto-capture/2026-04-13.md
- 09:15 [abc1234] feat: Add user authentication
- 09:32 [Write] auth_middleware.dart
- 10:01 [def5678] fix: Token refresh logic

SessionStart Hook（session-resume.ps1）

读取最近 3 天捕获的内容，并在新会话启动时将其作为上下文注入。这样，AI 能立刻知道你最近一直在做什么。

在 settings.json 中注册

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Bash|Write",
      "hooks": [{
        "type": "command",
        "command": "powershell -File auto-capture.ps1"
      }]
    }],
    "SessionStart": [{
      "hooks": [{
        "type": "command",
        "command": "powershell -File session-resume.ps1"
      }]
    }]
  }
}

正面对比

同时运行两套方案

好消息是：两者可以完美共存。claude-mem 以插件形式注册，DIY Hooks 则直接注册在 settings.json 中。两者会响应相同的事件，彼此之间不会产生冲突。

claude-mem 的优势场景

智能压缩：使用 LLM（Gemini/Claude）将工具输出总结成紧凑的观察记录

语义搜索：“上周我对认证系统做了什么？”这类查询真的可以正常工作

Web 仪表盘：以可视化方式概览已经捕获的内容

零依赖：不需要服务器、数据库或运行时

团队共享：Markdown 文件可以提交到 git，并在不同实例之间共享

完全可控：由你精确决定要捕获哪些内容，以及如何捕获

真正免费：完全不需要进行任何 API 调用

成本优化技巧

claude-mem 默认使用 Claude API 进行压缩，这会消耗你的 token。将其切换到免费的 Gemini，即可消除这部分成本：

// ~/.claude-mem/settings.json
{
  "CLAUDE_MEM_PROVIDER": "gemini",
  "CLAUDE_MEM_GEMINI_API_KEY": "your-free-key-from-aistudio.google.com"
}

我们的三层记忆架构

在我们的项目中（Flutter Web + Supabase，并行运行 3 个 Claude Code 实例），我们采用了分层方案：

claude-mem 确实兑现了承诺：让 Claude Code 从一个“一次性工具”转变为一位“不断成长的伙伴”。向量搜索和 Web UI 都是真正实用的功能，很难通过简单脚本复刻。

不过，对于希望实现零依赖、零 token 成本，并且能通过 git 方便地共享记忆的团队来说，DIY Hook 方案是一个可靠的起点。

我的建议是：先从 DIY Hooks 入手，获得最基本的记忆能力；等到需要语义搜索和自动压缩时，再叠加 claude-mem。

使用 Claude Code 构建｜项目：https://my-web-app-b67f4.web.app/

部分评论可能只有登录后的访客才能看到。请登录以查看全部评论。

如果需要采取进一步措施，你可以考虑屏蔽此人和/或举报滥用行为。