Claude Haiku 4.5로 마이그레이션하기

Claude Haiku 4.5는 프론티어에 근접한 성능을 갖춘 가장 빠르고 가장 지능적인 Haiku 모델로, 대화형 애플리케이션과 대용량 처리를 위한 프리미엄 모델 품질을 제공합니다.

기능에 대한 전체 개요는 모델 개요를 참조하세요.

Claude Haiku 3.5 및 이전 Haiku 모델에서 Claude Haiku 4.5로 마이그레이션하기

모델 이름 업데이트:

# Haiku 3.5에서
model = "claude-3-5-haiku-20241022"  # Before
model = "claude-haiku-4-5-20251001"  # After

새로운 속도 제한 검토: Haiku 4.5는 Haiku 3.5와 별도의 "rate limit"(속도 제한)을 가집니다. 자세한 내용은 속도 제한 문서를 참조하세요.

새로운 기능 살펴보기: 컨텍스트 인식, 증가된 출력 용량(64k 토큰), 더 높은 지능, 향상된 속도에 대한 자세한 내용은 모델 개요를 참조하세요.

호환성이 깨지는 변경 사항

이러한 호환성이 깨지는 변경 사항은 Claude 3.x Haiku 모델에서 마이그레이션할 때 적용됩니다.

1. 샘플링 매개변수 업데이트

   temperature 또는 top_p 중 하나만 사용하고, 둘 다 사용하지 마세요. 둘 다 설정하면 Claude Haiku 4.5에서 400 오류가 반환됩니다.

2. 도구 버전 업데이트

   최신 도구 버전(text_editor_20250728, code_execution_20250825)으로 업데이트하세요. undo_edit 명령을 사용하는 모든 코드를 제거하세요.

3. refusal 중지 사유 처리

   refusal 중지 사유를 처리하도록 애플리케이션을 업데이트하세요.

4. 동작 변경에 맞춰 프롬프트 업데이트

   Claude 4 모델은 더 간결하고 직접적인 커뮤니케이션 스타일을 가지고 있습니다. 최적화 지침은 프롬프트 작성 모범 사례를 검토하세요.

Haiku 4.5 마이그레이션 체크리스트

• 모델 ID를 claude-haiku-4-5-20251001로 업데이트
• 호환성 깨짐: 도구 버전을 최신(text_editor_20250728, code_execution_20250825)으로 업데이트. 레거시 버전은 지원되지 않음
• 호환성 깨짐: undo_edit 명령을 사용하는 모든 코드 제거(해당하는 경우)
• 호환성 깨짐: temperature 또는 top_p 중 하나만 사용하도록 샘플링 매개변수 업데이트(둘 다 설정하면 400 오류 반환)
• 애플리케이션에서 새로운 refusal 중지 사유 처리
• 새로운 속도 제한 검토 및 조정(Haiku 3.5와 별도)
• 프롬프트 작성 모범 사례에 따라 프롬프트 검토 및 업데이트
• 복잡한 추론 작업을 위해 확장 사고 활성화 고려
• 프로덕션 배포 전 개발 환경에서 테스트