카테고리: IT·활용 팁

Claude Sonnet 5 출시! Claude Code 기본 모델 교체 - 달라진 점과 활용법 총정리 🚀

목차9개 항목

안녕하세요! Mojangcam입니다 😎

지난번에 바이브 코딩(Vibe Coding) 입문 글에서 Claude Code로 AI 코딩 시작하는 법을 소개해드렸는데요, 그 사이에 꽤 큰 소식이 하나 있었어요. 바로 Anthropic이 새 모델 Claude Sonnet 5를 출시했고, 우리가 터미널에서 쓰는 Claude Code의 기본 모델이 Sonnet 5로 교체됐다는 것!

"모델이 바뀌면 나한테 뭐가 달라지는데?" 싶으시죠? 결론부터 말하면 더 똑똑해지고, 더 싸졌고, 컨텍스트가 100만 토큰으로 커졌어요. 오늘은 뭐가 달라졌는지, 내 Claude Code에서 어떻게 확인하고 쓰는지, 업데이트가 안 될 때 해결법까지 한 번에 정리해볼게요!

(실제 /model 화면 — Opus까지 쓸 수 있는 상위 플랜은 기본값(Default)이 Opus 4.8로 떠요. Free·Pro 기준 기본 모델은 Sonnet 5!)

🧩 Claude Sonnet 5, 뭐가 새로워졌나요?

Claude Sonnet 5는 2026년 6월 30일에 출시된 Anthropic의 새 중급(Sonnet급) 모델이에요. 공식 발표 기준 핵심 포인트는 이렇습니다.

  • 역대 가장 에이전틱한 Sonnet: 스스로 계획을 세우고, 브라우저·터미널 같은 도구를 쓰면서 자율적으로 작업을 끝까지 해내는 능력이 크게 올라갔어요. 예전엔 Opus급 모델이 필요했던 수준의 작업을 Sonnet 가격에 할 수 있게 된 거예요.
  • Opus 4.8에 근접한 성능: 전작 Sonnet 4.6 대비 추론·도구 사용·코딩·지식 작업이 전반적으로 크게 개선됐고, 일부 작업에서는 상위 모델인 Opus 4.8을 따라잡아요.
  • 1M(100만) 토큰 컨텍스트 기본 탑재: 별도 옵션 없이 네이티브로 100만 토큰을 지원해요. 웬만한 중형 프로젝트 코드 전체를 한 번에 읽힐 수 있는 크기예요.
  • 안전성 개선: 환각(없는 사실 지어내기)과 아첨성 답변 비율이 Sonnet 4.6보다 낮아졌다고 해요.

하나씩 뜯어볼게요 💡

  • 에이전틱(Agentic) : AI가 한 번 묻고 한 번 답하는 걸 넘어, 스스로 단계를 나눠 도구를 쓰며 작업을 완수하는 성질이에요. Claude Code처럼 파일을 읽고 수정하고 테스트까지 돌리는 도구에서 특히 중요해요.
  • 컨텍스트 윈도우(Context Window) : 모델이 한 번에 기억하고 참고할 수 있는 텍스트 양이에요. 클수록 긴 코드베이스·문서를 통째로 이해시킬 수 있어요.

공개된 벤치마크 수치를 보면 체감이 확 와요. 터미널에서 실제 개발 작업을 시키는 Terminal-Bench 2.1 기준으로 Sonnet 4.6이 67.0%였는데 Sonnet 5는 80.4%까지 뛰었어요. 상위 모델 Opus 4.8(82.7%)과 거의 붙은 수준이에요. 실전 코딩 벤치마크인 SWE-bench Verified에서도 85.2%를 기록했고요.

벤치마크 (공개 수치) Sonnet 5 Sonnet 4.6 Opus 4.8
Terminal-Bench 2.1 (터미널 작업) 80.4% 67.0% 82.7%
SWE-bench Verified (실전 코딩) 85.2% - -
OSWorld (컴퓨터 사용) 81.2% 78.5% -

💰 가격은 오히려 내려갔어요

성능이 올라갔는데 가격이 재밌어요. 2026년 8월 31일까지 프로모션 가격이 적용됩니다.

모델 (API 기준) 입력 (1M 토큰) 출력 (1M 토큰)
Sonnet 5 (프로모션, ~8/31) $2 $10
Sonnet 5 (9/1부터) $3 $15
Opus 4.8 (참고) $5 $25

Opus 4.8 대비 절반 이하 가격으로 근접한 성능을 쓸 수 있는 셈이라, API로 봇이나 자동화를 돌리는 분들께도 좋은 소식이에요. 참고로 Sonnet 5는 토크나이저가 바뀌어서 같은 글도 토큰 수가 약 1.0~1.35배로 잡힐 수 있는데, 프로모션 가격이 이걸 상쇄하도록 설계됐다고 해요. 그리고 claude.ai 웹/앱에서는 무료·Pro 플랜의 기본 모델로 이미 적용돼 있어요!

