Worktree 실전 — claude --worktree로 시작하기

Claude Code에는 Worktree를 자동으로 만들어주는 내장 기능이 있습니다. 복잡한 Git 명령어를 외울 필요 없이, claude --worktree 뒤에 이름만 붙이면 됩니다. 이 명령을 실행하면 Claude Code가 알아서 새로운 브랜치를 만들고, 별도의 작업 폴더를 생성하고, 그 안에서 Claude Code를 실행합니다. 여러분은 이름만 정해주면 됩니다. 노무사 비유로 설명하면, "사무장님, 새 책상 하나 펼쳐서 임금체불 사건 서류 준비해 주세요"라고 한마디 하는 것과 같습니다. 사무장이 알아서 책상을 세팅하고, 관련 서류를 꺼내놓고, 작업 준비를 마쳐줍니다. 작업이 끝나면 정리도 자동입니다. 변경사항이 없으면 자동으로 삭제되고, 변경사항이 있으면 "정리할까요?"라고 물어봅니다. 마치 "이 책상 치울까요, 아니면 내일 이어서 하실 건가요?"라고 묻는 것과 같습니다.

# 가장 간단한 사용법: claude --worktree 이름
claude --worktree feature-login

# 줄여서 -w 옵션도 사용 가능합니다
claude -w bugfix-payment

# 실행하면 이런 안내가 표시됩니다:
# ✓ Created worktree at .claude/worktrees/feature-login
# ✓ Switched to branch 'feature-login'
# ✓ Starting Claude Code...

실제로 두 개의 작업을 동시에 여는 과정을 단계별로 따라해 봅시다. 1단계: 터미널을 엽니다. (이전 레슨에서 배운 것처럼 Mac에서는 Command + Space → "터미널" 검색) 2단계: 프로젝트 폴더로 이동합니다. cd 명령으로 작업할 프로젝트 폴더에 들어갑니다. 3단계: 첫 번째 Worktree를 만듭니다. claude --worktree unfair-dismissal 이라고 입력합니다. Claude Code가 새 워크트리를 만들고 자동으로 실행됩니다. 이 터미널 창에서 부당해고 관련 작업을 시작합니다. 4단계: 새 터미널 창을 엽니다. (Command + T 또는 Command + N) 같은 프로젝트 폴더로 이동합니다. 5단계: 두 번째 Worktree를 만듭니다. claude --worktree wage-claim 이라고 입력합니다. 이 터미널 창에서 임금체불 관련 작업을 시작합니다. 이제 두 개의 터미널 창에서 각각 다른 작업이 동시에 진행됩니다! 한쪽에서 AI가 구제신청서를 작성하는 동안, 다른 쪽에서 진정서를 작성할 수 있습니다.

# ── 터미널 창 1 ──
cd ~/my-labor-project
claude --worktree unfair-dismissal
# → "부당해고 구제신청서 초안을 작성해 주세요" 라고 요청

# ── 터미널 창 2 (새 창 열기: Command + T) ──
cd ~/my-labor-project
claude --worktree wage-claim
# → "임금체불 진정서 초안을 작성해 주세요" 라고 요청

# 두 작업이 동시에 진행됩니다!
# 터미널 창을 오가며 진행 상황을 확인하세요.

claude --worktree 기능이 가장 편리하지만, 상황에 따라 수동으로 워크트리를 만들어야 할 때도 있습니다. 예를 들어 특정 브랜치를 지정하고 싶거나, 폴더 위치를 직접 정하고 싶을 때입니다. 수동 방식도 어렵지 않습니다. git worktree add 명령으로 워크트리를 만들고, 해당 폴더에서 claude를 실행하면 됩니다. 다만 초보 단계에서는 방법 A(claude --worktree)를 사용하시는 것을 강력히 권장합니다. 자동 정리 기능도 있고, 실수할 여지가 적습니다. 방법 B는 "이런 것도 가능하구나" 정도로 알아두시면 됩니다.

# 수동으로 워크트리 만들기
git worktree add ../my-project-wage-claim wage-claim-branch

# 해당 폴더로 이동해서 Claude Code 실행
cd ../my-project-wage-claim
claude

# 작업 완료 후 정리
cd ..
git worktree remove my-project-wage-claim

실무에서 자주 발생하는 상황을 시뮬레이션해 봅시다. 오전에 3건의 작업이 동시에 들어왔습니다. 사건 1: 부당해고 구제신청서 — 의뢰인 김OO, A병원에서 부당해고, 신청 기한이 다음 주 사건 2: 임금체불 진정서 — 의뢰인 이OO, B건설에서 3개월 임금 미지급 사건 3: 취업규칙 검토 — C요양병원, 2026년 개정법 반영 여부 확인 기존에는 긴급도 순서대로 하나씩 처리해야 했습니다. 구제신청서 2시간, 진정서 1시간, 취업규칙 검토 2시간으로 총 5시간. 하지만 Worktree로 3개를 동시에 AI에게 맡기면, 각각의 초안이 거의 동시에 완성됩니다. AI가 초안을 작성하는 데 각 10~15분이면, 15분 후에 3건의 초안을 검토하고 수정하면 됩니다. 5시간이 1시간으로 줄어드는 효과입니다.

# ── 터미널 1: 부당해고 구제신청서 ──
claude -w unfair-dismissal
# "김OO 부당해고 구제신청서를 작성해 주세요.
#  A병원, 간호사, 근속 3년, 해고사유: 환자 응대 불량..."

# ── 터미널 2: 임금체불 진정서 ──
claude -w wage-claim
# "이OO 임금체불 진정서를 작성해 주세요.
#  B건설, 현장소장, 3개월 미지급, 월 350만원..."

# ── 터미널 3: 취업규칙 검토 ──
claude -w work-rules-review
# "C요양병원 취업규칙을 2026년 개정 노동법 기준으로
#  검토해 주세요. 특히 육아휴직(6+6) 반영 여부 확인..."