2026년 7월 25일, Anthropic의 Claude API에 관한 여러 업데이트가 발표되었습니다. 그중에서도 가장 주의가 필요한 것이 바로 Claude Opus 4.7의 fast mode 폐지입니다.

지금까지 claude-opus-4-7에 speed: "fast"를 지정하면 고속 응답을 얻을 수 있었으나, 이 기능이 삭제되어 해당 요청은 폴백(fallback) 없이 에러를 반환하게 되었습니다. 이전 버전인 Claude Opus 4.6에서는 속도 지정이 무효하더라도 표준 속도로 자동 폴백되었기 때문에, 동일한 감각으로 업그레이드나 운용을 계속하고 있다면 운영 환경에서 갑자기 에러가 발생할 가능성이 있습니다.

이와 함께, 대화 도중에 툴(tool)을 추가·삭제해도 프롬프트 캐시(prompt cache)를 유지할 수 있는 베타 기능의 대상 모델이 확대된 점과, effort 파라미터(parameter)에 관한 문서 문구의 명확화에 대해서도 소개합니다.

📌 영향을 받는 사람

• claude-opus-4-7을 speed: "fast"와 함께 호출하고 있는 애플리케이션·에이전트 개발자
• Claude Opus 4.6에서 이전을 예정하고 있거나 이미 이전을 완료한 팀
• 동적으로 툴 세트(tool set)를 전환하는 에이전트를 Claude Fable 5 / Mythos 5 / Opus 4.8로 구축하고 있는 개발자

fast mode의 지원 상황을 모델 세대별로 정리하면 다음과 같습니다.

또 다른 변경 사항인 '대화 도중의 툴 변경 베타'의 대상 확대는 캐시 유지 메커니즘으로서 다음과 같이 동작합니다.

이번 업데이트에 포함된 변경 사항을 정리합니다.

⚠️ Breaking Change

claude-opus-4-7에 대해 speed: "fast"를 지정한 요청은 이전처럼 표준 속도로 폴백되지 않고 즉시 에러가 발생합니다. claude-opus-4-7 자체는 표준 속도라면 계속 이용 가능합니다.

대상 모델과 동작의 차이는 다음과 같습니다.

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

기존에 Claude Opus 5 한정으로 베타 제공되던 '대화 턴(turn) 간의 툴 추가·삭제 시 프롬프트 캐시를 유지하는' 기능이 다음 모델에서도 이용 가능해졌습니다.

• Claude Fable 5
• Claude Mythos 5
• Claude Opus 4.8
• Claude Opus 5

이용을 위해서는 요청에 베타 헤더 mid-conversation-tool-changes-2026-07-01를 포함해야 합니다. 동적으로 툴을 전환하는 에이전트(예: 사용자의 권한이나 태스크 내용에 따라 툴 세트를 바꾸는 설계)에서는 캐시 재사용을 통한 비용 및 레이턴시(latency) 개선을 기대할 수 있습니다.

기능 자체의 변경은 없으나, 문서상에서 "effort는 Claude Opus 5를 제어하는 **주요 수단 (primary control)**이다"라고 명시되었습니다. low / medium / high / xhigh / max의 모든 단계를 지원하며, capability(역량)가 중요한 태스크에는 max를 사용하는 것이 권장됩니다.

필수 대응 (change-001)

• 코드베이스 전체에서 claude-opus-4-7과 speed: "fast"의 조합을 검색하여 식별합니다.
• fast mode를 유지하고 싶은 부분은 모델 지정(model specification)을 claude-opus-5 또는 claude-opus-4-8로 변경합니다.
• fast mode가 필요하지 않다면 speed 파라미터 자체를 삭제하고, claude-opus-4-7을 표준 속도로 계속 사용합니다.
• CI 또는 스테이징(staging) 환경에서 speed: "fast" + claude-opus-4-7 요청이 통과되고 있지 않은지 사전에 확인합니다.

💡 Tips

Claude Opus 4.6에서 "speed 지정이 적용되지 않아도 작동했던" 경우, Opus 4.7로 업그레이드할 때 이 에러를 처음 인지하는 사례가 많습니다. 모델 이관 시에는 반드시 speed 파라미터 조합을 회귀 테스트 (regression test)에 포함시키십시오.

임의 대응 (change-002)

• 동적으로 툴셋 (toolset)을 전환하는 에이전트를 Claude Fable 5 / Mythos 5 / Opus 4.8 / Opus 5에서 운용하고 있는 경우, 베타 헤더(beta header) mid-conversation-tool-changes-2026-07-01를 추가하여 캐시 유지 (cache maintenance)의 이점을 검증합니다.

대응 불필요 (change-003)

• 문서 문구 변경일 뿐이므로, 기존의 effort 설정은 변경할 필요가 없습니다.

import anthropic
client = anthropic.Anthropic()
# 지금까지는 작동했을 것으로 예상되는 요청
...

이 요청은 향후 **에러 (error)**가 됩니다.

import anthropic
client = anthropic.Anthropic()
# fast mode를 유지하고 싶은 경우 Opus 5 / Opus 4.8로 이관
...

import anthropic
client = anthropic.Anthropic()
# speed 파라미터를 제거하고 표준 속도로 이용
...

response = client.messages.create(
    model="claude-fable-5", # Fable 5 / Mythos 5 / Opus 4.8 / Opus 5에서 이용 가능
    max_tokens=1024,
    ...
)

Claude Opus 4.7의 fast mode는 폐지되었으며, speed: "fast" 지정 요청은 폴백 (fallback) 없이 에러가 발생합니다. fast mode를 지속하고 싶다면 Claude Opus 5 또는 Opus 4.8로의 이관이 필수적입니다.

• Claude Opus 4.7 자체는 표준 속도라면 계속 이용 가능하므로, speed 파라미터를 제거하는 것만으로 해결되는 경우도 있습니다.
• 대화 도중의 툴 변경을 동반하는 프롬프트 캐시 (prompt cache) 유지 베타가 Claude Fable 5 · Mythos 5 · Opus 4.8 · Opus 5로 확대되었으며, 베타 헤더를 부여하는 것만으로 이용할 수 있습니다.

effort 파라미터에 대해서는 기능 변경이 없으며, 문서상의 위치가 명확해졌을 뿐입니다.

특히 fast mode의 파괴적 변경 (breaking change)은 모델 이관 시 에러로서 처음 현상화되기 쉬우므로, 릴리스 전에 요청 조합을 반드시 확인해 두시기 바랍니다.