[클로드 시리즈_24] AI 직원을 고용하는 방법 — Claude Code 서브에이전트 & 에이전트 팀 완전 정복

강호종 AI 길라잡이 강사 | 2026.05.28

---

핵심 결론 먼저

Claude Code의 핵심은 '혼자 일하지 않는 것'입니다. 서브에이전트(Subagents)는 복잡한 작업을 전문 팀원에게 분담시키고, 에이전트 팀(Agent Teams)은 여러 AI 인스턴스가 직접 소통하며 병렬로 대형 프로젝트를 처리합니다. 실제로 Anthropic은 이 방식으로 16개 에이전트를 동원해 10만 줄 규모의 C 컴파일러를 구축했습니다. 이 글 하나로 서브에이전트 개념부터 커스텀 에이전트 제작, 에이전트 팀 활성화까지 한 번에 정리합니다.

---

1. 서브에이전트(Subagents)의 이해 — AI 팀장과 팀원 구조

정의 및 비유

서브에이전트는 메인 대화창(팀장)의 지시를 받아 특정 영역만 전담하는 전문 팀원입니다.

팀장이 직접 모든 서류를 작성하는 것이 아니라, 리서치 담당·회계 담당에게 일을 맡기고 결과만 보고받는 구조와 같습니다. 각 서브에이전트는 자체 컨텍스트 윈도우에서 실행되므로 메인 대화를 오염시키지 않고 독립적으로 작업합니다.

서브에이전트의 4가지 핵심 장점

1. 병렬 처리: 여러 작업을 동시에 실행하여 전체 소요 시간을 획기적으로 단축합니다.
2. 컨텍스트 보호: 대량의 데이터를 다뤄도 메인 창의 컨텍스트(기억 공간)를 오염시키지 않습니다.
3. 전문화: 특정 모델이나 도구 권한을 부여하여 특정 업무의 정확도를 높입니다.
4. 재사용성: 한 번 구축한 전문 에이전트를 여러 프로젝트에서 호출할 수 있습니다.

---

2. 도구별 역할 비교 — 스킬 vs 서브에이전트

업무의 성격에 따라 가장 효율적인 도구를 선택하는 것이 '바이브 코딩'의 핵심입니다.

구분	스킬 (Skills)	서브에이전트 (Subagents)
성격	업무 매뉴얼	전문 팀원
비유	레시피 카드	전문 요리사
판단력	불필요 (순서대로 실행)	필요 (스스로 판단 및 실행)
실행 방식	/커맨드	사용자 또는 Claude가 자동 호출
적합한 업무	정해진 절차의 일 (급여 계산, 변환)	판단이 필요한 일 (리서치, 분석, 테스트)

---

3. 병렬 처리 워크플로우 — 오케스트레이션

복잡한 미션을 해결할 때는 Decompose(분해) → Execute(병렬 실행) → Integrate(통합) 과정을 거칩니다.

전체 흐름

1. /decompose (미션 분해): 최종 산출물을 정의하고, 작업을 독립적 작업(병렬 가능)과 의존적 작업(순차 필요)으로 나눕니다.
   • 동시 진행 가능한 리서치가 있고, 트렌드 분석 → (분석한 내용을 토대로) 콘텐츠 기획처럼 순서가 의존적 작업이 있음
2. /execute (병렬 투입): 분해된 작업 지시서에 따라 여러 서브에이전트들을 백그라운드에 동시 투입합니다.
3. /integrate (결과 통합): 각자 작업한 결과 파일들을 읽어 하나의 최종 보고서로 합칩니다.

예시 — 경쟁사 분석 보고서

• 병렬: 경쟁사 A사 조사, B사 조사, C사 조사를 동시에 진행
• 순차: 세 조사가 모두 끝난 후 '비교 분석' 및 '최종 보고서 작성'

---

4. 커스텀 서브에이전트 만들기

저장 위치 및 범위

