Claude Code Agent Teams: AI 보조 개발의 미래

여러 특화 에이전트가 작업 목록을 공유하고, 팀 리드를 통해 조율하며, 하나의 프로젝트에서 백엔드, 프론트엔드, 데이터베이스, 문서 작업을 병렬화하는 방법을 다루는 실전 가이드입니다.

업데이트됨 2026년 6월 29일 · 15분 읽다

대규모 애플리케이션이나 엔터프라이즈 환경에서는 컨텍스트가 생각보다 훨씬 빨리 차버립니다. 한 시간 전에 내린 큰 설계 결정은 아마 이미 컨텍스트에서 밀려났을 것이고, 모델이 이미 처리했던 내용을 계속 다시 설명해야 합니다. 대부분은 제대로 하고 있지만, 문제는 한 명의 어시스턴트에게 전체 팀의 일을 시키고 있다는 점입니다.

Claude Code Agent Teams는 이를 바꾸기 위해 도입되었습니다. 핵심 아이디어는 하나의 세션이 모든 일을 순서대로 처리하는 대신, 작업 목록을 공유하고 서로 직접 메시지를 주고받으며 병렬로 일을 수행하는 여러 특화 에이젠트를 띄우는 것입니다.

이 글에서는 Agent Teams가 어떻게 작동하는지, 각 특화 역할이 무엇을 하는지, 그리고 실제 소프트웨어 프로젝트에서 이들을 어떻게 조율하는지 살펴보겠습니다.

Claude Code가 처음이신가요? 오후 한나절만 투자해 기본기를 익혀 보세요: Claude Code 101 코스.

Claude Code Agent Teams란?

Claude Code Agent Teams는 여러 Claude Code 세션이 같은 프로젝트를 동시에 수행할 수 있게 하는 조정 계층입니다. 하나의 세션이 팀 리드 역할을 맡아, 업무의 특정 부분을 처리하도록 다른 세션(팀원)을 생성합니다.

각 팀원은 자체 컨텍스트 창을 가진 완전한, 독립적인 Claude Code 인스턴스로 실행됩니다. 이들은 작업 목록을 공유하고, 가능한 작업을 스스로 가져가며, 조율이 필요할 때 서로 직접 메시지를 주고받습니다.

이는 단지 터미널 탭을 몇 개 열어 각각에서 Claude를 돌리는 수준이 아닙니다. 그렇게 하면 분리된 대화창들이 서로의 진행 상황을 볼 수 없고, 누가 무엇을 하는지 합의할 수도 없습니다. 반면 에이전트 팀은 모든 세션에 작업에 대한 공유된 뷰와 소통 수단을 제공합니다. 리드가 모두의 정렬을 유지합니다.

실제로는, 더 이상 세션 간 릴레이를 직접 맡을 필요가 없다는 뜻입니다. 팀이 자체적으로 조율하고, 방향 설정과 결과 검토에만 개입하면 됩니다.

Agent Teams가 필요한 이유

단일 Claude Code 세션은 프로젝트가 충분히 커지기 전까지는 잘 동작합니다.

모든 Claude Code 세션에는 컨텍스트 창이 있고, 그 창에는 한계가 있습니다. 작업이 진행되면서 파일 내용, 명령 출력, 설계 논의, 상호 대화가 세션을 채웁니다. 어느 순간부터는 오래된 정보가 컨텍스트에 남아 있지 않게 되고, 모델은 같은 작업 내에서 먼저 내린 결정을 잊기 시작합니다.

이 문제가 두드러지는 상황은 보통 세 가지입니다.

대형 저장소: 수백 개 파일이 있는 코드베이스는 컨텍스트에 모두 담을 수 없습니다. 세션은 동일한 파일을 반복해서 읽으며, 이미 가졌던 이해를 재구성하느라 토큰을 낭비합니다.
복잡한 프로젝트: 백엔드, 프론트엔드, 테스트 전반에 인증을 추가하는 등 교차 기능은 모델이 한 번에 너무 많은 관심사를 다루게 만듭니다. 새로 추가되는 것마다 기존 모든 항목과 컨텍스트 공간을 경쟁하게 만듭니다.
동시 다중 작업: 한 세션에 기능 구현, 모듈 리팩터링, 테스트 작성, 문서 업데이트를 한 대화 안에서 모두 시키는 것은 문제를 자초하는 일입니다.

