Claude Code 서브 에이전트 12개를 6개월 굴려본 결과 — 호출 빈도, 패턴, 5가지 안티패턴 2026-05-04 갱신 | 작성자: 원스 (Wons) | 분야: 서브 에이전트 운영 Claude Code의 서브 에이전트를 처음 봤을 때 "이게 정말 단일 모델 호출보다 좋을까"가 의심이었어요. 추가 호출이 늘면 토큰 비용도 늘고, 컨텍스트 분리가 오히려 정보 손실을 만들 수도 있으니까요. 그래서 6개월간 12개의 서브 에이전트를 본인 프로젝트에 만들어 운영해 봤습니다. 결론은 단순합니다 — 잘 쓰면 가치가 크고, 잘못 쓰면 비용만 늘어나는 양면성 이에요. 이 글은 그 가운데를 가르는 패턴을 정리한 카탈로그입니다. 도메인별 깊이가 궁금하다면 Playwright + Plan-Gen-Heal 글 이 더 적합해요. 이 글은 12개 에이전트 카탈로그 + 패턴·안티패턴에 집중합니다. 먼저, 서브 에이전트가 정확히 무엇인가 Claude Code의 서브 에이전트(sub-agent)는 메인 에이전트가 명시적으로 위임할 수 있는 작업 단위예요. 공식 문서 의 정의에 따르면: 독립된 컨텍스트 : 메인 에이전트와 별도의 메모리. 큰 작업 컨텍스트가 흐려지지 않음. 고유한 시스템 프롬프트 : 도메인별로 톤·규칙·도구 권한을 다르게 설정 가능. 메인이 결과만 받음 : 서브의 모든 추론 과정이 아닌 최종 결과물만 메인 컨텍스트로 돌아옴. 파일 위치는 .claude/agents/<name>.md (프로젝트별) 또는 ~/.claude/agents/<name>.md (전역). Markdown frontmatter로 도구 권한·모델·설명을 지정합니다. --- name: code-reviewer description: Reviews PRs for security and style issues to...