• AI 에이전트 여러 개를 한 팀처럼 움직이려면, 메인 에이전트가 일을 나누고 하위 에이전트가 맡는 구조를 만듭니다.
• Claude는 하위 에이전트마다 쓸 수 있는 도구를 제한하고, 깊이와 비용에 상한을 둘 수 있습니다.
• 처음에는 읽기 전용 에이전트 2개만 만들고, 결과를 사람이 확인한 뒤 역할을 늘리세요.
📌 먼저 알아둘 개념
AI 에이전트를 여러 개 쓰는 방식은 크게 두 가지입니다. 하나는 메인 에이전트가 필요할 때마다 하위 에이전트를 부르는 방식이고, 다른 하나는 미리 짠 절차를 스크립트처럼 실행하는 방식입니다.
이 글은 Claude 공식 문서에 나온 첫 번째 방식, 즉 메인 에이전트와 하위 에이전트 구조를 중심으로 설명합니다. 초보자는 이 방식부터 익히는 것이 안전합니다.

🛠️ 설정 전에 정할 3가지
첫째, 역할을 나눕니다. 예를 들어 자료 찾기, 검토, 작성처럼 맡길 일을 이름과 함께 정합니다.
둘째, 각 역할이 쓸 도구를 고릅니다. 검토 역할은 읽기만 하고, 파일 저장이나 메일 발송은 빼는 식입니다.
셋째, 한도를 정합니다. 몇 단계까지 부를지, 동시에 몇 개를 돌릴지, 비용 상한은 얼마인지 미리 적어 두세요.
📝 설정 방법 (두 가지 중 고르기)
방법 1은 파일로 만드는 방식입니다. 프로젝트 폴더 안 .claude/agents 아래에 역할별 마크다운 파일을 만들고, 이름, 설명, 쓸 도구, 지시문을 적습니다. 설명을 구체적으로 써야 Claude가 맞는 역할을 골라 부릅니다.
방법 2는 코드로 만드는 방식입니다. Claude Agent SDK의 agents 옵션에 역할별 설정을 넣습니다. 개발 경험이 있는 분이 쓰기 좋습니다.
어느 쪽이든 메인 에이전트의 도구 목록에는 하위 에이전트를 부르는 도구가 포함되어 있어야 합니다. 공식 예시에서도 이 도구를 허용 목록에 넣습니다.

🧪 예시: 블로그 글 리서치 팀 만들기
예를 들어 블로그 글을 쓰는 팀을 만든다고 해 봅시다. 리서치 역할은 자료를 찾고 요약만 합니다. 검토 역할은 원문과 대조하며 숫자와 날짜를 확인합니다. 작성 역할은 초안만 씁니다.
메인 에이전트에게 "리서치 에이전트로 자료를 찾고, 검토 에이전트로 확인한 뒤 초안을 만들어 줘"라고 말하면, 세 단계가 차례로 진행됩니다. 하위 에이전트는 독립된 문맥에서 일하므로 메인 대화가 길어지지 않습니다.
🛡️ 꼭 지킬 안전 장치
가장 중요한 것은 되돌리기 어려운 행동을 사람이 확인하게 하는 것입니다. 메일 발송, 결제, 파일 삭제는 하위 에이전트에게 주지 않거나, 실행 전에 승인을 받도록 하세요.
하위 에이전트도 각자 API 요청을 보내므로 비용이 늘어납니다. 총 비용 상한을 꼭 정해 두세요. 공식 문서는 중첩 깊이와 동시 실행 수, 비용 한도를 따로 조절할 수 있다고 설명합니다.
❓ 자주 묻는 질문
Q. 에이전트를 몇 개부터 만들면 좋을까요?
A. 두세 개로 시작하세요. 역할이 많아질수록 결과를 추적하기 어려워집니다.
Q. 에이전트끼리 서로 직접 대화하나요?
A. 이 글의 구조에서는 메인 에이전트가 결과를 모아 판단합니다. 서로 직접 협업하는 구조는 별도 설정이 필요하고, 이 글에서는 다루지 않습니다.
⚠️ 주의할 점
설정 방법은 제품 버전에 따라 메뉴와 옵션 이름이 바뀔 수 있습니다. 실제로 적용하기 전에 공식 문서의 최신 안내를 꼭 확인하세요.
📚 출처
Claude Agent SDK 문서 "Subagents in the SDK" (code.claude.com/docs, 2026년 11월 확인) / Claude Platform 문서 "Multiagent orchestration" (platform.claude.com/docs) / Claude Code 문서 "Orchestrate subagents at scale with dynamic workflows"
'AI 배우기' 카테고리의 다른 글
| 🔔 ChatGPT 음성 모드 12월 11일 종료, GPT-Live로 바뀌는 일정과 초보자 체크 3가지 (0) | 2026.11.12 |
|---|---|
| 🛑 AI 에이전트를 멈추는 법, 기업용 킬스위치 발표로 개인이 배울 점 (0) | 2026.11.12 |
| 🤖 AI 에이전트 여럿이 일하면 왜 엉망이 될까 (0) | 2026.11.11 |
| 🗳️ AI 가짜뉴스는 어디까지 규제할까? 시민 100명이 직접 토론합니다 (0) | 2026.11.11 |
| 🎬 구글 비즈로 무료 15초 AI 영상 만드는 법, 월 3편 초보자 4단계 가이드 (0) | 2026.11.11 |