---
title: Claude Opus 5.5의 새로운 기능
url: https://platform.claude.com/docs/ko/models/opus-5-5/whats-new-opus-5-5
description: Claude Opus 5.5의 호환성이 깨지는 변경 사항, 기능 지원 및 동작 차이에 대한 개요입니다.
---

Claude Opus 5.5는 장시간 실행되는 "agentic coding"(에이전트 코딩) 및 지식 작업을 위해 만들어졌으며, 가격은 입력/출력 토큰 100만 개당 $4 / $20 USD입니다. 이미 Claude Opus 5에서 실행 중인 코드에는 네 가지 "breaking change"(호환성이 깨지는 변경 사항)가 영향을 미칩니다. [사고를 비활성화할 수 없음](https://platform.claude.com/docs/ko/models/opus-5-5/whats-new-opus-5-5#thinking-cant-be-disabled), [강제 도구 사용 시 오류 반환](https://platform.claude.com/docs/ko/models/opus-5-5/whats-new-opus-5-5#forced-tool-use-is-not-supported), [사고 블록이 모델 및 대화에 연결됨](https://platform.claude.com/docs/ko/models/opus-5-5/whats-new-opus-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them), 그리고 Claude API 및 Google Cloud에서 [이전 `computer_20251124` 컴퓨터 사용 도구가 허용되지 않음](https://platform.claude.com/docs/ko/models/opus-5-5/whats-new-opus-5-5#computer-20251124-is-not-supported)입니다. 처음 세 가지는 Claude Fable 5.1에도 적용됩니다. 또 다른 변경 사항은 요청을 실패시키지 않으면서 응답 형태를 바꿉니다. [도구 호출 사이의 텍스트가 `thinking` 블록으로 반환](https://platform.claude.com/docs/ko/models/opus-5-5/whats-new-opus-5-5#text-between-tool-calls)되며, 기본 `display` 설정에서는 이 블록의 텍스트가 비어 있습니다. 이 텍스트를 진행 상황 업데이트로 사용자에게 스트리밍하는 애플리케이션은 텍스트를 반환하는 `display` 값을 설정할 때까지 도구 호출 사이에 아무것도 표시하지 않게 됩니다.

## 새로운 모델

| 모델              | Claude API ID   | 설명                        |
| --------------- | --------------- | ------------------------- |
| Claude Opus 5.5 | claude-opus-5-5 | 장시간 실행되는 에이전트 코딩 및 지식 작업용 |

["Adaptive thinking"(적응형 사고)](https://platform.claude.com/docs/ko/build-with-claude/thinking)은 항상 켜져 있으며, ["effort"(노력 수준) 매개변수](https://platform.claude.com/docs/ko/build-with-claude/effort)가 사고 깊이를 제어합니다. 이 모델에서의 기본값은 `medium`입니다. "Context window"(컨텍스트 윈도우), 출력 한도, 지식 컷오프 및 가격은 [Claude Opus 5.5 모델 페이지](https://platform.claude.com/docs/ko/models/opus-5-5/overview)를 참조하고, 현재 제공되는 모든 모델은 [모델 개요](https://platform.claude.com/docs/ko/models/overview)를 참조하세요.

## 호환성이 깨지는 변경 사항

### 사고를 비활성화할 수 없음

Claude Opus 5에서는 사고가 기본적으로 켜져 있으며, effort가 `high` 이하일 때 `thinking: {"type": "disabled"}`가 허용됩니다. Claude Opus 5.5에서는 사고가 항상 켜져 있습니다. `thinking: {"type": "disabled"}`를 설정하거나 `thinking: {"type": "enabled", "budget_tokens": N}`으로 수동 예산을 지정한 요청은 400 `invalid_request_error`를 반환합니다. `thinking` 필드를 생략하거나, 이와 동일한 `thinking: {"type": "adaptive"}`를 보내세요. 베타 헤더는 필요하지 않습니다.

오류 메시지는 다음과 같습니다:

```text wrap
"thinking.type.disabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
```

```text wrap
"thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
```

[effort 매개변수](https://platform.claude.com/docs/ko/build-with-claude/effort)는 사고 깊이, "latency"(지연 시간) 및 비용을 제어하는 수단입니다. 이전에 사고를 비활성화했던 곳에서는 effort를 낮추세요. 수준 선택에 대한 측정 결과는 [비용과 지능 최적화](https://platform.claude.com/docs/ko/about-claude/models/optimizing-for-cost-and-intelligence#tune-effort)에서 확인할 수 있습니다. 모든 응답은 하나 이상의 `thinking` 블록으로 시작할 수 있으므로(기본값인 `display: "omitted"`에서는 `thinking` 필드가 비어 있는 상태로 반환됨), 콘텐츠 블록은 위치가 아닌 `type` 필드로 선택하고, 도구 사용 루프에서는 `thinking` 블록을 수정하지 않고 그대로 다시 전달하세요. 이미 Claude Opus 5에서 사고를 켠 상태로 실행 중인 코드는 변경할 필요가 없습니다. [사고](https://platform.claude.com/docs/ko/build-with-claude/thinking) 및 마이그레이션 가이드의 [변경 전후 비교](https://platform.claude.com/docs/ko/models/opus-5-5/migration-guide#thinking-cant-be-disabled)를 참조하세요.

### 강제 도구 사용은 지원되지 않음

Claude Opus 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) 엔드포인트에도 동일한 검증이 적용됩니다. 스키마에 맞는 JSON이 필요하다면 `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/opus-5-5/migration-guide#forced-tool-use)를 확인할 수 있습니다.

### 사고 블록이 모델 및 대화에 연결됨

모든 사고 블록은 어떤 모델이 생성했는지를 기록하며, 각 모델은 자신의 블록과 일부 다른 모델의 블록만 읽습니다. Claude Opus 5.5는 Claude Opus 5, 이전 Opus, Sonnet, Haiku 모델, 그리고 Claude API 및 Google Cloud에서는 Claude Sonnet 5.5와 Claude Haiku 5.5의 사고 블록을 읽지만, Claude Fable 또는 Claude Mythos 모델의 블록은 읽지 않습니다. Claude API에서는 Claude Fable 5.1과 Claude Mythos 5.1이 Claude Opus 5.5의 사고 블록을 읽으며, 다른 모델은 읽지 않습니다. Claude Opus 5에서 Claude Opus 5.5로 이동하거나, Claude API에서 Claude Opus 5.5로부터 Claude Fable 5.1 또는 Claude Mythos 5.1로 올라가는 대화는 추론을 유지합니다. Claude Opus 5.5에서 이 두 모델 이외의 모델로 이동하거나, Claude Fable 또는 Claude Mythos 모델에서 Claude Opus 5.5로 이동하는 대화는 전환 이후의 턴을 이전 모델의 추론 없이 실행합니다. 요청에 대상 모델이 읽을 수 없는 블록이 포함되어 있으면 API는 모델이 보기 전에 해당 블록을 제거합니다: 요청은 성공하며, 제거된 블록에는 요금이 부과되지 않습니다. `thinking-binding-controls-2026-08-01` 베타 헤더를 사용하면 제거 사실이 최상위 `input_transformations` 배열에 보고됩니다. [대화 중 모델 전환](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking#switching-models)을 참조하세요.

API는 또한 Claude Opus 5.5 사고 블록 앞에 있는 내용(`system` 프롬프트, `tools` 또는 이전 메시지)이 블록 생성 이후 변경되었는지도 확인합니다. Claude Fable 5.1과 마찬가지로, 2026년 8월 31일 00:00 UTC 이후에 생성된 계정에 대해서는 Claude API 및 클라우드 플랫폼에서 이 확인을 기본적으로 적용합니다. 해당 계정에서는 이러한 변경 이후 블록을 재전송하는 요청이 400 오류를 반환합니다. 대신 영향을 받는 블록을 제거하려면 `thinking-binding-controls-2026-08-01` 베타 헤더를 보내고 `thinking.block_binding.prefix_mismatch_behavior`를 `"drop_block"`으로 설정하세요. 이전 계정에서는 이 필드를 어느 값으로든 설정하면 해당 요청이 이 동작에 옵트인됩니다. 이 문제가 아예 발생하지 않도록 대화를 추가 전용(append-only)으로 유지하세요: 지시 사항이나 도구는 편집 대신 [대화 중 시스템 메시지](https://platform.claude.com/docs/ko/build-with-claude/mid-conversation-system-messages)로 변경하세요. [보존된 사고](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking) 및 마이그레이션 가이드의 [이 변경 사항에 대한 참고](https://platform.claude.com/docs/ko/models/opus-5-5/migration-guide#thinking-blocks)를 참조하세요.

### Claude API 및 Google Cloud에서 `computer_20251124` 컴퓨터 사용 도구는 지원되지 않음

Claude Opus 5는 ["computer use"(컴퓨터 사용)](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/computer-use-tool)를 `computer_toolset_20260801` 도구 세트로도, `computer-use-2025-11-24` 베타 헤더와 함께 이전 `computer_20251124` 도구로도 허용합니다. Claude API 및 Google Cloud에서 Claude Opus 5.5는 도구 세트만 지원합니다. `computer_20251124` 도구를 선언한 요청은 400 `invalid_request_error`를 반환합니다. 메시지는 거부된 유형을 명시한 다음, `Did you mean one of` 뒤에 모델이 허용하는 도구 유형(`computer_toolset_20260801` 포함)을 나열하며, 다음과 같이 시작합니다:

```text wrap
'claude-opus-5-5' does not support tool types: computer_20251124.
```

Claude API 또는 Google Cloud에서 기존 통합을 이전하려면 [`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`에 맞게 에이전트 루프를 업데이트하세요. Amazon Bedrock에서는 이전 `computer_20251124` 도구가 Claude Opus 5에서와 마찬가지로 Claude Opus 5.5에서도 계속 작동하므로 변경할 필요가 없습니다. 다른 플랫폼의 경우 컴퓨터 사용 도구의 [호환성](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/computer-use-tool#compatibility) 섹션을 참조하세요. 이미 도구 세트를 사용하는 통합과 [브라우저 사용 도구](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/browser-use-tool)는 변경할 필요가 없습니다. 마이그레이션 가이드에서 요청의 [변경 전후 비교](https://platform.claude.com/docs/ko/models/opus-5-5/migration-guide#computer-use-toolset)를 확인할 수 있습니다.

## 기능 지원

Claude Opus 5.5는 [메시지별 effort](https://platform.claude.com/docs/ko/build-with-claude/effort#change-effort-mid-conversation-beta)(베타), [대화 중 시스템 메시지](https://platform.claude.com/docs/ko/build-with-claude/mid-conversation-system-messages), [작업 예산](https://platform.claude.com/docs/ko/build-with-claude/task-budgets), 최소 캐시 가능 프롬프트가 512 토큰인 ["prompt caching"(프롬프트 캐싱)](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), 그리고 서버 측 및 클라이언트 측 [도구](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/overview)를 지원합니다. Claude API 및 Google Cloud에서 컴퓨터 사용에는 `computer_toolset_20260801` 도구 세트가 필요합니다([호환성이 깨지는 변경 사항](https://platform.claude.com/docs/ko/models/opus-5-5/whats-new-opus-5-5#computer-20251124-is-not-supported) 참조). 모델별 제공 여부는 각 기능 페이지를 참조하세요.

### Fast mode

["Fast mode"(빠른 모드)](https://platform.claude.com/docs/ko/build-with-claude/fast-mode)는 Claude API에서, 그리고 Azure에서 호스팅되는 배포에 대해 [Claude in Microsoft Foundry](https://platform.claude.com/docs/ko/build-with-claude/claude-in-microsoft-foundry)에서 Claude Opus 5.5에 제공되지만, Anthropic에서 호스팅되는 배포에는 제공되지 않습니다. Amazon Bedrock, Claude Platform on AWS 또는 Google Cloud에서는 제공되지 않습니다. Claude API에서 요청에 `speed: "fast"`를 설정하세요. Claude Opus 5.5에는 베타 헤더가 필요하지 않습니다. 지원 모델, 속도 제한 및 가격은 [Fast mode](https://platform.claude.com/docs/ko/build-with-claude/fast-mode)를 참조하세요.

### 메시지에서 도구 정의하기(베타)

`inline-tools-2026-09-15` 베타 헤더를 사용하면, 대화 중 시스템 메시지의 `tool_addition` 블록에 참조 대신 전체 도구 정의를 담을 수 있습니다. 따라서 `tools`를 편집하지 않고도, 그리고 프롬프트 캐시를 잃지 않고도 대화 중에 도구를 추가하거나, 스키마를 변경하거나, 서버 도구를 최신 버전으로 옮길 수 있습니다. 이 기능은 Claude Opus 5.5를 포함하여 대화 중 도구 변경을 지원하는 모든 모델에서 작동합니다. [메시지에서 도구 정의하기](https://platform.claude.com/docs/ko/build-with-claude/mid-conversation-system-messages#define-tools-in-a-message-beta)를 참조하세요.

### 온디맨드 압축(베타)

`compact-2026-09-04` 베타 헤더를 사용하면, 최상위 `compaction` 매개변수를 보내는 요청이 전체 대화를 요약한 서명된 `compaction` 블록을 반환하며, 이후 요약된 메시지 대신 이 블록을 맨 앞에 보내면 됩니다. 이 기능은 Claude Opus 5.5를 포함하여 "compaction"(압축)을 지원하는 모델에서 사용할 수 있습니다. 압축 시점을 직접 선택할 수 있고, 요청을 백그라운드에서 실행할 수 있으며, 유지하는 턴의 사고 블록은 교체 후에도 유효하게 유지될 수 있습니다([압축과 보존된 사고](https://platform.claude.com/docs/ko/build-with-claude/compaction-thinking-blocks#conditions-for-kept-thinking-to-stay-valid)의 조건 충족 시). 이는 Claude Opus 5.5에서 [사고 블록이 대화에 연결되어 있기](https://platform.claude.com/docs/ko/models/opus-5-5/whats-new-opus-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them) 때문에 중요합니다. 플랫폼별 제공 여부와 전체 요청 흐름은 [온디맨드 압축](https://platform.claude.com/docs/ko/build-with-claude/compaction-on-demand)을 참조하세요.

## 동작 차이

Claude Opus 5.5는 코드 변경 없이도 나타나는 여러 측면에서 Claude Opus 5와 다릅니다. 각 항목에 대한 안내는 [Claude Opus 5.5 프롬프팅](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-opus-5-5)에 있습니다:

* **기본 effort는 `medium`입니다.** `effort`를 생략한 요청은 `medium`으로 실행됩니다. Claude Opus 5에서는 `high`로 실행되었습니다. `effort`를 명시적으로 설정하고 스윕을 다시 실행하세요. [effort 보정](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort)을 참조하세요.
* **동일한 effort 수준에서 턴당 사고량 증가.** 동일한 [effort](https://platform.claude.com/docs/ko/build-with-claude/effort) 설정에서 이 모델은 Claude Opus 5보다 턴당 더 많이 사고하는 경향이 있으며, 특히 `xhigh`와 `max`에서 두드러집니다. 기존 설정을 그대로 가져오지 말고 effort 스윕을 다시 실행하고, `max_tokens`에 사고를 위한 여유를 남겨 두세요. [effort 보정](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort)을 참조하세요.
* **도구 호출 사이의 텍스트가 사고 블록으로 반환됩니다.** 모델이 도구 호출 사이에 작성하는 짧은 메모는 `text` 블록이 아닌 [진행 상황 업데이트 `thinking` 블록](https://platform.claude.com/docs/ko/build-with-claude/thinking#progress-updates)으로 전달됩니다. 따라서 기본값인 `display: "omitted"`에서는 이를 사용자에게 스트리밍하는 애플리케이션이 오류 없이 도구 호출 사이에 아무것도 표시하지 않게 됩니다. 이를 수신하기 위한 해결 방법은 [마이그레이션 가이드](https://platform.claude.com/docs/ko/models/opus-5-5/migration-guide#text-between-tool-calls)에 있으며, 이러한 업데이트를 더 많이 요청하는 방법은 [사용자 대상 진행 상황 업데이트](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#user-facing-progress-updates)에서 다룹니다.
* **더 많은 안전장치 카테고리.** 모델은 사이버 보안 분류기 외에 생물학 안전 분류기도 실행합니다. Claude Opus 5와 마찬가지로, 응답 텍스트에서 내부 추론을 재현하도록 유도하는 요청은 `reasoning_extraction` 카테고리로 거부될 수 있습니다. [거부 및 폴백](https://platform.claude.com/docs/ko/models/opus-5-5/whats-new-opus-5-5#refusals-and-fallback)과 [안전장치 거부](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#safeguard-refusals)를 참조하세요.
* **차트, 다이어그램, 스크린샷을 더 정확하게 읽습니다.** 이 모델은 도구 없이도 밀도 높은 차트와 레이아웃에 의존하는 시각 자료에서 값을 훨씬 더 정밀하게 읽어 내므로, 이전 모델을 위해 만든 프롬프트 측 비전 우회 방법이 더 이상 필요하지 않을 수 있습니다. 다만 가장 밀도 높은 입력에서는 이미지 도구가 여전히 정확도를 높여 줍니다. [복잡한 시각적 입력을 위한 도구](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#tools-for-complex-visual-inputs)를 참조하세요.

Claude Opus 5 통합이 사고를 비활성화한 상태로 실행되었다면, [호환성이 깨지는 변경 사항](https://platform.claude.com/docs/ko/models/opus-5-5/whats-new-opus-5-5#thinking-cant-be-disabled)과 함께 [사고 비활성화를 전제로 작성된 프롬프트](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#prompts-written-for-thinking-disabled)를 참조하세요. 에이전트 코딩 및 코드 리뷰, 지식 작업, 커뮤니케이션, 시각 입력, 컴퓨터 사용에서의 역량 향상에 대해서는 [프롬프팅과 관련된 기능](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#capability-improvements)을 참조하세요.

## 거부 및 폴백

Claude Opus 5.5에는 안전 분류기가 탑재되어 있으며, [거부 및 폴백](https://platform.claude.com/docs/ko/build-with-claude/refusals-and-fallback)의 모든 내용이 적용됩니다. 거부된 요청은 `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"`, 베타, 해당 카테고리에 대해 Anthropic이 권장하는 모델로 재시도), [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 Opus 5.5의 가격은 입력 토큰 100만 개당 $4 USD, 출력 토큰 100만 개당 $20 USD로, Claude Opus 5의 $5 및 $25보다 낮습니다. 토큰 100만 개당 5분 캐시 쓰기는 $5, 1시간 캐시 쓰기는 $8, 캐시 읽기는 $0.20(기본 입력 가격의 0.05배)입니다. [배치 처리](https://platform.claude.com/docs/ko/build-with-claude/batch-processing)는 절반 가격인 $2 및 $10입니다. 데이터 레지던시 및 도구 가격은 [가격](https://platform.claude.com/docs/ko/about-claude/pricing)을 참조하세요.

## 가용성

Claude Opus 5.5는 다음에서 사용할 수 있습니다:

* **Claude API:** 모든 고객, `claude-opus-5-5`로 제공.
* **AWS:** [Claude in Amazon Bedrock](https://platform.claude.com/docs/ko/build-with-claude/claude-in-amazon-bedrock)에서 `anthropic.claude-opus-5-5`로, [Claude Platform on AWS](https://platform.claude.com/docs/ko/build-with-claude/claude-platform-on-aws)에서 `claude-opus-5-5`로 제공.
* **Google Cloud:** [Claude on Google Cloud](https://platform.claude.com/docs/ko/build-with-claude/claude-on-vertex-ai)에서 `claude-opus-5-5`로 제공.
* **Microsoft Foundry:** [Claude in Microsoft Foundry](https://platform.claude.com/docs/ko/build-with-claude/claude-in-microsoft-foundry)에서 `claude-opus-5-5`로 제공.

## Claude Opus 5에서 마이그레이션

모델 ID를 업데이트하세요:

<CodeGroup exclude="shell">
  ```python Python
  model = "claude-opus-5"  # Before
  model = "claude-opus-5-5"  # After
  ```

  ```typescript TypeScript
  let model = "claude-opus-5"; // Before
  model = "claude-opus-5-5"; // After
  ```

  ```csharp C#
  var model = Model.ClaudeOpus5; // Before
  model = Model.ClaudeOpus5_5; // After
  ```

  ```go Go
  model := anthropic.ModelClaudeOpus5  // Before
  model = anthropic.ModelClaudeOpus5_5 // After
  ```

  ```java Java
  Model model = Model.CLAUDE_OPUS_5; // Before
  model = Model.CLAUDE_OPUS_5_5; // After
  ```

  ```php PHP
  $model = Model::CLAUDE_OPUS_5; // Before
  $model = Model::CLAUDE_OPUS_5_5; // After
  ```

  ```ruby Ruby
  model = Anthropic::Model::CLAUDE_OPUS_5 # Before
  model = Anthropic::Model::CLAUDE_OPUS_5_5 # After
  ```
</CodeGroup>

그런 다음 `thinking: {"type": "disabled"}` 또는 `thinking: {"type": "enabled", ...}` 설정을 모두 제거하고 대신 [effort](https://platform.claude.com/docs/ko/build-with-claude/effort) 수준을 선택하세요. `tool_choice` 유형 `any` 및 `tool`은 `auto`와 [엄격한 도구 사용](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/strict-tool-use)으로 교체하세요. Claude API 또는 Google Cloud에서 `computer_20251124`를 통해 컴퓨터 사용을 이용하는 경우 [도구 세트로 이전](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124)하세요. 인터페이스에 도구 호출 사이의 텍스트를 표시하는 경우 `thinking.display`도 설정하세요. [도구 호출 사이의 텍스트가 사고 블록으로 반환됨](https://platform.claude.com/docs/ko/models/opus-5-5/migration-guide#text-between-tool-calls)을 참조하세요. Claude Opus 5 및 이전 모델에서의 단계별 안내와 전체 체크리스트는 [마이그레이션 가이드](https://platform.claude.com/docs/ko/models/opus-5-5/migration-guide)를 참조하세요.

## 다음 단계

<CardGroup cols={3}>
  <Card title="모델 개요" icon="arrow-right" href="https://platform.claude.com/docs/ko/models/overview">
    현재 제공되는 모든 Claude 모델의 전체 사양 및 가격입니다.
  </Card>

  <Card title="마이그레이션 가이드" icon="code" href="https://platform.claude.com/docs/ko/models/opus-5-5/migration-guide">
    Claude Opus 5 및 이전 모델의 코드를 Claude Opus 5.5로 이전하세요.
  </Card>

  <Card title="Claude Opus 5.5 프롬프팅" icon="terminal" href="https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-opus-5-5">
    Claude Opus 5.5에 특화된 동작 차이와 프롬프팅 패턴입니다.
  </Card>

  <Card title="Effort" icon="gauge" href="https://platform.claude.com/docs/ko/build-with-claude/effort">
    Claude가 응답할 때 사용하는 토큰 양을 low부터 max까지 제어하세요.
  </Card>

  <Card title="사고" icon="brain" href="https://platform.claude.com/docs/ko/build-with-claude/thinking">
    적응형 사고의 작동 방식과 사고 블록이 보존되는 방식입니다.
  </Card>

  <Card title="거부 및 폴백" icon="shield" href="https://platform.claude.com/docs/ko/build-with-claude/refusals-and-fallback">
    `stop_reason: "refusal"`을 처리하고 다른 모델로 재시도하세요.
  </Card>
</CardGroup>
