Claude Sonnet 5.5 공개, 개발자를 위한 사용 가이드

• Anthropic이 Claude Sonnet 5.5 를 공개하고, 모델 선택과 마이그레이션, Claude Code 사용법을 담은 개발자 가이드를 함께 발표함

• Sonnet 5 대비 약 30% 빠르고, 같은 작업에 토큰을 훨씬 적게 써서 비용도 최대 30% 절감됨

• 토큰당 가격은 Sonnet 5와 동일하며, adaptive thinking이 기본으로 켜져 있음

Sonnet 5.5와 Opus 5.5 선택 기준

• Sonnet 5.5가 적합한 작업

  • 명세가 분명하고 결과를 검증할 방법이 있는 작업

  • 버그 수정, 기능 반복 개발, 일상적인 대량 개발

  • 문서, 슬라이드, 스프레드시트 작업

• Opus 5.5가 적합한 작업

  • 복잡한 판단이 필요한 작업

  • 난이도가 가장 높고 오래 걸리는 문제

가격 (100만 토큰당)

주요 사양

• 모델 ID: claude-sonnet-5-5

• 컨텍스트 윈도우 1M 토큰, 최대 출력 128k 토큰 (Batch API는 300k)

• 지식 기준일 2026년 6월

• effort 단계: low, medium, high, xhigh, max (API 기본값 high)

• 최소 캐시 길이가 512 토큰 으로 줄어 짧은 시스템 프롬프트와 도구 정의도 캐싱 가능

활용 팁

• effort는 작업 종류에 맞춰 선택

  • 일반 API 작업은 기본값 high 로 시작

  • 명세가 분명한 에이전트 코딩과 여러 단계 도구 사용은 medium, 어렵거나 길면 high

  • 채팅처럼 응답 속도가 중요한 작업은 medium 또는 low

  • xhigh, max 는 품질 향상을 직접 측정한 경우에만 권장

  • effort 단계가 재조정되어 Sonnet 5 설정을 그대로 가져오면 안 되며, 다시 맞춰 봐야 함

  • 생각을 줄이려면 프롬프트로 요청하지 말고 effort를 낮춰야 함

  • 대화 중 최상위 effort를 바꾸면 프롬프트 캐시가 깨지므로, 메시지 단위 effort 변경(베타)으로 어려운 질문만 올리는 방식이 효율적임

• max_tokens 는 넉넉하게

  • 사고 토큰도 max_tokens 에 포함됨

  • 에이전트 코딩은 최대치인 128,000으로 두고 스트리밍으로 받는 것을 권장

• 낮은 effort에서는 끝까지 하도록 지시

  • low, medium 에서는 긴 작업 도중 멈추고 확인을 구하는 경우가 있음

  • 반대로 요청하지 않은 테스트, 문서, 보조 파일을 덧붙이는 경향도 있음

  • 공식 문서에서 제안하는 시스템 프롬프트

Keep working until everything the user asked for is done, and only stop to ask when you can't go on without the user or before a risky step.

When the work the user asked for is done and checked, stop and report. Don't add features, tests, files, docs or refactors that weren't asked for. If you think one would help, mention it at the end instead of doing it.

• 코드 수정 후 실제 검증을 요구

  • low 에서는 테스트나 빌드 없이 완료라고 보고하는 경우가 있음

  • 테스트, 타입 체크, 빌드 중 실제로 도는 검사를 하고 보고하라는 지시를 넣으면 거의 사라지고, 비용은 조금만 늘어남

• xhigh, max 에서는 과잉 검토를 차단

  • 작업이 끝난 뒤에도 스스로 리뷰를 반복하거나 리뷰 서브에이전트를 띄우는 경향이 있음

  • "검사가 통과하면 멈추고 보고하라"는 지시만으로 품질 변화 없이 비용이 약 3분의 1 감소

• 아이디어만 원하면 명시

  • "이걸로 뭘 할 수 있는지 보여줘" 같은 열린 요청에 바로 보고서나 발표 자료를 만들기 시작할 수 있음

• 최신 정보는 검색하게 지시

  • 가격, 규정처럼 바뀌었을 수 있는 내용도 학습 지식으로 답하는 경우가 있음

  • "확신이 있어도 최신 정보는 검색으로 확인하라"를 넣고, "도구는 꼭 필요할 때만" 같은 문구는 제거

• JSON으로 받는 추론 작업

  • 계산이나 순위 매기기처럼 몇 단계 생각이 필요한 작업에서 생각 없이 바로 답해 틀리기 쉬움

  • 시스템 프롬프트 끝에 Think the problem through before you answer. 한 줄을 넣으면 high 에서 xhigh 에 가까운 정확도를 보임

• 복잡한 차트나 도면에는 도구 제공

  • 이미지를 자르거나 확대하는 도구를 주면 훨씬 정확하게 읽음

  • 차트는 도구를 준 high 가 도구 없는 max 보다 정확했고 비용은 훨씬 적었음

• 추론 과정을 본문에 쓰라고 요청하지 말 것

  • reasoning_extraction 카테고리로 거절될 수 있음

  • 과정이 필요하면 thinking.display: "summarized" 로 요약된 사고를 받아서 확인

Sonnet 5에서 마이그레이션

• 사전 사고를 끌 때 {"type": "disabled"} 대신 {"type": "between_tools"} 사용 (high 이하 effort만 지원)

• tool_choice 의 any, tool 은 사용 불가, auto 와 strict: true 도구 로 대체하고 모든 객체에 additionalProperties: false 필요

• 대화 기록은 append only로 유지하며, Sonnet 5의 사고 블록도 그대로 읽음

• computer use는 computer_toolset_20260801 도구로 바뀌었고 베타 헤더 불필요

• advisor는 Opus 5.5, Opus 5, Sonnet 5.5만 조합 가능하며 조언 결과는 암호화되어 전달됨

• Sonnet 5용으로 넣었던 우회 처리(거부 유도 회피, 도구 호출 재시도 등)는 제거해도 됨

Claude Code에서 사용

• v2.1.284부터 sonnet 별칭이 Sonnet 5.5를 가리킴

• /model sonnet 으로 전환하며 기본 effort는 medium

• 사고는 끌 수 없고 effort로만 조절, Fast mode는 미지원

• /claude-api migrate this project to claude-sonnet-5-5 로 기존 프로젝트 마이그레이션을 맡길 수 있음

제공 플랫폼

• Claude API, Google Cloud, Microsoft Foundry: claude-sonnet-5-5

• Amazon Bedrock: anthropic.claude-sonnet-5-5

원문: Building with Claude Sonnet 5.5, Prompting Claude Sonnet 5.5