해법은 수십 년 전 인간 팀이 도달한 결론과 같습니다: 일을 나누세요.

리팩터링에서 한 세션이 한계에 부딪힌다면, 백엔드 변경은 한 팀원에게, 프론트엔드 변경은 다른 팀원에게, 테스트 업데이트는 또 다른 팀원에게 맡기세요. 각 팀원은 자신의 업무에 필요한 것만 사용합니다.

같은 아이디어는 리서치에도 적용됩니다. 세 가지 경쟁 가설이 있는 작업은 한 세션이 순차적으로 진행하는 것보다 세 명의 팀원이 각자 하나씩 병렬로 조사한 후 결과를 비교하는 편이 더 빠릅니다.

전문화는 깊이를, 병렬성은 속도를 제공합니다. 두 가지를 결합하면 단일 세션으로는 환각을 일으키거나 지나치게 오래 걸릴 작업도 수행할 수 있습니다.

Claude Code Agent Teams의 작동 방식

팀 세션은 다섯 단계를 거치며, 오케스트레이션은 Claude Code 내부에서 처리됩니다.

목표 정의: 주니어 엔지니어에게 브리핑하듯 평이한 언어로 원하는 바를 설명합니다. 리드는 이를 읽고 어떻게 분해할지 결정합니다.
업무 위임: 리드는 공유 작업 목록을 만들고, 이름, 역할, 시작 프롬프트를 가진 팀원을 생성합니다. 팀 구조를 직접 지정할 수도 있고, 리드가 스스로 결정하게 둘 수도 있습니다.
병렬 실행: 각 팀원은 작업을 가져가 진행 중으로 표시하고, 완료 후 완료로 표시합니다. 의존성은 자동으로 준수되며, 파일 잠금이 충돌을 방지합니다. 팀원들은 서로에게 직접 메시지를 보낼 수 있습니다 — 리드를 경유할 필요가 없습니다.
결과 통합: 리드는 완료된 작업을 수집하고, 충돌을 해결하여 단일 결과물(PR, 보고서, 리팩터링된 모듈 등 목표에 따른 산출물)을 만듭니다.
결과 검토: 일반적인 풀 리퀘스트처럼 최종 결과를 검토합니다: 변경 사항을 읽고, 코드를 실행하고, 테스트를 확인합니다.

Agent Teams의 특화 역할

역할은 에이전트 팀의 형태를 결정합니다. 역할이 없으면 일반 세션들이 서로 겹치는 작업을 하게 됩니다. Claude Code는 고정된 목록을 제공하지 않습니다 — 브리핑에서 역할을 정의하거나 .claude/agents/ 아래에 저장한 서브에이전트 정의를 리드에 지정하세요.

기획 에이전트

기획 에이전트는 코드가 작성되기 전에 목표를 작업으로 분해합니다. 코드베이스를 탐색하고, 의존성을 매핑하며, 지속적인 확인 없이 단일 팀원이 끝낼 수 있는 독립적인 단위의 작업 목록을 만듭니다.

실무에서는 팀 리드가 이 역할을 직접 맡는 경우가 많습니다. 업무 규모가 충분히 클 때는 전담 기획 팀원을 두어도 좋습니다.

코딩 에이전트

코딩 에이전트는 구현을 작성합니다. 대부분의 팀원은 코딩 에이전트이며, 백엔드, 프론트엔드, 데이터베이스, AI 기능 등 각기 구분된 영역을 담당합니다. 핵심은 범위가 겹치지 않도록 하는 것입니다. 두 팀원이 같은 파일을 편집하면 서로의 작업을 덮어씁니다.

