본문으로 건너뛰기

오픈리그로 클로드 코드·코덱스 팀 만들기: 리뷰 16번에 커밋 6개

윤누리

2026.10.21

오픈리그로 클로드 코드·코덱스 팀 만들기: 리뷰 16번에 커밋 6개 본문 이미지

오픈리그(OpenRig)로 클로드 코드(Claude Code)와 코덱스(Codex)를 한 팀으로 묶어 결제 기능 6개를 만들었어요. 2026년 10월 21일, 리뷰 16번 끝에 커밋 6개가 나왔어요.

오픈리그는 AI 코딩 도구 여러 개를 한 팀으로 묶어 주는 오픈소스 도구예요. 누가 무슨 일을 하는지 뒤에서 기록해 둬서, 채팅 창을 닫아도 일이 이어져요.

오픈리그를 배우려고 시작했어요

지피터스에서 로나를 만드는 PM이자 24기 멀티에이전트 스터디 멤버 윤누리예요. 전에는 OMC(oh-my-claudecode)로 한 채팅 안에서 클로드 여러 개를 돌렸어요. 이번엔 사이드 프로젝트 챗봇에 결제·환불 기능 6개를 붙이면서 오픈리그를 처음 써 봤어요.

목표는 기능보다 오픈리그를 이해하는 거였어요. 클로드 코드에 이렇게 보냈어요.

openrig 때문에 터미널이 별도로 뜨는데 그냥 orca에 탭으로 터미널 열어서 하는게 나을 것 같은데..?

그리고 나는 이번에 하는게 구현 진행도 진행이지만 openrig가 뭔지 배우고 싶은거라 하나씩 설명해주면서 해줘야해.

클로드는 오픈리그 화면을 오르카(Orca, 터미널을 탭으로 모아 쓰는 앱)의 탭 하나에 붙여 줬어요.

비유보다 실제 구조가 쉬웠어요

구조를 쉽게 알려 달라고 하자, 클로드가 식당 비유 그림을 만들어 줬어요. 저는 사장님, 코덱스 매니저는 홀 매니저, 클로드는 요리사, 코덱스 리뷰어는 맛 검사였어요.

▲ 오픈리그 구조를 식당에 비유한 그림: 홀 매니저, 요리사(클로드), 맛 검사(코덱스), 주문 장부

근데 질문할수록 비서, 창문 같은 비유가 더 붙었어요. 그래서 이렇게 보냈어요.

설명해주는 비서, 주방 창문 장부 등이 각각 뭐고 어떻게 동작하는지 직관적으로 이해가 안 됨

비유를 빼고 실제로 무엇인지만 적을게요. 지금 이 맥에서 도는 건 3가지예요.

쉽게 풀면 이래요.

  • 제 채팅 창: 오픈리그의 일부가 아니에요. 제 대신 명령을 쳐 줄 뿐이에요.

  • 데몬(뒤에서 계속 도는 관리 프로그램): 누가 어느 팀인지, 할 일이 뭔지 적어 둬요. 맥을 다시 켜도 남아요.

  • AI 자리: 클로드 2개, 코덱스 3개가 각자 따로 켜져 있어요. 오르카 탭은 그 화면을 보여 주기만 해서, 탭을 닫아도 일은 계속돼요.

이 설명도 그림 맨 위에 넣어 달라고 했어요.

비유 없이 본 오픈리그: 채팅 창, 데몬, 에이전트와 일이 흘러가는 순서

▲ 비유 없이 본 오픈리그: 채팅 창, 데몬, 에이전트와 일이 흘러가는 순서

오픈리그 팀이 일하는 순서

제가 "ㅇㅋ 한번 직접 해봅시다."라고 하자 일이 시작됐어요. 새벽 3시 25분이었어요. 매니저가 2명짜리 팀(starter)을 띄우고, 할 일 6개를 목록에 올렸어요.

오픈리그 상황판: kernel과 starter 두 팀, 빌더(클로드)와 리뷰어(코덱스) 두 자리

▲ 오픈리그 상황판: kernel과 starter 두 팀, 빌더(클로드)와 리뷰어(코덱스) 두 자리. 일이 끝난 뒤 터미널 내용을 그대로 옮겨 찍었어요

그 뒤는 이렇게 돌았어요.

  1. 클로드가 할 일 하나를 맡아 코드를 쓰고 테스트해요.

  2. 코덱스에게 검토를 부탁해요.

  3. 코덱스가 직접 테스트를 만들어 문제를 찾아요.

  4. 지적을 고쳐 다시 내고, 통과하면 커밋(작업 저장)해요.

코덱스의 지적은 구체적이었어요. 환불 기능에서는 이런 문제를 찾았어요.

환불이 PayPal 에선 성공했는데 우리 DB 기록이 잠깐 실패하면 「실패」로 적혀요. 그러면 돈은 나갔는데 다시 환불될 길이 열려요.

코덱스 리뷰어가 남긴 검토 파일: 승인된 환불이 실패로 바뀔 수 있다는 지적

▲ 코덱스 리뷰어가 남긴 검토 파일: 승인된 환불이 실패로 바뀔 수 있다는 지적(영어 원문)

리뷰는 일마다 1번에서 5번까지, 모두 16번 돌았어요. 환불을 실제로 실행하는 3번 일이 5번으로 가장 많았어요.

사람이 챙겨야 했던 것

