Миграция на 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.

​

Суммированное мышление

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

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

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

​

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

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

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

​

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

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

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