为什么您的 Codex 上下文不会跟随您到 Claude Code
每个工具存储的内容
Codex 在启动时读取 AGENTS.md,并将其他所有内容(打开的文件、达成的决策、进行中的计划)保留在其上下文窗口中,并在该窗口填满时进行压缩。Claude Code 的工作方式类似:启动时读取 CLAUDE.md,其他所有内容都保留在会话上下文中。静态指令文件有直接的对应关系。而动态理解在两者中都没有归宿,这就是为什么它们无法互相传递的原因。
无法传输的技术原因
AGENTS.md 和 CLAUDE.md 只是 Markdown 文件,因此这部分只需复制并调整。但会话状态在设计上是瞬态的:Codex 会在执行长任务时将其压缩,并在会话结束时丢弃,因此即使 Claude Code 有导入工具,也没有任何内容可以导出。您并不是在迁移智能体的记忆——您是在迁移一个配置文件,然后手动重建记忆。
这给您带来的代价
您必须在一个第一个智能体已经理解的代码库上重新引导第二个智能体:相同的规范、相同的架构演练、相同的修正。Codex 学到的、但未写入 AGENTS.md 的所有内容都消失了。而且您又回到了起点:Claude Code 在会话之间也是无状态的,所以明天它也会轻装上阵——您只是更换了工具,却没有改变底层问题。
分步指南:手动从 Codex 迁移到 Claude Code
原生途径是手动的,但它能传递核心要素。
步骤 1:提取 Codex 保留的内容
- 复制您的
AGENTS.md——即智能体遵循的规范、命令和约束。 - 回顾最近的 Codex 会话,写下那些从未写入文件的决策和约束:被否决的方法、架构选择、已知陷阱。
- 记录您的 Codex 配置所依赖的 MCP 服务器和工具。
步骤 2:设置 Claude Code
- 在仓库根目录下创建或更新
CLAUDE.md,根据AGENTS.md调整您的规范。 - 将挽救的决策和约束添加到
CLAUDE.md或 Claude Code 在启动时会读取的文档文件中。 - 将您的 MCP 服务器重新添加到 Claude Code 的 MCP 配置中。
您得到的是一个转换后的基线:一个配置文件加上您记得挽救的任何上下文。这里没有会话历史记录的传输,而且如果您保留 Codex 进行部分工作,这里的任何内容都不会保持同步。
迁移中无法保留的内容
从未写入文件的会话级项目理解。过去修复背后的推理。以及持久性问题本身:两个智能体都会进行压缩和丢弃,因此您手动维护的文件是两者唯一能可靠启动的依据——除非您在两者中添加一个超越会话生命周期的层。
更好的方法:统一的记忆层,适用于任何智能体
迁移之所以痛苦,只是因为每个智能体的知识都消亡在它内部。将项目知识放在一个中立的层中,切换就变成了一种连接。MemoryLake 一次性存储您的架构、决策和规范——可搜索、Git 风格的版本控制、端到端加密——并通过 MCP 将它们提供给 Claude Code 和 Codex,因此两者都不会空白启动,切换成本为零。
| 维度 | 手动 Codex → Claude Code | MemoryLake 层 |
|---|---|---|
| 所需步骤 | 手动转换配置 + 挽救 | 3 步(一次性) |
| 会话级理解 | 基本丢失 | 保留且可搜索 |
| 在压缩中幸存 | 否 | 是(按需检索) |
| 在渐进式切换期间保持同步 | 否 | 是 |
| 决策历史 | 无 | 是(Git 风格) |
| 以后切换或添加智能体 | 重新转换 | 直接连接 |
步骤 1:创建 API 密钥
登录 MemoryLake,生成密钥并发送您的第一个请求——大约需要 30 秒。

步骤 2:上传您的第一批记忆
放入两个智能体都需要项目知识:架构说明、决策记录、规范和 API 文档——文档、图像和其他文件都可以——而不是将它们困在一个工具的配置文件中。

步骤 3:连接您的 AI 和智能体
两个智能体都支持 MCP:使用您的 API 密钥将 MemoryLake 添加到 Claude Code 和 Codex 的 MCP 配置中。在渐进式切换期间,两者都不会落后,并且相同的记忆可以传递给 OpenClaw 和其他支持 MCP 的智能体——因此您的下一个工具只需连接,无需重新开始。

重新引导智能体的实际成本
支付两次的“切换税”
迁移智能体意味着要向其重新传授前一个智能体已经了解的代码库——然后还要支付其日常版本,因为新智能体在每个会话中也会重新探索您的仓库。在按使用量计费的工具中,这种重新探索是在开始任何工作之前就消耗的 token。
检索代替重新引导
通过共享层,Claude Code 可以按需拉取您的规范和决策,而不是重新构建它们,因此它在第一天就能掌握情况,并在压缩后保持知情。更快的启动、更少的重复修正、更低的支出——MemoryLake 的 Token 节省计算器(Token Saving Calculator)可以根据您的使用情况预测效果。
跨智能体记忆的最佳实践
在切换前进行挽救
Codex 保留的会话知识是在切换时会消失的部分。先将其捕获到共享层中,迁移就不会丢失任何内容。
将规范保留在仓库中,决策保留在记忆层中
CLAUDE.md 和 AGENTS.md 是每个工具在启动时读取的稳定规范的理想归宿。而带有日期的决策、被否决的方法和已解决的问题则属于可检索的记忆,压缩无法丢弃它们。
按仓库划分范围
每个仓库一个记忆范围可以保持两个智能体的上下文精确,并防止一个项目的规范泄露到另一个项目中。
结论
从 Codex 迁移到 Claude Code 是一个配置转换加上您手动重建的记忆——如果您止步于此,您只是转移了问题,而没有解决它,因为新智能体在会话之间也会像旧智能体一样遗忘。将您的项目知识放在两个智能体都能读取的层中,切换就变成了一种连接:第一天就能获得知情的会话、在压缩中幸存的决策,并且在您下次更换工具时无需重新传授。迁移配置,保留记忆。