Миграция на Claude 4.5

Это руководство охватывает два ключевых пути миграции на модели Claude 4.5:

• Claude Sonnet 3.7 → Claude Sonnet 4.5: Наша самая интеллектуальная модель с лучшими в своем классе возможностями рассуждения, кодирования и долгосрочных агентов
• Claude Haiku 3.5 → Claude Haiku 4.5: Наша самая быстрая и интеллектуальная модель Haiku с производительностью, близкой к передовой, для приложений реального времени и высокообъемной интеллектуальной обработки

Обе миграции включают критические изменения, требующие обновления вашей реализации. Это руководство проведет вас через каждый путь миграции с пошаговыми инструкциями и четко обозначенными критическими изменениями.

Перед началом миграции мы рекомендуем ознакомиться с Что нового в Claude 4.5, чтобы понять новые функции и возможности, доступные в этих моделях, включая расширенное мышление, осведомленность о контексте и улучшения поведения.

Миграция с Claude Sonnet 3.7 на Claude Sonnet 4.5

Claude Sonnet 4.5 — это наша самая интеллектуальная модель, предлагающая лучшую в своем классе производительность для рассуждения, кодирования и долгосрочных автономных агентов. Эта миграция включает несколько критических изменений, требующих обновления вашей реализации.

Шаги миграции

1. Обновите имя модели:

   # До (Claude Sonnet 3.7)
   model="claude-3-7-sonnet-20250219"
   
   # После (Claude Sonnet 4.5)
   model="claude-sonnet-4-5-20250929"

2. Обновите параметры выборки

   Это критическое изменение от Claude Sonnet 3.7.

   Используйте только temperature ИЛИ top_p, но не оба:

   # До (Claude Sonnet 3.7) - Это вызовет ошибку в Sonnet 4.5
   response = client.messages.create(
       model="claude-3-7-sonnet-20250219",
       temperature=0.7,
       top_p=0.9,  # Нельзя использовать оба
       ...
   )
   
   # После (Claude Sonnet 4.5)
   response = client.messages.create(
       model="claude-sonnet-4-5-20250929",
       temperature=0.7,  # Используйте temperature ИЛИ top_p, но не оба
       ...
   )

3. Обработайте новую причину остановки refusal

   Обновите ваше приложение для обработки причин остановки refusal:

   response = client.messages.create(...)
   
   if response.stop_reason == "refusal":
       # Обработайте отказ надлежащим образом
       pass

4. Обновите инструмент текстового редактора (если применимо)

   Это критическое изменение от Claude Sonnet 3.7.

   Обновите до text_editor_20250728 (тип) и str_replace_based_edit_tool (имя). Удалите любой код, использующий команду undo_edit.

   # До (Claude Sonnet 3.7)
   tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]
   
   # После (Claude Sonnet 4.5)
   tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]

   Подробнее см. в документации инструмента текстового редактора.

5. Обновите инструмент выполнения кода (если применимо)

   Обновите до code_execution_20250825. Устаревшая версия code_execution_20250522 все еще работает, но не рекомендуется. Подробнее см. в документации инструмента выполнения кода для инструкций по миграции.

6. Удалите заголовок бета-версии экономичного использования инструментов

   Экономичное использование инструментов — это функция бета-версии, которая работает только с Claude 3.7 Sonnet. Все модели Claude 4 имеют встроенное экономичное использование инструментов, поэтому вам больше не нужно включать заголовок бета-версии.

   Удалите заголовок бета-версии token-efficient-tools-2025-02-19 из ваших запросов:

   # До (Claude Sonnet 3.7)
   client.messages.create(
       model="claude-3-7-sonnet-20250219",
       betas=["token-efficient-tools-2025-02-19"],  # Удалите это
       ...
   )
   
   # После (Claude Sonnet 4.5)
   client.messages.create(
       model="claude-sonnet-4-5-20250929",
       # Нет заголовка бета-версии token-efficient-tools
       ...
   )

7. Удалите заголовок бета-версии расширенного вывода

   Заголовок бета-версии output-128k-2025-02-19 для расширенного вывода доступен только в Claude Sonnet 3.7.

   Удалите этот заголовок из ваших запросов:

   # До (Claude Sonnet 3.7)
   client.messages.create(
       model="claude-3-7-sonnet-20250219",
       betas=["output-128k-2025-02-19"],  # Удалите это
       ...
   )
   
   # После (Claude Sonnet 4.5)
   client.messages.create(
       model="claude-sonnet-4-5-20250929",
       # Нет заголовка бета-версии output-128k
       ...
   )

8. Обновите ваши подсказки для изменений поведения

   Claude Sonnet 4.5 имеет более лаконичный, прямой стиль общения и требует явного направления. Ознакомьтесь с лучшими практиками инженерии подсказок Claude 4 для руководства по оптимизации.

