Claude Haiku 3, 4월 19일부로 은퇴 — 마이그레이션 체크리스트

무슨 일이 벌어지나

2026-04-19 이후 claude-3-haiku-20240307 등 Haiku 3 계열 모델 ID 호출은 deprecation 에러 또는 404 를 반환한다. 프로덕션에서 이 모델을 쓰는 팀은 오늘 안에 교체가 필요.

영향 받는 워크로드

• 채팅 1차 응답 봇
• 대량 분류·태깅 파이프라인
• RAG 1차 리랭커
• 모더레이션·스팸 필터
• 간단 요약 배치 작업

교체 방법

- model: "claude-3-haiku-20240307"
+ model: "claude-haiku-4-5"

또는 alias 미사용 명시 버전:

claude-haiku-4-5-20251001

가격 비교

| | Haiku 3 | Haiku 4.5 | |---|---|---| | 입력 | $0.25 / MTok | $1 / MTok | | 출력 | $1.25 / MTok | $5 / MTok | | 컨텍스트 | 200k | 200k | | 출력 한도 | 4k | 64k | | 지연시간 | 낮음 | 더 낮음 | | 추론 품질 | 보통 | Sonnet 3.5 수준 |

단가는 4배 뛰었지만 품질·지연시간 모두 크게 개선돼 동일 작업당 토큰 수가 줄고 재호출률이 낮아지면서 실질 체감 비용 증가는 보통 2배 내외.

마이그레이션 체크리스트

• [ ] 코드베이스 전체에서 claude-3-haiku 문자열 검색
• [ ] 환경변수 MODEL_ID 를 쓰고 있었다면 deploy 값만 변경
• [ ] 출력 토큰 한도를 높게 가정한 코드가 있는지 확인 (4k → 64k 로 늘어남)
• [ ] 프롬프트 평가 샘플 20개로 품질 regression 테스트
• [ ] 비용 대시보드에서 이틀간 실지출 모니터

은퇴 예정 다른 모델

• Sonnet 4 / Opus 4 — 2026-06-15 은퇴 예정. 아직 시간 있지만 마이그레이션 계획 세워둘 것.