클로드 코드를 10배 스마트하게: Agent Teams 완전 정복
📺 원본 영상: 오늘 나온 따끈 따끈한 클로드 코드를 10배 스마트하게 만드는법! Claude Code Teams
🎙️ 채널: 코드팩토리
📅 정리 일자: 2026-02-07
⚠️ Note: 본 리포트는 영상의 음성을 텍스트로 변환(STT)하여 정리한 것입니다. 화면에 표시된 자료(차트, 코드, 슬라이드 등)는 포함되지 않을 수 있습니다.
개요
Anthropic이 Opus 4.6 출시와 함께 공식 발표한 Claude Code의 Agent Teams 기능은 단순한 모델 업데이트를 넘어서는 패러다임 전환이다. 이 기능은 하나의 메인 Claude Code 인스턴스가 여러 개의 완전히 독립적인 Claude Code 인스턴스를 생성하고 조율할 수 있게 해준다. 기존의 서브 에이전트(Sub-agent)가 하나의 세션 내에서 작업 결과만 보고하던 방식과 달리, Agent Teams는 각 팀원이 독립적인 컨텍스트 윈도를 가지고 실시간으로 서로 메시지를 주고받으며 협업한다. 본 강연에서는 이 혁신적인 기능의 작동 원리, 설정 방법, 그리고 실전 활용 사례를 상세히 다룬다.
Agent Teams의 작동 원리 - 오케스트레이션의 새로운 차원
Agent Teams는 메인 Claude Code 인스턴스가 지휘자(Orchestrator) 역할을 수행하는 구조다. 왼쪽의 메인 인스턴스는 작업을 분석하고 필요한 팀원들을 생성한 뒤, 각자에게 역할을 부여한다. 그러면 오른쪽에 독립적으로 생성된 Claude Code 인스턴스들이 각자 부여받은 작업을 동시에 수행하기 시작한다. 이는 단순히 작업을 나눠서 처리하는 것을 넘어, 각 팀원이 서로의 진행 상황을 공유하고 필요에 따라 직접 커뮤니케이션하며 작업을 조율할 수 있다는 점에서 기존 서브 에이전트와 근본적으로 다르다.
강연자는 이 기능이 Opus 4.6 모델 자체보다 훨씬 더 큰 업데이트라고 강조했다. 왜냐하면 이는 AI 개발 도구의 작업 방식 자체를 바꾸는 구조적 혁신이기 때문이다. 기존에는 하나의 AI가 순차적으로 작업을 처리하거나, 서브 에이전트를 통해 제한적으로 병렬 처리를 했다면, 이제는 마치 실제 개발팀처럼 여러 개발자가 동시에 다른 부분을 작업하고 결과를 통합하는 방식으로 발전한 것이다.
서브 에이전트와 Agent Teams - 무엇이 다른가
컨텍스트와 독립성의 차이
서브 에이전트는 메인 에이전트의 컨텍스트 윈도 내에서 작동하며, 작업이 완료되면 결과만 호출자에게 반환한다. 반면 Agent Teams의 각 팀원은 완전히 독립적인 컨텍스트 윈도를 가진다. 이는 각 팀원이 독자적으로 사고하고 판단할 수 있다는 의미다. 서브 에이전트가 메인 에이전트의 지시를 받아 실행하고 결과를 보고하는 “작업자”라면, Agent Teams의 팀원들은 독립적으로 판단하고 서로 협의하는 “협업자”에 가깝다.
통신 방식의 혁신
서브 에이전트는 메인 에이전트에게만 결과를 보고한다. 통신은 일방향이며, 작업이 시작되면 사용자가 개입할 수 없다. 하지만 Agent Teams에서는 팀원들이 서로 직접 메시지를 실시간으로 전송한다. 메인 에이전트는 이들의 커뮤니케이션을 조율하며, 사용자는 특정 팀원에게 직접 추가 작업을 지시할 수도 있다. 강연자는 이를 “서로 조율이 막 계속 일어난다”고 표현했는데, 이는 작업 중간에도 유연하게 방향을 조정할 수 있다는 의미다.
작업 관리와 공유 작업 목록
서브 에이전트 모드에서는 메인 에이전트가 모든 작업을 관리한다. 하지만 Agent Teams는 자체 조율을 통한 공유 작업 목록(Shared Work List)을 운영한다. 각 팀원이 작업을 업데이트하면, 이 정보가 실시간으로 다른 팀원들에게 공유된다. 메인 에이전트는 전체 진행 상황을 모니터링하며 필요시 작업을 재배분하거나 새로운 팀원을 추가할 수 있다. 이는 마치 실제 프로젝트 관리 도구에서 여러 개발자가 동시에 작업하는 것과 유사한 경험을 제공한다.
Agent Teams를 사용해야 하는 상황
병렬 탐색이 가치를 더하는 작업
Agent Teams는 병렬 탐색(Parallel Exploration)이 실질적인 가치를 더하는 작업에 가장 효과적이다. 강연자가 언급한 대표적인 사례는 “연구 및 검토(Research and Review)“다. 예를 들어, 하나의 Claude Code 세션에서 코드를 작성한 후, 완전히 새로운 세션에서 그 코드를 검토하도록 하는 패턴을 많은 개발자가 사용한다. 컨텍스트가 클리어된 상태에서 처음부터 다시 리뷰하면 문제를 더 쉽게 찾아낼 수 있기 때문이다. Agent Teams를 사용하면 이런 작업을 자동화할 수 있다. 메인 에이전트가 코드를 작성하는 동안, 별도의 팀원이 독립적으로 코드 리뷰를 수행하고, 또 다른 팀원이 테스트 코드를 작성하는 식으로 동시에 진행할 수 있다.
새로운 모듈 또는 기능 개발
각 팀원이 독립적인 부분을 소유하여 서로 간섭하지 않도록 하는 것이 중요한 작업에도 적합하다. 예를 들어, 프론트엔드와 백엔드를 동시에 개발하거나, 여러 개의 독립적인 컴포넌트를 병렬로 구현할 때 효과적이다. 강연자는 “각각의 레이어로 우리가 나눠가지고 작업을 시키고, 그 친구들이 작업한 결과들을 또다시 메인에서 싱크로나이즈 시켜가지고”라고 설명했다. 즉, 레이어별로 작업을 분리한 뒤, 메인 에이전트가 결과를 통합하고 다시 작업을 배분하는 사이클을 반복할 수 있다는 것이다.
교차 계층 조율과 경쟁 가설 디버깅
강연자가 “교차 계층 조율”과 “경쟁하는 가설로 디버깅”을 언급한 것은 특히 흥미롭다. 예를 들어, 하나의 버그에 대해 여러 가설을 동시에 검증하거나, 서로 다른 아키텍처 접근 방식을 병렬로 시도해볼 수 있다. 기존 방식에서는 하나씩 순차적으로 시도해야 했지만, Agent Teams를 사용하면 여러 접근법을 동시에 실험하고 가장 효과적인 것을 선택할 수 있다.
Agent Teams를 사용하지 말아야 하는 상황
순차적 작업과 동일 파일 편집
강연자는 공식 문서를 인용하며 “순차적 작업 그리고 동일 파일 편집 또는 많은 종속성이 있는 작업의 경우에는 단일 세션이나 서브 에이전트가 더 효과적입니다”라고 강조했다. 이는 두 가지 이유 때문이다. 첫째, 컨텍스트 연속성이다. 단일 세션에서 작업하면 이전 작업의 모든 컨텍스트가 유지되므로 정보가 더 정확하고 완전하다. 둘째, 파일 충돌 가능성이다. 여러 팀원이 동시에 같은 파일을 수정하면 충돌이 발생할 수 있다.
토큰 비용 - 훨씬 더 많이 소비된다
강연자가 가장 강조한 주의사항은 토큰 비용이다. 공식 문서에는 Agent Teams가 “단일 세션보다 훨씬 더 많은 토큰을 사용한다”고 명시되어 있다. 강연자는 이를 “그냥 더 많은 토큰이 아니라 훨씬 더 많은 토큰”이라고 재차 강조했다. 예를 들어, 4개의 에이전트를 동시에 실행하면 토큰 사용량이 4배가 된다. 병렬 실행의 속도 이점은 분명하지만, 비용도 비례해서 증가한다는 것을 명심해야 한다. 따라서 비싼 요금제를 사용하지 않는다면, 정말 병렬 처리가 필요한 작업에만 선택적으로 사용하는 것이 현명하다.
설정 방법 - settings.json과 환경 변수
필수 환경 변수 설정
Agent Teams를 활성화하려면 settings.json 파일에 두 가지 환경 변수를 추가해야 한다. 이 파일은 사용자 폴더 또는 프로젝트별로 접근할 수 있다. 강연자가 제시한 설정은 다음과 같다.
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
"TEAMMATE_MODE": "tmux"
}
}첫 번째 환경 변수 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS를 1로 설정하면 Agent Teams 기능이 활성화된다. 이는 현재 실험적(Experimental) 기능이기 때문에 명시적으로 활성화해야 한다. 두 번째 환경 변수 TEAMMATE_MODE는 팀원들이 어떻게 표시될지를 결정한다.
TEAMMATE_MODE - tmux vs in-progress
TEAMMATE_MODE에는 두 가지 옵션이 있다. in-progress 모드는 백그라운드 작업처럼 하나의 창 안에서 팀원들이 작업하는 것을 보여준다. 사용자는 Shift + 위/아래 키를 사용해 각 팀원 사이를 전환할 수 있다. 반면 tmux 모드는 팀원이 생성될 때마다 창을 새로 분할(Split Pane)해서 보여준다. 각 팀원의 작업을 동시에 시각적으로 확인할 수 있고, 특정 팀원에게 직접 명령을 입력할 수도 있다.
강연자는 tmux 모드를 강력하게 추천했다. 다른 도구들로도 시도해봤지만 잘 작동하지 않았으며, tmux가 macOS에서 가장 안정적으로 작동한다고 언급했다. Windows에서는 완벽하게 지원되지 않을 수 있지만, 기능 자체는 작동한다.
커맨드 라인 플래그로 일시적 활성화
settings.json에 설정을 추가하지 않고도 특정 세션에서만 Agent Teams를 사용할 수 있다. 커맨드 라인에서 다음과 같이 플래그를 추가하면 된다.
claude-code --dangerously-skip-permissions --teammate-mode=tmux강연자는 settings.json에 설정을 넣어도 때때로 작동하지 않는 경우가 있어서, 실행할 때마다 이런 식으로 플래그를 추가하고 있다고 밝혔다. 아직 베타 단계이기 때문에 발생하는 불안정성으로 보인다. 기존 세션을 이어서 보고 싶다면 추가로 다른 플래그를 함께 사용할 수도 있다.
tmux 설치와 실행
tmux란 무엇인가
tmux는 터미널 멀티플렉서(Terminal Multiplexer)로, 개발자들이 전통적으로 많이 사용해온 도구다. 하나의 터미널 세션 내에서 여러 개의 패널을 프로그래매틱하게(프로그램적으로) 생성하고 관리할 수 있다. Claude Code가 tmux를 선택한 이유는 바로 이 프로그래매틱한 제어 가능성 때문이다. AI가 자동으로 패널을 생성하고, 각 패널에서 독립적인 Claude Code 인스턴스를 실행하며, 사용자에게 시각적으로 보여줄 수 있다.
설치와 실행 방법
tmux는 각 운영체제별로 설치 방법이 다르다. 공식 문서나 웹 검색을 통해 설치한 후, 터미널에서 tmux라고 입력하면 실행된다. 실행되면 화면 아래에 초록색 바가 나타나며, 일반 터미널과 비슷하지만 독특한 인터페이스가 표시된다. 강연자는 “어떤 터미널을 사용해도 상관없다”고 언급했다. VS Code의 터미널, Cursor의 터미널, 또는 일반 터미널 어디서든 tmux를 실행할 수 있다.
tmux 세션 내에서 Claude Code를 실행하면, Agent Teams가 활성화될 때 자동으로 화면이 분할되며 각 팀원이 독립적인 패널에 표시된다. 사용자는 여러 팀원의 작업을 동시에 모니터링하고, 필요시 특정 팀원에게 직접 명령을 입력할 수 있다.
실전 활용 - 개발자 블로그 프로젝트 예제
계획 단계 - Agent Teams를 고려한 프롬프트 작성
강연자는 실제 사례로 개발자 블로그 프로젝트를 시연했다. 중요한 것은 Agent Teams를 효과적으로 트리거하는 프롬프트를 작성하는 것이다. 단순히 “팀으로 구성해서 작업해줘”라고 하면 서브 에이전트를 만드는 경우가 많았다고 한다. 강연자가 여러 번 시도한 끝에 찾은 효과적인 프롬프트 패턴은 다음과 같다.
개발자 블로그를 만들 거야. [기술 스택 설명]
어떤 작업들을 병렬로 실행할 수 있는지, 그리고 팀메이트는 어떻게 구성해야 하는지 계획해줘.
다음 링크에서 Agent Teams 문서를 확인하고 적합하게 계획해줘: [공식 문서 링크]
핵심은 세 가지다. 첫째, 병렬 실행 가능성을 명시적으로 언급한다. 둘째, 팀메이트 구성을 요청한다. 셋째, 공식 문서 링크를 제공한다. 이 기능이 너무 새롭기 때문에, 문서 링크를 직접 제공하면 Claude Code가 올바른 방식으로 팀을 구성할 확률이 훨씬 높아진다. 강연자는 “항상 확률의 게임”이라며, 당분간은 링크를 넣어주는 게 좋다고 조언했다.
플랜 생성과 팀 구성
Claude Code는 이 프롬프트를 받으면 플랜을 작성한다. 강연자의 예시에서는 Next.js 초기화와 같은 초기 설정은 팀 리드(메인 에이전트)가 담당하고, 이후 병렬 작업 가능한 부분들을 식별했다. 구체적으로 Layout Engineer, Blog Engineer, Content Stylist 세 명의 팀원을 제안했고, 각자가 담당할 작업을 명확히 정의했다. 이 플랜이 마음에 들면 “계획대로 팀메이트들을 만들어서 구현해줘”라고 요청하면 된다.
실행 단계 - 오케스트레이션 과정
강연자는 팀 이름을 지정하는 것이 중요하다고 강조했다. 예시에서는 “블로그 크리에이터(Blog Creator)“라는 이름을 부여했다. 팀 이름은 나중에 작업을 재개하거나 참조할 때 사용된다. 실행이 시작되면 메인 에이전트가 먼저 Phase 1(초기 설정)을 완료한 후, 팀을 생성하고 작업 목록을 등록한다.
💡 [영상 참조] 강연자는 이 시점에서 화면의 작업 목록과 팀원 생성 과정을 보여주며 설명합니다. 상세 내용은 원본 영상을 확인하세요.
작업 목록(Task List)이 생성되면, 각 항목이 어떤 팀원에게 할당되었는지 표시된다. 메인 에이전트는 지속적으로 진행 상황을 모니터링하며, 팀원들이 보내는 메시지를 중계하고 리포트한다. 각 팀원은 독립적으로 작업을 수행하며, 필요시 서로 메시지를 주고받는다. 모든 작업이 완료되면 팀원들은 자동으로 종료(Dispose)되고, 결과는 팀 이름으로 저장된다.
tmux 분할 화면 vs in-progress 모드
강연자의 시연에서는 설정이 제대로 적용되지 않아 in-progress 모드로 실행되었다. 이는 베타 단계에서 발생할 수 있는 불안정성이다. in-progress 모드에서는 스크롤을 내려가며 각 팀원의 독립적인 화면을 확인해야 한다. 백그라운드 작업과 비슷해 보이지만, 완전히 독립적인 인스턴스라는 점이 다르다. 만약 특정 팀원에게 추가 작업을 지시하고 싶다면, 해당 팀원의 화면에서 직접 입력하면 된다. 이 요청은 메인 에이전트와 무관하게 독립적으로 처리된다.
반면 tmux 모드에서는 화면이 자동으로 분할되어 모든 팀원의 작업을 동시에 시각적으로 확인할 수 있다. 강연자는 “오히려 이 두 가지를 다 보여드리는 게 유용할 수도 있다”며, 두 모드의 차이를 설명했다.
Task List의 글로벌 동기화
강연자가 언급한 흥미로운 기능 중 하나는 Task List의 글로벌 동기화다. 이전에는 영상으로 다루지 않았지만, Task가 이제 글로벌하게 설정된다. 여러 개의 Claude Code를 실행했을 때, 특정 Task의 ID를 주입하면 팀메이트를 사용하지 않아도 서로 오케스트레이션되고 통신이 가능하다. 이는 Anthropic 팀이 애초에 이런 멀티 인스턴스 협업 기능을 염두에 두고 시스템을 설계했음을 보여준다. Agent Teams는 이를 메인 Claude Code에서 한 번에 오케스트레이션하는 기능을 추가한 것이다.
메인 에이전트는 공유된 Task List를 생성하고, 각 팀원이 작업을 업데이트할 때마다 이 목록이 실시간으로 갱신된다. 사용자는 메인 에이전트의 화면에서 전체 진행 상황을 한눈에 파악할 수 있으며, 어떤 에이전트가 어떤 메시지를 보냈는지도 확인할 수 있다. 필요하다면 메인 에이전트가 새로운 작업을 추가하고 팀원에게 할당할 수도 있다.
검증 스킬과 병렬 테스트 실행
강연자가 시연한 또 다른 사례는 검증(Verification) 작업이다. UI 검증, API 검증 등 여러 종류의 검증 스킬을 미리 만들어 놓았고, 이를 Agent Teams로 병렬 실행했다. “CREATE A TEAM WITH TEAMMATES: VERIFY UI, VERIFY API” 등의 명령을 내리면, 네 개의 에이전트가 동시에 생성되어 각자 다른 검증 작업을 수행한다.
💡 [영상 참조] 강연자는 이 시점에서 화면에 표시된 네 개의 에이전트와 색깔이 바뀌는 화면을 보여주며 설명합니다. 상세 내용은 원본 영상을 확인하세요.
각 에이전트는 작업을 완료한 후 결과를 리포트한다. 메인 에이전트는 이들의 리포트를 통합하여 사용자에게 전달한다. 이런 방식은 테스트 자동화, 코드 리뷰, 성능 검증 등 다양한 품질 보증 작업에 활용할 수 있다.
팀 이름과 작업 재개
모든 작업이 완료되면 팀원들은 자동으로 종료되지만, 정보는 팀 이름으로 저장된다. 나중에 같은 팀 이름을 사용하면 이전 작업을 그대로 불러올 수 있다. 강연자는 “결국엔 다 파일로 저장이 되는 거”라고 설명했다. 이는 작업의 연속성을 보장하며, 복잡한 장기 프로젝트에서 특히 유용하다. 예를 들어, 오늘 프론트엔드 팀을 만들어 작업하고, 내일 같은 팀 이름으로 백엔드 작업을 추가하는 식으로 프로젝트를 관리할 수 있다.
실제 사용 시 권장 사항
일단 써봐야 안다
강연자는 “일단은 기본적으로 여러분이 한번 써봐야지, 이거를 내가 어떤 상황에 쓸지 피부로 느낄 수 있다”고 강조했다. 독립적인 여러 작업을 병렬로 하고 싶지 않더라도, 일단 한 번 사용해보는 것이 중요하다. 터미널을 열고, 새로운 폴더든 기존 프로젝트든 상관없이 실행해보면 바로 감이 온다. 이론적으로 이해하는 것과 실제로 여러 개의 Claude Code가 동시에 작동하는 것을 보는 것은 완전히 다른 경험이다.
베타 단계의 불안정성 감수하기
현재 Agent Teams는 실험적 기능이므로 완벽하게 작동하지 않을 수 있다. 강연자도 시연 중 설정이 제대로 적용되지 않는 경우를 경험했다. “이게 안 들어갈 때가 있어요. 이거 어쩔 수가 없습니다”라며, 이럴 때는 메인 에이전트를 종료하고 다시 실행하면 된다고 조언했다. 너무 베타 상태라서 발생하는 문제지만, 몇 번 재시도하면 대부분 해결된다.
비용 인식하고 선택적으로 사용하기
토큰 비용이 훨씬 더 많이 든다는 점을 항상 염두에 두어야 한다. 모든 작업에 Agent Teams를 사용하는 것은 비효율적이다. 정말 병렬 처리가 의미 있는 작업, 여러 관점에서의 검토가 필요한 작업, 독립적인 모듈 개발 등에 선택적으로 사용하는 것이 현명하다. 단일 세션으로도 충분한 순차적 작업이나 동일 파일 편집이 많은 작업에는 전통적인 방식이 더 적합하다.
마무리 - 개발 워크플로우의 패러다임 전환
Agent Teams는 단순한 기능 추가가 아니라 AI 보조 개발의 패러다임을 바꾸는 혁신이다. 하나의 AI가 모든 것을 처리하던 시대에서, 여러 AI가 협업하는 시대로 전환하고 있다. 이는 실제 개발 팀의 작업 방식을 모방한 것이며, 더 복잡하고 대규모의 프로젝트를 효율적으로 관리할 수 있게 해준다.
강연자는 “아직까지도 근데 저희가 클로드 코드에 대해서, 그리고 안티그래비티에 대해서, 그리고 앞으로 나올 업데이트들에 대해서 저희가 할 얘기가 엄청 많이 남았다”며 영상을 마무리했다. Agent Teams는 시작에 불과하며, AI 개발 도구는 계속해서 진화하고 있다. 지금은 베타 단계의 불안정성이 있지만, 이 기능이 안정화되면 개발 워크플로우에 혁명적인 변화를 가져올 것이 분명하다.
실무에 바로 적용하기 위해서는 우선 작은 프로젝트에서 실험해보고, 어떤 작업이 Agent Teams에 적합한지 경험을 쌓는 것이 중요하다. 독립적인 검증 작업, 레이어별 개발, 경쟁 가설 검증 등에서부터 시작하여, 점차 복잡한 협업 시나리오로 확장해 나가는 것이 효과적인 학습 경로가 될 것이다.
📚 출처 및 참고
| 구분 | 내용 |
|---|---|
| 원본 영상 | 오늘 나온 따끈 따끈한 클로드 코드를 10배 스마트하게 만드는법! Claude Code Teams |
| 채널 | 코드팩토리 |
| 리포트 작성 | 2026-02-07 |
| 작성 방식 | YouTube 영상 STT 변환 후 에디팅 |
💬 본 리포트는 영상 내용을 바탕으로 재구성되었습니다. 정확한 내용은 원본 영상을 참조해 주세요.