技能包

OpenRig：用 YAML 把 Claude Code 與 Codex 編成一個 agent 團隊

想把 Claude Code 與 Codex 編成一個由 YAML 定義、一條指令啟動的 agent 團隊時選它；開始前需備齊 Node.js 22 或 24 與 tmux，並注意 rig setup 會向 ~/.tmux.conf 附加設定且預設安裝 Herdr（--no-herdr 可略過）。

官方來源 · OpenRig

安裝

npx skills add https://github.com/mvschwarz/openrig/tree/v0.7.0/skills/rigs --skill rigs --agent claude-code

適合誰

OpenRig 適合想把多個 coding agent 編成一個固定團隊的開發者：一個 rig 包裹你的 harness，用 YAML 定義 agent 團隊，然後一條指令啟動。它最突出的能力，是在同一個 rig 裡同時執行 Claude Code 和 Codex，並作為一個系統統一管理。它的價值點就在「團隊」：與其在多個終端機視窗裡分別照看各個 agent，不如把成員寫進同一份 YAML，交給一條指令和統一的就緒檢查來管理。

開始前先核對環境，四項都滿足再往下走：Node.js 22 或 24（Apple silicon 機型用 22）、tmux、macOS 或 Linux（Windows 走 WSL2），以及已登入的 Claude Code 或 Codex。任何一項不滿足就先補齊，光是這一步就能省掉後面大多數錯誤。如果你只用其他 agent、留在 Windows 原生環境或使用別的 Node 版本，官方沒有說明支援情況，先當作未確認。

反過來看，三類情況先不要用：只習慣圖形介面、不想寫設定的使用者；需要在 Windows 原生環境（非 WSL2）直接執行的使用者；想搭配 Claude Code 與 Codex 之外用戶端的使用者——官方說明沒有涵蓋這些用法。換句話說，如果你平時只執行一個用戶端、也用不上統一啟動，rig 的團隊結構帶來的收益有限。

3 分鐘完成第一次嘗試

推薦主路徑只有一條：用官方給出的安裝指令把 rigs skill 裝進 Claude Code，前提是上一節環境已就緒。在終端機執行：

npx skills add https://github.com/mvschwarz/openrig/tree/v0.7.0/skills/rigs --skill rigs --agent claude-code

指令裡的 v0.7.0 是官方頁面給出的固定版本路徑，照原樣複製即可。安裝完成後，用 YAML 寫下你的 agent 團隊定義；順序是安裝 skill、寫 YAML、按需初始化（rig setup）、啟動（rig up）。官方只說明團隊用 YAML 定義、一條指令啟動，沒有給出欄位、範例或檔案位置，設定細節以安裝後 skill 自帶說明為準，不要憑猜測編寫。

接著是初始化。在執行 rig setup 之前，先了解它的副作用：它會向 ~/.tmux.conf 附加一個 OpenRig 區塊；在 macOS 上可以經 Homebrew 安裝 tmux；除非傳入 --no-herdr，否則還會安裝 Herdr。這就是執行前的確認點——不想引入 Herdr，就帶上 --no-herdr 再執行。

最後啟動：執行 rig up，由它拉起 tmux 會話、各 harness、啟動檔案，並執行就緒檢查。你能觀察到的成功訊號：tmux 裡出現團隊對應的會話，各 harness 啟動，就緒檢查逐項給出結果。如果 tmux 裡沒有會話或就緒檢查報錯，先回到環境清單核對 Node 版本與 tmux。官方未說明 rig up 是否會修改檔案或存取網路，這一點未確認；到此為止也還沒有讓任何成員執行實際任務，先確認啟動正常，再交給它真正的工作。

使用案例

案例一：讓 Claude Code 與 Codex 同隊協作。場景：你兩個用戶端都在用，希望它們處在同一個被統一管理的系統裡。做法：裝好 rigs skill 後，在團隊 YAML 中把兩個 harness 都定義進去，然後執行 rig up。可期待的結果：兩者作為同一個系統被啟動，tmux 中出現各自的會話，就緒檢查逐項給出結果，兩個成員都在 tmux 裡可見，便於對照。

案例二：把每天開工的環境準備收斂成一條指令。場景：不想每次手動開 tmux、逐個拉起各成員。做法：團隊 YAML 定義好之後，每次開工直接執行 rig up，由它負責 tmux 會話、harness、啟動檔案與就緒檢查。可期待的結果：重複的準備動作壓縮成一條指令，就緒檢查的結果直接告訴你團隊是否就緒。

兩個案例可以連起來做：先用案例一確認編隊本身可行，再把它變成案例二那樣的日常固定入口。兩個案例都止於官方說明涵蓋的步驟：團隊成員啟動之後如何分工、具體執行什麼任務，官方沒有給出範例，這裡不虛構。

使用邊界

  • 環境與用戶端：官方只列出 Node.js 22 或 24（Apple silicon 為 22）、tmux、macOS/Linux（WSL2）與已登入的 Claude Code 或 Codex；其他用戶端、Windows 原生環境、其他 Node 版本均未確認。
  • 安裝面與版本：安裝透過 npx skills add 完成，官方指令明確綁定 --agent claude-code；官方說明未提供外掛市集或其他用戶端的等價安裝方式，不要自行類推。安裝路徑固定指向 v0.7.0，升級方式未說明。
  • 副作用與確認點：rig setup 會向 ~/.tmux.conf 附加 OpenRig 區塊，可能經 Homebrew 安裝 tmux，且除非傳入 --no-herdr，否則會安裝 Herdr；執行前確認你接受這些變更。
  • 團隊定義：YAML 的具體欄位、範例與檔案位置不在官方說明內，不要憑猜測編寫設定。
  • 就緒檢查：由 rig up 執行，但檢查的具體項目與失敗後的行為官方未說明；以指令輸出為準，不要假設會自動重試或回復。
  • 任務行為：OpenRig 做的是團隊編排，官方說明未涉及改寫文字或修改使用者檔案；成員 agent 執行時的檔案、指令與網路行為取決於你選用的用戶端本身，本文不額外下安全結論。
  • 未確認項：授權與定價、解除安裝方式、rig up 的退出與清理行為、單一 rig 能容納的成員數量上限，官方說明中均未找到。