Это руководство охватывает два ключевых пути миграции на модели Claude 4.5:
  • Claude Sonnet 3.7 → Claude Sonnet 4.5: Наша самая интеллектуальная модель с лучшими в классе возможностями рассуждения, кодирования и долгосрочной работы агентов
  • Claude Haiku 3.5 → Claude Haiku 4.5: Наша самая быстрая и интеллектуальная модель Haiku с производительностью, близкой к передовой, для приложений реального времени и высокообъемной интеллектуальной обработки
Обе миграции включают критические изменения, которые требуют обновления вашей реализации. Это руководство проведет вас через каждый путь миграции с пошаговыми инструкциями и четко отмеченными критическими изменениями. Перед началом миграции мы рекомендуем ознакомиться с Что нового в Claude 4.5, чтобы понять новые функции и возможности, доступные в этих моделях, включая расширенное мышление, контекстную осведомленность и поведенческие улучшения.

​
Миграция с Claude Sonnet 3.7 на Claude Sonnet 4.5

Claude Sonnet 4.5 - это наша самая интеллектуальная модель, предлагающая лучшую в классе производительность для рассуждения, кодирования и долгосрочных автономных агентов. Эта миграция включает несколько критических изменений, которые требуют обновления вашей реализации.

​
Шаги миграции

  1. Обновите название вашей модели: 
    # До (Claude Sonnet 3.7)
model="claude-3-7-sonnet-20250219"

# После (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"
  2. Обновите параметры выборки
    Это критическое изменение по сравнению с 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, но не оба
    ...
)
  3. Обработайте новую причину остановки refusal Обновите ваше приложение для обработки причин остановки refusal: 
    response = client.messages.create(...)

if response.stop_reason == "refusal":
    # Обработайте отказ соответствующим образом
    pass
  4. Обновите инструмент текстового редактора (если применимо)
    Это критическое изменение по сравнению с 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"}]
    См. Документацию инструмента текстового редактора для подробностей.
  5. Обновите инструмент выполнения кода (если применимо) Обновите до code_execution_20250825. Устаревшая версия code_execution_20250522 все еще работает, но не рекомендуется. См. Документацию инструмента выполнения кода для инструкций по миграции.
  6. Удалите заголовок бета-версии токен-эффективного использования инструментов Токен-эффективное использование инструментов - это бета-функция в Claude 3.7. Все модели 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
    ...
)
  7. Удалите заголовок бета-версии расширенного вывода Бета-заголовок 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
    ...
)
  8. Обновите ваши промпты для поведенческих изменений Claude Sonnet 4.5 имеет более краткий, прямой стиль общения и требует явного направления. Ознакомьтесь с лучшими практиками промпт-инжиниринга Claude 4 для руководства по оптимизации.
  9. Рассмотрите включение расширенного мышления для сложных задач Включите расширенное мышление для значительного улучшения производительности в задачах кодирования и рассуждения (по умолчанию отключено): 
    response = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[...]
)
    Расширенное мышление влияет на эффективность кэширования промптов.
  10. Протестируйте вашу реализацию
Протестируйте в среде разработки перед развертыванием в продакшене, чтобы убедиться, что все критические изменения правильно обработаны.

​
Контрольный список миграции Sonnet 3.7 → 4.5

  • Обновить ID модели на claude-sonnet-4-5-20250929
  • КРИТИЧЕСКОЕ: Обновить параметры выборки для использования только temperature ИЛИ top_p, но не оба
  • Обработать новую причину остановки refusal в вашем приложении
  • КРИТИЧЕСКОЕ: Обновить инструмент текстового редактора на text_editor_20250728 и str_replace_based_edit_tool (если применимо)
  • КРИТИЧЕСКОЕ: Удалить любой код, использующий команду undo_edit (если применимо)
  • Обновить инструмент выполнения кода на code_execution_20250825 (если применимо)
  • Удалить бета-заголовок token-efficient-tools-2025-02-19 (если применимо)
  • Удалить бета-заголовок output-128k-2025-02-19 (если применимо)
  • Просмотреть и обновить промпты, следуя лучшим практикам Claude 4
  • Рассмотреть включение расширенного мышления для сложных задач рассуждения
  • Обработать причину остановки model_context_window_exceeded (специфично для Sonnet 4.5)
  • Рассмотреть включение инструмента памяти для долгосрочных агентов (бета)
  • Рассмотреть использование автоматической очистки вызовов инструментов для редактирования контекста (бета)
  • Протестировать в среде разработки перед развертыванием в продакшене

​
Функции, удаленные из Claude Sonnet 3.7

  • Токен-эффективное использование инструментов: Бета-заголовок token-efficient-tools-2025-02-19 не поддерживается (см. шаг 6)
  • Расширенный вывод: Бета-заголовок output-128k-2025-02-19 не поддерживается (см. шаг 7)
Оба заголовка могут быть включены в запросы, но не будут иметь эффекта.

​
Миграция с Claude Haiku 3.5 на Claude Haiku 4.5

Claude Haiku 4.5 - это наша самая быстрая и интеллектуальная модель Haiku с производительностью, близкой к передовой, обеспечивающая качество премиум-модели с производительностью реального времени для интерактивных приложений и высокообъемной интеллектуальной обработки. Эта миграция включает несколько критических изменений, которые требуют обновления вашей реализации. Для полного обзора новых возможностей см. Что нового в Claude 4.5.
Цены Haiku 4.5: 1замиллионвходныхтокенов,1 за миллион входных токенов, 5 за миллион выходных токенов. См. Цены Claude для подробностей.

