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

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

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

Обновите имя модели:

# До (Claude Sonnet 3.7)
model="claude-3-7-sonnet-20250219"

# После (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"

Обновите параметры выборки

Это критическое изменение по сравнению с 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, но не оба
    ...
)

Обработайте новую причину остановки refusal

Обновите ваше приложение для обработки причин остановки refusal:
```
response = client.messages.create(...)

if response.stop_reason == "refusal":
    # Обработайте отказ надлежащим образом
    pass
```
Обновите инструмент текстового редактора (если применимо)

Это критическое изменение по сравнению с 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"}]
```
Обновите инструмент выполнения кода (если применимо)

Обновите до code_execution_20250825. Устаревшая версия code_execution_20250522 по-прежнему работает, но не рекомендуется. Подробные инструкции по миграции см. в документации инструмента выполнения кода.
Удалите заголовок бета-версии для экономного использования инструментов

Экономное использование инструментов — это функция бета-версии, которая работает только с Claude 3.7 Sonnet. Все модели Claude 4 имеют встроенное экономное использование инструментов, поэтому вам больше не следует включать заголовок бета-версии.

Удалите заголовок бета-версии token-efficient-tools-2025-02-19 beta header из ваших запросов:
```
# До (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
    ...
)
```

Удалите заголовок бета-версии для расширенного вывода

Заголовок бета-версии output-128k-2025-02-19 beta header для расширенного вывода доступен только в 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
    ...
)

Обновите ваши подсказки с учётом изменений поведения

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

Включите расширенное мышление для значительного улучшения производительности при выполнении задач кодирования и рассуждения (отключено по умолчанию):
```
response = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[...]
)
```
Расширенное мышление влияет на эффективность .
Протестируйте вашу реализацию

Протестируйте в среде разработки перед развёртыванием в производство, чтобы убедиться, что все критические изменения обработаны надлежащим образом.

Контрольный список миграции 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 (если применимо)
Удалите заголовок бета-версии (если применимо)

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

Экономное использование инструментов: Заголовок бета-версии token-efficient-tools-2025-02-19 работает только с Claude 3.7 Sonnet и не поддерживается в моделях Claude 4 (см. шаг 6)
Расширенный вывод: Заголовок бета-версии output-128k-2025-02-19 не поддерживается (см. шаг 7)

Оба заголовка могут быть включены в запросы Claude 4, но не будут иметь никакого эффекта.

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

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

Полный обзор новых возможностей см. в Что нового в Claude 4.5.

Цена Haiku 4.5 составляет $1 за миллион входных токенов, $5 за миллион выходных токенов. Подробности см. в Цены Claude.

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

Обновите имя модели:

# До (Haiku 3.5)
model="claude-3-5-haiku-20241022"

# После (Haiku 4.5)
model="claude-haiku-4-5-20251001"

Обновите версии инструментов (если применимо)

Это критическое изменение по сравнению с 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"}]
```

Контрольный список миграции 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 в вашем приложении
Рассмотрите возможность включения расширенного мышления для сложных задач рассуждения (новая возможность)

Выбор между 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) для:

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

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

Основные пути миграции, описанные выше (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 для большинства вариантов использования.

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

Нет критических изменений. Все вызовы API будут работать без изменений.

Просто обновите ID модели:

# До (Claude Opus 4.1)
model="claude-opus-4-1-20250805"

# После (Claude Opus 4.5)
model="claude-opus-4-5-20251101"

Claude Opus 4.5 — это наша самая интеллектуальная модель, сочетающая максимальные возможности с практической производительностью. Она отличается значительными улучшениями в области зрения, кодирования и компьютерного использования по более доступной цене, чем Opus 4.1. Идеально подходит для сложных специализированных задач и профессиональной разработки программного обеспечения.

Для кодовых баз со множеством ссылок на модели доступен плагин Claude Code для автоматизации миграции на Opus 4.5.

Миграция между моделями Claude 4.5

Нет критических изменений. Все вызовы API будут работать без изменений.

Просто обновите ID модели.

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

Проверьте нашу документацию API для получения подробных спецификаций
Ознакомьтесь с возможностями моделей для сравнения производительности
Ознакомьтесь с примечаниями к выпуску API для обновлений API
Свяжитесь с поддержкой, если у вас возникнут проблемы во время миграции

token-efficient-tools-2025-02-19

Обновите параметры выборки

Это критическое изменение по сравнению с 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, но не оба
    ...
)

Рассмотрите возможность включения расширенного мышления для сложных задач

Включите расширенное мышление для значительного улучшения производительности при выполнении задач кодирования и рассуждения (отключено по умолчанию):

response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 5000},
    messages=[...]
)

Расширенное мышление влияет на эффективность кэширования подсказок.

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

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

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

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

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

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

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

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

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

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

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

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

Миграция с Claude Sonnet 4 → Sonnet 4.5

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

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

Миграция между моделями Claude 4.5

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