작성자 주: claude-sonnet-4-5는 2026-11-30에 지원이 종료돼요. 이 글에서는 claude-sonnet-5-5로 마이그레이션할 때 모델 ID, 캐시 읽기 배수, 요금이 어떻게 달라지는지 설명하고, 전환 당일 확인할 필드와 검수 방법을 안내해요.
코드나 설정 파일, 게이트웨이 라우팅에 claude-sonnet-4-5 또는 날짜가 포함된 스냅샷 claude-sonnet-4-5-20250929가 남아 있다면, 서둘러 마이그레이션 일정을 잡아야 해요. Anthropic의 모델 지원 종료 페이지에는 이 스냅샷이 Deprecated로 표시돼 있어요. 공지일은 2026-09-30, 지원 종료일은 2026-11-30이며, 공식 대체 모델은 claude-sonnet-5-5예요.
이 글은 또 하나의 “새 모델이 더 뛰어나다”는 홍보 글이 아니에요. Sonnet 4.5에서 Sonnet 5.5로 옮길 때 필요한 엔지니어링 작업만 다뤄요. 모델 ID를 어떻게 바꾸는지, 배수와 요금이 어떻게 달라지는지, 전환 당일 어떤 필드를 수정해야 하는지, 전환 후에는 어떻게 검수하는지 설명해요. 모델의 성능 차이는 이 글의 결론에 포함하지 않으니, 직접 사용하는 작업으로 회귀 테스트를 진행해야 해요.
핵심 가치: 이 글을 읽고 나면 새 모델과 기존 모델을 비교한 표, 실행 가능한 전환 순서를 확인할 수 있어요. 마이그레이션이 제대로 됐는지 확인할 때 사용할 요청과 살펴봐야 할 필드도 알 수 있어요.
Sonnet 4.5 서비스 종료에 따른 Sonnet 5.5 마이그레이션 핵심 사항
먼저 결론부터 말씀드릴게요. 아래 표는 이번 마이그레이션에서 가장 주의해야 할 네 가지 사항이에요. 데이터 기준일은 2026-11-10입니다.
| 핵심 사항 | 설명 | 영향 |
|---|---|---|
| 서비스 종료일 | claude-sonnet-4-5-20250929는 2026-11-30에 서비스가 종료돼요. 공지일은 2026-09-30이에요. |
약 20일 남았으므로 월말 전에 전환을 완료해야 해요. |
| 공식 대체 모델 | Anthropic은 claude-sonnet-5-5로 교체할 것을 권장해요. |
마이그레이션 대상이 명확해 여러 모델을 두고 고민할 필요가 없어요. |
| 두 모델 모두 호출 가능 | 현재 플랫폼 모델 목록에 기존 모델과 새 모델이 모두 있어요. | 일정 기간 병행 운영하면서 점진적 배포와 회귀 테스트를 진행할 수 있어요. |
| 가격 및 캐시 배율 변경 | 입력, 출력, 캐시 읽기의 단가가 모두 낮아지고, 캐시 읽기 배율은 0.1에서 0.05로 내려가요. | 청구 금액이 달라지며, 캐시 적중률이 높은 서비스일수록 변화가 더 커요. |
Sonnet 4.5와 Sonnet 5.5 모두 지금 호출할 수 있어요
이번 마이그레이션은 한 번에 전면 전환할 필요가 없어요. 2026-11-10에 APIYI apiyi.com의 공개 가격표 API를 확인한 결과, 총 283개 모델 가운데 claude-sonnet-4-5와 claude-sonnet-4-5-20250929가 모두 등록돼 있었고, claude-sonnet-5-5와 claude-sonnet-5-5-thinking도 제공되고 있었어요. 기존 모델과 새 모델을 동시에 사용할 수 있으므로, 서비스 종료일 전에 동일한 API 키와 OpenAI 호환 인터페이스를 사용해 트래픽을 기존 ID에서 새 ID로 점진적으로 옮길 수 있어요.
날짜가 붙은 스냅샷인 claude-sonnet-4-5-20250929와 날짜가 없는 claude-sonnet-4-5가 코드의 서로 다른 위치에 흩어져 있는 경우가 많다는 점에 유의하세요. 전자는 재현 가능한 오프라인 평가 스크립트에서 자주 쓰이고, 후자는 서비스 코드와 설정 관리 시스템에서 흔히 사용돼요. 마이그레이션할 때는 두 가지 표기 모두 검색해서 찾아야 해요. 한쪽만 수정하지 않도록 주의하세요.
Sonnet 5.5 마이그레이션 시 thinking 변형 모델
claude-sonnet-5-5-thinking은 가격표 API에 별도 항목으로 등록돼 있고, 자체 배율도 적용돼요. 기존에 서비스에서 ‘일반 호출’과 ‘심층 추론 호출’을 구분해 사용했다면, 마이그레이션할 때도 각각 별도로 매핑해야 해요. thinking 변형 모델의 가격을 기본 모델인 claude-sonnet-5-5의 가격에 합쳐 계산하지 마세요. 이 글의 뒤쪽에서 안내하는 가격 환산은 기본 모델에만 해당해요. thinking 변형 모델은 플랫폼 모델 목록에 표시된 실제 항목을 기준으로 확인하세요.
Sonnet 4.5와 Sonnet 5.5 모델 ID 비교
마이그레이션의 첫 단계는 ID 매핑 표를 만드는 거예요. 아래 표에서 기존 표기와 권장하는 새 표기를 확인할 수 있어요.
| 현재 표기 | 상태 | 마이그레이션 후 표기 | 비고 |
|---|---|---|---|
claude-sonnet-4-5-20250929 |
사용 중단 예정, 2026-11-30에 종료 | claude-sonnet-5-5 |
공식 권장 대체 모델 |
claude-sonnet-4-5 |
아직 목록에 있으므로 스냅샷과 함께 마이그레이션해야 해요 | claude-sonnet-5-5 |
비즈니스 코드에서 가장 흔히 사용하는 표기 |
| 추론 시나리오에서 직접 조합한 Sonnet 4.5 호출 | 건별로 확인해야 해요 | claude-sonnet-5-5-thinking |
별도 항목이며 요금도 따로 책정돼요 |
매핑 정보는 여러 서비스에 각각 하드코딩하기보다 설정 센터나 환경 변수처럼 한곳에 모아 관리하는 편이 좋아요. 그러면 서비스 종료일 전후에 한곳만 수정하면 되고, 롤백도 간편해요.
Sonnet 5.5로 마이그레이션한 뒤 가격 및 캐시 읽기 배율 변화
배율 환산 기준
가격 조회 API에서 제공하는 값은 달러 가격이 아니라 세 가지 배율 필드예요. model_ratio(입력 배율), completion_ratio(입력 대비 출력 배율), cache_ratio(입력 대비 캐시 읽기 배율)입니다. 이 글에서는 플랫폼에 게시된 기존 글과 같은 기준으로 환산해요.
- 배율 1 = 입력 토큰 100만 개당 2달러
- 출력 단가 = 입력 단가 ×
completion_ratio - 캐시 읽기 단가 = 입력 단가 ×
cache_ratio
아래 표의 달러 가격은 위 기준으로 환산한 값이며, 공식 공시 가격이 아니에요. 데이터 기준일은 2026-11-10입니다.
| 모델 | model_ratio | completion_ratio | cache_ratio | 입력 $/토큰 100만 개 | 출력 $/토큰 100만 개 | 캐시 읽기 $/토큰 100만 개 |
|---|---|---|---|---|---|---|
claude-sonnet-4-5 |
1.5 | 5 | 0.1 | $3 | $15 | $0.30 |
claude-sonnet-5-5 |
1 | 5 | 0.05 | $2 | $10 | $0.10 |
Sonnet 5.5 캐시 읽기 배율 변화 살펴보기
표를 보면 두 가지 변화가 있어요. 첫째, 기본 배율인 model_ratio가 1.5에서 1로 낮아졌고 completion_ratio는 두 모델 모두 5이므로 입력과 출력 단가가 각각 약 3분의 1씩 낮아져요. 둘째, 캐시 읽기 배율인 cache_ratio가 0.1에서 0.05로 내려갔어요. 기본 배율 하락까지 더해져 캐시 읽기 단가는 $0.30에서 $0.10으로 약 3분의 2 낮아졌습니다.
같은 모델 ID로 마이그레이션하더라도 업무 유형에 따라 청구 금액의 변화 폭은 달라져요. 긴 시스템 프롬프트, 긴 문서 질의응답, 다중 턴 에이전트처럼 캐시 적중률이 높은 환경에서는 캐시 읽기가 청구 금액에서 차지하는 비중이 커서, 입력과 출력만 사용하는 업무보다 전체 비용 변화가 더 두드러질 수 있어요. 예산을 책정할 때 일률적인 비율 하나만 적용하지 마세요.
청구 금액 변화 예시(가정한 사용량)
아래에서는 가정한 월간 사용량을 기준으로 환산해 세 가지 가격 항목이 청구 금액에 어떻게 영향을 주는지 살펴볼게요. 아래 수치는 계산 방법을 설명하기 위한 예시이므로, 실제 사용량 통계로 바꿔 적용하세요.
| 과금 항목 | 가정한 월 사용량 | Sonnet 4.5 환산 비용 | Sonnet 5.5 환산 비용 |
|---|---|---|---|
| 입력 | 토큰 1,000만 개 | $30 | $20 |
| 출력 | 토큰 200만 개 | $30 | $20 |
| 캐시 읽기 | 토큰 3,000만 개 | $9 | $3 |
| 합계 | — | $69 | $43 |
또한 프롬프트 캐시는 일반적으로 모델별로 분리돼요. 새 ID로 전환하면 이전 모델에 쌓인 캐시가 자동으로 이어지지 않으므로, 전환 직후의 요청은 캐시에 다시 기록됩니다. 따라서 전환 당일에는 캐시 적중률이 잠시 낮아지고 청구 금액도 약간 변동할 수 있어요. 청구 금액을 비교할 때는 전환 후 처음 몇 시간은 제외하고 살펴보는 게 좋습니다.
전환 전후에 APIYI apiyi.com의 모델 목록에서 claude-sonnet-5-5와 claude-sonnet-5-5-thinking의 현재 배율을 다시 확인하고, 확인 결과를 내부 비용 예측표와 알림 임계값에 반영하세요.
Sonnet 4.5에서 Sonnet 5.5로 빠르게 마이그레이션하기
가장 간단한 요청 예시
OpenAI 호환 인터페이스로 새 모델을 호출할 때는 아래 항목만 확인하면 돼요.
- 인터페이스 주소 base_url:
https://api.apiyi.com/v1 - 요청 경로:
/chat/completions - 모델 필드 model:
claude-sonnet-5-5(기존claude-sonnet-4-5또는claude-sonnet-4-5-20250929를 대체) - 인증: 요청 헤더
Authorization: Bearer YOUR_API_KEY - 메시지 본문:
messages는 그대로 유지하면 돼요. 마이그레이션할 때 수정할 필요가 없어요.
OpenAI 공식 SDK를 사용한다면 보통 클라이언트 초기화의 base_url과 호출 시 model 매개변수만 바꾸면 돼요. 나머지 비즈니스 코드는 그대로 유지할 수 있어요.
전체 전환 항목 확인하기
전환 당일에는 다음 항목을 하나씩 확인하세요.
– 클라이언트 초기화: base_url을 `https://api.apiyi.com/v1`로 통일하고, API 키는 환경 변수에서 읽도록 설정해요.
– 기본 모델: 설정 센터 또는 환경 변수의 기본 model을 `claude-sonnet-5-5`로 변경해요.
– 추론 라우팅: 기존에 심층 추론을 사용하던 분기는 `claude-sonnet-5-5-thinking`으로 변경해요. 이 모델은 별도 요금이 적용돼요.
– 대체 모델 목록: fallback 또는 재시도 경로에 `claude-sonnet-4-5`가 있다면 함께 바꿔 주세요. 모델 지원 종료 후 대체 호출이 실패하는 일을 방지할 수 있어요.
– 허용 목록 및 권한: 게이트웨이의 모델 허용 목록과 팀원이 사용할 수 있는 모델 목록에 새 ID를 추가해요.
– 비용 및 알림: 단가표와 예산 알림 임계값을 새 요금 배율에 맞게 업데이트해요.
– 로그 및 보고서: model 필드로 사용량을 집계하는 대시보드에서 새 ID와 기존 ID를 같은 비즈니스 라인으로 묶어 주세요. 전환 후 보고서가 끊기는 일을 방지할 수 있어요.
– 오프라인 평가 스크립트: 날짜 스냅샷 `claude-sonnet-4-5-20250929`을 사용하는 평가 작업을 새 ID로 바꾸고 기준선을 다시 실행해요.
빠른 시작 팁: 먼저 테스트 환경에서 APIYI의 같은 키로 새 모델과 기존 모델을 모두 호출해 출력과 사용량 차이를 기록한 뒤, 점진적 배포 비율을 정하는 것을 권장해요. 신규 사용자는 무료 테스트 할당량으로 회귀 테스트를 먼저 진행해도 좋아요.
권장하는 5단계 전환 순서
- 기존 ID 전체 검색: 코드 저장소, 설정 센터, CI 스크립트, 게이트웨이 설정에서
claude-sonnet-4-5를 검색하세요. 날짜가 포함된 형식과 포함되지 않은 형식을 모두 검색해 목록으로 정리합니다. - 새 모델 가격 확인: 플랫폼의 모델 목록에서
claude-sonnet-5-5와 thinking 변형의 현재 요율을 확인하고, 비용 예상치와 알림 임계값을 업데이트하세요. - 일부 트래픽으로 단계적 전환: 먼저 핵심이 아닌 업무나 요청의 일부를 새 ID로 전환하세요. 나머지 트래픽은 기존 ID가 계속 처리하도록 두고 오류율과 출력 품질을 살펴봅니다.
- 동일한 요청으로 검수: 고정된 검수 요청을 신구 모델에 각각 보내 응답, 사용량, 과금이 예상대로인지 확인하세요(자세한 내용은 다음 절 참고).
- 지원 종료 전에 전체 전환: 2026-11-30 전에 전체 전환을 완료하고, 코드와 설정에서 기존 ID를 삭제해 지원 종료 후 누락된 경로에서 오류가 발생하지 않도록 하세요.
전환 후 동일한 요청으로 검수하기
검수의 핵심은 ‘동일한 요청’입니다. 시스템 프롬프트, 사용자 메시지, max_tokens를 고정한 뒤 기존 모델과 새 모델에 각각 요청을 보내 다음 항목을 비교하세요.
- 응답의 model 필드: 응답의 모델명이
claude-sonnet-5-5인지 확인하세요. 기본값이나 대체 로직으로 다른 모델명으로 바뀌지 않았는지도 살펴봅니다. - usage 사용량 필드:
prompt_tokens와completion_tokens를 비교하세요. 응답에 캐시 관련 필드가 있다면 함께 기록해 캐시가 적용됐는지 확인합니다. - 업무 출력: 자체 평가 기준에 따라 결과를 확인하세요. 예를 들어 구조화된 출력이 JSON 검증을 통과하는지, 도구 호출 형식이 올바른지 점검합니다. 성능 차이는 실제 작업에 대한 회귀 테스트 결과를 기준으로 판단하세요.
- 과금 내역: APIYI apiyi.com 콘솔의 사용량 기록에서 해당 요청을 찾아 새 요율에 따른 계산과 과금이 일치하는지 확인하세요.
다음 날 동일한 요청을 다시 보내면 캐시가 다시 생성된 후의 적중 여부도 확인할 수 있습니다. 검수를 통과하면 단계적 전환 비율을 높이세요.
자주 묻는 질문(FAQ)
Q1: Sonnet 4.5의 서비스 종료 대상 모델은 무엇인가요?
Anthropic의 서비스 종료 페이지에 명시된 모델은 `claude-sonnet-4-5-20250929`이며, 상태는 Deprecated입니다. 공지일은 2026-09-30, 서비스 종료일은 2026-11-30입니다. 업무에서 날짜가 없는 `claude-sonnet-4-5` 형식을 사용 중이라면, 서비스 종료 후 호출 오류가 발생하지 않도록 함께 마이그레이션하는 것이 좋습니다.
Q2: Sonnet 5.5로 마이그레이션할 때 Sonnet 4.5와 비교해 주의할 점은 무엇인가요?
엔지니어링 측면에서 주요 변경 사항은 세 가지입니다. 모델 ID가 `claude-sonnet-5-5`로 바뀌고, 입력·출력·캐시 읽기 단가가 모두 낮아지며, 캐시 읽기 배율은 0.1에서 0.05로 변경됩니다. 사용 중인 시나리오에 적합한지는 자체 작업으로 회귀 테스트를 진행해야 합니다. 이 글에서는 전면 대체가 가능하다고 결론 내리지 않습니다.
Q3: 서비스 종료일 전까지 `claude-sonnet-4-5`를 계속 호출할 수 있나요?
2026-11-10 기준으로 `claude-sonnet-4-5`와 `claude-sonnet-4-5-20250929` 모두 플랫폼 모델 목록에 있어 계속 호출할 수 있습니다. 이 기간에 신구 모델을 병렬로 실행해 비교해 보는 것이 좋지만, 전환을 서비스 종료 당일까지 미루지는 마세요.
Q4: Sonnet 5.5로 마이그레이션한 뒤 비용 변화가 가장 큰 업무는 무엇인가요?
캐시 읽기 비중이 높은 업무에서 변화가 가장 큽니다. 예를 들면 다음과 같습니다.
– **긴 시스템 프롬프트를 사용하는 고객 지원 또는 어시스턴트**: 매 요청에서 같은 긴 프롬프트 캐시를 적중합니다.
– **긴 문서에 대한 질의응답**: 같은 문서에 반복해서 질문합니다.
– **다중 턴 에이전트 작업**: 여러 턴에 걸쳐 컨텍스트를 대량으로 재사용합니다.
Q5: API를 통해 `claude-sonnet-5-5`로 빠르게 전환하려면 어떻게 해야 하나요?
APIYI에 가입해 API 키를 발급받은 뒤, OpenAI 호환 호출 방식은 그대로 유지하고 `base_url`을 이 글에 안내된 주소로 설정한 다음 `model`을 `claude-sonnet-5-5`로 바꾸면 됩니다. 신규 사용자는 무료 테스트 크레딧으로 검수 요청을 먼저 실행해 볼 수 있습니다.
Q6: thinking 변형 모델의 요금은 어떻게 책정되나요?
`claude-sonnet-5-5-thinking`은 요금 조회 API에서 별도 항목으로 제공되며, 배율도 기본 모델과 다릅니다. 이 글에서 환산한 요금은 기본 모델인 `claude-sonnet-5-5`에만 해당합니다. thinking 변형 모델의 현재 요금은 플랫폼 모델 목록에서 확인하세요. 기본 모델 요금을 적용하면 안 됩니다.
Q7: 마이그레이션 시 알려진 위험은 무엇인가요?
주요 위험은 세 가지입니다. 첫째, 하드코딩된 기존 ID가 남아 있으면 서비스 종료 후 바로 오류가 발생합니다. 둘째, 전환 당일에는 캐시를 다시 구축해야 하므로 단기적으로 적중률이 낮을 수 있습니다. 셋째, 출력 스타일이나 형식이 달라질 수 있어 엄격한 형식 파싱에 의존하는 하위 시스템은 회귀 테스트가 필요합니다. 단계적 전환과 고정 요청 검수로 대부분의 위험을 줄일 수 있습니다.
Sonnet 4.5에서 Sonnet 5.5로 마이그레이션할 때 핵심 요점
- 지원 종료일이 명확해요:
claude-sonnet-4-5-20250929는 2026-11-30에 지원이 종료돼요. 공식적으로는claude-sonnet-5-5로 전환하는 것을 권장해요. - 신구 모델을 함께 사용해 점진적으로 전환할 수 있어요: 2026-11-10 기준으로 두 모델 모두 플랫폼 목록에 있어 병렬로 비교할 수 있어요.
- 세 항목의 단가가 모두 바뀌어요: 배율 기준으로 입력은 $3→$2, 출력은 $15→$10, 캐시 읽기는 $0.30→$0.10이에요.
- 캐시 읽기 단가가 가장 크게 달라져요:
cache_ratio가 0.1에서 0.05로 낮아져 캐시 비중이 높은 서비스일수록 변화가 더 커요. - thinking은 별도로 요금이 책정돼요:
claude-sonnet-5-5-thinking은 독립 항목이므로 기본 모델 가격과 섞어 표기하지 마세요. - 동일한 요청으로 검증하세요:
model필드와usage사용량, 청구 내역을 확인하고, 성능 차이는 실제 업무에 사용하는 작업으로 회귀 테스트하세요.
요약
Sonnet 4.5에서 Sonnet 5.5로 마이그레이션할 때 핵심은 다음과 같아요.
- 먼저 ID를 바꾸세요:
claude-sonnet-4-5와claude-sonnet-4-5-20250929를 모두claude-sonnet-5-5에 매핑하고, 추론용 분기는 thinking 변형 모델에 매핑하세요. - 그다음 가격을 다시 계산하세요:
model_ratio,completion_ratio,cache_ratio를 기준으로 입력, 출력, 캐시 읽기 비용을 새로 추정하세요. - 마지막으로 검증하세요: 점진적으로 전환한 뒤 동일한 요청으로 반환된 모델명, 사용량, 청구 금액을 확인하고, 지원 종료일 전에 기존 ID를 삭제하세요.
2026-11-30까지 약 20일 남았어요. 이번 주에 전체 검색과 테스트 환경 전환을 마치고, 업무 회귀 테스트를 진행할 시간을 확보하는 것을 권장해요. 신구 모델을 함께 비교해야 한다면 APIYI apiyi.com에서 API 키 하나로 호출과 사용량을 확인할 수 있어요. 모델명과 가격은 플랫폼 모델 목록을 기준으로 확인하세요.
📚 참고 자료
- Anthropic 모델 지원 종료 페이지: Claude 모델의 사용 중단 및 지원 종료 일정
- 링크:
platform.claude.com/docs/en/about-claude/model-deprecations -
설명:
claude-sonnet-4-5-20250929의 상태, 공지일, 지원 종료일, 공식 대체 권장 모델을 확인할 수 있어요. -
APIYI 공개 가격표 API: 모델 배율 데이터 출처
- 링크:
api.apiyi.com/api/pricing - 설명: 2026-11-10에 조회했으며,
model_ratio,completion_ratio,cache_ratio필드가 포함되어 있어요.
작성자: APIYI 기술팀
기술 상담: 마이그레이션 과정에서 문제가 발생하면 APIYI 웹사이트 홈에서 문의해 주세요. 더 많은 연동 자료는 docs.apiyi.com 문서 센터에서 확인할 수 있어요.
