安装 claude-mem 可以使用官方终端安装器，由它选择接入的编程工具、准备运行依赖并配置记忆提供方。开始前应确认 node.js 和宿主版本符合要求，安装后用诊断命令与一个小任务验证采集效果。仅执行全局 npm 安装并不能完成插件钩子和后台服务的配置。
检查 Node.js 和编程工具版本
在系统终端运行 node --version，确认 Node.js 为 20 或更高版本。接入当前 Claude Code 钩子时，官方安装说明要求 Claude Code 至少为 2.1.139，运行 claude --version 检查。
安装器会检查 Bun、uv 等依赖并处理缺失项。下载依赖需要网络和可写目录；已有配置先核对用途，避免把开发源码目录当作正式数据目录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
运行安装器并选择记忆提供方
在系统终端运行 npx claude-mem install，按实际需要选择宿主。交互流程会准备运行环境，再处理登录和记忆提供方选择；仔细确认当前选择，不要直接把预选服务当作唯一方案。
若明确希望记忆整理使用自己的 Anthropic 账户，可运行 npx claude-mem install --provider claude。当前文档说明该选项会跳过记忆服务账户登录步骤，但整理任务仍消耗对应 Claude 用量。
不要用 npm install -g claude-mem 代替完整安装流程；这种方式只安装 SDK 或库，不会自动完成插件注册与 worker 设置。
重新打开宿主并运行诊断
安装完成后重启终端或 IDE，再启动 Claude Code，确保新进程继承更新后的 PATH。运行 npx claude-mem doctor，检查 Hook launcher、依赖和服务状态。
在测试项目里完成一项小修改，确认查看器出现对应观察记录，再开启新会话查询该任务。首次没有旧记忆属于正常情况；诊断报错则按具体缺项修复，不用删除数据库重新开始。
