Claude Haiku 3 API, 4월 20일 이후엔 이 코드가 에러를 냅니다

결론부터 말씀드리면 — claude-3-haiku-20240307을 API 코드 어딘가에 하드코딩해 놨다면, 2026년 4월 20일 이후 해당 요청은 에러를 반환합니다. Anthropic 공식 문서에 퇴역일이 명확히 찍혀 있습니다. 그런데 많은 곳에서 “4월 19일”이라고 돌아다니는 날짜는 틀린 정보입니다. 공식 deprecation 테이블 기준 정확한 날짜는 4월 20일입니다. 5일밖에 남지 않았습니다.

공식 종료일이 “4월 19일”이 아닌 이유

수많은 영문 블로그와 유튜브 영상이 “Claude Haiku 3 is retiring April 19, 2026”이라는 제목을 달고 있습니다. 국내 정리 글도 “19일”로 옮겨 적은 게 많습니다. 직접 확인해봤습니다.

Anthropic이 2026년 2월 19일 공지에서 “April 19″라는 날짜를 언급한 건 맞습니다. 그런데 platform.claude.com/docs/en/about-claude/model-deprecations 테이블에 현재 찍혀 있는 공식 Tentative Retirement Date는 April 20, 2026입니다. (출처: Anthropic Model Deprecations 공식 문서, 2026.04.15 확인)

하루 차이가 별거 아닌 것 같지만, 4월 19일 자정을 목표로 배포 작업을 잡아둔 팀이라면 타이밍이 달라집니다. 공식 문서를 직접 확인하는 습관이 왜 필요한지가 이 사례에서 딱 보입니다.

한편 Amazon Bedrock에서는 별도 일정이 적용됩니다. Bedrock 기준으로 Claude Haiku 3 요청은 2026년 2월 26일부터 이미 Haiku 4.5로 자동 리라우팅되고 있습니다. Bedrock을 쓴다면 이미 몇 달 전에 전환이 자동 처리됐을 수 있습니다. Claude API 직접 호출자만 지금 마이그레이션이 필요합니다.

▲ 목차로 돌아가기

코드 어디에 숨어 있는지 찾는 법

한 줄 grep으로 전체를 스캔하는 방법

모델 ID가 코드베이스에 박혀 있는 위치는 생각보다 다양합니다. 함수 기본값, 설정 딕셔너리, 테스트 픽스처, .env 파일, CI/CD 파이프라인 시크릿까지 퍼져 있는 경우가 실제 사례에서 자주 확인됩니다.

# Python, JSON, YAML, .env 전체 검색
grep -r "claude-3-haiku" . \
--include="*.py" \
--include="*.json" \
--include="*.yaml" \
--include="*.env" -n

위 명령어를 실행해서 나오는 결과가 0줄이라면 안전합니다. 한 줄이라도 걸린다면 아래 섹션에서 교체 대상과 요금 변화를 확인하고 넘어가세요.

한 번 바꾸고 두 번 다시 안 고치는 구조 만들기

Anthropic은 이번이 처음이 아닙니다. Claude 2, Sonnet 3, Haiku 3.5, Sonnet 3.7이 이미 차례로 퇴역했습니다. 하드코딩을 반복하면 deprecation 공지마다 같은 작업을 반복하게 됩니다. 모델 ID를 한 파일에서 중앙 관리하는 패턴이 실무에서 가장 안정적입니다.

# models.py — 여기 한 곳만 바꾸면 됩니다
class Models:
FAST    = "claude-haiku-4-5-20251001"   # Haiku 3 대체
STANDARD = "claude-sonnet-4-6"
POWERFUL = "claude-opus-4-6"
# HAIKU_3 = "claude-3-haiku-20240307"   # 2026-04-20 종료

▲ 목차로 돌아가기

Haiku 4.5로 바꾸면 요금이 어떻게 달라지나

“Haiku 4.5는 Haiku 3과 가격이 같다”는 정보가 여러 영문 사이트에 퍼져 있습니다. 이게 잘못된 정보입니다. Haiku 3.5의 가격($0.80/$4)과 혼동한 결과입니다. 공식 가격을 직접 비교하면 이렇습니다.

(출처: Anthropic 공식 Pricing 문서 및 Models Overview, 2026.04.15 기준)

월 500만 input 토큰을 처리하는 서비스 기준으로 계산해보면:

• Haiku 3 기준: 500만 × $0.25 = 월 $1.25
• Haiku 4.5 전환 후: 500만 × $1.00 = 월 $5.00
• 월 차이: +$3.75 (약 3배 증가)

Haiku 4.5는 Batch API를 사용하면 50% 할인이 적용됩니다($0.50/$2.50). 실시간 응답이 필요 없는 대량 처리 작업이라면 Batch API와 함께 쓰는 게 비용 충격을 줄이는 현실적인 방법입니다.

▲ 목차로 돌아가기

Haiku 3 대비 실제 성능이 얼마나 올랐나

요금은 올랐는데 성능도 그만큼 올랐는지가 핵심 질문입니다. Anthropic 공식 발표(2025.10.15)에서 인용한 수치와 벤치마크를 공개 자료 기준으로 정리했습니다.

(출처: Anthropic — Introducing Claude Haiku 4.5, 2025.10.15 / HappyCapy Migration Guide, 2026.04)

