MemoryLake
返回全部文章
Tutorial2026 年 7 月 29 日·6 分钟阅读

如何在不丢失上下文的情况下从 Codex 迁移到 Claude Code (2026)

许多开发者在 7 月份重新审视了 Codex。Codex 中 GPT-5.6 的默认输入上下文被悄然缩减——从大约 372k token 降至 272k token,缩减了约 27%,这是通过 GitHub 配置更改而非官方公告发现的。在长周期的智能体任务中,这意味着压缩(compaction)会更早到来,并带走您的需求。如果您正在转向 Claude Code,您会发现迁移过程大部分是手动的,而且您最怀念的部分根本无法导出。

简而言之:没有从 Codex 导入到 Claude Code 的导入工具。您的 `AGENTS.md` 需要手动转换为 `CLAUDE.md`,但会话级别的理解——智能体与您共同制定的决策、修正和架构——无法导出,因此 Claude Code 在启动时只能从头开始 grep 您的仓库。

本指南将介绍如何将 Codex 配置迁移到 Claude Code、哪些内容无法保留,以及如何在不向第二个智能体重新传授代码库的情况下完成切换。

为什么您的 Codex 上下文不会跟随您到 Claude Code

每个工具存储的内容

Codex 在启动时读取 AGENTS.md,并将其他所有内容(打开的文件、达成的决策、进行中的计划)保留在其上下文窗口中,并在该窗口填满时进行压缩。Claude Code 的工作方式类似:启动时读取 CLAUDE.md,其他所有内容都保留在会话上下文中。静态指令文件有直接的对应关系。而动态理解在两者中都没有归宿,这就是为什么它们无法互相传递的原因。

无法传输的技术原因

AGENTS.mdCLAUDE.md 只是 Markdown 文件,因此这部分只需复制并调整。但会话状态在设计上是瞬态的:Codex 会在执行长任务时将其压缩,并在会话结束时丢弃,因此即使 Claude Code 有导入工具,也没有任何内容可以导出。您并不是在迁移智能体的记忆——您是在迁移一个配置文件,然后手动重建记忆。

这给您带来的代价

您必须在一个第一个智能体已经理解的代码库上重新引导第二个智能体:相同的规范、相同的架构演练、相同的修正。Codex 学到的、但未写入 AGENTS.md 的所有内容都消失了。而且您又回到了起点:Claude Code 在会话之间也是无状态的,所以明天它也会轻装上阵——您只是更换了工具,却没有改变底层问题。

分步指南:手动从 Codex 迁移到 Claude Code

原生途径是手动的,但它能传递核心要素。

步骤 1:提取 Codex 保留的内容

  1. 复制您的 AGENTS.md——即智能体遵循的规范、命令和约束。
  2. 回顾最近的 Codex 会话,写下那些从未写入文件的决策和约束:被否决的方法、架构选择、已知陷阱。
  3. 记录您的 Codex 配置所依赖的 MCP 服务器和工具。

步骤 2:设置 Claude Code

  1. 在仓库根目录下创建或更新 CLAUDE.md,根据 AGENTS.md 调整您的规范。
  2. 将挽救的决策和约束添加到 CLAUDE.md 或 Claude Code 在启动时会读取的文档文件中。
  3. 将您的 MCP 服务器重新添加到 Claude Code 的 MCP 配置中。

您得到的是一个转换后的基线:一个配置文件加上您记得挽救的任何上下文。这里没有会话历史记录的传输,而且如果您保留 Codex 进行部分工作,这里的任何内容都不会保持同步。

迁移中无法保留的内容

从未写入文件的会话级项目理解。过去修复背后的推理。以及持久性问题本身:两个智能体都会进行压缩和丢弃,因此您手动维护的文件是两者唯一能可靠启动的依据——除非您在两者中添加一个超越会话生命周期的层。

更好的方法:统一的记忆层,适用于任何智能体

迁移之所以痛苦,只是因为每个智能体的知识都消亡在它内部。将项目知识放在一个中立的层中,切换就变成了一种连接。MemoryLake 一次性存储您的架构、决策和规范——可搜索、Git 风格的版本控制、端到端加密——并通过 MCP 将它们提供给 Claude Code 和 Codex,因此两者都不会空白启动,切换成本为零。

