Claude Code 신규 기능: 서브에이전트와 멀티에이전트 자동화 E2E 테스트 워크플로우
Claude Code의 새로운 '서브에이전트' 기능과 Playwright MCP를 활용해 AI 주도 E2E 테스트 자동화 워크플로우를 실습합니다. 이 영상은 서브에이전트의 개념과 생성 방법, 병렬 테스트 자동화의 실제 예시, 실제 개발 흐름에서 얻는 이점 및 한계까지 단계적으로 보여줍니다. AI 기반 소프트웨어 개발에서 자동화 테스트의 생산성을 실질적으로 높일 수 있는 실전 활용법이 핵심 포인트입니다.
1. 서브에이전트란 무엇인가? 👾
영상은 Claude Code의 서브에이전트 기능을 소개하면서 시작합니다. 서브에이전트는 특화 목적과 전문 역할을 부여받아 메인 에이전트와 분리된 독립 컨텍스트에서 동작할 수 있는 새 기능입니다.
"클로드 코드의 서브 에이전트라고 하는 것은, 특정 목적과 전문 영역을 가진 별도의 서브 에이전트를 하나 생성할 수 있는 그런 기능인데요."
기본적으로 각 서브에이전트별로 사용하는 도구도 명확히 지정할 수 있어, 성능을 높이고 역할 분리를 명확히 할 수 있습니다.
"서브 에이전트를 활용하게 되면, 기존에 메인 에이전트에서 사용하던 컨텍스트 창과 완전히 분리된 컨텍스트를 활용할 수가 있는 그런 특징이 있습니다."
이 영상의 목표는 이러한 서브에이전트를 두 종류 꾸려서, 실제 AI 기반 개발에서 중요한 E2E(End-to-End) 테스트 자동화 사례를 보여주는 것입니다.
2. 워크플로우 기획: 시나리오 분석가 + 테스터 에이전트 🧩
먼저 전체 워크플로우 구조를 그림으로 간단하게 설명합니다:
- 메인 에이전트가 두 개의 서브에이전트를 관리함.
- 첫 번째 서브에이전트: E2E 테스트 '시나리오'를 도출하는 '시나리오 분석가'
- 두 번째 서브에이전트: 도출된 시나리오별로 실제 '테스트 코드'를 작성하는 '테스터 에이전트'
"첫 번째 서브 에이전트는 E2E 테스트의 시나리오를 도출할 수 있는 시나리오 분석가 서브 에이전트를 만들어 볼 겁니다."
추가로, 테스트 시나리오가 여러 개일 경우, 각각의 테스트 시나리오에 대해 각기 독립적으로 테스트 코드를 작성할 수 있도록 병렬로 여러 테스터 서브에이전트가 생성됩니다.
"테스트 시나리오가 세 개가 있다고 하면, 세 개의 테스트 작성 에이전트가 병렬로 요청을 하게 됩니다."
이렇게 병렬 처리를 하면, 전체 테스트 작업 속도가 크게 빨라집니다.
"기존에 병렬 처리를 하지 않고 작성했을 때보다 이렇게 병렬로 처리하게 되면, 테스트 코드를 작성하는 시간이 굉장히 많이 줄어들게 됩니다."
3. Notion AI 미팅 노트와 기타 AI 기능 소개 💻
본 시연 전에 스폰서 광고로 Notion의 AI 미팅 노트 기능을 간단히 데모합니다. 이 부분은 영상의 실제 워크플로우 흐름과 직접적 관계는 없으나, 실무 활용에 도움이 될 유틸성 정보입니다.
"노션에서 AI 미팅 노트라고 하는 신규 기능이 출시가 되었는데요. 회의에서 얘기하는 모든 내용들이 다 받아쓰기가 되고, 직접 회의 내용에 대한 메모도 기록할 수 있는 공간입니다."
Notion AI 미팅 노트는 회의 자동 기록, 요약, 메모 융합, 그리고 프로젝트 검색 지원까지 다양한 기능을 제공합니다.
"음성 녹음을 기반으로 텍스트를 전사해 주고, 전사된 내용을 요약해 주는 서비스는 많지만, 직접 작성한 노트의 내용과 음성 인식을 결합해서 요약의 성능을 더 높여 주는 서비스는 거의 처음 본 거 같고요."
여러 AI 기능이 통합된 비즈니스 플랜이 월 3만원에 제공되며, 영상 설명란의 링크를 통해 바로 체험 가능하다고 안내합니다.
4. 샘플 프로젝트 설명 및 서브에이전트의 실제 정의 ⚙️
실제 시연할 샘플 프로젝트(간단한 메모장 앱)를 간략히 소개합니다.
"간단한 메모장 앱입니다. 메모가 저장되어 있고, 메모를 추가, 수정, 검색할 수 있는 기능이 있습니다."
이제, 메모장 앱에 E2E 테스트 자동화 워크플로우를 적용하기 위해 서브에이전트 파일을 만듭니다. 서브에이전트 정의 방식은 아래처럼 매우 간단합니다:
- 프로젝트 루트에 마크다운 파일로 생성
- 이름, 역할, 설명, 사용 도구, 실행 방식 등 간략 설정 가능
"서브에이전트를 만들고자 하는 프로젝트 루트 경로에 서브에이전트 마크다운 파일을 만들어주시면 되고, 그 내부에서 이름, 언제 동작하게 할지, 어떤 모델을 쓸건지, 어떤 색깔로 표시할 건지 정해줄 수 있습니다."
(1) 시나리오 분석가 서브에이전트
- 역할: Playwright MCP 활용, 웹앱 분석 후 E2E 시나리오 문서화
- 주요 업무:
- 웹페이지 분석
- 유저 플로우 파악
- 시나리오 문서화
- 우선순위 설정
"웹페이지를 분석해서 테스트 시나리오를 도출하고, 폭발적인 테스트 문서를 생성해야 할 때 이 서브 에이전트를 사용해."
(2) 플레이라이트 E2E 테스터 서브에이전트
- 역할: 위에서 도출한 시나리오를 기반으로 실제 테스트 코드 생성 및 검증, 테스트 실패 시 반복
- 주요 업무:
- 시나리오 분석 및 HTML 셀렉터 수집
- 코드 생성
- 테스트 실행 및 실패 시 재시도
"플레이라이트 MCP를 사용해서 E2E 테스트를 생성, 실행, 검증해야 할 때 이 에이전트를 사용해."
5. 실제 워크플로우 시연과 병렬 테스트의 장점 🚦
서브에이전트가 올바르게 준비됐으면, Claude Code에서 슬래시 명령어로 에이전트 등록 및 확인이 가능합니다.
-
먼저 E2E 시나리오 애널라이저 서브에이전트를 호출해 시나리오 작성을 요청:
"E2 시나리오 애널라이저 서브에이전트를 사용해서 로컬호스트 3000번 포트의 주요 사용자를 분석하고 E2E 테스트 시나리오를 만들어줘."
→ 플레이라이트 MCP로 실제 브라우저 탐색 후, 시나리오(예: 메모 생성, 조회, 수정, 삭제 등)를 문서화
-
이어서 각 테스트 시나리오별로 플레이라이트 E2E 테스터 서브에이전트를 병렬로 호출해 코드를 구현하게 요청:
"각각의 테스트 시나리오를 플레이라이트 E2E 테스터 서브에이전트를 사용해서 병렬로 구현해줘."
이렇게 하면 동시에 여러 브라우저를 띄워 테스트를 진행할 수 있어 생산성이 극대화됩니다.
"기존에 순차적으로 하나의 테스트 코드 작성이 끝나고 다음 작업으로 넘어갔을 때보다, 이렇게 서브 이전트를 여러 개 병렬로 처리하게 하면 테스트 코드를 작성하는 속도가 굉장히 많이 빨라지게 될 것 같고요."
병렬 처리의 현실적 주의점
병렬 테스트 진행 시, 에이전트 간 의존성 충돌이 발생할 수 있음을 실제 사례로 보여줍니다.
"하나에서 생성하고, 하나에서 삭제했는데 개수를 체크하는 부분에서 충돌이 발생하면서 테스트가 완료되지 않은 문제점이 있었습니다."
병렬 요청 시에는 데이터 및 상태 관리, 의존성 확인이 무엇보다 중요함을 강조합니다.
6. 개발자 역할의 변화와 멀티 에이전트 활용의 미래 🌱
영상 후반에는 멀티에이전트 시대의 개발자 역할 변화에 대해 가볍게 논의합니다.
"이제 한 명의 개발자가 하나의 에이전트를 다루는 것에서 그치는 게 아니고, 여러 개의 에이전트를 멀티에이전트로 다루는 능력을 키우는 것이 굉장히 중요할 것 같다."
현재 LLM/에이전트 성능의 한계로 무조건 다중 에이전트가 "더 낫다"고만 보긴 어렵지만, 근미래에는 멀티에이전트 운용 능력이 필수 역량이 될 것임을 시사합니다.
"실제로 혼자서 20~30개의 에이전트를 동시에 멀티에이전트로 돌리면서 서비스를 개발하는 사례들이 많이 나오고 있는 것 같습니다."
"앞으로의 개발자의 역할에서 여러 개의 에이전트를 다룰 수 있는 능력은 필수가 되지 않을까 생각합니다."
마무리
이 영상은 Claude Code의 서브에이전트 기능을 실전 예시와 함께 체험하며, 효율적인 컨텍스트 관리, 병렬 자동화의 현실적 이점과 한계, 그리고 멀티에이전트 시대의 개발 패러다임 변화까지 담았습니다.
빠르게 진화하는 AI/에이전트 개발 생태계에서 테스트 자동화와 생산성 극대화에 관심 있는 개발자라면 실무 적용을 검토해볼 만한 인사이트가 가득합니다. 🛠️✨