클로드 소네트 4.5 API, 11월 30일에 꺼진다 | 5.5로 옮길 때 400 오류 나는 설정 5가지와 쓰는 곳 찾는 법

Claude API로 만든 서비스나 스크립트가 아직 claude-sonnet-4-5-20250929를 부르고 있다면 11월 30일 전에 바꿔야 합니다. 앤트로픽이 9월 30일 이 모델의 종료를 알렸고, 종료일이 지나면 이 이름으로 보낸 요청은 실패합니다. 공식 대체 모델은 claude-sonnet-5-5인데, 이름만 바꾸면 400 오류가 나는 설정이 몇 가지 있습니다.

한 줄 요약: claude-sonnet-4-5-20250929는 Claude API에서 11월 30일 종료되고 공식 대체는 claude-sonnet-5-5다. 5.5는 생각(thinking)이 기본으로 켜지고, 프리필·thinking 예산·강제 tool_choice·샘플링 값·옛 computer use 도구는 400 오류가 난다. 먼저 Console Usage → Export와 grep으로 쓰는 곳부터 찾는다.

목차

1. 무엇이 언제 꺼지나

2. 내 코드와 키 중 어디서 쓰고 있나

3. 5.5로 옮기면 400 오류가 나는 설정

4. 가격과 토큰은 어떻게 달라지나

5. 11월 30일 전에 할 일

1. 무엇이 언제 꺼지나

공식 문서의 2026년 9월 30일 항목은 짧습니다. 종료일 11월 30일, 종료 모델 claude-sonnet-4-5-20250929, 권장 대체 claude-sonnet-5-5 세 칸이 전부입니다. 앤트로픽은 공개 모델을 종료하기 최소 60일 전에 실제로 쓰고 있는 고객에게 이메일로 알린다고 적어 두었습니다.

모델	지금 상태	문서에 적힌 날짜
claude-sonnet-4-5-20250929	Deprecated(종료 예정)	11월 30일 종료 확정
claude-opus-4-5-20251101	Active	"2026년 11월 24일보다 빠르지 않음"
claude-haiku-4-5-20251001	Active	"2026년 10월 15일보다 빠르지 않음"
claude-sonnet-4-6	Active	"2027년 2월 17일보다 빠르지 않음"
claude-sonnet-5-5	Active	"2027년 9월 28일보다 빠르지 않음"

핵심 Opus 4.5와 Haiku 4.5는 아직 종료가 발표된 모델이 아닙니다. 문서의 "Not sooner than" 날짜는 그보다 먼저 꺼지지는 않는다는 뜻이지 그날 꺼진다는 뜻이 아닙니다. 다만 Haiku 4.5는 그 날짜가 10월 15일로 가까우니 공지를 지켜보는 편이 좋습니다.

출처: Claude 모델 종료 문서 갈무리(2026년 10월 6일)

3줄 선택 가이드

• Claude API 키로 직접 코드를 짰다 → 아래 grep과 Console Export로 쓰는 곳부터 찾는다
• Amazon Bedrock·Google Cloud에서 쓴다 → 각 플랫폼 모델 표의 날짜를 따로 본다
• claude.ai 앱·클로드 코드 구독으로만 쓴다 → 이 표는 API 일정이고, 앱·구독의 모델 제공은 별도로 확인한다

2. 내 코드와 키 중 어디서 쓰고 있나

가장 빠른 방법은 두 가지입니다. 하나는 프로젝트 폴더에서 모델 이름 문자열을 검색하는 것이고, 다른 하나는 Claude Console에서 사용 기록을 내려받아 키별로 보는 것입니다.

소네트 4.5를 부르는 줄 찾기(맥·리눅스)

grep -rnE "claude-sonnet-4-5|claude-4-5-sonnet|sonnet-4-5" --include=*.py --include=*.js --include=*.ts --include=*.env .

재구성한 예시 화면(파일·모델 이름은 예시)

