---
title: "安装和管理插件"
description: "Plugins 会把 skills、app integrations 和 MCP servers 打包成 Codex 可复用的工作流。"
verifiedAt: "2026-05-06"
---

import { Cards, Card } from 'fumadocs-ui/components/card';

## 概览

Plugins 会把 skills、app integrations 和 MCP servers 打包成 Codex 可复用的工作流。

> [!WARNING]
> 插件不是普通扩展包。它可能带来 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](https://developers.openai.com/images/codex/plugins/directory.png)
- dark mode：[https://developers.openai.com/images/codex/plugins/directory_dark.png](https://developers.openai.com/images/codex/plugins/directory_dark.png)

### 在 CLI 里打开 Plugin Directory

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

```text
codex
/plugins
```

截图：

- light mode：[https://developers.openai.com/images/codex/plugins/cli_light.png](https://developers.openai.com/images/codex/plugins/cli_light.png)
- dark mode：[https://developers.openai.com/images/codex/plugins/codex-plugin-cli.png](https://developers.openai.com/images/codex/plugins/codex-plugin-cli.png)

CLI 插件浏览器会按 marketplace 对 plugins 分组。

你可以用 marketplace tabs 切换来源，打开 plugin 查看详情，安装或卸载 marketplace 条目，并在已安装 plugin 上按 <kbd>Space</kbd> 切换启用状态。

### 安装并使用插件

打开 plugin directory 后：

1. 搜索或浏览 plugin，并打开详情。
2. 选择安装按钮。在 App 中选择加号按钮或 **Add to Codex**；在 CLI 中选择 `Install plugin`。
3. 如果 plugin 需要外部 app，请在提示时连接。部分 plugins 会在安装时要求认证；另一些会等到你第一次使用时再处理。
4. 安装完成后，开启一个新 thread，并让 Codex 使用该 plugin。

安装 plugin 后，你可以直接在 prompt window 中使用它。

示例截图：

- light mode：[https://developers.openai.com/images/codex/plugins/plugin-github-invoke.png](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](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](https://developers.openai.com/codex/app/commands) 和 [Skills](https://developers.openai.com/codex/skills)。 |

### 权限和数据共享如何工作

安装 plugin 会让它的工作流在 Codex 中可用，但现有 [approval settings](https://developers.openai.com/codex/agent-approvals-security) 仍然生效。

所有已连接的外部服务，仍受它们自身的认证、隐私和数据共享政策约束。

- 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：

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

## 构建自己的插件

如果想创建、测试或分发自己的 plugin，见 [Build plugins](https://developers.openai.com/codex/plugins/build)。

该页面覆盖本地脚手架、手动 marketplace 设置、plugin manifests 和打包指引。

## 接下来去哪

<Cards>
  <Card title="构建自己的插件" description="理解 manifest、skills、apps、MCP servers 和 marketplace 打包方式。" href="/docs/codex/official/03-extensions/69-build-plugins" />
  <Card title="Skills 复用" description="插件中的 skills 本质是可复用工作流，先理解 skill 边界。" href="/docs/codex/official/03-extensions/09-skills-reuse" />
  <Card title="MCP 接入" description="插件包含 MCP server 时，需要单独核验工具权限和认证。" href="/docs/codex/official/03-extensions/08-mcp-integration" />
  <Card title="官方 Plugins" description="插件目录、安装方式和 marketplace 状态以官方页面为准。" href="https://developers.openai.com/codex/plugins" />
</Cards>
