使用导入流程，可以将您在其他代理中的指令、配置、技能、MCP 服务器、钩子 (hooks)、子代理及近期会话导入到 Codex 中。Codex 会迁移其可直接处理的部分，并可开启后续对话以协助迁移剩余内容。
开始迁移
- 打开 Codex 应用中的 设置 (Settings)。
- 在 常规 (General) 页面上，找到 导入其他代理设置 (Import other agent setup)。
- 选择 导入 (Import) 或 再次导入 (Import again)。
- 检查 Codex 发现的内容，选择要迁移的项目，然后选择 导入 (Import)。
- 导入完成后，如果您想检查结果，请选择 查看已导入文件 (View imported files)。
迁移机制
Codex 会检查您的用户级设置和当前项目。用户级设置来源于您机器上的文件；项目级设置则来源于您打开的存储库中的文件。
导入时，Codex 会：
- 检测其可以发现的设置。
- 导入所选可直接迁移的项目。
- 导入完成后再次进行检查。
- 如果仍有内容需要后续处理，Codex 会主动提供在新的对话中继续迁移的选项。
Codex 可导入的内容
| 检测到的设置 | Codex 目标位置 |
|---|---|
| 指令文件 | AGENTS.md |
settings.json | config.toml |
| 技能 | Codex 技能 |
| 过去 30 天内的近期会话 | Codex 对话和项目 |
| MCP 服务器配置 | Codex MCP 配置 |
| 钩子 | Codex 钩子 (Hooks) |
| 斜杠命令 | Codex 技能 |
| 子 Agent | Codex 代理 |
在新对话中完成剩余设置
部分检测到的设置在 Codex 中没有直接对应的映射。对于这些项目，Codex 可以通过 migrate-to-codex 技能开启一个新对话，以协助完成迁移。
当出现这种情况时，Codex 会显示剩余的设置，并提供 在 Codex 中继续 (Continue in Codex) 的选项。
如果您选择继续，Codex 将打开一个已预填剩余工作的新对话。该对话会将用户级设置与项目级设置区分开，以便您了解每个剩余项目应归属的位置。
导入后需要检查的内容
在依赖已迁移的设置之前，请务必进行检查，特别是：
- 已导入技能和代理中的工具限制或权限。
- 使用自定义身份验证、请求头、环境变量或传输方式的 MCP 服务器设置。
- 在 Codex 中行为可能不同的钩子 (Hooks)。
- 需要人工手动跟进的插件、市场或其他剩余设置。
- 依赖于参数、Shell 插值或文件路径占位符的提示模板或命令式提示。
切换后
导入完成后，打开您的一个已迁移项目并继续工作。如果您是 Codex 的新用户，请参阅 快速入门 以了解剩余的设置流程。