claude-mem新手教程：一条命令给 Claude Code 装上”永久记忆”，跨会话自动记住你的项目

你是不是也遇到过这种情况：用 Claude Code 改了半天代码，明天新开一个会话，它又变回”失忆”状态——项目结构要重新讲一遍，昨天定好的代码规范要再说一次，改到一半的功能它压根不记得。好家伙，感觉每天都在带新人。

更糟的是长项目。上下文越堆越多，token 花了不少，AI 却还是记不住关键结论。今天介绍一款本周刚冲上 GitHub 热榜的开源工具 claude-mem（一周涨了 3800+ Star），专治这个病。

claude-mem 是什么？

一句话：给 Claude Code 装上跨会话的”长期记忆”。

它会自动捕捉你在每个会话里干了什么——用了哪些工具、改了哪些文件、得出什么结论——然后压缩成语义摘要存在本地数据库里。下次你再打开 Claude Code，它自动把上回的记忆带进来，接着上次的进度干活。全程不用你手动整理笔记。

开源免费（Apache 2.0 协议），支持 Windows / macOS / Linux。

安装前的准备

装之前先确认两件事：

① 你已经装好并登录了 Claude Code（claude-mem 是它的插件，本身不能独立跑）。
② 电脑上有 Node.js 20 或更高版本。终端里敲 node -v 看一眼版本号，不够就去 nodejs.org 装新的。

第一步：一条命令安装

打开终端（Windows 用 PowerShell），直接敲：

npx claude-mem install

就这一条。安装器会自动检查依赖、注册插件钩子、把后台服务搭好。

⚠️ 这里有个大坑必须提醒：网上有些教程写 npm install -g claude-mem，这是错的！官方 README 明确说了，全局 npm 方式只装了 SDK 库，不会注册插件钩子，也不会启动后台服务，装完等于白装。老老实实用上面的 npx claude-mem install。

第二步：登录或跳过（都行）

安装完它会引导你在浏览器里登录 claude-mem（邮箱验证码方式，不用绑卡）。登录后前 30 天可以用它自带的免费记忆服务。

不想登录也完全没问题，安装时加个参数跳过：

CLAUDE_MEM_ONLINE_OPTIN=false npx claude-mem install

跳过登录后你需要自己选记忆后端：自己的 OpenRouter/Gemini API key，或者直接用你的 Anthropic 订阅额度。装完记得重启 Claude Code。

如果你已经在用 Claude Code 的插件市场，也可以走市场方式安装：

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

第三步：什么都不用做，它自己跑

装好之后就是它的核心卖点：零操作。你照常写代码、和 AI 对话，claude-mem 在背后默默干活：

• 会话开始时——自动把之前的项目记忆注入给 AI
• 你每次提问时——记录这次交互的关键信息
• AI 每次用工具时——捕捉改了什么文件、执行了什么命令
• 会话结束时——把过程压缩成摘要，存进本地 SQLite 数据库

技术上它靠 5 个生命周期钩子（SessionStart / UserPromptSubmit / PostToolUse / Stop / SessionEnd）挂在 Claude Code 上，加一个本地后台服务负责存储和检索。数据库全在你自己电脑上，不上云。

想看看它到底记了啥？启动时终端会打印一个本地网址，浏览器打开就是实时记忆查看器，能看到所有记录流。

几个实用技巧

① 敏感内容不入库。把密码、密钥这类内容包在 <private>...</private> 标签里，claude-mem 就不会存它。

② 查历史不用翻。它内置 mem-search 技能，直接用自然语言问”上次我们是怎么解决登录超时的”，AI 会去记忆库里搜。搜索走三层省 token 流程：先拿索引 → 再看时间线 → 最后只取需要的详情，官方说能省约 10 倍 token。

③ 不只支持 Claude Code。装 OpenCode 的用 npx claude-mem install --ide opencode，Antigravity CLI 也支持。多工具党的福音。

常见问题

Q：数据存在哪？安全吗？
存在本地 SQLite 数据库里，不开登录就是纯本地。云同步是可选功能，不同步不影响使用。

Q：会不会拖慢 Claude Code？
钩子只在会话节点触发，摘要压缩是后台服务干的，实测对日常使用无感。

Q：npm 装的那个版本怎么卸载干净？
claude-mem 有 uninstall 命令，官方文档 docs.claude-mem.ai 有 Troubleshooting 章节，遇到怪问题先去那查。

下载地址

嫌在线安装慢的，这里提供官方 npm 安装包离线版（v13.35.0，未做任何修改）：

夸克网盘下载：https://pan.quark.cn/s/0bc5b1ac69e7

这个 tgz 是官方 npm 安装包原样备份，可离线留档。要说明的是：安装注册这一步官方只认 npx claude-mem install 这条路（全局 npm 装的只是 SDK 库，不带钩子），所以建议还是在有网环境执行上面的安装命令；这个包适合留着做版本备份或网络不好时加速。

项目主页：https://github.com/thedotmack/claude-mem

说实话，现在 AI 编程工具越来越多，但”失忆”一直是最大痛点。claude-mem 用最省事的方式把这个坑填了——一条命令装上，然后你就忘了它的存在，直到发现 AI 居然记得上周三你写过什么。

关注公众号：「实用软技」，在公众号窗口里回复关键字“软件”即可免费获取

https://www.88531.cn/?p=58228

创作不易，用心坚持，请喝一怀爱心咖啡！继续坚持创作~~