Sonnet 5.5는 Sonnet 5의 토큰 단가를 유지하고, 예전 파라미터 일부의 호환을 깨뜨립니다

바뀐 점

Anthropic 빌드 가이드는 아래 100만 토큰당 요금을 적습니다. 배치 처리와 프롬프트 캐시를 포함한 Sonnet 5.5의 모든 가격은 Sonnet 5와 같으므로, ID를 바꿔도 토큰당 청구액은 그대로입니다. inference_geo를 "us"로 둔 미국 전용 추론은 표준 가격의 1.1배입니다. Anthropic은 작업 청구액은 여전히 움직인다고 말합니다. Sonnet 5.5가 보통 토큰을 덜 쓰고, 대부분의 작업은 최대 30% 덜 든다는 설명입니다. 긴 변이 최대 2576픽셀인 고해상도 티어에서 2000×1500 이미지는 Sonnet 4.6, Sonnet 4.5, Haiku 4.5보다 약 2.5배의 토큰이 듭니다. 그 디테일이 필요 없으면 보내기 전에 해상도를 줄입니다.

Claude Code 체인지로그가 Anthropic API라고 부르는 Claude API의 ID는 claude-sonnet-5-5입니다. 같은 가이드에서 Claude Platform on AWS, Google Cloud, Microsoft Foundry는 별도 호스트이며 같은 ID를 받습니다. Amazon Bedrock은 anthropic.claude-sonnet-5-5를 씁니다. 가이드는 Sonnet 5.5가 오늘 그 플랫폼들에서 쓸 수 있으며, Foundry는 Global Standard 배포로 한정된다고 말합니다. 컨텍스트는 베타 헤더 없는 네이티브 100만 토큰입니다. 최대 출력은 128k 토큰이고, Message Batches API에서는 output-300k-2026-03-24 베타 헤더로 최대 300k까지입니다. 지식 컷오프는 2026년 6월입니다. 토크나이저는 Sonnet 5와 같습니다. 캐시할 수 있는 가장 짧은 프롬프트는 512토큰으로, Sonnet 5의 1,024토큰보다 짧습니다. 캐시 읽기는 입력 가격의 10분의 1입니다.

Claude Code 체인지로그는 claude-sonnet-5-5가 이제 Anthropic API의 기본 Sonnet이며, 컨텍스트는 1M, 100만 토큰당 $2/$10, 캐시 읽기는 100만 토큰당 $0.20이라고 적습니다. 빌드 가이드는 Claude Code v2.1.284와 TypeScript용 Agent SDK v0.3.284 이상에서 sonnet 별칭이 medium effort의 Sonnet 5.5이고, thinking은 켜진 채이며, fast mode는 없다고 말합니다. 기본 모델은 Opus 5.5로 남습니다. 범위가 분명한 작업은 /model sonnet으로 바꿉니다.

• ClaudeDevs 발표
• Claude Sonnet 5.5로 구축하기
• Claude Code 체인지로그

누구를 위한 모델인가

Anthropic의 워크로드 표는 범위가 분명한 코딩, 양이 많은 일상 개발, 다듬어진 문서·슬라이드·스프레드시트, 반복해서 도는 정의가 분명한 에이전트 작업을 Sonnet 5.5에서 시작하라고 둡니다. 신중한 판단, 길게 이어지는 에이전트 작업, 가장 어려운 문제는 Opus 5.5에서 시작합니다. 가이드는 Sonnet 5.5가 명세가 분명하고 결과를 확인할 방법이 있는 일에 맞는다고 말합니다.

Anthropic은 Epic Games COO Daniel Vogel을 인용합니다. 초기 테스트에서 시스템 설계 감사와 데이터 흐름 검토가 상위 등급에 기대하는 품질 기준을 유지했고, 게임플레이 코드 수만 줄과 수 시간짜리 작업을 거쳤으며, 지시를 덜 세세하게 넣어도 됐다는 내용입니다. 이는 Anthropic이 공개한 Epic의 초기 테스트입니다. Haiku 5.5는 앞으로 몇 주 안에, 양이 많고 지연이 낮아야 하는 작업용으로 예정돼 있습니다. 같은 날 @claudeai는 @_re_pete의 잎사귀 시뮬레이터와 @forwardeditor의 공 튀기기 테스트를 가리켰고, 각각 Sonnet 5와 Sonnet 5.5를 나란히 두었습니다. 그 게시물에는 점수나 프롬프트가 없습니다. 빌드 가이드에서 Lance Martin의 캡션은 각 모델이 사진 한 장을 다시 그리는 코드를 쓰는 장면을 보여 주며, 순서는 사진, Sonnet 5, Sonnet 5.5, Opus 5.5입니다. 승자는 적지 않습니다.

• 잎사귀 시뮬레이터 스레드
• 공 튀기기 테스트
• Claude Sonnet 5.5로 구축하기

Sonnet 5 연동에서 바꿀 것

모델은 claude-sonnet-5-5로 보내고, 콘텐츠 블록은 type별로 읽습니다. adaptive thinking이 기본으로 켜져 있어 응답이 thinking 블록으로 시작할 수 있고, content[0].text를 읽는 코드는 깨집니다. 가이드 예시는 output_config의 effort를 medium으로 둡니다. 기본 effort는 제품 전체에서 하나의 값이 아닙니다. 모델 상세 표는 Claude API에서 high를 주며, 가이드는 강한 결과에서 시작하라는 뜻이라고 말합니다. Claude Code에서는 medium입니다. 가격 절은 표면마다 다를 수 있다고 말하며, 예로 Claude Platform은 high, Claude Code는 medium을 듭니다.

effort 단계는 low, medium, high, xhigh, max이며 다시 조정되어 Sonnet 5 설정은 이어지지 않습니다. 작업이 에이전트형도 아니고 지연에 민감하지도 않으면 high에서 시작합니다. 에이전트 코딩과 여러 단계의 도구 사용은 명세가 분명한 작업에서 medium으로 시작하고, 더 어렵거나 길어지면 high로 올립니다. 대화와 그 밖의 지연에 민감한 작업은 medium이나 low에서 시작합니다. xhigh나 max는 자체 평가에서 품질이 오를 때만 씁니다. thinking은 max_tokens에 포함됩니다. 에이전트 코딩에서는 max_tokens를 128,000으로 두고 응답을 스트리밍합니다. 시스템 프롬프트에 덜 생각하라고 적어도 thinking이 안정적으로 줄지는 않습니다. Claude Code에서는 /claude-api migrate this project to claude-sonnet-5-5가 모델 ID 교체와 깨지는 파라미터 변경을 적용합니다.

Anthropic은 기존 Sonnet 5 프롬프트가 잘 동작해야 한다고 말합니다. 거절을 유도하는 문장, 도구 호출 재시도용 우회 문구, "do not be lazy" 줄을 뺀 다음 다른 튜닝 전에 평가를 다시 돌립니다. effort가 low이면 Sonnet 5.5가 코드 변경을 실제로 돌려 보는 검사를 건너뛰기도 합니다. 거절은 HTTP 200이고 stop_reason은 refusal입니다. stop_details는 cyber, bio, frontier_llm, reasoning_extraction, general_harms 중 하나입니다. 모델에게 응답 안에 추론을 쓰라고 하면 reasoning_extraction 거절을 부릅니다. 가이드는 그 추론을 요약된 thinking에서 읽으라고 하며, adaptive thinking과 display를 summarized로 둡니다. 서버 측 fallback은 Claude API의 베타이고, fallbacks는 "default"입니다. cyber와 frontier_llm 거절만 재시도하며, 그 재시도는 Sonnet 5에서 합니다. Anthropic은 자동 행동 감사에서 Sonnet 5.5가 대부분의 정렬과 정직성 지표에서 Sonnet 5와 같거나 더 낫다고 말합니다. 가이드는 그 감사의 항목별 점수를 주지 않습니다. Anthropic은 이것이 가장 능력 있는 모델들과 비슷한 사이버보안 안전장치를 둔 첫 Sonnet이며, 대부분의 일상적인 소프트웨어 개발은 영향을 받지 않는다고도 말합니다. 가이드는 메시지별 effort(베타), 대화 도중의 시스템 메시지, 대화 도중의 도구 변경(베타)을 더한다고 적지만, 이 페이지에는 요청 형태가 없습니다. 요청 사이에 최상위 effort를 바꾸면 캐시가 무효가 됩니다. 메시지별 effort는 캐시를 유지합니다.

