🤖에이전트
Claude Code의 Subagent 시스템 완벽 가이드
컨텍스트 관리와 작업 특화를 위한 Claude Code의 Subagent 생성 및 활용 방법
↗ 원본 링크#Claude Code#Subagent#AI 에이전트#컨텍스트 관리
Subagent란?
Subagent는 특정 작업을 처리하는 특화된 AI 어시스턴트입니다. 각 Subagent는 독립적인 컨텍스트 윈도우에서 실행되며, 주 대화창을 깔끔하게 유지하면서 복잡한 작업을 처리합니다.
Subagent의 주요 이점
▸
컨텍스트 보존: 탐색과 구현을 분리하여 주 대화창 정리
▸
제약 조건 적용: 특정 도구만 사용하도록 제한 가능
▸
구성 재사용: 프로젝트 간 설정 공유
▸
동작 특화: 특정 도메인에 맞춤화된 시스템 프롬프트
▸
비용 제어: Haiku 같은 저렴한 모델로 작업 라우팅
내장 Subagent 종류
1. Explore (탐색 에이전트)
코드베이스 검색 및 분석에 최적화된 읽기 전용 에이전트입니다.
▸
모델: 주 대화에서 상속 (Claude API에서는 Opus로 제한)
▸
도구: 읽기 전용 (Write, Edit 불가)
▸
용도: 파일 검색, 코드 탐색, 코드베이스 분석
▸
철저함 수준: quick / medium / very thorough
2. Plan (계획 에이전트)
Plan mode에서 계획 수립 전 컨텍스트를 수집하는 연구 에이전트입니다.
▸
모델: 주 대화에서 상속
▸
도구: 읽기 전용
▸
용도: 계획을 위한 코드베이스 연구
3. General-purpose (범용 에이전트)
복잡한 다단계 작업을 위한 유능한 에이전트입니다.
▸
모델: 주 대화에서 상속
▸
도구: 모든 도구 사용 가능
▸
용도: 복잡한 연구, 다단계 작업, 코드 수정
사용자 정의 Subagent 만들기
동일한 유형의 작업을 반복적으로 수행할 때 커스텀 Subagent를 정의하면 효율적입니다.
핵심 포인트
▸
명확한 설명 작성: Claude가 언제 해당 Subagent를 사용할지 판단하는 기준
▸
도구 제한 설정: 필요한 도구만 허용하여 안전성 확보
▸
스코프 선택: 사용자 수준 또는 프로젝트 수준으로 범위 지정
컨텍스트 절감 효과
Subagent는 자체 컨텍스트 윈도우에서 작업을 수행하고 요약만 반환하므로, 주 대화창이 검색 결과나 로그로 넘치는 것을 방지합니다.
컨텍스트 윈도우 시각화에서 실제 작동 방식을 확인할 수 있습니다.
주의사항
▸Explore와 Plan은 CLAUDE.md 파일과 git 상태를 건너뛰어 빠르게 작동
▸사용자 정의 Subagent는 CLAUDE.md와 git 상태를 모두 로드
▸`Explore`라는 이름의 커스텀 Subagent는 내장 Explore를 재정의함