---
title: Claude Sonnet 5.5의 새로운 기능
url: https://platform.claude.com/docs/ko/models/sonnet-5-5/whats-new-sonnet-5-5
description: "Claude Sonnet 5에서 Claude Sonnet 5.5로 전환할 때 달라지는 점: 호환성이 깨지는 변경 사항, 기능 지원, 동작 차이, 가격 및 가용성."
---
Claude Sonnet 5.5는 속도와 지능의 최상의 조합을 제공합니다. 다섯 가지 호환성을 깨는 변경 사항(breaking change)이 이미 Claude Sonnet 5에서 실행 중인 코드에 영향을 줄 수 있습니다:
* [`between_tools`로 사전 사고 끄기](https://platform.claude.com/docs/ko/models/sonnet-5-5/whats-new-sonnet-5-5#turn-off-up-front-thinking).
* [강제 도구 사용은 오류를 반환합니다](https://platform.claude.com/docs/ko/models/sonnet-5-5/whats-new-sonnet-5-5#forced-tool-use-is-not-supported).
* [사고 블록은 모델 및 대화에 연결됩니다](https://platform.claude.com/docs/ko/models/sonnet-5-5/whats-new-sonnet-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them).
* [일부 컴퓨터 사용 도구 버전은 지원되지 않습니다](https://platform.claude.com/docs/ko/models/sonnet-5-5/whats-new-sonnet-5-5#computer-20251124-is-not-supported).
* [어드바이저 도구는 네 가지 모델을 어드바이저로 거부합니다](https://platform.claude.com/docs/ko/models/sonnet-5-5/whats-new-sonnet-5-5#advisor-tool-pairings): Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5, Claude Haiku 5.5.
요청을 실패시키지는 않지만 응답 형태를 바꾸는 변경 사항이 하나 더 있습니다: [도구 호출 사이의 텍스트가 `thinking` 블록으로 반환됩니다](https://platform.claude.com/docs/ko/models/sonnet-5-5/whats-new-sonnet-5-5#text-between-tool-calls). 해당 텍스트를 사용자에게 스트리밍하는 애플리케이션은 텍스트를 반환하는 `display` 값을 설정하거나 `between_tools`로 사전 사고를 끌 때까지 도구 호출 사이에 아무것도 표시하지 않게 됩니다.
## 새 모델
| 모델 | Claude API ID | 설명 |
| ----------------- | ----------------- | -------------- |
| Claude Sonnet 5.5 | claude-sonnet-5-5 | 속도와 지능의 최상의 조합 |
[적응형 사고](https://platform.claude.com/docs/ko/build-with-claude/thinking)는 기본적으로 켜져 있으며, [노력 수준 매개변수](https://platform.claude.com/docs/ko/build-with-claude/effort)가 사고 깊이를 제어합니다. Claude API에서의 기본값은 `high`입니다. 토크나이저는 Claude Sonnet 5와 동일하므로 같은 텍스트는 같은 토큰 수를 생성합니다. 컨텍스트 윈도우, 출력 한도, 지식 컷오프 및 가격은 [Claude Sonnet 5.5](https://platform.claude.com/docs/ko/models/sonnet-5-5/overview) 모델 페이지를 참조하세요.
모든 현재 모델은 [모델 개요](https://platform.claude.com/docs/ko/models/overview)를 참조하세요.
## 호환성이 깨지는 변경 사항
### `between_tools`로 사전 사고 끄기
Claude Sonnet 5.5에서 사전 사고를 끄려면 `"disabled"` 대신 `thinking: {"type": "between_tools"}`를 보내세요. 이것이 이 모델에서 가장 낮은 사고 설정입니다. Claude Sonnet 5.5를 제공하는 모든 플랫폼에서 사용할 수 있습니다. 모델이 도구 호출 사이에 작성하는 짧은 [진행 상황 업데이트](https://platform.claude.com/docs/ko/build-with-claude/thinking#progress-updates)는 여전히 요약 텍스트와 함께 `thinking` 블록으로 반환됩니다. 해당 블록은 어시스턴트 턴의 나머지 부분과 함께 변경하지 않고 다시 전달하세요. 다시 보내는 진행 상황 업데이트 블록은 요약이 아닌 모델이 작성한 전체 메모를 모델에 제공합니다. 요청에서 도구를 사용하지 않는 경우, Claude Sonnet 5에서 `disabled`를 사용할 때와 마찬가지로 응답에는 텍스트만 포함됩니다.
Claude Sonnet 5.5에서 `thinking: {"type": "disabled"}`를 보내는 요청은 `between_tools`를 안내하는 메시지와 함께 400 `invalid_request_error`를 반환합니다.
`between_tools`는 `low`, `medium`, `high` 노력 수준에서 허용됩니다. `xhigh` 또는 `max` 노력 수준에서는 `between_tools`를 사용한 요청이 400 오류를 반환합니다. `xhigh` 또는 `max`로 실행하려면 적응형 사고를 사용하세요: `thinking` 필드를 생략하거나, 이와 동일한 `thinking: {"type": "adaptive"}`를 보내면 됩니다. `between_tools`를 사용하면 대화 도중에 노력 수준을 변경할 수 없습니다: 적용 중인 수준과 다른 [메시지별 `output_config.effort`](https://platform.claude.com/docs/ko/build-with-claude/effort-per-message)는 400 오류를 반환합니다. 턴마다 노력 수준을 달리하려면 적응형 사고를 사용하세요.
`between_tools`는 다른 필드를 받지 않습니다: 함께 보낸 `display`, `budget_tokens` 또는 `block_binding`은 400 오류를 반환합니다. 수동 사고 예산(`thinking: {"type": "enabled", "budget_tokens": N}`)은 400 오류를 반환합니다. [사고](https://platform.claude.com/docs/ko/build-with-claude/thinking) 및 마이그레이션 가이드의 [사전 사고 끄기](https://platform.claude.com/docs/ko/models/sonnet-5-5/migration-guide#turn-off-up-front-thinking)를 참조하세요.
### 강제 도구 사용은 지원되지 않습니다
Claude Sonnet 5.5는 “forced tool use”(강제 도구 사용)를 지원하지 않습니다. `tool_choice`를 `{"type": "any"}` 또는 `{"type": "tool", "name": "..."}`로 설정하면 400 `invalid_request_error`가 반환됩니다:
```text wrap
tool_choice: type "tool" and "any" are not supported for this model.
```
`tool_choice: {"type": "auto"}`(기본값)와 `{"type": "none"}`은 지원됩니다. 동일한 검사가 [토큰 계산](https://platform.claude.com/docs/ko/build-with-claude/token-counting) 엔드포인트에도 적용됩니다. 스키마에 유효한 도구 입력이 필요하면 `tool_choice: {"type": "auto"}`를 유지하고 [엄격한 도구 사용](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/strict-tool-use)으로 `strict: true`를 설정하거나, 스키마를 [구조화된 출력](https://platform.claude.com/docs/ko/build-with-claude/structured-outputs)으로 옮기세요. 모델이 텍스트로 답하는 대신 도구를 호출하도록 하려면 프롬프트에서 도구가 적용되는 경우를 명시하세요. 마이그레이션 가이드의 [강제 도구 사용은 지원되지 않습니다](https://platform.claude.com/docs/ko/models/sonnet-5-5/migration-guide#forced-tool-use) 섹션에서 변경 전후를 확인할 수 있습니다.
### 사고 블록은 모델 및 대화에 연결됩니다
모든 사고 블록은 어떤 모델이 생성했는지를 기록합니다. 모델을 전환하는 대화는 전환 대상 모델이 이전 모델의 사고 블록을 읽을 수 있는 경우에만 이전 추론을 유지합니다:
| 전환 | 추론 유지 여부 |
| ---------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| Claude Sonnet 5 이하, Claude Opus 4.8 이하 또는 Claude Haiku 4.5 이하에서 Claude Sonnet 5.5로 | 예 |
| Claude Haiku 5.5에서 Claude Sonnet 5.5로 | 예, Claude API 및 Claude Models on Google Cloud (Google managed)에서만 |
| 그 밖의 모든 모델에서 Claude Sonnet 5.5로 | 아니요 |
| Claude Sonnet 5.5에서 Claude Opus 5.5, Claude Fable 5.2 또는 Claude Mythos 5.2로 | 예, Claude API 및 Claude Models on Google Cloud (Google managed)에서만 |
| Claude Sonnet 5.5에서 그 밖의 모든 모델로 | 아니요 |
요청에 대상 모델이 읽을 수 없는 블록이 포함되어 있으면 API는 모델이 이를 받기 전에 해당 블록을 제외합니다. 요청은 성공하며, 제외된 블록에는 요금이 부과되지 않습니다. `thinking-binding-controls-2026-08-01` 베타 헤더를 사용하면 API는 최상위 `input_transformations` 배열에 이 제외를 보고합니다. [모델을 전환했다가 되돌아오기](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking#switching-models)를 참조하세요. Claude Sonnet 5.5가 관련되지 않은 전환은 [Claude API에서 추론을 유지하는 모델 전환](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking#which-model-switches-keep-reasoning)을 참조하세요.
API는 또한 모델이 Claude Sonnet 5.5 사고 블록을 생성한 이후 해당 블록 앞에 있는 내용이 변경되었는지 확인합니다. 이 접두사 검사는 `system` 프롬프트, `tools` 및 모든 이전 메시지를 대상으로 합니다. 대화는 추가 전용(append-only)으로 유지하세요. 지침이나 도구를 변경할 때는 편집 대신 [대화 중간 시스템 메시지](https://platform.claude.com/docs/ko/build-with-claude/mid-conversation-system-messages)를 사용하세요.
[“prefix check”(접두사 검사)](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking/prefix-checks#prefix-check)를 통과하지 못하면 [400 오류](https://platform.claude.com/docs/ko/api/errors#thinking-block-conversation-mismatch)가 발생할 수도 있고 발생하지 않을 수도 있습니다. 두 경우를 모두 식별하고 처리하려면 [사고 블록에 대한 접두사 검사](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking/prefix-checks)를 참조하세요.
접두사 검사는 Claude API 및 [일부 클라우드 플랫폼](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking#feature-availability)에서 실행됩니다.
[보존된 사고](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking) 및 마이그레이션 가이드의 [사고 블록에 관한 참고 사항](https://platform.claude.com/docs/ko/models/sonnet-5-5/migration-guide#thinking-blocks)을 참조하세요.
### 일부 컴퓨터 사용 도구 버전은 지원되지 않습니다
Claude Sonnet 5.5는 `computer_toolset_20260801` 도구 세트를 통해 [컴퓨터 사용](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/computer-use-tool)을 지원합니다. Amazon Bedrock에서는 Claude Sonnet 5.5가 `computer-use-2025-11-24` 베타 헤더와 함께 `computer_20251124` 도구도 허용합니다. Claude Sonnet 5.5는 Claude API의 `computer_20251124`처럼 허용하지 않는 컴퓨터 사용 도구 버전에 대해 400 오류를 반환합니다. Claude API의 `invalid_request_error` 메시지는 거부된 유형을 명시하고, `Did you mean one of` 뒤에 모델이 허용하는 도구 유형을 나열합니다. 메시지는 다음과 같이 시작합니다:
```text wrap
'claude-sonnet-5-5' does not support tool types: computer_20251124.
```
도구 세트를 사용하는 통합은 변경할 필요가 없습니다. `computer_20251124` 통합을 도구 세트로 옮기려면 변경 전후의 요청을 보여 주는 [`computer_20251124`에서 마이그레이션](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124)을 따르세요. 베타 헤더를 제거하고 `tools` 항목을 `{"type": "computer_toolset_20260801"}`로 바꾸세요. 그런 다음 멤버 `tool_use` 블록, 일괄 작업, 결과의 `toolset_name`에 맞게 에이전트 루프를 업데이트하세요.
### 일부 어드바이저 도구 조합은 지원되지 않습니다
[어드바이저 도구](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/advisor-tool)는 베타로 제공됩니다. Claude Sonnet 5.5 실행자는 다음 어드바이저만 허용합니다:
* Claude Mythos 5.2 및 Claude Fable 5.2
* Claude Mythos 5.1 및 Claude Fable 5.1
* Claude Mythos 5 및 Claude Fable 5
* Claude Opus 5.5 및 Claude Opus 5
* Claude Sonnet 5.5 자체
Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5, Claude Haiku 5.5 어드바이저는 Claude Sonnet 5 실행자와 작동합니다. Claude Sonnet 5.5 실행자와 함께 사용하면 400 `invalid_request_error`를 반환합니다. Claude Sonnet 5.5가 허용하는 모든 어드바이저는 조언을 `advisor_redacted_result` 블록으로 암호화하여 반환합니다. 따라서 클라이언트는 조언 텍스트를 읽을 수 없습니다. 어드바이저 도구의 [모델 호환성](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/advisor-tool#model-compatibility) 및 [결과 변형](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/advisor-tool#result-variants)을 참조하세요.
## 기능 지원
Claude Sonnet 5.5는 다음 기능을 지원합니다:
* [메시지별 effort](https://platform.claude.com/docs/ko/build-with-claude/effort-per-message)(베타로 제공)
* [대화 중간 시스템 메시지](https://platform.claude.com/docs/ko/build-with-claude/mid-conversation-system-messages)
* [대화 중간 도구 변경](https://platform.claude.com/docs/ko/build-with-claude/mid-conversation-system-messages#mid-conversation-tool-changes)(베타로 제공)
* 최소 캐시 가능 프롬프트가 512 토큰인 [프롬프트 캐싱](https://platform.claude.com/docs/ko/build-with-claude/prompt-caching)
* [배치 처리](https://platform.claude.com/docs/ko/build-with-claude/batch-processing)
* [Files API](https://platform.claude.com/docs/ko/build-with-claude/files)
* [PDF 지원](https://platform.claude.com/docs/ko/build-with-claude/pdf-support)
* [비전](https://platform.claude.com/docs/ko/build-with-claude/vision)
* 서버 측 및 클라이언트 측 도구([Claude와 함께하는 도구 사용](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/overview) 참조)
Claude Sonnet 5는 메시지별 effort, 대화 중간 시스템 메시지, 대화 중간 도구 변경을 지원하지 않습니다. Claude Sonnet 5에서는 최소 캐시 가능 프롬프트가 1,024 토큰입니다. 모델별 사용 가능 여부는 각 기능 페이지를 참조하세요.
### 필요 시 압축 (베타)
`compact-2026-09-04` 베타 헤더를 사용하면, 최상위 `compaction` 매개변수를 보내는 요청은 해당 요청의 메시지를 요약한 서명된 `compaction` 블록을 반환합니다. 이후 요청에서는 해당 블록이 요약한 메시지 대신 `messages`의 맨 앞에 위치합니다. 압축 시점과 블록 뒤에 유지할 턴은 직접 선택합니다. Claude Sonnet 5.5에서는 유지된 턴의 사고 블록이 압축 후에도 유효하게 유지될 수 있습니다. 조건은 [압축과 보존된 사고](https://platform.claude.com/docs/ko/build-with-claude/compaction-thinking-blocks#conditions-for-kept-thinking-to-stay-valid)를 참조하세요. 플랫폼 가용성과 전체 요청 흐름은 [필요 시 압축](https://platform.claude.com/docs/ko/build-with-claude/compaction-on-demand)을 참조하세요.
### 메시지에서 도구 정의하기 (베타)
`inline-tools-2026-09-15` 베타 헤더를 사용하면, 대화 중간 시스템 메시지의 `tool_addition` 블록에 참조 대신 전체 도구 정의를 담을 수 있습니다. `tools`를 편집하거나 프롬프트 캐시를 잃지 않고도 대화 도중에 도구를 추가하거나, 스키마를 변경하거나, 서버 도구를 최신 버전으로 옮길 수 있습니다. [메시지에서 도구 정의하기](https://platform.claude.com/docs/ko/build-with-claude/mid-conversation-system-messages#define-tools-in-a-message-beta)를 참조하세요.
### 사고 블록은 이를 생성한 계정에 귀속됩니다
Claude Sonnet 5.5가 생성한 사고 블록은 이를 생성한 계정 또는 해당 계정에 연결된 계정에서만 작동합니다. 다른 계정이 이러한 블록을 보내면, API는 모델이 받기 전에 블록을 제외하고 요청은 성공합니다. Claude Haiku 5.5, Claude Fable 5.2, Claude Mythos 5.2의 블록도 동일한 규칙을 따릅니다.
Claude API 및 Claude Models on Google Cloud (Google managed)에서는 어떤 블록이 제외되었는지 확인할 수 있습니다. `thinking-binding-controls-2026-08-01` 베타 헤더를 보내면, 응답은 제외된 각 블록을 `reason: "organization_binding_mismatch"`와 함께 `input_transformations`에 나열합니다. [계정 및 클라우드 플랫폼](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking#account-bound-thinking)을 참조하세요.
## 동작 차이
다음 각 항목에 대한 지침은 [Claude Sonnet 5.5 프롬프팅](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-sonnet-5-5)을 참조하세요. Claude Sonnet 5.5는 코드 변경 없이도 드러나는 다음과 같은 방식에서 Claude Sonnet 5와 다릅니다:
* **노력 수준이 재조정되었습니다.** [노력 수준](https://platform.claude.com/docs/ko/build-with-claude/effort)은 Claude Sonnet 5에서와 같은 양의 사고를 생성하지 않습니다. 설정을 그대로 가져오지 말고 노력 수준 스윕을 다시 실행하세요. 워크로드가 에이전트형이거나 지연 시간에 민감한 경우가 아니라면 `high`로 시작하세요. 에이전트형 코딩 및 다단계 도구 사용의 경우, 명확하게 정의된 작업은 `medium`으로 시작하고 더 어렵거나 긴 작업은 `high`로 올리세요. 채팅 및 기타 지연 시간에 민감한 작업은 `medium` 또는 `low`로 시작하세요.
* **도구 호출 사이의 텍스트가 사고 블록으로 반환됩니다.** 도구 호출 사이에서 한두 문장보다 긴 메모는 [진행 상황 업데이트 `thinking` 블록](https://platform.claude.com/docs/ko/build-with-claude/thinking#progress-updates)으로 반환됩니다. 더 짧은 언급은 `text`로 유지됩니다. 기본값인 `display: "omitted"`에서는 진행 상황 업데이트 블록의 텍스트가 비어 있으므로, 이러한 메모를 사용자에게 스트리밍하는 애플리케이션은 오류 없이 도구 호출 사이에 아무것도 표시하지 않게 됩니다. [`between_tools`로 사전 사고를 끄면](https://platform.claude.com/docs/ko/models/sonnet-5-5/whats-new-sonnet-5-5#turn-off-up-front-thinking) 텍스트가 다시 반환됩니다. 이를 받으려면 마이그레이션 가이드의 [도구 호출 사이의 텍스트는 사고 블록으로 반환됩니다](https://platform.claude.com/docs/ko/models/sonnet-5-5/migration-guide#text-between-tool-calls)를 참조하세요.
* **보호 장치 카테고리.** 모델의 보호 장치는 다섯 가지 [`stop_details` 카테고리](https://platform.claude.com/docs/ko/build-with-claude/refusals-and-fallback#refusal-response)로 요청을 거절할 수 있습니다. `"cyber"`는 요청이 사이버 피해를 야기할 수 있음을 의미합니다. `"bio"`는 생물학적 피해를 야기할 수 있음을 의미합니다. `"frontier_llm"`은 경쟁 AI 모델 개발에 도움이 될 수 있음을 의미합니다. `"reasoning_extraction"`은 모델에게 내부 추론을 응답 텍스트에 재현하도록 요청함을 의미합니다. `"general_harms"`는 다른 사용 정책 영역에 해당함을 의미합니다. [거절, 폴백 및 요금 청구](https://platform.claude.com/docs/ko/models/sonnet-5-5/whats-new-sonnet-5-5#refusals-fallback-and-billing)를 참조하세요.
## 거절, 폴백 및 요금 청구
[거절 및 폴백](https://platform.claude.com/docs/ko/build-with-claude/refusals-and-fallback)의 모든 내용이 Claude Sonnet 5.5에 적용됩니다. 거절된 요청은 `stop_reason: "refusal"` 및 정책 영역을 명시하는 [`stop_details`](https://platform.claude.com/docs/ko/build-with-claude/refusals-and-fallback#refusal-response) 객체와 함께 HTTP 200을 반환합니다.
코드에서 거절을 처리하고, 폴백을 구성하세요. [서버 측 폴백](https://platform.claude.com/docs/ko/build-with-claude/refusals-and-fallback#server-side-fallback)(`fallbacks: "default"`)을 사용하면 `"cyber"` 또는 `"frontier_llm"` 카테고리에서 거절된 요청이 Claude Sonnet 5에서 다시 실행됩니다. `"bio"`, `"reasoning_extraction"` 또는 `"general_harms"` 카테고리에서 거절된 요청은 재시도되지 않습니다. 서버 측 폴백은 Claude API 및 [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/anthropic-managed)에서 베타로 제공됩니다. [SDK 미들웨어](https://platform.claude.com/docs/ko/build-with-claude/refusals-and-fallback#client-side-fallback)나 자체 재시도를 사용할 수도 있습니다.
출력 전에 발생한 거절은 일부 거절 카테고리에서는 요금이 부과되고 다른 카테고리에서는 부과되지 않습니다. 어느 경우든 속도 제한에 포함됩니다. [거절에 대한 요금 청구 방식](https://platform.claude.com/docs/ko/build-with-claude/refusals-and-fallback#how-refusals-are-billed)을 참조하세요.
## 가격
Claude Sonnet 5.5는 프롬프트 캐시 읽기를 제외하고 Claude Sonnet 5와 가격이 같습니다. 프롬프트 캐시 읽기는 백만 토큰당 $0.10 USD로, Claude Sonnet 5 요금의 절반입니다. 전체 목록, 데이터 레지던시 및 도구 가격은 [가격](https://platform.claude.com/docs/ko/about-claude/pricing)을 참조하세요.
## 가용성
Claude Sonnet 5.5는 다음에서 사용할 수 있습니다:
* **Claude API:** 모든 고객, `claude-sonnet-5-5`로 사용
* **AWS:** [Amazon Bedrock의 Claude](https://platform.claude.com/docs/ko/build-with-claude/claude-in-amazon-bedrock)에서 `anthropic.claude-sonnet-5-5`로, [Claude Platform on AWS](https://platform.claude.com/docs/ko/build-with-claude/claude-platform-on-aws)에서 `claude-sonnet-5-5`로 사용
* **Google Cloud:** [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/anthropic-managed)에서 `claude-sonnet-5-5`로, [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed)에서 `claude-sonnet-5-5`로 사용
* **Microsoft Foundry:** [Microsoft Foundry의 Claude](https://platform.claude.com/docs/ko/build-with-claude/claude-in-microsoft-foundry)에서 `claude-sonnet-5-5`로 사용
## Claude Sonnet 5에서 마이그레이션
모델 ID를 업데이트하세요:
```python Python
model = "claude-sonnet-5" # Before
model = "claude-sonnet-5-5" # After
```
```typescript TypeScript
let model = "claude-sonnet-5"; // Before
model = "claude-sonnet-5-5"; // After
```
```csharp C#
var model = Model.ClaudeSonnet5; // Before
model = Model.ClaudeSonnet5_5; // After
```
```go Go
model := anthropic.ModelClaudeSonnet5 // Before
model = anthropic.ModelClaudeSonnet5_5 // After
```
```java Java
Model model = Model.CLAUDE_SONNET_5; // Before
model = Model.CLAUDE_SONNET_5_5; // After
```
```php PHP
$model = Model::CLAUDE_SONNET_5; // Before
$model = Model::CLAUDE_SONNET_5_5; // After
```
```ruby Ruby
model = Anthropic::Model::CLAUDE_SONNET_5 # Before
model = Anthropic::Model::CLAUDE_SONNET_5_5 # After
```
그런 다음 여섯 가지 사항을 확인하세요:
1. 코드에서 `disabled`로 사고를 끄고 있다면, 대신 `high` 이하의 effort에서 `between_tools`를 보내세요.
2. `tool_choice` 유형 `any`와 `tool`을 `auto`와 [엄격한 도구 사용](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/strict-tool-use)으로 대체하세요.
3. 대화는 추가 전용(append-only)으로 유지하세요. 이전 기록을 편집한 후 Claude Sonnet 5.5 사고 블록을 다시 재생하는 요청은 400 오류를 반환할 수 있습니다. [사고 블록은 모델 및 대화에 연결됩니다](https://platform.claude.com/docs/ko/models/sonnet-5-5/whats-new-sonnet-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them)를 참조하세요.
4. `computer_20251124`를 통해 컴퓨터 사용을 사용한다면, [도구 세트로 이동하세요](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124). Amazon Bedrock에서는 `computer_20251124`도 작동합니다.
5. Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 또는 Claude Haiku 5.5 어드바이저와 함께 어드바이저 도구를 사용한다면, [Claude Sonnet 5.5가 허용하는 어드바이저로 전환하세요](https://platform.claude.com/docs/ko/models/sonnet-5-5/whats-new-sonnet-5-5#advisor-tool-pairings).
6. 인터페이스에서 도구 호출 사이의 텍스트를 표시한다면, 적응형 사고를 사용할 때 `thinking.display`를 설정하세요. `between_tools`를 사용하면 해당 설정 없이도 텍스트가 반환됩니다. [도구 호출 사이의 텍스트는 사고 블록으로 반환됩니다](https://platform.claude.com/docs/ko/models/sonnet-5-5/migration-guide#text-between-tool-calls)를 참조하세요.
[Claude Sonnet 5.5 마이그레이션 가이드](https://platform.claude.com/docs/ko/models/sonnet-5-5/migration-guide)에는 Claude Sonnet 5 및 이전 모델에서의 단계별 지침과 전체 체크리스트가 있습니다.
## 다음 단계
모든 현재 Claude 모델의 전체 사양 및 가격.
Claude Sonnet 5 및 이전 모델의 코드를 Claude Sonnet 5.5로 이전하세요.
Claude Sonnet 5.5에 특화된 동작 차이 및 프롬프팅 패턴.
Claude가 응답할 때 사용하는 토큰 양을 low부터 max까지 제어하세요.
적응형 사고의 작동 방식과 사고 블록이 보존되는 방식.
`stop_reason: "refusal"`을 처리하고 다른 모델에서 재시도하세요.