에이전트중급공식

나만의 서브에이전트

Custom subagents

역할, 지시문, 쓸 수 있는 도구를 정해 둔 보조 클로드를 만들어요. 본 대화를 깔끔하게 유지하면서 일을 나눠 맡길 수 있어요.

에이전트는 ‘보조 클로드’이에요

한 가지 역할만 맡는 보조 클로드예요. 큰 일을 나눠 맡기면 본 대화가 복잡해지지 않고 결과만 받아 볼 수 있어요.

도구 종류 비교하기
난이도
중급 · 계정 로그인이나 간단한 설정이 조금 필요해요.
쓰는 곳
클로드 코드
만든 곳
Anthropic (클로드 코드 기본 기능) (공식)
이런 일에 써요
개발·코딩업무 자동화

설치하기

따로 설치할 명령이 없어요. 아래 설명대로 클로드 코드에서 바로 쓰거나 만들면 돼요.

만드는 방법

클로드에게 이렇게 부탁하면 파일을 만들어 줘요.

~/.claude/agents/에 코드 개선 제안만 하는 서브에이전트를 만들어 줘. 파일 수정은 못 하게 해 줘.

  • ~/.claude/agents/에 두면 내 모든 프로젝트에서 쓸 수 있어요.
  • 프로젝트의 .claude/agents/에 두면 그 프로젝트에서만 쓰고, 팀과 공유할 수 있어요.
  • 새 폴더를 만든 직후에는 클로드 코드를 다시 시작해야 인식돼요.

언제 쓰나요

  • 검색, 로그 분석처럼 결과가 길어서 본 대화를 어지럽히는 일
  • 같은 지시로 반복해서 맡기는 일 (리뷰, 문서 점검 등)
  • 비용을 줄이려고 가벼운 모델로 돌리고 싶은 일
원본 저장소·문서 보기2026-10-24에 공식 문서와 대조해 확인했어요. 설치 방법은 바뀔 수 있으니 원본을 함께 보세요.

이 도구가 들어간 조합