Claude Fable 5.2 및 Claude Mythos 5.2 마이그레이션 가이드

Claude Managed Agents 에이전트에 어드바이저가 있는 경우, 어드바이저의 model도 업데이트해야 하는 두 번째 모델 이름입니다. 에이전트의 모델을 변경할 때 이를 claude-fable-5-2 또는 claude-mythos-5-2로 설정하세요. Claude Fable 5.2 실행자에는 Claude Fable 5.2 또는 Claude Mythos 5.2 어드바이저가 필요합니다를 참조하세요.

다음 섹션에서는 Claude Fable 5.1, Claude Mythos 5.1, Claude Opus 5.5 또는 이전 Claude Fable, Claude Mythos, Claude Opus 모델에서 Claude Fable 5.2 또는 Claude Mythos 5.2로 이전하는 방법을 다룹니다. 변경 사항 자체는 Claude Fable 5.2의 새로운 기능을 참조하세요. 동작 차이와 모델별 프롬프팅 패턴은 Claude Fable 5.2 프롬프팅을 참조하세요.

Claude Fable 5.2는 Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed)에서 사용할 수 있습니다. Amazon Bedrock에서도 사용할 수 있습니다. Claude Models on Google Cloud (Google managed)에서도 사용할 수 있습니다. Microsoft Foundry에서도 사용할 수 있습니다. Claude Mythos 5.2는 동일한 기능을 갖추고 있으며, Cyber Verification Program과 같은 Anthropic의 인증 프로그램을 통해 인증된 조직만 사용할 수 있습니다.

claude-fable-5-2와 claude-mythos-5-2가 공유하는 기본 설정은 다음과 같습니다.

• 사고: Adaptive thinking(적응형 사고)은 Claude Fable 5.1과 마찬가지로 항상 켜져 있습니다. 모델이 언제 얼마나 사고할지 결정하며, effort(노력 수준) 매개변수가 사고의 깊이를 제어합니다. thinking: {type: "disabled"}와 수동 확장 사고(thinking: {type: "enabled", budget_tokens: N})는 모두 400 오류를 반환합니다.
• Effort: 다섯 가지 노력 수준이 모두 지원되며, 기본값은 Claude Fable 5.1과 마찬가지로 high입니다. Claude Fable 5.2 권장 노력 수준을 참조하세요.
• Prefill: 어시스턴트 메시지를 “prefill”(미리 채우기)하면 Claude Fable 5.1과 마찬가지로 400 오류가 반환됩니다. 대신 시스템 프롬프트 지시를 사용하세요.
• 샘플링 매개변수: Claude Fable 5.1과 마찬가지로 temperature, top_p, top_k를 생략하세요. 400 오류를 반환하는 값은 샘플링 매개변수를 참조하세요.
• 도구 선택: {type: "auto"}(기본값)와 {type: "none"}이 지원됩니다. {type: "any"} 또는 {type: "tool", name: "..."}로 도구 호출을 강제하면 Claude Fable 5.1과 마찬가지로 400 오류가 반환됩니다.
• 구조화된 출력: “customer-managed encryption keys”(고객 관리형 암호화 키), 즉 CMEK를 사용하는 조직에서는 Claude Fable 5.1과 마찬가지로 구조화된 출력을 두 모델 모두에서 사용할 수 없습니다. 여기에는 엄격한 도구 사용과 JSON 출력이 모두 포함됩니다. 해당 환경의 요청에 strict: true 또는 output_config.format이 설정되어 있다면 이를 제거하고 코드에서 출력을 검증하세요.
• 모델 간 사고 보존: Claude API 및 Claude Models on Google Cloud (Google managed)에서 Claude Fable 5.2와 Claude Mythos 5.2는 서로의 사고 블록과 Claude Opus 5.5, Claude Sonnet 5.5, Claude Haiku 5.5를 포함한 다른 모델의 사고 블록을 읽을 수 있습니다. 다른 모델은 이들 모델의 블록을 읽을 수 없습니다. 목록은 대화 도중 모델 전환을 참조하세요.
• 계정에 바인딩된 사고: Claude Fable 5.2와 Claude Mythos 5.2의 사고 블록은 해당 블록을 생성한 계정 또는 그 계정과 연결된 계정에서만 작동합니다. 다른 계정이 이러한 블록을 전송하면 API는 모델이 블록을 받기 전에 이를 제거하며, 요청은 성공합니다. Claude API 및 Claude Models on Google Cloud (Google managed)에서 thinking-binding-controls-2026-08-01 베타 헤더를 사용하면, 응답의 input_transformations에 제거된 각 블록이 reason: "organization_binding_mismatch"와 함께 나열됩니다. 사고 블록은 생성한 계정에 귀속됩니다를 참조하세요.
• 컨텍스트 윈도우 및 출력: 기본적으로 1M 토큰 컨텍스트 윈도우를 제공하며, 요청당 최대 128k 출력 토큰을 지원합니다.
• 가격: 입력 토큰 100만 개당 $8 USD, 출력 토큰 100만 개당 $40 USD이며, Claude Fable 5.1과 Claude Mythos 5.1의 $10 USD 및 $50 USD와 비교됩니다. 프롬프트 캐시 읽기는 토큰 100만 개당 $0.20 USD로, 해당 모델의 $0.25 USD와 비교됩니다. 가격을 참조하세요.
• 데이터 보존: 두 모델 모두 Claude Fable 5.1 및 Claude Mythos 5.1과 마찬가지로 30일 데이터 보존이 필요하고, Anthropic이 명시적으로 승인하지 않는 한 “zero data retention”(데이터 무보존), 즉 ZDR 약정하에서는 사용할 수 없으며, Covered Models(적용 대상 모델)로 지정되어 있습니다. Claude API에서 30일 보존이 설정되지 않은 조직 또는 워크스페이스의 요청은 400 invalid_request_error를 반환합니다. ZDR 약정이 있는 조직은 Anthropic 계정 팀에 문의하거나 개별 워크스페이스에 대해 보존을 구성하세요. 플랫폼별 세부 정보는 모델별 데이터 보존 요구 사항을 참조하세요.
• Priority Tier: 두 모델 모두 Priority Tier에서 지원되지 않습니다.
• Fast mode: 두 모델 모두 Messages API 요청에서 fast mode를 지원합니다. 각 모델을 사용할 수 있는 플랫폼은 Fast mode 제공 여부에서 확인할 수 있습니다.

두 모델이 다른 점은 다음과 같습니다.

• 가용성: Claude API에서 Claude Fable 5.2는 액세스 승인이 필요하지 않습니다. Claude Mythos 5.2는 Cyber Verification Program과 같은 Anthropic의 인증 프로그램을 통해 인증된 조직만 사용할 수 있습니다. 액세스를 요청하려면 사용 사례에 해당하는 프로그램에 신청하거나 Anthropic 계정 팀에 문의하세요.
• 속도 제한: Claude Fable 5.2는 Claude Fable 5.1과 Claude Fable 5가 공유하는 통합 제한과 별도로 자체 속도 제한을 갖습니다. Claude Mythos 5.2는 Claude Mythos 5.1 및 Claude Mythos 5와 하나의 통합 제한을 공유합니다. 속도 제한을 참조하세요.

Claude Fable 5.1에서 Claude Fable 5.2로 마이그레이션

마이그레이션은 대부분 그대로 교체하는 방식으로 가능합니다. API 표면, 항상 켜져 있는 적응형 사고, 강제 도구 선택 제한, 거부 처리, stop_details 카테고리, 데이터 보존 요구 사항은 모두 Claude Fable 5.1과 동일합니다. Claude Fable 5.2는 비용이 더 저렴합니다. 입력 토큰 100만 개당 $8 USD, 출력 토큰 100만 개당 $40 USD로, Claude Fable 5.1의 $10 USD 및 $50 USD보다 저렴합니다. 네 가지 변경 사항으로 인해 코드가 동작하지 않을 수 있습니다. 이전 턴의 편집을 감지하는 prefix check(접두사 검사)가 모든 계정에 적용됩니다. Claude Fable 5.1은 Claude Fable 5.2의 사고 블록을 읽을 수 없습니다. 이전 computer use 도구인 computer_20251124는 Amazon Bedrock을 제외한 모든 플랫폼에서 400 오류를 반환합니다. 어드바이저 도구를 사용할 때 Claude Fable 5.2 실행자는 Claude Fable 5.2 또는 Claude Mythos 5.2만 어드바이저로 허용합니다.

모델 이름 업데이트

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

모델 ID는 Amazon Bedrock에서는 anthropic.claude-fable-5-2이고, 그 외 모든 플랫폼에서 claude-fable-5-2입니다. 각 플랫폼의 ID는 Claude Fable 5.2 모델 페이지를 참조하세요.

호환성을 깨는 변경 사항

