Claude Opus 5.5는 2026년 9월 22일 출시된 Claude 5.5 계열의 첫 모델입니다. Claude API에서는 날짜 접미사 없는 claude-opus-5-5로 바로 호출할 수 있고, 표준 가격은 입력 100만 토큰당 $4, 출력 100만 토큰당 $20입니다. Opus 5의 $5·$25보다 20% 낮고, 캐시 읽기는 $0.50에서 $0.20으로 60% 내려갔습니다. Claude 앱과 Claude Code에서는 Pro·Max·Team 요금제에서 쓸 수 있으며 Free 요금제에는 Opus가 포함되지 않습니다.
Opus 5에서 옮기는 코드라면 모델 ID만 바꾸고 끝낼 수 없습니다. thinking을 끄거나 수동 예산을 주는 요청, tool_choice로 도구 호출을 강제하는 요청은 400 오류를 받습니다. 요청은 성공하지만 화면이나 도구 루프가 조용히 망가지는 응답 변화도 있습니다. 아래 내용은 2026년 9월 24일 기준 Opus 5.5 모델 페이지와 새로운 기능, 마이그레이션 가이드를 따릅니다.
내 경로에서 Opus 5.5를 쓸 수 있나요?
경로마다 넣어야 할 이름과 확인할 점이 다릅니다. API·클라우드 제공 여부는 공식 문서의 가용성 항목에, 요금제별 포함 여부는 claude.com/pricing의 모델 표에 나와 있습니다.
| 경로 | 이용 여부 | 모델 ID 또는 선택 방법 | 확인할 점 |
|---|---|---|---|
| Claude API | 모든 고객 | claude-opus-5-5 | 기본 effort가 medium입니다 |
| Amazon Bedrock | 제공 | anthropic.claude-opus-5-5 | 계정·리전에서 모델 활성화 여부를 콘솔에서 확인 |
| Claude Platform on AWS | 제공 | claude-opus-5-5 | Fast mode는 쓸 수 없음 |
| Google Cloud | 제공 | claude-opus-5-5 | 가격은 Google Cloud가 따로 정함 |
| Microsoft Foundry | 제공 | claude-opus-5-5 | US Data Zone 배포는 1.1배 요금 |
| Claude 앱 Free | 불가 | — | 요금제 표에서 Opus가 No |
| Claude 앱 Pro·Max·Team | 가능 | 모델 메뉴에서 Opus 5.5 | 이전에 Opus 5를 골라 두었다면 그대로 남음 |
| Claude Code | 2.1.280 이상 | /model에서 Opus 선택 | 예전 버전은 예전 기본값을 보여 줌 |
클라우드 세 곳은 문서에 모델 ID가 올라와 있어도 특정 계정과 리전에서 오늘 바로 선택되는지까지 보장하지 않습니다. 콘솔의 모델 목록에서 먼저 확인한 뒤 개발 환경에서 한 번 호출해 보는 순서가 안전합니다.
Claude 앱에서는 9월 22일부터 Pro·Max·Team의 모델 메뉴에 Opus 5.5가 보이고 Free 계정에는 보이지 않는다고 Notebookcheck가 전했습니다. 같은 기사에 따르면 Opus 5는 레거시 모델 목록으로 옮겨졌고, 이전에 Opus 5를 직접 골라 두었던 사람은 선택이 자동으로 바뀌지 않으니 모델 메뉴를 한 번 확인해야 합니다.
Claude Code는 2.1.280 변경 내역에서 Opus 5.5를 기본 Opus 모델로 바꿨습니다. 같은 버전에서 Pro와 Team Standard 요금제의 기본 모델이 Sonnet에서 Opus로 바뀌었고, /effort가 모델별 설정으로 바뀌기 전에 저장해 둔 effort 값은 Opus 5.5에 적용되지 않습니다. 그래서 Opus 5.5는 직접 고를 때까지 기본값 medium으로 시작합니다. 내 버전이 그 이후인지 확인하는 방법은 Claude Code 업데이트 내역: 내 버전 이후 변경 찾기와 롤백에 정리되어 있습니다.
사양도 짧게 짚어 두면, 컨텍스트 윈도우는 베타 헤더 없이 기본 100만 토큰이고 동기 Messages API의 최대 출력은 128K 토큰입니다. Message Batches API에서는 output-300k-2026-03-24 베타 헤더로 300K까지 늘릴 수 있습니다. 입력은 텍스트와 이미지, 출력은 텍스트이며 지식 기준 시점은 2026년 6월입니다. 모델 페이지는 은퇴 시점을 2027년 9월 22일 이전으로 잡지 않으며, Sonnet 5.5와 Haiku 5.5는 몇 주 안에 나온다고만 밝혔습니다.
가격: 토큰 단가 20% 인하와 "40% 절감"은 다른 이야기입니다
아래는 Anthropic이 직접 운영하는 Claude API의 표준 가격이며, 단위는 모두 100만 토큰당 USD입니다. 세금, 도구 사용료, Bedrock·Google Cloud 가격은 포함하지 않습니다. 출처는 Claude 가격 페이지입니다.
| 과금 항목 | Opus 5.5 | Opus 5 | 변화 |
|---|---|---|---|
| 입력 | $4 | $5 | −20% |
| 출력 | $20 | $25 | −20% |
| 5분 캐시 쓰기 | $5 | $6.25 | −20% |
| 1시간 캐시 쓰기 | $8 | $10 | −20% |
| 캐시 읽기 | $0.20 | $0.50 | −60% |
| Batch 입력 / 출력 | $2 / $10 | $2.50 / $12.50 | −20% |
| Fast mode 입력 / 출력 | $8 / $40 | $10 / $50 | −20% |
캐시 읽기 인하 폭이 큰 이유는 배율이 바뀌었기 때문입니다. 다른 모델의 캐시 적중은 기본 입력 단가의 0.1배인데 Opus 5.5는 0.05배로 계산됩니다. 긴 시스템 프롬프트와 코드베이스를 캐시해 두고 여러 턴을 도는 에이전트 작업일수록 이 차이가 커집니다. 최소 캐시 길이는 512토큰입니다.
단가표에 없는 조건도 청구액을 바꿉니다.
inference_geo: "us"로 미국 내 추론을 지정하면 입력·출력·캐시 쓰기·캐시 읽기에 모두 1.1배가 붙습니다. Claude API와 Claude Platform on AWS, Microsoft Foundry의 US Data Zone 배포가 해당합니다.- Bedrock과 Google Cloud는 자체 가격표를 씁니다. 위 표의 숫자를 그대로 옮기지 마세요.
- Fast mode(리서치 프리뷰)는 Claude API에서만 제공되고 Batch와 함께 쓸 수 없습니다.
speed: "fast"와fast-mode-2026-02-01베타 헤더로 켜며, Anthropic은 발표에서 최대 2.5배 속도라고 설명합니다. Claude Code에서도 쓸 수 있습니다.
같은 토큰 수로 다시 계산하면
두 모델이 같은 수의 토큰을 쓴다고 가정하면 단가 차이만 남습니다. 아래 금액은 캐시 쓰기, 도구 사용료, 세금을 제외한 값입니다.
예시 A — 캐시 없이 입력 10만 토큰, 출력 2만 토큰
- Opus 5.5:
0.1 × $4 + 0.02 × $20 = $0.80 - Opus 5:
0.1 × $5 + 0.02 × $25 = $1.00 - 차이 $0.20, 20% 절감
예시 B — 캐시 읽기 20만 토큰, 새 입력 2만 토큰, 출력 5천 토큰(에이전트의 한 턴)
- Opus 5.5:
0.2 × $0.20 + 0.02 × $4 + 0.005 × $20 = $0.04 + $0.08 + $0.10 = $0.22 - Opus 5:
0.2 × $0.50 + 0.02 × $5 + 0.005 × $25 = $0.10 + $0.10 + $0.125 = $0.325 - 차이 $0.105, 약 32% 절감
캐시 비중이 클수록 절감률은 20%에서 60% 쪽으로 움직입니다. 캐시가 없는 요청은 정확히 20%입니다.
"작업당 약 40% 저렴"은 Anthropic의 측정입니다
Anthropic은 기본 설정에서 일반적인 작업을 돌리면 Opus 5보다 40% 적게 든다고 밝혔습니다. 토큰당 가격이 내려간 데다 작업 하나에 쓰는 토큰도 줄었다는 설명이며, 출력 생성 속도는 30% 이상 빨라졌다고 합니다. 테스트에 쓴 작업 구성은 자세히 공개되지 않았으므로, 이 수치는 요청 하나하나에 적용되는 할인이 아니라 Anthropic 측정 결과로 읽어야 합니다.
실제 청구액은 두 방향으로 움직일 수 있습니다.
- 내려가는 쪽:
effort를 지정하지 않은 요청은 Opus 5에서high로 돌았지만 Opus 5.5에서는medium으로 돕니다. 사고량이 줄어드는 만큼 출력 토큰도 줄 수 있습니다. - 올라가는 쪽: 같은 effort에서 Opus 5.5는 턴당 더 많이 사고하는 경향이 있고,
xhigh와max에서 특히 두드러집니다. 사고 토큰은 사고 내용을 화면에 보여 주지 않아도 출력 토큰으로 청구됩니다. Opus 5에서 사고를 꺼 두었던 워크로드는 이제 사고가 항상 켜지므로 요청당 출력 토큰이 늘어날 수 있습니다.
예산을 잡으려면 같은 작업 묶음을 Opus 5와 Opus 5.5에 돌려 입력·캐시·출력 토큰과 완료율을 함께 기록하는 방법이 가장 정확합니다. Claude Code를 API 키로 쓰고 있다면 /cost로 현재 세션의 누적 비용을 볼 수 있습니다. effort 단계별 성능과 비용 자료는 Claude Opus 5.5 effort 설정: 다섯 단계 중 어디서 시작할까?에서, 같은 단가의 다른 모델과 작업비가 갈리는 조건은 Claude Opus 5.5 vs GPT-5.6 Sol: 같은 단가, 다른 작업당 비용에서 이어서 볼 수 있습니다.
구독 요금제에는 이 단가가 적용되지 않습니다
Pro·Max·Team 구독은 토큰이 아니라 사용 한도로 계량하므로 위 API 단가가 월 청구액을 바꾸지 않습니다. Anthropic은 Opus 5.5 출시와 함께 Pro, Max, Team, 좌석 기반 Enterprise의 5시간 사용 한도를 올렸다고 밝혔지만 상향 폭은 공개하지 않았습니다. 구독자에게는 원하는 때 쓸 수 있는 사용량 초기화권도 지급됐습니다. 이 초기화권이 5시간 한도와 주간 한도 중 무엇을 채우는지는 Opus 5.5 사용량 초기화권: 쓸 시점과 Fable 5.1 선택 기준에서, 요금제별 한도 차이는 클로드 Pro·Max 사용량 한도 비교에서 다룹니다.
반대로 API 키로 호출하는 서비스는 구독과 상관없이 토큰 단위로 청구됩니다. Console 크레딧, 구독, 클라우드 IAM 가운데 어떤 경로로 결제할지 정하는 단계라면 Claude API 키 구매 전에 확인할 것이 도움이 됩니다.
Opus 5 코드를 옮길 때 점검할 것
변경 사항은 성격에 따라 세 가지로 나누면 점검하기 쉽습니다. 요청 자체가 400으로 실패하는 것, 요청은 성공하지만 응답 모양이 바뀌어 화면이나 루프가 조용히 망가지는 것, 그리고 플랫폼마다 결과가 다른 것입니다.
400 오류로 실패하는 요청 설정
| Opus 5에서 쓰던 설정 | Opus 5.5 결과 | 바꿀 방법 |
|---|---|---|
thinking: {"type": "disabled"} | 400 invalid_request_error | thinking을 빼거나 {"type": "adaptive"}로 보내고, 사고를 줄이려면 effort를 낮춤 |
thinking: {"type": "enabled", "budget_tokens": N} | 400 invalid_request_error | 위와 같음. 사고 깊이는 output_config.effort로만 조절 |
tool_choice: {"type": "any"} 또는 {"type": "tool", "name": ...} | 400, 토큰 카운팅 엔드포인트도 같음 | auto(기본값)나 none만 허용. 스키마가 필요하면 엄격한 도구 사용(strict: true)이나 구조화된 출력 |
computer_20251124 도구(Claude API, Google Cloud) | 400 | 베타 헤더를 빼고 {"type": "computer_toolset_20260801"}로 교체한 뒤 에이전트 루프 수정 |
이전 메시지·system·tools를 고친 뒤 사고 블록 재전송 | 2026년 8월 31일 00:00 UTC 이후 생성된 계정은 기본 400 | 대화를 추가 전용으로 유지하고, 지시 변경은 대화 중 시스템 메시지로 |
오류 메시지는 원인을 그대로 알려 줍니다. thinking 문제라면 "thinking.type.disabled" is not supported for this model., 도구 강제라면 tool_choice: type "tool" and "any" are not supported for this model., 컴퓨터 사용 도구라면 'claude-opus-5-5' does not support tool types: computer_20251124.로 시작합니다.
Opus 5에서 사고를 켠 채 돌리던 코드라면 thinking 항목은 바꿀 것이 없습니다. 흔한 수정은 아래처럼 사고를 끄고 특정 도구를 강제하던 요청입니다. 일부 필드만 보여 주는 조각입니다.
// Opus 5: 두 설정 모두 Opus 5.5에서 400
{
"model": "claude-opus-5",
"thinking": { "type": "disabled" },
"tool_choice": { "type": "tool", "name": "extract_invoice" }
}// Opus 5.5: thinking은 생략, 사고량은 effort로, 도구는 auto + strict
{
"model": "claude-opus-5-5",
"output_config": { "effort": "low" },
"tool_choice": { "type": "auto" },
"tools": [{ "name": "extract_invoice", "strict": true, "input_schema": { } }]
}auto는 매 턴 도구 호출을 보장하지 않습니다. 강제 호출에 기대던 흐름은 프롬프트에 "어떤 경우에 이 도구를 써야 하는지"를 적고 다시 시험해야 합니다. 사고를 꺼 두었던 워크로드라면 max_tokens가 사고와 응답 텍스트를 합친 양에 걸린다는 점도 다시 보세요. 공식 가이드는 xhigh나 max에서 64K부터 시작하라고 권합니다.
Opus 5보다 오래된 모델에서 바로 옮긴다면 두 가지가 더 있습니다. temperature, top_p, top_k를 기본값이 아닌 값으로 보내면 400이 나고(Opus 4.6 이하에서 온 코드), 마지막 어시스턴트 턴을 미리 채우는 prefill도 400입니다(Opus 4.5 이하에서 온 코드). Opus 4.8에서 Priority Tier를 쓰던 조직은 Opus 5.5가 Priority Tier를 지원하지 않으므로 용량을 따로 계획해야 합니다.
오류 없이 조용히 바뀌는 것
도구 호출 사이의 텍스트가 사라집니다. Opus 5에서는 모델이 도구 호출 사이에 쓰던 짧은 설명이 text 블록으로 왔습니다. Opus 5.5에서는 각 도구 호출 앞에 최대 하나씩 진행 상황 thinking 블록으로 오고, 기본값 display: "omitted"에서는 그 내용이 비어 있습니다. 이 텍스트를 사용자에게 보여 주던 화면은 오류 없이 조용해집니다. thinking.display를 "updates"(베타, thinking-display-updates-2026-08-18 헤더, 진행 상황만)나 "summarized"(진행 상황과 추론 요약)로 두고, 비어 있지 않은 thinking 블록을 바로 뒤의 tool_use보다 먼저 그리면 됩니다.
응답 첫 블록이 텍스트가 아닐 수 있습니다. 모든 응답이 thinking 블록으로 시작할 수 있으므로 content[0].text처럼 위치로 읽는 코드, 첫 content_block_start 이벤트를 텍스트로 취급하는 스트림 처리기가 깨집니다. 블록은 type으로 고르세요.
# 위치가 아니라 type으로 텍스트를 읽습니다
text = "".join(b.text for b in response.content if b.type == "text")
# 도구 루프에서는 어시스턴트 턴을 받은 그대로 돌려보냅니다
messages.append({"role": "assistant", "content": response.content})도구 루프에서 thinking 블록을 유형별로 걸러 내거나 순서를 바꾸거나 일부만 보내면 400이 납니다. 내용이 빈 블록까지 포함해 받은 그대로 돌려보내야 합니다.
모델을 바꾸면 사고 블록이 버려질 수 있습니다. Opus 5.5는 Opus 5와 그 이전 Opus·Sonnet·Haiku의 사고 블록을 읽지만 Fable과 Mythos 모델의 블록은 읽지 못합니다. 반대로 Claude API에서 Opus 5.5의 사고 블록을 읽을 수 있는 다른 모델은 Fable 5.1과 Mythos 5.1뿐입니다. 읽을 수 없는 블록은 요청 전에 조용히 제거되고 요청은 성공하며, 제거된 블록은 과금되지 않습니다. 라우터나 폴백으로 대화 중간에 모델을 바꾸는 서비스라면 전환 이후 턴이 이전 추론 없이 돈다는 점을 전제로 두세요. thinking-binding-controls-2026-08-01 베타 헤더를 보내면 제거 내역이 input_transformations에 기록됩니다.
거부가 오류가 아니라 정상 응답으로 옵니다. 안전 분류기가 요청을 거부하면 HTTP 200에 stop_reason: "refusal"이 붙고, stop_details.category에 cyber, bio, reasoning_extraction 가운데 하나가 담깁니다. Opus 5보다 생물학 분류기와 reasoning_extraction 카테고리가 추가됐습니다. 상태 코드만 보는 코드는 거부를 성공으로 처리하므로 stop_reason을 확인하고 폴백을 준비해야 합니다. 서버 측 폴백(fallbacks: "default", 베타), SDK 미들웨어, 자체 재시도 중에서 고를 수 있으며, 서버 측 폴백은 reasoning_extraction 거부를 재시도하지 않습니다. Anthropic은 대부분의 사이버 보안 작업이 Opus 4.8로 돌려진다고 밝혔습니다. 자세한 처리 방법은 거부 및 폴백 문서에 있습니다.
effort 기본값이 바뀝니다. 앞서 말한 대로 effort를 생략한 요청은 medium으로 돕니다. 품질을 유지해야 하는 요청은 effort를 명시하고, 선택한 수준에서 비용과 지연 시간 기준선을 새로 잡으세요.
플랫폼마다 다른 것
- 컴퓨터 사용:
computer_20251124는 Claude API와 Google Cloud에서만 400입니다. Amazon Bedrock에서는 Opus 5에서처럼 계속 작동하므로 바꿀 필요가 없고, 그 밖의 플랫폼은 컴퓨터 사용 도구 문서의 호환성 항목을 확인해야 합니다. 도구 세트를 쓰면 요청마다 입력 토큰이 약 4,500개 늘어납니다. 브라우저 사용 도구와 이미 도구 세트를 쓰는 통합은 바꿀 것이 없습니다. - 모델 ID: Bedrock만
anthropic.claude-opus-5-5이고 나머지는claude-opus-5-5입니다. - Fast mode: Claude API 전용입니다. Bedrock, Claude Platform on AWS, Google Cloud, Microsoft Foundry에서는 쓸 수 없습니다.
- 가격: Bedrock과 Google Cloud는 자체 가격,
inference_geo: "us"와 Foundry US Data Zone은 1.1배입니다.
옮기는 순서
- 범위를 정합니다. Claude Managed Agents는 모델 이름만 바꾸면 됩니다. Messages API를 직접 호출하는 코드가 대상입니다.
- 자동 도구를 먼저 돌려 봅니다. Claude Code에서
/claude-api migrate this project to claude-opus-5-5를 실행하면 번들로 제공되는 Claude API 스킬이 모델 ID 교체, 호환성이 깨지는 매개변수 수정, effort 보정을 적용하고 수동 확인 목록을 만듭니다. 파일을 고치기 전에 범위(작업 디렉터리 전체, 하위 디렉터리, 특정 파일)를 묻고, Bedrock과 Claude Platform on AWS 클라이언트는 해당 플랫폼 형식에 맞춰 줍니다. - 400 항목을 없앱니다. 위 표의 설정을 코드에서 검색해 고칩니다.
- 응답 처리 코드를 고칩니다. 블록을
type으로 읽고, 도구 루프에서 블록을 그대로 돌려보내고, 진행 상황을 보여 주는 화면이라면thinking.display를 설정하고,stop_reason: "refusal"처리를 넣습니다. - effort를 명시하고 다시 잽니다. 개발 환경에서 평소 트래픽을 대표하는 요청으로 effort 단계별 비용·지연 시간·품질을 확인한 뒤 프로덕션 트래픽을 옮깁니다.
공식 마이그레이션 체크리스트에서 Opus 5 사용자는 첫 번째 그룹 "모든 시작 모델"만 적용하면 됩니다. thinking과 tool_choice 변경은 Fable 5.1이 먼저 겪은 변화이기도 해서, 해당 전환을 이미 해 봤다면 Claude Fable 5.1: API 가격·변경점·마이그레이션 가이드의 경험을 그대로 쓸 수 있습니다.
자주 묻는 질문
무료 요금제에서 Opus 5.5를 쓸 수 있나요?
쓸 수 없습니다. 2026년 9월 24일 기준 claude.com/pricing의 모델 표에서 Opus는 Free가 No, Pro·Max 5x·Max 20x가 Yes입니다. Free 요금제에서는 Sonnet과 Haiku를 쓸 수 있습니다. API는 요금제와 별개로 모든 고객이 claude-opus-5-5를 호출할 수 있지만 토큰 단위로 과금됩니다.
Opus 5.5와 Opus 5 중 무엇이 더 나은가요?
Anthropic은 Opus 5.5가 대부분의 작업에서 Fable 5.1 수준의 성능을 낸다고 발표했고, 가격은 모든 토큰 항목에서 Opus 5보다 낮습니다. 다만 사고를 끌 수 없고 도구 호출을 강제할 수 없으므로, 이 두 가지에 기대는 워크로드는 옮기기 전에 흐름을 다시 설계해야 합니다. Opus 5.5와 Fable 5.1 가운데 무엇으로 시작할지는 Opus 5.5 vs Fable 5.1: Claude API 모델을 비용과 성능으로 고르는 법에서 비교합니다.
Opus 5.5에서 effort를 매번 max로 써야 하나요?
그럴 필요는 없습니다. 기본값은 medium이고, Opus 5.5는 같은 effort에서도 Opus 5보다 더 많이 사고하는 경향이 있어 max는 출력 토큰과 지연 시간을 크게 늘릴 수 있습니다. 작업별로 낮은 단계부터 올려 가며 품질이 유지되는 지점을 찾는 편이 비용 면에서 유리합니다. 단계별 자료는 Claude Opus 5.5 effort 설정에 있습니다.
한국어로 쓰면 토큰이 더 많이 나오나요?
Anthropic은 언어별 토큰 배율을 공개하지 않습니다. 가격 페이지에 적힌 것은 Opus 4.7부터 쓰는 새 토크나이저가 같은 텍스트에 대해 이전 토크나이저보다 토큰을 약 30% 더 만든다는 점뿐이며, 증가 폭은 내용에 따라 다르다고 합니다. Opus 5와 Opus 5.5는 같은 새 토크나이저를 쓰므로 두 모델의 비용 비교 비율에는 영향이 없습니다. 내 한국어 프롬프트가 몇 토큰인지는 토큰 카운팅 엔드포인트로 직접 재는 방법이 가장 정확합니다.
캐시 쓰기 비용은 언제 회수되나요?
Opus 5.5에서 5분 캐시 쓰기는 입력 단가의 1.25배($5), 캐시 읽기는 0.05배($0.20)입니다. 같은 내용을 한 번만 다시 읽어도 쓰기 할증분 $1보다 절감분 $3.80이 커서 캐시 쓰기 비용이 회수됩니다(100만 토큰 기준, $4 + $4 = $8 대 $5 + $0.20 = $5.20). 1시간 캐시($8, 2배)는 한 번 다시 읽으면 $8 대 $8.20으로 거의 같고 두 번째 읽기부터 이득입니다. 손익분기를 계산하는 구조는 OpenAI vs Claude 캐시 과금에 정리되어 있으며, 그 글의 숫자는 이전 가격 기준이므로 계산 방식만 참고하세요.
