Claude Code 插件包含的内容
Anthropic 的插件文档是这样描述的:“Claude Code 插件是一个包含技能、智能体、钩子、MCP 服务器或其他组件的目录,Claude Code 将其作为一个单元进行安装和加载。”
插件的清单文件位于 .claude-plugin/plugin.json。大多数插件来自市场(marketplace),市场是一个列出插件及其获取路径的目录。
当您安装插件时,Claude Code 会将其记录在您的设置中。每个插件都有一个格式为 <entry-name>@<marketplace> 的安装 ID,Anthropic 将其描述为 Claude Code 写入设置文件中 enabledPlugins 下的键。对于在用户范围内安装的插件,该条目位于 ~/.claude/settings.json。您或您的组织注册的市场可以出现在 extraKnownMarketplaces 下。
另外两个位置对迁移也很重要:
- 插件的安装文件。 Claude Code 将其公开为
CLAUDE_PLUGIN_ROOT。文档警告说,此路径“在插件更新时会发生变化,因此不要在那里写入状态”。 - 插件的数据目录。 Claude Code 将其公开为
CLAUDE_PLUGIN_DATA,位于~/.claude/plugins/data/<id>/。它“在第一次引用时创建并在插件更新时保留”,Anthropic 将安装的依赖项、生成的代码和缓存列为典型内容。
插件还可以向您请求配置值。根据清单参考,标记为敏感的值存储在“安全存储中,而不是 settings.json 中”。
Codex 导入迁移的内容
OpenAI 的导入流程是起点。它可以在两个地方使用:
- ChatGPT 桌面应用,可以在“设置”下的“导入”中从 Claude Code、Claude Cowork 或 Cursor 导入。
- Codex CLI,可以在空闲会话中使用
/import从 Claude Code 或 Cursor 导入。
OpenAI 的文档列出了导入涵盖的内容。插件就在列表中,此外还包括:指令文件(变为 AGENTS.md)、您的 settings.json(映射到 config.toml)、技能、MCP 服务器配置、钩子、斜杠命令(变为技能)以及子智能体。来自 Claude Code 的项目记忆(memories)会迁移到 Codex 记忆,过去 30 天的聊天记录会变成 ChatGPT 聊天。
首先请放心:“导入不会更改或删除您现有的智能体设置。”您的 Claude Code 插件仍保持安装状态并在原处正常运行。
如果您计划在一段时间内同时使用这两个工具,桌面应用还可以保持导入工作的同步。OpenAI 表示,您可以在“设置”->“导入”下开启自动更新,“以保持导入的工作与原始智能体同步”,并在同一位置查看您的导入历史记录。这对于您在 Claude Code 中持续更新的插件非常重要,否则一次性导入会变得过时。
Codex 如何找到您的插件
专门针对插件,文档解释了检测步骤:“从 .claude/settings.json 检测插件时,Codex 会从 extraKnownMarketplaces 读取配置的市场源。”
官方市场还有一个备用方案。如果您的 enabledPlugins 列表包含来自 claude-plugins-official 的插件,但未列出市场源,Codex 会推断 anthropics/claude-plugins-official 为来源。
应用服务器参考补充说,对于插件项目,Codex 会列出每个市场名称以及它“可以尝试迁移”的插件名称。这个措辞值得注意。检测告诉您 Codex 将尝试什么,并不代表每个插件都能原封不动地运行。
检测也是增量的。OpenAI 指出,它“仅返回仍有工作待做的项目”。例如,当 AGENTS.md 已经存在且不为空时,Codex 会跳过指令文件步骤,且技能导入不会覆盖现有的技能目录。如果您已经手动设置了 Codex 的一部分,导入不会替换它。
Codex 可以读取的插件格式
Codex 有自己的插件格式,清单文件位于 .codex-plugin/plugin.json。它也可以读取 Claude 格式的插件和市场。
最明确的说明出现在 OpenAI 为从 GitHub 导入插件的工作区管理员提供的指南中。市场仓库必须包含以下文件之一:
.agents/plugins/marketplace.json,一个 Codex 市场.claude-plugin/marketplace.json,被描述为“带有plugins数组的 Claude 兼容市场”.claude-plugin/plugin.json,“当不存在市场清单时的独立 Claude 插件”
同一指南指出,市场条目“可以引用带有 .codex-plugin/plugin.json 的原生插件、Claude 兼容插件、Agent Plugins 1.0 包或支持的技能包”。
该工作区导入是 ChatGPT 工作区的管理员功能,目前仅支持 GitHub 仓库。如果您的团队已经在 GitHub 中维护了一个 Claude Code 市场,管理员可以将工作区指向它,而不是转换每个插件。
导入后需要跟进的操作
导入只是第一步。OpenAI 的文档列出了在依赖导入的设置之前需要审核的内容,插件也在其中。该列表包括:
- 导入的技能和智能体中的工具限制或权限
- 具有自定义身份验证、标头、环境变量或传输方式的 MCP 服务器设置,其中“您可能需要重新登录”
- “导入后行为可能有所不同的钩子”
- “需要手动跟进的插件、市场或其他设置”
在桌面应用中,导入会“检查导入的插件或连接是否仍需设置”,并在需要完成设置时显示状态卡。选择“完成”将引导您完成剩余操作。
对于工作区导入,还有另一个步骤。安装和身份验证设置不会从仓库中获取,并且“导入插件不会授予成员应用访问权限或连接他们的帐户”。每个人仍需连接自己的帐户。
插件钩子在 Codex 中的行为方式
钩子在此次迁移中需要最多的关注,因为在您审核之前,Codex 不会运行它们。
当启用插件时,Codex 可以将插件的生命周期钩子与用户、项目和托管钩子一起加载。默认情况下,它会在插件根目录下查找 hooks/hooks.json。
为了兼容性,Codex 为插件钩子命令提供与 Claude Code 相同的环境变量。OpenAI 的钩子文档称:“Codex 还会设置 CLAUDE_PLUGIN_ROOT 和 CLAUDE_PLUGIN_DATA,以兼容现有的插件钩子。”Codex 自己的等效变量 PLUGIN_ROOT 和 PLUGIN_DATA 指向已安装的插件根目录和插件的可写数据目录。
请注意这对存储数据的意义。Codex 会自行设置该变量,与其自身的 PLUGIN_DATA 并列。导入文档中列出的迁移内容不包括插件数据目录。如果某个插件在 Claude Code 端的 ~/.claude/plugins/data/<id>/ 中积累了有用的内容,请在假设它存在于 Codex 之前,检查插件是否需要它。
另一个区别是审核。“插件钩子使用与其他钩子相同的事件模式。在运行之前请审核并信任它们。”在 CLI 中,您可以使用 /hooks 进行审核。在桌面应用中,您可以在编辑器中选择“审核钩子”或打开“设置”->“钩子”。并且“如果插件更新更改了捆绑的脚本,即使钩子定义保持不变,Codex 也需要重新审核。”我们在关于为什么 Codex 钩子需要审核的指南中介绍了审核周期。
开始前的检查清单
- 列出您拥有的内容。 查看 Claude Code 设置文件(用户和项目范围)中的
enabledPlugins和extraKnownMarketplaces。 - 记录敏感配置。 插件存储在安全存储中的值不在
settings.json中,因此请计划重新输入它们。 - 查找保存数据的插件。 检查
~/.claude/plugins/data/中是否有插件依赖的内容目录。 - 识别钩子。 记录哪些插件运行钩子,以便您知道在 Codex 中需要审核什么。
- 区分团队和个人插件。 团队市场最好由管理员统一处理。
人们首先尝试的操作
期望每个插件都能原封不动地工作。 Codex 列出了它可以尝试迁移的插件。有些需要手动跟进。
假设钩子会立即运行。 Codex 要求您在运行之前审核并信任插件钩子。
忘记密钥。 敏感值存在安全存储中,而不是 Codex 读取的设置文件中。
逐个重新安装团队市场插件。 工作区管理员可以从 GitHub 导入整个市场。
期望导入会改动 Claude Code。 它不会更改或删除您现有的设置。
手动迁移步骤
第 1 步:盘点插件和市场
记录每个启用的插件、其所属市场、是否包含钩子,以及是否保留了数据或敏感设置。
第 2 步:运行导入
在 ChatGPT 桌面应用中使用“设置”->“导入”,或在空闲的 Codex CLI 会话中使用 /import。选择您的 Claude Code 设置并选择您想要的插件。
第 3 步:完成设置并登录
按照桌面应用中的状态卡操作,登录需要身份验证的 MCP 服务器,并重新输入敏感值。
第 4 步:审核并信任钩子
在 CLI 中打开 /hooks,或在桌面应用中选择“审核钩子”,阅读每个插件钩子,并信任您想要运行的钩子。
第 5 步:用熟悉的任务测试每个插件
使用每个迁移的插件运行一个您熟悉的任务,并将结果与 Claude Code 生成的结果进行比较。
更好的方法:将插件依赖的上下文保存在一个地方
插件承载了程序:技能、钩子和工具。它们作用的对象是您项目的上下文(context),例如约定、决策和约束,而这正是两个工具中必须保持一致的内容。
MemoryLake 是此类项目上下文(如决策、约定及其背后的原因)的记忆层,保存在您维护的一个地方,并可供您连接的助手(如 ChatGPT、Claude Code 和 Codex)使用。
您可以用自己的语言亲自编写条目。不会从您的 Claude Code 插件、其数据目录、您的设置文件、您的 Codex 插件或钩子、您的 AGENTS.md 文件或任何供应商的存储中读取、写入或删除任何内容。插件导入和钩子审核的工作方式与 OpenAI 和 Anthropic 描述的一致。
第 1 步:创建 API 密钥
登录并从控制面板生成密钥。请将其保存在插件配置文件和仓库之外。