결과에 나온 파일과 줄 번호가 고칠 곳입니다. 다만 모델 이름이 배포 서비스의 환경 변수나 데이터베이스 설정에만 있으면 코드 검색으로는 나오지 않습니다. 그래서 두 번째 방법이 필요합니다.

재구성한 예시 화면(메뉴 이름 기준: Claude 모델 종료 문서)

공식 문서가 안내하는 절차는 세 단계입니다. Claude Console의 Usage 페이지로 가서 Export를 누르고, 내려받은 CSV에서 API 키와 모델별 사용량을 봅니다. 소네트 4.5가 찍힌 키가 있으면 그 키를 쓰는 서비스가 바꿀 대상입니다.

주의 Amazon Bedrock과 Google Cloud는 종료 일정을 각자 정합니다. 공식 문서도 이 두 곳의 상태와 날짜가 다를 수 있다고 적어 두었습니다. 이 글의 11월 30일은 Claude API, Claude Platform on AWS, Microsoft Foundry 기준입니다.

3. 5.5로 옮기면 400 오류가 나는 설정

이전 가이드는 소네트 4.5에서 넘어올 때 고칠 것을 목록으로 정리해 두었습니다. 그중 그대로 두면 요청 자체가 400 오류로 거절되는 대표적인 설정은 아래 다섯 가지입니다. 아래에서 따로 설명하는 thinking: disabled도 400 오류가 나는 설정입니다.

4.5에서 쓰던 것	5.5에서 일어나는 일	바꾸는 방법(공식 가이드)
마지막 assistant 메시지 미리 채우기(프리필)	400 오류	형식이 목적이면 구조화 출력, 나머지는 시스템·사용자 메시지로
thinking: enabled + budget_tokens	400 오류	thinking: adaptive와 output_config.effort로
tool_choice: any 또는 tool(강제 호출)	400 오류	tool_choice: auto + 도구에 strict: true(Amazon Bedrock은 strict 없이 auto만 쓰고 도구 입력을 코드에서 검증)
temperature·top_p·top_k 기본값 아닌 값	400 오류	빼고 프롬프트로 조절
computer_20250124 도구	어느 플랫폼에서도 거부	Claude API·Google Cloud는 computer_toolset_20260801

재구성한 예시 화면(기준: 소네트 5.5 이전 가이드)

하나 더 알아 둘 것이 있습니다. 4.5는 thinking 필드를 안 보내면 생각 없이 답했지만, 5.5는 필드가 없으면 적응형 생각이 켜집니다. 그래서 응답 맨 앞에 thinking 블록이 올 수 있고, content[0].text로 답을 읽던 코드는 깨집니다. 블록을 type으로 골라 읽도록 바꾸고, 도구를 쓰는 대화에서는 thinking 블록을 그대로 다시 넘겨야 합니다.

생각을 미리 하지 않게 하려면 thinking: {"type": "between_tools"}를 보냅니다. 소네트 5에서 쓰던 {"type": "disabled"}는 5.5에서 400 오류가 납니다. between_tools는 effort가 low·medium·high일 때만 받습니다.

핵심 베타 헤더도 정리합니다. interleaved-thinking-2025-05-14는 빼고, fine-grained-tool-streaming-2025-05-14는 도구별 eager_input_streaming: true로 바꿉니다. output_format은 output_config.format으로 옮깁니다.

4. 가격과 토큰은 어떻게 달라지나

가격 문서 기준으로 소네트 4.5는 입력 100만 토큰당 3달러, 출력 15달러입니다. 이전 가이드는 소네트 5.5가 소네트 5와 같은 가격이라고 적었고, 소네트 5는 입력 2달러, 출력 10달러입니다. 단가만 보면 내려갑니다.

그런데 같은 글이 토큰으로는 더 많이 셉니다. 이전 가이드는 5.5가 새 토크나이저를 써서 4.5보다 같은 텍스트가 약 30% 더 많은 토큰이 된다고 적었습니다. 생각이 기본으로 켜지고 생각 토큰은 출력 요금으로 청구되니, max_tokens와 월 비용은 실제 요청으로 다시 재 봐야 합니다. 큰 이미지도 4.5보다 토큰을 더 씁니다.

