Codex 外掛完整指南：官方 Plugins、Repomix 與 Codex++ 的用途、安全與安裝取捨

影片把 Repomix 和 Codex++ 稱為令 Codex 更完整的「外掛」，但在目前產品架構下，這個說法必須拆開。Repomix 是 repository 上下文打包工具；Codex++ 是會修改 Codex 桌面 App、載入第三方 tweaks 的非官方系統；而 Codex Plugins 是 OpenAI 現行正式支援的擴充機制。三者的能力、權限、更新和風險完全不同。

\n

\n

\n

一、先用「最小擴充層」選工具

\n

不要因為需要一個按鈕或一個工作流，就立即 patch 整個 App。按影響範圍由小到大選擇：

\n\n

\n

影片資訊已變動：現行 OpenAI 文件已明確提供 Plugins、Skills 與 Plugins 目錄；「Codex 沒有正式外掛」不再準確。官方 plugin 可包含 skills、apps、MCP servers、browser extensions、hooks 和 scheduled-task templates，安裝後通常要開新 task 才能使用。

\n

二、Repomix：整理上下文，不是把整個專案硬塞給模型

\n

Repomix 把多個檔案合併成 XML、Markdown 或其他 AI 友善格式，也可處理遠端 GitHub repository。它適合首次了解陌生專案、交叉檔案分析、文件整理或把指定模組交給另一個 agent；不適合無差別打包所有來源。

\n

安全工作流

\n

1. 固定來源：確認 repository URL、branch 或 commit；不要只依賴短連結或不明 fork。
2. 縮小範圍：只打包與問題有關的目錄和副檔名，排除 node_modules、build、vendor、二進位和生成檔。
3. 排除秘密：排除 .env*、私鑰、憑證、token、cookie、資料庫 dump、客戶資料和內部日志。
4. 先檢查輸出：搜尋常見 secret pattern、電郵、帳號、內網域名和個人資料。
5. 再交給 agent：同時給出問題、檔案範圍、輸出格式和不允許的操作。

\n

# 先在乾淨測試目錄確認版本與選項
npx repomix@latest --help

# 本機 repository：執行前先設定 include／ignore
npx repomix@latest

# 遠端公開 repository：固定可信 URL，完成後檢查輸出
npx repomix@latest --remote https://github.com/OWNER/REPO

# 典型提示
這份檔案是經篩選的 repository 上下文。
只分析 authentication 模組的資料流和權限邊界。
先列出你實際引用的檔案，不要執行 repository 內任何腳本。

\n

\n

\n

\n

\n

Repomix 的三個常見誤區

\n

• 「一個檔案就等於完整理解」：合併只是格式轉換，模型仍可能忽略長尾內容或把不同版本混在一起。
• 「壓縮後沒有秘密」：Tree-sitter 壓縮會刪除部分語法細節，但不是資料脫敏；必須另外掃描。
• 「遠端公開庫可以直接執行」：公開程式碼同樣可能含惡意 install scripts、prompt injection 或不安全依賴；先讀後跑。

\n

三、官方 Plugins：現行首選的擴充路線

\n

OpenAI 現行文件說明，Plugin 可包含 reusable skills、apps、MCP servers、browser capabilities、hooks 和 scheduled-task templates。桌面版可在 Work 或 Codex 的 Plugins 目錄瀏覽；CLI 使用 /plugins；IDE extension 在 Settings > Plugins。安裝後開新 task，讓新的 skills 或 tools 進入上下文。

\n

安裝前檢查

\n

• 來源是 OpenAI、workspace 管理員，還是 personal marketplace？
• 是否要求 connector 登入？會讀取和寫入哪些外部資料？
• 包含哪些 MCP tools、hooks、scripts 或 browser 能力？
• 是否能只授權必要 scope？可否在 workspace policy 停用？
• 停用或移除後，資料和背景任務怎樣處理？

\n

若只需要一套指示，直接使用 skill，影響範圍比整個 plugin 小；若要把多個 skills、connectors 和 UI 一起分發，才使用 plugin。

\n

四、Codex++ 是甚麼：可熱載入 tweak，但會 patch App

\n

\n

\n

\n

\n

