Claude Sonnet 5 출시 : 공식 문서 살펴보기(주요 변화, 가격, 모델 ID, 플랜별 접근성, 1M 컨텍스트 등)

안녕하세요! 갓대희 입니다.

2026년 6월 30일, Anthropic이 Claude Sonnet 5를 발표했다. 같은 날 가격 페이지도 바뀌었다. 자세히 보면 어긋나는 대목이 있다. 9월부터 토큰당 단가는 Sonnet 4.6과 완전히 같아지지만 실제 청구액은 달라질 수 있다.

 

출시 첫 주라 정보가 많고 흩어져 있다. 발표문, 모델 문서, 가격 페이지, Claude Code 문서가 따로 움직이고, 어느 글을 봐도 "어떤 플랜에서 어떻게 쓰면 되는지"가 한곳에 모여 있지 않다. 모델 ID에 날짜를 붙여야 하는 줄 아는 사람도 있고 Claude Code에서 sonnet이라고만 치면 매번 Sonnet 5가 나온다고 생각하는 사람도 있다. 둘 다 공식 문서 기준으로는 맞지 않는다.

 

이 글에서는 출시 메시지와 벤치마크, 가격 정책, 플랜별 접근성, API·앱 실사용법, 한국 시장에서 달라지는 부분을 공식 발표와 문서 기준으로 정리한다. 코드를 안 써본 독자도 어떤 플랜으로 시작하면 되는지, 이미 Sonnet 4.6을 쓰던 개발자라면 무엇을 바꿔야 하는지 차례대로 확인하도록 구성했다.

이 글은 2026년 7월 1일 기준으로 작성됐다. 공식 소스: Anthropic 공식 발표 · Claude 모델 개요 문서

Claude 모델 출시 시리즈

1. 미토스 5? 페이블 5? — Anthropic 신모델 출시 총정리, 이 글은 Fable 5가 직접 썼다 ← 이전 글
2. Claude Sonnet 5 출시 총정리 — 지금 가장 싸게 쓰는 법과 9월부터 달라지는 것들 [현재 글]

이 글의 핵심 6가지

• Anthropic 공식 포지셔닝은 "Opus 4.8에 근접한 성능, 더 낮은 가격"
• 코딩·에이전틱 벤치마크가 Sonnet 4.6 대비 크게 올랐다 (SWE-bench Pro 58.1%→63.2%, Terminal-Bench 67.0%→80.4%)
• 가격은 8월 31일까지 입력 $2/출력 $10, 9월부터 $3/$15(Sonnet 4.6과 동일)
• 모델 ID는 claude-sonnet-5 하나뿐 — 날짜 붙은 버전은 없다
• Claude Code의 sonnet·default 별칭은 계정 유형·제공자에 따라 다른 모델로 해석된다
• thinking을 끄면 도구·검색 사용 성향도 낮아질 수 있어, 에이전트 작업은 effort와 max_tokens를 함께 봐야 한다
• 한국 전용 평가·출시일·요금 정책은 공식 확인되지 않았다 — 결제는 해외 결제 가능 카드 필요

목차

1. 출시 개요 — Opus 4.8에 근접한 성능, 가격은 더 낮게
2. 코딩·에이전틱 성능, 벤치마크로 보는 변화 폭
3. 안전성 평가 — Sonnet 4.6과 달라진 것
4. 가격 정책 — 도입가와 표준가, 그리고 토크나이저 함정
5. 플랜별 접근성과 추천 매트릭스
6. API 실사용법 — 모델 ID부터 마이그레이션까지
7. Claude.ai 앱·웹에서 쓰는 법
8. 코딩 에이전트·자동화 파이프라인 적용 — Claude Code와 별칭 함정
9. Sonnet 4.6에서 갈아타야 할까
10. 자주 묻는 질문과 결론

본문에서 쓰는 용어 정리

• API(Application Programming Interface, 응용 프로그램 인터페이스): 프로그램끼리 데이터를 주고받는 약속된 호출 방식
• SDK(Software Development Kit): API를 쉽게 호출하도록 묶어 놓은 코드 패키지
• 토크나이저(tokenizer): 텍스트를 모델이 처리하는 최소 단위(토큰)로 쪼개는 변환기
• effort 파라미터: 모델이 답을 내기까지 얼마나 깊이 추론할지 조절하는 강도 설정값
• 적응형 사고(adaptive thinking): 질문 난이도에 따라 모델이 스스로 추론 깊이를 조절하는 사고 모드
• ZDR(zero data retention, 데이터 무보존): 요청·응답 데이터를 서버에 전혀 남기지 않는 운영 방식
• 별칭(alias): claude-sonnet-5 같은 정식 모델 ID 대신 짧게 쓰는 sonnet, opus 같은 호출용 이름
• 캐시 히트(cache hit): 이전에 보냈던 프롬프트가 그대로 재사용되어 더 싸게 처리되는 경우
• Batch API: 실시간 응답 대신 비동기로 대량 요청을 처리해 단가를 낮추는 API

 

