Claude Sonnet 4.5를 API에서 사용 중이라면 이제 교체 일정을 잡아야 합니다. Anthropic은 2026년 9월 30일 claude-sonnet-4-5-20250929의 지원 종료를 공지했고, Claude API에서의 종료 예정일을 2026년 11월 30일로 제시했습니다. 권장 대체 모델은 claude-sonnet-5-5입니다. 이는 오늘 당장 모든 호출이 중단됐다는 뜻이 아닙니다. 운영팀이 남은 기간에 호출 경로를 찾고, 응답 형식과 비용을 다시 검증하라는 신호에 가깝습니다. Anthropic 공식 릴리스 노트와 모델 지원 종료 안내를 기준으로 핵심을 정리했습니다.
이미지 안내: 이 글의 대표 사진과 본문 사진은 GPT로 만든 실사형 연출 이미지입니다. 실제 직원이나 직접 API 성능 측정 현장을 촬영한 사진이 아닙니다.
1. 무엇이 언제 바뀌나: 날짜와 적용 범위부터 구분
이번 공지의 주체는 Anthropic이며, 대상은 특정 날짜가 붙은 Sonnet 4.5 API 모델 ID입니다. 공지일은 9월 30일, Claude API 종료 예정일은 11월 30일입니다. 약 두 달의 이전 기간이 있지만, 마감일에 맞춰 일괄 교체하기보다 트래픽을 나눠 이동해야 장애를 줄일 수 있습니다. 테스트와 실제 운영에는 여유를 두되, 날짜가 변경될 수 있으므로 배포 직전에는 공식 페이지를 다시 확인하세요.
| 확인 항목 | 공식 안내 | 실무 해석 |
|---|---|---|
| 기존 모델 ID | claude-sonnet-4-5-20250929 |
코드·설정·프록시·기록에서 정확히 검색 |
| 공지일 | 2026년 9월 30일 | 새 종료 일정이 발표된 날 |
| Claude API 종료 예정 | 2026년 11월 30일 | 그 전에 호환성 검사와 전환 완료 |
| 권장 대체 모델 | claude-sonnet-5-5 |
이름 교체만으로는 충분하지 않음 |
Anthropic 문서에는 Claude API 외에도 Bedrock, Google Cloud, Microsoft Foundry, Claude Platform on AWS 같은 제공 경로가 나옵니다. 그러나 이번 릴리스 노트에서 11월 30일이라고 명시한 범위는 Claude API입니다. 다른 클라우드의 실제 비활성화 시각과 모델 ID는 해당 서비스의 공지를 별도로 확인하세요. 단일 날짜를 모든 플랫폼에 그대로 적용하면 잘못된 긴급 조치를 하게 될 수 있습니다.
2. Sonnet 5.5로 옮기면 어떤 코드가 깨질 수 있나
Anthropic의 Sonnet 5.5 공식 마이그레이션 가이드는 Sonnet 4.5에서 이동할 때 누적해서 적용해야 할 변경을 나열합니다. 기존 요청에 thinking 필드를 넣지 않았다면 4.5에서는 사고 과정이 꺼졌지만 5.5에서는 적응형 사고가 기본으로 켜집니다. 같은 프롬프트라도 지연 시간과 토큰 사용량이 달라질 수 있으므로 기본값을 무심코 유지하지 마세요. 전면적인 사고 과정이 필요 없는 업무는 가이드의 between_tools 설정을 검토할 수 있지만, 높은 effort 설정과의 조합에는 제한이 있습니다.
4.5의 수동 사고 예산 thinking: {"type":"enabled","budget_tokens":...}은 5.5에서 오류가 납니다. 새 모델에서는 adaptive와 output_config.effort로 전환해야 하며, 예전 budget 값을 effort 단계에 일대일로 대응시키는 공식 공식은 없습니다. 비기본 temperature, top_p, top_k도 제거해야 합니다. 강제 도구 선택인 tool_choice의 any·tool은 400 오류를 일으키므로 auto와 엄격한 도구 입력 검증 방식을 검토하세요.
대화 끝에 assistant 메시지를 미리 채우는 방식도 새 모델에서 허용되지 않습니다. 구조화된 출력이나 시스템 지침으로 의도를 옮겨야 합니다. 도구 입력은 문자열 연결이 아니라 표준 JSON 파서로 처리하고, 응답의 텍스트·사고·도구 블록은 type별로 읽어야 합니다. 스트리밍 화면에서 도구 사이의 텍스트를 그대로 보여 주던 앱은 응답 블록 처리 방식까지 확인해야 합니다.
| 4.5에서 흔한 설정 | 5.5 전환 시 조치 | 검증 방법 |
|---|---|---|
| 사고 필드 생략 | 기본 adaptive 동작을 전제로 effort 재설정 | 지연·출력 토큰·정확도 비교 |
budget_tokens |
adaptive와 effort로 교체 | 저·중·고 effort 반복 실행 |
강제 tool_choice |
auto와 strict 도구 검토 |
400 오류와 도구 호출 성공률 |
| assistant prefill | 구조화된 출력·명시적 지침으로 이전 | 응답 형식 회귀 테스트 |
| 비기본 샘플링 값 | 해당 파라미터 제거 | 실패 요청 로그 확인 |
3. 가격 비교: 명목 단가는 낮지만 실제 청구액은 다시 계산
공식 가격표의 Claude API 기본 텍스트 단가를 보면 Sonnet 4.5는 입력 100만 토큰당 3달러, 출력 15달러이고 Sonnet 5.5는 입력 2달러, 출력 10달러입니다. 단순 단가로는 각각 약 33% 낮습니다. 하지만 같은 한국어 문장이라도 새 토크나이저에서는 토큰 수가 달라질 수 있습니다. Anthropic 가이드는 Sonnet 4.5 등 이전 모델 대비 같은 텍스트에 약 30% 더 많은 토큰이 생성될 수 있다고 안내하며, 실제 증가는 내용에 따라 달라진다고 단서를 붙입니다.

