Это руководство охватывает два ключевых пути миграции на модели Claude 4.5:
Обе миграции включают критические изменения, требующие обновления вашей реализации. Это руководство проведет вас через каждый путь миграции с пошаговыми инструкциями и четко обозначенными критическими изменениями.
Перед началом миграции мы рекомендуем ознакомиться с Что нового в Claude 4.5, чтобы понять новые функции и возможности, доступные в этих моделях, включая расширенное мышление, осведомленность о контексте и улучшения поведения.
Claude Sonnet 4.5 — это наша самая интеллектуальная модель, предлагающая лучшую в своем классе производительность для рассуждения, кодирования и долгосрочных автономных агентов. Эта миграция включает несколько критических изменений, требующих обновления вашей реализации.
Обновите имя модели:
# До (Claude Sonnet 3.7)
model="claude-3-7-sonnet-20250219"
# После (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"Обновите параметры выборки
Это критическое изменение по сравнению с 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, но не оба
...
)Обработайте новую причину остановки refusal
Обновите ваше приложение для обработки причин остановки refusal:
response = client.messages.create(...)
if response.stop_reason == "refusal":
# Обработайте отказ надлежащим образом
passОбновите инструмент текстового редактора (если применимо)
Это критическое изменение по сравнению с 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"}]Обновите инструмент выполнения кода (если применимо)
Обновите до code_execution_20250825. Устаревшая версия code_execution_20250522 по-прежнему работает, но не рекомендуется. Подробнее см. в документации инструмента выполнения кода.
Удалите заголовок бета-версии для эффективного использования токенов в инструментах
Эффективное использование токенов в инструментах — это бета-функция, которая работает только с 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
...
)Удалите заголовок бета-версии для расширенного вывода
Заголовок бета-версии 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
...
)Обновите ваши подсказки для изменений поведения
Claude Sonnet 4.5 имеет более лаконичный, прямой стиль общения и требует явного направления. Ознакомьтесь с лучшими практиками инженерии подсказок Claude 4 для рекомендаций по оптимизации.
Рассмотрите включение расширенного мышления для сложных задач
Включите расширенное мышление для значительного улучшения производительности при кодировании и решении задач рассуждения (отключено по умолчанию):
response = client.messages.create(
model="claude-sonnet-4-5-20250929",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 10000},
messages=[...]
)Расширенное мышление влияет на эффективность .
Протестируйте вашу реализацию
Протестируйте в среде разработки перед развертыванием в производство, чтобы убедиться, что все критические изменения правильно обработаны.
claude-sonnet-4-5-20250929temperature ИЛИ top_p, но не обаrefusal в вашем приложенииtext_editor_20250728 и str_replace_based_edit_tool (если применимо)undo_edit (если применимо)code_execution_20250825 (если применимо)token-efficient-tools-2025-02-19 работает только с Claude 3.7 Sonnet и не поддерживается в моделях Claude 4 (см. шаг 6)output-128k-2025-02-19 не поддерживается (см. шаг 7)Оба заголовка могут быть включены в запросы Claude 4, но не будут иметь никакого эффекта.
Claude Haiku 4.5 — это наша самая быстрая и интеллектуальная модель Haiku с производительностью, близкой к передовой, обеспечивающая качество премиум-модели с производительностью в реальном времени для интерактивных приложений и высокообъемной интеллектуальной обработки. Эта миграция включает несколько критических изменений, требующих обновления вашей реализации.
Для полного обзора новых возможностей см. Что нового в Claude 4.5.
Цены Haiku 4.5: $1 за миллион входных токенов, $5 за миллион выходных токенов. Подробнее см. в ценах Claude.
Обновите имя модели:
# До (Haiku 3.5)
model="claude-3-5-haiku-20241022"
# После (Haiku 4.5)
model="claude-haiku-4-5-20251001"Обновите версии инструментов (если применимо)
Это критическое изменение по сравнению с 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"}]claude-haiku-4-5-20251001text_editor_20250728, code_execution_20250825) - устаревшие версии не поддерживаютсяundo_edit (если применимо)temperature ИЛИ top_p, но не обаrefusal в вашем приложенииКак Claude Sonnet 4.5, так и Claude Haiku 4.5 — это мощные модели Claude 4 с различными сильными сторонами:
Модели Claude 4, особенно Sonnet и Haiku 4.5, показывают значительное улучшение производительности при использовании расширенного мышления для кодирования и сложных задач рассуждения. Расширенное мышление отключено по умолчанию, но мы рекомендуем включить его для требовательной работы.
Важно: Расширенное мышление влияет на эффективность кэширования подсказок. Когда содержимое, не являющееся результатом инструмента, добавляется в беседу, блоки мышления удаляются из кэша, что может увеличить затраты в многооборотных беседах. Мы рекомендуем включить мышление, когда преимущества производительности перевешивают компромисс кэширования.
Основные пути миграции, описанные выше (Sonnet 3.7 → 4.5 и Haiku 3.5 → 4.5), представляют наиболее распространенные обновления. Однако вы можете выполнять миграцию с других моделей Claude на Claude 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"Нет критических изменений. Все вызовы 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 будут работать без изменений.
Просто обновите ID модели:
# До (Claude Opus 4.1)
model="claude-opus-4-1-20250805"
# После (Claude Opus 4.5)
model="claude-opus-4-5-20251101"Claude Opus 4.5 — это наша самая интеллектуальная модель, сочетающая максимальные возможности с практической производительностью. Она отличается значительными улучшениями в области зрения, кодирования и компьютерного использования по более доступной цене, чем Opus 4.1. Идеально подходит для сложных специализированных задач и профессиональной разработки программного обеспечения.
Для кодовых баз со множеством ссылок на модели доступен плагин Claude Code для автоматизации миграции на Opus 4.5.
Нет критических изменений. Все вызовы API будут работать без изменений.
Просто обновите ID модели.
Подробнее см. в документации инструмента текстового редактора.
token-efficient-tools-2025-02-19output-128k-2025-02-19 (если применимо)model_context_window_exceeded (специфично для Sonnet 4.5)text_editor_20250728 и str_replace_based_edit_toolcode_execution_20250825undo_editОбновите параметры выборки
Это критическое изменение по сравнению с 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, но не оба
...
)Проверьте новые ограничения скорости
Haiku 4.5 имеет отдельные ограничения скорости от Haiku 3.5. Подробнее см. в документации по ограничениям скорости.
Обработайте новую причину остановки refusal
Обновите ваше приложение для обработки причин остановки отказа.
Рассмотрите включение расширенного мышления для сложных задач
Включите расширенное мышление для значительного улучшения производительности при кодировании и решении задач рассуждения (отключено по умолчанию):
response = client.messages.create(
model="claude-haiku-4-5-20251001",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 5000},
messages=[...]
)Расширенное мышление влияет на эффективность кэширования подсказок.
Изучите новые возможности
Подробнее см. в Что нового в Claude 4.5 о осведомленности о контексте, увеличенной емкости вывода (64K токенов), повышенном интеллекте и улучшенной скорости.
Протестируйте вашу реализацию
Протестируйте в среде разработки перед развертыванием в производство, чтобы убедиться, что все критические изменения правильно обработаны.