코딩 에이전트는 더 저렴한 모델에서도 잘 동작합니다. 많은 실무자는 리드를 Opus로, 팀원들을 Sonnet으로 실행합니다. 실행은 조율만큼 깊은 추론이 필요하지 않기 때문입니다.

테스팅 에이전트

테스팅 에이전트는 테스트를 작성하고 실행합니다. 코딩 팀원이 엔드포인트를 구축하는 동안에도 합의된 API 계약을 기준으로 작업할 수 있어, 코드가 반영될 때 이미 테스트가 준비되어 있습니다.

또한 세션 내내 테스팅 팀원을 실행 상태로 유지해, 코딩 팀원이 작업을 완료할 때마다 테스트 스위트를 재실행하게 할 수 있습니다.

리뷰 에이전트

리뷰 에이전트는 diff를 읽고 버그, 스타일 이슈, 누락된 엣지 케이스, 보안 문제를 표시합니다. 보안과 성능처럼 서로 다른 관점으로 두 명의 팀원에게 리뷰를 분할하면 특히 효과적이며, 리드가 이들의 결과를 취합합니다.

이미 프로젝트용 서브에이전트 정의가 있다면, 팀원은 그 도구와 시스템 프롬프트를 자동으로 상속받습니다.

문서화 에이전트

문서화 에이전트는 독스트링, README 업데이트, 아키텍처 노트나 API 레퍼런스 같은 장문 문서를 작성합니다. 코딩과 테스트가 끝난 시점에는 작업의 최종 형태가 명확하므로, 마지막에 실행할 팀원으로 적합합니다.

전문화가 결과를 개선하는 이유

범용 세션은 구현, 테스트, 문서, 리뷰 피드백을 동시에 컨텍스트에 담아야 합니다. 특화된 팀원은 필요한 것만 로드하여 컨텍스트를 작게 유지하고, 추론을 집중시킵니다. 전문화는 디버깅도 쉽게 만듭니다. 문제가 생기면 확인해야 할 세션이 명확하기 때문입니다.

Agent Teams로 병렬 개발하기

병렬성은 에이전트 팀의 핵심 목적입니다.

리드가 작업을 쪼개고 팀원을 시작하면, 모두 동시에 실행됩니다. 각 팀원은 별도의 Claude Code 세션이므로 작업이 하나의 컨텍스트 창 뒤에 대기하지 않습니다. 다부분 기능의 총 소요 시간은 전체 합이 아니라 가장 느린 부분의 시간으로 줄어듭니다.

특히 병렬로 잘 맞는 조합 세 가지는 다음과 같습니다.

프론트엔드와 백엔드 병렬: 두 레이어를 모두 사용하는 새 기능을 구축할 때, 백엔드 팀원은 API 엔드포인트를, 프론트엔드 팀원은 이를 소비하는 컴포넌트를 만듭니다. 두 팀원은 직접 메시지로 조율합니다. 백엔드 팀원이 응답 형태를 정하는 즉시 프론트엔드 팀원에게 그 형태를 전달하고, 서로 완전히 끝나길 기다리지 않고 작업을 이어갑니다.
구현과 테스트 병렬: 코딩 팀원이 구현을 작성하는 동안 테스팅 팀원은 합의된 계약에 맞춰 테스트를 작성합니다. 코딩 팀원이 작업을 완료로 표시할 즈음에는 테스트가 이미 준비되어 바로 실행할 수 있습니다. 코드를 먼저 쓰고 마지막에 테스트를 추가하는 일반적인 순서보다 훨씬 빠릅니다.
문서와 코드 리뷰 병렬: 코딩 팀원이 일부 작업을 마치면, 문서화 팀원은 독스트링과 README 업데이트를 쓰기 시작하고 리뷰 팀원은 버그와 스타일 이슈를 찾기 위해 diff를 읽습니다. 서로를 막지 않으며, 두 결과 모두 리드가 통합합니다.

