검색
← 모듈 로드맵

Claude Opus 5.5 변경 사항

조회 1발행 출처 platform.claude.com · platform.claude.com

클로드레퍼런스전문가

나중에 보기좋아요
공유 · 인쇄
후기댓글

Claude Opus 5.5는 장시간 실행되는 에이전트형 코딩과 지식 업무를 위해 만들어졌으며, 가격은 입력 / 출력 토큰 백만 개당 각각 4달러 / 20달러 USD입니다. 네 가지 중대한 변경 사항은 Claude Opus 5에서 이미 실행 중인 코드에 영향을 줍니다. thinking은 비활성화할 수 없고, 강제 도구 사용은 오류를 반환하며, thinking 블록은 모델과 대화에 묶여 있고, Claude API와 Google Cloud에서는 이전 computer_20251124 computer use 도구가 허용되지 않습니다. 앞의 세 가지는 Claude Fable 5.1에도 적용됩니다. 추가로 한 가지 변경은 어떤 요청도 실패시키지 않지만 응답 형식을 바꿉니다. 도구 호출 사이의 텍스트는 기본 display 설정에서는 텍스트가 비어 있는 thinking 블록으로 돌아옵니다. 이 텍스트를 진행 상황 업데이트로 사용자에게 스트리밍하는 애플리케이션은, 텍스트를 반환하는 display 값을 설정할 때까지 도구 호출 사이에서 조용해집니다.

새 모델

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

적응형 thinking은 항상 켜져 있으며, effort 매개변수가 thinking 깊이를 제어합니다. 이 모델의 기본값은 medium입니다. 컨텍스트 창, 출력 한도, 지식 기준 시점, 가격은 Claude Opus 5.5 모델 페이지를 참조하세요. 현재 모든 모델은 모델 개요에서 볼 수 있습니다.

중대한 변경 사항

Thinking은 비활성화할 수 없습니다

Claude Opus 5에서는 thinking이 기본적으로 켜져 있으며 thinking: {"type": "disabled"}는 effort high 이하에서 허용됩니다. 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 블록을 수정하지 않은 채 다시 전달해야 합니다. 이미 Claude Opus 5에서 thinking을 켠 상태로 실행되는 코드는 변경이 필요하지 않습니다. Thinking과 마이그레이션 가이드의 thinking 전후 비교를 참조하세요.

강제 도구 사용은 지원되지 않습니다

Claude Opus 5.5는 강제 도구 사용을 지원하지 않습니다. 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: true를 설정하거나, 스키마를 구조화된 출력으로 옮기세요. 모델이 텍스트로 답하지 않고 도구를 호출하게 하려면, 도구가 적용되는 상황을 프롬프트에 명시하세요. 마이그레이션 가이드에는 tool choice 전후 비교가 나와 있습니다.

Thinking 블록은 모델과 대화에 묶여 있습니다

