遷移到 Codex
說明如何用 Codex import flow 遷移其他 agent 的 instructions、configuration、skills、MCP servers 和 sessions。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| Migration | 遷移 | 把已有設定或工作流匯入 Codex 的過程。 |
| Import | 匯入 | 遷移時把可識別的設定 / 規則帶進 Codex。 |
| 遷移盤點 | migration audit | 遷移前先理清現有資產和不可遷項。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你規劃從其它工具遷移到 Codex 的盤點、匯入和收尾。
你是 Codex 遷移規劃顧問，幫我把從其它工具或舊設定遷移到 Codex 的過程理清，避免漏項和返工。
【角色】
你熟悉遷移的啟動方式、遷移如何工作、Codex 能匯入什麼、哪些要在新會話裡手動完成，也知道遷移前要先盤點。
【輸入】
- 我現在用什麼工具 / 設定：___
- 想遷移的內容（規則 / 命令 / 工作流 / 歷史）：___
- 哪些是必須保留的：___
- 遷移的緊迫程度：___
【工作流程】
1. 先盤點現有資產，區分可匯入和需手動重建的
2. 說明遷移啟動方式和匯入範圍
3. 列出匯入後需要在新會話手動完成的設定
4. 給遷移後的驗證清單，確認沒漏
【輸出規範】
▌一、遷移前盤點（可匯入 / 需手動）
▌二、遷移啟動 + 匯入範圍
▌三、需手動完成的收尾設定
▌四、遷移後驗證清單
【硬約束】
- 遷移前必須盤點，不盲目一鍵遷
- 不能匯入的項要明確列出，不假裝全自動
- 關鍵設定遷移後逐項驗證，不預設成功
- 涉及金鑰的設定遷移走安全方式，不明文搬運
- 不確定的匯入能力標註需查官方文件Codex 提供 import flow，可以把另一個 agent 的 instructions、configuration、skills、MCP servers、hooks、subagents 和 recent sessions 帶入 Codex。
Codex 會直接遷移它能處理的部分；剩餘內容則可以開啟 follow-up thread，繼續協助遷移。
官方頁面：https://developers.openai.com/codex/migrate
Migrate to Codex
官方 import flow 和遷移後複核清單。
Config reference
檢查匯入後的 config.toml。
Rules
把 instruction files 收斂到 Codex 可讀取的規則體系。
匯入流程截圖：
- 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
遷移前先做盤點
不要把 import 當成“點一下就切換完”。商業專案遷移前先列清：
| 專案 | 要確認什麼 |
|---|---|
| Instructions | 哪些是全域偏好，哪些是專案規則 |
| Config | 模型、審批、沙箱、網路、檔案許可權是否適合 Codex |
| Skills | 哪些只讀，哪些會寫入，哪些依賴外部工具 |
| MCP servers | token、headers、transport、tool allowlist 是否安全 |
| Hooks | 是否會改變 Codex 行為或寫入檔案 |
| Subagents | 是否真的需要遷移為 Codex subagents |
| Sessions | 最近 30 天會話是否有繼續價值 |
匯入流程會區分 user-level setup 和 project-level setup。你要做的是確認遷移目標，而不是把舊工具裡的所有東西照搬到 Codex。
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 佔位引數的 prompt templates 或 command-style prompts。
After You Switch
import 完成後，開啟一個已 migrated project，從那裡繼續。
如果你剛開始使用 Codex，見 quickstart，完成其餘 setup flow。
匯入後驗證
遷移完成後，建議用一個低風險專案驗證：
- 開啟已遷移專案。
- 讓 Codex 說明它讀取到了哪些規則和設定。
- 跑一個只讀任務，例如“解釋這個專案結構”。
- 跑一個小改動任務，並確認審批、沙箱和測試命令是否符合預期。
- 檢查 MCP server 是否只暴露必要工具。
- 檢查 imported skills 是否仍然有清楚的使用邊界。
如果行為異常，先修規則和設定，不要馬上投入生產任務。遷移成功的標準不是“檔案匯入了”，而是 Codex 在真實專案裡按預期讀取規則、執行命令、請求審批和生成可審查 diff。