GLOSSARY

서브에이전트

중급AI 에이전트

이 페이지는 AI 에이전트 문맥에서 자주 쓰이는 서브에이전트의 뜻과 쓰임을 중급 난이도 기준으로 정리한 AI 용어사전 항목입니다. 정의와 맥락, 관련 용어 9개, 관련 글 6개 순서로 묶었으니, 아래 설명을 먼저 읽고 연결된 개념과 글까지 이어서 보면 이해가 빨라집니다.

서브에이전트(Subagent)는 주 에이전트가 범위를 정한 하위 작업을 별도의 실행 맥락에서 처리하도록 호출하는 전문 에이전트입니다. 주 에이전트는 일을 나누고 결과를 합치며, 서브에이전트는 맡은 범위에서 조사, 작성, 검토 같은 작업을 수행합니다.

별도 컨텍스트와 작업 공간은 다르다

서브에이전트를 쓰는 가장 뚜렷한 이유는 컨텍스트 분리입니다. 대규모 코드 검색이나 긴 문서 조사를 맡기면 중간 검색 결과와 도구 출력이 서브에이전트의 컨텍스트에 머뭅니다. 주 에이전트는 보고받은 핵심 결과를 바탕으로 다음 결정을 내릴 수 있습니다. 다만 서브에이전트가 항상 마지막 답변 한 줄만 돌려주는 것은 아닙니다. 제품에 따라 요약, 구조화된 상태, 사용량, 작업 파일 경로 같은 실행 정보가 함께 반환될 수 있습니다.

별도 컨텍스트가 별도 파일 시스템을 뜻하지도 않습니다. 같은 저장소에서 실행된 작업자들은 파일 변경을 바로 공유할 수 있고, 동시에 같은 파일을 고치면 충돌하거나 다른 사람의 수정을 덮을 수 있습니다. Anthropic의 Claude Code 서브에이전트 문서는 기본 서브에이전트가 주 대화의 현재 작업 디렉터리에서 시작하며, isolation: worktree를 지정할 때 별도의 Git 작업 사본을 쓴다고 설명합니다. 다른 에이전트 제품은 작업 공간 공유와 격리 방식이 다를 수 있으므로 실행 환경의 규칙을 확인해야 합니다.

예를 들어 결제 기능을 점검하면서 한 작업자에게 API 권한 검토를, 다른 작업자에게 화면 오류 조사를 맡길 수 있습니다. 두 작업이 서로 다른 파일을 읽고 결과만 보고한다면 병렬 실행이 잘 맞습니다. 둘 다 같은 결제 모듈을 수정해야 한다면 파일 소유 범위를 나누거나 작업 사본을 분리해야 합니다. 주 에이전트는 누가 어떤 파일과 결론을 맡았는지 정하고, 보고가 오면 서로 모순되는 주장과 중복 변경을 확인한 뒤 하나의 결과로 합칩니다.

ℹ️컨텍스트 격리는 파일 격리가 아닙니다

각 서브에이전트가 별도 대화 맥락에서 일해도 같은 작업 디렉터리를 볼 수 있습니다. 병렬 수정 전에는 파일 소유 범위나 worktree 같은 격리 방법을 정해야 합니다.

병렬 작업과 보고는 어떻게 설계하나

병렬 실행은 서로 기다리지 않아도 되는 작업에서 이점이 큽니다. 세 라이브러리의 공식 문서를 각각 조사하거나, 보안·성능·접근성을 독립적으로 검토하는 일은 동시에 진행할 수 있습니다. 데이터베이스 스키마가 확정돼야 API를 만들 수 있는 작업처럼 선후 관계가 있다면 순차 실행이 맞습니다. Claude Code 병렬 작업 안내는 조정 주체, 작업자 간 통신 필요성, 같은 파일 수정 여부를 기준으로 서브에이전트와 팀, 격리된 작업 사본을 구분합니다.

일을 맡길 때는 결과물과 작업 경계를 함께 분명히 씁니다. 읽을 자료, 수정 가능한 파일, 금지된 동작, 필요한 근거, 완료 조건, 보고 형식을 함께 줍니다. “저장소를 살펴봐”보다 “인증 모듈에서 세션 만료 처리만 읽고, 파일과 줄을 근거로 위험 세 건 이하를 보고하라”가 합치기 쉽습니다. 보고에는 결론뿐 아니라 확인한 범위, 근거 위치, 남은 불확실성, 실제로 바꾼 파일을 포함해야 합니다. 주 에이전트는 보고를 받은 뒤 사실 충돌과 누락을 확인하며, 여러 요약을 그대로 이어 붙이는 것으로 합류를 끝내지 않습니다.

서브에이전트끼리 직접 대화할 수 있는지도 제품에 따라 다릅니다. Claude Code의 서브에이전트는 호출한 대화에 보고하고, 별도의 agent teams는 공유 작업 목록과 작업자 간 메시지를 지원합니다. Claude Code 기능 비교는 스킬을 필요할 때 불러오는 지침, 서브에이전트를 격리된 실행 맥락, 에이전트 팀을 서로 조율하는 독립 세션으로 구분합니다. 이 차이를 무시하면 직접 협의가 필요한 일을 보고 통로 하나뿐인 작업자들에게 맡겨 조정 비용이 커질 수 있습니다.

도구 권한과 사용 시점을 판단하기

서브에이전트가 모든 도구를 쓸 수 있다는 보장은 없습니다. 역할 정의에서 읽기, 검색, 셸, 파일 수정, MCP 서버 같은 도구를 허용하거나 막을 수 있고, 상위 세션의 권한 정책도 영향을 줍니다. Claude Code의 공식 문서는 서브에이전트마다 도구 목록과 권한 모드를 정할 수 있다고 안내합니다. 보안 검토 작업자에게는 읽기와 검색만 주고, 테스트 실행 작업자에게만 제한된 셸 권한을 주는 식으로 맡은 일에 필요한 범위만 열 수 있습니다.

권한이 좁으면 안전성은 높아지지만 수행할 수 있는 일도 줄어듭니다. 읽기 전용 작업자가 문제를 찾았다고 해서 수정까지 끝낸 것은 아니며, 네트워크 권한이 없는 조사자는 최신 외부 문서를 확인할 수 없습니다. 보고서에는 무엇을 할 수 없었는지 남겨야 주 에이전트가 미완료 작업을 알아볼 수 있습니다. 단순 파일 검색에 배포 권한까지 줄 이유도 없습니다. 도구 권한은 편의를 위한 목록이 아니라 서브에이전트의 실제 행동 경계입니다.

서브에이전트는 큰 작업을 무조건 잘게 나눌 때보다, 독립된 조사 과정이 길거나 전문 역할이 반복되거나 병렬성이 분명할 때 효과적입니다. 짧은 수정 하나를 위임하면 작업 설명과 보고를 주고받는 비용이 더 클 수 있습니다. 같은 파일을 계속 함께 고치거나 작업자끼리 수시로 합의해야 한다면 주 에이전트가 직접 처리하거나 팀형 조정 방식을 택하는 편이 낫습니다. 성공적인 분업은 작업자 수보다 경계, 권한, 합류 순서가 분명한지에 달려 있습니다.

RELATED TERMS