모델 폐지
모델 폐지 (Model deprecations)
더 안전하고 강력한 모델이 출시되면서 Anthropic은 기존 모델을 주기적으로 은퇴(retire)시켜요. 그래서 Anthropic 모델에 의존하는 애플리케이션은 계속 동작하도록 가끔 업데이트가 필요할 수 있어요. 영향을 받는 고객에게는 항상 이메일과 문서를 통해 알림이 가요. 이 페이지에는 모든 API 폐지(deprecation) 내역과 권장 교체 모델이 정리되어 있어요.
출처: 문서
본문
개요 (Overview)
Anthropic은 모델 수명 주기를 설명할 때 다음 용어를 사용해요:
- Active(활성): 모델이 완전히 지원되며 사용을 권장하는 상태예요.
- Legacy(레거시): 모델이 더 이상 업데이트를 받지 않으며, 향후 폐지될 수 있는 상태예요.
- Deprecated(폐지): 모델이 여전히 동작하지만 더 이상 권장되지 않아요. Anthropic이 권장 교체 모델을 제공하고 은퇴 날짜를 지정해요.
- Retired(은퇴): 모델을 더 이상 사용할 수 없어요. 은퇴한 모델에 대한 요청은 실패해요.
이 페이지의 날짜는 Anthropic이 운영하는 플랫폼, 즉 클로드 API, AWS의 Claude Platform, Microsoft Foundry에 적용돼요. 파트너가 운영하는 플랫폼(Amazon Bedrock과 Google Cloud)은 자체 은퇴 일정을 정하므로, 모델의 수명 주기 상태와 날짜가 다를 수 있어요. Amazon Bedrock, Amazon Bedrock (Opus 4.6 이하), Google Cloud의 모델 표를 참고하세요.
교체 모델로 마이그레이션
모델이 폐지되면 은퇴 날짜 이전에 모든 사용을 적절한 교체 모델로 옮겨야 해요. 은퇴 날짜가 지난 모델에 대한 요청은 실패해요.
교체 모델이 작업에서 어떤 성능을 내는지 파악하기 위해, 은퇴 날짜 한참 전에 새 모델로 애플리케이션을 충분히 테스트해 보는 것을 권장해요.
최신 클로드 모델로 마이그레이션하는 구체적인 방법은 마이그레이션 가이드를 참고하세요.
알림 (Notifications)
Anthropic은 곧 은퇴할 모델을 활발하게 배포 중인 고객에게 알림을 보내요. 공개 출시된 모델의 경우 모델 은퇴 최소 60일 전에 통지를 제공해요.
모델 사용량 감사 (Auditing model usage)
폐지된 모델의 사용을 파악하기 위해 고객은 API 사용량 감사(audit)를 받을 수 있어요. 다음 단계를 따라 하세요:
- Claude Console의 Usage 페이지로 이동해요.
- Export를 클릭해요.
- 다운로드한 CSV를 검토해 API 키와 모델별로 사용량을 확인해요.
이 감사를 통해 애플리케이션이 아직 폐지된 모델을 사용하고 있는 부분을 찾을 수 있고, 은퇴 날짜 전에 새 모델로의 업데이트 우선순위를 정하는 데 도움이 돼요.
모범 사례 (Best practices)
- 문서에서 모델 폐지에 대한 업데이트를 정기적으로 확인하세요.
- 현재 모델의 은퇴 날짜 한참 전에 새 모델로 애플리케이션을 테스트하세요.
- 가능한 한 빨리 코드를 권장 교체 모델을 사용하도록 업데이트하세요.
- 마이그레이션에 도움이 필요하거나 질문이 있으면 지원 팀에 문의하세요.
폐지의 단점과 완화 방안
Anthropic은 현재 새 모델 출시를 위한 용량을 확보하기 위해 모델을 폐지하고 은퇴시켜요. 여기에는 단점이 따르는데, 다음과 같아요:
- 특정 모델을 중시하는 사용자는 새 버전으로 마이그레이션해야 해요
- 연구자는 진행 중이거나 비교적인 연구를 위해 모델에 접근할 수 없게 돼요
- 모델 은퇴는 안전 및 모델 복지(model welfare) 관련 위험을 유발해요
언젠가 Anthropic은 과거 모델을 다시 공개적으로 이용 가능하게 만들기를 희망해요. 그때까지 Anthropic은 모델 가중치의 장기 보존 및 기타 조치를 통해 이런 영향을 완화하겠다고 약속했어요. 자세한 내용은 모델 폐지 및 보존에 관한 약속(Commitments on Model Deprecation and Preservation)을 참고하세요.
모델 상태 (Model status)
현재 및 최근에 은퇴한 모델은 다음 표에 상태와 함께 정리되어 있어요:
| API 모델 이름 | 현재 상태 | 폐지일 | 예정 은퇴 날짜 |
|---|---|---|---|
| claude-fable-5-1 | Active | N/A | 2027년 9월 1일 이전에는 은퇴하지 않음 |
| claude-mythos-5-1 | Active | N/A | 2027년 9월 1일 이전에는 은퇴하지 않음 |
| claude-fable-5 | Active | N/A | 2027년 6월 9일 이전에는 은퇴하지 않음 |
| claude-mythos-5 | Active | N/A | 2027년 6월 9일 이전에는 은퇴하지 않음 |
| claude-mythos-preview | Deprecated | 2026년 6월 9일 | 추후 공지 |
| claude-opus-5-5 | Active | N/A | 2027년 9월 22일 이전에는 은퇴하지 않음 |
| claude-opus-5 | Active | N/A | 2027년 7월 24일 이전에는 은퇴하지 않음 |
| claude-opus-4-8 | Active | N/A | 2027년 5월 28일 이전에는 은퇴하지 않음 |
| claude-opus-4-7 | Active | N/A | 2027년 4월 16일 이전에는 은퇴하지 않음 |
| claude-opus-4-6 | Active | N/A | 2027년 2월 5일 이전에는 은퇴하지 않음 |
| claude-opus-4-5-20251101 | Active | N/A | 2026년 11월 24일 이전에는 은퇴하지 않음 |
| claude-opus-4-1-20250805 | Retired | 2026년 6월 5일 | 2026년 8월 5일 |
| claude-opus-4-20250514 | Retired | 2026년 4월 14일 | 2026년 6월 15일 |
| claude-sonnet-5 | Active | N/A | 2027년 6월 30일 이전에는 은퇴하지 않음 |
| claude-sonnet-4-6 | Active | N/A | 2027년 2월 17일 이전에는 은퇴하지 않음 |
| claude-sonnet-4-5-20250929 | Active | N/A | 2026년 9월 29일 이전에는 은퇴하지 않음 |
| claude-sonnet-4-20250514 | Retired | 2026년 4월 14일 | 2026년 6월 15일 |
| claude-3-7-sonnet-20250219 | Retired | 2025년 10월 28일 | 2026년 2월 19일 |
| claude-haiku-4-5-20251001 | Active | N/A | 2026년 10월 15일 이전에는 은퇴하지 않음 |
| claude-3-5-haiku-20241022 | Retired | 2025년 12월 19일 | 2026년 2월 19일 |
| claude-3-haiku-20240307 | Retired | 2026년 2월 19일 | 2026년 4월 20일 |
폐지 이력 (Deprecation history)
모든 폐지 내역은 가장 최근 공지부터 다음 섹션에 정리되어 있어요.
2026-06-05: Claude Opus 4.1 모델
2026년 6월 5일, Anthropic은 Claude API에서 Claude Opus 4.1을 사용하는 개발자에게 곧 은퇴한다는 소식을 전했어요.
| 은퇴 날짜 | 폐지 모델 | 권장 교체 모델 |
|---|---|---|
| 2026년 8월 5일 | claude-opus-4-1-20250805 |
claude-opus-4-8 |
2026-04-14: Claude Sonnet 4 및 Claude Opus 4 모델
2026년 4월 14일, Anthropic은 Claude API에서 Claude Sonnet 4 및 Claude Opus 4 모델을 사용하는 개발자에게 곧 은퇴한다는 소식을 전했어요.
| 은퇴 날짜 | 폐지 모델 | 권장 교체 모델 |
|---|---|---|
| 2026년 6월 15일 | claude-sonnet-4-20250514 |
claude-sonnet-4-6 |
| 2026년 6월 15일 | claude-opus-4-20250514 |
claude-opus-4-8 |
2026-02-19: Claude Haiku 3 모델
2026년 2월 19일, Anthropic은 Claude API에서 Claude Haiku 3 모델을 사용하는 개발자에게 곧 은퇴한다는 소식을 전했어요.
| 은퇴 날짜 | 폐지 모델 | 권장 교체 모델 |
|---|---|---|
| 2026년 4월 20일 | claude-3-haiku-20240307 |
claude-haiku-4-5-20251001 |
2025-12-19: Claude Haiku 3.5 모델
2025년 12월 19일, Anthropic은 Claude API에서 Claude Haiku 3.5 모델을 사용하는 개발자에게 곧 은퇴한다는 소식을 전했어요.
| 은퇴 날짜 | 폐지 모델 | 권장 교체 모델 |
|---|---|---|
| 2026년 2월 19일 | claude-3-5-haiku-20241022 |
claude-haiku-4-5-20251001 |
2025-10-28: Claude Sonnet 3.7 모델
2025년 10월 28일, Anthropic은 Claude API에서 Claude Sonnet 3.7 모델을 사용하는 개발자에게 곧 은퇴한다는 소식을 전했어요.
| 은퇴 날짜 | 폐지 모델 | 권장 교체 모델 |
|---|---|---|
| 2026년 2월 19일 | claude-3-7-sonnet-20250219 |
claude-sonnet-4-6 |
2025-08-13: Claude Sonnet 3.5 모델
2025년 8월 13일, Anthropic은 Claude Sonnet 3.5 모델을 사용하는 개발자에게 곧 은퇴한다는 소식을 전했어요.
| 은퇴 날짜 | 폐지 모델 | 권장 교체 모델 |
|---|---|---|
| 2025년 10월 28일 | claude-3-5-sonnet-20240620 |
claude-sonnet-4-6 |
| 2025년 10월 28일 | claude-3-5-sonnet-20241022 |
claude-sonnet-4-6 |
2025-06-30: Claude Opus 3 모델
2025년 6월 30일, Anthropic은 Claude Opus 3 모델을 사용하는 개발자에게 곧 은퇴한다는 소식을 전했어요.
| 은퇴 날짜 | 폐지 모델 | 권장 교체 모델 |
|---|---|---|
| 2026년 1월 5일 | claude-3-opus-20240229 |
claude-opus-4-8 |
2025-01-21: Claude 2, Claude 2.1, Claude Sonnet 3 모델
2025년 1월 21일, Anthropic은 Claude 2, Claude 2.1, Claude Sonnet 3 모델을 사용하는 개발자에게 곧 은퇴한다는 소식을 전했어요.
| 은퇴 날짜 | 폐지 모델 | 권장 교체 모델 |
|---|---|---|
| 2025년 7월 21일 | claude-2.0 |
claude-opus-4-8 |
| 2025년 7월 21일 | claude-2.1 |
claude-opus-4-8 |
| 2025년 7월 21일 | claude-3-sonnet-20240229 |
claude-sonnet-4-6 |
2024-09-04: Claude 1 및 Instant 모델
2024년 9월 4일, Anthropic은 Claude 1 및 Instant 모델을 사용하는 개발자에게 곧 은퇴한다는 소식을 전했어요.
| 은퇴 날짜 | 폐지 모델 | 권장 교체 모델 |
|---|---|---|
| 2024년 11월 6일 | claude-1.0 |
claude-haiku-4-5-20251001 |
| 2024년 11월 6일 | claude-1.1 |
claude-haiku-4-5-20251001 |
| 2024년 11월 6일 | claude-1.2 |
claude-haiku-4-5-20251001 |
| 2024년 11월 6일 | claude-1.3 |
claude-haiku-4-5-20251001 |
| 2024년 11월 6일 | claude-instant-1.0 |
claude-haiku-4-5-20251001 |
| 2024년 11월 6일 | claude-instant-1.1 |
claude-haiku-4-5-20251001 |
| 2024년 11월 6일 | claude-instant-1.2 |
claude-haiku-4-5-20251001 |
API 파라미터 폐지
Anthropic은 때때로 현재 모델에 더 이상 적용되지 않는 요청 파라미터를 폐지해요. API가 폐지된 파라미터를 처리하는 방식은 다음 표와 같이 모델에 따라 달라져요. 대부분의 SDK는 기존 코드가 계속 타입 체크를 통과하도록 요청 타입에 폐지된 파라미터를 유지해요. Python SDK(1.0 이상)는 temperature, top_p, top_k를 제거하므로, 이를 전달하면 TypeError가 발생해요.
| Parameter | 상태 | 동작 | 권장 교체 |
|---|---|---|---|
temperature, top_p, top_k |
Deprecated (Claude Opus 4.7 이상) | Claude 4.7 이상 모델 및 Claude Mythos Preview에서 기본값이 아닌 값으로 설정하면 400 오류를 반환해요. | 생략하고 프롬프트 작성으로 모델 동작을 유도하세요. |
마이그레이션 단계는 마이그레이션 가이드를 참고하세요.