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