Claude Agent Team
21 Jun 2026
|
claude
Agent Team
여러 개의 Calude Instance가 동시에 실행하면서 서로 팀을 이루어 메시지를 서로 교환하면서 작업을 수행하는 방식
Sub-Agent vs Agent Team
| 항목 |
Sub-Agent |
Agent Team |
| 컨텍스트 |
자체 컨텍스트, 결과를 호출자에게 리턴 |
자체 컨텍스트, 독립적 실행 |
| 통신 |
Main Agent에만 결과 전달 |
각 팀원들간 메시지 교환 |
| 조율 |
Main Agent가 전체 조율 |
공유 Task List로 자율적으로 조율 |
| 적합한 작업 |
결과만 중요한 집중 작업 |
토론과 협업이 필요한 복잡한 작업 |
| 토큰 소모량 |
낮음 |
높음 |
구성요소
| 구성요소 |
설명 |
| Team Lead |
팀 생성, 팀원 생성, 작업 조율하는 메인 세션 |
| Teammates |
할당된 작업을 수행하는 별도 Calude Code 인스턴스 |
| Task List |
팀원들간 요청 및 완료하는 공유 작업 목록 |
| Mailbox |
에이전트간 통신 시스템 |
적합한 사례
| 사례 |
설명 |
| 리서치 & 리뷰 |
여러 팀원들이 서로 다른 관점에서 조사 |
| 새 모듈/기능 개발 |
각자 다른 부분을 소유하면서 개발 |
| 경쟁 가설 디버깅 |
여러 이론들을 병렬적으로 테스트, 서로 반박하면서 수렴 |
| Cross-Layer 조율 |
프론트/백엔드/테스트를 각각 담당 |
비적합 사례
- 순차 작업
- 같은 파일 수정
- 의존성이 많은 작업
Best Practices
- 충분한 컨텍스트 제공: 팀원은 리더의 대화 히스토리를 상속받지 않음
- 적절한 Task 크기: 너무 작으면 오버헤드 낭비, 너무 크면 확인 없이 오래 진행
- 팀원당 5~6개의 Task가 적당함
- 파일 충돌 방지
- 모니터링: 방치하면 낭비 위험 증가
제약사항
/resume, /rewind로 in-process 팀원 복원 불가- Task 상태 업데이트 지연 가능
- 완료가 느릴 수 있음
- 세션당 1개의 팀만 가능
- 중첩 팀 불가
- 리더 변경 불가
예시
에이전트 팀을 구성해서 개발해줘.
첫번째, 주식 분석 전문가야. 각 기업별 기술적으로 차트를 분석하고, 주가와 기업의 가치를 전문적으로 비교하고 분석하고 현재 투자할만한지, 주식을 판매해야 할 지 의견을 말해줄거야.
두번째, 백엔드 개발 전문가야. 백엔드로 현재 주가와 가치를 크롤링하고 프론트엔드에 정보를 제공하는 REST API를 개발할거야. 주로 기업 정보(기업 이름, 매출, 순이익, 주가, 주식 상승/하락 정보 등)와 주식 매매 의견 정보, 그리고 매수해야 할 주식 Top 5, 매도해야 할 주식 Top 5 등의 정보를 REST API로 제공해.
세번째, 프론트엔드 개발 전문가야. 백엔드에서 제공하는 API를 이용해서
코스피 상위 100개 기업의 리스트를 보여주고, 클릭하면 기업 정보와 주가 차트 정보, 그리고 매수 또는 매도, 유지 의견 정보를 보여줄거야.
또한 매수할 주식 Top5, 매도할 주식 Top5 등의 대시보드도 보여줄거야.
각 에이전드들끼리 협업해서, 백엔드/프로트엔드 개발 프로젝트를 진행해줘. 개발하다가 질문이 생기면 각 에이전트에게 협업하면서 조사하고, 계획 수정하고 검토해줘. 그래서 프로젝트를 완성해줘.
