🌿 Git Worktree — 안전한 실험 공간

Git Worktree = 안전한 실험 공간

코드를 수정하다가 “아, 이거 잘못 건드렸다” 싶을 때 있잖아요? 되돌리려 해도 어디까지 바꿨는지 기억이 안 나고, 원본이 망가질까 봐 불안하고. 이런 경험, 다들 있을 거예요.

Git Worktree는 이 문제를 깔끔하게 해결해줘요. 원본 코드는 그대로 두고, 옆에 완전히 독립된 복사본을 만들어서 거기서 마음껏 실험하는 거예요.

비유하면 모델하우스와 같아요. 실제로 살고 있는 우리 집(원본)은 건드리지 않고, 바로 옆에 모델하우스(워크트리)를 지어서 인테리어를 바꿔보고, 벽지를 바꿔보고, 가구를 옮겨보는 거예요. 마음에 들면 우리 집에도 적용하고, 마음에 안 들면 모델하우스를 철거하면 끝이에요.

왜 Worktree가 필요할까?

“그냥 브랜치 만들면 되지 않아?”라고 생각할 수 있어요. 맞아요, 브랜치도 실험용으로 쓸 수 있어요. 하지만 Worktree는 브랜치보다 훨씬 편한 점이 있어요.

브랜치 전환 vs Worktree — 비교

Worktree 만들기 — /worktree 한 줄이면 끝

Claude Code에서는 Worktree를 만드는 것이 정말 쉬워요. 슬래시 명령어 하나면 됩니다.

방법 1: Claude Code 슬래시 명령어 (가장 쉬움)

/worktree

이렇게 입력하면 Claude Code가 알아서 새 브랜치를 만들고, 워크트리 폴더를 생성하고, 거기로 이동까지 해줘요. 한 줄이면 끝이에요.

방법 2: 직접 git 명령어 사용

슬래시 명령어 없이 직접 하고 싶다면, git 명령어를 쓸 수도 있어요.

# 상위 폴더에 새 워크트리 생성
git worktree add ../my-experiment feat/new-feature

# 설명:
# ../my-experiment  → 워크트리가 만들어질 폴더 경로
# feat/new-feature  → 새 브랜치 이름

# 워크트리 폴더로 이동
cd ../my-experiment

# 여기서 자유롭게 작업!
# 원본 폴더와 완전히 독립되어 있어요.

전체 흐름 — 4단계

관리 명령어 — 이것만 알면 돼요

git worktree list

# 출력 예시:
# /home/user/my-project       abc1234 [main]
# /home/user/my-experiment    def5678 [feat/new-feature]

실험이 마음에 들 때 — merge(합치기)

# 1. 워크트리에서 변경 사항 커밋
cd ../my-experiment
git add .
git commit -m "새 기능 완성"

# 2. 원본 폴더로 돌아가서 merge
cd ../my-project
git merge feat/new-feature

# 3. 워크트리 정리
git worktree remove ../my-experiment
git branch -d feat/new-feature

실험이 마음에 안 들 때 — 삭제

# 워크트리 삭제 (폴더도 함께 삭제됨)
git worktree remove ../my-experiment

# 브랜치도 삭제 (선택)
git branch -D feat/new-feature

# 끝! 원본은 아무것도 안 바뀌어 있어요.

Agent Teams와 조합하기

Worktree의 진짜 힘은 Agent Teams와 함께 쓸 때 나와요. Agent Teams는 Claude Code가 여러 “팀원(에이전트)”을 만들어서 동시에 작업하는 기능이에요.

문제는, 여러 에이전트가 같은 폴더에서 동시에 작업하면 서로 파일을 덮어쓰거나 충돌이 날 수 있다는 거예요. 마치 요리사 3명이 같은 도마 하나에서 동시에 칼질하는 것과 같아요. 위험하죠?

그래서 Agent Teams는 각 에이전트에게 별도의 워크트리를 줘요. 요리사마다 자기 도마를 갖는 거예요. 각자 독립적으로 작업하고, 다 끝나면 결과를 합치는 방식이에요.

Agent Teams + Worktree 작동 원리

우리 프로젝트에 3개 페이지를 동시에 만들어줘.

1. 홈페이지 - 히어로 섹션 + 소개 + CTA
2. 서비스 페이지 - 서비스 3개 카드형 레이아웃
3. 팀 소개 페이지 - 팀원 프로필 그리드

각각 독립적으로 작업하고, 완성되면 merge해줘.

이렇게 지시하면 Claude Code가 알아서 워크트리 3개를 만들고, 에이전트 3명이 동시에 작업한 뒤, 결과를 합쳐줘요. 여러분은 최종 결과만 확인하면 돼요.

직접 해보기

Worktree를 직접 만들어보세요. git이 설치되어 있고, git으로 관리하는 프로젝트가 있으면 바로 할 수 있어요.

# 기존 프로젝트 폴더에서 실행
git worktree add ../my-test-experiment test/experiment

# 생성 확인
git worktree list

# 워크트리 폴더로 이동
cd ../my-test-experiment

# 아무 파일이나 수정해보기
echo "실험 중입니다!" > test-file.txt

# 커밋
git add .
git commit -m "워크트리 실험"

# 원본 폴더로 돌아가서 확인
cd ../my-project

# test-file.txt가 없어요! 원본은 안전해요.
ls test-file.txt
# 파일 없음!

# 방법 1: 슬래시 명령어
/worktree

# 방법 2: 한국어로 지시
워크트리를 만들어서 새 기능을 실험해줘.
홈페이지 디자인을 파란색 테마로 바꿔보고 싶어.
마음에 안 들면 삭제하면 되니까 과감하게 해줘.

방금 워크트리에서 만든 파란색 테마가 마음에 들어.
원본 프로젝트에 merge해줘.
그리고 워크트리는 정리해줘.

확인 체크리스트

활용 팁 + 주의사항

Worktree를 실전에서 쓸 때 알아두면 좋은 팁과 주의사항들이에요.

# 좋은 이름 (목적이 명확)
git worktree add ../mk-login-page feat/login
git worktree add ../mk-bug-fix-123 fix/issue-123
git worktree add ../mk-redesign feat/redesign

# 나쁜 이름 (뭔지 모름)
git worktree add ../test1 branch1
git worktree add ../temp branch2

git worktree add ../my-experiment feat/experiment
cd ../my-experiment
npm install   # 이걸 먼저!
npm run dev

워크트리에서 만든 기능을 PR로 올려줘.
리뷰 받고 merge하고 싶어.