AI 에이전트를 위한 Git 작업 트리: Claude Code와 Codex를 병렬로 실행

git 작업 트리는 동일한 저장소에 연결된 추가 작업 폴더입니다. 여기에는 자체 체크아웃 브랜치, 자체 스테이징 영역 및 자체 파일이 있으며 모든 작업 트리는 동일한 커밋, 브랜치 및 원격을 공유합니다. 이는 git worktree가 Claude Code 또는 Codex와 같은 AI 코딩 에이전트를 병렬로 실행하는 가장 간단한 방법입니다. 각 에이전트에 고유한 작업 트리를 제공하면 서로의 파일을 건드리지 않고 두 번째 복제 없이 동시에 편집, 빌드, 테스트 및 커밋할 수 있습니다.

한 폴더에 있는 두 에이전트는 하나의 작업 트리를 공유합니다. 하나는 파일에 대해 테스트를 실행하고 다른 하나는 다시 쓰기의 중간에 있으며 git checkout는 둘 중 하나를 다른 하나 아래로 이동합니다. 별도의 클론은 이를 방지하지만 자체 가져오기가 필요합니다. 작업 트리는 하나의 저장소를 기록하는 별도의 폴더를 제공합니다.

git 작업 트리가 무엇인지, 작업 트리가 공유하는 것

모든 저장소는 하나의 작업 트리인 기본 작업 트리로 시작됩니다. 이 폴더는 git clone 또는 git init가 만든 폴더입니다. git worktree add는 동일한 .git 데이터에 연결된 추가 폴더인 링크된 작업 트리를 생성합니다. 공식 git 작업 트리 문서에 따르면, 연결된 작업 트리는 HEAD 및 인덱스와 같은 작업 트리별 파일을 제외한 모든 것을 저장소와 공유합니다. 실제로:

에이전트에게는 한 가지 규칙이 중요합니다. 기본적으로 git worktree add는 다른 작업 트리에서 이미 체크아웃된 분기의 체크아웃을 거부합니다. 따라서 모든 에이전트에는 자체 분기가 필요하며 이는 검토 시 정확히 원하는 것입니다.

git worktree add를 사용하여 작업 트리를 만드는 방법

저장소 내부에서 명령을 실행하고 저장소 내부가 아닌 저장소 옆에 새 작업 트리를 배치하면 편집자, 검색 도구 및 에이전트가 하나의 체크아웃을 다른 체크아웃 내부에서 색인화하지 않습니다. 그러면 각각 main에서 시작하는 새 분기에 두 개의 작업 트리가 생성됩니다.

cd ~/code/myapp
git worktree add -b agent/auth-refactor ../myapp-auth main
git worktree add -b agent/flaky-tests ../myapp-tests main
git worktree list

-b는 브랜치를 생성하고 경로는 새 폴더이며 마지막 인수는 시작할 커밋입니다. git worktree list는 폴더, 커밋 및 분기와 함께 모든 작업 트리를 인쇄합니다. 이미 존재하는 분기를 사용하려면 -b: git worktree add ../myapp-review feature/login를 생략하세요.

작업 트리당 하나의 AI 에이전트: 병렬 워크플로

패턴은 간단합니다. 작업 1개, 분기 1개, 작업 트리 1개, 에이전트 세션 1개입니다. 귀하는 검토자로 기본 작업 트리에 머물며 상담원은 폴더를 공유하지 않습니다. 가장 중요한 것은 작업을 어떻게 분할하느냐입니다. 좋은 병렬 작업은 다음과 같습니다.

• 코드의 다른 부분(예: auth/의 리팩터링 및 billing/의 새 테스트)에서 해당 분기가 동일한 줄에 거의 닿지 않습니다.
• 분명히 완료되었거나 완료되지 않음: 통과해야 하는 실패한 테스트, 추가할 엔드포인트, 업그레이드할 종속성.
• 한 번에 검토할 수 있을 만큼 작습니다. 에이전트 차이가 크다는 것은 폴더에 관계없이 검토 문제입니다.

cd ../myapp-auth && claude
cd ../myapp-tests && codex

각 라인을 자체 터미널에서 실행하십시오. 각 에이전트의 테스트 및 빌드는 자체 파일에 대해 실행됩니다.

Claude Code와 함께 Git 작업 트리 사용

Claude Code에 자체 작업 트리를 직접 제공하려면 일반 Git으로 작업 트리를 만들고 그 안에서 claude을 시작하세요. 그런 다음 에이전트는 해당 폴더만 읽고 편집하고 해당 분기에 커밋합니다.

git worktree add ../myapp-auth -b agent/auth
cd ../myapp-auth
claude

Claude Code의 --worktree 플래그

