혼자 공부하는 바이브 코딩 with 클로드 코드 (6)
인프런 완독 챌린지 책 읽고 강좌 보고, 요약정리 + 실습 기록
Chapter 07 클로드 코드 AI 에이전트로 개발팀 구성하기
AI 에이전트를 구성해서 직렬/병렬로 프로젝트를 진행할 수 있음.
에이전트 구성방법이 /agents 명령어에서 자연어로(대화로) 생성하는 방식으로 바뀜 (버전올라가면서 바뀜)
프로젝트 전용 에이전트, 범용 에이전트를 구성할 수 있음
직접 파일을 작성하거나, 클로드 코드에 요청해서 생성
.claude/agents/ 경로 하위에 MD 파일로 만들어짐 (name, description, tools, model)
실습용 프로젝트니까 복잡하게 만들지 않도록 프롬프트 지시(시간 절약, 토큰 절약!)
 |
| 실습 프로젝트용 CLAUDE.md 설정이 잘 동작 했다 |
다중 에이전트 구성의 장단점을 Claude에게 물어보고 들은 답변
(프롬프트: 클로드 코드에서 다중 에이전트를 구성해서 작업할때 얻는 이득이 뭘까? 장단점을 설명해줄래? 방금 장/단점을 요약해서 md 파일 표 형태로 작성해줘.)
Claude Code 다중 에이전트(Multi-Agent) 장단점 요약
장점
| 구분 |
내용 |
| 컨텍스트 창 확보 |
서브에이전트마다 독립된 컨텍스트·작업 디렉토리·도구 접근 권한을 가져서, 대형 코드베이스 탐색 시 메인 에이전트의 컨텍스트를 아끼고 추가 컨텍스트 창을 확보할 수 있음 |
| 병렬 처리로 속도 향상 |
여러 태스크를 동시에 실행해 조사·분석 시간을 단축. 모듈별로 에이전트를 나누거나 리팩토링을 독립적인 청크로 쪼개 병렬 처리 가능 |
| 역할 분담 및 전문화 |
분석 담당/실행 담당처럼 역할을 분리하고, 에이전트마다 커스텀 시스템 프롬프트와 별도의 도구·권한을 설정해 특화된 작업(디버깅, 보안 분석, 스타일 정리 등)에 집중시킬 수 있음 |
| 교차 검증 |
여러 에이전트가 서로의 결과물에 이의를 제기하며 조정하는 구조를 만들 수 있어, 한 에이전트의 오류를 다른 에이전트가 잡아줄 여지가 있음 |
단점 / 리스크
| 구분 |
내용 |
| 토큰 비용 증가 |
단일 에이전트 워크플로우보다 비용이 상당히 높음 — 에이전트마다 컨텍스트를 새로 채우므로 비용이 배가됨 |
| 파일 충돌 문제 |
여러 에이전트가 같은 파일을 동시에 수정하면 충돌 위험. worktree로 격리하거나 각 에이전트가 서로 다른 파일 집합을 소유하도록 작업을 나눠야 함 |
| 조율 오버헤드 |
복잡한 팀 역학이 진행을 늦출 수 있음. 파일 수정이 들어가는 작업은 병렬보다 단일 실행이 더 안전하다는 실전 의견도 있음 |
| 실험적 기능 |
Agent Teams는 아직 연구 프리뷰 단계라 거친 부분(버그, 불안정성)이 있을 수 있음 |
| 문서화 부담 |
서브에이전트가 프로젝트 맥락(API 스펙 등)을 충분히 모르면 검증 단계가 누락되는 등 문제가 생겨, 문서(.md)를 계속 보완해야 하는 별도 작업이 필요함 |
실전 팁
- 조사/분석 작업 → 병렬 권장: 코드 탐색, 파일 검색, 리서치성 작업은 안전하게 병렬화 가능
- 파일 수정 작업 → 병렬 신중히: worktree로 격리하거나 각 에이전트의 담당 파일 범위를 명확히 구분
- 깊은 중첩은 지양: 서브에이전트 중첩 깊이 제한(5단계)이 있고, 깊어질수록 관리가 어려워짐
Chapter 07 실습 (에이전트 생성, 활용해서 프로젝트 구현)
- 에이전트들 생성 (저자님이 제공한 7장-서브에이전트-보완자료.pdf 참고해서 실습)
- 냉장고를 부탁해 App 코드 리뷰 에이전트(code-bug-analyzer)에게 코드 리뷰 요청하고 수정
 |
| 코드 리뷰 에이전트 활용 |
- AI 공감 다이어리 프로그램
- CLAUDE.md 작성할 때 학습용 프로젝트니까 기술 스택 최소화, 라이브러리 사용 최소화하라고 지시함
- 그 결과 서버 기동도 필요 없고, 결과물이 index.html 한 개만 나옴
- + 에이전트 생성하면 클로드 코드를 재시작해야 정상 적용됨(에이전트를 안쓴듯)
 |
| AI 공감 다이어리 앱 |
- PDF 문서 요약 프로그램
- 같은 프로젝트 폴더에서 진행해서 PRD.md, index_pdf.html 파일 두 개만 나옴
- Claude Code 재시작해서 정상적으로 에이전트가 활용되서 구현됨
 |
| 에이전트 활용을 통한 구현 실습 |
 |
| AI PDF 문서 요약 앱 |
Chapter 07 클로드 코드 AI 에이전트로 개발팀 구성하기
07-1 클로드 코드의 AI 에이전트 이해하기
- 에이전트: 목표와 규칙에 따라 스스로 판단하고 작업을 수행하는 AI 대리 프로그램
- AI 서브 에이전트: 특정 작업을 전문적으로 수행하도록 만든 독립형 AI 도우미, 작업을 직렬 혹은 병렬로 처리 가능하다.
- 에이전트별로 모델(sonnet, opus 같은 AI 모델) 선택 가능
- 세밀한 권한 설정, 작업 맥락 유지
- 서브 에이전트를 이용해 AI 에이전트를 역할 분담하고 구성해 협업하는 팀 단위 프로젝트를 진행할 수 있다
07-2 AI 에이전트로 소프트웨어 개발 자동화하기
- 역할별 서브 에이전트 유형들 책에서 나온 예시 (본인의 프로젝트에 맞춰 역할을 분할하고 협업하도록 구성)
- 코드리뷰(code-bug-analyzer): 버그 찾기, 규칙 위반 점검, 개선점 제안
- 최적화(performance-optimizer): 프로그램의 속도, 자원 사용, 효율성을 향상시키는 성능 개선
- UX 디자인(ux-design-advisor): 사용자가 쉽고 편리하게 이용할 수 있도록 인터페이스 설계
- 제품 기획(product-manager-prd): PRD 작성, 제품의 목표와 기능, 사용자 요구사항을 정의하고 개발 일정 관리
- 백엔드(backend-architect): 서버 구축, 데이터베이스 설계 등 핵심 로직 구현
- 프런트엔드(frontend-developer): 사용자가 보는 화면과 인터페이스를 설계하고 제작
- 품질 보증 엔지니어(qa-engineer): QA, 버그 찾기, 성능 테스트
- AI 통합 전문가(ai-integration-specialist): AI 모델을 개발하거나, 기존 AI 모델을 최적화해 프로젝트에 맞는 AI 솔루션을 구현
- 에이전트 협업: 에이전트를 역할별로 나누고 에이전트 팀을 구성해 프로젝트를 협업하며 완성하는 방식
댓글
댓글 쓰기