용어 · AI 코딩
Subagent
서브에이전트
메인 대화와 분리된 자체 컨텍스트에서 하위 작업을 처리하고 요약만 돌려주는 보조 AI 에이전트.
실무에서 뜻하는 것
서브에이전트는 메인 Claude가 일을 나눠 맡기는 팀원입니다. 각 서브에이전트는 자기 컨텍스트 윈도우, 시스템 프롬프트, 허용 도구를 따로 가집니다. 검색 결과나 긴 로그처럼 다시 볼 일 없는 내용은 서브에이전트 안에 남습니다. 메인 대화에는 요약만 돌아옵니다. 자주 쓰는 역할은 .claude/agents/ 폴더에 마크다운 파일로 정의해 둡니다. 서브에이전트가 보내는 요청도 메인 대화와 같은 사용 한도에서 차감됩니다.
리텐션에서 쓴 예
클로드 대화 길이 제한 해결하는 7가지 방법은 서브에이전트를 다섯 번째 해결책으로 소개했습니다. 메인 Claude가 조율하고, 코드 리뷰·테스트·문서화를 각 서브에이전트에 맡기는 구조입니다. 목적은 도구 사용 결과와 중간 과정이 메인 컨텍스트를 채우지 않게 하는 것입니다. 글은 복잡한 문제일수록 대화 초반에 서브에이전트를 쓰라고 권했습니다.
헷갈리기 쉬운 것
서브에이전트를 많이 띄운다고 빨라지지는 않습니다. 클로드 Opus 5, 이제 이렇게 말 걸어야 합니다는 작은 일까지 나누면 비용과 시간이 배로 든다고 적었습니다. 서로 독립적인 큰 작업에만 맡기는 편이 낫습니다. 넓게 보면 서브에이전트는 멀티 에이전트 오케스트레이션 구성의 한 형태입니다.
이 용어가 나오는 글
관련 용어
출처: 사용자 정의 subagent 만들기 (Claude Code 공식 문서)
수정 · Markdown 원문