Claude Code의 새로운 Agent Teams 기능을 사용하면 여러 AI 에이전트를 실제 엔지니어링 팀처럼 병렬로 조율할 수 있습니다. 활성화 방법과 나만의 AI 팀을 운영하는 방법을 알아보세요.

이제 당신이 CEO입니다: Claude Code에서 AI 개발팀을 이끄는 방법

상상해 보세요. 터미널을 열고 몇 문장을 입력하면 갑자기 화면이 여러 패널로 나뉩니다. 각 패널에는 프로젝트의 다른 부분을 작업하는 자율적인 AI 개발자가 있습니다. 그들은 서로 대화합니다. 작업을 맡습니다. 서로의 아이디어에 이의를 제기합니다. 그리고 당신은 편안히 앉아 실시간 전략 게임처럼 펼쳐지는 것을 지켜봅니다.

이것이 Claude Code의 Agent Teams입니다. 그리고 이것이 현실이 되었습니다.

Agent Teams란?

Agent Teams는 여러 Claude Code 인스턴스가 함께 작업하도록 조율할 수 있게 해줍니다. 하나의 세션이 팀 리더로 기능하며, 작업을 조정하고, 태스크를 할당하고, 결과를 종합합니다. 나머지는 팀원으로, 각각 고유한 컨텍스트 윈도우에서 실행되는 독립된 세션이며, 서로 직접 소통합니다.

서브에이전트와의 차이점은 이것입니다: 서브에이전트는 단일 세션 안에서 실행되며 메인 에이전트에게만 보고할 수 있습니다. 서로 대화할 수 없습니다. Agent Teams는 완전히 독립된 Claude Code 인스턴스로, 서로 직접 메시지를 주고받습니다. 보고만 하는 빠르고 집중적인 작업자가 필요하면 서브에이전트를 사용하세요. 팀원들이 발견을 공유하고, 서로 도전하며, 자율적으로 조율해야 할 때는 Agent Teams를 사용하세요.

당신은 항상 통제권을 유지합니다. Claude는 당신의 승인 없이 팀을 생성하지 않습니다. 당신이 요청하거나, Claude가 제안하고 당신의 확인을 기다립니다.

30초 만에 활성화

Agent Teams는 실험적 기능이며 기본적으로 비활성화되어 있습니다. 다음 두 가지 방법 중 하나로 활성화하세요:

옵션 1: 환경 변수

bash

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

옵션 2: 설정 파일

settings.json에 추가하세요:

json

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

끝입니다. 이제 당신은 팀 매니저입니다.

첫 번째 팀 시작하기

설정 파일이 필요 없습니다. YAML도 필요 없습니다. 태스크와 원하는 팀 구조를 자연어로 설명하기만 하면 됩니다. Claude가 팀을 생성하고, 팀원을 실행하고, 당신의 프롬프트에 따라 작업을 조율합니다.

이 예제는 세 가지 역할이 독립적이고 서로를 기다리지 않고 문제를 탐색할 수 있기 때문에 잘 작동합니다:

개발자가 코드베이스 전체에서 TODO 코멘트를 추적하는 데 도움이 되는
CLI 도구를 설계하고 있습니다. 다양한 각도에서 탐색할 에이전트 팀을
만들어 주세요: UX 담당 한 명, 기술 아키텍처 담당 한 명,
반대 의견 역할 한 명.

Enter를 누르고 지켜보세요. Claude가 공유 태스크 목록이 있는 팀을 만들고, 각 각도별로 팀원을 실행하고, 탐색하게 하고, 발견을 종합하고, 작업이 끝나면 정리합니다.

리더의 터미널에는 모든 팀원과 그들이 작업 중인 내용이 표시됩니다. 프로젝트 대시보드가 실시간으로 업데이트되는 느낌입니다.

액션을 보는 두 가지 방법

팀이 화면에 어떻게 표시될지 선택할 수 있습니다:

인프로세스 모드가 기본값입니다. 모든 팀원이 메인 터미널 내에서 실행됩니다. Shift+위/아래로 팀원을 선택하고 직접 메시지를 보낼 수 있습니다. 어떤 터미널에서든 작동하며 추가 설정이 필요 없습니다.

