Oct 12, 2026

把 Claude Code 和 Codex 编成一支受管团队

7k 星的 OpenRig CLI 把散落的 agent 终端变成一支 YAML 定义的团队——pod、稳定的席位地址、快照与消息通信,横跨 Claude Code 和 Codex,一条 rig up 命令启动。

#tutorial#ai-agents#developer-tools#workflow

两个终端标签页里的两个编码 agent 不是一支团队——是从没见过彼此工作的两个陌生人。OpenRig 包住你的 harness,正如 harness 包住模型:用 YAML 定义团队,一条命令启动,每个 agent 都拿到一个稳定地址,可以给它发消息、检查状态、重启后恢复。

为什么这个 Skill 重要

OpenRig 是构建在 tmux 和 SQLite 上的本地 daemon、CLI 和终端 UI。一个 rig 是一份声明式 RigSpec:seat 组成 pod,pod 之间连边,外加延续性策略。seat 是稳定地址,比如 dev-build@starter——占用它的对话可以换,身份和它沉淀下来的上下文不变。rig 可以按名字快照和恢复,已在 tmux 里跑着的会话可以直接收编而不必重启,团队开箱即用:starter 给一次有界变更配一对 Claude Code 构建者加 Codex 审查者,workshop 为持续工作加上 lead 和 QA,factory 用七个 agent 承接长期产品工作。它是 Apache-2.0 的自托管软件,直接读你已有的订阅——不需要第二个。

安装

需要 Node.js 22 或 24、tmux,以及 macOS 或 Linux——Windows 上支持的路线是 WSL2,Apple silicon 上 README 要求用 Node 22。分步安装:

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

--providers 是你选定 Claude Code、Codex 或两者的地方;dry run 会先预览 setup 将要改动的全部内容。rig setup 会在缺失时安装 harness,往 ~/.tmux.conf 写入一个 OpenRig 配置块,并默认安装 herdr 终端工作区(不想装就加 --no-herdr)。README 的建议:运行之前先读它的 What OpenRig changes on your machine 一节并备份相关文件——setup 和启动会写入信任设置和可执行钩子。装完用 tmux -V 加上你那个 provider 的 claude auth status 或 codex login status 核对。

实战:通过 starter 完成一次有界变更

  1. 在你的仓库里,手动预览并启动 starter 团队:
cd /path/to/your/repository
rig specs preview starter --kind rig
rig up starter --cwd . --plan
rig up starter --cwd .
  1. 派活之前先检查就绪状态——rig ps --nodes --rig starter——并处理它报告的认证或权限提示(如果有 seat 停在了提示上,rig ps 会显示出 rig seat continue <seat> 命令,执行后它的启动上下文才会送达)。
  2. 给构建者一个有界的成果:
rig send dev-build@starter 'Implement <one useful change>. Track the task in the queue and return its ID. Keep it local, verify the behavior, ask dev-review in this rig to check the exact candidate, and record the result and how I can try it.'
  1. 发消息本身不创建队列任务——任务由构建者记录。用 rig queue list --destination dev-build@starter --limit 1000 跟踪进度,然后阅读最终产物和针对该候选的审查意见。

收工时 rig down --snapshot 捕获全部状态,rig up <name> 恢复——每个节点的恢复结果会告诉你哪些 seat 顺利续跑、哪些需要关注。

技巧

  • 觉得手动路径麻烦就开口让 agent 来:安装之后它可以打开 OpenRig TUI 和 kernel 操作员,后者会根据你已有的 provider 推荐三支团队之一。
  • 三支主力团队之外还有专项团队:code-review、research、pm,以及 secrets-manager——一个由专项 agent 运维的 HashiCorp Vault 实例(需要 Docker)。
  • 用 rig send、rig broadcast 或 rig chatroom 让 agent 互通消息;用 rig grow、rig shrink、rig remove 演进运行中的拓扑。
  • 权限提升是显式的:YOLO 默认关闭,seat 的默认策略允许 Claude 跑普通的 rig 命令,而 rig up 这类生命周期命令仍会询问;更大的权限只出现在单独说明的 workshop bundle 里。
  • 已经在 tmux 里跑着 agent?rig discover 指纹识别它们,rig adopt 直接收编,无需重启。

何时不用这个 Skill

没有原生 Windows——支持的路线是 WSL2,而且自动化测试目前还不能在 WSL2 上运行。如果你的工作就是单个 agent 加单个任务,这套机制的操作成本会超过它省下的时间。另外 OpenRig 管团队不管账单:它是自托管的,所选 provider 的模型用量费用照常产生。


查看 排行榜 了解更多 skill。