Claude Code의 저품질 결과물 원인: 하위 모델(Haiku) 사용 문제

작성자의 가설에 동의하며, 에이전트가 사용자 모르게 하위 모델을 사용하는 'on the dl(비밀리에)' 방식에 대해 주의가 필요하다는 반응이다.

• Claude.md 파일에 'Use only Sonnet or Opus for subagents'와 같은 규칙을 추가하여 Haiku 사용을 차단하라.
• 에이전트가 수행하는 진단 작업의 로그를 확인하여 어떤 모델이 정보를 수집하고 있는지 모니터링하라.

Subagent

— 메인 AI 에이전트의 지시를 받아 특정 하위 작업을 수행하는 보조 모델이다. 복잡한 워크플로를 분산 처리하여 효율성을 높이지만, 성능이 낮은 모델을 서브에이전트로 사용할 경우 전체 결과물의 품질이 저하될 수 있다.

Diagnostics

— 코드의 오류나 구조를 분석하여 메인 모델에게 정보를 제공하는 사전 탐색 단계이다. 이 단계에서 정확한 정보가 수집되지 않으면 메인 모델이 잘못된 근거를 바탕으로 코드를 작성하게 되는 원인이 된다.

Claude.md

— Claude Code와 같은 에이전트 도구의 동작 방식이나 규칙을 정의하는 설정 파일이다. 사용자는 이 파일을 통해 에이전트가 특정 모델만 사용하도록 강제하거나 작업 처리 가이드라인을 명시할 수 있다.