• 개인용: ~/.claude/agents/ (내 모든 프로젝트에서 사용)
• 프로젝트용: .claude/agents/ (해당 프로젝트 내에서만 사용)

에이전트 파일 구조 (YAML + Markdown)

파일 상단에는 설정을, 하단에는 페르소나와 지침을 작성합니다.

yaml
---
name: code-reviewer
description: "코드 품질 및 보안 검토 전문가"
tools: Read, Grep, Glob, Bash
model: sonnet
---
# 당신은 시니어 코드 리뷰어입니다.
1. git diff로 최근 변경사항을 확인하세요.
2. 보안 취약점과 에러 핸들링을 중심으로 리뷰하세요.

💡 리뷰용 에이전트에는 쓰기 권한을 제외하세요. tools: Read, Grep, Glob처럼 읽기 전용 도구만 부여하면 의도치 않은 코드 수정을 원천 방지할 수 있습니다.

에이전트 파일 내 도구(Tools) 설명

도구	비유	주요 역할
Read	책을 펼쳐서 읽기	지정한 파일 하나를 열어서 내용을 읽음 (읽기 전용)
Grep	책 안에서 단어 찾기 (Ctrl+F)	파일들의 내용 안에서 특정 텍스트나 패턴을 검색
Glob	도서관 책 제목으로 찾기	파일명/경로 패턴으로 파일 목록을 찾음
Bash	터미널에서 명령어 실행	셸 명령어를 실행 — 가장 강력하면서 가장 위험한 도구

Grep vs Glob 차이: Grep은 파일의 "내용"을 보고, Glob은 파일의 "이름/위치"만 봅니다.

---

5. 내장 서브에이전트 — 기본 제공 에이전트

Claude Code에는 Claude가 적절할 때 자동으로 호출하는 내장 서브에이전트가 포함되어 있습니다. 각각은 부모 대화의 권한을 상속하며 추가 도구 제한이 적용됩니다.

에이전트명	모델	주요 용도
Explore	Haiku (빠름)	코드 탐색, 파일 검색 — 읽기 전용 도구만 사용
Plan	상속 모델	/plan 모드 진입 시 계획 수립 및 연구 — 읽기 전용
General-purpose	상속 모델	탐색 + 수정이 모두 필요한 복잡한 다단계 작업
claude-code-guide	Haiku	Claude Code 기능 관련 질문 답변
statusline-setup	Sonnet	/statusline 명령으로 상태 표시줄 설정 시 사용

1. Explore — 코드 탐색용

읽기 전용 도구(Read, Glob, Grep)만 쓰며 Haiku 모델로 빠르게 동작합니다. 호출 시 quick(빠른 조회), medium(균형), very thorough(전수 분석) 중 철저함 레벨이 지정됩니다.

"결제 관련 코드가 어디 있는지 찾아줘"
"인증 로직 흐름 파악해줘"

이런 요청에서 메인 에이전트가 Glob/Grep을 직접 도배하는 대신 Explore에게 넘겨서 메인 컨텍스트를 깨끗하게 유지합니다.

2. Plan — 계획 모드 전용 리서치

/plan 명령으로 Plan 모드에 진입했을 때만 호출됩니다. 메인 모델을 상속받지만 읽기 전용이라 조사 단계에서 코드가 실수로 수정되는 일이 없습니다. 서브에이전트는 다른 서브에이전트를 다시 부를 수 없기 때문에, 이 구조 덕분에 무한 중첩이 막힙니다.

/plan 결제 모듈에 쿠폰 시스템 추가하는 방법 설계해줘

3. General-purpose — 탐색 + 수정이 모두 필요할 때

모든 도구를 쓸 수 있고 메인 모델을 상속합니다. 다단계이고 의존성 있는 복잡한 작업, 또는 독립적인 여러 모듈을 병렬로 수정해야 할 때 자동으로 여러 개가 동시에 띄워지기도 합니다.

"인증, DB, API 모듈을 각각 별도 서브에이전트로 병렬 조사해줘"
"테스트 스위트 돌리고 실패한 케이스만 에러 메시지와 함께 보고해줘"

