Molayo

© 2026 Molayo

Qiita헤드라인2026. 06. 27. 21:53

Claude API 대규모 업데이트 총정리: Fable 5 등장 및 구형 모델 폐지에 따른 대응 가이드

요약

Anthropic의 Claude API 대규모 업데이트로 인해 Fable 5 등 차세대 모델이 등장하고 구형 모델들이 순차적으로 폐지됩니다. 개발자는 에러 방지를 위해 사용 중인 모델 ID를 확인하고 권장 모델로 즉시 교체해야 합니다.

핵심 포인트

  • Claude Fable 5 및 Mythos 5 출시와 1M 컨텍스트 윈도우 지원
  • 구형 모델(Sonnet 4, Opus 4 등)의 단계적 폐지에 따른 모델 ID 교체 필수
  • Fable 5 사용 시 토큰 소비량이 약 30% 증가하므로 비용 재산정 필요
  • 신규 모델에서 특정 파라미터(thinking, assistant prefill 등) 사용 시 400 에러 주의

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

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

제공 종료 모델종료일이행 권장 모델
claude-sonnet-4-202505142026-06-15claude-sonnet-4-6
claude-opus-4-202505142026-06-15claude-opus-4-8
claude-3-haiku-202403072026-04-20claude-haiku-4-5
claude-3-opus-202402292026-01-05claude-opus-4-5
claude-3-7-sonnet-202502192026-02-19claude-sonnet-4-6
claude-3-5-haiku-202410222026-02-19claude-haiku-4-5
claude-3-5-sonnet-* (2개 모델)2025-10-28claude-sonnet-4-5

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

비권장 대상삭제 · retire 예정일이행처
claude-opus-4-1-202508052026-08-05claude-opus-4-8
claude-opus-4-7의 speed:"fast"2026-07-24claude-opus-4-8의 fast mode

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

기능Fable 5 / Mythos 5
컨텍스트 윈도우 (Context Window)1M 토큰 (기본값)
...이용 불가 (30일 데이터 보유 필수)
거부 시 과금출력 생성 전 거부는 과금 없음

⚠️ 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에서 이용 가능).

기능Opus 4.8
컨텍스트 윈도우 (Context Window)1M (Claude API / Bedrock / Vertex), 200k (Microsoft Foundry)
...

대화 중간 시스템 메시지 (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)을 병용할 경우, 코드 실행은 무료입니다. 비용 절감을 위해 이 조합을 활용하십시오.

우선순위조치 사항기한
🔴 즉시claude-sonnet-4-20250514 → claude-sonnet-4-6만료됨
🔴 즉시claude-opus-4-20250514 → claude-opus-4-8만료됨
🔴 즉시claude-3-haiku-20240307 → claude-haiku-4-5만료됨
🟠 긴급claude-opus-4-7 fast mode 폐지2026-07-24
🟡 계획claude-opus-4-1-20250805 → claude-opus-4-82026-08-05
🟢 검토Fable 5 / Opus 4.8로의 이전 (신기능 활용)—

모델 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 페이지를 정기적으로 확인하는 것을 권장합니다.

AI 자동 생성 콘텐츠

본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0