Appearance
Codex Plugin 是把 Skills、App 集成和 MCP Server 打包在一起的可复用工作流扩展。通过插件你可以让 Codex 读写 Gmail、Google Drive、Slack 等外部服务。本文说明插件包含什么、如何从 App 或 CLI 安装、如何触发使用，以及权限和隐私机制。
Codex Plugins
插件是什么
Plugin 把以下内容打包在一起，让你一次安装就能解锁完整的工作流能力：
- Skills：可复用的任务指令模板，Codex 按需加载后会按照正确的步骤和参考资源执行特定类型的工作
- Apps：连接 GitHub、Slack、Google Drive 等外部工具的集成，让 Codex 可以读取信息、在这些工具里采取行动
- MCP Servers：提供额外工具或共享信息访问权限的服务，通常来自本地项目之外的系统
常见场景：
- 安装 Gmail 插件，让 Codex 读取和管理邮件
- 安装 Google Drive 插件，跨 Drive、Docs、Sheets、Slides 工作
- 安装 Slack 插件，让 Codex 总结频道或起草回复
安装插件
从 Codex App 安装
打开 Codex App，点击 Plugins 进入插件目录，浏览和安装精选插件。点击插件的 + 按钮或 Add to Codex 完成安装。
从 CLI 安装
在 Codex CLI 里运行 /plugins 打开插件列表，选择插件后按提示安装。
安装流程：
- 搜索或浏览插件，打开详情
- 点击安装按钮（App 里是 + 或 Add to Codex，CLI 里是
Install plugin） - 如果插件需要连接外部 App，在提示时完成连接（部分插件在安装时要求认证，部分在首次使用时才要求）
- 安装完成后开始新线程，向 Codex 发出使用该插件的指令
使用插件
安装后有两种使用方式：
描述任务：直接说你想要的结果，Codex 自动选择合适的插件和工具：
总结今天收到的未读 Gmail 邮件
从 Google Drive 拉取最新的发布说明指定插件：用 @ 显式调用特定插件或其 Skill：
@gmail 帮我回复来自 marketing team 的邮件适合明确知道要用哪个插件时使用。
权限与数据共享
安装插件只让其工作流在 Codex 里可用，你现有的审批策略设置依然有效。
- 捆绑 Skills：安装后立即可用
- 捆绑 Apps：如果需要认证，Codex 会在安装时或首次使用时提示你在 ChatGPT 里连接相关 App
- 捆绑 MCP Servers：可能需要额外设置或认证
当 Codex 通过捆绑 App 传递数据时，该 App 自身的使用条款和隐私政策适用。外部服务的认证、隐私和数据共享策略仍由各服务自己管理。
卸载或禁用插件
卸载：重新打开插件浏览器，找到该插件，选择 Uninstall plugin。卸载插件会从 Codex 移除插件包，但捆绑的 App 仍然安装在 ChatGPT 里，需要在 ChatGPT 里单独管理。
临时禁用（保留但不激活）：在 ~/.codex/config.toml 里设置 enabled = false，然后重启 Codex：
toml
[plugins."gmail@openai-curated"]
enabled = false构建自己的插件
如果你想创建、测试或分发自己的插件，见 构建 Plugin。那篇文档覆盖本地脚手架、marketplace 配置、plugin manifest 格式和打包说明。
常见问题
Q: 插件里的 Skills 和直接在 AGENTS.md 里写指令有什么区别？
A: 本质上都是 Skill，区别在于打包和分发方式。AGENTS.md 和项目级 Skill 只在该项目里生效；插件可以打包多个 Skill + App 集成 + MCP 配置，一次安装在所有项目里都可用，也可以分享给团队或发布到插件目录。
Q: 安装插件会不会自动修改我的代码或发出消息？
A: 不会。安装本身只是让插件的工作流和工具在 Codex 里可用，你现有的审批策略仍然生效。Codex 采取任何会修改文件或调用外部 App 的操作，仍然按你配置的审批策略决定是否需要确认。
Q: 一个插件可以同时包含 Skill + App + MCP 吗？
A: 可以。插件设计就是用来把这三类能力打包在一起的。安装一个插件可以同时获得相关的 Skill 指令、App 连接器和 MCP 工具访问权限。