AI 编程助手最尴尬的时刻，是你昨天已经让它读完项目、跑过测试、解释过架构，今天新开 Claude Code，它又像刚入职一样从零问起。claude-mem 的安装目的，就是把这些项目上下文留到下一次会话里，让 Agent 能接着上次的判断继续干活，而不是每次重新热身。

先知道它装完后应该变成什么样

装好 claude-mem 后，新会话不是凭空变聪明，而是会自动拿到上一些会话的相关上下文。它会观察工具调用，压缩项目线索，再在后续会话开始时注入相关记忆。你应该看到的结果是：Claude Code 能说出项目里最近处理过什么、哪些命令跑过、哪个方案之前被否掉。

我会这样试：安装前先选一个真实项目，不要拿空目录测试。让 Claude Code 读一个模块、记录一个测试命令、解释一次失败原因，然后新开会话问它“上次这个项目卡在哪里”。这个问题能直接判断记忆有没有接上。

安装入口选哪个

第一次安装，优先用官方推荐的交互式命令：

npx claude-mem install

这个安装器会检查运行时，自动处理 Bun 和 uv，检测 Claude Code、Cursor、Windsurf、OpenCode、Codex CLI 等工具，并让你选择模型提供商。装完后会复制插件文件、注册 hooks，并启动 worker 服务。

如果你已经在 Claude Code 里，也可以直接用插件市场命令：

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

我会这样试：新手先用 npx claude-mem install。它会把依赖、IDE 检测、worker 启动都串起来；等跑通后，再考虑给其他编辑器接入。

不要只跑 npm 全局安装

这里最容易错。claude-mem 虽然发布在 npm 上，但 npm install -g claude-mem 只会安装 SDK 或 library，不会注册 Claude Code 的插件 hooks，也不会启动 worker。命令成功不等于跨会话记忆已经生效。

我会这样试：如果你之前只跑过 npm 全局安装，直接重新走 npx claude-mem install。不要继续围绕全局包排查，否则会把问题绕远。

安装前看三个条件

官方要求 Node.js 20.0.0 或更高版本；Bun 1.0 以上和 uv 会由安装器尝试自动补齐；还需要 Claude Code 或其他支持的 IDE。SQLite 由 bun:sqlite 提供，数据会写到本机。

我会这样试：终端先跑 node -v。如果主版本低于 20，先升级 Node，再安装 claude-mem。不要在旧 Node 环境里反复 repair，错误会越来越像“插件坏了”，其实只是环境没达标。

装完后先看数据目录

默认数据目录是 ~/.claude-mem/，常见文件包括数据库、worker pid、worker port、日志和 settings.json。如果你怀疑没有记忆，先看这个目录有没有生成，而不是马上删除重装。

关键文件是：

~/.claude-mem/settings.json
~/.claude-mem/claude-mem.db
~/.claude-mem/.worker.port
~/.claude-mem/logs/

我会这样试：装完先打开 settings.json，确认 worker host、worker port、data dir 都存在。网页查看器打不开时，也先看这里的端口，不要死记一个固定地址。

新会话怎么验证能接着干活

安装完成后，重启 Claude Code，进入同一个项目目录。先让它做一个小任务，例如读取 README、确认测试命令、总结一个模块职责。结束会话后重新打开 Claude Code，再问一个具体问题。

可以这样问：

上次这个项目里，我们确认的测试命令是什么？
上次你读过哪个模块，它主要负责什么？
之前为什么没有采用方案 A？

如果它能答出具体命令、文件或决策，说明跨会话上下文已经接上。如果只回答一堆通用建议，说明还要查 worker、hooks 或上下文注入设置。

我会这样试：先验证一个小记忆，再验证复杂决策。小记忆过不了，不要急着拿大项目压它。

如果更新后提示异常怎么办

插件升级后，如果版本标记、依赖或 hooks 状态不一致，官方建议用 repair 修复：

npx claude-mem repair

它会刷新缺失依赖和安装标记，比直接删目录重装更稳。只有确认数据库损坏、备份完成、日志也指向存储问题时，再考虑清理数据。

我会这样试：先 repair，再看 worker 日志。不要第一步就删 ~/.claude-mem，那相当于把可能有用的历史上下文也一起丢掉。

中文项目建议加一项设置

如果你的项目需求、注释、任务说明主要是中文，可以把模式设成 code--zh：

{
  "CLAUDE_MEM_MODE": "code--zh"
}

这个设置影响观察摘要和上下文注入的语言风格，不会改变代码本身。中文团队使用时，它能让后续会话拿到更自然的中文项目线索。

我会这样试：中文项目用 code--zh，英文开源项目保留默认 code。改完配置后重启 Claude Code，再测新会话是否能接回上下文。

安装完成检查清单

• Node.js 版本达到 20.0.0 或更高。
• 使用 npx claude-mem install 或 Claude Code 插件市场命令安装。
• 没有把 npm install -g claude-mem 当成插件安装完成。
• ~/.claude-mem/settings.json 已生成。
• worker 端口、数据目录和日志文件能找到。
• 重启 Claude Code 后，在同一个项目里能取回上一轮具体上下文。
• 中文项目已按需要设置 CLAUDE_MEM_MODE。

claude-mem 的安装重点不是多跑几个命令，而是让“记录、压缩、保存、取回”这条链路跑通。只要新会话能接住上次的项目命令、文件判断和决策原因，AI 编程助手就不再是每天重新报到，而是能沿着昨天的进度继续往下走。