클로드 코드의 서브 에이전트만으로는 해결하기 어려운 복잡한 협업 작업이 있습니다. 이 영상은 클로드 코드의 에이전트 팀 기능이 무엇인지, 기존 서브 에이전트와 어떻게 다른지를 실제 데모와 함께 단계별로 설명합니다.
이 영상은 짐코딩 채널에서 클로드 코드를 주제로 제작한 콘텐츠입니다. 클로드 코드 완벽 마스터 강의 수강생 3,000명 돌파를 기념한 대규모 업데이트의 일환으로, 에이전트 팀이라는 신기능을 실습 중심으로 소개합니다.
서브 에이전트와 에이전트 팀의 차이
영상은 회사 조직 비유로 두 방식의 차이를 명확하게 설명합니다.
서브 에이전트는 각자 독립적으로 일하고 결과 요약만 메인 컨텍스트에 돌려주는 방식입니다. 커피 프랜차이즈 시장 보고서를 예로 들면, 서울, 부산, 대구, 광주 각 지역 조사를 팀원 네 명에게 나눠 맡기는 것처럼 서로 소통 없이 결과만 받으면 끝나는 구조입니다.
반면 에이전트 팀은 팀원끼리 직접 소통하면서 협업하는 방식입니다. 직장인 점심 도시락 배달 서비스 기획안을 만들 때처럼, 예산 담당 팀원이 시장 조사 담당 팀원에게 시장 규모를 직접 물어봐야 하는 경우에 적합합니다.
서브 에이전트의 세 가지 한계
영상에서는 서브 에이전트가 복잡한 작업에서 가지는 구조적 한계를 세 가지로 정리합니다.
첫째, 병렬로 실행한 서브 에이전트끼리 직접 대화가 불가능합니다. 프론트엔드 개발자 A가 API 스펙 문제를 발견해도 옆에 있는 백엔드 개발자 B에게 직접 말을 못 하고 메인을 통해 우회해야 합니다.
둘째, 결과 요약만 메인 컨텍스트에 돌아오기 때문에 중간에 발견한 미묘한 단서들이 사라집니다. 서브 에이전트가 파일 50개를 분석하면서 “이상한 패턴이 있는데 당장 문제는 아니네”라고 넘어간 정보는 나중에 다시 꺼낼 수 없습니다.
셋째, 메인 에이전트 혼자 모든 서브 에이전트를 관리하므로 서브 에이전트가 늘어날수록 메인 컨텍스트가 조율 작업으로 빠르게 소진됩니다.
에이전트 팀의 네 가지 특징
영상은 공식 문서를 기반으로 에이전트 팀의 차별점을 네 가지로 설명합니다.
컨텍스트: 각 팀원이 자기만의 독립된 컨텍스트를 유지합니다. 서브 에이전트와 달리 중간에 스쳐 지나간 정보도 팀원의 컨텍스트에 남아 있어, 나중에 “아까 그 파일 다시 봐봐”라고 요청할 수 있습니다.
소통: 보안 담당 팀원이 성능 담당 팀원에게 “이거 한번 봐봐”라고 메시지를 직접 보낼 수 있습니다. 메인을 거치지 않고 팀원 간 직접 소통이 가능합니다.
조율: 공유된 테스크 리스트를 통해 팀원이 자기 작업이 끝나면 다음 테스크를 스스로 가져갑니다. 매번 팀장이 지시하지 않아도 효율적으로 일이 진행됩니다.
비용: 팀원 수만큼 독립된 클로드 세션을 사용하므로 비용이 높아집니다. 팀원이 세 명이면 대략 세 배 이상의 토큰이 사용됩니다.
핵심 용어 다섯 가지
- 팀 리드: 팀을 만든 클로드 코드 세션이 팀장 역할을 합니다. 한 번 정해지면 변경 불가합니다.
- 팀메이트: 리드가 만든 추가 클로드 코드 세션으로, 각자 독립된 컨텍스트를 가집니다.
- 스폰: 새로운 팀원 세션을 생성하는 것을 의미합니다.
- 테스크 리스트: 모든 팀원이 공유하는 작업 목록입니다. 각 작업은 대기 중, 진행 중, 완료됨 세 단계로 관리됩니다.
- 메일박스: 팀원끼리 메시지를 주고받는 시스템으로, 팀 리드와 팀원 사이, 팀원과 팀원 사이 모두 소통이 가능합니다.
에이전트 팀 활성화 방법
에이전트 팀은 실험적 단계라 기본적으로 비활성화되어 있습니다. settings.json 파일에서 환경 변수를 1로 설정해야 합니다. 활성화 후에는 클로드에게 자연어로 팀 구성을 요청하면 됩니다. 예를 들어 “현재 Next.js 프로젝트에서 세 명의 팀원을 만들어서 각각 보안, 성능, 스타일을 리뷰해 달라”고 요청하면 팀이 생성되고 테스크 리스트가 자동으로 작성됩니다.
에이전트 팀을 써야 할 타이밍
서브 에이전트를 여러 개 병렬로 돌리다가 다음 상황이 발생하면 에이전트 팀이 더 적합합니다.
- 메인 컨텍스트가 조율 작업으로 빠르게 소진될 때
- 서브 에이전트끼리 정보를 직접 공유해야 할 때
- 중간 과정의 맥락을 나중에 다시 참조해야 할 때
핵심 요점
- 서브 에이전트 vs 에이전트 팀: 서브 에이전트는 결과만 보고하는 프리랜서, 에이전트 팀은 서로 대화하며 협업하는 팀입니다.
- 에이전트 팀이 필요한 순간: 서브 에이전트끼리 정보를 직접 공유해야 하거나, 메인 컨텍스트가 조율 부담으로 소진될 때입니다.
- 테스크 리스트의 힘: 공유된 테스크 리스트 덕분에 팀원이 자기 작업이 끝나면 다음 작업을 스스로 가져갑니다.
- 비용 트레이드오프: 에이전트 팀은 팀원 수만큼 독립 세션을 사용하므로 비용이 높습니다.
- 디스플레이 모드: 윈도우 사용자는 인프로그레스 모드, macOS/리눅스 사용자는 tmux 또는 iTerm2로 분할 창 모드를 사용할 수 있습니다.