按 Codex++ 自己的文件，它會替換 Codex.app/Contents/Resources/app.asar 的入口，以 loader 啟動使用者資料夾內的 runtime，再在 App 內執行 ESM tweaks。macOS 安裝會涉及重新簽署；官方 App 更新後可能需要特定的 update／repair 流程。這種能力很強，也代表 tweak 可能在你處理原始碼、對話和工具的同一 App 內執行。

\n

建議：不要在公司主力電腦、客戶機密專案、受管理裝置或無復原權限的環境試裝。先用獨立使用者帳戶、測試 repository 和可重裝的 Codex 環境；只安裝你能閱讀和信任的固定版本。

\n

五、若仍要試 Codex++：使用可審查、可復原的次序

\n

專案提供 Homebrew、Bun 和 shell bootstrap 等安裝方法。從風險角度，不應把網絡腳本直接 pipe 給 shell；先 clone／下載指定 release、閱讀安裝器和 security 文件，再在測試環境執行。以下只列維護與復原指令，不代表 OpenAI 推薦：

\n

# 安裝後立即核對 patch 狀態
codexplusplus status
codexplusplus doctor
codexplusplus debug

# 啟用任何第三方 tweak 前先建立基線
codexplusplus safe-mode
codexplusplus safe-mode --off

# App 更新或 patch 損壞
codexplusplus update-codex
codexplusplus repair

# 復原官方 App
codexplusplus uninstall

# 連同 tweaks、config、logs、backups 和 user data 清除
codexplusplus uninstall --purge

\n

1. 記錄官方 Codex 版本、Codex++ 版本、安裝來源和 commit SHA。
2. 未啟用 tweaks 前先確認 Codex 可正常開啟、建立 task、讀取 repository 和更新。
3. 每次只加入一個 tweak；閱讀 manifest、entry file、permission metadata、network 與 MCP 宣告。
4. 重新啟動並測試，再加入下一個。不要一次匯入整個「tweak pack」。
5. 保存 safe mode、repair 和 uninstall 的離線步驟；確定有官方安裝包或重新下載渠道。

\n

六、Tweak Manager：逐項啟用，不要把「可安裝」當成「可信」

\n

\n

\n

\n

最小驗收清單

\n

• 關閉 tweak 後，功能與資源是否完全停止？
• tweak 是否讀取目前 repository 以外的檔案？
• 是否新增 MCP server、hook、background process 或開機項目？
• 是否把 telemetry、錯誤日志、提示或程式碼傳到外部？
• 更新是否固定 commit／release，還是每次抓取 main？
• 移除後是否仍留下 runtime、設定、LaunchAgent 或簽署變更？

\n

七、影片中的 Follow Builders／Daily Digest：先驗證來源再摘要

\n

\n

\n

\n

\n

要用官方路線完成相同需求，可建立一個只讀 skill，配合 Web、GitHub connector 或 MCP 讀取已批准來源，再輸出帶連結、日期和「未核實」標籤的摘要。若需要每日自動執行，再使用受支援的 scheduled task 或 automation，毋須為摘要功能 patch App。

\n

八、決策表：甚麼情況用哪一個？

\n

\n\n

九、完整安全提示範本

\n

請先審查這個 Codex 擴充專案，不要安裝、執行或修改我的 Codex App。

來源：
Repository URL：
指定 release／commit：

請回報：
1. 它是 prompt、AGENTS.md、skill、official plugin、MCP、CLI 工具還是 App patch？
2. 安裝會修改哪些檔案、簽署、啟動項目、設定和網絡連線？
3. 會讀取哪些 repository、對話、憑證或外部服務？
4. 所有 install／update／repair／uninstall 指令及其風險。
5. 依賴、postinstall、shell script、下載和遙測。
6. 是否有官方、權限更小的替代方案？
7. 建立測試、safe mode、復原和完整移除清單。

只做靜態審查，等我明確批准後才可執行任何安裝。

\n

外掛的判斷原則很簡單：用最小能力完成需求，讓權限、來源、版本和復原方式都可見。Repomix 可以是好用的上下文工具；Codex++ 也可能提供有趣的實驗性 UI。但當官方 Skills、Plugins、Apps 和 MCP 已存在，任何會 patch App 的方案都應由「預設安裝」降級為「明確風險、隔離環境、能審查才試」。