安裝和管理外掛
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 引入不必要的能力和風險：
- 內建或已有擴充套件能不能解決？ 能的話就別裝，每多一個外掛多一份維護和風險面。
- 來源可信嗎？ 優先官方或原始碼可審查的外掛，來源不明的不裝。
- 它要的許可權合理嗎？ 一個格式化外掛卻要網路和檔案全許可權，就是危險訊號，按最小必要取捨。
三個問題都過了再裝；裝完也定期回顧還在不在用，不用的及時移除。