에이전트를 병렬로 실행하기
Claude Code가 여러 작업을 동시에 처리하는 방법들을 비교합니다: 서브에이전트, 에이전트 뷰, 에이전트 팀, 격리된 worktree 세션.
서브에이전트, 에이전트 뷰, 에이전트 팀, worktrees는 각각 다른 방식으로 작업을 병렬화합니다. 올바른 선택은 각 대화에 직접 참여하고 싶은지, 작업을 넘기고 나중에 확인하고 싶은지, 아니면 Claude가 작업자 그룹을 조율하도록 하고 싶은지에 따라 달라집니다.
| 접근 방식 | 제공되는 기능 | 사용 시기 |
|---|---|---|
| 서브에이전트 | 한 세션 내에서 자신의 컨텍스트에서 부작업을 수행하고 요약을 반환하는 위임된 작업자 | 부작업이 검색 결과, 로그 또는 다시 참조하지 않을 파일 내용으로 주 대화를 넘칠 때 |
| 에이전트 뷰 | claude agents로 열 수 있는 백그라운드에서 실행 중인 세션을 디스패치하고 모니터링하는 하나의 화면. 연구 미리보기 |
여러 개의 독립적인 작업이 있고 작업을 넘기고, 상태를 한눈에 확인하고, 필요할 때만 개입하고 싶을 때 |
| 에이전트 팀 | 공유 작업 목록과 에이전트 간 메시징을 통해 조율되는 여러 세션으로, 리더가 관리합니다. 실험적이며 기본적으로 비활성화됨 | Claude가 프로젝트를 여러 부분으로 나누고, 할당하고, 작업자들을 동기화 상태로 유지하기를 원할 때 |
| Worktrees | 별도의 git 체크아웃으로 병렬 세션이 서로의 파일을 건드리지 않음 | 여러 세션을 직접 실행하거나, 서브에이전트가 겹치는 파일을 편집할 때 |
/batch |
하나의 큰 변경을 5~30개의 worktree 격리 서브에이전트로 계획된 분할로, 각각 pull request를 열기 | 저장소 전체 마이그레이션 또는 하나의 지시로 설명할 수 있는 기계적 리팩터링 |
모든 접근 방식에서 작업자는 Claude 세션입니다. 다른 도구를 포함하려면 MCP 서버로 Claude에 노출하세요.
이러한 접근 방식들을 결합할 수 있습니다. 에이전트 뷰는 파일을 편집해야 할 때 자동으로 각 디스패치된 세션을 자신의 worktree로 이동하고, 작업 중인 세션은 각각 자신의 worktree를 얻는 서브에이전트를 생성할 수 있습니다.
접근 방식 선택하기
올바른 접근 방식은 누가 작업을 조율하는지, 작업자가 통신해야 하는지, 동일한 파일을 편집하는지에 따라 달라집니다:
- 누가 작업을 조율합니까? Claude가 한 대화 내에서 위임하고 결과를 수집하기를 원하면 서브에이전트를 사용하세요. 독립적인 작업을 넘기고 다시 확인하려면 에이전트 뷰를 사용하세요. Claude가 작업자 그룹을 계획, 할당, 감독하기를 원하면 실험적이며 기본적으로 비활성화된 에이전트 팀을 사용하세요.
- 작업자가 서로 대화해야 합니까? 서브에이전트는 결과를 생성한 대화에 보고하고, 에이전트 뷰 세션은 사용자에게만 보고합니다. 에이전트 팀의 팀원은 작업 목록을 공유하고 서로 직접 메시지를 보냅니다.
- 작업이 동일한 파일을 건드립니까? worktrees로 작업을 격리하세요. 서브에이전트와 직접 실행하는 세션은 각각 별도의 worktree를 사용할 수 있습니다. 에이전트 팀은 팀원을 worktree에 격리하지 않으므로 작업을 분할하여 각 팀원이 다른 파일 집합을 소유하도록 하세요.
실행 중인 작업 확인하기
실행 중인 작업을 확인하는 명령은 사용한 접근 방식에 따라 다릅니다:
- 백그라운드 세션의 경우,
claude agents는 에이전트 뷰를 열어줍니다: 모든 세션, 상태, 입력이 필요한 세션을 보여주는 하나의 화면입니다. - 현재 세션의 서브에이전트의 경우,
/agents는 라이브 서브에이전트를 나열하는 Running 탭과 사용자 정의 서브에이전트를 생성하고 편집할 수 있는 Library 탭이 있는 패널을 엽니다. 유사한 이름에도 불구하고 이는claude agents와 별개입니다. - 현재 세션의 백그라운드에서 실행 중인 모든 것의 경우,
/tasks는 각 항목을 나열하고 확인, 연결 또는 중지할 수 있게 해줍니다.
모든 세션의 데스크톱 뷰는 데스크톱 앱에서 세션과 병렬로 작업하기를 참조하세요.
더 알아보기
아래의 각 가이드는 하나의 접근 방식에 대한 설정 및 구성을 다룹니다:
- 사용자 정의 서브에이전트 생성: 재사용 가능한 전문가를 정의하고 사용할 수 있는 도구를 제어합니다.
- 에이전트 뷰로 에이전트 관리: 세션을 디스패치하고, 상태를 감시하고, 필요할 때 연결합니다.
- 에이전트 팀 조율: 리더와 팀원을 설정하고, 작업을 할당하고, 작업을 검토합니다.
- worktrees로 병렬 세션 실행: 격리된 체크아웃에서 Claude를 시작하고, 복사되는 내용을 제어하고, 나중에 정리합니다.