9. Рассмотрите возможность включения расширенного мышления для сложных задач

   Включите расширенное мышление для значительного улучшения производительности при выполнении задач кодирования и рассуждения (отключено по умолчанию):

   response = client.messages.create(
       model="claude-sonnet-4-5-20250929",
       max_tokens=16000,
       thinking={"type": "enabled", "budget_tokens": 10000},
       messages=[...]
   )
   Расширенное мышление влияет на эффективность кэширования подсказок.

10. Протестируйте вашу реализацию

Протестируйте в среде разработки перед развертыванием в производство, чтобы убедиться, что все критические изменения правильно обработаны.

Контрольный список миграции Sonnet 3.7 → 4.5

• Обновите ID модели на claude-sonnet-4-5-20250929
• КРИТИЧЕСКОЕ: Обновите параметры выборки, чтобы использовать только temperature ИЛИ top_p, но не оба
• Обработайте новую причину остановки refusal в вашем приложении
• КРИТИЧЕСКОЕ: Обновите инструмент текстового редактора на text_editor_20250728 и str_replace_based_edit_tool (если применимо)
• КРИТИЧЕСКОЕ: Удалите любой код, использующий команду undo_edit (если применимо)
• Обновите инструмент выполнения кода на code_execution_20250825 (если применимо)
• Удалите заголовок бета-версии token-efficient-tools-2025-02-19 (если применимо)
• Удалите заголовок бета-версии output-128k-2025-02-19 (если применимо)
• Проверьте и обновите подсказки в соответствии с лучшими практиками Claude 4
• Рассмотрите возможность включения расширенного мышления для сложных задач рассуждения
• Обработайте причину остановки model_context_window_exceeded (специфично для Sonnet 4.5)
• Рассмотрите возможность включения инструмента памяти для долгосрочных агентов (бета-версия)
• Рассмотрите возможность использования автоматического очищения вызовов инструментов для редактирования контекста (бета-версия)
• Протестируйте в среде разработки перед развертыванием в производство

Функции, удаленные из Claude Sonnet 3.7

• Экономичное использование инструментов: Заголовок бета-версии token-efficient-tools-2025-02-19 работает только с Claude 3.7 Sonnet и не поддерживается в моделях Claude 4 (см. шаг 6)
• Расширенный вывод: Заголовок бета-версии output-128k-2025-02-19 не поддерживается (см. шаг 7)

Оба заголовка могут быть включены в запросы Claude 4, но не будут иметь никакого эффекта.

Миграция с Claude Haiku 3.5 на Claude Haiku 4.5

Claude Haiku 4.5 — это наша самая быстрая и интеллектуальная модель Haiku с производительностью, близкой к передовой, обеспечивающая качество премиум-модели с производительностью реального времени для интерактивных приложений и высокообъемной интеллектуальной обработки. Эта миграция включает несколько критических изменений, требующих обновления вашей реализации.

Для полного обзора новых возможностей см. Что нового в Claude 4.5.

Шаги миграции

1. Обновите имя модели:

   # До (Haiku 3.5)
   model="claude-3-5-haiku-20241022"
   
   # После (Haiku 4.5)
   model="claude-haiku-4-5-20251001"

2. Обновите версии инструментов (если применимо)

   Это критическое изменение от Claude Haiku 3.5.

   Haiku 4.5 поддерживает только последние версии инструментов:

   # До (Haiku 3.5)
   tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]
   
   # После (Haiku 4.5)
   tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
   • Текстовый редактор: Используйте text_editor_20250728 и str_replace_based_edit_tool
   • Выполнение кода: Используйте code_execution_20250825
   • Удалите любой код, использующий команду undo_edit

3. Обновите параметры выборки

   Это критическое изменение от Claude Haiku 3.5.

   Используйте только temperature ИЛИ top_p, но не оба:

   # До (Haiku 3.5) - Это вызовет ошибку в Haiku 4.5
   response = client.messages.create(
       model="claude-3-5-haiku-20241022",
       temperature=0.7,
       top_p=0.9,  # Нельзя использовать оба
       ...
   )
   
   # После (Haiku 4.5)
   response = client.messages.create(
       model="claude-haiku-4-5-20251001",
       temperature=0.7,  # Используйте temperature ИЛИ top_p, но не оба
       ...
   )

4. Проверьте новые ограничения скорости

   Haiku 4.5 имеет отдельные ограничения скорости от Haiku 3.5. Подробнее см. в документации об ограничениях скорости.

5. Обработайте новую причину остановки refusal

   Обновите ваше приложение для обработки причин остановки отказа.

6. Рассмотрите возможность включения расширенного мышления для сложных задач

   Включите расширенное мышление для значительного улучшения производительности при выполнении задач кодирования и рассуждения (отключено по умолчанию):

   response = client.messages.create(
       model="claude-haiku-4-5-20251001",
       max_tokens=16000,
       thinking={"type": "enabled", "budget_tokens": 5000},
       messages=[...]
   )
   Расширенное мышление влияет на эффективность кэширования подсказок.

7. Изучите новые возможности

   Подробнее см. в Что нового в Claude 4.5 для получения информации об осведомленности о контексте, увеличенной емкости вывода (64K токенов), повышенном интеллекте и улучшенной скорости.

