用编码 Agent 的人几乎都撞过这堵墙：Claude Code 知道你为什么选了某个架构，Codex 却完全不知道这段对话存在过，Cursor 又从零开始理解项目——每次切换工具都要把背景重新讲一遍。8 月底一篇 XDA 实测文章展示了一个解法：AgentMemory，一个本地共享记忆服务器，让 Claude Code、Codex、Cursor 等编码 Agent 接入同一个项目记忆，切换工具零重复讲解。这篇教程带你装起来，并在真实项目里跑通「三工具接力」。
🧠 本教程适合：在多个编码 Agent 之间切换的开发者（重度用户尤其受益）、技术团队负责人。需要 Node.js 20+，会跑终端命令即可。
Step 1：先确认痛点——「记忆属于会话」而不是「属于项目」
1 为什么每次切换 Agent 都要从零开始
主流的编码 Agent「记忆」都是会话级的：
· 会话结束 = 记忆清零
· 换工具 = 项目背景全丢
三个具体痛点：
1. 重复劳动：每次新会话都要重新讲
架构约定、命名规范、设计意图
——复杂项目光「前情提要」就要 10-20 分钟
2. 知识无法沉淀：调试发现的 bug 根因、
总结出的最佳实践，全都没地方存
3. 上下文窗口有限：想全量倒给新 Agent
又放不下，硬塞还费 token
AgentMemory 的解法：
· 记忆从「属于某个 Agent」变成「属于项目」
· 运行时自动捕获提示词、工具调用、
决策、偏好 → 存进本地共享记忆库
· 另一个 Agent 需要时，检索出相关的部分
——不是全量倾倒，是按需取用💡 注意区分：这和《Codex 持久模式》的「单工具跨会话记忆」不同——AgentMemory 解决的是跨工具的交接，是给「多 Agent 接力」配的公共记忆层。
Step 2：安装——比想象中简单
2 一条命令 + 交互式向导
前置要求：Node.js 20 或更新
1. 安装并启动
npx -y @agentmemory/agentmemory@latest
2. 首次运行进入交互式向导：
· 选择要连接的 Agent
（Claude Code / Codex / Cursor / GitHub Copilot CLI /
DeepSeek Harness / OpenClaw / Qwen Code /
Antigravity 等）
· 选择 LLM 提供方（或保持无 Key 模式）
· AgentMemory 自动启动本地记忆服务器 + 运行时
3. 装插件（让记忆「自动捕获」）
· Claude Code 和 Codex 需要装官方插件：
生命周期钩子自动记录会话过程
· Cursor 通过 MCP 连接即可
4. 打开本地查看器
http://localhost:3113
· 实时看记忆库在构建（决策、偏好、工具调用）🚀 新手建议：第一次先连 2 个工具（比如 Claude Code + Codex），跑顺了再加 Cursor——插件越少，排障越简单。
Step 3：实战验证——三个工具接力做一个小项目
3 复刻 XDA 作者的「接力测试」
测试设计：做一个本地看板式文章追踪器
（纯 HTML/CSS/JS + localStorage，无后端）
第一棒：Codex 做功能
· 提示：「做 5 个阶段的看板式文章追踪器，
支持每篇稿件的截止日期、备注、拖拽」
· 完成度 ✓，架构决策被记入共享记忆
第二棒：Claude Code 做设计（故意不给背景）
· 提示：「功能已经 OK，UI 需要好好设计，
做成精炼的 Mac App 风格，圆角卡片、
留白充足。不要改变已经定下的功能与决策」
· 结果：没有 undo Codex 的成果，直接接力
第三棒：Cursor 做规划视图（给一个
「没有上下文就没法完成」的提示）
· 提示：「加上我们之前讨论过的规划视图，
与现有 app 和已确立的偏好保持一致」
· 你故意不说 Today / This Week / 日历
· 结果：Cursor 直接回忆起偏好
——要「按截止日期分 Today/This Week 的列表」，
而不是日历；还自动加了 Board/Planning 切换
结论：三次切换，零次重新解释项目背景。💡 测试的巧妙处：第三棒的提示词故意「依赖记忆才能完成」——如果 Cursor 不知道之前的偏好，它大概率会做一个日历视图。记忆检索命中，才是真·共享记忆。
Step 4：记忆的取舍——不是越多越好
4 检索式取用 vs 全量倾倒
AgentMemory 的机制是「检索具体记忆」，
不是把整个项目历史塞进每个新会话：
· 需要时按相关性取回
· 与任务无关的历史不进上下文
为什么这很重要：
· 记忆占据模型的上下文窗口
· 塞太多无关历史 = 浪费 token + 干扰判断
· 「多给」不是「给对」
取舍原则：
· 保留：架构决策、用户偏好、踩坑教训
· 丢弃：一次性的中间过程、无关对话
对比传统做法：
· CLAUDE.md / .cursor/rules / AGENTS.md
——静态规则文件，每次全量加载
· AgentMemory ——动态记忆，按需检索
两者互补：规则文件写「该怎么做」，
共享记忆存「已经决定了什么」。隐私边界：共享记忆会捕获你的提示词和决策——别在记忆服务器里出现密钥、Token、客户机密。AgentMemory 是本地服务器，但接入它的每个 Agent 都能读到记忆，按「最小必要」原则写入。
Step 5：进阶用法——让交接更专业
5 记忆 + 规则文件 + 交接文档的组合拳
| 工具 | 管什么 | 何时用 |
|---|---|---|
| CLAUDE.md / AGENTS.md | 构建命令、测试方式、代码约定 | 每个会话自动加载 |
| AgentMemory | 架构决策、用户偏好、历史上下文 | 切换 Agent 时按需检索 |
| 交接文档（HANDOFF.md） | 当前任务进度、下一步待办 | 长任务跨天交接时 |
最佳实践：规则文件定规矩，共享记忆存历史，交接文档讲进度——三层各司其职。每次切换 Agent 前更新交接文档，配合共享记忆，基本可以消灭「重新解释项目」这类重复劳动。
Step 6：落地清单与注意点
6 什么时候该上、什么时候先等等
适合上 AgentMemory 的场景：
· 常年在 2 个以上编码 Agent 间切换
· 项目横跨多天、多会话、多人协作
· 被「重新解释背景」反复折磨
先等等的场景：
· 只用单一工具（单工具用 CLAUDE.md 就够）
· 项目极短、一次会话能完成
· 对记忆隐私敏感且无法隔离
落地四步：
1. 装好 + 连 2 个工具跑一周
2. 观察 localhost:3113 里积累了哪些记忆
——如果记的都是噪音，调整捕获范围
3. 挑一个真实项目做「接力测试」
（参考 Step 3 的三棒设计）
4. 把「切换前更新 HANDOFF.md」固化成习惯
一句话总结：工具解决「记不记得住」，
习惯解决「用不用得上」——
共享记忆只对会交接的人生效。🎉 价值上限：项目越大、切换越频繁，共享记忆的复利越明显——今天的决策会变成明天另一个 Agent 的起点。先跑一周看数据，再决定要不要全面接入。