# 什麼是 Oh My Codex (OMX)？將 OpenAI Codex CLI 轉變為多代理編碼團隊的協調層

Oh My Codex (OMX) 是 OpenAI Codex CLI 的開源工作流層。了解它如何添加多代理團隊、tmux 協調、持久記憶、鉤子以及像 $team 和 autopilot 這樣的結構化工作流程。

Canonical URL: https://a2a-mcp.org/blog/what-is-oh-my-codex-zh-TW

Language: zh-TW

Published: 2026-04-07

Updated: 2026-04-07

## 主要重點

- **Oh My Codex (OMX)** 是一個開源的協調層，建構在官方 OpenAI Codex CLI 之上，增加了多智能體協調、持久狀態、鉤子與結構化工作流程，而無需替換核心 Codex 執行引擎。
- 專案架構分析顯示 OMX 的功能類似於 **oh-my-zsh 之於 Codex**：它提供可重用的技能（$deep-interview、$ralplan、$ralph、$team）、33 種專屬智能體提示，以及基於 tmux 的平行工作器，同時 Codex 負責實際的推理與程式碼生成。
- GitHub 和 Discord 上的社群回饋表明，OMX 透過隔離的 git worktree 實現安全的平行開發，並透過 `.omx/` 目錄與彈性的筆記本記憶，減少複雜專案中的上下文遺失。
- 安裝與設定僅需不到 2 分鐘：先執行 `npm install -g oh-my-codex`，再執行 `omx setup`；它支援 macOS/Linux 上的 tmux 或 Windows 上的 psmux。
- 進階功能包含自主研究、自動駕駛模式、OpenClaw 通知整合，以及根據任務複雜度進行模型路由，使其成為大型重構、全端建置與團隊式 AI 開發的理想選擇。

## Oh My Codex 是什麼？

