⚖️
Subagent vs Agent Team 비교
비슷해 보이는 두 기능의 차이를 쉽게 설명합니다. 언제 어떤 걸 써야 할지 알아봐요.
Claude Code에는 Subagent와 Agent Team, 두 가지 멀티 에이전트 방식이 있습니다. 이름이 비슷해서 헷갈리기 쉬운데, 사용 상황이 완전히 다릅니다.
Subagent (서브에이전트) — 단순 위임
현재 대화에서 Claude가 하위 작업을 처리하도록 다른 Claude를 잠깐 호출합니다. • 주 에이전트가 서브에이전트에게 작업 위임 • 서브에이전트 완료 → 결과 반환 → 주 에이전트 계속 진행 • 동시 실행 가능 (Agent 도구 여러 개 병렬 호출) ✅ 단순 독립 작업 ✅ 빠른 실행, 적은 설정 ✅ 현재 세션에서 바로 사용
Agent Team (에이전트 팀) — 지속 협업
팀장 Claude가 팀을 구성하고, 팀원들이 메시지로 소통하며 장기 작업을 수행합니다. • 팀장-팀원 계층 구조 • TaskList로 작업 관리, SendMessage로 소통 • 팀원이 작업 완료 후에도 팀 유지 (다음 작업 대기) ✅ 복잡한 대형 프로젝트 ✅ 지속적인 협업 필요 시 ✅ 팀원별 역할 분담
코드로 보는 차이
// Subagent — Agent 도구로 즉시 위임
Agent tool {
subagent_type: "general-purpose",
prompt: "이 파일 분석해줘: data.csv"
}
// → 분석 결과 즉시 반환
// Agent Team — 팀 구성 후 지속 협업
TeamCreate { team_name: "analytics-team" }
TaskCreate { subject: "파일 1 분석" }
TaskCreate { subject: "파일 2 분석" }
Agent tool { name: "analyst-1", ... }
Agent tool { name: "analyst-2", ... }
// → 팀원들이 병렬로 작업, 완료 시 보고선택 기준
- •작업 1개, 빠르게 → Subagent
- •작업 여러 개, 독립적 → Subagent 병렬 호출
- •작업 많고 복잡, 상호 보고 필요 → Agent Team
- •장기 프로젝트, 역할 분담 → Agent Team
- •단순 코드 리뷰 → Custom Subagent (에이전트 정의)
- •10개+ 파일 동시 처리 → Agent Team
실전 선택 예시
"이 보고서 요약해줘" → 단순 작업 → Subagent "10개 부서 데이터 각각 분석해줘" → 독립 반복 작업 → Subagent 10개 병렬 "3개월짜리 프로젝트 기획·개발·테스트 동시 진행" → 지속적 역할 분담 → Agent Team
💡
처음엔 Subagent로 시작하세요. 작업이 복잡해지고 팀원 간 소통이 필요해지는 시점에 Agent Team으로 전환하는 것이 자연스러운 흐름입니다.