Claude Platform Docs
Модели и ценыClaude Opus 5

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

Миграция на Claude Opus 5 с более ранних моделей Claude: идентификаторы моделей, критические изменения, рекомендуемые изменения и контрольные списки миграции.

Claude Opus 5 — это качественный скачок по сравнению с Claude Opus 4.8: модель сильна в глубоких рассуждениях, агентных и долгосрочных задачах, а также в масштабировании вычислений на этапе вывода (test-time compute scaling). О поведенческих различиях и специфичных для модели приёмах составления подсказок см. Составление подсказок для Claude Opus 5.

Claude Opus 5 — это прямая замена Claude Opus 4.8 по той же цене: $5 за миллион входных токенов и $25 за миллион выходных токенов; см. Цены на Claude. Для кода, уже работающего на Claude Opus 4.8, есть два критических изменения, описанных в разделе Критические изменения. Claude Opus 5 поддерживает тот же набор функций, что и Claude Opus 4.8, включая «context window» (контекстное окно) на 1 млн токенов (по умолчанию, без бета-заголовка), максимум 128 тыс. выходных токенов, адаптивное мышление, «prompt caching» (кэширование подсказок), пакетную обработку, Files API, поддержку PDF, зрение, а также серверные и клиентские инструменты, с двумя исключениями: web fetch недоступен на Claude Opus 5, и Priority Tier не поддерживается на Claude Opus 5. Доступность для моделей см. на странице каждого инструмента.

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

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

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

claude-opus-5 — это фиксированный идентификатор модели без суффикса даты, по той же схеме, что и claude-opus-4-8 и claude-sonnet-5.

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

  1. Мышление включено по умолчанию: На Claude Opus 4.8 запросы без поля thinking выполняются без мышления; на Claude Opus 5 те же запросы выполняются с адаптивным мышлением. max_tokens остаётся жёстким ограничением на общий объём вывода — мышление плюс текст ответа, — поэтому пересмотрите его для рабочих нагрузок, которые выполнялись без мышления на Claude Opus 4.8. Токены мышления тарифицируются как выходные токены, даже когда текст мышления вам не возвращается, поэтому, хотя цена за токен не изменилась, рабочая нагрузка, выполнявшаяся без мышления на Claude Opus 4.8, может производить больше выходных токенов на запрос на Claude Opus 5; см. Контроль затрат. Чтобы сохранить прежнее поведение, передайте thinking: {type: "disabled"} с учётом ограничения по effort из следующего пункта; обратите внимание, что при отключённом мышлении модель может изредка выдавать вызовы инструментов в виде обычного текста или включать внутренние XML-теги в видимый вывод, поэтому по возможности предпочитайте более низкие уровни effort с включённым мышлением, а там, где это невозможно, см. способы смягчения в разделе Работа с отключённым мышлением.

    Вместе с этим меняется и форма ответа. При включённом мышлении ответ может начинаться с одного или нескольких блоков thinking перед первым блоком text, а поскольку thinking.display на Claude Opus 5 по умолчанию равен "omitted", эти блоки приходят с пустым полем thinking наряду с их signature. Код, читающий ответ по позиции, например content[0].text или обработчик потока, который считает первое событие content_block_start текстом, ломается на таких ответах. Вместо этого выбирайте блоки содержимого по их полю type: читайте text из блоков, у которых type равен "text", и ветвитесь по типу блока при обработке событий потока. Чтобы получать читаемые сводки мышления вместо пустого поля thinking, установите display: "summarized"; см. Управление отображением мышления.

    Если вы используете цикл использования инструментов, передавайте блоки thinking из каждого ответа ассистента обратно в API полностью и без изменений при возврате результатов инструментов, включая блоки с пустым полем thinking. Возвращайте сообщение ассистента в том виде, в каком оно получено, а не фильтруйте его блоки содержимого по типу и не пересобирайте его: API отклоняет отредактированные, переупорядоченные или частично удалённые блоки мышления с ошибкой 400. См. Сохранение блоков мышления.

  2. Отключение мышления ограничено уровнем effort high: Вы по-прежнему можете отключить мышление с помощью thinking: {type: "disabled"}, но только при уровне effort high или ниже. Запрос, сочетающий thinking: {type: "disabled"} с effort xhigh или max, возвращает ошибку 400. Claude Opus 4.8 принимает такое сочетание, поэтому перед миграцией проверьте запросы, отключающие мышление.

    Проверка выполняется для каждого запроса: конфигурация effort и мышления каждого запроса валидируется независимо, поэтому запрос, повышающий effort до xhigh или max при отключённом мышлении, отклоняется, даже если более ранние запросы в разговоре были приняты.

    До (принимается на Claude Opus 4.8, отклоняется на Claude Opus 5):

    client.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    thinking={"type": "disabled"},
    output_config={"effort": "xhigh"},
    messages=[{"role": "user", "content": "..."}],
)

    После (Claude Opus 5) — либо удалите поле thinking, чтобы снова включить мышление:

    client.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    output_config={"effort": "xhigh"},  # thinking is on by default
    messages=[{"role": "user", "content": "..."}],
)

    либо оставьте мышление отключённым и понизьте effort:

    client.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    thinking={"type": "disabled"},
    output_config={"effort": "high"},  # or "medium", "low"
    messages=[{"role": "user", "content": "..."}],
)

