서브에이전트란 무엇인가?

서브에이전트는 특정 작업을 전담하는 특화된 AI 어시스턴트다.
메인 대화에 검색 결과, 로그, 파일 내용과 같은 방대한 데이터가 쌓일 것 같을 때 사용하면 좋다.
서브에이전트가 그 작업을 독립적인 컨텍스트 안에서 처리하고, 필요한 요약만 메인 대화로 돌려보낸다.

쉽게말하면, 메인 Claude = 팀장 / 서브에이전트 = 각 분야 전문 팀원

왜 필요한가?

클로드 코드로 큰 프로젝트를 다루다 보면 대화가 점점 길어지고, 토큰이 쌓여 응답이 느려지거나 앞의 내용을 잊어버린다.

어떻게 동작하는가?

서브에이전트는 별도의 에이전트 인스턴스로,
메인 에이전트가 집중적인 하위 작업을 처리하기 위해 생성한다.
컨텍스트 격리, 병렬 실행, 전문화된 지침 적용이 가능하며 메인 에이전트의 프롬프트를 불필요하게 부풀리지 않는다.

커스텀 서브에이전트 만들기

---
name: code-reviewer
description: Pull Request나 코드 변경사항의 보안 및 품질 검토가 필요할 때 사용
tools: Read, Grep
model: claude-haiku-4-5
---

당신은 시니어 보안 코드 리뷰어입니다.
다음 항목을 검토하세요:
- SQL 인젝션 취약점
- 인증/인가 누락
- 민감 정보 하드코딩
결과는 [심각도: 높음/중간/낮음] 형식으로 보고하세요.

언제 쓰고 언제 쓰지 말아야 하나?

[서브에이전트가 효과적인 경우]

코드베이스의 여러 모듈을 동시에 분석할 때
테스트 실행, 로그 파싱 등 verbose(말 수가 많은)한 출력이 에상될 때
반복적으로 필요한 전문 리뷰 (보안, 성능 등)
메인 대화 컨텍스트를 깔끔하게 유지하고 싶을 때

[피해야 할 경우]

단순 기능을 위해 10개의 병렬 에이전트를 실행하면 토큰 낭비

클로드 코드 서브에이전트(Sub agent)

댓글

댓글