제한 요소는 파일 충돌입니다. 두 팀원이 동시에 같은 파일을 쓰면 서로의 작업을 덮어씁니다. 따라서 리드는 파일 또는 모듈 경계에 따라 일을 나눠야 합니다. 경계가 명확한 한, 작업 목록이 허용하는 만큼 많은 팀원을 병렬로 실행할 수 있습니다.

대규모 코드베이스를 위한 Claude Code Agent Teams

대규모 코드베이스에서는 에이전트 팀이 선택이 아니라 필수에 가깝습니다.

수백, 수천 개 파일이 있는 저장소는 단일 컨텍스트 창에 담을 수 없습니다. 대형 코드베이스를 혼자 작업하는 세션은 코드를 재발견하는 데만 예산의 상당 부분을 씁니다.

Agent Teams에서는 각 팀원이 자신의 업무와 관련된 파일만 로드하므로 팀원별 컨텍스트 창이 작고 집중된 상태로 유지됩니다. 팀 전체로는 저장소 전체를 논리적으로 다룰 수 있지만, 단일 세션이 모든 것을 담을 필요는 없습니다.

이는 특히 다음 세 가지 상황에서 중요합니다.

크로스커팅 변경: 여러 모듈의 수십 개 파일을 건드리는 리팩터링은 한 세션이 흐름을 잃지 않고 처리하기 어렵습니다. 모듈 단위로 분할해 각 모듈을 한 팀원에게 맡기면 범위를 관리하기 쉬워집니다.
저장소 전반의 감사: 대규모 코드베이스에 대한 보안 점검이나 성능 감사는 여러 팀원을 병렬로 실행해 저장소의 다른 부분을 각각 살피는 것이 효과적입니다. 리드는 이들의 결과를 하나의 보고서로 통합합니다.
장기 프로젝트: 수주에 걸친 프로젝트는 단일 세션이 담을 수 없는 컨텍스트를 축적합니다. 에이전트 팀은 작업을 체크포인트로 분할하고, 각 체크포인트를 이전 모든 내용을 기억할 필요가 없는 팀원이 맡도록 할 수 있습니다.

비용이 따릅니다.

각 팀원은 자체 컨텍스트 창을 가진 완전한 Claude Code 세션이므로, 토큰 사용량은 팀 규모에 비례해 선형적으로 증가합니다. 네 명의 팀은 동일한 작업량에 대해 단일 세션의 약 네 배 토큰을 사용합니다. 더 높게 추정하는 경우도 있습니다. 대가로 얻는 것은 더 빠른 실시간 경과와 관심사별 더 깊은 처리로, 단일 세션으로는 현실적으로 끝내기 어려운 작업에서 보통 이득이 됩니다.

프로젝트가 클수록 Agent Teams의 이점은 커집니다. 하지만 과용하지 마세요 — 작은 버그 수정에는 단일 세션이 더 저렴하고 효과적입니다.

Agent Teams와 Claude Tag

에이전트 팀만이 Anthropic이 팀 워크플로에서 AI의 역할을 재정의하는 곳은 아닙니다.

Claude Tag는 Claude를 Slack에 조직의 공동 참여자로 데려오는 별도 기능입니다. 채널에서 @Claude 를 태그하면, Claude는 조직의 도구와 채널의 컨텍스트를 사용해 작업을 수행합니다. 이미 논의한 내용을 기억하고, 스스로 후속 조치를 하며, 조직의 정체성 하에 일합니다.

두 기능은 서로 다른 조정 문제를 해결합니다. 에이전트 팀은 한 개발자의 머신에서 하나의 집중된 작업을 위해 여러 Claude Code 세션을 조율합니다. Claude Tag는 수일, 수주에 걸쳐 Slack에서 인간 팀 전반에 하나의 Claude 정체성을 조율합니다. 하지만 방향성은 같습니다. AI는 개인이 고립적으로 사용하는 도구에서 팀의 기존 워크플로 내부에서 작동하는 참여자로 이동하고 있습니다.

