Claude Opus 5.5의 새로운 기능

Claude Opus 5.5의 새로운 기능 (What's new in Claude Opus 5.5)

Claude Opus 5.5는 장기 실행 에이전트 코딩과 지식 작업을 위해 만들어졌으며, 입력/출력 백만 토큰당 $4 / $20 USD로 책정되어 있어요. Claude Opus 5에서 이미 실행 중인 코드에 영향을 주는 네 가지 호환성 파괴 변경과, 기능 지원, 동작 차이를 한눈에 정리한 페이지예요.

출처: 문서

본문

Claude Opus 5.5는 장기 실행 에이전트 코딩과 지식 작업을 위해 만들어졌으며, 입력/출력 백만 토큰당 $4 / $20 USD로 책정되어 있어요. Claude Opus 5에서 이미 실행 중인 코드에 영향을 주는 네 가지 호환성 파괴 변경이 있어요: thinking을 비활성화할 수 없고, 강제된 도구 사용이 오류를 반환하며, thinking 블록이 모델과 대화에 묶이며, Claude API와 Google Cloud에서는 이전 computer_20251124 컴퓨터 사용 도구가 허용되지 않아요. 처음 세 가지는 Claude Fable 5.1에도 동일하게 적용돼요. 또 하나의 변경은 어떤 요청도 실패시키지 않으면서 응답 형태를 바꾸는 것인데, 도구 호출 사이의 텍스트가 thinking 블록으로 돌아오고, 기본 display 설정에서는 그 텍스트가 비어 있어요. 그 텍스트를 진행 상황 업데이트로 사용자에게 스트리밍하는 애플리케이션은, 텍스트를 반환하는 display 값을 설정하기 전까지는 도구 호출 사이에 조용해져요.

새 모델

모델 Claude API ID 설명
Claude Opus 5.5 claude-opus-5-5 장기 실행 에이전트 코딩과 지식 작업용

Adaptive thinking은 항상 켜져 있고, effort 파라미터가 thinking 깊이를 제어해요. 이 모델에서 기본값은 medium이에요. 컨텍스트 창, 출력 한도, 지식 기준일, 가격은 Claude Opus 5.5 모델 페이지를, 모든 현재 모델은 모델 개요를 참고하세요.

호환성 파괴 변경

Thinking을 비활성화할 수 없음

Claude Opus 5에서는 thinking이 기본값으로 켜져 있고 effort high 이하에서 thinking: {"type": "disabled"}가 허용돼요. Claude Opus 5.5에서는 thinking이 항상 켜져 있어요. thinking: {"type": "disabled"}를 설정하는 요청이나, thinking: {"type": "enabled", "budget_tokens": N}으로 수동 예산을 잡는 요청은 400 invalid_request_error를 반환해요. thinking 필드를 생략하거나, 동등한 thinking: {"type": "adaptive"}를 보내세요. 베타 헤더는 관련되지 않아요.

오류 메시지는 다음과 같아요:

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

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

effort 파라미터는 thinking 깊이, 지연 시간, 비용을 제어하는 도구예요. 이전에 thinking을 비활성화했던 곳에서는 낮추세요. 비용과 지능 최적화에는 수준 선택을 위한 측정 결과가 있어요. 모든 응답이 하나 이상의 thinking 블록으로 시작할 수 있으므로(기본 display: "omitted"에서 빈 thinking 필드로 반환됨), 위치가 아니라 type 필드로 콘텐츠 블록을 선택하고, 도구 사용 루프에서 thinking 블록을 수정하지 않고 다시 전달하세요. thinking이 켜진 상태로 Claude Opus 5에서 이미 실행 중인 코드는 변경이 필요 없어요. Thinking과 마이그레이션 가이드의 before and after를 참고하세요.

강제 도구 사용 미지원

Claude Opus 5.5는 강제 도구 사용(forced tool use)을 지원하지 않아요. tool_choice가 {"type": "any"} 또는 {"type": "tool", "name": "..."}로 설정되면 400 invalid_request_error를 반환해요:

tool_choice: type "tool" and "any" are not supported for this model.

tool_choice: {"type": "auto"}(기본값)와 {"type": "none"}은 지원되며, 같은 검증이 토큰 계산 엔드포인트에도 적용돼요. 스키마 유효 JSON을 위해서는 tool_choice: {"type": "auto"}를 유지하고 엄격한 도구 사용(strict tool use)으로 strict: true를 설정하거나, 스키마를 구조화된 출력으로 옮기세요. 모델이 텍스트로 답하는 대신 도구를 호출하게 하려면, 프롬프트에서 도구가 적용되는 시점을 말하세요. 마이그레이션 가이드에 before and after가 있어요.

Thinking 블록이 모델과 대화에 묶임

모든 thinking 블록은 어떤 모델이 그것을 만들었는지 기록하고, 각 모델은 자신의 블록과 일부 다른 모델의 블록만 읽어요. Claude Opus 5.5는 Claude Opus 5 및 그 이전 Opus, Sonnet, Haiku 모델의 thinking 블록은 읽지만, Claude Fable이나 Claude Mythos 모델의 블록은 읽지 않아요. Claude API에서 Claude Fable 5.1과 Claude Mythos 5.1은 Claude Opus 5.5의 thinking 블록을 읽으며, 다른 어떤 모델도 그러지 않아요. 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 배열에 보고돼요. 대화 중간에 모델 전환하기를 참고하세요.

API는 Claude Opus 5.5 thinking 블록 앞의 어떤 것(system 프롬프트, tools, 이전 메시지)이 블록이 만들어진 이후 변경되었는지도 확인해요. Claude Fable 5.1과 마찬가지로, Claude API와 클라우드 플랫폼에서 2026년 8월 31일 00:00 UTC 이후 생성된 계정에는 기본적으로 그 확인을 강제해요. 그 계정에서 변경 후 블록을 재생하는 요청은 400 오류를 반환해요. 영향을 받은 블록을 대신 버리려면 thinking-binding-controls-2026-08-01 베타 헤더를 보내고 thinking.block_binding.prefix_mismatch_behavior를 "drop_block"으로 설정하세요. 이전 계정에서는 그 필드를 어떤 값으로든 설정하면 요청이 옵트인돼요. 대화를 append-only로 유지해 이런 문제가 생기지 않게 하세요: 편집 대신 대화 중간 시스템 메시지로 지시나 도구를 변경하세요. 보존된 thinking과 마이그레이션 가이드의 이 변경에 대한 참고를 참고하세요.

Claude API와 Google Cloud에서는 computer_20251124 컴퓨터 사용 도구 미지원

Claude Opus 5는 컴퓨터 사용을 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 포함)을 나열해요. 메시지는 다음과 같이 시작돼요:

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

