동일한 저장소에서 여러 Claude Code 에이전트를 동시에 실행하는 방법이 git worktree를 통해 구현되었습니다. 각 에이전트는 자체 브랜치와 전용 작업 디렉토리를 가지므로 파일 충돌이 없고 간섭 없이 읽기/쓰기가 가능합니다.

워크플로우

• 각 브랜치에 대해 git worktree를 생성합니다.
• 각 worktree 디렉토리에서 별도의 Claude Code 세션을 엽니다.
• 에이전트가 서로를 인식하지 못한 채 병렬로 실행되도록 합니다.
• 두 작업이 완료되면 일반 git merge를 통해 브랜치를 병합합니다.

실제 예제

# 기능 브랜치용 worktree 생성
git worktree add ../repo-feature feature-branch
# 버그 수정 브랜치용 worktree 생성
git worktree add ../repo-bugfix bugfix-branch

각 디렉토리에서 Claude Code 시작
cd ../repo-feature && claude-code .
cd ../repo-bugfix && claude-code .

장점

병렬화 가능한 작업에서 실제로 속도 향상이 있습니다. 한 에이전트가 버그를 수정하는 동안 다른 에이전트가 새 기능을 초안하거나, 리팩토링과 테스트 커버리지 작업을 동시에 할 수 있습니다. 모든 작업이 깔끔하게 분할되지는 않지만, 진정으로 독립적인 작업은 충돌 없이 병렬 처리가 가능합니다. 사용자는 한 에이전트가 버그를 수정하고 다른 에이전트가 기능을 초안하는 것을 동시에 충돌 없이 수행했다고 보고했습니다.

고려사항

사용자는 장기 실행 작업의 안정성과 대규모에서 병합 충돌이 문제가 되는지에 대해 질문합니다. worktree 브랜치를 병합할 때 표준 git merge 해결 방식이 적용됩니다.

대상

동일한 코드베이스에서 독립적인 작업을 병렬화하려는 Claude Code 사용자.