Модели и ценыМодели

Руководство по миграции

Руководство по миграции на новейшие модели Claude с предыдущих версий Claude

Это руководство описывает миграцию кода, использующего Messages API. Если вы используете Claude Managed Agents, никаких изменений, кроме обновления имени модели, не требуется.

Автоматизируйте миграцию с помощью навыка Claude API. В Claude Code выполните /claude-api migrate, чтобы вызвать встроенный навык Claude API. Он работает для любой целевой модели на этой странице:

/claude-api migrate this project to claude-opus-4-8

Навык выполняет замену идентификатора модели и, при необходимости, вносит критические изменения параметров, заменяет prefill и калибрует effort для вашей целевой модели по всей кодовой базе, а затем формирует контрольный список пунктов для ручной проверки. Перед редактированием каких-либо файлов он просит вас подтвердить область миграции (весь рабочий каталог, подкаталог или конкретный список файлов). Навык также обнаруживает клиенты Amazon Bedrock, Google Cloud, Claude Platform on AWS и Microsoft Foundry и корректирует форматы идентификаторов моделей и изменения функций для каждой платформы.

Миграция с Claude Mythos Preview на Claude Mythos 5

Claude Mythos 5 — это преемник с ограниченным доступом для Claude Mythos Preview, исследовательской предварительной версии, доступной только по приглашениям. Общедоступную модель с теми же возможностями см. в разделе Claude Fable 5.

Миграция в основном сводится к простой замене. Claude Mythos 5 использует тот же Messages API и те же паттерны использования инструментов, что и Claude Mythos Preview, а количество токенов практически не меняется, поскольку обе модели используют один и тот же токенизатор. Ключевые изменения, которые следует проверить, — это функции, которые больше недоступны (перечислены в следующем разделе), и вывод мышления.

График вывода из эксплуатации Claude Mythos Preview см. в разделе Устаревание моделей.

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

model = "claude-mythos-preview"  # Before
model = "claude-mythos-5"  # After

Функции, недоступные в Claude Mythos 5

Расширенное мышление и бюджеты токенов мышления: Ручное расширенное мышление (thinking: {type: "enabled", budget_tokens: N}) не поддерживается в claude-mythos-5 и возвращает ошибку 400. Адаптивное мышление всегда включено: модель сама определяет, когда и сколько думать при каждом запросе, и конфигурация thinking не требуется. thinking: {type: "disabled"} возвращает ошибку. У budget_tokens нет прямой замены: мышление адаптивно, а параметр effort — это отдельный элемент управления на уровне вывода, а не бюджет мышления.

До (Claude Mythos Preview):
```
client.messages.create(
    model="claude-mythos-preview",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[{"role": "user", "content": "..."}],
)
```
После (Claude Mythos 5):
```
client.messages.create(
    model="claude-mythos-5",
    max_tokens=16000,
    messages=[{"role": "user", "content": "..."}],
)
```
Предзаполнение ассистента (assistant prefill): Предзаполнение сообщения ассистента не поддерживается в claude-mythos-5 и возвращает ошибку 400, так же как и в Claude Mythos Preview. Вместо этого используйте инструкции в системной подсказке.
Вывод мышления: В claude-mythos-5 необработанная цепочка рассуждений никогда не возвращается, но блоки мышления по-прежнему содержат читаемый обобщённый текст, когда thinking.display установлен в summarized. Передавайте блоки мышления обратно без изменений при продолжении разговора на той же модели. См. Вывод мышления в Claude Fable 5 и Claude Mythos 5.

Подсчёт токенов и тарификация

claude-mythos-5 использует тот же токенизатор, что и claude-mythos-preview (токенизатор, представленный в Claude Opus 4.7). Количество токенов практически не меняется при миграции с claude-mythos-preview. По сравнению с моделями до Claude Opus 4.7 тот же контент может токенизироваться примерно в 30% больше токенов, в зависимости от содержимого и характера рабочей нагрузки.

/v1/messages/count_tokens возвращает практически неизменные значения для claude-mythos-5 по сравнению с claude-mythos-preview. Заново определите базовые показатели стоимости и задержки на ваших собственных рабочих нагрузках.

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

Обновите имя модели с claude-mythos-preview на claude-mythos-5.
Удалите конфигурацию ручного расширенного мышления (thinking: {type: "enabled", budget_tokens: N}). Адаптивное мышление всегда включено, и поле thinking не требуется.
Удалите любую конфигурацию thinking: {type: "disabled"}. Отключение мышления возвращает ошибку в claude-mythos-5.
Удалите budget_tokens. У него нет прямой замены: мышление адаптивно, а параметр effort — это отдельный элемент управления на уровне вывода, а не бюджет мышления.
Убедитесь, что любой код, который разбирает поле thinking, обрабатывает его только как отображаемый текст и передаёт блоки мышления обратно без изменений при продолжении на той же модели. thinking.display по умолчанию имеет значение "omitted" в claude-mythos-5, так же как и в Claude Mythos Preview; установите display: "summarized", чтобы получать читаемые сводки. См. Вывод мышления в Claude Fable 5 и Claude Mythos 5.
Если вы воспроизводите историю разговора на другой модели, сначала удалите блоки thinking и redacted_thinking из предыдущих ходов ассистента. Блоки мышления из claude-mythos-5 привязаны к модели, которая их создала, и модели, отличные от Claude Fable 5 и Claude Mythos 5, молча игнорируют их. Удаление делает кросс-модельные запросы минимальными и единообразными.
Заново определите базовые показатели количества токенов и стоимости на ваших собственных рабочих нагрузках. Количество токенов практически не меняется при миграции с claude-mythos-preview.

Миграция с Claude Opus 4.8 на Claude Fable 5

Claude Fable 5 — самая мощная широко выпущенная модель Anthropic, общедоступная в Claude API, Claude Platform on AWS, Amazon Bedrock, Google Cloud и Microsoft Foundry.

Миграция в основном сводится к простой замене. Claude Fable 5 использует тот же Messages API и те же паттерны использования инструментов, что и Claude Opus 4.8. Она поддерживает то же контекстное окно в 1 млн токенов по умолчанию и те же 128 тыс. максимальных выходных токенов. Количество токенов практически не меняется, поскольку обе модели используют один и тот же токенизатор.

Ключевые изменения, которые следует проверить, — это всегда включённое адаптивное мышление, вывод мышления, отказы классификатора безопасности и ценообразование. Раздел Перед миграцией описывает ценообразование и хранение данных; раздел Что изменилось описывает остальное.

Перед миграцией

Стоимость Claude Fable 5 составляет $10 за миллион входных токенов и $50 за миллион выходных токенов, по сравнению с $5 и $25 для Claude Opus 4.8. Подробности см. в разделе Цены на Claude.

Claude Fable 5 требует 30-дневного хранения данных и недоступна в рамках соглашений о нулевом хранении данных (ZDR); она обозначена как Covered Model (покрываемая модель). В Claude API запрос от организации, конфигурация хранения данных которой не соответствует этому требованию, возвращает ошибку 400 invalid_request_error. Организациям с соглашением ZDR следует связаться со своей командой по работе с клиентами Anthropic, чтобы обсудить конфигурацию хранения данных; Claude Opus 4.8 остаётся доступной в рамках ZDR. В качестве альтернативы вы можете настроить хранение данных для каждого рабочего пространства. Требование 30-дневного хранения данных применяется на каждой платформе, где предлагается Claude Fable 5; подробности по каждой платформе см. в разделе Требования к хранению данных для конкретных моделей.

Если ваш код работает на Claude Opus 4.7 или более ранней версии, сначала примените раздел Миграция с Claude Opus 4.7 на Claude Opus 4.8 и, для моделей более ранних, чем Claude Opus 4.7, шаги миграции на Claude Opus 4.7. Эти разделы описывают критические изменения (отклонение параметров сэмплирования, отклонение ручного расширенного мышления, удаление prefill, новый токенизатор), которые данный раздел не повторяет.

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

model = "claude-opus-4-8"  # Before
model = "claude-fable-5"  # After

Что изменилось

Пункты в этом разделе описывают различия в API и поведении, которые стоит проверить после замены идентификатора модели.

Адаптивное мышление всегда включено: Адаптивное мышление — единственный режим мышления в claude-fable-5. Модель сама определяет, когда и сколько думать при каждом запросе, и конфигурация thinking не требуется. thinking: {type: "disabled"} возвращает ошибку. Используйте параметр effort для управления глубиной мышления.

Изменение поведения, которое следует проверить: в Claude Opus 4.8 запросы без поля thinking выполняются без мышления; в claude-fable-5 те же запросы выполняются с адаптивным мышлением. max_tokens остаётся жёстким ограничением на общий вывод — мышление плюс текст ответа, — поэтому пересмотрите его для рабочих нагрузок, которые выполнялись без мышления в Claude Opus 4.8. См. Контроль затрат.

До (Claude Opus 4.8):
```
client.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "..."}],
)
```
После (Claude Fable 5):
```
client.messages.create(
    model="claude-fable-5",
    max_tokens=16000,
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "..."}],
)
```
Расширенное мышление и бюджеты мышления (без изменений): Ручное расширенное мышление (thinking: {type: "enabled", budget_tokens: N}) не поддерживается в claude-fable-5 и возвращает ошибку 400, так же как и в Claude Opus 4.8. У budget_tokens нет прямой замены: мышление адаптивно, а параметр effort — это отдельный элемент управления на уровне вывода, а не бюджет мышления.
Предзаполнение ассистента (без изменений): Предзаполнение сообщения ассистента не поддерживается в claude-fable-5 и возвращает ошибку 400, так же как и в Claude Opus 4.8. Вместо этого используйте инструкции в системной подсказке.
Вывод мышления: В claude-fable-5 необработанная цепочка рассуждений никогда не возвращается, но блоки мышления по-прежнему содержат читаемый обобщённый текст, когда thinking.display установлен в summarized. Передавайте блоки мышления обратно без изменений при продолжении разговора на той же модели. См. Вывод мышления в Claude Fable 5 и Claude Mythos 5.
Классификаторы безопасности и причина остановки refusal: claude-fable-5 запускает классификаторы безопасности для запросов и во время генерации ответа. Когда классификатор отклоняет запрос, Messages API возвращает stop_reason: "refusal" как успешный HTTP-ответ 200, а не ошибку. Поле stop_details.category сообщает, какой классификатор сработал, с категориями, такими как "cyber", "bio" и "reasoning_extraction", или null, когда отказ не соответствует ни одной именованной категории. Полный набор см. в таблице категорий отказов.

Вам не выставляется счёт за входные токены запроса, отклонённого до генерации какого-либо вывода. Когда классификатор срабатывает в середине потока, входные и уже переданные выходные токены тарифицируются; отбросьте частичный вывод.

Чтобы автоматически повторно выполнять отклонённые запросы на другой модели, передайте опциональный параметр fallbacks, который находится в бета-версии в Claude API и Claude Platform on AWS. Параметр недоступен в Message Batches API, а также в Amazon Bedrock, Google Cloud и Microsoft Foundry; на этих трёх платформах выполняйте повторную попытку на стороне клиента или используйте промежуточное ПО SDK для резервного варианта при отказе (refusal-fallback middleware). См. Обработка причин остановки.
Начинайте с уровня effort high: Значение по умолчанию для параметра effort остаётся high. В Claude Opus 4.8 рекомендация для программирования и работы с высокой автономностью — явно устанавливать xhigh. В claude-fable-5 используйте high по умолчанию для большинства задач и резервируйте xhigh для наиболее требовательных к возможностям рабочих нагрузок. Более низкие настройки effort в claude-fable-5 по-прежнему работают хорошо и часто превосходят производительность xhigh на предыдущих моделях. Снижайте effort, если задача выполняется, но занимает больше времени, чем необходимо. См. Создание подсказок для Claude Fable 5.
Сниженный минимум для кэширования подсказок: Минимальная длина кэшируемой подсказки в claude-fable-5 составляет 512 токенов, что ниже 1 024 токенов в Claude Opus 4.8. Подсказки, которые были слишком короткими для кэширования в Claude Opus 4.8, теперь могут создавать записи кэша без каких-либо изменений кода. В Amazon Bedrock минимум для claude-fable-5 составляет 1 024 токена. Минимумы для каждой модели см. в разделе Кэширование подсказок.

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

