为什么你还需要OpenRig:2026年多智能体编程团队管理终极方案
【免费下载链接】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 装进同一个 "rig" 里,当作一支真正的团队来指挥。你用 YAML 定义团队结构,一条命令启动全部智能体,再用终端界面看清谁在干活、谁在卡住、哪些结果需要你拍板。本文带你看懂 OpenRig 能解决什么问题,以及如何快速拉起你的第一支 AI 编程团队。
一、痛点:单个 AI 编程助手,正在变成"终端会话坟场"
2026 年,AI 编程工具的用法已经从"问一个问题"进化到"派一个任务"。但当你在一个仓库里同时跑多个 agent 时,很快会撞上这堵墙:
- 会话失控:一堆 tmux 窗口各自为政,不知道哪个在跑什么任务;
- 上下文断裂:机器重启后,之前跑了一半的 agent 全部失联;
- 缺少分工:写代码的 agent 自己 review 自己,等于没有 review;
- 无法协作:agent 之间传话靠你人肉复制粘贴。
一句话:你需要的不是更强的单兵,而是一支有指挥、有分工、可恢复的团队。这正是 OpenRig 的定位——它管理的不是一堆智能体,而是"智能体组成团队之后形成的那个系统":哪些会话在运行、彼此如何关联、重启后如何恢复。
A harness wraps a model. A rig wraps your harnesses. (一个 harness 包裹一个模型,一个 rig 包裹你的所有 harness。)
二、核心功能一览:多智能体编程团队管理的 6 件事
OpenRig 的架构是"本地守护进程 + CLI + 终端 UI + MCP 服务器",构建在 tmux 之上。对普通用户来说,你只需要记住这 6 个能力:
| 能力 | 说明 | 对应命令 |
|---|---|---|
| 🧩YAML 定义团队拓扑 | 用 RigSpec 声明 pod、成员、协作边和连续性策略 | rig up |
| 🚀一键启动整支队伍 | 自动创建 tmux 会话、注入身份与启动文件、做就绪检查 | rig up first-project |
| 👀团队状态可视化 | TUI 中以表格和拓扑图查看每个座位的运行时、模型、上下文占比 | rig tui --shared |
| 🧲接管已有会话 | 自动发现 tmux 里已存在的 Claude Code / Codex 会话并纳入管理 | rig discover/rig adopt |
| 💾快照与恢复 | 关机前保存完整团队状态,开机后按名字恢复 | rig down --snapshot/rig up <name> |
| 💬跨 agent 通信 | 给指定座位发消息、广播、开聊天室 | rig send/rig broadcast/rig chatroom |
下面是 TUI 中的真实运行画面:左侧是团队拓扑树,右侧是拓扑图,每个座位都能看到运行时和上下文占用比例——谁快把上下文用完了,一眼可见。
三、快速上手:3 分钟拉起第一支 AI 编程团队
环境要求
- Node.js 20 / 22 / 24(Apple 芯片 Mac 建议 Node.js 22)
- tmux
- macOS 或 Linux(暂不支持原生 Windows,WSL2 未测试)
安装与检查
npm install -g @openrig/cli rig setup --dry-run # 先查看安装计划,再正式执行rig setup会自动检查 tmux、Claude Code、Codex 等前置条件,并汇报"尝试了什么、实际成功了什么"。遇到问题时,用rig doctor做系统体检。
启动首个 rig 并派发任务
cd /path/to/your-repo rig up first-project --cwd . # 启动 2 个 Codex 座位:owner + checker rig tui --shared # 打开共享团队仪表盘然后给"主人"座位派一个边界清晰的任务:
rig send dev-owner@first-project \ '实现一个实用的小改动,记录任务到队列并返回 ID,完成后请 dev-check 审查候选方案。'💡小技巧:给 agent 派任务时,遵循"一个边界清晰的结果 + 指定谁来做验收"的模式,效果远好于模糊的"帮我优化一下"。
在 UI 里查看团队也很简单——点击左侧 Explorer 中的demorig,即可加载它的实时拓扑:
四、看懂 RigSpec:把团队"装进 YAML"
OpenRig 团队的结构定义在 YAML 里,官方称之为RigSpec。仓库里有一份堪称教科书级的完整示例,就是 demo/rig.yaml:
- orch pod:
lead(claude-code)——编排者,负责分派任务 - dev pod:
impl(claude-code)、qa(codex)、design(claude-code)——实现、质检、设计 - rev pod:
r1(claude-code)、r2(codex)——两个独立评审 - infra pod:
daemon与ui两个终端节点
8 个节点、4 个 pod,还定义了协作边(edges):lead把任务委派给impl,qa可以观察impl的工作,r1与r2相互协作。每个 agent 的"人格"则由各自的 agent.yaml 描述(技能、指引、hooks、启动契约),整个团队的协作规范写在 demo/culture.md 里——研究型 rig 用探索型文化,实现型 rig 用"信任但验证"的保守文化。
TUI 打开后,这套结构就变成下面这张图:pod 是分组,节点是座位,连线是协作关系,哪个 agent 用什么运行时(蓝色 Claude、绿色 Codex)一目了然。
在 UI 中点击某个节点(如orch1.lead)的CMUX按钮,还能直接打开该 agent 的真实终端,随时"潜入"一线查看它到底在写什么:
五、不写配置也能开工:内置 Starter Rigs
没想好团队怎么搭?OpenRig 自带了一批"开箱即用"的 rig 蓝图,用rig specs ls即可浏览,规格定义位于 packages/daemon/specs/rigs/:
| Starter Rig | 规模 | 适合场景 |
|---|---|---|
first-project | 2 座位 | 新手首选,最小的"owner + checker"组合 |
conveyor | 4 座位 | Claude + Codex 混合,展示 intake→planning→build→review 的交接流水线 |
product-team | 大编制 | 2 个编排者 + 实现、QA、设计 + 2 个独立评审的完整产品小队 |
adversarial-review | 双评审 | 两个独立评审各查各的,编排者综合结论,分歧即暴露真问题 |
research-team | 研究型 | 探索式文化,适合调研类任务 |
secrets-manager | 服务化 | 由专家 agent 运维一个 HashiCorp Vault 实例(需 Docker) |
rig specs preview product-team --kind rig # 先看蓝图 rig up product-team # 直接拉起进阶玩法:用rig grow/rig shrink在运行中调整团队规模,用rig bundle把团队打包成带 SHA-256 校验的便携归档,跨机器复制你的"整支团队"。
六、架构速览:它凭什么管得住一支 agent 团队?
CLI / TUI / MCP | Hono HTTP daemon(本地守护进程) | Domain services | SQLite + tmux + runtime adapters- CLI:面向人和 agent 的统一命令入口,源码在 packages/cli/;
- TUI:拓扑浏览器,支持表格、图谱、座位详情、Specs、Projects、Feed 等视图,源码在 packages/tui/;
- MCP 服务器:让 agent 可以自管理拓扑(
rig_up、rig_ps、rig_send等工具)——也就是说,lead agent 可以指挥其他 agent,而不仅是人下命令; - 运行时适配器:原生接入 Claude Code、Codex 会话,以及终端节点,核心实现在 packages/daemon/。
每个 agent 都运行在一个你可以随时 attach 进去的 tmux 会话中——OpenRig 不把你关在"黑盒"里,所有操作都保留人工介入的入口。
七、安全须知:OpenRig 会改动你机器上的什么?
安装多智能体工具前,先看清楚它会动哪些文件,这很重要。OpenRig 的行为是透明且写在文档里的(详见 docs/reference/getting-started.md):
rig setup:可能补装缺失工具,并在~/.tmux.conf写入鼠标支持与滚动回看配置;- 守护进程启动:在
~/.openrig下创建实例状态(含数据库与插件资源); - Claude Code:写入工作区信任与引导完成状态,
.claude/settings.local.json会加入上下文收集器配置; - Codex:写入
~/.codex/config.toml,启用 hooks 与信任记录; - 权限底线:YOLO(完全跳过权限确认)默认关闭,需要显式配置才会开启。
⚠️ 官方建议:首次使用前备份相关配置文件。所有启动写入都发生在你的本地机器上,OpenRig 是开源自托管方案,跑在你自己的基础设施上(模型调用费用仍由各服务商收取)。
八、常见问题 FAQ
Q1:必须同时订阅 Claude 和 Codex 吗?不必。最小起步 rigfirst-project使用两个 Codex 座位(需要已登录 Codex,可用codex login status检查);其他 Claude / Codex 组合按所选 rig 决定,按需准备即可。
Q2:Windows 能用吗?暂不支持原生 Windows,WSL2 未做测试。macOS 和 Linux 是受支持平台。
Q3:已有正在跑的 Claude Code / Codex 会话,会被破坏吗?不会。rig discover只是给现有 tmux 会话做"指纹识别",rig adopt将其纳入管理;也可以完全从空白 rig 开始。
Q4:和平台托管的"Managed Agents"有什么不同?OpenRig 开源、自托管、可混编多厂商 agent(Claude Code + Codex 同队),你控制全部基础设施与团队拓扑;托管方案则是云端黑盒。
九、总结:2026 年,给 AI 一支队伍而不是一张嘴
回到标题的问题——为什么你还需要 OpenRig?因为 AI 编程的竞争焦点已经从"哪个模型聪明"转移到了"哪支队伍靠谱":
- 结构化:YAML 定义团队,拓扑、分工、协作边全部显式可见;
- 可恢复:快照 + 按名恢复,重启不再是灾难;
- 可验证:owner 干活、checker 审查、双评审对抗,结果自带质检;
- 可介入:每个座位都是真实 tmux 会话,随时人工下场。
从npm install -g @openrig/cli到第一支团队跑起来,只需几分钟。2026 年多智能体编程团队管理的终极方案,或许不需要你去造一支队伍——先拉起first-project,让 OpenRig 替你管起来。 🚀
【免费下载链接】openrigMulti-agent harness that runs Claude Code and Codex together as one system项目地址: https://gitcode.com/GitHub_Trending/op/openrig
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考