Миграция на Claude 4
Эта страница содержит рекомендации по миграции с моделей Claude 3.7 на модели Claude 4 (Opus 4 и Sonnet 4).
В большинстве случаев вы можете перейти на модели Claude 4 с минимальными изменениями:
-
Обновите название модели:
- С:
claude-3-7-sonnet-20250219
- На:
claude-sonnet-4-20250514
илиclaude-opus-4-20250514
- С:
-
Существующие API-вызовы должны продолжать работать без изменений, хотя поведение API немного изменилось в моделях Claude 4 (подробности см. в примечаниях к выпуску API).
Что нового в Claude 4
Новая причина остановки при отказе
Модели Claude 4 вводят новую причину остановки refusal
для контента, который модель отказывается генерировать по соображениям безопасности, из-за повышенного интеллекта моделей Claude 4:
При миграции на Claude 4 вам следует обновить ваше приложение, чтобы обрабатывать причины остановки refusal
.
Резюмированное мышление
При включенном расширенном мышлении API сообщений для моделей Claude 4 возвращает резюме полного процесса мышления Claude. Резюмированное мышление обеспечивает все преимущества интеллекта расширенного мышления, предотвращая при этом злоупотребления.
Хотя API согласован между моделями Claude 3.7 и 4, потоковые ответы для расширенного мышления могут возвращаться в “прерывистом” режиме доставки, с возможными задержками между событиями потока.
Резюмирование обрабатывается другой моделью, отличной от той, которую вы указываете в своих запросах. Модель мышления не видит резюмированный вывод.
Для получения дополнительной информации см. документацию по расширенному мышлению.
Чередующееся мышление
Модели Claude 4 поддерживают чередование использования инструментов с расширенным мышлением, что позволяет вести более естественные разговоры, где использование инструментов и ответы могут смешиваться с обычными сообщениями.
Чередующееся мышление находится в бета-версии. Чтобы включить чередующееся мышление, добавьте бета-заголовок interleaved-thinking-2025-05-14
в ваш API-запрос.
Для получения дополнительной информации см. документацию по расширенному мышлению.
Обновленный инструмент текстового редактора
Инструмент текстового редактора был обновлен для моделей Claude 4 со следующими изменениями:
- Тип инструмента:
text_editor_20250429
- Название инструмента:
str_replace_based_edit_tool
- Команда
undo_edit
больше не поддерживается в моделях Claude 4.
Инструмент текстового редактора str_replace_editor
остается таким же для Claude Sonnet 3.7.
Если вы мигрируете с Claude Sonnet 3.7 и используете инструмент текстового редактора:
Для получения дополнительной информации см. документацию по инструменту текстового редактора.
Токен-эффективное использование инструментов больше не поддерживается
Токен-эффективное использование инструментов доступно только в Claude Sonnet 3.7.
Если вы мигрируете с Claude Sonnet 3.7 и используете токен-эффективное использование инструментов, мы рекомендуем удалить бета-заголовок token-efficient-tools-2025-02-19
из ваших запросов.
Бета-заголовок token-efficient-tools-2025-02-19
по-прежнему может быть включен в запросы Claude 4, но он не будет иметь никакого эффекта.
Расширенный вывод больше не поддерживается
Бета-заголовок output-128k-2025-02-19
для расширенного вывода доступен только в Claude Sonnet 3.7.
Если вы мигрируете с Claude Sonnet 3.7, мы рекомендуем удалить output-128k-2025-02-19
из ваших запросов.
Бета-заголовок output-128k-2025-02-19
по-прежнему может быть включен в запросы Claude 4, но он не будет иметь никакого эффекта.
Соображения по производительности
Claude Sonnet 4
- Улучшенные возможности рассуждения и интеллекта по сравнению с Claude Sonnet 3.7
- Повышенная точность использования инструментов
Claude Opus 4
- Самая мощная модель с превосходными возможностями рассуждения и интеллекта
- Медленнее, чем модели Sonnet
- Лучше всего подходит для сложных задач, требующих глубокого анализа
Контрольный список миграции
- Обновите идентификатор модели в ваших API-вызовах
- Протестируйте существующие запросы (должны работать без изменений)
- Удалите бета-заголовок
token-efficient-tools-2025-02-19
, если применимо - Удалите бета-заголовок
output-128k-2025-02-19
, если применимо - Обрабатывайте новую причину остановки
refusal
- Обновите тип и название инструмента текстового редактора, если используете его
- Удалите любой код, использующий команду
undo_edit
- Изучите новые возможности чередования инструментов с расширенным мышлением
- Ознакомьтесь с лучшими практиками инженерии промптов для Claude 4 для оптимальных результатов
- Протестируйте в среде разработки перед развертыванием в продакшн
Нужна помощь?
- Проверьте нашу документацию по API для подробных спецификаций.
- Ознакомьтесь с возможностями моделей для сравнения производительности.
- Просмотрите примечания к выпуску API для обновлений API.
- Свяжитесь с поддержкой, если вы столкнетесь с какими-либо проблемами во время миграции.