Skip to main content

요약 답변

이는 게이트웨이가 모델을 변경한 것이 아니라, Claude Code 자체의 비용 절감 메커니즘입니다. Claude Code에 설정하신 claude-opus-5은 메인 대화만 처리합니다. 세션 제목 생성이나 주제 감지와 같은 소규모 백그라운드 작업과 Explore 등의 내장 서브에이전트는 기본적으로 더 저렴한 Haiku 모델(예: claude-haiku-4-5-20251001)에서 실행되므로 로그에 두 모델이 모두 표시됩니다. 모든 요청에 Opus를 사용하도록 하려면 환경 변수를 통해 강제 지정할 수 있습니다. 자세한 내용은 아래의 모든 요청에 Opus 강제 적용 섹션을 참고하시기 바랍니다.

로그에서 이를 확인하는 방법

콘솔의 사용량 로그에서 이러한 Haiku 요청은 일반적으로 세 가지 특징을 나타냅니다:
  • Opus 요청과 동일한 token 및 그룹: 동일한 키, 동일한 ClaudeCode 그룹이며, 이는 동일한 Claude Code 클라이언트에서 전송되었음을 의미합니다.
  • 매우 적은 tokens와 호출당 극히 적은 비용: 수천에서 수만 tokens에 달하는 메인 대화 Opus 요청과 확연히 대조적으로, 보통 수십에서 수백 tokens에 불과합니다.
  • 사용자의 동작에 따라 일시에 집중 발생: 새 세션 시작, Claude Code에 코드베이스 검색 요청, 하위 작업 할당 시 집중적으로 발생합니다.
모델 이름은 클라이언트가 전송한 내용과 정확히 일치합니다. APIYI는 요청의 model 필드를 기준으로 라우팅 및 과금을 진행합니다. 로그에 Haiku가 표시된다면 Claude Code가 Haiku를 요청한 것이며, 해당 호출은 Opus 가격이 아닌 Haiku 가격으로 과금됩니다.

Claude Code가 이렇게 작동하는 이유

Claude Code에는 대형 모델과 소형 모델 간의 2단계 분리 구조가 내장되어 있습니다: 백그라운드 작업과 코드 검색은 높은 모델 성능을 필요로 하지 않지만 자주 실행되므로, Haiku를 사용하면 전체 과금을 눈에 띄게 절감할 수 있으며 속도도 더 빠릅니다. 대부분의 사용자에게는 기본 설정이 적절한 선택입니다.

모든 요청을 Opus로 강제 적용하기

모든 요청을 Opus에서 처리하도록 하려면(예: 더 높은 품질의 서브에이전트 검색을 원하는 경우), ~/.claude/settings.json의 env 블록에서 모든 티어가 동일한 Opus 모델을 가리키도록 설정하십시오:
저장한 후 Claude Code를 재시작하십시오. 그러면 사용 로그에 claude-opus-5-5만 표시됩니다.
claude-opus-5-5를 메인 모델로 사용하십시오. claude-opus-5보다 최신이며 성능이 더 우수하고, ClaudeCode 그룹에서 사용할 수 있습니다. 위 설정에서 모델 이름을 복사하기만 하면 됩니다.
모든 작업을 Opus로 실행하면 비용이 눈에 띄게 증가합니다. 백그라운드 작업과 서브에이전트가 자주 실행되며, 기존에 Haiku 가격으로 과금되던 호출이 모두 Opus 가격으로 과금됩니다. 더 스마트한 소형 모델만 원하신다면 절충안으로 ANTHROPIC_DEFAULT_HAIKU_MODEL를 더 최신인 claude-haiku-5-5으로 설정하고 나머지는 기본값으로 두는 방법이 있습니다.

FAQ

token, IP 및 타임라인을 확인하십시오. Haiku 요청이 Opus 요청과 동일한 token을 사용하고, 동일한 IP에서 발생하며, 본인의 작업 활동 내역과 일치한다면 해당 요청은 본인의 Claude Code에서 발생한 것입니다. 낯선 IP가 확인되거나 작업하지 않은 시간대에 대량 사용이 발생했다면 키 유출로 간주하십시오. 자세한 내용은 Token 관리를 참조하십시오.
/model은 메인 대화 모델만 전환합니다. 백그라운드 헬퍼 및 서브에이전트가 사용하는 모델은 변경되지 않습니다. 해당 모델들도 변경하려면 위와 같이 ANTHROPIC_DEFAULT_HAIKU_MODEL 및 CLAUDE_CODE_SUBAGENT_MODEL을 설정하십시오.
CC Switch와 같은 도구 역시 Claude Code의 환경 변수를 설정할 뿐입니다. 관련 제공자 프로필에서 위의 변수를 claude-opus-5-5(으)로 설정하십시오. 자세한 내용은 CC Switch 설정을 참조하십시오.

관련 문서

Claude Code 설정 가이드

설치, APIYI 설정 및 일반적인 문제

Codex, ClaudeCode 및 기본 그룹

Claude Code에 사용할 token 그룹