1. 접두사 검사가 모든 계정에 적용됩니다: Claude Fable 5.1과 마찬가지로, Claude Fable 5.2의 각 thinking 블록은 그 앞에 있던 system 프롬프트, tools, 대화 기록에 대해서만 유효합니다. Claude Fable 5.2는 계정 생성 시기와 관계없이 모든 계정에 이 접두사 검사를 적용합니다. Claude Fable 5.1은 기본적으로 2026년 8월 31일 이후에 생성된 계정에 이를 적용합니다. 따라서 이전 계정에서는 Claude Fable 5.1에서 통과하던 요청이 Claude Fable 5.2에서 실패할 수 있습니다.

   Claude Code, claude.ai, Claude Managed Agents 또는 Claude Agent SDK가 대화 기록을 관리하는 경우에는 변경할 사항이 없습니다. 코드에서 messages 배열을 직접 구성하는 경우, 요청 사이에 코드가 수행하는 작업을 접두사 검사의 영향을 받는 대상의 목록과 비교하세요. 이러한 편집 후에 사고 블록을 다시 전송하는 요청은 400 오류를 반환합니다:

   messages.5.content.0: Invalid `signature` in `thinking` block. The block is bound to a different conversation. Remove the block, or set `thinking.block_binding.prefix_mismatch_behavior` to "drop_block". That setting requires the `thinking-binding-controls-2026-08-01` value in the `anthropic-beta` header.

   

   동일한 요청 본문으로 재시도해도 오류는 해결되지 않습니다. 프로덕션 트래픽을 전환하기 전에 이러한 편집을 찾으려면, 현재 사용 중인 모델인 Claude Fable 5.1 또는 Claude Opus 5.5를 대상으로 코드가 접두사를 편집하는지 확인하기의 검사를 실행하세요. prefix_mismatch_behavior를 설정하면 요청이 검사에 옵트인되므로 어떤 계정에서도 작동합니다. 보존된 사고에서 각 패턴에 대한 해결 방법을 확인할 수 있습니다.

   프로덕션에서 불일치가 코드의 버그만을 의미한다면 prefix_mismatch_behavior를 기본값인 "error"로 두세요. 편집을 수정하는 동안 영향을 받는 블록을 제거하고 해당 추론 없이 계속하려면 "drop_block"으로 설정하세요. 이는 장기적인 설정이 아니라 임시 방편으로 취급하세요. 블록을 제거하면 출력 토큰이 증가할 수 있습니다.

2. Claude Fable 5.1은 Claude Fable 5.2의 사고 블록을 읽을 수 없습니다: Claude API 및 Claude Models on Google Cloud (Google managed)에서 Claude Fable 5.2는 Claude Fable 5.1의 블록을 읽으므로, claude-fable-5-1에서 claude-fable-5-2로 이동하는 대화는 이전 추론을 유지합니다. 반대 방향으로는 Claude Fable 5.1이 Claude Fable 5.2의 블록을 읽을 수 없습니다. 라우터 전환, 클라이언트 측 재시도 또는 분류기 거부 폴백으로 인해 대화가 Claude Fable 5.2에서 Claude Fable 5.1을 포함한 다른 모델로 이동하면, API는 해당 모델이 읽을 수 없는 블록을 제거합니다. 요청은 성공하며, 제거된 입력 토큰에 대해서는 요금이 청구되지 않습니다. 이후 모델은 해당 추론 없이 작동하므로, 전환 후 첫 번째 턴에서 비용과 “latency”(지연 시간)가 증가할 수 있습니다. thinking-binding-controls-2026-08-01 베타 헤더를 사용하면 input_transformations에 제거된 각 블록이 reason: "model_binding_mismatch"와 함께 나열됩니다. 대화 도중 모델 전환을 참조하세요.

3. computer_20251124 대신 computer use 도구 세트를 사용하세요: computer_20251124 유형의 tools 항목은 Amazon Bedrock을 제외한 모든 플랫폼에서 400 오류를 반환합니다. 대신 computer_toolset_20260801 도구 세트를 선언하세요. 베타 헤더를 제거하고 name이나 디스플레이 크기 없이 항목을 전송하면 됩니다. 그런 다음 computer_20251124에서 마이그레이션에 설명된 대로 도구 세트에 맞게 에이전트 루프를 업데이트하세요. Amazon Bedrock에서는 이전 도구가 Claude Fable 5.1에서와 동일하게 작동합니다.

4. Claude Fable 5.2 실행자에는 Claude Fable 5.2 또는 Claude Mythos 5.2 어드바이저가 필요합니다: 베타 버전인 어드바이저 도구를 사용할 때 어드바이저는 실행자와 적어도 동등한 성능을 갖춰야 합니다. Claude Fable 5.2 또는 Claude Mythos 5.2 실행자는 Claude Fable 5.2 또는 Claude Mythos 5.2만 어드바이저로 허용하며, Claude Fable 5.1과 Claude Mythos 5.1을 포함한 그 외의 어드바이저는 400 invalid_request_error를 반환합니다. 실행자의 모델 ID를 변경할 때 어드바이저 도구 정의의 model을 claude-fable-5-2 또는 claude-mythos-5-2로 설정하세요. 어드바이저의 model을 변경하는 것은 tools에 대한 편집이므로, 새 대화에서 변경하세요. 변경 후 이전 사고 블록을 다시 전송하는 요청은 prefix_mismatch_behavior를 "drop_block"으로 설정하지 않는 한 접두사 검사에 실패하고(접두사 검사가 모든 계정에 적용됩니다 참조) 400 오류를 반환합니다. 현재 실행자를 유지하고 어드바이저만 변경하려면 어드바이저의 model을 claude-fable-5-2로 설정하세요. 모든 실행자 모델이 이를 허용합니다. Claude Fable 5.2 어드바이저는 조언을 암호화하여 반환하므로, 코드에서 조언 텍스트를 읽는 경우 결과 변형을 참조하세요. Claude Managed Agents 에이전트의 어드바이저에도 동일한 조합이 적용되므로, 에이전트의 모델을 변경할 때 해당 어드바이저의 model을 이 두 모델 중 하나로 설정하세요. 모델 호환성 및 세션에 어드바이저 제공하기를 참조하세요.

동작 변경 사항

1. 더 적은 사고를 요청하는 프롬프트 문장은 medium 이상의 effort에서 모델의 사고를 막지 못합니다: Claude Fable 5.1은 대개 "숙고하지 말고 바로 답하세요"와 같은 문장을 따릅니다. Anthropic의 테스트에서 이러한 문장은 medium 이상에서 Claude Fable 5.2의 사고를 막지 못했습니다. 이러한 문장을 제거하고 노력 수준을 낮추세요. Effort 보정을 참조하세요.
2. 높은 effort에서 모델이 자신의 작업을 검토하기 위해 subagent를 시작할 수 있습니다: xhigh 및 max와 같은 높은 노력 수준의 에이전트형 코딩 제품에서, Anthropic은 Claude Fable 5.2가 자신의 작업을 검토하기 위해 “subagent”(하위 에이전트)를 사용하는 것을 관찰했습니다. Claude Fable 5.1은 동일한 작업에서 이렇게 하지 않았습니다. subagent는 세션 비용의 상당 부분을 차지할 수 있습니다. 서브에이전트에 대한 기대치 설정하기를 참조하세요.
3. 작은 max_tokens는 텍스트를 위한 공간을 남기지 않을 수 있습니다: 사고 토큰은 max_tokens에 포함되므로, 작은 max_tokens로 보낸 요청은 thinking 블록 이후 텍스트가 나오기 전에 stop_reason: "max_tokens"로 중지될 수 있습니다. Claude Fable 5.1의 사고를 대개 막아 주는 프롬프트 문장은 medium 이상의 effort에서 Claude Fable 5.2의 사고를 막지 못합니다. 따라서 Claude Fable 5.1에서 작은 max_tokens에 맞추기 위해 그러한 문장에 의존하던 요청은 Claude Fable 5.2에서 텍스트가 나오기 전에 토큰이 소진될 수 있습니다. 사고를 위한 여유를 두도록 max_tokens를 늘리거나, 더 낮은 effort 수준을 선택하세요.

프롬프트를 이전할 때 확인해야 할 다른 동작은 동작 차이를 참조하세요.

마이그레이션 체크리스트

