로드 중
로드 중

Claude Code의 여러 인스턴스를 병렬로 실행하는 것은 생산성을 가장 크게 높일 수 있는 방법 중 하나입니다. Claude는 가볍기 때문에 여러 개의 복사본을 쉽게 실행하고, 각각에 다른 작업을 할당하여 동시에 작업하게 만들 수 있습니다. 이는 사실상 프로젝트에서 작업하는 가상의 소프트웨어 엔지니어 팀을 두는 것과 같습니다.

과제: 파일 충돌

병렬 인스턴스의 주요 문제는 동시에 같은 파일을 수정하려고 할 수 있다는 점입니다. 각 인스턴스가 다른 인스턴스가 무엇을 하고 있는지 알지 못하기 때문에 충돌하거나 유효하지 않은 코드가 생길 수 있습니다.

한 프로젝트에서 작업 중인 세 개의 Claude Code 인스턴스: "로깅 추가", ".pptx 파일 지원", "실패한 테스트 조사".

해결책은 각 Claude 인스턴스에 별도의 작업 공간을 부여하는 것입니다. 각 인스턴스는 프로젝트의 자체 복사본으로 작업하며, 독립적으로 변경을 수행한 다음 그 변경 사항을 메인 프로젝트에 다시 병합합니다.

각각 자체 프로젝트 복사본을 가진 네 개의 Claude Code 인스턴스, "리소스 정의" 및 "로깅 추가" 등의 작업을 수행.

Git Worktree

Git worktree는 이 워크플로우에 완벽하게 어울립니다. 프로젝트가 이미 Git으로 관리되고 있다면 바로 worktree를 사용할 수 있습니다. Worktree는 Git의 브랜치 기능을 확장한 것으로, 머신의 별도 디렉터리에 프로젝트의 완전한 복사본을 만들 수 있게 해줍니다.

폴더 1의 feature_a 브랜치와 폴더 2의 feature_b 브랜치, 각각 동일한 main.py, tools/document.py, tools/math.py를 포함.

각 worktree는 별도의 브랜치에 해당합니다. 기능 A를 위한 폴더 하나와 기능 B를 위한 폴더를 따로 가질 수 있으며, 각 폴더에는 코드베이스의 완전한 복사본이 포함됩니다. 그런 다음 각 worktree에서 별도의 Claude Code 인스턴스를 실행하여 완전히 격리된 상태로 작업합니다.

feature_a와 feature_b worktree 브랜치 다이어그램, 각각 하나의 커밋을 가지고 main 브랜치로 다시 병합됨.

각 Claude 인스턴스가 기능 작업을 마치면, 작업을 커밋하고 일반적인 Git 브랜치를 병합하는 것처럼 메인 브랜치로 다시 병합합니다.

.trees 폴더에 feature_a라는 이름의 worktree를 생성하고, 이미 존재하면 중단하고, .venv를 심볼릭 링크하고, VS Code를 실행하는 프롬프트.

Worktree 생성 자동화하기

관리하기 복잡해 보일 수 있지만, 전체 워크플로우를 Claude Code 자체에 위임할 수 있습니다. Claude에게 다음을 요청하는 프롬프트를 작성할 수 있습니다:

  1. 특정 폴더에 새 git worktree 생성하기
  2. Git이 추적하지 않는 의존성을 심볼릭 링크하기
  3. 해당 디렉터리에서 새 VS Code 인스턴스 실행하기

.trees에 feature_a라는 이름의 worktree를 생성하는 프롬프트: 이미 존재하면 중단하고, .venv를 심볼릭 링크하고, "code"로 VS Code를 실행.

커스텀 명령어

매번 긴 프롬프트를 복사하여 붙여넣는 대신, Claude Code에서 커스텀 슬래시 명령어를 만들 수 있습니다. .claude/commands에 .md 파일을 추가하여 커스텀 명령어를 만드세요.

프로젝트 파일의 worktree 복사본에서 Claude Code를 실행 중인 feature_a라는 이름의 두 번째 VS Code 창.

커스텀 명령어는 $ARGUMENTS를 참조할 수 있으며, 이는 명령어에 전달하는 인수로 대체됩니다. 예를 들어:

  • /project:create_worktree feature_a는 "feature_a"라는 이름의 worktree를 생성합니다
  • /project:create_worktree develop는 "develop"이라는 이름의 worktree를 생성합니다

실제로 작동하는 병렬 개발

실제로 전체 워크플로우가 어떻게 보이는지 살펴보겠습니다. 서로 다른 기능을 위해 여러 개의 worktree를 만들 수 있습니다:

동일한 프로젝트 파일을 가진 네 개의 VS Code 창, "문서 테스트", "로깅 추가", "노트 도구 추가", "수학 도구 추가"라는 레이블.

각 Claude 인스턴스는 할당된 작업을 수행합니다:

  • 문서 테스트 업데이트
  • 로깅 추가
  • 노트 작성 도구 추가
  • 뺄셈 도구 추가

.trees/$ARGUMENTS에서 $ARGUMENTS worktree를 병합하는 프롬프트, "git status" 같은 명령어를 사용하여 병합 충돌을 나열.

변경 사항 병합하기

기능이 완성되면 병합 과정도 자동화할 수 있습니다. Claude에게 다음을 지시하는 또 다른 커스텀 명령어를 만드세요:

  1. worktree 디렉터리로 이동하기
  2. 최신 커밋 확인하기
  3. 루트 디렉터리로 다시 이동하기
  4. worktree 브랜치 병합하기
  5. 병합 충돌을 자동으로 처리하기

.claude/commands에 create_worktree.md와 merge_worktree.md가 있고 터미널에서 Claude Code가 실행 중인 VS Code.

Claude는 각 브랜치에서 이루어진 변경 사항에 대한 이해를 바탕으로 병합 충돌을 자동으로 해결할 수도 있습니다.

결과

이 접근 방식은 관리할 수 있는 만큼 많은 병렬 인스턴스로 확장됩니다. 기능을 순차적으로 작업하는 대신, 여러 Claude 인스턴스가 프로젝트의 서로 다른 부분을 동시에 개발하도록 할 수 있습니다. 이는 각자 독립된 환경에서 작업한 후 그 결과물을 함께 모으는, 자신만의 개발자 팀을 두는 것과 같습니다.

생산성 향상은 상당합니다 - 실행하는 병렬 인스턴스의 수만큼 개발 역량이 곱해지는 것과 같습니다.