2025년 8월~2026년 6월에 걸쳐 Anthropic의 Claude API에 대규모 업데이트가 진행되었습니다. Claude Fable 5 · Claude Opus 4.8 등 차세대 모델이 등장하는 한편, Sonnet 4 · Opus 4 · Haiku 3 등 구형 모델이 잇따라 제공 종료(retire)되고 있습니다.

대응을 소홀히 하면 모든 요청이 에러가 되기 때문에, 이용 중인 모델 ID를 지금 바로 확인하는 것이 중요합니다. 이 기사에서는 개발자가 취해야 할 액션을 중심으로 정리합니다.

📌 영향을 받는 사람

claude-sonnet-4-20250514

/claude-opus-4-20250514

를 사용 중인 개발자 → 즉시 대응 필수 (이미 에러 발생)
claude-3-haiku-20240307

를 사용 중인 개발자 → 이미 에러 발생 중
claude-opus-4-7

에서 speed:"fast"

를 사용 중인 개발자 → 2026년 7월 24일 삭제
claude-opus-4-1-20250805

를 사용 중인 개발자 → 2026년 8월 5일 retire

⚠️ Breaking Change

다음 모델에 대한 요청은 현재 이미 에러를 반환합니다. 코드베이스를 검색하여 즉시 교체해 주세요.

연구 목적으로 액세스 지속이 필요한 경우에는 External Researcher Access Program에 신청할 수 있습니다.

가장 고성능인 일반 제공 모델 Claude Fable 5 (claude-fable-5)와, Project Glasswing 참가자를 위한 Claude Mythos 5 (claude-mythos-5)가 발표되었습니다.

⚠️ Breaking Change

Fable 5 / Mythos 5에서 thinking:{type:"disabled"}나 수동 확장 사고 예산, assistant prefill을 지정하면 400 에러가 반환됩니다.

⚠️ Breaking Change

Fable 5 / Mythos 5는 동일한 텍스트라도 구형 모델보다 약 30% 더 많은 토큰을 소비합니다. 비용 산정에는 token counting API를 사용하여 재계산해 주세요.

Fable 5 고유 기능으로서, fallbacks 파라미터 (beta)를 통해 거부된 요청을 다른 모델로 자동 재실행할 수 있습니다 (Claude API / Claude Platform on AWS에서 이용 가능).

대화 중간 시스템 메시지 (mid-conversation system messages, 대화 도중 role:"system" 추가)가 Opus 4.8에서 지원되어, 장시간 세션 중에 지시 사항을 변경하더라도 프롬프트 캐시 (Prompt Cache) 히트율을 유지할 수 있습니다.

Sonnet 및 Haiku의 속도 제한 (Rate Limit)이 각 티어(Tier)에서 Opus와 동일한 수준으로 상향되었으며, 이용 티어가 Start / Build / Scale의 3단계로 통합되었습니다. 기존보다 제한이 낮아지는 조직은 없으므로, 별도의 대응은 필요하지 않습니다. 현재 티어는 Claude Console (platform.claude.com)의 Limits 페이지에서 확인할 수 있습니다.

Python / TypeScript / Go / Java / Ruby / PHP / C# 각 SDK가 code_execution_20260120을 지원합니다.

• REPL 상태의 영속화 (세션 내에서 변수 및 함수 재사용 가능)
• 프로그래매틱 도구 호출 (Programmatic Tool Use)의 최소 버전
• beta 헤더 불필요

지원 모델: Claude Fable 5, Mythos 5, Opus 4.5 이후, Sonnet 4.5 이후

Sonnet 4 / Opus 4를 사용 중인 경우 (최우선 사항)

현재 이미 에러가 발생하고 있습니다. 코드베이스에서 claude-sonnet-4-20250514 / claude-opus-4-20250514를 검색하여, claude-sonnet-4-6 / claude-opus-4-8로 교체하십시오.

Opus 4.7의 fast mode를 사용 중인 경우

2026년 7월 24일 이후, speed:"fast" + claude-opus-4-7 조합은 에러가 발생합니다. claude-opus-4-8의 fast mode로 전환하십시오.

Opus 4.1을 사용 중인 경우

2026년 8월 5일에 서비스가 종료됩니다. claude-opus-4-8로의 이전을 계획하십시오.

ZDR 구성에서 Fable 5 도입을 검토 중인 경우

Fable 5는 ZDR에서 이용할 수 없습니다. ZDR이 필요한 경우에는 claude-opus-4-8 등을 사용하십시오.

import anthropic
client = anthropic.Anthropic()
# ❌ Before (에러: 서비스 종료됨)
...

# ❌ Before (Fable 5에서는 400 에러 발생)
response = client.messages.create(
model="claude-fable-5",
...

💡 Tips

Fable 5의 멀티턴 대화 (Multi-turn conversation)에서는 응답에 포함된 thinking 블록을 다음 요청에 그대로 전달해야 합니다. 이를 생략하면 정상적으로 동작하지 않습니다.

# beta 헤더 없이 이용 가능
response = client.messages.create(
model="claude-sonnet-4-6",
...

💡 Tips

Sonnet 4.6 이후 버전에서 웹 검색 (Web Search) / 웹 가져오기 (Web Retrieval) 도구와 코드 실행 (Code Execution)을 병용할 경우, 코드 실행은 무료입니다. 비용 절감을 위해 이 조합을 활용하십시오.

모델 ID 이전 대상 요약표:

• Sonnet 4 → Sonnet 4.6
• Opus 4 / Opus 4.1 → Opus 4.8
• Haiku 3 / Haiku 3.5 → Haiku 4.5
• Sonnet 3.5 / 3.7 → Sonnet 4.6
• Opus 3 → Opus 4.5 (1/3의 비용으로 고성능)

앞으로도 Anthropic의 릴리스 노트(Release Notes)와 Claude Console의 Limits / Deprecations 페이지를 정기적으로 확인하는 것을 권장합니다.