Getting Started

导入到 Codex

用于把现有指令文件、MCP 配置、skills 和 subagents 迁移到 Codex 体系。

使用 import flow 将来自其他 agent 的 instructions、settings、skills、plugins、projects 和最近的 chat sessions 带入 Codex。Codex 会直接导入受支持的项目,并让你完成任何需要授权的已导入 plugins 或 connections 的设置。

导入不会更改或删除你现有的 agent setup。

开始导入

在 Codex app 中打开 Settings。

在 General 下找到 Import other agent setup。

选择 Import。

选择你想从哪些 agents 导入,然后选择 Continue。

在 Select items to import 页面,选择 Continue 导入全部内容,或选择 Customize 来挑选具体项目。

如果自定义导入,请选择要带入的项目,然后选择 Confirm。

导入完成后,打开一个已导入的 project 或 thread 继续工作。

导入如何工作

Codex 会同时检查你的 user-level setup 和现有 projects。user-level setup 来自你机器上的文件。project-level setup 来自你选择的 repositories 和 folders 中的文件。

导入时,Codex 会:

检测受支持的 setup 和最近的工作。

导入你选择的项目。

保持你现有的 agent setup 不变。

检查已导入的 plugins 或 connections 是否仍需要 setup。

需要后续处理时显示 status card。

Codex 可以导入什么

导入项目Codex 目标位置
Instruction filesAGENTS.md
settings.jsonconfig.toml
SkillsCodex skills
PluginsCodex plugins
Existing project folders使用相同 folders 的 Codex projects
Chat sessions from the last 30 daysCodex threads
MCP server configurationCodex MCP configuration
HooksCodex hooks
Slash commandsCodex skills
SubagentsCodex agents

导入后完成设置

导入完成后,Codex 会在左下角显示一个 status card。如果某个已导入的 plugin 或 connection 仍需要 setup,该卡片会指出。

当 Codex 标记某个需要注意的项目时,选择 Finish,并按照提示完成 setup。

导入后要检查什么

在依赖已导入的 setup 之前先检查它,尤其是:

已导入 skills 和 agents 中的 tool restrictions 或 permissions。

使用自定义 authentication、headers、environment variables 或 transports 的 MCP server settings。你可能需要重新登录。

行为在 Codex 中可能不同的 hooks。

需要手动后续处理的 plugins、marketplaces 或其他 setup。

依赖 arguments、shell interpolation 或 file-path placeholders 的 prompt templates 或 command-style prompts。

导入之后

导入完成后,打开一个已导入的 project 并从那里继续。如果你刚开始使用 Codex,请查看 quickstart 了解其余 setup flow。

站内延伸阅读