Git Worktrees로 여러 Claude Code 세션을 병렬로 실행하기

r/ClaudeAI의 한 개발자가 git worktree를 사용해 여러 Claude Code 세션을 병렬로 실행하는 실용적인 패턴을 공유합니다. 핵심 문제: 에이전트의 제안을 테스트하기 위해 git stash로 브랜치를 전환할 때마다 컨텍스트를 잃어버리는 점입니다.

설정 방법

• 메인 작업 트리: 리뷰 및 커밋을 수행하는 곳
• 2-3개의 추가 작업 트리: 각각 자체 브랜치에서 Claude Code 세션을 실행
• 워크플로: 에이전트가 작업을 완료하면 해당 작업 트리로 cd하여 diff를 검토하고, 병합한 후 다음 작업으로 이동

stash도, 컨텍스트 전환도, "내가 뭐 하고 있었지?"도 없습니다.

Git Worktree 빠른 시작

feature/agent-1 브랜치에 새 작업 트리를 생성하려면:

git worktree add ../project-feature-agent-1 feature/agent-1

이렇게 하면 별도의 디렉토리(../project-feature-agent-1)가 생성되며, 여기서 Claude Code(또는 다른 에이전트)를 독립적으로 실행할 수 있습니다. 각 작업 트리는 전체 작업 복사본이므로 각각 다른 브랜치를 체크아웃할 수 있습니다.

에이전트가 완료되면 메인 작업 트리에서:

cd ../project-feature-agent-1
git diff main
# 검토 후 병합
git checkout main
git merge feature/agent-1

그런 다음 작업 트리를 제거합니다:

git worktree remove ../project-feature-agent-1

AI 에이전트에 적합한 이유

일반적인 브랜치 전환은 커밋되지 않은 변경 사항을 stash하거나 작업 중인 내용을 커밋해야 하는데, 이는 흐름을 깨고 컨텍스트를 잃게 만듭니다. 작업 트리는 격리된 파일 시스템 디렉토리를 제공하므로 각 에이전트 세션이 자체 샌드박스에서 실행됩니다. 한 작업 트리에서 Claude Code를, 다른 작업 트리에서 Cursor를 실행하거나 서로 다른 프롬프트를 동시에 실행할 수 있습니다.

대상 사용자

git stash와 브랜치 전환의 오버헤드 없이 여러 실험이나 병렬 작업을 실행해야 하는 AI 코딩 에이전트(Claude Code, Cursor 등) 사용자.