Anthropic의 공식 발표에 따르면, Haiku 4.5는 출시 당시 Claude Sonnet 4(2025년 5월 모델) 수준의 코딩 성능을 보여줬습니다. 6개월 전 플래그십 성능이 경량 모델 가격으로 내려온 셈입니다. 요금 4배라는 숫자만 보면 부담스럽지만, 성능 등급 자체가 한 단계 올라간 것입니다.

분류, 라우팅, 짧은 응답 생성처럼 Haiku 3을 선택했던 대부분의 용도에서 Haiku 4.5는 단순한 대체가 아니라 품질 업그레이드입니다. 요금 인상분을 비용으로 볼 것인지, 성능 향상을 위한 투자로 볼 것인지는 각 서비스의 용도에 따라 판단이 달라집니다.

▲ 목차로 돌아가기

Sonnet 4.6으로 갈아탈 타이밍인지 판단하는 조건

Haiku 3을 쓴 이유가 “가격” 때문이었다면

Haiku 4.5로 바로 가는 게 맞습니다. API 포맷이 완전히 동일하고, 모델 ID 문자열 하나만 교체하면 됩니다. 요금은 올랐지만 성능도 올랐으므로 단순 대체로 처리하는 게 현실적입니다.

Haiku 3이 가끔 아쉬웠다면 Sonnet 4.6을 재검토할 시점

Haiku 3으로 처리하던 작업이 추론이 부족해 실패했거나, 도구 사용 정확도 문제가 있었다면 이번 기회에 Sonnet 4.6을 고려해볼 만합니다. Sonnet 4.6은 Haiku 4.5보다 3배 비싸지만($3/$15), 1M 토큰 컨텍스트 창을 기본 지원하고 복잡한 에이전트 작업에서 확연히 다른 결과를 냅니다.

실무 기준으로 판단하는 분기점은 이렇습니다. 하루 100만 output 토큰 이하의 소규모 서비스라면 Haiku 4.5 전환 시 월 비용 차이가 수 달러 수준입니다. 하루 1,000만 output 토큰 이상을 처리하는 고트래픽 서비스라면 요금 차이가 매달 수백 달러까지 벌어질 수 있으므로 Batch API 활용 여부와 함께 시뮬레이션이 필요합니다.

▲ 목차로 돌아가기

오늘 동시에 터진 또 다른 deprecated 공지

Haiku 3 종료일에만 집중하다 놓치기 쉬운 소식이 오늘 하나 더 나왔습니다. 2026년 4월 14일, Anthropic이 Claude Sonnet 4와 Claude Opus 4도 공식 deprecated 처리했습니다.

Sonnet 4와 Opus 4는 종료까지 약 2개월이 남아 있어 Haiku 3만큼 급박하지는 않습니다. 하지만 같은 코드베이스에 여러 모델이 섞여 있다면, Haiku 3 교체 작업을 하는 김에 Sonnet 4, Opus 4 모델 ID도 함께 점검하는 것이 효율적입니다.

이번에 Anthropic이 deprecated 처리한 모델 패턴을 보면, Claude 3 세대와 Claude 4 초기 모델(2025년 5월 스냅샷)을 동시에 정리하는 흐름입니다. 앞으로도 Claude 4 시리즈가 Claude 4.6 라인업으로 전면 교체될 가능성이 높습니다.

▲ 목차로 돌아가기

마이그레이션 체크리스트 — 5단계

4월 20일 이전에 완료해야 하는 작업을 순서대로 정리했습니다.

▲ 목차로 돌아가기

자주 나오는 질문 5가지

▲ 목차로 돌아가기

마치며

Claude Haiku 3 API 종료가 5일 앞으로 다가왔는데도 한국어로 정리된 자료가 거의 없었습니다. 특히 공식 종료일이 “4월 20일”이라는 점, Haiku 4.5의 요금이 Haiku 3보다 4배 올랐다는 점, 그리고 오늘 동시에 Sonnet 4와 Opus 4도 deprecated 처리됐다는 점은 기존 영문 기사들에서도 명확히 정리되지 않은 부분입니다.

마이그레이션 자체는 어렵지 않습니다. 모델 ID 하나 바꾸고, 스테이징에서 테스트하고, 4월 19일 이전에 프로덕션에 올리면 됩니다. 하지만 하드코딩 패턴이 남아 있다면 다음 deprecation 때 또 같은 작업을 하게 됩니다. 이번 기회에 모델 상수 파일 하나로 중앙 관리하는 구조로 바꿔두는 것이 더 오래가는 해결책입니다.

솔직히 말하면, Haiku 4.5의 성능이 1년 전 Sonnet 수준으로 올라온 건 개발자 입장에서 나쁜 소식이 아닙니다. 요금 부담이 있다면 Batch API로 절반을 아낄 수 있고, 고트래픽 서비스라면 멀티 에이전트 구조를 검토할 때 Haiku 4.5가 하위 에이전트 역할로 꽤 잘 맞습니다.

본 포스팅 참고 자료

1. ① Anthropic — Model Deprecations 공식 문서 (platform.claude.com/docs/en/about-claude/model-deprecations)
2. ② Anthropic — Introducing Claude Haiku 4.5 (anthropic.com/news/claude-haiku-4-5)
3. ③ Anthropic — Models Overview & Pricing (platform.claude.com/docs/en/about-claude/models/overview)
4. ④ Anthropic — Release Notes (Claude API Docs) (platform.claude.com/docs/ko/release-notes/overview)