| Claude API 기본 요금 | Sonnet 4.5 | Sonnet 5.5 | 주의 |
|---|---|---|---|
| 입력 / 100만 토큰 | $3 | $2 | 토큰 수가 같을 때의 단가 비교 |
| 출력 / 100만 토큰 | $15 | $10 | 사고·응답 길이를 포함해 재측정 |
| 5분 캐시 쓰기 / 100만 | $3.75 | $2.50 | 캐시 정책별 사용량 변동 |
| 캐시 읽기 / 100만 | $0.30 | $0.20 | 히트율을 별도로 확인 |
예를 들어 동일한 작업에서 예전 모델이 입력 10만·출력 1만 토큰을 썼다면 명목 단가 합계는 0.45달러입니다. 새 모델이 정확히 같은 토큰 수를 쓴다면 0.30달러지만, 토큰 수와 도구 호출 횟수·캐시 히트율이 바뀌면 청구액도 달라집니다. 이 예시는 계산법을 보여 주는 가정일 뿐 직접 실행 결과가 아닙니다. Bedrock과 Google Cloud의 지역·라우팅 요금은 별도이므로 자신의 실제 청구 경로로 계산해야 합니다.
4. 실제 성능: 공식 수치와 이 글이 확인하지 못한 것
이 글을 작성하면서 유료 Claude API로 직접 A/B 테스트를 실행하지 않았습니다. 따라서 ‘우리가 측정한 지연 시간’이나 한국어 실무 품질 점수는 제시하지 않습니다. 대신 Anthropic이 공개한 Sonnet 5.5 발표 자료의 일부 수치를 제공사 측정값으로 표시합니다. 아래 수치는 Sonnet 5.5와 Sonnet 5의 공식 평가 비교이지, 종료 대상인 Sonnet 4.5와의 동일 조건 직접 비교가 아닙니다.
| 공식 평가 | Sonnet 5.5 | 비교 모델 | 조건·측정 주체 |
|---|---|---|---|
| Terminal-Bench 4.0, 에이전트 코딩 | 70.6% | Sonnet 5 10.3% | Anthropic 공개 자료; 명령줄 다단계 작업, 세부 실행 조건은 시스템 카드 참조 |
| CursorBench 4.0, 다중 파일 코딩 | 55.5% | Sonnet 5 34.1% | Anthropic 공개 자료; 실제 Cursor 작업을 바탕으로 한 평가 |
| OSWorld 2.1, 컴퓨터 사용 | 80.1% | Sonnet 5 57.0% | Anthropic 공개 자료; 양쪽 모두 partial 조건 |
| 동일 텍스트 토큰화 | 이전 모델 대비 약 30% 증가 가능 | Sonnet 4.5 등 | Anthropic 마이그레이션 문서의 안내; 실제 문장·설정별 차이 |
평가 표본·도구·effort·채점 방식은 공식 시스템 카드에서 원문을 확인해야 합니다. 벤치마크 하나로 모든 회사의 고객 상담, RAG, 한국어 문서 작성 결과를 예측할 수 없습니다. 특히 Sonnet 4.5에서 옮기는 팀에게 필요한 핵심 수치는 자사 작업의 성공률과 작업당 비용입니다. 신규 모델의 공식 점수가 높아도 특정 JSON 스키마나 내부 지식 검색 체인에서는 퇴행이 생길 수 있습니다. 신뢰할 만한 독립적 동일 조건 4.5→5.5 비교는 이 글에서 확인하지 못했습니다.
5. 하루 만에 끝내지 않는 안전한 전환 순서
- 사용처 목록화: 저장소 코드뿐 아니라 환경 변수, 프롬프트 관리 도구, 워크플로 설정, 배치 작업, 서버리스 함수, 제휴 서비스 호출의 모델 ID를 검색합니다. 각 경로에 담당자와 일일 호출량을 붙입니다.
- 요청 형식 정리: 공식 마이그레이션 체크리스트를 기준으로 사고 예산, 샘플링, 강제 도구 호출, prefill, 출력 형식, 컴퓨터 사용 도구 버전을 검사합니다. 단순 문자열 교체 PR과 API 형식 수정 PR을 분리하면 검토가 쉽습니다.
- 대표 평가셋 구축: 실제 고객 데이터는 비식별화하고, 문의 응대·코드 수정·문서 추출·도구 호출 등 주요 흐름별로 20~50개 사례를 준비합니다. 실패하기 쉬운 길고 복잡한 입력도 섞습니다.
- 동일 조건 반복: 같은 입력·도구 스키마·상태·타임아웃을 두 모델에 적용하고 각 사례를 여러 번 실행합니다. 새 모델은 effort 수준이 변수이므로 한 단계만 재지 말고 최소 두세 단계를 비교합니다. 성공률뿐 아니라 p50/p95 지연, 입력·출력·캐시 토큰, 오류 종류, 작업당 청구액을 기록합니다.
- 점진 배포: 내부 테스트 뒤 소량의 운영 트래픽으로 이동하고 품질·비용·에러율을 관찰합니다. 종료일 전에 롤백 기준과 담당자를 정해 두고, 전환 완료 뒤에도 폐기 ID를 검색해 잔여 호출을 없앱니다.

