Эта страница содержит рекомендации по миграции с моделей 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 поддерживают чередование использования инструментов с расширенным мышлением, что позволяет вести более естественные разговоры, где использование инструментов и ответы могут смешиваться с обычными сообщениями.

Чередующееся мышление находится в бета-версии. Чтобы включить чередующееся мышление, добавьте бета-заголовок 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
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 для оптимальных результатов
  • Протестируйте в среде разработки перед развертыванием в продакшн

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