Codex 的导入工具现在涵盖了什么
Claude Code 配置,几乎是全盘接收
最初的目标是 Claude Code,且范围非常广泛。Codex 的文档描述了可以导入指令文件、config.toml 和 settings.json、技能和插件、MCP 服务器配置、项目文件夹和记忆、钩子(hooks)和斜杠命令、子智能体(subagents)以及过去 30 天内的聊天记录。在 CLI 中运行 /import,或使用桌面应用的导入流程即可。
在尝试之前,有一些限制值得了解:当任务正在运行、处于远程会话中或连接到本地应用服务器守护进程时,导入不可用,并且某些插件在导入后需要重新授权。
截至 8 月 7 日的 Cursor 管理的技能
这是全新的部分。发布说明只有一句话,而背后合并的工作指明了其机制:标题为“将 Cursor 管理的技能迁移到 Codex”、“分别解析 Claude 和 Cursor 会话记录”以及“在导入外部会话时保留工作目录”的拉取请求(PR)。
读到最后一个,您就能明白他们正在解决什么问题。导入会话不仅仅是导入文本——会话在目录中是有意义的,如果导入丢失了目录,就会产生一个您可以阅读但无法有效恢复使用的记录。
保持最新状态而非重复的对话
发布说明的后半部分更有意思:“在不创建重复副本的情况下同步对已导入 Claude 和 Cursor 对话的更改”,实现为“同步对已导入外部智能体会话的更新”。
在此之前,导入只是一个快照。再次导入就会得到第二个副本。现在,重新导入会与您已经导入的内容进行对齐。如果您在迁移期间并行运行两个工具(大多数人会这样做一两周),这就是“紧张地导入一次”与“可以重复导入”之间的区别。
不过,请注意其中的含义。同步意味着另一个工具仍然是该数据的权威来源。这是您同时使用两者期间的桥梁,而不是所有权的转移。
导入的聊天是什么,以及它不是什么
聊天导入有明确记录的限制:过去 30 天,上限为 50 个对话。这是一个刻意设计的范围,它告诉您这个功能是为什么服务的——在您切换时提供连续性,而不是归档。
我们需要清醒地认识到这 50 个对话的价值。对话记录是一个过程的记录,其中大部分内容在走向正确之前都是错误的。导入的聊天为您提供了可搜索的近期历史记录,以及继续周五放弃的思路的能力。但它们无法为您提供一套结论,因为没有人将结论与探索过程分离开来。如果某个决策发生在其中一个聊天中,导入该聊天并不等同于记录该决策,稍后阅读它的智能体将对被拒绝的方法和最终的方法给予几乎相同的权重。
以及一个未曾改变的界限
导入工具的文档仍然明确写着:“标准的 Claude 聊天数据无法导入。” ChatGPT 数据也无法导入。这种不对称性让人感到惊讶——OpenAI 自己的 CLI 可以通过一个命令导入竞争对手的开发者工具,却不会导入任何一家厂商的消费级应用。
这是一个连贯的决定,而不是疏忽:/import 是一个开发者配置工具,而来自消费级产品的聊天历史记录不属于开发者配置。这只意味着您的助手在聊天应用中建立的记忆仍然需要手动迁移,这属于它自己的迁移工作。
人们的尝试与误区
等待导入工具覆盖所有内容。 这可以理解,但它不会发生,因为差距不在于缺少功能。Cursor 或 Claude Code 中没有任何文件记录了您约定背后的原因;没有人写下来。导入工具只能移动存在的东西。
导入并假设完全等效。 这是最常见的失望来源。您的规则导入了,您的技能导入了,您的 MCP 服务器也导入了——但新的智能体仍然会提出您团队在上个季度拒绝的方法。传输过程中没有丢失任何东西;那些知识从未存在于文件中。
手动将规则复制到 `AGENTS.md` 中。 对于您关心的部分,这仍然是正确的直觉,而且这本来也是导入工具放置您内容的地方。Codex 解析 AGENTS.md 的顺序是从 ~/.codex/AGENTS.md(或 $CODEX_HOME)到仓库根目录,再到中间目录,最后到您的工作目录,最接近的文件具有最高优先级。按位置归档是保持范围完整的方法。
开启 Codex 记忆并认为大功告成。 值得一做,但这不是记录。Codex 记忆默认是关闭的,可以在“设置”中的“个性化”下启用,或者使用 [features] memories = true 启用。它们保存生成的状态——源自您聊天的摘要和持久条目——存储在 ~/.codex/memories/ 中,是全局的而非针对每个项目的,并且是该机器本地的。
永远同时打开这两个工具。 这是一个坦诚的权宜之计,而且由于重新导入可以同步,现在得到了更好的支持。但这也意味着您要维护两套存在分歧的标准,并在评审时才发现它们在哪里产生了分歧。
这种模式表明:每种权宜之计都能很好地管理配置,但对知识的管理却很糟糕。
解决方法:将知识保留在两个工具的配置之外
将您要移动的内容分成两堆,因为它们有不同的归宿。
配置应该存在于工具中,现在导入工具可以处理它。 规则、技能、MCP 服务器、钩子、命令、子智能体——让 /import 来做这件事,然后进行修剪。迁移是有人用全新的眼光审视每条规则的唯一时刻,因此请删除陈旧的内容,而不是将其带过去。
知识应该存在于这两个工具之外。 约束背后的原因、产生该约束的事件、您拒绝的替代方案、客户的需求、架构决策及其日期。这些都不属于厂商的配置目录,因为这会让每次工具更换都变成一次“考古挖掘”。
MemoryLake 是针对第二堆内容的记忆层——将决策、约束和源文档保存在一个存储库中,可直接从支持 MCP 的工具(如 Claude 和 Codex)中读取,也可通过 API 从 ChatGPT 中读取。这样,导入工具只需移动设置,而这正是它真正擅长的部分。
步骤 1:创建 API 密钥
在大约 30 秒内生成密钥并发送您的第一个请求。将其保存在您的环境变量或机密管理器中,而不是粘贴到会话中。