• 모델 이름을 claude-fable-5-1에서 claude-fable-5-2로 업데이트하세요.
• 프로덕션 트래픽을 이동하기 전에 속도 제한을 확인하세요. Claude Fable 5.2는 Claude Fable 5.1과 Claude Fable 5가 공유하는 제한과 별도로 자체 속도 제한을 갖습니다.
• computer_20251124를 통해 computer use를 Amazon Bedrock 이외의 곳에서 사용하는 경우, Claude Fable 5.2는 해당 도구에 대해 400 오류를 반환합니다. 대신 computer_toolset_20260801을 선언하고 도구 세트에 맞게 에이전트 루프를 업데이트하세요.
• Claude Fable 5.2를 실행자로 하여 어드바이저 도구를 사용하는 경우, 어드바이저의 model을 claude-fable-5-2 또는 claude-mythos-5-2로 설정하세요.
• 코드에서 messages 배열을 직접 구성하는 경우, thinking-binding-controls-2026-08-01 베타 헤더와 prefix_mismatch_behavior: "drop_block"으로 세션을 실행하고, input_transformations를 로깅하고, 모든 prefix_binding_mismatch 항목을 수정하세요. 계정이 Claude Fable 5.1에서 검사에 걸린 적이 없더라도 이 작업을 수행하세요.
• 프로덕션용 prefix_mismatch_behavior를 선택하세요. "error"(기본값) 또는 편집을 수정하는 동안의 임시 방편으로 "drop_block"을 선택할 수 있습니다. 블록을 제거하면 출력 토큰이 증가할 수 있기 때문입니다. 400 오류 또는 input_transformations 항목을 모니터링하세요.
• 빈 블록을 포함하여 모든 턴에서 thinking 블록을 변경하지 않고 계속 다시 전달하세요. 라우터나 폴백이 대화를 Claude Fable 5.2에서 Claude Fable 5.1로 이동할 수 있다면, Claude Fable 5.1이 Claude Fable 5.2의 블록 없이 실행될 것으로 예상하세요.
• 저장된 대화를 다른 계정을 통해 재생하는 경우, 각 대화를 이를 생성한 계정 또는 그 계정과 연결된 계정을 통해 재생하세요. API는 다른 계정이 생성한 Claude Fable 5.2 사고 블록을 제거합니다. 사고 블록은 생성한 계정에 귀속됩니다를 참조하세요.
• 자체 평가에서 effort 스윕을 다시 실행하고, 비용과 지연 시간의 기준선을 다시 설정하세요.
• 이전하는 시스템 프롬프트, 스킬 및 기타 지시 사항을 이전 모델용으로 작성된 지침 검토하기와 대조하여 확인하세요.

Claude Mythos 5.1에서 Claude Mythos 5.2로 마이그레이션

Claude Mythos 5.2는 Cyber Verification Program과 같은 Anthropic의 인증 프로그램을 통해 인증된 조직을 위한 Claude Fable 5.2의 대응 모델입니다. 모델 ID를 전환하기 전에 조직이 Claude Mythos 5.2에 액세스할 수 있는지 확인하세요.

Claude Mythos 5.2는 Claude Fable 5.2와 마찬가지로 모든 계정에 접두사 검사를 적용합니다. prefix_mismatch_behavior가 설정되지 않은 경우에서 Claude Mythos 5.1이 이미 오류를 반환하는 경우를 확인할 수 있습니다. Amazon Bedrock에서 Claude Mythos 5.2는 편집된 이전 턴에 대해 400 오류를 반환하지만, Claude Mythos 5.1은 해당 플랫폼에서 이러한 요청을 허용합니다. 코드가 이전 턴을 편집하는 경우, 변경할 사항과 테스트 방법은 이전 턴을 편집하면 사고 블록이 무효화됩니다를 참조하고, claude-mythos-5-2를 대상으로 테스트를 실행하세요.

Claude API 및 Claude Models on Google Cloud (Google managed)에서 Claude Mythos 5.2는 Claude Mythos 5.1의 사고 블록을 읽으므로, claude-mythos-5-1에서 claude-mythos-5-2로 이동하는 대화는 이전 추론을 유지합니다. 반대 방향으로는 Claude Mythos 5.1이 Claude Mythos 5.2의 블록을 읽을 수 없습니다. API는 해당 블록을 제거하며, 요청은 성공합니다. 대화 도중 모델 전환을 참조하세요.

베타 버전인 어드바이저 도구를 사용할 때 Claude Mythos 5.2 실행자는 Claude Mythos 5.2 또는 Claude Fable 5.2만 어드바이저로 허용합니다. Claude Mythos 5.1 또는 Claude Fable 5.1 어드바이저는 400 오류를 반환합니다. Claude Fable 5.2 실행자에는 Claude Fable 5.2 또는 Claude Mythos 5.2 어드바이저가 필요합니다를 참조하세요.

Claude Mythos 5.2는 computer_toolset_20260801 도구 세트를 통해 computer use를 지원합니다. computer_20251124 유형의 tools 항목은 이전 도구가 작동하는 Amazon Bedrock을 제외한 모든 플랫폼에서 400 오류를 반환합니다. computer_20251124 대신 computer use 도구 세트를 사용하세요를 참조하세요.

Claude Mythos 5.2의 비용은 입력 토큰 100만 개당 $8 USD, 출력 토큰 100만 개당 $40 USD로, Claude Mythos 5.1의 $10 USD 및 $50 USD와 비교됩니다. 프롬프트 캐시 읽기는 토큰 100만 개당 $0.20 USD로, $0.25 USD와 비교됩니다.

모델 이름 업데이트

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

마이그레이션 체크리스트

• 모델 이름을 claude-mythos-5-1에서 claude-mythos-5-2로 업데이트하세요.
• computer_20251124를 통해 computer use를 Amazon Bedrock 이외의 곳에서 사용하는 경우, Claude Mythos 5.2는 해당 도구에 대해 400 오류를 반환합니다. 대신 computer_toolset_20260801을 선언하고 도구 세트에 맞게 에이전트 루프를 업데이트하세요.
• Claude Mythos 5.2를 실행자로 하여 어드바이저 도구를 사용하는 경우, 어드바이저의 model을 claude-mythos-5-2 또는 claude-fable-5-2로 설정하세요.
• 빈 블록을 포함하여 모든 턴에서 thinking 블록을 변경하지 않고 계속 다시 전달하세요.
• 저장된 대화를 다른 계정을 통해 재생하는 경우, 각 대화를 이를 생성한 계정 또는 그 계정과 연결된 계정을 통해 재생하세요. API는 다른 계정이 생성한 Claude Mythos 5.2 사고 블록을 제거합니다. 사고 블록은 생성한 계정에 귀속됩니다를 참조하세요.
• 코드에서 messages 배열을 직접 구성하는 경우, claude-mythos-5-2를 대상으로 이전 턴을 편집하면 사고 블록이 무효화됩니다의 검사를 실행하고, 모든 prefix_binding_mismatch 항목을 수정하고, 대화 기록을 추가 전용으로 유지하세요(편집으로 간주되는 것 참조). 추가 전용 기록은 프롬프트 캐시도 유지해 줍니다.
• stop_reason: "refusal"을 처리하고, 응답 콘텐츠보다 먼저 stop_details.category를 읽으세요. 거부 및 폴백을 참조하세요.
• effort 스윕을 다시 실행하고, 비용과 지연 시간의 기준선을 다시 설정하세요.
• 이전하는 시스템 프롬프트, 스킬 및 기타 지시 사항을 이전 모델용으로 작성된 지침 검토하기와 대조하여 확인하세요.

Claude Opus 5.5에서 Claude Fable 5.2로 마이그레이션

Claude Fable 5.2는 Claude Opus 5.5와 동일한 Messages API 및 도구 사용 패턴을 사용합니다. 두 모델 모두 항상 적응형으로 사고하며 강제 도구 선택에 대해 400 오류를 반환하므로, 요청의 해당 부분은 그대로 유지됩니다. 트래픽 또는 폴백 경로를 Claude Fable 5.2로 이동할 때는 다음과 같은 차이가 적용됩니다.

모델 이름 업데이트

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

변경 사항

1. 데이터 보존이 필요합니다: Claude Fable 5.2는 30일 데이터 보존이 필요하며, Anthropic이 명시적으로 승인하지 않는 한 데이터 무보존(ZDR) 약정하에서는 사용할 수 없습니다. 조직 또는 워크스페이스가 ZDR하에서 Claude Opus 5.5를 실행하고 있다면, 전환하기 전에 워크스페이스에 대해 30일 보존을 활성화하거나 Anthropic 계정 팀에 문의하세요. 그렇지 않으면 Claude API에서 Claude Fable 5.2에 대한 모든 요청이 400 invalid_request_error를 반환합니다. 모델별 데이터 보존 요구 사항을 참조하세요.

2. 접두사 검사가 모든 계정에 적용됩니다: Claude Opus 5.5는 기본적으로 2026년 8월 31일 이후에 생성된 계정에 접두사 검사를 적용합니다. Claude Fable 5.2는 계정 생성 시기와 관계없이 모든 계정에 이를 적용합니다. 계정이 그보다 오래되었고 코드가 이전 턴을 편집하는 경우, Claude Opus 5.5에서 작동하던 요청이 Claude Fable 5.2에서 실패합니다. 전환하기 전에 테스트하려면 접두사 검사가 모든 계정에 적용됩니다를 참조하세요.

3. Claude Opus 5.5는 Claude Fable 5.2의 사고 블록을 읽을 수 없습니다: Claude Fable 5.2에서 Claude Opus 5.5로 이동하는 대화는 텍스트와 도구 호출을 유지하지만, 전환 이후의 턴은 Claude Fable 5.2의 추론 없이 실행됩니다. API는 모델이 해당 블록을 받기 전에 이를 제거하며, 요청은 성공하고, 제거된 블록에는 요금이 청구되지 않습니다. 전환 후 첫 번째 턴에서 비용과 지연 시간이 증가할 것으로 예상하세요. 반대 방향으로는, Claude API 및 Claude Models on Google Cloud (Google managed)에서 Claude Fable 5.2가 Claude Opus 5.5의 사고 블록을 읽으므로, claude-opus-5-5에서 claude-fable-5-2로 이동하는 대화는 이전 추론을 유지합니다.

4. 안전 분류기 및 폴백: Claude Fable 5.2는 Claude Fable 5.1과 동일한 stop_details 카테고리를 다루는 안전 분류기를 실행합니다. Claude Opus 5.5에서 본 카테고리만이 아니라 거부 카테고리 표의 모든 카테고리를 처리하세요. 거부된 요청을 다른 모델에서 다시 실행하려면 fallbacks: "default"를 설정하여 해당 카테고리에 대해 Anthropic이 권장하는 모델로 재시도하거나, 자체 재시도를 구현하세요. 이 매개변수는 Claude API 및 Claude Models on Google Cloud (Anthropic managed)에서 베타 버전이며, server-side-fallback-2026-07-01 베타 헤더가 필요합니다. Claude Fable 5.2에 허용되는 폴백 대상은 Claude Opus 4.8(claude-opus-4-8)과 Claude Opus 5(claude-opus-5)입니다. 서버 측 폴백은 "reasoning_extraction"으로 거부된 요청을 재시도하지 않습니다. 해당 거부는 그대로 반환됩니다. 폴백 모델은 Claude Fable 5.2의 사고 블록을 받지 않습니다. 거부 및 폴백을 참조하세요.

5. 가격: Claude Fable 5.2의 비용은 입력 토큰 100만 개당 $8 USD, 출력 토큰 100만 개당 $40 USD로, Claude Opus 5.5의 $4 USD 및 $20 USD와 비교됩니다. 프롬프트 캐시 읽기는 두 모델 모두 토큰 100만 개당 $0.20 USD입니다. 가격을 참조하세요.

6. Fast mode: Claude Fable 5.2는 Claude Opus 5.5와 마찬가지로 Claude API의 Messages API 요청에서 fast mode(speed: "fast")를 지원합니다. Claude Fable 5.2의 fast mode 비용은 입력 토큰 100만 개당 $16 USD, 출력 토큰 100만 개당 $80 USD로, fast mode에서 Claude Opus 5.5의 $8 USD 및 $40 USD와 비교됩니다. Fast mode 요금을 참조하세요.

   Claude Fable 5.2는 동일한 speed: "fast" 설정으로 Claude Models on Google Cloud (Anthropic managed)에서도 fast mode를 지원합니다.

   Claude Fable 5.2는 동일한 speed: "fast" 설정으로 Claude Models on Google Cloud (Google managed)에서도 fast mode를 지원합니다. 해당 플랫폼의 가격은 Google Cloud가 책정합니다. 클라우드 플랫폼 요금을 참조하세요.

   Claude Fable 5.2는 Anthropic에서 호스팅되는 배포에 대해 Microsoft Foundry의 Claude에서도 fast mode를 지원합니다. 해당 플랫폼에서 fast mode는 별도의 모델입니다. claude-fable-5-2-fast 배포로 요청을 보내고 speed는 생략하세요.

   Claude Mythos 5.2도 Claude API의 Messages API 요청에서 Claude Fable 5.2의 fast mode 가격으로 fast mode를 지원합니다. Claude Mythos 5.2가 fast mode를 지원하는 모든 플랫폼은 Fast mode 제공 여부에서 확인할 수 있습니다.

   Claude Managed Agents에서는 speed: "fast"를 제거하세요. 또한 Fast mode 제공 여부에 이동하려는 모델이 나열되지 않은 플랫폼 또는 호스팅 옵션에서도 이를 제거하세요.

7. CMEK 조직의 구조화된 출력: 고객 관리형 암호화 키를 사용하는 조직에서 Claude Opus 5.5는 구조화된 출력을 지원하지만 Claude Fable 5.2는 지원하지 않습니다. 이동하는 요청에서 strict: true와 output_config.format을 제거하고, 코드에서 출력을 검증하세요.

8. 기본 effort는 high입니다: Claude Opus 5.5의 기본값은 medium이므로, effort를 생략한 요청은 Claude Fable 5.2에서 한 단계 높은 수준으로 실행됩니다. 요청은 성공하며, 변경 사항은 비용, 지연 시간, 결과의 차이로만 나타납니다. effort를 명시적으로 설정한 다음, 자체 평가에서 effort 스윕을 다시 실행하세요.

9. Claude Fable 5.2 실행자에는 Claude Fable 5.2 또는 Claude Mythos 5.2 어드바이저가 필요합니다: 베타 버전인 어드바이저 도구를 사용할 때 Claude Opus 5.5 실행자는 Claude Opus 5.5와 Claude Fable 5.1을 포함한 여러 어드바이저를 허용합니다. Claude Fable 5.2 실행자는 Claude Fable 5.2 또는 Claude Mythos 5.2만 허용하며, 그 외의 어드바이저는 400 오류를 반환합니다. 실행자의 모델을 변경할 때 어드바이저의 model을 claude-fable-5-2 또는 claude-mythos-5-2로 설정하세요. Claude Fable 5.2 실행자에는 Claude Fable 5.2 또는 Claude Mythos 5.2 어드바이저가 필요합니다를 참조하세요.

마이그레이션 체크리스트

• 조직에 ZDR 약정이 있는 경우, 무엇보다 먼저 워크스페이스에 대해 30일 보존을 활성화하거나 Anthropic 계정 팀에 자격을 확인하세요.
• 모델 ID를 claude-opus-5-5에서 claude-fable-5-2로 업데이트하세요.
• 프로덕션 트래픽을 이동하기 전에 속도 제한을 확인하세요. Claude Fable 5.2의 속도 제한은 Claude Opus 5.5와 별도이며, 각 티어에서 토큰 제한이 더 낮습니다.
• 코드에서 messages 배열을 직접 구성하는 경우, 계정이 Claude Opus 5.5에서 검사에 걸린 적이 없더라도 접두사 검사가 모든 계정에 적용됩니다의 테스트를 실행하세요.
• 모든 stop_details.category를 처리하세요. 명시적인 fallbacks 목록을 설정하는 경우, Claude Fable 5.2에 허용된 대상만 지정하세요.
• 라우터나 폴백이 대화를 Claude Fable 5.2에서 Claude Opus 5.5로 이동하는 경우, 전환 이후의 턴이 Claude Fable 5.2의 사고 블록 없이 실행될 것으로 예상하세요.
• 저장된 대화를 다른 계정을 통해 재생하는 경우, 각 대화를 이를 생성한 계정 또는 그 계정과 연결된 계정을 통해 재생하세요. API는 다른 계정이 생성한 Claude Fable 5.2 사고 블록을 제거합니다. 사고 블록은 생성한 계정에 귀속됩니다를 참조하세요.
• Messages API 요청에서 fast mode를 사용하는 경우, Fast mode 제공 여부에 이동하려는 모델이 나열된 플랫폼 또는 호스팅 옵션에서만 speed: "fast"를 유지하세요. 해당 플랫폼 및 호스팅 옵션에서는 fast mode 가격을 기준으로 비용 기준선을 다시 설정하세요. 그 외의 모든 플랫폼 또는 호스팅 옵션과 Claude Managed Agents에서는 speed: "fast"를 제거하세요. fast-mode-2026-02-01 베타 헤더는 필요하지 않습니다. Claude API에서는 이를 전송하는 요청도 계속 작동합니다. Microsoft Foundry의 Claude는 예외입니다. 해당 플랫폼에서는 speed: "fast"를 제거하고 claude-fable-5-2-fast 배포로 요청을 보내세요.
• Claude Fable 5.2를 실행자로 하여 어드바이저 도구를 사용하는 경우, 어드바이저의 model을 claude-fable-5-2 또는 claude-mythos-5-2로 설정하세요.
• 고객 관리형 암호화 키를 사용하는 조직에서는 strict: true와 output_config.format을 제거하고, 코드에서 출력을 검증하세요.
• effort를 명시적으로 설정하세요. Claude Fable 5.2의 기본값은 high이고 Claude Opus 5.5의 기본값은 medium이므로, 이를 생략한 요청은 한 단계 높은 수준으로 실행됩니다. 그런 다음 자체 평가에서 effort 스윕을 다시 실행하고, 비용과 지연 시간의 기준선을 다시 설정하세요.
• 이전하는 시스템 프롬프트, 스킬 및 기타 지시 사항을 이전 모델용으로 작성된 지침 검토하기와 대조하여 확인하세요.

Claude Fable 5에서 Claude Fable 5.2로 마이그레이션

