Claude Haiku 5.5 출시 — Effort 설정으로 API 비용 아끼는 법

앤트로픽이 속도와 비용을 잡으면서 추론 능력까지 챙긴 Claude Haiku 5.5를 공개했습니다. 질문의 복잡도에 따라 스스로 생각 깊이를 조절하는 적응형 생각 기능이 기본으로 작동하는데요. API 비용을 아끼면서 에이전트 성능을 최적화할 수 있는 Haiku 5.5의 핵심 변화와 실전 활용법을 정리했습니다.

적응형 생각과 5단계 Effort 설정이란?

기존 추론 모델은 생각에 사용할 토큰 예산을 숫자로 직접 지정해야 했습니다. 반면 Claude Haiku 5.5는 질문의 난이도를 파악해 스스로 생각 길이를 조절하는 적응형 생각 방식을 기본으로 동작합니다.

개발자는 작업 성격에 따라 생각의 깊이를 5단계 Effort 설정으로 직접 제어할 수 있습니다. 선택할 수 있는 옵션은 low, medium, high, xhigh, max 이며, 기본값은 medium입니다.

단순 텍스트 변환이나 데이터 추출처럼 빠른 답변이 필요한 작업에는 Effort를 low로 지정하는 것이 유리합니다. 불필요한 연산을 줄여 응답 시간을 단축하고 토큰 소비를 아낄 수 있습니다. 반대로 복잡한 코드 검증이나 다단계 에이전트 로직을 처리할 때는 high 이상으로 올려 필요한 만큼 충분히 추론하도록 유도할 수 있습니다.

API 비용을 결정짓는 10만 토큰 계단식 요금제

Claude Haiku 5.5의 API 요금은 프롬프트 길이에 따라 가격이 달라지는 계단식 구조를 취하고 있습니다. 비용 관리에서 가장 중요한 기준점은 10만 토큰입니다.

프롬프트 크기가 10만 토큰 이하일 때는 백만 토큰당 입력 0.10달러, 출력 0.50달러로 매우 부담 없이 사용할 수 있습니다. 하지만 프롬프트가 10만 토큰을 초과하면 입력 요금은 백만 토큰당 0.50달러, 출력 요금은 2.50달러로 5배 늘어납니다.

긴 대화 맥락이나 대용량 문서를 처리할 때는 프롬프트 크기를 10만 토큰 이내로 관리하는 전략이 중요합니다. 피치 못하게 대용량 맥락을 계속 전달해야 한다면, 백만 토큰당 0.01달러에 불과한 프롬프트 캐싱을 적극 활용해 비용 부담을 낮출 수 있습니다.

실전 API 코드 설정과 자주 마주치는 400 에러

Haiku 5.5의 생각 깊이를 조절하는 방법은 간단합니다. Anthropic Python SDK를 사용할 때 API 요청의 output_config 객체에 원하는 effort 수준을 지정해주면 됩니다.