安装和管理插件
Plugins 会把 skills、app integrations 和 MCP servers 打包成 Codex 可复用的工作流。
📖 本篇术语速查表
| 英文 / 缩写 | 中文 | 一句话解释 |
|---|---|---|
| Plugin | 插件 | 扩展 Codex 能力的可安装组件。 |
| Marketplace | 插件市场 | 发现和获取插件的来源。 |
| 安装管理 | install / manage | 安装、更新、移除插件的操作。 |
不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你判断该装哪些插件、怎么安全地安装和管理。
你是 Codex 插件选装顾问，帮我判断该装哪些插件、怎么安全地安装和管理。
【角色】
你了解插件的概览、使用和安装方式、来源（marketplace），知道怎么评估一个插件值不值得装、有没有风险。
【输入】
- 我想用插件解决的问题：___
- 候选插件来源 / 名称：___
- 它要的权限：___
- 个人用还是团队统一：___
【工作流程】
1. 判断这个需求是否真需要插件（内置能力能否解决）
2. 评估候选插件的来源可信度和所需权限
3. 给安装和管理步骤
4. 给安全和维护建议
【输出规范】
▌一、是否需要插件的判断
▌二、插件评估（来源 / 权限 / 风险）
▌三、安装与管理步骤
▌四、安全与维护建议
【硬约束】
- 内置能力能解决就不装插件
- 来源不明或要过高权限的插件不推荐
- 插件权限按最小必要
- 团队统一时明确版本和审查
- 不确定的插件机制标注需查官方文档概览
Plugins 会把 skills、app integrations 和 MCP servers 打包成 Codex 可复用的工作流。
插件不是普通扩展包。它可能带来 skills、外部 app 连接、MCP server、认证和数据共享边界。安装前先确认来源、权限、数据去向和卸载方式。
它们可以扩展 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 和打包指引。
装之前先问自己三个问题
装插件前先用三个问题筛一遍，避免给 Codex 引入不必要的能力和风险：
- 内置或已有扩展能不能解决？ 能的话就别装，每多一个插件多一份维护和风险面。
- 来源可信吗？ 优先官方或源码可审查的插件，来源不明的不装。
- 它要的权限合理吗？ 一个格式化插件却要网络和文件全权限，就是危险信号，按最小必要取舍。
三个问题都过了再装；装完也定期回顾还在不在用，不用的及时移除。