Они не обязательны, но улучшат ваш опыт:

  1. Протестируйте effort max для задач, критичных к возможностям модели: Claude Opus 5 поддерживает полный набор уровней effort (low, medium, high, xhigh, max). Там, где максимальные возможности важнее расхода токенов, протестируйте effort max. Он может дать прирост на самых сложных задачах, но может демонстрировать убывающую отдачу от увеличенного расхода токенов и склонность к избыточному обдумыванию на более простых. Если вы работаете на effort xhigh или max, задайте большое значение max_tokens, чтобы у модели было пространство для размышлений и действий; начните с 64 тыс. токенов и настраивайте дальше.

  2. Рассмотрите автоматические резервные модели (fallbacks): Claude Opus 5 поставляется с классификаторами безопасности в области кибербезопасности, отказы которых в кибер-категории могут переключаться на Claude Opus 4.8. Чтобы автоматически повторно выполнять отклонённые запросы на другой модели, рассмотрите параметр fallbacks в режиме "default" (fallbacks: "default"), который выбирает рекомендуемую резервную модель на основе категории отказа вместо поддерживаемого вручную списка моделей. Серверный fallback находится в бета-версии; режим "default" требует бета-заголовка server-side-fallback-2026-07-01. См. Отказы и fallback.

  3. Кэшируйте более короткие подсказки: Минимальная кэшируемая длина подсказки на Claude Opus 5 составляет 512 токенов против 1024 токенов на Claude Opus 4.8. Подсказки, которые были слишком короткими для кэширования на Claude Opus 4.8, теперь могут создавать записи кэша без каких-либо изменений в коде. Минимумы для каждой модели см. в разделе Кэширование подсказок.

  4. Меняйте инструменты в ходе разговора (бета): Вы можете добавлять или удалять инструменты между ходами разговора, не инвалидируя попадания в кэш подсказок на более ранних ходах. Отправьте бета-заголовок mid-conversation-tool-changes-2026-07-01. Это полезно для агентных рабочих нагрузок, которые открывают инструменты постепенно или выводят их из использования по мере продвижения задачи; без него изменённый список инструментов инвалидирует кэшированный префикс.

  5. Перенастройте подсказки, касающиеся длины и многословности: Видимые ответы и письменные результаты по умолчанию на Claude Opus 5 длиннее, чем на Claude Opus 4.8, а понижение effort уменьшает объём мышления, но не сокращает видимый ответ надёжным образом. Вместо этого явно запрашивайте краткость или целевую длину. См. Длина ответа и многословность и Длина письменных результатов.

  6. Удалите перенесённые инструкции по проверке и ограничьте область задачи: Claude Opus 5 проверяет свою работу без указаний, поэтому удалите явные инструкции по проверке или самопроверке, перенесённые из подсказок, настроенных для более ранних моделей; если их оставить, это приводит к избыточной проверке. Для узких задач явно ограничивайте область задачи. В мультиагентных фреймворках давайте явные указания о том, какие сценарии требуют делегирования, или ограничивайте число субагентов, поскольку Claude Opus 5 делегирует охотнее, чем более ранние модели. См. Область задачи и избыточная проверка и Управление порождением субагентов.

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

  • Обновите имя модели с claude-opus-4-8 на claude-opus-5.
  • Проверьте рабочие нагрузки, которые выполнялись без поля thinking: на Claude Opus 5 они выполняются с мышлением. Пересмотрите max_tokens, который остаётся жёстким ограничением на общий объём вывода (мышление плюс текст ответа), или передайте thinking: {type: "disabled"} при effort high или ниже, чтобы сохранить прежнее поведение. Если вы отключаете мышление, ознакомьтесь с разделом Работа с отключённым мышлением, где описаны возможные артефакты вывода и способы их смягчения с помощью подсказок.
  • Обновите разбор ответов, читающий содержимое по позиции, например content[0].text или обработчик потока, предполагающий, что первый блок содержимого — текст: при включённом мышлении блоки thinking приходят перед блоками text. Вместо этого выбирайте блоки содержимого по type.
  • Если вы используете цикл использования инструментов, передавайте блоки thinking обратно полностью и без изменений при возврате результатов инструментов; изменённые блоки возвращают ошибку 400. См. Сохранение блоков мышления.
  • Убедитесь, что любой код, разбирающий поле thinking, рассматривает его только как текст для отображения. thinking.display на Claude Opus 5 по умолчанию равен "omitted", как и на Claude Opus 4.8, поэтому блоки мышления приходят с пустым полем thinking; установите display: "summarized", чтобы получать читаемые сводки. См. Управление отображением мышления.
  • Проверьте запросы, отключающие мышление: thinking: {type: "disabled"} с effort xhigh или max возвращает ошибку 400, проверяемую для каждого запроса. Снова включите мышление или понизьте effort до high или ниже.
  • Переоцените настройку effort: проведите новый перебор уровней effort на собственных оценках, а не переносите настройку, подобранную для более ранней модели. Уровни low и medium стоит протестировать как средства контроля затрат и задержки, а effort max — там, где максимальные возможности важнее расхода токенов. Если вы работаете на effort xhigh или max, поднимите max_tokens как минимум до 64 тыс. в качестве отправной точки.
  • Проверьте подсказки, близкие к минимуму кэширования: подсказки от 512 токенов теперь могут создавать записи кэша (против 1024 токенов на Claude Opus 4.8).
  • Обрабатывайте stop_reason: "refusal" и рассмотрите fallbacks: "default" (бета) для автоматического повторного выполнения отклонённых запросов на рекомендуемой резервной модели.
  • Если у вашей организации есть обязательства по Priority Tier, планируйте мощности отдельно: Priority Tier не поддерживается на Claude Opus 5, тогда как Claude Opus 4.8 его сохраняет.
  • Для агентных рабочих нагрузок рассмотрите бюджеты задач (бета) и изменение инструментов в ходе разговора (бета).
  • Перенастройте подсказки, касающиеся длины и многословности: видимые ответы и письменные результаты по умолчанию на Claude Opus 5 длиннее, а понижение effort уменьшает объём мышления, но не сокращает видимый ответ надёжным образом. Явно запрашивайте краткость или целевую длину. См. Длина ответа и многословность и Длина письменных результатов.
  • Удалите инструкции по проверке и самопроверке, перенесённые из подсказок, настроенных для более ранних моделей (на Claude Opus 5 они вызывают избыточную проверку), явно ограничивайте область задачи для узких задач, а в мультиагентных фреймворках направляйте или ограничивайте делегирование субагентам. См. Область задачи и избыточная проверка и Управление порождением субагентов.
  • Заново определите базовые показатели затрат и задержки на собственных рабочих нагрузках. Цена за токен не изменилась по сравнению с Claude Opus 4.8, но токены мышления тарифицируются как выходные токены, поэтому рабочие нагрузки, выполнявшиеся без мышления, могут производить больше выходных токенов на запрос.

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