1. 출시 개요 — Opus 4.8에 근접한 성능, 가격은 더 낮게

Claude Sonnet 5는 2026년 6월 30일 공개됐다. Anthropic이 발표문에서 앞세운 메시지는 단순하다. 공식 발표는 다음과 같이 설명한다.

"Sonnet 5 narrows the gap: its performance is close to that of Opus 4.8, but at lower prices."

(번역: Sonnet 5는 격차를 좁힌다 — 성능은 Opus 4.8에 근접하면서도 가격은 더 낮다.)

최상위 모델 Opus 4.8과의 성능 격차는 좁히고 가격은 낮췄다는 메시지다. 신모델을 낼 때 "더 강력해졌다"는 표현만 쓰는 경우가 많은데, 이번에는 가격까지 함께 강조한 점이 눈에 띈다. 가성비를 출시 메시지의 한 축으로 올린 셈이다. 구체적인 수치는 4장에서 따진다.

 

모델 ID는 claude-sonnet-5다. Sonnet 4.6의 드롭인(in-place, 호환 가능한 대체) 업그레이드로 설계됐고, 주의할 동작 변화는 세 가지다. 적응형 사고 기본 켜짐, 수동 확장 사고 제거, 기본값이 아닌 샘플링 파라미터 거부다. 세 가지 모두 6장 마이그레이션에서 코드 예제로 다룬다.

 

사용 범위도 넓다. Free·Pro 플랜의 기본 모델이고 Max·Team·Enterprise 사용자도 쓸 수 있다. 플랜별 차이는 5장에서 표로 정리한다.

 

공개 스펙을 보면 이번 출시는 새 모델 등급을 만든 사례라기보다, 기존 Sonnet 자리에 성능을 끌어올린 모델을 끼워 넣는 방식에 가깝다. 이런 드롭인 전략은 채택 장벽을 낮춘다. 대신 세 가지 동작 변화를 모르고 넘어가면 일부 코드에서 400 에러가 난다. 이 디테일은 가볍게 넘길 부분이 아니다.

 

2. 코딩·에이전틱 성능, 벤치마크로 보는 변화 폭

Anthropic은 Sonnet 5가 추론, 툴 사용, 코딩, 지식 작업 같은 에이전틱 성능에서 Sonnet 4.6보다 크게 개선됐다고 밝힌다. 발표 페이지 자체에는 구체 수치가 텍스트로 없다. 벤치마크 표가 이미지로만 제공된다.

수치 출처 고지: 아래 벤치마크 수치는 공식 발표 페이지 원문에 텍스트로 존재하지 않는다. 기술 매체 MarkTechPost 기사가 Anthropic의 6월 30일 공식 발표를 인용해 텍스트로 정리한 2차 출처 기준이며, 신뢰도(confidence)는 medium(중간) 등급으로 본다. 정확한 수치가 필요하면 공식 발표 페이지의 벤치마크 이미지와 직접 대조하는 편이 안전하다.

벤치마크	Sonnet 4.6	Sonnet 5	Opus 4.8
SWE-bench Pro (에이전틱 코딩)	58.1%	63.2%	69.2%
Terminal-Bench 2.1	67.0%	80.4%	미기재
OSWorld-Verified (컴퓨터 사용)	78.5%	81.2%	미기재
Humanity's Last Exam (도구 사용)	46.8%	57.4%	57.9%
GDPval-AA v2 (지식 작업, 점수)	미기재	1,618	1,615

표를 보면 Sonnet 5는 Sonnet 4.6 대비 전 항목에서 점수가 올랐다. Humanity's Last Exam과 GDPval-AA v2 두 항목에서는 Opus 4.8과 차이가 1점 안팎까지 좁혀졌다. SWE-bench Pro와 Terminal-Bench처럼 실제 작업을 끝까지 완수해야 하는 항목에서 격차가 가장 크게 벌어졌다는 점도 놓치면 안 된다. 단발성 질의응답보다 여러 턴에 걸친 작업에서 체감 차이가 클 가능성이 높다.

 

Sonnet 5가 Terminal-Bench 2.1에서 13.4%p, SWE-bench Pro에서 5.1%p 오른 건 단순 모델 교체 이상의 의미로 읽힌다. 두 벤치마크 모두 셸 명령 실행과 코드 수정을 거쳐 끝까지 작업을 완료해야 점수가 나오는 구조다. 그래서 이번 개선은 "더 똑똑한 답변"보다 "끝까지 해내는 능력"에 가깝다.

출시 직후 차트는 수정 이력이 있다

Anthropic은 2026년 6월 30일 발표문 하단 changelog에서 BrowseComp 비용-성능 차트를 한 차례 수정했다고 밝혔다. 초기 차트가 표준 agentic search 평가 방법론을 반영하지 않아 Sonnet 5 성능을 낮게 잡았고, 이후 10M 토큰 예산·압축·프로그래밍 방식 툴 호출을 포함한 시스템 카드 기준 방법론에 맞춰 업데이트했다는 설명이다. 따라서 출시 직후 캡처된 차트만 보고 결론을 내리기보다는 현재 공식 페이지와 시스템 카드 기준으로 다시 확인하는 편이 안전하다.

 

