Claude Code 서브에이전트 모델 동작 변경
PSA: Claude Code subagents inherit your session model now, they're not free Haiku anymore
·2026.07.27 04:12
Claude Code의 서브에이전트가 기존 Haiku 모델에서 메인 세션 모델을 상속받는 방식으로 변경되었습니다.
Claude Code v2.1.198 업데이트 이후, **서브에이전트(Subagent)**의 모델 동작 방식이 변경되었습니다.
기존에는 서브에이전트가 비용이 저렴한 Haiku 모델로 실행되어 토큰 소모를 줄였으나, 이제는 별도의 설정이 없으면 **메인 대화 세션의 모델을 그대로 상속(Inherit)**받습니다. 예를 들어, 사용자가 Opus 모델로 세션을 진행 중이라면 서브에이전트 역시 Opus 모델로 동작하게 됩니다.
주요 변경 사항 및 해결 방법:
- 모델 상속: 서브에이전트의
model필드가 기본적으로inherit로 설정됨. - 비용 관리: 서브에이전트가 고비용 모델을 사용하는 것을 방지하려면
CLAUDE_CODE_SUBAGENT_MODEL=haiku환경 변수를 설정하거나, 특정 에이전트의 frontmatter에model: haiku를 명시해야 함. - 해결 순서: 환경 변수 → 호출 시 모델 파라미터 → 서브에이전트 frontmatter → 메인 대화 모델 순으로 적용됨.
이 요약은 원문 이해를 돕기 위한 큐레이션입니다. 저작권은 원저작자에게 있으며, 정확한 내용과 맥락은 원문을 확인하세요.
요약 오류, 출처 표기 문제, 삭제 요청은 문의 · 건의로 알려주세요.