Claude Haiku 5.5 이후 첫 JSON 블록이 답이 아닌 이유: budget_tokens에서 content.type까지

2026년 10월 9일 기준: Haiku 5.5는 10월 7일 claude-haiku-5-5로 나왔다. 적응형 사고는 기본으로 켜져 첫 블록이 thinking일 수 있다. budget_tokens는 400이다. content.type으로 text를 읽고 JSON.parse 하라.

Haiku 5.5가 바꾸는 것은 응답 JSON의 어느 덩어리가 답인가입니다. 2026년 10월 7일 Anthropic은 Claude Haiku 5.5를 냈습니다. 모델 ID는 claude-haiku-5-5입니다. 적응형 사고는 기본으로 켜져 있어서 content의 첫 항목이 thinking 블록일 수 있고, 기본값은 본문이 빈 signature뿐입니다. budget_tokens를 남긴 요청은 400입니다. type으로 text를 고른 다음 JSON.parse에 넘기세요.

이 글은 2026년 10월 9일 기준입니다. 모델 페이지, 마이그레이션 가이드, 10월 7일 릴리스 노트를 따릅니다. 9월 29일 Sonnet 5.5와 between_tools는 Haiku 5.5를 아직 「앞으로 몇 주」라고 적었습니다. 그 날이 왔습니다. Sonnet의 400 네 곳을 다시 쓰지 않습니다. Haiku 4.5에서 5.5로 JSON 추출 코드가 바꿔야 하는 층만 답합니다.

10월 7일에 나온 것

공식 용도는 대량이면서 지연에 민감한 일입니다. 분류, 라우팅, 추출, 서브에이전트. 컨텍스트 100만 토큰, 최대 출력 12.8만. 사고는 적응형이고 기본 effort는 medium입니다. Claude API, Amazon Bedrock, Claude Platform on AWS, Google Cloud, Microsoft Foundry. 은퇴는 2027년 10월 7일보다 이르지 않습니다. claude-haiku-5-5에는 날짜 접미사도 별칭도 없습니다.

플랫폼Haiku 4.5Haiku 5.5
Claude APIclaude-haiku-4-5claude-haiku-5-5
Amazon Bedrockanthropic.claude-haiku-4-5anthropic.claude-haiku-5-5
Google Cloudclaude-haiku-4-5@20251001claude-haiku-5-5
Microsoft Foundryclaude-haiku-4-5claude-haiku-5-5

가격은 프롬프트가 10만 토큰을 넘는지로 나뉩니다(100만 토큰당 미국 달러). 10만 이하: 입력 0.10, 출력 0.50, 캐시 읽기 0.01, 5분 쓰기 0.125, 1시간 쓰기 0.20. 초과: 입력 0.50, 출력 2.50, 읽기 0.05, 5분 쓰기 0.625, 1시간 쓰기 1. Batch는 입력과 출력이 50%입니다. 비교표의 Haiku 4.5는 입력 1, 출력 5입니다. 발표는 평균으로 약 75% 더 싸다고도 적습니다. 같은 날 Sonnet 5.5 캐시 읽기는 0.20에서 0.10으로 내려갔습니다. 다른 가격표입니다. Haiku의 0.01과 섞지 마세요.

첫 블록은 답이 아닙니다

적응형 사고는 기본으로 켜져 있습니다. thinking을 빼도 응답은 thinking 블록으로 시작할 수 있습니다. 기본값은 thinking 필드가 빈 문자열이고 signature만 있습니다. Haiku 4.5는 요약된 사고를 돌려줬습니다. 요약이 필요하면 display를 summarized로 두세요.

마이그레이션 가이드는 직선입니다. 위치가 아니라 type으로 블록을 고르세요. 도구 결과를 돌려줄 때 thinking 블록은 signature까지 그대로 보내세요. 사고 토큰은 max_tokens에 들어갑니다. 4.5의 짧은 답에 맞춘 상한은 글이 나오기 전에 stop_reason: "max_tokens"로 멈출 수 있습니다. 추출 코드는 빈 블록을 JSON.parse에 넣습니다.

