8분 → 3분 — 12개 테스트 파일을 4개 병렬 서브에이전트로 분산 처리한 사례

Context

Claude Code는 기본적으로 순차 실행을 수행하며, API rate limit(분당 토큰 기준)에 도달하기 쉽다. 긴 컨텍스트를 가진 단일 에이전트는 집중력 저하와 토큰 누적 문제를 겪는다.

Technical Solution

• 단일 작업 → 여러 서브에이전트로 분할하여 각자 고유한 컨텍스트(window)에서 독립 실행
• CLAUDE.md에 병렬 힌트 삽입으로 자동 트리거 가능
• settings.json deny rules로 서브에이전트의 파일 수정 범위 제한 가능
• 각 서브에이전트 완료 후 상태 블록([SUCCESS|FAILURE]) 출력으로 감사 추적 구현

Impact

테스트 스위트 실행 시간 8분 → 3분(62.5% 단축)

Key Takeaway

서브에이전트의 진정한 가치는 rate limit 회피가 아니라, 각 인스턴스가 깔끔한 컨텍스트를 유지하며 집중된 출력을 생성한다는 점이다.