Claude Sonnet 4.5가 11월 30일에 종료되기 전에 옮길 모델을 정해보세요

Sonnet 4.5의 종료 일정은 어떻게 되나요?

모델 종료 문서의 내역에 따르면 일정은 아래와 같아요.

문서가 쓰는 용어를 알아 두면 읽기 쉬워요. Deprecated는 아직 동작하지만 더 이상 권장하지 않는 상태이고, Retired는 쓸 수 없어서 요청이 실패하는 상태예요. 지금 Sonnet 4.5는 앞의 상태예요. 문서는 예고된 모델이 최신 모델보다 안정성이 떨어질 가능성이 높다고도 경고해요.

통지 기간은 공개 출시된 모델의 종료를 최소 60일 전에 알린다고 적혀 있어요. 이번 예고(9월 30일)에서 종료일(11월 30일)까지는 그 기준에 맞아요.

다른 Claude 모델은 언제까지 쓸 수 있나요?

같은 문서의 상태표에서 지금 쓰이는 모델의 가장 이른 종료 시점을 뽑았어요. 이 열의 제목은 "잠정 종료일"이고, 값은 "이날보다 빠르지 않다"는 하한이에요. 아직 종료가 예고된 건 아니에요.

Haiku 4.5와 Opus 4.5는 하한 날짜가 가까워요. 이 날짜가 곧 종료일이라는 뜻은 아니에요. 다만 예고가 올라오면 위의 60일 기준으로 계획을 세우게 되니, 코드에서 이 모델명을 쓰는 곳을 미리 목록으로 만들어 두면 편해요.

이미 종료된 모델에는 무엇이 있나요?

문서 기준으로 claude-opus-4-1-20250805는 2026년 8월 5일에, claude-sonnet-4-20250514와 claude-opus-4-20250514는 2026년 6월 15일에 종료됐어요. claude-3-haiku-20240307은 2026년 4월 20일에 종료됐어요. 이런 이름이 설정 파일이나 환경 변수에 남아 있다면 이미 실패하고 있을 수 있어요.

5.5로 옮기면 코드의 어떤 부분이 걸리나요?

Claude Platform 릴리스 노트의 9월 28일 항목은 Sonnet 5에서 쓰던 코드가 깨질 수 있는 지점을 이렇게 적어요.

• 시작 단계의 thinking을 끄던 코드: thinking: {"type": "disabled"} 대신 {"type": "between_tools"}를 써야 해요(effort가 high 이하일 때).
• 도구 사용을 강제하는 코드: tool_choice가 any 또는 tool이면 400 오류가 나요.
• 예전 computer_20251124 도구: Claude API와 Google Cloud에서 받아 주지 않아요.

종료 문서의 매개변수 표에는 하나가 더 있어요. temperature, top_p, top_k를 기본값이 아닌 값으로 설정하면 Claude 4.7 이후 모델에서 400 오류가 난다고 적혀 있어요. 4.5 시절 코드가 이 값을 고정해 넘기고 있었다면, 옮길 때 가장 먼저 걸릴 수 있는 부분이에요. 5.5가 4.7 이후 모델에 속한다는 건 문서에 나열된 순서를 보고 판단한 거예요. 모델별 세부 동작은 마이그레이션 가이드로 확인하세요.

종료 전에 어떤 순서로 점검하나요?

1. Console의 Usage 페이지에서 Export로 CSV를 받아 API 키별·모델별 사용량을 봐요. 4.5를 아직 쓰는 키가 이 목록으로 드러나요.
2. 코드와 설정 파일에서 claude-sonnet-4-5-20250929 문자열을 검색해요.
3. 위의 thinking, tool_choice, 샘플링 매개변수를 정리해요.
4. 대표 작업 몇 가지를 4.5와 5.5에 같은 입력으로 보내 결과 형식과 토큰 사용량을 비교해요.
5. 문제가 없으면 모델명을 바꾸고, 종료일 전에 남은 호출이 없는지 사용량을 다시 내려받아 확인해요.

종료일은 새 공지로 바뀔 수 있어요. 작업 직전에 Claude Platform Docs의 Model deprecations 페이지와 릴리스 노트를 다시 열어 보세요. 문서는 종료 대상 고객에게 이메일과 문서로 알린다고 밝히고 있어요.