本文为非官方中文翻译，内容以 OpenAI 官方英文文档为准。
官方来源：https://developers.openai.com/codex/migrate
迁移到 Codex
切换到 Codex 时，将你在其他 agent 中的设置一并带过来。
使用导入流程，可将你在另一个 agent 中的指令、配置、skills、MCP servers、hooks、subagents 以及最近的会话导入到 Codex 中。 Codex 会直接迁移它能够处理的部分，并且可以打开一个后续线程， 帮助迁移其余尚未完成的内容。
开始迁移
- 在 Codex 应用中打开设置。
- 在通用页面中，找到导入其他 agent 设置。
- 选择导入或再次导入。
- 查看 Codex 找到的内容，选择要带过来的项目，然后选择导入。
- 导入完成后，如果你想检查结果，请选择查看已导入的文件。
迁移如何工作
Codex 会检查你的用户级设置和当前项目。用户级设置来自你机器上的文件； 项目级设置来自你当前打开的仓库中的文件。
当你导入时，Codex 会：
- 检测它能找到的设置。
- 导入所选的、它可以直接迁移的项目。
- 在导入完成后再次检查。
- 如果仍有内容需要后续处理，则提供在新线程中继续迁移的选项。
Codex 可以导入的内容
| 检测到的设置 | Codex 目标位置 |
|---|---|
| 指令文件 | AGENTS.md |
settings.json | config.toml |
| Skills | Codex skills |
| 最近 30 天的会话 | Codex 线程和项目 |
| MCP server 配置 | Codex MCP configuration |
| Hooks | Codex hooks |
| Slash commands | Codex skills |
| Subagents | Codex agents |
在新线程中完成剩余设置
某些检测到的设置无法与 Codex 形成干净的一对一映射。对于这些项目，
Codex 可以使用
migrate-to-codex
skill 打开一个新线程，以帮助完成迁移。
发生这种情况时，Codex 会显示剩余设置，并提供在 Codex 中继续选项。
如果你继续，Codex 会打开一个新线程，并预先填入剩余工作。 该线程会将用户级设置与项目级设置分开，以便你看到每个剩余项目分别属于哪里。
导入后需要检查的内容
在依赖任何已迁移设置之前，请先检查它们，尤其是：
- 已导入 skills 和 agents 中的工具限制或权限。
- 使用自定义认证、headers、环境变量或 transports 的 MCP server 设置。
- 在 Codex 中行为可能有所不同的 hooks。
- 需要手动后续处理的 plugins、marketplaces 或其他剩余设置。
- 依赖参数、shell 插值或文件路径占位符的提示模板或命令式提示。
切换之后
导入完成后，打开你已迁移的某个项目并从那里继续。如果你是 Codex 新用户，请参阅 quickstart 以完成其余设置流程。