커뮤니티커뮤니티Anthropic이 2026년 4월 30일부로 Claude Sonnet 4.5와 Claude Sonnet 4에서 제공하던 100만 토큰 컨텍스트 윈도우 (1M token context window) 베타를 공식 종료한다고 발표했습니다. 해당 베타 기능을 현재 프로덕션 환경에서 활용 중인 개발자라면 즉각적인 대응이 필요합니다.
이번 변경의 핵심은 간단합니다. 기존에 context-1m-2025-08-07 베타 헤더를 API 요청에 포함시켜 1M 토큰 컨텍스트를 활용하던 방식이 더 이상 작동하지 않습니다. 구체적으로는 두 가지 변화가 발생합니다.
context-1m-2025-08-07 헤더를 요청에 포함해도 Claude Sonnet 4.5 및 Claude Sonnet 4에서는 아무런 효과가 없습니다.즉, 별도의 마이그레이션 없이 기존 코드를 그대로 사용할 경우, 긴 컨텍스트가 필요한 요청에서 예기치 않은 오류가 발생할 수 있습니다.
1M 토큰 컨텍스트 기능이 사라지는 것이 아닙니다. 오히려 반대입니다. Anthropic은 이 기능을 베타 단계에서 정식 출시(Generally Available, GA) 단계로 격상시켰습니다. 베타 딱지를 떼고 더 안정적이고 범용적인 형태로 제공하겠다는 의미입니다. 베타 기간 동안 충분한 검증을 마쳤고, 이제는 특정 모델에서 누구나 별도 신청 없이 표준 기능으로 사용할 수 있게 된 것입니다.
1M 토큰 컨텍스트 윈도우를 계속 활용하고 싶다면, 다음 두 모델 중 하나로 마이그레이션하면 됩니다.
두 모델 모두에서 1M 토큰 컨텍스트 윈도우가 정식 기능으로 제공되며, 별도의 베타 헤더 없이도 바로 사용할 수 있습니다. 요금 역시 표준 가격(standard pricing)이 적용되어 베타 시절과 비교해 가격 구조가 복잡하지 않습니다. 코드 변경도 간단합니다. 모델명을 교체하고 베타 헤더를 제거하는 것만으로 마이그레이션이 완료됩니다.
긴 문서 분석, 대규모 코드베이스 리뷰, 장문의 대화 이력 유지 등 롱 컨텍스트(long context)를 적극 활용하는 에이전트 (agent) 파이프라인이나 RAG (Retrieval-Augmented Generation) 시스템을 운영 중인 개발자라면 이번 변경이 직접적인 영향을 미칩니다. 특히 자동화된 배치 처리나 무인 파이프라인에서 Sonnet 4.5 또는 Sonnet 4를 사용하고 있다면, 조용히 에러가 누적될 수 있으므로 지금 당장 사용 중인 모델과 컨텍스트 크기를 점검하는 것이 좋습니다.
마이그레이션 자체는 어렵지 않습니다. 하지만 타이밍을 놓치면 프로덕션 장애로 이어질 수 있다는 점에서, 오늘 바로 코드베이스를 점검하고 모델 버전을 업데이트하는 것을 권장합니다. Sonnet 4.6 또는 Opus 4.6으로 전환하면서 베타 헤더 관련 코드를 정리하면, 오히려 코드가 더 간결해지는 부수 효과도 얻을 수 있습니다.
📎 출처: Claude Platform 릴리즈 노트
아직 댓글이 없습니다