Claude每次新会话就失忆claude-mem 让AI编程助手拥有持久化记忆解决AI编程助手金鱼记忆痛点实现跨会话上下文无缝衔接但也需要分场景使用。一、痛点为什么需要持久化内存在使用 Claude Code 进行项目开发时你是否遇到过这些困扰会话重启后失忆每次新开对话Claude 都像是第一次见你的项目需要重新解释业务逻辑上下文窗口限制长会话中早期的关键决策和代码逻辑被挤出上下文跨天开发断片昨天讨论过的架构设计今天需要从头再讲一遍项目知识无法沉淀团队的最佳实践、踩过的坑无法被AI记住并复用claude-mem正是为解决这些问题而生。它是一个专为 Claude Code 构建的持久化内存压缩系统让 Claude 能够像人类开发者一样记住项目的历史实现真正的跨会话知识连续性。二、claude-mem 是什么claude-mem 是一个开源的持久化内存插件通过自动捕获工具使用观察、生成语义摘要并将其存储供未来会话检索从而实现跨会话的上下文保留。核心定位特性说明目标平台Claude Code / OpenCode / Antigravity CLI核心能力自动记忆、智能检索、渐进式披露存储方式SQLite 本地持久化 Chroma 向量数据库搜索方式MCP 工具 自然语言查询开源协议Apache License 2.0三、核心功能详解1. 持久化内存会话结束记忆不结束claude-mem 通过5 个生命周期钩子SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd自动捕获会话中的关键信息你执行过的命令和工具调用代码修改和文件操作错误和调试过程架构决策和讨论要点这些信息会被压缩成语义摘要存储在本地 SQLite 数据库中下次会话启动时自动注入到 Claude 的上下文中。2. 渐进式披露省 token 的智能检索claude-mem 采用三层工作流模式避免一次性将所有历史记录塞进上下文第一层search → 获取紧凑索引约 50-100 token/结果 第二层timeline → 获取时间顺序上下文 第三层get_observations → 仅获取筛选后的完整详情约 500-1000 token/结果优势通过在获取详情前进行筛选可节省约10 倍 token消耗同时保证上下文的相关性。3. 基于技能的搜索自然语言查历史claude-mem 提供了4 个 MCP 搜索工具工具功能search使用全文查询搜索内存索引支持按类型/日期/项目筛选timeline获取特定观察周围的时间顺序上下文get_observations按 ID 批量获取完整观察详情使用示例// 步骤1搜索相关索引 search(queryauthentication bug, typebugfix, limit10) // 步骤2查看时间线识别相关ID // 步骤3获取完整详情 get_observations(ids[123, 456])4. 隐私控制敏感内容不上传使用private标签包裹敏感信息claude-mem 会自动排除这部分内容的存储确保密码、密钥等隐私数据不会进入内存数据库。5. Web 查看器界面启动 worker 服务后会在终端打印一个本地 URL你可以通过浏览器实时查看内存流直观地了解 Claude “记住了什么”。四、快速上手一条命令搞定安装前置要求Node.js20.0.0 或更高版本Claude Code支持插件的最新版本BunJavaScript 运行时如缺失会自动安装uvPython 包管理器用于向量搜索如缺失会自动安装安装方式方式一命令行安装推荐# 为 Claude Code 安装npx claude-meminstall# 为 OpenCode 安装npx claude-meminstall--ideopencode# 为 Antigravity CLI 安装npx claude-meminstall--ideantigravity方式二通过插件市场安装/plugin marketplaceaddthedotmack/claude-mem /plugininstallclaude-mem方式三OpenClaw Gateway 一键安装curl-fsSLhttps://install.cmem.ai/openclaw.sh|bash重启即生效安装完成后重启 Claude Code。来自先前会话的上下文将自动出现在新会话中无需任何手动操作。⚠️注意npm install -g claude-mem仅安装 SDK/库本身不会注册插件钩子或设置 worker 服务。请始终通过npx claude-mem install或/plugin命令进行安装。五、配置按需定制你的工作流配置文件位于~/.claude-mem/settings.json首次运行时自动生成默认设置。语言与模式配置claude-mem 支持多种工作流模式和语言{CLAUDE_MEM_MODE:code--zh}模式描述code默认英文模式code--zh简体中文模式code--ja日文模式支持code--[lang]格式其中[lang]为 ISO 639-1 语言代码。修改后重启 Claude Code 即可生效。可配置项AI 模型选择Worker 服务端口数据目录位置日志级别上下文注入策略详细配置请参考官方配置指南。六、工作原理架构浅析claude-mem 的架构设计简洁而高效┌─────────────────┐ ┌──────────────┐ ┌─────────────────┐ │ Claude Code │────→│ 生命周期钩子 │────→│ Worker 服务 │ │ (插件运行时) │ │(6个钩子脚本) │ │ (本地 HTTP API)│ └─────────────────┘ └──────────────┘ └────────┬────────┘ │ ┌─────────────────────┼─────────────────────┐ ↓ ↓ ↓ ┌────────────┐ ┌──────────────┐ ┌──────────────┐ │ SQLite │ │ Chroma │ │ Web 查看器 │ │ (持久存储) │ │ (向量数据库) │ │ (内存流界面) │ └────────────┘ └──────────────┘ └──────────────┘核心组件生命周期钩子51个嵌入 Claude Code 的执行流程自动捕获事件智能安装器缓存依赖检查自动安装缺失的 Bun、uv 等工具Worker 服务本地 HTTP API 服务提供搜索端点和 Web 查看器SQLite 数据库结构化存储会话、观察记录、语义摘要Chroma 向量数据库支持混合语义 关键词的智能检索mem-search 技能自然语言查询接口渐进式披露结果七、实际应用场景场景1长期项目开发你在开发一个微服务架构项目已经进行了 20 多次会话。每次新会话Claude 都能记住各服务的职责划分数据库表结构设计API 接口约定已解决的坑和解决方案场景2Bug 追踪与修复三天前你修复了一个棘手的并发 Bug今天类似问题再次出现。通过自然语言搜索authentication bugClaude 能快速定位到之前的修复记录避免重复踩坑。场景3团队协作知识沉淀团队成员 A 解决了一个配置问题claude-mem 记录了全过程。团队成员 B 遇到相同问题时Claude 能直接引用 A 的解决方案实现团队知识的自动传承。场景4代码审查辅助Claude 记得你上周说过这个项目要用策略模式重构支付模块当你今天提交新代码时它能主动提醒是否符合既定的架构方向。八、故障排除常见问题问题解决方案npm : The term npm is not recognized确保 Node.js 已安装并添加到 PATH重启终端安装后上下文未保留检查是否正确重启 Claude Code确认钩子已注册搜索无结果确认 worker 服务已启动检查settings.json配置Windows 特定错误确保 PowerShell 版本 7.x自动诊断遇到问题直接向 Claude 描述内置的troubleshoot技能会自动诊断并提供修复方案。也可以手动生成 bug 报告cd~/.claude/plugins/marketplaces/thedotmacknpmrun bug-report九、与其他方案的对比方案持久化自动捕获语义搜索渐进式披露隐私控制Claude Code 原生❌❌❌❌❌手动保存提示词⚠️❌❌❌❌claude-mem✅✅✅✅✅十、总结claude-mem 填补了 Claude Code 在持久化上下文方面的空白让 AI 编程助手从会话级记忆跃升到项目级记忆。它的核心价值在于零手动干预全自动捕获和注入不改变原有工作流智能省 token渐进式披露避免上下文爆炸本地优先数据存储在本地隐私可控开源可扩展Apache 2.0 协议可自由定制如果你长期使用 Claude Code 进行项目开发claude-mem 几乎是必装插件。它让 Claude 真正成为你项目的长期合伙人而不是每次都要重新认识的临时工。参考链接GitHub 仓库github.com/thedotmack/claude-mem官方文档docs.claude-mem.aiDiscord 社区加入 Discord官方 X 账号Claude_Memory如果这篇文章对你有帮助欢迎点赞、收藏、转发有任何使用问题也可以在评论区交流讨论。
)
