클로드 소넷 5.5 API 특징·가격·사용사례 정리 (2026년 9월 29일 기준)

클로드 소넷 5.5는 속도와 지능의 균형을 내세운 Anthropic의 범용 모델이다. 2026년 9월 28일 출시됐고, 문맥 100만 토큰과 적응형 사고가 특징이다. API 가격은 입력 100만 토큰당 2달러, 출력 10달러다. 코딩 에이전트, 챗봇, 구조화 출력, 리서치 작업에 쓸 때는 사용사례별 설정이 다르다.

Anthropic 모델 페이지가 출시일, 사양, 요율을 밝힌다. 공식 프롬프팅 가이드는 사용사례별 설정을 설명한다. 이전 가이드는 소넷 5에서 옮길 때의 변경을 다룬다.

세 줄로 먼저 읽기

• 특징은 빠른 속도, 100만 토큰 문맥, 12만 8천 토큰 출력, 적응형 사고다.
• 사용사례마다 시작 설정이 다르다. 코딩은 medium에서, 빠른 응답은 low에서 시작한다.
• 가격은 소넷 5와 같다. 소넷 5 코드는 다섯 곳을 고쳐야 400 오류를 피한다.

Anthropic은 2026년 9월 28일 릴리스 노트에서 claude-sonnet-5-5를 공개했다. Claude API, Amazon Bedrock, Google Cloud, Microsoft Foundry, Claude Platform on AWS에서 쓸 수 있다. 한국 전용 원화 요율은 공식 문서에 없다. 이 글은 달러 기준 값만 다룬다.

소넷 5.5의 특징은 빠른 속도와 100만 토큰 문맥이다

공식 모델 페이지는 소넷 5.5를 속도와 지능의 균형이 가장 좋은 모델이라고 소개한다. 아래 값은 이 페이지에서 2026년 9월 29일에 확인한 사양이다.

항목	공식 값	실무 의미
문맥 창	100만 토큰	긴 문서와 긴 대화를 한 요청에 담는다.
최대 출력	12만 8천 토큰	배치 API 베타에서는 최대 30만 토큰이다.
사고 방식	적응형, 기본 effort는 high	모델이 생각량을 정하고 effort로 조절한다.
입력과 출력	텍스트·이미지 입력, 텍스트 출력	PDF와 이미지도 읽는다.
지연 시간	빠름	Opus 5.5보다 빠르고 Haiku 4.5보다 느리다.
지식 기준	2026년 6월	이후 변경은 검색 도구로 확인한다.
지원 종료	2027년 9월 28일 이전에는 없음	출시 후 최소 1년은 유지된다.

주의할 제약도 있다. temperature, top_p, top_k를 기본값이 아닌 값으로 보내면 400 오류가 난다. 캐시할 수 있는 최소 프롬프트 길이는 512토큰이다.

요청 거부 방식도 알아 둘 만하다. 요청이 거부되면 HTTP 200과 stop_reason: "refusal"이 온다. 사유는 cyber, bio, frontier_llm, reasoning_extraction, general_harms 다섯 가지다. 프롬프트에 추론 과정을 답변에 쓰라고 시키면 reasoning_extraction 거부를 부를 수 있다. 거부 유형별 과금 기준과 재시도 점검 순서는 Claude API 거부 응답 과금 기준과 재시도 점검법에서 따로 다뤘다.

API 가격은 입력 2달러, 출력 10달러다

공식 모델 페이지와 가격표의 기본 요율은 입력 100만 토큰당 2달러, 출력 100만 토큰당 10달러다. 소넷 5와 같다. 캐시 읽기는 0.20달러, 5분 캐시 쓰기는 2.50달러, 1시간 캐시 쓰기는 4달러다. 배치 API는 입력과 출력에 50% 할인이 붙는다.

사고 토큰도 출력 토큰으로 과금된다. 가격을 볼 때는 입력·출력·캐시를 나눠 계산한다. 예를 들어 입력 1만 토큰과 출력 2천 토큰이면 기본 요율만 곱한 값은 0.04달러다. 입력 0.02달러와 출력 0.02달러의 합이다. 이는 산술 예시이며 실제 청구액이 아니다.

새 기능 일부는 베타이므로 표시를 확인한다