명시적으로 호출하는 3가지 방법

자동 위임이 부족할 때 직접 호출하는 방법입니다.

1. 자연어 호출 — "Explore 서브에이전트로 인증 코드 찾아줘" (Claude가 위임 여부 판단)
2. @-멘션 — @"Explore (agent)" 인증 변경사항 봐줘 (해당 에이전트 실행 보장)
3. 세션 전체 적용 — claude --agent code-reviewer로 시작하면 메인 스레드 자체가 그 에이전트가 됨

---

6. 에이전트 팀 (Agent Teams) — 실험적 기능

📌 팩트체크 확인: Agent Teams는 2026년 2월 5일 Claude Opus 4.6 출시와 함께 연구 프리뷰(Research Preview)로 공개되었습니다. 서브에이전트보다 더 강력한 협업 구조로, 에이전트끼리 **메일박스(Mailbox)**를 통해 직접 소통합니다. (기본값 비활성화)

서브에이전트 vs 에이전트 팀 차이

구분	서브에이전트	에이전트팀
소통 방식	메인 에이전트에게만 보고	에이전트끼리 직접 메시지 교환 (P2P)
구조	부모-자식 계층 구조	팀 리드 + 팀원 수평 구조
적합 규모	일반 코딩 작업, 반복 업무	대규모 병렬 프로젝트
토큰 비용	일반 수준	팀원 수에 비례해 증가

활성화 방법

방법 1 — settings.json에 추가 (권장)

json

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

방법 2 — Windows PowerShell

powershell

$env:CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1; claude

방법 3 — Windows 일반 명령어(cmd)

cmd

set CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 && claude

실제 사례 — Anthropic의 C 컴파일러 구축

Anthropic 연구원 Nicholas Carlini는 이 방식으로 16개 에이전트를 동원해 약 2,000회 Claude Code 세션에 걸쳐 10만 줄 규모의 Rust 기반 C 컴파일러를 구축했습니다. 이 컴파일러는 Linux 6.9 커널을 x86·ARM·RISC-V 아키텍처에서 컴파일할 수 있으며, Doom 게임까지 실행됩니다. 총 비용은 약 $20,000 수준이었습니다.

---

7. 실전 주의사항 (Do's & Don'ts)

✅ 독립적 작업은 반드시 병렬로 분배하여 시간을 아끼세요.

✅ 리뷰용 에이전트에는 읽기 전용 도구만 부여하여 의도치 않은 코드 수정을 방지하세요.

❌ 의존성 있는 작업을 무리하게 병렬화하면 논리가 꼬입니다.

❌ 서브에이전트끼리는 직접 대화할 수 없습니다. (메인 에이전트를 통해 체인으로 연결해야 함)

💡 대화의 오염 방지: 작업 중 새로운 이슈(예: 일정 등록)가 생기면 메인 창이 아닌 '새 창'을 열어 처리하는 것이 컨텍스트 유지에 유리합니다.

💡 에이전트 팀 도입 주의: 에이전트 팀은 토큰 비용이 팀원 수에 비례해 증가합니다. 단순 작업은 서브에이전트로, 진짜 복잡하고 병렬 처리가 필요한 대규모 작업에만 에이전트 팀을 쓰는 것이 가성비가 좋습니다.

핵심 요약: 간단한 일은 직접(메인), 시간이 걸리거나 전문적인 일은 심부름(서브에이전트)시키고 결과만 받으세요!

---

8. Q&A — 자주 묻는 질문 5가지

Q1. 서브에이전트를 쓰면 토큰이 더 많이 소모되나요?

오히려 반대입니다. 서브에이전트는 자체 컨텍스트 윈도우에서 작동하고 결과 요약만 메인에 반환하기 때문에, 방대한 탐색 결과나 로그가 메인 컨텍스트를 채우는 것을 막아 전체 토큰 효율이 올라갑니다. 특히 Explore처럼 Haiku 모델로 돌아가는 에이전트는 비용도 낮습니다.