Oh My Codex，簡稱 **OMX**，是為 [OpenAI Codex CLI](https://github.com/openai/codex) 設計的專屬工作流程與協調層。主要由 Yeachan Heo 開發，並由 HaD0Yun 等維護者貢獻，它解決了基礎 Codex CLI 的關鍵限制——例如缺乏原生的多智能體支援、鉤子、會話持久性與進階執行時工具——同時保持 Codex 作為主要的執行引擎。

專案文件與 v0.10.0 發布說明證實，OMX 並未分叉或修改 Codex 本身。相反，它以增強的提示、技能、狀態管理與 tmux 驅動的平行處理來包裝會話。其概念模型很直接：Codex 負責智慧型編碼任務；OMX 則處理任務路由、團隊協調與開發者體驗。

來自實際示範與使用者報告的基準測試顯示，OMX 透過啟用協調的智能體「團隊」來加速複雜工作流程，其中一個專精於規劃，另一個於執行，第三個於驗證——從而減少多檔案變更或架構層級決策中的錯誤。

## Oh My Codex 的核心特色

OMX 透過幾個緊密整合的系統，提供生產級別的強化功能：

- **透過 tmux 進行多代理協同作業**：在隔離的 git 工作樹 (`.omx/team/<name>/worktrees/worker-N`) 中生成平行工作程序。這能防止同時編輯時發生寫入衝突。
- **結構化技能與關鍵字**：內建命令如 `$deep-interview` 用於澄清意圖，`$ralplan` 用於包含權衡審查的共識規劃，`$ralph` 用於持久執行「巨石級」任務直至驗證完成，以及 `$team N:executor` 用於平行團隊。
- **持久狀態與記憶**：`.omx/` 目錄儲存計劃、日誌、專案記憶 (`.omx/project-memory.json`) 以及一個能在上下文修剪後存續的優先級筆記系統。
- **掛鉤與抬頭顯示器**：可擴展的掛鉤 (`.omx/hooks/*.mjs` 和 Codex 原生的 `.codex/hooks.json`) 加上即時抬頭顯示器 (`omx hud --watch`) 用於即時監控。
- **33 個專業代理提示詞**：組織成建構/分析、審查、領域和協調通道——透過 `AGENTS.md` 自動載入。
- **自主與進階模式**：用於端到端執行的自動駕駛、自主研究 (`omx autoresearch`)、極限工作以實現最大平行度，以及根據複雜性進行智能模型路由。

這些功能將模糊的提示轉變為可靠的多步驟交付成果。

## Oh My Codex 如何運作：技術深度解析

當使用 `omx` 啟動時，OMX 會初始化一個增強的 Codex 工作階段。它注入標準提示詞、安裝技能、生成 `AGENTS.md` 用於委派規則，並為狀態、記憶、程式碼智能（LSP 工具、AST grep）以及團隊協同作業配置 MCP 伺服器。

**核心工作流程管道**（如官方示範所示）：

1. **意圖分類與深度訪談** — 在執行前減少模糊性。
2. **規劃與核准** — 使用 `$ralplan` 達成架構共識。
3. **團隊執行** — 生成具有隔離工作樹的 tmux 窗格；工作程序在報告完成前提交變更。
4. **驗證與合併** — 領導者透過策略如 `--no-ff -X theirs` 或 cherry-pick 逐步合併；衝突會自動記錄。

**範例團隊命令**：

```bash
omx team 3:executor "parallelize auth migration across modules"
```

該系統包含安全無爭議的任務生命週期、工作程序間的郵箱訊息傳遞，以及能在工作階段中斷後存續的持久狀態。

**進階技巧**：在相容的設定中，可使用 `OMX_TEAM_WORKER_CLI_MAP=codex,codex,claude` 來建立混合供應商的團隊，儘管主要焦點仍保持在 Codex 原生環境。

## Oh My Codex 與 Base Codex CLI 及其他工具的比較

| 面向                     | OpenAI Codex CLI (基礎版)       | Oh My Codex (OMX)                         | Cursor / Claude Code                 |
|-------------------------|---------------------------------|-------------------------------------------|--------------------------------------|
| **執行引擎**            | 單一代理                        | 協調多個 Codex 代理 + 技能                | 編輯器優先或單一代理專注             |
| **多代理支援**          | 無                              | 原生 tmux 團隊與工作樹隔離                | 有限或新興                           |
| **持久狀態**            | 僅限工作階段                     | `.omx/` 目錄 + 筆記本記憶                 | 僅限專案上下文                       |
| **鉤子與擴展性**        | 基礎                            | 完整自訂鉤子 + OpenClaw 整合              | 擴展/插件                            |
| **工作流程**            | 手動提示                        | 預建：自動駕駛、$ralph、$team             | GUI 驅動                            |
| **安全與監控**          | 無                              | 安全鉤子 + 即時 HUD                       | 視情況而定                           |

OMX 在 CLI 優先、大規模工程中表現出色，尤其是在協調與並行性至關重要的情況下。

## 安裝、設定與常見陷阱

**快速開始**（兩分鐘內）：

```bash
npm install -g @openai/codex oh-my-codex
omx setup
omx doctor
omx --madmax --high
```

**常見陷阱**及如何避免：

- **忘記 `omx setup`** — 會跳過提示/技能安裝與 `AGENTS.md` 生成，導致工作階段效果不佳。
- **Intel Mac 高 CPU 使用率** — 由 Gatekeeper 引起；可使用 `xattr -dr com.apple.quarantine $(which omx)` 並降低並行標誌來緩解。
- **團隊模式未清理工作區** — 領導者必須在開始前暫存/提交；否則工作樹會失敗。
- **忽略工作人員提交協議** — 代理必須執行 `git add -A && git commit`，否則運行時將自動提交作為備案。
- **鉤子預設為停用** — 透過 `OMX_HOOK_PLUGINS=1` 啟用以確保生產環境安全。

**進階技巧**：在委派前，使用 `omx explore --prompt "..."` 進行唯讀倉庫分析，或使用 `omx sparkshell` 進行安全的 Shell 檢查。

## 邊緣案例與進階使用情境

- **大型重構**：將整個 TypeScript 程式碼庫輸入 OMX，透過協調代理進行乾淨的 Python 重寫。
- **長時間運行的專案**：持久的 `.omx/state/` 和筆記本支援跨天的可恢復工作階段。
- **生產環境整合**：OpenClaw 鉤子可針對工作階段事件、閒置狀態或用戶問題發送通知。
- **自訂擴展**：透過插件系統添加技能，或擴展 MCP 工具進行 Python REPL 資料分析。

這些功能使得 OMX 在自主研究、完整應用程式引導或需要深入訪談式澄清的實驗中尤其強大。

## 結論

Oh My Codex 透過將強大的單一代理轉變為協調有序、具狀態的團隊，代表了 CLI 基於 AI 編碼的下一個演進階段。對其架構和實際使用情況的分析顯示，它為複雜的開發任務帶來了可靠性、速度和安全性方面可衡量的提升。

準備好升級你的 Codex 工作流程了嗎？立即運行 `npm install -g oh-my-codex && omx setup`，並在你的下一個模糊需求上開始使用 `$deep-interview`。官方儲存庫和文件提供了開始大規模協調所需的一切。