[AI] 2. Claude Code 병렬 처리로 효율 극대화하기 - git worktree 기본 개념

1. [AI] Claude Code 병렬 처리로 효율 극대화하기 - git worktree 기본 개념

2. [AI] Claude Code 병렬 처리로 효율 극대화하기 - (claude --worktree)

3. [AI] Claude Code 병렬 처리로 효율 극대화하기 - tmux 활용하기

4. [AI] Claude Code 병렬 처리로 효율 극대화하기 - git worktree 기본 개념

5. [AI] Claude Code 병렬 처리로 효율 극대화하기 - cmux, worktree, omc 병렬 처리하기 (.omc/handoffs, .omc/shared_memory.json)

 

• 지난 글에서는 하나의 Git 저장소를 공유하면서 물리적인 작업 폴더를 격리하는 git worktree 기본 개념에 대해 알아봄
• 개념은 좋지만, 매번 터미널에 git worktree add ../폴더명 -b 브랜치명을 직접 치고 경로를 계산해서 이동하는 과정은 꽤 번거로움
• 하지만 Claude Code를 사용하면 이 모든 복잡한 Git 과정을 명령어 단 한 줄로 자동화할 수 있음. 공식 문서에서 소개하는 claude --worktree 플래그의 실전 활용법을 정리.

1. claude --worktree 란?

Claude Code에는 Git Worktree 기능을 래핑(Wrapping)한 내장 명령어가 포함되어 있음

# 기본 사용법
$ claude --worktree [워크트리 이름]
# 또는 축약형
$ claude -w [워크트리 이름]

터미널에서 이 명령어를 입력하는 순간, Claude Code가 백그라운드에서 다음 작업들을 자동으로 수행함.

1. 현재 프로젝트 내의 숨김 디렉토리(.claude/worktrees/[워크트리 이름]) 생성
2. 해당 경로에 새로운 Git Worktree 세팅 및 전용 브랜치 자동 생성
3. 격리된 해당 폴더 내부에서 Claude Code 세션을 즉시 실행

개발자가 직접 폴더를 만들고 브랜치를 따서 이동할 필요 없이, 명령어 한 줄로 Claude 전용 독립 공간이 완성

2. 실전 활용 시나리오 (병렬 세션 돌리기)

가장 강력한 점은 터미널 탭을 여러 개 열어 서로 다른 작업을 수행하는 Claude를 동시에 여러 대 실행(Parallel Sessions)할 수 있다는 것

터미널 1: 내 작업 공간 (Human)

원래 하던 피처 개발 코드를 작성. 브랜치는 main 또는 feature/login 상태 유지.

$ cd my-project
# 평소처럼 내 키보드로 직접 코딩 진행

터미널 2: Claude 가동 (UI 리팩토링)

새 터미널 탭을 열고 UI 리팩토링 전용 워크트리를 띄워 Claude에게 일을 던짐.

$ claude -w refactor-ui
# 세션 진입 후 Claude에게 명령: "공통 버튼 컴포넌트 구조 좀 개선해줘"

터미널 3: 또 다른 Claude 가동 (유닛 테스트 작성)

또 하나의 터미널 탭을 열고 테스트 코드 작성을 시킴

$ claude -w write-test
# 세션 진입 후 Claude에게 명령: "기존 API 통신 로직 단위 테스트 코드 싹 다 짜놔"

이렇게 세팅하면 나, UI 고치는 Claude, 테스트 짜는 Claude 3명이서 하나의 프로젝트를 동시에 쪼개서 작업하는 상태가 됨. 서로 다른 폴더와 브랜치를 바라보고 있으므로 파일이 꼬이거나 빌드가 깨질 염려가 없음.

3. 작업 완료 후 동기화 및 정리 방법

Claude가 지시한 작업을 모두 끝마쳤다면, 마무리 프로세스도 매우 단순.

① Claude 세션 내부에서 커밋 및 푸시

Claude가 수정한 코드가 마음에 든다면, Claude 세션이 켜져 있는 상태 그대로 커밋과 푸시를 요청함

🤖 Claude: 작업을 완료했습니다. 커밋할까요?
👤 User: 응, 커밋하고 원격 저장소에 push까지 해줘.

• Claude가 해당 워크트리 브랜치 상태로 GitHub에 코드를 push함.

② 메인 작업 공간에서 합치기 (PR & Merge)

이제 내 원래 터미널(Human 작업 공간)로 돌아와서 평소처럼 GitHub에서 PR을 날려 머지(Merge)하면 됨. 원격에서 main 브랜치로 합쳐졌다면 최신 코드를 땡김

$ git checkout main
$ git pull origin main

③ 다 쓴 워크트리 청소하기

작업이 끝난 Claude 워크트리는 디스크 용량 관리를 위해 지워주는 것이 좋음. 메인 폴더에서 아래 명령어로 정리함.

# 사용법: git worktree remove .claude/worktrees/[워크트리 이름]
$ git worktree remove .claude/worktrees/refactor-ui
$ git worktree remove .claude/worktrees/write-test

• 해당 명령어를 치면 숨김 폴더 내부에 잡혀있던 임시 워크트리 폴더들이 깔끔하게 날아감.

요약

• claude --worktree [이름] 명령어 하나로 Git 워크트리 생성부터 브랜치 관리, 세션 실행까지 자동화됨.
• 터미널 멀티 탭을 활용해 독립된 환경의 Claude 세션을 여러 개 병렬로 가동할 수 있음.
• 복잡한 리팩토링이나 빌드가 오래 걸리는 작업을 AI에게 비동기로 던져두고, 본인의 메인 컨텍스트를 유지하며 개발 생산성을 극대화할 수 있는 가장 완벽한 방법임.