클로드 코드의 에이전트 팀에 대한 간략한 요약: 리드 세션은 여러 개의 독립적인 팀원 세션을 시작하여 병렬 협업을 지원합니다. 에이전트 팀은 공유 작업 목록과 메시징 시스템을 통해 자체적으로 구성되므로 복잡한 작업에 대한 토론, 탐색 및 협업에 더욱 적합합니다. 주요 기능은 다음과 같습니다. - 서브에이전트와의 차이점: 서브에이전트는 리드 에이전트가 작업을 할당하고 서브에이전트는 결과만 보고하는 방식입니다. 반면 에이전트 팀은 여러 팀원이 직접 소통하고, 작업 목록을 공유하고, 직접 작업을 할당받을 수 있어 토론과 협업이 필요한 복잡한 작업에 더욱 적합합니다. - 활성화 방법: 기본적으로 비활성화되어 있으며, 환경 변수 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`을 설정해야 합니다(이 변수는 `settings.json`에서 구성 가능). - 시작 방법: 자연어를 사용하여 클로드 코드에게 팀을 생성하도록 요청하고 원하는 팀 구조(역할/구성원 수/업무 분담)를 설명하세요. 팀 생성 후 공유 작업 목록이 생성됩니다. 리더는 집계 및 완료를 담당하며, 각 팀원과 직접 소통할 수 있습니다. - 프레젠테이션 모드: 두 가지 UI 모드 - 인프로세스: 모든 팀원이 동일한 터미널에서 실행되며, Shift+Up/Down 키를 눌러 동시 메시지 모드를 전환할 수 있습니다. - 분할 창: 각 팀원은 자신만의 창을 사용합니다(tmux 또는 iTerm2 + it2 CLI/Python API 필요). 기본값은 자동입니다. - 팀원 및 모델 지정: Claude는 팀원 수를 자동으로 지정하거나, "4명의 팀원이 병렬로 리팩토링"과 같이 명시적으로 요구하고 각 팀원이 사용할 모델을 지정할 수 있습니다. - 계획 승인: 팀원은 리더의 승인 및 코딩 시작 전에 읽기 전용 모드로 계획을 제출해야 합니다. 승인 기준은 프롬프트에 지정할 수 있습니다(예: 테스트 포함). - 위임 모드: 리더가 직접 코드를 작성하지 않고 오케스트레이션만 수행할 수 있도록 합니다(Shift+Tab으로 전환). 리더를 순수 오케스트레이션 담당자로 활용하려는 시나리오에 적합합니다. - 작업 할당 및 선점: 공유 작업 목록은 대기 중/진행 중/완료된 작업과 그 종속성을 지원합니다. 리더는 작업을 할당할 수 있으며, 팀원도 직접 작업을 수락할 수 있습니다. 파일 잠금 기능을 통해 여러 사람이 동일한 작업을 두고 경쟁하는 것을 방지합니다. - 종료 및 정리: 리더는 팀원에게 작업 종료를 요청할 수 있습니다. 작업 완료 후 리더는 정리 작업을 수행할 수 있습니다(활성 팀원을 확인하여 리소스 잔여/불일치를 방지). - 로컬 저장소 및 아키텍처: 팀 구성 및 작업 목록은 로컬에 저장됩니다(예: `~/.claude/teams/{team}/config.json`, `~/.claude/tasks/{team}/`). 메시지 전달 및 유휴 알림을 위한 사서함이 제공됩니다. - 토큰 비용: 팀 규모로 작업할 경우 토큰 사용량이 크게 증가합니다(각 팀원의 독립적인 컨텍스트 사용). 이는 연구/검토/새로운 기능 개발에 적합하며, 일일 단위로 간단한 작업을 수행하는 것이 세션당 비용 효율성이 더 높습니다. - 사용 팁 및 문제 해결: "충분한 컨텍스트 제공, 적절한 작업 분할, 파일 충돌 방지, 지속적인 모니터링 및 안내"의 중요성을 강조하고, 흔히 발생하는 문제(팀원 미참여, 과도한 권한 요청, 리더의 작업 조기 종료, tmux 파일 오류 등)를 나열합니다.

개인적인 의견: 아직은 상당히 미성숙한 느낌입니다. 특히 충분한 지침과 지속적인 모니터링이 필요한 상황에서는 더욱 그렇습니다. 이러한 조건을 충족할 수 있다면 에이전트 팀 대신 서브 에이전트만 사용해도 충분히 작업을 수행할 수 있을 것 같습니다. 이 아키텍처의 장점은 아직 명확하지 않습니다. 가장 큰 장점은 일반적인 멀티 에이전트 방식보다 토큰 소모가 적다는 점일지도 모르겠습니다.