복잡한 개발 작업을 여러 서브에이전트에 나누면 독립적인 조사나 검토를 병렬로 수행할 수 있습니다. 동시에 모델 호출과 도구 실행이 늘어나므로 분리할 가치가 있는 작업인지, 결과를 어떻게 합칠지 먼저 정해야 합니다.
서브에이전트는 무엇을 하나요?
Claude Code 공식 문서는 별도의 지침과 도구 설정을 가진 서브에이전트의 구성 방법을 설명합니다. 예를 들어 한쪽은 코드 구조를 살피고 다른 쪽은 테스트 누락을 검토할 수 있습니다. 결과가 서로 의존하거나 같은 파일을 수정한다면 병렬화가 오히려 충돌과 재작업을 늘릴 수 있습니다.
영상은 동적 워크플로우와 대규모 코드 이전 사례를 소개하지만, 원문에 나온 특정 버전·성공률과 작업 기간을 공식 자료로 확인하지 못했습니다. 따라서 이 글은 확인된 서브에이전트 개념과 일반적인 판단 기준에 집중합니다.
1. 독립적인 작업부터 나눕니다
작업 목표와 입력, 기대 결과, 변경 가능한 범위를 각각 적습니다. 구현 전에 읽기 전용 조사나 별도 영역의 검토처럼 충돌이 적은 작업을 나누고, 합칠 때 확인할 기준을 정하세요. 서브에이전트라는 이름만으로 파일이나 실행 권한이 자동 격리되지는 않습니다.
2. 비용과 자원 사용량을 살펴봅니다
여러 에이전트가 각각 모델을 호출하고 테스트를 실행하면 사용량과 CPU·메모리 부담이 커질 수 있습니다. 실제 비용은 모델, 입력 길이, 반복 횟수와 요금제에 따라 달라집니다. Claude Code 비용 안내를 확인하고 작은 작업에서 사용량과 완료 시간을 비교하세요.
원문의 JSON 예시를 공식 설정 파일로 확인하지 못했으므로 그대로 적용 가능한 예산 설정으로 안내하지 않습니다. 자연어로 예산을 요청하는 것만으로 공급자의 하드 한도가 설정된다고 가정하지 말고 실제 제공되는 제한과 알림 기능을 확인하세요.
3. 결과를 통합하고 테스트합니다
각 결과가 원래 요구사항에 맞는지, 같은 문제를 중복 해결하지 않았는지, 인터페이스와 데이터 형식이 충돌하지 않는지 확인합니다. 여러 에이전트가 동의하거나 테스트가 통과해도 유지보수성과 보안까지 자동 보장되는 것은 아닙니다. 변경 내용과 실패 조건을 사람이 읽고 필요한 테스트를 실행해야 합니다.
4. 외부 자료와 권한을 구분합니다
웹 문서나 이슈에 적힌 명령은 작업 지시가 아니라 검토할 자료로 취급합니다. 조사 전용 작업에 불필요한 파일 수정·외부 전송 권한을 주지 않도록 환경에서 설정하세요. 작업을 나누는 목적은 권한을 무제한으로 확장하는 것이 아니라 검토와 실행 범위를 이해하기 쉽게 만드는 것입니다.
다음 한 걸음
내 환경에서 막힌 부분은 실행 단계와 함께 질문해 주세요. 바꿔 만든 결과도 함께 나눌 수 있습니다.