Claude Code는 당신을 위해 작업 트리를 생성할 수 있습니다. Claude Code의 작업 트리 문서에 따르면, claude --worktree feature-auth(또는 -w)는 worktree.baseRef 설정에 달리 명시되지 않는 한 저장소의 기본 분기에서 분기된 worktree-feature-auth이라는 새 분기의 .claude/worktrees/feature-auth/ 아래에 작업 트리를 만듭니다. .worktreeinclude 파일은 .env과 같은 무시된 파일을 각각의 새 작업 트리에 복사합니다. 종료 시 Claude Code는 명명되지 않은 세션에서 깨끗한 작업 트리와 해당 분기를 제거하고 변경 사항이나 새 커밋이 있는 세션을 제거하기 전에 묻습니다.

claude --worktree feature-auth

Codex CLI와 함께 Git 작업 트리 사용

Codex CLI는 시작하는 디렉터리에서 작동하므로 Codex 세션당 하나의 작업 트리가 각 세션의 편집, 테스트 및 커밋을 별도로 유지합니다.

git worktree add ../myapp-tests -b agent/tests
cd ../myapp-tests
codex

Codex 앱과 Codex CLI

OpenAI의 Codex 앱 작업 트리 문서는 Codex가 하나의 프로젝트에서 여러 채팅을 실행할 수 있도록 하는 작업 트리를 설명합니다. 기본적으로 선택한 분기에 따라 $CODEX_HOME/worktrees로 이동하고 분기가 아닌 분리된 HEAD 상태에서 시작됩니다. 채팅 헤더에서 Handoff는 작업 트리와 로컬 체크아웃 간에 채팅을 이동하고 여기서 분기 만들기는 작업 트리의 작업을 검토하고 병합할 수 있는 분기로 바꿉니다. Codex CLI를 사용하면 프로젝트 디렉터리에서 codex을 실행하므로 생성한 작업 트리 내에서 시작합니다.

어느 쪽이든 이는 git worktree list 및 이를 읽는 모든 Git GUI에 표시되는 일반 Git 작업 트리입니다.

git worktree GUI: 모든 에이전트의 폴더 및 분기 추적

3~4개의 에이전트가 실행 중일 때 어려운 부분은 어떤 분기가 어떤 폴더에 있는지, 어떤 에이전트가 여전히 파일을 변경하고 있는지 추적하는 것입니다. 이 블로그(개인 저장소 포함)를 게시하는 macOS, Windows 및 Linux용 Git 클라이언트인 GitTree는 Claude Code 또는 Codex가 생성한 작업을 포함하여 Git이 이미 알고 있는 작업 트리를 읽고 각 작업 트리에 인터페이스에 위치를 제공합니다.

• 왼쪽 패널의 WORKTREES 섹션. 모든 작업 트리는 기본 작업 트리부터 해당 분기(또는 분리된 경우 해당 폴더)로 이름이 지정되며 이 탭에 열려 있는 작업 트리에 확인 표시가 있습니다. 잠긴, 분리된 및 누락된 작업 트리에는 레이블이 지정됩니다.
• 분기 팁의 형제 작업 트리. 커밋 그래프는 분기 팁에 있는 서로의 작업 트리에 보유된 변경 사항 수를 표시하므로 어떤 에이전트가 아직 편집 중인지 빠르게 확인할 수 있습니다. 마커를 클릭하면 해당 작업 트리 탭이 열립니다.
• 현재 위치에서 작업 트리를 만듭니다. 명령 팔레트에서 작업 트리 만들기... 또는 이 커밋에서 작업 트리 만들기... 커밋에서 새 분기나 분리된 체크아웃을 선택한 다음 폴더를 선택할 수 있습니다. 이 분기에 대한 작업 트리 만들기… 분기에서 새 폴더의 해당 분기를 체크아웃합니다.
• 자체 터미널이 있는 작업 트리당 하나의 탭. 새 탭에서 작업 트리 열기는 다른 저장소처럼 작업 트리를 열고, 그래프 아래의 내장 터미널은 자체 셸을 사용하여 해당 작업 트리 폴더에서 시작하므로 바로 그곳에서 claude 또는 codex을(를) 시작할 수 있습니다.
• 잠금, 이동, 제거, 정리 및 복구. 선택적 이유를 사용하여 잠그고 폴더를 이동하거나 제거합니다. Git은 커밋되지 않은 변경 사항이 있는 작업 트리 제거를 거부하고 브랜치는 그대로 유지됩니다. 오래된 작업 트리 정리는 Git이 삭제할 내용을 미리 보고, 작업 트리 링크 복구는 직접 이동한 작업 트리에서 실행하여 다시 연결합니다.

각 작업은 이미 설치한 Git을 실행하므로 결과는 명령줄과 일치합니다.

GitTree 기능 페이지에는 앱이 수행하는 모든 기능이 나열되어 있으며, Git GUI와 명령줄 비교에서는 각 접근 방식이 더 빠른 경우를 다룹니다.

여러 AI 에이전트의 작업 병합

