OpenRig新手教程：用first-project起步团队完成仓库里的第一个有用改动

【免费下载链接】openrigMulti-agent harness that runs Claude Code and Codex together as one system项目地址: https://gitcode.com/GitHub_Trending/op/openrig

OpenRig 是一个多智能体协作框架（Multi-agent Harness），它把 Claude Code 和 Codex 编排成一个统一管理的团队。本教程带你用内置的first-project起步 rig，在你的仓库里完成第一个被独立审查过的有用改动。

为什么选择 OpenRig：告别零散的终端会话

用过 Claude Code 或 Codex 的开发者都知道：开 3 个终端跑 3 个智能体，很快就变成一堆互不相关的会话——没人知道谁在干什么、谁该复查谁的代码，重启后一切上下文也消失了。

OpenRig 的思路是：harness（框架）包裹单个模型，而 rig（编队）包裹你的所有 harness。你用一份 YAML 定义团队结构，一条命令启动整个团队，每个智能体都有稳定的"座位"（Seat）和地址（如dev-owner@first-project）。对话可以换，座位和它积累的上下文始终留在同一个地址上。

环境要求与安装步骤

先确认系统要求

快速安装 OpenRig

npm install -g @openrig/cli rig setup --dry-run

--dry-run会先展示安装计划而不实际改动系统。确认无误后再正式执行rig setup。

⚠️ 温馨提示：OpenRig 在启动过程中会写入工作区信任设置和 provider hooks（如~/.claude.json、~/.codex/config.toml）。官方建议在首次运行前阅读 README 中的说明并备份相关文件。

用 first-project 启动你的第一个团队

first-project是专为首次使用设计的两座位起步 rig：

• dev-owner（Codex）：成果负责人，负责实现改动
• dev-check（Codex）：独立检查者，负责审查确切的候选版本

两者同在一个devpod 内，由一条delegates_to边连接。定义见 first-project/rig.yaml。

三步启动：计划、启动、打开仪表盘

cd /path/to/your/repository rig up first-project --cwd . --plan # 先查看启动计划 rig up first-project --cwd . # 正式启动 rig tui --shared # 打开共享仪表盘

--plan会先展示将要执行的操作；rig tui --shared打开后按Ctrl-b 然后 d可分离（detach）仪表盘而不停止团队。

检查项目座位就绪状态

启动后先用rig ps --nodes --rig first-project确认两个座位都已就绪，处理掉任何认证、信任或权限提示。座位就绪是分配工作前的必要一步。

分配第一个任务并跟踪队列

给 dev-owner 一个边界清晰的成果请求（官方推荐的任务模板）：

rig send dev-owner@first-project 'Implement <一个有用的小改动>. Track the task in the queue and return its ID. Keep it local, verify the behavior, ask dev-check@first-project to check the exact candidate, and record the result and how I can try it.'

然后跟踪任务队列：

rig queue list --destination dev-owner@first-project --limit 1000

💡 注意：发送消息本身不会创建队列条目，而是由 owner 在任务中标记。收到结果后，阅读最终产物和 dev-check 对候选版本的审查记录，然后回到同一个 owner 地址分配下一个改动——上下文是延续的。

团队运行起来之后

启动后可以在 TUI 中随时查看团队状态：拓扑图（Graph）、座位表格（Table）、健康度（Health）。下图左侧 Explorer 中点击 rig 即可加载其实时拓扑：

进入拓扑视图后，可以点击每个座位的CMUX按钮直接打开该智能体的终端——比如点开 lead 节点直接与编排者对话：

想体验更大的团队？

仓库里的 demo/ 目录是一个 8 节点、4 pod 的完整示例团队（lead、impl、qa、design、r1、r2 等），适合观察编排者如何分发任务、QA 如何观察实现者、评审者如何协作：

./demo/run.sh

常见问题与下一步

继续深入的资料：

• 完整的引导式上手路径：docs/reference/getting-started.md
• RigSpec 规范详解：docs/reference/rig-spec.md
• 更大的产品团队示例：rig up product-team（两个编排者 + 实现、QA、设计、独立评审）

从first-project开始，你会体会到多智能体协作最舒服的一点：团队的工作和上下文都留在固定地址上，你只需要在下一个改动时回来继续。

【免费下载链接】openrigMulti-agent harness that runs Claude Code and Codex together as one system项目地址: https://gitcode.com/GitHub_Trending/op/openrig