Claude Code와 Codex를 하나의 팀으로 묶어 지속 가능한 개발 흐름을 만듭니다
여러 개의 터미널 창을 번갈아 가며 에이전트를 돌리던 방식에서 벗어나, 하나의 명령어로 팀을 구성하고 관리하는 장면을 상상해 보세요. OpenRig는 Claude Code와 Codex 같은 개별 에이전트들을 하나의 시스템으로 묶어 주는 다중 에이전트 하네스입니다. 리드 에이전트에게 원하는 결과를 말하면, 전문 에이전트들이 협업하여 결과를 가져오고 필요한 결정을 요청합니다.
YAML로 정의하는 에이전트 팀 구조
OpenRig는 에이전트 팀의 구성을 YAML 파일(RigSpec)로 선언적으로 정의합니다. 이 파일에는 에이전트들이 속한 그룹(Pod), 에이전트 간의 연결 관계(Edges), 그리고 세션이 재부팅된 후에도 상태를 유지하는 정책(Continuity policies)이 포함됩니다. rig up 명령어 하나면 tmux 세션, 하네스, 시작 파일, 준비 상태 확인까지 모두 자동으로 처리됩니다. 기존에 실행 중이던 Claude Code나 Codex 세션도 rig discover로 찾아내어 관리 대상에 편입할 수 있습니다.
터미널 UI와 에이전트 간 소통
TUI(터미널 사용자 인터페이스)를 통해 팀의 토폴로지, 프로젝트, 피드, 시스템 건강 상태를 실시간으로 확인할 수 있습니다. 에이전트 간에는 rig send, rig broadcast, rig chatroom 명령어로 메시지를 주고받으며 협업을 진행합니다. 실행 중인 팀의 구조를 변경해야 할 때는 rig grow나 rig shrink로 좌석(Seat)을 추가하거나 제거할 수 있습니다. 모든 에이전트는 tmux 세션에서 실행되므로, 필요할 때 직접 붙어서 작업을 점검하거나 개입할 수 있습니다.
시스템에 미치는 영향과 보안 설정
OpenRig는 설치 및 실행 과정에서 시스템 파일에 여러 변경 사항을 적용합니다. ~/.tmux.conf에 마우스 지원 설정을 추가하고, ~/.openrig 디렉터리에 인스턴스 상태와 데이터베이스를 생성합니다. Claude Code와 Codex의 설정 파일에도 신뢰 설정(Trust settings)과 활동 훅(Activity hooks)을 기록합니다. 이러한 변경 사항은 에이전트가 작업을 수행할 때 필요한 권한과 컨텍스트를 관리하기 위함입니다. 첫 실행 전에는 rig setup --dry-run으로 변경 사항을 미리 확인하고, 관련 파일의 백업을 권장합니다. 특히 Codex의 경우 워크스페이스에 대한 신뢰 수준을 'trusted'로 설정하며, Claude Code는 편집 허용 모드를 기본으로 적용합니다.
실행 환경과 요구 사항
OpenRig를 실행하려면 Node.js 20, 22, 또는 24와 tmux가 필요합니다. 운영 체제는 macOS와 Linux를 지원하며, Apple silicon Mac에서는 Node.js 22 사용을 권장합니다. 네이티브 Windows는 아직 지원하지 않으며, WSL2는 테스트되지 않았습니다. 서비스 기반 리그(Rig)를 실행하려면 Docker가 추가로 필요합니다. 터미널 워크스페이스를 함께 보기 위해 herdr 또는 cmux를 선택적으로 사용할 수 있습니다. 설치 시 npm install -g @openrig/cli를 사용하거나, Bun을 통해 설치할 수도 있습니다.
시스템 파일 변경에 대한 주의
OpenRig는 에이전트가 안전하게 작업을 수행하도록 시스템 설정을 자동화하지만, 이는 사용자의 로컬 파일 시스템에 직접적인 영향을 미칩니다. 특히 Claude Code와 Codex의 설정 파일에 신뢰 기록과 훅 설정을 작성하므로, 기존 설정이 덮어써지거나 변경될 수 있습니다. README는 이러한 변경 사항이 자동화되며 인터랙티브한 미리보기가 제공되지 않는다고 명시합니다. 따라서 첫 사용 전에는 반드시 관련 설정 파일의 백업을 수행해야 합니다. 또한, 기존에 실행 중이던 세션은 새로 작성된 런타임 설정을 반영하기 위해 재시작이 필요할 수 있습니다. 시스템의 안정성과 데이터 무결성을 위해 이러한 변경 사항을 충분히 이해한 후 사용해야 합니다.