Claude API나 Google Cloud의 기존 통합을 옮기려면 computer_20251124에서 마이그레이션을 따르세요: 베타 헤더를 제거하고, tools 항목을 {"type": "computer_toolset_20260801"}으로 바꾸고, 에이전트 루프를 멤버 tool_use 블록, 배치 동작, 결과의 toolset_name에 맞게 업데이트하세요. Amazon Bedrock에서는 이전 computer_20251124 도구가 Claude Opus 5와 마찬가지로 Claude Opus 5.5에서 계속 동작하므로 변경이 필요 없어요. 다른 플랫폼은 컴퓨터 사용 도구의 호환성 섹션을 참고하세요. 이미 툴셋을 사용하는 통합과 브라우저 사용 도구는 변경이 필요 없어요. 마이그레이션 가이드에 요청의 before and after가 있어요.

기능 지원

Claude Opus 5.5는 메시지별 effort(베타), 대화 중간 시스템 메시지, 작업 예산(task budgets), 512 토큰 최소 캐시 가능 프롬프트를 갖춘 프롬프트 캐싱, 배치 처리, Files API, PDF 지원, 비전, 서버 측 및 클라이언트 측 도구를 지원해요. Claude API와 Google Cloud에서 컴퓨터 사용은 computer_toolset_20260801 툴셋을 요구해요(호환성 파괴 변경 참고). 모델 제공 여부는 각 기능의 페이지를 참고하세요.

