[AI 자동화] 클로드 코드 에이전트 팀즈, 여러 AI의 병렬 협업 정리
클로드 코드에 새롭게 추가된 에이전트 팀즈(Agent Teams)는 여러 AI가 각자 역할을 맡아 동시에 일을 처리하도록 설계된 기능입니다. 설정 절차부터 서브 에이전트와 무엇이 구별되는지까지 핵심만 짚어 정리합니다.
에이전트 팀즈란 무엇인가
에이전트 팀즈는 단일 AI가 처음부터 끝까지 모든 일을 떠안는 방식에서 벗어나, 복수의 AI가 업무를 분담해 함께 진행하도록 구성한 기능입니다.
앞서 나온 서브 에이전트가 메인 에이전트를 중심으로 모든 흐름이 모이는 중앙 집중형이었다면, 에이전트 팀즈는 하나의 작업 목록을 팀 전체가 공유하며 분산해서 처리하는 방식에 가깝습니다.
작업 분배는 Team-Lead가 맡고, 팀원들은 나뉜 업무를 병렬로 소화한 뒤 진행 결과를 요약해 보고합니다. 업무를 나누고 여러 작업을 한꺼번에 돌려야 하는 협업 환경에 잘 맞는 기능입니다.
에이전트 팀즈 설정과 실행 방법
에이전트 팀즈는 Max 요금제에서만 이용할 수 있습니다. Max 요금제 계정이 마련되었다면 다음으로 환경 변수를 지정해야 합니다.
기능을 적용할 레퍼지토리의 환경 변수 파일을 열어 아래 코드를 추가합니다.
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}설정을 마친 뒤 터미널에서 클로드 코드를 구동하고 명령을 넣으면 팀이 실제로 만들어지는 과정을 볼 수 있습니다. 이어서 Team-Lead가 태스크 목록을 짜고 업무를 잘게 나눠 팀원들에게 배분하는 순서로 흐름이 이어집니다.
Team-Lead는 팀장 역할을 하며 정리된 태스크를 팀원 각각에게 배정합니다. 이 영역에서는 어떤 팀원이 무슨 작업을 진행하고 있는지 실시간으로 파악됩니다.
팀 구조도에서 원하는 팀원을 클릭하면 그 팀원의 현재 상태와 지금까지의 작업 내역을 자세히 살펴볼 수 있습니다. 예시로 제시한 화면은 styler reviewer 팀원의 진행 기록입니다.
진행 현황을 요청하면 Team-Lead가 전체 상황을 정리해 알려줍니다.
완료된 태스크, 현재 각자 담당하는 작업, 아직 남아 있는 업무를 한눈에 파악할 수 있어 실제 조직이 돌아가는 방식과 유사합니다.
분할창 모드로 병렬 작업 확인하기
에이전트 팀 구조는 기본 화면에서도 살펴볼 수 있습니다.
여러 팀원이 동시에 움직이는 모습을 한 화면에서 보고 싶다면 분할 창 모드를 활용하면 됩니다.
이 모드는 기본 Windows 터미널에서 곧바로 실행되지 않고 리눅스 환경에서만 정상 작동합니다. 따라서 Windows 환경에서는 WSL을 우선 설치하고, 그 위에 터미널 분할 도구인 tmux를 올린 다음 tmux 안에서 claude를 실행하는 순서로 확인합니다.
실행한 뒤 테스트 명령을 입력하면 기존과 동일한 화면이 나타나고, 명령이 진행되며 팀원들이 각자 태스크를 받을 때마다 오른쪽에 패널이 하나씩 추가됩니다. 팀원마다 작업이 실시간으로 굴러가는 모습을 직접 확인할 수 있습니다.
작업을 끝낸 팀원은 Team-Lead에게 결과를 보고한 뒤 승인이 떨어질 때까지 대기 상태를 유지합니다.
에이전트 팀즈와 서브 에이전트의 차이
두 방식 모두 여러 에이전트를 동원한다는 점에서 처음에는 비슷하게 느껴지지만, 근본적인 구조는 다릅니다.
Sub Agent
- 모든 것이 중앙으로 모이는 구조
- 메인 에이전트가 서브 에이전트를 불러 일을 맡기고 결과만 회수
- 서브 에이전트끼리 직접 대화 불가, 소통은 메인 에이전트를 경유
- 컨텍스트는 정돈되지만 조율 부담이 메인에 집중
Agent Teams
- 업무를 분산해 협업하는 구조
- 공유된 태스크 목록을 토대로 동시에 작업
- 팀원끼리 직접 메시지 교환 가능
- 독립 세션을 유지하며 남은 일감을 스스로 처리
두 방식의 두드러진 차이를 표로 정리하면 다음과 같습니다.
| 구분 | Sub Agent | Agent Teams |
|---|---|---|
| 구조 | 중앙집중형 | 분산 협업형 |
| 작업 흐름 | 메인이 위임 → 결과만 보고 | 태스크 공유 후 병렬 진행 |
| 에이전트 간 소통 | 불가능 (항상 메인을 거침) | 가능 (직접 메시지 교환) |
| 컨텍스트 관리 | 메인 중심으로 깔끔하게 유지 | 각 팀원 독립 세션 유지 |
| 확장 시 특징 | 메인에 부담 집중 가능 | 역할 분담으로 병렬 확장 |
요약하면 서브 에이전트는 "일손을 하나 더 붙이는" 개념에 가깝고, 에이전트 팀즈는 "팀 자체를 꾸리는" 개념에 가깝습니다.
에이전트 팀즈 활용 시 참고할 점
병렬 처리 작업의 시각화는 에이전트 팀즈의 가장 큰 장점입니다.
과거 멀티 에이전트에 작업을 맡겼을 때는 실제로 병렬 처리가 이뤄지더라도 그 과정이 화면에 드러나지 않아, 결과가 나올 때까지 기다리는 형태에 머물렀습니다. 반면 에이전트 팀즈에서는 분할 창을 통해 여러 팀원이 동시에 작업하는 장면이 그대로 노출됩니다. 각 팀원이 맡은 태스크와 개별적으로 움직이는 흐름이 눈에 보이므로, 여러 세션이 한꺼번에 돌아가고 있다는 사실이 한결 뚜렷하게 체감됩니다.
팀원마다 독립된 세션으로 작동하는 만큼 토큰 소모량 역시 그에 비례해 증가합니다. 팀원이 3명이면 토큰 사용량도 3배로 늘어나는 셈입니다.
시험 삼아 다뤄보기에는 매우 흥미로운 기능이지만, 실제 업무에 본격 도입하려면 토큰 사용량 여유도 함께 점검해 두는 편이 좋습니다.