步骤 2:上传您的第一批记忆
放入您规则背后的文档、图像和文件:ADR(架构决策记录)、事件报告、客户需求、API 契约、大家都同意的 RFC。上传源文件而不是摘要——摘要恰恰是丢失原因的形式。

步骤 3:连接您的 AI 和智能体
通过 MCP 或 API 让 Claude、Codex、OpenClaw 和其他 AI 智能体访问记忆。Codex 和 Claude Code 都支持 MCP,并能直接读取相同的存储。对于 ChatGPT,通过 API 检索您需要的内容,并将其注入到提示词或调用模型的日常工作流中。

这在实践中改变了什么
第一个区别是导入变得平淡无奇,而这正是您对导入所期望的。设置移动了,您进行了修剪,然后就完成了——而不是花上一周时间去发现新智能体不知道的事情。
第二个区别是并行运行不再导致偏差。在任何实际迁移过程中,您都会使用这两个工具,而现在对话可以干净地重新同步。但是,您在一个工具中优化的规则仍然不会传播到另一个工具。当约束存在于共享存储中时,两个智能体都会读取相同的当前版本,而您不断重复解释的上下文将不再存在两个版本。
第三个区别是离开一个工具不再意味着同步的终止。同步是两个厂商存储之间的桥梁;而共享层是一个不属于任何一家厂商的存储。当您退订旧服务时,其中一个仍然可以继续工作。
并且它能与每个工具的原生记忆协同工作。Codex 记忆在本地不断学习您的习惯;Claude Code 的项目记忆在每个仓库中不断积累构建命令。两者都很有用,且都是机器本地的——这就是为什么您队友需要知道的事情不能只存在于那里,这也是每个智能体分别学习您的项目背后的相同差距。
在编码智能体之间导入的最佳实践
导入,并在当天进行修剪
无论传输过来什么,现在都由您来维护。将每条规则阅读一遍,删除为已不存在的服务编写的规则,并缩短其余规则。Codex 在每个会话中都会将 AGENTS.md 加载到上下文中,因此长度会降低对关键规则的遵循度。
将范围重新表达为目录位置
Cursor 通过激活模式和 glob 模式来表达范围;而 Codex 通过文件所在的位置来表达。仅适用于计费服务的规则应该属于 billing/AGENTS.md,而不是放在带有限定符的根文件中。位置是强制执行的;而限定符只是一种期望。
将导入的对话视为参考,而非记忆
将 30 天的聊天记录迁移过来对保持连续性很有用,但作为知识库却很糟糕——它只是一个对话记录,具有每个对话记录都有的问题。如果这些聊天中的某些内容是一个决策,请在其他地方将其写为决策。
谨慎决定是否启用生成的记忆
Codex 记忆默认关闭是一个合理的默认设置,开启它们也是合理的。只是不要让任何您不愿丢失的内容仅作为单台机器上的生成状态存在,并记住它是全局的而非针对每个项目的,因此它会混淆您工作中的上下文。
在您仍有访问权限时进行手动导出
任何存在于 Web 应用中而不是文件中的内容——消费级聊天应用的记忆、托管智能体的笔记——都必须手动复制出来,而且只能在您还在付费时进行。这是唯一有截止日期的一步;迁移的其他部分稍后都可以重新进行。
结论
8 月 7 日的版本使 Codex 的导入工具得到了显著提升:Cursor 管理的技能现在可以传输过来,并且之前导入的 Claude 和 Cursor 对话可以重新同步而不是重复。如果手动重建是您不切换的原因,那么这个原因基本上已经不复存在了。
没有改变的是界限的形态。导入工具移动配置和对话记录;标准的 Claude 聊天数据仍然根本无法导入;而您约定背后的推理从未存在于要导入的文件中。因此,使用导入工具来迁移设置,修剪导入的内容,并将持久的材料——决策、约束、事件、客户需求——保存在不属于这两个工具的存储库中。这样,下一次的发布说明对您来说只是一个便利,而不是一次拯救。