Руководство по миграции на Claude Haiku 5.5
Перейдите на Claude Haiku 5.5 с более ранних моделей Haiku с помощью этого руководства по миграции. Рекомендации по переходу на Claude Haiku 5.5 включают новый идентификатор модели, настройки, которые возвращают ошибки, изменения в размышлениях и контрольный список для каждой исходной модели.
Claude Code
Позвольте Claude Code выполнить миграцию вашего кода за вас
/claude-api migrate этот проект на claude-haiku-5-5В этом руководстве описан перевод кода, вызывающего Claude Haiku 4.5, на Claude Haiku 5.5. Если ваш код вызывает Claude Haiku 3.5 или Claude Haiku 3, также внесите изменения из раздела Миграция на Claude Haiku 5.5 с Claude Haiku 3.5 и более ранних моделей Haiku. Чтобы вместо этого перейти на модель Sonnet или Opus, см. Руководства по миграции. О том, как долго Claude Haiku 4.5 останется доступной, см. Устаревание моделей.
Контрольный список миграции по исходной модели
Двигайтесь по группам сверху вниз и остановитесь после той, в которой указана ваша текущая модель. Если вы используете Claude Haiku 4.5, первая группа — это весь список. Каждый пункт — это одно изменение, которое нужно внести в ваш код.
Любая исходная модель
- Замените идентификатор модели на идентификатор Claude Haiku 5.5 для вашей платформы. См. раздел Использование идентификатора модели Claude Haiku 5.5.
- Пересчитайте токены в ваших подсказках и пересмотрите лимиты
max_tokensи оценки стоимости, поскольку тот же текст учитывается как большее количество токенов, а крупные изображения — как большее количество визуальных токенов. См. раздел Пересчёт токенов. - Если ваши запросы отправляют
thinking: {"type": "enabled", "budget_tokens": N}, изменитеthinkingна{"type": "adaptive"}. См. раздел Настройка размышлений. - Если ваш код считывает первый блок содержимого как ответ, вместо этого выбирайте блоки по
type. См. раздел Настройка размышлений. - Удалите
temperature,top_pиtop_kиз ваших запросов. См. раздел Удаление параметров сэмплирования. - Если ваши запросы завершают
messagesходом ассистента, чтобы модель его продолжила, вместо этого завершайте их ходом пользователя. См. раздел Замена предзаполнения ответа ассистента. - Если вы используете управление компьютером, замените
computer_20250124на набор инструментовcomputer_toolset_20260801. В Amazon Bedrock также работаетcomputer_20251124. См. раздел Переход на набор инструментов для управления компьютером. - Если вы воспроизводите сохранённые диалоги через другую учётную запись, воспроизводите каждый из них через ту учётную запись, которая его создала. См. раздел Воспроизведение блоков размышлений через создавшую их учётную запись.
- Если ваш код изменяет
system,toolsили более ранниеmessagesмежду запросами в рамках диалога и отправляет блоки размышлений обратно, сохраняйте диалог в режиме только добавления. См. раздел Сохранение предыдущих ходов без изменений. - Обрабатывайте
stop_reason: "refusal". Claude Haiku 5.5 использует классификаторы безопасности, которые могут отклонить запрос, и у него нет резервного механизма на стороне сервера. См. раздел Отказы средств защиты.
Если у вашей организации есть обязательство Priority Tier для Claude Haiku 4.5, планируйте мощности отдельно: Priority Tier не поддерживается для Claude Haiku 5.5.
Claude Haiku 3.5 или более ранние
- Замените идентификатор модели Claude Haiku 3.5 или Claude Haiku 3 на идентификатор Claude Haiku 5.5 для вашей платформы. См. Миграция на Claude Haiku 5.5 с Claude Haiku 3.5 и более ранних моделей Haiku.
- Если вы используете инструмент
code_execution_20250522, перейдите наcode_execution_20250825или более позднюю версию. - Если вы используете инструмент текстового редактора, перейдите на
text_editor_20250728. - Обрабатывайте причины остановки
refusalиmodel_context_window_exceeded. - Если ваш код выполняет точное сравнение строковых параметров вызовов инструментов, учитывайте завершающие символы новой строки.
- Пересмотрите свои подсказки.
Использование идентификатора модели Claude Haiku 5.5
Замените идентификатор модели Claude Haiku 4.5 на идентификатор Claude Haiku 5.5 для вашей платформы.
| Платформа | Claude Haiku 4.5 | Claude Haiku 5.5 |
|---|---|---|
| Claude API | claude-haiku-4-5-20251001 или claude-haiku-4-5 | claude-haiku-5-5 |
| Amazon Bedrock | anthropic.claude-haiku-4-5 | anthropic.claude-haiku-5-5 |
| Claude Platform on AWS | claude-haiku-4-5 | claude-haiku-5-5 |
| Claude Models on Google Cloud (Anthropic managed) | claude-haiku-4-5-20251001 | claude-haiku-5-5 |
| Claude Models on Google Cloud (Google managed) | claude-haiku-4-5@20251001 | claude-haiku-5-5 |
| Microsoft Foundry | claude-haiku-4-5 | claude-haiku-5-5 |
claude-haiku-5-5 — это фиксированный идентификатор модели без суффикса даты и без отдельного псевдонима.
Пересчёт токенов
Claude Haiku 5.5 использует тот же «tokenizer» (токенизатор), что и Claude 4.7 и более поздние модели. Как и у всех моделей с этим токенизатором, один и тот же входной текст даёт в Claude Haiku 5.5 примерно на 30 процентов больше токенов, чем в Claude Haiku 4.5. Точный прирост зависит от содержимого. Запросы, ответы и события «streaming» (потоковой передачи) сохраняют ту же структуру. Меняется всё, что вы измеряете или планируете в токенах:
- Поля
usageи результаты подсчёта токенов для того же текста выше. - Заданное количество токенов вмещает меньше текста.
- Ограничение
max_tokens, подобранное для Claude Haiku 4.5, может обрезать эквивалентный вывод. - Оценки стоимости, сделанные по количеству токенов Claude Haiku 4.5, необходимо пересчитать с использованием количества токенов и цен Claude Haiku 5.5, включая её более высокие цены для длинных подсказок. См. Цены и Цены на длинный контекст.
Большие изображения также могут стоить больше токенов. Claude Haiku 5.5 использует уровень изображений высокого разрешения, при котором уменьшаются изображения размером более 2 576 пикселей по длинной стороне или более 4 784 визуальных токенов. Claude Haiku 4.5 и более ранние модели Haiku используют стандартный уровень, при котором уменьшаются изображения размером более 1 568 пикселей по длинной стороне или более 1 568 визуальных токенов. Изображение размером 2 000 на 1 500 пикселей стоит в Claude Haiku 5.5 примерно в 2,5 раза больше визуальных токенов, чем в Claude Haiku 4.5. См. Разрешение и стоимость в токенах.
Подсчитывайте токены подсказок с model, установленным в claude-haiku-5-5, а не используйте повторно значения, измеренные на Claude Haiku 4.5.
Настройка размышлений
Claude Haiku 5.5 настраивает размышления иначе, чем Claude Haiku 4.5. Значение thinking, равное {"type": "enabled", "budget_tokens": N}, возвращает ошибку 400, поэтому запросу, который его отправляет, требуется новое значение thinking.
Раньше запрос к Claude Haiku 4.5 устанавливал thinking в enabled с бюджетом токенов:
{
"model": "claude-haiku-4-5",
"max_tokens": 16000,
"thinking": { "type": "enabled", "budget_tokens": 8000 },
"messages": [{ "role": "user", "content": "..." }]
}Теперь тот же запрос к Claude Haiku 5.5 использует «adaptive thinking» (адаптивные размышления). Значение thinking меняется, а output_config.effort задаёт, насколько много модель размышляет:
{
"model": "claude-haiku-5-5",
"max_tokens": 16000,
"thinking": { "type": "adaptive" },
"output_config": { "effort": "medium" },
"messages": [{ "role": "user", "content": "..." }]
}Адаптивные размышления включены по умолчанию, поэтому ответ может начинаться с одного или нескольких блоков thinking, даже если запрос не задаёт thinking. Оставьте thinking незаданным или установите его в {"type": "adaptive"} и используйте effort (уровень усилий) как механизм управления: там, где Claude Haiku 4.5 работала без размышлений или с небольшим бюджетом для экономии токенов, выберите более низкий уровень усилий. На более низком уровне модель размышляет меньше и может полностью пропускать размышления для простых запросов. Рекомендации по подсказкам см. в разделе Используйте уровень усилий для управления размышлениями. Выбирайте блоки содержимого по их полю type, а не по позиции, и передавайте блоки thinking обратно без изменений вместе с результатами инструментов.
Токены размышлений учитываются в max_tokens, поэтому запрос с небольшим max_tokens может остановиться с stop_reason: "max_tokens" после блока thinking и до какого-либо текста. Если вы задавали небольшое значение max_tokens для Claude Haiku 4.5, увеличьте его, чтобы оставить место для размышлений, или выберите более низкий уровень усилий.
Блоки размышлений из более ранних ходов ассистента остаются в контексте и учитываются как входные токены, тогда как Claude Haiku 4.5 сохраняет только блоки последнего хода. Поэтому многоходовые диалоги содержат больше входных токенов, чем объясняется одним лишь изменением токенизатора. Чтобы удалить более старые блоки, используйте очистку блоков размышлений. См. Сохранение блоков размышлений в зависимости от модели.
По умолчанию Claude Haiku 5.5 возвращает каждый блок thinking с пустым полем thinking и только с signature, тогда как Claude Haiku 4.5 возвращает сводку размышлений. Чтобы получать сводку размышлений, установите thinking: {"type": "adaptive", "display": "summarized"}.
Claude Haiku 5.5 принимает принудительный tool_choice (any или именованный инструмент), но ответ начинается с вызова инструмента и не содержит блока thinking. Чтобы позволить модели поразмышлять перед вызовом инструмента, используйте tool_choice: {"type": "auto"} и укажите в подсказке, когда следует использовать инструмент.
Claude Haiku 5.5 читает блоки размышлений от Claude Sonnet 5, Claude Opus 4.8, Claude Haiku 4.5 и более ранних моделей, поэтому диалог, который вы переводите с Claude Haiku 4.5 на Claude Haiku 5.5, сохраняет свои рассуждения. Она не читает блоки от Claude Opus 5, Claude Opus 5.5, Claude Sonnet 5.5 или любой модели Claude Fable или Claude Mythos; API отбрасывает их без ошибки. В Claude API и Claude Models on Google Cloud (Google managed) Claude Opus 5.5 и Claude Sonnet 5.5 читают блоки Claude Haiku 5.5. См. Переключение моделей посреди диалога.
Удаление параметров сэмплирования
В Claude Haiku 5.5 не указывайте temperature, top_p и top_k и вместо этого управляйте поведением модели с помощью подсказок.
Замена предзаполнения ответа ассистента
«Prefill» (предзаполнение) — это завершающий ход ассистента в messages, который модель продолжает. Claude Haiku 4.5 принимает его, когда размышления выключены. Claude Haiku 5.5 отклоняет его с ошибкой 400, даже если размышления выключены. Завершайте messages ходом пользователя и заменяйте каждое предзаполнение в зависимости от его назначения:
- Формат вывода: используйте структурированные выводы или инструменты с полями enum для классификации.
- Вступления: попросите в системной подсказке давать прямой ответ.
- Продолжения: перенесите их в сообщение пользователя, например: «Ваш предыдущий ответ был прерван и закончился на
[previous_response]. Продолжите с того места, где остановились». - Напоминания о контексте: поместите их в ход пользователя.
Перевод использования компьютера на набор инструментов
Claude Haiku 4.5 поддерживает управление компьютером через инструмент computer_20250124 с бета-заголовком computer-use-2025-01-24. Claude Haiku 5.5 поддерживает управление компьютером через набор инструментов computer_toolset_20260801. Запрос к Claude Haiku 5.5, в котором объявлен computer_20250124, возвращает ошибку 400.
Чтобы перевести интеграцию на набор инструментов, уберите бета-заголовок computer-use-2025-01-24 и замените запись в tools на {"type": "computer_toolset_20260801"}. Затем внесите остальные изменения в запросы и цикл агента, описанные в разделе Миграция с computer_20251124. Выполняйте диспетчеризацию по name и toolset_name каждого блока tool_use участника набора, а не по input.action. Обрабатывайте каждый такой блок в ходе и возвращайте toolset_name в результатах. Масштабирование в наборе инструментов включено по умолчанию; если ваша среда его не реализует, добавьте "configs": {"zoom": {"enabled": false}}. Если вы отправляете бета-заголовок fine-grained-tool-streaming-2025-05-14, удалите его. Вместе с записью набора инструментов он приводит к ошибке 400.
В Amazon Bedrock Claude Haiku 5.5 также принимает инструмент computer_20251124 с бета-заголовком computer-use-2025-11-24.
Claude Haiku 5.5 поддерживает инструмент управления браузером (browser_toolset_20260801) для задач внутри веб-страниц. Claude Haiku 4.5 его не поддерживает.
Воспроизведение блоков размышлений через учётную запись, которая их создала
Блоки размышлений («thinking blocks») от Claude Haiku 5.5 работают только в аккаунте, который их создал, или в связанном с ним аккаунте. Когда другой аккаунт отправляет один из таких блоков, API отбрасывает блок до того, как его получит модель, и запрос выполняется успешно без этих рассуждений. Это затрагивает код, который хранит беседы и воспроизводит их через другой аккаунт, например сервис, обслуживающий нескольких клиентов из одного хранилища бесед. Воспроизводите каждую беседу через аккаунт, который её создал. См. Блоки размышлений остаются в аккаунте, который их создал.
Сохранение более ранних ходов без изменений
Блок размышлений Claude Haiku 5.5 остаётся действительным только до тех пор, пока всё, что было отправлено перед ним, остаётся неизменным: системная подсказка (system), инструменты (tools) и каждое предыдущее сообщение. Claude Haiku 4.5 не выполняет проверку префикса. Ведите беседы только в режиме добавления. Запрос, который отправляет блок обратно после такого изменения и оставляет thinking.block_binding.prefix_mismatch_behavior незаданным, получает ошибку 400 в аккаунтах, созданных 31 августа 2026 года, 00:00 UTC, или позже. В аккаунтах, созданных до этой даты, запрос получает ошибку только в том случае, если в нём для этого поля задано значение "error". Об изменениях, которые вызывают ошибку, и о том, что делать вместо этого, см. Кого затрагивает проверка префикса.
Миграция на Claude Haiku 5.5 с Claude Haiku 3.5 и более ранних моделей Haiku
Claude Haiku 3.5 выведена из эксплуатации в Claude API, Amazon Bedrock и Claude Models on Google Cloud (Google managed). Claude Haiku 3 выведена из эксплуатации в Claude API и Claude Models on Google Cloud (Google managed). См. Устаревание моделей.
При переходе с любой из этих моделей сначала примените все предыдущие разделы, а затем следующие изменения:
- Идентификатор модели: замените
claude-3-5-haiku-20241022, его псевдонимclaude-3-5-haiku-latestилиclaude-3-haiku-20240307наclaude-haiku-5-5. В Claude Models on Google Cloud (Google managed) заменитеclaude-3-5-haiku@20241022наclaude-haiku-5-5. В Amazon Bedrock используйте идентификатор Claude Haiku 5.5 из раздела Использование идентификатора модели Claude Haiku 5.5. - Выполнение кода: Claude Haiku 5.5 принимает
code_execution_20250825и более поздние версии. Если вы используете инструментcode_execution_20250522, поддерживающий только Python, перейдите на одну из них. См. Обновление до последней версии инструмента. - Текстовый редактор: если вы используете инструмент текстового редактора, перейдите на
text_editor_20250728(имя инструментаstr_replace_based_edit_tool), в котором нет командыundo_edit. См. Инструмент текстового редактора. - Причины остановки: обрабатывайте
refusalиmodel_context_window_exceeded. См. Причины остановки и резервные модели. - Завершающие символы новой строки: Claude 4.5 и более поздние модели сохраняют завершающие символы новой строки в строковых параметрах вызовов инструментов. Если ваш код выполняет точное сравнение этих строк, учитывайте их.
- Подсказки: Claude 4 и более поздние модели имеют более лаконичный, прямой стиль общения и нуждаются в явных указаниях. Пересмотрите свои подсказки с учётом руководств Составление подсказок для Claude Haiku 5.5 и Лучшие практики составления подсказок.
Эта страница была полезной?