🌿
NEW
Git Worktree 격리
실험적인 작업을 원본 코드와 완전히 분리된 공간에서 합니다. 실수해도 원본에 영향 없어요.
Git Worktree는 같은 저장소(Repository)를 여러 폴더에서 동시에 체크아웃할 수 있는 Git 기능입니다. Claude Code가 실험적인 변경을 할 때 안전한 별도 공간을 자동으로 만들어줍니다. 실수해도 원본은 안전합니다.
Claude Code에서 Worktree 사용
# Claude Code 내에서 /worktree 명령으로 시작
/worktree feature-login
# 또는 Claude에게 요청
"새 기능 실험 공간(worktree) 만들어줘"
# 생성된 워크트리 위치
.claude/worktrees/feature-login/
# 작업 완료 후 머지
git merge feature-login
# 또는 작업 폐기 (원본에 영향 없음)
git worktree remove .claude/worktrees/feature-login왜 필요한가요?
- •실험 중 원본 코드가 망가지는 것 방지
- •여러 기능을 동시에 독립적으로 개발
- •Agent Teams와 함께 사용 — 팀원마다 독립 워크트리
- •"테스트해봤다가 버리기" — 부담 없는 실험
- •PR 검토 시 현재 작업 중단 없이 다른 브랜치 확인
비유로 이해하기
원본 코드 = 완성된 집 (건드리면 안 됨) Worktree = 옆에 짓는 모델하우스 모델하우스에서 인테리어 이것저것 시도 → 마음에 들면 원본에 적용 마음에 안 들면? 모델하우스만 철거 → 원본은 멀쩡
Agent Teams + Worktree 조합
팀원 에이전트를 생성할 때 isolation: "worktree" 옵션을 주면, 각 팀원이 완전히 독립된 워크트리에서 작업합니다. 팀원 A와 팀원 B가 같은 파일을 동시에 수정해도 충돌이 없어요.
장점과 주의사항
- •✅ 완전한 격리 — 원본 코드 100% 안전
- •✅ 병렬 작업 — 여러 워크트리 동시 운영
- •✅ 빠른 전환 — 브랜치 체크아웃보다 빠름
- •✅ 자동 정리 — 변경 없으면 작업 완료 시 자동 삭제
- •⚠️ Git 저장소 필수 — git init이 되어 있어야 함
- •⚠️ 디스크 공간 — 워크트리마다 별도 공간 사용