이는 AI가 잘해야 할 것들을 바꿉니다.

단독 어시스턴트는 강한 제너럴리스트여야 하지만, 조율된 시스템은 계획을 세우고, 인수인계를 하고, 도움을 요청하며, 다른 에이전트와 인간들과 정렬 상태를 유지하는 강한 스페셜리스트여야 합니다. 에이전트 팀은 Claude Code 워크플로에서 이를 구현하고, Claude Tag는 이를 Slack 워크플로에서 가시화합니다.

Agent Teams 구축을 위한 모범 사례

좋은 에이전트 팀 설정은 대부분 초기에 달려 있습니다. 팀 자체는 빠르지만, 범위가 불명확한 작업과 모호한 역할에서 시간이 낭비됩니다.

다음은 몇 가지 모범 사례입니다.

역할을 명확히 정의: 각 팀원은 하나의 초점과 자신이 소유한 파일 집합을 가져야 합니다. 팀원을 만들 때, 정확히 무엇을 책임지는지, 무엇은 책임지지 않는지, 어떤 파일이나 모듈을 다룰 수 있는지 알려주세요. 모호한 역할은 겹치는 작업을 낳고, 겹치는 작업은 머지 충돌을 낳습니다.
병렬화 전에 작업 분해: 먼저 계획하고, 그다음 병렬화하세요. 입력, 출력, 의존성이 명확한 작업으로 나누는 기획 단계를 거친 뒤, 실행을 팀에 맡기세요. 계획에는 수천 토큰이 들지만, 잘못된 방향으로 가는 팀은 수십만 토큰이 들 수 있습니다.
CLAUDE.md로 표준 공유: 모든 팀원은 시작 시 작업 디렉터리의 CLAUDE.md 파일을 읽습니다. 코드 스타일, 파일 구조, 테스트 방식, 커밋 메시지 형식 등 공통 관례를 여기에 넣어 두세요.
리뷰 체크포인트 마련: 팀원 진행 상황을 점검하고, 벗어난 팀원은 방향을 수정하며, 승인 전 리드의 출력을 검토하세요. 위험한 작업에는 계획 승인 요구를 설정해, 팀원이 변경 전에 계획을 먼저 제시하고 리드 승인을 기다리게 하세요.
팀 규모 제한: 대부분의 워크플로에서는 3~5명의 팀원으로 시작하세요. 그 이상에서는 조율 오버헤드가 병렬 속도 향상보다 더 빨리 커집니다.
파일 충돌 회피: 파일이나 모듈 경계에 따라 작업을 분할해 각 팀원이 명확히 분리되도록 하세요. 두 팀원이 같은 파일을 편집하면 서로의 변경을 덮어씁니다. 정말 같은 파일을 여러 팀원이 건드려야 하는 작업이라면 병렬 대신 순차로 진행하세요.
공통 작업 사전 승인: 팀원으로부터의 권한 요청은 리드로 올라오며, 4명의 팀이 있으면 프롬프트도 4배가 될 수 있습니다. 팀을 시작하기 전에 permissions.allow 목록을 설정해, 파일 읽기나 테스트 실행 같은 일상 작업이 진행을 방해하지 않도록 하세요.
역할에 맞는 모델 매칭: 조율에는 더 깊은 추론이 유리하므로 리드는 Opus 같은 강력한 모델로, 실행은 Sonnet으로 운영하세요.

요약하면 이렇습니다. 상세한 작업 계획을 만들고, 소규모 주니어 엔지니어 팀을 브리핑하듯 팀을 브리핑하며, 명확한 범위와 공유 표준을 제공하고, 마지막에 작업을 점검하세요. 실제 엔지니어링 팀이 운영되는 방식에 가까울수록 에이전트 팀의 성과가 좋아집니다.

실전: Claude Code Agent Team

처음부터 끝까지 전체 흐름을 보겠습니다.

