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

Эта страница содержит рекомендации по миграции с моделей Claude 3.7 на модели Claude 4 (Opus 4 и Sonnet 4).

В большинстве случаев вы можете перейти на модели Claude 4 с минимальными изменениями:

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

   • С: claude-3-7-sonnet-20250219
   • На: claude-sonnet-4-20250514 или claude-opus-4-20250514

2. Существующие API-вызовы должны продолжать работать без изменений, хотя поведение API немного изменилось в моделях Claude 4 (подробности см. в примечаниях к выпуску API).

​

Что нового в Claude 4

​

Новая причина остановки при отказе

Модели Claude 4 вводят новую причину остановки refusal для контента, который модель отказывается генерировать по соображениям безопасности, из-за повышенного интеллекта моделей Claude 4:

{"id":"msg_014XEDjypDjFzgKVWdFUXxZP",
"type":"message",
"role":"assistant",
"model":"claude-sonnet-4-20250514",
"content":[{"type":"text","text":"I would be happy to assist you. You can "}],
"stop_reason":"refusal",
"stop_sequence":null,
"usage":{"input_tokens":564,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":22}
}

При миграции на Claude 4 вам следует обновить ваше приложение, чтобы обрабатывать причины остановки refusal.

​

Резюмированное мышление

При включенном расширенном мышлении API сообщений для моделей Claude 4 возвращает резюме полного процесса мышления Claude. Резюмированное мышление обеспечивает все преимущества интеллекта расширенного мышления, предотвращая при этом злоупотребления.

Хотя API согласован между моделями Claude 3.7 и 4, потоковые ответы для расширенного мышления могут возвращаться в “прерывистом” режиме доставки, с возможными задержками между событиями потока.

Для получения дополнительной информации см. документацию по расширенному мышлению.

​

Чередующееся мышление

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

Для получения дополнительной информации см. документацию по расширенному мышлению.

​

Обновленный инструмент текстового редактора

Инструмент текстового редактора был обновлен для моделей Claude 4 со следующими изменениями:

• Тип инструмента: text_editor_20250429
• Название инструмента: str_replace_based_edit_tool
• Команда undo_edit больше не поддерживается в моделях Claude 4.

Если вы мигрируете с Claude Sonnet 3.7 и используете инструмент текстового редактора:

# Claude Sonnet 3.7
tools=[
    {
        "type": "text_editor_20250124",
        "name": "str_replace_editor"
    }
]

# Claude 4
tools=[
    {
        "type": "text_editor_20250429",
        "name": "str_replace_based_edit_tool"
    }
]

Для получения дополнительной информации см. документацию по инструменту текстового редактора.

​

Токен-эффективное использование инструментов больше не поддерживается

Токен-эффективное использование инструментов доступно только в 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.
• Свяжитесь с поддержкой, если вы столкнетесь с какими-либо проблемами во время миграции.