Agent Teams 소개
Agent Teams는 Claude Code에서 여러 개의 독립적인 세션(Teammates)을 하나의 팀으로 구성하여 작업을 병렬로 수행하고 조율하는 새로운 오케스트레이션 기능입니다. 기존의 단일 에이전트 방식이 순차적으로 작업을 처리했다면, Agent Teams는 팀 리드(Team Lead) 가 전체 작업을 관리하고 여러 팀원(Teammates)들이 각자의 컨텍스트 창(Context Window)을 가지고 동시에 작업을 수행합니다.
Agent Teams 기능은 복잡한 엔지니어링 문제를 해결하기 위해 고안되었습니다. 예를 들어, 대규모 리팩토링이나 새로운 기능 구현 시 프론트엔드와 백엔드를 동시에 수정해야 하거나, 버그의 원인을 찾기 위해 서로 다른 가설을 동시에 검증해야 할 때 유용합니다. 사용자는 자연어로 팀을 구성하고 작업을 지시할 수 있으며, 팀원들은 공유된 작업 목록(Task List)을 통해 스스로 업무를 할당받고, 필요 시 서로 직접 메시지를 주고받으며 협업합니다.
현재 이 기능은 실험적(Experimental) 기능으로 제공되며, 사용하려면 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 환경 변수를 활성화해야 합니다. 단순한 코딩 보조를 넘어, 실제 개발 팀처럼 소통하고 협력하는 AI 에이전트의 가능성을 보여주는 중요한 진화 단계라고 할 수 있습니다.
Agent Teams vs. Subagents 비교
기존 Claude Code에서도 작업을 병렬화하기 위한 Subagents 기능이 존재했지만, Agent Teams와는 작동 방식과 목적에서 명확한 차이가 있습니다. 가장 큰 차이점은 에이전트 간의 (수평적) 소통과 자율성입니다.
| 특징 | Subagents | Agent Teams |
|---|---|---|
| 컨텍스트 | 자체 컨텍스트를 가지지만, 결과는 메인 에이전트에게 요약되어 반환됨 | 각 팀원이 완전히 독립적인 전체 컨텍스트 창을 유지함 |
| 커뮤니케이션 | 메인 에이전트에게만 보고 (단방향/수직적) | 팀원끼리 직접 메시지 교환 가능 (양방향/수평적) |
| 조정(Coordination) | 메인 에이전트가 모든 세부 작업을 관리 | 공유 작업 목록(Task List)을 통해 팀원들이 자율적으로 작업 수행 |
| 적합한 작업 | 결과물만 중요한 명확하고 좁은 범위의 작업 | 토론, 협업, 상호 검증이 필요한 복잡한 프로젝트 |
| 비용(Token) | 상대적으로 낮음 (결과만 메인 컨텍스트에 병합) | 높음 (각 팀원이 별도의 Claude 인스턴스로 실행) |
즉, Subagents는 빠르고 집중된 작업(예: 특정 함수 테스트)에 적합한 반면, Agent Teams는 팀원 간에 "내 생각은 다른데?"라며 서로의 가설을 검증하거나, 프론트엔드 담당과 백엔드 담당이 API 명세를 조율하는 등 더 복잡하고 상호작용이 필요한 시나리오에 최적화되어 있습니다.
Agent Teams 주요 특징
아키텍처 및 구성 요소
Agent Teams는 다음과 같은 역할과 시스템으로 구성됩니다.
-
Team Lead (팀 리드): 사용자와 소통하며 팀을 생성하고, 팀원을 스폰(Spawn)하며, 전체적인 진행 상황을 조율하는 메인 세션입니다.
-
Teammates (팀원): 리드에 의해 생성된 독립적인 Claude Code 인스턴스들입니다. 각자 별도의 터미널 프로세스처럼 동작합니다.
-
Task List (작업 목록): 모든 에이전트가 접근 가능한 공유 리스트입니다. 팀원들은 이 목록에서 자신이 처리할 수 있는 작업을 스스로 가져가서(Claim) 수행합니다. 작업 중에는 파일 잠금(File Locking)을 통해 중복 작업을 방지합니다.
-
Mailbox (메시징 시스템): 에이전트 간에 직접 메시지를 주고받을 수 있는 통신 채널입니다.
팀 관리 및 디스플레이 모드
팀원들은 사용자의 터미널 환경에 따라 두 가지 모드로 표시될 수 있습니다:
-
In-process 모드: 하나의 터미널 창에서
Shift+Up/Down키를 사용해 각 팀원의 세션을 전환하며 모니터링합니다. 별도의 설정 없이 바로 사용 가능합니다. -
Split-pane 모드:
tmux나iTerm2를 사용하는 경우, 화면을 분할하여 모든 팀원의 작업 상황을 한눈에 볼 수 있습니다. 각 패널을 클릭하여 특정 팀원에게 직접 개입하거나 명령을 내릴 수도 있습니다.
Agent Teams의 주요 사용 사례 (Use Cases)
-
연구 및 리뷰 (Research and Review): 여러 팀원이 문제의 서로 다른 측면을 조사하고, 서로의 발견을 공유하거나 반박하는 '과학적 토론' 방식을 통해 더 정확한 결론에 도달할 수 있습니다.
-
교차 레이어 조정 (Cross-layer Coordination): 프론트엔드, 백엔드, 테스트 코드를 각각 담당하는 팀원을 두어, 한 쪽의 변경 사항이 다른 쪽에 미치는 영향을 실시간으로 소통하며 개발할 수 있습니다.
-
경쟁 가설 디버깅: 버그의 원인이 불명확할 때, 각 팀원에게 서로 다른 가설을 검증하도록 지시하여 순차적으로 접근할 때보다 빠르게 원인을 파악할 수 있습니다.
Agent Teams에 대한 개발자 커뮤니티의 반응
Reddit과 Hacker News 등 개발자 커뮤니티에서는 해당 기능에 대해 다양한 반응을 보이고 있습니다.
-
긍정적 반응: "마법과 같다(Just magic)", "워크플로우가 획기적으로 개선되었다"는 평가가 많습니다. 특히 Anthropic이 이 기능을 사용해 리눅스 커널을 컴파일하는 C 컴파일러를 구축했다는 사례가 화제가 되었습니다.
-
비용 및 성능 우려: 각 팀원이 독립된 인스턴스로 돌아가기 때문에 토큰 소모량이 막대하다는 지적이 있습니다. 또한, 같은 파일을 여러 에이전트가 동시에 수정하려 할 때 발생하는 충돌 문제나, 리드 에이전트가 위임하지 않고 직접 일하려는 경향 등이 초기 단점으로 꼽힙니다.
Agent Teams 기능을 사용해 본 사용자는 마치 중간 관리자(Middle Manager)가 된 것 같은 기분을 느낀다는 반응이나, 에이전트끼리 서로 코드를 리뷰하며 "Gemini가 짠 코드보다 낫다"며 논쟁하는 듯한 상황을 묘사하는 글들도 눈에 띕니다.
Agent Teams 공식 문서
Agent Teams 기능을 활용한 C 컴파일러 구축 사례
Claude Opus 4.6 출시 관련 내용 정리
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 