在 Claude Code 里跑到一半，想换个 Agent 接着做，上下文怎么带过去？

一句话答案：Claude Code、Codex 这些 CLI 的会话是各存各的，换工具时聊天记录不会自动跟过去。可靠的做法是把上下文放进仓库：一份交接文档（HANDOFF.md）、一份两边都读的规则文件（AGENTS.md / CLAUDE.md），再加一个 git 检查点。

换个 Agent 接着做，为什么上下文会断？

各家 CLI 都把会话存在自己的目录里，互相不读。新开的 Agent 只看得到磁盘上的代码，看不到「前面试过什么、哪条路走不通、你最后说了什么」。代码其实没丢，丢的是决策和进度。

思路：把「代码」和「对话」分开处理。代码靠 git 保住；对话里真正有用的部分（目标、做到哪、踩过的坑），写成仓库里的文件。

不想复制粘贴一大坨，有没有靠谱的交接办法？

最稳的是让正在干活的那个 Agent 自己写交接文档，下一个 Agent 先读它，再看代码。

做法（不依赖任何工具）：

1. 换之前让当前 Agent 写 HANDOFF.md，包括：目标、改了哪些文件、做到哪、没做完的、验收标准、试过但失败的方案、下一步。最后加一句「写完就停，不要继续写代码」，免得交接文档和代码对不上。
2. 长期规则（代码风格、禁改目录、测试命令）放在 AGENTS.md。Codex 原生读这个文件；Claude Code 侧可以在 CLAUDE.md 里引用它，让两边看到同一份规则。
3. 新 Agent 的第一句话：「先读 AGENTS.md 和 HANDOFF.md，再看 git status / git diff，以仓库实际状态为准，复述一遍理解后再动手。」
4. 每次切换都重写 HANDOFF.md，不要一直往后追加。过期的交接文档比没有还糟。
5. Claude Code 还可以用 /export 把当前对话导出成文本，作为附件给下一个 Agent 参考。

一个可以直接复制的 HANDOFF.md 骨架：

# HANDOFF
- 目标：
- 当前分支 / HEAD：
- 已完成（文件 + 一句话）：
- 未完成：
- 验收标准 / 测试命令：
- 试过但失败的方案（别再试）：
- 下一步：

换之前，代码要先做什么保护？

先留一个 git 检查点，让下一个 Agent 读的是确定的状态，而不是你脑子里的记忆。

做法：

• 在自己的工作分支上 git add -A && git commit -m "wip: 交接检查点"；不想留提交就用 git stash。
• 交接文档里写上当前分支名和 HEAD，新 Agent 先核对再开始。
• 两个 Agent 不要同时改同一份工作目录；需要并行就各用一个 git worktree 或分支：git worktree add ../task-b -b task-b。

换了 Agent 之后，怎么确认它没把前面的活做歪？

不管谁接手，最后都看 Diff 再决定，不要只看 Agent 自己写的总结。

做法：git diff main...你的分支 看这条线上的全部改动；先跑测试，再逐个文件看有没有没要求的改动；交接文档里写明「不要重做的部分」，防止新 Agent 推倒重来。

常见问答

• Claude Code 和 Codex 能直接共享一个会话吗？ 原生不行，会话各存各的，只能靠文件和 git 交接。
• 交接文档要提交进仓库吗？ 自己的分支可以提交；共享仓库建议写进 .git/info/exclude，免得混进 PR。
• /export 导出的对话够用吗？ 当参考可以，但很长、夹杂试错过程，新 Agent 容易被带偏。优先给精简的 HANDOFF.md。
• AGENTS.md 和 CLAUDE.md 要各写一份吗？ 不用。规则写在 AGENTS.md，CLAUDE.md 里引用它即可，避免两份规则不一致。

边界说明

• 交接文档是「二手信息」，新 Agent 不知道的细节仍可能丢；关键决策尽量写成代码注释或测试。
• 不同 Agent 对同一份规则的遵守程度不一样，接手后的风格和质量不保证一致。
• 以上做法解决的是「接力」，不能让两个同时运行的 Agent 实时共享上下文。

有没有不用手动交接的办法？

如果不想每次手写交接文档，也有桌面工具把多个编码 Agent 放进同一个任务界面，比如 Caravel（免费使用，支持 macOS / Windows）：在同一个任务里把下一轮换成另一个 Agent，之前的对话会一起带过去。用法见手册：https://caravel-site.pages.dev/zh-CN/docs/chat/