Orca ADE란? Codex를 워크트리에서 병렬로 사용하는 방법

이 글에서 사용하는 주요 용어 정의

용어	뜻
Orca ADE	여러 AI 코딩 에이전트의 작업 공간과 실행 상태를 한곳에서 관리하는 데스크톱 개발 환경
Codex	저장소를 읽고 코드를 수정하며 명령을 실행할 수 있는 OpenAI의 코딩 에이전트
Git worktree	하나의 Git 저장소에 여러 작업 디렉터리를 연결해 브랜치를 동시에 다루는 기능
격리된 작업 공간	한 에이전트의 파일 변경이 다른 작업의 작업 디렉터리와 직접 섞이지 않는 환경
병렬 작업	서로 독립적인 개발 업무를 여러 에이전트가 같은 시간대에 나누어 처리하는 방식

---

도입

Codex에 여러 일을 동시에 맡기고 싶을 때 가장 먼저 부딪히는 문제는 모델 성능보다 파일 충돌입니다. 한 작업 디렉터리에서 두 에이전트가 같은 파일을 수정하면, 어느 변경이 누구의 것인지 구분하기 어렵고 테스트 결과도 서로 영향을 받습니다.

Orca ADE는 이 문제를 Git worktree와 작업별 에이전트 세션으로 풀어냅니다. 각 작업에 별도 작업 디렉터리를 주고 그 안에서 Codex를 실행하므로, 기능 개발과 버그 조사처럼 독립적인 일을 동시에 진행하기 쉬워집니다. 다만 Orca 자체가 새로운 AI 모델은 아닙니다. 이미 사용하는 Codex 같은 에이전트를 여러 작업 공간에서 운영하도록 돕는 하네스에 가깝습니다.

---

Orca ADE는 무엇을 관리하나

Orca 문서에 따르면 하나의 작업은 대체로 다음 요소를 묶습니다.

[Git 저장소]
      │
      ├─ 작업 A: worktree + Codex 터미널 + 브라우저
      ├─ 작업 B: worktree + Codex 터미널 + 브라우저
      └─ 작업 C: worktree + Codex 터미널 + 브라우저

핵심은 에이전트의 대화창만 여러 개 띄우는 것이 아닙니다. 작업마다 파일 시스템과 브랜치 상태를 분리하고, 어느 에이전트가 어떤 변경을 만들었는지 추적할 수 있게 하는 데 의미가 있습니다.

Git의 공식 문서에서 worktree는 하나의 저장소에 여러 작업 트리를 연결하는 기능으로 설명됩니다. 따라서 한 worktree에서 기능 브랜치를 수정하는 동안 다른 worktree에서는 별도의 브랜치로 테스트나 문서 작업을 진행할 수 있습니다.

---

Codex를 워크트리에서 병렬로 쓰는 구조

1. 작업을 독립 단위로 나눈다

병렬 실행 전에 먼저 작업 경계를 정해야 합니다. 다음 조합은 비교적 분리하기 쉽습니다.

• API 오류 원인 조사와 사용자 문서 초안 작성
• 프런트엔드 화면 구현과 백엔드 테스트 보강
• 서로 다른 모듈의 버그 수정

반대로 두 작업이 같은 핵심 파일을 계속 고쳐야 한다면 worktree가 있어도 마지막 병합에서 충돌할 수 있습니다.

2. 작업별 worktree를 만든다

개념적으로는 다음과 같은 Git 명령과 같습니다.

git worktree add ../project-feature-a -b feature/a
git worktree add ../project-bugfix-b -b fix/b

Orca는 이 작업 공간 생성을 인터페이스 안에서 관리합니다. 각 작업은 원본 저장소와 Git 객체를 공유하지만, 체크아웃된 파일과 현재 브랜치는 별도로 유지됩니다.

3. 각 worktree에서 Codex를 실행한다

