본문으로 건너뛰기
JournalTORIS / FIELD NOTES

← 블로그개발 도구

Orca(stablyai/orca) — 코딩 에이전트 여러 개를 동시에 돌리는 Git Worktree 오케스트레이터

GitHub 12.8만 스타를 넘긴 오픈소스 코딩 에이전트 오케스트레이터 Orca의 Git worktree 격리 구조, 34종+ CLI 연동, 실사용 가드레일 6가지와 자동 한도 전환 한계를 정리했다.

#Orca #AI코딩에이전트 #ClaudeCode #Codex #GitWorktree #오픈소스 #개발도구

Orca(stablyai/orca) — 코딩 에이전트 여러 개를 동시에 돌리는 Git Worktree 오케스트레이터

Q. 코딩 에이전트를 여러 개 동시에 돌리면 파일이 서로 덮어써지지 않나요? Orca는 이 문제를 어떻게 해결하나요? Orca(stablyai/orca)는 작업마다 독립된 Git worktree와 브랜치를 자동으로 만들어 에이전트들을 격리합니다. 한 저장소 안에서 Claude Code, Codex, OpenCode 같은 CLI 에이전트를 동시에 띄워도 각자 다른 폴더와 브랜치에서 작업하기 때문에 파일 충돌이 나지 않고, 결과물은 각각 별도의 Pull Request로 모입니다.

⚠️ 정확도 가드레일: 이 글은 2026년 11월 19일 기준입니다. GitHub 스타·포크 수와 지원 에이전트 목록은 stablyai/orca 공식 저장소를 직접 열어 확인했고, 실무 사용 사례와 한계는 2026년 11월 13일과 18일에 공개된 개발자 필드 리포트를 확인해 정리했습니다. 토리스가 로컬 머신에 Orca를 직접 설치해 장시간 부하 테스트를 돌린 결과는 아니며, 공식 문서 하위 페이지의 세부 옵션과 모바일 페어링 토큰 보안 이슈의 최신 패치 반영 여부는 저장소 README만으로는 확인하지 못했습니다.

30초 요약

  • Git Worktree 격리: 작업 하나당 독립 worktree와 브랜치를 생성해 여러 코딩 에이전트를 병렬 실행해도 파일 충돌이 발생하지 않습니다.
  • 규모와 라이선스: 2026년 11월 19일 기준 GitHub 128,787 스타 · 8,161 포크를 기록한 MIT 라이선스 오픈소스입니다.
  • 내 구독 그대로 사용: Claude Code, Codex, GitHub Copilot, OpenCode, Gemini CLI 등 34종 이상의 CLI 에이전트를 추가 API 중개 없이 본인 구독으로 실행합니다.
  • 주의할 기본값: 기본 권한 모드가 Full access(--dangerously-skip-permissions)이므로 main 브랜치 푸시 차단 훅과 PR 머지 금지 규칙을 직접 걸어야 안전합니다.
  • 자동 한도 전환은 미지원: 계정별 사용량 확인과 수동 전환은 지원하지만, 한도 소진 시 다른 구독으로 자동 페일오버(failover)하는 기능은 README 기준 아직 없습니다.

Orca는 기존 IDE와 무엇이 다른가

Orca는 코드를 직접 타이핑하는 편집기가 아니라, 여러 코딩 에이전트를 동시에 지휘하는 오케스트레이션 레이어입니다. Stably AI가 2026년 3월 공개한 이 오픈소스 프로젝트는 데스크톱 앱(macOS·Windows·Linux)과 CLI, iOS·Android 모바일 컴패니언 앱, 원격 서버 런타임까지 한 묶음으로 제공합니다.

핵심은 Git의 worktree 기능입니다. 보통 한 저장소에서 AI 코딩 에이전트 두 개를 동시에 켜면 같은 파일을 동시에 고치다 작업이 엉킵니다. Orca는 GitHub나 Linear 이슈, 혹은 프롬프트를 던지는 순간 전용 worktree와 브랜치를 따로 파서 에이전트를 배정합니다.

Orca 병렬 코딩 에이전트 격리 구조

지원 범위도 넓습니다. 공식 README 기준으로 Claude Code, Codex, Grok, Cursor, GitHub Copilot, OpenCode, Cline, Continue, Qwen Code 등 34개 이상의 CLI 에이전트를 명시하며, 터미널에서 돌아가는 CLI 에이전트라면 무엇이든 붙일 수 있습니다. 별도 유료 구독을 새로 결제하는 구조가 아니라, 개발자가 이미 가진 구독 계정과 API 키를 그대로 태우는 방식입니다.

광고

한 화면에서 돌아가는 병렬 작업 흐름

Orca의 작업 흐름은 이슈 수집, 병렬 분기, Diff·PR 리뷰 세 단계로 이어집니다. 저장소를 등록하면 GitHub과 Linear 이슈가 한 표에 모이고, 각 행의 Start 버튼을 누르면 해당 이슈 URL을 첫 프롬프트로 삼는 worktree가 바로 열립니다.

기능 영역 Orca 제공 방식 실무에서 체감되는 차이
실행 UI Chat UI와 Raw CLI 간 문맥 유지 전환 대화형 지시와 터미널 디버깅을 한 창에서 왕복
원격 실행 SSH 호스트·Remote Orca Server·클라우드 VM 노트북을 덮어도 에이전트가 서버에서 계속 작업
모바일 연동 iOS/Android 앱 페어링 에이전트가 질문하거나 멈출 때 폰으로 알림 수신·답변
코드 리뷰 변경 라인별 코멘트 작성 후 에이전트에 재전달 IDE와 브라우저를 오가지 않고 피드백 루프 단축
디자인 모드 내장 브라우저 요소 클릭 → HTML·스타일·셀렉터 복사 프론트엔드 UI 수정 지시 시 정확한 DOM 맥락 전달
자동화 리포지토리별 프롬프트 스케줄 실행 야간 의존성 점검·불안정 테스트 스윕 자동화

