서브에이전트 직접 만들기
파일 하나가 AI 직원

서브에이전트는 클로드가 일을 맡기는 전문 직원이에요. 머리말(카드)이 붙은 마크다운 파일 하나로 만들어요.

업무 카드 4칸

칸	필수?	뜻
name	필수	직원 이름(고유 식별자).
description	필수	언제 이 직원에게 맡길지. 클로드가 이 설명을 보고 위임 여부를 정해요. 짧게 쓰세요.
tools	선택	쓸 수 있는 도구 목록. 안 적으면 쓸 수 있는 도구를 전부 물려받아요.
model	선택	sonnet·opus·haiku·fable·모델 ID·inherit(메인 대화 모델 따라가기).

그 밖에 permissionMode, maxTurns, skills, mcpServers, hooks, memory, effort, isolation, color 같은 칸도 있어요. 출처: Claude Code 문서 · Subagents(문서 앞부분 기준).

---
name: 교정-담당
description: 글의 맞춤법과 어색한 문장을 점검한다. 글 검토를 부탁받으면 사용한다.
tools: Read
model: haiku
---
너는 꼼꼼한 교정 담당이다. 틀린 곳은 최대 3개만 알려 줘.

반장이 이해를 돕게 만든 예시예요. 직접 돌려 시험하지는 못했어요(로그인 세션 만료).

.claude/agents/ = 이 프로젝트에서만, ~/.claude/agents/ = 내 모든 프로젝트. 이름이 겹치면 프로젝트 쪽이 우선이에요.
부르기: ① 말로("교정-담당 서브에이전트로 …") ② @ 멘션 ③ claude --agent 이름으로 세션을 처음부터 그 직원으로
파일 쓰기가 어렵다면 클로드에게 "이런 직원 만들어 줘"라고 말해도 돼요.
서브에이전트도 기본 3단계까지 또 서브에이전트를 만들 수 있어요(tools에서 Agent를 빼면 막혀요).

※ 반장은 AI로 그린 캐릭터예요. 직접 확인한 내용만 적어요. 기능·수치는 바뀔 수 있으니 공식 사이트도 확인하세요. 궁금한 건 @ai_banjang 댓글로.