Claude Code subagent 구조 및 모델 할당 분석

Claude Code에는 총 6가지의 내장(built-in) subagent 유형이 존재하며, 이는 크게 3개의 주요 에이전트, 1개의 fork 타입, 2개의 헬퍼 에이전트로 구성됩니다.

주요 내장 subagent 유형:

• Explore: 파일 검색 및 코드 탐색용. Haiku 모델이 고정되어 있으며, 읽기 전용(Write/Edit 불가)으로 작동함.
• Plan: 코드베이스 연구용. 상위 모델의 성능을 상속받음.
• General-purpose: 복잡한 연구 및 코드 수정 수행.
• Fork: 현재 세션의 모델, 도구, 히스토리를 그대로 상속받아 새로운 작업을 수행함.

특히 Explore 에이전트는 다른 subagent들과 달리 모델 선택 과정이 고정되어 있어, 복잡한 디버깅 시 모델의 추론 능력 한계로 인해 의도와 다른 결과가 나올 수 있음에 유의해야 합니다.