Orca에서 에이전트로 Codex를 선택하면 해당 작업의 worktree가 현재 작업 디렉터리인 상태로 세션이 시작됩니다. 그래서 Codex가 읽고 수정하는 범위도 그 작업 공간을 기준으로 잡힙니다.

작업 A의 Codex → feature/a 브랜치 → 기능 구현
작업 B의 Codex → fix/b 브랜치     → 버그 수정
작업 C의 Codex → docs/c 브랜치    → 문서 작성

4. 결과를 각각 검토하고 통합한다

병렬 실행이 끝나면 테스트 결과와 diff를 작업별로 확인합니다. 이후 일반적인 Git 흐름에 따라 커밋을 정리하고 기준 브랜치에 병합합니다. worktree는 충돌 가능성을 없애는 기능이 아니라, 수정 중인 작업 공간이 서로 섞이는 문제를 줄이는 기능입니다.

---

어떤 작업에 적합할까

작업 유형	적합도	이유
독립 모듈 조사	높음	읽기 범위와 결과물이 잘 분리됨
여러 테스트 묶음 실행	높음	실행 상태와 로그를 작업별로 관리 가능
기능 구현과 문서화	높음	수정 파일이 겹칠 가능성이 비교적 낮음
같은 파일의 대규모 리팩터링	낮음	마지막 병합에서 충돌과 중복 판단이 늘어남
앞 작업 결과가 필요한 연쇄 작업	낮음	병렬화보다 순차 실행이 자연스러움

실무에서는 모든 업무를 동시에 돌리기보다, 먼저 탐색과 테스트처럼 독립성이 높은 일을 분리하는 편이 안정적입니다. 구현 작업은 파일 소유 범위를 명확히 정할 수 있을 때 병렬화하는 것이 좋습니다.

---

사용할 때 알아둘 제한 사항

같은 브랜치를 여러 worktree에서 체크아웃할 수 없다

Git은 일반적으로 하나의 브랜치를 동시에 여러 worktree에서 체크아웃하지 못하게 막습니다. 작업마다 별도 브랜치를 두는 구조가 필요한 이유입니다.

병렬 세션만큼 검토량도 늘어난다

에이전트 세 개가 동시에 결과를 만들면 사람이 검토해야 할 diff와 테스트 결과도 세 묶음이 됩니다. 실행 속도가 빨라졌다고 해서 통합 비용까지 자동으로 줄어드는 것은 아닙니다.

저장소 규칙은 모든 작업 공간에 일관되게 적용해야 한다

AGENTS.md, 테스트 명령, 코드 스타일 같은 저장소 규칙은 각 Codex 세션이 동일하게 이해할 수 있어야 합니다. 작업별 프롬프트만으로 규칙을 반복하기보다 저장소 안에 영속적인 지침을 두는 편이 관리하기 쉽습니다.

인증 정보는 작업 결과와 분리한다

Codex 로그인 정보나 API 키를 저장소 파일에 넣어서는 안 됩니다. Orca와 Codex의 계정 설정을 사용하고, .env 같은 민감한 파일이 커밋 대상에 포함되지 않았는지 diff에서 확인해야 합니다.

---

마무리

Orca ADE의 장점은 AI 모델을 더 똑똑하게 만드는 데 있지 않습니다. 여러 Codex 세션에 분리된 Git 작업 공간을 제공하고, 병렬 작업의 상태를 사람이 파악하기 쉽게 만드는 데 있습니다.

효과를 보려면 작업부터 잘 나눠야 합니다. 파일 의존성이 낮은 조사, 테스트, 문서화부터 worktree로 분리하고, 결과를 작업별로 검토한 뒤 병합하는 흐름이 가장 현실적입니다. 서로 강하게 얽힌 수정은 하나의 에이전트가 순차적으로 처리하는 편이 오히려 빠를 수 있습니다.

---

참고 자료

• Orca Documentation
• Orca Documentation - Codex
• Git Documentation - git-worktree
• OpenAI Codex Manual