Claude Code와 Codex를 팀으로 운영하는 법

한눈에 보는 진행 순서

처음이라면 이 순서대로 하면 돼요. 명령어는 각 단계의 자세한 섹션에 있어요.

1. 준비물 확인

   macOS나 Linux, Node.js 22 또는 24, tmux, Claude Code와 Codex 로그인 (starter를 그대로 띄우려면 둘 다, 하나만 있으면 kernel 오퍼레이터에게 맞춰 달라고 해요)

   자세히 보기 →
2. 설정 파일 백업

   OpenRig를 깔고 처음 실행하기 전에, 바뀌는 파일을 한 번만 복사해 둬요

   자세히 보기 →
3. 설치 계획 보기

   설치 스크립트를 --dry-run 으로 돌려 설치 계획을 봐요 (rig setup --dry-run 은 CLI를 깐 뒤에 돼요)

   자세히 보기 →
4. 설치

   한 줄 설치 스크립트, 또는 npm으로 CLI를 깔고 필요하면 rig setup

   자세히 보기 →
5. starter 팀 띄우기

   저장소 폴더에서 rig up starter --cwd .

   자세히 보기 →
6. 준비 확인

   rig ps --nodes --rig starter 로 두 좌석이 준비됐는지 보고, 질문에서 멈춘 좌석은 답한 뒤 rig seat continue <seat>

   자세히 보기 →
7. 일 맡기기

   rig send 로 빌더 좌석에 원하는 결과를 말해요

   자세히 보기 →
8. 상태 보기와 내리기

   rig ps, rig down

   자세히 보기 →

준비물

버전과 로그인 상태를 확인해요. 쓰지 않는 쪽은 설치하거나 로그인하지 않아도 돼요.

node --version
tmux -V
claude --version
claude auth status
codex --version
codex login status

로그인이 안 되어 있으면 한 번만 로그인해요.

claude auth login
codex login

CLI가 없으면 각 제공사 설치 안내대로 깔아요. rig setup 을 실행하면 쓰지 않는 쪽 CLI도 깔고, macOS에서는 cmux도 깔아요. 한쪽만 쓸 거면 rig setup 은 건너뛰어도 돼요 (그때 tmux는 직접 깔아요).

Linux 배포판 기본 Node.js는 오래된 경우가 있어요 (Ubuntu 24.04는 18). nvm으로 nvm install 22 를 하면 돼요.

설치 전에: 백업하고 미리 보기

README의 'What OpenRig changes on your machine'에 적힌 파일들이에요. 데몬은 rig up 으로도 저절로 켜지니, 백업은 데몬을 처음 켜기 전에 해요.

1. 홈 폴더 설정 백업

백업은 OpenRig를 처음 설치하기 전에 한 번만 해요. ~/openrig-backup 이 이미 있으면 다시 실행하지 마세요. 바뀐 파일이 원래 백업과 섞여요.

mkdir -p ~/openrig-backup
cp -pn ~/.tmux.conf ~/openrig-backup/tmux.conf
cp -pn ~/.codex/config.toml ~/openrig-backup/codex-config.toml
cp -pn ~/.claude.json ~/openrig-backup/claude.json
cp -Rp ~/.claude/skills ~/openrig-backup/claude-skills
cp -Rp ~/.agents/skills ~/openrig-backup/agents-skills
cp -pn ~/.config/cmux/settings.json ~/openrig-backup/cmux-settings.json

cp -pn 은 이미 있는 백업을 덮어쓰지 않아요. 없는 파일은 'No such file' 오류가 나요. 원래 없던 파일이니 넘어가면 돼요. CLAUDE_CONFIG_DIR 나 CODEX_HOME 을 바꿔 쓰고 있다면 그 폴더의 파일을 백업해요.

2. 저장소 쪽 설정 백업

팀을 띄울 저장소 폴더에서 해요. 백업 폴더 이름에 저장소 이름이 붙어서 저장소마다 따로 남아요. 작업 중인 변경은 먼저 커밋해 두면 되돌리기 쉬워요.

cd /path/to/your/repository
B=~/openrig-backup/repo-$(basename "$PWD")
mkdir -p "$B"
cp -pn .claude/settings.local.json "$B"/
cp -pn .mcp.json "$B"/
cp -pn .git/info/exclude "$B"/git-info-exclude

3. 설치 계획 미리 보기

설치 스크립트의 --dry-run 은 네 단계 설치 계획을 글로만 보여 주고 아무 명령도 실행하지 않아요. setup이 무엇을 할지는 CLI를 깐 뒤 rig setup --dry-run 으로 봐요.

curl -fsSL https://raw.githubusercontent.com/mvschwarz/openrig/v0.6.6/scripts/install.sh | sh -s -- --dry-run

rig setup --dry-run 은 setup 계획만 보여 줘요. 데몬이 켜질 때나 팀을 띄울 때 쓰는 파일까지 모두 미리 보여 주지는 않아요. 그래서 백업이 먼저예요.

