Claude Opus 4.6 является практически полной заменой Claude 4.5 с несколькими критическими изменениями, о которых следует знать. Полный список новых функций см. в разделе Что нового в Claude 4.6.
# Миграция Opus
model = "claude-opus-4-5" # До
model = "claude-opus-4-6" # ПослеУдаление предзаполнения: Предзаполнение сообщений помощника возвращает ошибку 400 на моделях Claude 4.6. Используйте структурированные выходы, инструкции системного приглашения или output_config.format вместо этого.
Кавычки параметра инструмента: Модели Claude 4.6 могут производить немного другое экранирование строк JSON в аргументах вызова инструмента (например, различная обработка экранирования Unicode или экранирования косой черты). Если вы анализируете input вызова инструмента как необработанную строку, а не используя парсер JSON, проверьте логику анализа. Стандартные парсеры JSON (такие как json.loads() или JSON.parse()) автоматически обрабатывают эти различия.
Это не требуется, но улучшит ваш опыт:
Миграция на адаптивное мышление: thinking: {type: "enabled", budget_tokens: N} устарел на моделях Claude 4.6 и будет удален в будущем выпуске модели. Переключитесь на thinking: {type: "adaptive"} и используйте параметр усилия для управления глубиной мышления. См. Адаптивное мышление.
response = client.beta.messages.create(
model="claude-opus-4-5",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 32000},
betas=["interleaved-thinking-2025-05-14"],
messages=[...],
)Обратите внимание, что миграция также переходит с client.beta.messages.create на client.messages.create. Адаптивное мышление и усилие — это функции GA и не требуют пространства имен бета-SDK или каких-либо бета-заголовков.
Удалите бета-заголовок усилия: Параметр усилия теперь GA. Удалите betas=["effort-2025-11-24"] из ваших запросов.
Удалите бета-заголовок потоковой передачи инструментов с точной детализацией: Потоковая передача инструментов с точной детализацией теперь GA. Удалите betas=["fine-grained-tool-streaming-2025-05-14"] из ваших запросов.
Удалите бета-заголовок чередующегося мышления (только Opus 4.6): Адаптивное мышление автоматически включает чередующееся мышление на Opus 4.6. Удалите betas=["interleaved-thinking-2025-05-14"] из ваших запросов Opus 4.6. Примечание: Sonnet 4.6 продолжает поддерживать этот бета-заголовок с ручным расширенным мышлением.
Миграция на output_config.format: Если вы используете структурированные выходы, обновите output_format={...} на output_config={"format": {...}}. Старый параметр остается функциональным, но устарел и будет удален в будущем выпуске модели.
Если вы выполняете миграцию с Opus 4.1, Sonnet 4 или более ранних моделей непосредственно на Claude 4.6, примените критические изменения Claude 4.6 выше плюс дополнительные изменения в этом разделе.
# С Opus 4.1
model = "claude-opus-4-1-20250805" # До
model = "claude-opus-4-6" # После
# С Sonnet 4
model = "claude-sonnet-4-20250514" # До
model = "claude-opus-4-6" # После
# С Sonnet 3.7
model = "claude-3-7-sonnet-20250219" # До
model = "claude-opus-4-6" # ПослеОбновите параметры выборки
Это критическое изменение при миграции с моделей Claude 3.x.
Используйте только temperature ИЛИ top_p, но не оба:
# До - это вызовет ошибку в моделях Claude 4+
response = client.messages.create(
model="claude-3-7-sonnet-20250219",
temperature=0.7,
top_p=0.9, # Невозможно использовать оба
# ...
)
# После
response = client.messages.create(
model="claude-opus-4-6",
temperature=0.7, # Используйте temperature ИЛИ top_p, но не оба
# ...
)Обновите версии инструментов
Это критическое изменение при миграции с моделей Claude 3.x.
Обновитесь до последних версий инструментов. Удалите любой код, использующий команду undo_edit.
# До
tools = [{"type": "text_editor_20250124", "name": "str_replace_editor"}]
# После
tools = [{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]text_editor_20250728 и str_replace_based_edit_tool. См. документацию инструмента текстового редактора для получения подробной информации.code_execution_20250825. См. документацию инструмента выполнения кода для инструкций по миграции.Обработайте причину остановки refusal
Обновите ваше приложение для обработки причин остановки refusal:
response = client.messages.create(...)
if response.stop_reason == "refusal":
# Обработайте отказ надлежащим образом
passОбработайте причину остановки model_context_window_exceeded
Модели Claude 4.5+ возвращают причину остановки model_context_window_exceeded когда генерация останавливается из-за достижения лимита контекстного окна, а не запрошенного лимита max_tokens. Обновите ваше приложение для обработки этой новой причины остановки:
response = client.messages.create(...)
if response.stop_reason == "model_context_window_exceeded":
# Обработайте лимит контекстного окна надлежащим образом
passПроверьте обработку параметров инструмента (конечные новые строки)
Модели Claude 4.5+ сохраняют конечные новые строки в параметрах строк вызова инструмента, которые ранее были удалены. Если ваши инструменты полагаются на точное совпадение строк с параметрами вызова инструмента, проверьте, что ваша логика правильно обрабатывает конечные новые строки.
Обновите ваши приглашения для поведенческих изменений
Модели Claude 4+ имеют более лаконичный, прямой стиль общения и требуют явного направления. Просмотрите лучшие практики подсказок для руководства по оптимизации.
token-efficient-tools-2025-02-19 и output-128k-2025-02-19. Все модели Claude 4+ имеют встроенное эффективное использование инструментов по токенам, и эти заголовки не имеют никакого эффекта.claude-opus-4-6output_config.format вместо этогоthinking: {type: "enabled", budget_tokens: N} на thinking: {type: "adaptive"} с параметром усилия (budget_tokens устарел и будет удален в будущем выпуске)effort-2025-11-24 (усилие теперь GA)fine-grained-tool-streaming-2025-05-14interleaved-thinking-2025-05-14 (только Opus 4.6; Sonnet 4.6 по-прежнему его поддерживает)output_format на output_config.format (если применимо)temperature ИЛИ top_ptext_editor_20250728, code_execution_20250825)refusalmodel_context_window_exceededtoken-efficient-tools-2025-02-19, output-128k-2025-02-19)Claude Sonnet 4.6 сочетает сильный интеллект с быстрой производительностью, с улучшенными возможностями агентского поиска и бесплатным выполнением кода при использовании с веб-поиском или веб-выборкой. Это идеально подходит для повседневного кодирования, анализа и задач создания контента.
Полный обзор возможностей см. в разделе обзор моделей.
Цена Sonnet 4.6 составляет $3 за миллион входных токенов, $15 за миллион выходных токенов. Подробности см. в разделе Цены Claude.
Обновите название модели:
# С Sonnet 4.5
model = "claude-sonnet-4-5" # До
model = "claude-sonnet-4-6" # После
# С Sonnet 4
model = "claude-sonnet-4-20250514" # До
model = "claude-sonnet-4-6" # ПослеПредзаполнение сообщений помощника больше не поддерживается
Это критическое изменение при миграции с Sonnet 4.5 или более ранней версии.
Предзаполнение сообщений помощника возвращает ошибку 400 на Sonnet 4.6. Используйте структурированные выходы, инструкции системного приглашения или output_config.format вместо этого.
Общие случаи использования предзаполнения и миграции:
Управление форматированием выходов (принудительный вывод JSON/YAML): Используйте структурированные выходы или инструменты с полями enum для задач классификации.
Исключение преамбул (удаление фраз "Вот..."): Добавьте прямые инструкции в системное приглашение: "Отвечайте прямо без преамбулы. Не начинайте с фраз вроде 'Вот...', 'На основе...', и т.д."
Избегание плохих отказов: Claude теперь намного лучше справляется с надлежащими отказами. Четкое формулирование в пользовательском сообщении без предзаполнения должно быть достаточным.
Продолжения (возобновление прерванных ответов): Переместите продолжение в пользовательское сообщение: "Ваш предыдущий ответ был прерван и закончился с [previous_response]. Продолжайте с того места, где вы остановились."
Гидратация контекста / согласованность роли (обновление контекста в длительных разговорах): Вместо этого внедрите то, что ранее было напоминаниями с предзаполненным помощником, в пользовательский ход.
Экранирование JSON параметра инструмента может отличаться
Это критическое изменение при миграции с Sonnet 4.5 или более ранней версии.
Экранирование строк JSON в параметрах инструмента может отличаться от предыдущих моделей. Стандартные парсеры JSON обрабатывают это автоматически, но пользовательский анализ на основе строк может потребовать обновлений.
Обновите параметры выборки
Это критическое изменение при миграции с моделей Claude 3.x.
Используйте только temperature ИЛИ top_p, но не оба.
Обновите версии инструментов
Это критическое изменение при миграции с моделей Claude 3.x.
Обновитесь до последних версий инструментов (text_editor_20250728, code_execution_20250825). Удалите любой код, использующий команду undo_edit.
Обработайте причину остановки refusal
Обновите ваше приложение для обработки причин остановки refusal.
Обновите ваши приглашения для поведенческих изменений
Модели Claude 4 имеют более лаконичный, прямой стиль общения. Просмотрите лучшие практики подсказок для руководства по оптимизации.
fine-grained-tool-streaming-2025-05-14 — Потоковая передача инструментов с точной детализацией теперь GA на Sonnet 4.6 и больше не требует бета-заголовка.output_format на output_config.format — Параметр output_format устарел. Используйте output_config.format вместо этого.Мы настоятельно рекомендуем выполнить миграцию с Sonnet 4.5 на Sonnet 4.6, который обеспечивает больший интеллект по той же цене.
Sonnet 4.6 по умолчанию имеет уровень усилия high, в отличие от Sonnet 4.5, который не имел параметра усилия. Мы рекомендуем отрегулировать параметр усилия при миграции с Sonnet 4.5 на Sonnet 4.6. Если не установлено явно, вы можете испытать более высокую задержку с уровнем усилия по умолчанию.
Если вы не используете расширенное мышление на Sonnet 4.5, вы можете продолжить без него на Sonnet 4.6. Вы должны явно установить усилие на уровень, подходящий для вашего случая использования. При low усилии с отключенным мышлением вы можете ожидать аналогичную или лучшую производительность по сравнению с Sonnet 4.5 без расширенного мышления.
response = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=8192,
output_config={"effort": "low"},
messages=[{"role": "user", "content": "Your prompt here"}],
)Если вы используете расширенное мышление на Sonnet 4.5, оно продолжает поддерживаться на Sonnet 4.6 без каких-либо изменений в конфигурации мышления. Мы рекомендуем сохранять бюджет мышления около 16k токенов. На практике большинство задач не используют столько, но это обеспечивает место для более сложных проблем без риска неконтролируемого использования токенов.
Для агентского кодирования, дизайна фронтенда, рабочих процессов, требующих много инструментов, и сложных корпоративных рабочих процессов, мы рекомендуем начать с medium усилия. Если вы обнаружите, что задержка слишком высока, рассмотрите возможность снижения усилия до low. Если вам нужен более высокий интеллект, рассмотрите возможность увеличения усилия до high или миграции на Opus 4.6.
response = client.beta.messages.create(
model="claude-sonnet-4-6",
max_tokens=16384,
thinking={"type": "enabled", "budget_tokens": 16384},
output_config={"effort": "medium"},
betas=["interleaved-thinking-2025-05-14"],
messages=[{"role": "user", "content": "Your prompt here"}],
)Для чата, создания контента, поиска, классификации и других задач, не связанных с кодированием, мы рекомендуем начать с low усилия с расширенным мышлением. Если вам нужна большая глубина, увеличьте усилие до medium.
response = client.beta.messages.create(
model="claude-sonnet-4-6",
max_tokens=8192,
thinking={"type": "enabled", "budget_tokens": 16384},
output_config={"effort": "low"},
betas=["interleaved-thinking-2025-05-14"],
messages=[{"role": "user", "content": "Your prompt here"}],
)Пути миграции выше используют расширенное мышление с budget_tokens для предсказуемого использования токенов. Если ваша рабочая нагрузка соответствует одному из следующих шаблонов, рассмотрите возможность попробовать адаптивное мышление вместо этого:
high усилия. Если задержка или использование токенов вызывает беспокойство, масштабируйте вниз до medium.При использовании адаптивного мышления оцените medium и high усилие на ваших задачах. Правильный уровень зависит от компромисса вашей рабочей нагрузки между качеством, задержкой и использованием токенов.
response = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=64000,
thinking={"type": "adaptive"},
output_config={"effort": "medium"},
messages=[{"role": "user", "content": "Your prompt here"}],
)Если вы видите непоследовательное поведение или регрессию качества с адаптивным мышлением, переключитесь на расширенное мышление с budget_tokens. Это обеспечивает более предсказуемые результаты с ограничением на стоимость мышления.
claude-sonnet-4-6output_config.format вместо этогоtext_editor_20250728, code_execution_20250825); устаревшие версии не поддерживаются (если выполняется миграция с 3.x)undo_edit (если применимо)temperature ИЛИ top_p, но не оба (если выполняется миграция с 3.x)refusal в вашем приложенииfine-grained-tool-streaming-2025-05-14 (теперь GA)output_format на output_config.formatClaude Sonnet 4.5 сочетает сильный интеллект с быстрой производительностью, что делает его идеальным для повседневного кодирования, анализа и задач создания контента.
Полный обзор возможностей см. в разделе обзор моделей.
Цена Sonnet 4.5 составляет $3 за миллион входных токенов, $15 за миллион выходных токенов. Подробности см. в разделе Цены Claude.
Обновите название модели:
# С Sonnet 4
model = "claude-sonnet-4-20250514" # До
model = "claude-sonnet-4-5-20250929" # После
# С Sonnet 3.7
model = "claude-3-7-sonnet-20250219" # До
model = "claude-sonnet-4-5-20250929" # ПослеЭти критические изменения применяются при миграции с моделей Claude 3.x Sonnet.
Обновите параметры выборки
Это критическое изменение при миграции с моделей Claude 3.x.
Используйте только temperature ИЛИ top_p, но не оба.
Обновите версии инструментов
Это критическое изменение при миграции с моделей Claude 3.x.
Обновитесь до последних версий инструментов (text_editor_20250728, code_execution_20250825). Удалите любой код, использующий команду undo_edit.
Обработайте причину остановки refusal
Обновите ваше приложение для обработки причин остановки refusal.
Обновите ваши приглашения для поведенческих изменений
Модели Claude 4 имеют более лаконичный, прямой стиль общения. Просмотрите лучшие практики подсказок для руководства по оптимизации.
claude-sonnet-4-5-20250929text_editor_20250728, code_execution_20250825); устаревшие версии не поддерживаются (если выполняется миграция с 3.x)undo_edit (если применимо)temperature ИЛИ top_p, но не оба (если выполняется миграция с 3.x)refusal в вашем приложенииClaude Haiku 4.5 — это самый быстрый и самый интеллектуальный модель Haiku с производительностью, близкой к границе, обеспечивающий качество премиум-модели для интерактивных приложений и высокообъемной обработки.
Полный обзор возможностей см. в разделе обзор моделей.
Цена Haiku 4.5 составляет $1 за миллион входных токенов, $5 за миллион выходных токенов. Подробности см. в разделе Цены Claude.
Обновите название модели:
# С Haiku 3.5
model = "claude-3-5-haiku-20241022" # До
model = "claude-haiku-4-5-20251001" # ПослеПросмотрите новые ограничения скорости: Haiku 4.5 имеет отдельные ограничения скорости от Haiku 3.5. Подробности см. в документации по ограничениям скорости.
Для значительного улучшения производительности при кодировании и задачах рассуждения рассмотрите возможность включения расширенного мышления с thinking: {type: "enabled", budget_tokens: N}.
Расширенное мышление влияет на эффективность кэширования приглашений.
Расширенное мышление устарело в Claude 4.6 или более новых моделях. Если вы используете более новые модели, используйте адаптивное мышление вместо этого.
Изучите новые возможности: Подробности см. в разделе обзор моделей о контекстной осведомленности, увеличенной емкости выходов (64K токенов), более высоком интеллекте и улучшенной скорости.
Эти критические изменения применяются при миграции с моделей Claude 3.x Haiku.
Обновите параметры выборки
Это критическое изменение при миграции с моделей Claude 3.x.
Используйте только temperature ИЛИ top_p, но не оба.
Обновите версии инструментов
Это критическое изменение при миграции с моделей Claude 3.x.
Обновитесь до последних версий инструментов (text_editor_20250728, code_execution_20250825). Удалите любой код, использующий команду undo_edit.
Обработайте причину остановки refusal
Обновите ваше приложение для обработки причин остановки refusal.
Обновите ваши приглашения для поведенческих изменений
Модели Claude 4 имеют более лаконичный, прямой стиль общения. Просмотрите лучшие практики подсказок для руководства по оптимизации.
claude-haiku-4-5-20251001text_editor_20250728, code_execution_20250825); устаревшие версии не поддерживаютсяundo_edit (если применимо)temperature ИЛИ top_p, но не обаrefusal в вашем приложенииWas this page helpful?