Claude Platform Docs
모델 및 가격Claude Sonnet 5

Claude Sonnet 5의 새로운 기능

Claude Sonnet 5의 새로운 기능 및 동작 변경 사항에 대한 개요입니다.

Claude Sonnet 5는 Anthropic의 Sonnet 모델 제품군의 차세대 모델입니다. Claude Sonnet 4.6을 그대로 대체할 수 있는 업그레이드이며, 세 가지 동작 변경 사항이 있습니다. adaptive thinking(적응형 사고)이 기본적으로 켜져 있고, 수동 "extended thinking"(확장 사고)은 이제 400 오류를 반환하며(Claude Sonnet 4.6에서 지원 중단되었음), 샘플링 매개변수(temperature, top_p, top_k)를 기본값이 아닌 값으로 설정하면 400 오류를 반환합니다. 이 페이지에서는 새로운 토크나이저를 포함하여 출시 시점의 모든 새로운 사항을 요약합니다.

새로운 모델

모델API 모델 ID설명
Claude Sonnet 5claude-sonnet-5속도와 지능의 최상의 조합

Claude Sonnet 5는 기본적으로 1M 토큰 컨텍스트 윈도우를 지원하며(1M 토큰이 기본값이자 최대값이며, 더 작은 컨텍스트 변형은 없습니다), 128k 최대 출력 토큰, adaptive thinking, 그리고 Claude Sonnet 4.6과 동일한 도구 및 플랫폼 기능 세트를 지원합니다. 단, Priority Tier는 Claude Sonnet 5에서 사용할 수 없습니다. Claude API 및 Google Cloud에서 Claude Sonnet 5는 브라우저 사용 도구와 컴퓨터 사용 도구의 안정 버전인 computer_toolset_20260801도 지원하는데, 이 두 가지는 모두 Claude Sonnet 4.6에서 지원되지 않습니다. 이전 버전인 computer_20251124는 두 모델 모두에서 여전히 허용됩니다. 기존 통합을 업그레이드하려면 computer_20251124에서 마이그레이션을 참조하세요.

전체 가격 및 사양은 모델 개요를 참조하세요.

동작 변경 사항

기본적으로 켜져 있는 adaptive thinking

Claude Sonnet 4.6에서는 thinking 필드가 없는 요청이 사고 없이 실행됩니다. Claude Sonnet 5에서는 동일한 요청이 adaptive thinking과 함께 실행됩니다. 사고를 끄려면 thinking: {type: "disabled"}를 전달하세요. max_tokens는 총 출력(사고와 응답 텍스트의 합)에 대한 엄격한 제한이므로, Claude Sonnet 4.6에서 사고 없이 실행되던 워크로드의 경우 이 값을 다시 검토하세요.

샘플링 매개변수 허용되지 않음

temperature, top_p 또는 top_k를 기본값이 아닌 값으로 설정하면 400 오류가 반환됩니다. 마이그레이션 시 이러한 매개변수를 제거하세요. 기본값(또는 매개변수 생략)은 허용됩니다. 모델 동작을 안내하려면 시스템 프롬프트 지침을 사용하세요. 이는 Sonnet 계열 모델에서는 새로운 사항이며, 동일한 제약이 이전에 Claude Opus 4.7에 도입된 바 있습니다.

수동 확장 사고 제거됨

수동 확장 사고(thinking: {type: "enabled", budget_tokens: N})는 Claude Sonnet 4.6에서 지원 중단되었으며, Claude Sonnet 5에서는 제거되어 Claude Opus 4.8 및 Claude Opus 4.7과 마찬가지로 400 오류를 반환합니다. 대신 effort 매개변수와 함께 adaptive thinking을 사용하세요.

# Claude Sonnet 5에서는 지원되지 않습니다(400 반환)
thinking = {"type": "enabled", "budget_tokens": 32000}

# 대신 이것을 사용하세요
thinking = {"type": "adaptive"}

새로운 토크나이저

Claude Sonnet 5는 새로운 "tokenizer"(토크나이저)를 사용합니다. 동일한 입력 텍스트가 Claude Sonnet 4.6에 비해 약 30% 더 많은 토큰을 생성합니다. 정확한 증가량은 콘텐츠에 따라 다릅니다. 이는 API 변경이 아닙니다. 요청, 응답 및 스트리밍 이벤트는 동일한 형태를 유지하며, 코드 변경이 필요하지 않습니다.

이 변경은 토큰 단위로 측정하거나 예산을 책정하는 모든 것에 영향을 미칩니다.

  • 토큰 수: 동일한 텍스트에 대한 usage 필드 및 토큰 카운팅 결과가 Claude Sonnet 4.6보다 높습니다. 이전 모델을 기준으로 측정한 수치를 재사용하지 말고, Claude Sonnet 5를 기준으로 다시 계산하세요.
  • 텍스트 기준 컨텍스트 윈도우 용량: 컨텍스트 윈도우는 1M 토큰이지만, 각 토큰이 평균적으로 더 적은 텍스트를 포함하므로 동일한 윈도우에 Claude Sonnet 4.6보다 적은 텍스트가 들어갑니다.
  • max_tokens 예산: Claude Sonnet 4.6에 맞춰 조정된 출력 제한은 Claude Sonnet 5에서 동등한 출력을 잘라낼 수 있습니다. 예상 출력 길이에 가깝게 설정된 제한을 다시 검토하세요.
  • 요청당 비용: 토큰당 가격은 Claude Sonnet 4.6보다 낮지만(가격 참조), 동일한 텍스트가 더 많은 토큰을 생성하므로 동등한 요청의 비용이 정비례로 감소하지는 않습니다.

