클로드 코드 Team 기능 완전 가이드 (총 9편) | 2편 서브에이전트 vs Team, 언제 뭘 써야 할까

시리즈: 클로드 코드 Team 기능 완전 가이드 (총 9편) | 2편

서브에이전트 vs Team, 언제 뭘 써야 할까

Claude Code의 서브에이전트와 Team 기능, 둘 다 여러 작업을 동시에 처리하는 건 같은데 정확히 뭐가 다른 걸까요? 이 글에서는 둘의 구조적 차이 3가지와 비용까지 고려한 상황별 선택 기준을 명확하게 정리해 드릴게요.

Summary

• 서브에이전트와 Team은 독립 컨텍스트, 직접 메시징, 공유 Task list 세 가지에서 근본적으로 달라요
• Team은 다관점 리뷰·경쟁 가설 디버깅처럼 독립적 탐색이 가치 있는 작업에 적합해요
• 서브에이전트는 강결합 리팩터링·단순 분배처럼 메인 세션이 통제해야 하는 작업에 적합해요
• Team은 "단일 세션보다 훨씬 더 많은 토큰"을 사용하므로 비용 민감도도 선택 기준이에요

이 글의 대상

• 서브에이전트를 써봤는데 Team과의 차이가 헷갈리는 분
• "내 작업에는 뭘 써야 하지?"라는 판단 기준이 필요한 분
• Claude Code 활용을 최적화해서 비용 대비 효율을 높이고 싶은 분

목차

1. 구조적 차이 한눈에 보기
2. 차이 1: 독립 컨텍스트
3. 차이 2: 직접 메시징
4. 차이 3: 공유 Task list와 자율 할당
5. 상황별 선택 가이드
6. 비용 관점에서의 판단

1. 구조적 차이 한눈에 보기

서브에이전트와 Team은 "누가 컨텍스트를 갖느냐"에서부터 갈려요.

먼저 전체 비교표를 보고 나서 하나씩 파고들어 볼게요.

비교 항목	서브에이전트(Subagent)	Team(Agent Teams)
컨텍스트	메인 세션의 컨텍스트 일부 상속	완전 독립 컨텍스트 윈도우
커뮤니케이션	메인에게 결과 보고만 가능	팀원 간 직접 메시지 교환 가능
작업 관리	메인이 직접 할당·관리	공유 Task list에서 자율 선택
비용	상대적으로 적음	단일 세션보다 훨씬 더 많은 토큰 사용
적합한 작업	분배 후 취합하면 되는 작업	독립적 탐색·상호 검증이 필요한 작업

이 표만 보면 "그냥 Team이 상위 호환 아닌가?" 싶을 수 있는데, 꼭 그렇지는 않아요. 각각의 차이가 왜 중요한지 살펴볼게요.

2. 차이 1: 독립 컨텍스트

Team의 팀원은 완전히 독립된 컨텍스트 윈도우를 가져요. 리더의 대화 히스토리가 전달되지 않아요.

서브에이전트는 메인 세션이 "이 코드의 성능을 분석해줘"라고 시키면, 메인이 지금까지 대화한 맥락을 어느 정도 알고 있는 상태에서 작업해요. 반면 Team의 팀원은 리더가 보내는 작업 지시만 받아요. 이전에 어떤 대화가 오갔는지 전혀 몰라요.

이게 장점이 되는 상황이 있어요:

• 편향 없는 독립 분석 — 리더가 "아마 이게 원인일 거야"라고 추측한 맥락이 팀원에게 전달되지 않으니, 팀원은 선입견 없이 분석할 수 있어요
• 컨텍스트 윈도우 절약 — 각 팀원이 자기 작업에 필요한 정보만 컨텍스트에 담으니까, 긴 대화 히스토리 때문에 윈도우가 차는 일이 없어요

반대로 단점도 있어요. 배경 설명이 필요한 작업이면 리더가 매번 상황을 다시 설명해야 하는 오버헤드가 생기거든요.

3. 차이 2: 직접 메시징

