서브에이전트(Subagent)
서브에이전트(subagent)는 주 에이전트가 작업을 넘겨주는 보조 에이전트입니다. 흔히 자체 지시와 도구를 가지고 새로운 별도의 컨텍스트 윈도우에서 일하며, 결과의 요약만 돌려줍니다.
다른 이름: sub-agent
작성 Divya Sharma · 2026년 11월 15일 확인 · 리뷰 방식
긴 에이전트 세션은 한 단계에만 중요하고 다시는 필요 없는 검색 결과, 로그, 파일 내용으로 가득 찹니다. 서브에이전트는 이런 잡동사니를 주 대화 밖에 둡니다. 주 에이전트가 곁가지 작업을 설명하면, 서브에이전트가 격리된 상태에서 일하고, 짧은 보고서만 돌아옵니다.
작동 방식
Claude Code에서 서브에이전트는 Markdown 파일로 정의합니다. 이름, 언제 쓸지에 대한 설명, 선택적인 허용 도구 및 모델 목록, 그리고 시스템 프롬프트가 되는 본문입니다. 작업이 설명과 맞으면 주 에이전트가 이를 위임합니다. 서브에이전트는 빈 컨텍스트 윈도우로 시작하며 부모의 기록을 보지 못하므로, 넘겨주는 메시지에 필요한 내용이 담겨 있어야 합니다. 다른 코딩 에이전트와 에이전트 프레임워크도 비슷한 위임 기능을 제공합니다.
왜 중요한가
서브에이전트는 컨텍스트 엔지니어링 도구입니다. 주 스레드를 짧게 유지하고, 여러 조사나 검토 작업을 병렬로 돌리게 하며, 위험한 도구를 좁은 용도의 보조 하나로 제한할 수 있게 합니다. 예를 들어 파일을 읽을 수는 있지만 편집할 수는 없는 리뷰어가 있습니다.
서브에이전트와 멀티 에이전트 시스템
서브에이전트는 부모 하나에게 보고하는 자식입니다. 멀티 에이전트 시스템은 더 넓은 설계로, 서로 대화하는 동등한 에이전트를 포함할 수 있습니다. 서브에이전트는 가장 단순하고 흔한 형태입니다.
한계
서브에이전트마다 자체 토큰을 쓰며, 넘겨주는 메시지나 요약에서 빠진 것은 부모에게 전달되지 않습니다.
관련 용어
- 멀티 에이전트 시스템(Multi-agent system)
- 멀티 에이전트 시스템(multi-agent system)은 각자 지시, 도구, 컨텍스트를 가진 여러 AI 에이전트가 작업의 일부를 맡아 처리하고, 결과를 서로 또는 조율 에이전트에 넘기는 구성입니다.
- 코딩 에이전트
- 코딩 에이전트(coding agent)는 소프트웨어를 직접 다루는 AI 에이전트입니다. 사람이 붙여 넣을 코드를 제안하는 데 그치지 않고, 코드베이스를 읽고, 파일을 수정하고, 명령과 테스트를 실행하며, 변경이 동작할 때까지 반복합니다.
- 컨텍스트 엔지니어링
- 컨텍스트 엔지니어링(context engineering)은 작업 동안 언어 모델의 컨텍스트 윈도에 들어가는 모든 것을 고르 고 관리하는 일입니다. 지시, 검색한 문서, 도구 정의, 도구 결과, 대화 기록이 여기에 포함됩니다.
- 에이전트 오케스트레이션
- 에이전트 오케스트레이션(agent orchestration)은 애플리케이션에서 어떤 에이전트나 모델 호출을 어떤 순서로 실행할지, 다음 단계를 어떻게 고를지를 제어하는 일입니다. 그 결정은 모델이 내릴 수도 있고 고정된 코드가 내릴 수도 있습니다.
- 컨텍스트 윈도
- 컨텍스트 윈도(context window)는 언어 모델이 한 번에 고려할 수 있는 텍스트의 최대량으로, 토큰 단위로 셉니다. 시스템 프롬프트, 대화, 문서, 도구 결과, 모델이 쓰는 응답이 모두 포함됩니다.