3. 안전성 평가 — Sonnet 4.6과 달라진 것

안전성 평가도 Sonnet 4.6과의 비교로 제시됐다. Anthropic은 Sonnet 5가 전반적으로 바람직하지 않은 행동(undesirable behaviors) 비율이 더 낮고, 에이전틱 맥락에서 더 안전하다고 설명한다.

 

평가 범위는 오용 협조, 기만 등 정렬되지 않은 행동 전반이다. 공식 발표는 악의적 요청 거부와 프롬프트 인젝션 하이재킹 저항이 개선됐다고 밝힌다. 환각(hallucination)과 아첨(sycophancy) 비율도 Sonnet 4.6보다 낮아졌다고 한다.

 

Sonnet 5는 실시간 사이버보안 안전장치를 갖춘 첫 Sonnet급 모델이다. 금지되거나 고위험인 사이버보안 주제 요청은 거부될 수 있다. 이때 거부는 에러가 아니라 정상 HTTP 200 응답으로 온다. stop_reason(응답 종료 사유) 필드에 refusal(거부)이 담기는 식이다.

실무 체크: 거부가 에러 코드가 아니라 정상 응답으로 온다는 점은 놓치기 쉽다. 기존에 4xx·5xx만 잡던 예외 처리 로직을 그대로 쓰면 거부 응답을 일반 성공으로 취급하게 된다. API 연동 코드에는 stop_reason 값을 분기하는 처리를 넣어 두는 게 안전하다.

 

4. 가격 정책 — 도입가와 표준가, 그리고 토크나이저 함정

가격은 두 단계다. 2026년 8월 31일까지는 입력 $2, 출력 $10(백만 토큰)이고 9월 1일부터는 입력 $3, 출력 $15로 오른다. 이 표준가는 Sonnet 4.6과 정확히 같다(2026-07-01 기준, 최신 가격은 공식 페이지 확인).

모델 / 기간 (MTok 기준)	기본 입력	5m 캐시 쓰기	1h 캐시 쓰기	캐시 히트	출력
Sonnet 5 (~2026-08-31)	$2	$2.50	$4	$0.20	$10
Sonnet 5 (2026-09-01~)	$3	$3.75	$6	$0.30	$15
Sonnet 4.6	$3	$3.75	$6	$0.30	$15

 

9월부터는 Sonnet 4.6과 토큰당 단가가 완전히 같아진다. 그런데 단가가 같다고 실제 비용까지 같다고 보면 틀린다.

가격표만 보면 놓치는 것 — 토크나이저

