OpenAI Codex 迁移页解决的是“怎么把另一个 agent 的设置搬到 Codex”这个问题，适合要迁移 instructions、配置、skills、MCP servers、hooks、subagents 和最近 30 天会话的用户。导入后先检查已识别项和剩余项；如果有不能一对一映射的内容，Codex 会提示继续到新线程处理。
OpenAI Codex 迁移到 Codex 教程
开始迁移
- 打开 Codex app 里的 Settings。
- 在 General 页面找到 Import other agent setup。
- 选择 Import 或 Import again。
- 查看 Codex 找到的内容，勾选要带入的项目，然后选择 Import。
- 导入完成后，如果要检查结果，选择 View imported files。
迁移是怎么工作的
Codex 会同时检查你的用户级设置和当前项目。
- 用户级设置来自你机器上的文件。
- 项目级设置来自你当前打开的 repository 里的文件。
导入时，Codex 会：
- 识别它能找到的设置。
- 导入你选中的、可以直接迁移的项目。
- 在导入结束后再次检查。
- 如果还有剩余工作，会提供在新线程里继续迁移。
Codex 能导入什么
| 检测到的设置 | Codex 目标位置 |
|---|---|
| Instruction files | AGENTS.md |
settings.json |
config.toml |
| Skills | Codex skills |
| 最近 30 天内的会话 | Codex threads 和 projects |
| MCP server configuration | Codex MCP configuration |
| Hooks | Codex hooks |
| Slash commands | Codex skills |
| Subagents | Codex agents |
剩余设置怎么在新线程里完成
有些检测到的设置不能和 Codex 做到一一对应。遇到这种情况，Codex 可以用 migrate-to-codex skill 开一个新线程，帮助继续完成迁移。
这时 Codex 会显示剩余设置，并提供 Continue in Codex。
如果继续，Codex 会直接打开一个新线程，把未完成的工作预填进去。这个线程会把用户级设置和项目级设置分开，方便你判断每一项应该放在哪一边。
导入后要检查什么
导入完成后，先复查再依赖它，尤其要看这些内容：
- 导入的 skills 和 agents 里，工具限制或权限是否符合预期。
- 使用自定义认证、headers、环境变量或 transports 的 MCP server 设置。
- 行为可能和 Codex 不同的 hooks。
- 仍需手动补齐的 plugins、marketplaces 或其他设置。
- 依赖参数、shell interpolation 或文件路径占位符的 prompt templates、command-style prompts。
切换到 Codex 之后
导入完成后，打开一个已经迁移好的 project，继续从那里开始。如果你刚开始使用 Codex，可以接着看 quickstart 完成后续设置。
常见问题
OpenAI Codex 能导入哪些其他 agent 的设置？
Codex 支持导入 instruction files、settings.json、skills、最近 30 天内的会话、MCP server configuration、hooks、slash commands 和 subagents。不是所有内容都能直接一对一映射，剩余部分可能需要在新线程里继续处理。
导入后为什么还会提示继续迁移？
如果 Codex 发现某些设置没有清晰的一一对应关系，就会把这些剩余项放到新线程里，用 migrate-to-codex skill 继续处理。这样你能看到哪些属于用户级设置，哪些属于项目级设置。
导入后要重点检查哪些风险项？
重点看工具权限、MCP server 的认证和 headers、hooks 行为差异，以及依赖 shell interpolation、文件路径占位符的 prompt templates。遇到这些项，建议先复查再在项目里正式使用。