Claude Code 每次都失忆，先别急着重装。先分清两件事：Claude Code 自带 auto memory，会把项目记忆放在 ~/.claude/projects/<project>/memory/；claude-mem 是第三方持久记忆插件，官方仓库是 thedotmack/claude-mem，靠 hooks、worker service 和本地数据库把过往会话摘要带回新会话。核验日期：2026-07-07。

claude-mem 怎么安装

官方推荐入口是 npx claude-mem install，也能在 Claude Code 里走插件市场：/plugin marketplace add thedotmack/claude-mem，再执行 /plugin install claude-mem。README 特别提醒，npm install -g claude-mem 只装 SDK/library，不会注册 hooks，也不会启动 worker。装完要重启 Claude Code；如果给 Codex、OpenCode 等工具接入，按安装器里检测到的 IDE 选项来，不要手动乱改项目文件。

安装前检查什么

• Node.js 版本至少 20。
• Bun、uv、SQLite 由安装器处理，失败时再跑 npx claude-mem repair。
• 选择 LLM provider 时，看你是用 Claude Code auth，还是 Gemini API key、OpenRouter API key。

配置文件看哪里

claude-mem 的主要目录在 ~/.claude-mem/，常看四个位置：settings.json、claude-mem.db、.worker.port、logs/。想改数据目录，用 CLAUDE_MEM_DATA_DIR；想改 worker 端口，用 CLAUDE_MEM_WORKER_PORT。密钥只放官方推荐的环境变量、~/.claude-mem/.env 或安装器写入的位置，别塞进业务项目根目录的 .env。涉及客户代码时，用 <private> 标签排除敏感内容。先别删库，先重启。

装完怎么验收

先开一个小项目，让 Claude Code 修一个小 bug、解释一次架构取舍，再结束会话。新会话里问“上次我们改到哪一步”，看是否出现相关观察记录。若仍像空白会话，先查 ~/.claude-mem/settings.json、worker 日志和端口；同时打开 Claude Code 的 /memory，确认 auto memory 没被关掉。能打开 viewer 但没有记录，多半是上一轮会话还没有产生可压缩观察；端口打不开，再看 worker 是否启动。CLAUDE.md 仍适合放 AI 编程规范，claude-mem 更适合记录过程记忆；提交前再看 Git Diff，别让记忆插件替你判断代码质量。

常见问题

1. 识别不到？重启 Claude Code，确认 hooks 已注册。
2. 需要 API key 吗？用 Claude Code auth 时未必单独填 key；选 Gemini 或 OpenRouter 时按安装器提示配置。
3. 能用第三方下载站吗？不要，只用 GitHub、官方文档或插件市场。

安装成功检查清单

• npx claude-mem install 已跑完。
• ~/.claude-mem/settings.json 存在。
• worker 有端口和日志。
• 新会话能读到上一轮项目上下文。