第 2 步:上传您的第一批记忆
从您的插件所假设的内容开始:它们的技能所执行的约定、您的钩子背后的原因,以及它们依赖的项目决策。每个条目对应一个约定或决策。

第 3 步:连接您的 AI 和智能体
连接 Claude Code 和 Codex,以及您使用的 ChatGPT 或其他助手。当您并排运行这两个编程工具时,它们都可以调用相同的条目。

这在实践中改变了什么
第一个区别是迁移不再依赖于每个插件的完美迁移。您设置背后的上下文已经记录在案。
第二个区别是同时使用两个工具时的一致性。您更新的一个约定会同时应用于 Claude Code 和 Codex,而不是仅在您编辑的那个工具中生效。
第三个区别是更清晰的审核。当您在 Codex 中阅读插件的钩子时,您可以根据您记录的理由来检查它们。
将插件从 Claude Code 迁移到 Codex 的最佳实践
先盘点。 了解您拥有哪些插件、市场、钩子和存储的数据。
使用导入功能。 它会从您的设置中检测插件,且不会更改您的 Claude Code 设置。
将检测视为待验证列表。 Codex 会列出它可以尝试迁移的插件。
审慎地审核钩子。 仅信任您理解的钩子,并预料到插件更新后需要重新审核。
重新输入密钥。 敏感设置不在导入读取的文件中。
让管理员处理团队市场。 GitHub 上兼容 Claude 的市场可以导入到工作区中。
将共享上下文保留在两个工具之外。 插件会迁移;但其背后的原因应该留在一个地方。
结论
Codex 可以迁移您的 Claude Code 插件。它的导入功能会从您的 Claude Code 设置中读取 enabledPlugins 和 extraKnownMarketplaces,可以推断官方市场,并列出它可以尝试迁移的插件。Codex 读取 Claude 格式的插件和市场,并设置 CLAUDE_PLUGIN_ROOT 和 CLAUDE_PLUGIN_DATA,以便现有的插件钩子可以运行。
仍需您处理的部分:钩子在运行前必须经过审核和信任,敏感设置和登录必须重新执行,且插件数据目录不在导入涵盖的列表中。检查其中的每一项,在熟悉的任务上测试每个插件,并将插件作用的项目上下文保存在两个工具都能使用的地方。