API 표면, 컨텍스트 윈도우 및 출력 제한, 토크나이저, 항상 켜져 있는 적응형 사고, 거부 처리는 모두 Claude Fable 5와 동일합니다. 다음 변경 사항 중 일부는 Claude Mythos 5에서 Claude Mythos 5.2로 이동할 때도 적용됩니다. 어떤 사항이 적용되는지는 Claude Mythos 5에서 Claude Mythos 5.2로 마이그레이션에서 확인할 수 있습니다.

모델 이름 업데이트

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

호환성을 깨는 변경 사항

1. “Forced tool choice”(강제 도구 선택)는 400 오류를 반환합니다: Claude Fable 5는 tool_choice로 auto, none, any, tool을 허용합니다. claude-fable-5-2에서는 {type: "any"}와 {type: "tool", name: "..."}가 400 invalid_request_error를 반환하며, 토큰 카운팅 엔드포인트도 마찬가지입니다. 오류 메시지는 강제 도구 사용 미지원을 참조하세요.

   도구 호출을 강제하지 않고 얻으려면 tool_choice를 auto로 두고 지시문에서 도구 이름을 지정하세요. 호출이 스키마와 일치하도록 도구에 strict: true를 설정하세요. 엄격한 도구 사용을 참조하세요. 스키마에 맞는 JSON을 얻기 위해서만 도구를 강제했다면 대신 JSON 출력을 사용하세요. 고객 관리형 암호화 키를 사용하는 조직에서는 구조화된 출력을 Claude Fable 5.2 또는 Claude Mythos 5.2에서 사용할 수 없습니다. 여기에는 엄격한 도구 사용과 JSON 출력이 모두 포함됩니다. 이 경우 auto와 지시문을 유지하고, strict를 생략하며, 코드에서 도구 입력을 검증하세요.

   애플리케이션이 현재 턴에서 특정 도구 호출을 필요로 하는 경우, 최신 user 턴 뒤에 대화 중간 시스템 메시지를 추가하세요. 도구 이름을 지정하고, 이 턴에서 해당 호출이 필수라고 명시하며, Claude에게 응답을 그 호출로 시작하라고 지시하세요. 이전 턴은 변경되지 않으므로 해당 턴의 프롬프트 캐시 적중과 사고 블록이 유효하게 유지됩니다. 대화 중간 시스템 메시지에서 이 기능을 사용할 수 있는 플랫폼 목록을 확인하세요. 도구를 호출하면 안 되는 턴에는 tool_choice: {"type": "none"}을 여전히 사용할 수 있습니다. 도구 사용 강제를 참조하세요.

2. 이전 턴을 편집하면 모든 계정에서 사고 블록이 무효화됩니다: Claude Fable 5는 이전 턴이 변경되었는지 확인하지 않습니다. Claude Fable 5.2에서는 각 thinking 블록이 그 앞에 온 system 프롬프트, tools, 메시지에 대해서만 유효합니다. Claude Fable 5.2는 모든 계정에 대해 이 prefix check(접두사 검사)를 적용합니다. 이 중 무엇이라도 변경된 후 사고 블록을 다시 보내는 요청은 400 오류를 반환하며, 동일한 요청 본문으로 재시도해도 해결되지 않습니다.

   Claude Code, claude.ai, Claude Managed Agents 또는 Claude Agent SDK가 대화 기록을 관리하는 경우에는 달라지는 것이 없습니다. 코드에서 직접 messages 배열을 구성하는 경우, 기록을 추가 전용(append-only)으로 유지하세요. 세션 동안 system과 tools를 고정하세요. 지시문 및 도구 변경은 대화 중간 시스템 메시지로 수행하고, 컨텍스트는 서버 측 컴팩션 또는 컨텍스트 편집으로 줄이세요. 대화 중간 시스템 메시지에서 이 기능을 사용할 수 있는 플랫폼 목록을 확인하세요. 접두사를 편집하지 않고 변경하기에서 일반적인 각 편집에 대한 대체 방법을 안내합니다.

   프로덕션 트래픽을 전환하기 전에 이러한 편집을 찾으려면 claude-fable-5-2를 대상으로 코드가 접두사를 편집하는지 확인하기의 검사를 실행하세요. 프로덕션에서 불일치가 코드의 버그만을 의미할 수 있다면 prefix_mismatch_behavior를 기본값인 "error"로 두세요. 편집을 수정하는 동안 영향을 받는 블록을 삭제하고 해당 추론 없이 계속 진행하려면 thinking-binding-controls-2026-08-01 베타 헤더와 함께 "drop_block"으로 설정하세요. 이는 장기적인 설정이 아닌 임시방편으로 취급하세요: 블록을 삭제하면 출력 토큰이 증가할 수 있습니다.

3. Claude Fable 5는 Claude Fable 5.2의 사고 블록을 읽을 수 없습니다: Claude API 및 Claude Models on Google Cloud (Google managed)에서 Claude Fable 5.2는 Claude Fable 5의 블록을 읽으므로, claude-fable-5에서 claude-fable-5-2로 이동한 대화는 이전 추론을 유지합니다. 반대 방향으로는 Claude Fable 5가 Claude Fable 5.2의 블록을 읽을 수 없습니다. 라우터 전환, 클라이언트 측 재시도 또는 분류기 거부 폴백으로 인해 대화가 Claude Fable 5.2에서 Claude Fable 5를 포함한 다른 모델로 이동하면, API는 해당 모델이 읽을 수 없는 블록을 삭제합니다. 요청은 성공하며, 삭제된 입력 토큰에 대해서는 요금이 청구되지 않습니다. thinking-binding-controls-2026-08-01 베타 헤더를 사용하면 input_transformations에 삭제된 각 블록이 reason: "model_binding_mismatch"와 함께 나열됩니다. 대화 도중 모델 전환을 참조하세요.

4. computer_20251124 대신 computer use 도구 세트를 사용하세요: Claude Fable 5.2에서는 유형이 computer_20251124인 tools 항목이 Amazon Bedrock을 제외한 모든 플랫폼에서 400 오류를 반환합니다. Claude Fable 5는 베타 헤더와 함께 이를 허용합니다. 대신 computer_20251124 대신 computer use 도구 세트 사용하기에 설명된 대로 computer_toolset_20260801 도구 세트를 선언하세요.

5. Claude Fable 5.2 실행자에는 Claude Fable 5.2 또는 Claude Mythos 5.2 어드바이저가 필요합니다: 베타 버전인 어드바이저 도구에서 Claude Fable 5.2 실행자는 Claude Fable 5.2 또는 Claude Mythos 5.2만 어드바이저로 허용합니다. Claude Fable 5 실행자가 허용하는 다른 어드바이저(예: Claude Fable 5, Claude Opus 5.5)는 400 오류를 반환합니다. 실행자의 model을 변경할 때 어드바이저의 model을 claude-fable-5-2 또는 claude-mythos-5-2로 설정하세요. Claude Fable 5.2 실행자에는 Claude Fable 5.2 또는 Claude Mythos 5.2 어드바이저가 필요합니다를 참조하세요.

기타 변경 사항

• 가격: 입력 토큰 백만 개당 $8 USD, 출력 토큰 백만 개당 $40 USD이며, Claude Fable 5의 $10 USD 및 $50 USD와 비교됩니다. 프롬프트 캐시 읽기는 토큰 백만 개당 $0.20 USD로, $1 USD와 비교됩니다. 가격을 참조하세요.
• Priority Tier: Claude Fable 5.2는 Priority Tier에서 지원되지 않습니다. Claude Fable 5는 지원됩니다. 조직에 Priority Tier 약정이 있는 경우 용량을 별도로 계획하세요.
• 메시지별 effort (베타): 프롬프트 캐시 적중을 잃지 않고 대화 도중 effort를 변경하려면, 요청 사이에 output_config.effort를 변경하는 대신 메시지별 effort role: "system" 메시지를 보내세요. 해당 섹션에서 이 기능을 사용할 수 있는 플랫폼 목록을 확인하세요.

마이그레이션 체크리스트

