Claude Code Agent Teams - 멀티 에이전트 협업

개요

Claude Code의 Agent Teams는 여러 Claude Code 인스턴스를 조율하여 협업하는 기능. Opus 4.6과 함께 2026년 2월 출시된 연구 프리뷰 기능.

핵심 개념

구조

• 팀 리드: 작업 조율, 할당, 결과 종합
• 팀원들: 각자 독립적인 컨텍스트 윈도우에서 작업
• 직접 소통: 팀원들이 서로 직접 소통 가능
• 사용자도 팀 리드 거치지 않고 개별 팀원과 직접 상호작용 가능

Subagent vs Agent Teams

Subagent	Agent Teams
단일 세션 내 실행	별도 세션으로 실행
메인 에이전트에게만 보고	서로 직접 소통
빠른 집중 작업용	발견 공유, 상호 도전, 자체 조율

최적 사용 사례

• 연구/리뷰: 여러 팀원이 문제의 다른 측면을 동시 조사
• 새 모듈/기능: 각 팀원이 별도 파트 담당
• 디버깅: 다른 가설을 병렬로 테스트
• 크로스레이어 조율: 프론트엔드, 백엔드, 테스트 각각 담당

사용법

1. CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS를 settings.json이나 환경변수에 추가
2. 병렬 작업이 유리한 태스크에서 에이전트 팀 요청
3. Shift+Up/Down 또는 tmux로 개별 팀원 직접 제어 가능

실제 사례

16개 에이전트로 Rust 기반 C 컴파일러 제작:

• 2,000회 세션, $20,000 API 비용
• 10만 줄 컴파일러 생성
• x86, ARM, RISC-V에서 Linux 6.9 빌드 가능

제한사항

• 세션 재개 불가
• 중첩 팀 불가
• 아직 연구 프리뷰 단계