Q2. 커스텀 서브에이전트를 만들 때 어떤 도구 권한을 줘야 하나요?

역할에 따라 최소 권한 원칙을 적용하세요. 코드 리뷰어에게는 Read·Grep·Glob만, 테스트 실행기에게는 Bash를 추가하는 식입니다. Bash는 가장 강력하지만 잘못 설정하면 파일을 삭제하거나 서버를 건드릴 수 있으므로 꼭 필요한 경우에만 부여합니다.

Q3. 서브에이전트와 Skills의 차이가 헷갈립니다.

Skills는 '레시피 카드'처럼 정해진 절차를 순서대로 실행하고 판단력이 없습니다. 서브에이전트는 '전문 요리사'처럼 상황을 스스로 판단하고 도구를 선택해서 일을 처리합니다. 반복적이고 예측 가능한 작업은 Skills로, 분석이나 리서치처럼 판단이 필요한 작업은 서브에이전트로 처리하는 것이 좋습니다.

Q4. 에이전트 팀은 일반 사용자도 쓸 수 있나요?

Pro, Max, Team, Enterprise 요금제라면 모두 사용 가능합니다. 단, 현재(2026년 5월 기준) 실험적 기능(Research Preview)이므로 환경변수를 직접 활성화해야 하고, 세션 재개 미지원·종료 버그 등 불안정한 부분이 있을 수 있습니다. 중요한 프로젝트보다는 실험적 용도로 먼저 테스트해 보는 것을 권장합니다.

Q5. 서브에이전트가 다른 서브에이전트를 부를 수 있나요?

불가능합니다. 서브에이전트는 다른 서브에이전트를 생성하거나 직접 대화할 수 없습니다. 반드시 메인 에이전트를 통해 체인으로 연결해야 합니다. 이 구조 덕분에 무한 중첩이 막혀 안전하게 동작합니다. 에이전트끼리 직접 소통이 필요하다면 에이전트 팀(Agent Teams)을 사용하세요.

---

마무리 — 오늘 당장 해볼 수 있는 3가지 액션

1. /agents 명령 실행 — Claude Code에서 /agents를 입력해 내장 서브에이전트 목록 확인
2. code-reviewer 에이전트 하나 만들기 — 위 YAML 구조를 복사해 ~/.claude/agents/code-reviewer.md에 저장
3. 오늘 작업에 Explore 호출해보기 — "Explore 서브에이전트로 현재 프로젝트의 인증 코드 찾아줘" 한 줄 입력

AI를 혼자 쓰는 시대에서 AI 팀을 운영하는 시대로 바뀌고 있습니다. 서브에이전트를 직접 만들어 써보고 어떤 작업에 가장 효과적이었는지 댓글로 공유해 주시면, 다음 편에서 실제 사례로 다뤄보겠습니다!

다음 편 예고: [클로드 코드 시리즈] Claude Code에 날개 달기 — MCP 서버 연동으로 Notion·Slack까지 자동화하는 법

---

작성자 | 강호종 AI 길라잡이 강사

생성형 AI 활용 업무 효율화 전문강사 · 디지털융합교육원 지도강사, 젠스파크 AI 전문강사 · (사)한국AINFT협회 이사
저서: 『생성형 AI 활용 업무혁신』(2026) · 『이것이 GEO마케팅이다』(2026)
📞 010-9912-9934 · 📧 art386@naver.com · blog.naver.com/art386 · aiart386.tistory.com

---

#서브에이전트 #클로드코드 #에이전트팀 #AgentTeams #Subagents #ClaudeCode #AI자동화 #멀티에이전트 #바이브코딩 #강호종강사 #AI길라잡이 #생성형AI #병렬처리 #오케스트레이션 #Anthropic #Opus46 #AI업무자동화 #코드리뷰자동화 #CLAUDE.md #2026AI트렌드