에이전트 병렬 실행

에이전트 병렬 실행 (Run agents in parallel)

Subagents, agent view, agent teams, 다이내믹 워크플로는 각각 서로 다른 방식으로 작업을 병렬화합니다. 어떤 것을 쓸지는 각 대화에 직접 머물고 싶은지, 작업을 넘겨주고 나중에 확인할지, 아니면 Claude가 워커 그룹을 조정하게 할지에 달려 있습니다.

출처: 공식문서

본문

접근 주는 것 언제 쓰는가
Subagents 한 세션 안에서 자신의 컨텍스트로 보조 작업을 하고 요약을 반환하는 위임된 워커 보조 작업이 다시 참조하지 않을 검색 결과·로그·파일 내용으로 메인 대화를 범람시킬 때
Agent view claude agents로 여는, 백그라운드 실행 세션을 디스패치·모니터링하는 한 화면. 리서치 프리뷰 독립 작업이 여러 개 있고 넘겨주고 한눈에 상태를 확인하며 하나가 필요할 때만 개입하려 할 때
Agent teams 공유 작업 목록과 에이전트 간 메시징을 가진, 리드가 관리하는 여러 조정된 세션. 실험적이며 기본적으로 비활성 Claude가 프로젝트를 조각으로 나누고 배정하고 워커들을 동기화하기를 원할 때
Dynamic workflows 많은 서브에이전트를 실행하고 결과를 상호 교차 검증하는 스크립트. 한 번에 한 턴으로 조정하기엔 너무 크거나 여러 번의 패스가 필요한 작업용 작업이 소수의 서브에이전트를 넘어서거나, 조사 결과를 서로 검증받고 싶을 때: 코드베이스 전체 감사, 500개 파일 마이그레이션, 교차 검증된 리서치, 여러 각도에서 초안을 잡은 계획

모든 접근에서 워커는 Claude 세션입니다. 다른 도구를 개입시키려면 MCP 서버로 Claude에 노출하세요.

에이전트 실행 방식은 아니지만 이 작업을 지원하는 도구가 세 개 더 있습니다:

  • Worktrees는 각 세션에 별도 git 체크아웃을 줘 병렬 세션이 같은 파일을 편집하지 않게 합니다. 직접 실행하는 세션에 쓰세요. agent view에서 디스패치한 세션은 파일 편집 전에 자신의 worktree로 이동하며, 스폰한 서브에이전트도 각각 하나를 받을 수 있습니다.
  • Cross-session messaging은 Claude가 이 머신·다른 머신·Claude Code on the web의 다른 Claude Code 세션을 나열하고 메시지를 보내게 해, 직접 실행하는 세션들이 서로 조사 결과와 상태를 주고받게 합니다.
  • /batch는 스킬로, Claude가 하나의 큰 변경을 각각 풀 리퀘스트를 여는 5~30개의 worktree 격리 서브에이전트로 쪼개게 합니다. 서브에이전트와 worktree를 패키지한 사용법이지 별도의 조정 스타일은 아닙니다.

당신이 각 단계를 이끌지 않고도 Claude를 실행하는 다른 기능들도 있지만, 그것들은 작업을 에이전트에 걸쳐 나누는 것과는 다른 문제를 풉니다:

  • 백그라운드 bash 명령은 대화를 차단하지 않고 셸 명령 하나를 실행합니다. 에이전트를 스폰하지 않습니다.
  • 포크된 서브에이전트는 새로 시작하는 대신 전체 대화 컨텍스트를 상속하는 서브에이전트입니다. 서브에이전트를 스폰하는 한 방식이지 별도 표면은 아닙니다. /subtask로 시작합니다. fork 모드가 켜져 있으면 Claude도 직접 하나를 스폰합니다. 전체 세션을 나란히 실행되는 새 백그라운드 세션으로 복사하려면 /fork를 쓰세요. agent view가 꺼져 있으면 포크 서브에이전트 명령은 /fork이고 /subtask는 없습니다.
  • routine은 병렬이 아니라 스케줄로 클라우드에서 세션을 실행합니다.

참고: 여러 세션이나 서브에이전트를 한 번에 실행하면 토큰 사용량이 배가됩니다. 사용량·레이트 리밋 세부 사항은 Costs를 참고하세요.

접근 방식 고르기

올바른 접근은 누가 작업을 조정하는지, 워커들이 통신해야 하는지, 같은 파일을 편집하는지에 달려 있습니다:

  • 누가 작업을 조정하나요?
  • 워커들이 서로 말해야 하나요? Claude는 직접 실행하는 세션들 사이, agent view에서 디스패치한 세션을 포함해 cross-session messaging으로 조사 결과를 전달할 수 있습니다. 서브에이전트는 결과를 자신을 스폰한 대화로 보고하고, agent view 세션은 당신에게만 보고합니다. 에이전트 팀의 동료들은 직접 서로 메시지를 보내고, Task 도구를 가질 때 작업 목록을 공유합니다.
  • 작업들이 같은 파일을 건드리나요? worktrees로 작업을 격리하세요. 서브에이전트와 직접 실행하는 세션은 각각 별도 worktree를 쓸 수 있습니다. 에이전트 팀은 동료를 worktree에서 격리하지 않으므로, 각 동료가 다른 파일 세트를 소유하도록 작업을 분할하세요.

실행 중인 작업 확인

실행 중인 작업을 확인하는 명령은 어느 접근을 썼는지에 따라 다릅니다:

  • 백그라운드 세션의 경우 claude agents가 agent view를 엽니다: 모든 세션, 그 상태, 어느 것이 입력을 필요로 하는지 보여주는 한 화면.
  • 현재 세션의 서브에이전트는 이름 있는 백그라운드 서브에이전트가 상태와 함께 @-멘션 자동완성에 나타납니다. v2.1.198부터 /agents는 패널을 열지 않고 서브에이전트 파일 위치를 가리키는 공지를 출력합니다. 커스텀 서브에이전트를 만들고 편집하려면 Claude에게 묻거나 파일을 직접 편집하세요. 비슷한 이름에도 /agents는 claude agents와 별개입니다.
  • 현재 세션의 백그라운드에서 실행되는 무엇이든 /tasks가 각 항목을 나열하고 확인·첨부·중지하게 해줍니다. 목록에는 완료된 서브에이전트도 포함됩니다.
  • 다이내믹 워크플로의 경우 /workflows가 실행 중·완료된 실행, 각각의 단계, 몇 개의 에이전트가 끝났는지를 나열합니다.

모든 세션의 데스크톱 뷰는 desktop app의 병렬 세션을 참고하세요.

더 알아보기

아래 각 가이드는 한 접근의 설정과 구성을 다룹니다: