클로드 오퍼스 5.5 전환 가이드, 체크리스트 4가지

안녕하세요👋 워크플로우 아키텍트, 수월한입니다.

2026년 9월 22일, 앤트로픽이 클로드 오퍼스 5.5를 출시했습니다. 지난 7월 24일 오퍼스 5가 나온 지 약 두 달 만이고, 앤트로픽이 "속도 조절(pacing the frontier)"을 공식 선언한 뒤 나온 첫 모델이라 업계에서도 다소 놀란 눈치입니다.

그런데 혹시 새 모델 소식을 보자마자 코드의 모델 이름부터 claude-opus-5-5로 바꿔보신 적 있으신가요? 그리고 다음 날 아침 에러 로그를 보고 "어제까진 멀쩡했는데" 하며 당황해보신 적은요?

가격표만 보면 이번 전환은 단순해 보입니다. 입력 토큰은 20% 싸지고 출력 속도는 30% 이상 빨라졌으니 모델 이름만 바꾸면 끝나는 일처럼 보입니다. 하지만 실제로는 다릅니다. 씽킹(thinking)을 끄던 코드, 특정 도구를 강제로 호출하던 코드, 진행 상황을 실시간으로 보여주던 화면까지 조용히 동작 방식이 바뀌는 지점이 최소 4곳 있습니다. 겉보기엔 매끈한 업그레이드지만 속을 들여다보면 단차가 숨어 있는 셈입니다.

오늘은 오퍼스 5.5로 넘어갈 때 실제로 무엇이 깨지는지, 그리고 언제 전환하고 언제 미뤄도 되는지를 체크리스트로 정리해드리겠습니다.

 

오늘의 핵심 요약

• 핵심 변화: 클로드 오퍼스 5.5가 9월 22일 출시되며 가격은 20%, 캐시 비용은 60% 내렸고 효율 개선까지 더하면 체감 비용은 40% 줄었습니다.
• 실무 적용: 모델 ID만 바꾸면 씽킹 비활성화, 도구 강제 지정, 생각 흔적 재사용, 구버전 컴퓨터 유즈 도구까지 4가지가 조용히 깨집니다.
• 기대 효과: 이 체크리스트로 전환 전 확인하면 배포 다음 날 에러 로그를 보고 당황하는 일을 막을 수 있습니다.

가격표만 보면 단순 교체처럼 보이지만, 실제로는 중간에 4가지 변경점이 숨어 있습니다.

클로드 오퍼스 5.5, 숫자로 보면 뭐가 달라졌나

숫자만 놓고 보면 이번 업그레이드는 확실히 남는 장사입니다. 입력 토큰은 100만 개당 5달러에서 4달러로, 출력 토큰은 25달러에서 20달러로 각각 20% 낮아졌고, 프롬프트 캐시 읽기 비용은 0.5달러에서 0.2달러로 60% 떨어졌습니다. 여기에 토큰을 쓰는 효율 자체가 좋아지면서, 앤트로픽은 전형적인 워크로드 기준 실제 체감 절감폭을 40%로 제시합니다. 속도가 더 급한 작업이라면 100만 입력 토큰당 8달러, 출력 20달러를 내고 기본 속도의 2.5배로 돌리는 고속 모드도 새로 생겼습니다.

성능 지표도 만만치 않습니다. 오퍼스 5.5는 이전까지 앤트로픽의 최상위 모델이었던 페이블 5.1급 성능을 더 낮은 비용에 구현하고, 에이전틱 코딩·컴퓨터 사용·지식 작업 전반에서 오퍼스 5를 앞섭니다. Terminal-Bench 4.0 등 주요 벤치마크에서는 오픈AI의 GPT-6 아스트라와도 동급이거나 우위에 있습니다. 안전성 쪽에서는 자동화 행동 감사에서 역대 최고 점수를 받았고, 경계를 우회하려는 시도는 오퍼스 5 대비 85% 줄었습니다. 출시 전 Frontier Design과 METR라는 외부 평가기관의 검증도 거쳤습니다.

항목	오퍼스 5	오퍼스 5.5
입력 토큰(100만 개)	$5	$4
출력 토큰(100만 개)	$25	$20
캐시 읽기(100만 개)	$0.5	$0.2
기본 effort	high	medium
출력 속도	기준	30% 이상 빠름
전형 워크로드 비용	기준	약 40% 절감

모델 ID만 바꾸면 실제로 무슨 일이 생기나

앤트로픽 공식 마이그레이션 가이드가 명시하는 브레이킹 체인지는 정확히 4가지입니다. 하나씩 순서대로 짚어보겠습니다.

씽킹 끄기, 도구 강제 지정, 생각 흔적 재사용, 구버전 컴퓨터 유즈 도구 순으로 코드가 영향을 받습니다.

① 씽킹(thinking) 끄기 자체가 사라졌다

오퍼스 5에서는 thinking: {"type": "disabled"}를 보내면 씽킹 없이 바로 답이 나왔습니다. 오퍼스 5.5에서는 이 값이든 {"type": "enabled", "budget_tokens": N}든 둘 다 400 에러로 거부됩니다. 이제 씽킹은 항상 켜져 있고, 토큰을 아끼고 싶다면 thinking 필드를 아예 지우고 effort 레벨을 낮추는 방식으로 바꿔야 합니다. 예컨대 토큰 절감이 목적이었다면 output_config에 effort: "low"를 지정하는 식입니다. 응답도 이제 항상 thinking 블록으로 시작하므로, 콘텐츠 블록을 타입별로 걸러서 처리하고 도구 결과를 보낼 때 thinking 블록을 손대지 않고 그대로 돌려줘야 합니다.

② 특정 도구 강제 지정이 막혔다

tool_choice에 any나 tool 타입을 넣어 "이 도구를 무조건 써라"고 강제하던 코드도 이제 400 에러를 받습니다. 토큰 카운팅 엔드포인트도 동일하게 막힙니다. 대신 auto를 쓰고 strict tool use나 구조화된 출력을 조합해, 프롬프트 안에서 "이럴 때는 이 도구를 쓰라"고 직접 안내하는 방식으로 바꿔야 합니다.

③ 생각의 흔적(thinking 블록)이 모델을 갈아타면 사라진다

오퍼스 5.5가 만든 씽킹 블록은 같은 세대인 페이블 5.1과 미소스 5.1을 빼면 다른 모델이 읽지 못합니다. 라우터나 폴백 로직이 대화 중간에 다른 모델로 넘기는 구조라면, 그 순간부터 씽킹 블록 없이 턴이 진행된다는 뜻입니다. 반대 방향으로는 오퍼스 5.5가 오퍼스 5 이하 구형 모델의 씽킹은 읽지만, 페이블이나 미소스 계열의 씽킹은 읽지 못합니다. 게다가 2026년 8월 31일 이후 만들어진 API 계정부터는 시스템 프롬프트나 도구 목록, 이전 메시지를 중간에 편집하고 나서 씽킹 블록을 재생하려 하면 기본적으로 400 에러가 뜹니다. 대화를 끝까지 append-only로만 이어간다면(클로드 코드, claude.ai, Managed Agents, Agent SDK는 이미 이 구조입니다) 신경 쓸 필요가 없지만, 직접 대화 이력을 조작하는 커스텀 파이프라인이라면 반드시 확인해야 할 대목입니다.

④ 컴퓨터 제어 도구 구버전이 통하지 않는다

컴퓨터 사용(computer use) 기능을 computer_20251124 타입으로 선언하던 코드는 Claude API와 구글 클라우드에서 400 에러를 받습니다. 대신 computer_toolset_20260801을 선언해야 하는데, 베타 헤더도 필요 없고 name이나 화면 크기도 따로 지정하지 않습니다. 에이전트 루프 쪽에서도 도구 호출을 처리하는 방식이 달라지므로 별도 확인이 필요합니다. 다만 아마존 베드락에서는 기존 방식이 그대로 동작하니, 베드락 기반이라면 이 항목은 건너뛰어도 됩니다.

체크리스트에는 없지만 같이 챙겨야 할 함정

공식 브레이킹 체인지 4가지 말고도, 눈에 잘 띄지 않지만 실무에 영향을 주는 변화가 두 가지 더 있습니다.

첫 번째는 effort 기본값 자체가 바뀌었다는 점입니다. 오퍼스 5는 effort를 따로 지정하지 않으면 high로 동작했지만, 오퍼스 5.5는 같은 상황에서 medium으로 동작합니다. 앞서 본 40% 비용 절감도 이 기본값을 기준으로 계산된 수치입니다. 기존 코드에서 effort를 명시하지 않고 있었다면, 모델 이름만 바꾸는 순간 의도치 않게 더 낮은 effort로 돌아가게 됩니다. 공식 가이드도 이전 설정을 그대로 재사용하지 말고 effort 스윕을 다시 돌려보라고 권고합니다.

두 번째는 사이버보안 작업의 조용한 재라우팅입니다. 대부분의 사이버보안 관련 작업은 오퍼스 5.5로 요청을 보내도 내부적으로 구형 모델인 오퍼스 4.8이 처리합니다. 생명과학 관련 작업에는 페이블 5.1과 동일한 안전장치가 적용됩니다. 거부 응답도 세분화되어 stop_reason이 "refusal"로 오면서 "bio", "reasoning_extraction" 같은 새 카테고리가 추가됐는데, 이 중 "reasoning_extraction"은 서버 사이드 폴백이 자동으로 재시도해주지 않는 항목이라 직접 처리 로직을 넣어야 합니다.

세 번째는 화면에 보이던 진행 상황 안내가 조용해진다는 점입니다. 도구 호출 사이사이 모델이 남기던 설명 텍스트가 이제는 씽킹 블록(progress-update) 안으로 들어가는데, 기본 표시 설정(omitted)에서는 이 블록이 비어 보입니다. 클로드 코드처럼 작업 중간 상태를 실시간으로 보여주던 화면이라면 갑자기 업데이트가 끊긴 것처럼 느껴질 수 있습니다. display 값을 "updates"(베타, thinking-display-updates-2026-08-18 헤더 필요) 또는 "summarized"로 바꾸면 다시 복구됩니다.

