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