维度手动 Codex → Claude CodeMemoryLake 层
所需步骤手动转换配置 + 挽救3 步(一次性)
会话级理解基本丢失保留且可搜索
在压缩中幸存是(按需检索)
在渐进式切换期间保持同步
决策历史是(Git 风格)
以后切换或添加智能体重新转换直接连接

步骤 1:创建 API 密钥

登录 MemoryLake,生成密钥并发送您的第一个请求——大约需要 30 秒。

创建 MemoryLake API 密钥
创建 MemoryLake API 密钥

步骤 2:上传您的第一批记忆

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

上传您的第一批记忆到 MemoryLake
上传您的第一批记忆到 MemoryLake

步骤 3:连接您的 AI 和智能体

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

通过 MCP 连接您的 AI 和智能体
通过 MCP 连接您的 AI 和智能体

重新引导智能体的实际成本

支付两次的“切换税”

迁移智能体意味着要向其重新传授前一个智能体已经了解的代码库——然后还要支付其日常版本,因为新智能体在每个会话中也会重新探索您的仓库。在按使用量计费的工具中,这种重新探索是在开始任何工作之前就消耗的 token。

检索代替重新引导

通过共享层,Claude Code 可以按需拉取您的规范和决策,而不是重新构建它们,因此它在第一天就能掌握情况,并在压缩后保持知情。更快的启动、更少的重复修正、更低的支出——MemoryLake 的 Token 节省计算器(Token Saving Calculator)可以根据您的使用情况预测效果。

跨智能体记忆的最佳实践

在切换前进行挽救

Codex 保留的会话知识是在切换时会消失的部分。先将其捕获到共享层中,迁移就不会丢失任何内容。

将规范保留在仓库中,决策保留在记忆层中

CLAUDE.mdAGENTS.md 是每个工具在启动时读取的稳定规范的理想归宿。而带有日期的决策、被否决的方法和已解决的问题则属于可检索的记忆,压缩无法丢弃它们。

按仓库划分范围

每个仓库一个记忆范围可以保持两个智能体的上下文精确,并防止一个项目的规范泄露到另一个项目中。

结论

从 Codex 迁移到 Claude Code 是一个配置转换加上您手动重建的记忆——如果您止步于此,您只是转移了问题,而没有解决它,因为新智能体在会话之间也会像旧智能体一样遗忘。将您的项目知识放在两个智能体都能读取的层中,切换就变成了一种连接:第一天就能获得知情的会话、在压缩中幸存的决策,并且在您下次更换工具时无需重新传授。迁移配置,保留记忆。

常见问题

我可以将我的 Codex 配置导入到 Claude Code 中吗?

不能。AGENTS.md 可以手动转换为 CLAUDE.md,但在这两个工具中,会话状态都是瞬态的——没有任何内容可以导出,而且 Claude Code 也没有针对 Codex 上下文的导入工具。

仅将 AGENTS.md 转换为 CLAUDE.md 就足够了吗?

它迁移了静态规范,这是简单的部分。决策、被否决的方法以及在会话期间建立的项目理解从未存在于该文件中,因此它们需要被挽救或使用共享记忆层。

为什么我的 Codex 上下文在 2026 年 7 月变差了?

开发者记录了 Codex 中 GPT-5.6 默认配置的输入上下文的减少——从大约 372k 降至 272k token——这是通过 GitHub 配置更改显现出来的。更少的空间意味着在长任务中更早触发压缩,从而更早地丢弃需求和决策。

切换后 Claude Code 会记住我的项目吗?

它自己不会。It 在启动时读取 CLAUDE.md,并在每个会话中从您的仓库重建其余部分——请参阅为什么 Claude Code 会遗忘项目上下文。持久层才是让会话在启动时就掌握情况的关键。

我可以并排运行 Codex 和 Claude Code 吗?

可以,而且这是更平滑的途径。通过 MCP 上的共享记忆,两者都能保持最新状态,因此您可以逐渐转移工作,而不是直接切断——并在同等基础上进行比较。相关内容:为 Claude Code 添加记忆