worktree를 사용하여 병렬 세션 실행

​

worktree에서 Claude 시작

claude --worktree feature-auth

claude --worktree bugfix-123

claude --worktree

​

기본 브랜치 선택

{
  "worktree": {
    "baseRef": "head"
  }
}

claude --worktree "#1234"

​

worktree 이름 재사용

• 커밋되지 않은 변경 사항이나 추적되지 않은 파일이 없습니다.
• 여전히 Claude Code가 생성한 브랜치에 있습니다.
• 커밋하지 않았거나 풀 요청이 병합되고 원격 브랜치가 삭제되었습니다.

​

gitignored 파일을 worktree로 복사

.env
.env.local
config/secrets.json

​

worktree로 서브에이전트 격리

​

worktree 정리

• 커밋되지 않은 변경 사항 없음, 추적되지 않은 파일 없음, 새로운 커밋 없음: worktree와 해당 브랜치가 자동으로 제거됩니다. 세션에 이름이 있으면 Claude는 대신 프롬프트를 표시하여 나중을 위해 worktree를 유지할 수 있습니다
• 커밋되지 않은 변경 사항, 추적되지 않은 파일 또는 새로운 커밋 존재: Claude는 worktree를 유지하거나 제거할지 묻습니다. 유지하면 디렉토리와 브랜치가 보존되어 나중에 돌아올 수 있습니다. 제거하면 worktree 디렉토리와 해당 브랜치가 삭제되어 커밋되지 않은 모든 변경 사항, 추적되지 않은 파일 및 커밋이 버려집니다
• 비대화형 실행: --worktree와 함께 -p로 생성된 worktree는 종료 프롬프트가 없으므로 자동으로 정리되지 않습니다. git worktree remove로 제거합니다

​

worktree 수동 관리

git worktree add ../project-feature-a -b feature-a

git worktree add ../project-bugfix bugfix-123

cd ../project-feature-a && claude

git worktree list

git worktree remove ../project-feature-a

​

비git 버전 관리

{
  "hooks": {
    "WorktreeCreate": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "bash -c 'NAME=$(jq -r .name); DIR=\"$HOME/.claude/worktrees/$NAME\"; svn checkout https://svn.example.com/repo/trunk \"$DIR\" >&2 && echo \"$DIR\"'"
          }
        ]
      }
    ]
  }
}

​

참고 항목

• 서브에이전트: 세션 내의 격리된 에이전트에 작업 위임
• 에이전트 팀: 여러 Claude 세션을 자동으로 조정
• 세션 관리: 대화 이름 지정, 재개 및 전환
• 데스크톱 병렬 세션: 데스크톱 앱의 worktree 기반 세션