Claude Opus 5 должен демонстрировать высокую производительность «из коробки» на существующих подсказках и оценках для Claude Opus 4.7 по той же цене: $5 за миллион входных токенов и $25 за миллион выходных токенов. Он поддерживает тот же набор функций, что и Claude Opus 4.7, включая контекстное окно на 1 млн токенов, максимум 128 тыс. выходных токенов, адаптивное мышление, кэширование подсказок, пакетную обработку, Files API, поддержку PDF, зрение, а также серверные и клиентские инструменты, с двумя исключениями: web fetch недоступен на Claude Opus 5, и Priority Tier не поддерживается на Claude Opus 5. Он также добавляет системные сообщения в ходе разговора и публично документирует детали остановки при отказе. На Claude API и Google Cloud Claude Opus 5 также поддерживает использование компьютера в виде стабильного набора инструментов computer_toolset_20260801 и инструмент использования браузера для задач внутри веб-страниц — ни то, ни другое Claude Opus 4.7 не поддерживает; существующие интеграции на более ранней версии computer_20251124 продолжают работать без изменений на обеих моделях. Чтобы обновить существующую интеграцию, см. Миграция с computer_20251124.

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

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

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

  1. Мышление включено по умолчанию: На Claude Opus 4.7 запросы без поля thinking выполняются без мышления; на Claude Opus 5 те же запросы выполняются с адаптивным мышлением. max_tokens остаётся жёстким ограничением на общий объём вывода — мышление плюс текст ответа, — поэтому пересмотрите его для рабочих нагрузок, которые выполнялись без мышления на Claude Opus 4.7. Токены мышления тарифицируются как выходные токены, даже когда текст мышления вам не возвращается, поэтому, хотя цена за токен не изменилась, рабочая нагрузка, выполнявшаяся без мышления на Claude Opus 4.7, может производить больше выходных токенов на запрос на Claude Opus 5; см. Контроль затрат. Чтобы сохранить прежнее поведение, передайте thinking: {type: "disabled"} с учётом ограничения по effort из следующего пункта; обратите внимание, что при отключённом мышлении модель может изредка выдавать вызовы инструментов в виде обычного текста или включать внутренние XML-теги в видимый вывод, поэтому по возможности предпочитайте более низкие уровни effort с включённым мышлением, а там, где это невозможно, см. способы смягчения в разделе Работа с отключённым мышлением.

    Вместе с этим меняется и форма ответа. При включённом мышлении ответ может начинаться с одного или нескольких блоков thinking перед первым блоком text, а поскольку thinking.display на Claude Opus 5 по умолчанию равен "omitted", эти блоки приходят с пустым полем thinking наряду с их signature. Код, читающий ответ по позиции, например content[0].text или обработчик потока, который считает первое событие content_block_start текстом, ломается на таких ответах. Вместо этого выбирайте блоки содержимого по их полю type: читайте text из блоков, у которых type равен "text", и ветвитесь по типу блока при обработке событий потока. Чтобы получать читаемые сводки мышления вместо пустого поля thinking, установите display: "summarized"; см. Управление отображением мышления.

    Если вы используете цикл использования инструментов, передавайте блоки thinking из каждого ответа ассистента обратно в API полностью и без изменений при возврате результатов инструментов, включая блоки с пустым полем thinking. Возвращайте сообщение ассистента в том виде, в каком оно получено, а не фильтруйте его блоки содержимого по типу и не пересобирайте его: API отклоняет отредактированные, переупорядоченные или частично удалённые блоки мышления с ошибкой 400. См. Сохранение блоков мышления.

  2. Отключение мышления ограничено уровнем effort high: Вы можете отключить мышление с помощью thinking: {type: "disabled"}, но только при уровне effort high или ниже. Запрос, сочетающий thinking: {type: "disabled"} с effort xhigh или max, возвращает ошибку 400. Claude Opus 4.7 принимает такое сочетание, поэтому перед миграцией проверьте запросы, отключающие мышление.

    Проверка выполняется для каждого запроса: конфигурация effort и мышления каждого запроса валидируется независимо, поэтому запрос, повышающий effort до xhigh или max при отключённом мышлении, отклоняется, даже если более ранние запросы в разговоре были приняты.

    До (принимается на Claude Opus 4.7, отклоняется на Claude Opus 5):

    client.messages.create(
    model="claude-opus-4-7",
    max_tokens=16000,
    thinking={"type": "disabled"},
    output_config={"effort": "xhigh"},
    messages=[{"role": "user", "content": "..."}],
)

    После (Claude Opus 5) — либо удалите поле thinking, чтобы выполнять запросы с мышлением:

    client.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    output_config={"effort": "xhigh"},  # thinking is on by default
    messages=[{"role": "user", "content": "..."}],
)

    либо оставьте мышление отключённым и понизьте effort:

    client.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    thinking={"type": "disabled"},
    output_config={"effort": "high"},  # or "medium", "low"
    messages=[{"role": "user", "content": "..."}],
)

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

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

  1. Параметры сэмплирования (без изменений): Установка temperature, top_p или top_k в значение, отличное от значения по умолчанию, возвращает ошибку 400 на Claude Opus 5, как и на Claude Opus 4.7. Большинство SDK по-прежнему определяют эти поля для совместимости с более ранними моделями, поэтому код, который их задаёт, проходит проверку типов, хотя API отклоняет запрос. Python SDK (v1.0 и новее) их не определяет, и их передача вызывает TypeError. Если вы удалили эти параметры при миграции на Opus 4.7, дальнейших изменений не требуется.

  2. Effort по умолчанию — high: Значение параметра effort по умолчанию на Claude Opus 5 — high на Claude API и в Claude Code. Если вы уже задаёте effort явно, ваша настройка не меняется.

  3. Уровни effort перекалиброваны: Распределение токенов, стоящее за каждым уровнем effort, на Claude Opus 5 отличается от Claude Opus 4.7, и Claude Opus 5 поддерживает полный набор уровней effort (low, medium, high, xhigh, max). Проведите новый перебор уровней effort на собственных оценках, а не переносите настройку, подобранную для Claude Opus 4.7. Уровни low и medium стоит протестировать как средства контроля затрат и задержки, а effort max — там, где максимальные возможности важнее расхода токенов. Если вы работаете на effort xhigh или max, задайте большое значение max_tokens, чтобы у модели было пространство для размышлений и действий; начните с 64 тыс. токенов и настраивайте дальше. См. Effort.

  4. Контекстное окно на 1 млн токенов по умолчанию: Claude Opus 5 по умолчанию предоставляет полное контекстное окно на 1 млн токенов без бета-заголовка и без надбавки за длинный контекст. Если ваш клиент передаёт бета-заголовок контекстного окна для совместимости со старыми моделями, на Claude Opus 5 его можно удалить.

  5. Системные сообщения в ходе разговора: Claude Opus 5 принимает сообщения с role: "system" сразу после хода пользователя в массиве messages (с учётом правил размещения). Используйте поле верхнего уровня system для инструкций, действующих с самого начала. Claude Opus 4.7 отклоняет role: "system" в messages с ошибкой 400. Если вы поддерживаете ветки кода, которые пересобирают полную историю сообщений для обновления инструкций, вы можете упростить их и сохранить попадания в кэш подсказок на более ранних ходах.

  6. Детали остановки при отказе: Объект stop_details в ответах с отказом (доступный начиная с Claude Opus 4.7) теперь публично документирован. Когда модель отклоняет запрос, он указывает категорию отказа в дополнение к существующей причине остановки refusal. Бета-заголовок не требуется, и возможности отказаться от этого нет. См. Обработка причин остановки.

  7. Сниженный минимум для кэширования подсказок: Минимальная кэшируемая длина подсказки на Claude Opus 5 составляет 512 токенов — меньше, чем на Claude Opus 4.7. Подсказки, которые были слишком короткими для кэширования на Claude Opus 4.7, теперь могут создавать записи кэша без каких-либо изменений в коде. Минимумы для каждой модели см. в разделе Кэширование подсказок.

  8. Быстрый режим: Claude Opus 5 поддерживает быстрый режим (исследовательская предварительная версия); быстрый режим недоступен на Claude Opus 4.7, где запросы с speed: "fast" возвращают ошибку. Параметр speed: "fast" и бета-заголовок fast-mode-2026-02-01 работают на Claude Opus 5 без изменений.

Они не обязательны, но улучшат ваш опыт:

  1. Рассмотрите автоматические резервные модели (fallbacks): Claude Opus 5 поставляется с классификаторами безопасности в области кибербезопасности, отказы которых в кибер-категории могут переключаться на Claude Opus 4.8. Чтобы автоматически повторно выполнять отклонённые запросы на другой модели, рассмотрите параметр fallbacks в режиме "default" (fallbacks: "default"), который выбирает рекомендуемую резервную модель на основе категории отказа вместо поддерживаемого вручную списка моделей. Серверный fallback находится в бета-версии; режим "default" требует бета-заголовка server-side-fallback-2026-07-01. См. Отказы и fallback.

  2. Меняйте инструменты в ходе разговора (бета): Вы можете добавлять или удалять инструменты между ходами разговора, не инвалидируя попадания в кэш подсказок на более ранних ходах. Отправьте бета-заголовок mid-conversation-tool-changes-2026-07-01. Это полезно для агентных рабочих нагрузок, которые открывают инструменты постепенно или выводят их из использования по мере продвижения задачи; без него изменённый список инструментов инвалидирует кэшированный префикс.

  3. Перенастройте подсказки, касающиеся длины и многословности: Видимые ответы и письменные результаты по умолчанию на Claude Opus 5 длиннее, чем на более ранних моделях Opus, а понижение effort уменьшает объём мышления, но не сокращает видимый ответ надёжным образом. Вместо этого явно запрашивайте краткость или целевую длину. См. Длина ответа и многословность и Длина письменных результатов.

  4. Удалите перенесённые инструкции по проверке и ограничьте область задачи: Claude Opus 5 проверяет свою работу без указаний, поэтому удалите явные инструкции по проверке или самопроверке, перенесённые из подсказок, настроенных для более ранних моделей; если их оставить, это приводит к избыточной проверке. Для узких задач явно ограничивайте область задачи. В мультиагентных фреймворках давайте явные указания о том, какие сценарии требуют делегирования, или ограничивайте число субагентов, поскольку Claude Opus 5 делегирует охотнее, чем более ранние модели. См. Область задачи и избыточная проверка и Управление порождением субагентов.

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

  • Обновите имя модели с claude-opus-4-7 на claude-opus-5 (или обновите псевдонимы).
  • Проверьте рабочие нагрузки, которые выполнялись без поля thinking: на Claude Opus 5 они выполняются с мышлением. Пересмотрите max_tokens, который остаётся жёстким ограничением на общий объём вывода (мышление плюс текст ответа), или передайте thinking: {type: "disabled"} при effort high или ниже, чтобы сохранить прежнее поведение. Если вы отключаете мышление, ознакомьтесь с разделом Работа с отключённым мышлением, где описаны возможные артефакты вывода и способы их смягчения с помощью подсказок.
  • Обновите разбор ответов, читающий содержимое по позиции, например content[0].text или обработчик потока, предполагающий, что первый блок содержимого — текст: при включённом мышлении блоки thinking приходят перед блоками text. Вместо этого выбирайте блоки содержимого по type.
  • Если вы используете цикл использования инструментов, передавайте блоки thinking обратно полностью и без изменений при возврате результатов инструментов; изменённые блоки возвращают ошибку 400. См. Сохранение блоков мышления.
  • Убедитесь, что любой код, разбирающий поле thinking, рассматривает его только как текст для отображения. thinking.display на Claude Opus 5 по умолчанию равен "omitted", как и на Claude Opus 4.7, поэтому блоки мышления приходят с пустым полем thinking; установите display: "summarized", чтобы получать читаемые сводки. См. Управление отображением мышления.
  • Проверьте запросы, отключающие мышление: thinking: {type: "disabled"} с effort xhigh или max возвращает ошибку 400, проверяемую для каждого запроса. Снова включите мышление или понизьте effort до high или ниже.
  • Если вы удалили параметры сэмплирования при миграции на Opus 4.7, никаких действий не требуется. Если вы снова добавили их с веткой повторной попытки при ошибке 400, удалите эту ветку повторной попытки.
  • Переоцените настройку effort: проведите новый перебор уровней effort на собственных оценках, а не переносите настройку, подобранную для Claude Opus 4.7. Протестируйте уровни low и medium как средства контроля затрат и задержки, а effort max — там, где максимальные возможности важнее расхода токенов. Если вы работаете на effort xhigh или max, поднимите max_tokens как минимум до 64 тыс. в качестве отправной точки.
  • Удалите любой бета-заголовок контекстного окна. Контекстное окно на 1 млн токенов используется по умолчанию на Claude API, Amazon Bedrock, Google Cloud и Microsoft Foundry.
  • Если вы пересобираете историю разговора для обновления инструкций, рассмотрите переход на системное сообщение в ходе разговора, чтобы сохранить попадания в кэш подсказок.
  • Убедитесь, что ваша обработка причин остановки читает stop_details при отказах (доступно начиная с Claude Opus 4.7; теперь публично документировано), и рассмотрите fallbacks: "default" (бета) для автоматического повторного выполнения отклонённых запросов на рекомендуемой резервной модели.
  • Проверьте подсказки, близкие к минимуму кэширования: подсказки от 512 токенов теперь могут создавать записи кэша.
  • Если вы используете web fetch, запланируйте альтернативу: он недоступен на Claude Opus 5.
  • Если у вашей организации есть обязательства по Priority Tier, учтите, что Priority Tier не поддерживается на Claude Opus 5.
  • Если вы использовали быстрый режим на Claude Opus 4.7, никаких изменений в запросах, кроме идентификатора модели, не требуется: speed: "fast" и бета-заголовок fast-mode-2026-02-01 работают на Claude Opus 5 без изменений.
  • Для агентных рабочих нагрузок рассмотрите бюджеты задач (бета) и изменение инструментов в ходе разговора (бета).
  • Перенастройте подсказки, касающиеся длины и многословности, и удалите инструкции по проверке и самопроверке, перенесённые из подсказок, настроенных для более ранних моделей.
  • Заново определите базовые показатели затрат и задержки на выбранном уровне effort. Цена за токен не изменилась по сравнению с Claude Opus 4.7, но токены мышления тарифицируются как выходные токены, поэтому рабочие нагрузки, выполнявшиеся без мышления, могут производить больше выходных токенов на запрос.

Миграция на Claude Opus 5 с Claude Opus 4.6 и более ранних моделей Opus

