跨会话、跨客户端复用工程经验：最新安装、Repo Memory与安全边界完整指南
在真实 AI 编程中，模型能力只是效率的一半，另一半是“下一次对话还记不记得上一次做过什么”。MemoraX Code 把长期记忆嵌入 Codex、Claude Code、DeepSeek Harness 与 OpenCode，让工程经验、仓库知识和协作习惯在跨会话、上下文压缩与客户端切换后继续可用。
为什么 Claude Code 与 Codex 需要共享记忆
切换 Coding Agent 时，最昂贵的不是重新打开项目，而是重新解释架构、失败尝试、仓库规则和当前决策。让另一个 Agent 全量读取代码和历史对话不仅消耗 Token，还可能漏掉真正关键的上下文。MemoraX Code 在客户端之外增加一层可检索记忆，只把与当前任务相关的少量信息带回会话。
它不是另一个 Harness，而是一套轻量集成
MemoraX Code 以 Skill、Hook、CLI 和本地 Backend 的方式接入现有工具，不要求把开发工作迁移到新的 IDE。当前官方说明支持 Codex、Claude Code、DeepSeek Harness 与 OpenCode。每个客户端保留自己的模型、工具和供应商流量，MemoraX 主要承担记忆检索与写回。
最新安装方式：先装包，再显式运行 setup
准备 Node.js 20 或更高版本（官方推荐 Node.js 24 LTS）；若要构建 Repo Memory，还需要 Python 3。当前官方流程把安装和配置拆成两步：
npm install -g @memorax/memorax-code
memorax-code setup安装器会检测可运行的客户端并完成连接。已有 MemoraX 账户可使用 memorax-code setup --existing-account。旧教程里常见的 --foreground-scripts 一行安装方式不应替代当前官方流程。
第一步实测：从 Codex 切换到 Claude Code
可以先用 Codex 搭建项目骨架、提交代码并形成关键决策，再在 Claude Code 新会话中要求继续同一项目。MemoraX Code 会按当前仓库范围检索相关工程记忆，让审查 Agent 先看到经过压缩的决策、风险和失败经验，再针对当前代码做验证。记忆被明确视为“待验证假设”，而不是事实真相。
Repo Memory：让 Issue、PR、Commit 变成可追溯上下文
Repo Memory 面向仓库结构和历史证据。你可以要求 Agent 拉取最近的 Issue、Pull Request 和 Commit，建立入口模块、关键实现、已知问题与决策映射。换到另一个客户端后，它不必重新扫完整仓库，就能从最近问题切入，再用当前代码核对。
四类记忆边界分别解决什么问题
Coding Memory 保存已验证修复、失败方案和回归检查；Repo Memory 记录架构、模块职责以及 Issue、PR、Commit 证据；Personal Memory 保存语言、解释深度和结果格式等协作偏好；Procedure Memory 保存可复用步骤、检查清单、前置条件和验证关卡。边界越清楚，检索时越不容易把无关信息塞回上下文。
跨会话协作的推荐工作流
一个稳妥流程是：先让主力 Agent 完成阶段任务并测试；再要求 MemoraX Code 保存可复用经验；新开会话或切换客户端后只召回当前任务相关内容；最后让新 Agent 用代码、测试和 Git 记录逐条核验。可把昂贵模型留给规划和审查，把执行交给更经济的模型，但不能省略测试与代码评审。
云端记忆、安全与隐私边界
云端记忆需要连接 MemoraX 服务。完成 setup 后，生成的配置会启用搜索、添加和自动写回；自动检索默认仍需显式启用。所选查询或写回内容会发送到 MemoraX，因此 API Key、私有仓库信息和敏感业务上下文都应按机密数据处理。建议先用非敏感项目测试，并检查配置、Trace 与保留策略。
如何判断它是否真的节省 Token
不要只看“会不会召回”，还要比较四项指标：新 Agent 到达正确修改点所需的轮数、读取文件数量、重复解释长度，以及最终是否通过测试。好的记忆层应减少调查成本，同时保留验证步骤；如果召回内容太多、过时或让 Agent 跳过代码检查，反而会放大错误。
适合与不适合的项目
它适合长期维护、多人或多 Agent 协作、需要频繁切换客户端以及 Issue/PR 历史丰富的仓库。一次性脚本、极小项目或不能把任何工程信息发送到外部服务的环境，收益可能有限。严格合规团队应先完成数据流、访问控制和删除机制评估。
三个可直接使用的提示词
- “使用 MemoraX Code 建立 Repo Memory，只拉取最近 3 个 Issue、PR 和 Commit，并标注证据来源。”
- “回忆这个仓库里与当前 Bug 相关的工程经验，把记忆当作假设，用现有代码和测试逐条验证。”
- “本轮任务完成并通过测试后，保存可复用的修复经验、失败方案和回归检查，不记录密钥与一次性信息。”
结论：共享记忆是协作层，不是事实数据库
MemoraX Code 让不同 Coding Agent 在同一项目上更容易接力，尤其适合“经济模型执行、强模型规划和审查”的组合。但长期记忆最重要的品质不是数量，而是边界清楚、按需召回、可删除并能被当前代码验证。把它当作跨会话的工程线索层，会比把它当作永远正确的知识库更可靠。
