在 Claude Code 与 Codex 之间换手，最容易丢的不是代码，是上下文。Alek Perak（TokenRip 创始人，原文已披露这一身份，文中有一节介绍自家产品）把交接要带的东西归成三样：规则、状态、决定。规则管几周不变的事，状态是“做到哪了、什么失败了”，决定是“代码背后的理由”。丢规则，智能体犯风格错误；丢状态，它重做已做过的事、重跑已炸过的命令；丢决定，它会把你故意写成的样子“修掉”。
规则：一份 AGENTS.md，两个智能体都读
把项目规则放进一份 AGENTS.md：测试怎么跑、哪些目录禁入、构建命令、命名约定。Codex 默认读它（用户级 ~/.codex，再从仓库根目录一路读到工作目录，上限 32 KiB，除非调高）；Claude Code 在没有 CLAUDE.md 时也会用 AGENTS.md，已有 CLAUDE.md 时在首行加 @AGENTS.md 导入共享文件、Claude 专属内容放下面。改一次规则，两个智能体下次会话都生效。注意别把它写臃肿：每次会话都加载，臃肿的代价是每个会话的上下文。
状态：停手前写一份短交接，失败必须写进去
让要停的智能体在停之前写交接，短而全：动了哪些文件、各改了什么；剩余工作按顺序列；失败了什么，包括不要重跑的命令；本次做的决定、各附一句话理由；接手前要先核查什么。然后让接手的智能体先读交接、再动手。好习惯四条：限 40 行逼它取舍；明确要失败——智能体默认只报成功，死胡同才最值钱；标日期，否则分不清是今早还是上周二的；两个智能体别同时写同一份 HANDOFF.md，会打架，各写各的，或上能处理并发写入的工具。
决定：放进版本库，或一个共享工作区
决定比任务活得久（“为什么用队列不用 cron”几个月后还重要），交接文件装不下。两条路：仓库里一事一文件的简短决定记录，随代码一起版本化；或一个共享工作区，决定置顶、每个智能体开工就读。文件法在偶尔切换时够用；每天都切换、并行跑、或工作溢出到仓库外（如聊天应用里的调研）时，就该看专用工具：DMN（把笔记存为 .dmn/memories 下的 markdown，免费）、Reinstate（把会话封存、一台电脑续到另一台，Apache-2.0 开源）、Concord MCP（智能体间经一个 MCP 服务器互发消息、认领文件、交接任务，MIT 开源），以及作者自家的 TokenRip（1 GB 免费，之后每月 20 美元起）。
今天就能开始的四步
- 今天下午写一份 AGENTS.md：测试、构建与风格规则；
- CLAUDE.md 首行加
@AGENTS.md（如果已有）； - 每次切换前，要一份含失败的短交接；
- 真正的决定各自成文件、随代码版本化。
常见问答：Codex 默认读 AGENTS.md，不读 CLAUDE.md，共享规则放 AGENTS.md；一份好的交接包括动过的文件、剩余工作、失败、带一句话理由的决定、接手前要核查的事，保持简短并标日期；同一分支上两个智能体可以并行，但别共用一份交接文件。
相关：站内今日两篇 Claude Code 实测教程——《5 个现成 Claude Code 技能照着抄》与《Claude Code 上网了：浏览器里接 GitHub 就能跑云端任务》。
来源：Medium @Alek Perak，原文：https://medium.com/@alek_65555/the-claude-code-and-codex-handoff-checklist-05bb12dd57ea
没有回复内容