OpenRig: YAML로 Claude Code와 Codex를 하나의 agent 팀으로 묶기

누구에게 적합한가

OpenRig는 여러 코딩 agent를 고정 팀으로 편성하고 싶은 개발자에게 적합합니다. rig는 여러분의 harness를 감싸고, YAML로 agent 팀을 정의한 뒤 명령 한 줄로 시작합니다. 가장 두드러진 능력은 같은 rig 안에서 Claude Code와 Codex를 동시에 실행하고 하나의 시스템으로 통합 관리하는 것입니다. 가치의 핵심은 '팀'에 있습니다. 여러 터미널 창에서 각 agent를 따로 돌보는 대신, 구성원을 하나의 YAML에 적어 넣고 명령 한 줄과 통합된 준비 검사에 맡기는 편이 낫습니다.

시작하기 전에 환경을 확인하고 네 항목이 모두 충족될 때 진행하세요. Node.js 22 또는 24(Apple silicon은 22), tmux, macOS 또는 Linux(Windows는 WSL2), 그리고 로그인된 Claude Code 또는 Codex. 하나라도 부족하면 먼저 채우세요. 그것만으로 이후 오류의 대부분을 피할 수 있습니다. 다른 agent만 사용하거나, Windows 네이티브 환경에 머물거나, 다른 Node 버전을 쓴다면 공식 문서는 지원 여부를 설명하지 않으므로 우선 미확인으로 취급하세요.

반대로 다음 세 가지 경우에는 아직 쓰지 마세요. 그래픽 인터페이스에만 익숙하고 설정을 직접 쓰고 싶지 않은 사용자. Windows 네이티브 환경(WSL2 아님)에서 직접 실행해야 하는 사용자. Claude Code와 Codex 외의 클라이언트와 함께 쓰고 싶은 사용자. 공식 문서는 이러한 용법을 다루지 않습니다. 다시 말해, 평소에는 클라이언트를 하나만 실행하고 통합 기동도 필요 없다면 rig의 팀 구조가 주는 이득은 제한적입니다.

3분 만에 첫 시도

권장 메인 경로는 하나뿐입니다. 공식 설치 명령으로 rigs skill을 Claude Code에 설치합니다. 앞 절의 환경이 갖춰져 있어야 합니다. 터미널에서 실행하세요:

npx skills add https://github.com/mvschwarz/openrig/tree/v0.7.0/skills/rigs --skill rigs --agent claude-code

명령의 v0.7.0은 공식 페이지가 제시하는 고정 버전 경로이므로 그대로 복사하면 됩니다. 설치가 끝나면 YAML로 agent 팀 정의를 작성합니다. 순서는 skill 설치, YAML 작성, 필요 시 초기화(rig setup), 기동(rig up)입니다. 공식 문서는 팀이 YAML로 정의되고 명령 한 줄로 시작된다고만 설명할 뿐 필드, 예시, 파일 위치를 제공하지 않습니다. 설정 세부사항은 설치 후 skill에 포함된 안내를 기준으로 하고, 추측으로 작성하지 마세요.

다음은 초기화입니다. rig setup을 실행하기 전에 부작용을 먼저 파악하세요. ~/.tmux.conf에 OpenRig 블록을 추가합니다. macOS에서는 Homebrew로 tmux를 설치할 수 있습니다. --no-herdr를 전달하지 않으면 Herdr도 설치합니다. 이것이 실행 전 확인 지점입니다. Herdr를 원하지 않으면 --no-herdr를 붙여 실행하세요.

마지막은 기동입니다. rig up을 실행하면 tmux 세션, 각 harness, 시작 파일이 뜨고 준비 검사가 실행됩니다. 관찰할 수 있는 성공 신호는 이렇습니다. tmux에 팀에 해당하는 세션이 나타난다. 각 harness가 시작된다. 준비 검사가 항목별로 결과를 알려 준다. tmux에 세션이 없거나 준비 검사가 오류를 내면 먼저 환경 목록으로 돌아가 Node 버전과 tmux를 확인하세요. rig up이 파일을 수정하거나 네트워크에 접근하는지는 공식 문서에 설명이 없어 미확인입니다. 이 시점까지는 어떤 구성원도 실제 작업을 수행하지 않았으므로, 기동이 정상인지 확인한 뒤 진짜 일을 맡기세요.

