챕터별 상세
00:43
에이전트 팀의 개념과 하위 에이전트와의 차이
에이전트 팀은 하나의 리드 에이전트와 여러 명의 팀원으로 구성된 오케스트레이션 구조이다. 일반적인 하위 에이전트(Subagents)가 메인 에이전트에게만 보고하는 것과 달리, 팀원들은 서로 직접 메시지를 주고받으며 작업 목록을 공유하고 자율적으로 협업한다. 각 팀원은 독립적인 컨텍스트를 가지며 리드 에이전트가 할당한 태스크를 병렬로 처리한다. 결과적으로 단순한 작업 대행을 넘어 복잡한 문제 해결을 위한 협업 체계를 구축한다.
06:48
에이전트 팀 활성화 및 기본 설정
에이전트 팀 기능은 현재 실험적 단계이므로 settings.json 파일에서 직접 활성화해야 한다. CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 환경 변수를 1로 설정한 후 Claude Code를 재시작하면 기능을 사용할 수 있다. 사용자는 자연어를 통해 원하는 팀 구성을 설명하기만 하면 Claude가 자동으로 필요한 역할의 에이전트들을 생성한다. 설정 과정에서 공식 문서를 참고하여 필요한 환경 변수를 정확히 입력하는 것이 중요하다.
json
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}settings.json 파일에서 에이전트 팀 실험적 기능을 활성화하는 설정
08:42
에이전트별 모델 지정 및 비용 최적화
에이전트 팀의 각 팀원에게 서로 다른 Claude 모델을 할당하여 성능과 비용의 균형을 맞출 수 있다. 예를 들어 복잡한 로직이 필요한 디버거에는 Opus 모델을, 단순한 UI 작업에는 Haiku 모델을 지정하는 방식이다. 에이전트 팀은 여러 인스턴스를 동시에 실행하므로 단일 에이전트보다 토큰 소모가 훨씬 빠르다. 따라서 모든 팀원에게 고성능 모델을 할당하기보다 태스크의 난이도에 맞춰 모델을 분배하는 전략이 필수적이다.
text
Create an agent team with one teammate on UX, one on architecture, one playing devil's advocate.자연어를 사용하여 특정 역할을 가진 에이전트 팀을 생성하는 프롬프트 예시
text
For the agent team, make sure the debugger runs on opus-4.6, the ui-perf runs on sonnet, and the ux-quality runs on haiku.각 에이전트 팀원별로 서로 다른 Claude 모델을 지정하는 프롬프트 예시
09:24
디스플레이 모드와 tmux 활용
에이전트 팀의 작업 과정을 확인하는 방식은 두 가지이다. 기본 모드인 'In-process'는 하나의 터미널에서 탭을 전환하며 각 에이전트의 상태를 확인하는 방식이다. 반면 'Split panes' 모드는 tmux를 활용하여 화면을 분할하고 모든 에이전트의 로그를 실시간으로 동시에 모니터링한다. 대화면 모니터를 사용하는 환경에서는 tmux 설정을 통해 팀 전체의 진행 상황을 한눈에 파악하는 것이 효율적이다. 설정 파일에서 teammode를 tmux로 지정하여 이 기능을 활성화한다.
11:52
태스크 관리 및 에이전트 제어 라이프사이클
에이전트 팀은 공유된 태스크 리스트를 중심으로 작동하며 사용자는 Ctrl+T를 눌러 전체 진행 상황을 확인할 수 있다. 리드 에이전트가 계획을 수립하면 팀원들이 태스크를 스스로 가져가거나(self-claim) 할당받아 실행한다. 작업이 완료되거나 일정 시간 유휴 상태가 되면 에이전트는 자동으로 종료된다. 사용자는 리드 에이전트를 통해 팀 전체의 승인 기준을 설정하거나 작업을 중단시키는 등 중앙 집중식 제어를 수행한다. 특히 구현 시작 전 반드시 계획(Plan)을 검토하도록 설정하는 것이 품질 관리에 중요하다.
19:05
실무 적용 베스트 프랙티스
효율적인 팀 운영을 위해 팀원 수는 3-5명, 에이전트당 태스크는 5-6개로 제한하는 것이 좋다. 팀원 수가 너무 많으면 관리 오버헤드와 토큰 비용이 기하급수적으로 증가하기 때문이다. 또한 에이전트들이 동일한 파일을 동시에 수정하여 충돌이 발생하는 것을 방지하기 위해 작업 범위를 명확히 분리해야 한다. 리드 에이전트에게 충분한 컨텍스트를 제공하고, 에이전트가 직접 코드를 수정하기 전에 계획을 먼저 보고하도록 유도하여 실수를 줄인다.
22:37
주요 활용 사례: 코드 리뷰 및 디버깅
에이전트 팀은 병렬 코드 리뷰와 복합적인 디버깅에서 강력한 성능을 발휘한다. 보안, 성능, 테스트 커버리지 등 각기 다른 관점을 가진 리뷰어 에이전트들을 배치하여 다각도의 검토 결과를 한 번에 얻을 수 있다. 디버깅 시에는 여러 가설을 각각의 에이전트에게 할당하여 병렬로 검증하게 함으로써 문제의 근본 원인을 빠르게 찾아낸다. 이는 단일 에이전트가 가질 수 있는 컨텍스트 편향을 방지하고 객관적인 분석 결과를 도출하는 데 도움을 준다.
용어 해설
- 에이전트 팀(Agent Teams)
- — Claude Code에서 여러 개의 에이전트 인스턴스가 하나의 팀을 구성하여 복잡한 작업을 분담하고 상호작용하며 해결하는 기능이다. 각 에이전트는 독립적인 컨텍스트를 가지면서도 공유된 작업 목록을 통해 협업하며, 병렬적인 개발 워크플로우를 가능하게 한다.
- 하위 에이전트(Subagent)
- — 메인 에이전트가 특정 태스크를 수행하기 위해 일시적으로 생성하는 실행 단위이다. 에이전트 팀과 달리 에이전트 간의 직접적인 통신이나 자율적인 협업 기능이 제한적이며, 주로 메인 에이전트의 지시에 따라 단일 작업을 처리하는 데 사용된다.
- 티먹스(tmux)
- — 하나의 터미널 창을 여러 개의 창(pane)으로 분할하여 사용할 수 있게 해주는 터미널 멀티플렉서 도구이다. Claude Code 에이전트 팀 모드에서 여러 에이전트의 작업 과정을 동시에 모니터링하기 위한 분할 화면(split panes) 기능을 구현하는 데 필수적이다.
- 오케스트레이션(Orchestration)
- — 여러 개의 독립된 에이전트나 서비스들이 조화롭게 작동하도록 배치, 관리, 조정하는 프로세스이다. 에이전트 팀에서는 리드 에이전트가 팀원들에게 작업을 할당하고 결과를 취합하며 전체적인 워크플로우를 제어하는 역할을 수행한다.
AI 분석 전체 내용 보기
AI 요약 · 북마크 · 개인 피드 설정 — 무료
출처 · 인용 안내
원문 발행 2026. 03. 22.수집 2026. 03. 22.출처 타입 YOUTUBE
인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.
