Claude API 대규모 업데이트 정리: Fable 5 등장 · 구모델 폐지 · 30% 토큰 증가 대응

2026년 4월~6월에 걸쳐, Anthropic은 Claude API에 대규모 변경을 가했습니다. Claude Fable 5 · Mythos 5라는 새로운 플래그십 모델의 등장, Claude Sonnet 4/Opus 4 · Haiku 3 등의 구모델 폐지(요청 시 에러 발생), 새로운 토크나이저(tokenizer)에 의한 토큰 수 약 30% 증가와 같이, **비용 및 호환성에 직결되는 파괴적 변경(breaking change)**이 여러 개 포함되어 있습니다.

본 기사에서는 severity가 critical/high인 변경 사항에 집중하여, 무엇이 변하고, 왜 중요하며, 어떻게 대응해야 하는지를 해설합니다.

📌 영향을 받는 사람

claude-sonnet-4-20250514 또는 claude-opus-4-20250514를 사용 중인 모든 개발자 (즉시 대응 필수)
claude-3-haiku-20240307를 사용 중인 개발자 (즉시 대응 필수)

• Claude Fable 5 / Opus 4.7 이후로 이행 예정인 개발자 (토큰 비용 산정 재검토 필요)
• 에이전트형 워크플로우를 구축하고 있는 개발자

⚠️ Breaking Change

claude-sonnet-4-20250514, claude-opus-4-20250514, claude-3-haiku-20240307로의 모든 요청은 현재 에러를 반환하고 있습니다.

폐지 모델	폐지일	이행 대상 모델
claude-sonnet-4-20250514	2026-06-15 (완료)	Claude Sonnet 4.6
...		Claude Opus 4.8

또한, Claude Sonnet 4.5 / Sonnet 4를 위한 **1M 토큰 컨텍스트 beta (context-1m-2025-08-07)**도 폐지되었습니다. 이 beta 헤더를 사용하고 있는 경우, 200k를 초과하는 요청은 에러가 발생합니다. 1M 컨텍스트가 필요한 경우에는 Claude Sonnet 4.6 또는 Opus 4.6 이후로의 이행이 필요합니다.

모델	모델 ID	컨텍스트	출력 토큰	특기 사항
Claude Fable 5	claude-fable-5	1M	128k	일반 제공, adaptive thinking 상시 유효
...

Claude Fable 5의 주요 특징:

• adaptive thinking이 유일한 사고 모드 (extended thinking 수동 설정 불가)
• 안전 분류기(safety classifier)를 탑재, 거부 시에는 stop_reason: "refusal"을 반환 (출력 전 거부는 과금되지 않음)
• fallbacks 파라미터 (beta)를 통해 다른 모델로 재실행 가능
• 30일 데이터 보존이 필수 → zero data retention 환경에서는 이용 불가

Claude Opus 4.8의 주요 특징:

• mid-conversation system messages 대응 (장시간 세션 중의 지시 변경으로 캐시 히트(cache hit)를 유지)
• stop_details가 공개 문서화됨 (category: cyber/bio/null 및 explanation을 반환)
• effort 기본값 high, 고해상도 이미지 입력 (장변 2576px) 대응

⚠️ Breaking Change

Claude Fable 5, Mythos 5, Opus 4.7 이후는 새로운 토크나이저(tokenizer)를 채택합니다. 동일한 텍스트에 대해 구모델보다 약 30% 더 많은 토큰을 생성합니다.

이 변경은 특히 다음과 같은 사항에 영향을 미칩니다:

• 비용 산정: 동일한 워크로드라도 청구 금액이 증가할 가능성
• 컨텍스트 상한 관리: 1M 토큰 윈도우(window)가 실질적으로 좁아짐
• token counting API: 반드시 이행 대상인 새로운 모델 ID를 지정하여 재계산할 필요가 있음

⚠️ Breaking Change

Fable 5 / Mythos 5에서는 다음과 같은 설정을 하면 400 에러가 반환됩니다.

설정 항목	Opus 4.7 이전	Fable 5 / Mythos 5
thinking.type: "disabled"	가능	❌ 400 에러
extended thinking 수동 예산 지정	가능	❌ 400 에러
assistant prefill	가능	❌ 400 에러
thinking.display	임의	기본값 "omitted" ("summarized" 권장)
adaptive thinking	opt-in	항상 활성화 (유일한 사고 모드)

멀티턴 (Multi-turn) 대화에서는 동일한 모델에 사고 블록 (thinking block)을 그대로 전달해야 합니다 (가공되지 않은 chain of thought는 반환되지 않습니다).

action_required: false로 변경되었지만, 에이전트 개발자라면 파악해 둘 가치가 있습니다.

기능	개요	상태
code_execution_20260120	REPL 상태의 영속화, beta 헤더 불필요	GA
...

claude-sonnet-4-20250514

/ claude-opus-4-20250514

/ claude-3-haiku-20240307

에 대한 참조를 코드에서 삭제 -
context-1m-2025-08-07

beta 헤더를 사용 중인 경우 Sonnet 4.6 / Opus 4.6 이후로 마이그레이션 -
claude-opus-4-1-20250805

를 사용 중인 경우 2026년 8월 5일까지 Opus 4.8로 마이그레이션 - Fable 5 / Opus 4.7 이후로 마이그레이션할 경우 새로운 토크나이저 (tokenizer)로 비용 산출을 재계산

Fable 5에서 thinking.type: "disabled" 또는 수동 예산을 설정하지 않았는지 확인

# Before（현재 에러 발생）
import anthropic
client = anthropic.Anthropic()
...

# After（Sonnet 4.6으로 마이그레이션）
import anthropic
client = anthropic.Anthropic()
...

import anthropic
client = anthropic.Anthropic()
prompt = [{"role": "user", "content": "your prompt here"}]
...

import anthropic
client = anthropic.Anthropic()
response = client.messages.create(
...

import anthropic
client = anthropic.Anthropic()
response = client.messages.create(
...

💡 Tips

code_execution_20260120은 REPL 상태의 영속화를 지원합니다. 여러 도구 호출(tool calls)에 걸쳐 변수나 실행 상태가 유지되므로, 단계적인 계산 처리나 데이터 분석에 특히 유효합니다.

변경 사항	중요도	대응 기한
Sonnet 4 / Opus 4 폐지 (에러 발생 중)	🔴 긴급	지금 즉시
...

이번 변경은 '모델 세대 교체'와 '에이전트 기반 확충'이 동시에 진행된 대규모 업데이트입니다. 구모델에 의존하는 부분은 지금 즉시 수정이 필요하며, 새로운 Fable 5로 마이그레이션할 경우에는 토크나이저 변경에 따른 비용 증가와 adaptive thinking의 동작 변경을 사전에 파악한 후 진행하시기 바랍니다.