개요
Claude Code의 Agent Teams는 여러 Claude Code 인스턴스를 조율하여 협업하는 기능. Opus 4.6과 함께 2026년 2월 출시된 연구 프리뷰 기능.
핵심 개념
구조
- 팀 리드: 작업 조율, 할당, 결과 종합
- 팀원들: 각자 독립적인 컨텍스트 윈도우에서 작업
- 직접 소통: 팀원들이 서로 직접 소통 가능
- 사용자도 팀 리드 거치지 않고 개별 팀원과 직접 상호작용 가능
Subagent vs Agent Teams
| Subagent | Agent Teams |
|---|---|
| 단일 세션 내 실행 | 별도 세션으로 실행 |
| 메인 에이전트에게만 보고 | 서로 직접 소통 |
| 빠른 집중 작업용 | 발견 공유, 상호 도전, 자체 조율 |
최적 사용 사례
- 연구/리뷰: 여러 팀원이 문제의 다른 측면을 동시 조사
- 새 모듈/기능: 각 팀원이 별도 파트 담당
- 디버깅: 다른 가설을 병렬로 테스트
- 크로스레이어 조율: 프론트엔드, 백엔드, 테스트 각각 담당
사용법
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS를 settings.json이나 환경변수에 추가- 병렬 작업이 유리한 태스크에서 에이전트 팀 요청
Shift+Up/Down또는 tmux로 개별 팀원 직접 제어 가능
실제 사례
16개 에이전트로 Rust 기반 C 컴파일러 제작:
- 2,000회 세션, $20,000 API 비용
- 10만 줄 컴파일러 생성
- x86, ARM, RISC-V에서 Linux 6.9 빌드 가능
제한사항
- 세션 재개 불가
- 중첩 팀 불가
- 아직 연구 프리뷰 단계