claude-mem 官方入口：AI Agent 长期记忆插件安装指南

搜 claude-mem 时，最容易混在一起的是三类页面：GitHub 仓库、官方文档、第三方教程。安装前先把入口认清，比照着别人复制一串命令更重要。按 2026 年 7 月 7 日核到的官方资料，claude-mem 的项目入口是 GitHub 上的 thedotmack/claude-mem，安装说明主要看 docs.claude-mem.ai 的 Installation 页面。

先认官方入口

GitHub 仓库适合确认项目是否还在维护、支持哪些 Agent、README 里有没有最新提醒。官方文档适合照着安装，因为它把 Quick Start、系统要求、插件市场安装和安装后验证放在同一页。看到“长期记忆插件”这类介绍时，不要只看标题，要确认页面是否指向这两个入口之一。

一个简单判断是：仓库描述里会写 Persistent Context Across Sessions，并说明它会记录 Agent 会话里的工具调用和项目观察，再把相关上下文带回未来会话。若某个页面只给网盘包、改名安装器或要求先输入账号密码，就先停下来核验来源。

推荐先走 npx 安装

新手最稳的路径是打开终端，确认 Node.js 和 npm 可用，然后执行官方推荐的安装命令：

npx claude-mem install

这个安装器会做运行时检查，并检测已安装的 IDE 或 AI Agent 客户端，例如 Claude Code、Cursor、Windsurf、OpenCode、Codex CLI、Antigravity CLI 等。交互步骤里只选自己实际在用的工具，不要全选一堆从没打开过的客户端，否则后面排查 hooks 会变乱。

这里有个常见坑：npm install -g claude-mem 看起来也像安装成功，但官方 README 已提醒，它通常只是装 SDK 或 library，不会注册插件 hooks，也不会把 worker 服务配置好。命令没报错，不代表长期记忆已经接入 Agent。

Claude Code 里也有插件命令

如果你主要用 Claude Code，也可以在 Claude Code 的插件流程里添加 marketplace，再安装 claude-mem。常见命令是先添加 thedotmack/claude-mem，再执行插件安装。这个路径更像“在 Claude Code 内部装插件”，适合已经熟悉 Claude Code 插件市场的人。

我会这样判断：第一次配置、多工具共用，选 npx claude-mem install；只给 Claude Code 装，而且你已经会用 /plugin，再考虑插件市场命令。两条路不要混着反复跑，失败时先看当前到底采用哪一种安装路径。

安装后看三个位置

安装完成不等于记忆马上好用。先重启对应的 AI Agent，再看 ~/.claude-mem/ 是否生成设置、数据库或日志文件。接着开一个新会话，让 Agent 回忆刚刚项目里的文件、命令或决策；如果它只能泛泛回答，说明上下文没有正确取回。

隐私也要提前处理。claude-mem 会记录项目操作观察，适合保存“上次测试失败原因”“某个模块别动”“迁移方案为什么放弃”这类动态历史，不适合保存密钥、客户隐私或未脱敏日志。涉及敏感内容时，先用官方的隐私标签或配置排除，再让它长期运行。

适合谁，不适合谁

它适合长期维护一个代码库、经常换会话、希望 AI Agent 记住排查过程的人。它不适合一次性问答、临时生成小脚本，或者对本地会话记录很敏感的项目。装之前想清楚这一点，比装完再纠结“为什么它记了这么多”更省时间。

最后检查四件事：入口来自 GitHub 仓库或官方文档；安装命令使用 npx claude-mem install 或 Claude Code 插件流程；本地目录和日志能看到变化；新会话能取回项目历史。四项都满足，再把它当成 AI Agent 的长期记忆层来用。