모든 thinking block에는 이를 생성한 모델이 기록되며, 각 모델은 자신이 만든 블록과 일부 다른 모델의 블록만 읽습니다. Claude Opus 5.5는 Claude Opus 5, 그 이전의 Opus, Sonnet, Haiku 모델의 thinking block을 읽으며, Claude API와 Google Cloud에서는 Claude Sonnet 5.5와 Claude Haiku 5.5의 thinking block도 읽지만, Claude Fable 또는 Claude Mythos 모델의 것은 읽지 않습니다. Claude API에서는 Claude Fable 5.1과 Claude Mythos 5.1이 Claude Opus 5.5의 thinking block을 읽습니다. 다른 모델은 그렇지 않습니다. 대화가 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 block 이전의 내용(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과 마이그레이션 가이드의 thinking block 관련 참고를 참조하세요.

computer_20251124 컴퓨터 사용 도구는 Claude API와 Google Cloud에서 지원되지 않습니다

Claude Opus 5는 computer use를 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.5에서도 Claude Opus 5에서와 마찬가지로 계속 작동하므로 변경이 필요하지 않습니다. 다른 플랫폼은 컴퓨터 사용 도구의 호환성 섹션을 참조하세요. 이미 툴셋을 사용하는 통합과 browser use 도구는 변경할 필요가 없습니다. 마이그레이션 가이드에는 요청의 이전과 이후가 나와 있습니다.

기능 지원

Claude Opus 5.5는 메시지별 effort(베타), 대화 중간 시스템 메시지, task budgets, 512 토큰 최소 캐시 가능 프롬프트를 지원하는 prompt caching, batch processing, Files API, PDF support, vision, 그리고 서버 측 및 클라이언트 측 tools을 지원합니다. Claude API와 Google Cloud에서는 computer use에 computer_toolset_20260801 toolset이 필요합니다(파괴적 변경 참고). 각 기능 페이지에서 모델 지원 여부를 확인하세요.

Fast mode

Fast mode은 Claude API와 Claude in Microsoft Foundry에서 Azure에 호스팅된 배포에 대해 Claude Opus 5.5에서 사용할 수 있지만, Anthropic에 호스팅된 배포에서는 사용할 수 없습니다. Amazon Bedrock, Claude Platform on AWS, Google Cloud에서는 사용할 수 없습니다. Claude API에서는 요청에 speed: "fast"를 설정하세요. Claude Opus 5.5는 베타 헤더가 필요하지 않습니다. 지원 모델, 속도 제한, 요금은 Fast mode를 참조하세요.

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

inline-tools-2026-09-15 베타 헤더를 사용하면, 대화 중간 시스템 메시지의 tool_addition 블록이 참조가 아니라 완전한 도구 정의를 담을 수 있으므로, tools를 편집하지 않고도 프롬프트 캐시를 잃지 않은 채 대화 중간에 도구를 추가하거나, 스키마를 변경하거나, 서버 도구를 더 최신 버전으로 이동할 수 있습니다. 이 기능은 Claude Opus 5.5를 포함해 대화 중간 도구 변경을 지원하는 모든 모델에서 작동합니다. 메시지에 도구 정의하기를 참조하세요.

필요할 때 압축(베타)

compact-2026-09-04 베타 헤더를 사용하면, 최상위 compaction 파라미터를 보내는 요청이 전체 대화를 요약한 서명된 compaction 블록을 반환하며, 이후 요약된 메시지 대신 이를 맨 앞에 보내면 됩니다. 이는 compaction을 지원하는 모델에서 사용할 수 있으며, Claude Opus 5.5도 포함됩니다. 언제 압축할지는 사용자가 정하며, 요청은 백그라운드에서 실행할 수 있고, 유지하는 턴의 thinking 블록은 교체 후에도 유효한 상태를 유지할 수 있습니다(보존된 thinking의 압축의 조건에 따름). 이는 Claude Opus 5.5에서 특히 중요한데, 이 모델의 thinking 블록은 대화와 연결되어 있기 때문입니다. 플랫폼 지원 여부와 전체 요청 흐름은 필요할 때 압축을 참조하세요.

동작 차이

Claude Opus 5.5는 코드 변경 없이도 드러나는 몇 가지 측면에서 Claude Opus 5와 다릅니다. 각 항목에 대한 안내는 Prompting Claude Opus 5.5에 있습니다:

  • 기본 effort는 medium입니다. effort를 생략한 요청은 medium으로 실행되며, Claude Opus 5에서는 high로 실행되었습니다. effort를 명시적으로 설정하고 스윕을 다시 실행하세요. effort 보정를 참조하세요.
  • 주어진 effort 수준에서 턴당 더 많은 thinking을 합니다. 같은 effort 설정에서 이 모델은 Claude Opus 5보다 턴당 더 많이 생각하는 경향이 있으며, 특히 xhigh와 max에서 그렇습니다. 설정을 그대로 이어 쓰지 말고 effort 스윕을 다시 실행하세요. 또한 max_tokens에는 thinking을 위한 여유를 남겨두세요. effort 보정를 참조하세요.
  • 더 많은 안전장치 범주. 이 모델은 사이버보안 분류기뿐 아니라 생물학 안전 분류기도 실행합니다. Claude Opus 5와 마찬가지로, 응답 텍스트에서 내부 추론을 재현하도록 유도하는 요청은 reasoning_extraction 범주로 거부될 수 있습니다. Claude Opus 5.5의 거부 및 대체와 안전장치 거부를 참고하세요.
  • 차트, 다이어그램, 스크린샷을 더 정확하게 읽음. 이 모델은 도구 없이도 밀도가 높은 차트와 레이아웃 의존적 시각 자료의 값을 훨씬 더 정확하게 읽으므로, 이전 모델용으로 만든 프롬프트 측 비전 우회책이 더 이상 필요하지 않을 수 있습니다. 다만 이미지 도구는 가장 밀집된 입력에서 여전히 정확도를 높여 줍니다. 복잡한 시각 입력을 위한 도구를 참고하세요.

Claude Opus 5 통합에서 thinking을 비활성화한 상태로 실행했다면, 파괴적 변경 사항인 ‘Thinking은 비활성화할 수 없습니다’와 함께 thinking 비활성화를 위해 작성된 프롬프트를 참고하세요. 에이전트형 코딩과 코드 리뷰, 지식 작업, 커뮤니케이션, 시각 입력, 컴퓨터 사용에서의 기능 향상은 프롬프트에 관련된 기능을 참고하세요.

거부 및 대체

Claude Opus 5.5에는 안전성 분류기가 포함되어 있으며, 거부 및 대체의 모든 내용이 적용됩니다. 거부된 요청은 HTTP 200을 반환하며 stop_reason: "refusal"과 정책 영역을 지정하는 stop_details 객체를 포함하므로, 거부를 처리하고 대체를 구성해야 합니다: 서버 측 대체(fallbacks: "default", 베타, 해당 범주에 대해 Anthropic이 권장하는 모델로 재시도), SDK 미들웨어, 또는 직접 구현한 재시도를 사용하세요. 어떤 대기 시간 전에 출력이 오지 않은 거부가 과금되는지는 거부 범주에 따라 다르며, 어느 경우든 사용량 제한에는 반영됩니다. 자세한 내용은 거부 과금 방식을 참고하세요.

가격

Claude Opus 5.5의 가격은 입력 토큰 백만 개당 4달러, 출력 토큰 백만 개당 20달러로, Claude Opus 5의 5달러와 25달러보다 낮습니다. 5분 캐시 쓰기는 5달러, 1시간 캐시 쓰기는 8달러이며, 캐시 읽기는 토큰 백만 개당 0.20달러입니다(기본 입력 가격의 0.05배). 배치 처리는 반값으로, 2달러와 10달러입니다. 데이터 거주지와 도구 가격은 가격을 참고하세요.

제공 여부

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

  • Claude API: 모든 고객에게 제공되며, claude-opus-5-5로 사용합니다.

Claude Opus 5에서 마이그레이션

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

python
model = "claude-opus-5"  # Before
model = "claude-opus-5-5"  # After

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

다음 단계

  • 모델 개요: 현재 모든 Claude 모델에 대한 완전한 사양과 가격.
  • 마이그레이션 가이드: Claude Opus 5 및 이전 모델에서 Claude Opus 5.5로 코드를 옮깁니다.
  • Prompting Claude Opus 5.5: Claude Opus 5.5에 특화된 동작 차이와 프롬프트 패턴.
  • Effort: Claude가 응답할 때 사용하는 토큰 수를 낮음부터 최대까지 제어합니다.
  • Thinking: 적응형 thinking이 어떻게 동작하는지와 thinking 블록이 어떻게 보존되는지 설명합니다.
  • 거부와 대체 처리: stop_reason: "refusal"을 처리하고 다른 모델로 다시 시도합니다.

출처

  • 원문: https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5 (2026-10-22 · platform.claude.com)

자료 변경 기록을 불러오는 중입니다.

다음 자료를 불러오는 중입니다.

후기

아직 후기가 없습니다

직접 적용한 결과와 주의할 점을 공유하는 공간입니다.

로그인하고 후기 쓰기

참고 자료 · 도구와 릴리스 노트

도구

클로드108

API로 내 앱에 AI 모델 연결하기 관련 자료

GPT-6.1 Terra 공개GPT-6.1 Terra를 Vercel AI Gateway에서 제공Claude Fable 5.1·Mythos 5.1 발표Claude Opus 5 출시Claude Sonnet 5 공개

댓글