git worktree로 여러 AI 코딩 에이전트를 병렬로 실행하는 방법

2026년을 거치며 AI 지원 개발에서 가장 큰 변화 중 하나는, 더 이상 단일 에이전트를 단일 작업에 겨누지 않는다는 것입니다. Claude Code와 Cursor 같은 도구는 이제 여러 에이전트를 병렬로 실행하도록 권장합니다 — 하나는 버그를 고치고, 다른 하나는 테스트를 작성하고, 세 번째는 기능 초안을 잡습니다. 함정: 그들이 모두 같은 작업 디렉터리를 편집하면, 서로의 변경을 덮어쓰고 빌드를 망가뜨립니다.

깔끔한 해결책은, 알고 보면 이 일에 완벽한 기본 요소인 오래된 Git 기능입니다: worktree.

worktree가 실제로 무엇인가

보통 Git 저장소는 하나의 작업 디렉터리 — 파일을 편집하는 폴더 — 를 가집니다. git worktree는 한 저장소가 동시에 여러 작업 디렉터리를 갖게 해주며, 각각 다른 브랜치로 체크아웃되고, 모두 같은 기저 .git 히스토리를 공유합니다. 각 worktree는 자신만의 파일을 가진 디스크상의 실제 폴더이므로, 한 곳에서 작업하는 에이전트가 다른 곳의 파일을 건드릴 수 없습니다.

세 사람이 키보드 하나를 두고 다투는 대신, 같은 사무실에서 모든 에이전트에게 자기 책상을 주는 것이라고 생각하세요.

핵심 워크플로

저장소 안에서, 각 작업마다 자신의 브랜치로 worktree를 생성하세요:

# Create a new branch + folder for an auth bug fix
git worktree add ../myapp-auth-fix -b fix/auth-bug

# Another for a feature, in parallel
git worktree add ../myapp-search -b feat/search

# See everything you have checked out
git worktree list

이제 메인 저장소 옆에 두 개의 형제 폴더가 생겼습니다: myapp-auth-fix와 myapp-search. 각각에서 별도의 에이전트 세션을 여세요 — cd ../myapp-auth-fix로 들어가 거기서 Claude Code를 시작하고, 다른 터미널 탭에서 ../myapp-search에 대해 같은 일을 하세요. 각 에이전트는 완전하고 독립적인 체크아웃을 가집니다. 동시에 실행되고, 각자의 브랜치에 커밋하며, 절대 충돌하지 않습니다.

작업이 끝나면, 브랜치를 병합하고 worktree를 제거해 정리하세요:

git checkout main
git merge fix/auth-bug
git worktree remove ../myapp-auth-fix

구체적인 예시

작은 웹 앱을 만들고 있고 독립적인 작업 세 개가 있다고 합시다: 불안정한 로그인 리다이렉트 고치기, 목록에 페이지네이션 추가하기, 느린 의존성 올리기. 하나씩 하는 대신:

git worktree add ../app-login   -b fix/login-redirect
git worktree add ../app-paging  -b feat/pagination
git worktree add ../app-deps    -b chore/upgrade-deps

각 폴더에서 집중된 프롬프트로 에이전트를 띄우세요. 로그인 에이전트가 리다이렉트 로직을 추적하는 동안, 페이지네이션 에이전트는 이미 컴포넌트를 작성하고 있고, 의존성 에이전트는 업그레이드와 테스트 스위트를 실행하고 있습니다. 20분 후, 깨끗하게 분리된 세 개의 브랜치를 검토하고 통과한 것들을 병합합니다.

정신을 유지해 주는 팁

• 작업을 독립적으로 유지하세요. worktree는 파일 충돌을 막지만, 두 에이전트가 서로 다른 브랜치에서 같은 파일을 편집하면 끝에서 여전히 병합 충돌을 만납니다. 자연스러운 이음새를 따라 작업을 나누세요.
• 각 worktree에 동일한 컨텍스트를 주세요. 저장소에 커밋된 CLAUDE.md(또는 동등한 규칙 파일)는 모든 worktree로 자동으로 따라가므로, 각 에이전트가 당신의 관례를 물려받습니다.
• 의존성 폴더를 주시하세요. node_modules, 가상 환경, 빌드 캐시는 worktree 간에 공유되지 않습니다. worktree마다 npm install을 한 번씩 실행하거나, 모든 것을 다시 내려받지 않도록 전역 저장소가 있는 패키지 매니저(pnpm, uv)를 써야 할 수 있습니다.
• 과도하게 병렬화하지 마세요. 실무에서는 동시 에이전트 3~5개가 최적점입니다. 그 이상이면 검토하고 조율하는 데 드는 시간이 얻는 속도를 능가합니다.

주요 도구 전반에 네이티브 worktree 통합이 2025년 말부터 들어오고 있고, 세션을 띄워 주는 전용 런처도 이제 존재합니다. 하지만 시작하는 데는 그중 아무것도 필요 없습니다 — git worktree add는 Git에 내장되어 있고, 오늘 작동하며, 여러 AI 에이전트가 서로 발에 걸리지 않으면서 당신을 위해 동시에 빌드하게 하는 가장 신뢰할 수 있는 단 하나의 방법입니다.