Sonnet 5는 새 토크나이저를 쓴다. 같은 입력 텍스트라도 Sonnet 4.6보다 약 30% 더 많은 토큰으로 쪼개진다 (출처: Sonnet 5 What's New 문서). API 요청·응답 형식 자체는 바뀌지 않아 코드 수정은 필요 없지만 토큰 카운팅과 비용 산정은 영향을 받는다. 토큰당 단가는 같아도 같은 작업에 드는 실제 비용은 Sonnet 4.6과 달라질 수 있다.

 

가성비를 단가표만 보고 판단하면 오판하기 쉽다. 9월 이후 기준으로 "Sonnet 4.6과 단가가 같으니 비용도 같다"고 생각하면, 토큰 소모량이 30% 늘어난 만큼 실제 청구액은 더 커질 수 있다. 마이그레이션 전에 자기 워크로드의 토큰 수를 다시 계산해 보는 게 낫다.

 

Batch API(비동기 대량 처리)를 쓰면 입출력 모두 50% 할인된다. Sonnet 5는 도입가 구간에서 입력 $1/출력 $5, 9월 이후에는 입력 $1.50/출력 $7.50이다.

 

프롬프트 캐싱은 5분 캐시 쓰기와 1시간 캐시 쓰기 단가가 따로 있다. 반복 호출이 많은 에이전트나 RAG 파이프라인에서는 "기본 입력 단가"만 볼 게 아니라 캐시 쓰기·캐시 히트 비율까지 같이 봐야 한다. 위 표에서 5분 캐시 쓰기 열을 따로 넣은 이유도 이 때문이다 (출처: 공식 가격 페이지).

 

컨텍스트가 길어진다고 단가가 오르는 구조도 아니다. Sonnet 5는 1M 토큰 전체 구간에서 표준 단가가 동일하게 적용된다. 900k 토큰 요청도 9k 토큰 요청과 같은 토큰당 단가로 청구된다. 이 부분은 한국 커뮤니티에 떠도는 다른 주장과 함께 11장에서 다시 짚는다.

 

5. 플랜별 접근성과 추천 매트릭스

Claude.ai 구독 플랜은 다섯 단계다. Free는 무료다. Pro는 연간 약정 시 월 $17(연 $200 선결제) 또는 월간 결제 시 $20, Max는 월 $100부터, Team 스탠다드 좌석은 연간 약정 월 $20(월간 $25)·프리미엄 좌석 월 $100, Enterprise는 좌석가에 API 단가 사용량을 더해 청구한다 (출처: Claude.ai 가격 페이지).

 

Sonnet 5는 이 중 Free와 Pro 플랜의 기본 모델이다. Max·Team·Enterprise 사용자도 쓸 수 있다.

플랜	월 가격	Sonnet 5
Free	$0	기본 모델
Pro	$17~20	기본 모델
Max	$100~	선택 가능
Team Standard	좌석당 $20~25	선택 가능
Team Premium	좌석당 $100	선택 가능
Enterprise	좌석가 + 사용량	선택 가능

 

Enterprise는 구조가 다르다. 좌석료는 접근권만 커버하고, 사용량은 모두 API 단가로 별도 청구된다. 플랜·좌석 단위의 사용량 한도는 없으며 관리자가 조직이나 개인 단위로 지출 한도 설정이 가능하다 (출처: Enterprise 플랜 안내).

한도가 없다고 비용까지 무제한은 아니다: Enterprise의 "플랜·좌석 단위 한도 없음"은 쓴 만큼 청구된다는 뜻이지, 비용이 안 든다는 뜻이 아니다. 관리자가 지출 한도를 미리 걸어 두지 않으면 사용량이 그대로 청구서에 반영된다.

 

5-1. 사용자 유형별 추천 매트릭스

사용자 유형	추천
비개발자, 가볍게 시작	Free 또는 Pro — claude.ai 채팅에서 기본으로 Sonnet 5 사용
개발자, API 직접 연동	Claude API에서 model="claude-sonnet-5" 호출
코딩 에이전트 상시 사용	Claude Code + Pro/Max — 단, default 별칭 차이는 8장 확인
팀 단위 협업	Team Standard/Premium — 좌석 단가와 워크로드 비교 후 선택
대규모 조직, 사용량 변동 큼	Enterprise — 좌석가+API 단가, 지출 한도로 통제

 

표만 보면 Pro가 제일 무난해 보인다. 다만 Claude Code를 상시 자동화에 쓸 계획이라면 이야기가 다르다. 계정 유형에 따라 Claude Code의 기본 모델 자체가 Sonnet 5가 아니라 Opus 4.8로 잡히는 경우가 있다. 이 함정은 8장에서 표로 짚는다.

 

여기서 한 번 축을 나눠서 보는 게 좋다. 5장까지는 "어떤 플랜으로 접근할 것인가"의 문제였다면, 이제부터는 "실제로 어떤 문자열과 설정으로 호출할 것인가"의 문제다. 이 둘을 섞어 생각하면 Free·Pro에서는 Sonnet 5가 기본인데 왜 Claude Code default는 다르게 보이느냐 같은 혼선이 생긴다. 다음 장부터는 구독 화면이 아니라 API 호출부 기준으로 정리한다.

 

6. API 실사용법 — 모델 ID부터 마이그레이션까지

먼저 바로잡을 부분이 있다. Sonnet 5의 모델 ID는 claude-sonnet-5 하나뿐이다.

모델 ID에 날짜를 붙이지 않는다

Claude 4.6 세대부터 모델 ID는 날짜가 붙은 것(예: 20250929)과 날짜가 없는 것 모두 고정 스냅샷이라는 것이 공식 규칙이다 (출처: Claude 모델 개요 문서). claude-sonnet-5-20260701처럼 날짜를 붙인 버전은 존재하지 않는다. claude-sonnet-5 자체가 이미 고정된 스냅샷이라 날짜를 따로 붙일 필요도, 이유도 없다.

6-1. 모델 ID와 컨텍스트 스펙

공식 모델 비교표 기준으로 Claude API ID는 claude-sonnet-5, AWS Bedrock ID는 anthropic.claude-sonnet-5, Google Cloud ID도 claude-sonnet-5이며, 설명은 "속도와 지능의 최적 조합"이다. AWS 쪽은 표기가 하나 더 있다. AWS 공식 블로그에서는 us.anthropic.claude-sonnet-5라는 크로스리전 추론 프로파일 ID를 쓴다 (출처: AWS 공식 블로그).

제공자	모델 ID
Claude API	claude-sonnet-5
AWS Bedrock (일반)	anthropic.claude-sonnet-5
AWS Bedrock (US 리전 추론 프로파일)	us.anthropic.claude-sonnet-5
Google Cloud (Vertex AI)	claude-sonnet-5

 

일반적으로는 anthropic.claude-sonnet-5를 쓰면 된다. US 리전 한정 변형이 필요할 때만 us. 접두사를 단 ID로 바꾸면 된다.

 

스펙은 컨텍스트 윈도우 1M 토큰, 최대 출력 128k 토큰이다. 신뢰할 수 있는 지식 기준일과 학습 데이터 기준일은 모두 2026년 1월이다. 1M 토큰은 기본값이자 최댓값이다. Sonnet 4.6에 있던 더 작은 컨텍스트 변형은 Sonnet 5에는 없다. 다만 Priority Tier(우선 처리 등급)는 Sonnet 5에서 지원되지 않는다.

 

6-2. 코드로 시작하기

Python SDK 설치는 한 줄이다.

pip install anthropic

 

이 명령은 Anthropic 공식 Python 패키지를 설치한다 (출처: Python SDK 문서). Python 3.9 이상이 필요하다.

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ.get("ANTHROPIC_API_KEY"),
)