Claude Opus 5 должен демонстрировать высокую производительность «из коробки» на существующих подсказках и оценках для Claude Opus 4.6 по той же цене, но есть несколько поведенческих изменений и изменений API, о которых стоит знать при миграции. Большинство этих изменений вступили в силу в Claude Opus 4.7; ещё два — мышление, включённое по умолчанию, и ограничение по effort при отключении мышления — вступают в силу на Claude Opus 5. Все они описаны в этом разделе, поэтому он является полным для кода, переходящего напрямую с Claude Opus 4.6. Claude Opus 5 поддерживает тот же набор функций, что и Claude Opus 4.6, включая:

Два исключения: web fetch недоступен на Claude Opus 5, и Priority Tier не поддерживается на Claude Opus 5. На Claude API и Google Cloud Claude Opus 5 также поддерживает использование компьютера в виде стабильного набора инструментов computer_toolset_20260801 и инструмент использования браузера для задач внутри веб-страниц — ни то, ни другое Claude Opus 4.6 и более ранние модели Opus не поддерживают; существующие интеграции на более ранней версии computer_20251124 продолжают работать без изменений на Claude Opus 5. Чтобы обновить существующую интеграцию, см. Миграция с computer_20251124.

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

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

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

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

    До (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 5):

    client.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},  # or "max", "xhigh", "medium", "low"
    messages=[{"role": "user", "content": "..."}],
)

    Адаптивным мышлением можно управлять с помощью подсказок и параметра effort; см. Выбор уровня effort.

  2. Мышление включено по умолчанию: На Claude Opus 4.6 и Claude Opus 4.7 запросы без поля thinking выполняются без мышления; на Claude Opus 5 те же запросы выполняются с адаптивным мышлением. max_tokens остаётся жёстким ограничением на общий объём вывода — мышление плюс текст ответа, — поэтому пересмотрите его для рабочих нагрузок, которые выполнялись без мышления. Токены мышления тарифицируются как выходные токены, даже если текст мышления вам не возвращается, поэтому, хотя цена за токен не изменилась, рабочая нагрузка, которая выполнялась без мышления, может производить больше выходных токенов на запрос на Claude Opus 5; см. Контроль затрат. Чтобы сохранить прежнее поведение, передайте thinking: {type: "disabled"} с учётом ограничения по effort из следующего пункта; обратите внимание, что при отключённом мышлении модель иногда может выдавать вызовы инструментов в виде обычного текста или включать внутренние XML-теги в видимый вывод, поэтому по возможности предпочитайте более низкие уровни effort с включённым мышлением, а там, где это невозможно, см. Работа с отключённым мышлением для способов смягчения.

    Вместе с этим меняется и форма ответа. При включённом мышлении ответ может начинаться с одного или нескольких блоков thinking перед первым блоком text, и поскольку содержимое мышления по умолчанию опускается на Claude Opus 5 (пункт 5 в этом списке), эти блоки приходят с пустым полем thinking наряду с их signature. Код, который читает ответ по позиции, например content[0].text или обработчик потока, который считает первое событие content_block_start текстом, ломается на таких ответах. Вместо этого выбирайте блоки содержимого по их полю type: читайте text из блоков, у которых type равен "text", и выполняйте ветвление по типу блока при обработке событий потока.

    Если вы запускаете цикл использования инструментов, передавайте блоки thinking из каждого ответа ассистента обратно в API полностью и без изменений при возврате результатов инструментов, включая блоки с пустым полем thinking. Возвращайте сообщение ассистента в том виде, в котором оно получено, а не фильтруйте его блоки содержимого по типу и не пересобирайте его: API отклоняет отредактированные, переупорядоченные или частично удалённые блоки мышления с ошибкой 400. См. Сохранение блоков мышления.

  3. Отключение мышления ограничено уровнем effort high: Вы можете отключить мышление с помощью thinking: {type: "disabled"}, но только при уровне effort high или ниже. Запрос, сочетающий thinking: {type: "disabled"} с effort xhigh или max, возвращает ошибку 400 на Claude Opus 5, что проверяется для каждого запроса. Проведите аудит запросов, отключающих мышление, перед миграцией: снова включите мышление или понизьте effort до high или ниже.

  4. Параметры сэмплирования удалены: Установка temperature, top_p или top_k в любое значение, отличное от значения по умолчанию, на Claude Opus 4.7 и более поздних моделях, включая Claude Opus 5, возвращает ошибку 400. Python SDK (v1.0 и новее) не определяет их, и их передача вызывает TypeError. Самый безопасный путь миграции — полностью исключить эти параметры из тел запросов. Подсказки — рекомендуемый способ управления поведением модели на Claude Opus 5. Если вы использовали temperature = 0 для детерминированности, учтите, что это никогда не гарантировало идентичных результатов на предыдущих моделях.

  5. Содержимое мышления по умолчанию опускается: Блоки мышления по-прежнему появляются в потоке ответа на Claude Opus 4.7 и более поздних моделях, но их поле thinking пусто, если вы явно не включите его. Это негласное изменение по сравнению с Claude Opus 4.6, где по умолчанию возвращался обобщённый текст мышления. Чтобы восстановить обобщённое содержимое мышления, установите thinking.display в "summarized":

    thinking = {
    "type": "adaptive",
    "display": "summarized",
}

    Значение по умолчанию — "omitted" на Claude Opus 4.7 и более поздних моделях. Если ваш продукт передаёт рассуждения пользователям в потоковом режиме, новое значение по умолчанию проявляется как долгая пауза перед началом вывода; установите display: "summarized", чтобы восстановить видимый прогресс во время мышления. Подробности см. в разделе Управление отображением мышления.

  6. Обновлённый подсчёт токенов: В Claude Opus 4.7 появился новый токенизатор, который также используют более поздние модели Opus, включая Claude Opus 5. Он способствует повышению производительности в широком спектре задач и может использовать примерно от 1x до 1,35x токенов при обработке текста по сравнению с моделями до Claude Opus 4.7 (до ~35% больше, в зависимости от содержимого).

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

    Вмешательства на уровне подсказок, task_budget и effort могут помочь контролировать затраты и обеспечить надлежащее использование токенов. Эти средства управления могут снижать интеллект модели. Обновите параметры max_tokens, чтобы обеспечить дополнительный запас, включая триггеры компактизации. Claude Opus 5 предоставляет контекстное окно в 1M по стандартным ценам API без надбавки за длинный контекст.

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

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

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

  • max: Может дать прирост на самых сложных задачах, но может демонстрировать убывающую отдачу от увеличенного расхода токенов и склонность к избыточному обдумыванию на более простых. Тестируйте его там, где максимальные возможности важнее расхода токенов.
  • xhigh: Расширенные возможности для длительной агентной работы и программирования, требующих большей глубины, чем по умолчанию.
  • high: Значение по умолчанию. Балансирует расход токенов и интеллект для большинства задач.
  • medium: Экономичная ступень ниже значения по умолчанию, которую стоит протестировать как средство контроля затрат и задержки.
  • low: Наиболее эффективный. Оставьте для коротких, ограниченных по объёму задач и рабочих нагрузок, чувствительных к задержке.

