[Claude] Opus 4.1 지원 종료, 박아둔 모델 ID는 에러예요

[Claude] Opus 4.1 지원 종료, 박아둔 모델 ID는 에러예요

Anthropic이 2026년 8월 5일자로 Claude Opus 4.1(claude-opus-4-1-20250805)을 은퇴시켰어요. 이제 이 모델 ID로 보낸 API 요청은 전부 에러를 돌려줘요. 6월 5일에 공지된 지원 종료 일정 그대로예요.

01. 코드에 박힌 모델 ID부터 찾아보는 게 먼저예요

은퇴한 모델은 다른 모델로 자동 대체되지 않고 요청 자체가 실패해요. 배치 작업이나 야간 잡처럼 사람이 안 보는 자리에 박혀 있으면 조용히 깨진 채로 남아 있을 수 있어요.

grep -rn "claude-opus-4-1-20250805" .

어떤 API 키가 이 모델을 쓰고 있었는지는 Console에서도 확인돼요. 공식 안내로는 Usage 페이지에서 Export를 눌러 받은 CSV에 키별·모델별 사용량이 나뉘어 나와요.

02. 공식 대체 모델은 Opus 4.8로 적혀 있어요

Anthropic 문서의 은퇴 표에는 권장 대체 모델이 claude-opus-4-8로 명시돼 있어요. 8월 5일 릴리스 노트 쪽은 claude-opus-5로 올리는 걸 권하고요.

공식 가격표 기준으로 두 모델 다 100만 토큰당 입력 $5, 출력 $25로 같아요. context window도 1M 토큰으로 같고요. Opus 5는 7월 24일에 나온 모델이고, 문서에는 복잡한 에이전트 코딩과 기업 업무용으로 소개돼 있어요. 어느 쪽이 맞는지는 쓰던 작업으로 직접 비교해볼 부분이에요.

03. 갈아탈 때 temperature 파라미터가 걸릴 수 있어요

Opus 4.7 세대부터 temperature·top_p·top_k가 폐기됐어요. 공식 문서에는 이 파라미터에 기본값이 아닌 값을 넣으면 400 에러가 난다고 적혀 있어요.

Opus 4.1 시절에 짠 코드에는 이 값들이 그대로 남아 있을 수 있어요. 모델 ID만 바꿔 배포하면 400으로 막히니까, 세 파라미터는 빼고 프롬프트로 동작을 잡으라는 게 공식 안내예요.

04. Bedrock과 Google Cloud는 일정이 따로예요

이번 날짜가 적용되는 범위는 Claude API, Claude Platform on AWS, Microsoft Foundry예요. Amazon Bedrock과 Google Cloud는 파트너가 각자 은퇴 일정을 잡기 때문에 모델 상태와 날짜가 다를 수 있어요.

이 두 곳으로 붙여 쓰고 있다면 각 플랫폼의 모델 표를 따로 확인하는 편이 안전해요.

05. 다음 차례는 9월 말부터 줄 서 있어요

지금 Active인 모델에도 잠정 은퇴 시점이 붙어 있어요. claude-sonnet-4-5-20250929는 9월 29일 이후, claude-haiku-4-5-20251001은 10월 15일 이후, claude-opus-4-5-20251101은 11월 24일 이후로 표기돼 있어요.

다만 이건 "그보다 빠르지는 않다"는 하한선이라 확정 날짜가 아니에요. 공개된 모델은 은퇴 최소 60일 전에 메일과 문서로 알린다고 하니, 그 사이에 정리하면 돼요.

연구 목적으로 은퇴한 모델이 계속 필요한 경우에는 External Researcher Access Program으로 접근을 신청하는 경로가 안내돼 있어요.

출처: Claude Platform 릴리스 노트 (2026년 8월 5일), Model deprecations

이 글은 공식 발표 내용을 정리한 것이고, Anthropic으로부터 어떤 형식의 협찬도 받지 않았습니다.