🤖 04. 팀협업

팀 협업에서 핵심은 “많이 병렬화”가 아니라 어떤 단위로 병렬화할지입니다. 같은 병렬이라도 Subagents와 Agent Teams는 비용 구조와 조율 방식이 다르기 때문에, 작업 성격에 맞춰 선택해야 합니다.

flowchart LR
  A[작업 입력] --> B{독립 병렬 필요?}
  B -->|낮음| C[단일 세션]
  B -->|중간| D[Subagents]
  B -->|높음| E[Agent Teams]
  E --> F[공유 task list + 직접 메시징]

🧠 칠판 치트시트

• 같은 파일 많이 건드리면 Teams보다 단일 세션이 낫다
• 탐색/검토 병렬은 Subagents가 비용 효율적이다
• 상호 토론형 검증이 필요할 때만 Agent Teams를 켠다

1) Subagents vs Agent Teams

공식 문서 요약:

• Subagents: 메인 세션 안에서 분업, 결과를 메인으로 반환
• Agent Teams: 독립 세션끼리 직접 소통 + 공유 task list

참고:

• https://code.claude.com/docs/en/sub-agents
• https://code.claude.com/docs/en/agent-teams

선택 기준

• 코드 탐색/리뷰 분업: Subagents 우선
• 가설 경쟁·다중 관점 토론: Agent Teams 우선
• 작은 수정/순차 작업: 단일 세션 유지

2) Agent Teams 활성화와 실행

settings.json 예시

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  "teammateMode": "in-process"
}

세션 단위 모드 강제

claude --teammate-mode in-process

운영 전에 알아둘 제한

공식 문서에서 Agent Teams는 아직 실험 기능으로 안내됩니다.

• in-process teammate는 /resume 시 복원이 완전하지 않을 수 있음
• 팀 정리(cleanup) 전에 teammate 종료를 먼저 해야 안정적
• 팀 규모가 커질수록 토큰 비용이 선형에 가깝게 증가

실무 팁:

• 기본 팀 크기는 3~5명에서 시작
• 같은 파일을 동시에 건드리는 작업은 Teams보다 단일 세션/서브에이전트가 안전

3) 바로 쓰는 팀 지시 프롬프트

PR #142를 병렬 리뷰해줘.
- 보안 리뷰 담당 1명
- 성능/쿼리 담당 1명
- 테스트 커버리지 담당 1명
각자 근거 3개와 수정안 2개를 제시하고,
리드는 충돌 항목만 통합 정리해줘.

4) Cowork를 붙일 때의 실무 포지션

Cowork(리서치 프리뷰)는 문서/리서치 중심의 비동기 협업에서 유용합니다. 다만 코드 변경 주도 워크플로는 Claude Code(teams/subagents) 기준으로 운영하는 편이 안정적입니다.

참고: https://claude.com/resources/tutorials/claude-cowork-a-research-preview

5) 미니 사례 2개

사례 A: Subagents로 해결된 경우

단일 저장소에서 API/테스트/문서 검토를 분리해 돌렸더니, 메인 컨텍스트가 덜 오염되어 최종 통합 속도가 빨라졌습니다.

사례 B: Teams가 필요했던 경우

원인 불명 장애에서 서로 다른 가설을 병렬로 검증해야 했고, 팀원 간 직접 반박/합의가 필요해 Agent Teams가 더 빨랐습니다.

실전 판단 요약 (2026-03 보강)

Agent Teams와 Subagent를 고를 때 가장 쉬운 기준은 하나다. 작업자끼리 직접 대화하고 서로의 가설을 검증해야 하면 Teams, 결과만 모아오면 되면 Subagent가 낫다.

• Teams: 디버깅 가설 경쟁, 프론트/백/테스트 교차 조율, 역할별 합의가 필요한 작업
• Subagent: 코드 탐색, 문서 요약, 정해진 규칙의 반복 점검처럼 결과만 중요할 때
• 실무 팁: 비용과 조율 부담 때문에 기본값은 Subagent로 두고, 상호 검증이 꼭 필요할 때만 Teams를 켠다.

6) 25분 도입 루틴

1. 8분: 현재 작업을 단일/서브/팀으로 분류
2. 7분: 팀 지시 프롬프트 템플릿 1개 작성
3. 10분: 소규모 파일럿 1회 실행 후 회고

완료 기준:

• 병렬화 전후 리드타임 비교가 가능하다
• 어떤 작업에 어떤 모드를 쓸지 팀 기준이 생긴다

운영 체크리스트

• 병렬 작업 단위가 서로 파일 충돌 없이 분리되어 있는가?
• lead에게 Clean up the team을 요청해 팀 정리를 마쳤는가?
• 팀 규모를 3~5명 범위에서 시작했는가?
• broadcast를 남용하지 않고 필요한 teammate에게만 메시지를 보냈는가?

다음 읽기

• 🤖 05. GitHub
• 🤖 08. 비용운영
• insights

생성형 AI 활용 고지

이 문서는 Claude Code 공식 문서를 바탕으로 생성형 AI를 활용해 정리했으며, 최종 공개 전 사람이 검토·보정했습니다.