병렬왜 나눠서 돌리나
여러 Claude를 동시에, 충돌 없이
세션 하나로는 한 번에 한 갈래다. 기능 개발과 버그 수정을 동시에 돌리면 더 빠르다. 문제는 두 작업이 같은 파일을 건드리면 충돌한다는 것 — git worktree가 이를 막아 준다.
한 문장으로worktree는 브랜치마다 독립된 폴더를 만들어 Claude를 따로 돌리는 것. 서로의 파일을 건드리지 않으니 병렬 작업이 안전하다.
세 가지 방식
Subagent
서브에이전트
한 세션 안에서 탐색을 위임 → 결과만 받아 메인 문맥 절약
·
Worktree
병렬 격리
브랜치별 독립 폴더에서 동시 작업 (충돌 없음)
·
Agent View
백그라운드
여러 세션을 한 화면에서 모니터링
| 방식 | 쓰는 때 | 명령 |
|---|---|---|
| 서브에이전트 | 큰 코드베이스 조사로 문맥이 차는 걸 막을 때 | 프롬프트로 위임 |
| worktree | 두 작업을 동시에, 파일 충돌 없이 | claude --worktree <name> |
| 백그라운드(Agent View) | 여러 병렬 세션을 한눈에 관리 | claude agents |
worktree로 병렬 작업 (따라하기)
1
터미널 1 — 기능 개발
한 창에서 기능 브랜치용 세션을 연다.
2
터미널 2 — 버그 수정
다른 창에서 이름만 바꿔 또 하나 연다. 두 세션은 서로 격리됨.
3
(선택) 모니터링
claude agents 로 백그라운드 세션들을 한 화면에서 본다.
4
완료 → 정리
세션 종료 시 worktree 자동 정리 (또는 git worktree remove).
claude --worktree feature-auth
claude --worktree bugfix-login
한 세션 안에서 탐색만 위임하고 싶으면 서브에이전트를 쓴다 — 결과 요약만 돌아와 메인 대화가 깨끗하다.
서브에이전트를 써서 인증 시스템이 토큰 갱신을 어떻게 처리하는지 조사해줘
초보자 주의worktree는 git 저장소 + 커밋 최소 1개가 있어야 동작한다. .claude/worktrees/ 를 .gitignore에 추가해 임시 파일이 커밋되지 않게 한다. .worktreeinclude 파일로 .env 같은 설정을 자동 복사할 수 있다.
Windowsgit이 설치돼 있어야 한다(네이티브 또는 WSL). 나머지 명령은 PowerShell에서 동일하게 작동.
출처: code.claude.com/docs/en/{sub-agents, agent-view, worktrees}
출처: code.claude.com/docs/en/{sub-agents, agent-view, worktrees}
클로드코드 시작하기공식 문서 · 06 에이전트 & 병렬