本文为非官方中文翻译,内容以 OpenAI 官方英文文档为准。
官方来源:https://developers.openai.com/codex/plugins
Plugins
在 Codex 中使用插件,以添加可复用的工作流、skills 和应用集成
概述
插件将 skills、应用集成和 MCP servers 打包为可在 Codex 中复用的工作流。
扩展 Codex 的能力,例如:
- 安装 Gmail 插件,让 Codex 读取和管理 Gmail。
- 安装 Google Drive 插件,以便在 Drive、Docs、Sheets 和 Slides 之间协同工作。
- 安装 Slack 插件来总结频道内容或起草回复。
一个插件可以包含:
- Skills: 针对特定类型工作的可复用指令。Codex 可以在需要时加载它们,以便在任务中遵循正确步骤,并使用正确的参考资料或辅助脚本。
- Apps: 与 GitHub、Slack 或 Google Drive 等工具的连接,使 Codex 能够从这些工具中读取信息并在其中执行操作。
- MCP servers: 为 Codex 提供对额外工具或共享信息的访问,通常来自本地项目之外的系统。
更多插件能力即将推出。
使用和安装插件
Codex 应用中的插件目录
在 Codex 应用中打开 Plugins,浏览并安装精选插件。

CLI 中的插件目录
在 Codex CLI 中,运行以下命令以打开插件列表:
codex
/plugins

CLI 插件浏览器会按 marketplace 对插件进行分组。使用 marketplace 标签页切换来源,打开某个插件以查看详细信息,安装或卸载 marketplace 条目,并在已安装插件上按 Space 切换其启用状态。
安装并使用插件
打开插件目录后:
- 搜索或浏览一个插件,然后打开其详情。
- 选择安装按钮。在应用中,选择加号按钮或 Add to Codex。在 CLI 中,选择
Install plugin。 - 如果插件需要外部应用,请在提示时进行连接。有些插件会在安装期间要求你进行身份验证。另一些则会等到你第一次使用它们时再提示。
- 安装完成后,开启一个新线程并请求 Codex 使用该插件。
安装插件后,你可以直接在提示窗口中使用它:

直接描述任务
说明你想要的结果,例如“总结今天未读的 Gmail 线程”或“从 Google Drive 拉取最新的发布说明”。
当你希望 Codex 为任务选择合适的已安装工具时,请使用这种方式。
选择特定插件
输入 @ 以显式调用该插件或其打包的某个 skill。
当你想明确指定 Codex 应使用哪个插件或 skill 时,请使用这种方式。参见 Codex 应用命令和 Skills。
权限和数据共享的工作方式
安装插件会使其工作流在 Codex 中可用,但你现有的审批设置仍然适用。任何已连接的外部服务仍受其自身的身份验证、隐私和数据共享政策约束。
- 打包的 skills 会在你安装插件后立即可用。
- 如果插件包含 apps,Codex 可能会在设置期间或你首次使用它们时提示你在 ChatGPT 中安装这些 apps 或登录。
- 如果插件包含 MCP servers,在你使用它们之前,可能需要额外设置或身份验证。
- 当 Codex 通过打包的 app 发送数据时,该 app 的条款和隐私政策适用。
移除或关闭插件
要移除插件,请从插件浏览器中重新打开它并选择 Uninstall plugin。
卸载插件会从 Codex 中移除该插件包,但打包的 apps 会继续保持已安装状态,直到你在 ChatGPT 中管理它们。
如果你想保留插件已安装但将其关闭,请在 ~/.codex/config.toml 中将其条目设置为 enabled = false,然后重启 Codex:
[plugins."gmail@openai-curated"]
enabled = false
构建你自己的插件
如果你想创建、测试或分发自己的插件,请参见构建插件。该页面涵盖本地脚手架、手动 marketplace 设置、插件清单以及打包指南。