스플릿 패인 모드가 하이라이트입니다. 각 팀원이 고유한 가시적 패인을 갖습니다. 여러 AI 개발자가 나란히 실시간으로 코딩하는 것을 문자 그대로 볼 수 있습니다. tmux 또는 iTerm2가 필요하며 VS Code의 통합 터미널, Windows Terminal, Ghostty에서는 작동하지 않습니다.

실시간 전략 게임 느낌을 원한다면 스플릿 패인 모드가 답입니다. 세 에이전트가 별도의 패인에서 다양한 각도로 코드베이스를 동시에 조사하는 것을 보는 것은 정말 짜릿합니다.

프로처럼 팀을 제어하기

팀이 가동되면 리더에게 자연어로 말합니다. 리더가 당신의 지시에 따라 조율, 태스크 할당, 위임을 처리합니다.

여기서 강력한 기술이 나옵니다 - Delegate Mode. Shift+Tab을 눌러 권한 모드를 순환합니다. 에이전트 팀이 활성화되면 순환에 Delegate Mode가 포함되어 리더를 조율 도구만으로 제한합니다. 코딩 없이 실행, 메시징, 태스크 관리만 가능합니다. 리더가 위임 대신 직접 태스크를 구현하려는 흔한 문제를 해결합니다.

리더를 완전히 우회할 수도 있습니다. Shift+위/아래로 아무 팀원이나 선택하고 직접 메시지를 보내세요. 지휘 체계에 묶여 있지 않습니다. 진짜 팀 매니저가 누군가의 책상으로 걸어가듯이 원하는 곳에 개입할 수 있습니다.

공유 태스크 목록

뒤에서 팀은 공유 태스크 목록으로 운영됩니다. 태스크에는 세 가지 상태가 있습니다: 대기 중, 진행 중, 완료. 태스크에 의존성을 설정할 수 있습니다. 팀원이 다른 태스크가 의존하는 태스크를 완료하면 차단된 태스크가 자동으로 해제됩니다.

팀원은 자율적으로 태스크를 가져갑니다. 한 명이 작업을 마치면 목록에서 다음 미할당, 미차단 태스크를 가져갑니다. 마이크로매니지먼트가 필요 없습니다.

모든 팀 구성과 태스크는 ~/.claude/teams/{team-name}/config.json에 로컬 저장됩니다.

Agent Teams가 빛나는 영역

Agent Teams는 병렬 탐색이 실질적인 가치를 더하는 태스크에 가장 효과적입니다. 가이드에서 직접 가져온 가장 강력한 사용 사례입니다:

리서치와 리뷰

여러 팀원이 문제의 다양한 측면을 동시에 조사한 다음 서로의 발견을 공유하고 이의를 제기합니다. 단일 리뷰어는 한 번에 한 종류의 문제에 치우치는 경향이 있습니다. 기준을 독립적인 영역으로 나누면 모든 것이 동시에 철저한 관심을 받습니다:

PR #142를 리뷰할 에이전트 팀을 만드세요. 세 명의 리뷰어를 실행:
- 보안 영향에 집중하는 한 명
- 성능 영향을 확인하는 한 명
- 테스트 커버리지를 검증하는 한 명
각자 리뷰하고 발견 사항을 보고하게 하세요.

세 에이전트, 세 각도, 모두 동시에 실행. 특수부대를 지휘하는 느낌입니다.

새로운 모듈이나 기능

팀원들이 서로의 영역을 침범하지 않고 각자 별도의 부분을 소유합니다. 경계가 명확할 때 Agent Teams가 진가를 발휘합니다:

새 대시보드 기능을 구축할 에이전트 팀을 만드세요.
API 레이어 담당 한 명, 프론트엔드 컴포넌트 담당 한 명,
테스트 스위트 담당 한 명.

API 팀원이 타입 정의를 완료하면 프론트엔드 팀원에게 직접 메시지를 보냅니다. 테스트 팀원이 API 팀원에게 dev 서버 실행을 요청합니다. 당신이 손가락 하나 움직이지 않아도 스스로 조율합니다.

경쟁 가설로 디버깅

이론을 하나씩 테스트하는 대신, 각각 다른 가설을 병렬로 추적하는 팀원을 실행합니다. 더 빨리 답에 수렴하며, 진행 과정에서 서로의 발견에 이의를 제기할 수 있습니다.