Если у вашей организации есть соглашение о нулевом хранении данных (ZDR), подтвердите соответствие требованиям перед миграцией. claude-fable-5 требует 30-дневного хранения данных и в Claude API в противном случае возвращает ошибку 400 invalid_request_error. См. Требования к хранению данных для конкретных моделей.
Обновите имя модели с claude-opus-4-8 на claude-fable-5.
Удалите любую конфигурацию thinking: {type: "disabled"}. Отключение мышления возвращает ошибку в claude-fable-5, а запросы без поля thinking выполняются с адаптивным мышлением.
Если вы удалили ручное расширенное мышление и предзаполнения ассистента во время предыдущих миграций, никаких действий не требуется: оба остаются неподдерживаемыми в claude-fable-5.
Убедитесь, что любой код, который разбирает поле thinking, обрабатывает его только как отображаемый текст и передаёт блоки мышления обратно без изменений при продолжении на той же модели. thinking.display по умолчанию имеет значение "omitted" в claude-fable-5, так же как и в Claude Opus 4.8; установите display: "summarized", чтобы получать читаемые сводки. См. Вывод мышления в Claude Fable 5 и Claude Mythos 5.
Если вы воспроизводите историю разговора на другой модели, сначала удалите блоки thinking и redacted_thinking из предыдущих ходов ассистента. Блоки мышления из claude-fable-5 привязаны к модели, которая их создала, и модели, отличные от Claude Fable 5 и Claude Mythos 5, молча игнорируют их. Удаление делает кросс-модельные запросы минимальными и единообразными. Исключение составляет погашение резервного кредита (fallback credit), которое требует тела запроса, воспроизведённого в точном соответствии с правилами этой функции.
Обрабатывайте stop_reason: "refusal" и читайте поле stop_details.category. Чтобы автоматически повторно выполнять отклонённые запросы на другой модели, рассмотрите опциональный параметр fallbacks (бета). См. Обработка причин остановки.
Пересмотрите вашу настройку effort. Начинайте с high для большинства задач, включая рабочие нагрузки, которые выполнялись на xhigh в Claude Opus 4.8.
Заново определите базовые показатели стоимости и задержки на ваших собственных рабочих нагрузках. Количество токенов практически не меняется при миграции с claude-opus-4-8; цена за токен отличается.

Миграция с Claude Opus 4.7 на Claude Opus 4.8

Claude Opus 4.8 создана для сложного агентного программирования и корпоративной работы. Она основана на Claude Opus 4.7.

Claude Opus 4.8 должна демонстрировать высокую производительность «из коробки» на существующих подсказках и оценках Claude Opus 4.7. Критических изменений API для кода, уже работающего на Claude Opus 4.7, нет. Она поддерживает тот же набор функций, что и Claude Opus 4.7, включая контекстное окно в 1 млн токенов, 128 тыс. максимальных выходных токенов, адаптивное мышление, кэширование подсказок, пакетную обработку, Files API, поддержку PDF, компьютерное зрение и полный набор серверных и клиентских инструментов. Она также добавляет системные сообщения в середине разговора и публично документирует детали остановки при отказе.

Если ваш код работает на Claude Opus 4.6 или более ранней версии, также примените шаги миграции на Claude Opus 4.7 ниже перед обновлением до Claude Opus 4.8. Эти шаги включают критические изменения (отклонение параметров сэмплирования, отклонение ручного расширенного мышления, новый токенизатор), которые само по себе обновление до 4.8 не охватывает.

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

# Миграция на Opus
model = "claude-opus-4-7"  # Before
model = "claude-opus-4-8"  # After

Что изменилось

Это не критические изменения. Код, работающий на Claude Opus 4.7, продолжает работать без изменений на Claude Opus 4.8. Пункты ниже описывают различия в поведении, которые стоит проверить после замены идентификатора модели.

Параметры сэмплирования (без изменений): Установка temperature, top_p или top_k в значение, отличное от значения по умолчанию, возвращает ошибку 400 в Claude Opus 4.8, так же как и в Claude Opus 4.7. Типы запросов SDK по-прежнему определяют эти поля для совместимости с более ранними моделями, поэтому код, который их устанавливает, проходит проверку типов, но API отклоняет запрос на стороне сервера. Если вы удалили эти параметры при миграции на Opus 4.7, дальнейших изменений не требуется.
Значение effort по умолчанию — high: Значение по умолчанию для параметра effort в Claude Opus 4.8 — high на всех поверхностях, включая Claude Code и Messages API. Если вы уже устанавливаете effort явно, ваша настройка не изменится. Для программирования и работы с высокой автономностью явно устанавливайте xhigh. Пересмотрите вашу настройку effort с учётом вашего бюджета задержки и стоимости.
Контекстное окно в 1 млн токенов по умолчанию: Claude Opus 4.8 предоставляет полное контекстное окно в 1 млн токенов по умолчанию без бета-заголовка и без надбавки за длинный контекст. Если ваш клиент передаёт бета-заголовок контекстного окна для совместимости со старыми моделями, вы можете удалить его в Claude Opus 4.8.
Системные сообщения в середине разговора: Claude Opus 4.8 принимает сообщения с role: "system" сразу после хода пользователя в массиве messages (с учётом правил размещения). Используйте поле верхнего уровня system для инструкций, которые применяются с самого начала. Более ранние модели, включая Claude Opus 4.7, отклоняют role: "system" в messages с ошибкой 400. Если вы поддерживаете пути кода, которые перестраивают полную историю сообщений для обновления инструкций, вы можете упростить их и сохранить попадания в кэш подсказок для более ранних ходов.
Детали остановки при отказе: Объект stop_details в ответах с отказом (доступный начиная с Claude Opus 4.7) теперь публично задокументирован. Когда модель отклоняет запрос, она идентифицирует категорию отказа в дополнение к существующей причине остановки refusal. Бета-заголовок не требуется, и отказаться от этого нельзя. См. Обработка причин остановки.
Сниженный минимум для кэширования подсказок: Минимальная длина кэшируемой подсказки в Claude Opus 4.8 составляет 1 024 токена, что ниже, чем в Claude Opus 4.7. Подсказки, которые были слишком короткими для кэширования в Claude Opus 4.7, теперь могут создавать записи кэша без каких-либо изменений кода. Минимумы для каждой модели см. в разделе Кэширование подсказок.
Перекалиброванные уровни effort: Распределение токенов за каждым уровнем effort изменяется в Claude Opus 4.8 по сравнению с Claude Opus 4.7: medium допускает несколько больше мышления, high — несколько меньше, а xhigh — существенно больше. Если вы настраивали уровень effort под стоимость или задержку Claude Opus 4.7, заново определите базовые показатели на том же уровне, прежде чем корректировать его. См. Effort.

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

Обновите имя модели с claude-opus-4-7 на claude-opus-4-8 (или обновите псевдонимы).
Если вы удалили параметры сэмплирования во время миграции на Opus 4.7, никаких действий не требуется. Если вы добавили их обратно с путём повторной попытки при ошибке 400, удалите этот путь повторной попытки.
Пересмотрите вашу настройку effort. Значение по умолчанию — high на всех поверхностях; для программирования и работы с высокой автономностью явно устанавливайте xhigh.
Удалите любой бета-заголовок контекстного окна. Контекстное окно в 1 млн токенов является значением по умолчанию в Claude API, Amazon Bedrock, Google Cloud и Microsoft Foundry.
Если вы перестраиваете историю разговора для обновления инструкций, рассмотрите переход на системное сообщение в середине разговора, чтобы сохранить попадания в кэш подсказок.
Убедитесь, что ваша обработка причин остановки читает stop_details при отказах (доступно начиная с Claude Opus 4.7; теперь публично задокументировано).
Заново определите базовые показатели стоимости и задержки на выбранном вами уровне effort.

Миграция на Claude Opus 4.7

Claude Opus 4.7 обладает высокой автономностью и исключительно хорошо справляется с долгосрочной агентной работой, работой со знаниями, задачами компьютерного зрения и задачами памяти.

Claude Opus 4.7 должна демонстрировать высокую производительность «из коробки» на существующих подсказках и оценках Claude Opus 4.6 по той же цене $5 / $25 за MTok, но есть несколько изменений в поведении и API, о которых стоит знать при миграции. Она поддерживает тот же набор функций, что и Claude Opus 4.6, включая:

Контекстное окно в 1 млн токенов по стандартным ценам API без надбавки за длинный контекст
128 тыс. максимальных выходных токенов
Адаптивное мышление
Кэширование подсказок
Пакетная обработка
Files API
Поддержка PDF
Компьютерное зрение
Полный набор серверных и клиентских инструментов (bash, выполнение кода, использование компьютера, текстовый редактор, веб-поиск, веб-загрузка, коннектор MCP, память)

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

# Миграция на Opus
model = "claude-opus-4-6"  # Before
model = "claude-opus-4-7"  # After

Критические изменения

Расширенное мышление удалено: thinking: {type: "enabled", budget_tokens: N} больше не поддерживается в Claude Opus 4.7 и более поздних моделях и возвращает ошибку 400. Переключитесь на адаптивное мышление (thinking: {type: "adaptive"}) и используйте параметр effort для управления глубиной мышления. Адаптивное мышление выключено по умолчанию в Claude Opus 4.7: запросы без поля thinking выполняются без мышления, что соответствует поведению Opus 4.6. Явно установите thinking: {type: "adaptive"}, чтобы включить его.

До (Claude Opus 4.6):
```
client.messages.create(
    model="claude-opus-4-6",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[{"role": "user", "content": "..."}],
)
```
После (Claude Opus 4.7):
```
client.messages.create(
    model="claude-opus-4-7",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},  # or "max", "xhigh", "medium", "low"
    messages=[{"role": "user", "content": "..."}],
)
```
Адаптивное мышление управляется через подсказки. Рекомендации по настройке, когда модель думает слишком много или слишком мало, см. в разделе Калибровка effort и глубины мышления.
Параметры сэмплирования удалены: Установка temperature, top_p или top_k в любое значение, отличное от значения по умолчанию, в Claude Opus 4.7 возвращает ошибку 400. Самый безопасный путь миграции — полностью исключить эти параметры из полезной нагрузки запроса. Подсказки — рекомендуемый способ управления поведением модели в Claude Opus 4.7. Если вы использовали temperature = 0 для детерминизма, обратите внимание, что это никогда не гарантировало идентичные выходные данные на предыдущих моделях.
Содержимое мышления по умолчанию опущено: Блоки мышления по-прежнему появляются в потоке ответа в Claude Opus 4.7, но их поле thinking пусто, если вы явно не включите его. Это незаметное изменение по сравнению с Claude Opus 4.6, где по умолчанию возвращался обобщённый текст мышления. Чтобы восстановить обобщённое содержимое мышления в Claude Opus 4.7, установите thinking.display в "summarized":
```
thinking = {
    "type": "adaptive",
    "display": "summarized",
}
```
Значение по умолчанию — "omitted" в Claude Opus 4.7. Если ваш продукт передаёт рассуждения пользователям в потоковом режиме, новое значение по умолчанию выглядит как длинная пауза перед началом вывода; установите display: "summarized", чтобы восстановить видимый прогресс во время мышления. Подробности см. в разделе Расширенное мышление.
Обновлённый подсчёт токенов: Claude Opus 4.7 использует новый токенизатор, что способствует её улучшенной производительности в широком спектре задач. Новый токенизатор может использовать примерно от 1x до 1,35x токенов при обработке текста по сравнению с предыдущими моделями (до ~35% больше, в зависимости от содержимого).

