/ 디렉터리 / 플레이그라운드 / Awesome Claude Code Subagents
● 커뮤니티 VoltAgent ⚡ 바로 사용

Awesome Claude Code Subagents

제작: VoltAgent · VoltAgent/awesome-claude-code-subagents

100개 이상의 특화된 Claude Code 서브에이전트 — 프론트엔드, 백엔드, 인프라, 보안, 성능, 데이터 커버. 제너럴리스트가 아닌 전문가를 호출하세요.

VoltAgent의 awesome-claude-code-subagents는 의견적 서브에이전트 설정 라이브러리입니다 — 각각은 자체 시스템 프롬프트, 도구 허용 목록, 리뷰 체크리스트를 갖춘 도메인 전문가입니다. '보안 리뷰어'나 '성능 감사자'를 서브에이전트로 위임하여 집중된 출력을 얻고, 메인 에이전트가 통합합니다.

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "awesome-claude-subagents": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/VoltAgent/awesome-claude-code-subagents",
        "~/.claude/skills/awesome-subagents"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "awesome-claude-subagents": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/VoltAgent/awesome-claude-code-subagents",
        "~/.claude/skills/awesome-subagents"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "awesome-claude-subagents": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/VoltAgent/awesome-claude-code-subagents",
        "~/.claude/skills/awesome-subagents"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "awesome-claude-subagents": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/VoltAgent/awesome-claude-code-subagents",
        "~/.claude/skills/awesome-subagents"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "awesome-claude-subagents",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/VoltAgent/awesome-claude-code-subagents",
        "~/.claude/skills/awesome-subagents"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "awesome-claude-subagents": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/VoltAgent/awesome-claude-code-subagents",
          "~/.claude/skills/awesome-subagents"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add awesome-claude-subagents -- git clone https://github.com/VoltAgent/awesome-claude-code-subagents ~/.claude/skills/awesome-subagents

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Awesome Claude Code Subagents

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

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

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

흐름
  1. 생성
    Use awesome-subagents. Spawn the 'security-reviewer' subagent on src/auth.✓ 복사됨
    → 서브에이전트가 결과 보고
  2. 트리아지
    Group findings by severity. Identify which the main agent should fix now vs file as issues.✓ 복사됨
    → 트리아지된 목록

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

함정
  • 서브에이전트가 메인 에이전트와 의견이 다른 것을 찾음 — 당신의 판단 — 보통 보안 중심 출력이 맞음; 기본적으로 주의
함께 쓰기: claude-hud-skill

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

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

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

흐름
  1. 범위 지정
    Spawn the 'perf-auditor' subagent on the /orders endpoint. Include the DB schema.✓ 복사됨
    → 결과: N+1, 누락된 인덱스, 핫 루프
  2. 적용
    Apply the top 3 fixes; benchmark before/after.✓ 복사됨
    → 수치가 포함된 지연 시간 감소

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

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

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

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

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

흐름
  1. 검색
    List subagents that are good for 'Postgres query optimization'.✓ 복사됨
    → 범위가 포함된 2–3개 후보
  2. 시도
    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다른 큐레이션된 집합을 원할 때겹침; 선호하는 철학 선택

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기