2026년 7월 24일, Anthropic은 신규 모델 Claude Opus 5(claude-opus-5)를 정식 출시했습니다. 1M 토큰의 컨텍스트 윈도우 (Context Window), 최대 128k 토큰의 출력, thinking의 기본 활성화 등 Claude Opus 4.8로부터 크게 진화했습니다. 가격은 Opus 4.8과 동일한 $5 / $25 per MTok로 유지되어, 비용을 늘리지 않고 성능을 끌어올릴 수 있다는 점이 큰 포인트입니다.

한편, 이번 출시에는 개발자가 반드시 대응해야 하는 파괴적 변경 (Breaking Changes) 2건이 포함되어 있습니다.

• Opus 5에서는 effort가 xhigh / max일 때 thinking을 무효화하면 400 에러가 발생함
• Claude Opus 4.7의 fast mode가 삭제되어, 지정 시 에러가 발생함

또한 베타 기능으로 fallbacks 파라미터에 "default" 모드가 추가되었습니다. 이 기사에서는 이러한 변경 사항을 정리하고, 기존 코드에서 무엇을 확인하고 수정해야 하는지 해설합니다.

📌 영향을 받는 사람

• Claude API / Amazon Bedrock / Google Cloud Vertex AI / Microsoft Foundry에서 Opus 계열 모델을 이용 중인 개발자
• effort 파라미터와 thinking 무효화를 조합하여 이용 중인 애플리케이션
• fast mode (speed: "fast")로 Claude Opus 4.7을 호출하고 있는 구현

Opus 5는 Opus 4.8의 후속 모델로 등장하였으며, Bedrock, Vertex AI, Microsoft Foundry를 포함한 모든 채널에서 이용 가능합니다. 반면 Opus 4.7은 fast mode를 지원하지 않게 되어, fast mode를 계속 사용하려면 Opus 5 또는 Opus 4.8로의 이행이 필요합니다.

가격이 동결된 상태에서 컨텍스트 윈도우가 대폭 확장되었다는 점이 최대의 토픽입니다. 장문 컨텍스트를 다루는 RAG나 코드베이스 전체 분석 태스크에서의 활용이 기대됩니다.

⚠️ Breaking Change

Claude Opus 5에서는 effort가 xhigh 또는 max인 경우에 thinking: {"type": "disabled"}를 지정하면 400 에러가 반환되도록 변경되었습니다. Opus 4.8에서는 허용되었던 조합이기 때문에, 기존 코드를 그대로 Opus 5로 향하게 하면 실패할 가능성이 있습니다.

thinking을 무효화할 수 있는 것은 effort: "high" 이하인 경우뿐입니다. high effort 레벨에서의 추론 정밀도를 확보하기 위한 동작 변경으로 판단됩니다.

⚠️ Breaking Change

claude-opus-4-7에 대해 speed: "fast"를 지정하는 요청은 표준 속도로의 폴백 (Fallback) 없이 에러를 반환하게 되었습니다 (Opus 4.6과는 동작이 다릅니다). Opus 4.7 자체는 표준 속도로 계속 이용 가능합니다.

fast mode를 계속 사용하려면 Claude Opus 5 또는 Claude Opus 4.8로의 전환이 필요합니다.

fallbacks 파라미터에 "default" 모드가 추가되어, 거부 카테고리 (refusal category)별로 Anthropic 권장 폴백 모델이 자동으로 적용되도록 되었습니다. 이용을 위해서는 server-side-fallback-2026-07-01 베타 헤더 지정이 필요합니다.

개발자가 취해야 할 액션은 다음 3가지입니다.

• effort × thinking 조합을 점검하기: effort: "xhigh" 또는 "max"를 지정하면서 동시에 thinking: {"type": "disabled"}를 보내고 있는 부분이 없는지 코드를 검색하여, Opus 5로 전환하기 전에 수정해야 합니다.
• fast mode 사용처 확인하기: claude-opus-4-7 + speed: "fast"를 사용 중인 경우, Opus 5 또는 Opus 4.8로 전환해야 합니다.
• Opus 5 전환 검토하기: 가격은 그대로 유지되면서 1M 컨텍스트와 128k 출력을 사용할 수 있으므로, 긴 문장을 처리하는 워크로드(Workload)는 전환 시 이점이 매우 큽니다.

# Before: Opus 4.8에서는 허용되었던 조합
response = client.messages.create(
model="claude-opus-4-8",
...

# After: Opus 5로 전환할 경우 effort를 낮추거나, thinking을 비활성화하지 않음
response = client.messages.create(
model="claude-opus-5",
...

# Before: Opus 4.7 + fast mode (Opus 5 출시 후에는 에러 발생)
response = client.messages.create(
model="claude-opus-4-7",
...

# After: fast mode를 사용하려면 Opus 5 또는 Opus 4.8을 지정
response = client.messages.create(
model="claude-opus-5",
...

Claude Opus 5가 2026년 7월 24일에 출시되었습니다. 가격은 기존과 동일하게 유지($5/$25 per MTok)하면서, 1M 토큰 컨텍스트, 128k 출력, 그리고 thinking(사고 과정) 기본 활성화를 구현했습니다.

• 파괴적 변경 ①: Opus 5에서 effort: xhigh/max와 thinking: disabled를 병용하면 400 에러가 발생합니다. 기존 코드의 점검이 필요합니다.
• 파괴적 변경 ②: Claude Opus 4.7의 fast mode가 삭제되어, speed: "fast" 지정 시 에러가 발생합니다. 지속적인 이용을 위해서는 Opus 5/4.8로의 전환이 필요합니다.
• 베타 기능으로 fallbacks 파라미터에 "default" 모드가 추가되어, 거절 시의 폴백(Fallback) 모델 선정이 간소화되었습니다.

Opus 5로의 전환을 검토하고 있다면, 우선 effort와 thinking의 조합, 그리고 fast mode 사용 여부를 코드베이스에서 확인하는 것부터 시작하면 원활하게 진행할 수 있습니다.