테스트 표는 사례 ID, 모델 ID, effort, 입력 해시, 성공 기준, 성공/실패, 지연, 입력 토큰, 출력 토큰, 캐시 읽기·쓰기, 도구 호출 횟수, 총비용으로 만들면 재현성이 좋아집니다. 결과가 다르면 프롬프트를 먼저 맞추고 도구 정의가 동일한지 확인한 뒤 다시 실행하세요. API 키와 운영 권한이 없는 상태에서 결과를 상상해 기입하면 마이그레이션 판단이 왜곡됩니다.
6. 자주 생기는 실패 사례와 배포 전 체크리스트
첫 번째 실패 사례는 모델 ID만 바꾸고 예전 budget_tokens를 남겨 400 오류가 발생하는 것입니다. 두 번째는 도구 호출을 반드시 요구하는 기존 설정을 유지해 새로운 모델의 강제 도구 제한과 충돌하는 경우입니다. 세 번째는 기본 사고 동작과 토크나이저 차이를 고려하지 않아 max_tokens와 월 예산이 예상보다 빨리 소진되는 경우입니다. 네 번째는 이전 모델의 prefill에 의존하던 JSON 응답이 통째로 실패하는 경우입니다. 어느 경우도 모델이 단순히 ‘성능이 나쁘다’는 결론으로 처리하면 원인을 놓칩니다.
- 운영 중인 모든
claude-sonnet-4-5-20250929사용처와 담당자를 확인했는가? - Anthropic Claude API와 다른 클라우드 제공 경로의 종료 일정을 구별했는가?
- 공식 가이드의 4.5→5.5 변경 사항을 코드와 프롬프트 양쪽에서 점검했는가?
- 한국어 대표 작업을 같은 입력·도구·타임아웃으로 반복 측정했는가?
- 지연·정확도·도구 성공률·작업당 비용의 허용 기준과 롤백 조건을 정했는가?
- 11월 30일 이전에 트래픽 이전과 잔여 호출 제거를 마칠 수 있는가?
7. FAQ: 가장 많이 헷갈리는 세 가지
Q. 10월 1일부터 Sonnet 4.5 API가 바로 끊기나요?
A. 아닙니다. Anthropic 릴리스 노트는 9월 30일을 지원 종료 공지일로, 11월 30일을 Claude API 종료 예정일로 적었습니다. 예정일과 실제 운영 상태는 배포 직전 다시 확인해야 합니다.
Q. Sonnet 5.5가 더 싸니 월 청구액도 무조건 줄까요?
A. 기본 토큰 단가는 낮지만 실제 토큰 수, 기본 사고 동작, 캐시 사용량, 이미지 입력 비용이 달라질 수 있습니다. 같은 평가셋으로 작업당 비용을 다시 계산해야 합니다.
Q. Bedrock이나 Google Cloud도 같은 날 종료되나요?
A. 이번 공식 릴리스 노트의 11월 30일 문구는 Claude API를 가리킵니다. 파트너 플랫폼은 각자의 모델 가용성·일정을 확인하는 것이 안전합니다. 모델 ID 형식도 제공 경로별로 다를 수 있습니다.
Q. 기존 대화 기록을 새 모델에 그대로 넘겨도 되나요?
A. 사고 블록은 모델과 대화 기록에 묶이므로, 중간 내용을 수정하거나 다른 모델의 블록을 재사용할 때 처리 방식이 달라질 수 있습니다. 공식 가이드에 따라 append-only 대화와 블록 type 처리를 검증하세요.
공식 확인 자료와 업데이트 방법
- Claude Platform 릴리스 노트 — 2026년 9월 30일 지원 종료 공지
- Anthropic 모델 지원 종료 목록
- Sonnet 5.5 마이그레이션 체크리스트
- Sonnet 5.5 모델 사양과 가용성
- Claude API 공식 가격표
- Anthropic의 평가 결과와 방법론 안내
기준 시점은 2026년 10월 1일 한국 시간입니다. 가격·종료일·제공 지역은 바뀔 수 있습니다. 이 글은 제공사 공식 자료를 해석한 것이며, 직접 API 호출로 성능을 측정했다는 주장이 아닙니다.



