🛠️ 내 Claude Code에서 Sonnet 5 쓰는 법

이제 실습이에요. Claude Code는 v2.1.197부터 Sonnet 5를 지원하고 기본 모델로 사용해요. 딱 3단계면 됩니다.

📌 1단계 - 내 버전 확인하기

코드
claude --version

여기서 나오는 버전이 2.1.197 미만이면 Sonnet 5가 모델 목록에 아예 안 보여요. 업데이트가 필요합니다.

(실제 실행 결과 — 2.1.197 이상이면 준비 완료예요!)

📌 2단계 - 업데이트하기

코드
# 기본 (네이티브 설치)
claude update

# npm으로 설치한 경우
npm install -g @anthropic-ai/claude-code@latest

여기서 중요한 팁 하나! 업데이트가 끝나면 터미널을 완전히 닫고 새로 여세요. 열려 있던 터미널은 메모리에 옛날 버전을 계속 물고 있어서, 업데이트를 해도 세션에는 반영이 안 되거든요. ("업데이트 됐다는데 왜 그대로지?"의 90%가 이거예요 😅)

📌 3단계 - 모델 확인·전환하기

새 터미널에서 Claude Code를 켜고 /model을 입력하면 모델 선택 화면이 떠요. 이제 Sonnet = Sonnet 5로 표시되고, 예전에 따로 있던 "Sonnet (1M context)" 항목은 사라졌어요. 1M 컨텍스트가 기본 내장이라 더 이상 구분할 필요가 없어졌거든요.

코드
# 세션 안에서
/model            # 선택 화면에서 Sonnet 5 선택 후 Enter → 기본값으로 저장

# 또는 직접 지정
/model claude-sonnet-5

모델을 항상 고정하고 싶다면 이런 방법도 있어요.

코드
# Claude Code v2.1.197+ 기준

# 방법 1: 실행할 때 지정 (한 세션만)
claude --model claude-sonnet-5

# 방법 2: 환경 변수로 지정
export ANTHROPIC_MODEL=claude-sonnet-5
코드
// 방법 3: settings.json에 저장 (영구 설정)
{
  "model": "claude-sonnet-5"
}

모델 ID는 날짜 접미사 없이 claude-sonnet-5이고, 별칭으로 sonnet-5, sonnet도 똑같이 동작해요.

📌 자주 나는 문제 3가지

  1. /model 목록에 Sonnet 5가 안 보여요
    • 원인: Claude Code 버전이 2.1.197 미만
    • 해결: claude update 후 버전 재확인
  2. 업데이트했는데 여전히 옛 버전이에요
    • 원인: ① 터미널이 옛 바이너리를 메모리에 유지 중 ② npm 설치본과 네이티브 설치본이 동시에 깔려 충돌
    • 해결: 터미널 완전 재시작 → 그래도 안 되면 which claude(macOS/리눅스) 또는 where.exe claude(윈도우)로 중복 설치를 찾아 오래된 쪽 제거
  3. 선택은 되는데 "custom model"이라고 떠요
    • 원인: 일부 버전의 표시 버그 (기능에는 문제 없음)
    • 해결: /model claude-sonnet-5로 직접 지정하면 라벨과 무관하게 Sonnet 5로 동작해요

💡 활용 팁 - 이렇게 굴려보세요

  • 큰 프로젝트를 통째로: 1M 컨텍스트 덕분에 "이 프로젝트 전체 구조 파악하고 리팩토링 계획 세워줘" 같은 요청이 훨씬 잘 먹혀요. 디스코드 봇 코드가 파일 수십 개로 불어났어도 OK!
  • 모델 역할 분담: 평소 코딩·반복 작업은 Sonnet 5로 돌리고, 까다로운 설계나 대규모 리뷰만 Opus 4.8로 올리는 조합이 가성비가 좋아요.
  • API 쓰는 분들: 8월 31일까지 프로모션 가격이니, 디스코드 봇에 AI 연동하기 글에서 만든 AI 봇 모델을 claude-sonnet-5로 바꿔서 돌려보세요. 응답 품질 차이가 꽤 느껴질 거예요.

📌 마무리

오늘은 Claude Sonnet 5 출시 소식과 함께, Claude Code에서 새 기본 모델을 확인·전환하는 법까지 정리해봤어요. 요약하면 ① 6월 30일 출시, Opus급 성능을 절반 가격에 ② 1M 컨텍스트 기본 탑재 ③ Claude Code v2.1.197 이상으로 업데이트하고 터미널 재시작만 기억하시면 됩니다!

다음에는 아예 처음부터 따라 하는 Claude Code 입문 가이드(터미널 AI 코딩 에이전트)를 준비하고 있어요. Sonnet 5로 달라진 Claude Code, 제대로 써보고 싶은 분들은 기대해주세요 🙌

📚 함께 보면 좋은 글

글쓴이

Mojangcam

직접 코드를 짜고, 서버를 돌리고, 막힌 에러를 해결하며 배운 것들을 기록하는 개발·IT 실전 기록 블로그