简介Claude-Mem 是由thedotmack开发的开源项目是一个专为Claude Code设计的持久内存压缩系统。在当今AI辅助开发日益普及的背景下开发者面临一个普遍挑战AI助手在会话结束后会丢失所有上下文导致每次新会话都需要重新解释项目背景和历史决策。Claude-Mem应运而生通过自动捕获工具使用观察、生成语义摘要并使其在未来的会话中可用实现了跨会话的上下文持久化。该项目使Claude能够维持对项目的知识连续性即使会话结束或重新连接后也能保持记忆。核心价值上下文持久化会话间的上下文得以保存避免重复解释自动记忆捕获无需手动干预系统自动记录重要观察智能摘要生成将冗长的工具使用记录压缩为语义摘要渐进式披露分层检索记忆优化令牌使用效率隐私控制通过标签排除敏感内容保护隐私数据项目定位在AI编码助手日益成为开发工作流核心组件的今天Claude-Mem填补了会话间记忆断层的空白。传统AI助手每次会话都是从零开始而Claude-Mem通过构建持久记忆层使AI能够记住过去的决策、错误修复和项目进展。项目特别注重易用性和自动化让开发者无需改变现有工作习惯即可获得记忆增强能力。技术基础Claude-Mem采用现代化的架构设计基于Node.js环境深度集成Claude Code的插件系统。核心采用SQLite数据库进行持久存储结合Chroma向量数据库实现混合语义和关键词搜索。系统通过Bun运行时管理工作者服务提供HTTP API和Web查看器界面。其智能记忆压缩算法能够将冗长的工具使用观察转化为紧凑的语义表示显著减少存储和检索成本。主要功能1. 跨会话持久记忆Claude-Mem的核心功能是使上下文在会话间持久化。系统自动捕获Claude Code中的工具使用观察包括命令执行、文件操作、代码编辑等关键活动。这些观察被智能压缩并存储当开始新会话时相关记忆会自动注入到上下文中。这意味着Claude能够记住之前的对话、已解决的问题、做出的设计决策无需用户重复解释项目背景。2. 渐进式记忆检索系统采用分层记忆检索机制显著优化令牌使用效率。当Claude需要查询记忆时首先获取紧凑的索引结果约50-100令牌/结果然后根据需要获取时间线上下文最后仅对筛选出的相关ID获取完整详细信息约500-1,000令牌/结果。这种渐进式披露模式相比一次性获取所有详细信息可节省约10倍的令牌消耗。3. 智能记忆搜索通过集成的mem-search技能用户可以使用自然语言查询项目历史。搜索支持全文查询、按类型/日期/项目筛选并利用Chroma向量数据库实现混合语义和关键词搜索。搜索结果按相关性排序并提供时间线视图帮助理解特定观察发生时的上下文环境。4. Claude桌面集成Claude-Mem提供专门的Claude桌面技能允许用户直接从Claude桌面对话中搜索记忆。这意味着即使不在Claude Code环境中用户也能访问项目历史记忆实现跨平台的知识连续性。5. 隐私保护机制系统提供细粒度的隐私控制用户可以使用private标签包装敏感内容这些内容将被排除在存储之外。配置设置还允许用户控制哪些类型的上下文被注入确保敏感信息不会意外泄露。6. 自动操作与零配置Claude-Mem设计为完全自动化运行无需手动干预。安装后系统自动开始捕获观察、生成摘要、管理数据库。智能安装脚本检查并自动安装缺失的依赖项如Bun、uv等确保系统即装即用。7. 实时观察馈送对于OpenClaw网关安装系统支持将实时观察馈送到Telegram、Discord、Slack等平台。这使得团队可以共享开发进展和关键决策增强协作透明度。8. Web查看器界面内置的Web查看器界面http://localhost:37777提供直观的记忆浏览和管理功能。用户可以查看会话历史、搜索记忆、调整设置并在稳定版和Beta版之间切换。9. MCP搜索工具集成Claude-Mem通过模型上下文协议MCP提供5个智能搜索工具search获取紧凑索引timeline获取时间线上下文get_observations获取完整详细信息save_memory手动保存重要信息。这些工具遵循三层工作流模式确保令牌高效使用。10. Beta功能通道项目提供Beta通道包含实验性功能如无尽模式Endless Mode。无尽模式采用仿生记忆架构支持超长会话通过版本切换功能用户可以在稳定版和Beta版之间灵活选择。11. 分布式上下文生成通过集成的Live Context系统支持分布式CLAUDE.md生成。这使得团队可以协作构建和维护项目上下文文档确保所有成员共享一致的项目知识。12. 自动故障诊断当遇到问题时用户只需向Claude描述问题集成的故障排除技能会自动诊断并提供修复建议。系统还包含自动化的Bug报告生成器简化问题反馈流程。安装与配置环境要求与兼容性在安装Claude-Mem之前需要确保系统满足以下要求核心依赖Node.js版本18.0.0或更高这是运行Claude-Mem的基础环境Claude Code最新版本且支持插件功能这是Claude-Mem的主要运行平台BunJavaScript运行时和进程管理器如果缺失会自动安装uvPython包管理器用于向量搜索功能如果缺失会自动安装SQLite 3用于持久存储已捆绑在系统中平台特定说明Windows用户如果遇到npm未被识别错误请确保Node.js和npm已正确安装并添加到PATH环境变量中。从https://nodejs.org下载最新Node.js安装程序安装后重启终端。macOS/Linux用户通常通过包管理器安装Node.js即可满足要求。OpenClaw网关支持在OpenClaw网关上作为持久内存插件安装。Claude Code插件安装推荐方式对于大多数用户作为Claude Code插件安装是最简单的方式步骤1添加市场仓库在Claude Code终端会话中输入以下命令/plugin marketplace add thedotmack/claude-mem步骤2安装插件/plugin install claude-mem步骤3重启Claude Code安装完成后重启Claude Code以使插件生效。重启后之前会话的上下文将自动出现在新会话中。重要注意事项Claude-Mem也在npm上发布但npm install -g claude-mem仅安装SDK/库不会注册插件钩子或设置工作者服务。要使用Claude-Mem作为插件必须始终通过上述/plugin命令安装。安装后系统会自动创建默认配置并启动工作者服务。OpenClaw网关安装对于使用OpenClaw网关的用户安装更加简单单命令安装curl -fsSL https://install.cmem.ai/openclaw.sh | bash此安装程序自动处理依赖项检查和安装插件设置和配置AI提供商配置工作者服务启动可选的实时观察馈送配置Telegram、Discord、Slack等OpenClaw集成优势作为网关级插件为所有连接的客户端提供记忆服务支持团队共享记忆库实时观察馈送到协作平台集中化配置和管理手动安装与高级配置对于需要更多控制的用户可以手动安装和配置配置位置设置文件位于~/.claude-mem/settings.json首次运行时自动创建并填充默认值。可配置参数AI模型选择用于摘要生成的AI模型工作者端口HTTP API服务端口默认37777数据目录记忆数据库存储位置日志级别控制日志详细程度error、warn、info、debug上下文注入设置控制哪些类型的上下文被自动注入隐私过滤器配置敏感内容检测和排除规则环境变量支持CLAUDEMEM_DATA_DIR覆盖默认数据目录CLAUDEMEM_PORT覆盖默认API端口CLAUDEMEM_LOG_LEVEL控制日志级别CLAUDEMEM_AI_PROVIDER指定AI提供商配置依赖管理Claude-Mem包含智能依赖管理自动依赖安装如果检测到Bun缺失自动下载并安装如果uv未找到自动安装Python包管理器SQLite3已捆绑无需额外安装依赖缓存安装程序包含缓存依赖检查器避免重复下载和安装支持离线安装如果依赖已缓存版本管理与更新版本切换通过Web查看器界面http://localhost:37777→ Settings用户可以在稳定版经过充分测试的生产就绪版本Beta版包含实验性功能如无尽模式更新机制通过/plugin update claude-mem更新插件版本工作者服务自动检测并应用更新数据库模式迁移自动处理故障排除与验证安装验证安装完成后通过以下方式验证访问Web查看器http://localhost:37777检查工作者服务状态在Claude Code中测试记忆检索常见问题解决端口冲突如果37777端口被占用通过设置文件更改端口权限问题确保对数据目录有读写权限内存不足调整摘要生成批处理大小如何使用快速开始与基本工作流安装并重启Claude Code后Claude-Mem立即开始工作无需额外配置。系统自动执行以下流程自动记忆捕获当您在Claude Code中工作时系统在后台自动捕获工具使用观察命令执行、文件操作等对话中的重要决策点代码变更和问题解决过程智能摘要生成原始观察被智能压缩为语义摘要存储到SQLite数据库中。摘要保留了关键信息同时显著减少存储空间。上下文自动注入当开始新会话时系统根据当前项目和工作目录自动将相关记忆注入到Claude的上下文中。Claude会记得之前的对话和决策。记忆搜索与查询当需要查找特定信息时使用集成的搜索功能自然语言搜索通过mem-search技能使用自然语言查询项目历史搜索上周修复的身份验证错误渐进式检索工作流对于复杂查询遵循三层工作流模式搜索索引获取紧凑的结果列表约50-100令牌/结果时间线查看了解特定观察发生时的上下文详细信息获取仅获取筛选后相关ID的完整详情搜索筛选选项按类型筛选bugfix、feature、discussion等按日期范围筛选按项目/目录筛选按相关性排序MCP工具使用模式Claude-Mem通过MCP提供5个核心搜索工具遵循标准化使用模式标准工作流示例// 第1步搜索索引 search(query身份验证错误, typebugfix, limit10) // 第2步查看索引识别相关ID如#123、#456 // 第3步获取完整详情 get_observations(ids[123, 456]) // 第4步手动保存重要信息 save_memory(textAPI需要X-API-Key认证头, titleAPI认证)工具详细说明search全文搜索记忆索引返回紧凑结果timeline获取特定观察或查询的时间线上下文get_observations按ID批量获取完整观察详情save_memory手动保存重要信息供后续搜索工作流文档始终对Claude可见确保正确使用模式Claude桌面集成使用即使不在Claude Code环境中也能访问记忆桌面技能激活在Claude桌面对话中使用记忆搜索技能搜索项目历史中关于数据库迁移的讨论跨平台记忆同步桌面搜索查询远程Claude-Mem服务结果以对话形式返回支持与Claude Code相同的搜索筛选隐私控制与敏感信息处理保护敏感信息是系统的重要功能隐私标签使用在对话中用private标签包装敏感内容private 数据库密码supersecret123 API密钥sk_live_abc123 /private标签内的内容将被排除在记忆存储之外。配置隐私过滤器在设置文件中可以配置自动检测的敏感模式如API密钥、密码模式特定文件/目录的排除规则自定义隐私标签Web查看器界面操作通过浏览器访问http://localhost:37777使用完整的管理功能主要功能区域仪表板显示系统状态、记忆统计、最近活动搜索界面图形化记忆搜索和浏览会话管理查看和管理所有会话历史设置面板配置系统参数、切换版本实时馈送查看实时观察流如果配置版本管理在设置面板中可以在稳定版和Beta版之间切换查看当前版本和更新日志配置自动更新设置Beta功能体验对于愿意尝试实验性功能的用户启用Beta通道在Web查看器设置面板中切换到Beta版本。无尽模式Endless Mode仿生记忆架构支持超长会话动态记忆压缩和检索优化适合长时间、复杂的开发任务实验功能注意事项Beta功能可能不稳定建议在非关键项目上测试定期备份记忆数据库团队协作与共享记忆在团队环境中Claude-Mem支持协作功能OpenClaw网关部署作为网关级插件为整个团队提供共享记忆服务。实时观察馈送配置观察馈送到团队协作平台Telegram频道/群组Discord服务器Slack工作区权限与访问控制基于项目的记忆隔离团队共享记忆库个人私有记忆保护故障诊断与维护当遇到问题时系统提供多种诊断工具自动故障排除向Claude描述问题故障排除技能自动诊断常见问题提供修复建议生成诊断报告手动诊断命令// 检查系统状态 检查Claude-Mem工作者服务状态 // 查看日志 查看最近100行系统日志 // 验证数据库完整性 运行数据库完整性检查Bug报告生成使用自动化生成器创建详细Bug报告cd ~/.claude/plugins/marketplaces/thedotmack npm run bug-report性能优化建议基于实际使用经验以下建议可提升使用效果记忆管理优化定期清理过时记忆通过Web查看器调整摘要生成频率平衡新鲜度和性能配置项目特定的记忆保留策略搜索效率提升使用具体、描述性的查询词结合类型/日期筛选缩小结果范围批量获取详细信息减少API调用系统资源管理根据硬件调整工作者线程数配置适当的数据库缓存大小监控内存使用避免资源耗尽应用场景实例实例1长期复杂项目的上下文连续性维护场景描述一个开发团队正在构建一个大型微服务架构的电商平台项目周期长达18个月。开发过程中团队成员经常需要查阅数月前的设计决策、技术选型理由和已解决的问题。传统方式下开发者需要翻阅会议记录、文档和代码提交历史效率低下且容易遗漏关键上下文。新加入的团队成员更难快速理解项目的历史决策和架构演进。解决方案团队部署Claude-Mem作为项目的记忆中枢。系统自动捕获所有开发会话中的关键活动架构设计讨论、技术选型决策、性能优化方案、错误修复过程等。当开发者开始新会话时系统根据当前工作目录自动注入相关历史记忆。例如当开发者处理支付服务时Claude会自动记得三个月前团队决定使用Stripe而非PayPal的原因、两个月前处理的支付超时问题、上周优化的数据库查询性能。当新成员加入支付团队时他们可以自然语言查询这个服务之前遇到过哪些支付失败问题系统返回按时间排序的修复历史包括根本原因、解决方案和预防措施。实施效果新功能开发时间缩短40%减少重复解释和背景调查新团队成员上手时间从3周缩短到3天技术债务显著减少历史决策可追溯性提高知识流失风险降低关键决策被持久记录代码审查效率提升审查者了解历史上下文实例2分布式团队的异步协作增强场景描述一个跨国科技公司在三个时区有开发团队核心产品需要24小时持续开发。由于时差问题团队间的交接和沟通存在延迟经常出现重复工作或上下文丢失。美国团队修复的问题亚洲团队可能不知道几小时后可能再次出现。欧洲团队的设计决策美国团队可能不理解背景导致后续实现偏离原意。解决方案公司在OpenClaw网关上部署Claude-Mem作为团队共享记忆层。所有团队的开发会话都连接到同一个记忆服务系统自动捕获并共享关键观察。实时观察馈送配置到团队的Slack频道重要活动自动通知相关成员。当旧金山团队凌晨修复了一个数据库死锁问题系统自动生成摘要并存储。几小时后东京团队开始工作时如果他们处理相关代码Claude会提示相关记忆旧金山团队凌晨修复了类似死锁问题解决方案是...。同时修复摘要自动发布到团队的Slack#数据库频道所有时区的成员都能看到。实施效果跨时区重复工作减少70%关键问题修复的团队知晓率从40%提高到95%交接文档编写时间减少60%团队间误解和偏离设计的情况减少80%24小时开发连续性显著增强实例3紧急生产故障的快速诊断与修复场景描述一家金融科技公司的支付系统在高峰时段突然出现故障交易失败率飙升到15%。运维团队需要快速诊断问题但相关代码由三个月前离职的工程师开发当前团队不熟悉实现细节。传统故障排查需要翻阅大量文档、代码历史和监控数据响应时间长达数小时导致重大业务损失。解决方案公司已部署Claude-Mem并记录了所有开发活动。当故障发生时工程师立即查询系统记忆支付服务最近有哪些变更系统返回按时间排序的近期活动两周前的性能优化、一周前的依赖更新、三天前的配置变更。通过时间线视图工程师发现故障与三天前的配置变更时间吻合。进一步查询该变更的详细信息系统显示变更内容数据库连接池大小从100调整为50变更原因减少内存使用测试结果当时通过所有测试。结合实时监控团队迅速定位问题连接池过小导致高峰时段连接耗尽。实施效果平均故障诊断时间从4小时缩短到25分钟生产故障修复速度提升85%知识流失导致的问题解决时间减少90%新工程师处理遗留代码问题的能力显著增强事故复盘更加全面历史上下文完整可追溯实例4个人开发者学习与技能提升场景描述一位独立开发者同时维护多个开源项目和技术栈经常在不同技术间切换。当需要重新使用三个月前学过的技术时经常忘记具体实现细节和最佳实践。传统方式下需要重新阅读文档、查看示例代码效率低下且容易重复犯错。解决方案开发者使用Claude-Mem作为个人开发记忆库。系统自动记录每个项目的学习过程新技术的实验代码、遇到的问题和解决方案、最佳实践总结、有用的代码片段等。当开发者需要重新使用GraphQL时可以查询我之前学习GraphQL时总结了哪些最佳实践系统返回按项目分类的记忆在电商项目中总结的查询优化技巧、在社交应用中处理N1问题的方案、在管理后台中实现权限控制的方法。这些记忆按时间线和相关性组织帮助开发者快速恢复上下文。实施效果技术切换成本降低60%重新上手时间显著缩短个人知识库系统化学习成果持久保存重复犯错减少历史教训被有效记录和提醒代码质量提高最佳实践被持续应用和优化开源项目贡献效率提升上下文连续性增强实例5教育培训机构的个性化学习支持场景描述一家编程培训学校为数百名学生提供在线课程学生进度和基础差异大。教师难以跟踪每个学生的学习历史、薄弱环节和个性化需求。传统教学方式下教师需要查阅作业记录、课堂参与和测试成绩难以提供精准的个性化指导。解决方案学校为每位学生部署个人Claude-Mem实例记录所有学习活动课堂练习、作业提交、错误调试、概念理解过程等。系统自动分析学习模式识别薄弱环节生成个性化学习建议。当学生遇到困难时教师可以查询该学生的学习记忆这位学生在函数式编程概念上遇到过哪些困难系统返回时间线视图两周前在理解纯函数时的问题、一周前在递归应用上的困惑、三天前在高阶函数使用中的错误。教师基于这些洞察提供针对性指导。实施效果学生个性化指导精准度提高80%教师备课时间减少40%基于历史洞察优化教学内容学生学习效率提升薄弱环节被持续跟踪和强化教学质量可量化教学效果基于数据持续优化学生满意度显著提高个性化学习体验增强GitHub地址官方仓库地址https://github.com/thedotmack/claude-mem项目关键信息项目名称Claude-Mem - Claude Code的持久内存压缩系统作者thedotmack最新版本v10.3.12026年2月持续活跃维护开源协议GNU Affero General Public License v3.0 (AGPL-3.0)主要语言TypeScript/JavaScript项目状态生产就绪在真实开发环境中广泛使用仓库结构概览claude-mem/ ├── .claude-plugin/ # Claude Code插件配置 ├── .claude/ # Claude配置和安装器 ├── .github/ # GitHub Actions工作流 ├── cursor-hooks/ # Cursor IDE钩子实现 ├── docs/ # 项目文档和多语言翻译 ├── install/ # 安装脚本和配置 ├── installer/ # 交互式CLI安装器 ├── openclaw/ # OpenClaw网关集成 ├── plugin/ # 插件核心代码 ├── ragtime/ # RAG相关功能 ├── scripts/ # 工具脚本和实用程序 ├── src/ # 源代码目录 ├── tests/ # 测试套件 ├── .gitignore # Git忽略配置 ├── .mcp.json # MCP服务器配置 ├── .translation-cache.json # 翻译缓存 ├── CHANGELOG.md # 版本变更日志 ├── CLAUDE.md # Claude指导文档 ├── LICENSE # AGPL-3.0许可证 ├── README.md # 项目主文档 ├── conductor.json # 分布式上下文生成配置 ├── package.json # Node.js项目配置 ├── transcript-watch.example.json # 转录监控示例 └── tsconfig.json # TypeScript配置核心特性总结持久记忆系统跨会话上下文保存避免重复解释自动观察捕获无需手动记录系统自动识别重要活动智能摘要生成冗长记录压缩为语义摘要减少存储渐进式检索三层工作流优化令牌使用效率自然语言搜索mem-search技能支持直观查询Claude桌面集成跨平台记忆访问隐私保护敏感内容标签排除和自动过滤MCP工具集成5个标准化搜索工具Web查看器界面图形化记忆管理和配置Beta功能通道无尽模式等实验性功能OpenClaw支持网关级部署和团队共享实时观察馈送Telegram、Discord、Slack集成自动故障诊断智能问题识别和修复建议多语言支持完整文档翻译和国际化安装命令参考# Claude Code插件安装推荐 /plugin marketplace add thedotmack/claude-mem /plugin install claude-mem # OpenClaw网关安装 curl -fsSL https://install.cmem.ai/openclaw.sh | bash # 重启Claude Code后自动生效系统要求Node.js 18.0.0或更高版本Claude Code最新版本支持插件Bun运行时自动安装uv包管理器自动安装SQLite 3已捆绑社区与支持官方文档详细README和配置指南多语言支持包括他加禄语Tagalog等翻译问题反馈通过GitHub Issues报告问题贡献指南欢迎提交Pull Request安全披露遵循负责任的漏洞报告流程版本更新定期发布功能增强和修复社区活跃1,415次提交持续发展项目愿景与影响Claude-Mem代表了AI辅助开发工具演进的重要方向。在AI编码助手能力日益强大的今天如何使AI记住过去的交互成为提升开发效率的关键。项目通过持久记忆层解决了会话间断层的根本问题使AI能够真正成为持续的学习伙伴而非每次重置的临时助手。从技术架构看Claude-Mem的混合存储设计SQLiteChroma平衡了关系数据和语义搜索的需求。其三层检索工作流体现了对实际使用场景的深刻理解通过渐进式披露显著优化了令牌使用效率。这种设计既保证了功能的完整性又考虑了实际部署的成本约束。从实际应用看Claude-Mem已经在多个场景中证明了其价值。无论是长期项目开发、分布式团队协作还是紧急故障响应系统都能显著提升效率和质量。其隐私保护机制特别适合处理敏感代码的企业环境。更重要的是Claude-Mem作为开源项目其透明性和可扩展性为用户提供了信心。所有组件都是可审查和可修改的用户可以根据需要调整记忆策略、摘要算法和检索逻辑。活跃的社区贡献确保项目持续演进跟上AI技术发展的步伐。随着AI在软件开发中的深入应用Claude-Mem这类记忆增强系统的重要性将日益凸显。它不仅提高了单次会话的效率更重要的是构建了持续的知识积累机制。在这个技术快速变化的时代Claude-Mem为开发者提供了对抗知识流失的有效工具是构建可持续开发工作流的关键组件。