이 문서는 Anthropic의 새로운 모델인 Claude Haiku 5.5의 주요 업데이트 사항, 기술적 변경점 및 마이그레이션 가이드를 다루고 있습니다.

핵심 개요

Claude Haiku 5.5는 고부하, 지연 시간에 민감한 작업(분류, 라우팅, 추출, subagent 태스크)에 최적화된 모델입니다. 1M 토큰의 컨텍스트 윈도우와 최대 128k의 출력 토큰을 지원하며, 최신 토크나이저를 도입하여 이전 모델인 Claude Haiku 4.5 대비 동일한 텍스트에 대해 토큰 수가 약 30% 증가합니다.

주요 기능 및 기술적 변경 사항

1. Adaptive Thinking 및 effort 파라미터:

모델이 스스로 사고의 양과 방식을 결정하는 Adaptive thinking이 기본 활성화됩니다. 사용자는 effort 파라미터를 통해 응답 품질과 속도/비용 간의 트레이드오프를 조정할 수 있습니다. 기존의 수동 budget_tokens 방식은 제거되었습니다.

2. 토크나이저 변화:

Claude 4.7 이후 적용된 최신 토크나이저를 사용함에 따라, 토큰 산정 방식이 변경되었습니다. 비용 추산 및 max_tokens 설정 시 이를 반영한 재계산이 필요합니다.

3. API 동작 및 제약 사항:
   • 응답 구조: 응답이 thinking 블록으로 시작할 수 있으므로, 응답 파싱 시 위치 기반이 아닌 type 기반의 블록 선택 로직을 사용해야 합니다.
   • 샘플링 파라미터: 비기본적인 temperature, top_p, top_k 설정 시 에러가 발생하므로 이를 생략해야 합니다.
   • Assistant prefill: Assistant 메시지로 응답을 시작하는(prefill) 방식이 금지되며, 반드시 user 턴으로 대화를 종료해야 합니다.
   • Computer use: 기존 computer_20250124 툴 대신 computer_toolset_20260801을 사용해야 합니다.
   • 보안 및 재현성: 안전성 분류기에 의한 거부 시 stop_reason: "refusal"을 처리해야 하며, thinking 블록은 생성된 계정 혹은 연결된 계정 내에서만 재현 가능합니다.

마이그레이션 핵심 가이드

• Thinking 블록 제어: thinking.display 설정을 통해 사고 과정을 요약할 수 있습니다.
• 컨텍스트 제한: max_tokens 설정 시 thinking 토큰이 전체 할당량에 포함된다는 점을 고려해야 합니다.
• 대화 유지: thinking 블록이 포함된 대화를 재전송할 경우, 대화의 일관성을 위해 수정 없이 append-only 방식을 유지해야 합니다.