Claude Code session 하나는 인상적입니다. 하지만 동시에 세 가지 변경이 필요해지는 순간까지가 그렇습니다. 보통은 같은 저장소에서 terminal 탭을 세 개 여는 쪽으로 손이 갑니다. 몇 분은 잘 돌아갑니다. 그러다 두 에이전트가 같은 파일을 편집하고, 하나가 다른 하나의 발밑에서 branch를 바꾸고, 테스트 실행이 더 이상 존재하지 않는 checkout을 읽기 시작합니다.
병렬 에이전트는 프롬프트 문제가 아니라 파일 시스템 문제입니다. Claude Code는 평범한 파일을 통해 작업하므로, 두 session에는 branch도 index도 공유하지 않는 두 개의 작업 directory가 필요합니다.
terminal 탭은 왜 병렬 작업이 아닌가
git 저장소는 작업 트리마다 checkout된 branch가 하나뿐입니다. 그 트리에서 Claude Code session 두 개를 열면 모든 것을 공유합니다. 같은 파일, 같은 index, 같은 node_modules, 같은 dev server 포트까지요. terminal이 독립적이라 session도 독립적으로 보이지만, 그 아래의 코드는 그렇지 않습니다.
- 한 에이전트가
git switch나git rebase를 실행하는 동안 다른 에이전트는 이전 파일을 계속 편집합니다. - 두 에이전트가 같은 파일에 쓰면 마지막 저장이 이기고, 첫 번째 변경은 작업 트리에서 사라집니다.
- test watcher, dev server, migration이 그 순간 checkout되어 있던 branch를 기준으로 실행됩니다.
- diff에 모든 session의 작업이 뒤섞여 있어 결과를 리뷰하는 일이 추측에 가까워집니다.
탭은 읽기 전용 탐색, 로그 추적, 간단한 질문에는 여전히 유용합니다. 에이전트가 파일을 편집하고 테스트를 실행해야 하는 순간 쓸모가 없어집니다.
병렬 session을 실행하는 세 가지 실용적 방법
고려할 만한 세 가지 옵션이 있습니다. 얼마나 많은 격리를 제공하는지, 얼마나 많은 잡무를 남기는지가 다릅니다.
- 하나의 checkout에서 terminal 탭 사용 — 시작은 빠르지만 동시 편집에는 안전하지 않습니다.
- 수동 git worktree와 worktree당 Claude Code 인스턴스 하나 — 진짜 격리를 얻지만 경로, 의존성, 정리를 직접 관리해야 합니다.
- Nethür 같은 워크스페이스 — worktree를 만들고 추적하며, 각 worktree에서 에이전트를 실행하고 diff와 session을 한곳에 모읍니다.
옵션 1: git worktree를 직접 만들기
git worktree는 같은 저장소를 별도 directory에서, 자체 branch로 checkout한 두 번째 복사본입니다. Git이 object database를 공유하므로 복사 비용은 저렴하지만 파일과 index는 독립적입니다.
git fetch origin
git worktree add ../shop-fix-login -b fix/login origin/main
git worktree add ../shop-fix-billing -b fix/billing origin/main
cd ../shop-fix-login && claude
# second terminal
cd ../shop-fix-billing && claude이제 각 Claude Code 인스턴스는 서로 다른 directory와 branch를 봅니다. 하나에게는 login race를 고치라고 하고 다른 하나에게는 billing을 다시 쓰라고 해도, 어느 쪽도 상대의 파일을 덮어쓸 수 없습니다.
문제는 새 checkout에 없는 모든 것입니다. 의존성이 없고 .env 파일도 없으며, 두 session이 같은 포트를 잡으려 할 수 있습니다. 모든 worktree에 다시 설치하거나, 무겁고 gitignore된 directory를 공유해야 합니다. Nethür는 같은 문제와 자체 해법을 worktree 가이드에서 설명합니다. 공유 경로, nethur.yaml 항목, .worktreeinclude, setup hook입니다.
옵션 2: Claude Code 자체의 병렬 기능 사용
Claude Code 자체도 여러 작업 흐름을 실행하는 방법을 계속 추가하고 있습니다. desktop app은 격리된 git worktree에서 병렬 session을 실행할 수 있고, subagent와 agent team은 하나의 session이 작업 일부를 위임하게 합니다. Anthropic 제품 안에서만, 혼자 작업한다면 그것으로 충분할 수 있습니다.
하지만 그 기능들은 여전히 Claude에 한정됩니다. Claude Code, Codex, 다른 CLI 에이전트가 나란히 실행되는 하나의 워크스페이스를 주지 않고, 팀원이 서로의 session을 보고 이어받을 공유 공간도 주지 않습니다. 병렬 작업이 에이전트, 머신, 사람을 넘나든다면 에이전트 위에 한 겹이 더 필요합니다.
옵션 3: worktree를 대신 만들어 주는 워크스페이스
Nethür는 작업에 탭이 아니라 워크스페이스가 주어진다는 생각을 중심으로 만들어졌습니다. 각 worktree는 자체 branch, 파일, terminal, editor 탭, browser 탭을 가진 실제 git worktree입니다. 만드는 데는 짧은 대화상자 하나면 되고, git 작업은 백그라운드에서 일어납니다.
- Nethür를 설치하고 저장소를 추가합니다. 팀이라면 작업을 호스팅할 머신을 고릅니다. 노트북, 팀원의 머신, VPS, SSH 대상 모두 가능합니다.
- 병렬 작업마다 worktree를 만듭니다. 작업 이름을 붙이고, 시작 ref(보통
origin/main)를 고르고, GitHub, GitLab, Linear, Jira 항목이 있으면 연결합니다. - 각 worktree 안에서 에이전트 선택기를 열고 Claude Code를 실행합니다. Nethür가 해당 worktree를 작업 directory로 시작하므로 두 session은 충돌할 수 없습니다.
- 에이전트가 실행되는 동안 pane을 분할하거나 worktree 사이를 전환합니다. 사이드바에서 어떤 session이 작업 중인지, 대기 중인지, 끝났는지 보여 줍니다.
- 각 diff를 해당 시작 ref와 비교해 리뷰합니다. 승자를 남기고 commit, push한 뒤 그 worktree에서 pull request를 열고, 진 worktree와 branch를 삭제합니다.
중요한 차이는 worktree를 만드는 버튼이 아닙니다. worktree, 에이전트 session, diff, 정리가 같은 작업에 계속 붙어 있다는 점입니다. 병렬 에이전트 레시피는 스크린샷과 세 에이전트 예시로 같은 흐름을 안내합니다.
어떤 방식이 내 작업에 맞을까?
| 방식 | 파일 격리 | 설정 | 리뷰 | 팀 |
|---|---|---|---|---|
| 하나의 checkout에서 탭 사용 | 없음 — 파일과 branch 공유 | 즉시 | 뒤섞인 diff, 수동으로 풀어야 함 | 공유 화면 없음 |
| 수동 git worktree | 완전 — worktree당 branch 하나 | git 명령, 의존성, env 파일 | directory마다 diff 하나, 수작업 | 채팅으로 경로를 주고받음 |
| Claude Code desktop | Claude session에 한해 완전 | 설치 후 로그인 | Claude용 내장 리뷰 | 단일 사용자 화면 |
| Nethür | 완전 — git worktree 또는 폴더 워크스페이스 | 저장소 추가, worktree 생성 | worktree별 diff, 주석, PR 흐름 | 공유 프로젝트, 채팅, takeover |
병렬성을 잘 활용하는 네 가지 패턴
- 같은 작업, 세 에이전트. 동일한 프롬프트를 세 worktree에서 Claude Code, Codex, 다른 CLI에 각각 줍니다. 순차적으로 재시도하는 대신 diff를 비교하세요. 의견이 갈리는 지점이 보통 어려운 부분을 알려 줍니다.
- 표면별로 나누기. 한 에이전트는 API 변경, 하나는 UI, 하나는 테스트를 맡습니다. 같은 이슈를 각 worktree에 연결해 context가 계속 보이게 합니다.
- 구현과 리뷰. 한 에이전트가 변경을 만들고, 별도 worktree의 두 번째 에이전트가 diff를 읽고 regression을 찾습니다. 최종 판단은 당신이 합니다.
- 탐색과 출시. 오래 걸리는 리서치 session은 한 worktree에, 깨끗한 구현 session은 다른 worktree에 둡니다. 리서치 에이전트가 곧 merge할 branch를 더럽히지 않습니다.
미리 대비할 함정
- 의존성과 로컬 secret. 새 worktree는 깨끗한 checkout입니다.
node_modules와 캐시를 공유하고,.worktreeinclude로.env파일을 복사하거나 생성 후 setup hook을 실행하세요. - 포트와 데이터베이스.
3000에서 dev server 두 개가 싸웁니다. worktree마다 포트를 다르게 주고, 가능하면 데이터베이스나 schema도 따로 두세요. - 생성 파일과 migration. 도구가 그렇게 설계되지 않았다면 같은 데이터베이스에 migration을 두 번 실행하지 마세요.
- 토큰 예산. 병렬성은 사용량을 배가합니다. 두세 session으로 시작하고 사용량 미터를 보면서 그냥 기다리는 session은 멈추세요.
- 정리 부채. 모든 worktree는 branch입니다. 승자를 고르는 즉시 진 쪽을 삭제하지 않으면 저장소가 버려진 실험으로 가득 찹니다.
병렬 작업은 사람이 붙으면 더 어려워진다
두 개발자가 같은 프로젝트에서 에이전트를 돌리는 순간, 파일 시스템 문제는 조정 문제로 바뀝니다. 누구 worktree가 어느 branch에 있는지, 누가 리뷰를 기다리는지, 작성자가 오프라인이 될 때 다른 사람이 session을 이어받을 수 있는지가 문제가 됩니다.
Nethür는 공유 프로젝트와 팀 서버로 이를 처리합니다. 모두가 같은 워크스페이스에 연결해 활성 session을 보고, 작업 옆에서 서로 @mention하며, transcript를 복사하지 않고도 session을 takeover할 수 있습니다. 각자는 여전히 자신의 Claude 구독으로 로그인합니다. 돌려야 할 공유 key가 없습니다. 팀 가이드에서 설정을 다룹니다.
worktree 두 개로 시작하기
평소 순차적으로 두 번 돌릴 만한 작업 하나를 고르세요. 같은 ref에서 worktree 두 개를 만들고 두 에이전트에 같은 프롬프트를 주고 결과를 비교합니다. 이 실험 하나가 어떤 벤치마크보다 병렬 작업에 대해 더 많이 알려 줍니다. 격리의 이점, 의존성 마찰, 리뷰 비용을 자기 저장소에서 직접 보게 됩니다.
잘 되면 이긴 branch를 남기고 다른 worktree를 삭제하세요. 그다음에는 깔끔하게 둘로 나뉘는 작업으로 다시 해 보세요. 병렬 에이전트는 스위치가 아니라 습관입니다.