message = client.messages.create(
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Hello, Claude",
        }
    ],
    model="claude-sonnet-5",
)
print(message.content)

 

공식 문서의 예제 코드는 기본값으로 model="claude-opus-4-8"을 쓴다. Sonnet 5를 호출하려면 이 부분만 claude-sonnet-5로 바꾸면 된다. 나머지 코드는 그대로 동작한다.

 

6-3. Sonnet 4.6에서 마이그레이션하기

가장 단순한 마이그레이션은 모델 ID 문자열만 바꾸는 방식이다.

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

 

단, 세 가지는 그냥 넘어가면 막힌다.

 

첫째, 적응형 사고 기본 켜짐이다. Sonnet 4.6에서는 thinking(사고) 필드 없는 요청이 사고 없이 실행됐지만 Sonnet 5에서는 같은 요청이 적응형 사고로 실행된다. 끄고 싶다면 thinking: {type: "disabled"}를 명시해야 한다.

 

둘째, 수동 확장 사고 제거다. budget_tokens를 지정하던 방식은 400 에러로 돌아온다.

# Sonnet 5에서 지원되지 않음 (400 에러)
thinking = {"type": "enabled", "budget_tokens": 32000}

# 대신 이렇게
thinking = {"type": "adaptive"}

 

셋째, 기본값이 아닌 샘플링 파라미터 거부다. temperature, top_p, top_k를 기본값이 아닌 값으로 설정하면 400 에러가 반환된다. Sonnet급 모델에는 처음 적용되는 제약이며, Opus 4.7에서 먼저 도입된 것과 같다.

 

세 항목 모두 얼핏 보면 문법 차이처럼 보이지만 운영 환경에서는 성격이 다르다. 모델 ID 교체는 단순 치환에 가깝지만 thinking 방식과 샘플링 파라미터 제약은 요청 성공 여부를 바꾸는 조건이다. 특히 공용 유틸 함수나 래퍼 SDK에 temperature 같은 값을 관성적으로 넣어 둔 팀이라면, 모델만 갈아끼우고도 배포 직후 400 에러를 맞을 수 있다.

 

실무에서 가장 많이 걸리는 지점: 세 변화 중 두 번째가 가장 흔하다. 기존에 budget_tokens로 추론 강도를 세밀하게 맞춰 둔 파이프라인이 있다면, 마이그레이션 전에 해당 호출부를 effort 파라미터 기반으로 바꿔야 한다. 그대로 두면 요청이 전부 실패한다.

 

6-4. 그 외 알아둘 것

effort(추론 강도) 기본값은 API와 Claude Code 모두 high다. Opus 4.8은 claude.ai를 포함한 모든 표면에서 기본값이 high인 반면, Sonnet 5는 API와 Claude Code에서만 그렇다.

 

공식 prompting 문서에서 추가로 눈여겨볼 부분은 도구 사용 성향이다. Sonnet 5는 Sonnet 4.6보다 더 agentic하게 동작하지만, thinking을 disabled로 끄면 도구 호출이나 검색을 덜 시도할 수 있다. thinking을 끈 상태에서도 도구 사용을 기대한다면 시스템 프롬프트에 "필요하면 검색·도구를 사용하라"는 지시를 명시하는 편이 낫다.

 

반대로 high, xhigh, max effort로 오래 도는 작업에서는 max_tokens를 너무 낮게 잡으면 사고와 도구 호출이 예산을 먼저 써 버리고 최종 답변이 잘릴 수 있다. 이런 경우에는 max_tokens를 올리거나 medium effort로 낮추는 것이 공식 권장에 가깝다.

 

또 하나, assistant message prefilling은 Sonnet 5에서도 지원되지 않는다. 이 제약은 Sonnet 4.6에서 이어진 것이므로, JSON 형식 강제가 필요하면 prefilling 대신 structured outputs, system prompt, output_config.format 같은 대안을 써야 한다.

 

Message Batches API에서는 output-300k-2026-03-24 베타 헤더를 쓰면 최대 300k 출력 토큰까지 지원된다. 평소엔 잘 안 쓰는 옵션이지만 긴 생성 결과를 한 번에 받아야 하는 배치 작업이라면 챙겨둘 만하다.

 

출시 시점 제공 범위는 Claude API(전체 고객), AWS(Claude in Bedrock + Claude Platform on AWS, 단 레거시 Bedrock InvokeModel·Converse는 미지원), Google Cloud(Vertex AI), Microsoft Foundry(프리뷰)다. ZDR(데이터 무보존) 계약 조직도 지원된다.

 

