프롬프트·활용
서브에이전트
Sub-agent
메인 에이전트가 특정 작업을 위임하는 독립 보조 에이전트. 자체 컨텍스트 창·시스템 프롬프트·도구 권한을 갖고, 작업 결과의 요약만 돌려줍니다.
8
서브에이전트(Sub-agent)는 에이전트가 특정 작업을 위임하는 독립적인 보조 일꾼입니다. 자기만의 컨텍스트 창, 맞춤 시스템 프롬프트, 허용된 도구, 독립 권한을 갖습니다.
핵심 포인트
Claude Code에서 각 서브에이전트는 "자체 컨텍스트 창·맞춤 시스템 프롬프트·특정 도구 접근·독립 권한"으로 동작합니다.
오케스트레이터(메인 에이전트)는 서브에이전트의 description에 맞는 작업을 만나면 자동으로 위임하고, 서브에이전트는 독립적으로 일한 뒤 원본이 아닌 "요약"만 돌려줍니다.
주된 가치: 메인 대화의 컨텍스트 보존(검색결과·로그·파일덤프 분리), 도구 제한으로 제약 강제, 설정 재사용, 행동 특화, 더 저렴한 모델로 라우팅해 비용 절감.
"다시 들여다보지 않을 결과로 메인 대화가 넘칠" 곁가지 작업에 쓰기 좋습니다.
이렇게 쓰여요
코드를 작성한 뒤 호출하는 "code-reviewer" 서브에이전트
거대한 코드베이스를 탐색하고 결론 요약만 메인 세션에 돌려주는 리서치 서브에이전트
주의할 점
서브에이전트는 같은 세션 안에서 동작하지만 메인 컨텍스트를 공유하지 않습니다. 위임한 작업 내용만 전달되므로, 꼭 필요한 맥락은 명시적으로 넘겨줘야 합니다.