Team의 팀원들은 서로 직접 메시지를 주고받을 수 있어요. 서브에이전트는 메인에게만 보고할 수 있고요.

Team에는 메일박스 시스템이 있어서 두 가지 소통 방식을 지원해요:

메시징 방식	설명	사용 예시
message	특정 팀원에게 1:1 전달	"A야, 네가 찾은 쿼리 결과 좀 알려줘"
broadcast	전체 팀원에게 동시 전달	"전원 주목, 기준이 바뀌었어"

서브에이전트 구조에서는 이게 안 돼요. 서브에이전트 A가 발견한 걸 서브에이전트 B에게 알려주려면, 먼저 A가 메인에게 보고하고, 메인이 다시 B에게 전달해야 해요. 중간 단계가 하나 더 생기는 거죠.

이 차이가 빛나는 순간은 팀원 간 협력이 필요한 작업이에요. 예를 들어 팀원 A가 프론트엔드를 담당하고 팀원 B가 백엔드를 담당할 때, A가 "이 API 응답 형식이 이렇게 바뀌면 좋겠어"라고 B에게 직접 요청할 수 있어요.

4. 차이 3: 공유 Task list와 자율 할당

Team은 공유 Task list를 통해 팀원이 스스로 작업을 가져가는 자율 구조(self-claim)예요.

서브에이전트는 메인이 "너는 이거 해"라고 명시적으로 할당하는 구조예요. 반면 Team의 Task list는 이런 식으로 운영돼요:

1. 리더가 작업들을 Task list에 등록하고 상태를 pending으로 설정해요
2. 팀원들이 자기가 할 수 있는 작업을 골라서 in-progress로 바꾸고 수행해요
3. 완료되면 completed로 변경하고 다음 작업을 가져가요

여기에 종속성(dependency) 관리도 돼요. "작업 C는 작업 A와 B가 둘 다 끝나야 시작 가능"이런 식으로 설정할 수 있어요.

이 구조의 장점은 유연성이에요. 팀원마다 작업 속도가 다를 수 있는데, 빨리 끝난 팀원이 알아서 다음 작업을 가져가니까 놀고 있는 시간이 줄어들어요.

5. 상황별 선택 가이드

작업의 성격에 따라 최적의 선택이 달라져요.

Team이 유리한 경우

상황	왜 Team인가
동일 코드 다관점 리뷰	보안·성능·테스트를 독립 컨텍스트에서 동시 리뷰
경쟁 가설 디버깅	가설별로 팀원을 배정해 병렬 검증
교차 계층 변경	프론트/백/인프라 담당이 직접 소통하며 동시 작업
기술 비교 조사	각 기술별 전담 조사 후 리더가 종합

서브에이전트/단일 세션이 유리한 경우

상황	왜 Team이 아닌가
강결합 리팩터링	파일 간 연쇄 변경이라 독립 작업이 어려워요
비용에 민감한 작업	Team은 토큰을 훨씬 더 많이 써요
단순 요약·번역	한 세션이면 충분한 단순 작업이에요
순차 파이프라인	앞 단계 결과가 뒷 단계 입력인 구조에요

빠른 판단 체크리스트

작업을 앞에 두고 이 질문들에 답해 보세요:

1. 결과물이 독립적으로 분리 가능한가? → Yes면 Team 후보
2. 다른 관점이 가치를 만드는가? → Yes면 Team 강력 추천
3. 팀원 간 소통이 필요한가? → Yes면 Team, No면 서브에이전트도 OK
4. 비용보다 품질이 우선인가? → No면 서브에이전트나 단일 세션

6. 비용 관점에서의 판단

Team은 "단일 세션보다 훨씬 더 많은 토큰"을 사용한다는 걸 반드시 고려해야 해요.

공식 문서에서도 이 점을 명확히 언급하고 있어요. 각 팀원이 독립된 컨텍스트 윈도우를 가지니까, 같은 작업이라도 Team으로 하면 토큰 소모가 N배에 가까워져요. 여기에 팀원 간 메시지 교환, 리더의 조율 작업까지 더해지면 단일 세션 대비 상당한 비용 차이가 생겨요.

