Claude Code의 Sub Agent가 독립적 컨텍스트와 역할별 도구 제한으로 메인 세션의 컨텍스트 오염을 방지하고 전문성을 제공하는 구조

Context

메인 Claude Code 세션이 모든 작업을 직접 처리하면 대화 컨텍스트가 복잡해지고, 다양한 업무 도메인에 최적화하기 어렵다는 구조적 한계가 존재한다.

Technical Solution

• Sub Agent → 독립적 컨텍스트 윈도우와 전용 시스템 프롬프트로 격리된 실행 환경 제공
• 빌트인 에이전트 4종(Explore, Plan, General-purpose, Bash)이 자동으로 선택되어 각각 코드 탐색, 사전 분석, 복합 작업, 터미널 명령 담당
• /agents 명령어로 생성 시 description 기반 자동 위임 가능하며, 마크다운 파일(YAML + 본문)로 구조화
• Personal 범위(~/.claude/agents/)와 Project 범위(.claude/agents/)로 저장 위치별 가용 범위 구분

Impact

코드 리뷰, 테스트 작성, 보안 감사 등 역할별 특화된 에이전트로 작업 정확도 향상

Key Takeaway

Sub Agent는 외부 시스템 연동을 위한 MCP와 달리 AI 작업 전용 인스턴스로, least privilege 원칙에 따른 도구 제한으로 보안을 강화하는 설계