나만의 AI 서브에이전트 만들기
5가지 실전 예제로 배우는 AI 에이전트 활용법. 특정 목적과 역할을 가진 전문 AI 조수를 만들어 일과 삶의 질을 높여보세요.
🎯 AI 서브에이전트란?
특정 목적과 역할을 가진 전문 AI 조수로, 당신의 필요에 맞춰 맞춤형 도움을 제공합니다.
🚀 왜 필요한가?
- 반복적인 업무 자동화
- 전문 분야의 깊이 있는 조언
- 개인화된 솔루션 제공
- 생산성 극대화
Subagents란 무엇인가?
Claude Code의 강력한 Subagents 기능 이해하기
🎯 정의와 개념
- 특정 역할이나 전문성을 가진 보조 AI 에이전트
- 메인 대화 흐름과 별개의 컨텍스트 창을 가짐
- 고유한 시스템 프롬프트, 도구 세트, 모델 구성 가능
- Claude Code가 자동 또는 명시적으로 호출 가능
⭐ 주요 이점
- 컨텍스트 보존: 독립된 작업 공간으로 메인 대화 복잡성 감소
- 전문성 강화: 역할별 특화된 지침과 도구로 성공률 향상
- 재사용성: 한 번 정의하면 여러 프로젝트에서 공유 가능
- 권한 제어: 필요한 도구만 허용하여 보안 및 책임 분리
🔧 동작 방식
정의
Markdown 파일로 역할과 기능 명시
호출
자동 위임 또는 명시적 호출
실행
독립된 컨텍스트에서 전문 작업 수행
첫 번째 서브에이전트 생성하기
단계별 가이드로 나만의 AI 서브에이전트 만들기
1️⃣ 서브에이전트 인터페이스 열기
다음 명령을 실행하세요:
/agents
2️⃣ 'Create New Agent' 선택
- 프로젝트 수준 또는 사용자 수준 서브에이전트를 생성할지 선택하세요
- 프로젝트 수준: 해당 프로젝트에서만 사용
- 사용자 수준: 모든 프로젝트에서 공통으로 사용
3️⃣ 서브에이전트 정의
권장사항:
먼저 Claude로 생성한 다음 맞춤화하여 자신만의 것으로 만드세요
상세 설명:
서브에이전트를 자세히 설명하고 언제 사용해야 하는지 명시하세요
도구 선택:
접근 권한을 부여할 도구를 선택하세요 (또는 모든 도구를 상속받으려면 비워두세요)
편집 팁:
Claude로 생성하는 경우 e를 눌러 자체 편집기에서 시스템 프롬프트를 편집할 수도 있습니다
4️⃣ 저장 및 사용
이제 서브에이전트를 사용할 수 있습니다! Claude는 적절할 때 자동으로 사용하거나 명시적으로 호출할 수 있습니다:
> code-reviewer 서브에이전트를 사용하여 최근 변경사항을 확인해주세요
사용 방식 및 예시 Subagent
실제 사용 방법과 실용적인 예제들
🚀 Subagent 호출 방식
자동 위임 (Automatic Delegation)
- Claude Code가 요청 문맥과 description 기반으로 자동 선택
- "use proactively" 또는 "MUST BE USED" 표현으로 적극 위임 유도
- 예: "코드 리뷰해줘" → code-reviewer 자동 호출
명시적 호출 (Explicit Invocation)
- 사용자가 직접 subagent 이름을 요청문에 명시
- 예: "Use the code-reviewer subagent to check my changes"
- 정확한 제어가 필요할 때 사용
📋 예시 Subagent들
역할: 코드 품질, 보안, 유지보수성 중심 리뷰
도구: Read, Grep, Glob, Bash
모델: inherit
작동 예: git diff 분석, 우선순위 기준 피드백 제공
역할: 오류, 테스트 실패, 비정상 동작 진단
도구: Read, Edit, Bash, Grep, Glob
절차: 에러 메시지 → 재현 단계 → 원인 분석 → 최소 수정 → 검증
역할: 데이터 분석, SQL 쿼리 작성, BigQuery 활용
도구: Bash, Read, Write
모델: sonnet
행동 흐름: 요구사항 이해 → 쿼리 작성 → 분석 → 요약 보고
💡 활용 팁 및 권고사항
설계 원칙
- Claude로 직접 생성하고 커스터마이즈
- 단일 책임 방식으로 역할 설계
- 구체적 지침, 제약, 예시 포함
- 도구 접근은 최소한으로 제한
관리 방법
- 프로젝트 subagent는 버전 관리에 포함
- 팀원들과의 공유 및 협업
- 정기적인 성능 평가 및 개선
- 문서화와 테스트 유지
고급 활용 및 성능 고려사항
복잡한 작업을 위한 고급 기법과 최적화 전략
🔗 서브에이전트 체이닝 (Chaining)
복합 작업 시 여러 subagent를 순차적으로 호출하여 전문성의 시너지 효과 창출
예시: 코드 개선 워크플로우
코드 분석
code-reviewer
최적화
optimizer
문서화
documenter
🎯 동적 Subagent 선택
자동 판단 메커니즘
- Claude Code가 문맥 기반으로 적합한 subagent 판단
- description 필드의 구체성과 행동 지향성 중요
- 요청의 복잡도와 전문 분야 매칭
선택 최적화 팁
- description에 키워드 포함 (예: "security", "performance")
- 사용 시나리오를 구체적으로 명시
- 호출 조건을 명확하게 정의
⚡ 성능 및 비용 고려사항
긍정적 요소
- 컨텍스트 효율성: 메인 대화 깔끔하게 유지
- 전문성 집중: 특정 분야의 성공률 향상
- 재사용성: 반복 작업의 일관성 향상
- 유지보수성: 모듈화된 관리 용이
주의사항
- 지연 시간: 호출마다 초기 설정 및 문맥 로드 필요
- 비용 증가: 여러 모델 호출로 인한 비용 상승
- 복잡성: 과도한 subagent 생성으로 관리 부하
- 의존성: subagent 간 의존성 관리 필요
📚 최종 정리 및 참고자료
핵심 원칙
- 단일 책임 원칙 + 최소 권한 원칙 준수
- 문서화, 버전 관리, 팀 공유 중요
- 필요한 경우에만 생성, 과도한 분산 방지
- 지속적인 성능 평가 및 개선
관련 문서
- Slash commands 문서
- Hooks 설정 가이드
- MCP 도구 문서
- Claude Code Best Practices
나만의 여행 플래너 ✈️
개인의 취향과 조건에 맞춰 완벽한 여행 계획을 세워주는 전문가
🎯 주요 역할
- 예산과 기간에 맞는 여행 코스 추천
- 개인 취향 반영한 맞춤 일정
- 숙소, 교통편, 맛집 종합 계획
- 현지인 추천 명소 안내
⭐ 주요 기능
- 일자별 상세 여행 일정 제안
- 예산에 맞는 교통편, 숙소 추천
- 현지 맛집 및 숨은 명소 리스트
- 여행 스타일에 맞는 활동 추천
📝 시스템 프롬프트 예시
너는 5년 차 여행 전문 가이드야. 내가 '파리 3박 4일' 여행 계획을 짜달라고 하면, 아래 조건에 맞춰서 일정을 제안해 줘.
- 여행 스타일: 박물관과 미술관 관람을 좋아하지만, 너무 빡빡하지 않게 여유롭게 다니고 싶어.
- 예산: 1인 하루 식비 10만 원 이내.
- 필수 포함: 에펠탑, 루브르 박물관은 꼭 가보고 싶어. 현지인들이 자주 가는 빵집도 추천해 줘.
독서 도우미 서평가 📚
책의 핵심 내용을 깊이 있게 이해하고, 나만의 서평을 쓸 수 있도록 도와주는 파트너
🎯 주요 역할
- 책의 핵심 내용 체계적 요약
- 깊이 있는 독서를 위한 질문 제공
- 인상 깊은 구절 해석 및 분석
- 다양한 형식의 서평 작성 도움
⭐ 주요 기능
- 책 핵심 내용 및 줄거리 요약
- 인상 깊은 구절에 대한 해석 제공
- 토론 및 생각을 확장할 질문 제시
- 지정된 형식에 맞는 서평 초안 작성
📝 시스템 프롬프트 예시
너는 통찰력 있는 서평가야. 내가 '데일 카네기의 인간관계론'을 읽고 블로그에 올릴 서평을 쓰려고 해.
이 책의 핵심 교훈 3가지를 요약하고, '일상에서 바로 적용해 볼 수 있는 방법'에 대한 내용을 포함해서 500자 내외의 서평 초안을 작성해 줘. 친근하고 설득력 있는 말투를 사용해 줘.
콘텐츠 기획자 💡
복잡한 아이디어를 구체적인 콘텐츠로 만들어내는 창의적인 기획 전문가
🎯 주요 역할
- 주제 기반 콘텐츠 아이디어 발굴
- 타겟 독자에 맞는 기획안 작성
- 매력적인 제목과 구조 설계
- 콘텐츠 제작 방향성 제시
⭐ 주요 기능
- 타겟 독자를 고려한 콘텐츠 아이디어 제안
- 매력적인 제목 및 소제목 아이디어 생성
- 콘텐츠의 상세 목차 및 구조 설계
- 각 파트별 핵심 내용 및 자료조사 방향 제시
📝 시스템 프롬프트 예시
너는 IT 트렌드에 밝은 콘텐츠 기획 전문가야. '비개발자를 위한 클로드 활용법'이라는 주제로 유튜브 영상을 만들려고 해.
사람들이 가장 궁금해할 만한 내용으로 구성된 5분짜리 영상 시나리오를 작성해 줘. 도입부(1분), 핵심 내용(3분), 마무리(1분)로 구성하고, 각 파트별로 어떤 화면을 보여주면 좋을지 아이디어도 함께 제시해 줘.
맞춤형 식단 및 레시피 코치 🥗
'오늘 뭐 먹지?'라는 고민을 해결해 주는 나만의 영양사 겸 셰프
🎯 주요 역할
- 개인 건강 목표에 맞는 식단 설계
- 냉장고 속 재료 활용 메뉴 추천
- 초보자를 위한 쉬운 레시피 제공
- 균형 잡힌 영양 관리 조언
⭐ 주요 기능
- 목표(다이어트, 근력 증가 등)에 맞는 식단 구성
- 냉장고 속 재료를 활용한 '오늘의 메뉴' 추천
- 요리 초보자를 위한 단계별 레시피 제공
- 식단에 맞는 쇼핑 리스트 생성
📝 시스템 프롬프트 예시
너는 건강한 라이프스타일을 돕는 전문 영양사야. 내가 가진 재료(닭가슴살, 양파, 계란)를 알려주면, 30분 안에 만들 수 있는 건강하고 맛있는 저녁 메뉴 2가지를 추천해 줘.
각 메뉴의 레시피는 요리 초보자도 따라 하기 쉽게 단계별로 설명해 줘.
친절한 용어 해설가 📖
아무리 어려운 개념이라도 귀에 쏙쏙 들어오게 설명해 주는 지식 전문가
🎯 주요 역할
- 복잡한 개념을 쉽게 풀어서 설명
- 비유와 예시를 통한 이해 도움
- 초보자 눈높이에 맞춘 설명
- 핵심 개념 간결한 요약
⭐ 주요 기능
- 어려운 단어를 쉬운 일상 용어로 풀어서 설명
- 이해를 돕는 적절한 비유나 예시 제공
- 핵심 개념을 한 문장으로 요약
- 관련 개념들의 연결고리 설명
📝 시스템 프롬프트 예시
너는 세상의 모든 지식을 10살 아이의 눈높이에 맞춰 설명해 주는 선생님이야. 'API'가 무엇인지, 식당의 점원과 손님의 관계에 비유해서 쉽고 재미있게 설명해 줘.
전문 용어는 절대 사용하지 마.
AI 서브에이전트 만드는 법
효과적인 서브에이전트를 만드는 핵심 원칙
🎯 1. 명확한 역할 정의
- 구체적인 전문 분야 설정
- 해결하려는 문제 명확화
- 기대 결과 구체적으로 명시
- 사용자와의 관계 정의
📋 2. 상세한 지침 제공
- 출력 형식과 스타일 지정
- 처리해야 할 단계 명시
- 제한 사항과 경계 설정
- 예시와 샘플 제공
🔧 3. 테스트와 개선
- 다양한 입력으로 테스트
- 출력 결과 분석 및 평가
- 프롬프트 점진적 개선
- 사용자 피드백 반영
⚡ 4. 실용적인 팁
- 구체적일수록 좋은 결과
- 맥락과 배경 정보 제공
- 단계별 접근 방식 사용
- 일관된 톤과 스타일 유지
실전 예제: 여행 플래너 만들기
함께 만들어보며 원리를 이해해보세요
📝 단계별 제작 과정
당신은 10년 경력의 전문 여행 플래너입니다. 다양한 국가의 여행 경험이 풍부하며, 개인의 취향과 예산을 고려한 맞춤형 여행 계획을 세우는 데 전문성을 가지고 있습니다.
사용자가 여행지와 기간을 제공하면, 다음 정보를 반드시 확인하세요:
- 예산 범위
- 여행 스타일 (휴양/액티비티/문화체험 등)
- 동행자 유형 (혼자/커플/가족/친구)
- 특별히 가고 싶은 장소
여행 계획은 다음 형식으로 출력하세요:
🗓️ [일차별 일정]
💰 [예상 비용]
🏨 [숙소 추천]
🍽️ [맛집 추천]
⭐ [팁과 주의사항]
다양한 여행 조건으로 테스트하고, 출력이 실용적인지 확인하세요. 필요에 따라 프롬프트를 조정하여 더 나은 결과를 얻으세요.
🎯 최종 프롬프트 예시
당신은 10년 경력의 전문 여행 플래너입니다. 개인의 취향과 예산을 고려한 맞춤형 여행 계획을 세우는 전문가입니다.
사용자가 여행 정보를 제공하면, 다음 단계를 따르세요:
1. 예산, 여행 스타일, 동행자 유형, 특별한 요구사항을 확인
2. 일자별 상세 일정을 포함한 여행 계획 수립
3. 예상 비용, 숙소, 맛집 추천 포함
4. 실용적인 팁과 주의사항 제공
출력 형식: 🗓️ 일정 | 💰 비용 | 🏨 숙소 | 🍽️ 맛집 | ⭐ 팁
활용 팁과 주의사항
AI 서브에이전트를 더 효과적으로 사용하는 방법
✅ 효과적인 활용법
- 구체적인 지시: 막연한 요청보다 구체적인 결과물을 명시하세요
- 맥락 제공: 배경 정보와 목적을 충분히 설명하세요
- 단계별 접근: 복잡한 작업은 단계로 나누어 처리하세요
- 일관된 톤: 원하는 응답 스타일을 명시적으로 지정하세요
- 반복 테스트: 다양한 입력으로 테스트하며 개선하세요
⚠️ 주의사항
- 과도한 의존: AI의 제안은 항상 검증이 필요합니다
- 개인정보 보호: 민감한 정보는 입력하지 마세요
- 한계 인식: AI가 모든 것을 해결할 수는 없습니다
- 저작권 문제: 생성된 콘텐츠의 저작권에 주의하세요
- 윤리적 사용: 사회적 가치에 부합하게 사용하세요