그래서 권장하는 접근법은 이래요:

• 단순하거나 비용 민감한 작업 → 단일 세션 또는 서브에이전트
• 품질·깊이가 중요한 고가치 작업 → Team
• 처음 써보는 거라면 → 작은 작업으로 먼저 테스트해서 비용 감각을 잡아 보기

핵심 정리

1. 서브에이전트 vs Team의 핵심 차이: 독립 컨텍스트, 직접 메시징, 공유 Task list
2. Team 팀원은 리더의 대화 히스토리를 물려받지 않아 편향 없는 분석 가능
3. 메일박스(message/broadcast)로 팀원 간 직접 소통 가능
4. Task list의 self-claim 구조로 팀원이 자율적으로 작업을 가져감
5. Team은 토큰 사용량이 훨씬 많으므로 비용 대비 가치를 따져야 함

FAQ

Q. 서브에이전트로 하던 작업을 Team으로 바꾸면 무조건 더 좋아지나요?

A. 아니에요. 서브에이전트로 충분한 작업을 Team으로 바꾸면 비용만 늘고 효과는 비슷할 수 있어요. Team은 "독립적 관점"과 "팀원 간 소통"이 가치를 만드는 작업에서만 진짜 차이가 나요.

Q. Team 팀원끼리 파일을 직접 공유할 수 있나요?

A. 메시지로 내용을 전달할 수는 있지만, 파일 시스템 자체는 공유해요. 같은 프로젝트 디렉토리에서 작업하니까 파일 자체는 서로 접근 가능해요. 다만 같은 파일을 동시에 수정하면 충돌이 생길 수 있어서 Task list의 file-locking 기능이 있는 거예요.

Q. broadcast를 자주 써도 괜찮나요?

A. 공식 문서에서는 broadcast를 "드물게" 사용하라고 권장해요. 모든 팀원에게 메시지가 가니까 각 팀원의 컨텍스트 윈도우를 소모하고, 그만큼 비용도 증가하거든요. 정말 전원이 알아야 하는 중요한 변경 사항에만 쓰는 게 좋아요.

Q. 서브에이전트와 Team을 동시에 쓸 수 있나요?

A. Team의 팀원은 중첩 팀을 만들 수 없지만, 팀원 내부에서 서브에이전트를 활용하는 건 별도의 영역이에요. 다만 구조가 복잡해지면 관리가 어려워지니까, 보통은 하나의 방식을 선택해서 쓰는 게 깔끔해요.

Q. Team의 비용이 구체적으로 얼마나 더 드나요?

A. 정확한 배수는 작업 특성에 따라 달라지지만, 팀원 수만큼 독립 세션이 돌아가니까 기본적으로 (1 + 팀원 수) 배에 가까운 토큰을 사용한다고 보면 돼요. 여기에 조율 오버헤드까지 더하면 단일 세션의 3~6배 정도 나올 수 있어요.

Q. 어떤 작업부터 Team을 시도해보면 좋을까요?

A. 코드 리뷰가 가장 좋은 시작점이에요. 같은 PR을 보안/성능/테스트 관점에서 동시에 리뷰하면 Team의 가치를 바로 체감할 수 있거든요. 결과물이 명확히 분리되고, 다관점이 실질적 가치를 만드는 대표적인 사례예요.

참고 자료 (References)

데이터 출처

출처	설명	링크
Agent Teams 공식 문서 (KO)	한국어 공식 가이드	Agent Teams KO
Agent Teams 공식 문서 (EN)	영문 공식 가이드	Agent Teams EN
Costs 공식 문서	비용 관련 공식 가이드	Costs

핵심 인용

"단일 세션보다 훨씬 더 많은 토큰을 사용"
— Agent Teams 공식 문서 (비용 관련)

다음 편 예고

[3편] 핵심 구성요소 완벽 해설 — 리더, 팀원, Task list, 메일박스

• 리더와 팀원의 역할·제약 조건 상세 해설
• Task list 상태 관리와 종속성 설정법
• 메일박스, 표시 모드, Delegate 모드, Plan approval까지