분기는 공유되므로 기본 작업 트리에서는 에이전트가 커밋하는 순간 모든 에이전트의 분기를 볼 수 있습니다. 각 항목을 팀원의 끌어오기 요청처럼 처리하세요. 신뢰할 수 있지만 검토되었습니다.

1. 차이점을 먼저 읽으십시오. 에이전트의 분기를 main 덩어리와 비교하고 관련 없는 편집, 삭제된 테스트 및 새로운 종속성을 찾으십시오.
2. 겹침을 확인하세요. GitTree는 병합 전에 충돌을 예측하고, main과(와) 충돌할 때 분기 이름 옆에 경고하며, 병합되지 않은 다른 분기가 동일한 파일에 닿을 때 힌트를 줍니다. 모두 컴퓨터에서 계산됩니다. 여러 에이전트 분기를 사용하면 어떤 병합 순서가 가장 덜 손상되는지 알 수 있습니다.
3. 기록을 정리합니다. 해당 에이전트의 작업 트리 내에서 GUI의 대화형 리베이스를 사용하여 Squash 체크포인트 커밋: Git은 다른 폴더에서 체크아웃된 브랜치를 체크아웃하지 않습니다.
4. 풀 요청을 병합하거나 엽니다. 기본 작업 트리에서 병합하거나 에이전트 분기를 GitTree의 main로 드래그하여 풀 요청을 병합, 리베이스하거나 시작합니다.
5. 뒤로 돌아가세요. 두 에이전트가 동일한 줄을 변경한 경우 [Git 병합 충돌 해결 방법](/ko/blog/resolve-git-merge-con conflicts)을 참조하세요. 병합이 잘못되면 병합, 재설정 또는 리베이스를 취소할 수 있습니다.
6. 정리합니다. 작업 트리를 제거한 다음 병합된 분기를 삭제합니다.

git switch main
git merge --no-ff agent/auth-refactor
git worktree remove ../myapp-auth
git branch -d agent/auth-refactor

AI 코딩 에이전트로 인한 Git 작업 트리의 함정

• 하나의 분기를 두 개의 작업 트리로 강제 실행합니다. --force는 하나의 분기를 놓고 두 폴더가 싸우는 대가로 Git의 거부를 해결합니다. 대신 기존 작업 트리를 엽니다. GitTree는 해당 분기가 체크아웃된 위치를 알려줍니다.
• 작업 트리가 모든 것을 격리한다고 가정합니다. 서비스가 아닌 파일을 격리합니다. 동일한 포트에서 개발 서버를 시작하거나 동일한 로컬 데이터베이스를 마이그레이션하는 에이전트는 여전히 충돌하므로 각 작업 트리에 자체 포트와 테스트 데이터베이스를 제공합니다.
• 폴더를 직접 삭제하거나 이동합니다. Git은 모든 작업 트리에 대한 기록을 유지합니다. 삭제된 폴더의 기록은 git worktree prune(또는 훨씬 나중에 Git의 자동 정리)가 제거될 때까지 남아 있습니다. git worktree repair, 이동한 폴더 내에서 실행하고 다시 연결합니다. 항상 마운트되지 않는 드라이브의 작업 트리를 잠그면 가지치기를 통해 드라이브가 그대로 유지됩니다.
• 검토되지 않은 작업을 강제 제거합니다. git worktree remove는 --force을 추가하지 않는 한 변경 사항이 있는 작업 트리를 거부하므로 먼저 차이점을 읽어보세요. Claude Code의 비대화형 -p 실행은 이후 세션에서 해제될 때까지 작업 트리를 잠긴 상태로 둡니다. 직접 제거하기 전에 잠금을 해제하세요.
• 에이전트를 실행하는 탭을 닫습니다. GitTree에서 내장 터미널은 저장소 탭에 속하며 탭을 닫으면 하나에서 실행 중인 에이전트를 포함하여 터미널 세션이 중지됩니다.
• 검토할 수 있는 것보다 더 많은 에이전트를 실행합니다. 검토는 실제 병목 현상입니다. 2~3개의 병렬 작업으로 시작하고 병합하는 것이 일상적으로 느껴지면 더 추가하세요.

다음 작업에 작업 트리를 사용해 보세요

Git의 작업 트리 명령만 있으면 시작할 수 있으며, GUI를 사용하면 여러 작업 트리를 더 쉽게 볼 수 있습니다. GitTree에는 모든 Git 기능, 개인 저장소가 포함된 macOS, Windows 및 Linux에 대한 무료 요금제가 있으며, AI 도우미인 Nour에는 GitTree Pro가 함께 제공됩니다. 로그인하면 모든 Git 기능이 무료 플랜으로 제공되며 Git 2.39 이상이 필요합니다. Ubuntu 22.04에서 먼저 Ubuntu에서 Git 업그레이드하세요. Linux 설치 가이드를 따르거나 GitTree 다운로드 페이지를 방문하세요.