/v1/messages/count_tokens будет возвращать другое количество токенов для Claude Opus 4.7, чем для Claude Opus 4.6. Эффективность токенов может варьироваться в зависимости от характера рабочей нагрузки.

Вмешательства через подсказки, task_budget и effort могут помочь контролировать затраты и обеспечить надлежащее использование токенов. Эти элементы управления могут снижать интеллект модели. Обновите ваши параметры max_tokens, чтобы обеспечить дополнительный запас, включая триггеры сжатия. Claude Opus 4.7 предоставляет контекстное окно в 1 млн токенов по стандартным ценам API без надбавки за длинный контекст.
Удаление prefill (перенесено из Opus 4.6): Предзаполнение сообщений ассистента возвращает ошибку 400 в Claude Opus 4.7. Вместо этого используйте структурированные выходные данные, инструкции в системной подсказке или output_config.format.

Выбор уровня effort

Параметр effort позволяет вам настраивать соотношение интеллекта Claude и расхода токенов, обменивая возможности на более высокую скорость и более низкие затраты. Начните с нового уровня effort xhigh для сценариев программирования и агентных сценариев использования и используйте минимум high для большинства сценариев, чувствительных к интеллекту. Экспериментируйте с другими уровнями effort для дальнейшей настройки использования токенов и интеллекта:

max: Максимальный effort может обеспечить прирост производительности в некоторых сценариях использования, но может демонстрировать убывающую отдачу от увеличенного использования токенов. Эта настройка также иногда может быть склонна к избыточному мышлению. Тестируйте максимальный effort для задач, требующих высокого интеллекта.
xhigh (новый): Очень высокий effort — лучшая настройка для большинства сценариев программирования и агентных сценариев использования.
high: Эта настройка балансирует использование токенов и интеллект. Для большинства сценариев, чувствительных к интеллекту, используйте минимум high.
medium: Подходит для сценариев, чувствительных к стоимости, которым необходимо снизить использование токенов, жертвуя при этом интеллектом.
low: Резервируйте для коротких, ограниченных по объёму задач и рабочих нагрузок, чувствительных к задержке, которые не чувствительны к интеллекту.

Effort важнее для этой модели, чем для любой предыдущей Opus. Активно экспериментируйте с ним при обновлении.

Изменения в поведении

Claude Opus 4.7 имеет несколько поведенческих отличий от Claude Opus 4.6, которые не являются критическими изменениями API, но могут потребовать обновления подсказок или удаления вспомогательной обвязки.

Длина ответа варьируется в зависимости от сценария использования: Claude Opus 4.7 калибрует длину ответа в соответствии с тем, насколько сложной он считает задачу, вместо того чтобы по умолчанию придерживаться фиксированной многословности. Обычно это означает более короткие ответы на простые запросы и значительно более длинные — на открытый анализ.

Если ваш продукт зависит от определённого стиля или многословности вывода, вам может потребоваться настроить подсказки. Например, чтобы уменьшить многословность, добавьте: «Давай краткие, сфокусированные ответы. Пропускай несущественный контекст и сводите примеры к минимуму». Если вы замечаете конкретные виды избыточных объяснений, добавьте в подсказку целевые инструкции для их предотвращения.

Положительные примеры, показывающие, как Claude может общаться с надлежащим уровнем лаконичности, как правило, более эффективны, чем отрицательные примеры или инструкции, указывающие модели, чего не следует делать.
Более буквальное следование инструкциям: Claude Opus 4.7 интерпретирует подсказки более буквально и явно, чем Claude Opus 4.6, особенно на более низких уровнях усилий. Он не будет молча обобщать инструкцию с одного элемента на другой и не будет делать выводы о запросах, которые вы не делали. Преимущество такой буквальности — точность и меньше лишних итераций. Как правило, он работает лучше для сценариев использования API с тщательно настроенными подсказками, структурированным извлечением и конвейерами, где требуется предсказуемое поведение. Пересмотр подсказок и обвязки может быть особенно полезен при миграции на Claude Opus 4.7.
Более прямой тон: Как и в случае с любой новой моделью, стиль прозы в длинных текстах может измениться. Claude Opus 4.7 более прямолинеен и категоричен, с меньшим количеством одобрительных формулировок и меньшим количеством эмодзи по сравнению с более тёплым стилем Claude Opus 4.6. Если ваш продукт полагается на определённый голос, переоцените стилевые подсказки относительно нового базового уровня.
Встроенные обновления о ходе выполнения в агентных трассировках: Claude Opus 4.7 предоставляет пользователю более регулярные и качественные обновления на протяжении длинных агентных трассировок. Если вы добавили обвязку для принудительного вывода промежуточных сообщений о статусе («После каждых 3 вызовов инструментов подводи итог прогресса»), попробуйте её удалить. Если вы обнаружите, что длина или содержание обновлений Claude Opus 4.7 для пользователя плохо откалиброваны под ваш сценарий использования, явно опишите в подсказке, как должны выглядеть эти обновления, и приведите примеры.
Меньше порождаемых субагентов по умолчанию: Claude Opus 4.7 по умолчанию склонен порождать меньше субагентов. Однако этим поведением можно управлять через подсказки; дайте Claude Opus 4.7 явные указания о том, когда субагенты желательны.
Более строгая калибровка усилий: Существенно отличаясь от Claude Opus 4.6, Claude Opus 4.7 строго соблюдает уровни усилий, особенно на нижнем конце диапазона. На уровнях low и medium модель ограничивает свою работу тем, что было запрошено, не выходя за рамки.

Это хорошо для задержки и стоимости, но на умеренно сложных задачах, выполняемых с усилием low, есть некоторый риск недостаточного обдумывания. Если вы наблюдаете поверхностные рассуждения на сложных проблемах, повысьте усилие до high или xhigh вместо того, чтобы обходить это через подсказки.

Если вам нужно сохранить усилие на уровне low ради задержки, добавьте целевое указание: «Эта задача включает многошаговые рассуждения. Тщательно обдумай проблему, прежде чем отвечать». См. Рекомендуемые уровни усилий для Claude Opus 4.7.
Меньше вызовов инструментов по умолчанию: Claude Opus 4.7 склонен использовать инструменты реже, чем Claude Opus 4.6, и больше полагаться на рассуждения. В большинстве случаев это даёт лучшие результаты.

Чтобы увеличить использование инструментов, повысьте настройку усилий. Настройки усилий high или xhigh демонстрируют существенно большее использование инструментов в агентном поиске и кодировании. Вы также можете скорректировать подсказку, чтобы явно проинструктировать модель о том, когда и как правильно использовать её инструменты.
Защитные меры кибербезопасности в реальном времени: Впервые добавленные в Claude Opus 4.7, запросы, затрагивающие запрещённые или высокорисковые темы, могут приводить к отказам. Для легитимной работы в области безопасности, такой как тестирование на проникновение, исследование уязвимостей или red-teaming, подайте заявку в Cyber Verification Program, чтобы запросить снижение ограничений. См. Защитные меры, предупреждения и апелляции для справки.
Поддержка изображений высокого разрешения: Claude Opus 4.7 — первая модель Claude с поддержкой изображений высокого разрешения. Максимальное разрешение изображения составляет 2576 пикселей по длинной стороне, по сравнению с 1568 пикселями в предыдущих моделях. Это открывает преимущества для рабочих нагрузок с интенсивным использованием зрения и особенно ценно для управления компьютером, понимания скриншотов и анализа документов.

Поддержка высокого разрешения работает автоматически и не требует бета-заголовка или включения на стороне клиента. Следует учесть два момента:
- Изображения в полном разрешении могут использовать примерно до 3 раз больше токенов изображений, чем в предыдущих моделях (до 4 784 токенов на изображение по сравнению с предыдущим пределом примерно в 1 600 токенов на изображение). Пересмотрите бюджет max_tokens и ожидания по стоимости для рабочих нагрузок с большим количеством изображений или уменьшите разрешение перед отправкой, если вам не нужна дополнительная детализация.
- Координаты указания и ограничивающих рамок, возвращаемые моделью, соответствуют фактическим пикселям изображения в соотношении 1:1 в Claude Opus 4.7, поэтому преобразование масштабного коэффициента не требуется.
См. Поддержка изображений высокого разрешения в Claude Opus 4.7 для подробностей.

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

Обновите имя модели с claude-opus-4-6 на claude-opus-4-7 (или обновите псевдонимы).
Удалите temperature, top_p и top_k из полезных нагрузок запросов.
Замените thinking: {type: "enabled", budget_tokens: N} на thinking: {type: "adaptive"} плюс параметр effort.
Удалите любые предзаполнения сообщений ассистента.
Если ваш пользовательский интерфейс отображает содержимое мышления, явно включите суммаризацию мышления.
Повторно измерьте сквозную стоимость и задержку с учётом обновлённой токенизации.
Перенастройте max_tokens с учётом обновлённой токенизации.
Повторно протестируйте любые оценки количества токенов на стороне клиента.
Если ваше приложение отправляет изображения, пересмотрите бюджет с учётом поддержки изображений высокого разрешения (примерно до 3 раз больше токенов изображений на изображение в полном разрешении). Уменьшите разрешение перед отправкой, если вам не нужна дополнительная детализация.
Если вы используете координаты указания или ограничивающих рамок от модели, удалите любое преобразование масштабного коэффициента; координаты соответствуют фактическим пикселям изображения в соотношении 1:1 в Claude Opus 4.7.
Пересмотрите подсказки с учётом описанных выше изменений поведения (длина ответа, буквальность, тон, обновления о ходе выполнения, субагенты, калибровка усилий, запуск инструментов, защитные меры кибербезопасности, обработка изображений высокого разрешения).
Заново определите базовую длину ответа, удалив существующие подсказки управления длиной, затем настройте явно.
При использовании усилия xhigh или max повысьте max_tokens как минимум до 64 тыс. в качестве отправной точки.
Рассмотрите внедрение бюджетов задач (бета) для агентных рабочих процессов.
Если ваш продукт выполняет легитимную работу в области безопасности, подайте заявку в Cyber Verification Program для доступа к сниженным ограничениям на контент по кибербезопасности.

Миграция на Claude Opus 4.7 с Opus 4.5 или более ранних версий

Если вы мигрируете с Claude Opus 4.5, Opus 4.1 (устаревшая) или более ранней модели напрямую на Claude Opus 4.7, примените все изменения Opus 4.7 плюс накопительные изменения в этом разделе, которые вступили в силу между Opus 4.5 и Opus 4.7. Если вы мигрируете с Opus 4.6, вам нужен только раздел Opus 4.7.

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

# Миграция на Opus
model = "claude-opus-4-5"  # Before
model = "claude-opus-4-7"  # After

Критические изменения

Удаление предзаполнения описано в критических изменениях Opus 4.7 выше.
Экранирование параметров инструментов: Claude Opus 4.6 и более поздние модели могут выдавать несколько иное экранирование строк JSON в аргументах вызовов инструментов (например, другая обработка экранирования Unicode или экранирования прямой косой черты). Если вы разбираете input вызова инструмента как необработанную строку, а не используете JSON-парсер, проверьте логику разбора. Стандартные JSON-парсеры (такие как json.loads() или JSON.parse()) обрабатывают эти различия автоматически.

Миграция с Claude 4.1 или более ранних версий

Если вы мигрируете с Opus 4.1 (устаревшая) или более ранних моделей напрямую на Claude Opus 4.7, примените изменения Claude Opus 4.7 в начале этого руководства и накопительные изменения выше плюс дополнительные изменения в этом разделе.

# Из Opus 4.1
model = "claude-opus-4-1-20250805"  # Before
model = "claude-opus-4-7"  # After

# Из Sonnet 3.7
model = "claude-3-7-sonnet-20250219"  # Before
model = "claude-opus-4-7"  # After

Дополнительные критические изменения

Удалите параметры сэмплирования

Это критическое изменение при миграции с моделей Claude 3.x.

