Claude Fable 5.2로 옮길 때 깨지는 네 가지와 점검 목록

Claude Fable 5.1에서 5.2로 옮기는 일은 대부분 모델 이름만 바꾸면 끝나지만, 네 가지 경우에는 코드가 깨질 수 있어요. 공식 마이그레이션 가이드는 대화 기록 수정(프리픽스 검사), 생각 블록 호환, 예전 컴퓨터 사용 도구, 어드바이저 모델 조합을 꼽아요. 가격은 입력 100만 토큰당 10달러에서 8달러로, 출력은 50달러에서 40달러로 내려갔어요.

모델 이름

model = "claude-fable-5-1"  # Before
model = "claude-fable-5-2"  # After

Amazon Bedrock에서는 global.anthropic.claude-fable-5-2 또는 us.anthropic.claude-fable-5-2를 쓰고, bedrock-runtime 엔드포인트에서만 제공돼요. 5.2는 5.1·5와 따로 사용량 한도가 잡혀 있으니 운영 트래픽을 옮기기 전에 한도부터 보라고 해요.

깨질 수 있는 네 가지

1. 대화 앞부분을 고치면 400 오류

5.2는 모든 요청에 ‘프리픽스 검사’를 해요. 대화 도중에 system, tools, 앞선 메시지를 바꾼 뒤 그 뒤에 생긴 thinking 블록을 다시 보내면 400 오류가 나고, 같은 요청을 다시 보내도 풀리지 않아요. Claude Code, claude.ai, Managed Agents, Agent SDK가 기록을 관리한다면 바꿀 것이 없어요. 직접 messages 배열을 만드는 코드라면 기록을 덧붙이기만 하도록(append-only) 바꾸라는 게 가이드의 권고예요.

원인을 찾는 동안에는 thinking-binding-controls-2026-08-01 베타 헤더와 함께 thinking.block_binding.prefix_mismatch_behavior를 "drop_block"으로 두면 문제 블록만 빼고 계속 진행할 수 있어요. 가이드는 이를 임시방편으로만 쓰라고 해요. 버린 블록만큼 다시 생각해야 해서 출력 토큰이 늘 수 있기 때문이에요. 기본값은 "error"예요. 또 MCP 커넥터에서 서버의 도구 목록을 고정하지 않았다면, 요청 사이에 바뀐 도구 목록도 5.2에서는 ‘수정’으로 본다고 해요.

2. 5.1은 5.2의 생각 블록을 못 읽어요

5.1에서 5.2로 넘어가는 대화는 앞의 추론을 이어받지만, 반대로 라우터나 재시도, 거절 폴백 때문에 5.2에서 다른 모델로 넘어가면 API가 읽을 수 없는 블록을 버려요. 요청은 성공하고 버린 토큰은 청구되지 않지만, 바뀐 직후 첫 턴은 추론 없이 시작해서 비용과 지연이 늘 수 있어요. 다른 계정에서 만든 5.2 생각 블록도 버려지니, 저장한 대화를 다시 돌릴 때는 원래 계정(또는 연결된 계정)으로 돌려야 해요.

3. 컴퓨터 사용 도구 교체

computer_20251124 타입 도구는 Amazon Bedrock을 뺀 모든 플랫폼에서 400 오류를 내요. 대신 computer_toolset_20260801 도구 묶음을 선언하고, 베타 헤더를 빼고, name이나 화면 크기 없이 보내라고 해요. 에이전트 루프도 새 도구 묶음에 맞게 고쳐야 해요.

4. 어드바이저는 5.2급만

베타인 어드바이저 도구에서 5.2(또는 Mythos 5.2) 실행 모델은 Fable 5.2나 Mythos 5.2만 어드바이저로 받아요. 5.1을 어드바이저로 두면 400 오류예요. 반대로 어떤 실행 모델이든 Fable 5.2를 어드바이저로 받아요. 어드바이저 모델을 바꾸는 것도 tools 수정이라서 새 대화에서 바꾸라고 해요. 5.2 어드바이저의 조언은 암호화되어 돌아와요.

동작이 달라진 점

  • “고민하지 말고 바로 답하라” 같은 프롬프트 문장이 medium 이상 effort에서 생각을 멈추지 못해요. 그런 문장은 지우고 effort를 낮추라고 해요.
  • 생각 토큰도 max_tokens에 포함돼서, 작게 잡으면 텍스트 없이 stop_reason: "max_tokens"로 끝날 수 있어요.
  • 코딩 제품에서 xhigh, max effort일 때 스스로 서브에이전트를 띄워 검토하는 모습이 관찰됐다고 해요. 세션 비용이 크게 늘 수 있어요.

Opus 5.5에서 옮긴다면 더 볼 것

  • 30일 데이터 보관이 필수예요. 무보관(ZDR) 조건이면 모든 요청이 400 오류가 나니 가장 먼저 확인해야 해요.
  • 기본 effort가 Opus 5.5의 medium보다 한 단계 높은 high예요. 빼먹으면 오류 없이 비용과 지연만 달라지니 명시하라고 해요.
  • 가격은 입력 8달러, 출력 40달러로 Opus 5.5(4달러·20달러)의 두 배예요. 패스트 모드(speed: "fast")는 16달러·80달러이고, Managed Agents에서는 이 설정을 빼야 해요.
  • 고객 관리 암호화 키(CMEK) 조직에서는 구조화 출력이 안 되니 strict: true와 output_config.format을 빼고 코드에서 검증해야 해요.

점검 목록

  • 모델 이름과 사용량 한도 확인
  • computer_20251124를 쓰면 computer_toolset_20260801로 교체
  • 어드바이저 model을 claude-fable-5-2 또는 claude-mythos-5-2로
  • 직접 기록을 만드는 코드는 drop_block으로 한 세션 돌려 input_transformations의 prefix_binding_mismatch 항목을 모두 고치기
  • thinking 블록은 빈 것까지 매 턴 그대로 돌려보내기
  • 자체 평가로 effort를 다시 맞추고 비용·지연 기준선 다시 잡기

이 글의 코드와 설정 이름은 공식 가이드에서 옮겼고, 직접 실행해 보지는 않았어요.

출처: Claude Fable 5.2·Mythos 5.2 마이그레이션 가이드, Claude Platform 릴리스 노트

Similar Posts