使用导入流程，将你的指令、配置、技能、MCP 服务器、钩子、子代理和近期会话从其他代理迁移至 Codex。Codex 会直接迁移其能处理的部分，并会开启一个后续线程来协助迁移剩余的内容。
开始迁移
- 打开 设置 in the Codex app.
- 在 综合 页面，找到 导入其他代理设置.
- 选择 导入 or 再次导入.
- 查看 Codex 找到的内容，选择要导入的项目，然后选择 导入.
- 导入完成后，选择 查看已导入文件 以检查结果。
迁移工作原理
Codex 会检查你的用户级别设置和当前项目。用户级别设置来自你机器上的文件；项目级别设置来自你当前打开的仓库中的文件。
导入时，Codex 会：
- 检测它能找到的设置。
- 导入所选的可直接迁移的项目。
- 在导入完成后再次检查。
- 如果仍有内容需要后续处理，则提议在新线程中继续迁移。
Codex 可导入的内容
| 检测到的设置 | Codex 中的目标位置 |
|---|---|
| 指令文件 | AGENTS.md |
settings.json | config.toml |
| 技能 | Codex 技能 |
| 过去 30 天内的近期会话 | Codex 线程和项目 |
| MCP 服务器配置 | Codex MCP 配置 |
| 钩子 | Codex 钩子 |
| 斜杠命令 | Codex 技能 |
| 子智能体 | Codex 代理 |
在新线程中完成剩余设置
某些检测到的设置无法与 Codex 形成一一对应的关系。对于这些项目，Codex 可以使用
migrate-to-codex
技能开启一个新线程，以帮助完成迁移。
当这种情况发生时，Codex 会显示剩余的设置并提供 在 Codex 中继续.
如果你选择继续，Codex 将打开一个新线程，并自动填入剩余的工作。该线程会将用户级别设置与项目级别设置区分开，以便你清楚地了解每个剩余项目的归属。
导入后需检查的内容
在使用已迁移的设置之前请先进行检查，特别是：
- 已导入技能和代理中的工具限制或权限。
- 使用了自定义身份验证、请求头、环境变量或传输协议的 MCP 服务器设置。
- 在 Codex 中行为可能有所不同的钩子。
- 需要手动跟进的插件、市场或其他剩余设置。
- 依赖于参数、Shell 插值或文件路径占位符的提示词模板或命令式提示词。
切换之后
导入完成后，打开你已迁移的一个项目并从那里继续。如果你是初次使用 Codex，请参阅 快速入门 以了解剩余的设置流程。