8. Протестируйте вашу реализацию

   Протестируйте в среде разработки перед развертыванием в производство, чтобы убедиться, что все критические изменения правильно обработаны.

Контрольный список миграции Haiku 3.5 → 4.5

• Обновите ID модели на claude-haiku-4-5-20251001
• КРИТИЧЕСКОЕ: Обновите версии инструментов на последние (например, text_editor_20250728, code_execution_20250825) - устаревшие версии не поддерживаются
• КРИТИЧЕСКОЕ: Удалите любой код, использующий команду undo_edit (если применимо)
• КРИТИЧЕСКОЕ: Обновите параметры выборки, чтобы использовать только temperature ИЛИ top_p, но не оба
• Проверьте и отрегулируйте новые ограничения скорости (отдельно от Haiku 3.5)
• Обработайте новую причину остановки refusal в вашем приложении
• Рассмотрите возможность включения расширенного мышления для сложных задач рассуждения (новая возможность)
• Используйте осведомленность о контексте для лучшего управления токенами в длительных сеансах
• Подготовьтесь к большим ответам (максимальный вывод увеличен с 8K на 64K токенов)
• Проверьте и обновите подсказки в соответствии с лучшими практиками Claude 4
• Протестируйте в среде разработки перед развертыванием в производство

Выбор между Sonnet 4.5 и Haiku 4.5

Оба Claude Sonnet 4.5 и Claude Haiku 4.5 — это мощные модели Claude 4 с различными сильными сторонами:

Выберите Claude Sonnet 4.5 (самый интеллектуальный) для:

• Сложное рассуждение и анализ: Лучший в своем классе интеллект для сложных задач
• Долгосрочные автономные агенты: Превосходная производительность для агентов, работающих независимо в течение длительных периодов
• Продвинутые задачи кодирования: Наша самая сильная модель кодирования с продвинутым планированием и инженерией безопасности
• Рабочие процессы с большим контекстом: Улучшенное управление контекстом с инструментом памяти и возможностями редактирования контекста
• Задачи, требующие максимальных возможностей: Когда интеллект и точность — главные приоритеты

Выберите Claude Haiku 4.5 (самый быстрый и интеллектуальный Haiku) для:

• Приложения реального времени: Быстрое время отклика для интерактивного пользовательского опыта с производительностью, близкой к передовой
• Высокообъемная интеллектуальная обработка: Экономичный интеллект в масштабе с улучшенной скоростью
• Развертывания, чувствительные к стоимости: Производительность, близкая к передовой, по более низким ценам
• Архитектуры суб-агентов: Быстрые, интеллектуальные агенты для многоагентных систем
• Компьютерное использование в масштабе: Экономичная автоматизация рабочего стола и браузера
• Задачи, требующие скорости: Когда низкая задержка критична при сохранении интеллекта, близкого к передовому

Рекомендации по расширенному мышлению

Модели Claude 4, особенно Sonnet и Haiku 4.5, показывают значительное улучшение производительности при использовании расширенного мышления для задач кодирования и сложного рассуждения. Расширенное мышление отключено по умолчанию, но мы рекомендуем включить его для требовательной работы.

Важно: Расширенное мышление влияет на эффективность кэширования подсказок. Когда содержимое, не являющееся результатом инструмента, добавляется в беседу, блоки мышления удаляются из кэша, что может увеличить затраты в многооборотных беседах. Мы рекомендуем включить мышление, когда преимущества производительности перевешивают компромисс кэширования.

Другие сценарии миграции

Основные пути миграции, описанные выше (Sonnet 3.7 → 4.5 и Haiku 3.5 → 4.5), представляют наиболее распространенные обновления. Однако вы можете выполнять миграцию с других моделей Claude на Claude 4.5. Этот раздел охватывает эти сценарии.

Миграция с Claude Sonnet 4 → Sonnet 4.5

Критическое изменение: Нельзя указывать одновременно temperature и top_p в одном запросе.

Все остальные вызовы API будут работать без изменений. Обновите ID модели и отрегулируйте параметры выборки, если необходимо:

# До (Claude Sonnet 4)
model="claude-sonnet-4-20250514"

# После (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"

Миграция с Claude Opus 4.1 → Sonnet 4.5

Нет критических изменений. Все вызовы API будут работать без изменений.

Просто обновите ID модели:

# До (Claude Opus 4.1)
model="claude-opus-4-1-20250805"

# После (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"

Claude Sonnet 4.5 — это наша самая интеллектуальная модель с лучшими в своем классе возможностями рассуждения, кодирования и долгосрочных агентов. Она обеспечивает превосходную производительность по сравнению с Opus 4.1 для большинства вариантов использования.

Нужна помощь?

• Проверьте нашу документацию API для получения подробных спецификаций
• Ознакомьтесь с возможностями модели для сравнения производительности
• Ознакомьтесь с примечаниями к выпуску API для обновлений API
• Свяжитесь с поддержкой, если у вас возникнут проблемы при миграции