작은 예제를 진행하겠습니다. SQLite 데이터베이스에서 메시지를 읽는 FastAPI 기반 "hello world" REST API와 API를 호출해 결과를 보여주는 아주 작은 HTML 페이지입니다. 이 앱은 백엔드 라우트, 데이터베이스 레이어, 정적 프론트엔드, 그리고 README 문서를 포함하므로 네 명 팀에 잘 맞습니다.

에이전트 팀 활성화

에이전트 팀은 실험적 기능이며 기본적으로 꺼져 있습니다. 셸 또는 Claude Code 설정 파일에서 환경 변수를 설정해 활성화합니다.

설정 파일 위치는 ~/.claude/settings.json 입니다. 열어 다음을 추가하세요:

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

설정 파일을 편집하고 싶지 않다면, Claude Code를 시작하기 전에 셸에서 변수를 설정할 수도 있습니다:

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

어느 방식이든 동작합니다. 변수가 설정되면, Claude Code는 팀 관련 프롬프트를 인식하고 요청 시 조정 계층을 시작합니다.

Claude Code를 시작하고 팀을 브리핑

프로젝트용 빈 디렉터리를 만들고 그 안에서 Claude Code를 시작하세요:

mkdir hello-api && cd hello-api
claude

이제 팀을 브리핑합니다. 프롬프트는 자연어이지만, 역할과 경계를 구체적으로 정의할수록 팀의 성과가 좋아집니다. hello world API를 위한 프롬프트는 다음과 같습니다:

Create an agent team to build a small "hello world" REST API.

The project is a FastAPI service that returns a greeting from a SQLite
database, plus a tiny HTML page that calls the API and shows the result.
- One teammate on the database: create app/db.py with a sqlite3 connection
  to a greetings.db file. Define a get_greeting() function that returns
  the message column from the first row. On import, create the table if
  it doesn't exist and seed it with "Hello, World!" if empty.
- One teammate on the backend: build a FastAPI app in app/main.py with
  a GET /greeting endpoint that calls get_greeting() from app/db.py.
  Add permissive CORS and mount the static/ directory at the root so
  the HTML page is served from the same origin.
- One teammate on the frontend: build static/index.html as a single page
  that fetches /greeting on load, shows a spinner while loading, displays
  the greeting in a centered card on success, and shows an error message
  on failure. Inline the CSS and JavaScript.
- One teammate on docs: write README.md with installation, run, and
  open-in-browser steps, plus an API reference table. Also create
  requirements.txt with fastapi and uvicorn[standard].
Use Sonnet for each teammate. Require plan approval before any teammate
makes changes.

이 프롬프트에서 주목할 점은 세 가지입니다. 파일 경계(app/db.py, app/main.py, static/index.html, README.md, requirements.txt)가 겹침을 방지합니다. 모델 선택(Sonnet)은 토큰 비용을 관리 가능하게 유지합니다. 그리고 plan approval 은 각 팀원이 코드를 작성하기 전에 계획을 제시하도록 강제해, 브리핑을 오해한 팀원을 수정할 체크포인트를 제공합니다.

팀의 진행을 지켜보기

프롬프트를 제출하면, 리드는 작업을 분해하고 팀원을 시작합니다. 터미널 하단에 팀원별 한 줄씩 표시되는 에이전트 패널이 나타납니다.

생성된 에이전트

각 행에는 팀원의 이름과 현재 작업이 표시됩니다. 리드는 공유 작업 목록을 채우고, 의존성에 따라 작업을 할당하거나 해제합니다. 백엔드 팀원은 get_greeting() 을 가져오기 때문에 데이터베이스 레이어를 기다립니다. 문서 팀원은 나머지가 충분히 진행되어 정확히 설명할 수 있을 때까지 기다립니다.

작업 목록도 볼 수 있습니다. Ctrl+T 를 눌러 토글하세요. 목록에는 모든 작업, 상태(대기, 진행 중, 완료), 담당 팀원이 표시됩니다.

팀원 간 이동

각 팀원은 전체 Claude Code 세션이며, 누구와도 대화할 수 있습니다.

