수십 개 파일의 타입 오류를 한 번에 고쳐야 합니다. 하나의 에이전트가 순차적으로 처리하면 느리고, 컨텍스트도 금방 찹니다. Subagents로 파일별로 나눠 병렬 처리하면 훨씬 빠릅니다.
메인 에이전트가 하위 에이전트(Subagent)를 생성해 작업 일부를 위임하는 기능입니다. 각 Subagent는 독립적인 컨텍스트를 가지고 병렬로 실행됩니다.
병렬 실행(Parallel Execution): 여러 작업을 동시에 수행하는 방식. 순차 처리보다 전체 소요 시간이 크게 줄어듭니다.
메인 에이전트
├── Subagent 1: user.service.ts 타입 오류 수정
├── Subagent 2: product.service.ts 타입 오류 수정
├── Subagent 3: order.service.ts 타입 오류 수정
└── Subagent 4: payment.service.ts 타입 오류 수정
메인 에이전트가 작업을 분석하고 Subagent에 분배합니다.
메인: 전체 범위 파악 → 작업 분할 → 각 Subagent에 위임 → 결과 취합
각 Subagent는 자신에게 맡겨진 작업에만 집중합니다. 다른 Subagent의 작업을 알 필요가 없습니다.
Subagent는 독립된 컨텍스트를 가집니다.
메인 에이전트 컨텍스트:
- 전체 계획
- 작업 분배 현황
Subagent 1 컨텍스트:
- user.service.ts 내용
- 타입 오류 수정 지시
(메인의 다른 정보는 없음)
Subagent 2 컨텍스트:
- product.service.ts 내용
- 타입 오류 수정 지시
컨텍스트 격리로 각 Subagent가 한 가지 작업에 집중합니다.
Context Isolation: 각 에이전트가 독립된 컨텍스트를 가지는 것. 다른 에이전트의 작업이 섞이지 않아 각각의 작업 품질이 높아집니다.
여러 Subagent가 동시에 파일을 수정하면 충돌이 발생할 수 있습니다. Worktree 격리로 각 Subagent가 독립된 작업 디렉토리에서 작업합니다.
.git/worktrees/
subagent-1/ ← Subagent 1의 작업 공간
subagent-2/ ← Subagent 2의 작업 공간
subagent-3/ ← Subagent 3의 작업 공간
각 Subagent가 완료하면 메인이 결과를 검토하고 병합합니다.
Git Worktree: 하나의 Git 저장소에서 여러 작업 디렉토리를 동시에 사용하는 기능. 브랜치마다 독립된 파일 시스템을 제공합니다.
claude> /agents
현재 실행 중인 에이전트 목록과 각 에이전트의 상태를 확인합니다.
claude> /background "테스트 전체 실행하고 결과 알려줘"
현재 대화를 차단하지 않고 백그라운드에서 작업을 실행합니다. 작업이 완료되면 알림이 옵니다.
claude> /bg # /background 단축키
현재 세션을 복제해 독립적인 탐색을 시작합니다.
claude> /fork
현재 컨텍스트를 유지하면서 다른 방향을 시도해볼 때 씁니다. 원본 세션을 유지하면서 실험적인 변경을 해볼 수 있습니다.
claude> /tasks
현재 진행 중인 모든 작업과 Subagent의 상태를 확인합니다. 병렬 작업의 진행 상황을 한눈에 볼 수 있습니다.
특정 작업에 특화된 에이전트 유형을 지정할 수 있습니다.
Explore: 파일 탐색 전용
code-reviewer: 코드 리뷰 전용
general-purpose: 범용
작업 성격에 맞는 에이전트를 선택하면 더 적합한 결과가 나옵니다.
단순한 작업은 단일 에이전트로 충분합니다. Subagents는 단일 에이전트로 처리하기 어려운 규모의 작업에 씁니다.