Начиная с Claude Opus 4.7, установка temperature, top_p или top_k в любое значение, отличное от значения по умолчанию, вернёт ошибку 400. Самый безопасный путь миграции — полностью исключить эти параметры из запросов и использовать подсказки для управления поведением модели. Если вы использовали temperature = 0 для детерминизма, учтите, что это никогда не гарантировало идентичных выводов.
```
# До — это вызовет ошибку в моделях Claude 4+
response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    temperature=0.7,
    top_p=0.9,  # Non-default sampling params return 400 on Opus 4.7
    # ...
)

# После
response = client.messages.create(
    model="claude-opus-4-7",
    # ...
)
```
Обновите версии инструментов

Это критическое изменение при миграции с моделей 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+ имеют встроенное токен-эффективное использование инструментов, и эти заголовки не имеют эффекта.

Контрольный список миграции (с Opus 4.5 или более ранних версий)

Обновите идентификатор модели на claude-opus-4-7
Примените все критические изменения Opus 4.7 (расширенное мышление удалено, параметры сэмплирования удалены, отображение мышления по умолчанию опущено, обновлённая токенизация)
КРИТИЧЕСКОЕ: Удалите предзаполнения сообщений ассистента (возвращает ошибку 400); используйте структурированные выводы или output_config.format вместо этого
КРИТИЧЕСКОЕ в Opus 4.7: Замените thinking: {type: "enabled", budget_tokens: N} на thinking: {type: "adaptive"} плюс параметр effort (возвращает 400 в Opus 4.7)
Убедитесь, что разбор JSON вызовов инструментов использует стандартный JSON-парсер
Удалите бета-заголовок effort-2025-11-24 (effort теперь общедоступен)
Удалите бета-заголовок fine-grained-tool-streaming-2025-05-14
Удалите бета-заголовок interleaved-thinking-2025-05-14 (адаптивное мышление включает чередующееся мышление автоматически)
Перейдите с output_format на output_config.format (если применимо)
При миграции с Claude 4.1 или более ранних версий: удалите temperature, top_p и top_k (значения, отличные от значений по умолчанию, возвращают 400 в Opus 4.7)
При миграции с Claude 4.1 или более ранних версий: обновите версии инструментов (text_editor_20250728, code_execution_20250825)
При миграции с Claude 4.1 или более ранних версий: обрабатывайте причину остановки refusal
При миграции с Claude 4.1 или более ранних версий: обрабатывайте причину остановки model_context_window_exceeded
При миграции с Claude 4.1 или более ранних версий: проверьте обработку строковых параметров инструментов на завершающие переводы строк
При миграции с Claude 4.1 или более ранних версий: удалите устаревшие бета-заголовки (token-efficient-tools-2025-02-19, output-128k-2025-02-19)
Пересмотрите и обновите подсказки, следуя лучшим практикам составления подсказок
Протестируйте в среде разработки перед развёртыванием в продакшене

Миграция с Claude Sonnet 4.6 на Claude Sonnet 5

Claude Sonnet 5 предлагает лучшее сочетание скорости и интеллекта в семействе моделей Claude. Он построен на основе Claude Sonnet 4.6.

Claude Sonnet 5 — это прямая замена Claude Sonnet 4.6 по той же цене $3 / $15 за миллион токенов (вводная цена $2 / $10 за миллион токенов до 31 августа 2026 года; см. Цены). Есть два критических изменения API для кода, уже работающего на Claude Sonnet 4.6: ручное расширенное мышление (thinking: {type: "enabled", budget_tokens: N}) и параметры сэмплирования (temperature, top_p, top_k), установленные в значения, отличные от значений по умолчанию, больше не принимаются и возвращают ошибку 400. Используйте адаптивное мышление с параметром effort вместо этого. Claude Sonnet 5 поддерживает тот же набор функций, что и Claude Sonnet 4.6, включая контекстное окно в 1 млн токенов, адаптивное мышление, кэширование подсказок, пакетную обработку, Files API, поддержку PDF, зрение и полный набор серверных и клиентских инструментов. Priority Tier недоступен в Claude Sonnet 5. Claude Sonnet 5 также использует новый токенизатор.

Если ваш код работает на Claude Sonnet 4.5 или более ранней версии, также примените шаги миграции на Claude Sonnet 4.6 перед обновлением до Claude Sonnet 5. Эти шаги включают критические изменения (отклонение предзаполнения сообщений ассистента, различия в экранировании JSON параметров инструментов), которые обновление до Sonnet 5 само по себе не покрывает.

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

# Миграция на Sonnet
model = "claude-sonnet-4-6"  # Before
model = "claude-sonnet-5"  # After

Что изменилось

Пункты 4 и 5 в следующем списке являются критическими изменениями. max_tokens остаётся жёстким пределом на общий вывод (мышление плюс текст ответа), поэтому пересмотрите его для рабочих нагрузок, которые выполнялись без мышления на Claude Sonnet 4.6.

Новый токенизатор: Claude Sonnet 5 использует новый токенизатор. Один и тот же входной текст даёт примерно на 30% больше токенов, чем на Claude Sonnet 4.6. Запросы, ответы и события потоковой передачи сохраняют ту же форму, и изменения кода не требуются, но всё, что вы измеряете или бюджетируете в токенах, смещается: поля usage и результаты подсчёта токенов для того же текста выше, контекстное окно в 1 млн токенов вмещает меньше текста, а предел max_tokens, настроенный для Claude Sonnet 4.6, может обрезать эквивалентный вывод. Цена за токен не изменилась, поэтому стоимость эквивалентного запроса может отличаться. Повторно выполните подсчёт токенов на Claude Sonnet 5 вместо повторного использования подсчётов, измеренных на более ранних моделях.
128 тыс. максимальных выходных токенов (без изменений): Claude Sonnet 5 поддерживает до 128 тыс. выходных токенов, так же как и Claude Sonnet 4.6. Существующие значения max_tokens остаются действительными. Учитывайте новый токенизатор при их определении.
Предзаполнение сообщений ассистента (без изменений): Предзаполнение сообщения ассистента возвращает ошибку 400 в Claude Sonnet 5, так же как и в Claude Sonnet 4.6. Если вы удалили предзаполнение при миграции на Claude Sonnet 4.6, дальнейшие изменения не требуются. Используйте структурированные выводы, инструкции в системной подсказке или output_config.format вместо этого.
Адаптивное мышление включено по умолчанию: В Claude Sonnet 4.6 запросы без поля thinking выполняются без мышления; в Claude Sonnet 5 те же запросы выполняются с адаптивным мышлением. Чтобы отключить мышление, передайте thinking: {type: "disabled"}. Ручное расширенное мышление (thinking: {type: "enabled", budget_tokens: N}) не поддерживается и возвращает ошибку 400. Используйте параметр effort (по умолчанию high) для управления глубиной мышления.
Параметры сэмплирования удалены: Параметры сэмплирования (temperature, top_p, top_k), установленные в значение, отличное от значения по умолчанию, не принимаются и возвращают ошибку 400.
Защитные меры кибербезопасности: Claude Sonnet 5 — первая модель уровня Sonnet с защитными мерами кибербезопасности в реальном времени. Запросы, затрагивающие запрещённые или высокорисковые темы кибербезопасности, могут быть отклонены. Отказы возвращаются как успешный HTTP-ответ 200 с stop_reason: "refusal", а не как ошибка. См. Защитные меры, предупреждения и апелляции для справки.

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

Обновите имя модели с claude-sonnet-4-6 на claude-sonnet-5.
Повторно выполните подсчёт токенов на Claude Sonnet 5. Новый токенизатор даёт примерно на 30% больше токенов для того же текста, что может изменить стоимость запроса, даже несмотря на то что цена за токен не изменилась.
Пересмотрите пределы max_tokens, установленные близко к ожидаемой длине вывода, и повысьте их до максимума в 128 тыс. (без изменений по сравнению с Claude Sonnet 4.6), где это полезно.
Удалите конфигурацию thinking: {type: "enabled", budget_tokens: N} (возвращает ошибку 400). Адаптивное мышление включено по умолчанию; передайте {type: "disabled"}, чтобы отключить его, или используйте параметр effort для управления глубиной.
Удалите параметры temperature, top_p и top_k, установленные в значения, отличные от значений по умолчанию (они возвращают ошибку 400 в Claude Sonnet 5).
Добавьте обработку stop_reason: "refusal", если ваша рабочая нагрузка может затрагивать темы кибербезопасности.
Заново определите базовую стоимость на вашей типичной рабочей нагрузке перед развёртыванием в продакшене.
Пересмотрите max_tokens для рабочих нагрузок, которые ранее выполнялись без мышления.

Миграция на Claude Sonnet 4.6

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

Полный обзор возможностей см. в обзоре моделей.

Цена Sonnet 4.6 составляет $3 за миллион входных токенов, $15 за миллион выходных токенов. См. цены Claude для подробностей.

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

# Начиная с Sonnet 4.5
model = "claude-sonnet-4-5"  # Before
model = "claude-sonnet-4-6"  # After

Критические изменения

При миграции с Sonnet 4.5

Предзаполнение сообщений ассистента больше не поддерживается

Это критическое изменение при миграции с 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

Обновите параметры сэмплирования

Это критическое изменение при миграции с моделей Claude 3.x.

Используйте только temperature ИЛИ top_p, но не оба.
Обновите версии инструментов

Это критическое изменение при миграции с моделей Claude 3.x.

Обновитесь до последних версий инструментов (text_editor_20250728, code_execution_20250825). Удалите любой код, использующий команду undo_edit.
Обрабатывайте причину остановки refusal

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

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

Миграция с Sonnet 4.5

Рассмотрите возможность миграции с 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"}],
)

Если вы используете расширенное мышление

Если вы используете расширенное мышление с budget_tokens в Sonnet 4.5, оно по-прежнему функционирует в Sonnet 4.6, но является устаревшим. Переходите на адаптивное мышление с параметром усилий.

Миграция на адаптивное мышление

Адаптивное мышление — это рекомендуемая замена budget_tokens в Sonnet 4.6. Оно особенно хорошо подходит для следующих типов рабочих нагрузок:

Автономные многошаговые агенты: агенты для написания кода, которые превращают требования в работающее программное обеспечение, конвейеры анализа данных и поиск ошибок, где модель работает независимо на протяжении многих шагов. Адаптивное мышление позволяет модели калибровать свои рассуждения на каждом шаге, оставаясь на правильном пути на более длинных траекториях. Для таких рабочих нагрузок начните с уровня усилий high. Если задержка или использование токенов вызывают беспокойство, снизьте уровень до medium.
Агенты для работы с компьютером: Sonnet 4.6 достиг лучшей в своём классе точности в оценках использования компьютера при работе в адаптивном режиме.
Бимодальные рабочие нагрузки: сочетание простых и сложных задач, где адаптивное мышление пропускает этап размышления для простых запросов и глубоко рассуждает над сложными.

При использовании адаптивного мышления оцените уровни усилий 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"}],
)

Если вы наблюдаете непоследовательное поведение или снижение качества при использовании адаптивного мышления, попробуйте сначала снизить настройку усилий или использовать max_tokens в качестве жёсткого ограничения. Расширенное мышление с budget_tokens по-прежнему функционирует в Sonnet 4.6, но является устаревшим и больше не рекомендуется.

Сохранение budget_tokens во время миграции

Если вам необходимо временно сохранить budget_tokens во время миграции, бюджет около 16 тыс. токенов обеспечивает запас для более сложных задач без риска неконтролируемого использования токенов. Эта конфигурация является устаревшей и будет удалена в будущем выпуске модели.

Сценарии использования для программирования и агентных задач

Для агентного программирования, фронтенд-дизайна, рабочих процессов с интенсивным использованием инструментов и сложных корпоративных рабочих процессов начните с уровня усилий medium. Если вы обнаружите, что задержка слишком высока, рассмотрите возможность снижения уровня усилий до low. Если вам нужен более высокий уровень интеллекта, рассмотрите возможность повышения уровня усилий до high или миграции на Opus 4.7.

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"}],
)

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

