Claude Code 가이드 #5 — 에이전트 & 서브에이전트
Multi-Agent 코드 리뷰 시스템, 에이전트 파일 구성, 병렬 실행과 결과 취합.
Claude Code의 에이전트 시스템을 활용하면 복잡한 작업을 여러 하위 에이전트에게 위임할 수 있습니다. 코드 리뷰, 테스트 작성, 문서 생성을 병렬로 실행하여 생산성을 극대화합니다.
에이전트란?
Claude Code에서 에이전트는 특정 역할을 가진 AI 인스턴스입니다. 메인 에이전트가 작업을 분할하고, 서브에이전트에게 위임하여 병렬 처리합니다.
- 보안 리뷰 에이전트: 취약점, 인증 이슈 검토
- 성능 리뷰 에이전트: N+1 쿼리, 메모리 누수 검토
- 스타일 리뷰 에이전트: 코딩 컨벤션, 네이밍 검토
에이전트 파일 구성
에이전트는 마크다운 프론트매터로 정의됩니다. --agent 플래그로 실행합니다.
에이전트 파일 예시 (security-reviewer.md)--- name: Security Reviewer model: claude-sonnet-4-6 tools: - read_file - search --- # 역할 코드의 보안 취약점을 검토합니다. # 체크리스트 - SQL 인젝션 - XSS - 인증/인가 이슈 - 하드코딩된 시크릿
병렬 실행과 결과 취합
병렬 리뷰 실행claude --agent security-reviewer.md review src/ claude --agent performance-reviewer.md review src/ claude --agent style-reviewer.md review src/
각 에이전트의 결과를 메인 에이전트가 취합하여 종합 리뷰 보고서를 생성합니다. GitHub Actions와 연동하면 PR마다 자동 리뷰가 가능합니다.
다음 편에서는 GitHub Actions 연동을 다룹니다. PR 자동 리뷰와 CI/CD 통합을 설정하는 방법을 알아봅니다.
claude-code에이전트서브에이전트코드리뷰