claude-mem 持久记忆

能做什么

• 通过生命周期钩子（如 SessionStart、PostToolUse、SessionEnd）自动捕获智能体会话中的工具使用观察。
• 将这些观察压缩并生成语义摘要，存入本地 SQLite 数据库，使上下文在会话结束或重连后仍可延续。
• 提供基于技能的检索与 MCP 搜索工具，支持用自然语言查询项目历史；采用渐进式披露分层返回结果，先给索引，再取时间线，最后按需获取完整观察详情。
• 提供本地 Web 查看器与 worker HTTP API，可浏览记忆、会话与设置。
• 支持用 <private> 标签排除敏感内容，并提供上下文注入的配置项。

适用场景

• 在 Claude Code 等智能体环境中进行长期或多轮开发，需要跨会话保留项目知识与历史决策。
• 需要按类型、日期或项目检索过往缺陷修复、决策等记录。
• 希望为本地智能体或 MCP 服务嵌入可持久化的记忆能力。

使用条件与限制

• 需要 Node.js 20.0.0 或更高版本；安装与运行依赖 Bun、uv 与 SQLite（部分依赖缺失时自动安装）。
• 建议通过 npx claude-mem install 或插件市场安装；直接 npm install -g claude-mem 仅安装 SDK/库，不注册钩子或 worker 服务。
• 安装流程可能引导登录并选择记忆提供方；可显式指定 --provider 或在非交互环境跳过账号交互。
• 不同 IDE/运行环境（如 Grok Bot、OpenCode、T3 Code 等）的集成方式与行为存在差异，需按对应说明配置。
• 采用 Apache-2.0 许可证；文档说明了开放与商业边界，具体以项目许可文件为准。