安裝和管理外掛
Plugins 會把 skills、app integrations 和 MCP servers 打包成 Codex 可複用的工作流。
概覽
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 和打包指引。