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