Claude Code, 서브에이전트 병렬 태스크 실행 정식 GA — 멀티 파일 작업 가속
Anthropic이 Claude Code의 서브에이전트(Sub-agent) 병렬 태스크 실행 기능을 정식 GA로 전환했다. 단일 프롬프트로 최대 5개의 독립 태스크를 동시에 처리할 수 있어, 대규모 코드베이스에서 테스트 작성·문서화·린트 수정을 동시에 진행하는 워크플로가 가능해진다.
기능 개요
Claude Code는 이제 하나의 사용자 지시에서 내부적으로 서브에이전트를 분기해 최대 5개 태스크를 병렬로 수행한다. 예를 들어 "src/api 디렉터리 전체에 Jest 단위 테스트를 작성하고, JSDoc을 추가하고, ESLint 오류를 고쳐줘"라는 단일 프롬프트를 입력하면, Claude Code가 세 태스크를 별도 컨텍스트에서 동시에 진행한 후 결과를 병합한다.
각 서브에이전트는 격리된 파일 잠금(file-level locking) 메커니즘으로 동일 파일을 동시 수정하는 충돌을 방지한다. 충돌이 감지되면 Claude Code가 자동으로 직렬 실행으로 폴백한다.
성능 및 제한 사항
| 항목 | 수치 | |---|---| | 최대 병렬 서브에이전트 수 | 5개 | | 서브에이전트당 컨텍스트 윈도우 | 독립 200K 토큰 | | 사용 모델 | Claude Sonnet 4.6 (기본) | | 월 사용 요금 | 공식 페이지 참조 |
현재 터미널 CLI(claude 커맨드) 및 VS Code 확장 1.9.0 이상에서 사용 가능하다. JetBrains 플러그인 지원은 2026년 4분기 로드맵에 포함되어 있다.
워크플로 적용 방법
1. 활성화 방법
별도 설정 없이 GA 전환과 동시에 자동 적용된다. 병렬 실행을 원하지 않는 경우 CLAUDE_CODE_MAX_SUBAGENTS=1 환경 변수로 직렬 모드로 고정할 수 있다.
2. 추천 사용 패턴
# 효과적인 병렬 태스크 예시
"components/ 하위 20개 파일에 TypeScript strict 타입을 추가하고,
storybook 스토리를 생성하고, CHANGELOG.md를 업데이트해줘"
태스크 간 의존성이 없을수록 병렬 효율이 높다. 의존 관계가 있는 태스크는 자연어로 순서를 명시하면 Claude Code가 DAG를 구성해 처리한다.
3. 비용 관리 팁
서브에이전트마다 독립 컨텍스트를 사용하므로 토큰 소비량이 직렬 대비 증가할 수 있다. claude --dry-run 플래그로 실행 전 예상 태스크 분기 수와 토큰 예측값을 확인하는 습관을 권장한다.