복잡한 작업을 AI 에이전트에게 맡겼는데 60% 정도 진행하다 멈춰버린 경험, 있으신가요? 컨텍스트가 길어질수록 집중력이 흐려지고, 2단계 세부사항이 5단계와 뒤섞이면서 결국 /clear로 다시 시작하게 되죠.

Anthropic이 Claude Code에 에이전트 팀 기능을 추가했습니다. 단일 에이전트가 순차적으로 작업하는 대신, 리드 에이전트가 여러 팀원에게 작업을 위임하고 각 팀원이 독립적으로 병렬 작업하면서 서로 소통하는 구조죠. 커뮤니티에서는 이를 ‘스웜(swarm)’이라 부릅니다.

출처: Claude Code Swarms – AddyOsmani.com

왜 에이전트 팀인가?

단일 에이전트 모델의 실패 패턴은 명확합니다. 인증 시스템을 세 개 서비스에 걸쳐 리팩토링하라고 하면 60% 정도까지는 진행하다가 컨텍스트가 붕괴되죠. 이는 단순히 토큰 한계 문제가 아닙니다. LLM은 컨텍스트에 정보가 많을수록 지금 중요한 것에 집중하기 어려워합니다. 프로젝트 매니저의 전략 노트가 CSS 버그 수정 컨텍스트에 섞여 있으면 오히려 성능이 떨어지는 거죠.

인간 팀도 비슷하게 작동합니다. 백엔드 엔지니어를 프론트엔드 코드 리뷰에 앉히지 않고, 전사 슬랙 스레드에 모두를 참조하지 않습니다. 전문화는 집중에 관한 것입니다.

멀티 에이전트 패턴은 이를 공식화합니다. 각 에이전트에게 좁은 범위와 깨끗한 컨텍스트를 주면 각 도메인 내에서 더 나은 추론이 가능하고, 독립적인 품질 검증이 이뤄지며, 단계 간 자연스러운 체크포인트가 생깁니다. 테스트 에이전트는 테스트만 컨텍스트에 담고, 3시간짜리 기획 논의는 담지 않습니다.

에이전트 팀은 어떻게 작동하나?

구조는 단순합니다. 하나의 Claude Code 세션이 팀 리드가 되고, 여러 팀원을 생성합니다. 각 팀원은 완전히 독립적인 Claude Code 인스턴스로, 자신만의 큰 토큰 컨텍스트 창을 갖습니다.

핵심 구성 요소는 세 가지입니다. 의존성 추적이 가능한 공유 태스크 리스트, 에이전트 간 직접 메시징을 위한 메일박스 시스템, 그리고 팀원들이 작업을 마치면 스스로 다음 작업을 선택하는 자율 작업 할당 방식입니다.

기존 서브에이전트와의 차이가 여기 있습니다. 서브에이전트는 집중된 작업을 수행하고 결과만 부모에게 보고하는 구조입니다. 서로 대화할 수 없죠. 에이전트 팀은 실제 협업입니다. 팀원들이 발견한 내용을 공유하고, 서로의 접근법에 이의를 제기하고, 독립적으로 조율합니다. 대신 각 팀원이 별도의 Claude 인스턴스이기 때문에 토큰 비용이 더 듭니다.

실제로 어떻게 사용하나?

설정 파일에서 실험 기능을 활성화한 후, 자연어로 원하는 팀을 요청하면 됩니다. “개발자가 코드베이스 전체에서 TODO 코멘트를 추적하도록 돕는 CLI 도구를 설계하고 있어. 서로 다른 각도에서 이를 탐색할 에이전트 팀을 만들어줘. 한 팀원은 UX, 한 팀원은 기술 아키텍처, 한 팀원은 반대 입장을 맡아서.” 리드가 팀을 구성하고, 각 관점에 맞는 팀원을 생성하고, 작업을 조율합니다.

팀원들은 리드의 터미널에 목록으로 표시되고, 각자 무엇을 하고 있는지 볼 수 있습니다. 개별 팀원에게 직접 메시지를 보낼 수도 있고, 팀원의 세션으로 들어가서 진행 상황을 확인할 수도 있죠. 작업이 끝나면 리드에게 팀 정리를 요청하면 됩니다.

어떤 경우에 효과적인가?

병렬 탐색이 실제 가치를 더하는 작업에서 빛을 발합니다.

경쟁 가설 디버깅이 대표적입니다. 앱이 메시지 하나 보낸 후 종료되는데 원인을 모를 때, 다섯 명의 팀원이 각각 다른 이론을 조사하게 하고 서로의 이론을 반박하도록 만드는 거죠. 과학 토론처럼요. 순차 조사는 앵커링 문제가 있습니다. 하나의 이론을 탐색하면 이후 조사가 그쪽으로 편향되거든요. 여러 독립 조사자가 적대적 토론을 벌이면 근본 원인에 훨씬 빠르게 수렴합니다.

크로스레이어 기능 작업도 잘 맞습니다. 프론트엔드, 백엔드, 테스트에 걸친 변경 사항을 각각 다른 팀원이 담당하는 거죠. 한 에이전트가 레이어 간 컨텍스트를 전환하는 대신, 세 에이전트가 자신의 도메인에 완전히 집중하면서 병렬로 작업합니다.

반대로 순차 작업이나 같은 파일을 여러 팀원이 편집해야 하는 경우, 의존성이 많은 작업에는 비효율적입니다. 두 팀원이 같은 파일을 편집하면 덮어쓰기가 발생하고, 조율 오버헤드가 실제 작업보다 커질 수 있습니다.

멀티 에이전트 조율이 현실이 되다

멀티 에이전트 조율 패턴이 실험적 해킹에서 프로덕션 기능으로 구현됐다는 게 핵심입니다. 개발자들이 Claude Code 바이너리의 피처 플래그를 발견하고 서브에이전트와 bash 스크립트로 우회 방법을 만들던 것이 이제 정식 기능이 됐죠.

이는 개발 생산성의 시간 압축을 의미합니다. 며칠 걸리던 순차 작업이 몇 시간의 병렬 실행으로 압축되는 거죠. 하지만 주의할 점도 있습니다. 병렬로 작동하는 에이전트를 보면 활동 지표가 인상적입니다. 시간당 커밋 수, 병렬 태스크 완료, 수정한 코드 라인 수 같은 것들이요. 그러나 활동이 항상 가치로 이어지는 건 아닙니다.

멀티 에이전트 시스템의 위험은 코드를 매우 빠르게 대량 생산하기 쉽다는 점입니다. 그 코드는 여전히 정확하고, 유지보수 가능하고, 실제 문제를 해결해야 합니다. 오케스트레이션 패턴을 설정하는 데 시간을 쓰느라 정작 무엇을 만들어야 하는지 생각하는 시간을 잃는 경우도 봤습니다. 도구가 아니라 문제가 접근법을 이끌어야 합니다.

참고자료:

• Orchestrate teams of Claude Code sessions – Claude Code Docs