Обновите идентификатор модели на claude-sonnet-4-6
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Удалите предварительное заполнение сообщений ассистента; вместо этого используйте структурированные выводы или output_config.format
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Убедитесь, что парсинг JSON параметров инструментов обрабатывает различия в экранировании
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Обновите версии инструментов до последних (text_editor_20250728, code_execution_20250825); устаревшие версии не поддерживаются (при миграции с 3.x)
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Удалите любой код, использующий команду undo_edit (если применимо)
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Обновите параметры сэмплирования, чтобы использовать только temperature ИЛИ top_p, но не оба (при миграции с 3.x)
Обработайте новую причину остановки refusal в вашем приложении
Удалите бета-заголовок fine-grained-tool-streaming-2025-05-14 (теперь общедоступно)
Перенесите output_format на output_config.format
Просмотрите и обновите подсказки в соответствии с лучшими практиками составления подсказок
Рекомендуется: Перейдите с thinking: {type: "enabled", budget_tokens: N} на thinking: {type: "adaptive"} с параметром усилий (budget_tokens является устаревшим и будет удалён в будущем выпуске)
Протестируйте в среде разработки перед развёртыванием в продакшене

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

Claude Sonnet 4.5 сочетает высокий интеллект с быстрой производительностью, что делает его идеальным для повседневных задач программирования, анализа и работы с контентом.

Полный обзор возможностей см. в обзоре моделей.

Стоимость Sonnet 4.5 составляет 3 доллара за миллион входных токенов, 15 долларов за миллион выходных токенов. Подробности см. в разделе Цены на Claude.

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

# Из Sonnet 3.7
model = "claude-3-7-sonnet-20250219"  # Before
model = "claude-sonnet-4-5-20250929"  # After

Критические изменения

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

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

Обновите идентификатор модели на claude-sonnet-4-5-20250929
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Обновите версии инструментов до последних (text_editor_20250728, code_execution_20250825); устаревшие версии не поддерживаются (при миграции с 3.x)
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Удалите любой код, использующий команду undo_edit (если применимо)
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Обновите параметры сэмплирования, чтобы использовать только temperature ИЛИ top_p, но не оба (при миграции с 3.x)
Обработайте новую причину остановки refusal в вашем приложении
Просмотрите и обновите подсказки в соответствии с лучшими практиками составления подсказок
Рассмотрите возможность включения расширенного мышления для сложных задач рассуждения
Протестируйте в среде разработки перед развёртыванием в продакшене

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

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

Полный обзор возможностей см. в обзоре моделей.

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

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

# От Haiku 3.5
model = "claude-3-5-haiku-20241022"  # Before
model = "claude-haiku-4-5-20251001"  # After

Ознакомьтесь с новыми ограничениями скорости: Haiku 4.5 имеет отдельные ограничения скорости от Haiku 3.5. Подробности см. в документации по ограничениям скорости.

Для значительного повышения производительности в задачах программирования и рассуждения рассмотрите возможность включения расширенного мышления с помощью thinking: {type: "enabled", budget_tokens: N}.

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

Расширенное мышление является устаревшим в моделях Claude 4.6 и удалено в Claude Opus 4.7. При использовании более новых моделей используйте вместо него адаптивное мышление.

Изучите новые возможности: См. обзор моделей для получения подробной информации об осведомлённости о контексте, увеличенной ёмкости вывода (64 тыс. токенов), более высоком интеллекте и улучшенной скорости.

Критические изменения

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

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

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

Получить помощь

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

Was this page helpful?

Модели и ценыМодели

Руководство по миграции

Руководство по миграции на новейшие модели Claude с предыдущих версий Claude

/claude-api migrate this project to claude-opus-4-8

Миграция с Claude Mythos Preview на Claude Mythos 5

График вывода из эксплуатации Claude Mythos Preview см. в разделе Устаревание моделей.

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

model = "claude-mythos-preview"  # Before
model = "claude-mythos-5"  # After

Функции, недоступные в Claude Mythos 5

Расширенное мышление и бюджеты токенов мышления: Ручное расширенное мышление (thinking: {type: "enabled", budget_tokens: N}) не поддерживается в claude-mythos-5 и возвращает ошибку 400. Адаптивное мышление всегда включено: модель сама определяет, когда и сколько думать при каждом запросе, и конфигурация thinking не требуется. thinking: {type: "disabled"} возвращает ошибку. У budget_tokens нет прямой замены: мышление адаптивно, а параметр effort — это отдельный элемент управления на уровне вывода, а не бюджет мышления.

До (Claude Mythos Preview):
```
client.messages.create(
    model="claude-mythos-preview",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[{"role": "user", "content": "..."}],
)
```
После (Claude Mythos 5):
```
client.messages.create(
    model="claude-mythos-5",
    max_tokens=16000,
    messages=[{"role": "user", "content": "..."}],
)
```
Предзаполнение ассистента (assistant prefill): Предзаполнение сообщения ассистента не поддерживается в claude-mythos-5 и возвращает ошибку 400, так же как и в Claude Mythos Preview. Вместо этого используйте инструкции в системной подсказке.
Вывод мышления: В claude-mythos-5 необработанная цепочка рассуждений никогда не возвращается, но блоки мышления по-прежнему содержат читаемый обобщённый текст, когда thinking.display установлен в summarized. Передавайте блоки мышления обратно без изменений при продолжении разговора на той же модели. См. Вывод мышления в Claude Fable 5 и Claude Mythos 5.

Подсчёт токенов и тарификация

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

Обновите имя модели с claude-mythos-preview на claude-mythos-5.
Удалите конфигурацию ручного расширенного мышления (thinking: {type: "enabled", budget_tokens: N}). Адаптивное мышление всегда включено, и поле thinking не требуется.
Удалите любую конфигурацию thinking: {type: "disabled"}. Отключение мышления возвращает ошибку в claude-mythos-5.
Удалите budget_tokens. У него нет прямой замены: мышление адаптивно, а параметр effort — это отдельный элемент управления на уровне вывода, а не бюджет мышления.
Убедитесь, что любой код, который разбирает поле thinking, обрабатывает его только как отображаемый текст и передаёт блоки мышления обратно без изменений при продолжении на той же модели. thinking.display по умолчанию имеет значение "omitted" в claude-mythos-5, так же как и в Claude Mythos Preview; установите display: "summarized", чтобы получать читаемые сводки. См. Вывод мышления в Claude Fable 5 и Claude Mythos 5.
Если вы воспроизводите историю разговора на другой модели, сначала удалите блоки thinking и redacted_thinking из предыдущих ходов ассистента. Блоки мышления из claude-mythos-5 привязаны к модели, которая их создала, и модели, отличные от Claude Fable 5 и Claude Mythos 5, молча игнорируют их. Удаление делает кросс-модельные запросы минимальными и единообразными.
Заново определите базовые показатели количества токенов и стоимости на ваших собственных рабочих нагрузках. Количество токенов практически не меняется при миграции с claude-mythos-preview.

Миграция с Claude Opus 4.8 на Claude Fable 5

Перед миграцией

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

model = "claude-opus-4-8"  # Before
model = "claude-fable-5"  # After

Что изменилось

Адаптивное мышление всегда включено: Адаптивное мышление — единственный режим мышления в claude-fable-5. Модель сама определяет, когда и сколько думать при каждом запросе, и конфигурация thinking не требуется. thinking: {type: "disabled"} возвращает ошибку. Используйте параметр effort для управления глубиной мышления.

Изменение поведения, которое следует проверить: в Claude Opus 4.8 запросы без поля thinking выполняются без мышления; в claude-fable-5 те же запросы выполняются с адаптивным мышлением. max_tokens остаётся жёстким ограничением на общий вывод — мышление плюс текст ответа, — поэтому пересмотрите его для рабочих нагрузок, которые выполнялись без мышления в Claude Opus 4.8. См. Контроль затрат.

До (Claude Opus 4.8):
```
client.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "..."}],
)
```
После (Claude Fable 5):
```
client.messages.create(
    model="claude-fable-5",
    max_tokens=16000,
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "..."}],
)
```
Расширенное мышление и бюджеты мышления (без изменений): Ручное расширенное мышление (thinking: {type: "enabled", budget_tokens: N}) не поддерживается в claude-fable-5 и возвращает ошибку 400, так же как и в Claude Opus 4.8. У budget_tokens нет прямой замены: мышление адаптивно, а параметр effort — это отдельный элемент управления на уровне вывода, а не бюджет мышления.
Предзаполнение ассистента (без изменений): Предзаполнение сообщения ассистента не поддерживается в claude-fable-5 и возвращает ошибку 400, так же как и в Claude Opus 4.8. Вместо этого используйте инструкции в системной подсказке.
Вывод мышления: В claude-fable-5 необработанная цепочка рассуждений никогда не возвращается, но блоки мышления по-прежнему содержат читаемый обобщённый текст, когда thinking.display установлен в summarized. Передавайте блоки мышления обратно без изменений при продолжении разговора на той же модели. См. Вывод мышления в Claude Fable 5 и Claude Mythos 5.
Классификаторы безопасности и причина остановки refusal: claude-fable-5 запускает классификаторы безопасности для запросов и во время генерации ответа. Когда классификатор отклоняет запрос, Messages API возвращает stop_reason: "refusal" как успешный HTTP-ответ 200, а не ошибку. Поле stop_details.category сообщает, какой классификатор сработал, с категориями, такими как "cyber", "bio" и "reasoning_extraction", или null, когда отказ не соответствует ни одной именованной категории. Полный набор см. в таблице категорий отказов.

Вам не выставляется счёт за входные токены запроса, отклонённого до генерации какого-либо вывода. Когда классификатор срабатывает в середине потока, входные и уже переданные выходные токены тарифицируются; отбросьте частичный вывод.

Чтобы автоматически повторно выполнять отклонённые запросы на другой модели, передайте опциональный параметр fallbacks, который находится в бета-версии в Claude API и Claude Platform on AWS. Параметр недоступен в Message Batches API, а также в Amazon Bedrock, Google Cloud и Microsoft Foundry; на этих трёх платформах выполняйте повторную попытку на стороне клиента или используйте промежуточное ПО SDK для резервного варианта при отказе (refusal-fallback middleware). См. Обработка причин остановки.
Начинайте с уровня effort high: Значение по умолчанию для параметра effort остаётся high. В Claude Opus 4.8 рекомендация для программирования и работы с высокой автономностью — явно устанавливать xhigh. В claude-fable-5 используйте high по умолчанию для большинства задач и резервируйте xhigh для наиболее требовательных к возможностям рабочих нагрузок. Более низкие настройки effort в claude-fable-5 по-прежнему работают хорошо и часто превосходят производительность xhigh на предыдущих моделях. Снижайте effort, если задача выполняется, но занимает больше времени, чем необходимо. См. Создание подсказок для Claude Fable 5.
Сниженный минимум для кэширования подсказок: Минимальная длина кэшируемой подсказки в claude-fable-5 составляет 512 токенов, что ниже 1 024 токенов в Claude Opus 4.8. Подсказки, которые были слишком короткими для кэширования в Claude Opus 4.8, теперь могут создавать записи кэша без каких-либо изменений кода. В Amazon Bedrock минимум для claude-fable-5 составляет 1 024 токена. Минимумы для каждой модели см. в разделе Кэширование подсказок.

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

