告别AI失忆!Claude Code插件“Claude-Mem”让AI拥有永久记忆,代码会话从此无缝衔接-夜雨聆风

告别AI失忆!Claude Code插件“Claude-Mem”让AI拥有永久记忆,代码会话从此无缝衔接

你是否经历过这样的场景：在Claude Code中辛苦调试了一整天，解决了三个Bug、重构了两个模块，正准备收工时，突然需要切换一个紧急任务。等你再回来，会话早已关闭，之前所有的上下文、思考脉络、代码修改记录全部归零。Claude再次像个“失忆”的实习生，从头开始问东问西……
如果AI能拥有永久记忆，一切将完全不同。

痛点：AI会话的“金鱼记忆”

作为开发者，我们早已习惯了和AI结对编程。Claude Code这类智能编码工具，能极大提升我们的开发效率。但有一个问题始终挥之不去：AI的上下文是短暂且孤立的。

每次启动新会话，Claude都像第一次见面一样，对项目一无所知。哪怕你昨天刚和它讨论过某个模块的架构设计，今天它依然会问你“这个函数是做什么的”。这种“金鱼记忆”让协作变得断断续续，效率大打折扣。

有人可能会说：“那我每次手动把上次的对话总结贴给Claude不就行了？”
但手动整理上下文既耗时又容易遗漏，而且随着项目复杂度增加，维护成本呈指数级上升。

如果有一种工具，能让AI自动记录、压缩并注入上下文，那该多好？

现在，这个工具真的来了——Claude-Mem。

Claude-Mem：为Claude Code打造的“永久记忆”系统

Claude-Mem是一个专门为Claude Code设计的插件，它通过自动捕获会话中的工具使用、代码操作、讨论内容，生成语义摘要，并在未来会话中智能注入相关上下文，从而让Claude拥有跨越会话的持久记忆。

简单来说，它让Claude Code从一个“用完就忘”的临时助手，变成了一个能够“记住你、理解项目、延续思考”的长期伙伴。

核心功能：四大亮点，让记忆真正可用

🧠 持久化记忆

所有会话中的观察记录（包括你做了什么、改了哪些文件、问了什么问题）都会被自动存储到本地SQLite数据库。当你下次启动会话时，Claude-Mem会将相关历史上下文注入，Claude会“记得”之前的讨论和决策。

📊 渐进式披露

记忆不是一股脑全塞给Claude——那样会快速消耗令牌。Claude-Mem采用分层检索策略，先给出精简索引（约50-100 tokens/结果），待Claude确认需要查看详情时，再展开完整内容。令牌消耗减少约10倍。

🔍 基于技能的智能搜索

提供mem-search技能，允许你通过自然语言查询历史记忆。比如输入“我们上周讨论的API认证问题”，Claude-Mem会从数据库中找出相关观察记录，并提供上下文供Claude引用。

🖥️ Web查看器界面

运行http://localhost:37777，即可打开一个实时更新的Web面板，你可以在这里浏览所有会话记录、观察摘要，甚至手动搜索记忆。

🔒 隐私控制

不想让AI记住某些敏感内容？只需在对话中使用<private>标签包裹内容，Claude-Mem会自动过滤这些内容，绝不存储。

⚙️ 上下文配置

你可以通过配置文件精细控制哪些上下文被注入、注入多少条观察、摘要的生成方式等。默认设置已针对大多数场景优化，但高级用户可深度定制。

🤖 完全自动化

无需任何人工干预。Claude-Mem通过Claude Code的钩子系统，在会话启动、工具使用、会话结束等关键节点自动触发记忆操作，真正做到“无感”。

🔗 引用追溯

每条观察记录都有唯一ID，你可以通过ID在Web查看器中查看完整内容，也可以在后续对话中直接引用（例如“根据上次#123号观察，我们讨论过……”）。

工作原理：钩子+服务+数据库的三层架构

Claude-Mem并不是一个简单的脚本，而是一个精心设计的系统，由以下核心组件构成：

1. 5个生命周期钩子

利用Claude Code的钩子机制，在以下时刻自动执行任务：

SessionStart：会话启动时，注入历史上下文
UserPromptSubmit：用户提交提示时，记录观察
PostToolUse：工具使用后，记录操作结果
Stop：会话停止时，生成摘要
SessionEnd：会话结束时，做最终清理

2. 工作服务（Worker Service）

一个独立运行的HTTP服务，监听localhost:37777，提供：

10+个搜索API端点（供Claude调用）
Web查看器界面（供开发者浏览）
数据库管理、摘要生成等后台任务

该服务由Bun管理，性能优异，资源占用极低。

3. SQLite数据库

所有观察记录、会话信息、摘要内容都存储在~/.claude-mem/目录下的SQLite数据库中。利用FTS5全文搜索，实现快速检索。

4. Chroma向量数据库

为支持语义搜索，Claude-Mem集成了Chroma向量数据库。当Claude需要寻找“相关但关键词不完全匹配”的记忆时，向量搜索能够基于语义相似度找到最相关的结果。

5. 记忆压缩引擎

每次会话结束时，Claude-Mem会调用AI（通过Claude Agent SDK）对本次会话的观察记录进行压缩，生成结构化摘要，并存储到数据库中，供后续会话使用。

