2026년 9월 23일

Opus 5.5, 유의점과 마이그레이션 체크리스트

claudeopusllm

안녕하세요! 재니미입니다.

지난 글 「Opus 5.5, 뭐가 달라졌나」에서 Opus 5.5로 넘어갈 때 실제로 요청이 실패하는 네 가지 변경 사항을 정리했습니다. 이번 글에서는 요청은 성공하지만 결과가 달라지는 것 중 나머지 두 가지, 안전장치 거부와 프론트엔드 기본 스타일을 다루고, 마지막에 전체 마이그레이션 순서를 정리하겠습니다.

안전장치 거부 카테고리가 늘었다

Opus 5.5에는 안전 분류기가 붙어 있고, 거부된 요청은 에러가 아니라 HTTP 200과 함께 stop_reason: "refusal", 그리고 어떤 정책 영역에 걸렸는지 알려주는 stop_details 객체로 돌아옵니다.

생물학: Opus 5에서 넘어오는 경우 새로 생기는 분류기입니다. 일상적인 건강·교육 질문은 영향을 안 받습니다. 생명과학 업무에 방해가 된다면 별도 검증 프로그램에 신청할 수 있습니다.
사이버 보안: 소스 코드에서 취약점을 찾는 건 허용되고, 고위험 이중 용도 활동은 막힙니다.
추론 추출: 모델의 내부 추론을 응답 텍스트에 그대로 재현하도록 유도하는 요청이 걸리는 카테고리입니다. 이것도 Opus 5에서는 없던 항목입니다. 사고 대신 응답 안에 추론 과정을 적으라고 시켰던 프롬프트가 있다면 그 지시를 빼고, 사고 블록에서 요약된 추론을 읽는 쪽으로 바꿔야 합니다.

거부는 다른 모델로 자동 재시도하도록 구성할 수 있습니다. 다만 추론 추출 거부만은 예외라서, 서버 쪽 대체 기능이 재시도 없이 그대로 돌려줍니다.

밀도 높은 시각 자료에는 여전히 도구가 필요하다

1편에서 본 것처럼 Opus 5.5는 도구 없이도 차트와 다이어그램을 훨씬 정확히 읽습니다. 그래서 이전 모델을 위해 만들어둔 시각 자료 우회 방법은 재검토할 만합니다. 다만 가장 밀도 높은 입력에서는 여전히 두 가지가 정확도를 높여줍니다.

하나는 고해상도 이미지입니다. 기술 도면 같은 입력에서 특히 효과가 큽니다. 다른 하나는 이미지 처리 도구입니다. 원본 이미지와 PIL·OpenCV 같은 라이브러리가 설치된 컨테이너에 접근할 수 있게 해서, 모델이 직접 자르고 확대하고 측정하고 검증하게 하는 방식입니다. 컨테이너까지 붙이기 부담스럽다면 자르기 도구 하나만으로도 도움이 됩니다.

이런 도구는 effort가 높을수록 더 효과적으로 씁니다. 반대로 도구 없이 effort만 올리면 기술 도면 판독은 나아지지만 차트에는 거의 효과가 없습니다.

프론트엔드 기본 스타일이 바뀌었다

디자인 방향을 따로 안 주고 프론트엔드 작업을 시키면 Opus 5.5는 몇 가지 기본 스타일로 돌아갑니다. “AI가 만든 것처럼 안 보이게 해줘” 같은 일반적인 지시는 별 효과가 없다고 합니다. 어차피 하나의 기본값을 다른 기본값으로 바꿀 뿐이기 때문입니다.

대신 피해야 할 구체적인 패턴을 콕 집어서 지시하면 반응이 좋습니다. Anthropic이 예시로 든 문장은 이런 식입니다.

플레이스홀더 데이터가 들어간 평범한 HTML/CSS 개인 웹사이트를 만들어줘. 크림색이나 오프화이트
배경, 헤드라인의 이탤릭체 강조 단어, 01/02/03 같은 번호 매긴 섹션 라벨, 모노스페이스 라벨,
알약 모양 버튼은 쓰지 마.

한 번에 끝내려 하지 말고 반복하는 게 낫습니다. 첫 결과물이 대신 어떤 스타일을 썼는지 확인하고, 피해야 할 패턴 목록을 그때그때 늘려가면 됩니다.

마이그레이션 체크리스트

지난 글과 이 글에서 다룬 걸 순서대로 묶으면 이렇습니다.

모델 ID를 claude-opus-5-5로 바꿉니다.
thinking: {"type": "disabled"}나 {"type": "enabled", ...} 설정을 전부 지우고 effort 수준을 고릅니다.
tool_choice의 any·tool 유형을 auto와 엄격한 도구 사용 조합으로 바꿉니다.
Claude API나 Google Cloud에서 computer_20251124를 쓰고 있었다면 도구 세트로 옮깁니다.
도구 호출 사이의 텍스트를 화면에 그리고 있었다면 thinking.display 설정을 확인합니다.
effort를 명시적으로 설정하고 다시 스윕해서 재보정합니다.
사고를 대신해 응답에 추론을 적으라고 시켰던 지시가 있으면 빼고, 요약된 사고 블록으로 바꿉니다.
프론트엔드 작업 프롬프트에 피해야 할 스타일을 구체적으로 적어둡니다.

감사합니다.