Если у вашей организации есть соглашение о нулевом хранении данных (ZDR), подтвердите соответствие требованиям перед миграцией. claude-fable-5 требует 30-дневного хранения данных и в Claude API в противном случае возвращает ошибку 400 invalid_request_error. См. Требования к хранению данных для конкретных моделей.
Обновите имя модели с claude-opus-4-8 на claude-fable-5.
Удалите любую конфигурацию thinking: {type: "disabled"}. Отключение мышления возвращает ошибку в claude-fable-5, а запросы без поля thinking выполняются с адаптивным мышлением.
Если вы удалили ручное расширенное мышление и предзаполнения ассистента во время предыдущих миграций, никаких действий не требуется: оба остаются неподдерживаемыми в claude-fable-5.
Убедитесь, что любой код, который разбирает поле thinking, обрабатывает его только как отображаемый текст и передаёт блоки мышления обратно без изменений при продолжении на той же модели. thinking.display по умолчанию имеет значение "omitted" в claude-fable-5, так же как и в Claude Opus 4.8; установите display: "summarized", чтобы получать читаемые сводки. См. Вывод мышления в Claude Fable 5 и Claude Mythos 5.
Если вы воспроизводите историю разговора на другой модели, сначала удалите блоки thinking и redacted_thinking из предыдущих ходов ассистента. Блоки мышления из claude-fable-5 привязаны к модели, которая их создала, и модели, отличные от Claude Fable 5 и Claude Mythos 5, молча игнорируют их. Удаление делает кросс-модельные запросы минимальными и единообразными. Исключение составляет погашение резервного кредита (fallback credit), которое требует тела запроса, воспроизведённого в точном соответствии с правилами этой функции.
Обрабатывайте stop_reason: "refusal" и читайте поле stop_details.category. Чтобы автоматически повторно выполнять отклонённые запросы на другой модели, рассмотрите опциональный параметр fallbacks (бета). См. Обработка причин остановки.
Пересмотрите вашу настройку effort. Начинайте с high для большинства задач, включая рабочие нагрузки, которые выполнялись на xhigh в Claude Opus 4.8.
Заново определите базовые показатели стоимости и задержки на ваших собственных рабочих нагрузках. Количество токенов практически не меняется при миграции с claude-opus-4-8; цена за токен отличается.

Миграция с Claude Opus 4.7 на Claude Opus 4.8

Claude Opus 4.8 создана для сложного агентного программирования и корпоративной работы. Она основана на Claude Opus 4.7.

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

# Миграция на Opus
model = "claude-opus-4-7"  # Before
model = "claude-opus-4-8"  # After

Что изменилось

Параметры сэмплирования (без изменений): Установка temperature, top_p или top_k в значение, отличное от значения по умолчанию, возвращает ошибку 400 в Claude Opus 4.8, так же как и в Claude Opus 4.7. Типы запросов SDK по-прежнему определяют эти поля для совместимости с более ранними моделями, поэтому код, который их устанавливает, проходит проверку типов, но API отклоняет запрос на стороне сервера. Если вы удалили эти параметры при миграции на Opus 4.7, дальнейших изменений не требуется.
Значение effort по умолчанию — high: Значение по умолчанию для параметра effort в Claude Opus 4.8 — high на всех поверхностях, включая Claude Code и Messages API. Если вы уже устанавливаете effort явно, ваша настройка не изменится. Для программирования и работы с высокой автономностью явно устанавливайте xhigh. Пересмотрите вашу настройку effort с учётом вашего бюджета задержки и стоимости.
Контекстное окно в 1 млн токенов по умолчанию: Claude Opus 4.8 предоставляет полное контекстное окно в 1 млн токенов по умолчанию без бета-заголовка и без надбавки за длинный контекст. Если ваш клиент передаёт бета-заголовок контекстного окна для совместимости со старыми моделями, вы можете удалить его в Claude Opus 4.8.
Системные сообщения в середине разговора: Claude Opus 4.8 принимает сообщения с role: "system" сразу после хода пользователя в массиве messages (с учётом правил размещения). Используйте поле верхнего уровня system для инструкций, которые применяются с самого начала. Более ранние модели, включая Claude Opus 4.7, отклоняют role: "system" в messages с ошибкой 400. Если вы поддерживаете пути кода, которые перестраивают полную историю сообщений для обновления инструкций, вы можете упростить их и сохранить попадания в кэш подсказок для более ранних ходов.
Детали остановки при отказе: Объект stop_details в ответах с отказом (доступный начиная с Claude Opus 4.7) теперь публично задокументирован. Когда модель отклоняет запрос, она идентифицирует категорию отказа в дополнение к существующей причине остановки refusal. Бета-заголовок не требуется, и отказаться от этого нельзя. См. Обработка причин остановки.
Сниженный минимум для кэширования подсказок: Минимальная длина кэшируемой подсказки в Claude Opus 4.8 составляет 1 024 токена, что ниже, чем в Claude Opus 4.7. Подсказки, которые были слишком короткими для кэширования в Claude Opus 4.7, теперь могут создавать записи кэша без каких-либо изменений кода. Минимумы для каждой модели см. в разделе Кэширование подсказок.
Перекалиброванные уровни effort: Распределение токенов за каждым уровнем effort изменяется в Claude Opus 4.8 по сравнению с Claude Opus 4.7: medium допускает несколько больше мышления, high — несколько меньше, а xhigh — существенно больше. Если вы настраивали уровень effort под стоимость или задержку Claude Opus 4.7, заново определите базовые показатели на том же уровне, прежде чем корректировать его. См. Effort.

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

Обновите имя модели с claude-opus-4-7 на claude-opus-4-8 (или обновите псевдонимы).
Если вы удалили параметры сэмплирования во время миграции на Opus 4.7, никаких действий не требуется. Если вы добавили их обратно с путём повторной попытки при ошибке 400, удалите этот путь повторной попытки.
Пересмотрите вашу настройку effort. Значение по умолчанию — high на всех поверхностях; для программирования и работы с высокой автономностью явно устанавливайте xhigh.
Удалите любой бета-заголовок контекстного окна. Контекстное окно в 1 млн токенов является значением по умолчанию в Claude API, Amazon Bedrock, Google Cloud и Microsoft Foundry.
Если вы перестраиваете историю разговора для обновления инструкций, рассмотрите переход на системное сообщение в середине разговора, чтобы сохранить попадания в кэш подсказок.
Убедитесь, что ваша обработка причин остановки читает stop_details при отказах (доступно начиная с Claude Opus 4.7; теперь публично задокументировано).
Заново определите базовые показатели стоимости и задержки на выбранном вами уровне effort.

Миграция на Claude Opus 4.7

Контекстное окно в 1 млн токенов по стандартным ценам API без надбавки за длинный контекст
128 тыс. максимальных выходных токенов
Адаптивное мышление
Кэширование подсказок
Пакетная обработка
Files API
Поддержка PDF
Компьютерное зрение
Полный набор серверных и клиентских инструментов (bash, выполнение кода, использование компьютера, текстовый редактор, веб-поиск, веб-загрузка, коннектор MCP, память)

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

# Миграция на Opus
model = "claude-opus-4-6"  # Before
model = "claude-opus-4-7"  # After

Критические изменения

Расширенное мышление удалено: thinking: {type: "enabled", budget_tokens: N} больше не поддерживается в Claude Opus 4.7 и более поздних моделях и возвращает ошибку 400. Переключитесь на адаптивное мышление (thinking: {type: "adaptive"}) и используйте параметр effort для управления глубиной мышления. Адаптивное мышление выключено по умолчанию в Claude Opus 4.7: запросы без поля thinking выполняются без мышления, что соответствует поведению Opus 4.6. Явно установите thinking: {type: "adaptive"}, чтобы включить его.

До (Claude Opus 4.6):
```
client.messages.create(
    model="claude-opus-4-6",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[{"role": "user", "content": "..."}],
)
```
После (Claude Opus 4.7):
```
client.messages.create(
    model="claude-opus-4-7",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},  # or "max", "xhigh", "medium", "low"
    messages=[{"role": "user", "content": "..."}],
)
```
Адаптивное мышление управляется через подсказки. Рекомендации по настройке, когда модель думает слишком много или слишком мало, см. в разделе Калибровка effort и глубины мышления.
Параметры сэмплирования удалены: Установка temperature, top_p или top_k в любое значение, отличное от значения по умолчанию, в Claude Opus 4.7 возвращает ошибку 400. Самый безопасный путь миграции — полностью исключить эти параметры из полезной нагрузки запроса. Подсказки — рекомендуемый способ управления поведением модели в Claude Opus 4.7. Если вы использовали temperature = 0 для детерминизма, обратите внимание, что это никогда не гарантировало идентичные выходные данные на предыдущих моделях.
Содержимое мышления по умолчанию опущено: Блоки мышления по-прежнему появляются в потоке ответа в Claude Opus 4.7, но их поле thinking пусто, если вы явно не включите его. Это незаметное изменение по сравнению с Claude Opus 4.6, где по умолчанию возвращался обобщённый текст мышления. Чтобы восстановить обобщённое содержимое мышления в Claude Opus 4.7, установите thinking.display в "summarized":
```
thinking = {
    "type": "adaptive",
    "display": "summarized",
}
```
Значение по умолчанию — "omitted" в Claude Opus 4.7. Если ваш продукт передаёт рассуждения пользователям в потоковом режиме, новое значение по умолчанию выглядит как длинная пауза перед началом вывода; установите display: "summarized", чтобы восстановить видимый прогресс во время мышления. Подробности см. в разделе Расширенное мышление.
Обновлённый подсчёт токенов: Claude Opus 4.7 использует новый токенизатор, что способствует её улучшенной производительности в широком спектре задач. Новый токенизатор может использовать примерно от 1x до 1,35x токенов при обработке текста по сравнению с предыдущими моделями (до ~35% больше, в зависимости от содержимого).

/v1/messages/count_tokens будет возвращать другое количество токенов для Claude Opus 4.7, чем для Claude Opus 4.6. Эффективность токенов может варьироваться в зависимости от характера рабочей нагрузки.

Вмешательства через подсказки, task_budget и effort могут помочь контролировать затраты и обеспечить надлежащее использование токенов. Эти элементы управления могут снижать интеллект модели. Обновите ваши параметры max_tokens, чтобы обеспечить дополнительный запас, включая триггеры сжатия. Claude Opus 4.7 предоставляет контекстное окно в 1 млн токенов по стандартным ценам API без надбавки за длинный контекст.
Удаление prefill (перенесено из Opus 4.6): Предзаполнение сообщений ассистента возвращает ошибку 400 в Claude Opus 4.7. Вместо этого используйте структурированные выходные данные, инструкции в системной подсказке или output_config.format.

Выбор уровня effort

max: Максимальный effort может обеспечить прирост производительности в некоторых сценариях использования, но может демонстрировать убывающую отдачу от увеличенного использования токенов. Эта настройка также иногда может быть склонна к избыточному мышлению. Тестируйте максимальный effort для задач, требующих высокого интеллекта.
xhigh (новый): Очень высокий effort — лучшая настройка для большинства сценариев программирования и агентных сценариев использования.
high: Эта настройка балансирует использование токенов и интеллект. Для большинства сценариев, чувствительных к интеллекту, используйте минимум high.
medium: Подходит для сценариев, чувствительных к стоимости, которым необходимо снизить использование токенов, жертвуя при этом интеллектом.
low: Резервируйте для коротких, ограниченных по объёму задач и рабочих нагрузок, чувствительных к задержке, которые не чувствительны к интеллекту.

Effort важнее для этой модели, чем для любой предыдущей Opus. Активно экспериментируйте с ним при обновлении.

Изменения в поведении

Длина ответа варьируется в зависимости от сценария использования: Claude Opus 4.7 калибрует длину ответа в соответствии с тем, насколько сложной он считает задачу, вместо того чтобы по умолчанию придерживаться фиксированной многословности. Обычно это означает более короткие ответы на простые запросы и значительно более длинные — на открытый анализ.

Если ваш продукт зависит от определённого стиля или многословности вывода, вам может потребоваться настроить подсказки. Например, чтобы уменьшить многословность, добавьте: «Давай краткие, сфокусированные ответы. Пропускай несущественный контекст и сводите примеры к минимуму». Если вы замечаете конкретные виды избыточных объяснений, добавьте в подсказку целевые инструкции для их предотвращения.

