Claude Code, 서브에이전트 오케스트레이션 정식 GA — 태스크 병렬 분기 최대 10개

무엇이 바뀌었나

Claude Code는 기존에 단일 에이전트 루프로 동작했으나, 이번 GA 전환으로 서브에이전트 오케스트레이션 아키텍처가 정식 지원된다. 루트 에이전트가 작업을 분해(task decomposition)하면, 최대 10개의 서브에이전트가 각자 독립적인 컨텍스트 창을 가지고 병렬로 실행된다. 서브에이전트 간 결과 병합(merge) 및 충돌 감지(conflict detection)는 루트 에이전트가 자동으로 처리한다.

내부적으로 Claude Opus 4.7이 오케스트레이터 역할을 맡고, 서브태스크 난이도에 따라 Claude Sonnet 4.6 또는 Claude Haiku 4.5로 자동 라우팅되는 계층형 모델 라우팅 구조가 적용됐다. 비용은 각 서브에이전트가 소비하는 토큰에 따라 개별 과금되므로, 공식 페이지에서 모델별 단가를 확인한 뒤 예산 설계를 권장한다.

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

대규모 리팩터링 자동화 시나리오에서 효용이 두드러진다. 예를 들어 모노레포 환경에서 packages/* 하위 모듈별로 서브에이전트를 분기하면, 기존 순차 실행 대비 전체 소요 시간을 최대 60% 단축할 수 있다고 Anthropic 공식 벤치마크는 밝혔다(내부 10만 줄 TypeScript 프로젝트 기준).

크리에이터·기술 문서 팀에서는 다국어 문서 동시 번역·검수 파이프라인에 바로 적용할 수 있다. 루트 에이전트가 원문을 섹션 단위로 분할하고, 각 서브에이전트가 언어별로 번역 후 용어 일관성 검사를 병렬 수행하는 워크플로우가 공식 Cookbook 예제로 함께 공개됐다.

CI/CD 연동도 강화됐다. GitHub Actions 및 GitLab CI용 공식 액션이 업데이트되어, claude-code run --agents 5 --task-file tasks.yaml 형태의 단일 명령으로 서브에이전트 파이프라인을 트리거할 수 있다.

설정 방법 및 주의사항

클라이언트 업데이트는 npm install -g @anthropic-ai/claude-code@latest 한 줄로 완료된다. VS Code 익스텐션은 마켓플레이스에서 자동 업데이트가 제공되며, JetBrains 플러그인은 플러그인 매니저에서 수동 업데이트가 필요하다.

주의할 점은 동시 서브에이전트 수가 많을수록 토큰 소비가 선형 이상으로 증가할 수 있다는 것이다. Anthropic은 초기 실험 시 3~5개 에이전트로 시작해 비용-성능 균형을 확인할 것을 권장한다. 또한 서브에이전트 간 파일 쓰기 충돌을 방지하기 위해 작업 범위(scope)를 명확히 정의하는 것이 중요하다. 자세한 요금 체계는 공식 페이지 참조.