claude-mem 怎么用？Codex/Claude Code 跨会话记忆方法

你昨天让 Codex 或 Claude Code 读过项目结构、修过一个坑、还定过一条开发规则，今天开新会话又要从头解释一遍。claude-mem 解决的就是这种断层：它把会话里的工具调用、项目观察、决策和摘要保存下来，在后续会话里把相关上下文重新取出来，让 AI Agent 不至于每次都像第一次见这个项目。

我会这样理解它：claude-mem 不是把整段聊天原封不动塞回上下文，而是通过 hooks、worker 服务、SQLite 数据库和搜索工具，把历史工作压缩成可检索的记忆。用在 Claude Code 时更顺；用在 Codex 这类 AI 编程助手上，重点也是同一件事：让项目背景、修复记录和个人偏好能跨会话接上。

第一步：先把它装到正在用的助手里

官方推荐的入口是 npx claude-mem install。安装器会检查运行环境，选择要接入的 IDE 或 CLI，比如 Claude Code、Cursor、OpenCode、Codex CLI、Antigravity CLI 等，并配置 hooks 和本地 worker。Claude Code 还可以走插件市场命令：/plugin marketplace add thedotmack/claude-mem，再执行 /plugin install claude-mem。

我会这样试：先用推荐命令安装，再新开一个 Claude Code 或 Codex 项目会话，问它“你能看到哪些历史项目记忆”。如果完全没有上下文，不急着写文章式排查，先确认 worker 是否启动、插件 hooks 是否被安装、当前项目是不是你之前工作的那个目录。

第二步：让它自然积累，而不是手动复制聊天记录

claude-mem 的日常用法很轻：你正常让 Agent 读文件、改代码、运行测试、记录决策，它会在会话过程中捕获观察，再在后台生成摘要。下一次会话开始时，相关上下文会被注入；需要更精确时，再用搜索工具去查历史。

我会这样试：修完一个复杂问题后，直接告诉 Agent：“把这次修复的原因、涉及文件、以后不要再踩的坑整理成可复用记忆。”这样做的好处是，记忆里会有更明确的项目规则，而不是只留下零散的文件访问痕迹。

第三步：用搜索找旧决策

当项目做久了，不要一上来就让 AI 拉满所有记忆。claude-mem 的搜索文档强调三层方式：先 search 拿轻量结果，再用 timeline 看前后发生了什么，最后只对关键 ID 用 get_observations 取完整细节。这样比一次性翻出大量历史更省上下文，也更不容易把无关旧事带进当前任务。

我会这样问：“搜索一下上次认证失败相关的修复记录，先只给我结果索引，不要展开全文。”看到 ID 后，再让它拉取最相关的 3 条。这个节奏适合查 bug、查架构决策、查某个页面为什么要这么实现。

第四步：把敏感内容排除在记忆之外

跨会话记忆好用，但不等于所有东西都该被保存。claude-mem 支持 <private> 标签，把临时上下文、密钥、内部地址、生产错误日志等包起来。Agent 在当前会话能看到这些内容，但它们不会进入持久化记忆和搜索索引。

我会这样试：发日志、token、客户信息、临时决策前，先用 <private> 包住。真正该记住的是“这个项目测试前要启动 Redis”“这个目录是旧版代码不要改”“支付回调失败的根因是签名时间窗”，不是具体密钥和客户数据。

Codex 和 Claude Code 里怎么分工

Claude Code 适合优先跑 claude-mem 的插件式工作流，因为官方文档围绕 hooks、插件市场和 Claude Code 写得最完整。Codex 场景里，可以把它当成项目记忆层：开始任务时先让 Agent 检索相关历史，再按当前仓库文件核实，不要只凭旧记忆下结论。

收尾检查看 4 点：新会话能否看到上一轮摘要；搜索能否找到关键 bug 或决策；敏感内容有没有用 private 标签排除；AI 给出的旧记忆是否又被当前文件验证过。四点都做到了，claude-mem 才是真正在帮 Codex/Claude Code 接着干活，而不是多装了一个记忆插件。