블로그로 돌아가기
[REVIEW]

Claude Code 서브에이전트 컬렉션 agency-agents: 스타 124,996 리뷰

7분 읽기1 views
#AI 에이전트 컬렉션#agency-agents#서브에이전트 설치#AI 자동화#claude code 서브에이전트

Claude Code 서브에이전트 컬렉션 agency-agents 2026 완전 분석 리뷰

먼저 결론부터 말씀드릴게요. agency-agents는 프론트엔드 개발자부터 레딧 커뮤니티 매니저까지, 디지털 에이전시 한 곳의 조직도를 통째로 Claude Code 서브에이전트로 옮겨 담은 컬렉션이에요. 2026-07-02 KST 기준 스타 124,996개로 이 분야 압도적 1위입니다. 그런데 정작 중요한 교훈은 "이걸 다 깔지 마세요"예요. 왜 그런지 지금부터 풀어드릴게요.

agency-agents란 무엇인가요

agency-agents: msitarzewski/agency-agents 저장소에 담긴 Claude Code 서브에이전트 모음이에요. 엔지니어링·디자인·마케팅·세일즈·재무·보안 등 **16개 부서(division)**에 걸쳐 실측 233개의 전문 에이전트가 들어 있습니다. 각 에이전트는 성격·업무 프로세스·검증된 산출물을 갖춘 "한 명의 담당자"로 설계됐어요.

부서별 구성을 보면 규모가 실감 납니다. 전문 분야 53개, 마케팅 36개, 엔지니어링 34개, 게임개발 20개, 공간정보(GIS) 13개, 보안 10개, 디자인·세일즈 각 9개 순이에요. README는 "232개"라고 적혀 있는데 실측은 233개로 하나 더 많았습니다. 2026-06-30 네트워크 엔지니어 에이전트가 추가되면서 문서 숫자가 잠깐 뒤처진 것으로 보여요.

핵심은 프레이밍이에요. 다른 컬렉션이 "개발 직무별 도우미 모음"이라면, agency-agents는 회사 전 직군을 담아요. 1인 기업이나 작은 팀이 "부서별 전문가 한 명씩"을 즉시 세팅한다는 서사가 명확하죠. MIT 라이선스라 그대로 가져다 써도 되고요.

왜 압도적 1위가 됐나요

Claude Code 서브에이전트 컬렉션은 여럿이지만, 스타 수 차이가 큽니다. 2026-07-02 KST 실측 기준으로 비교하면 이래요.

저장소스타포크마지막 활동
msitarzewski/agency-agents124,99620,2832026-07-01
wshobson/agents37,4334,0202026-06-29
VoltAgent/awesome-claude-code-subagents22,7202,6432026-06-24
contains-studio/agents12,4002,5262025-07-28

2위인 wshobson/agents(37,433)의 3.3배예요. 눈여겨볼 지표는 포크 수입니다. agency-agents의 포크는 스타 대비 약 16%인데, 보통 컬렉션은 5% 미만이에요. 에이전트를 새로 기여하려면 저장소를 포크해서 PR을 올리는 방식이라, 포크가 곧 "직접 손대는 기여자"의 규모인 셈이죠. 2025-10-13에 만들어진 저장소가 262일 만에 이만큼 큰 겁니다.

반면 한때 인기였던 contains-studio/agents는 마지막 활동이 2025-07-28에 멈춰 있어요. 초창기 컬렉션이 유지보수를 놓친 대조군이고, agency-agents가 바로 어제(2026-07-01)까지 갱신되고 있다는 점이 결정적 차이입니다.

Claude Code 서브에이전트 개념 짚기

여기서 "서브에이전트"가 뭔지 짚고 갈게요. 비유하자면, 메인 대화가 총괄 PM이고 서브에이전트는 특정 업무만 맡는 계약직 전문가예요. Anthropic 공식 문서 기준으로 정리하면 이렇습니다.

  • 독립 컨텍스트 창: 서브에이전트는 자기만의 대화 공간에서 일해요. 메인 대화가 잡다한 정보로 오염되지 않죠.
  • 도구 권한 제한: 예를 들어 문서 검토 에이전트에게는 읽기·검색 도구만 주고 파일 수정 권한은 빼요. 실수로 문서를 고치는 사고를 원천 차단합니다.
  • 병렬 실행: 여러 서브에이전트가 동시에 다른 분석을 돌릴 수 있어요.