• 모델 이름을 claude-fable-5에서 claude-fable-5-2로 업데이트하세요.
• 프로덕션 트래픽을 이동하기 전에 속도 제한을 확인하세요. Claude Fable 5.2에는 Claude Fable 5.1과 Claude Fable 5가 공유하는 속도 제한과는 별도의 자체 속도 제한이 있습니다.
• 강제 tool_choice({type: "any"} 또는 {type: "tool", ...})를 {type: "auto"}와 명시적인 지시문 및 strict: true 도구로 대체하거나, JSON 출력으로 대체하세요. 지시문은 user 턴에 넣으세요. 애플리케이션이 호출을 필요로 하는 경우에는 대화 중간 시스템 메시지에 나열된 플랫폼에서 대신 대화 중간 role: "system" 메시지에 넣으세요. 고객 관리형 암호화 키를 사용하는 조직에서는 엄격한 도구 사용과 JSON 출력을 Claude Fable 5.2에서 사용할 수 없습니다. 이 경우 {type: "auto"}와 지시문을 유지하고 코드에서 도구 입력을 검증하세요.
• 코드에서 직접 messages 배열을 구성하는 경우, thinking-binding-controls-2026-08-01 베타 헤더와 prefix_mismatch_behavior: "drop_block"으로 세션을 실행하고, input_transformations를 로깅하며, 모든 prefix_binding_mismatch 항목을 수정하세요. 모델 전환 후의 model_binding_mismatch 항목은 예상된 것입니다.
• 기록을 추가 전용으로 유지하세요: 세션 시작 시 system과 tools를 고정하고, 세션 중 변경은 role: "system" 메시지로 수행하며, 컨텍스트는 서버에서 줄이세요. 대화 중간 시스템 메시지에서 이 기능을 사용할 수 있는 플랫폼 목록을 확인하세요.
• 프로덕션 prefix_mismatch_behavior를 선택하세요: "error"(기본값) 또는 편집을 수정하는 동안의 임시방편으로 "drop_block". 블록을 삭제하면 출력 토큰이 증가할 수 있기 때문입니다. 400 오류 또는 input_transformations 항목을 모니터링하세요.
• 비어 있는 블록을 포함하여 모든 턴에서 thinking 블록을 변경 없이 계속 다시 전달하세요. 라우터나 폴백이 대화를 Claude Fable 5.2에서 Claude Fable 5로 이동할 수 있다면, Claude Fable 5가 Claude Fable 5.2의 블록 없이 실행될 것으로 예상하세요.
• 저장된 대화를 다른 계정을 통해 재생하는 경우, 각 대화를 해당 대화를 생성한 계정 또는 그 계정에 연결된 계정을 통해 재생하세요. API는 다른 계정이 생성한 Claude Fable 5.2 사고 블록을 삭제합니다. 사고 블록은 생성한 계정에 귀속됩니다를 참조하세요.
• computer_20251124를 통해 computer use를 Amazon Bedrock 이외의 곳에서 사용하는 경우, Claude Fable 5.2는 해당 도구에 대해 400 오류를 반환합니다. 대신 computer_toolset_20260801을 선언하고 도구 세트에 맞게 에이전트 루프를 업데이트하세요.
• Claude Fable 5.2를 실행자로 하여 어드바이저 도구를 사용하는 경우, 어드바이저의 model을 claude-fable-5-2 또는 claude-mythos-5-2로 설정하세요.
• 요청 사이에 effort를 변경하는 경우, 플랫폼이 지원하는 곳에서 해당 변경을 베타 기능인 메시지별 effort role: "system" 메시지로 옮기세요.
• 조직에 Priority Tier 약정이 있는 경우 용량을 별도로 계획하세요.
• stop_reason: "refusal"을 처리하고 stop_details.category를 읽으세요. fallbacks: "default"를 고려하세요. 이는 Claude API 및 Claude Models on Google Cloud (Anthropic managed)에서 베타 버전입니다.
• 자체 평가에서 effort 스윕을 다시 실행하고, 비용과 지연 시간의 기준선을 다시 설정하세요.
• 가져오는 시스템 프롬프트, 스킬 및 기타 지시문을 이전 모델용으로 작성된 지침 검토하기와 대조하여 확인하세요.

Claude Mythos 5에서 Claude Mythos 5.2로 마이그레이션

Claude Mythos 5.2는 Cyber Verification Program과 같은 Anthropic의 인증 프로그램을 통해 인증된 조직을 위한 Claude Fable 5.2의 대응 모델입니다. 모델 ID를 전환하기 전에 조직이 Claude Mythos 5.2에 액세스할 수 있는지 확인하세요.

Claude Fable 5에서 Claude Fable 5.2로 마이그레이션의 변경 사항 중 네 가지가 그대로 적용됩니다:

• 강제 도구 선택은 400 오류를 반환합니다.
• 이전 턴을 편집하면 사고 블록이 무효화됩니다(모든 계정에 대해).
• computer_20251124 대신 computer use 도구 세트를 사용하세요.
• Claude Fable 5.2 또는 Claude Mythos 5.2 실행자에는 이 두 모델 중 하나가 어드바이저로 필요합니다.

Claude API 및 Claude Models on Google Cloud (Google managed)에서 Claude Mythos 5.2는 Claude Mythos 5의 사고 블록을 읽으므로, claude-mythos-5에서 claude-mythos-5-2로 이동한 대화는 이전 추론을 유지합니다. 반대 방향으로는 Claude Mythos 5가 Claude Mythos 5.2의 블록을 읽을 수 없습니다: API가 이를 삭제하고 요청은 성공합니다. 대화 도중 모델 전환을 참조하세요. Claude Mythos 5.2의 비용은 입력 토큰 백만 개당 $8 USD, 출력 토큰 백만 개당 $40 USD이며, Claude Mythos 5의 $10 USD 및 $50 USD와 비교됩니다. 프롬프트 캐시 읽기는 토큰 백만 개당 $0.20 USD로, $1 USD와 비교됩니다.

모델 이름 업데이트

model = "claude-mythos-5"  # Before
model = "claude-mythos-5-2"  # After

마이그레이션 체크리스트

• 모델 이름을 claude-mythos-5에서 claude-mythos-5-2로 업데이트하세요.
• 강제 tool_choice(any 또는 tool)를 auto와 명시적인 지시문 및 strict: true 도구로 대체하거나, JSON 출력으로 대체하세요. 고객 관리형 암호화 키를 사용하는 조직에서는 엄격한 도구 사용과 JSON 출력을 Claude Mythos 5.2에서 사용할 수 없습니다. 이 경우 auto와 지시문을 유지하고 코드에서 도구 입력을 검증하세요.
• computer_20251124를 통해 computer use를 Amazon Bedrock 이외의 곳에서 사용하는 경우, Claude Mythos 5.2는 해당 도구에 대해 400 오류를 반환합니다. 대신 computer_toolset_20260801을 선언하고 도구 세트에 맞게 에이전트 루프를 업데이트하세요.
• Claude Mythos 5.2를 실행자로 하여 어드바이저 도구를 사용하는 경우, 어드바이저의 model을 claude-mythos-5-2 또는 claude-fable-5-2로 설정하세요.
• 비어 있는 블록을 포함하여 모든 턴에서 thinking 블록을 변경 없이 계속 다시 전달하세요.
• 저장된 대화를 다른 계정을 통해 재생하는 경우, 각 대화를 해당 대화를 생성한 계정 또는 그 계정에 연결된 계정을 통해 재생하세요. API는 다른 계정이 생성한 Claude Mythos 5.2 사고 블록을 삭제합니다. 사고 블록은 생성한 계정에 귀속됩니다를 참조하세요.
• 코드에서 직접 messages 배열을 구성하는 경우, claude-mythos-5-2를 대상으로 이전 턴을 편집하면 사고 블록이 무효화됩니다의 검사를 실행하고, 모든 prefix_binding_mismatch 항목을 수정하며, 대화 기록을 추가 전용으로 유지하세요(편집으로 간주되는 것 참조). 추가 전용 기록은 프롬프트 캐시도 유지해 줍니다.
• stop_reason: "refusal"을 처리하고, 응답 콘텐츠보다 먼저 stop_details.category를 읽으세요. 거부 및 폴백을 참조하세요.
• effort 스윕을 다시 실행하고, 비용과 지연 시간의 기준선을 다시 설정하세요.
• 가져오는 시스템 프롬프트, 스킬 및 기타 지시문을 이전 모델용으로 작성된 지침 검토하기와 대조하여 확인하세요.

Claude Opus 5에서 Claude Fable 5.2로 마이그레이션

Claude Fable 5.2는 Claude Opus 5와 동일한 Messages API 및 도구 사용 패턴을 사용합니다. 1M 토큰 컨텍스트 윈도우, 128k 최대 출력 토큰, 512토큰 프롬프트 캐싱 최소값, 대화 중간 시스템 메시지가 그대로 유지됩니다. 프리필 및 샘플링 매개변수에 대한 제한도 마찬가지입니다. 트래픽 또는 폴백 경로를 Claude Fable 5.2로 이동할 때는 다음과 같은 차이점이 적용됩니다.

모델 이름 업데이트

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

변경 사항

1. thinking을 비활성화할 수 없습니다: Claude Opus 5는 노력 수준이 high 이하일 때 thinking: {type: "disabled"}를 허용합니다. Claude Fable 5.2에서는 adaptive thinking(적응형 사고)이 항상 켜져 있으며, thinking: {type: "disabled"}는 모든 노력 수준에서 400 오류를 반환합니다. 해당 필드를 제거하고, 더 낮은 노력 수준으로 토큰 사용량을 제어하세요. thinking을 비활성화한 채 실행되던 워크로드의 경우, thinking과 응답 텍스트를 모두 포함하는 max_tokens를 재검토하세요. 해당 코드가 content[0].text처럼 위치로 콘텐츠를 읽는다면, thinking 블록이 먼저 오므로 대신 type으로 콘텐츠 블록을 선택하세요.

2. 강제 도구 선택은 400 오류를 반환합니다: Claude Opus 5는 tool_choice any와 tool을 허용합니다. Claude Fable 5.2는 둘 다 거부합니다. 대신 보낼 내용은 강제 도구 선택은 400 오류를 반환합니다를 참조하세요.

3. 이전 턴을 편집하면 모든 계정에서 사고 블록이 무효화됩니다: Claude Opus 5는 이전 턴이 변경되었는지 확인하지 않습니다. Claude Fable 5.2는 모든 계정에 대해 이를 확인합니다. 코드가 요청 사이에 이전 메시지를 편집하거나, system 또는 tools를 다시 구성하거나, 클라이언트에서 컴팩션을 수행하는 경우, Claude Fable 5.2는 요청을 거부하거나 유효하지 않은 사고 블록을 삭제합니다. 변경할 내용과 테스트 방법은 이전 턴을 편집하면 사고 블록이 무효화됩니다를 참조하세요.

4. Claude Opus 5는 Claude Fable 5.2의 사고 블록을 읽을 수 없습니다: Claude API 및 Claude Models on Google Cloud (Google managed)에서 Claude Fable 5.2는 Claude Opus 5의 블록을 읽으므로, claude-opus-5에서 claude-fable-5-2로 이동한 대화는 이전 추론을 유지합니다. 반대 방향으로는 Claude Opus 5가 Claude Fable 5.2의 블록을 읽을 수 없습니다. Claude Fable 5.2에서 Claude Opus 5로 이동한 대화는 전환 이후의 턴을 Claude Fable 5.2의 추론 없이 실행합니다. API는 모델이 해당 블록을 받기 전에 이를 삭제하고, 요청은 성공하며, 삭제된 블록에 대해서는 요금이 청구되지 않습니다. 대화 도중 모델 전환을 참조하세요.

5. 도구 호출 사이의 텍스트가 사고 블록으로 반환됩니다: Claude Opus 5에서는 모델이 도구 호출 사이에 작성한 텍스트가 text 블록으로 반환됩니다. Claude Fable 5.2에서는 그 내레이션이 진행 상황 업데이트 thinking 블록으로 반환되며, 각 도구 호출 앞에 최대 하나씩 옵니다. 인터페이스에서 해당 내레이션을 렌더링하는 경우, 추론은 숨긴 채 진행 상황 업데이트를 텍스트로 받으려면 thinking.display를 베타 기능인 "updates"로 설정하고, 둘 다 받으려면 "summarized"로 설정하세요. 그런 다음 tool_use 블록 사이의 비어 있지 않은 thinking 블록을 렌더링하세요. 도구 호출 사이의 진행 상황 업데이트를 참조하세요.

6. computer_20251124 대신 computer use 도구 세트를 사용하세요: Claude Opus 5는 베타 헤더와 함께 이전 computer_20251124 도구를 허용합니다. Claude Fable 5.2는 이에 대해 Amazon Bedrock을 제외한 모든 플랫폼에서 400 오류를 반환합니다. computer_20251124 대신 computer use 도구 세트 사용하기를 참조하세요.

7. 안전 분류기 및 폴백: Claude Fable 5.2의 안전 분류기는 Claude Opus 5의 분류기보다 더 넓은 범위의 stop_details 카테고리를 다룹니다. "bio"와 같은 추가 stop_details.category 값을 예상하세요. 거부 카테고리 표의 모든 카테고리를 처리하세요. 거부된 요청을 다른 모델에서 다시 실행하려면 fallbacks: "default"를 설정하거나 자체 재시도를 구축하세요. 이 매개변수는 Claude API 및 Claude Models on Google Cloud (Anthropic managed)에서 베타 버전이며, server-side-fallback-2026-07-01 베타 헤더가 필요합니다. 거부, 폴백 및 요금 청구에서 허용되는 폴백 대상 목록을 확인하세요.

8. 가격: Claude Fable 5.2의 비용은 입력 토큰 백만 개당 $8 USD, 출력 토큰 백만 개당 $40 USD이며, Claude Opus 5의 $5 USD 및 $25 USD와 비교됩니다. 프롬프트 캐시 읽기는 토큰 백만 개당 $0.20 USD로, $0.50 USD와 비교됩니다. 가격을 참조하세요.

9. 데이터 보존이 필수입니다: Claude Fable 5.2는 30일 데이터 보존이 필요하며, Anthropic이 명시적으로 승인하지 않는 한 데이터 무보존(ZDR) 약정에서는 사용할 수 없습니다. Claude Opus 5는 ZDR에서 사용할 수 있습니다. Claude API에서 30일 보존이 없는 조직 또는 워크스페이스의 요청은 400 invalid_request_error를 반환합니다. 모델별 데이터 보존 요구 사항을 참조하세요.

10. Fast mode: Claude Opus 5는 fast-mode-2026-02-01 베타 헤더와 함께 fast mode(speed: "fast")를 연구 프리뷰로 지원합니다. Claude Fable 5.2는 Claude API의 Messages API 요청에서 헤더 없이 이를 지원합니다. 헤더를 전송하는 요청도 계속 작동합니다. Claude Fable 5.2의 fast mode 비용은 입력 토큰 백만 개당 $16 USD, 출력 토큰 백만 개당 $80 USD이며, fast mode에서 Claude Opus 5의 $10 USD 및 $50 USD와 비교됩니다. Fast mode 요금을 참조하세요.

    Claude Fable 5.2는 동일한 speed: "fast" 설정으로 Claude Models on Google Cloud (Anthropic managed)에서도 fast mode를 지원합니다.

    Claude Fable 5.2는 동일한 speed: "fast" 설정으로 Claude Models on Google Cloud (Google managed)에서도 fast mode를 지원합니다. 해당 플랫폼의 가격은 Google Cloud가 책정합니다. 클라우드 플랫폼 요금을 참조하세요.

    Claude Fable 5.2는 Anthropic에서 호스팅되는 배포에 대해 Microsoft Foundry의 Claude에서도 fast mode를 지원합니다. 해당 플랫폼에서 fast mode는 별도의 모델입니다. claude-fable-5-2-fast 배포로 요청을 보내고 speed는 생략하세요.

    Claude Mythos 5.2도 Claude API의 Messages API 요청에서 헤더 없이 Claude Fable 5.2의 fast mode 가격으로 fast mode를 지원합니다. Claude Mythos 5.2가 fast mode를 지원하는 모든 플랫폼은 Fast mode 제공 여부에서 확인할 수 있습니다.

    Claude Managed Agents에서는 speed: "fast"를 제거하세요. 또한 Fast mode 제공 여부에 이동하려는 모델이 나열되지 않은 경우에도 이를 제거하세요.

11. CMEK 조직의 구조화된 출력: 고객 관리형 암호화 키를 사용하는 조직에서 Claude Opus 5는 구조화된 출력을 지원하지만 Claude Fable 5.2는 지원하지 않습니다. 이동하는 요청에서 strict: true와 output_config.format을 제거하고, 코드에서 출력을 검증하세요.

12. Claude Fable 5.2 실행자에는 Claude Fable 5.2 또는 Claude Mythos 5.2 어드바이저가 필요합니다: 베타 버전인 어드바이저 도구에서 Claude Opus 5 실행자는 Claude Opus 5와 Claude Fable 5.1을 포함한 여러 어드바이저를 허용합니다. Claude Fable 5.2 실행자는 Claude Fable 5.2 또는 Claude Mythos 5.2만 허용하며, 다른 어드바이저는 400 오류를 반환합니다. 실행자의 model을 변경할 때 어드바이저의 model을 claude-fable-5-2 또는 claude-mythos-5-2로 설정하세요. Claude Fable 5.2 실행자에는 Claude Fable 5.2 또는 Claude Mythos 5.2 어드바이저가 필요합니다를 참조하세요.

마이그레이션 체크리스트

