09장. Agent Teams (실험적 기능) — Claude Code 완벽 가이드<

Claude Code 완벽 가이드

👥 CHAPTER 09 / 13

Agent Teams (실험적 기능)

📚 Claude Code 완벽 가이드 ⏱ 읽는 시간 약 5분 📅 2026년 3월

이 장의 내용

1. Agent Teams란?
2. 활성화 방법
3. 팀 구조
4. 협업 패턴 4가지
5. 현재 한계 및 로드맵

🧪

Agent Teams는 현재 실험적 기능입니다. 향후 업데이트에서 변경될 수 있습니다.

01Agent Teams란?

단일 Claude Code 세션 내에서 여러 전문 에이전트가 계층적으로 협업하는 기능입니다. 팀 리더가 전문가 팀원들을 조율하고, 공유 작업 목록으로 동기화합니다.

상태

실험적 (Experimental)

최적 모델

Opus 4.6

최적 팀 규모

3~5명 팀원

활성화

환경 변수 설정

02활성화 방법

bash

# 현재 세션만 활성화
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
claude

# 영구 설정 (zsh)
echo 'export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1' >> ~/.zshrc
source ~/.zshrc

# 설정 확인
echo $CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS  # 1 출력

03팀 구조

역할	설명	주요 책임
팀 리더	전체 조율자	작업 할당, 진행 모니터링, 아키텍처 결정
팀원	전문 실행자	담당 작업 집중, 진행 보고, 목록 업데이트
공유 작업 목록	중앙 조율 도구	전체 작업 추적, 의존성 관리

04협업 패턴 4가지

패턴 1: 병렬 개발

text

- frontend-engineer: 로그인 UI 개발
- backend-engineer: 인증 API 구현
- qa-engineer: 통합 테스트 작성
→ 세 에이전트가 동시에 각자 작업

패턴 2: 순차 파이프라인

text

Task 1: db-specialist → DB 스키마 설계
  ↓ (완료 후)
Task 2: backend-engineer → CRUD 구현
  ↓
Task 3: frontend-engineer → 대시보드 개발

패턴 3: 코드 리뷰 워크플로우

text

Task 1: feature-dev → 기능 구현
  ↓ (병렬)
Task 2: security-reviewer → 보안 검사
Task 3: perf-reviewer → 성능 분석
  ↓ (둘 다 완료 후)
Task 4: feature-dev → 피드백 반영

패턴 4: 조사 & 구현

text

Task 1: research-agent → 코드베이스 분석
  ↓ (병렬)
Task 2: agent-a → 인증 모듈 적용
Task 3: agent-b → 결제 모듈 적용
Task 4: agent-c → 알림 모듈 적용

05현재 한계 및 로드맵

제한 사항	설명
지속성 없음	세션 종료 시 팀 정보 소멸
토큰 소비 증가	다중 에이전트 = 더 많은 토큰
조율 오버헤드	팀원이 많을수록 조율 비용 증가 (3~5명 권장)
Opus 4.6 최적	다른 모델에서는 성능 저하 가능

예정된 개선사항

• Agent Teams 정식 출시
• 세션 간 팀 지속성
• 시각적 팀 대시보드
• 고급 작업 스케줄링

출처: github.com/wesammustafa/Claude-Code-Everything-You-Need-to-Know

Claude Code 완벽 가이드 · 09장 / 13장