에이전트 패널에서 위아래 화살표로 팀원을 선택하고 Enter 를 눌러 해당 팀원의 대화 기록을 엽니다. 이제 그 팀원의 세션에 들어와 있으며, 입력하는 내용은 리드가 아니라 그 팀원에게 전달됩니다. 이를 통해 나머지 팀을 개입시키지 않고 특정 팀원에게 추가 컨텍스트를 제공하거나 접근 방식을 수정할 수 있습니다.

Esc 를 눌러 리드로 돌아옵니다.

벗어난 팀원 리다이렉션

때로는 팀원이 브리핑을 잘못 이해하거나 하지 말아야 할 작업으로 벗어날 수 있습니다. 계획 승인 단계에서 팀원의 계획을 확인하거나 에이전트 패널에서 진행이 엇나감을 보고 이를 파악합니다.

계획 승인을 사용하는 경우, 팀원은 계획 후 일시 정지하고 파일을 작성하기 전에 제안을 보여줍니다. 데이터베이스 에이전트의 예시는 다음과 같습니다.

데이터베이스 에이전트 승인

제안된 스키마와 접근 방식을 읽고, 승인하거나 피드백을 달아 거절할 수 있습니다. 계획에 빠진 것이 있다면 "원시 sqlite3 대신 SQLAlchemy를 사용하세요"처럼 답하면 팀원이 다시 계획을 세웁니다.

팀원이 이미 작업을 시작한 뒤 문제를 발견했다면, 에이전트 패널에서 해당 팀원을 선택하고 Enter 를 눌러 세션을 열고 메시지를 보내세요. 선택한 팀원에서 x 를 눌러 중지할 수도 있고, 현재 팀원이 완전히 막힌 경우 리드에게 대체 팀원을 시작하도록 요청할 수도 있습니다.

마무리 및 검토

모든 팀원이 작업을 마치면, 리드는 간단한 요약과 프로젝트 실행에 필요한 명령을 보고합니다.

최종 리드 지시사항

이제 작업을 검토합니다. 에디터에서 생성된 파일을 열고 diff를 읽어보세요.

생성된 app/main.py 파일

또한 데이터베이스 에이전트가 생성하고 시드한 데이터베이스를 확인할 수 있습니다.

greetings 테이블

그런 다음 의존성을 설치하고 uvicorn app.main:app --reload 를 실행한 뒤, 브라우저에서 http://localhost:8000 를 열어 전체 스택이 엔드 투 엔드로 동작하는지 확인하세요.

최종 앱

변경을 원한다면, 리드에게 조정할 내용을 알려주세요. 리드는 직접 수정하거나 새 팀원을 시작해 처리합니다. 결과에 만족하면 리드에게 변경 사항 커밋을 요청할 수 있습니다. 세션이 끝나면 리드는 팀원을 종료하고 팀 구성은 정리됩니다.

이것으로 끝입니다!

맺음말

Claude Code Agent Teams의 핵심은 두 가지입니다: 전문화와 조정. 각 팀원은 자신만의 업무 범위와 컨텍스트 창을 갖습니다. 리드는 정렬을 유지하고, 작업 목록은 동기화를 보장하며, 직접 메시지는 세션 간 정보를 전달하느라 사용자를 기다리게 하지 않습니다.

더 큰 그림에서 AI 보조 개발은 개인에서 조율된 형태로 이동하고 있습니다. 에이전트 팀은 그 변화가 오늘 Claude Code에서 드러나는 방식이며, 같은 패턴이 Slack용 Claude Tag에서도 나타나고 있습니다. 지금 이에 익숙해지는 개발자는 컨텍스트 한계에 덜 시달리고 실제 기능을 만드는 데 더 많은 시간을 쓰게 될 것입니다.

생성형 AI 자격증을 찾고 계신가요? 최고의 코스, 준비 팁, FAQ를 포함한 2026년 최고의 생성형 AI 자격증을 확인하세요.