에이전트
개요

에이전트 개요

에이전트는 제한된 범위의 위임된 작업을 처리하는 전문 서브에이전트입니다.

🤖

에이전트는 특정 도구와 모델에 대한 접근 권한을 가지고, 자신의 전문 분야에 집중합니다.

에이전트란?

에이전트는 Claude Code가 복잡한 작업을 더 효율적으로 처리할 수 있도록 돕는 전문화된 서브에이전트입니다.

에이전트의 구조

---
name: agent-name
description: 에이전트 설명
tools: Read, Write, Edit, Bash, Grep, Glob
model: opus
---
 
에이전트의 역할과 지침...

메타데이터 필드

필드설명예시
name에이전트 고유 이름code-reviewer
description에이전트 역할 설명코드 품질 검토
tools사용 가능한 도구Read, Grep, Glob
model사용할 모델opus, sonnet

에이전트 목록

🗓️ planner🏗️ architect🧪 tdd-guide👀 code-reviewer🔒 security-reviewer🔧 build-error-resolver🎭 e2e-runner🧹 refactor-cleaner📝 doc-updater

에이전트 사용 가이드

1. 언제 에이전트를 사용할까?

상황추천 에이전트다운로드
새 기능 계획planner
시스템 설계architect
테스트 작성tdd-guide
코드 리뷰code-reviewer
보안 검토security-reviewer
빌드 오류build-error-resolver
E2E 테스트e2e-runner
코드 정리refactor-cleaner
문서 업데이트doc-updater

2. 에이전트 설치

# 모든 에이전트 복사
cp agents/*.md ~/.claude/agents/
 
# 또는 필요한 에이전트만
cp agents/code-reviewer.md ~/.claude/agents/
cp agents/tdd-guide.md ~/.claude/agents/

3. 에이전트 커스터마이징

에이전트 파일을 수정하여 본인의 워크플로우에 맞게 조정할 수 있습니다:

---
name: code-reviewer
description: 우리 팀의 코딩 컨벤션에 맞춘 코드 리뷰
tools: Read, Grep, Glob
model: sonnet  # opus 대신 sonnet 사용
---
 
# 우리 팀 코드 리뷰어
 
## 추가 규칙
- 변수명은 camelCase 사용
- 함수는 20줄 이하로 유지
- 모든 public 함수에 JSDoc 작성
...

에이전트 vs 스킬 vs 규칙

구분에이전트스킬규칙
목적복잡한 작업 위임워크플로우 정의항상 따를 가이드라인
실행독립적으로 실행에이전트/커맨드가 호출자동으로 적용
도구지정된 도구만 사용도구 없음도구 없음
모델지정 가능없음없음
⚠️

팁: 에이전트는 컨텍스트 윈도우를 사용합니다. 필요한 에이전트만 활성화하세요.

모범 사례

  1. 명확한 역할 정의 - 각 에이전트가 무엇을 하는지 명확히
  2. 적절한 도구 선택 - 필요한 도구만 부여
  3. 모델 선택 - 복잡한 작업은 opus, 간단한 작업은 sonnet
  4. 설명 활용 - description으로 언제 사용할지 명시
  5. 정기적 검토 - 에이전트가 여전히 유용한지 주기적으로 확인
planner (계획 수립)