Если вы работаете на уровне effort xhigh или max, установите большое значение max_tokens, чтобы у модели было пространство для мышления и действий; начните с 64k токенов и настраивайте далее. Effort важнее для этой модели, чем для любой предыдущей Opus. Активно экспериментируйте с ним при обновлении.

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

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

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

    Если ваш продукт зависит от определённого стиля или многословности вывода, вам может потребоваться настроить подсказки. Например, чтобы уменьшить многословность, добавьте: «Provide concise, focused responses. Skip non-essential context, and keep examples minimal.» Если вы наблюдаете конкретные виды избыточных объяснений, добавьте в подсказку целевые инструкции для их предотвращения.

    Положительные примеры, показывающие, как Claude может общаться с надлежащим уровнем краткости, как правило, эффективнее отрицательных примеров или инструкций, говорящих модели, чего не делать. На Claude Opus 5 видимые ответы и письменные результаты по умолчанию длиннее, чем на более ранних моделях Opus, а снижение effort уменьшает объём мышления, но не сокращает надёжно видимый ответ; явно запрашивайте краткость или целевую длину. См. Длина ответа и многословность.

  2. Более буквальное следование инструкциям: Claude Opus 4.7 интерпретирует подсказки более буквально и явно, чем Claude Opus 4.6, особенно на низких уровнях effort. Он не обобщает молча инструкцию с одного элемента на другой и не выводит запросы, которых вы не делали. Преимущество этой буквальности — точность и меньше метаний. Как правило, он работает лучше для сценариев использования API с тщательно настроенными подсказками, структурированным извлечением и конвейерами, где требуется предсказуемое поведение. Пересмотр подсказок и обвязки может быть особенно полезен при миграции на Claude Opus 5.

  3. Более прямой тон: Как и с любой новой моделью, стиль прозы в длинных текстах может измениться. Claude Opus 4.7 более прямолинеен и категоричен, с меньшим количеством одобрительных формулировок и эмодзи, чем более тёплый стиль Claude Opus 4.6. Если ваш продукт опирается на определённый голос, переоцените стилевые подсказки относительно новой базовой линии.

  4. Встроенные обновления о прогрессе в агентных трассах: Claude Opus 4.7 предоставляет пользователю более регулярные и качественные обновления на протяжении длинных агентных трасс. Если вы добавили обвязку для принудительных промежуточных сообщений о статусе («After every 3 tool calls, summarize progress»), попробуйте её удалить. Если вы обнаружите, что длина или содержание обращённых к пользователю обновлений Claude Opus 4.7 плохо откалиброваны для вашего сценария, явно опишите в подсказке, как должны выглядеть эти обновления, и приведите примеры.

  5. Изменилось порождение субагентов: Claude Opus 4.7 по умолчанию склонен порождать меньше субагентов, чем Claude Opus 4.6, тогда как Claude Opus 5 делегирует субагентам охотнее, чем более ранние модели. Этим поведением можно управлять с помощью подсказок в любом направлении; дайте явные указания о том, когда субагенты желательны, или ограничьте их количество. См. Управление порождением субагентов.

  6. Более строгая калибровка effort: Существенно отличаясь от Claude Opus 4.6, Claude Opus 4.7 строго соблюдает уровни effort, особенно на нижнем конце. На low и medium модель ограничивает свою работу тем, что было запрошено, а не делает больше, чем просили.

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

    Если вам нужно сохранить effort на уровне low ради задержки, добавьте целевые указания: «This task involves multistep reasoning. Think carefully through the problem before responding.» См. Рекомендуемые уровни effort для Claude Opus 4.7.

  7. Меньше вызовов инструментов по умолчанию: Claude Opus 4.7 склонен использовать инструменты реже, чем Claude Opus 4.6, и больше полагаться на рассуждения. В большинстве случаев это даёт лучшие результаты.

    Чтобы увеличить использование инструментов, повысьте настройку effort. Настройки effort high или xhigh демонстрируют существенно большее использование инструментов в агентном поиске и программировании. Вы также можете скорректировать подсказку, чтобы явно указать модели, когда и как правильно использовать её инструменты.

  8. Защитные механизмы кибербезопасности в реальном времени: Впервые добавленные в Claude Opus 4.7, запросы, затрагивающие запрещённые или высокорисковые темы, могут приводить к отказам. Для легитимной работы в области безопасности, такой как тестирование на проникновение, исследование уязвимостей или red-teaming, подайте заявку в Cyber Verification Program, чтобы запросить снижение ограничений. Способ подачи заявки зависит от того, как вы получаете доступ к Claude.

  9. Поддержка изображений высокого разрешения: Claude Opus 4.7 — первая модель Claude с поддержкой изображений высокого разрешения. Максимальное разрешение изображения — 2 576 пикселей по длинной стороне, по сравнению с 1 568 пикселями на предыдущих моделях. Это открывает прирост на рабочих нагрузках с интенсивным использованием зрения и особенно ценно для использования компьютера, понимания скриншотов и анализа документов.

    Поддержка высокого разрешения автоматическая и не требует бета-заголовка или включения на стороне клиента. Две вещи, которые следует учесть:

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

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