사용 사례

사례 1: Claude Code와 Codex를 한 팀에서 협업시키기. 상황: 두 클라이언트를 모두 쓰며 하나의 관리되는 시스템 안에 두고 싶다. 방법: rigs skill을 설치한 뒤 팀 YAML에 두 harness를 모두 정의하고 rig up을 실행합니다. 기대 결과: 둘이 하나의 시스템으로 시작되고, tmux에 각자의 세션이 나타나며, 준비 검사가 항목별로 결과를 알려 주고, 두 구성원이 모두 tmux에서 보이므로 비교하기 쉽습니다.

사례 2: 매일의 개발 준비를 명령 한 줄로 압축하기. 상황: tmux를 손으로 열고 구성원을 하나씩 띄우는 일을 반복하고 싶지 않다. 방법: 팀 YAML을 정의한 뒤 매일 작업을 시작할 때 rig up을 실행해 tmux 세션, harness, 시작 파일, 준비 검사를 맡깁니다. 기대 결과: 반복되는 준비 동작이 명령 한 줄로 줄고, 준비 검사 결과가 팀의 준비 상태를 곧바로 알려 줍니다.

두 사례는 이어서 할 수 있습니다. 먼저 사례 1로 편성 자체가 가능한지 확인한 뒤, 이를 사례 2 같은 일상의 고정 입구로 만드세요. 두 사례 모두 공식 문서가 다루는 단계까지만 나아갑니다. 팀 구성원이 시작 후 어떻게 분담하고 어떤 작업을 수행하는지에 대한 공식 예시는 없으므로 여기서 지어내지 않습니다.

사용상 한계

• 환경과 클라이언트: 공식이 나열한 것은 Node.js 22 또는 24(Apple silicon은 22), tmux, macOS/Linux(WSL2), 로그인된 Claude Code 또는 Codex뿐입니다. 다른 클라이언트, Windows 네이티브 환경, 다른 Node 버전은 모두 미확인입니다.
• 설치 경로와 버전: 설치는 npx skills add로 이루어지며 공식 명령은 --agent claude-code에 명시적으로 고정되어 있습니다. 플러그인 마켓이나 다른 클라이언트용 동등한 설치 방법은 공식 문서에 없으므로 임의로 유추하지 마세요. 설치 경로는 v0.7.0으로 고정되어 있으며 업그레이드 방법은 설명되지 않았습니다.
• 부작용과 확인 지점: rig setup은 ~/.tmux.conf에 OpenRig 블록을 추가하고, Homebrew로 tmux를 설치할 수 있으며, --no-herdr를 전달하지 않으면 Herdr를 설치합니다. 실행 전에 이러한 변경을 수용하는지 확인하세요.
• 팀 정의: YAML의 구체적인 필드, 예시, 파일 위치는 공식 문서에 없으므로 추측으로 설정을 작성하지 마세요.
• 준비 검사: rig up이 실행하지만 검사 항목과 실패 시 동작은 공식 문서에 설명이 없습니다. 명령 출력을 기준으로 삼고 자동 재시도나 롤백을 가정하지 마세요.
• 작업 동작: OpenRig가 하는 일은 팀 오케스트레이션입니다. 공식 문서는 텍스트 재작성이나 사용자 파일 수정을 다루지 않으며, 구성원 agent 실행 시의 파일·명령·네트워크 동작은 선택한 클라이언트에 달려 있으므로 이 글은 추가로 보안 결론을 내리지 않습니다.
• 미확인 항목: 라이선스와 가격, 제거 방법, rig up의 종료 및 정리 동작, 하나의 rig가 수용할 수 있는 구성원 수 상한. 공식 문서에서 모두 찾지 못했습니다.