Claude Opus 4.8 빠른 모드 종료: 11월 30일 전에 Opus 5.5로 이전
Opus 4.8 빠른 모드는 2026년 11월 30일에 제거됩니다. 이후 해당 요청은 표준 속도로 자동 전환되지 않고 오류를 반환합니다. 모델과 속도 설정을 찾아 Opus 5.5로 이전하고, 빠른 모드용 beta 헤더를 제거한 뒤 usage.speed를 확인합니다. 직접 Claude API를 사용할 때의 가격과 전용 한도를 비교하고 Claude Code를 업데이트합니다. 복구할 때 사용할 표준 속도 구성도 준비합니다.
목차
Claude Opus 4.8의 빠른 모드에 대한 지원 중단이 공지되었습니다. 2026년 11월 30일 전에 claude-opus-4-8과 speed: "fast"를 함께 쓰는 요청을 claude-opus-5-5로 이전해야 합니다. 제거 이후에는 기존 조합이 표준 속도로 자동 전환되지 않고 오류를 반환합니다.
Anthropic은 10월 30일 릴리스 노트에서 이 기한을 발표했습니다. Claude Code v2.1.316 릴리스는 표준 속도로 자동 전환되지 않는다는 점을 명시합니다.
이번 변경은 속도 옵션 하나를 제거하는 조치입니다. 2026-11-02 기준 모델 수명 주기 표는 claude-opus-4-8을 여전히 Active로 표시합니다. 모델의 잠정 종료 시점은 2027년 5월 28일보다 이르지 않습니다. 이 모델을 계속 사용해야 한다면 빠른 모드 설정을 제거하고 표준 속도 요청이 정상적으로 작동하는지 검증합니다.
아래 절차는 Anthropic의 Messages API를 직접 사용하는 경우를 대상으로 합니다. Claude Code 사용자가 확인해야 할 설정도 별도로 다룹니다.
1. 코드와 배포 설정에서 영향받는 요청을 찾습니다
모델 설정과 속도 설정을 각각 찾은 뒤, 애플리케이션이 두 값을 어디에서 합치는지 추적합니다. 서로 다른 파일이나 환경 변수, 게이트웨이 규칙에서 값을 가져올 수 있습니다.
ripgrep을 설치한 상태에서 저장소 최상위 디렉터리의 Bash 셸로 다음 검색을 실행합니다.
rg -l --hidden --no-ignore \
-g '!.git' \
-g '!node_modules' \
-g '!.venv' \
-e 'claude-opus-4-8' \
-e 'fast-mode-2026-02-01' \
-e 'fastMode' \
-e 'speed' .이 명령은 설정 내용 대신 파일 이름을 출력합니다. 숨김 파일과 무시된 파일도 검색하므로 로컬에서 덮어쓴 설정을 찾는 데 도움이 됩니다. 각 검색 결과는 직접 확인해야 합니다. 이름이 speed인 일반적인 설정은 다른 기능에 쓰일 수도 있습니다.
저장소 밖에 있는 다음 설정도 확인합니다.
- 배포 환경 변수와 CI 작업 설정
- 에이전트의 기본 모델과 대체 모델 목록
- 게이트웨이의 모델 매핑과 요청 변환 규칙
- Claude Code의 사용자 설정, 프로젝트 설정, 관리자 설정
최종 전송 요청에 기존 모델 ID와 speed: "fast"가 모두 포함되는지 확인합니다. 모델 이름만 있는 사용량 보고서로는 해당 요청이 빠른 모드를 사용했는지 판단할 수 없습니다.
영향받는 서비스마다 담당자, 설정 출처, 요청 모델, 요청 속도, 되돌릴 구성을 기록합니다. 이 점검 기록에는 인증 정보나 프롬프트 내용을 넣지 않습니다.
2. 모델을 바꾸고 호환되지 않는 설정을 점검합니다
Opus 5.5에서는 speed: "fast"를 유지하고 빠른 모드에만 쓰던 beta 값을 제거합니다. Anthropic의 Opus 5.5 기능 문서는 이 모델에 해당 beta 헤더가 필요하지 않다고 명시합니다.
anthropic-beta에 여러 기능의 값이 들어 있다면 fast-mode-2026-02-01만 제거합니다. 다른 기능에 필요한 값은 그대로 유지합니다.
기존 작업을 새 모델로 보내기 전에 다음 설정을 확인합니다.
| 설정 또는 동작 | Opus 5.5에서 해야 할 작업 |
|---|---|
model | claude-opus-5-5로 설정합니다. |
speed | 빠른 모드가 필요하면 "fast"를 유지합니다. |
thinking | 생략하거나 {"type":"adaptive"}를 사용합니다. 추론을 끄는 설정과 수동 예산을 지정하는 enabled 설정은 거부됩니다. |
tool_choice | {"type":"auto"} 또는 {"type":"none"}를 사용합니다. 강제 선택인 any와 이름으로 도구를 지정하는 tool은 거부됩니다. |
temperature, top_p, top_k | 이 매개변수를 생략합니다. |
| 어시스턴트 응답 시작 부분 미리 채우기 | 다음 응답의 시작 부분으로 사용하던 불완전한 어시스턴트 메시지를 제거합니다. |
| 응답 처리 | type으로 텍스트 블록을 선택합니다. content[0].text에 답변이 있다고 가정하지 않습니다. |
이 항목들은 Opus 5.5 마이그레이션 가이드의 요청 점검 사항입니다. 일부 제한은 이전 모델에도 이미 적용됩니다. 다만 요청을 만드는 공통 코드가 이전 과정에서 호환되지 않는 매개변수를 다시 추가할 수 있습니다.
애플리케이션이 특정 도구 호출을 반드시 요구한다면 강제 선택을 auto로 바꿀 때 그 보장도 달라집니다. 애플리케이션의 검증 로직을 수정하고, 배포 전에 해당 실행 경로를 테스트해야 합니다.
Opus 5.5는 적응형 추론을 항상 활성화합니다. 추론과 화면에 표시되는 텍스트가 같은 예산을 쓰므로 max_tokens를 다시 확인합니다. 추론 깊이는 output_config.effort로 조절합니다.
도구 결과를 모델에 돌려주는 반복 과정에서는 어시스턴트 메시지 전체를 보존합니다. 추론 블록도 함께 유지해야 합니다. 표시할 텍스트만 골라내더라도 모델에 다시 보내는 대화 내용은 바꾸면 안 됩니다. 대화 기록을 다시 작성하거나 컴퓨터 제어 도구를 사용하는 애플리케이션은 마이그레이션 가이드의 별도 점검 항목도 확인합니다.
3. 요청 하나를 보내고 실제 처리 속도를 확인합니다
운영 트래픽을 옮기기 전에 성공한 응답의 usage.speed를 확인합니다. 요청 필드는 원하는 속도를 나타내고, 응답 필드는 실제 사용된 속도를 나타냅니다.
Bash, jq, --fail-with-body를 지원하는 curl이 필요합니다. 빠른 모드에 접근할 수 있는 Anthropic 직접 발급 Claude API 키를 사용합니다. 2026-11-02 기준 Opus 5.5에는 Start, Build, Scale 등급의 기본 빠른 모드 한도가 있습니다. Evaluation 등급의 조직은 사용 가능한 등급으로 이동해야 합니다.
다음 예제는 현재 Messages API 요청 형식을 사용합니다. 스트리밍 없이 요청하고, 응답을 저장한 뒤 검증하여 텍스트를 출력합니다.
read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY
curl --silent --show-error --fail-with-body \
--max-time 600 \
--dump-header fast-headers.txt \
--output fast-response.json \
https://api.anthropic.com/v1/messages \
-H "Authorization: Bearer $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2026-10-21" \
-H "Content-Type: application/json" \
--data '{
"model": "claude-opus-5-5",
"max_tokens": 4096,
"speed": "fast",
"stream": false,
"output_config": {"effort": "low"},
"messages": [
{
"role": "user",
"content": "Explain a cache hit in one sentence."
}
]
}' &&
jq -e '
.type == "message"
and .model == "claude-opus-5-5"
and .usage.speed == "fast"
and .stop_reason == "end_turn"
and any(
.content[]?;
.type == "text" and (.text | length > 0)
)
' fast-response.json &&
jq -r '.content[] | select(.type == "text") | .text' fast-response.json정상 검증 시 예상 출력은 true이며, 그다음 모델의 답변이 표시됩니다. 이는 성공 판정 조건이며 실제로 실행해서 기록한 결과는 아닙니다.
&& 연산자는 실패한 요청이 성공 여부 검증 단계로 넘어가지 않도록 합니다. 예제의 4096 예산과 low 추론 수준은 이 작은 테스트를 위해 선택한 값입니다. 빠른 모드를 사용하기 위한 필수 값은 아닙니다.
예제에는 anthropic-version: 2026-10-21이 설정되어 있습니다. 기존 연동에서 이 헤더를 바꾸기 전에는 별도의 API 버전 마이그레이션 가이드를 확인합니다.
curl이 실패하면 오류와 새로 저장된 응답 본문을 확인합니다. 요청이 성공했는데 검증에 실패했다면 model, usage.speed, stop_reason, content를 살펴봅니다.
빠른 모드로 처리된 응답도 max_tokens에 도달할 수 있습니다. 종료 사유 안내에 따라 출력 예산이나 추론 수준을 조정합니다. 속도 정보가 없거나 "standard"라면 이 빠른 모드 검증을 통과한 것으로 볼 수 없습니다.
2026-11-02 기준 BetterToken은 claude-opus-4-8과 claude-opus-5-5를 모두 모델 목록에 표시합니다. Messages 참조 문서에는 https://www.bettertoken.ai/v1/messages가 안내되어 있습니다. 이 경로로 이전하기 전에는 빠른 모드 설정 전달, usage.speed 반환, 과금 방식을 확인해야 합니다. 해당 서비스 문서의 인증 방식을 사용합니다. 모델 목록에 있다는 사실만으로 빠른 모드 지원을 확인할 수는 없습니다.
4. 용량 부족 오류와 마이그레이션 오류를 구분합니다
동시 요청 수는 빠른 모드 전용 한도를 기준으로 계획합니다. 표준 속도의 Opus 한도로 빠른 모드의 가용 용량을 판단할 수 없습니다.
레이트 리밋 문서는 실제 허용량을 확인할 곳으로 조직의 Console 한도 페이지를 안내합니다. Opus 4.8에서 쓰던 동시 요청 설정이 Opus 5.5에서도 그대로 맞는다고 가정하면 안 됩니다.
저장된 응답 헤더에서 anthropic-fast-input-tokens-remaining과 anthropic-fast-output-tokens-remaining을 확인합니다. 입력 토큰과 출력 토큰 중 어느 쪽의 한도가 부족한지 구분하는 데 도움이 됩니다.
실패 원인별로 처리 방식을 명확하게 정합니다.
retry-after가 있는 빠른 모드429: 안내된 시간만큼 기다립니다. 표준 속도가 허용된다면speed: "fast"를 빼고 다시 요청할 수도 있습니다.- 지출 상한 때문에 발생한
429: 지출 한도 문제를 해결합니다. 속도를 바꿔도 소진된 예산이 복구되지는 않습니다. - 과부하
529: 재시도 횟수를 제한하고 대기 시간을 늘립니다. 다른 속도로 바꾸면 반드시 성공한다고 가정하지 않습니다. - 잘못된 매개변수 또는 제거된 Opus 4.8 빠른 모드 조합: 요청을 수정합니다. 같은 요청을 반복해서 보내는 것으로는 이전을 완료할 수 없습니다.
Anthropic은 빠른 모드의 한도 오류에 대해 애플리케이션에서 표준 속도로 전환하는 방법을 설명합니다. 이 방법을 선택했다면 재요청의 응답이 "standard"를 보고하는지 확인합니다.
가능하면 재시도 제한은 한 계층에서 관리합니다. SDK 자체 재시도 위에 별도의 반복문을 더하면 요청 수와 지연 시간이 늘어날 수 있습니다. 구체적인 구현은 안전한 Retry-After 처리와 지수 백오프 가이드에서 다룹니다.
5. 같은 토큰 사용량으로 비용을 비교합니다
Opus 5.5의 공개된 빠른 모드 토큰 요금은 Opus 4.8보다 낮습니다. 다만 Opus 5.5의 표준 속도보다는 토큰당 요금이 높습니다.
아래는 2026-11-02 기준 Anthropic 직접 제공 Claude API의 USD 요금입니다. MTok은 토큰 100만 개를 뜻합니다.
| 구성 | 입력 MTok당 | 출력 MTok당 |
|---|---|---|
| Opus 4.8 빠른 모드 | $10 | $50 |
| Opus 5.5 빠른 모드 | $8 | $40 |
| Opus 5.5 표준 속도 | $4 | $20 |
빠른 모드 요금은 Anthropic의 가격표를 기준으로 합니다. 표준 속도 요금은 Opus 5.5 모델 페이지에서도 확인할 수 있습니다.
입력 1 MTok과 전체 출력 0.2 MTok을 처리한다고 가정하면 예상 토큰 비용은 다음과 같습니다.
Opus 4.8 fast: 1 × $10 + 0.2 × $50 = $20
Opus 5.5 fast: 1 × $8 + 0.2 × $40 = $16
Opus 5.5 standard: 1 × $4 + 0.2 × $20 = $8
Fast-to-fast reduction at fixed token usage:
($20 - $16) / $20 = 20%이 계산은 캐시를 사용하지 않는 입력을 가정합니다. 유료 서버 도구나 데이터 상주 지역에 따른 추가 요금도 없다고 가정합니다. 세금, 크레딧, 계정별 할인은 제외합니다. 캐시와 데이터 상주 지역에 따른 요금 조정은 따로 계산해야 합니다.
20%라는 결과는 토큰 사용량을 고정했을 때만 적용됩니다. 실제 작업 완료 비용도 20% 줄어든다는 뜻은 아닙니다. Opus 5.5의 추론 토큰은 화면에 표시되지 않더라도 출력 토큰으로 과금됩니다. 따라서 이전에 추론 없이 처리하던 작업은 전체 출력 토큰 수가 달라질 수 있습니다.
대표적인 작업에서 검증을 통과한 결과, 토큰 비용, 재시도 횟수, 경과 시간을 함께 측정합니다. 생성 속도 향상이 사용자 경험을 실질적으로 개선하는 곳에 빠른 모드를 유지합니다. 도구나 외부 서비스가 완료 시간의 대부분을 차지하는 백그라운드 작업에서는 표준 속도를 먼저 테스트합니다.
6. Claude Code의 모델 선택과 빠른 모드 설정을 바꿉니다
Opus 5.5를 명시적으로 선택한 뒤 빠른 모드 스위치를 확인합니다. Claude Code를 업데이트했다는 사실만으로 저장된 모델 지정도 바뀌었다고 볼 수는 없습니다.
모델 설정 문서에 따르면 Opus 5.5에는 Claude Code v2.1.280 이상이 필요합니다.
네이티브 설치 방식을 사용했다면 Bash에서 다음 명령을 실행합니다.
claude update
claude --version
claude패키지 관리자로 설치했다면 설치 문서에 안내된 해당 패키지 관리자의 업데이트 명령을 사용합니다.
Claude Code 대화형 세션 안에서는 다음을 실행합니다.
/model claude-opus-5-5
/fast
/status/fast에서 스위치를 바꿔야 한다면 Space를 누른 뒤 Enter로 확정합니다. 문서에 안내된 활성화 상태는 Fast mode ON과 ↯ 아이콘으로 표시됩니다. /status로 선택된 모델을 확인합니다.
~/.claude/settings.json, .claude/settings.json, .claude/settings.local.json에서 모델을 덮어쓰는 설정을 확인합니다. ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, 시작 옵션, 관리자 설정도 살펴봅니다. 설정 파일 전체를 교체하지 않고 기존 키를 수정합니다.
한 번 다시 시작한 뒤 모델을 재확인합니다. 재개한 세션이나 우선순위가 더 높은 설정 때문에 이전 모델 선택이 유지될 수 있습니다.
Claude Code의 빠른 모드 동작에는 빠른 모드 한도에 걸려 대기하는 동안 표준 속도로 자동 전환하는 기능이 포함됩니다. 이 동작이 Opus 4.8 빠른 모드 요청의 제거 공지를 무효화하지는 않습니다.
계정 한도로 변경이 막힌다면 먼저 Claude Code 구독 한도와 API 429 오류를 구분합니다.
7. 복구할 수 있는 구성을 준비하고 점진적으로 적용합니다
요청 검증과 애플리케이션의 결과 검증을 모두 통과한 뒤에만 일부 트래픽을 옮깁니다.
일반 텍스트 요청을 검증에 포함합니다. 도구를 사용하는 애플리케이션이라면 대표적인 도구 상호작용도 확인합니다. 평소 출력 예산에 가까운 작업도 별도로 테스트합니다. 새 모델의 사용 가능한 결과를 기존 구성과 비교합니다. 속도 검증, 오류 수, 토큰 비용, 전체 완료 시간을 관찰합니다.
복구할 때 사용할 수 있도록 이전에 검증한 표준 속도 구성을 유지합니다. 11월 30일 이후에는 claude-opus-4-8과 speed: "fast"를 다시 설정해도 정상적인 복구 경로가 되지 않습니다.
배포된 서비스의 요청을 다시 확인해 이전을 마무리합니다. 최종적으로 어떤 운영 경로에서도 제거된 모델과 속도의 조합을 만들 수 없어야 합니다.
