OpenAI Codex 迁移指南：从其他 AI 编程工具无缝切换

OpenAI Codex 近期推出了迁移功能，允许开发者从 Claude Code、Cursor 等 AI 编程工具无缝切换到 Codex 平台。该功能支持一键导入指令文件、配置、Skills、MCP 服务器、Hooks、子代理和最近会话等几乎所有自定义设置，大幅降低了切换成本。

开始迁移

迁移操作非常简单，只需几个步骤：

1. 打开 Codex 应用的 Settings
2. 在 General 页面找到 Import other agent setup
3. 点击 Import 或 Import again
4. 检查 Codex 检测到的内容，选择要导入的项，然后点击 Import
5. 导入完成后，可以点击 View imported files 查看结果

迁移工作原理

Codex 会同时检查你的用户级别设置和当前项目配置。用户级别的配置来自本机上的文件，项目级别的配置来自你打开的仓库中的文件。

导入过程分为四个阶段：

1. 检测 — 自动扫描可识别的设置文件
2. 直接导入 — 将选中的项目迁移到 Codex 对应的配置中
3. 二次检查 — 导入完成后再次扫描是否还有遗漏
4. 跟进线程 — 对于无法直接映射的项目，Codex 会开一个新的线程来帮助完成迁移

支持导入的内容

Codex 支持从其他代理导入以下配置：

可以看到，Codex 对主流 AI 编程工具的配置格式做了完整的兼容映射。特别是 Skills、Hooks、MCP 服务器这些核心自定义能力，都能直接迁移。

无法直接映射的设置处理

有些检测到的配置无法找到一对一的映射关系。对于这些项目，Codex 会使用内置的 migrate-to-codex 技能打开一个新的线程来帮助完成迁移。

当你看到 Continue in Codex 的提示时，点击后会打开一个新的线程，其中已经预填了剩余的迁移工作。线程会将用户级别和项目级别的设置分开显示，方便你了解每个待处理项的归属范围。

导入后的检查清单

导入完成后，建议仔细检查以下内容：

• 工具限制和权限 — 导入的 Skills 和 Agents 中的权限设置是否正确
• MCP 服务器设置 — 使用自定义认证、请求头、环境变量或传输方式的 MCP 配置
• Hooks 行为 — Hooks 在 Codex 中的行为可能与原工具有差异
• 插件和市场 — 需要手动跟进的剩余设置
• Prompt 模板 — 依赖参数、Shell 变量插值或文件路径占位符的命令式提示词

切换后的下一步

导入完成后，打开迁移过来的项目即可继续工作。如果你是 Codex 新用户，建议阅读官方的快速入门指南完成剩余的设置流程。

---

总的来说，Codex 的迁移功能覆盖了从指令文件到子代理的八大类配置，配合后续的跟进线程，基本可以做到"零配置"切换。对于正在考虑从 Claude Code 或 Cursor 迁移到 Codex 的开发者来说，这是一个非常实用的功能。