항목	소네트 4.5	소네트 5.5
입력 단가(100만 토큰)	3달러	2달러
출력 단가(100만 토큰)	15달러	10달러
같은 텍스트의 토큰 수	기준	약 30% 많음(내용에 따라 다름)
thinking 필드 없을 때	생각 안 함	적응형 생각 켜짐

5. 11월 30일 전에 할 일

순서는 단순합니다. 쓰는 곳을 찾고, 모델 이름을 바꾸고, 위 표의 다섯 가지를 고치고, 응답을 type으로 읽게 바꾼 뒤, 평소 쓰던 입력 몇 개로 결과와 비용을 비교합니다. 이전 가이드는 일반 작업은 effort high에서 시작하고, 에이전트형 코딩이나 여러 단계 도구 호출은 medium에서, 채팅처럼 응답 속도가 중요한 작업은 medium이나 low에서 시작하라고 권합니다.

주의 종료일을 넘기면 옛 이름으로 보낸 요청은 실패합니다. 오류 처리 없이 모델을 부르는 자동화가 있다면, 바꾸기 전에 실패 시 알림부터 걸어 두는 편이 안전합니다.

Q. claude.ai 앱이나 클로드 코드 구독도 영향을 받나요?

종료 문서가 적용 대상으로 적은 곳은 Claude API, Claude Platform on AWS, Microsoft Foundry입니다. 앱과 구독 상품의 모델 제공 일정은 이 문서에 설명이 없으니 따로 확인해야 합니다.

Q. Bedrock에서 쓰는데 날짜가 같나요?

아닙니다. 공식 문서는 Amazon Bedrock과 Google Cloud가 각자 종료 일정을 정한다고 적었습니다. 각 플랫폼의 모델 표를 따로 확인해야 합니다.

Q. 소네트 4.6으로 잠깐 옮겨도 되나요?

문서상 4.6은 Active이고 2027년 2월 17일보다 빨리 꺼지지 않는다고 적혀 있습니다. 다만 공식 권장 대체는 5.5이고, 4.6도 결국 다시 옮겨야 합니다.

Q. 오류 메시지로 무엇을 고쳐야 할지 알 수 있나요?

이전 가이드에 대표 오류 문구가 실려 있습니다. 예를 들어 강제 도구 호출은 "tool_choice: type tool and any are not supported for this model", 프리필은 "This model does not support assistant message prefill"입니다.

3줄 핵심 요약

1. claude-sonnet-4-5-20250929는 Claude API에서 11월 30일 종료, 대체는 claude-sonnet-5-5.
2. 프리필·thinking 예산·thinking disabled·강제 tool_choice·샘플링 값·옛 computer use는 5.5에서 400 오류.
3. Console Usage → Export와 grep으로 쓰는 곳을 찾고, 토큰 약 30% 증가를 감안해 비용을 다시 잰다.

마치며

오늘 할 일은 하나입니다. Claude Console의 Usage에서 Export를 눌러 CSV를 받아 보세요. 내려받은 기록에서 소네트 4.5가 보이지 않더라도 배포 설정과 환경 변수는 한 번 더 확인하세요. 보이면 아직 50일 넘게 남았으니 위 설정들을 하나씩 고칠 시간이 충분합니다. OpenAI도 10월 23일에 옛 API 모델 여러 개를 종료할 예정이니, 두 회사 API를 함께 쓰고 있다면 같이 점검하세요.

NEXT READ

이어서 읽어 볼 글

01  클로드 소네트 5.5, 무료 플랜에서도 쓴다 · 대체 모델 소개

02  커서에서 OpenAI 모델이 11월 12일 끊긴다 · 다른 종료 일정

03  코딩 AI 구독 한 장 비교 · 구독 요금

#클로드,#ClaudeAPI,#소네트45,#소네트55,#모델종료,#API이전,#Anthropic,#코드노트,#개발자,#AI개발