agency-agents의 각 .md 파일은 이 표준 포맷(마크다운 본문 + YAML frontmatter)을 그대로 따라요. 그래서 변환 없이 ~/.claude/agents/ 폴더에 복사만 하면 바로 작동합니다.

많이 설치한다고 많이 쓰는 건 아니에요

이제 가장 중요한 이야기예요. 233개를 다 깔면 정말 다 쓰일까요? 아니에요. README가 스스로 경고합니다. OpenCode 런타임은 약 119개만 등록하고 나머지는 조용히 버려요(업스트림 버그). 233개 전량 설치가 도구의 물리적 한계를 넘는 실제 사례인 거죠.

한계는 도구 숫자만이 아니에요. 서브에이전트의 실사용률은 설명(description) 품질과 호출 규칙에 달려 있습니다. 에이전트 설명이 모호하면 메인 세션이 "언제 이걸 불러야 하지?"를 판단하지 못해 활성화율이 뚝 떨어져요. 단순 작업에 열 개를 병렬로 띄우면 토큰만 낭비하고 조율 비용만 늘고요.

저희 QJC도 같은 실수를 했어요. 외부에서 에이전트 101개를 한꺼번에 임포트했는데, 22일 동안 호출 횟수가 0회였습니다. 결국 전부 아카이브로 내렸죠. "많이 설치 ≠ 많이 사용"은 남의 이야기가 아니라 저희가 직접 겪은 교훈이에요.

agency-agents 실전 설치 전략

그래서 어떻게 써야 할까요. 핵심은 소수 정예 + 명확한 호출 규칙이에요. 대량 로스터는 "무엇이 가능한지 둘러보는 카탈로그"로 쓰고, 실전에는 내 워크플로우에 맞는 3~5개만 고르세요.

부분 설치가 답입니다. 전체가 아니라 필요한 부서나 에이전트만 골라 넣으면 돼요.

# 부서 단위로만 설치 (엔지니어링 + 보안)
./scripts/install.sh --tool claude-code --division engineering,security

# 특정 에이전트만 콕 집어 설치
./scripts/install.sh --tool claude-code --agent frontend-developer,ui-designer

설치 후에는 "이 에이전트를 언제 부를지"를 문서로 정해두세요. 설명을 구체적으로 다듬고, 어떤 키워드나 상황에서 호출할지 규칙을 세우는 겁니다. 이게 활성화율을 살리는 진짜 레버예요. 앱(agencyagents.app)으로 클릭 한 번에 설치할 수도 있지만, 진입장벽이 낮은 것과 실제로 잘 쓰는 건 별개라는 점을 꼭 기억하세요.

참고로 지원 도구 목록에 Claude Code, Cursor, Codex, Gemini CLI는 물론 Hermes까지 포함돼 있어요. 저희처럼 여러 하네스를 함께 쓰는 팀에도 이식이 어렵지 않습니다.

마무리

agency-agents는 "AI 에이전시를 통째로 고용한다"는 발상을 스타 124,996개로 증명한 컬렉션이에요. 하지만 가치는 몇 개를 깔았느냐가 아니라, 내 일에 맞는 몇 개를 골라 언제 부를지 규칙을 세웠느냐에서 나옵니다. 오늘 전량 설치 대신 부서 하나만 골라 시작해보세요. 그게 훨씬 빠르게 성과를 냅니다.

자주 묻는 질문 (FAQ)

Q: agency-agents는 무료인가요?

네, MIT 라이선스라 무료로 쓰고 수정·재배포도 가능해요. 다만 에이전트를 실행하는 Claude Code 같은 도구 자체의 이용 요금은 별도입니다.

Q: 233개를 전부 설치해야 하나요?

아니에요. 오히려 권장되지 않아요. OpenCode처럼 약 119개만 등록되는 도구 한계도 있고, 실사용률은 설치 개수가 아니라 설명 품질과 호출 규칙에 달려 있어요. --division이나 --agent 옵션으로 3~5개만 부분 설치하는 편이 실무적입니다.

Q: 서브에이전트를 처음 쓰는데 어디서부터 볼까요?

먼저 Anthropic 공식 서브에이전트 문서로 개념(독립 컨텍스트, 도구 제한)을 잡으세요. 그다음 agency-agents 저장소에서 내 업무와 가장 가까운 부서 하나를 골라 .md 파일 몇 개만 ~/.claude/agents/에 복사해 시험해보시면 됩니다.

관련 글

참고자료