작업을 쪼개는 방식도 흥미롭습니다. 상위 에이전트에게 큰 기능을 맡기면 하위 워커 에이전트들을 각각의 worktree에 띄워 병렬 처리한 뒤 결과를 취합해 올릴 수 있고, orca CLI 자체도 터미널에 내장돼 있어 스크립트로 worktree 생성과 에이전트 호출을 자동화할 수 있습니다. 최근 코딩 모델 가격 경쟁으로 MAI Code 2와 Flash처럼 가성비 모델이 늘어나면서, 설계는 상위 모델에 맡기고 구현 에이전트만 저렴한 모델로 여러 개 돌리는 분업 전략도 현실적인 선택지가 됐습니다.

실사용자가 짚은 6가지 사고와 필수 가드레일

Q. Orca를 설치하면 바로 마음 놓고 병렬 에이전트를 돌려도 되나요? 아닙니다. 1주일간 실전 프로젝트에 투입한 필드 리포트에 따르면, 도구 충돌이 아니라 허용된 기본 권한과 낡은 로컬 기준 브랜치 때문에 사고가 납니다.

2026년 11월 13일 dev.to에 실린 15년 차 VS Code 사용자의 실전 기록을 보면, 첫 주에 겪은 문제 대부분은 기본 설정에서 비롯됐습니다.

첫째, 기본 권한 모드가 Full access입니다. Claude Code를 --dangerously-skip-permissions 옵션으로 실행하기 때문에, 에이전트가 작업 완료 후 main 브랜치에 직접 푸시하거나 머지를 제안할 때 실수 한 번이면 그대로 반영됩니다. GitHub 무료 비공개 저장소는 브랜치 보호 규칙을 걸 수 없으므로, 모든 worktree가 공유하는 pre-push 훅으로 refs/heads/main 푸시를 막고 프롬프트 끝에 "PR만 열고 절대 머지·main 푸시 금지"를 박아두는 편이 안전합니다.

둘째, 로컬 기준 브랜치와 추적되지 않는 파일 문제입니다. 로컬 main이 원격보다 뒤처진 상태에서 worktree를 파면 에이전트가 낡은 코드를 기준으로 잘못된 답을 내놓습니다. set-base-ref 명령으로 origin/main을 기준점으로 맞추고, Git에 추적되지 않는 .env 파일이나 로컬 헬퍼 스크립트는 새 worktree에 복사해야 합니다. 또한 Orca는 바이너리를 직접 실행하므로 .zshrc의 셸 별칭이 전달되지 않아, 공통 환경변수는 ~/.claude/settings.json에 두어야 인식됩니다.

셋째, 이슈 컨텍스트와 배포 확인 범위입니다. 아직 머지되지 않은 PR에 적힌 문서를 참조하도록 이슈를 던지면 에이전트가 답을 기다리며 멈춥니다. 필요한 스펙은 이슈 본문에 직접 붙여 넣고, 작업 성격이 바뀌면(예: 색상 수정 중 인프라 변경 필요) 기존 대화를 이어가지 말고 새 worktree를 여는 것이 안전합니다.

루틴 자동화와 한도 전환의 현주소

Orca는 중앙 스케줄링(Automations)과 계정별 한도 조회(Accounts)를 제공하지만, 한도 소진 시 다른 구독으로 자동 전환하는 페일오버는 지원하지 않습니다.

2026년 11월 18일 dev.to에 공개된 루틴 오케스트레이터 비교 분석에 따르면, Orca README에는 Automations를 통한 정기 프롬프트 실행과 로그아웃 없는 수동 계정 전환이 명시돼 있지만 failover·cron·quota 기반 자동 우회 기능은 언급되지 않았습니다. 반면 자동 페일오버에 초점을 맞춘 willynikes2/agent-orchestrator(67★)는 스케줄러가 없고, 스케줄링과 구독 라우팅을 모두 넣은 christianreiss/codex-orchestrator(19★)는 아직 초기 단계입니다. 결국 생태계와 안정성 면에서는 Orca가 압도적이지만, 여러 유료 계정을 자동으로 돌려쓰는 완전 무인 파이프라인까지 기대하면 아쉽습니다.

토리스의 판단 — 언제 쓰고 언제 피할까

  • Orca를 바로 도입할 만한 경우: 혼자 또는 소규모 팀이 여러 GitHub 이슈·버그 수정·UI 개선을 동시에 처리해야 할 때, Claude Code와 Codex 같은 CLI 에이전트를 이미 유료 구독 중인데 파일 충돌 때문에 한 번에 하나씩만 돌리고 있었을 때 가장 효과가 큽니다.
  • 도입 전 가드레일이 필수인 경우: 비공개 저장소에 브랜치 보호가 없거나 프로덕션 배포 파이프라인이 연결된 저장소라면, 첫 작업 전 main 푸시 차단 훅과 origin/main 기준선 고정부터 세팅해야 합니다.
  • 아직 다른 대안이 필요한 경우: 수십 개 루틴을 24시간 돌리면서 한도 초과 시 자동으로 다른 구독 계정으로 넘겨야 하거나, 사내 보안 정책상 모바일 QR 페어링·외부 텔레메트리 옵션을 엄격히 통제해야 한다면 자동 전환 스크립트나 자체 하네스를 별도로 두는 편이 낫습니다.

토리스 스튜디오의 AI 기반 자동화·개발 파이프라인 설계 기준은 진행 방식과 개발 서비스에서도 확인할 수 있습니다.

출처

광고

YOUTUBE · TORIS STUDIO

토리스 영상 더 보기