7. Claude.ai 앱·웹에서 쓰는 법

코드를 안 쓰는 독자라면 claude.ai에서 바로 시작하면 된다. Free와 Pro 플랜은 가입 직후부터 Sonnet 5가 기본 모델이라 모델을 따로 고를 필요도 없다.

Projects(프로젝트) 기능을 쓰면 자체 대화 기록과 지식 베이스를 가진 독립 작업공간을 만든다.

문서·텍스트·코드 같은 파일을 업로드해 지식 베이스로 쓰고, 프로젝트 지침(project instructions)으로 응답 스타일을 커스터마이징한다. 무료 사용자는 최대 5개 프로젝트까지 만들 수 있다. 유료 플랜은 RAG(검색 증강 생성) 기술로 대용량 콘텐츠를 자동 확장 처리하며 Team·Enterprise는 조직 공유 기능이 추가된다.

 

Projects는 Sonnet 5 전용 신기능이 아니라 기존 claude.ai 플랫폼 기능이다.

Sonnet 5가 Projects를 "더 잘 쓴다"기보다는, 모델이 바뀌어도 그대로 쓸 수 있는 작업공간이 있다고 이해하는 편이 정확하다.

API의 1M과 채팅 앱의 대화 길이는 다른 숫자다

Claude API와 Claude Code에서 Sonnet 5는 1M 토큰 컨텍스트 윈도우로 동작한다. 반면 claude.ai 채팅 앱의 대화 길이 한도는 유료 플랜 전반 200K 토큰이고 일부 Enterprise 모델만 500K로 더 크다고 안내되어 있다. 이 문서에는 Sonnet 5에 대한 별도 언급이 없어 Sonnet 5 출시 이후 갱신됐는지는 확인되지 않는다. 채팅 앱에서 긴 대화가 막힌다면 API의 1M 토큰과는 다른 한도가 적용된다는 점을 염두에 두는 게 안전하다.

 

그리고 혹시나 Claude Design에서도 Sonnet5가 바로 사용 가능한지 확인 해 보았다. 당연히 클로드 디자인에서도 sonnet5가 바로 적용되어있는것을 확인 할 수 있었다.

 

8. 코딩 에이전트·자동화 파이프라인 적용 — Claude Code와 별칭 함정

Anthropic은 Sonnet 5를 에이전틱 코딩의 실행 계층으로 내세운다.

"Claude Sonnet 5 gives our agents a strong execution layer for multi-step software engineering work; it handles sustained coding, tool use, and debugging well across messy technical contexts. Claude Sonnet 5 sat on real pull requests, and it carried each one through to a tested, verified result on its own. It traces a failure to its actual root cause and ships a durable fix. For day-to-day automation, it's a no-brainer."

(번역: Claude Sonnet 5는 우리 에이전트에게 다단계 소프트웨어 엔지니어링 작업을 위한 강력한 실행 계층을 제공한다. 지속적인 코딩, 툴 사용, 그리고 복잡하고 지저분한 기술적 맥락에서의 디버깅을 잘 처리한다. Claude Sonnet 5는 실제 풀 리퀘스트를 맡아 각각을 테스트를 거쳐 검증된 결과까지 스스로 끝까지 처리했다. 실패의 실제 근본 원인을 추적해 오래 가는 수정을 내놓는다. 일상적인 자동화 작업에는 두말할 것 없이 좋은 선택이다.)

실제 PR을 끝까지 처리했다는 표현은 2장 벤치마크의 SWE-bench Pro 63.2%, Terminal-Bench 80.4%와 같은 맥락이다.

질의응답형 벤치마크가 아니라 "끝까지 검증된 결과까지 도달했는가"를 보는 작업에서 점수가 크게 오른 흐름과 맞물린다.

 

Claude Code에서 Sonnet 5를 쓰려면 v2.1.197 이상이 필요하다(Opus 4.8은 v2.1.154 이상).

Claude Code의 모델 별칭은 입력한 글자가 같아도 어떤 계정·제공자를 쓰느냐에 따라 실제로 호출되는 모델이 다르다.

sonnet 별칭이 제공자마다 다르게 해석된다: Anthropic API에서 sonnet 별칭은 Sonnet 5로 해석된다. 하지만 Claude Platform on AWS에서는 Sonnet 4.6, Bedrock·Vertex·Foundry에서는 Sonnet 4.5로 해석된다. 같은 /model sonnet 명령이라도 어느 제공자를 쓰느냐에 따라 다른 모델이 뜬다.

 

default(기본값) 별칭은 더 까다롭다.

Max, Team Premium, Enterprise 종량제(pay-as-you-go), Anthropic API 사용자는 Claude Code의 기본 모델이 Opus 4.8이다. Pro, Team Standard, Enterprise 구독좌석(subscription seats) 사용자만 기본 모델이 Sonnet 5다 (출처: Claude Code 모델 설정 문서).

 

단, 이 별칭들은 제공자별 권장 버전을 가리키며 시간이 지나면 바뀔 수 있다. 아래 표는 2026-07-01 기준 스냅샷이다.