설치와 첫 실행

설치: 한 줄로

v0.6.6 설치 스크립트가 Node.js와 npm 확인, 최신 @openrig/cli 설치와 Node.js, SQLite 확인, rig setup --dry-run, rig setup 까지 차례로 해요. rig setup 은 없는 Claude Code나 Codex를 npm으로 깔고, macOS에서는 Homebrew로 tmux와 cmux도 깔아요. 데몬은 켜지 않아요.

curl -fsSL https://raw.githubusercontent.com/mvschwarz/openrig/v0.6.6/scripts/install.sh | sh

로그인이 안 된 쪽이 있으면 마지막 단계가 FAILED [4/4] 로 끝나요. 어느 방법이든 rig setup 은 'Some steps need attention'에 로그인을 적어요. 남은 게 로그인뿐이면 설치는 끝난 거예요. 쓰려는 쪽만 로그인하고 이어가면 돼요.

설치: 한 단계씩

npm install -g @openrig/cli
rig setup --dry-run

rig setup 을 적용하면 Claude Code와 Codex를 둘 다 확인해서 없는 쪽을 npm으로 깔고, macOS에서는 Homebrew로 tmux와 cmux도 깔아요. 둘 다 쓸 거면 이어서 rig setup 을 실행해요. 한쪽만 쓸 거면 건너뛰어도 돼요.

kernel 오퍼레이터 열기

kernel은 운영자, 어드바이저, 큐 워커로 된 기본 리그예요. 팀 고르기를 돕고, Claude Code나 Codex 하나만 있으면 starter를 맞춰 줘요. rig setup 은 데몬을 켜지 않으니 직접 켜요. 켜졌다고 바로 준비된 건 아니라서 상태를 봐요.

rig daemon start   # 데몬이 꺼져 있을 때만
rig status
rig ps --nodes --rig kernel
rig terminal open saved:kernel --provider herdr

Herdr가 없으면 --provider cmux 로 열어요. 둘 다 없으면 rig ps --nodes --rig kernel --json 에서 operator.agent 줄의 canonicalSessionName 을 찾아 새 터미널에서 붙어요. 나올 때는 Ctrl-b 다음 d예요.

env -u TMUX tmux attach-session -t '=<canonicalSessionName>'

starter 팀 띄우기

작업할 저장소 폴더로 가서, 팀 구성을 미리 보고, 계획을 확인한 뒤 띄워요.

cd /path/to/your/repository
rig specs preview starter --kind rig
rig up starter --cwd . --plan
rig up starter --cwd .

공식 문서 기준으로 dev-review는 Codex 모델 gpt-6-astra로 고정되어 있어요. 띄우기 전에 내 계정에서 그 모델을 쓸 수 있는지 확인해요. Claude Code나 Codex 하나만 있으면 kernel 오퍼레이터에게 맞춰 달라고 하면 같은 이름으로 내 환경용 사본을 만들어요.

준비됐는지 확인

rig status
rig ps --nodes --rig starter

rig up 이 Status: partial 과 'Startup attention (<seat>)'을 보여 주면 그 좌석이 로그인, 신뢰, 권한 질문에서 멈춘 거예요 (rig ps --nodes 에서는 'Startup details'). rig 를 실행해 시작 화면(작업 화면이 열리면 S)에서 그 좌석을 고르고 o 로 터미널을 열어 답해요. Herdr가 있으면 rig terminal open starter --provider herdr 로 열어도 돼요. 답한 뒤 화면에 나온 명령을 실행해요.

rig seat continue <seat>

쓰는 법

원하는 결과를 말하기

좌석 주소로 빌더에게 한 가지 결과를 보내요. 무엇이 보여야 하는지, 범위, 확인 방법을 함께 적으면 좋아요. 리뷰는 빌더가 dev-review에게 직접 넘겨서, 터미널 사이를 옮겨 줄 필요가 없어요. <one useful change> 는 내 저장소에서 바꾸고 싶은 실제 변경 하나로 바꿔 적어요 (꺾쇠 괄호는 빼요).

rig send dev-build@starter 'Implement <one useful change>. Track the task in the queue and return its ID. Keep it local, verify the behavior, ask dev-review in this rig to check the exact candidate, and record the result and how I can try it.'

메시지를 보낸다고 작업이 바로 생기지는 않아요. 빌더가 작업을 기록하면 큐에서 볼 수 있어요.

rig queue list --destination dev-build@starter --limit 1000
rig queue list --destination dev-review@starter --limit 1000
rig queue show <id> --full

다음 변경도 같은 빌더 좌석에 이어서 보내요. 보던 터미널을 닫아도 좌석 주소와 큐는 남아 있어요.

리드가 있는 팀이라면

workshop은 리드에게 원하는 결과를 말해요. factory는 어드바이저에게 아이디어를 말하고, 리드가 팀을 운영해요. 처음 설치 뒤에는 kernel 오퍼레이터가 무엇을 만들지 묻고 세 팀 중 하나를 추천해 줘요.

