AI Briefing

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 → 메인 대화 모델 순으로 적용됨.

이 한국어 요약은 AI가 자동으로 만들었습니다. 원문의 주장과 맥락은 원문에서 확인해 주세요. 저작권은 원저작자에게 있습니다.

AI 처리 방식을 확인하거나, 요약 오류와 출처 표기 문제, 삭제 요청을 문의 · 건의로 알려주세요.