Claude Code, 병렬 서브에이전트 오케스트레이션 정식 GA
Anthropic이 Claude Code에서 단일 작업을 여러 서브에이전트로 분기·병렬 실행하는 오케스트레이션 기능을 정식 출시했다. 대규모 리팩터링·테스트 생성·문서화 등 독립적으로 분리 가능한 태스크를 동시에 처리할 수 있어, 복잡한 코드베이스 작업 시간을 대폭 단축할 수 있다.
서브에이전트 오케스트레이션이란
Claude Code의 신규 오케스트레이션 레이어는 사용자가 하나의 고수준 지시를 내리면, Claude Code가 작업을 의존성 그래프(DAG) 형태로 분해해 독립 서브태스크를 병렬 실행한다. 예를 들어 "전체 프로젝트를 TypeScript strict 모드로 마이그레이션해" 라고 입력하면, 파일 분석·타입 추가·테스트 수정 등을 별도 에이전트가 동시에 처리한다.
핵심 특징:
- 최대 10개 서브에이전트 동시 스폰 (Pro/Max 플랜)
- 각 서브에이전트는 독립 컨텍스트 윈도우(200K 토큰) 보유
- 오케스트레이터는 Sonnet 4.6, 서브에이전트는 Haiku 4.5 기본 할당으로 비용 최적화
- 충돌 감지 시 자동 병합 또는 사용자 승인 요청
한국 개발자 실전 활용 시나리오
1. 모노레포 일괄 의존성 업그레이드
패키지 단위로 서브에이전트를 분기해 각 워크스페이스의 package.json 수정·테스트 실행·충돌 해결을 병렬 처리. 기존 순차 방식 대비 최대 4~6배 속도 향상 (Anthropic 내부 벤치마크 기준).
2. API 문서 자동 생성 컨트롤러·서비스·스키마 파일을 서브에이전트별로 분석 후 오케스트레이터가 OpenAPI 스펙으로 통합.
3. 다국어 i18n 키 추출 및 번역 초안 소스코드 스캔 에이전트 + 번역 초안 생성 에이전트를 동시 실행해 PR 준비 시간 단축.
요금 및 시작 방법
| 플랜 | 최대 병렬 에이전트 | 월 요금 | |------|-------------------|---------| | Pro | 5개 | 공식 페이지 참조 | | Max | 10개 | 공식 페이지 참조 | | Free | 미지원 | — |
CLI 업데이트 방법:
npm update -g @anthropic-ai/claude-code
# 버전 1.12.0 이상 필요
오케스트레이션 모드 활성화는 대화 중 /orchestrate 슬래시 커맨드를 입력하거나, 설정 파일에서 "orchestration": { "enabled": true } 를 추가하면 된다. 서브에이전트 실행 로그는 ~/.claude/logs/ 에 태스크별로 저장되어 디버깅에 활용할 수 있다.