공식 What's new 문서는 소넷 5.5가 지원하는 기능을 나열한다. 이 가운데 요청별 effort, 대화 중간 시스템 메시지, 도구 중간 변경은 소넷 5가 지원하지 않는다. 베타 표시가 붙은 기능은 헤더가 필요하고 바뀔 수 있다.

• 요청별 effort(베타): 대화 도중 요청마다 생각량을 바꾼다. 캐시가 유지된다.
• 대화 중간 시스템 메시지: 앞선 메시지를 고치지 않고 지시를 바꾼다.
• 도구 중간 변경(베타): 대화 중에 도구 목록을 바꾼다.
• 온디맨드 압축(베타): 긴 대화를 서명된 요약 블록으로 줄인다. compact-2026-09-04 헤더가 필요하다.
• 인라인 도구 정의(베타): 메시지 안에 도구 정의를 담는다. inline-tools-2026-09-15 헤더가 필요하다.

Files API, PDF 지원, 비전, 프롬프트 캐싱, 배치 처리도 지원한다. 플랫폼마다 지원 범위가 다를 수 있다. 쓰려는 경로의 공식 페이지를 먼저 본다.

사용사례별로 시작 설정이 다르다

공식 프롬프팅 가이드는 사용사례별 시작점을 제시한다. 소넷 5.5의 effort 단계는 소넷 5와 다르게 조정됐다. 소넷 5 설정을 그대로 옮기지 말고 자기 평가 세트로 다시 잰다.

사용사례	공식 권고	이유
에이전트 코딩·여러 단계 도구 사용	명확한 작업은 medium, 어렵거나 길면 high	low에서는 검증을 건너뛰거나 중간에 확인을 물을 수 있다.
채팅·지연에 민감한 작업	medium 또는 low	effort가 높을수록 첫 응답이 늦다.
계산이 필요한 JSON 출력	적응형 사고에 high 이상, 시스템 프롬프트 끝에 "Think the problem through before you answer."	생각 없이 답하면 정확도가 떨어진다.
리서치·고객지원	바뀔 수 있는 조건은 검색 도구로 확인하라고 지시	학습 지식으로 가격·허용 조건을 답할 수 있다.
도표·도면 이미지	자르기·확대·코드 실행 도구 제공	도표는 도구를 쓰면 effort를 올리는 것보다 정확했다.

마케팅 실무에 대입하면 이렇게 볼 수 있다. 이 예시는 공식 권고에서 추론한 것이며 MCPY가 실측한 결과가 아니다.

• 광고 성과 요약 봇: 응답 속도가 중요하므로 medium이나 low에서 시작하고, 숫자 합계가 들어가면 high를 시험한다.
• CRM 문의 분류: 규칙 적용이 필요하면 구조화 출력과 적응형 사고를 함께 쓰고 high에서 정확도를 잰다. Amazon Bedrock에서는 구조화 출력을 쓸 수 없다.
• 정책·요금 안내 챗봇: 바뀌는 조건은 검색 도구로 확인하게 지시한다.
• 대시보드 캡처 해석: 도표를 확대하는 도구를 붙인다.

긴 에이전트 작업에서는 진행 상황이 안 보일 수 있다. 도구 호출 사이의 긴 메모가 thinking 블록으로 오고 기본 설정에서는 텍스트가 비어 있기 때문이다. 사용자에게 보여 주려면 display: "updates"(베타)를 쓰거나 between_tools를 쓴다.

상위·하위 모델과는 이렇게 나뉜다

공식 비교표에서 소넷 5.5는 가격과 속도의 중간 지점에 있다. 공식 프롬프팅 가이드는 가장 어려운 장기 작업에는 Opus 모델이 낫다고 안내한다.

모델	문맥	가격(입력/출력)	지연
Claude Fable 5.1	100만	10달러 / 50달러	느림
Claude Opus 5.5	100만	4달러 / 20달러	보통
Claude Sonnet 5.5	100만	2달러 / 10달러	빠름
Claude Haiku 4.5	20만	1달러 / 5달러	가장 빠름

소넷 5에서 옮길 때는 다섯 곳을 확인한다

공식 What's new 문서는 소넷 5 코드의 호환성 변경 다섯 가지를 나열한다. 모든 앱에 다섯 문제가 다 생기는 것은 아니다. 쓰는 기능부터 확인한다.

