OpenAI Codex Plugins 适合把 Skills、Apps 和 MCP Servers 打包成可复用工作流，安装后即可让 Codex 处理 Gmail、Google Drive、Slack 等外部服务。可从 Codex App 的 Plugins 目录或 CLI 的 /plugins 进入安装；如果要临时停用，可在 ~/.codex/config.toml 将对应条目设为 enabled = false 后重启 Codex。

OpenAI Codex Plugins 安装与使用 #

插件是什么 #

Plugins 会把 Skills、app 集成和 MCP servers 组合成可复用的工作流，让 Codex 扩展到更多任务场景。

常见用法包括：

• 安装 Gmail plugin，让 Codex 读取和管理 Gmail
• 安装 Google Drive plugin，让 Codex 跨 Drive、Docs、Sheets、Slides 工作
• 安装 Slack plugin，让 Codex 总结频道或起草回复

一个 plugin 可以包含：

• Skills: 针对特定任务的可复用指令。Codex 需要时会加载它们，并按正确步骤使用对应参考资料或辅助脚本。
• Apps: 连接 GitHub、Slack、Google Drive 等工具，让 Codex 可以读取这些工具中的信息，并在其中执行操作。
• MCP servers: 让 Codex 访问更多工具或共享信息的服务，通常来自本地项目之外的系统。

如果你要发布、打包或分发自己的插件，可以查看 Build plugins。

如何使用和安装插件 #

在 Codex app 里打开插件目录 #

在 Codex app 中打开 Plugins，可以浏览并安装精选插件。

插件目录会按来源分组：

• Curated by OpenAI: OpenAI 为所有 Codex 用户提供的精选插件
• Shared with you: 其他 ChatGPT workspace 成员分享给你的插件
• Created by you: 你自己创建或添加到 workspace 的插件

在 Codex CLI 里打开插件列表 #

在 Codex CLI 中运行以下命令打开插件列表：

codex
/plugins

CLI 的插件浏览器会按 marketplace 分组。你可以用 marketplace 标签切换来源，打开某个插件查看详情，安装或卸载 marketplace 条目；对已安装插件按 Space 可以切换启用状态。

安装并使用插件 #

打开插件目录后，按下面步骤操作：

1. 搜索或浏览插件，打开详情页。
2. 选择安装按钮。在 app 里点加号或 Add to Codex；在 CLI 里选择 Install plugin。
3. 如果插件需要外部 app，按提示连接。有些插件会在安装时要求认证，有些会等到第一次使用时才要求。
4. 安装完成后，新建一个 thread，再让 Codex 使用这个插件。

安装后，你可以直接在提示窗口里使用插件：

• 直接描述任务：直接说出你想要的结果，例如“Summarize unread Gmail threads from today” 或 “Pull the latest launch notes from Google Drive.” 适合让 Codex 自己挑选最合适的已安装工具。
• 指定某个插件：输入 @ 显式调用插件或它打包的某个 skill。适合你已经知道要用哪个插件或 skill 的情况。可参考 Codex app commands 和 Skills。

权限和数据共享怎么工作 #

安装 plugin 只会让它的工作流在 Codex 里可用，你现有的 approval settings 仍然生效。外部服务本身的认证、隐私和数据共享策略，也仍然由各自服务决定。

• Bundled skills 安装后立即可用
• 如果 plugin 包含 apps，Codex 可能会在安装时或第一次使用时提示你在 ChatGPT 中安装或登录这些 app
• 如果 plugin 包含 MCP servers，在你使用前可能还需要额外设置或认证
• 当 Codex 通过 bundled app 传递数据时，适用该 app 自己的条款和隐私政策

如何移除或关闭插件 #

要移除插件，重新打开 plugin browser，找到该插件后选择 Uninstall plugin。

卸载插件会把 plugin bundle 从 Codex 中移除，但 bundled apps 仍会保留，直到你在 ChatGPT 里单独管理它们。

如果你想保留插件但暂时关闭它，可以把 ~/.codex/config.toml 中对应条目标记为 enabled = false，然后重启 Codex：

[plugins."gmail@openai-curated"]
enabled = false

构建自己的插件 #

如果你想创建、测试或分发自己的 plugin，请查看 Build plugins。那一页会说明本地脚手架、手动 marketplace 设置、workspace 分享、plugin manifests 和打包流程。

常见问题 #

OpenAI Codex Plugins 安装后会自动生效吗 #

不会所有内容都自动生效。bundled skills 安装后立即可用，但 apps 和 MCP servers 可能还需要你完成额外认证或设置。Codex 通过插件执行涉及文件修改或外部服务操作时，仍然受你现有的 approval settings 约束。

OpenAI Codex plugin 怎么临时禁用 #

在 ~/.codex/config.toml 里把对应插件条目的 enabled 设为 false，然后重启 Codex。这样插件不会被卸载，只是暂时不启用。

卸载 plugin 后 bundled app 还在吗 #

还在。卸载 plugin 只会把插件包从 Codex 中移除，bundled apps 需要到 ChatGPT 里单独管理。