Claude Code, 병렬 서브에이전트 실행 기능 베타 공개

병렬 서브에이전트 아키텍처

Claude Code 베타 업데이트는 오케스트레이터-워커 패턴을 채택했다. 루트 에이전트가 태스크를 분석한 뒤 의존성이 없는 작업을 최대 5개의 서브에이전트에 분산한다. 각 서브에이전트는 독립된 컨텍스트를 가지며, 완료 후 오케스트레이터가 결과를 병합한다. 내부 벤치마크 기준 1,000줄 규모 리팩터링 작업에서 단일 에이전트 대비 소요 시간이 평균 58% 감소했다.

사용 방법 및 설정

# Claude Code 최신 버전 업데이트
npm install -g @anthropic-ai/claude-code@latest

# 병렬 모드 활성화 (베타 플래그)
claude --parallel --max-subagents 5 "테스트 커버리지 80% 달성하고 README 업데이트해줘"

--max-subagents 값은 1~5 사이로 설정 가능하며, API 키당 동시 서브에이전트 수는 Anthropic 계정 티어에 따라 제한된다. 서브에이전트 각각은 Claude Haiku 4.5 모델을 기본으로 사용해 비용을 최적화하고, 오케스트레이터는 Claude Sonnet 계열을 사용한다.

크리에이터·개발자 활용 시나리오

• 영상 크리에이터: 스크립트 초안 생성·자막 파일 변환·SNS 홍보 문구 작성을 동시에 처리
• 풀스택 개발자: API 엔드포인트 추가와 프론트엔드 컴포넌트 생성을 병렬 실행
• 오픈소스 메인테이너: CHANGELOG 업데이트, 이슈 트리아지 코멘트 초안, 릴리스 노트를 한 번의 명령으로 자동화

베타 기간 동안 병렬 서브에이전트 사용량은 기존 Claude Code 사용량 크레딧에 합산되며, 정식 GA 이후 별도 요금 체계 적용 여부는 공식 페이지 참조.