​
Шаги миграции

  1. Обновите название вашей модели: 
    # До (Haiku 3.5)
model="claude-3-5-haiku-20241022"

# После (Haiku 4.5)
model="claude-haiku-4-5-20251001"
  2. Обновите версии инструментов (если применимо)
    Это критическое изменение по сравнению с 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"}]
    • Текстовый редактор: Используйте text_editor_20250728 и str_replace_based_edit_tool
    • Выполнение кода: Используйте code_execution_20250825
    • Удалите любой код, использующий команду undo_edit
  3. Обновите параметры выборки
    Это критическое изменение по сравнению с 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, но не оба
    ...
)
  4. Просмотрите новые ограничения скорости Haiku 4.5 имеет отдельные ограничения скорости от Haiku 3.5. См. Документацию по ограничениям скорости для подробностей.
  5. Обработайте новую причину остановки refusal Обновите ваше приложение для обработки причин остановки отказа.
  6. Рассмотрите включение расширенного мышления для сложных задач Включите расширенное мышление для значительного улучшения производительности в задачах кодирования и рассуждения (по умолчанию отключено): 
    response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 5000},
    messages=[...]
)
    Расширенное мышление влияет на эффективность кэширования промптов.
  7. Изучите новые возможности См. Что нового в Claude 4.5 для подробностей о контекстной осведомленности, увеличенной выходной емкости (64K токенов), повышенном интеллекте и улучшенной скорости.
  8. Протестируйте вашу реализацию Протестируйте в среде разработки перед развертыванием в продакшене, чтобы убедиться, что все критические изменения правильно обработаны.

​
Контрольный список миграции Haiku 3.5 → 4.5

  • Обновить ID модели на claude-haiku-4-5-20251001
  • КРИТИЧЕСКОЕ: Обновить версии инструментов на последние (например, text_editor_20250728, code_execution_20250825) - устаревшие версии не поддерживаются
  • КРИТИЧЕСКОЕ: Удалить любой код, использующий команду undo_edit (если применимо)
  • КРИТИЧЕСКОЕ: Обновить параметры выборки для использования только temperature ИЛИ top_p, но не оба
  • Просмотреть и настроить для новых ограничений скорости (отдельно от Haiku 3.5)
  • Обработать новую причину остановки refusal в вашем приложении
  • Рассмотреть включение расширенного мышления для сложных задач рассуждения (новая возможность)
  • Использовать контекстную осведомленность для лучшего управления токенами в длинных сессиях
  • Подготовиться к более крупным ответам (максимальный вывод увеличен с 8K до 64K токенов)
  • Просмотреть и обновить промпты, следуя лучшим практикам Claude 4
  • Протестировать в среде разработки перед развертыванием в продакшене

​
Выбор между Sonnet 4.5 и Haiku 4.5

И Claude Sonnet 4.5, и Claude Haiku 4.5 - это мощные модели Claude 4 с разными сильными сторонами:

​
Выберите Claude Sonnet 4.5 (самый интеллектуальный) для:

  • Сложного рассуждения и анализа: Лучший в классе интеллект для сложных задач
  • Долгосрочных автономных агентов: Превосходная производительность для агентов, работающих независимо в течение длительных периодов
  • Продвинутых задач кодирования: Наша самая сильная модель кодирования с продвинутым планированием и инженерией безопасности
  • Рабочих процессов с большим контекстом: Улучшенное управление контекстом с инструментом памяти и возможностями редактирования контекста
  • Задач, требующих максимальных возможностей: Когда интеллект и точность являются главными приоритетами

​
Выберите Claude Haiku 4.5 (самый быстрый и интеллектуальный Haiku) для:

  • Приложений реального времени: Быстрое время отклика для интерактивного пользовательского опыта с производительностью, близкой к передовой
  • Высокообъемной интеллектуальной обработки: Экономически эффективный интеллект в масштабе с улучшенной скоростью
  • Экономически чувствительных развертываний: Производительность, близкая к передовой, по более низким ценам
  • Архитектур суб-агентов: Быстрые, интеллектуальные агенты для мульти-агентных систем
  • Использования компьютера в масштабе: Экономически эффективная автономная автоматизация рабочего стола и браузера
  • Задач, требующих скорости: Когда низкая задержка критична при сохранении интеллекта, близкого к передовому

​
Рекомендации по расширенному мышлению

Модели Claude 4, особенно Sonnet и Haiku 4.5, показывают значительные улучшения производительности при использовании расширенного мышления для задач кодирования и сложного рассуждения. Расширенное мышление отключено по умолчанию, но мы рекомендуем включать его для требовательной работы. Важно: Расширенное мышление влияет на эффективность кэширования промптов. Когда в разговор добавляется контент, не являющийся результатом инструмента, блоки мышления удаляются из кэша, что может увеличить затраты в многоходовых разговорах. Мы рекомендуем включать мышление, когда преимущества производительности перевешивают компромисс кэширования.

​
Другие сценарии миграции

Основные пути миграции, рассмотренные выше (Sonnet 3.7 → 4.5 и Haiku 3.5 → 4.5), представляют наиболее распространенные обновления. Однако вы можете мигрировать с других моделей Claude на Claude 4.5. Этот раздел охватывает эти сценарии.

​
Миграция с Claude Sonnet 4 → Sonnet 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"

​
Миграция с Claude Opus 4.1 → Sonnet 4.5

Никаких критических изменений. Все вызовы 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 для большинства случаев использования.

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