서브에이전트는 역할 하나를 맡는 부하 직원입니다. 실물은 직원 카드 5칸(이름·역할·도구·모델·지침)이 적힌 문서 파일 하나입니다.
만들기·관리
두 길이 있습니다. 말로 뽑기 — 카드를 먼저 보여 달라고 해서 승인 후 생성합니다. 또는 /agents 관리 화면을 씁니다. 손으로 밟는 절차는 따라 하기 3편에 있습니다.
사는 곳
- .claude/agents/ — 이 폴더 전용 직원.
- ~/.claude/agents/(홈 폴더) — 내 컴퓨터 공용 직원.
운영 원칙
- 도구는 필요한 최소한만 줍니다(책 13장).
- 모델 등급은 일의 깊이에 맞게 배정합니다(책 12장).
- 하나를 잘하는 직원 여럿이 만능 직원 하나보다 낫습니다.
요령
갓 만든 직원이 안 보이면 세션을 새로 엽니다(책 9장 첫 출근 팁).
[캡처 자리] /agents 직원 명단 화면
공식 문서 원문 — 클로드 코드 공식 안내의 "서브에이전트" 장. 이 페이지는 우리가 실제 운영하며 쓰는 방식의 기록이며, 위 도장 날짜에 공식 안내와 대조했습니다.