확인할 부분	기존 코드에서 생길 수 있는 일	조치
사고 설정	thinking.type=disabled가 400 오류를 낸다.	사전 사고를 끄려면 between_tools를 쓰고 effort를 high 이하로 둔다.
도구 강제	tool_choice의 any 또는 tool이 400 오류를 낸다.	auto로 바꾸고 도구 입력 검증을 확인한다.
사고 블록 재사용	과거 대화를 편집해 사고 블록을 다시 보내면 계정 조건에 따라 400 오류가 날 수 있다.	기존 대화를 고치지 말고 새 메시지만 덧붙인다.
컴퓨터 사용 도구	Claude API와 Google Cloud에서 이전 computer_20251124 도구가 허용되지 않는다.	computer_toolset_20260801로 옮긴다.
어드바이저 도구	소넷 5.5를 실행 모델로 쓸 때 Opus 4.8, Opus 4.7, 소넷 5를 어드바이저로 지정하면 거부된다.	소넷 5.5가 받는 모델로 바꾼다.

도구 호출을 강제한 자동화가 가장 먼저 걸린다. 소넷 5.5는 auto와 none만 받는다. 공식 가이드는 auto에 strict: true를 함께 쓰거나 구조화 출력을 쓰라고 안내한다. 다만 auto에서는 모델이 도구 없이 답할 수도 있다. 도구 실행이 필수인 단계는 코드에서 결과를 검사한다. Amazon Bedrock에서는 strict 도구를 포함한 구조화 출력이 이 모델에 제공되지 않는다. 그곳에서는 strict 없이 auto만 보내고 코드에서 도구 입력을 검증한다.

모델을 교체하는 순서는 이렇게 잡는다

아래는 공식 변경을 바탕으로 정리한 점검 순서다. 실제 고객 시스템을 이전한 실험 결과가 아니다.

1. 요청 형식을 모은다. 모델 ID, 사고 설정, effort, 도구 강제 여부, 컴퓨터 사용 도구, 어드바이저 모델을 적는다.
2. 보낼 수 없는 값을 바꾼다. disabled와 강제 tool_choice부터 정리한다.
3. 대표 작업으로 시험한다. 도구 호출 여부, 화면 표시, 사고 블록 전달을 확인한다. 성공·400 오류·빈 응답을 나눠 기록한다.
4. 비용 기준선을 다시 잰다. 입력·출력·사고 토큰과 캐시를 나눠 기록한다.
5. 문제없는 경로부터 넓힌다. 이전 모델 ID로 되돌릴 설정을 준비한다.

이전 가이드는 Messages API 코드를 다룬다. Claude Managed Agents를 쓴다면 모델 이름 변경 외에 필요한 변경은 없다고 밝힌다.

자주 묻는 질문

소넷 5.5의 가장 큰 특징은 무엇인가?
공식 문서는 속도와 지능의 균형을 내세운다. 사양으로는 100만 토큰 문맥, 12만 8천 토큰 출력, 적응형 사고가 눈에 띈다.

소넷 5.5가 소넷 5보다 비싼가?
기본 공개 요율은 같다. 입력 100만 토큰당 2달러, 출력 10달러다. 실제 청구액은 작업별 사용량과 계약 조건으로 확인한다.

한국에서는 얼마로 결제하나?
공식 모델 페이지는 달러 기준 요율만 제시한다. 원화 고정 가격이나 결제 환율은 확인되지 않았다.

모델 이름만 바꾸면 되나?
Messages API에서 위 설정을 쓴다면 아니다. 현재 코드의 파라미터와 응답 파서를 먼저 확인한다.

공식 근거 링크

• 출시일: Anthropic 릴리스 노트
• 사양·요율·모델 비교: 소넷 5.5 모델 페이지, 가격표
• 새 기능·호환성 변경: What's new in Claude Sonnet 5.5
• 이전 절차: Migrating to Claude Sonnet 5.5
• 사용사례별 설정: Prompting Claude Sonnet 5.5

공식 근거 확인: 2026년 9월 29일. 계산 예시는 산술 설명이며 실제 청구 자료가 아니다. 마케팅 사용 예시는 공식 권고에서 추론한 것이다. 그림은 생성 일러스트이며 실제 API 화면이나 장애 증거가 아니다.