Claude Code 상세 사용법 62: 에이전트 팀으로 병렬 작업 조율하기 | DAKER 커뮤니티

Claude Code 상세 사용법 62: 에이전트 팀으로 병렬 작업 조율하기

Claude Code의 에이전트 팀은 여러 클로드 코드 세션을 하나의 작업으로 묶어 조율하는 실험적 기능입니다. 공식 문서 기준 팀에는 리더 세션과 팀원이 있고, 팀원은 각자 독립 context window에서 일하며 공유 작업목록과 직접 메시지로 협업합니다. 단순 하위 에이전트보다 무겁지만, 서로 다른 가설을 동시에 검증해야 하는 AI 코딩 작업에는 강합니다.

Mermaid 흐름으로 보는 선택 기준

아래 Mermaid source처럼 먼저 병렬성이 필요한지 보고, 필요하면 가장 작은 표면부터 올립니다.

Mermaid source:
flowchart TD
  A[작업 정의] --> B{독립된 갈래가 있나}
  B -->|아니오| C[단일 Claude Code 세션]
  B -->|예| D{결과만 요약하면 되나}
  D -->|예| E[하위 에이전트]
  D -->|아니오| F{공유 조율이 필요한가}
  F -->|예| G[에이전트 팀]
  F -->|아니오| H[에이전트 뷰 또는 worktree]

켜기 전에 버전을 본다

공식 문서는 에이전트 팀을 experimental로 설명하며 기본값은 꺼져 있습니다. 먼저 버전을 확인하고, 팀 기능을 명시적으로 켭니다.

claude --version
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
claude

팀 문서나 settings.json에 플래그를 둘 수도 있지만, 실험 기능은 repo별로 의도를 남기는 편이 안전합니다. “왜 팀이 필요한가”를 PRD나 작업 메모 첫 줄에 적어 두세요.

팀에 맡길 만한 일

좋은 후보는 서로 독립된 증거를 모아야 하는 일입니다. 예를 들어 프론트 성능 저하, API timeout, 테스트 flaky를 각각 다른 팀원이 조사하고 리더가 원인을 합칩니다. 새 기능도 UI, 서버, 테스트가 파일 소유권으로 나뉘면 잘 맞습니다.

나쁜 후보도 있습니다. 작은 버그 한 줄, 강한 순서가 있는 migration, 같은 파일을 여러 명이 동시에 고치는 refactor는 팀보다 단일 세션이나 하위 에이전트가 낫습니다.

시작 프롬프트 예시

리더에게는 구현보다 조율 계약을 먼저 줍니다.

목표: 결제 실패율 증가 원인을 찾고 최소 수정안을 제시한다.
팀 구성: 로그 조사, 최근 diff 조사, 테스트 재현을 분리한다.
경계: 같은 파일을 동시에 수정하지 않는다. 수정 전 리더에게 보고한다.
완료 조건: 원인 가설, 근거 파일, 재현 명령, 필요한 테스트를 합쳐 보고한다.

팀원에게 맡기는 단위는 “조사해줘”보다 좁아야 합니다. “최근 24시간의 checkout timeout 로그와 배포 commit을 비교해줘”처럼 입력, 범위, 산출물을 같이 씁니다.

실패 모드

첫째, session resumption과 shutdown behavior에 알려진 제한이 있으므로 긴 작업은 중간 요약을 자주 남깁니다. 둘째, 팀원이 같은 파일을 만지면 merge 비용이 커집니다. 셋째, 리더가 없는 팀은 결론이 흩어집니다. 넷째, 실험 기능이므로 버전 차이와 UI 변경을 전제로 런북을 짧게 유지합니다.

선임 엔지니어 takeaways

에이전트 팀은 바이브코딩을 “여러 Claude Code에게 던지기”로 만드는 기능이 아닙니다. 클로드 코드, agentic coding, 코드 리뷰, 테스트 자동화에서 팀을 쓰려면 작업 분리, 파일 소유권, 합류 지점, 중단 기준이 먼저 있어야 합니다. 병렬성은 비용입니다. 그 비용보다 빠른 증거 수집과 더 나은 검증이 클 때만 팀으로 올리세요.

참고: Anthropic Claude Code agent teams, agent view, parallel agents, llms.txt 문서를 2026-06-15 Asia/Seoul 기준으로 확인했습니다.