클로드 코드의 최신 기능인 에이전트 팀은 여러 AI 에이전트가 서로 소통하며 병렬로 협력할 수 있게 해주는 기능으로, 기존 서브 에이전트 방식의 핵심 한계인 “에이전트 간 소통 불가” 문제를 해결합니다. 이 영상은 에이전트 팀이 기본 모드·서브 에이전트와 어떻게 다른지를 설명하고, 터미널 멀티플렉서인 티맥스를 활용해 로컬 머신에서 에이전트 팀을 실제로 설정·운영하는 과정을 단계별로 보여줍니다.
세 가지 모드의 차이: 기본 모드, 서브 에이전트, 에이전트 팀
클로드 코드에는 작업 처리 방식에 따라 세 가지 모드가 있습니다.
기본 모드는 하나의 에이전트가 하나의 컨텍스트 윈도우를 사용합니다. UI 컴포넌트 작성, 서버 사이드 함수, 매칭 알고리즘 구현, 테스트 작성처럼 여러 작업을 순차적으로 처리합니다. 문제는 컨텍스트가 길어질수록 정확도가 떨어진다는 점입니다.
서브 에이전트는 이 문제를 해결하려는 시도입니다. 메인 컨텍스트 윈도우가 오케스트레이터 역할을 하며, 각 작업을 개별 서브 에이전트에게 분배합니다. 에이전트마다 컨텍스트가 줄어드니 정확도가 올라갑니다. 그러나 서브 에이전트들 사이에 소통이 없다는 치명적인 한계가 있습니다. 예를 들어, 프론트엔드 에이전트가 정의한 데이터 타입과 백엔드 에이전트가 정의한 데이터 타입이 서로 달라도, 서로 모르기 때문에 최종 실행 시 타입 오류가 발생합니다.
에이전트 팀은 이 소통 문제를 해결합니다. 팀 리더가 여러 서브 에이전트를 생성하고, 각 에이전트가 서로 직접 소통할 수 있습니다. 백엔드 에이전트가 작업을 마치면 생성한 타입 정보를 프론트엔드 에이전트에게 전달하여 정합성을 맞추는 식입니다.
에이전트 팀 설정 방법
설정은 세 단계로 구성됩니다.
첫째, 클로드 코드를 최신 버전으로 업데이트합니다. 터미널에서 claude update 명령을 실행하면 됩니다.
둘째, 티맥스를 설치합니다. 맥 환경에서는 brew install tmux로 설치할 수 있습니다. 티맥스는 하나의 터미널 창 안에서 여러 패널을 나눠 각 에이전트와 개별적으로 소통할 수 있게 해주는 도구입니다. 에이전트 팀은 두 가지 디스플레이 모드를 지원합니다. 하나는 단일 터미널 세션에서 Shift+위아래 방향키로 에이전트를 전환하는 인 프로그레스 모드, 다른 하나는 분할 패널로 모든 에이전트 출력을 동시에 보는 티맥스 모드입니다.
셋째, 클로드 코드에서 에이전트 팀 모드와 티맥스 분할 패널을 활성화하는 명령을 루트 디렉터리에서 실행합니다.
에이전트 팀 실전 운영: 직접 은행 연동 리서치 사례
영상은 장부 관리 애플리케이션에 은행 계좌 직접 연동 기능을 추가할지 판단하기 위한 리서치 프로젝트를 실제 사례로 보여줍니다.
에이전트 팀을 시작하는 방법은 간단합니다. 별도의 슬래시 명령 없이, 프롬프트에 “에이전트 팀을 만들어라” 또는 “팀을 만들어라”는 키워드를 넣으면 자동으로 에이전트 팀 모드가 활성화됩니다.
이 사례에서는 네 개의 에이전트를 구성했습니다.
- 에이전트 1 (비즈니스·제품): 웹 검색으로 경쟁사 분석, 시장 적합성, 사용자 경험 영향 분석 담당
- 에이전트 2 (재무·비용): 각 서비스 제공자의 비용 분석 및 비용 전망 테이블 작성 담당
- 에이전트 3 (기술 아키텍처): 오퍼스 모델을 별도 지정. 특정 서비스 제공자에 종속되지 않도록 리포지터리 패턴과 유사한 추상화 레이어를 설계
- 에이전트 4 (데빌 애드버킷): 에이전트 1~3의 결과물을 검토하고 가정에 도전하는 범용 에이전트
에이전트들이 작업을 마치면 오케스트레이터가 결과를 취합해 최종 보고서를 작성합니다. 실제 결과물에는 도입 권장 여부, 서비스 제공자 추천, 비용 분석, 기술 아키텍처, 위험 요소, 구현 단계 등이 포함됩니다.
클로드 스킬로 전환하여 재사용하기
한 번 성공적으로 실행한 에이전트 팀 세션을 스킬로 저장해두면 매번 긴 프롬프트를 작성하지 않고도 재사용할 수 있습니다.
방법은 세션이 끝난 뒤 “이 대화를 바탕으로 나중에 재사용할 수 있는 스킬을 만들어줘”라고 요청하는 것입니다. 이렇게 만든 스킬은 /research-team처럼 슬래시 커맨드로 실행할 수 있으며, 지라 티켓 번호나 리서치 주제만 파라미터로 넘기면 됩니다.
실전 가이드
에이전트 팀을 처음 사용해보려는 분이라면 다음 순서를 따라 해볼 수 있습니다.
- 클로드 코드 업데이트:
claude update명령 한 줄이면 충분합니다. 구버전에서는 에이전트 팀 기능이 없을 수 있으므로 반드시 선행해야 합니다. - 티맥스 설치:
brew install tmux를 실행합니다. 설치 후 클로드 코드 설정에서 에이전트 팀 모드와 티맥스 분할 패널 옵션을 활성화합니다. - 티맥스 세션 시작: 프로젝트 디렉터리로 이동한 뒤 클로드를 실행합니다. 패널이 분할된 터미널 화면이 나타나면 준비 완료입니다.
- 에이전트 팀 요청: 프롬프트에 “에이전트 팀을 만들어라” 키워드를 포함하고, 각 에이전트의 역할, 사용할 서브 에이전트 타입, 필요한 경우 모델을 지정합니다. 에이전트 간 소통이 필요한 에이전트에는 “다른 에이전트와 직접 소통할 수 있다”고 명시해야 합니다.
- 스킬로 저장: 성공적인 세션이 끝나면 바로 스킬로 저장해두세요. “이 대화를 바탕으로 재사용 가능한 스킬을 만들어줘”라고 요청하면 됩니다.
비판적 검토
이 영상은 에이전트 팀과 서브 에이전트의 차이를 데이터 타입 불일치 문제라는 구체적인 사례로 명확하게 설명한 점이 인상적입니다. 추상화 레이어를 통한 서비스 제공자 교체 가능성처럼, 단순 소개를 넘어 실무 설계 원칙까지 다루는 깊이도 돋보입니다.
다만 에이전트 팀을 활성화하는 실제 명령어와 티맥스 설정 명령어는 커뮤니티 가입을 통해서만 얻을 수 있다고 언급합니다. 또한 에이전트 팀을 사용할 때 발생하는 API 비용이나 컨텍스트 사용량 증가에 대한 설명은 없습니다. 실제 프로젝트에 적용하기 전에 비용 구조를 별도로 확인해볼 필요가 있습니다.
에이전트 팀은 복잡한 리서치나 병렬 개발처럼 여러 전문 영역이 동시에 필요한 작업에서 특히 강점을 발휘하지만, 단순한 단일 작업에는 오히려 설정 오버헤드가 클 수 있습니다.
핵심 요점
- 에이전트 팀의 핵심 가치는 “에이전트 간 직접 소통”이다. 서브 에이전트도 병렬 처리가 가능하지만, 에이전트끼리 결과를 공유할 수 없어 타입 불일치 같은 오류가 발생한다. 에이전트 팀은 이 소통 채널을 열어준다.
- 티맥스는 에이전트 팀의 필수 인프라다. 분할 패널로 여러 에이전트의 출력을 동시에 볼 수 있고, Ctrl+B 단축키로 각 에이전트와 개별 소통이 가능하다.
- 에이전트 팀은 별도 명령 없이 키워드만으로 트리거된다. 프롬프트에 “에이전트 팀을 만들어라” 또는 “팀을 만들어라”를 넣으면 자동으로 활성화된다.
- 복잡한 에이전트에는 오퍼스 모델을 개별 지정할 수 있다. 에이전트마다 다른 모델을 할당할 수 있어 비용과 성능을 최적화할 수 있다.
- 성공한 세션은 즉시 스킬로 저장해 재사용하라. 다음부터는 슬래시 커맨드 하나로 동일한 팀 구성을 자동으로 재현할 수 있다.