worktree로 병렬 작업하기
git worktree로 작업마다 따로 체크아웃해 Claude Code 세션 여러 개를 동시에 돌려도, 서로의 파일을 덮어쓰지 않고 하나씩 합칠 수 있습니다.
claude --worktree로 이름 붙은 worktree와 브랜치를 만들어 세션을 엽니다. .env 같은 무시된 파일은 .worktreeinclude로 따라오게 하고, 끝나면 세션 종료 화면이나 git worktree remove로 정리합니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.
준비
- Claude Code 설치와 로그인
1. 준비
저장소에 커밋이 하나 이상 있어야 합니다. worktree 폴더가 커밋되지 않게 .gitignore에 넣습니다.
echo .claude/worktrees/ >> .gitignore결과: 무시 목록에 들어간 worktree 폴더
확인: git check-ignore .claude/worktrees/x로 무시되는지 확인
2. worktree 세션 열기
작업마다 이름을 줘 엽니다. .claude/worktrees/<이름>/에 worktree-<이름> 브랜치가 생깁니다. PR을 바로 받으려면 "#1234"처럼 따옴표로 번호를 줍니다.
claude --worktree feature-auth결과: 새 worktree에서 열린 세션
확인: git worktree list에 새 경로가 보이는지 확인
3. 무시된 파일 따라오게 하기
worktree는 새 체크아웃이라 .env나 node_modules가 없습니다. 프로젝트 루트의 .worktreeinclude에 .gitignore 문법으로 복사할 파일을 적고, 의존성은 worktree마다 설치합니다.
.env
.env.local결과: .worktreeinclude
확인: 새 worktree에 .env가 복사됐는지 확인
4. 다른 터미널에서 두 번째 작업
다른 이름으로 하나 더 엽니다. 두 세션은 같은 .git을 쓰지만 파일은 따로입니다.
claude --worktree fix-login-bug결과: 동시에 도는 두 세션
확인: 두 폴더의 git status가 서로 다른 변경을 보이는지 확인
5. 합치고 정리
작업이 끝나면 브랜치를 PR로 올리거나 합칩니다. 대화형 세션은 끝낼 때 변경이 없으면 worktree를 지우고, 변경이 있으면 남길지 묻습니다. -p로 돌린 것은 직접 지웁니다.
git worktree list
git worktree remove .claude/worktrees/feature-auth결과: 정리된 worktree 목록
확인: git worktree list에 지운 경로가 없는지 확인
주의
- 같은 파일을 두 작업이 동시에 크게 고치면 합칠 때 충돌. 작업을 파일 기준으로 나누기
- worktree마다 의존성 설치와 개발 서버 포트가 따로 필요
- "다시 묻지 않기" 승인은 원래 체크아웃의 .claude/settings.local.json에 저장되어 모든 worktree에 적용
댓글