Claude Code가 팀장, Codex·Cursor·Antigravity가 팀원: Orca로 코딩 에이전트 4개를 한 팀으로 묶은 첫날 (1차 1/3 → 2차 3/3 성공)
2026.10.15

📝 한줄 요약
Orca의 오케스트레이션 기능으로 Claude Code를 코디네이터로, Codex·Cursor·Antigravity를 워커로 묶었어요. 첫 시험은 3개 중 1개만 성공했지만, 원인 2개를 고친 뒤 재시도에서 3개 모두 성공했고 그 절차를 스킬로 저장했어요.
🎯 배경: 세션이 너무 많아지고, 너무 길어졌다
저는 개발자가 아니라 AI 도구로 제품을 만드는 "Flowgrammer"예요. 요즘은 팀 메신저 Parking에 붙일 봇들(KTX 조회, LCK 경기 알림, 배송 조회, 근처 화장실 찾기, 영화 순위)을 만들고 있는데, 봇마다 Claude Code 세션을 따로 열어서 작업했어요.
그러다 두 가지 문제가 눈에 띄었어요.
같은 저장소를 여러 세션이 동시에 고치다 보니 "다른 세션이 그 사이에 이미 push해서…" 같은 충돌 메시지가 나왔어요.
한 세션은 메시지가 8,359개까지 쌓였어요. 이렇게 길어지면 앞에서 정한 내용을 놓치기 쉬워요.
그래서 "에이전트 하나가 다 하지 말고, 여러 AI에게 일을 나눠 맡기고 Claude Code는 팀장 역할만 하면 어떨까?"라는 생각으로 시작했어요. 사용한 도구는 여러 코딩 에이전트를 한 화면에서 돌리는 Orca(오픈소스 ADE)예요.
🔧 작업 과정
1단계. 기본 개념부터 정리: 세션 분리, worktree, PR
먼저 "세션을 나눠서 작업하는 게 정상이냐"부터 물어봤어요. 답은 "흔히 쓰는 방식이지만, 세션마다 작업 폴더(git worktree)를 따로 줘야 충돌이 안 난다"였어요. 여기서 PR(Pull Request)이라는 말이 처음 나왔는데, 회사 문서로 비유하니 바로 이해됐어요.
main 브랜치 = 결재 끝난 최종본, 각 세션 = 사본을 떠서 고치는 담당자, PR = "이렇게 고쳤으니 반영해 주세요"라는 결재 상신, merge = 최종본에 반영
2단계. Orca에 에이전트 계정 연결하기
Orca 설정의 "AI 제공업체 계정"에서 에이전트별로 상태가 제각각이었어요.
에이전트 | 처음 상태 | 한 일 |
|---|---|---|
Codex | 이미 로그인됨 | 없음 (데스크톱 앱 로그인을 그대로 인식) |
Cursor | "로그인을 찾을 수 없음" | Cursor CLI 설치 후 로그인 |
Antigravity | "Windows에서 계정 전환 미지원" | Orca의 계정 전환 기능만 안 되는 것이라 무시 |
Gemini CLI | 로그인 실패 | Antigravity CLI( |
Cursor는 cursor-agent login을 쳤더니 "명령을 찾을 수 없다"는 오류가 났어요. CLI가 아예 설치돼 있지 않았던 거예요. PowerShell에서 아래 명령으로 설치하고, 창을 새로 연 뒤 로그인하니 해결됐어요.
irm 'https://cursor.com/install?win32=true' | iex
cursor-agent loginGemini CLI는 Google 계정 로그인을 시도하자 "개인 사용자는 더 이상 지원하지 않으니 Antigravity로 옮기라"는 메시지가 떴어요. 그래서 Antigravity CLI를 설치했는데, 설치 후에도 agy를 인식하지 못했어요. 설치 경로가 PATH에 등록되지 않은 게 원인이라 직접 등록했어요.
irm https://antigravity.google/cli/install.ps1 | iex
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path","User") + ";$env:LOCALAPPDATA\agy\bin", "User")agy models로 모델 목록을 보니 Gemini 3.8 Flash 말고도 Claude Opus 4.6, Sonnet 4.6이 들어 있었어요. Claude Code 토큰이 부족할 때 Google 구독으로 Claude 모델을 돌리는 우회로도 생긴 셈이에요.
3단계. 오케스트레이션 켜기: 이미 켜져 있었다

Claude에게 컴퓨터 제어를 맡겨 Orca 설정 화면을 직접 확인하게 했더니, Orca CLI 등록과 오케스트레이션 스킬이 이미 최신 상태로 켜져 있었어요. 처음엔 "감지된 에이전트 2개"라고만 떠서 걱정했는데, 스킬은 코디네이터(Claude Code)에만 있으면 된다고 해요. 워커는 일을 받을 때 "끝나면 이렇게 보고하라"는 안내문이 자동으로 들어가거든요.
4단계. 첫 시험 실행: 3개 중 1개 성공
망가져도 상관없는 아주 작은 일로 시험했어요. 세 에이전트에게 각각 README 맨 아래에 한 줄씩 추가하게 한 거예요.
💡 이때 쓴 프롬프트 (Orca 안의 Claude Code에 붙여넣기)
너는 코디네이터야. 먼저 `orca skills get orchestration --full`을 읽고 그 방식대로 진행해. 연결 시험이 목적이니 코드 변경은 최소로 해. 1. orca orchestration run-create 로 Run 생성 2. 태스크 3개 생성, 각각 worker-start --worktree new-child 로 실행 - Task1 (antigravity): README.md 맨 아래에 "## Agent test: antigravity" 한 줄 추가 - Task2 (codex): 같은 방식으로 "## Agent test: codex" - Task3 (cursor): 같은 방식으로 "## Agent test: cursor" 3. check --wait 로 worker_done 3개 기다리기 4. 각 워커가 성공했는지, 어디서 막혔는지 표로 보고. merge·push는 하지 마
결과는 Cursor만 성공이었어요. 좋았던 점은 Claude Code가 실패한 워커의 화면까지 열어보고 원인을 정확히 짚어서 보고했다는 거예요.
에이전트 | 결과 | 원인 |
|---|---|---|
Cursor | ✅ | 한 줄 추가 후 커밋까지 완료 |
Codex | ❌ | Codex 데스크톱 앱만 있고 CLI가 없어서 실행 자체가 안 됨 |
Antigravity | ❌ | Gemini CLI에서 가져온 텔레메트리 플러그인의 경로 버그로 모든 도구 호출이 막힘 |
5단계. 원인 2개 고치고 재시도: 3개 모두 성공
# Codex CLI 설치
npm install -g @openai/codex
# 문제 플러그인을 지우지 않고 백업 폴더로 옮겨서 비활성화
New-Item -ItemType Directory -Force "$HOME\.gemini\plugins_disabled" | Out-Null
Move-Item "$HOME\.gemini\config\plugins\googlecloudtools.datacloud_telemetry*" "$HOME\.gemini\plugins_disabled\"💡 재시도 프롬프트
codex CLI 설치와 antigravity 플러그인 문제를 고쳤어. 실패한 두 태스크를 --retry-of로 재시도하고, 결과를 같은 표 형식으로 보고해. merge·push는 하지 마.
Orca를 재시작하고 재시도하니 Codex와 Antigravity 모두 worker_done을 보냈고, Claude Code가 각 브랜치의 변경 내용(diff)을 직접 열어 "정확히 한 줄만 추가됐다"는 것까지 확인했어요. 시험이 끝난 뒤 worktree 3개와 브랜치 3개도 Claude Code에게 맡겨 깨끗이 정리했어요.
Codex CLI와 Antigravity CLI까지 설치를 마친 뒤 다시 보니 감지된 에이전트가 5개로 늘어 있었어요.

📊 결과
코딩 에이전트 4개(Claude Code·Codex·Cursor·Antigravity)를 하나의 오케스트레이션 Run으로 연결
시험 태스크 성공률: 1차 1/3 → 2차 3/3
실패 원인 2개를 Claude Code가 워커 화면을 직접 읽어서 찾아냄 (사람은 고치기만 함)
시험 흔적(worktree·브랜치) 정리까지 끝내고 main은 그대로 유지
전체 절차를
orca-orchestrate스킬로 저장해서, 다음부터는 "오케스트레이션으로 [목표] 진행해"라고만 하면 됨같은 메뉴에 Claude·Codex·Gemini·Antigravity·Cursor가 나란히 있어서 에이전트를 바로 띄울 수도 있어요.

💡 핵심 팁: 실전 전에 "한 줄 추가" 시험부터 돌리세요
에이전트마다 설치·로그인·플러그인 문제가 숨어 있어서, 큰 작업부터 맡기면 어디서 막혔는지 찾기 어려워요. README에 한 줄씩 추가하는 수준의 시험으로 연결부터 확인하면, 실패해도 잃을 게 없고 원인이 바로 보여요.
실전에서는 Claude Code에게 바로 맡기지 말고 배정 계획을 먼저 보여달라고 하는 게 안전해요.
💡 실전용 프롬프트 (계획 확인 후 실행)
목표: Parking에 [기능 설명] 추가 오케스트레이션으로 진행해. 단, 실행 전에 계획부터 보여줘. 1. 태스크를 서로 파일이 겹치지 않게 3~5개로 쪼개 2. 아래 원칙으로 에이전트 배정 - 설계·공용 파일·최종 검토: 너(Claude Code)가 직접 - 구현량이 많은 태스크: codex - UI·화면 작업: cursor - 조사·문서·테스트 작성: antigravity 3. 태스크 / 담당 / 수정할 파일 / 완료 기준을 표로 보여주고 내 승인을 기다려 4. 승인하면 실행하고, 끝나면 결과 표로 보고. merge·push는 하지 마
위 역할 분담은 예시일 뿐 검증된 성능 순위가 아니에요. 몇 번 돌려보면서 내 작업에 맞게 고쳐 나가면 돼요.
❓ 작업하며 주고받은 질문과 답
Q1. 에이전트 세션을 기능별로 나눠서 작업해도 되나요?
흔히 쓰는 방식이에요. 다만 같은 저장소를 동시에 고치면 충돌하니, 세션마다 git worktree(또는 브랜치)를 따로 주고 PR로 합치는 게 좋아요. 공용 설정 파일은 한 세션에서만 고치게 정하고, 세션 하나에 기능 하나만 맡기세요.
Q2. PR이 뭐예요?
Pull Request, 즉 "고친 코드를 본 코드에 합쳐도 될지 검토해 달라"는 병합 요청서예요. 바로 push하면 즉시 반영되지만, PR을 거치면 바뀐 줄만 모아 보고 승인한 뒤 merge할 수 있어서 되돌리기도 쉬워요.
Q3. 태스크별로 Gemini·Codex·Cursor에 일을 나누고 Claude Code로 조율할 수 있나요?
Orca의 오케스트레이션 기능으로 가능해요. Claude Code가 Run을 만들고 태스크를 나눈 뒤, 각 태스크를 다른 에이전트에게 별도 worktree로 배정해요. 워커가 끝나면 worker_done으로 보고하고, Claude Code가 결과를 검토해요.
Q4. 작업 중에 넷 중 하나의 토큰이 떨어지면 어떻게 되나요?
워커가 떨어지면 그 워커만 멈추고, 그때까지 한 작업은 자기 worktree에 남아요. 나머지 워커는 계속 일해요. 코디네이터는 보고가 없으면 시간 초과로 알아채고, --retry-of로 다른 에이전트에게 재배정할 수 있어요. 코디네이터(Claude Code)가 떨어지면 결과를 받아 정리할 주체가 없어서 더 곤란하지만, Run 기록은 Orca에 저장돼 있어 한도가 풀린 뒤 이어서 진행하면 돼요. 태스크를 작게 쪼개고 진행 상황을 PROGRESS.md에 남기게 하면 피해가 줄어요.
Q5. 에이전트별로 일을 직접 지정해야 하나요, Claude Code가 알아서 나누나요?
둘 다 돼요. 직접 지정(A)은 작업이 명확할 때, 완전 위임(B)은 큰 기능을 통째로 맡길 때 맞아요. 추천은 혼합(C)이에요. 목표와 배정 원칙만 주고, Claude Code가 만든 배정 계획을 확인한 뒤 실행하게 하는 방식이에요.
방식 | 사용자가 주는 것 | Claude Code가 하는 것 | 해당 경우 |
|---|---|---|---|
A. 직접 지정 | 태스크 목록 + 담당 에이전트 | 실행·대기·검토·보고 | 작업이 이미 명확할 때, 에이전트별 성능을 비교해 보고 싶을 때 |
B. 위임 | 목표 하나 | 태스크 분해·배정·실행·검토·보고 | 큰 기능을 통째로 맡길 때 |
C. 혼합 (추천) | 목표 + 배정 원칙 | 분해·배정안을 먼저 보여주고, 승인받은 뒤 실행 | 대부분의 실전 작업 |
🚀 다음 계획
Parking 봇 기능처럼 파일이 서로 겹치지 않는 실제 작업 3개로 첫 실전 Run 돌리기
에이전트별로 잘하는 일을 기록해서 배정 원칙을
orca-orchestrate스킬에 반영하기원칙이 안정되면 계획 승인 단계를 빼고 완전 위임으로 넘어가기
도구: Orca, Claude Code, Codex CLI, Cursor CLI, Antigravity CLI | 프로젝트: Parking




Spark님, 안녕하세요. 첫 시험에서 3개 중 1개만 성공했다가 원인 2개를 고쳐 3/3으로 만든 과정을 숨기지 않고 적어주셔서 읽는 내내 따라가기 좋았어요.
특히 PR을 "결재 상신", main을 "결재 끝난 최종본"에 빗댄 부분이 인상적이었어요. 개발자가 아니어도 worktree를 왜 따로 줘야 하는지 바로 이해되는 설명이에요. 그리고 Q4에서 워커의 토큰이 떨어지면 그 워커만 멈추고, 코디네이터가 시간 초과로 알아채 --retry-of로 재배정한다는 정리와 PROGRESS.md로 피해를 줄이는 팁은 실제로 돌려본 사람만 쓸 수 있는 내용이었어요.
Gemini CLI가 막혀 Antigravity CLI(agy)로 바꾸고 PATH를 직접 등록하신 대목도, 같은 곳에서 막힐 분들께 큰 도움이 될 것 같아요. 다음 Run에서 에이전트별 배정 원칙이 어떻게 쌓이는지도 궁금해요. 꼬리 탁! 치고 응원하고 갈게요 🐈⬛