claude-mem：让 Claude Code 拥有持久记忆的插件

claude-mem：让 Claude Code 拥有持久记忆的插件

Claude Code 用户最近盯上了一个叫 claude-mem 的项目，GitHub 上攒了 8.1 万 Star。它解决了一个很具体的问题：让 Claude Code 在会话结束后还能记住之前聊过什么。

用过 Claude Code 的人都知道，每次新开对话，之前的上下文就清空了。同一个项目反复沟通，每次都要重新交代背景，效率很低。claude-mem 就是专门解决这个问题的。

核心功能：自动记忆，开箱即用

安装方式很简单，一条命令就能搞定：

npx claude-mem install

装完重启 Claude Code，它会自动在后台运行。每次你和 Claude 交互时，工具会捕获对话中的观察结果，生成语义摘要，并存入本地数据库。下次打开新会话，这些记忆会自动注入上下文。

除了 Claude Code，它还支持 Gemini CLI 和 OpenCode，安装时加个 --ide 参数就行。也能通过插件市场直接装。

技术架构分了几层

claude-mem 不是简单地把聊天记录存下来。它的设计更接近一个完整的记忆系统。

生命周期钩子：在 SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd 等关键节点插入逻辑，自动捕获观察和注入上下文。还有预安装脚本来检查依赖缓存。

Worker Service：本地起一个 HTTP 服务，端口 37777，提供 Web UI 和 10 个搜索接口，进程由 Bun 管理。

数据层：SQLite 存会话、观察和摘要。Chroma 向量数据库做混合语义检索和关键词搜索。

搜索技能：通过 MCP 工具暴露给 Claude，支持自然语言查询。搜索采用三层工作流：先用 search 拿紧凑索引，再用 timeline 看时间线上下文，最后用 get_observations 取完整详情。按这个顺序过滤后再取详情，能省大约 10 倍的 token。

几个实用的细节

渐进式披露：记忆不是一次性全部塞进上下文，而是分层加载，同时显示 token 消耗，用量透明。

隐私控制：敏感内容可以用 private 标签标记，这部分不会被存入数据库。

多语言支持：支持中文、日文等多种语言模式，改配置文件就能切换。

Web 查看器：浏览器打开 localhost:37777 能看到实时记忆流，还能直接管理和搜索。

引用功能：每条观察都有独立 ID，可以通过 API 或 Web UI 查看具体某一条。

Beta 频道：可以切换实验版本，体验 Endless Mode 这类新功能。

实际用起来怎么样

从架构上看，这个项目考虑得比较周全。自动运行、分层搜索、隐私控制、引用系统，这些功能都踩在了实际痛点上。

不过也有门槛。需要 Node.js 20+，还要装 Bun 和 uv，环境依赖不算少。Windows 用户如果 npm 没配好 PATH，可能会遇到安装问题。

另外，记忆质量取决于摘要算法。项目复杂度很高时，自动生成的摘要是否能准确还原上下文，还需要长期使用来验证。观察数据的存储和检索效率，随着数据量增长是否还能保持，也是个需要关注的问题。

适合谁用

如果你经常用 Claude Code 处理同一个代码库，这个插件能省掉大量重复沟通的成本。做长期项目、需要维护复杂上下文的场景，它的价值比较明显。

对偶尔用一次的用户来说，安装和配置的功夫可能不值当。Claude Code 是你日常主力工具的话，claude-mem 值得试试。

一次的用户来说，安装和配置的功夫可能不值当。Claude Code 是你日常主力工具的话，claude-mem 值得试试。