Agent Teams란? Claude Code의 Research Preview 기능으로, 여러 Claude Code 세션이 병렬로 협업하며 공유 작업 목록·메일박스·팀 리드로 조율됩니다. 2026년 2월 Anthropic이 공식 문서(code.claude.com/docs)에 발표했으며, Subagent와 달리 팀원 간 직접 메시징이 가능합니다.
왜 다들 “에이전트 팀” 얘기하는지 궁금하지 않으셨어요?
저도 Cursor랑 Claude Code 쓰면서 Subagent는 알았는데, Agent Teams는 뭔가 다른 거라고 들었거든요. 뭔지 궁금해서 공식 문서랑 몇 개 글 읽어봤고, 제 경험으로 정리해봤습니다.
5분이면 개념부터 첫 팀 만들기까지 끝낼 수 있습니다. 저는 초보자 눈높이로 정리해볼게요.
Agent Teams가 뭔데? Subagent랑 뭐가 달라?
Subagent vs Agent Teams 차이
구분 Subagent Agent Teams 구조 메인 에이전트 → 서브에이전트 여러 세션이 동등한 팀원 통신 서브는 메인에만 보고 팀원 간 직접 메시징 가능 토큰 비용 상대적으로 낮음 단일 세션 대비 약 2배 (각 팀원 독립 컨텍스트) 적합한 작업 결과만 필요할 때 토론·협업·병렬 가설 검증 필요할 때
Subagent는 “메인한테 일 시키고, 서브들이 각자 돌아서 결과만 가져오는” 구조예요. Agent Teams는 여러 Claude가 팀으로 모여서 서로 대화하면서 일하는 거예요.
이거 왜 중요한지 아세요? 병렬로 다른 가설을 검증하거나, 리뷰어 3명이 각각 보안·성능·테스트 관점에서 돌아야 할 때 유리해요.
어떻게 켜나? 복붙 가능한 설정
Agent Teams는 실험 기능이라 기본 비활성화예요. 아래 중 하나만 하면 됩니다.
방법 1: 셸 프로필에 추가 (가장 간단)
.zshrc 또는 .bashrc에 한 줄 추가:
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
저장 후 source ~/.zshrc (또는 .bashrc) 실행하고 Claude Code 다시 띄우면 돼요.
방법 2: settings.json (VS Code/Cursor 연동 시)
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
방법 3: 한 번만 켜고 실행
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude
Claude Code 2.1.32 이상이어야 해요. 2026년 2월 5일 릴리스된 버전입니다.
첫 팀 만들어보기 — 뭐라고 말하면 되나?
팀은 슬래시 명령이 아니라 자연어로 만듭니다. 예를 들어:
“PR 리뷰를 3명이 나눠서 해줘. 한 명은 보안, 한 명은 성능, 한 명은 테스트 커버리지 관점으로.”
이렇게 말하면 Claude가 자동으로 팀원 3명을 만들고, 각자 할 일을 나눠요.
공식 문서 권장:
- 팀 크기: 3–5명
- 팀원당 태스크: 5–6개
- 초보자 첫 시도: 리뷰·리서치·버그 조사처럼 코드 작성 없는 작업부터
코드 짜는 건 나중에 하고, “이 3개 가설 병렬로 검증해줘” 같은 걸로 시작하는 게 부담이 적어요.
팀 구성요소는 Team Lead, Teammates, Task List, Mailbox 네 가지예요. Lead가 작업 나누고, 팀원들이 메일박스로 소통하는 구조입니다. [[260212 코드 짜는 시대는 끝났다 에이전트 오케스트레이션 직접 해보고 느낀 점]]에서 말한 Planner-Worker-Judge랑 같은 패러다임이에요.
언제 쓰고, 언제 안 쓰는 게 좋을까?
| 권장 시나리오 | 비권장 시나리오 |
|---|---|
| 크로스레이어 조율 (프론트·백엔드 동시) | 순차 작업 (A 끝나고 B) |
| 경쟁 가설 디버깅 (가설 3개 병렬 검증) | 동일 파일 여러 명이 편집 |
| 신규 모듈/기능 개발 | 의존성 많은 작업 (단일 세션이 효율적) |
| 리서치·리뷰 (코드 작성 없음) | 단순 요청 1개 |
토큰 비용이 단일 세션·Subagent보다 상당히 높다는 걸 알아두세요. 복잡한 병렬 작업에만 쓰는 게 이득입니다.
내가 느낀 점
저는 에이전트 오케스트레이션을 [[260212 코드 짜는 시대는 끝났다 에이전트 오케스트레이션 직접 해보고 느낀 점|직접 해보고]] Planner-Worker-Judge 구조로 팀을 돌려봤는데, Agent Teams는 그걸 Claude Code 안에서 바로 쓰게 해주는 거더라고요.
제가 수동으로 에이전트 4명 만들어서 블로그 팀 돌리던 게, 이제는 “팀 만들어줘” 한 마디로 되는 시대가 온 거예요.
솔직한 마음 — 비용·제한 꼭 알고 쓰자
Research Preview라 프로덕션 전면 사용은 아직 조심하는 게 좋아요. 토큰 비용도 Subagent 대비 약 2배라고 하니, 저는 “이 작업은 병렬이 진짜 이득인가?” 한 번 생각해보고 켜는 걸 추천해요.
Opus 4.6 가격(2026년 2월 기준): $5/$25 per million input/output, 200K 초과 시 $10/$37.50. 팀원 5명이면 그만큼 곱해서 들어갑니다.
앞으로 할 것들
- 리뷰·리서치부터 팀 3명으로 돌려보기
- 토큰 사용량 체크하면서 언제 팀이 이득인지 패턴 정리
- [[260212 코드 짜는 시대는 끝났다 에이전트 오케스트레이션 직접 해보고 느낀 점|에이전트 오케스트레이션]] 글에서 썼던 Planner-Worker-Judge와 Agent Teams 구조 비교해보기
FAQ (자주 묻는 질문)
Q: Agent Teams 가격은 얼마인가요?
A: Opus 4.6 기준 입력 $5/백만, 출력 $25/백만 토큰입니다. 팀원 수만큼 컨텍스트가 따로 쓰이므로 단일 세션 대비 2배 이상 나올 수 있어요.
Q: Subagent랑 Agent Teams 뭘 써야 하나요?
A: 결과만 필요하고 순차 작업이면 Subagent. 토론·협업·병렬 가설 검증이 필요하면 Agent Teams가 맞아요.
Q: Cursor Subagent랑 같은 건가요?
A: 아니에요. Cursor는 8에이전트 병렬·앙상블 방식이고, Claude Code Agent Teams는 Lead-Teammate-Task 구조로, 제품이 다릅니다.
Q: 초보자가 처음 해볼 만한 작업은?
A: PR 리뷰 3관점(보안·성능·테스트) 분리, 버그 가설 병렬 검증, 리서치 요약 등 코드 작성 없는 작업부터 추천해요.
Q: 팀원 수 제한이 있나요?
A: 공식 권장은 3–5명이고, 팀원당 5–6개 태스크입니다. 너무 많으면 조율 오버헤드와 토큰 비용이 급증하므로 작게 시작하세요.
참고 자료
- Claude Code Agent Teams 공식 문서
- Claude Opus 4.6 공식 발표
- [[260212 코드 짜는 시대는 끝났다 에이전트 오케스트레이션 직접 해보고 느낀 점]] — 에이전트 팀 구조 이론편