← AI 용어집

AI 용어집 · 기초 · 에이전트

서브에이전트 Subagent

서브에이전트는 메인 AI 에이전트가 일부 작업을 맡기는 보조 에이전트입니다. 자기만의 컨텍스트에서 작업한 뒤 결과 요약만 메인 에이전트에 돌려줍니다.

쉽게 말하면 팀장이 자료 조사를 팀원에게 맡기고, 팀원이 수많은 자료를 혼자 읽은 뒤 한 장짜리 보고서만 올리는 것과 비슷합니다. 다만 서브에이전트는 맡은 일이 끝나면 따로 남지 않습니다. 같은 작업 세션 안에서만 움직이는 임시 일꾼에 가깝습니다.

무엇인가

AI 에이전트가 큰 일을 하다 보면 파일 검색이나 로그 확인처럼 곁가지 작업이 생깁니다. 이런 작업의 중간 결과까지 모두 메인 대화에 쌓이면 컨텍스트 윈도(모델이 한 번에 볼 수 있는 글의 양)가 금방 찹니다. 다시 볼 일도 없는 내용으로 말이죠. 서브에이전트는 이런 곁가지 작업을 따로 떼어 맡는 보조 에이전트입니다. Claude Code 공식 문서는 서브에이전트를 '특정 유형의 작업을 처리하는 전문화된 AI 어시스턴트'라고 설명합니다.

어떻게 작동하나

서브에이전트는 메인 대화와 분리된 자기만의 컨텍스트 윈도에서 돌아갑니다. 서브에이전트마다 시스템 프롬프트(역할과 규칙을 정한 지시문)를 따로 둘 수 있습니다. 쓸 수 있는 도구와 권한도 따로 정합니다. 메인 에이전트는 각 서브에이전트에 적힌 짧은 설명을 보고 지금 작업을 맡길지 판단합니다. 일을 맡은 서브에이전트는 독립적으로 작업하고, 끝나면 요약한 결과만 메인 에이전트에 돌려줍니다.

서브에이전트에 일을 맡기는 흐름사용자 요청 → 메인 에이전트; 메인 에이전트 → 서브에이전트(작업 위임); 서브에이전트 → 검색 결과·로그(탐색); 서브에이전트 → 요약 결과(요약); 요약 결과 → 메인 에이전트(보고); 메인 에이전트 → 최종 답변사용자 요청메인 에이전트대화 흐름 유지최종 답변서브에이전트별도 컨텍스트제한된 도구검색 결과·로그메인엔 안 들어감요약 결과작업 위임탐색요약보고
서브에이전트에 일을 맡기는 흐름 메인 에이전트가 곁가지 작업을 서브에이전트에 맡깁니다. 서브에이전트는 검색 결과와 로그를 자기 컨텍스트 안에서만 다루고, 요약만 메인에 돌려줍니다.

왜 주목받나

가장 큰 이점은 메인 대화의 컨텍스트를 아낄 수 있다는 점입니다. 탐색이나 구현 과정의 긴 기록이 메인 대화에 쌓이지 않습니다. 쓸 수 있는 도구를 제한해 안전하게 일을 나눌 수도 있습니다. 예를 들어 읽기만 하는 서브에이전트를 둘 수 있습니다. 같은 설정을 여러 프로젝트에서 다시 쓸 수 있고, 단순한 작업은 Haiku 같은 더 빠르고 저렴한 모델에 맡겨 비용을 줄일 수도 있습니다. 이런 이유로 코딩 에이전트에서 일을 나누는 대표적인 방법이 되었습니다.

알아 둘 점

서브에이전트도 모델에 요청을 따로 보냅니다. 그래서 메인 대화와 같은 사용량 한도를 함께 씁니다. 각 서브에이전트의 설명은 메인 에이전트의 컨텍스트를 차지하므로 짧게 써야 합니다. 자세한 지시는 해당 서브에이전트가 실행될 때만 불러오는 시스템 프롬프트에 넣는 편이 좋습니다. 서브에이전트는 한 세션 안에서만 일합니다. 여러 세션을 동시에 돌리거나 세션끼리 협업시키는 일은 다른 기능의 몫입니다.

예시

코딩 도구 Claude Code에는 기본으로 들어 있는 서브에이전트가 여러 개 있습니다. 대표적으로 Explore는 코드베이스를 빠르게 검색하고 분석하는 읽기 전용 에이전트입니다. 그 밖에 Plan, General-purpose 등이 있습니다. 사용자는 자주 맡기는 일에 맞춰 직접 서브에이전트를 정의할 수도 있습니다. 이 사이트에서 다룬 'Claude Haiku 5.5' 출시 소식처럼 작고 빠른 모델이 나오면, 이런 서브에이전트에 단순 작업을 맡기는 선택지도 넓어집니다.

이 사이트에서 나온 사례

함께 보면 좋은 용어

참고