• 조직에 ZDR 약정이 있는 경우, 무엇보다 먼저 워크스페이스에 대해 30일 보존을 활성화하거나 Anthropic 계정 팀에 자격 여부를 확인하세요.
• 모델 ID를 claude-opus-5에서 claude-fable-5-2로 업데이트하세요.
• 프로덕션 트래픽을 이동하기 전에 속도 제한을 확인하세요. Claude Fable 5.2의 속도 제한은 Claude Opus 5와 별도이며, 각 티어에서 토큰 한도가 더 낮습니다.
• thinking: {type: "disabled"} 구성을 모두 제거하세요. 더 낮은 노력 수준으로 토큰 사용량을 제어하고, max_tokens를 재검토하며, type으로 콘텐츠 블록을 선택하세요.
• 비어 있는 블록을 포함하여 모든 턴에서 thinking 블록을 변경 없이 다시 전달하세요. 도구 사용 루프에서는 도구 결과와 함께 다시 보내세요. 사고 블록 보존을 참조하세요.
• 강제 tool_choice(any 또는 tool)를 auto와 명시적인 지시문 및 strict: true 도구로 대체하거나, JSON 출력으로 대체하세요. 고객 관리형 암호화 키를 사용하는 조직에서는 엄격한 도구 사용과 JSON 출력을 Claude Fable 5.2에서 사용할 수 없습니다. 이 경우 auto와 지시문을 유지하고 코드에서 도구 입력을 검증하세요.
• 코드에서 직접 messages 배열을 구성하는 경우, claude-fable-5-2를 대상으로 이전 턴을 편집하면 사고 블록이 무효화됩니다의 검사를 실행하고, 모든 prefix_binding_mismatch 항목을 수정하며, 기록을 추가 전용으로 유지하세요.
• computer_20251124를 통해 computer use를 Amazon Bedrock 이외의 곳에서 사용하는 경우, Claude Fable 5.2는 해당 도구에 대해 400 오류를 반환합니다. 대신 computer_toolset_20260801을 선언하고 도구 세트에 맞게 에이전트 루프를 업데이트하세요.
• Claude Fable 5.2를 실행자로 하여 어드바이저 도구를 사용하는 경우, 어드바이저의 model을 claude-fable-5-2 또는 claude-mythos-5-2로 설정하세요.
• 라우터나 폴백이 대화를 Claude Fable 5.2에서 Claude Opus 5로 이동하는 경우, 전환 이후의 턴이 Claude Fable 5.2의 사고 블록 없이 실행될 것으로 예상하세요.
• 저장된 대화를 다른 계정을 통해 재생하는 경우, 각 대화를 해당 대화를 생성한 계정 또는 그 계정에 연결된 계정을 통해 재생하세요. API는 다른 계정이 생성한 Claude Fable 5.2 사고 블록을 삭제합니다. 사고 블록은 생성한 계정에 귀속됩니다를 참조하세요.
• 인터페이스에서 도구 호출 사이의 텍스트를 렌더링하는 경우, thinking.display를 "updates"(베타 기능) 또는 "summarized"로 설정하고, 비어 있지 않은 thinking 블록을 렌더링하세요.
• 모든 stop_details.category를 처리하세요. 명시적인 fallbacks 목록을 설정하는 경우, Claude Fable 5.2에 허용된 대상만 지정하세요.
• Claude API의 Messages API 요청에서 fast mode를 사용하는 경우, Fast mode 제공 여부에 이동하려는 모델이 나열된 경우에만 speed: "fast"를 유지하세요. 유지하는 경우 fast mode 가격을 기준으로 비용 기준선을 다시 설정하세요. Claude Managed Agents에서는 speed: "fast"를 제거하세요. fast-mode-2026-02-01 베타 헤더는 필요하지 않으며, 이를 전송하는 요청도 계속 작동합니다.
• 고객 관리형 암호화 키를 사용하는 조직에서는 strict: true와 output_config.format을 제거하고, 코드에서 출력을 검증하세요.
• 자체 평가에서 effort 스윕을 다시 실행하고, 비용과 지연 시간의 기준선을 다시 설정하세요.
• 가져오는 시스템 프롬프트, 스킬 및 기타 지시문을 이전 모델용으로 작성된 지침 검토하기와 대조하여 확인하세요.

Claude Opus 4.8 이하에서 Claude Fable 5.2로 마이그레이션

먼저 claude-opus-4-8을 교체할 모델 ID로 하여 Claude Opus 5에서 Claude Fable 5.2로 마이그레이션을 진행하세요. Claude Opus 4.8은 Claude Opus 5와 마찬가지로 다음과 같으므로, 해당 섹션은 Claude Opus 4.8의 코드에 그대로 적용됩니다:

• thinking: {type: "disabled"}, 강제 도구 선택, computer_20251124 도구, fast mode를 허용합니다.
• 도구 호출 사이의 텍스트를 text 블록으로 반환합니다.
• zero data retention(ZDR) 약정에서 사용할 수 있습니다.
• 비용은 입력 토큰 백만 개당 $5 USD, 출력 토큰 백만 개당 $25 USD이며, 프롬프트 캐시 읽기는 $0.50 USD입니다.

이 섹션에서는 Claude Opus 5 섹션에서 다루지 않는 차이점을 추가로 설명합니다.

변경 사항

1. thinking을 생략한 요청에서도 thinking이 실행됩니다: Claude Opus 4.8에서는 요청하지 않는 한 thinking이 꺼져 있습니다. Claude Fable 5.2에서는 thinking 필드가 없는 요청이 adaptive thinking으로 실행됩니다. 응답에서 text 블록 앞에 thinking 블록이 올 수 있으므로, content[0].text를 읽는 대신 type으로 콘텐츠 블록을 선택하세요. 도구 사용 루프에서는 비어 있는 블록을 포함하여 thinking 블록을 도구 결과와 함께 변경 없이 다시 보내세요. thinking 토큰은 출력 토큰으로 청구되며, max_tokens는 thinking과 응답 텍스트를 모두 포함합니다. max_tokens를 재검토하고, thinking을 줄이려는 곳에서는 effort를 낮추세요. Claude API 및 Claude Models on Google Cloud (Google managed)에서 Claude Fable 5.2는 이전 Claude Opus 4.8 턴의 사고 블록을 읽으므로, claude-fable-5-2로 이동한 대화는 해당 추론을 유지합니다.

2. 더 낮은 프롬프트 캐싱 최소값: Claude Fable 5.2의 최소 캐시 가능 프롬프트 길이는 512토큰으로, Claude Opus 4.8의 1,024토큰보다 낮습니다. 캐시하기에 너무 짧았던 프롬프트도 코드 변경 없이 캐시 항목을 생성할 수 있습니다. 프롬프트 캐싱을 참조하세요.

3. Priority Tier가 지원되지 않습니다: Claude Opus 4.8은 Priority Tier를 지원합니다. Claude Fable 5.2는 지원하지 않습니다. 조직에 Priority Tier 약정이 있는 경우 용량을 별도로 계획하세요.

4. 어드바이저 도구의 조언이 암호화되어 반환됩니다: 베타 버전인 어드바이저 도구에서 Claude Opus 4.8 실행자는 Claude Opus 4.8과 같이 조언을 일반 텍스트로 반환하는 어드바이저와 함께 사용할 수 있습니다. Claude Fable 5.2 실행자가 허용하는 유일한 어드바이저인 Claude Fable 5.2와 Claude Mythos 5.2는 조언을 advisor_redacted_result 블록으로 암호화하여 반환하므로, 클라이언트에서 그 텍스트를 읽을 수 없습니다. 코드가 조언 텍스트를 읽는 경우 해당 의존성을 제거하세요. 결과 변형을 참조하세요.

코드가 Claude Opus 4.7 이하에 있는 경우, Claude Opus 5.5 가이드의 마이그레이션 체크리스트 중 일부도 적용하세요. Claude Opus 4.7 이하 그룹에서 시작하여 해당 모델을 명시한 그룹까지 내려가세요. 이 그룹들은 제거된 샘플링 매개변수 및 베타 헤더와 같이 Claude Opus 4.8 이전에 이루어진 요청 변경 사항을 다룹니다. 해당 체크리스트의 fast mode 항목은 Fast mode 제공 여부에 이동하려는 모델이 나열된 경우에만 적용하세요. 고객 관리형 암호화 키를 사용하는 조직에서는 구조화된 출력을 Claude Fable 5.2에서 사용할 수 없으므로, 그곳에서는 output_config.format 항목을 적용하지 마세요. 대신 요청에서 output_format을 제거하고, 코드에서 JSON을 검증하세요.

마이그레이션 체크리스트

• claude-opus-4-8을 교체할 모델 ID로 하여 Claude Opus 5 체크리스트를 진행하세요.
• thinking 필드 없이 실행되던 워크로드를 검토하세요. Claude Fable 5.2에서는 이러한 워크로드가 thinking과 함께 실행되므로, max_tokens를 재검토하고, thinking을 줄이려는 곳에서는 effort를 낮추며, type으로 콘텐츠 블록을 선택하세요.
• thinking 필드를 파싱하는 코드가 이를 표시용 텍스트로만 취급하는지 확인하세요. 읽을 수 있는 요약을 받으려면 thinking.display를 "summarized"로 설정하세요.
• 캐싱 최소값 근처의 프롬프트를 검토하세요: 512토큰 이상의 프롬프트는 캐시 항목을 생성할 수 있습니다.
• 조직에 Priority Tier 약정이 있는 경우 용량을 별도로 계획하세요.
• 어드바이저 도구를 사용하고 코드가 조언 텍스트를 읽는 경우 해당 의존성을 제거하세요: 조언은 암호화된 advisor_redacted_result 블록으로 도착합니다.
• Claude Opus 4.8에 맞게 조정된 설정을 가져오는 대신 자체 평가에서 새로운 effort 스윕을 실행하세요.
• Claude Opus 4.7 이하에서는 해당 모델에 대한 Claude Opus 5.5 가이드의 체크리스트 그룹도 적용하세요. Fast mode 제공 여부에 이동하려는 모델이 나열되지 않은 경우 fast mode 항목은 생략하세요. 고객 관리형 암호화 키를 사용하는 조직에서는 output_config.format 항목도 생략하고 요청에서 output_format을 제거하세요.