Claude-Mem

Claude-Mem 是开发者 Alex Newman 打造的一款 Claude Code 智能记忆插件。通过 SessionStart、PostToolUse 等五个生命周期钩子自动捕获会话中的工具调用、代码决策与调试过程,利用 Claude Agent SDK 将原始输出压缩为结构化观察记录(约 500 令牌),存储在本地 SQLite + Chroma 向量数据库中,让 Claude Code 拥有跨会话的长期记忆能力。

一、工具介绍

Claude-Mem 由开发者 Alex Newman 在 GitHub 开源,定位是”Claude Code 的长期记忆层”。当前 Claude Code 每次新会话都”失忆”,之前的对话、代码决策、调试经验都丢失,需要用户重复说明背景。Claude-Mem 通过生命周期钩子自动捕获和压缩会话信息,让 AI 编程助手能够记住之前的项目状态、代码风格偏好、问题解决方案。

插件基于 Claude Agent SDK,把每次会话的工具调用、决策点、调试过程压缩为结构化观察记录,存储在本地 SQLite(关系型数据)+ Chroma(向量数据库)。下次新会话时,Claude-Mem 检索相关历史记忆,自动注入到上下文中,实现跨会话记忆。

二、核心功能

• 生命周期钩子:通过 SessionStart、PostToolUse 等 5 个钩子自动捕获会话事件。
• 结构化压缩:利用 Claude Agent SDK 把原始输出压缩为约 500 令牌的结构化记录,节省存储。
• 本地存储:SQLite + Chroma 向量数据库本地存储,数据不出本机,隐私安全。
• 跨会话记忆:新会话自动检索相关历史记忆,注入上下文,实现长期记忆。
• 项目隔离:每个项目独立记忆空间,避免不同项目记忆串扰。
• 隐私保护:所有数据本地存储,不上传云端,符合隐私合规。
• 开源透明:MIT 协议开源,代码可审查、可定制。
• 轻量集成:作为 Claude Code 插件安装,几行配置即可启用。

三、使用场景

• 长期项目开发:开发大型项目时,AI 记住之前的代码决策、架构讨论,避免重复解释。
• 代码风格一致:AI 记住用户的代码风格偏好(命名、注释、格式),保持一致性。
• Bug 调试延续:调试复杂 Bug 时,AI 记住之前的尝试和结论,加速问题定位。
• 学习曲线:新手用 Claude Code 时,AI 记住用户的学习进度,提供个性化的指导。
• 团队协作:团队成员共享记忆库(可选),新成员快速了解项目历史。
• 多项目管理:同时维护多个项目时,AI 准确识别当前项目,加载对应记忆。
• 代码审查:AI 记住团队的代码审查标准,提供一致性的反馈。
• 个性化体验:AI 记住用户的角色、经验水平,定制化沟通方式。

四、价格方案

Claude-Mem 完全开源免费(GitHub 开源,MIT 协议)。用户只需支付:

• Claude API 调用费(Claude Code 使用)
• 本地存储无费用
• 第三方库(Chroma)免费

五、功能特点

• 跨会话记忆:解决 Claude Code 最大痛点,会话间不丢失上下文。
• 本地存储:SQLite + Chroma 本地存储,数据安全可控。
• 结构化压缩:500 令牌压缩记录,平衡存储成本和记忆质量。
• 项目隔离:每个项目独立记忆空间,避免串扰。
• 轻量集成:Claude Code 插件方式安装,几行配置即可启用。
• 活跃维护:GitHub Star 数千,作者持续更新,功能不断完善。

六、上手指南

1. 通过 npm 安装 Claude-Mem:`npm install -g claude-mem`。
2. 在 Claude Code 配置中加载插件,设置 SQLite 和 Chroma 数据库路径。
3. 启动 Claude Code,插件自动捕获会话事件并压缩存储。
4. 下次启动新会话时,自动加载相关历史记忆,可在对话中查看。

七、常见问题