meng shao@shao__meng · XOpenAI 这次迁移工具不玩虚的，自动扫描两层级配置还能手动兜底，不过 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 模板或命令式提示