迁移到 Codex

使用导入流程，可以把其它智能体中的指令、配置、技能、MCP servers、hooks、子智能体和最近会话带入 Codex。Codex 会直接迁移它能处理的部分，并可以打开一个后续线程，帮助你迁移剩余内容。

开始迁移

1. 在 Codex App 中打开 Settings（设置）。
2. 在 General（通用） 页面找到 Import other agent setup。
3. 选择 Import 或 Import again。
4. 查看 Codex 找到的内容，选择要导入的项目，然后选择 Import。
5. 导入完成后，如果你想检查结果，可以选择 View imported files。

迁移如何工作

Codex 会同时检查你的用户级设置和当前项目。用户级设置来自你机器上的文件；项目级设置来自你当前打开的代码仓库。

导入时，Codex 会：

1. 检测它能找到的设置。
2. 导入所选且可以直接迁移的项目。
3. 在导入完成后再次检查。
4. 如果还有需要后续处理的内容，就提供在新线程中继续迁移的选项。

Codex 可以导入什么

在新线程中完成剩余设置

有些检测到的设置无法干净地一一映射到 Codex。对于这些项目，Codex 可以打开一个带有 migrate-to-codex skill 的新线程，帮助你完成剩余迁移。

出现这种情况时，Codex 会显示剩余设置，并提供 Continue in Codex。

如果继续，Codex 会打开一个新线程，并预先填好剩余工作。该线程会把用户级设置和项目级设置分开，让你能看清每个剩余项目属于哪里。

导入后要检查什么

在依赖迁移结果前，请检查所有已迁移设置，尤其是：

• 已导入技能和智能体中的工具限制或权限。
• 使用自定义认证、headers、环境变量或 transports 的 MCP server 设置。
• 行为可能在 Codex 中不同的 hooks。
• 仍需手动处理的插件、marketplaces 或其它剩余设置。
• 依赖参数、shell 插值或文件路径占位符的提示词模板或命令式提示词。

切换之后

导入完成后，打开一个已迁移的项目并从那里继续。如果你刚开始使用 Codex，请参见快速开始，完成其余设置流程。