MCP智能搜索工具：3层工作流，节省10倍令牌

Claude-Mem通过4个MCP（Model Context Protocol）工具，实现了令牌高效的智能搜索。这套工具遵循渐进式披露设计理念，让Claude在需要时才获取完整内容。

工具列表

search

功能：通过全文查询搜索记忆索引，可按类型、日期、项目筛选。
返回：精简的结果列表（ID+摘要），约50-100 tokens/条。

timeline

功能：获取特定观察记录或查询的时间线上下文。
返回：相关观察记录的前后内容，帮助理解事件的连续性。

get_observations

功能：通过ID获取完整观察记录详情。
返回：完整的观察内容，约500-1000 tokens/条。

典型使用流程

// 第一步：搜索获得索引search(query="authentication bug", type="bugfix", limit=10)// 第二步：查看索引，识别相关ID（例如 #123, #456）// 第三步：获取完整详情get_observations(ids=[123, 456])

通过这种方式，Claude可以先用少量令牌筛选出候选，再只对真正需要的内容展开详情，相比一次性返回所有内容，令牌消耗减少约10倍。

快速开始：三步安装，立即体验

安装Claude-Mem非常简单，只需在Claude Code中执行以下命令：

# 第一步：添加插件市场/plugin marketplace add thedotmack/claude-mem# 第二步：安装插件/plugin install claude-mem# 第三步：重启Claude Code

重启后，Claude-Mem会自动启动工作服务（监听http://localhost:37777），并开始记录本次会话的内容。当你下次启动新会话时，历史上下文将自动注入。

💡 注意：Claude-Mem也发布在npm上，但npm install -g claude-mem仅安装SDK/库，不会注册插件钩子或启动工作服务。请务必通过上述/plugin命令进行安装。

🦞 OpenClaw网关集成

如果你使用OpenClaw网关，可以通过单条命令安装Claude-Mem作为持久化内存插件：

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

安装程序会自动处理依赖、插件设置、AI提供商配置、工作进程启动，甚至可选的实时观察内容推送到Telegram、Discord、Slack等平台。

系统要求与Windows注意事项

Node.js：18.0.0或更高版本
Claude Code：支持插件的最新版本
Bun：JavaScript运行时和进程管理器（若缺失将自动安装）
uv：Python包管理器，用于向量搜索（若缺失将自动安装）
SQLite 3：用于持久化存储（已捆绑）

Windows用户若遇到npm : The term 'npm' is not recognized错误，请确保已安装Node.js并将其添加到PATH。从Node.js官网下载最新安装程序，安装后重启终端即可。

配置与开发：定制属于你的记忆引擎

配置文件

设置存储在~/.claude-mem/settings.json中。首次运行时会自动创建并填充默认值。可配置项包括：

AI模型选择
工作服务端口（默认37777）
数据目录
日志级别
上下文注入数量（默认最近50条观察）
Chroma向量数据库模式（本地/远程）

详细配置说明请参阅官方文档。

开发与贡献

Claude-Mem是一个开源项目（AGPL-3.0），欢迎参与贡献。步骤如下：

Fork仓库
创建功能分支
编写代码和测试
更新文档
提交Pull Request

开发指南详见官方开发文档。

错误报告

如果遇到问题，可以运行内置的错误报告生成器，它会自动收集环境信息并生成全

面的报告：cd ~/.claude/plugins/marketplaces/thedotmacknpm run bug-report

测试版功能：无尽模式

Claude-Mem提供了一个测试版渠道，包含实验性功能。其中最引人注目的是无尽模式——一种用于延长会话的仿生记忆架构。当你的会话接近令牌限制时，无尽模式会自动将当前上下文压缩成摘要，并开始新会话，实现“无限长度”的对话。

你可以通过Web查看器界面（http://localhost:37777 → 设置）在稳定版和测试版之间切换，体验最新功能。

社区与支持

Claude-Mem拥有一个活跃的开发者社区，你可以通过以下渠道获取帮助和交流：

📖 官方文档：claude-mem.dev
🐞 GitHub Issues：提交问题或建议
🐦 官方X账号：@Claude_Memory
💬 官方Discord：加入Discord
✍️ 作者：Alex Newman (@thedotmack)

关于$CMEM代币

有一个名为CMEM的Solana代币，它由社区成员在未事先征得Claude-Mem创建者同意的情况下创建，但后来被创建者Alex Newman正式接纳。该代币旨在作为社区发展的催化剂，为最需要实时智能体数据的开发者和知识工作者提供支持。
代币地址：2TsmuYUrsctE57VLckZBYEEzdokUF8j8e1GavekWBAGS

结语

AI的“记忆”能力，决定了它与人类协作的深度。Claude-Mem通过巧妙的设计，让Claude Code从一个“会话工具”进化为一个“长期伙伴”。它自动记录、压缩、检索，将历史经验转化为即时可用的知识，让每次对话都站在之前的肩膀上。

如果你厌倦了反复向AI解释项目背景，如果你想在复杂开发任务中保持思路连贯，如果你希望AI真正“了解”你和你的代码——那么，Claude-Mem值得你立刻尝试。

现在就去安装吧，让Claude记住你的一切，让每一次协作都更加高效。