Положительные примеры, показывающие, как Claude может общаться с надлежащим уровнем лаконичности, как правило, более эффективны, чем отрицательные примеры или инструкции, указывающие модели, чего не следует делать.
Более буквальное следование инструкциям: Claude Opus 4.7 интерпретирует подсказки более буквально и явно, чем Claude Opus 4.6, особенно на более низких уровнях усилий. Он не будет молча обобщать инструкцию с одного элемента на другой и не будет делать выводы о запросах, которые вы не делали. Преимущество такой буквальности — точность и меньше лишних итераций. Как правило, он работает лучше для сценариев использования API с тщательно настроенными подсказками, структурированным извлечением и конвейерами, где требуется предсказуемое поведение. Пересмотр подсказок и обвязки может быть особенно полезен при миграции на Claude Opus 4.7.
Более прямой тон: Как и в случае с любой новой моделью, стиль прозы в длинных текстах может измениться. Claude Opus 4.7 более прямолинеен и категоричен, с меньшим количеством одобрительных формулировок и меньшим количеством эмодзи по сравнению с более тёплым стилем Claude Opus 4.6. Если ваш продукт полагается на определённый голос, переоцените стилевые подсказки относительно нового базового уровня.
Встроенные обновления о ходе выполнения в агентных трассировках: Claude Opus 4.7 предоставляет пользователю более регулярные и качественные обновления на протяжении длинных агентных трассировок. Если вы добавили обвязку для принудительного вывода промежуточных сообщений о статусе («После каждых 3 вызовов инструментов подводи итог прогресса»), попробуйте её удалить. Если вы обнаружите, что длина или содержание обновлений Claude Opus 4.7 для пользователя плохо откалиброваны под ваш сценарий использования, явно опишите в подсказке, как должны выглядеть эти обновления, и приведите примеры.
Меньше порождаемых субагентов по умолчанию: Claude Opus 4.7 по умолчанию склонен порождать меньше субагентов. Однако этим поведением можно управлять через подсказки; дайте Claude Opus 4.7 явные указания о том, когда субагенты желательны.
Более строгая калибровка усилий: Существенно отличаясь от Claude Opus 4.6, Claude Opus 4.7 строго соблюдает уровни усилий, особенно на нижнем конце диапазона. На уровнях low и medium модель ограничивает свою работу тем, что было запрошено, не выходя за рамки.

Это хорошо для задержки и стоимости, но на умеренно сложных задачах, выполняемых с усилием low, есть некоторый риск недостаточного обдумывания. Если вы наблюдаете поверхностные рассуждения на сложных проблемах, повысьте усилие до high или xhigh вместо того, чтобы обходить это через подсказки.

Если вам нужно сохранить усилие на уровне low ради задержки, добавьте целевое указание: «Эта задача включает многошаговые рассуждения. Тщательно обдумай проблему, прежде чем отвечать». См. Рекомендуемые уровни усилий для Claude Opus 4.7.
Меньше вызовов инструментов по умолчанию: Claude Opus 4.7 склонен использовать инструменты реже, чем Claude Opus 4.6, и больше полагаться на рассуждения. В большинстве случаев это даёт лучшие результаты.

Чтобы увеличить использование инструментов, повысьте настройку усилий. Настройки усилий high или xhigh демонстрируют существенно большее использование инструментов в агентном поиске и кодировании. Вы также можете скорректировать подсказку, чтобы явно проинструктировать модель о том, когда и как правильно использовать её инструменты.
Защитные меры кибербезопасности в реальном времени: Впервые добавленные в Claude Opus 4.7, запросы, затрагивающие запрещённые или высокорисковые темы, могут приводить к отказам. Для легитимной работы в области безопасности, такой как тестирование на проникновение, исследование уязвимостей или red-teaming, подайте заявку в Cyber Verification Program, чтобы запросить снижение ограничений. См. Защитные меры, предупреждения и апелляции для справки.
Поддержка изображений высокого разрешения: Claude Opus 4.7 — первая модель Claude с поддержкой изображений высокого разрешения. Максимальное разрешение изображения составляет 2576 пикселей по длинной стороне, по сравнению с 1568 пикселями в предыдущих моделях. Это открывает преимущества для рабочих нагрузок с интенсивным использованием зрения и особенно ценно для управления компьютером, понимания скриншотов и анализа документов.

Поддержка высокого разрешения работает автоматически и не требует бета-заголовка или включения на стороне клиента. Следует учесть два момента:
- Изображения в полном разрешении могут использовать примерно до 3 раз больше токенов изображений, чем в предыдущих моделях (до 4 784 токенов на изображение по сравнению с предыдущим пределом примерно в 1 600 токенов на изображение). Пересмотрите бюджет max_tokens и ожидания по стоимости для рабочих нагрузок с большим количеством изображений или уменьшите разрешение перед отправкой, если вам не нужна дополнительная детализация.
- Координаты указания и ограничивающих рамок, возвращаемые моделью, соответствуют фактическим пикселям изображения в соотношении 1:1 в Claude Opus 4.7, поэтому преобразование масштабного коэффициента не требуется.
См. Поддержка изображений высокого разрешения в Claude Opus 4.7 для подробностей.

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

Обновите имя модели с claude-opus-4-6 на claude-opus-4-7 (или обновите псевдонимы).
Удалите temperature, top_p и top_k из полезных нагрузок запросов.
Замените thinking: {type: "enabled", budget_tokens: N} на thinking: {type: "adaptive"} плюс параметр effort.
Удалите любые предзаполнения сообщений ассистента.
Если ваш пользовательский интерфейс отображает содержимое мышления, явно включите суммаризацию мышления.
Повторно измерьте сквозную стоимость и задержку с учётом обновлённой токенизации.
Перенастройте max_tokens с учётом обновлённой токенизации.
Повторно протестируйте любые оценки количества токенов на стороне клиента.
Если ваше приложение отправляет изображения, пересмотрите бюджет с учётом поддержки изображений высокого разрешения (примерно до 3 раз больше токенов изображений на изображение в полном разрешении). Уменьшите разрешение перед отправкой, если вам не нужна дополнительная детализация.
Если вы используете координаты указания или ограничивающих рамок от модели, удалите любое преобразование масштабного коэффициента; координаты соответствуют фактическим пикселям изображения в соотношении 1:1 в Claude Opus 4.7.
Пересмотрите подсказки с учётом описанных выше изменений поведения (длина ответа, буквальность, тон, обновления о ходе выполнения, субагенты, калибровка усилий, запуск инструментов, защитные меры кибербезопасности, обработка изображений высокого разрешения).
Заново определите базовую длину ответа, удалив существующие подсказки управления длиной, затем настройте явно.
При использовании усилия xhigh или max повысьте max_tokens как минимум до 64 тыс. в качестве отправной точки.
Рассмотрите внедрение бюджетов задач (бета) для агентных рабочих процессов.
Если ваш продукт выполняет легитимную работу в области безопасности, подайте заявку в Cyber Verification Program для доступа к сниженным ограничениям на контент по кибербезопасности.

Миграция на Claude Opus 4.7 с Opus 4.5 или более ранних версий

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

# Миграция на Opus
model = "claude-opus-4-5"  # Before
model = "claude-opus-4-7"  # After

Критические изменения

Удаление предзаполнения описано в критических изменениях Opus 4.7 выше.
Экранирование параметров инструментов: Claude Opus 4.6 и более поздние модели могут выдавать несколько иное экранирование строк JSON в аргументах вызовов инструментов (например, другая обработка экранирования Unicode или экранирования прямой косой черты). Если вы разбираете input вызова инструмента как необработанную строку, а не используете JSON-парсер, проверьте логику разбора. Стандартные JSON-парсеры (такие как json.loads() или JSON.parse()) обрабатывают эти различия автоматически.

Миграция с Claude 4.1 или более ранних версий

# Из Opus 4.1
model = "claude-opus-4-1-20250805"  # Before
model = "claude-opus-4-7"  # After

# Из Sonnet 3.7
model = "claude-3-7-sonnet-20250219"  # Before
model = "claude-opus-4-7"  # After

Дополнительные критические изменения

Удалите параметры сэмплирования

Это критическое изменение при миграции с моделей Claude 3.x.

Начиная с Claude Opus 4.7, установка temperature, top_p или top_k в любое значение, отличное от значения по умолчанию, вернёт ошибку 400. Самый безопасный путь миграции — полностью исключить эти параметры из запросов и использовать подсказки для управления поведением модели. Если вы использовали temperature = 0 для детерминизма, учтите, что это никогда не гарантировало идентичных выводов.
```
# До — это вызовет ошибку в моделях Claude 4+
response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    temperature=0.7,
    top_p=0.9,  # Non-default sampling params return 400 on Opus 4.7
    # ...
)

# После
response = client.messages.create(
    model="claude-opus-4-7",
    # ...
)
```
Обновите версии инструментов

Это критическое изменение при миграции с моделей 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+ имеют встроенное токен-эффективное использование инструментов, и эти заголовки не имеют эффекта.

Контрольный список миграции (с Opus 4.5 или более ранних версий)

Обновите идентификатор модели на claude-opus-4-7
Примените все критические изменения Opus 4.7 (расширенное мышление удалено, параметры сэмплирования удалены, отображение мышления по умолчанию опущено, обновлённая токенизация)
КРИТИЧЕСКОЕ: Удалите предзаполнения сообщений ассистента (возвращает ошибку 400); используйте структурированные выводы или output_config.format вместо этого
КРИТИЧЕСКОЕ в Opus 4.7: Замените thinking: {type: "enabled", budget_tokens: N} на thinking: {type: "adaptive"} плюс параметр effort (возвращает 400 в Opus 4.7)
Убедитесь, что разбор JSON вызовов инструментов использует стандартный JSON-парсер
Удалите бета-заголовок effort-2025-11-24 (effort теперь общедоступен)
Удалите бета-заголовок fine-grained-tool-streaming-2025-05-14
Удалите бета-заголовок interleaved-thinking-2025-05-14 (адаптивное мышление включает чередующееся мышление автоматически)
Перейдите с output_format на output_config.format (если применимо)
При миграции с Claude 4.1 или более ранних версий: удалите temperature, top_p и top_k (значения, отличные от значений по умолчанию, возвращают 400 в Opus 4.7)
При миграции с Claude 4.1 или более ранних версий: обновите версии инструментов (text_editor_20250728, code_execution_20250825)
При миграции с Claude 4.1 или более ранних версий: обрабатывайте причину остановки refusal
При миграции с Claude 4.1 или более ранних версий: обрабатывайте причину остановки model_context_window_exceeded
При миграции с Claude 4.1 или более ранних версий: проверьте обработку строковых параметров инструментов на завершающие переводы строк
При миграции с Claude 4.1 или более ранних версий: удалите устаревшие бета-заголовки (token-efficient-tools-2025-02-19, output-128k-2025-02-19)
Пересмотрите и обновите подсказки, следуя лучшим практикам составления подсказок
Протестируйте в среде разработки перед развёртыванием в продакшене

Миграция с Claude Sonnet 4.6 на Claude Sonnet 5

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

# Миграция на Sonnet
model = "claude-sonnet-4-6"  # Before
model = "claude-sonnet-5"  # After

Что изменилось

