Смена claude-haiku-4-5 на claude-haiku-5-5 — самая простая часть этой миграции. Пять шаблонов запросов, которые работали на Haiku 4.5, теперь возвращают ошибку 400. Ещё несколько изменений не приводят к ошибкам, но меняют полученный ответ, его стоимость или поведение модели внутри агента.
Anthropic заявляет, что существующие промпты для Haiku 4.5 должны хорошо работать на Haiku 5.5 без изменений. С кодом запросов вокруг этих промптов всё сложнее. В этой статье каждая проблема описана так, как вы её встретите: что увидите, почему это происходит и как исправить, а в конце приведён чек-лист. Основной источник — руководство по миграции на Haiku 5.5 от Anthropic.
Диагностика: сопоставьте симптом
| Что вы видите | Причина | Исправление |
|---|---|---|
| 400 на запрос с бюджетом thinking | Ручной thinking удалён | Adaptive thinking плюс effort |
| 400 с temperature, top_p или top_k | Параметры сэмплирования зафиксированы | Удалите их |
| 400, когда сообщения заканчиваются ходом ассистента | Prefill удалён | Завершайте ходом пользователя |
| 400 при использовании computer use | Старый инструмент computer отклоняется | Перейдите на набор инструментов computer |
| 400 после редактирования предыдущих ходов | Thinking привязан к истории | Историю ведите только дописыванием |
| Парсер возвращает пустой или неверный текст | Блок thinking идёт первым | Выбирайте блоки по типу |
| Ответ обрезан или отсутствует | Thinking учитывается в лимите | Увеличьте max_tokens или снизьте effort |
| Счётчик токенов и счёт выросли примерно на 30% | Новый токенизатор | Пересчитайте на новой модели |
| Ответ с stop reason refusal | Новые классификаторы безопасности | Обрабатывайте это в своём клиенте |
Первые пять проблем проявляются явно. Остальные проходят незаметно, и их сложнее найти.
Пять явных сбоев
1. Ручные бюджеты thinking
Что вы увидите: ошибку 400 на любой запрос, в котором передаётся thinking: {"type": "enabled", "budget_tokens": N}.
Почему: Haiku 4.5 поддерживал расширенное мышление только с ручным бюджетом токенов. Haiku 5.5 поддерживает только adaptive thinking и управляет глубиной через effort.
Исправление: передайте {"type": "adaptive"} или не указывайте thinking, а затем выберите уровень effort. Если старый бюджет был маленьким, чтобы экономить токены, выбирайте низкий уровень.
# Before: Haiku 4.5
thinking={"type": "enabled", "budget_tokens": 8000}
# After: Haiku 5.5
thinking={"type": "adaptive"},
output_config={"effort": "medium"},
2. Параметры сэмплирования
Что вы увидите: ошибку 400, если запрос задаёт temperature, top_p или top_k.
Почему: Haiku 5.5 принимает только значения по умолчанию: temperature равную 1 и top_p равную 0.99. Любое другое значение любого из них, любой top_k или одновременная передача temperature и top_p возвращают 400, независимо от того, используется ли thinking. Даже top_p, равный 1, отклоняется.
Исправление: удалите все три параметра. Типичный случай — temperature=0 у классификатора, который использовался для стабильных меток. Замените его структурированным выводом или инструментом, у которого входные данные задаются перечислением (enum), чтобы набор меток обеспечивала схема, а не сэмплирование. Также проверьте SDK-обёртки и шлюзы, которые добавляют значения сэмплирования по умолчанию от вашего имени.
3. Prefill ответа ассистента
Что вы увидите: ошибку 400, если последний элемент в messages является ходом ассистента, даже при выключенном thinking.
Почему: prefill не поддерживается в Haiku 5.5, как и в остальной актуальной линейке Claude.
Исправление: завершайте messages ходом пользователя и замените prefill тем, для чего он использовался. Управление форматом переходит к структурированному выводу (output_config.format). Заранее заданное вступление превращается в инструкцию в системном промпте отвечать сразу по существу. Продолжение прерванного ответа переносится в сообщение пользователя: «Твой предыдущий ответ заканчивался фразой [текст]. Продолжи с этого места».
4. Computer use
Что вы увидите: ошибку 400 в Claude API или Google Cloud, если запрос объявляет инструмент computer_20250124.
Почему: на этих платформах Haiku 5.5 поддерживает computer use только через новый набор инструментов computer_toolset_20260801.
Исправление: уберите заголовок беты computer-use-2025-01-24, замените запись инструмента на {"type": "computer_toolset_20260801"} и обновите цикл агента: диспетчеризируйте по полю name каждого блока tool_use и toolset_name, а не по input.action, обрабатывайте каждый такой блок в ходе и возвращайте toolset_name в результатах. Масштабирование (zoom) включено по умолчанию; если ваша среда его не реализует, отключите его в конфигурации набора инструментов. На Amazon Bedrock перед выбором версии проверьте примечания о совместимости инструмента computer use. Этот же семейство инструментов добавляет и использование браузера, которого не было у Haiku 4.5.
5. Редактирование предыдущих ходов
Что вы увидите: ошибку 400, если запрос возвращает блок thinking после того, как что-то перед ним изменилось: системный промпт, список инструментов или более ранее сообщение.
Почему: блок thinking от Haiku 5.5 остаётся действительным, только пока всё, что отправлено до него, не изменилось. Проверка включена по умолчанию для аккаунтов, созданных 31 августа 2026 года или позже, а для более старых аккаунтов — только если запрос включает её явно.
Исправление: ведите диалоги только дописыванием. Типичные виновники: системный промпт с меткой времени, список инструментов, который растёт при подключении плагина, усечение истории на стороне клиента и напоминания, которые добавляются в историю и удаляются при следующем ходе. Для инструкций, действующих на один ход, Haiku 5.5 поддерживает системные сообщения внутри messages без заголовка беты: они добавляют контекст, не редактируя предыдущие сообщения.
Незаметные сбои
Блоки thinking идут первыми. Thinking включён по умолчанию, поэтому ответ может начинаться с одного или нескольких блоков thinking. Код, который читает response.content[0].text как ответ, ломается или возвращает пустой текст. Выбирайте блоки по type.
Текст thinking по умолчанию пуст. Haiku 4.5 возвращал сводку рассуждений. Haiku 5.5 возвращает блоки thinking с пустым полем text и только подписью. Если ваш интерфейс показывал сводки рассуждений, задайте thinking: {"type": "adaptive", "display": "summarized"}. В любом случае передавайте блоки thinking обратно без изменений вместе с результатами инструментов: сериализатор, который удаляет пустые блоки, сотрёт их.
Теперь max_tokens должен покрывать и thinking. Лимит, рассчитанный на короткий ответ, может быть исчерпан thinking, и ответ завершится с stop_reason: "max_tokens" до появления текста. Увеличьте лимит или снизьте effort.
Тот же текст — примерно на 30% больше токенов. Новый токенизатор меняет поля usage, результаты count_tokens, бюджеты контекста и любые значения max_tokens, подобранные для Haiku 4.5. Он также сдвигает границу ценообразования 100K токенов примерно до 77K токенов по подсчёту Haiku 4.5. Пересчитайте реальные промпты, указав модель claude-haiku-5-5, прежде чем доверять панели расходов.
Effort по умолчанию — medium. У Haiku 4.5 не было настройки effort. Haiku 5.5 по умолчанию использует medium, что может быть больше рассуждений, чем нужно простому маршруту. Задайте значение явно.
Блоки thinking привязаны к аккаунту, который их создал. Если ваш сервис воспроизводит сохранённые диалоги через другой аккаунт API, блоки thinking Haiku 5.5 молча отбрасываются, и запрос выполняется без этих рассуждений. Воспроизводите каждый диалог через аккаунт, который его создал.
Priority Tier не переносится. Haiku 5.5 не поддерживает Priority Tier, поэтому планируйте мощности отдельно, если вы полагались на него для Haiku 4.5.
Изменения поведения, важные для агентов с реальными правами
Отказы теперь бывают, и ничто не перехватит их за вас. Haiku 5.5 использует классификаторы безопасности в четырёх категориях: кибербезопасность, биология, разработка фронтирных LLM и общие риски. Отказ возвращается как обычный HTTP 200 с stop_reason: "refusal" и категорией в stop_details. У Haiku 5.5 нет серверного резервного варианта: список резервных моделей возвращает 400, а режим резервирования по умолчанию оставляет запрос отклонённым. Проверяйте stop_reason перед чтением content и решайте в своём коде, переформулировать ли запрос, передать ли его более крупной модели или остановиться. Согласно анонсу, защита в области кибербезопасности допускает более широкий круг оборонительных задач, чем у Sonnet 5.5, но блокирует тестирование на проникновение.
Пользовательский текст внутри результатов инструментов может игнорироваться. Haiku 5.5 обучен сопротивляться prompt injection через результаты инструментов. Если ваш харнес передаёт сообщение, которое пользователь набрал в ходе задачи, внутри блока tool_result, модель может счесть его недоверенным и проигнорировать. Размещайте ввод пользователя в середине хода в текстовом блоке после последнего результата инструмента, а служебные уведомления харнеса — в отдельном системном сообщении.
При низком effort агенты могут остановиться раньше или пропустить проверки. При длинном системном промпте кодингового агента на low Haiku 5.5 иногда возвращает задачу до её завершения, а на low и medium иногда сообщает об изменении кода как о готовом, не запустив тест. В руководстве по промптам для Haiku 5.5 от Anthropic есть короткие инструкции для обоих случаев. Для агента, который может записывать файлы или выполнять команды, непроверенное «готово» опаснее из двух.
Принудительный выбор инструмента отключает thinking. Принудительный tool_choice по-прежнему принимается, но модель вызывает инструмент, не рассуждая заранее. Для инструментов с побочными эффектами auto плюс понятная инструкция позволяет модели рассуждать перед действием.
Инструментам поиска нужна сегодняшняя дата. Если у Haiku 5.5 есть инструмент поиска, укажите текущую дату в системном промпте или в описании инструмента. В тестах Anthropic это помогало опираться на свежие результаты.
Миграция запроса через AIHubMix
Классификатор на Haiku 4.5, который использовал temperature=0 и prefill { для JSON, переписан под Haiku 5.5 через нативный эндпоинт Claude от AIHubMix:
import os
import anthropic
client = anthropic.Anthropic(
api_key=os.environ["AIHUBMIX_API_KEY"],
base_url="https://aihubmix.com",
)
r = client.messages.create(
model="claude-haiku-5-5",
max_tokens=2000, # room for thinking plus the JSON
output_config={
"effort": "low", # thinking is on by default; keep it light
"format": { # replaces the prefill and temperature=0
"type": "json_schema",
"schema": {
"type": "object",
"properties": {
"label": {"type": "string", "enum": ["billing", "bug", "other"]}
},
"required": ["label"],
"additionalProperties": False,
},
},
},
messages=[{"role": "user", "content": "Ticket: 'I was charged twice for October.'"}],
)
if r.stop_reason == "refusal":
raise RuntimeError(f"declined: {r.stop_details}")
text = next(b.text for b in r.content if b.type == "text")
print(text)
Стоит проверить при первом тестовом запуске, передаёт ли шлюз поля output_config и новые заголовки бета-версий без изменений. Когда мигрированный маршрут пройдёт ваши оценки, список моделей AIHubMix позволяет легко направить тот же код на Sonnet 5.5 для тех типов задач, которые продолжают не работать на Haiku.
Чек-лист миграции
- Измените ID модели на claude-haiku-5-5 без суффикса даты.
- Замените каждый бюджет thinking на adaptive thinking и явно заданный уровень effort.
- Удалите temperature, top_p и top_k, включая значения по умолчанию, которые добавляют обёртки.
- Замените предзаполнение ответа ассистента (prefill) на структурированный вывод, системные инструкции или продолжение в пользовательском сообщении.
- Перенесите computer use на набор инструментов для компьютера и обновите цикл агента.
- Если блоки thinking воспроизводятся, делайте историю диалога только дополняемой (append-only).
- Читайте содержимое ответа по типу блока и сохраняйте пустые блоки thinking при воспроизведении.
- Увеличьте max_tokens на маршрутах с короткими ответами или снизьте effort.
- Обрабатывайте стоп-причину refusal до чтения содержимого; не настраивайте серверные фолбэки.
- Пересчитайте токены промптов на новой модели и заново установите базовые значения на дашбордах стоимости.
- Проверьте, какие промпты теперь превышают 100K токенов, и сократите их или разбейте на части.
- Установите display в summarized, если пользователи видели сводки рассуждений.
- Передавайте пользовательский ввод в ходе диалога вне результатов инструментов.
- Передавайте агентам с поиском сегодняшнюю дату.
- Перед переносом объёма заново проверьте лимиты запросов и необходимость Priority Tier.
Часто задаваемые вопросы
Будут ли мои промпты для Haiku 4.5 работать на Haiku 5.5?
Anthropic заявляет, что существующие промпты должны работать хорошо и без изменений. Ломаются параметры запроса вокруг них: бюджеты thinking, настройки сэмплирования, prefill и старый инструмент computer use. Все они возвращают ошибки.
Почему мой классификатор теперь падает, после того как я убрал temperature 0?
Он не должен падать, но метки могут варьироваться сильнее. Используйте структурированный вывод или инструмент с полем enum, чтобы допустимые метки задавались схемой. Это надёжнее, чем temperature 0 когда-либо была.
Можно ли по-прежнему отключить thinking?
Да, на уровнях effort low, medium и high. На xhigh и max отключение thinking возвращает ошибку. Anthropic рекомендует вместо этого более низкий уровень effort, так как на простых запросах модель может сама пропускать thinking.
Что должен делать мой код, когда Haiku 5.5 отказывает?
Проверяйте стоп-причину до чтения содержимого. У Haiku 5.5 нет серверного фолбэка, поэтому ваш код решает, переформулировать ли запрос, отправить его более крупной модели или вернуть пользователю ошибку.
Почему после миграции выросло использование токенов?
Две причины. Новый токенизатор считает примерно на 30% больше токенов для того же текста, а thinking включён по умолчанию и добавляет выходные токены. Снизьте effort и пересчитайте промпты на новой модели.
Нужно ли что-то менять для кэширования промптов?
Обычно нет, и стало проще: согласно руководству Anthropic по миграции, минимальный кэшируемый промпт уменьшился с 4 096 до 512 токенов, а блоки thinking из предыдущих ходов по умолчанию остаются в кэшированном префиксе. Не редактируйте более ранние ходы: теперь это инвалидирует и блоки thinking, и кэш.
Можно ли перенести диалог с Haiku 5.5 на более крупную модель?
Да, сам диалог переносится. Переходят ли ранние блоки thinking из Haiku 5.5 тоже, зависит от целевой модели, поэтому перед тем, как на это рассчитывать, проверьте документацию Anthropic по сохранённому thinking (preserved thinking).
Читайте дальше: серия Claude Haiku 5.5
- Прежде чем планировать миграцию, полезно понять, проходит ли новая модель вашу планку качества. Бенчмарки против Haiku 4.5, GPT-6 Luna и Sonnet 5.5 — в статье Claude Haiku 5.5 vs Haiku 4.5: что теперь дают десять центов
- Шаг 2 чек-листа предлагает выбрать уровень effort. О том, сколько каждый уровень стоит в токенах и с чего начать, читайте в статье Уровни effort в Claude Haiku 5.5: Medium по умолчанию, Low часто достаточно
- Смена токенизатора двигает не только дашборды, но и линию цены. Чтобы увидеть, что это делает с реальным счётом, читайте Цены Claude Haiku 5.5: граница в 100K за скидкой 90%
Источники
- Руководство по миграции на Claude Haiku 5.5 (Claude Platform Docs)
- Промптинг Claude Haiku 5.5 (Claude Platform Docs)
- Представляем Claude Haiku 5.5 (Anthropic)
- Claude Haiku 5.5 на AIHubMix
- Claude Haiku 5.5 вышел по цене $0,10 за миллион токенов. Прочтите правило 100K перед миграцией (Roo's Newsletter)



