Git Worktree를 활용한 AI 코딩 병렬 작업법
- •개발자는 Git Worktree를 사용하여 여러 AI 코딩 에이전트 세션을 동시에 실행할 수 있다.
- •각 Worktree는 독립적인 디렉터리를 제공하여 서로 다른 기능 브랜치 간의 실수로 인한 커밋을 방지한다.
- •수동 Git Worktree 설정으로 브랜치 이름과 기본 구성을 정밀하게 제어할 수 있다.
소프트웨어 개발자 아드레야(Athreya)는 Git Worktree를 활용해 여러 Claude Code AI 세션을 동시에 실행하는 작업 방식을 공개했다. 동일한 저장소에 대해 분리된 작업 디렉터리를 구성하면, 수동으로 데이터를 저장(Stashing)하거나 문맥을 전환할 필요 없이 여러 기능을 서로 다른 브랜치에서 동시에 작업할 수 있다.
Git Worktree는 하나의 저장소에서 여러 디렉터리를 체크아웃할 수 있게 해주는 기능으로, 개발자가 작업 간의 격리를 유지하도록 돕는다. 각 작업은 고유 브랜치와 연결된 개별 폴더에서 진행되며, 특정 Claude Code 에이전트와 매핑된다. 이 구조 덕분에 파일이 겹치지 않으며, 각 Worktree가 단일 브랜치에 고정되어 있어 잘못된 브랜치에 코드를 커밋하는 상황을 물리적으로 방지한다.
구현을 위해서는 'git worktree add -b [branch] [directory] master' 명령어를 사용한다. 설정이 완료되면 각 터미널 세션에서 독립적인 Claude 인스턴스를 실행할 수 있으며, '/rename' 명령어로 세션 이름을 브랜치명과 일치시켜 관리 효율을 높일 수 있다. 터미널 기반 인터페이스인 TUI 파일 브라우저 'peektea'를 사용하는 경우, 각 Worktree 내부에서 로컬 바이너리를 빌드하고 실행하면 포트 충돌이나 프록시 관리 문제 없이 독립적인 기능 테스트가 가능하다.
Claude Code CLI 도구는 빠른 실험을 위한 '--worktree' 플래그를 제공하지만, 체계적인 업무를 위해서는 수동 설정이 브랜치 명명 및 기본 브랜치 선택 측면에서 더 유리하다. 작업 완료 후 'git worktree remove'로 디렉터리를 삭제해도 브랜치는 보존되어 데이터 손실을 막을 수 있다. 이러한 병렬 방식은 순차적이었던 개발 프로세스를 동시 작업 체계로 전환하여 여러 기능을 격리된 환경에서 개발, 검토, 테스트하도록 지원한다.