그래도 갈아타야 할까, 판단 기준과 자동화 팁

네 가지 변경점을 다 확인했다면 이제 판단만 남았습니다. 새 프로젝트라면 굳이 미룰 이유가 없습니다. 처음부터 medium effort를 기준으로 설계하면 되니까요. 반면 기존에 운영 중인 파이프라인이라면, 위 4가지 항목 중 하나라도 해당하는 코드가 있는지 먼저 확인하고, 씽킹 비활성화나 강제 도구 지정에 의존하던 부분부터 손보는 순서가 안전합니다.

한 번에 전체 트래픽을 옮기기보다는 신규 트래픽 일부만 오퍼스 5.5로 라우팅하고 기존 트래픽은 오퍼스 5에 남겨둔 채 비용과 품질을 함께 측정하는 단계적 전환이 실무적으로 더 안전합니다. 오퍼스 5의 effort 5단계를 다룬 이전 글에서 정리했던 것처럼 effort는 체감 비용에 직접 영향을 주는 값이라, 새 기본값(medium)에서 품질이 유지되는지부터 확인하는 게 순서입니다.

수동으로 코드를 하나씩 고치기 부담스럽다면, 클로드 코드에서 아래 명령 한 줄로 마이그레이션을 자동화할 수 있습니다.

/claude-api migrate this project to claude-opus-5-5

이 명령은 모델 ID 교체는 물론 위 4가지 브레이킹 체인지에 필요한 파라미터 수정, effort 값 보정까지 프로젝트 전체에 적용하고, 수동으로 확인해야 할 항목은 별도 체크리스트로 뽑아줍니다. 아마존 베드락이나 AWS 위의 클로드 플랫폼 환경도 자동으로 인식해 그에 맞는 모델 ID와 기능 차이를 반영합니다.

전환 직전 자가진단 체크리스트

본격적으로 코드를 고치기 전에, 아래 세 가지만 먼저 확인해보세요.

• 씽킹을 비활성화하거나 tool_choice로 도구를 강제 지정하는 코드가 있나요? 있다면 위 ①·②번부터 손봐야 합니다.
• 대화 중간에 다른 모델로 넘기는 라우터나 폴백 구조를 쓰고 있나요? 그렇다면 씽킹 블록 호환성(③번)을 먼저 확인하세요.
• effort 값을 코드에 명시하지 않고 기본값에 의존하고 있나요? 그렇다면 배포 전에 반드시 원하는 effort를 직접 지정하세요.

마무리하며

오퍼스 5.5는 가격도 내리고 속도도 빨라진, 분명 갈아탈 만한 업그레이드입니다. 다만 "모델 ID만 바꾸면 끝"이라는 기대와 달리, 씽킹 제어 방식과 도구 강제 지정, 씽킹 블록 호환성, 컴퓨터 유즈 도구까지 4곳에서 실제로 동작이 달라집니다. 여기에 effort 기본값 변화와 사이버보안 작업의 조용한 재라우팅까지 챙기면 예상치 못한 에러 로그를 보고 당황할 일은 없을 겁니다.

오퍼스 5를 당장 놓아줄 필요는 없습니다. 최소 2027년 1월까지는 계속 지원되니, 위 체크리스트로 영향받는 코드부터 확인하고 신규 트래픽 일부로 먼저 테스트해보시길 권합니다. effort 값이 실제 비용에 어떻게 영향을 주는지 더 자세히 보고 싶다면 오퍼스 5 Effort 5단계 가이드를, 애초에 오퍼스 5가 페이블 5를 왜 밀어냈는지가 궁금하다면 이 글을 참고하세요. 가격이 내려간 신모델로 넘어갈 때 체크리스트가 필요한 상황은 클로드만의 일이 아닙니다. 제미나이 3.7 플래시 전환 체크리스트도 같은 패턴을 다루고 있어 비교해보시면 도움이 됩니다.

자주 묻는 질문(FAQ)

Q1. 아마존 베드락에서도 컴퓨터 유즈 도구 관련 변경사항이 똑같이 적용되나요?

아니요. computer_20251124가 통하지 않는 변경은 Claude API와 구글 클라우드에만 해당합니다. 아마존 베드락에서는 기존 방식이 오퍼스 5.5에서도 그대로 동작합니다.

Q2. 오퍼스 5.5 출시로 소네트나 하이쿠 요금도 같이 바뀌나요?

아직입니다. 클로드 소네트 5.5와 하이쿠 5.5는 수주 내 별도로 출시될 예정이며, 현재 소네트 5·하이쿠 가격은 이번 발표와 무관하게 그대로 유지됩니다.

Q3. 지금 오퍼스 5를 계속 써도 괜찮나요?

네. 오퍼스 5는 퇴역 예고일 기준으로 최소 2027년 1월까지 계속 지원됩니다. 당장 전환하지 않아도 서비스에 문제가 생기지는 않으니, 체크리스트를 확인한 뒤 여유 있게 전환하셔도 됩니다.