Fast mode

Fast mode(연구 프리뷰)는 Claude API에서만 Claude Opus 5.5에 제공돼요. Amazon Bedrock, AWS 위의 Claude Platform, Google Cloud, Microsoft Foundry에서는 제공되지 않아요. fast-mode-2026-02-01 베타 헤더로 speed: "fast"를 설정하세요. 접근, 지원 모델, 가격은 Fast mode를 참고하세요.

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

inline-tools-2026-09-15 베타 헤더를 사용하면 대화 중간 시스템 메시지의 tool_addition 블록이 참조 대신 전체 도구 정의를 담을 수 있어요. 그래서 tools를 편집하지 않고, 프롬프트 캐시를 잃지 않으면서 대화 중간에 도구를 추가하거나, 스키마를 변경하거나, 서버 도구를 최신 버전으로 옮길 수 있어요. 이것은 대화 중간 도구 변경을 지원하는 모든 모델에서 동작하며 Claude Opus 5.5도 포함돼요. 메시지에서 도구 정의를 참고하세요.

온디맨드 압축 (베타)

compact-2026-09-04 베타 헤더를 사용하면 최상위 compaction 파라미터를 보내는 요청이 전체 대화를 요약한 서명된 compaction 블록을 반환하고, 그것을 요약된 메시지 대신 먼저 보내요. 압축을 지원하는 모델(Claude Opus 5.5 포함)에서 제공돼요. 언제 압축할지 선택하고, 요청은 백그라운드에서 실행될 수 있으며, 유지하는 턴의 thinking 블록은 교체 후에도 유효하게 남을 수 있어요(압축과 보존된 thinking의 조건 하에). 이것은 thinking 블록이 대화에 묶여 있기 때문에 Claude Opus 5.5에서 중요해요. 플랫폼 제공 여부와 전체 요청 흐름은 온디맨드 압축을 참고하세요.

동작 차이

Claude Opus 5.5는 어떤 코드 변경 없이도 나타나는 여러 면에서 Claude Opus 5와 달라요. 각각에 대한 지침은 Claude Opus 5.5 프롬프팅에 있어요:

  • 기본 effort는 medium이에요. effort를 생략한 요청은 medium으로 실행돼요. Claude Opus 5에서는 high로 실행됐어요. effort를 명시적으로 설정하고 스윕(sweep)을 다시 실행하세요. Effort 보정을 참고하세요.
  • 주어진 effort 수준에서 턴당 thinking이 더 많아요. 같은 effort 설정에서 모델은 Claude Opus 5보다 턴당 더 많이 생각하는 경향이 있으며, 특히 xhigh와 max에서 그래요. 설정을 그대로 가져오지 말고 effort 스윕을 다시 실행하고, thinking을 위해 max_tokens에 여유를 두세요. Effort 보정을 참고하세요.
  • 도구 호출 사이의 텍스트가 thinking 블록으로 돌아와요. 모델이 도구 호출 사이에 쓰는 짧은 메모가 text 블록이 아니라 진행 상황 업데이트 thinking 블록으로 도착해요. 그래서 기본 display: "omitted"에서 그것을 사용자에게 스트리밍하는 애플리케이션은 오류 없이 도구 호출 사이에 조용해져요. 마이그레이션 가이드에 그것을 받는 수정 방법이 있고, 사용자 대상 진행 상황 업데이트에서 더 많이 요청하는 방법을 다뤄요.
  • 안전장치 카테고리가 더 많아요. 모델은 사이버 보안 분류기에 더해 생물학 안전 분류기(biology safety classifier)도 실행하고, 내부 추론을 응답 텍스트로 재현하도록 강요하는 요청은 reasoning_extraction 카테고리로 거절될 수 있어요. 거절 및 폴백과 안전장치 거절을 참고하세요.
  • 차트, 다이어그램, 스크린샷을 더 선명하게 읽어요. 모델은 도구 없이도 빽빽한 차트와 레이아웃 의존적 시각 자료의 값을 훨씬 더 정확히 읽어요. 그래서 이전 모델을 위해 만들어진 프롬프트 측 비전 우회책이 더 이상 필요하지 않을 수 있어요. 가장 빽빽한 입력에서는 이미지 도구가 여전히 정확도를 더해줘요. 복잡한 시각 입력을 위한 도구를 참고하세요.