Claude Sonnet 4.6에서 이어받은 API 제약 사항

어시스턴트 메시지 프리필 지원되지 않음

어시스턴트 메시지를 프리필하면 400 오류가 반환되며, 이는 Claude Sonnet 4.6과 동일합니다. 대신 구조화된 출력, 시스템 프롬프트 지침 또는 output_config.format을 사용하세요.

기능 개선 사항

Claude Sonnet 5는 더 낮은 가격으로 Claude Sonnet 4.6보다 향상된 기능을 제공하는 업그레이드입니다. 또한 Opus 계열 모델로 이동하지 않고도 Claude Sonnet 4.6이 제공하는 것보다 더 많은 기능이 필요한 워크로드를 위한 선택지이기도 합니다.

Claude Sonnet 4.6 대비 가장 큰 향상은 코딩 및 에이전트 작업에서 나타납니다. 벤치마크 결과는 Anthropic의 Transparency Hub를 참조하세요.

사이버 보안 안전장치

Claude Sonnet 5는 실시간 사이버 보안 안전장치를 갖춘 최초의 Sonnet 등급 모델입니다. 금지되거나 고위험인 사이버 보안 주제와 관련된 요청은 거부될 수 있습니다. 거부는 오류가 아니라 stop_reason: "refusal"이 포함된 성공적인 HTTP 200 응답으로 반환됩니다. 안전장치가 차단하는 내용과 합법적인 보안 작업이 Cyber Verification Program에 신청하는 방법은 Claude Opus 및 Sonnet의 실시간 사이버 안전장치를 참조하세요.

가격

Claude Sonnet 5의 가격은 입력 토큰 백만 개당 $2, 출력 토큰 백만 개당 $10로, Claude Sonnet 4.6의 $3/$15보다 토큰당 가격이 낮습니다. 새로운 토크나이저가 동일한 텍스트에 대해 약 30% 더 많은 토큰을 생성하므로, Claude Sonnet 4.6과 비교할 때 동등한 요청의 비용이 토큰당 가격에 정비례하여 감소하지는 않습니다. 정확한 차이는 콘텐츠와 워크로드 형태에 따라 다릅니다.

배치 처리 및 프롬프트 캐싱 요금을 포함한 전체 가격은 가격을 참조하세요.

가용성

출시 시점에 Claude Sonnet 5는 다음에서 사용할 수 있습니다.

Claude Sonnet 5는 ZDR 계약이 있는 조직을 위해 제로 데이터 보존을 지원합니다.

마이그레이션 가이드

Claude Sonnet 5는 Claude Sonnet 4.6을 그대로 대체할 수 있습니다. 모델 ID를 업데이트하세요.

model = "claude-sonnet-4-6"  # Before
model = "claude-sonnet-5"  # After

그런 다음 다음 사항을 검토하세요.

  1. 토큰 예산 및 수: 새로운 토크나이저는 동일한 텍스트에 대해 약 30% 더 많은 토큰을 생성합니다. 정확한 증가량은 콘텐츠와 워크로드 형태에 따라 다릅니다. 토큰 카운팅으로 프롬프트를 다시 계산하고, 예상 출력 길이에 가깝게 설정된 max_tokens 제한을 다시 검토하세요.
  2. 확장 사고: 여전히 budget_tokens를 설정하고 있다면 adaptive thinking으로 마이그레이션하세요. 수동 확장 사고(thinking: {type: "enabled"})는 지원되지 않으며 400 오류를 반환합니다.
  3. 샘플링 매개변수: 샘플링 매개변수(temperature, top_p, top_k)를 기본값이 아닌 값으로 설정한 요청은 400 오류를 반환하므로, 마이그레이션 시 제거하세요. 도구 정의 및 응답 형태는 변경되지 않았으며, 어시스턴트 메시지 프리필은 Claude Sonnet 4.6에서 이미 지원되지 않았습니다.

자세한 내용은 Claude Sonnet 4.6에서 Claude Sonnet 5로 마이그레이션을 참조하세요.

다음 단계

모델 개요

현재 모든 Claude 모델의 전체 사양 및 가격.

토큰 카운팅

마이그레이션하기 전에 새로운 토크나이저로 프롬프트를 측정하세요.

Adaptive thinking

Claude Sonnet 5에서 권장되는 사고 활성화 모드.

컨텍스트 윈도우

1M 토큰 컨텍스트 윈도우의 작동 방식.

가격

배치 처리 및 프롬프트 캐싱 요금을 포함한 전체 가격.

Was this page helpful?