---
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="/zh-Hant/docs/codex/official/03-extensions/69-build-plugins" />
  <Card title="Skills 複用" description="外掛中的 skills 本質是可複用工作流，先理解 skill 邊界。" href="/zh-Hant/docs/codex/official/03-extensions/09-skills-reuse" />
  <Card title="MCP 接入" description="外掛包含 MCP server 時，需要單獨核驗工具許可權和認證。" href="/zh-Hant/docs/codex/official/03-extensions/08-mcp-integration" />
  <Card title="官方 Plugins" description="外掛目錄、安裝方式和 marketplace 狀態以官方頁面為準。" href="https://developers.openai.com/codex/plugins" />
</Cards>