Они не обязательны, но улучшат ваш опыт:

  1. Переоцените max_tokens: Поскольку тот же текст даёт большее количество токенов на Claude Opus 4.7 и более поздних моделях, обновите параметры max_tokens, чтобы обеспечить дополнительный запас, включая триггеры компактизации. Вмешательства на уровне подсказок, task_budget и effort могут помочь контролировать затраты и обеспечить надлежащее использование токенов.

  2. Проведите аудит ожиданий по количеству токенов: Любой путь кода, который оценивает токены на стороне клиента или предполагает фиксированное соотношение токенов к символам, следует повторно протестировать на Claude Opus 5. Используйте конечную точку подсчёта токенов для проверки.

  3. Внедрите бюджеты задач (бета): Claude Opus 4.7 вводит бюджеты задач. Эти бюджеты позволяют сообщить Claude, сколько токенов у него есть на полный агентный цикл, включая мышление, вызовы инструментов, результаты инструментов и финальный вывод. Модель видит текущий обратный отсчёт и использует его для приоритизации работы и корректного завершения задачи по мере расходования бюджета. Для использования установите бета-заголовок task-budgets-2026-03-13 и добавьте следующее в конфигурацию вывода:

    output_config = {
    "effort": "high",
    "task_budget": {"type": "tokens", "total": 128000},
}

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

    Для открытых агентных задач, где качество важнее скорости, не устанавливайте бюджет задачи. Оставьте бюджеты задач для рабочих нагрузок, где вам нужно, чтобы модель ограничивала свою работу выделенным объёмом токенов. Минимальное значение бюджета задачи — 20k токенов.

    Бюджет задачи — не жёсткий предел; это рекомендация, о которой модель знает. Он отличается от max_tokens:

    • task_budget: рекомендательный предел на весь агентный цикл. Модель видит его и использует для распределения темпа.
    • max_tokens: жёсткий потолок генерируемых токенов на запрос. Он не передаётся модели, поэтому модель о нём не знает.

    Используйте task_budget, когда хотите, чтобы модель сама себя ограничивала, а max_tokens — как жёсткий потолок для ограничения использования.

  4. Установите большое значение max_tokens при effort max или xhigh: Если вы запускаете Claude Opus 4.7 или более позднюю модель на уровне effort max или xhigh, установите большой бюджет максимальных выходных токенов, чтобы у модели было пространство для мышления и действий через её субагентов и вызовы инструментов. Начните с 64k токенов и настраивайте далее.

  5. Уменьшайте разрешение изображений, если высокое разрешение не нужно: Claude Opus 4.7 и более поздние модели поддерживают изображения до 2576px / 3,75MP. Изображения высокого разрешения используют больше токенов. Если дополнительная детализация изображения не нужна, уменьшайте разрешение изображений перед отправкой в Claude, чтобы избежать роста расхода токенов. См. Изображения и зрение.

  6. Рассмотрите автоматические резервные варианты: Claude Opus 5 поставляется с классификаторами безопасности в области кибербезопасности, отказы которых по кибер-категории могут переключаться на Claude Opus 4.8. Чтобы автоматически повторно выполнять отклонённые запросы на другой модели, рассмотрите параметр fallbacks в режиме "default" (fallbacks: "default"), который выбирает рекомендуемую резервную модель на основе категории отказа вместо поддерживаемого вручную списка моделей. Резервное переключение на стороне сервера находится в бета-версии; режим "default" требует бета-заголовка server-side-fallback-2026-07-01. См. Отказы и резервное переключение.

  7. Кэшируйте более короткие подсказки: Минимальная кэшируемая длина подсказки на Claude Opus 5 — 512 токенов, что ниже, чем на более ранних моделях Opus. Подсказки, которые были слишком короткими для кэширования, теперь могут создавать записи кэша без каких-либо изменений кода. Минимумы для каждой модели см. в разделе Кэширование подсказок.

  8. Меняйте инструменты в середине разговора (бета): Вы можете добавлять или удалять инструменты между ходами разговора, не аннулируя попадания в кэш подсказок на более ранних ходах. Отправьте бета-заголовок mid-conversation-tool-changes-2026-07-01. Это полезно для агентных рабочих нагрузок, которые открывают инструменты постепенно или выводят их из использования по мере продвижения задачи; без него изменённый список инструментов аннулирует кэшированный префикс.

  9. Удалите перенесённые инструкции по проверке и ограничьте область задачи: Claude Opus 5 проверяет свою работу без указаний, поэтому удалите явные инструкции по проверке или самопроверке, перенесённые из подсказок, настроенных для более ранних моделей; если их оставить, это приводит к избыточной проверке. Для узких задач явно ограничивайте область задачи. См. Область задачи и избыточная проверка.

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

  • Обновите имя модели с claude-opus-4-6 на claude-opus-5 (или обновите псевдонимы).
  • Удалите temperature, top_p и top_k из тел запросов.
  • Замените thinking: {type: "enabled", budget_tokens: N} на thinking: {type: "adaptive"} плюс параметр effort или полностью удалите поле thinking; адаптивное мышление включено по умолчанию на Claude Opus 5.
  • Проверьте рабочие нагрузки, которые выполнялись без поля thinking: на Claude Opus 5 они выполняются с мышлением. Пересмотрите max_tokens, который остаётся жёстким ограничением на общий объём вывода (мышление плюс текст ответа), или передайте thinking: {type: "disabled"} при effort high или ниже, чтобы сохранить прежнее поведение.
  • Обновите разбор ответов, который читает содержимое по позиции, например content[0].text или обработчик потока, предполагающий, что первый блок содержимого — текст: при включённом мышлении блоки thinking приходят перед блоками text. Вместо этого выбирайте блоки содержимого по type.
  • Если вы запускаете цикл использования инструментов, передавайте блоки thinking обратно полностью и без изменений при возврате результатов инструментов; изменённые блоки возвращают ошибку 400. См. Сохранение блоков мышления.
  • Проведите аудит запросов, отключающих мышление: thinking: {type: "disabled"} с effort xhigh или max возвращает ошибку 400, что проверяется для каждого запроса. Снова включите мышление или понизьте effort до high или ниже.
  • Удалите любые предзаполнения сообщений ассистента.
  • Если ваш интерфейс отображает содержимое мышления, явно включите обобщение мышления.
  • Повторно измерьте сквозные затраты и задержку при обновлённой токенизации; токены мышления тарифицируются как выходные токены, поэтому рабочие нагрузки, которые выполнялись без мышления, также могут производить больше выходных токенов на запрос.
  • Перенастройте max_tokens с учётом обновлённой токенизации.
  • Повторно протестируйте любые оценки количества токенов на стороне клиента.
  • Если ваше приложение отправляет изображения, пересмотрите бюджет с учётом поддержки изображений высокого разрешения (примерно до 3x больше токенов изображения на изображение в полном разрешении). Уменьшайте разрешение перед отправкой, если дополнительная детализация вам не нужна.
  • Если вы используете координаты указания или ограничивающих рамок от модели, удалите любое преобразование масштабного коэффициента; координаты соотносятся 1:1 с реальными пикселями изображения на Claude Opus 4.7 и более поздних моделях.
  • Проверьте подсказки на предмет изменений поведения (длина ответа, буквальность, тон, обновления о прогрессе, субагенты, калибровка effort, срабатывание инструментов, кибер-защита, обработка изображений высокого разрешения).
  • Заново определите базовую длину ответа, удалив существующие подсказки для контроля длины, затем настройте явно.
  • При использовании effort xhigh или max повысьте max_tokens как минимум до 64k в качестве отправной точки.
  • Рассмотрите внедрение бюджетов задач (бета) и изменения инструментов в середине разговора (бета) для агентных рабочих процессов.
  • Обрабатывайте stop_reason: "refusal" и рассмотрите fallbacks: "default" (бета) для автоматического повторного выполнения отклонённых запросов на рекомендуемой резервной модели.
  • Проверьте подсказки, близкие к минимуму кэширования: подсказки из 512 токенов и более теперь могут создавать записи кэша на Claude Opus 5.
  • Если вы используете web fetch, запланируйте альтернативу: он недоступен на Claude Opus 5.
  • Если у вашей организации есть обязательство по Priority Tier, учтите, что Priority Tier не поддерживается на Claude Opus 5.
  • Удалите инструкции по проверке и самопроверке, перенесённые из подсказок, настроенных для более ранних моделей; они вызывают избыточную проверку на Claude Opus 5.
  • Если ваш продукт выполняет легитимную работу в области безопасности, подайте заявку в Cyber Verification Program для доступа к сниженным ограничениям на кибер-контент.

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

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

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

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

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

  1. Удаление предзаполнения описано в критических изменениях при миграции с Claude Opus 4.6.

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

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

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

    response = client.beta.messages.create(
    model="claude-opus-4-5",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 32000},
    betas=["interleaved-thinking-2025-05-14"],
    messages=[{"role": "user", "content": "Your prompt here"}],
)

    Обратите внимание, что миграция также переходит с client.beta.messages.create на client.messages.create. Адаптивное мышление и effort не требуют бета-пространства имён SDK или каких-либо бета-заголовков.

  2. Удалите бета-заголовок effort: Параметр effort не требует бета-заголовка. Удалите betas=["effort-2025-11-24"] из ваших запросов.

  3. Удалите бета-заголовок детализированной потоковой передачи инструментов: Детализированная потоковая передача инструментов не требует бета-заголовка. Удалите betas=["fine-grained-tool-streaming-2025-05-14"] из ваших запросов.

  4. Удалите бета-заголовок чередующегося мышления: Адаптивное мышление автоматически включает чередующееся мышление на Claude Opus 4.7, Opus 4.6 и Sonnet 4.6. Удалите betas=["interleaved-thinking-2025-05-14"] из ваших запросов. Заголовок по-прежнему работает на Sonnet 4.6 с ручным расширенным мышлением, но ручной режим устарел.

  5. Перейдите на output_config.format: Если вы используете структурированные выходные данные, обновите output_format={...} на output_config={"format": {...}}. API по-прежнему принимает устаревший параметр output_format, но он будет удалён в будущем выпуске модели. Python SDK (v1.0 и новее) не принимает output_format={...} в client.beta.messages.create() или count_tokens(). Аргумент output_format=Model вспомогательных функций parse() и stream() не изменился.

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

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

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

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

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

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

    Начиная с Claude Opus 4.7, установка temperature, top_p или top_k в любое значение, отличное от значения по умолчанию, возвращает ошибку 400. Python SDK (v1.0 и новее) не определяет их, и их передача вызывает TypeError. Самый безопасный путь миграции — полностью исключить эти параметры из запросов и использовать подсказки для управления поведением модели. Если вы использовали 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-5",
    # ...
)

  2. Обновите версии инструментов

    Обновитесь до последних версий инструментов. Удалите любой код, использующий команду undo_edit.

    # До
