SubAgent
개요
SubAgent는 복잡한 작업을 수행할 때 Claude Code가 자동으로 생성하는 독립적인 에이전트입니다. 메인 에이전트가 특정 하위 작업을 SubAgent에게 위임하여 병렬 처리하거나 전문화된 작업을 수행합니다.
SubAgent는 단 한가지의 특화된 일을 처리하는 Agent 입니다. Main Agent와 독립된 Context Window를 갖고 있으며 Main Agent에 의해서 트리거 되거나 사용자에 의해서 직접 트리거 될 수도 있습니다. 동시에 여러개의 SubAgent가 실행 될 수 있습니다.
주요 특징
- 독립적인 컨텍스트에서 작업 수행
- 병렬 처리 가능
- 특정 작업에 특화된 프롬프트 사용
- 결과를 메인 에이전트에게 보고
사용 방법
SubAgent 정의
.claude/agents/ # 프로젝트별 에이전트
~/.claude/agents/ # 전역 에이전트
예시
# .claude/agents/code-reviewer.md
---
name: code-reviewer
description: 코드 리뷰를 수행하는 에이전트
allowed-tools: Read, Grep, Glob
---
당신은 코드 리뷰 전문가입니다. 다음을 수행하세요:
1. 코드 품질 분석
2. 버그 가능성 확인
3. 개선 사항 제안
클로드 코드 기본 SubAgent
기본 SubAgent 종류
클로드 코드에서는 기본적으로 제공하는 여러가지 종류의 SubAgent가 있습니다.
- agent-general-purpose (Task, WebSearch 등을 수행)
- agent-Plan (코드베이스 분석 및 계획수립)
- agent-Explore (코드베이스 분석)
- agent-statusline-setup (Statusline 세팅)
SubAgent 사용방법
@agent-general-purpose 를 사용해서 @something.js 코드에 디버깅용 콘솔을 작성해줘
subagent를 멘션하는 방법은 @-mentions 입니다. 예를들어 @agent-Plan 을 하면 직접 멘션할 수 있습니다.
별도의 Context
Main Agent와는 별도의 Context를 갖기 때문에 SubAgent에서 생성한 코드는 rewind를 할 수 없습니다.
활용 사례
- 대규모 코드베이스 분석
- 병렬 파일 검색 및 수정
- 복잡한 리팩토링 작업