Claude Opus 5 통합이 thinking 비활성화로 실행됐다면 thinking 비활성화용으로 작성된 프롬프트를 호환성 파괴 변경과 함께 참고하세요. 에이전트 코딩과 코드 리뷰, 지식 작업, 커뮤니케이션, 시각 입력, 컴퓨터 사용에서의 기능 향상은 프롬프팅과 관련된 기능을 참고하세요.

거절 및 폴백

Claude Opus 5.5에는 안전 분류기가 포함되어 있고, 거절 및 폴백의 모든 내용이 적용돼요. 거절된 요청은 stop_reason: "refusal"과 정책 영역을 명명하는 stop_details 객체와 함께 HTTP 200을 반환해요. 그러므로 거절을 처리하고 폴백을 구성하세요: 서버 측 폴백(fallbacks: "default", 베타, Anthropic이 그 카테고리에 대해 권장하는 모델에서 재시도), SDK 미들웨어, 또는 자체 재시도로 다른 모델에 재시도하세요.

가격

Claude Opus 5.5는 입력 백만 토큰당 $4 USD, 출력 백만 토큰당 $20 USD로, Claude Opus 5의 $5/$25보다 낮아요. 5분 캐시 쓰기 $5, 1시간 캐시 쓰기 $8, 캐시 읽기는 백만 토큰당 $0.20(기본 입력 가격의 0.05배)이에요. 배치 처리는 절반 가격인 $2와 $10이에요. 데이터 상주와 도구 가격은 가격을 참고하세요.

제공 (Availability)

Claude Opus 5.5는 다음에서 제공돼요:

Claude Opus 5에서 마이그레이션

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

```python Python model = "claude-opus-5" # Before model = "claude-opus-5-5" # After ``` 
let model = "claude-opus-5"; // Before
model = "claude-opus-5-5"; // After

var model = Model.ClaudeOpus5; // Before
model = Model.ClaudeOpus5_5; // After

model := anthropic.ModelClaudeOpus5  // Before
model = anthropic.ModelClaudeOpus5_5 // After

Model model = Model.CLAUDE_OPUS_5; // Before
model = Model.CLAUDE_OPUS_5_5; // After

$model = Model::CLAUDE_OPUS_5; // Before
$model = Model::CLAUDE_OPUS_5_5; // After

model = Anthropic::Model::CLAUDE_OPUS_5 # Before
model = Anthropic::Model::CLAUDE_OPUS_5_5 # After

그런 다음 thinking: {"type": "disabled"} 또는 thinking: {"type": "enabled", ...} 설정을 제거하고 대신 effort 수준을 선택하세요. tool_choice 유형 any와 tool을 auto + 엄격한 도구 사용으로 바꾸세요. Claude API나 Google Cloud에서 computer_20251124로 컴퓨터 사용을 사용한다면 툴셋으로 이동하세요. 인터페이스가 도구 호출 사이의 텍스트를 표시한다면 thinking.display도 설정하세요. 도구 호출 사이의 텍스트가 thinking 블록으로 반환됨을 참고하세요. Claude Opus 5 및 이전 모델에서의 단계별 지시와 전체 체크리스트는 마이그레이션 가이드를 참고하세요.

다음 단계

모든 현재 Claude 모델의 전체 사양과 가격. Claude Opus 5 및 이전 모델의 코드를 Claude Opus 5.5로 옮기세요. Claude Opus 5.5에 특화된 동작 차이와 프롬프팅 패턴. Claude가 응답할 때 사용하는 토큰 수를 low에서 max까지 제어하세요. adaptive thinking이 어떻게 동작하고 thinking 블록이 어떻게 보존되는지. `stop_reason: "refusal"`을 처리하고 다른 모델에 재시도하세요.

더 알아보기 (Learn more)