에이전트 팀 (Agent Teams)

에이전트 팀(Agent Teams)은 여러 AI 에이전트가 역할을 나누고 진행 상황을 공유하며 하나의 작업을 수행하는 협업 구성입니다. Claude Code에서는 독립된 세션들이 팀 리더의 조율과 공유 작업 목록을 바탕으로 협력하는 기능 이름으로도 쓰입니다. 여러 작업자를 실행하는 것과 그 결과가 정확하게 통합되는 것은 별도 조건입니다.

역할을 나누고 결과를 합치는 구성

팀에서는 전체 요청을 나누는 역할과 개별 작업을 수행하는 역할을 구별합니다. 한 작업자가 자료를 조사하고 다른 작업자가 코드를 읽는 식으로 겹치지 않는 범위를 맡길 수 있습니다. 각자가 어떤 입력을 받고 무엇을 내놓는지 명확해야 결과를 합칠 때 빠진 부분을 찾을 수 있습니다. 단순히 같은 질문을 여러 번 보내는 방식과 역할을 나누어 공동 작업을 진행하는 방식은 목적이 다릅니다.

Claude Code의 에이전트 팀 안내는 팀 리더, 팀원, 공유 작업 목록과 메시지 교환을 설명합니다. 팀원은 별도 컨텍스트를 가진 세션으로 동작하며 다른 팀원과 직접 소통할 수 있습니다. 2026년 10월 11일 확인한 문서에서는 실험 기능으로 안내합니다. 기능의 제공 상태와 설정 방법은 사용하는 Claude Code 버전에서 다시 확인할 내용입니다.

병렬로 진행할 수 있는 조사는 팀 작업에 맞지만, 앞 단계의 결과가 있어야 다음 단계를 시작할 수 있는 일은 의존 관계가 남습니다. 같은 버그를 서로 다른 파일에서 조사하더라도 최종 수정은 한곳에 모아 충돌 여부를 확인할 수 있습니다. 작업자 수를 늘리면 모든 일이 같은 비율로 빨라지는 것은 아니며, 지시 전달과 결과 통합에 드는 시간도 함께 생깁니다.

하위 에이전트와 팀원의 차이

Claude Code의 하위 에이전트 문서는 하위 에이전트가 별도의 컨텍스트에서 특정 일을 수행하고 결과를 주 대화에 반환하는 구조를 설명합니다. 많은 검색 결과나 로그를 주 대화에 모두 넣지 않고 필요한 요약을 돌려받는 데 쓸 수 있습니다. 별도 컨텍스트를 사용한다는 공통점이 있어도 팀의 공유 작업과 팀원 간 소통이 모두 같은 방식으로 제공되는 것은 아닙니다.

팀 구성은 여러 작업자가 서로 논의해야 하는 조사나 병렬 구현에 맞을 수 있습니다. 주 작업자가 한 가지 질문만 맡기고 답을 회수하면 되는 경우에는 하위 에이전트 호출로 범위를 충분히 나눌 수도 있습니다. 도구마다 팀과 하위 에이전트라는 이름이 가리키는 권한과 생명주기는 다릅니다. 한 제품의 용어를 다른 제품의 동일한 기능 보장으로 옮기지 않습니다.

멀티 에이전트 시스템은 여러 에이전트가 상호작용하는 더 넓은 시스템 범주입니다. 에이전트 팀은 그 안에서 협업 작업을 조직하는 구성이나 특정 제품 기능으로 이해할 수 있습니다. 팀이라는 이름만으로 구성원들이 서로 다른 모델이라는 뜻도 정해지지 않습니다. 같은 모델을 쓰더라도 담당 입력과 작업 범위, 도구 권한에 따라 역할이 나뉩니다.

파일 충돌과 검수 책임

공유 저장소에서 팀원 둘이 같은 파일을 동시에 수정하면 각자 읽은 기준 내용이 달라질 수 있습니다. Claude Code 팀 안내는 파일 소유 범위를 나누어 충돌을 줄이는 방법을 설명합니다. 조사 결과를 별도 파일로 남기고 최종 통합 담당자가 확인하면 어떤 작업자의 변경인지 추적하기 쉽습니다. 파일 저장 성공만으로 다른 팀원의 수정까지 보존됐다고 보지는 않습니다.

팀원의 완료 메시지는 검수할 결과가 준비됐다는 신호로 읽습니다. 주장에 연결된 원문, 변경한 파일, 실행한 시험과 남은 제한을 함께 받아야 통합 담당자가 실제로 확인할 수 있습니다. 여러 작업자가 같은 잘못된 전제를 물려받으면 결과가 서로 비슷해도 정확성의 독립 증거가 되지 않습니다. 검수는 작업자 수보다 근거를 다시 읽고 결과를 확인하는 절차에 달려 있습니다.

비용과 실행 권한도 팀 단위로 정리할 대상입니다. 각 세션이 사용하는 컨텍스트와 도구 호출이 합쳐지므로 단일 작업의 비용만으로 전체를 판단하기 어렵습니다. 외부에 글을 발행하거나 데이터를 바꾸는 작업은 역할 배정과 별도로 허용 범위를 확인합니다. 팀 리더가 최종 결과와 미완료 항목을 함께 모으면 개별 작업의 완료와 전체 요청의 완료를 구분할 수 있습니다.