Awesome Claude Code Subagents (Claude Skill) — 설치 & 라이브 데모

왜 쓰나요

핵심 기능

주요 개발 도메인에 걸쳐 100개 이상의 서브에이전트
각각은 범위가 지정된 도구 + 시스템 프롬프트 보유
부모 Claude Code 세션에서 호출하도록 설계
커버 범위: 보안 리뷰, 성능, 코드젠 리뷰, 인프라 비용 등
유지보수 중, 성장 중, 커뮤니티 기여

라이브 데모

실제 사용 모습

준비됨

설치

작성자 저장소 · Claude Skills 공식 문서

사용 사례

실전 활용법: Awesome Claude Code Subagents

전문 서브에이전트에 보안 리뷰 위임

👤 auth/데이터와 관련된 기능을 출시하는 개발자 ⏱ ~20 min intermediate

언제 쓸까: 메인 에이전트가 auth 코드를 작성했을 때; 집중된 서브에이전트의 두 번째 눈이 필요할 때.

흐름

생성

Use awesome-subagents. Spawn the 'security-reviewer' subagent on src/auth.✓ 복사됨

→ 서브에이전트가 결과 보고
트리아지

Group findings by severity. Identify which the main agent should fix now vs file as issues.✓ 복사됨

→ 트리아지된 목록

결과: 실제 리뷰어 급여를 지불하지 않고 모든 PR에 보안 피드백.

함정

서브에이전트가 메인 에이전트와 의견이 다른 것을 찾음 — 당신의 판단 — 보통 보안 중심 출력이 맞음; 기본적으로 주의

함께 쓰기: claude-hud-skill

핫 경로에 성능 감사 서브에이전트 실행

👤 느린 기능을 프로파일링하는 개발자 ⏱ ~45 min intermediate

언제 쓸까: 엔드포인트가 느리고 집중된 성능 리뷰가 필요할 때.

흐름

범위 지정

Spawn the 'perf-auditor' subagent on the /orders endpoint. Include the DB schema.✓ 복사됨

→ 결과: N+1, 누락된 인덱스, 핫 루프
적용

Apply the top 3 fixes; benchmark before/after.✓ 복사됨

→ 수치가 포함된 지연 시간 감소

결과: 느낌이 아닌 실제 성능 향상.

함정

서브에이전트가 마이크로 최적화를 제안 — 영향 순위 요청; 잡음 무시

틈새 작업에 맞는 서브에이전트 찾기

👤 카탈로그가 처음인 개발자 ⏱ ~15 min beginner

언제 쓸까: 특정 작업이 있는데 어떤 서브에이전트를 사용해야 할지 모를 때.

흐름

검색

List subagents that are good for 'Postgres query optimization'.✓ 복사됨

→ 범위가 포함된 2–3개 후보
시도

Use the top match on /reports/slow_queries.sql.✓ 복사됨

→ 대상 분석

결과: 작업에 맞는 도구; 덜 일반적인 에이전트 추론.

함정

서브에이전트 정의가 겹침 — 가장 좁게 범위가 지정된 것 선택

조합

다른 MCP와 조합해 10배 효율

awesome-claude-subagents + claude-hud-skill

서브에이전트 생성하고 실시간 진행 상황 확인

awesome-claude-subagents + mcp-agent-mail

서브에이전트들이 중복 작업을 피하기 위해 메일로 조율

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
list_subagents	domain?	탐색	무료
spawn_subagent	name, scope, task	집중된 작업 위임	서브에이전트 실행 token

비용 및 제한

운영 비용

API 쿼터: 해당 없음
호출당 토큰: 각 서브에이전트 실행은 자체 컨텍스트 — 비용이 쌓임; 의식적으로 예산 관리
금액: 무료
팁: 작업이 진정으로 전문적일 때만 서브에이전트 사용; 과도한 위임 금지

보안

권한, 시크릿, 파급범위

최소 스코프: 서브에이전트별 — 일부는 셸 필요, 일부 불필요

자격 증명 저장: 기본 없음

데이터 외부 송신: 서브에이전트의 도구에 따름

절대 부여 금지: 필요하지 않은 서브에이전트에 광범위한 도구 접근

승인 전 각 서브에이전트의 허용 목록 읽기

문제 해결

자주 발생하는 오류와 해결

서브에이전트가 영원히 실행됨

타임아웃 설정; 일부는 과도하게 열정적

서브에이전트가 범위를 무시

생성 작업에서 더 명시적으로; 엄격한 경로 범위 설정

대안

Awesome Claude Code Subagents 다른 것과 비교

대안	언제 쓰나	단점/장점
단일 다중 도구 에이전트	작업이 범용적일 때	덜 집중된 출력
wshobson/agents	다른 큐레이션된 집합을 원할 때	겹침; 선호하는 철학 선택

Awesome Claude Code Subagents