迁移到 Codex
Codex 提供 import flow，可以把另一个 agent 的 instructions、configuration、skills、MCP server
Codex 提供 import flow，可以把另一个 agent 的 instructions、configuration、skills、MCP servers、hooks、subagents 和 recent sessions 带入 Codex。
Codex 会直接迁移它能处理的部分；剩余内容则可以打开 follow-up thread，继续协助迁移。
导入流程截图：
- light mode：https://developers.openai.com/images/codex/migrate/import-flow-light.png
- dark mode：https://developers.openai.com/images/codex/migrate/import-flow-dark.png
Start the Migration
- 在 Codex app 中打开 Settings。
- 在 General page 中找到 Import other agent setup。
- 选择 Import 或 Import again。
- review Codex 找到的内容，选择要带入的 items，然后选择 Import。
- import 完成后，如果想检查结果，选择 View imported files。
How Migration Works
Codex 会同时检查 user-level setup 和当前 project。
user-level setup 来自你机器上的 files；project-level setup 来自你当前打开的 repository 中的 files。
import 时，Codex 会：
- 检测它能找到的 setup。
- import 已选择且能直接 migrate 的 items。
- import 完成后再次检查。
- 如果仍有内容需要 follow-up work，则提供在 new thread 中继续 migration 的选项。
What Codex Can Import
| Detected setup | Codex destination |
|---|---|
| Instruction files | AGENTS.md |
settings.json | config.toml |
| Skills | Codex skills |
| Recent sessions from the last 30 days | Codex threads and projects |
| MCP server configuration | Codex MCP configuration |
| Hooks | Codex hooks |
| Slash commands | Codex skills |
| Subagents | Codex agents |
Finish Remaining Setup in a New Thread
有些 detected setup 没有 clean one-to-one mapping 可以直接进入 Codex。
对于这类 items，Codex 可以打开 new thread，并使用 migrate-to-codex skill，协助完成剩余 migration。
发生这种情况时，Codex 会展示 remaining setup，并提供 Continue in Codex。
additional setup 截图：
- light mode：https://developers.openai.com/images/codex/migrate/additional-setup-light.png
- dark mode：https://developers.openai.com/images/codex/migrate/additional-setup-dark.png
如果继续，Codex 会打开 new thread，并把 remaining work 预先填好。
这个 thread 会把 user-level setup 和 project-level setup 分开，让你看清每个 remaining item 应该放在哪里。
follow-up migration task 截图：
- light mode：https://developers.openai.com/images/codex/migrate/continue-with-codex-light.png
- dark mode：https://developers.openai.com/images/codex/migrate/continue-with-codex-dark.png
What to Review After Import
依赖 migrated setup 前，请 review 导入结果，尤其是：
- imported skills 和 agents 中的 tool restrictions 或 permissions。
- 使用 custom authentication、headers、environment variables 或 transports 的 MCP server settings。
- 在 Codex 中 behavior 可能不同的 hooks。
- plugins、marketplaces，或其他需要 manual follow-up 的 remaining setup。
- 依赖 arguments、shell interpolation 或 file-path placeholders 的 prompt templates 或 command-style prompts。
After You Switch
import 完成后，打开一个已 migrated project，从那里继续。
如果你刚开始使用 Codex，见 quickstart，完成其余 setup flow。