{
  "model": "claude-haiku-5-5",
  "max_tokens": 16000,
  "thinking": { "type": "adaptive" },
  "output_config": { "effort": "medium" },
  "messages": [{ "role": "user", "content": "..." }]
}

강제 tool_choice(any 또는 이름 있는 도구)는 Haiku 5.5에서 아직 받습니다. Opus 5.5와 Sonnet 5.5에서는 any와 tool이 400입니다. Haiku에서는 강제가 도구 호출로 응답을 시작하고 thinking 블록이 없습니다. 먼저 생각하게 하려면 auto를 쓰세요.

400이 되는 옛 JSON 네 가지

  1. 수동 사고 예산. enabled와 budget_tokens는 400입니다. adaptive로 바꾸고 깊이는 output_config.effort로 맞추세요.
  2. 샘플링. 기본이 아닌 temperature, 0.99가 아닌 top_p, 모든 top_k, 그리고 temperature와 top_p를 함께 보내는 요청은 400입니다. 세 필드를 지우세요.
  3. 어시스턴트 프리필. messages를 assistant로 끝내면 사고를 꺼도 400입니다. 형식은 Structured Output이나 enum 도구로 옮기세요.
  4. 옛 컴퓨터 사용 도구. Claude API와 Google Cloud에서 computer_20250124는 400입니다. computer_toolset_20260801로 바꾸고 옛 베타 헤더를 빼세요. toolset과 fine-grained-tool-streaming-2025-05-14를 같이 보내도 400입니다.

400은 아닌데 사고가 사라지는 길이 있습니다. Haiku 5.5 thinking 블록을 다른 계정으로 다시 보내면 API가 모델이 보기 전에 버리고, 요청은 성공합니다. 멀티테넌트는 그 블록을 만든 계정으로 재생해야 합니다. system, tools, 더 앞의 messages를 바꾼 뒤 thinking을 돌려보내면 400입니다. 대화는 덧붙이기만 하세요. 2026년 8월 31일 0시 UTC 이전에 만든 계정은 prefix_mismatch_behavior를 설정했을 때만 이 오류가 납니다.

stop_reason: "refusal"은 따로 처리하세요. 서버 쪽 폴백은 없습니다. Priority Tier는 이 모델에서 지원되지 않습니다. Claude Managed Agents는 가이드에 따르면 모델 이름 외에는 바꿀 것이 없습니다.

사고를 끄고 구조화 출력

disabled는 low, medium, high에서 됩니다. xhigh와 max는 400입니다. 프롬프트에 「바로 답하라」고 써도 공식 테스트에서는 사고가 멈추지 않았습니다. 덜 생각하는 레버는 더 낮은 effort입니다.

사고를 끄고 Structured Output으로 JSON을 요구하면 필요한 도구를 건너뛸 수 있습니다. 세 갈래입니다. 적응형으로 되돌리기, 도구가 필수인 요청에서 output_config.format을 빼기, 또는 tool_choice로 강제하기. 강제하면 호출 앞에 글이 없습니다.

Amazon Bedrock의 Claude는 Structured Output을 지원하지 않습니다. 분류와 추출은 enum 도구를 쓰세요. 최상위 effort를 턴 사이에 바꾸면 그 대화의 프롬프트 캐시가 무효가 됩니다. 메시지 단위 변경은 mid-conversation-output-config-2026-07-01과 적응형 사고가 필요합니다. 사고를 끄면 그 변경 자체가 400입니다.

같은 글이 더 많은 토큰이 됩니다

Haiku 5.5는 Claude 4.7 이후와 같은 새 토크나이저를 씁니다. 같은 입력은 Haiku 4.5보다 약 30% 더 많은 토큰으로 셉니다. 요청, 응답, 스트림의 모양은 그대로입니다. usage는 커지고 같은 max_tokens에 들어가는 글은 줄어듭니다. 셀 때는 model을 claude-haiku-5-5로 두고, 4.5 숫자는 재사용하지 마세요.

「평균 약 75% 더 싸다」와 「토큰이 약 30% 늘었다」는 같은 표입니다. 모델 문자열만 바꾸고 옛 max_tokens를 남기면 JSON이 끝나기 전에 잘립니다.

