Claude Sonnet 5 완벽 정리 - 1M 컨텍스트와 달라진 점 총정리

프로젝트에서 쓰던 Claude Sonnet 4.6을 그대로 유지할지, 새로 나온 Claude Sonnet 5로 옮길지 고민하던 차에 공식 문서를 정리해봤습니다. 단순히 모델 이름만 바뀐 게 아니라 컨텍스트, 토크나이저, 기본 동작까지 여러 곳이 달라져서 마이그레이션 전에 꼭 확인해야 할 내용이 많았습니다.

이 글에서 사용하는 주요 용어 정의

용어	정의
컨텍스트 윈도우(Context Window)	모델이 한 번에 참고할 수 있는 입력+출력 토큰의 총량
Adaptive Thinking	별도 설정 없이도 모델이 필요에 따라 스스로 사고 과정을 거치는 기본 동작
토크나이저(Tokenizer)	텍스트를 모델이 처리하는 토큰 단위로 쪼개는 규칙
MTok	100만 토큰(Million Tokens)을 뜻하는 가격 단위

---

Claude Sonnet 5란?

Claude Sonnet 5(API 모델 ID: claude-sonnet-5)는 Claude Sonnet 4.6의 후속 모델로, Anthropic 공식 문서 기준 "드롭인(drop-in) 업그레이드"로 소개됩니다. 즉 기존 Sonnet 4.6 코드를 그대로 두고 모델 ID만 바꿔도 대부분 동작합니다.

가장 큰 특징은 1M 토큰 컨텍스트 윈도우가 기본값이자 최댓값이라는 점입니다. Sonnet 4.6처럼 더 작은 컨텍스트 옵션이 따로 있는 게 아니라, 처음부터 1M 하나로 통일되었습니다. 최대 출력 토큰은 128k이며, Priority Tier를 제외한 Sonnet 4.6의 모든 툴·플랫폼 기능을 동일하게 지원합니다.

[Sonnet 4.6] 여러 컨텍스트 옵션 존재
      │
      ▼ 업그레이드
[Sonnet 5]  1M 토큰 컨텍스트 (기본값 = 최댓값), 128k 최대 출력

---

핵심 내용

1) 동작 변경 3가지

공식 문서가 강조하는 동작 변경은 다음 세 가지입니다.

변경 사항	Sonnet 4.6	Sonnet 5
thinking 필드 없을 때	사고 없이 실행	Adaptive Thinking 기본 적용
수동 확장 사고(budget_tokens)	지원 중단 예정(deprecated)	완전 제거, 400 에러
temperature/top_p/top_k 커스텀 값	허용	400 에러 반환

수동 확장 사고 대신 thinking: {type: "adaptive"}를 사용해야 하며, 샘플링 파라미터는 기본값 외의 값을 넣으면 요청 자체가 거부됩니다.

2) 새 토크나이저 - 토큰 수가 약 30% 늘어난다

Sonnet 5는 새 토크나이저를 사용합니다. 같은 텍스트라도 Sonnet 4.6 대비 약 30% 더 많은 토큰으로 계산됩니다. API 요청/응답 구조는 그대로지만, 다음 항목은 다시 확인해야 합니다.

• 기존에 측정해둔 토큰 수 (재계산 필요)
• max_tokens 한도 (기존 기준으로는 응답이 잘릴 수 있음)
• 요청당 비용 (토큰당 단가는 동일해도 총 토큰 수가 늘어 비용이 달라질 수 있음)

3) 가격 및 이용 가능 범위

Sonnet 5는 표준 가격 기준 입력 $3 / 출력 $15(MTok당)로 Sonnet 4.6과 동일하지만, 2026년 8월 31일까지는 $2 / $10 도입 가격이 적용됩니다. Claude API, AWS Bedrock, Google Cloud, Microsoft Foundry 전반에서 이용 가능하고, Managed Agents에서도 event delta streaming, 세션 단위 오버라이드 등 확장된 기능과 함께 지원됩니다.

---

실습 예시 - 마이그레이션 코드

# 기존 (Sonnet 4.6)
model = "claude-sonnet-4-6"
thinking = {"type": "enabled", "budget_tokens": 32000}

# 변경 후 (Sonnet 5)
model = "claude-sonnet-5"
thinking = {"type": "adaptive"}

마이그레이션 시 체크리스트는 다음과 같습니다.

1. 모델 ID를 claude-sonnet-5로 변경
2. budget_tokens를 쓰던 코드는 adaptive로 전환
3. temperature/top_p/top_k에 커스텀 값을 넣고 있었다면 제거
4. 토큰 카운팅을 다시 실행해 max_tokens 한도 재조정

---

마무리

Claude Sonnet 5는 이름 그대로 Sonnet 라인의 다음 세대지만, 1M 컨텍스트 고정·Adaptive Thinking 기본화·새 토크나이저까지 실무에 영향을 주는 변경이 꽤 있습니다. 특히 토큰 수가 늘어나는 점과 수동 확장 사고 제거는 기존 코드에서 400 에러로 바로 드러날 수 있으니, 마이그레이션 전에 위 체크리스트부터 확인해보시길 권합니다.

---

참고 자료

• Anthropic 공식 문서 - What's new in Claude Sonnet 5
• Claude Platform release notes
• Releasebot - Claude Developer Platform Updates, July 2026