알아서 다 해 주지는 않았어요. 세 가지를 챙겨야 했어요.

  • 허락 질문: 클로드가 정해진 일 밖의 명령을 칠 때마다 "해도 될까요?"를 물어요. 답이 없으면 멈춰요. 옆의 클로드 창이 대신 지켜보며 답했어요.

  • 사용량 한도: 오전 9시 48분에 클로드 사용량이 다 차서 멈췄어요. 다른 계정으로 이어 갔고, 오후 1시 41분에 마지막 커밋이 들어갔어요.

  • 메모리: AI 하나가 프로그램 하나라 무거워요. 팀을 띄우기 전, 기본 4자리만 돌 때도 AI 프로그램들이 5.5GB를 썼어요. 7명짜리 팀(factory)은 이번에 안 썼어요.

OMC·오르카와 비교

오픈리그, OMC, 오르카 오케스트레이션을 12개 항목으로 비교한 그림

▲ 오픈리그, OMC, 오르카 오케스트레이션을 12개 항목으로 비교한 그림

  • OMC: 채팅 안에서 돌아요. 가볍지만 창을 닫으면 끊겨요. 몇 시간짜리 일에 맞아요.

  • 오르카에서 직접 나눠 맡기기: 탭마다 AI가 보여요. 기록이 없어서 지휘하는 쪽이 손으로 챙겨야 해요. 하루치 일에 맞아요.

  • 오픈리그: 창을 닫아도, 재부팅해도 이어 가요. 대신 무겁고 배울 게 많아요(명령 87개). 며칠짜리 일에 맞아요.

비교를 듣고 제 말로 정리해 봤어요.

ㅇㅋ... 여전히 언제 openrig를 쓰면 가장 좋은지는 모르겠지만 여튼 멀티 에이전트로 오케이스트이션을 내가 신경을 안 써도 매우 촘촘히 해주고 ralplan, autopilot처럼 다 돌려주는데 이걸 daemon 형식으로 해서 해준다 - 중단되어도 다시 돌릴 수 있다 뭐 이런건가

거의 맞아요. 다만 「신경 안 써도 다 해 준다」는 부분은 조금 달라요.
(중간 줄임)
OpenRig가 제공하는 건 판이에요. 자리, 할 일 목록, AI끼리 말을 주고받는 통로가 여기에 해당해요.

일을 어떻게 나눌지는 팀 설정과 지시문대로 AI가 정한다는 뜻이었어요.

결과와 남은 일

  • 커밋 6개: 파일 59개가 바뀌었어요.

  • 테스트: 2,022개에서 2,228개로 늘었고 모두 통과했어요.

  • 만든 기능: 손님이 챗봇에 "환불해 주세요"라고 쓰면 본인 확인 뒤 환불해요. 금액이 한도를 넘으면 가게 주인에게 승인 카드를 보내요.

  • 실제 확인: 페이팔(PayPal) 연습 환경에서 9달러 상품을 사고 환불을 요청하니 「Refund of $9 sent to PayPal」 카드가 떴어요.

아직 실제 서비스에는 배포하지 않았어요. 언제 오픈리그를 꺼내면 가장 좋은지도 아직 감이 덜 잡혔어요.

오픈리그 처음 써 볼 때 순서

설치 방법은 공식 저장소(https://github.com/mvschwarz/openrig)에서 볼 수 있어요.

  1. 준비: Node.js 22 또는 24, tmux가 필요해요. 클로드 코드와 코덱스 중 하나만 있어도 돼요.

  2. 백업: 오픈리그가 설정 파일 몇 개를 바꿔요. README의 "what OpenRig changes on your machine"을 먼저 읽어요.

  3. 설치: npm install -g @openrig/cli, rig setup, rig daemon start 순서로 쳐요.

  4. 일 맡기기: 할 일을 적어 매니저에게 주면 팀을 제안해요. 처음엔 2명짜리 starter가 좋아요.

  5. 지켜보기: rig ps로 상태를, rig tui로 상황판을 봐요.

처음 쓰는 도구를 배우면서 일을 맡길 때는 이렇게 시키면 돼요.

[도구 이름]을 처음 써 봐. 구현도 하지만 이 도구가 뭔지 배우는 게 목적이야.
비유 말고, 지금 컴퓨터에서 실제로 뭐가 돌고 있는지로 설명해 줘.
명령을 칠 때마다 무슨 명령인지 한 줄씩 알려 주고, 큰 그림부터 보여 준 다음 [첫 작업]을 시작해 줘.
1

함께 이야기해요 1

로그인하고 댓글을 남겨 주세요

primadonna 프로필 이미지
primadonna2026.10.22

다른 멀티에이전트 도구랑 뭐가 다른지 궁금해서 README 좀 찾아봤어요. 팀 구성을 YAML 파일로 정의해 두고 클로드 코드랑 코덱스를 한 팀에 섞어서 명령 하나로 띄우는 게 핵심이더라고요. OMC는 채팅 하나 안에서 끝나는 반면, 오픈리그는 데몬이 기록을 들고 있어서 며칠짜리 일을 이어 가는 쪽이고요.

하나 눈에 띈 건 권한이었어요. 기본 설정에서 코덱스 자리는 승인 없이 전체 권한(danger-full-access)으로 뜬다고 적혀 있어서 결제·환불 코드 만질 때는 이 부분은 꼭 확인하고 써야 할 것 같아요.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기