에피소드 2. Agent Teams 기능 완벽 가이드 - 여러 Claude가 함께 일하는 법

Agent Teams란 무엇인가요?

왜 Agent Teams가 필요한가요?

Single-Agent의 한계

1. 전문성 부족: 백엔드, 프론트엔드, 보안, 테스트를 모두同一个이 담당하면 깊이가 얕아져요
2. 병렬 작업 불가: 한 번에 하나밖에 못 하니까 시간이 오래 걸리죠
3. 관점의 한계: 한 사람의 생각에는 편향이 있을 수 있어요

Agent Teams의 장점

1. 전문 분담: 각자 전문 영역을 맡아서 더 깊이 있게 일할 수 있어요
2. 병렬 처리: 동시에 여러 작업을 할 수 있어서 시간이 단축되죠
3. 다양한 관점: 서로 다른 생각을 해서 더 나은 해결책을 찾을 수 있어요

Agent Teams 아키텍처

Team Lead (팀 리더)

• 작업을 작은 단위로 나눠요
• 각 Teammate에게 적절한 작업을分配해요
• 전체 진행 상황을 모니터링해요
• 결과를 통합해서 최종 산출물을 만들어요

Teammate (팀메이트)

• 할당된 작업을 수행해요
• Team Lead에게 진행 상황을 보고해요
• 다른 Teammate와 협업하기도 해요

두 가지 실행 모드

In-Process 모드

• 설정이 간단해요
• 메모리를 효율적으로 써요
• 빠르게 시작할 수 있어요

• 한 번에 하나의 작업만 처리해요 (진짜 병렬은 아니에요)
• 복잡한 작업에는 느릴 수 있어요

• 간단한 프로젝트
• 빠르게 결과를 봐야 할 때
• 리소스가 제한적일 때

Split-Pane 모드

• 진짜 병렬 처리가 가능해요
• 각 에이전트가 독립적으로 작동해요
• 복잡한 프로젝트에 적합해요

• 설정이 조금 복잡해요
• 터미널 설정이 필요해요
• 더 많은 리소스를 써요

• 대규모 프로젝트
• 진짜 병렬 처리가 필요할 때
• 리소스가 충분할 때

Agent Teams 설정 방법

In-Process 모드 설정

{
  "agentTeams": {
    "enabled": true,
    "mode": "in-process",
    "teamSize": 3
  }
}

Split-Pane 모드 설정

# 새로운 tmux 세션 시작
tmux new-session -d -s claude-team

# Team Lead용 창 생성
tmux rename-window "lead"
tmux send-keys 'claude' C-m

# Teammate 1용 창 생성
tmux new-window -t claude-team -n "mate1"
tmux send-keys 'claude' C-m

# Teammate 2용 창 생성
tmux new-window -t claude-team -n "mate2"
tmux send-keys 'claude' C-m

# 세션에 연결
tmux attach-session -t claude-team

1. Cmd + Shift + D로 수평 분할
2. 각 분할에서 claude 실행
3. 첫 번째를 Team Lead, 나머지를 Teammate로 사용

주니어 개발자를 위한 활용법

1. 병렬 코드 리뷰

• Teammate 1: 백엔드 코드 리뷰
• Teammate 2: 프론트엔드 코드 리뷰
• Teammate 3: 테스트 코드 리뷰
• Team Lead: 전체 통합 및 최종 판단

2. 다양한 관점 탐색

• Teammate 1: 성능 관점에서 분석
• Teammate 2: 보안 관점에서 분석
• Teammate 3: 유지보수 관점에서 분석
• Team Lead: 세 관점을 종합해서 최적 해결책 제시

3. 학습 및 탐구

• Teammate 1: 공식 문서 읽기
• Teammate 2: 예제 코드 분석
• Teammate 3: 베스트 프랙티스 조사
• Team Lead: 정리 및 요약

실제 사용 예시

# Team Lead에서 작업 시작
/Users/me/project $ claude

> 이 REST API를 구현해야 해. /users, /posts, /comments 엔드포인트 필요해.

# Team Lead가 자동으로 작업 분배
→ Teammate 1에게 /users 엔드포인트 할당
→ Teammate 2에게 /posts 엔드포인트 할당
→ Teammate 3에게 /comments 엔드포인트 할당

# 각 Teammate가 병렬로 작업 수행
→ Teammate 1: User 스키마 설계 및 구현
→ Teammate 2: Post 스키마 설계 및 구현
→ Teammate 3: Comment 스키마 설계 및 구현

# Team Lead가 결과 통합
→ 전체 API 테스트
→ 문서 생성
→ 최종 코드 리뷰

효율적인 Agent Teams 사용 팁

1. 적절한 팀 크기

• 소규모 프로젝트: 2-3명 (Lead + 1-2명)
• 중규모 프로젝트: 3-4명 (Lead + 2-3명)
• 대규모 프로젝트: 4-5명 (Lead + 3-4명)

2. 명확한 역할 분담

# 좋은 예
Teammate 1: 백엔드 API 개발 담당
Teammate 2: 프론트엔드 UI 개발 담당
Teammate 3: 테스트 및 문서화 담당

# 나쁜 예
모든 Teammate: "아무거나 해"

3. 정기적인 동기화

> 각자 현재 진행 상황 공유해 줘.

영상으로 배우기

정리하며

1. 더 빨리: 병렬 처리로 시간이 단축돼요
2. 더 똑똑하게: 전문 분담으로 품질이 높아져요
3. 더 다양하게: 여러 관점에서 문제를 해결해요

참고 자료