계정/제공자	default	sonnet	opus
Max / Team Premium / Enterprise 종량제 / Anthropic API	Opus 4.8	Sonnet 5	Opus 4.8
Pro / Team Standard / Enterprise 구독좌석	Sonnet 5	Sonnet 5	Opus 4.8
Claude Platform on AWS	Opus 4.7	Sonnet 4.6	Opus 4.7
Bedrock / Vertex / Foundry	Sonnet 4.5	Sonnet 4.5	Opus 4.6

 

표에서 보듯 claude.ai 채팅 앱에서는 Free·Pro 모두 Sonnet 5가 기본(7장에서 다룬 사실)이지만 Claude Code의 "기본값"은 이 규칙을 따르지 않는다. claude.ai 앱 디폴트와 Claude Code 디폴트를 같은 규칙으로 생각하면 안 된다.

실무 해석 규칙을 하나만 잡으면 이렇다: Claude Code에서 default는 "내 계정에서 지금 가장 먼저 잡히는 모델"이지 "항상 Sonnet 계열"이라는 뜻이 아니다. 반대로 sonnet은 이름은 같아도 제공자에 따라 Sonnet 5가 아닐 수 있다. 비용 예측이든 재현성이든 중요하다면 별칭을 감으로 믿지 말고 /model 결과와 설정 파일을 같이 확인하는 쪽이 안전하다.

Claude Code에서 Sonnet 5는 Anthropic API 기준 언제나 1M 토큰 컨텍스트로 실행되며, 200K 변형이나 [1m] 접미사 선택, 별도 사용 크레딧이 전혀 필요 없다. 세션은 약 967K 토큰에서 자동 압축(auto-compact)된다(기본값, CLAUDE_CODE_AUTO_COMPACT_WINDOW로 조정 가능).

 

다만 LLM gateway를 통해 Claude Code를 라우팅하거나 CLAUDE_CODE_DISABLE_1M_CONTEXT=1로 1M 컨텍스트를 꺼 둔 환경은 예외다. 이런 배포에서는 [1m] 접미사나 별도 환경변수 핀이 의미를 가질 수 있다. 운영 자동화에서는 별칭보다 full model ID와 ANTHROPIC_DEFAULT_SONNET_MODEL 같은 env var로 고정하는 편이 재현성이 좋다.

 

기본 effort는 high이며, fallbackModel 설정 예시에서도 claude-sonnet-5가 1순위로 쓰인다.

"fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]

 

ex) 나의 경우 max 플랜이어서 Default가 Opus 4.8, effort는 High가 default이다.

 

fallbackModel은 메인 모델 요청이 실패하거나 과부하일 때 자동으로 전환할 대체 모델을 지정하는 설정이다. Sonnet 5를 1순위로 두면 Opus 계열이 막혔을 때도 작업이 끊기지 않는다.

 

9. Sonnet 4.6에서 갈아타야 할까

갈아탈지 말지는 결국 두 가지로 갈린다. 작업의 성격과 비용이다.

항목	Sonnet 4.6	Sonnet 5	Opus 4.8
SWE-bench Pro	58.1%	63.2%	69.2%
가격(입력/출력, 9월 이후, MTok)	$3 / $15	$3 / $15	공식 가격 페이지 별도 확인
컨텍스트 윈도우	1M(작은 변형 존재)	1M(고정, 변형 없음)	1M
적응형 사고 기본값	꺼짐	켜짐	켜짐(모든 표면)
Claude Code 기본 모델	해당 없음	계정 유형별 상이(8장)	Max 등 일부 계정 기본

 

표로 보면 순수 성능은 Sonnet 5가 우위고 단가는 9월 이후 동일하다. 하지만 4장에서 짚었듯 토크나이저 변화로 실질 비용은 더 들 수 있다. 점수만 보고 무조건 갈아타면 비용 계산을 건너뛰는 셈이다.

 

여러 커뮤니티에서도(아직 출시한지 얼마 되지 않았지만) Sonnet 5를 "저렴한 Opus 대체재"로만 보면 실망하기 쉽고, "Sonnet 4.6보다 넓어진 agentic 작업 범위"로 보면 쓸 곳이 보인다. effort를 낮게 잡고 쓰는 가벼운 반복 작업이라면 Sonnet 5가 무난하고, 고난도 작업을 high·xhigh·max effort로 오래 돌리는 워크로드라면 Opus 4.8과 실측 비교를 해 보는 게 낫다.

 

Sonnet 4.6에서 급하게 옮길 필요가 없는 경우와 옮기는 게 분명히 이득인 경우는 갈린다.

적응형 사고 기본 켜짐이나 샘플링 파라미터 제약처럼 동작이 바뀌는 부분을 감당할 수 있고, 멀티스텝 에이전트 작업 비중이 크다면 옮기는 쪽이 유리하다. 단발성 질의응답 위주라면 체감 차이가 크지 않을 수 있다.

 

10. 자주 묻는 질문과 결론

Q1. Sonnet 5를 무료로 쓸 수 있나