Новый токенизатор: Claude Sonnet 5 использует новый токенизатор. Один и тот же входной текст даёт примерно на 30% больше токенов, чем на Claude Sonnet 4.6. Запросы, ответы и события потоковой передачи сохраняют ту же форму, и изменения кода не требуются, но всё, что вы измеряете или бюджетируете в токенах, смещается: поля usage и результаты подсчёта токенов для того же текста выше, контекстное окно в 1 млн токенов вмещает меньше текста, а предел max_tokens, настроенный для Claude Sonnet 4.6, может обрезать эквивалентный вывод. Цена за токен не изменилась, поэтому стоимость эквивалентного запроса может отличаться. Повторно выполните подсчёт токенов на Claude Sonnet 5 вместо повторного использования подсчётов, измеренных на более ранних моделях.
128 тыс. максимальных выходных токенов (без изменений): Claude Sonnet 5 поддерживает до 128 тыс. выходных токенов, так же как и Claude Sonnet 4.6. Существующие значения max_tokens остаются действительными. Учитывайте новый токенизатор при их определении.
Предзаполнение сообщений ассистента (без изменений): Предзаполнение сообщения ассистента возвращает ошибку 400 в Claude Sonnet 5, так же как и в Claude Sonnet 4.6. Если вы удалили предзаполнение при миграции на Claude Sonnet 4.6, дальнейшие изменения не требуются. Используйте структурированные выводы, инструкции в системной подсказке или output_config.format вместо этого.
Адаптивное мышление включено по умолчанию: В Claude Sonnet 4.6 запросы без поля thinking выполняются без мышления; в Claude Sonnet 5 те же запросы выполняются с адаптивным мышлением. Чтобы отключить мышление, передайте thinking: {type: "disabled"}. Ручное расширенное мышление (thinking: {type: "enabled", budget_tokens: N}) не поддерживается и возвращает ошибку 400. Используйте параметр effort (по умолчанию high) для управления глубиной мышления.
Параметры сэмплирования удалены: Параметры сэмплирования (temperature, top_p, top_k), установленные в значение, отличное от значения по умолчанию, не принимаются и возвращают ошибку 400.
Защитные меры кибербезопасности: Claude Sonnet 5 — первая модель уровня Sonnet с защитными мерами кибербезопасности в реальном времени. Запросы, затрагивающие запрещённые или высокорисковые темы кибербезопасности, могут быть отклонены. Отказы возвращаются как успешный HTTP-ответ 200 с stop_reason: "refusal", а не как ошибка. См. Защитные меры, предупреждения и апелляции для справки.

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

Обновите имя модели с claude-sonnet-4-6 на claude-sonnet-5.
Повторно выполните подсчёт токенов на Claude Sonnet 5. Новый токенизатор даёт примерно на 30% больше токенов для того же текста, что может изменить стоимость запроса, даже несмотря на то что цена за токен не изменилась.
Пересмотрите пределы max_tokens, установленные близко к ожидаемой длине вывода, и повысьте их до максимума в 128 тыс. (без изменений по сравнению с Claude Sonnet 4.6), где это полезно.
Удалите конфигурацию thinking: {type: "enabled", budget_tokens: N} (возвращает ошибку 400). Адаптивное мышление включено по умолчанию; передайте {type: "disabled"}, чтобы отключить его, или используйте параметр effort для управления глубиной.
Удалите параметры temperature, top_p и top_k, установленные в значения, отличные от значений по умолчанию (они возвращают ошибку 400 в Claude Sonnet 5).
Добавьте обработку stop_reason: "refusal", если ваша рабочая нагрузка может затрагивать темы кибербезопасности.
Заново определите базовую стоимость на вашей типичной рабочей нагрузке перед развёртыванием в продакшене.
Пересмотрите max_tokens для рабочих нагрузок, которые ранее выполнялись без мышления.

Миграция на Claude Sonnet 4.6

Полный обзор возможностей см. в обзоре моделей.

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

# Начиная с Sonnet 4.5
model = "claude-sonnet-4-5"  # Before
model = "claude-sonnet-4-6"  # After

Критические изменения

При миграции с Sonnet 4.5

Предзаполнение сообщений ассистента больше не поддерживается

Это критическое изменение при миграции с 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

Обновите параметры сэмплирования

Это критическое изменение при миграции с моделей Claude 3.x.

Используйте только temperature ИЛИ top_p, но не оба.
Обновите версии инструментов

Это критическое изменение при миграции с моделей Claude 3.x.

Обновитесь до последних версий инструментов (text_editor_20250728, code_execution_20250825). Удалите любой код, использующий команду undo_edit.
Обрабатывайте причину остановки refusal

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

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

Миграция с 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"}],
)

Если вы используете расширенное мышление

Миграция на адаптивное мышление

Автономные многошаговые агенты: агенты для написания кода, которые превращают требования в работающее программное обеспечение, конвейеры анализа данных и поиск ошибок, где модель работает независимо на протяжении многих шагов. Адаптивное мышление позволяет модели калибровать свои рассуждения на каждом шаге, оставаясь на правильном пути на более длинных траекториях. Для таких рабочих нагрузок начните с уровня усилий high. Если задержка или использование токенов вызывают беспокойство, снизьте уровень до medium.
Агенты для работы с компьютером: Sonnet 4.6 достиг лучшей в своём классе точности в оценках использования компьютера при работе в адаптивном режиме.
Бимодальные рабочие нагрузки: сочетание простых и сложных задач, где адаптивное мышление пропускает этап размышления для простых запросов и глубоко рассуждает над сложными.

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 во время миграции

Сценарии использования для программирования и агентных задач

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"}],
)

Сценарии использования для чата и задач, не связанных с программированием

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"}],
)

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

Обновите идентификатор модели на claude-sonnet-4-6
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Удалите предварительное заполнение сообщений ассистента; вместо этого используйте структурированные выводы или output_config.format
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Убедитесь, что парсинг JSON параметров инструментов обрабатывает различия в экранировании
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Обновите версии инструментов до последних (text_editor_20250728, code_execution_20250825); устаревшие версии не поддерживаются (при миграции с 3.x)
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Удалите любой код, использующий команду undo_edit (если применимо)
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Обновите параметры сэмплирования, чтобы использовать только temperature ИЛИ top_p, но не оба (при миграции с 3.x)
Обработайте новую причину остановки refusal в вашем приложении
Удалите бета-заголовок fine-grained-tool-streaming-2025-05-14 (теперь общедоступно)
Перенесите output_format на output_config.format
Просмотрите и обновите подсказки в соответствии с лучшими практиками составления подсказок
Рекомендуется: Перейдите с thinking: {type: "enabled", budget_tokens: N} на thinking: {type: "adaptive"} с параметром усилий (budget_tokens является устаревшим и будет удалён в будущем выпуске)
Протестируйте в среде разработки перед развёртыванием в продакшене

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

Полный обзор возможностей см. в обзоре моделей.

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

# Из Sonnet 3.7
model = "claude-3-7-sonnet-20250219"  # Before
model = "claude-sonnet-4-5-20250929"  # After

Критические изменения

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

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

Обновите идентификатор модели на claude-sonnet-4-5-20250929
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Обновите версии инструментов до последних (text_editor_20250728, code_execution_20250825); устаревшие версии не поддерживаются (при миграции с 3.x)
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Удалите любой код, использующий команду undo_edit (если применимо)
КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Обновите параметры сэмплирования, чтобы использовать только temperature ИЛИ top_p, но не оба (при миграции с 3.x)
Обработайте новую причину остановки refusal в вашем приложении
Просмотрите и обновите подсказки в соответствии с лучшими практиками составления подсказок
Рассмотрите возможность включения расширенного мышления для сложных задач рассуждения
Протестируйте в среде разработки перед развёртыванием в продакшене

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

Полный обзор возможностей см. в обзоре моделей.

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

# От Haiku 3.5
model = "claude-3-5-haiku-20241022"  # Before
model = "claude-haiku-4-5-20251001"  # After

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

Критические изменения

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

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

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

Получить помощь

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

Was this page helpful?

Миграция с Claude Mythos Preview на Claude Mythos 5

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

Функции, недоступные в Claude Mythos 5

Подсчёт токенов и тарификация

Контрольный список миграции

Миграция с Claude Opus 4.8 на Claude Fable 5

Перед миграцией

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

Что изменилось

Контрольный список миграции

Миграция с Claude Opus 4.7 на Claude Opus 4.8

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

Что изменилось

Контрольный список миграции

Миграция на Claude Opus 4.7

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

Критические изменения

Выбор уровня effort

Изменения в поведении

Рекомендуемые изменения

Контрольный список миграции

Миграция на Claude Opus 4.7 с Opus 4.5 или более ранних версий

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

Критические изменения

Рекомендуемые изменения

Миграция с Claude 4.1 или более ранних версий

Дополнительные критические изменения

Дополнительные рекомендуемые изменения

Контрольный список миграции (с Opus 4.5 или более ранних версий)

Миграция с Claude Sonnet 4.6 на Claude Sonnet 5

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

Что изменилось

Контрольный список миграции

Миграция на Claude Sonnet 4.6

Критические изменения

При миграции с Sonnet 4.5

При миграции с Claude 3.x

Рекомендуемые изменения

Миграция с Sonnet 4.5

Если вы не используете расширенное мышление

Если вы используете расширенное мышление

Миграция на адаптивное мышление

Сохранение budget_tokens во время миграции

Сценарии использования для программирования и агентных задач

Сценарии использования для чата и задач, не связанных с программированием

Контрольный список миграции на Sonnet 4.6

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

Критические изменения

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

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

Критические изменения

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

Получить помощь

Миграция с Claude Mythos Preview на Claude Mythos 5

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

Функции, недоступные в Claude Mythos 5

Подсчёт токенов и тарификация

Контрольный список миграции

Миграция с Claude Opus 4.8 на Claude Fable 5

Перед миграцией

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

Что изменилось

Контрольный список миграции

Миграция с Claude Opus 4.7 на Claude Opus 4.8

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

Что изменилось

Контрольный список миграции

Миграция на Claude Opus 4.7

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

Критические изменения

Выбор уровня effort

Изменения в поведении

Рекомендуемые изменения

Контрольный список миграции

Миграция на Claude Opus 4.7 с Opus 4.5 или более ранних версий

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

Критические изменения

Рекомендуемые изменения

Миграция с Claude 4.1 или более ранних версий

Дополнительные критические изменения

Миграция с Claude Mythos Preview на Claude Mythos 5

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

Функции, недоступные в Claude Mythos 5

Подсчёт токенов и тарификация

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

Миграция с Claude Opus 4.8 на Claude Fable 5

Перед миграцией

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

Что изменилось

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

Миграция с Claude Opus 4.7 на Claude Opus 4.8

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

Что изменилось

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

Миграция на Claude Opus 4.7

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

Критические изменения

Выбор уровня effort

Изменения в поведении

Рекомендуемые изменения

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

Миграция на Claude Opus 4.7 с Opus 4.5 или более ранних версий

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

Критические изменения

Рекомендуемые изменения

Миграция с Claude 4.1 или более ранних версий

Дополнительные критические изменения

Дополнительные рекомендуемые изменения

Контрольный список миграции (с Opus 4.5 или более ранних версий)

Миграция с Claude Sonnet 4.6 на Claude Sonnet 5

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

Что изменилось

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

Миграция на Claude Sonnet 4.6

Критические изменения

При миграции с Sonnet 4.5

При миграции с Claude 3.x

Рекомендуемые изменения

Миграция с Sonnet 4.5

Если вы не используете расширенное мышление

Если вы используете расширенное мышление

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

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

Критические изменения

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

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

Критические изменения

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

Получить помощь

Миграция с Claude Mythos Preview на Claude Mythos 5

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

Функции, недоступные в Claude Mythos 5

Подсчёт токенов и тарификация

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

Миграция с Claude Opus 4.8 на Claude Fable 5

Перед миграцией

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

Что изменилось

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

Миграция с Claude Opus 4.7 на Claude Opus 4.8

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

Что изменилось

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

Миграция на Claude Opus 4.7

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

Критические изменения

Выбор уровня effort

Изменения в поведении

Рекомендуемые изменения

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

Миграция на Claude Opus 4.7 с Opus 4.5 или более ранних версий

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

Критические изменения

Рекомендуемые изменения

Миграция с Claude 4.1 или более ранних версий

Дополнительные критические изменения

Дополнительные рекомендуемые изменения

Контрольный список миграции (с Opus 4.5 или более ранних версий)

Миграция с Claude Sonnet 4.6 на Claude Sonnet 5

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