• thinking 필드가 없는 요청은 adaptive thinking으로 돕니다. thinking type disabled는 400을 돌려줍니다. between_tools는 앞쪽 thinking을 끄므로 thinking은 도구 호출 사이에만 일어나고, low, medium, high에서만 됩니다. xhigh나 max에서는 400을 돌려주므로 그 단계는 adaptive thinking을 씁니다. 가이드의 예시 자체도 between_tools로 바꿀 때 xhigh 요청을 high로 내립니다. between_tools는 display, budget_tokens, block_binding을 거부하고, effort는 대화 도중에 바꿀 수 없습니다. Sonnet 5.5를 제공하는 모든 플랫폼에서 베타 헤더 없이 동작합니다. SDK에 between_tools가 없으면 SDK를 업데이트합니다.
• type이 any나 tool인 tool_choice는 토큰 집계 엔드포인트를 포함해 400을 돌려줍니다. auto를 보내고, strict는 true, 모든 object에 additionalProperties는 false, 언제 도구를 부를지 적는 프롬프트를 함께 보냅니다.
• Sonnet 5.5는 Sonnet 5의 thinking 블록을 읽으므로, 앞으로 넘긴 대화는 그 추론을 유지합니다. 가이드는 다른 어떤 모델도 Sonnet 5.5의 thinking 블록을 읽지 않는다고 말합니다.
• Claude API와 Google Cloud에서 computer use는 toolset computer_toolset_20260801뿐입니다. 예전 도구 computer_20251124를 선언하면 400이 납니다. computer-use-2025-11-24 헤더를 뺍니다. fine-grained-tool-streaming-2025-05-14 헤더가 toolset 옆에 있으면 그 조합이 400을 돌려주므로 빼고, 필요한 각 도구에 eager_input_streaming을 true로 둡니다. 에이전트 루프는 이어서 멤버 tool_use 블록, 배치 액션, 결과에 실린 toolset_name을 처리합니다. Amazon Bedrock은 여전히 computer_20251124를 받습니다.
• advisor 도구에서 Sonnet 5.5 executor는 Opus 4.8, Opus 4.7, Sonnet 5를 advisor로 거부합니다. 받는 advisor에는 Opus 5.5, Opus 5, Sonnet 5.5가 포함됩니다. 조언은 advisor_redacted_result 블록으로 암호화되어 돌아오며, 애플리케이션 코드는 그 안의 텍스트를 읽을 수 없습니다.
• 도구 호출 사이의 메모가 한두 문장보다 길면 progress thinking 블록으로 돌아오고, 기본 display에서는 비어 있습니다. adaptive thinking에서는 display를 summarized로 두거나, thinking-display-updates-2026-08-18 베타 헤더와 함께 updates로 둡니다. between_tools에서는 그 텍스트가 display 없이 돌아옵니다.

• Claude Sonnet 5.5로 구축하기

이 페이지가 열어 둔 것

레이트 리밋은 Sonnet 5와 별개이고, 기본 티어 값은 같습니다. Priority Tier는 Claude API에서 쓸 수 있습니다. 제로 데이터 보존은 대상이 되는 고객용입니다. 이 페이지는 티어 숫자, Priority Tier 가격, 자격 규칙, 별도의 배치 비율을 적지 않습니다. Haiku 5.5는 앞으로 몇 주 안에 합류한다고 적혀 있습니다. Cyber Verification Program은 곧 적법한 보안 작업을 위해 Sonnet 5.5를 포함할 예정입니다. 두 문장 모두 날짜는 없습니다. 여기의 computer-use 규칙은 Claude API, Google Cloud, Bedrock 예외를 다룹니다. Claude Platform on AWS와 Microsoft Foundry에는 이 페이지의 computer-use 규칙이 주어지지 않습니다. Anthropic의 자동 행동 감사는 항목 점수 없이 요약돼 있습니다. "Available today"는 2026년 9월 28일 발표 옆에 있는 가이드의 표현입니다.

• Claude Sonnet 5.5로 구축하기