Claude Code, 서브에이전트 병렬 실행 정식 지원—대형 리팩토링 속도 대폭 향상

무엇이 바뀌었나

Claude Code는 이제 단일 세션 안에서 최대 10개의 서브에이전트를 병렬로 스폰(spawn)할 수 있다. 각 서브에이전트는 독립된 컨텍스트 윈도우를 가지며, 오케스트레이터 에이전트가 작업 결과를 취합해 최종 PR 초안을 생성한다. 기존에는 순차적으로 파일을 순회하며 편집했기 때문에 500개 이상의 파일을 포함한 모노레포에서 완료까지 수십 분이 소요됐다.

실제 성능 수치

Anthropic 공식 벤치마크(내부 테스트, 1,000파일 TypeScript 모노레포 기준):

• 의존성 전체 교체 작업: 기존 평균 47분 → 19분 (약 60% 단축)
• 유닛 테스트 자동 생성(커버리지 80% 목표): 기존 평균 31분 → 14분
• 서브에이전트 수는 작업 복잡도에 따라 자동 결정되며, 수동으로 --max-agents 5 플래그로 제한 가능

사용 모델은 기본적으로 Claude Sonnet 4이며, --model opus 플래그를 추가하면 Claude Opus 4.7 기반으로 전환된다. 가격은 각 서브에이전트의 입출력 토큰이 개별 과금되므로 작업 전 공식 페이지 참조.

한국 개발자 적용 가이드

모노레포 프로젝트 설정 예시:

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

# 병렬 서브에이전트 활성화 (기본 on, 최대 수 제한 예시)
claude --max-agents 8 "packages/ 디렉터리 내 모든 컴포넌트에 Jest 테스트 추가"

주의사항:

• 서브에이전트 간 파일 충돌 방지를 위해 오케스트레이터가 락(lock) 메커니즘을 자동 적용한다.
• Git이 초기화된 디렉터리에서만 병렬 모드가 활성화된다. 버전 관리가 없는 폴더에서는 단일 에이전트 모드로 폴백된다.
• 현재 macOS·Linux CLI 환경에서 지원되며, VS Code 확장 플러그인 지원은 2026년 7월 예정이다.

대규모 레거시 코드베이스를 유지보수하는 팀이라면 이번 업데이트를 통해 리팩토링 사이클을 주 단위에서 일 단위로 단축할 수 있을 것으로 기대된다.