# worktree로 병렬 작업하기
id: claude-code-worktree · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/claude-code-worktree
기준일: 2026-11-21 (여기서 고친 날)
도구: Claude Code
걸리는 시간: 약 15분
평가 점수: 32/100 (확인 없음 · 검수 대기)

git worktree로 작업마다 따로 체크아웃해 Claude Code 세션 여러 개를 동시에 돌려도, 서로의 파일을 덮어쓰지 않고 하나씩 합칠 수 있습니다.

설명: claude --worktree로 이름 붙은 worktree와 브랜치를 만들어 세션을 엽니다. .env 같은 무시된 파일은 .worktreeinclude로 따라오게 하고, 끝나면 세션 종료 화면이나 git worktree remove로 정리합니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.

준비물: Claude Code 설치와 로그인

단계:
1. [명령 실행 · Claude Code] 준비 — 저장소에 커밋이 하나 이상 있어야 합니다. worktree 폴더가 커밋되지 않게 .gitignore에 넣습니다.
   프롬프트:
   > echo .claude/worktrees/ >> .gitignore
   기대 결과: 무시 목록에 들어간 worktree 폴더
   확인 방법: git check-ignore .claude/worktrees/x로 무시되는지 확인
2. [명령 실행 · Claude Code] worktree 세션 열기 — 작업마다 이름을 줘 엽니다. .claude/worktrees/<이름>/에 worktree-<이름> 브랜치가 생깁니다. PR을 바로 받으려면 "#1234"처럼 따옴표로 번호를 줍니다.
   프롬프트:
   > claude --worktree feature-auth
   기대 결과: 새 worktree에서 열린 세션
   확인 방법: git worktree list에 새 경로가 보이는지 확인
3. [사람이 · Claude Code] 무시된 파일 따라오게 하기 — worktree는 새 체크아웃이라 .env나 node_modules가 없습니다. 프로젝트 루트의 .worktreeinclude에 .gitignore 문법으로 복사할 파일을 적고, 의존성은 worktree마다 설치합니다.
   프롬프트:
   > .env
   > .env.local
   기대 결과: .worktreeinclude
   확인 방법: 새 worktree에 .env가 복사됐는지 확인
4. [명령 실행 · Claude Code] 다른 터미널에서 두 번째 작업 — 다른 이름으로 하나 더 엽니다. 두 세션은 같은 .git을 쓰지만 파일은 따로입니다.
   프롬프트:
   > claude --worktree fix-login-bug
   기대 결과: 동시에 도는 두 세션
   확인 방법: 두 폴더의 git status가 서로 다른 변경을 보이는지 확인
5. [명령 실행 · Claude Code] 합치고 정리 — 작업이 끝나면 브랜치를 PR로 올리거나 합칩니다. 대화형 세션은 끝낼 때 변경이 없으면 worktree를 지우고, 변경이 있으면 남길지 묻습니다. -p로 돌린 것은 직접 지웁니다.
   프롬프트:
   > git worktree list
   > git worktree remove .claude/worktrees/feature-auth
   기대 결과: 정리된 worktree 목록
   확인 방법: git worktree list에 지운 경로가 없는지 확인

주의:
- 같은 파일을 두 작업이 동시에 크게 고치면 합칠 때 충돌. 작업을 파일 기준으로 나누기
- worktree마다 의존성 설치와 개발 서버 포트가 따로 필요
- "다시 묻지 않기" 승인은 원래 체크아웃의 .claude/settings.local.json에 저장되어 모든 worktree에 적용

출처:
- Claude Code 문서: worktree로 병렬 세션 https://code.claude.com/docs/en/worktrees
- Claude Code 문서: 자주 쓰는 작업 https://code.claude.com/docs/en/common-workflows