claude.ai Free 플랜 가입만으로 Sonnet 5가 기본 모델로 제공된다. 다만 무료 플랜의 정확한 일일 사용량 한도는 공식 문서에 구체 수치로 공개되어 있지 않다. 서드파티 추정치만 떠돌 뿐이다. 정확한 한도가 필요하면 가입 후 직접 확인하는 게 정확하다.

 

Q2. API 비용은 어떻게 계산하나

토큰 수 × 단가로 계산하는 기본 공식은 같다. 다만 Sonnet 5는 새 토크나이저 때문에 같은 텍스트가 Sonnet 4.6보다 약 30% 더 많은 토큰으로 계산된다는 점을 넣어야 한다. 9월 이후 단가만 보고 Sonnet 4.6과 같은 비용이 나올 거라 가정하면 실제 청구액과 차이가 날 수 있다.

 

Q3. 기존 코드는 어떻게 옮기나

최소 변경은 모델 ID 문자열 교체뿐이다. budget_tokens로 수동 확장 사고를 쓰던 코드는 thinking: {type: "adaptive"}로 바꿔야 하고 temperature·top_p·top_k를 기본값이 아닌 값으로 설정해 뒀다면 그 설정을 제거해야 한다. 자세한 코드는 6장을 참고한다.

 

Q4. "200K 넘으면 추가 과금된다"는 말이 맞나

한국 커뮤니티 일부에는 "Sonnet이 200K 토큰을 넘기면 입력 $6, 출력 $22.5로 할증된다"는 주장이 돌아다닌다.

 

공식 가격 정책과 대조하면 사실이 아니다

Sonnet 5는 1M 토큰 전체 구간에서 표준 단가가 동일하게 적용된다. 900k 토큰 요청도 9k 토큰 요청과 같은 토큰당 단가로 청구된다 (출처: 공식 가격 페이지). 200K라는 숫자 자체가 Sonnet 5에는 적용되지 않는 기준이다.

 

이전 세대 모델이나 다른 서비스의 정책이 섞여 와전된 것으로 보인다. 출처가 분명하지 않은 가격 정보는 공식 가격 페이지와 대조하는 습관을 들이는 게 좋다.

 

결론

상황	판단
비개발자, 가볍게 시작	Free/Pro 가입만으로 충분 — 별도 설정 불필요
Sonnet 4.6 API 사용 중	모델 ID만 바꾸되 thinking·샘플링 파라미터 코드 점검
Claude Code 상시 사용	계정 유형별 default 별칭부터 확인(8장 표)
비용에 민감	9월 전 도입가 구간에 워크로드 실측, 토큰 증가분까지 계산
한국에서 결제 막힘	해외 결제 가능 카드 확인, 안 되면 비공식 대안은 참고 수준으로

 

오늘 바로 해볼 것 4가지

• Claude API 호출부에서 model 문자열을 claude-sonnet-5로 바꿔 본다
• budget_tokens를 쓰던 thinking 설정이 있다면 type: "adaptive"로 교체한다
• Claude Code 버전이 v2.1.197 이상인지 확인하고 /model로 현재 기본 모델을 확인한다
• 자기 계정 유형이 8장 표의 어디에 해당하는지 확인하고 default 별칭을 맹신하지 않는다

출시 첫 주의 가격·접근성 정보는 빠르게 바뀔 수 있다. 이 글에서 정리한 모델 ID, 가격, 별칭 규칙은 공식 문서 기준이지만 실제 적용 전에는 Claude API 콘솔에서 model="claude-sonnet-5"로 메시지 하나를 직접 보내 응답이 정상적으로 오는지 확인하는 게 가장 빠르다.

---

참고 자료

• Anthropic — Claude Sonnet 5 공식 발표
• Claude Docs — Models overview
• Claude Docs — What's new on Sonnet 5
• Claude Docs — Migration guide
• Claude Docs — Pricing
• Claude Docs — Python SDK
• Claude.ai — Pricing
• Claude Support — Enterprise 플랜 안내
• Claude Support — 결제 FAQ
• Claude Support — 사용량·길이 한도
• Claude Support — Projects 안내
• Claude Code Docs — Model configuration
• MarkTechPost — 벤치마크 비교 기사
• AWS — Claude Sonnet 5 on AWS
• Claude Docs — Prompting Claude Sonnet 5
• X — @ClaudeDevs Sonnet 5 출시 포스트
• Threads — @claudeai Sonnet 5 출시 포스트
• Reddit — r/ClaudeAI Sonnet 5 출시 스레드
• Reddit — Sonnet 5 비용-성능 토론
• Hacker News — Claude Sonnet 5 토론 스레드
• 개인 블로그 — 한국 결제 비공식 팁 (참고용)

작성일: 2026-07-01

분석 대상: Claude Sonnet 5 (모델 ID claude-sonnet-5, 2026-06-30 발표)

가격·플랜·한도 정보는 이후 변경될 수 있다. 최신 내용은 공식 발표 페이지에서 확인하는 게 좋다.