OpenAI Codex 推出“一键迁移”：无缝接管 Claude Code 与 Cursor 配置，零摩擦切换 AI 编程助手

在 AI 编程助手领域，切换工具往往意味着痛苦的重新配置：丢失精心调优的规则、重新安装技能包、重建 MCP 连接，甚至遗失重要的历史会话上下文。OpenAI 最新推出的 “Migrate to Codex” 功能，旨在彻底解决这一痛点。

• 文档：https://developers.openai.com/codex/migrate

通过智能扫描与 Agent 辅助，Codex 现在可以一键导入来自 Claude Code、Cursor 等其他主流编程工具的完整配置，包括指令、技能、MCP 服务器、钩子、子代理以及最近 30 天的会话记录。这不仅是一次数据搬运，更是一次智能化的工作流平移。

核心亮点：智能映射 + Agent 兜底

1. 全量配置智能映射

Codex 能够自动识别并转换其他工具的配置文件格式，确保你的习惯得以保留：

• 指令文件：自动迁移至 AGENTS.md，保持对 Agent 行为的约束。
• 设置文件：将 settings.json 等格式转换为 Codex 原生的 config.toml。
• 技能与命令：斜杠命令（Slash Commands）和技能（Skills）自动映射到 Codex 技能系统。
• 扩展集成：MCP 服务器配置、Hooks（钩子）及子代理（Subagents）均有对应入口，无需手动重写。

2. Agent 辅助处理复杂迁移

对于无法简单一对一映射的配置（如自定义脚本、特定插件逻辑），Codex 不会直接丢弃，而是启动一个专用的迁移线程：

• 自动识别剩余项：扫描出需要人工干预或复杂转换的内容。
• Agent 介入处理：在新线程中，Codex Agent 会协助你逐步完成这些剩余配置的迁移，提供指导甚至直接生成代码。
• 分类清晰：将用户级设置与项目级设置分开展示，便于逐项审查。

3. 用户级与项目级双重覆盖

• 用户级设置：扫描本地全局配置文件，迁移通用偏好、全局技能和 MCP 连接。
• 项目级设置：扫描当前仓库中的配置文件，确保特定项目的规则、环境和依赖也能无缝过渡。

4. 历史会话保留

• 最近 30 天会话：自动导入近期的对话历史，让你在新环境中也能快速回顾之前的思路和上下文，避免“断片”。

迁移步骤：五步轻松切换

1. 打开设置：启动 Codex App，进入 Settings。
2. 找到入口：在 General 页面， locate “Import other agent setup”。
3. 开始导入：点击 Import（首次）或 Import again（重复操作）。
4. 选择内容：Codex 会自动检测可用配置，勾选你希望迁移的项目（如技能、MCP、会话等）。
5. 审查结果：导入完成后，点击 View imported files 检查文件结构和内容是否正确。

💡 提示：如果存在无法自动迁移的内容，Codex 会提示你 “Continue in Codex”，点击即可进入专用线程由 Agent 协助处理。

迁移后必查清单

虽然自动化程度很高，但为了确保安全性和稳定性，建议在正式使用前审查以下内容：

• 权限与安全：检查导入的技能和代理中的工具限制、权限设置是否符合预期。
• MCP 配置：验证使用自定义身份验证、Header、环境变量或特殊传输方式的 MCP 服务器连接是否正常。
• Hooks 行为：确认钩子在 Codex 环境下的触发条件和执行逻辑是否与旧工具一致。
• 路径与变量：检查依赖 shell 插值、文件路径占位符或特定参数的提示模板，确保在新环境中能正确解析。
• 插件兼容性：某些特定于旧工具的插件可能需要手动寻找 Codex 等效替代方案。

为什么这很重要？

• 降低切换门槛：让开发者可以无负担地尝试新工具，不再被“配置地狱”劝退。
• 保护资产积累：你花费时间调试的技能、编写的规则和积累的会话历史，都是宝贵的数字资产，Codex 确保它们不被浪费。
• 加速团队 adoption：对于团队而言，统一迁移配置可以大幅缩短全员上手新工具的时间，提升协作效率。