[공식문서읽기] 클로드 코드 에이전트 팀 - 여러 AI가 협업하는 새로운 개발 패러다임

클로드 코드 에이전트 팀(Agent Teams)은 Anthropic이 Opus 4.6과 함께 출시한 실험적 기능으로, 여러 Claude Code 인스턴스가 하나의 팀처럼 협업할 수 있게 해줍니다. 한 명의 AI에게 지시하고 기다리는 방식에서 벗어나, 여러 AI 에이전트가 동시에 코드베이스의 서로 다른 부분을 작업하는 것이 가능해졌습니다.

에이전트 팀이란?

에이전트 팀은 여러 Claude Code 세션이 팀으로 함께 작동하도록 조율하는 기능입니다. 구성은 다음과 같습니다:

구성 요소	역할
팀 리더	팀을 생성하고 작업을 조율하는 메인 세션
팀원	할당된 작업을 독립적으로 수행하는 Claude Code 인스턴스
작업 목록	팀원들이 청구하고 완료하는 공유 태스크
메일박스	에이전트 간 직접 통신을 위한 메시징 시스템

기존의 서브에이전트(Subagent)와 달리, 팀원들은 리더를 거치지 않고 서로 직접 메시지를 주고받을 수 있습니다. 이는 단순한 병렬 실행이 아닌, 조율된 개발(orchestrated development)을 가능하게 합니다.

언제 사용해야 할까?

에이전트 팀은 병렬 탐색이 실질적인 가치를 더하는 작업에 가장 효과적입니다:

추천 사용 사례:

• 연구 및 검토: 여러 팀원이 문제의 다양한 측면을 동시에 조사
• 새로운 모듈 개발: 팀원들이 각각 별도의 부분을 담당
• 경쟁 가설 디버깅: 다양한 이론을 병렬로 테스트하여 빠르게 답에 수렴
• 교차 계층 작업: 프론트엔드, 백엔드, 테스트를 각각 다른 팀원이 담당

피해야 할 경우:

• 순차적 작업이 필요한 경우
• 동일한 파일을 여러 명이 편집해야 하는 경우
• 많은 종속성이 있는 작업

활성화 및 시작 방법

에이전트 팀은 기본적으로 비활성화되어 있습니다. settings.json에서 환경 변수를 설정하여 활성화합니다:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

활성화 후 자연어로 팀 생성을 요청합니다:

CLI 도구를 설계하고 있어. 에이전트 팀을 만들어서 다양한 각도로 탐색해줘:
- UX 담당 팀원
- 기술 아키텍처 담당 팀원
- 반론을 제기하는 팀원

표시 모드

에이전트 팀은 두 가지 표시 모드를 지원합니다:

모드	설명	요구사항
In-process	모든 팀원이 메인 터미널 내에서 실행. Shift+Up/Down으로 팀원 선택	없음
분할 창	각 팀원이 자신의 창을 가짐. 모든 출력을 한 번에 확인 가능	tmux 또는 iTerm2

서브에이전트와의 차이점

특성	서브에이전트	에이전트 팀
컨텍스트	결과를 호출자에게 반환	완전히 독립적
통신	메인 에이전트에게만 보고	팀원들끼리 직접 메시지 전송
조율	메인 에이전트가 모든 작업 관리	공유 작업 목록으로 자체 조율
토큰 비용	낮음 (결과가 요약됨)	높음 (각 팀원이 별도 인스턴스)

빠르고 집중된 작업은 서브에이전트를, 발견 사항을 공유하고 서로 도전하며 자체 조율이 필요한 복잡한 작업은 에이전트 팀을 사용하세요.

실제 사례: C 컴파일러 프로젝트

Anthropic 엔지니어가 16개의 에이전트에게 Rust 기반 C 컴파일러 작성을 맡겼습니다. 약 2,000개의 Claude Code 세션과 $20,000의 API 비용으로, 10만 줄의 컴파일러가 완성되었습니다. 이 컴파일러는 x86, ARM, RISC-V에서 Linux 6.9 커널을 빌드할 수 있습니다.

팀 및 엔터프라이즈 요금제

Claude Code는 이제 Team 및 Enterprise 요금제에서 사용할 수 있습니다:

• 프리미엄 시트: Claude 채팅과 Claude Code를 하나의 구독으로 번들
• 유연한 사용량: 기본 일일 사용량 + 표준 API 요율로 추가 사용 가능
• 관리자 컨트롤: 사용자별 지출 한도, 사용량 분석, 도구 권한 및 파일 접근 제한 설정

모범 사례

1. 팀원에게 충분한 컨텍스트 제공

보안 검토 팀원을 생성해줘: "src/auth/ 인증 모듈의 보안 취약점을
검토해. 토큰 처리, 세션 관리, 입력 검증에 집중하고,
심각도 등급과 함께 이슈를 보고해."

2. 작업 크기 적절히 조정

• 너무 작으면 조율 오버헤드가 이점을 초과
• 너무 크면 팀원이 체크인 없이 오래 작동하여 낭비 위험 증가
• 팀원당 5-6개의 명확한 결과물이 있는 작업이 적절

3. 파일 충돌 피하기

두 팀원이 동일한 파일을 편집하면 덮어쓰기가 발생합니다. 각 팀원이 다른 파일 집합을 소유하도록 작업을 분해하세요.

4. 계획 승인 요구하기

복잡한 작업의 경우 팀원이 구현 전에 계획을 제출하도록 설정할 수 있습니다:

아키텍트 팀원을 생성해서 인증 모듈을 리팩토링하게 해.
변경하기 전에 계획 승인을 요구해.

현재 제한 사항

에이전트 팀은 아직 실험적 기능입니다:

• 세션 재개 시 in-process 팀원이 복원되지 않음
• 세션당 하나의 팀만 관리 가능
• 중첩된 팀 생성 불가
• 분할 창 모드는 VS Code 터미널, Windows Terminal에서 미지원

마무리

클로드 코드 에이전트 팀은 AI 코딩의 새로운 지평을 열었습니다. 단일 에이전트의 한계를 넘어 여러 AI가 협업하는 방식으로, 복잡한 프로젝트를 더 빠르고 효율적으로 진행할 수 있습니다. 아직 실험적 기능이지만, PR 검토나 라이브러리 연구처럼 명확한 경계가 있는 작업부터 시작해보는 것을 추천합니다.

---

참고 자료

• Claude Code 에이전트 팀 공식 문서
• Claude Code Teams 및 Enterprise 발표
• Anthropic Opus 4.6 Agent Teams - TechCrunch
• Claude Code Agent Teams 가이드 - SitePoint

이 글은 Claude Code를 활용하여 작성되었습니다.