企业官网建设流程全解析

OpenRig环境准备清单：tmux、Codex登录与前置依赖逐项核查教程

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

为什么你需要这份 OpenRig 环境准备清单

OpenRig是一个多智能体运行框架（harness），可以把Claude Code和Codex装进同一个 "rig" 中，作为一支可管理的 AI 编码团队来运行。新手最常卡住的环节不是代码，而是环境准备：tmux 没装、Codex 没登录、Node 版本不对，都会导致rig up启动失败。

本教程给你一份逐项核查的环境准备清单，按顺序执行一遍即可确认你的 macOS / Linux 机器满足所有前置依赖。

第1步：确认操作系统与 Node.js 版本

OpenRig 只支持macOS 和 Linux（原生 Windows 暂不支持，WSL2 未测试）。

• 需要Node.js 20、22 或 24
• Apple 芯片的 Mac 请使用Node.js 22（见 docs/releases/v0.5.15.md 中的兼容性说明）

node -v

版本低于 20 时，preflight 检查会直接报错——OpenRig 内置的前置检查逻辑位于 packages/cli/src/system-preflight.ts，Node 版本不足时它会给出明确的修复建议。

第2步：安装 OpenRig 并先做 dry-run

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

关键原则：先--dry-run查看计划，再实际应用。rig setup会检查并尝试安装缺失工具，并在~/.tmux.conf中写入 OpenRig 配置块（鼠标支持、滚动缓冲区），详见 packages/cli/src/commands/setup.ts 中的步骤定义。

⚠️ 首次使用前，建议先备份~/.claude.json、~/.codex/等配置文件，因为 OpenRig 会写入信任设置与钩子（见 README.md 的完整说明）。

第3步：核查 tmux 是否可用

tmux 是 OpenRig 的"地基"——每个智能体都运行在一个独立的 tmux 会话中，你可以随时 attach 进去直接观察。

tmux -V

• macOS：brew install tmux
• Debian/Ubuntu：apt install tmux

检查逻辑位于 packages/cli/src/tmux-health.ts，它不只检查命令存在，还会探测 tmux 控制端是否真正可用。装完后再跑一次tmux -V确认。

第4步：安装并登录 Codex

first-project起步 rig 提供两个原生 Codex 座位（owner 与 checker），所以Codex 登录是硬性前置条件，缺失它会成为真实的启动阻塞项（见 docs/reference/getting-started.md）。

codex --version # 确认已安装 codex login # 未登录时执行 codex login status # 确认登录状态

OpenRig 对 Codex 凭据采用"密钥安全"设计：认证文件位于$HOME/.codex（可用CODEX_HOME覆盖），CLI 只读取结构化状态（是否存在、是否可解析、登录状态），绝不回显令牌内容，实现见 packages/cli/src/lib/codex-auth.ts。

第5步：用内置命令做最终核查

逐项手动检查完成后，可以用 OpenRig 自带的三个核查命令做"总验收"：

例如：

cd /path/to/your/repository rig requirements <rig-spec>.yaml

输出中所有条目显示OK即代表该 rig 声明的依赖全部满足；出现MISSING就先补装对应工具。

第6步：试启动，确认环境真正就绪

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

在启动视图里点击 demo rig，可以在浏览器 UI 中查看 rig 列表：

在拓扑视图中点击某个座位的 CMUX 按钮，可直接进入该智能体的终端：

用rig ps --nodes --rig first-project检查每个座位的 readiness。如果某个座位停留在认证、信任或权限提示上，先解决提示再分配任务——daemon 正常 ≠ 每个座位都就绪，这是新手最常混淆的一点。

启动成功后，TUI 会以拓扑图展示整支团队：

环境准备核查清单（可对照打勾）

1. ✅ macOS 或 Linux，Node.js 20 / 22 / 24（Apple Silicon 用 22）
2. ✅npm install -g @openrig/cli安装成功
3. ✅rig setup --dry-run计划已审查并应用
4. ✅tmux -V有版本输出
5. ✅codex --version有版本输出
6. ✅codex login status显示已登录
7. ✅rig doctor与rig requirements无 fail / MISSING
8. ✅ 关键配置文件（~/.claude.json、~/.codex/）已备份

全部打勾后，你就可以放心运行rig up first-project，正式让 Claude Code 和 Codex 在同一个 rig 里协作了。完整的新手路径参考 README.md 与 docs/reference/getting-started.md。

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