Claude 서브에이전트 사용법 복잡한 작업을 팀원처럼 나눠 처리하기

🤖

Claude의 기능들 4강

Claude가 복잡한 작업을 팀원처럼 나눠서 처리하는 기능입니다

에이전트란?

에이전트는 Claude 안에서 돌아가는 전문 보조원입니다. 큰 작업을 여러 보조원에게 나눠주면 더 빠르고 정확하게 처리할 수 있습니다.

💡
비유: 팀장(메인 Claude)이 팀원(에이전트)에게 “너는 이거 조사해”, “너는 저거 분석해” 하고 나눠준 다음, 결과를 모아서 정리하는 것과 같습니다.

기본 제공 에이전트

🔧
일반

모든 작업 가능

복잡한 작업을 자율적으로 처리합니다. 모든 도구를 사용할 수 있습니다.

🔍

파일 찾기 / 검색

파일을 찾거나 코드를 검색합니다. 읽기만 가능하고 수정은 불가합니다.

📋
계획

작업 계획 수립

작업 계획을 세우고 구조를 분석합니다. 읽기만 가능하고 수정은 불가합니다.

에이전트가 실제로 동작하는 모습

예시

나: "이 프로젝트의 모든 API를 찾아서 문서로 정리해줘"

Claude (팀장):
  ├── 탐색 에이전트 1 → 프로젝트 파일 전체 검색
  ├── 탐색 에이전트 2 → API 관련 코드 분석
  └── 결과 종합 → API 문서 작성
⚡ 여러 에이전트가 동시에 작업하므로 하나씩 하는 것보다 훨씬 빠릅니다.

가장 쉽게 만드는 방법

직접 파일을 만들 필요 없이, Claude에게 대화로 요청하면 됩니다.

1

간단하게 요청

코드를 검토해주는 커스텀 에이전트를 만들어줘
2

구체적으로 요청

변경된 파일과 관련된 테스트를 자동으로 찾아서 실행해주는
에이전트를 만들어줘. 결과를 알기 쉽게 정리해주면 좋겠어.

Claude가 .claude/agents/ 폴더에 파일을 자동으로 만들어줍니다.

에이전트 파일 구조

.claude/agents/ 폴더에 파일을 만들면 나만의 전문 보조원을 만들 수 있습니다.

예시: .claude/agents/checker/checker.md

---
description: 변경된 파일과 관련된 테스트를 찾아서 실행합니다
tools: Bash, Read, Glob, Grep
---

1. 변경된 파일 목록을 확인하세요
2. 관련된 테스트 파일을 찾으세요
3. 해당 테스트만 실행하세요
4. 결과를 알기 쉽게 정리해서 보고하세요