당신이 심판이고 전문가들 사이의 토론이라고 생각하세요.

레이어 간 조율

프론트엔드, 백엔드, 테스트에 걸친 변경 사항을 각각 다른 팀원이 담당합니다. 이것은 "한 두뇌로는 움직이는 부품이 너무 많다"는 전형적인 시나리오이며, Agent Teams가 아름답게 처리합니다.

Agent Teams를 사용하지 말아야 할 때

모든 태스크에 팀이 필요한 것은 아닙니다. Agent Teams는 조율 오버헤드를 추가하고 단일 세션보다 훨씬 더 많은 토큰을 사용합니다. 팀원이 독립적으로 작업할 수 있을 때 가장 효과적입니다.

다음의 경우 팀을 건너뛰고 단일 세션이나 서브에이전트를 사용하세요:

각 단계가 이전 단계에 의존하는 순차적 태스크
여러 에이전트가 충돌을 일으킬 수 있는 동일 파일 편집
병렬 실행을 방해하는 의존성이 많은 작업
하나의 에이전트가 완벽하게 처리하는 일상적인 태스크

변수 이름을 바꾸기 위해 다섯 명 팀을 구성하지 않을 것입니다. 같은 논리가 여기에도 적용됩니다.

토큰 비용: 파워의 대가

이것이 가장 중요한 섹션입니다. Agent Teams는 단일 세션보다 훨씬 더 많은 토큰을 사용합니다. 각 팀원이 고유한 컨텍스트 윈도우를 가지며, 토큰 사용량은 활성 팀원 수에 따라 증가합니다.

리서치, 리뷰, 새 기능 개발에서는 추가 토큰이 보통 그 가치가 있습니다. 일상 태스크에서는 단일 세션이 훨씬 비용 효율적입니다.

프리랜서를 고용하는 것과 같습니다. 큰 프로젝트를 위해 데려오지, 일상 업무에는 사용하지 않습니다.

CLAUDE.md는 계속 작동합니다

좋은 소식입니다. CLAUDE.md는 Agent Teams에서도 정상적으로 작동합니다. 팀원은 작업 디렉토리에서 CLAUDE.md 파일을 읽으므로 프로젝트별 가이드가 전체 팀에 자동으로 적용됩니다. 추가 구성이 필요 없습니다.

알려진 제한사항

Agent Teams는 실험적이며 문서는 이에 대해 솔직합니다. 현재 알려진 제한사항에는 세션 재개, 태스크 조율, 종료 동작 관련 문제가 포함됩니다. 세션당 하나의 팀만 실행할 수 있고, 중첩 팀은 지원되지 않으며, 스플릿 패인 모드는 tmux와 iTerm2로 제한됩니다.

리더가 위임 대신 직접 태스크를 구현하려고 시도하는 경우가 있습니다. 두 가지 해결책: 프롬프트에서 명시적으로 "팀원이 태스크를 완료할 때까지 기다린 후 진행하세요"라고 지시하거나, Delegate Mode(Shift+Tab)를 사용하여 조율 도구만으로 제한합니다.

초기 단계이지만 핵심 경험은 이미 근본적으로 새로운 무언가처럼 느껴집니다.

시작하기: 첫 번째 미션

결론

Agent Teams는 Claude Code를 단일 개발자에서 실시간으로 지휘하는 조율된 팀으로 변모시킵니다. 원하는 것을 설명하고, 역할을 할당하고, 여러 AI 에이전트가 별도 패인에서 시작하여 태스크를 맡고, 서로 메시지를 보내고, 결과를 병렬로 전달하는 것을 지켜봅니다.

실험적입니다. 토큰을 소모합니다. 거친 부분이 있습니다. 그리고 올해 AI 지원 코딩에서 가장 흥미로운 사건입니다.

활성화하세요. 팀을 실행하세요. 터미널이 살아나는 것을 지켜보세요.

당신은 더 이상 코드만 쓰고 있는 것이 아닙니다. 당신이 쇼를 이끌고 있습니다.

Claude Code Agent Teams: 이제 당신이 AI 개발팀의 CEO입니다 (게임 같은 느낌으로)