技能包

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 能容纳的成员数量上限，官方说明中均未找到。