공식문서: https://code.claude.com/docs/ko/sub-agents

서브에이전트

특정 유형의 작업을 처리하는 특화된 AI 어시스턴트.

서브에이전트 만들기

/agents
> create new agent

(프롬프트)
코드리뷰를 전문으로 하는 서브에이전트를 만들어줘.
해당 서브에이전트는 코드 구현이 완료된 후에 동작하게 해줘.

서브에이전트 사용하기

(프롬프트)
code-review-expert 서브에이전트로 전체 프로젝트 코드리뷰를 해줘.

(결과)
⏺ code-review-expert 서브에이전트의 종합적인 코드 리뷰가 완료되었습니다.

  📊 리뷰 요약                
  프로젝트는 아키텍처 패턴과 인증 체계는 견고하지만, 보안과 코드 품질 면에서 개선이 필요한 상태입니다. 
  
  🔴 즉시 수정 필요 (보안)   
  1. Redis 세션 삭제 엔드포인트 인증 없음 - /super/sessionclear에 권한 검증 추가         
  2. 파일 업로드 형식 검증 없음 - MIME 타입 필터 추가        
  3. 세션 쿠키 보안 속성 미설정 - secure, sameSite 추가    
  4. 민감 정보 로그 노출 - console.log('mfaRes') 제거 
  
  🟡 주요 개선사항
  - XSS 방지를 위해 dangerouslySetInnerHTML에 DOMPurify 적용   
  - useTimer 훅 메모리 누수 (useRef 적용 필요)
  - Sentry captureException() 직접 호출 부족  
  - window.location.reload() 과다 사용 (20곳+)
  
  🟢 우수 사례
  - 서버 사이드 세션 검증이 철저함 (96/101 페이지)  
  - RSA2048 암호화로 비밀번호 보호
  - API 호출 레이어 잘 추상화됨  
  - 커스텀 훅으로 폼 상태 관리 효율적 
  
  📋 우선순위별 액션 플랜     
  상세 리뷰 내용을 참고하여 보안 이슈부터 순차적으로 개선해주세요. 필요하면 특정 파일의 수정을 도와드릴 수 있습니다.    

서브에이전트 특징

• 서브에이전트는 자체 컨텍스트에서 동작한다. 결과만 요약해서 메인 컨텍스트로 넘겨준다.
  • 메인 대화를 오염시키지 않는다!
  • 테스트 실행, 문서 가져오기 또는 로그 파일 처리는 상당한 컨텍스트를 소비할 수 있습니다.
    이를 subagent에 위임하면 자세한 출력이 subagent의 컨텍스트에 유지되고 관련 요약만 주 대화로 반환됩니다.

서브에이전트 체이닝

여러 단계 워크플로우의 경우, Claude에 subagent를 순차적으로 사용하도록 요청할 수 있다.
각 subagent는 작업을 완료하고 결과를 Claude에 반환하고, Claude는 관련 컨텍스트를 다음 subagent에 전달한다.

(프롬프트)
code-review-expert 서브에이전트를 사용해서 퍼포먼스 이슈를 찾아줘. 
그 다음에 optimizer-expert 서브에이전트로 이슈들을 수정해줘.

사용 팁!

• 작업 초반에 서브에이전트를 활용하자.