먼저 맞출 JSON 네 가지

  1. 요청 본문. budget_tokens가 없고, 기본이 아닌 샘플링이 없으며, messages가 assistant로 끝나지 않습니다. 사고는 빼거나 adaptive입니다.
  2. 실제 응답 하나. type이 text인 블록을 집은 다음 JSON.parse하세요. content[0]은 파싱하지 마세요.
  3. 돌려보내는 thinking 블록. signature가 남아 있고, 블록은 고쳐지지 않았으며, system과 tools도 그 턴 그대로입니다.
  4. 구조화 출력 schema. 이 턴에 도구가 필수이면 사고를 끄지 마세요. Bedrock에서는 output_config.format 대신 도구 enum입니다.

로컬 JSON 도구로 응답 보기

모델 문자열을 바꾸기 전에 브라우저에서 세 텍스트를 여세요. 옛 4.5 요청, 새 5.5 요청, thinking 블록이 있는 응답입니다.

  • JSON 검증기 — 요청과 응답이 올바른 JSON인지.
  • JSONPath — $..content[?(@.type=='text')]로 답을 꺼내고 thinking은 피합니다.
  • JSON Diff — 4.5와 5.5를 대조해 budget_tokens, temperature, 프리필이 사라졌는지 봅니다.

데이터는 브라우저를 떠나지 않습니다. 계약을 평평하게 본 다음 모델 ID를 바꾸세요. 빈 첫 thinking 블록을 추출 결과로 삼지 마세요.

자주 묻는 질문

model만 claude-haiku-5-5로 바꿔서 올릴 수 있나요?

기본값으로는 안 됩니다. budget_tokens, 기본이 아닌 temperature나 top_p, 임의의 top_k, assistant 프리필, Claude API 또는 Google Cloud의 computer_20250124는 400입니다. content 첫 블록을 읽는 파서는 thinking을 답으로 봅니다.

파싱한 첫 블록이 빈 이유는 무엇인가요?

기본 thinking 블록은 thinking 필드가 빈 문자열이고 signature만 있습니다. 요약은 display를 summarized로 둡니다. 답은 type이 text인 블록이지 인덱스 0이 아닙니다.

budget_tokens를 줄이면 더 싸지나요?

아닙니다. budget_tokens가 있는 enabled는 400입니다. 덜 생각하는 방법은 더 낮은 effort입니다. 단순한 요청은 low에서 thinking 블록이 없을 수 있습니다.

사고를 끄고 JSON을 요구해도 도구가 호출되나요?

확실하지 않습니다. 공식 프롬프트 안내는 사고를 끄고 Structured Output을 쓰면 필요한 도구를 건너뛸 수 있다고 적습니다. 적응형을 유지하거나 output_config.format을 빼거나 tool_choice로 강제하세요.

Bedrock에서 구조화 JSON은 어떻게 받나요?

가이드는 Amazon Bedrock의 Claude가 Structured Output을 지원하지 않는다고 적습니다. 분류와 추출은 enum 도구를 쓰세요.

9월 Sonnet 5.5의 between_tools와 같은 규칙인가요?

아닙니다. Sonnet 5.5는 thinking.disabled를 거부하고 between_tools를 원하며, 강제 tool_choice도 거부합니다. Haiku 5.5는 high 이하에서 disabled를 허용하고 강제 tool_choice도 받지만, 그때 응답에는 thinking 블록이 없습니다.

정리

Haiku 5.5가 가져가는 것은 「첫 블록이 JSON 답」이라는 가정입니다. 추출 자체는 가져가지 않습니다. 10월 7일의 claude-haiku-5-5는 기본으로 적응형 사고를 하고, budget_tokens를 거부하며, 같은 글을 약 30% 더 많은 토큰으로 셉니다. type으로 text를 읽고, thinking 블록은 그대로 돌려보내며, 도구가 필수인 턴에서 구조화 출력과 사고 끄기를 같이 두지 마세요.

모델 ID를 바꾸기 전에 옛 요청, 새 요청, 실제 응답을 로컬에서 평평하게 보세요. 가격표는 더 낮을 수 있습니다. 파서는 어느 덩어리가 JSON인지 여전히 구분해야 합니다.