Home / Glossary / 서브 에이전트

Definition

서브 에이전트

서브 에이전트는 복잡한 작업의 독립적인 부분을 동시에 처리하기 위해 메인 AI 코딩 에이전트가 생성하는 병렬 자식 프로세스입니다. 모든 것을 순차적으로 처리하는 대신, 메인 에이전트는 하위 작업을 병렬로 실행하여 결과를 상위 에이전트에 보고하는 전문화된 자식 에이전트에 위임합니다.

서브 에이전트의 작동 방식

메인 에이전트가 여러 독립적인 부분이 있는 작업을 만나면 병렬로 처리하기 위해 서브 에이전트를 생성할 수 있습니다. 예를 들어 "인증, 결제, 알림 모듈을 새 오류 처리 패턴으로 리팩토링하라"고 요청하면, 메인 에이전트가 각 모듈에 대해 하나씩 세 개의 서브 에이전트를 생성할 수 있습니다. 각 서브 에이전트는 관련 파일을 읽고, 변경을 수행하고, 독립적으로 테스트를 실행합니다. 메인 에이전트는 결과를 수집하고 변경 사항 간의 일관성을 보장합니다.

서브 에이전트가 유용한 경우

  • +여러 독립적인 모듈에 걸친 대규모 리팩토링 작업
  • +코드베이스의 여러 부분을 동시에 조사
  • +여러 분석 작업(보안 감사, 성능 검사, 스타일 리뷰)을 병렬로 실행
  • +여러 독립적인 컴포넌트에 대한 코드 동시 생성
  • +여러 근본 원인이 있을 수 있는 복잡한 버그 조사

서브 에이전트는 하위 작업이 진정으로 독립적일 때 가장 효과적입니다. 같은 파일을 수정하거나 서로의 출력에 의존하지 않는 경우입니다. 작업에 의존성이 있을 때는 충돌을 피하기 위해 단일 에이전트의 순차적 실행이 더 적절합니다.

Claude Code는 Task 도구를 통해 서브 에이전트를 지원합니다. 메인 에이전트는 특정 지침과 범위가 지정된 권한으로 자식 에이전트를 생성하고, 그들의 결과를 일관된 응답으로 합성할 수 있습니다.

서브 에이전트가 메인 에이전트와 컨텍스트를 공유하나요?+
서브 에이전트는 생성될 때 메인 에이전트로부터 컨텍스트를 받지만, 라이브 컨텍스트 윈도우를 공유하지는 않습니다. 각 서브 에이전트는 자체 컨텍스트로 독립적으로 작동합니다. 메인 에이전트는 최종 출력을 받아 합성합니다.
동시에 몇 개의 서브 에이전트가 실행될 수 있나요?+
도구와 가용 리소스에 따라 다릅니다. Claude Code는 여러 서브 에이전트를 병렬로 실행할 수 있으며, 일반적으로 각 작업의 복잡성에 따라 2~5개입니다. 실용적인 한계는 토큰 사용량과 API 속도 제한에 의해 결정됩니다.
서브 에이전트가 자체 서브 에이전트를 생성할 수 있나요?+
원칙적으로는 가능하며, 이렇게 하면 에이전트의 트리가 생성됩니다. 실제로는 대부분의 작업이 단일 위임 수준으로 잘 처리됩니다. 깊은 중첩은 대부분의 코딩 작업에서 비례적인 이점 없이 복잡성을 추가합니다.
서브 에이전트 사용을 피해야 할 때는 언제인가요?+
작업이 서로 의존성이 있거나, 같은 파일을 수정할 경우(병합 충돌 위험), 또는 작업이 여러 에이전트를 생성하고 조정하는 오버헤드보다 순차 처리가 빠를 만큼 작은 경우에는 서브 에이전트를 피하세요.

Related terms

Agentic CodingClaude Code코딩 에이전트헤드리스 AI 에이전트

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS