安装和管理插件
Plugins 会把 skills、app integrations 和 MCP servers 打包成 Codex 可复用的工作流。
概览
Plugins 会把 skills、app integrations 和 MCP servers 打包成 Codex 可复用的工作流。
它们可以扩展 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 提供额外工具或共享信息的服务，通常来自当前项目之外的系统。
更多 plugin 能力会继续进入产品。
使用和安装插件
在 Codex App 里打开 Plugin Directory
在 Codex App 中打开 Plugins，可以浏览并安装精选插件。
截图：
- light mode：https://developers.openai.com/images/codex/plugins/directory.png
- dark mode：https://developers.openai.com/images/codex/plugins/directory_dark.png
在 CLI 里打开 Plugin Directory
在 Codex CLI 中运行下面命令，打开插件列表：
codex
/plugins截图：
- light mode：https://developers.openai.com/images/codex/plugins/cli_light.png
- dark mode：https://developers.openai.com/images/codex/plugins/codex-plugin-cli.png
CLI 插件浏览器会按 marketplace 对 plugins 分组。
你可以用 marketplace tabs 切换来源，打开 plugin 查看详情，安装或卸载 marketplace 条目，并在已安装 plugin 上按 Space 切换启用状态。
安装并使用插件
打开 plugin directory 后：
- 搜索或浏览 plugin，并打开详情。
- 选择安装按钮。在 App 中选择加号按钮或 Add to Codex；在 CLI 中选择
Install plugin。 - 如果 plugin 需要外部 app，请在提示时连接。部分 plugins 会在安装时要求认证；另一些会等到你第一次使用时再处理。
- 安装完成后，开启一个新 thread，并让 Codex 使用该 plugin。
安装 plugin 后，你可以直接在 prompt window 中使用它。
示例截图：
- light mode：https://developers.openai.com/images/codex/plugins/plugin-github-invoke.png
- dark mode：https://developers.openai.com/images/codex/plugins/plugin-github-invoke-dark.png
两种常用方式：
| 方式 | 怎么写 | 适合场景 |
|---|---|---|
| 直接描述任务 | 直接说出想要的结果，例如“总结今天未读的 Gmail 会话”或“从 Google Drive 提取最新发布说明”。 | 你希望 Codex 自己选择合适的已安装工具。 |
| 指定 plugin | 输入 @，显式调用 plugin 或其中打包的 skills。 | 你想明确指定 Codex 应该使用哪个 plugin 或 skill。见 Codex app commands 和 Skills。 |
权限和数据共享如何工作
安装 plugin 会让它的工作流在 Codex 中可用，但现有 approval settings 仍然生效。
所有已连接的外部服务，仍受它们自身的认证、隐私和数据共享政策约束。
- plugin 安装后，其中打包的 skills 会立即可用。
- 如果 plugin 包含 apps，Codex 可能会在设置阶段或你第一次使用时，提示你在 ChatGPT 中安装或登录这些 apps。
- 如果 plugin 包含 MCP servers，使用前可能需要额外设置或认证。
- 当 Codex 通过打包的 app 发送数据时，该 app 的条款和隐私政策适用。
移除或关闭插件
如果要移除 plugin，重新从 plugin browser 打开它，并选择 Uninstall plugin。
卸载 plugin 会从 Codex 中移除 plugin bundle，但打包的 apps 会保持已安装，直到你在 ChatGPT 中管理它们。
如果想保留 plugin installed，但临时关闭它，可以把 ~/.codex/config.toml 中对应 entry 设置为 enabled = false，然后重启 Codex：
[plugins."gmail@openai-curated"]
enabled = false构建自己的插件
如果想创建、测试或分发自己的 plugin，见 Build plugins。
该页面覆盖本地脚手架、手动 marketplace 设置、plugin manifests 和打包指引。