迁移到 Codex

使用导入流程将你的指令、配置、Skills、MCP 服务器、Hooks、子 Agent 和近期会话从其他 AI 编程助手迁移到 Codex。

Codex 会迁移它可以直接处理的部分，并可以打开一个后续线程来帮助迁移剩余内容。

开始迁移

1. 打开 Codex 桌面应用中的设置（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 目标
指令文件	AGENTS.md
settings.json	config.toml
Skills	Codex Skills
近 30 天的近期会话	Codex 线程和项目
MCP 服务器配置	Codex MCP 配置
Hooks	Codex Hooks
斜杠命令	Codex Skills
子 Agent	Codex 子 Agent

在线程中完成剩余设置

某些检测到的设置没有干净的一对一映射到 Codex。对于这些项目，Codex 可以打开一个新线程，使用 migrate-to-codex Skill 来帮助完成迁移。

发生这种情况时，Codex 会显示剩余设置并提供在 Codex 中继续（Continue in Codex）的选项。

如果你选择继续，Codex 会打开一个新线程，其中已填入剩余的工作。该线程将用户级设置与项目级设置分开，以便你可以查看每个剩余项目所属的位置。

导入后需要检查的内容

在依赖任何已迁移的设置之前，请仔细检查，特别是：

• 导入的 Skills 和 Agent 中的工具限制或权限
• 使用自定义认证、请求头、环境变量或传输方式的 MCP 服务器设置
• 在 Codex 中行为可能不同的 Hooks
• 需要手动跟进的插件、市场或其他剩余设置
• 依赖于参数、shell 插值或文件路径占位符的提示模板或命令式提示

迁移之后

导入完成后，打开一个你已迁移的项目并继续使用。如果你是 Codex 新手，请参阅快速开始了解其余设置流程。