Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
Anthropic이 1M 컨텍스트 윈도우와 thinking 기능이 기본 활성화된 Claude Opus 5를 출시했습니다. 기존 모델 대비 성능과 용량이 크게 향상되었으나, API 사용 시 주의해야 할 두 가지 파괴적 변경 사항이 포함되었습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기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건이 포함되어 있습니다.
effort가 xhigh / max일 때 thinking을 무효화하면 400 에러가 발생함또한 베타 기능으로 fallbacks 파라미터에 "default" 모드가 추가되었습니다. 이 기사에서는 이러한 변경 사항을 정리하고, 기존 코드에서 무엇을 확인하고 수정해야 하는지 해설합니다.
📌 영향을 받는 사람
effort 파라미터와 thinking 무효화를 조합하여 이용 중인 애플리케이션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로의 이행이 필요합니다.
| 항목 | Claude Opus 4.8 | Claude Opus 5 |
|---|---|---|
| 컨텍스트 윈도우 (Context Window) | 기존 값 | 1M 토큰 (기본값·최대값) |
| 최대 출력 | 기존 값 | 128k 토큰 |
| thinking | 옵션 | 기본적으로 활성화 |
| 가격 (입력/출력) | $5 / $25 per MTok | $5 / $25 per MTok (동결) |
| 이용 채널 | Claude API, Bedrock, Vertex AI, Foundry | 좌동 |
가격이 동결된 상태에서 컨텍스트 윈도우가 대폭 확장되었다는 점이 최대의 토픽입니다. 장문 컨텍스트를 다루는 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: "xhigh" 또는 "max"를 지정하면서 동시에 thinking: {"type": "disabled"}를 보내고 있는 부분이 없는지 코드를 검색하여, Opus 5로 전환하기 전에 수정해야 합니다.claude-opus-4-7 + speed: "fast"를 사용 중인 경우, Opus 5 또는 Opus 4.8로 전환해야 합니다.# 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(사고 과정) 기본 활성화를 구현했습니다.
effort: xhigh/max와 thinking: disabled를 병용하면 400 에러가 발생합니다. 기존 코드의 점검이 필요합니다.speed: "fast" 지정 시 에러가 발생합니다. 지속적인 이용을 위해서는 Opus 5/4.8로의 전환이 필요합니다.fallbacks 파라미터에 "default" 모드가 추가되어, 거절 시의 폴백(Fallback) 모델 선정이 간소화되었습니다.Opus 5로의 전환을 검토하고 있다면, 우선 effort와 thinking의 조합, 그리고 fast mode 사용 여부를 코드베이스에서 확인하는 것부터 시작하면 원활하게 진행할 수 있습니다.