OpenAI 这次迁移工具不玩虚的,自动扫描两层级配置还能手动兜底,不过 slash commands 被吞进 Skills 的设计值得注意,切换前先把这条看清楚。
OpenAI 为 Codex 发布官方迁移方案,支持从其他 AI Coding Agents 一键导入指令、配置、技能、近30天会话等资产。迁移采用“自动迁移+残留兜底”设计:通过用户级和项目级双层扫描,执行检测、迁移、回检的四步循环;自动处理可识别配置后,对剩余部分使用 `migrate-to-codex` skill 手动处理。需注意 Slash commands 被归入 Skills 体系,且会话历史仅限30天。迁移完成后,必须人工复核工具权限、MCP服务器认证、Hooks行为差异等五类内容,因平台间语义或实现差异可能影响功能。
【OpenAI Codex 官方迁移指南】 从其他 AI Coding Agents 迁移到 Codex,把你的"Agent 资产"(指令、配置、技能、会话历史等等)一键搬过来! https://developers.openai.com/codex/migrate
迁移入口 Codex App → Settings → General → "Import other agent setup" → Import
迁移机制(关键设计) Codex 在两个层级同时扫描: · 用户级:本机上的全局配置文件 · 项目级:当前打开仓库内的配置文件
执行流程是一个带回检的四步循环: · 检测可识别的配置 · 直接迁移可处理的部分 · 迁移后再次检测 · 对剩余无法自动迁移的内容,另开一个新线程协助手动完成
这种"自动 + 残留兜底"的设计是文档最值得注意的地方--它承认不是所有概念都能 1:1 映射。
可直接迁移的对象映射表 指令文件(如 CLAUDE.md)-> AGENTS.md settings.json -> config.toml Skills -> Codex Skills 近 30 天会话 -> Codex threads / projects MCP 服务器配置 -> Codex MCP 配置 Hooks -> Codex Hooks Slash commands -> Codex Skills Subagents -> Codex agents
两个值得留意的设计取舍: · Slash commands 被归并到 Skills--Codex 不维护独立的斜杠命令体系,而是统一用 Skills 表达。 · 会话有 30 天窗口限制,更早的历史不会被带过来。
残留迁移的兜底机制 无法干净映射的内容,Codex 会用一个名为 migrate-to-codex 的官方 skill 在新线程里继续处理,并且用户级与项目级的剩余项分开列出,便于判断归属。
迁移后必须人工复核的五类内容 1. Skills 与 agents 中的工具权限和限制 -- 权限模型在不同智能体间语义不同,容易宽松化或失效 2. MCP 服务器的自定义认证、headers、环境变量、传输协议 -- 这些通常无法自动搬运 3. Hooks 行为差异 -- 触发时机和上下文未必一致 4. Plugins、marketplaces 等无对应概念的设置 5. 依赖参数、shell 插值、文件路径占位符的 prompt 模板或命令式提示