OpenRig安装全攻略Node.js 20/22/24版本选择与Apple Silicon避坑指南【免费下载链接】openrigMulti-agent harness that runs Claude Code and Codex together as one system项目地址: https://gitcode.com/GitHub_Trending/op/openrigOpenRig 是一个开源的多智能体编排框架multi-agent harness让 Claude Code 和 Codex 两个 AI 编程助手在同一个系统里组队干活。安装它只需要三个硬前提Node.js 20/22/24偶数 LTS 版本、tmux、macOS 或 Linux而 Apple Silicon 的 Mac 必须选Node.js 22。下面讲清楚版本怎么选、三步怎么装、以及最常见的坑怎么绕。一、环境需求速览装 OpenRig 前的 3 个前提项目要求说明Node.js20 / 22 / 24偶数 LTS21、23、25 等奇数版不受支持tmux必须所有 agent 会话的载体操作系统macOS 或 Linux原生 Windows 暂不支持WSL2 未测试官方声明见 README.md 的 Requirements 章节根目录 package.json 与 packages/daemon/package.json 都写死了只接受偶数 LTS 的 Nodecheck-engines.test.mjs 还会在 CI 里守住这条约束。为什么只要偶数 LTSOpenRig 的 CLI 依赖原生模块 better-sqlite3它需要各 Node 版本对应的预编译二进制。奇数版21/23/25通常没有这些预编译包装上去要么编译失败要么运行时崩溃。二、Node.js 版本怎么选20、22 还是 24结论先行Apple Silicon 选 22其余环境 22 或 24 都稳保守党选 22。Apple SiliconM 系列Mac务必用Node 22。这是本次避坑的核心——macOS arm64 上配合 Node 24 安装 SQLite 依赖时可能因缺少预编译二进制且本机没有可用编译器而直接失败即使用编译器现编运行时清理数据库也可能出错。官方在 v0.5.15 发布说明的已知兼容性限制 中明确建议macOS arm64 暂时请用 Node 22。Intel Mac / Linux20、22、24 均可推荐 22 求稳或 24 尝鲜。奇数版 21/23/25不要选装包时就会被拦下。安装成功后进入终端 UITUI在左侧资源管理器点击 demo rig即可加载这支由 Claude Code 与 Codex 组成的多智能体团队的实时拓扑。OpenRig 的守卫机制很贴心安装时 postinstall 会执行 check-abi.mjs做两层检查——先查版本是否为 ≥20 的偶数 LTS再真正加载一次 better-sqlite3 以捕捉 NODE_MODULE_VERSION 不匹配。任何一层不过都会打印一个清晰的错误框并附上可直接粘贴的修复命令nvm install 22 npm install -g openrig/cli三、快速安装三步走第 1 步确认 Node 版本装好 tmuxnode -v # 应为 v20 / v22 / v24 brew install tmux # macOSDebian/Ubuntu 用apt install tmux第 2 步全局安装 OpenRig CLInpm install -g openrig/cli第 3 步先演练再落地rig setup --dry-run # 只显示准备做什么不改动机器 rig setup # 执行机器准备rig setup会尝试补齐 tmux、cmux、Claude Code、Codex 等工具并向~/.tmux.conf写入 OpenRig 配置块鼠标支持与回滚缓冲。它会在你的机器上写入哪些文件、为什么写详见 README 的「What OpenRig changes on your machine」 章节建议首次运行前先读一遍并备份相关文件。 想用 Bun 安装bun add -g openrig/cli。注意 OpenRig 仍在 Node.js 上运行所以 Node 22 依然要装好且 Bun 可能拦截 postinstall 检查SQLite 校验就不会在安装时执行。四、Apple Silicon 避坑清单3 个高频故障现象原因解法better-sqlite3 装不上 / 找不到预编译包Apple Silicon 配了 Node 24nvm install 22 npm install -g openrig/cli提示「不支持奇数 Node」正在用 21/23/25切到 22 或 24 重装NODE_MODULE_VERSION 不匹配装完后换过 Node旧原生模块残留npm rebuild better-sqlite3或换回正确的 Node 重装避坑口诀M 系列 Mac 先nvm install 22再装 OpenRig。注意这只是针对 arm64 的 SQLite 现状的临时建议并不改变官方声明的 20/22/24 支持范围。五、安装后验证启动第一支多智能体团队进入目标仓库按顺序验证并启动完整引导见 getting-started 指南tmux -V # tmux 可用 codex --version # Codex 已安装 codex login status # Codex 已登录 rig up first-project --cwd . --plan # 先查看启动计划 rig up first-project --cwd . # 正式启动 rig tui --shared # 打开共享仪表盘first-project是最小的两席团队owner 负责人 checker 检查者。启动后在 TUI 拓扑图里可以看到每个座位的运行时、模型、上下文用量与状态按Ctrl-b再按d可分离终端而不中断团队rig tui --shared随时回来看板。这些启动前的检查Node 版本、tmux、可写目录、守护进程端口逻辑都在 system-preflight.ts 中每项失败都会附带原因和修复命令照着做即可。六、常见问题速查端口被占用用rig config set daemon.port 新端口换端口或查一下占用该端口的进程。机器层面出状况跑rig doctor体检支持--json输出方便交给 agent 自动处理。Windows 用户原生 Windows 暂不支持、WSL2 未测试建议使用 macOS 或 Linux。相关资源路径安装与需求声明README.mdApple Silicon 兼容性说明docs/releases/v0.5.15.md安装后 ABI 守卫脚本packages/cli/scripts/check-abi.mjs版本约束测试scripts/check-engines.test.mjs系统预检源码packages/cli/src/system-preflight.ts【免费下载链接】openrigMulti-agent harness that runs Claude Code and Codex together as one system项目地址: https://gitcode.com/GitHub_Trending/op/openrig创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考