tools = [{"type": "text_editor_20250124", "name": "str_replace_editor"}]

# После
tools = [{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]

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

    Обновите ваше приложение для обработки причин остановки refusal:

    response = client.messages.create(...)

if response.stop_reason == "refusal":
    # Обработайте отказ соответствующим образом
    pass

  4. Обрабатывайте причину остановки 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

  5. Проверьте обработку параметров инструментов (завершающие переводы строк)

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

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

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

  • Удалите устаревшие бета-заголовки: Удалите token-efficient-tools-2025-02-19 и output-128k-2025-02-19. Все модели Claude 4+ имеют встроенное токен-эффективное использование инструментов, и эти заголовки не оказывают никакого эффекта.

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

  • Обновите идентификатор модели на claude-opus-5
  • Примените все критические изменения для миграции с Claude Opus 4.6 (расширенное мышление удалено, мышление включено по умолчанию, ограничение уровня усилий при отключении мышления, параметры сэмплирования удалены, отображение мышления по умолчанию опущено, обновлённая токенизация)
  • КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Удалите предзаполнения сообщений ассистента (возвращает ошибку 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_20260521)
  • При миграции с 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 Opus 5 с Claude Sonnet 5

Claude Opus 5 и Claude Sonnet 5 имеют одинаковую поверхность API: обе модели работают с включённым по умолчанию адаптивным мышлением, обе по умолчанию устанавливают параметр effort в значение high в Claude API и Claude Code, обе по умолчанию предоставляют «context window» (контекстное окно) размером 1M токенов с максимумом в 128k выходных токенов, и ни одна из них не поддерживает Priority Tier. Ручное расширенное мышление и параметры сэмплирования, отличные от значений по умолчанию, возвращают ошибку 400 на обеих моделях, как и предзаполнение сообщений ассистента.

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

model = "claude-sonnet-5"  # Before
model = "claude-opus-5"  # After

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

  1. Цены: Claude Opus 5 стоит $5 за миллион входных токенов и $25 за миллион выходных токенов. Claude Sonnet 5 стоит $2/$10 за миллион входных/выходных токенов. Полную информацию о ценах см. в разделе Цены на Claude.

  2. Отключение мышления ограничено уровнем усилий high: В Claude Sonnet 5 thinking: {type: "disabled"} принимается при любом уровне усилий. В Claude Opus 5 оно принимается только при уровне effort high или ниже; запрос, сочетающий thinking: {type: "disabled"} с уровнем усилий xhigh или max, возвращает ошибку 400, что проверяется для каждого запроса. Перед миграцией проведите аудит запросов, отключающих мышление.

  3. Системные сообщения в середине разговора: Claude Opus 5 принимает сообщения с role: "system" непосредственно после хода пользователя в массиве messages (с учётом правил размещения). Эта функция недоступна в Claude Sonnet 5. Если вы поддерживаете ветки кода, которые перестраивают полную историю сообщений для обновления инструкций, вы можете упростить их и сохранить попадания в кэш подсказок на более ранних ходах.

  4. Web fetch недоступен: Инструмент web fetch доступен в Claude Sonnet 5, но не в Claude Opus 5.

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

  • Обновите название модели с claude-sonnet-5 на claude-opus-5.
  • Проведите аудит запросов, отключающих мышление: thinking: {type: "disabled"} с уровнем усилий xhigh или max возвращает ошибку 400 в Claude Opus 5. Снова включите мышление или снизьте уровень усилий до high или ниже.
  • Если вы используете web fetch, запланируйте альтернативу: он недоступен в Claude Opus 5.
  • Повторно выполните подсчёт токенов для Claude Opus 5 вместо повторного использования значений, измеренных для Claude Sonnet 5, и заново определите базовые показатели стоимости и задержки на ваших собственных рабочих нагрузках; цены за токен различаются.

Was this page helpful?