Agent Teams
여러 Claude Code 인스턴스가 팀으로 협업해서 복잡한 작업을 처리해요.
Agent Teams란?
Agent Teams는 여러 Claude Code 인스턴스를 팀으로 구성해서 협업하는 기능이에요. 팀 리더가 작업을 분배하고, 팀원들이 독립적으로 작업하면서 서로 직접 메시지를 주고받을 수 있어요.
실험적 기능: 기본 비활성화. 설정에서 활성화해야 사용할 수 있어요.
병렬 작업
여러 팀원이 각각 다른 모듈을 동시에 작업해요.
직접 소통
팀원 간 직접 메시지를 주고받을 수 있어요.
공유 태스크 리스트
모든 팀원이 작업 상태를 공유해요.
팀 리더
메인 세션이 작업을 조율하고 결과를 종합해요.
서브에이전트 vs Agent Teams
| 항목 | 서브에이전트 | Agent Teams |
|---|---|---|
| 컨텍스트 | 결과만 메인에 반환 | 완전 독립 |
| 소통 | 메인 에이전트에만 보고 | 팀원끼리 직접 소통 |
| 조율 | 메인이 모든 작업 관리 | 공유 태스크 리스트로 자율 조율 |
| 적합한 상황 | 결과만 필요한 집중 작업 | 토론과 협업이 필요한 복잡한 작업 |
| 토큰 비용 | 낮음 | 높음 (각 팀원이 별도 인스턴스) |
활성화 방법
settings.json에 환경 변수를 추가하세요.
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}사용법
팀 생성
Claude에게 팀을 만들고 작업 구조를 설명하세요.
에이전트 팀을 만들어줘. UX 담당 1명, 기술 아키텍처 담당 1명, 테스트 담당 1명으로 구성해줘.팀원과 대화
- In-process 모드: Shift+Down으로 팀원 전환, 입력 후 Enter
- Split-pane 모드: tmux/iTerm2 패널 클릭
- Ctrl+T: 태스크 리스트 확인
디스플레이 모드 선택
| 모드 | 설명 |
|---|---|
| In-process | 모든 팀원이 메인 터미널에서 실행 (Shift+Down 전환) |
| Split panes | 각 팀원이 별도 패널 (tmux/iTerm2 필요) |
활용 예시
병렬 코드 리뷰: 보안, 성능, 테스트 커버리지를 각각 다른 팀원이 동시에 검토
경쟁 가설 디버깅: 5명의 팀원이 각각 다른 가설을 테스트하고 서로 토론
크로스 레이어: 프론트엔드, 백엔드, 테스트를 각각 담당하는 팀원이 동시에 작업
모범 사례
- 팀원에게 충분한 컨텍스트를 제공하세요
- 3~5명으로 시작하세요
- 팀원당 5~6개 작업이 적절해요
- 팀원들이 서로 다른 파일을 작업하도록 분배하세요
- 리서치와 리뷰부터 시작하고, 그 다음 구현을 맡기세요
- 종료 전 팀 리더로 cleanup하세요
제한사항
- 세션당 하나의 팀만 가능
- In-process 팀원은 세션 재개 불가
- 중첩 팀 불가 (팀 안에 팀)
- 팀 리더는 변경 불가
- Split panes는 tmux 또는 iTerm2 필요
- 토큰 사용량이 단일 세션보다 훨씬 높아요