서브에이전트
특정 작업에 특화된 AI 도우미를 만들어 Claude에게 일을 나눠주세요.
서브에이전트란?
서브에이전트는 특정 작업(코드 리뷰, 디버깅, 데이터 분석 등)에 특화된 AI 도우미예요. 각각 독립된 작업 공간에서 실행되며, 필요한 도구만 사용하도록 제한할 수 있어요.
컨텍스트 보존
메인 대화의 컨텍스트를 소비하지 않아요.
도구 제한
필요한 도구만 허용해서 안전하게 실행해요.
병렬 실행
여러 서브에이전트를 동시에 돌릴 수 있어요.
비용 절감
간단한 작업은 Haiku 같은 빠른 모델에 맡길 수 있어요.
기본 제공 서브에이전트
| 이름 | 모델 | 용도 |
|---|---|---|
| Explore | Haiku | 빠른 코드 검색/분석 (읽기 전용) |
| Plan | 상속 | Plan 모드에서 조사/분석 |
| General-purpose | 상속 | 복잡한 다단계 작업 |
| Bash | 상속 | 터미널 명령 실행 |
| Claude Code Guide | Haiku | Claude Code 기능 안내 |
나만의 서브에이전트 만들기
방법 1: /agents 메뉴 (가장 쉬운 방법)
- Claude Code에서
/agents입력 - Create new agent 선택
- 범위 선택 (User-level 또는 Project-level)
- Generate with Claude로 자동 생성하거나 직접 작성
- 도구, 모델, 색상 선택 후 저장
방법 2: 마크다운 파일 직접 작성
에이전트 파일을 직접 만들 수도 있어요.
저장 위치:
~/.claude/agents/— 모든 프로젝트에서 사용.claude/agents/— 현재 프로젝트에서만 사용
# ~/.claude/agents/code-reviewer.md 예시
---
name: code-reviewer
description: 코드 품질과 보안을 검사합니다
tools: Read, Glob, Grep
model: sonnet
---
코드를 분석하고 품질, 보안, 모범 사례에 대한
피드백을 제공하세요.주요 설정 옵션
| 설정 | 설명 | 예시 |
|---|---|---|
name | 에이전트 이름 | code-reviewer |
description | 언제 사용할지 설명 | 코드 리뷰 전문가 |
tools | 사용 가능 도구 | Read, Grep, Glob |
model | 사용할 모델 | sonnet, haiku, opus |
memory | 학습 내용 저장 | user, project |
maxTurns | 최대 실행 횟수 | 10 |
isolation | 격리 실행 | worktree |
활용 예시
코드 리뷰: 코드 변경 후 자동으로 품질/보안 검사
병렬 조사: 여러 서브에이전트로 다른 파일/모듈을 동시 분석
비용 절감: 간단한 검색은 Haiku, 복잡한 분석은 Opus에 맡기기