팀 화면 보기

rig tui --shared
rig terminal open starter --provider herdr

rig terminal open 은 Herdr가 설치되어 연결돼 있을 때 써요 (cmux면 --provider cmux). 여러 번 열면 워크스페이스가 또 생길 수 있으니, 이미 연 화면이 있으면 그리로 돌아가요. 공유 대시보드에서 빠져나올 때는 Ctrl-b 다음 d예요. 대시보드를 끄지 않고 나와요.

팀 내리기

rig down 은 그 팀의 에이전트 세션과 진행 중인 일을 끝내요. 먼저 누가 멈출지 확인해요.

rig ps --nodes --rig starter
rig down starter

모두 끄려면 rig ps --json 으로 리그 목록을 보고 하나씩 rig down 해요. kernel은 맨 마지막에, 그다음 백그라운드 서비스를 꺼요.

rig down kernel
rig daemon stop

미리 짜 둔 팀 비교

rig specs ls --kind rig
rig specs preview factory --kind rig
rig up factory

이 밖에 code-review (독립 리뷰 2개), research (분석가와 정리 담당), pm (제품 리드, 리서처, 프로토타입 빌더) 팀도 내장되어 있어요. 돌아가는 팀에 자리를 늘리고 줄일 때는 rig grow, rig shrink 를 써요.

자주 막히는 곳

rig doctor 의 로그인 확인은 이 컴퓨터 안에서만 하는 확인이라, 제공사가 실제로 받아 주는지나 에이전트가 일하는지까지는 보장하지 않아요. rig ps --nodes --rig <rig> 도 함께 봐요.

되돌리기 (백업 복원)

데몬이 켜져 있으면 Codex 설정을 다시 쓸 수 있어서, 먼저 팀과 데몬을 끄고 복원해요.

팀과 데몬을 끄기 전에, 권한 허용 규칙을 추가한 에이전트가 있으면 그 에이전트에게 "Undo the OpenRig command allowances added by this setup; keep my other rules."라고 말해 그 추가분만 지워요. 그 에이전트가 kernel 운영자라면 rig down kernel 뒤에는 말할 수 없어요.

rig ps --json 에 다른 리그가 보이면 kernel 전에 하나씩 rig down 해요. rig daemon stop 은 서비스만 끄고 에이전트 tmux 세션은 남겨요. 데몬이 이미 꺼져 있으면 rig daemon start --no-kernel 로 켠 뒤 내려요.

rig ps --json
rig down starter
rig down kernel
rig daemon stop

덮어쓰기 전에 지금 상태를 따로 남기고, diff 로 OpenRig가 바꾼 부분만인지 봐요. 백업 뒤에 직접 바꾼 설정이 있으면 복원 뒤 다시 넣어요.

mkdir -p ~/openrig-backup/after
cp -p ~/.tmux.conf ~/openrig-backup/after/tmux.conf
cp -p ~/.codex/config.toml ~/openrig-backup/after/codex-config.toml
cp -p ~/.claude.json ~/openrig-backup/after/claude.json
cp -p ~/.config/cmux/settings.json ~/openrig-backup/after/cmux-settings.json
diff ~/openrig-backup/codex-config.toml ~/.codex/config.toml
diff ~/openrig-backup/claude.json ~/.claude.json

cp -p ~/openrig-backup/tmux.conf ~/.tmux.conf
cp -p ~/openrig-backup/codex-config.toml ~/.codex/config.toml
cp -p ~/openrig-backup/claude.json ~/.claude.json
cp -p ~/openrig-backup/cmux-settings.json ~/.config/cmux/settings.json

CLAUDE_CONFIG_DIR 나 CODEX_HOME 을 쓰면 그 폴더의 파일을 되돌려요. 저장소 쪽은 같은 폴더에서 되돌려요.

cd /path/to/your/repository
B=~/openrig-backup/repo-$(basename "$PWD")
cp -p "$B"/settings.local.json .claude/settings.local.json
cp -p "$B"/.mcp.json .mcp.json
cp -p "$B"/git-info-exclude .git/info/exclude
git status --short --ignored

OpenRig가 만든 .openrig/, .codex/plugins/ 아래 openrig-core 폴더, 새로 생긴 AGENTS.md, CLAUDE.md, CLAUDE.local.md 를 확인해서 원래 없던 것만 정리해요. 스킬 폴더는 덮어쓰지 말고, 추가된 openrig-skills 를 백업과 비교해서 직접 정리해요. 백업이 없는 파일은 원래 없던 것이니 새로 생긴 걸 지우면 돼요. Claude나 Codex 로그인 정보는 지우지 않아요.

복원한 뒤 rig daemon start, rig up, rig context add 를 실행하거나 rig 화면에서 데몬을 켜면 Codex 설정과 openrig-skills 를 다시 써요. rig setup 을 다시 하면 ~/.tmux.conf 블록도 다시 들어가요. 그래서 복원은 OpenRig를 그만 쓸 때 해요.