Claude Code와 Codex를 한 팀으로, 멀티 에이전트 시스템 OpenRig 입문 6단계
여러 터미널 창을 띄워가며 Claude Code와 Codex를 따로 쓰는 건 번거롭고 문맥이 끊깁니다. OpenRig은 YAML 하나로 에이전트 팀을 정의하고 한 명령어로 부팅해, 리드 에이전트가 전문가들을 조율하며 결과를 가져오게 만듭니다. 이 글은 설치부터 첫 리그 실행, 팀 구성 요령까지 6단계로 정리합니다.
AI 코딩 에이전트를 여러 개 돌려 본 사람이라면, 터미널 세션이 난립하고 문맥 공유가 안 돼 결국 사람이 중계자 노릇을 하게 되는 경험을 했을 것입니다. OpenRig은 그 파편화된 세션을 하나의 지속 가능한 팀으로 묶어주는 하네스입니다.
OpenRig이란 무엇인가요
OpenRig은 mvschwarz/openrig 저장소에 있는 오픈소스 프로젝트예요. 한 줄 설명은 “Claude Code와 Codex를 하나의 시스템으로 묶어주는 멀티 에이전트 하네스”입니다. 현재 스타 1,460개, 포크 125개를 기록했고, 주 언어는 TypeScript이며 Apache-2.0 라이선스를 사용합니다. 프로젝트는 5개월 전(2026년 4월) 처음 만들어졌고, 이번 달(2026년 9월)까지 꾸준히 업데이트되었습니다.
OpenRig은 ‘하네스’가 모델을 감싸고, ‘리그’가 그런 하네스들을 다시 감싸는 구조를 가집니다. YAML 파일에 에이전트 팀을 정의하고, 한 줄 명령으로 전체 팀을 부팅하면 Claude Code와 Codex가 같은 리그 안에서 서로 협업합니다. 이렇게 하면 별도의 터미널 세션을 여러 개 띄울 필요 없이, 하나의 지속적인 작업 공간에서 AI 코딩 에이전트를 운영할 수 있어요.
리그 안에서는 리드 에이전트가 목표 결과를 묻고, 필요에 따라 전문 에이전트에게 작업을 분배합니다. 팀이 만든 결과와 중요한 결정은 사용자에게 전달되며, 작업 내역과 컨텍스트는 동일한 주소에 보관돼 다음 작업에도 바로 이어 사용할 수 있습니다.
bun add -g @openrig/cli| 항목 | 값 |
|---|---|
| Stars | 1,460 |
| Forks | 125 |
| 주 언어 | TypeScript |
| 라이선스 | Apache-2.0 |
왜 OpenRig을 쓰나요
여러 AI 에이전트를 동시에 띄워두면 각자 다른 터미널 창에서 돌아가기 때문에, 누가 무슨 작업을 했는지 한눈에 파악하기 어렵습니다. 문맥이 창마다 흩어지니 같은 파일을 두고 중복 수정이 일어나거나, 앞서 논의한 결정 사항이 다음 세션에 전달되지 않는 일도 잦습니다. OpenRig은 이런 분리된 터미널 세션의 불편함과 문맥 단절 문제를 한 번에 풀어줍니다.
리드 에이전트 중심 협업이 주는 변화
OpenRig 팀은 리드 에이전트(Lead Agent) 한 명을 두고, 그 아래로 전문 에이전트들을 배치합니다. 사용자는 리드 에이전트에게만 원하는 결과를 말하면 되고, 리드가 작업 분배·진행 상황 취합·중요 결정만 사용자에게 되돌려주는 식입니다. 덕분에 터미널 창을 번갈아 가며 확인할 필요가 없고, 프로젝트 전체 문맥이 한곳에 모입니다.
- 터미널 여러 개를 열어둘 필요 없이 tmux 세션 하나로 통합 관리
- 작업 히스토리와 결정 사항이 에이전트 팀 단위로 저장되어 인수인계가 자연스러움
- YAML 설정만 바꾸면 에이전트 구성·역할·모델을 유연하게 교체 가능
요약하면, OpenRig은 "터미널 파편화"와 "문맥 손실"이라는 두 가지 고질적 불편을 리드 에이전트 중심 워크플로로 해결해, AI 코딩 에이전트들을 지속 가능하고 조직적인 팀으로 만들어줍니다.
설치 전 확인 사항과 환경 준비
OpenRig을 실행하려면 macOS나 Linux 환경이 필요하고, 필수 도구로 Node.js와 tmux가 있어야 해요. 지원되는 Node.js 버전은 20, 22, 24이며, Apple Silicon Mac을 사용할 경우에는 특히 Node.js 22를 권장합니다.
Windows에서는 아직 네이티브 지원이 되지 않으며, WSL2에서도 테스트되지 않았으니 사용을 피하는 것이 좋아요. macOS와 Linux에서는 별다른 추가 설정 없이 바로 실행할 수 있습니다.
bun add -g @openrig/cliNode.js 설치
Node.js 22 버전을 다운로드하고 설치합니다.
tmux 설치
패키지 매니저(apt, brew 등)로 tmux를 설치합니다.
CLI 설치
위의 bun 명령어를 실행해 OpenRig CLI를 전역으로 설치합니다.
환경 점검
rig setup명령어를 실행해 하모니와 cmux가 정상인지 확인합니다.
| 필수 요소 | 버전/설명 |
|---|---|
| Node.js | 20, 22, 24 중 하나 (Apple Silicon Mac → 22 권장) |
| tmux | macOS·Linux 모두 필요 |
OpenRig이 내 컴퓨터에 어떤 변화를 주나요?
Rig를 시작하면 AI 에이전트와 연동된 파일 훅이 생성되고, 작업 공간에 대한 신뢰 설정이 추가됩니다. 이 파일들은 일반적인 프로젝트 파일과 동일한 디렉터리에 위치하니, 필요에 따라 원본을 보관해 두시면 됩니다.
- Node.js 22 설치
- tmux 설치
- Bun으로 CLI 설치
- 설정 파일 백업
설치 전 최종 체크리스트
첫 리그 실행 6단계
첫 리그를 실행하려면 먼저 전역에 OpenRig CLI를 설치합니다. macOS 또는 Linux 환경에서 Node.js 20·22·24와 tmux가 있어야 하고, Apple silicon을 쓰는 경우 Node.js 22를 권장합니다. 설치 명령은 bun add -g @openrig/cli 혹은 npm 으로도 가능합니다.
설치가 끝나면 rig setup 으로 provider hook과 workspace trust 설정을 적용하고, YAML 파일에 Claude Code와 Codex 에이전트를 정의합니다. 정의가 완료되면 rig up 명령으로 전체 팀을 부팅하고, 리드 에이전트에게 원하는 결과를 지시합니다. 마지막으로 에이전트가 만든 코드와 결정 사항을 확인해 피드백을 주면 첫 리그 실행이 마무리됩니다.
bun add -g @openrig/cli1. 글로벌 설치
Bun 혹은 npm 으로 @openrig/cli 를 전역에 설치합니다.
2. rig setup 실행
rig setup명령으로 provider hook과 workspace trust 설정을 적용합니다.3. 팀 정의 파일 작성
YAML 파일에 Claude Code와 Codex 에이전트를 정의합니다.
4. rig up 으로 부팅
rig up로 전체 팀을 시작합니다.5. 리드 에이전트에 지시
리드 에이전트에게 원하는 결과를 전달하면, 내부 전문가들을 조율합니다.
6. 결과 확인
에이전트가 만든 코드와 결정 사항을 확인하고 필요 시 피드백을 줍니다.
| 필수 도구 | 버전 |
|---|---|
| Node.js | 20, 22, 24 |
| tmux | 설치 필요 |
| OS | macOS·Linux |
rig 실행이 시스템에 미치는 변화
rig setup 은 provider hook 파일과 VS Code workspace trust 설정을 작성합니다. 기존 파일을 백업해 두는 것이 안전합니다.
주의할 점과 운영 팁
OpenRig을 실제 업무에 적용할 때는 몇 가지 놓치기 쉬운 포인트가 있어요. 먼저 Bun으로 bun add -g @openrig/cli를 실행하면, 패키지의 postinstall 스크립트가 차단될 수 있습니다. 이 경우 Node.js와 SQLite 검증 로직이 실행되지 않으니, 설치 후 직접 node -v와 sqlite3 --version을 확인해 주세요. 또한 OpenRig은 실행 시 provider hook 파일과 workspace trust 설정을 현재 작업 디렉터리에 기록합니다. 중요한 파일이므로 설치 전·후에 반드시 백업해 두는 것이 안전합니다.
bun add -g @openrig/cli버전 확인
node -v로 Node.js 20·22·24 중 하나인지 확인합니다.SQLite 검증
sqlite3 --version명령으로 SQLite가 설치돼 있는지 확인합니다.파일 백업
~/.config/openrig/provider-hooks와~/.config/openrig/trust-settings를 안전한 디렉터리로 복사합니다.
| 필수 도구 | 버전 |
|---|---|
| Node.js | 20·22·24 |
| tmux | 지원 OS(macOS·Linux) |
postinstall 스크립트 차단 시 대처법
Bun이 스크립트를 차단하면, 설치 로그에 경고가 표시됩니다. 이때는 위의 ‘버전 확인’과 ‘SQLite 검증’ 단계를 수동으로 진행하고, provider hook 파일을 직접 생성하거나 기존 파일을 복원하면 됩니다.
- tmux 세션은
tmux new -s openrig로 이름을 지정해 두면, 여러 에이전트를 한 화면에서 관리하기 편합니다. - 세션 종료 시
tmux detach로 빠져나가면 백그라운드에서 작업이 유지됩니다.
정리: 나만의 AI 개발팀 만들기
AI 개발팀을 만들 때 가장 쉬운 시작은 작은 저장소 하나와 단일 변경을 준비하는 것입니다. OpenRig은 그 저장소에 정의된 YAML 파일 한 개로 여러 AI 에이전트를 동시에 관리할 수 있게 해줍니다. 처음엔 main 브랜치에 rig.yaml만 추가하고, 원하는 결과를 리드 에이전트에게 이야기하면 나머지는 자동으로 조율됩니다.
팀의 작업과 문맥을 같은 주소에 지속시키면, 언제든 이전 상태로 돌아가거나 새로운 작업을 이어붙일 수 있어요. OpenRig은 Claude Code와 Codex를 하나의 리그 안에 넣어, 각각의 터미널 세션이 아니라 지속적인 팀으로 전환합니다. 이렇게 하면 결과물과 결정 사항을 한눈에 파악하고, 필요할 때만 개입하면 됩니다.
bun add -g @openrig/cli1️⃣ 저장소 준비
새 Git 저장소를 만들고,
rig.yaml파일에 에이전트 팀 구성을 적습니다.2️⃣ 환경 설치
Node.js(20·22·24)와 tmux가 있는 macOS·Linux에
bun add -g @openrig/cli명령을 실행합니다.3️⃣ 팀 부팅
터미널에서
rig up명령만 입력하면 모든 에이전트가 동시에 시작됩니다.4️⃣ 한 번의 변경 적용
리드 에이전트에게 목표를 말하고, 결과가 나오면 해당 커밋을 바로 저장소에 푸시합니다.
| ⭐ 스타 | 1,460 |
|---|---|
| 🍴 포크 | 125 |
| 🗂️ 주 언어 | TypeScript |
| 📄 라이선스 | Apache-2.0 |
| 🕒 처음 만들어진 시점 | 5개월 전(2026년 4월) |
| 🛠️ 마지막 업데이트 | 이번 달(2026년 9월) |
- YAML에 에이전트 이름과 역할을 정의하면, OpenRig이 자동으로 tmux 세션을 구성합니다.
- Claude Code와 Codex가 같은 리그 안에 있어, 코드 생성·리뷰·테스트를 한 번에 처리합니다.
- 팀 전체의 컨텍스트는 저장소 주소에 남으므로, 언제든 같은 환경을 재현할 수 있습니다.