---
title: Руководство по миграции на Claude Haiku 5.5
url: https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide
description: Перейдите на Claude Haiku 5.5 с более ранних моделей Haiku с помощью этого руководства по миграции. Рекомендации по переходу на Claude Haiku 5.5 включают новый идентификатор модели, настройки, которые возвращают ошибки, изменения в размышлениях и контрольный список для каждой исходной модели.
---

<Note>
  В этом руководстве рассматривается миграция кода [Messages API](https://platform.claude.com/docs/ru/build-with-claude/working-with-messages). Если вы используете [Claude Managed Agents](https://platform.claude.com/docs/ru/managed-agents/overview), никаких изменений, кроме обновления названия модели, не требуется.
</Note>

Позвольте Claude Code выполнить миграцию вашего кода за вас

```text
/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](https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide#migrating-from-haiku-35). Чтобы вместо этого перейти на модель Sonnet или Opus, см. [Руководства по миграции](https://platform.claude.com/docs/ru/about-claude/models/migration-guide). О том, как долго Claude Haiku 4.5 останется доступной, см. [Устаревание моделей](https://platform.claude.com/docs/ru/about-claude/model-deprecations).

## Контрольный список миграции по исходной модели

Двигайтесь по группам сверху вниз и остановитесь после той, в которой указана ваша текущая модель. Если вы используете Claude Haiku 4.5, первая группа — это весь список. Каждый пункт — это одно изменение, которое нужно внести в ваш код.

### Любая исходная модель

1. Замените идентификатор модели на идентификатор Claude Haiku 5.5 для вашей платформы. См. раздел [Использование идентификатора модели Claude Haiku 5.5](https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide#use-the-claude-haiku-5-5-model-id).
2. Пересчитайте токены в ваших подсказках и пересмотрите лимиты `max_tokens` и оценки стоимости, поскольку тот же текст учитывается как большее количество токенов, а крупные изображения — как большее количество визуальных токенов. См. раздел [Пересчёт токенов](https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide#recount-tokens).
3. Если ваши запросы отправляют `thinking: {"type": "enabled", "budget_tokens": N}`, измените `thinking` на `{"type": "adaptive"}`. См. раздел [Настройка размышлений](https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide#configure-thinking).
4. Если ваш код считывает первый блок содержимого как ответ, вместо этого выбирайте блоки по `type`. См. раздел [Настройка размышлений](https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide#configure-thinking).
5. Удалите `temperature`, `top_p` и `top_k` из ваших запросов. См. раздел [Удаление параметров сэмплирования](https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide#remove-sampling-parameters).
6. Если ваши запросы завершают `messages` ходом ассистента, чтобы модель его продолжила, вместо этого завершайте их ходом пользователя. См. раздел [Замена предзаполнения ответа ассистента](https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide#replace-assistant-prefill).
7. Если вы используете управление компьютером, замените `computer_20250124` на набор инструментов `computer_toolset_20260801`. В Amazon Bedrock также работает `computer_20251124`. См. раздел [Перевод использования компьютера на набор инструментов](https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide#computer-use-toolset).
8. Если вы воспроизводите сохранённые разговоры через другой аккаунт, воспроизводите каждый из них через тот аккаунт, который его создал. См. раздел [Воспроизведение блоков размышлений через аккаунт, который их создал](https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide#replay-thinking-blocks-through-the-producing-account).
9. Если ваш код изменяет `system`, `tools` или более ранние `messages` между запросами в рамках разговора и отправляет блоки размышлений обратно, ведите разговор в режиме только добавления. См. раздел [Сохранение более ранних ходов без изменений](https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide#keep-earlier-turns-unchanged).
10. Обрабатывайте `stop_reason: "refusal"`. Claude Haiku 5.5 использует классификаторы безопасности, которые могут отклонить запрос, и у него нет резервного механизма на стороне сервера. См. раздел [Отказы средств защиты](https://platform.claude.com/docs/ru/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#safeguard-refusals).
11. Если ваши подсказки просят модель записывать свои рассуждения в ответе, например в тегах `<thinking>` или `<reasoning>`, удалите эти инструкции. Claude Haiku 5.5 может отклонить запрос, который их содержит, и вернуть категорию `reasoning_extraction`. См. раздел [Защитные отказы](https://platform.claude.com/docs/ru/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#safeguard-refusals).

Если у вашей организации есть обязательство [Priority Tier](https://platform.claude.com/docs/ru/api/service-tiers#supported-models) для Claude Haiku 4.5, планируйте мощности отдельно: Priority Tier не поддерживается для Claude Haiku 5.5.

### Claude Haiku 3.5 или более ранние

1. Замените идентификатор модели Claude Haiku 3.5 или Claude Haiku 3 на идентификатор Claude Haiku 5.5 для вашей платформы. См. [Миграция на Claude Haiku 5.5 с Claude Haiku 3.5 и более ранних моделей Haiku](https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide#migrating-from-haiku-35).
2. Если вы используете инструмент `code_execution_20250522`, перейдите на `code_execution_20250825` или более позднюю версию.
3. Если вы используете инструмент текстового редактора, перейдите на `text_editor_20250728`.
4. Обрабатывайте причины остановки `refusal` и `model_context_window_exceeded`.
5. Если ваш код выполняет точное сравнение строковых параметров вызовов инструментов, учитывайте завершающие символы новой строки.
6. Пересмотрите свои подсказки.

## Использование идентификатора модели 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` и результаты [подсчёта токенов](https://platform.claude.com/docs/ru/build-with-claude/token-counting) для того же текста выше.
* Заданное количество токенов вмещает меньше текста.
* Ограничение `max_tokens`, подобранное для Claude Haiku 4.5, может обрезать эквивалентный вывод.
* Оценки стоимости, сделанные по количеству токенов Claude Haiku 4.5, необходимо пересчитать с использованием количества токенов и цен Claude Haiku 5.5, включая её более высокие цены для длинных подсказок. См. [Цены](https://platform.claude.com/docs/ru/about-claude/pricing) и [Цены на длинный контекст](https://platform.claude.com/docs/ru/about-claude/pricing#long-context-pricing).

Большие изображения также могут стоить больше токенов. 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. См. [Разрешение и стоимость в токенах](https://platform.claude.com/docs/ru/build-with-claude/vision#evaluate-image-size).

Подсчитывайте токены подсказок с `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` с бюджетом токенов:

```json
{
  "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` задаёт, насколько много модель размышляет:

```json
{
  "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](https://platform.claude.com/docs/ru/build-with-claude/effort) (уровень усилий) как механизм управления: там, где Claude Haiku 4.5 работала без размышлений или с небольшим бюджетом для экономии токенов, выберите более низкий уровень усилий. На более низком уровне модель размышляет меньше и может полностью пропускать размышления для простых запросов. Рекомендации по подсказкам см. в разделе [Используйте уровень усилий для управления размышлениями](https://platform.claude.com/docs/ru/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#use-effort-to-control-thinking). Выбирайте блоки содержимого по их полю `type`, а не по позиции, и передавайте блоки `thinking` обратно без изменений вместе с результатами инструментов.

Токены размышлений учитываются в `max_tokens`, поэтому запрос с небольшим `max_tokens` может остановиться с `stop_reason: "max_tokens"` после блока `thinking` и до какого-либо текста. Если вы задавали небольшое значение `max_tokens` для Claude Haiku 4.5, увеличьте его, чтобы оставить место для размышлений, или выберите более низкий [уровень усилий](https://platform.claude.com/docs/ru/build-with-claude/effort).

Блоки размышлений из более ранних ходов ассистента остаются в контексте и учитываются как входные токены, тогда как Claude Haiku 4.5 сохраняет только блоки последнего хода. Поэтому многоходовые разговоры содержат больше входных токенов, чем объясняется одним лишь изменением токенизатора. Чтобы удалить более старые блоки, используйте [очистку блоков размышлений](https://platform.claude.com/docs/ru/build-with-claude/context-editing#thinking-block-clearing). См. [Сохранение блоков размышлений в зависимости от модели](https://platform.claude.com/docs/ru/build-with-claude/thinking#thinking-block-preservation-by-model).

По умолчанию 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 4.5 на Claude Haiku 5.5, сохраняет свои рассуждения. Для других переключений это зависит от двух моделей:

| Переключение | Сохраняет свои рассуждения |
| ----- | ----- |
| На Claude Haiku 5.5 с Claude Haiku 4.5 или более ранних, Claude Sonnet 5 или более ранних либо Claude Opus 4.8 или более ранних | Да |
| На Claude Haiku 5.5 с любой другой модели | Нет. API отбрасывает блоки размышлений этой модели без ошибки. |
| С Claude Haiku 5.5 на Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.2 или Claude Mythos 5.2 | Да, только в Claude API и Claude Models on Google Cloud (Google managed) |
| С Claude Haiku 5.5 на любую другую модель | Нет |

См. [Переключение моделей туда и обратно](https://platform.claude.com/docs/ru/build-with-claude/preserved-thinking#switching-models). О переключениях, в которых не участвует Claude Haiku 5.5, см. [Какие переключения моделей сохраняют рассуждения в Claude API](https://platform.claude.com/docs/ru/build-with-claude/preserved-thinking#which-model-switches-keep-reasoning).

## Удаление параметров сэмплирования

В Claude Haiku 5.5 не указывайте `temperature`, `top_p` и `top_k` и вместо этого управляйте поведением модели с помощью подсказок.

## Замена предзаполнения ответа ассистента

«Prefill» (предзаполнение) — это завершающий ход ассистента в `messages`, который модель продолжает. Claude Haiku 4.5 принимает его, когда размышления выключены. Claude Haiku 5.5 отклоняет его с ошибкой 400, даже если размышления выключены. Завершайте `messages` ходом пользователя и заменяйте каждое предзаполнение в зависимости от его назначения:

* **Формат вывода:** используйте [структурированные выводы](https://platform.claude.com/docs/ru/build-with-claude/structured-outputs) или инструменты с полями enum для классификации.
* **Вступления:** попросите в системной подсказке давать прямой ответ.
* **Продолжения:** перенесите их в сообщение пользователя, например: «Ваш предыдущий ответ был прерван и закончился на `[previous_response]`. Продолжите с того места, где остановились».
* **Напоминания о контексте:** поместите их в ход пользователя.

## Перевод использования компьютера на набор инструментов

Claude Haiku 4.5 поддерживает [управление компьютером](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/computer-use-tool) через инструмент `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`](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/computer-use-tool#migrate-from-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 поддерживает [инструмент управления браузером](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/browser-use-tool) (`browser_toolset_20260801`) для задач внутри веб-страниц. Claude Haiku 4.5 его не поддерживает.

## Воспроизведение блоков размышлений через аккаунт, который их создал

Блоки размышлений от Claude Haiku 5.5 работают только в аккаунте, который их создал, или в связанном с ним аккаунте. Когда другой аккаунт отправляет один из таких блоков, API отбрасывает блок до того, как его получит модель, и запрос выполняется успешно без этих рассуждений. Это затрагивает код, который хранит разговоры и воспроизводит их через другой аккаунт, например сервис, обслуживающий нескольких клиентов из одного хранилища разговоров. Воспроизводите каждый разговор через аккаунт, который его создал. См. [Аккаунты и облачные платформы](https://platform.claude.com/docs/ru/build-with-claude/preserved-thinking#account-bound-thinking).

## Сохранение более ранних ходов без изменений

Ведите разговоры в режиме только добавления. Блок размышлений Claude Haiku 5.5 остаётся действительным только до тех пор, пока всё, что было отправлено перед ним, остаётся неизменным: системная подсказка (`system`), инструменты (`tools`) и каждое предыдущее сообщение.

Непройденная [«prefix check» (проверка префикса)](https://platform.claude.com/docs/ru/build-with-claude/preserved-thinking/prefix-checks#prefix-check) может привести к [ошибке 400](https://platform.claude.com/docs/ru/api/errors#thinking-block-conversation-mismatch), а может и не привести. Чтобы выявлять и обрабатывать оба случая, см. [Проверка префикса для блоков размышлений](https://platform.claude.com/docs/ru/build-with-claude/preserved-thinking/prefix-checks).

Об изменениях, которые вызывают ошибку, и о том, что делать вместо этого, см. [Если ваш код изменяет системную подсказку, инструменты или историю](https://platform.claude.com/docs/ru/build-with-claude/preserved-thinking/prefix-checks#what-to-check).

## Миграция на 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). См. [Устаревание моделей](https://platform.claude.com/docs/ru/about-claude/model-deprecations).

При переходе с любой из этих моделей сначала примените все предыдущие разделы, а затем следующие изменения:

* **Идентификатор модели:** замените `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](https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide#use-the-claude-haiku-5-5-model-id).
* **Выполнение кода:** Claude Haiku 5.5 принимает `code_execution_20250825` и более поздние версии. Если вы используете инструмент `code_execution_20250522`, поддерживающий только Python, перейдите на одну из них. См. [Обновление до последней версии инструмента](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/code-execution-tool#upgrade-to-latest-tool-version).
* **Текстовый редактор:** если вы используете инструмент текстового редактора, перейдите на `text_editor_20250728` (имя инструмента `str_replace_based_edit_tool`), в котором нет команды `undo_edit`. См. [Инструмент текстового редактора](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/text-editor-tool).
* **Причины остановки:** обрабатывайте `refusal` и `model_context_window_exceeded`. См. [Причины остановки и резервные модели](https://platform.claude.com/docs/ru/build-with-claude/handling-stop-reasons).
* **Завершающие символы новой строки:** Claude 4.5 и более поздние модели сохраняют завершающие символы новой строки в строковых параметрах вызовов инструментов. Если ваш код выполняет точное сравнение этих строк, учитывайте их.
* **Подсказки:** Claude 4 и более поздние модели имеют более лаконичный, прямой стиль общения и нуждаются в явных указаниях. Пересмотрите свои подсказки с учётом руководств [Составление подсказок для Claude Haiku 5.5](https://platform.claude.com/docs/ru/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5) и [Лучшие практики составления подсказок](https://platform.claude.com/docs/ru/build-with-claude/prompt-engineering/claude-prompting-best-practices).
