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

Руководство по миграции на Claude Opus 5.5

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

Claude Code

Позвольте Claude Code выполнить миграцию вашего кода за вас

/claude-api migrate этот проект на claude-opus-5-5

На этой странице перечислены изменения в коде, необходимые для перехода на Claude Opus 5.5 с Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6 и более ранних моделей Opus или Claude Sonnet 5. Каждому читателю нужны разделы Требования к каждому запросу к Claude Opus 5.5 и Обработка размышлений в каждом ответе. Затем перейдите к разделу для вашей текущей модели: в его первом предложении перечислены другие разделы, которые относятся к вам. В контрольном списке миграции перечислены все изменения в зависимости от исходной модели.

Claude Opus 5.5 стоит дешевле, чем Claude Opus 5 ($4 / $20 USD за миллион входных / выходных токенов по сравнению с $5 / $25 USD; см. цены на Claude). Сведения о поддержке функций см. в разделе Что нового в Claude Opus 5.5. О различиях в поведении и шаблонах подсказок для конкретной модели см. Составление подсказок для Claude Opus 5.5.

Требования к каждому запросу к Claude Opus 5.5

С какой бы модели вы ни переходили, запрос к claude-opus-5-5 должен соответствовать следующим требованиям. Если в пункте сказано, что параметр отклоняется, API возвращает ошибку 400.

  • Идентификатор модели: используйте claude-opus-5-5 — фиксированный идентификатор модели без суффикса даты. В Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), Claude Models on Google Cloud (Google managed) и Microsoft Foundry используйте идентификатор модели соответствующей платформы; см. раздел Доступность.
  • Размышления: не отправляйте поле thinking или отправьте thinking: {"type": "adaptive"}, что равнозначно: адаптивные размышления («adaptive thinking») всегда включены. thinking: {"type": "disabled"} и ручные бюджеты размышлений (thinking: {"type": "enabled", "budget_tokens": N}) отклоняются. См. сравнение «до и после» для размышлений.
  • Уровень усилий: управляйте глубиной размышлений с помощью параметра effort — единственного параметра запроса, который ею управляет. Поддерживаются все пять уровней (low, medium, high, xhigh, max), по умолчанию используется medium. См. Рекомендуемые уровни effort для Claude Opus 5.5.
  • Выбор инструмента: используйте tool_choice {"type": "auto"} (по умолчанию) или {"type": "none"}. Принудительный вызов инструмента с помощью {"type": "any"} или {"type": "tool", "name": "..."} отклоняется. См. сравнение «до и после» для выбора инструмента.
  • Параметры сэмплирования: не указывайте temperature, top_p и top_k. Для управления поведением модели используйте подсказки.
  • Предзаполнение: не завершайте messages предзаполненной репликой ассистента: такой запрос отклоняется. Вместо этого используйте структурированные выходные данные или инструкции в системной подсказке.
  • Использование компьютера: объявляйте «computer use» (использование компьютера) как набор инструментов computer_toolset_20260801. В Amazon Bedrock также работает computer_20251124. См. критическое изменение для computer use.
  • Контекстное окно: бета-заголовок для «context window» (контекстное окно) не нужен. Контекстное окно на 1M токенов используется по умолчанию, а заголовок, отправляемый для более старых моделей, ни на что не влияет.

Следующий запрос удовлетворяет всем пунктам списка: уровень усилий задан, а поле thinking отсутствует. Там, где пример выводит текст, он находит текстовый блок по его типу, поскольку блоки thinking идут первыми.

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    messages=[
        {
            "role": "user",
            "content": "Analyze the trade-offs between microservices and monolithic architectures",
        }
    ],
    output_config={"effort": "medium"},
)

for block in response.content:
    if block.type == "text":
        print(block.text)

Обработка размышлений в каждом ответе

Размышления выполняются при каждом запросе к Claude Opus 5.5, поэтому каждый ответ может начинаться с блоков thinking, а max_tokens охватывает размышления вместе с текстом. Если ваш код уже работает с включёнными размышлениями, пункты 1–3, скорее всего, уже выполнены: проверьте пункты 4 и 5. Если он работал без размышлений на любой более ранней модели, каждый пункт является изменением.

  1. max_tokens охватывает размышления вместе с текстом: на Claude Opus 4.8 и более ранних моделях Opus запросы без поля thinking выполняются без размышлений. Claude Opus 5 и Claude Sonnet 5 принимают thinking: {"type": "disabled"}. На Claude Opus 5.5 каждый запрос выполняется с адаптивными размышлениями. max_tokens остаётся жёстким ограничением общего объёма вывода — размышлений вместе с текстом ответа, поэтому пересмотрите его для рабочих нагрузок, которые выполнялись без размышлений. Токены размышлений тарифицируются как выходные токены, даже если текст размышлений вам не возвращается, поэтому такая рабочая нагрузка может производить больше выходных токенов на запрос. См. Контроль затрат. Чтобы тратить меньше токенов на размышления, снизьте уровень усилий. Если вы используете уровень усилий xhigh или max, задайте большое значение max_tokens, чтобы у модели было место для размышлений и действий; начните с 64k токенов и настраивайте дальше. Если ваши подсказки были настроены для работы без размышлений, см. Подсказки, написанные для отключённых размышлений.

  2. Ответы начинаются с блоков размышлений: ответ может начинаться с одного или нескольких блоков thinking перед первым блоком text. Код, который читает ответ по позиции, например content[0].text или обработчик потока, считающий первое событие content_block_start текстом, на таких ответах ломается. Вместо этого выбирайте блоки содержимого по их полю type: читайте text из блоков, у которых type равен "text", и ветвитесь по типу блока при обработке событий потока.

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

  4. Текст размышлений по умолчанию опускается: thinking.display по умолчанию имеет значение "omitted", поэтому блоки thinking приходят с пустым полем thinking вместе с их signature. Рассматривайте поле thinking только как текст для отображения. Чтобы вместо этого получать читаемые сводки, установите для thinking.display значение "summarized":

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

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

  5. Текст между вызовами инструментов приходит в блоках размышлений: короткие заметки, которые модель пишет между вызовами инструментов, возвращаются в виде блоков thinking, которые при отображении по умолчанию пусты. См. Текст между вызовами инструментов возвращается в блоках размышлений.

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

Проходите группы сверху вниз и остановитесь после той, в которой названа ваша текущая модель: все пункты до этого места относятся к вам. Если вы используете Claude Opus 5, первая группа — это весь список. Если вы используете Claude Sonnet 5, примените первую и последнюю группы.

Любая исходная модель

  • Обновите идентификатор модели на claude-opus-5-5.
  • Удалите thinking: {"type": "disabled"} и thinking: {"type": "enabled", ...}; вместо этого выберите уровень effort.
  • Задайте effort явно: по умолчанию используется medium, тогда как у Claude Opus 5 — high.
  • Замените типы tool_choice any и tool на auto в сочетании со строгим использованием инструментов или структурированными выходными данными.
  • Если вы используете более раннюю версию инструмента использования компьютера, вместо неё объявите computer_toolset_20260801 (без бета-заголовка) и обновите цикл агента для работы с набором инструментов. В Amazon Bedrock также работает computer_20251124.
  • Если маршрутизатор или резервный механизм может перевести разговор с Claude Opus 5.5 на другую модель, учитывайте, что эта модель будет работать без блоков размышлений Claude Opus 5.5 (исключение составляют Claude Fable 5.1 и Claude Mythos 5.1 в Claude API, которые их сохраняют). Сама Claude Opus 5.5 читает размышления от Claude Opus 5, от более ранних моделей Opus, Sonnet и Haiku, а в Claude API и Claude Models on Google Cloud (Google managed) — также от Claude Sonnet 5.5 и Claude Haiku 5.5, но не от моделей Claude Fable или Claude Mythos.
  • Читайте блоки содержимого по type и передавайте блоки thinking обратно без изменений в циклах использования инструментов.
  • Если ваш интерфейс отображает текст между вызовами инструментов, задайте display: "updates" (бета) или "summarized" и отображайте непустые блоки thinking.
  • Если ваш код изменяет предыдущие реплики, подсказку system или tools посреди разговора, следуйте разделу Сохранённые размышления.
  • Обрабатывайте stop_reason: "refusal" и настройте резервный механизм.
  • Заново определите базовые показатели стоимости и задержки на выбранном уровне effort.
  • Если ваш код отключал размышления, пересмотрите max_tokens, который охватывает размышления плюс текст ответа; при effort xhigh или max начните с 64k. См. Обработка размышлений в каждом ответе.

Claude Opus 4.8 или более ранние

  • Проверьте рабочие нагрузки, которые выполнялись без поля thinking: на Claude Opus 5.5 они выполняются с размышлениями, и размышления нельзя отключить. Пересмотрите max_tokens, который остаётся жёстким ограничением общего объёма вывода (размышления вместе с текстом ответа), и снизьте effort там, где вам нужно меньше размышлений. Токены размышлений тарифицируются как выходные токены, поэтому такие рабочие нагрузки могут производить больше выходных токенов на запрос.
  • Убедитесь, что любой код, разбирающий поле thinking, рассматривает его только как текст для отображения. Установите display: "summarized", чтобы получать читаемые сводки.
  • Проверьте подсказки, близкие к минимальному размеру для кэширования: подсказки от 512 токенов и более могут создавать записи кэша.
  • Если у вашей организации есть обязательство по Priority Tier, планируйте мощности отдельно: Priority Tier не поддерживается на Claude Opus 5.5.
  • Если вы используете уровень усилий xhigh или max, для начала увеличьте max_tokens как минимум до 64k.
  • Для агентных рабочих нагрузок рассмотрите бюджеты задач (бета) и изменение инструментов посреди разговора (бета).

Claude Opus 4.7 или более ранние

  • Проведите новый перебор уровней усилий на ваших собственных оценках, а не переносите настройку, подобранную для более ранней модели.
  • Удалите любой заголовок бета-версии для контекстного окна.
  • Если вы пересобираете историю разговора, чтобы обновить инструкции, рассмотрите переход на системное сообщение посреди разговора, чтобы сохранить попадания в кэш подсказок.
  • Убедитесь, что ваша обработка причин остановки читает stop_details при отказах.
  • Если вам нужен быстрый режим, который Claude Opus 4.7 отклоняет, установите speed: "fast" в ваших запросах к Claude API. Claude Opus 5.5 не требует заголовка бета-версии.

Claude Opus 4.6 или более ранние

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

Claude Opus 4.5 или более ранние

  • Удалите все предзаполнения сообщений ассистента; Claude Opus 4.6 уже их отклоняет.
  • Убедитесь, что для разбора JSON вызовов инструментов используется стандартный парсер JSON.
  • Перейдите с client.beta.messages.create() на client.messages.create(): адаптивным размышлениям и уровню усилий не нужно пространство имён beta.
  • Удалите заголовок бета-версии 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 или более ранние

  • Обновите версии инструментов (text_editor_20250728, code_execution_20260521).
  • Обрабатывайте причину остановки refusal.
  • Обрабатывайте причину остановки model_context_window_exceeded.
  • Проверьте обработку строковых параметров инструментов на наличие завершающих символов новой строки.
  • Удалите заголовки бета-версий token-efficient-tools-2025-02-19 и output-128k-2025-02-19.
  • Проверьте и обновите подсказки в соответствии с лучшими практиками составления подсказок.

Только Claude Sonnet 5

  • Если вы пересобираете историю разговора, чтобы обновить инструкции, рассмотрите переход на системное сообщение посреди разговора, чтобы сохранить попадания в кэш подсказок.
  • Проверьте подсказки, близкие к минимальному размеру для кэширования: подсказки от 512 токенов и более могут создавать записи кэша.

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

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

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

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

claude-opus-5-5 — фиксированный идентификатор модели без суффикса даты, по той же схеме, что и claude-opus-5. В Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), Claude Models on Google Cloud (Google managed) и Microsoft Foundry используйте идентификатор модели соответствующей платформы; см. Доступность.

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

Каждое изменение объясняется в разделе Критические изменения страницы «Что нового в Claude Opus 5.5»; в этом разделе приведено изменение кода для каждого из них.

Размышления нельзя отключить

И thinking: {"type": "disabled"}, и thinking: {"type": "enabled", "budget_tokens": N} возвращают ошибку 400 ("thinking.type.disabled" is not supported for this model. или "thinking.type.enabled" is not supported for this model.). Удалите поле thinking и выберите уровень усилий; там, где вы отключали размышления ради экономии токенов, используйте более низкий уровень. После этого ответы начинаются с блоков thinking, поэтому выбирайте блоки содержимого по type и передавайте блоки thinking обратно без изменений вместе с результатами инструментов. См. Размышления нельзя отключить.

До. Claude Opus 5 принимает этот запрос, а Claude Opus 5.5 отклоняет его с ошибкой 400:

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

После:

client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    output_config={"effort": "low"},  # thinking is always on; effort is the control
    messages=[{"role": "user", "content": "..."}],
)

Принудительное использование инструментов не поддерживается

Типы tool_choice any и tool возвращают ошибку 400 (tool_choice: type "tool" and "any" are not supported for this model.), в том числе на эндпоинте подсчёта токенов. Используйте auto со строгим использованием инструментов или структурированными выходными данными и укажите в подсказке, когда следует применять инструмент. Строгое использование инструментов принимает подмножество JSON Schema, поэтому проверьте input_schema каждого инструмента, прежде чем добавлять strict: true. Каждый объект в схеме должен задавать additionalProperties: false; см. Ограничения JSON Schema. См. Принудительное использование инструментов не поддерживается.

До. Claude Opus 5 принимает этот запрос, а Claude Opus 5.5 отклоняет его с ошибкой 400:

client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    tools=tools,
    tool_choice={"type": "tool", "name": "get_weather"},
    messages=[{"role": "user", "content": "What's the weather in Paris?"}],
)

После:

client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    # строгое использование инструментов: каждый вызов соответствует input_schema инструмента
    tools=[{**tool, "strict": True} for tool in tools],
    tool_choice={"type": "auto"},
    messages=[
        {
            "role": "user",
            "content": "What's the weather in Paris? Use the get_weather tool.",
        }
    ],
)

Блоки размышлений привязаны к модели и разговору

В Claude API Claude Fable 5.1 и Claude Mythos 5.1 читают блоки размышлений Claude Opus 5.5; никакая другая модель этого не делает. Маршрутизатор или резервный механизм, который переводит беседу с Claude Opus 5.5 на любую другую модель, обрабатывает эти ходы без них. В обратном направлении Claude Opus 5.5 читает блоки размышлений из Claude Opus 5, из более ранних моделей Opus, Sonnet и Haiku, а в Claude API и Claude Models on Google Cloud (Google managed) — также из Claude Sonnet 5.5 и Claude Haiku 5.5, но не из моделей Claude Fable или Claude Mythos. Сохраняйте беседу в режиме «только добавление» (без изменений подсказки system, tools или более ранних сообщений в середине беседы), чтобы блоки оставались действительными; Claude Code, claude.ai, Claude Managed Agents и Claude Agent SDK уже так делают. Для аккаунтов, созданных 31 августа 2026 года в 00:00 UTC или позже, в Claude API и на облачных платформах запрос, который повторно воспроизводит блок размышлений после такого изменения и оставляет thinking.block_binding.prefix_mismatch_behavior неустановленным, получает ошибку 400. Для интеграций в режиме «только добавление» изменять код не требуется. См. Блоки размышлений привязаны к модели и беседе и Сохранённые размышления.

Некоторые версии инструмента использования компьютера не поддерживаются

Claude Opus 5.5 поддерживает использование компьютера через набор инструментов computer_toolset_20260801. В Amazon Bedrock Claude Opus 5.5 также принимает инструмент computer_20251124 с бета-заголовком computer-use-2025-11-24. Claude Opus 5.5 возвращает ошибку 400 для любой версии инструмента использования компьютера, которую она не принимает, например для computer_20251124 в Claude API. Она не принимает computer_20250124 ни на одной платформе. В Claude API сообщение об ошибке начинается с 'claude-opus-5-5' does not support tool types: computer_20251124., после чего перечисляются типы инструментов, которые принимает модель.

Интеграции, использующие набор инструментов, не требуют изменений. Чтобы перевести интеграцию с computer_20251124 на набор инструментов, удалите бета-заголовок и отправляйте запись computer_toolset_20260801 без name и размеров дисплея. В цикле агента обрабатывайте каждый блок tool_use члена набора в реплике и повторяйте toolset_name в каждом результате. Считывайте действие из name каждого блока, а не из input.action. В разделе Миграция с computer_20251124 перечислены изменения цикла агента.

До. Claude Opus 5 принимает этот запрос, а Claude Opus 5.5 отклоняет его с ошибкой 400 в Claude API:

client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    betas=["computer-use-2025-11-24"],
    tools=[
        {
            "type": "computer_20251124",
            "name": "computer",
            "display_width_px": 1024,
            "display_height_px": 768,
        }
    ],
    messages=[{"role": "user", "content": "Open the display settings."}],
)

После:

client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    # без бета-заголовка; запись набора инструментов не принимает имя или размер дисплея
    tools=[{"type": "computer_toolset_20260801"}],
    messages=[{"role": "user", "content": "Open the display settings."}],
)

Текст между вызовами инструментов возвращается в блоках размышлений

На Claude Opus 5 текст, который модель пишет между вызовами инструментов, возвращается в виде блоков text. На Claude Opus 5.5, как и на Claude Fable 5.1, это сопровождение возвращается в виде блоков thinking с обновлениями прогресса — не более одного перед каждым вызовом инструмента. При значении thinking.display по умолчанию "omitted" их поле thinking пусто. Ни один запрос не завершается ошибкой, но приложение, которое передаёт этот текст своим пользователям как обновления прогресса, замолкает между вызовами инструментов. Чтобы вернуть обновления, читайте их из блоков thinking и задайте значение display, которое возвращает их текст: "updates" (бета, заголовок thinking-display-updates-2026-08-18) возвращает обновления прогресса, при этом рассуждения остаются скрытыми, а "summarized" возвращает и то, и другое вперемешку. Затем отображайте каждый непустой блок thinking перед блоком tool_use, которому он предшествует, и передавайте блоки обратно без изменений вместе с остальной частью хода ассистента. См. Обновления прогресса для пользователей.

Классификаторы безопасности и резервное переключение

Claude Opus 5.5 может возвращать stop_reason: "refusal" с категорией в stop_details. Его классификаторы охватывают более широкий набор категорий, чем у Claude Opus 5, поэтому ожидайте значений stop_details.category, таких как "bio", в дополнение к "cyber" и "reasoning_extraction"; см. таблицу категорий отказов. Обрабатывайте отказы и настройте резервное переключение на стороне сервера или собственные повторные попытки (резервное переключение на стороне сервера не повторяет запросы, отклонённые с "reasoning_extraction"; такой отказ возвращается вам); см. Отказы и резервное переключение и Отказы средств защиты.

  1. Заново проведите перебор уровней усилий. Уровень усилий — единственный механизм управления размышлениями на Claude Opus 5.5, и его значение по умолчанию — medium, тогда как у Claude Opus 5 — high, поэтому запрос без effort теперь выполняется на уровне medium. Понижайте уровень там, где качество сохраняется, и повышайте его для самых сложных задач. См. Уровень усилий.
  2. Пересмотрите инструкции в подсказках, специфичные для модели. Инструкции, настроенные под поведение Claude Opus 5, могут быть больше не нужны; см. Составление подсказок для Claude Opus 5.5. Если вы работали с отключёнными размышлениями, см. также Подсказки, написанные для отключённых размышлений.
  3. Протестируйте в среде разработки, прежде чем переключать производственный трафик.

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

Сначала проработайте разделы Требования к каждому запросу к Claude Opus 5.5, Обработка размышлений в каждом ответе и Миграция на Claude Opus 5.5 с Claude Opus 5. В качестве заменяемого идентификатора модели используйте claude-opus-4-8. Последний из этих разделов применим к коду для Claude Opus 4.8 в неизменном виде, поскольку Claude Opus 4.8, как и Claude Opus 5:

  • Принимает thinking: {"type": "disabled"}, принудительный выбор инструмента и инструмент computer_20251124.
  • Возвращает текст между вызовами инструментов в виде блоков text.
  • По умолчанию использует уровень усилий high.

Этот раздел дополняет их тем, что изменилось между Claude Opus 4.8 и Claude Opus 5. Контрольный список см. в первых двух группах контрольного списка миграции.

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

  1. Размышления выполняются в запросах, где они не были указаны: на Claude Opus 4.8 размышления отключены, если вы их не запросили. На Claude Opus 5.5 запрос без поля thinking выполняется с размышлениями, поэтому каждый пункт раздела Обработка размышлений в каждом ответе является изменением для такого кода. Если ваш код никогда не отправлял поле thinking, в примерах «до» и «после» для размышлений удалять нечего.

  2. Снижен минимальный размер для кэширования подсказок: минимальная длина кэшируемой подсказки на Claude Opus 5.5 составляет 512 токенов по сравнению с 1 024 токенами на Claude Opus 4.8. Подсказки, которые были слишком короткими для кэширования на Claude Opus 4.8, могут создавать записи кэша без каких-либо изменений кода. Минимальные значения для каждой модели см. в разделе Кэширование подсказок.

  3. Priority Tier не поддерживается: Priority Tier не поддерживается на Claude Opus 5.5, тогда как Claude Opus 4.8 его сохраняет. Если у вашей организации есть обязательство по Priority Tier, планируйте мощности отдельно.

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

  1. Рассмотрите бюджеты задач (бета): Для агентных рабочих нагрузок task budgets (бюджеты задач) сообщают модели, сколько токенов у неё есть на полный агентный цикл. Для них требуется beta header (бета-заголовок) task-budgets-2026-03-13.

  2. Рассмотрите изменение инструментов в середине диалога (бета): Изменение инструментов в середине диалога позволяет добавлять или удалять инструменты между ходами диалога, не делая недействительными попадания в кэш подсказок на более ранних ходах. Изменение самого массива tools делает кэшированный префикс недействительным. В Claude API, Claude Platform on AWS и Claude Models on Google Cloud (Anthropic managed) отправляйте бета-заголовок inline-tools-2026-09-15. Заголовок mid-conversation-tool-changes-2026-07-01 работает для изменений, которые ссылаются на инструмент по ссылке, в Claude API, Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) и Claude Models on Google Cloud (Google managed).

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

Сначала проработайте разделы Требования к каждому запросу к Claude Opus 5.5, Обработка размышлений в каждом ответе, Миграция на Claude Opus 5.5 с Claude Opus 5 и Миграция на Claude Opus 5.5 с Claude Opus 4.8. В качестве заменяемого идентификатора модели используйте claude-opus-4-7. Эти разделы применимы к коду для Claude Opus 4.7 в неизменном виде. Как и Claude Opus 4.8, эта модель принимает thinking: {"type": "disabled"}, принудительный выбор инструмента и инструмент computer_20251124. По умолчанию она использует уровень усилий high и работает без размышлений, если вы их не запросили.

Этот раздел дополняет их тем, что изменилось после Claude Opus 4.7. Если ваш код работает на Claude Opus 4.6 или более ранней модели, после этого раздела перейдите к разделу Миграция на Claude Opus 5.5 с Claude Opus 4.6 и более ранних моделей Opus. В нём описаны критические изменения, вступившие в силу в Claude Opus 4.7. Контрольный список см. в первых трёх группах контрольного списка миграции.

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

Ни один из этих пунктов не добавляет критических изменений к описанным в предыдущих разделах; их стоит проверить после замены идентификатора модели.

  1. Уровни усилий перекалиброваны: Распределение токенов для каждого уровня effort (усилий) в Claude Opus 5.5 изменилось по сравнению с Claude Opus 4.7. Значение по умолчанию — medium, тогда как у Claude Opus 4.7 — high. Проведите новый перебор уровней усилий на собственных оценках, а не переносите настройку, подобранную для Claude Opus 4.7. См. Уровень усилий.

  2. Контекстное окно в 1M используется по умолчанию: Claude Opus 5.5 по умолчанию предоставляет полное context window (контекстное окно) в 1M токенов без бета-заголовка. Если ваш клиент передаёт бета-заголовок контекстного окна для совместимости со старыми моделями, удалите его.

  3. Системные сообщения в середине диалога: В Claude API, Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) и Claude Models on Google Cloud (Google managed) Claude Opus 5.5 принимает сообщения role: "system" сразу после хода пользователя в массиве messages (с учётом правил размещения). Используйте поле верхнего уровня system для инструкций, которые применяются с самого начала. Claude Opus 4.7 отклоняет role: "system" в messages с ошибкой 400. Если вы поддерживаете пути кода, которые перестраивают всю историю сообщений для обновления инструкций, вы можете упростить их и сохранить попадания в кэш подсказок на более ранних ходах.

  4. Детали остановки при отказе: Когда модель отклоняет запрос, Claude Opus 5.5 возвращает объект stop_details, указывающий категорию отказа, вместе с причиной остановки refusal. Claude Opus 4.7 возвращает тот же объект, поэтому это важно, только если ваша обработка stop reason (причины остановки) его ещё не считывает. Бета-заголовок не требуется, и возможности отказаться от этого нет. Если ваша обработка причин остановки его ещё не считывает, см. Обработка причин остановки. Claude Opus 5.5 отказывает в большем числе категорий; см. Классификаторы безопасности и резервный вариант.

  5. Быстрый режим: Claude Opus 5.5 поддерживает fast mode (быстрый режим) в Claude API. Быстрый режим недоступен в Claude Opus 4.7, где запросы с speed: "fast" возвращают ошибку. Установите speed: "fast" в своих запросах. Claude Opus 5.5 не требует бета-заголовка.

  6. Набор инструментов для использования компьютера и инструмент использования браузера: Claude Opus 5.5 поддерживает computer use (использование компьютера) в виде набора инструментов computer_toolset_20260801 и browser use tool (инструмент использования браузера) для задач внутри веб-страниц. Claude Opus 4.7 не поддерживает ни то, ни другое. Чтобы перевести интеграцию computer_20251124 на набор инструментов, см. критическое изменение для использования компьютера.

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

Сначала пройдите все предыдущие разделы в порядке их следования на странице. Это Требования к каждому запросу к Claude Opus 5.5, Обработка размышлений в каждом ответе, а также разделы для Claude Opus 5, Claude Opus 4.8 и Claude Opus 4.7. Эти разделы применимы к коду на Claude Opus 4.6 без изменений. Как и Claude Opus 4.7, эта модель принимает thinking: {"type": "disabled"}, принудительный выбор инструмента и инструмент computer_20251124. По умолчанию она использует уровень усилий high и работает без размышлений, если вы их не запросите. Claude Opus 4.5 и более ранние модели Opus также принимают thinking: {"type": "disabled"} и принудительный выбор инструмента и работают без размышлений, если вы их не запросите, поэтому эти разделы применимы и к ним.

В этом разделе описано, что изменилось в Claude Opus 4.7; заменяемый идентификатор модели — claude-opus-4-6. Два его подраздела описывают изменения, произошедшие ранее, для читателей, использующих Claude Opus 4.5 или более ранние модели и Claude 4.1 или более ранние модели. Контрольный список см. в контрольном списке миграции вплоть до группы, в которой указана ваша модель.

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

  1. Удалены расширенные размышления: «extended thinking» (расширенные размышления) в форме thinking: {"type": "enabled", "budget_tokens": N} больше не поддерживаются в Claude Opus 4.7 и более поздних моделях и возвращают ошибку 400. Перейдите на «adaptive thinking» (адаптивные размышления) (thinking: {"type": "adaptive"}) и используйте параметр effort для управления глубиной размышлений. В Claude Opus 5.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.5), где отличаются идентификатор модели и строки thinking и output_config:

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

    Адаптивными размышлениями можно управлять с помощью подсказок и параметра effort, который заменяет бюджет размышлений в качестве способа контролировать объём рассуждений модели. Вместо пересчёта значения budget_tokens проведите перебор уровней усилий на собственных оценках. Таблица уровней усилий описывает, когда использовать каждый уровень, а раздел Рекомендуемые уровни усилий для Claude Opus 5.5 посвящён этой модели.

  2. Удалены параметры сэмплирования: Не указывайте temperature, top_p и top_k. Подсказки — рекомендуемый способ управлять поведением модели в Claude Opus 5.5. Если вы использовали temperature = 0 для детерминированности, учтите, что это никогда не гарантировало идентичных результатов и на предыдущих моделях.

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

  4. Обновлённый подсчёт токенов: в Claude Opus 4.7 появился новый токенизатор, который используют и более поздние модели Opus, включая Claude Opus 5.5. Он способствует повышению производительности на широком спектре задач и может использовать примерно в 1–1,35 раза больше токенов при обработке текста по сравнению с моделями до Claude Opus 4.7 (до примерно 35 процентов больше, в зависимости от содержимого).

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

    Обновите параметры max_tokens, чтобы обеспечить дополнительный запас, включая пороги срабатывания компактизации, и повторно протестируйте все участки кода, которые оценивают количество токенов на стороне клиента или предполагают фиксированное соотношение токенов и символов. Для проверки используйте эндпоинт Подсчёт токенов. Изменения в подсказках, task_budget и effort помогают контролировать затраты; эти средства управления могут снижать интеллектуальные возможности модели.

  5. Удаление предзаполнения (уже действует в Claude Opus 4.6): «prefill» (предзаполнение) сообщений ассистента возвращает ошибку 400 в Claude Opus 4.6 и более поздних моделях Opus, включая Claude Opus 5.5, поэтому это изменение касается вас, только если вы переходите с Claude Opus 4.5 или более ранней модели. Вместо этого используйте структурированные выходные данные или инструкции в системной подсказке.

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

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

  1. Встроенные обновления о ходе работы в агентных трассах: Claude Opus 4.7 предоставляет пользователю более регулярные и качественные обновления на протяжении длинных агентных трасс. Если вы добавили обвязку для принудительного вывода промежуточных сообщений о статусе («После каждых 3 вызовов инструментов подводи итог прогресса»), попробуйте её удалить. В Claude Opus 5.5 эти обновления поступают в блоках thinking, которые пусты при значении thinking.display по умолчанию. Чтобы получать их, см. раздел Текст между вызовами инструментов возвращается в блоках размышлений. Чтобы настроить их длину и содержание, см. Обновления о ходе работы для пользователя.

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

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

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

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

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

Различия, касающиеся подсказок, см. в разделах Подсказки для Claude Opus 5.5 и Лучшие практики составления подсказок.

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

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

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

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

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

Первый пункт обязателен для Claude Opus 5.5; остальные рекомендуются.

  1. Переход на адаптивные размышления (обязательно): thinking: {"type": "enabled", "budget_tokens": N} возвращает ошибку 400 в Claude Opus 4.7 и более поздних моделях. Пример «до» и «после» приведён в пункте 1 критических изменений для миграции с Claude Opus 4.6. Миграция также предполагает переход от client.beta.messages.create() к client.messages.create(): адаптивные размышления и уровень усилий не требуют бета-пространства имён SDK или каких-либо бета-заголовков.

  2. Удалите бета-заголовок уровня усилий: параметр effort не требует бета-заголовка. Удалите бета effort-2025-11-24 из своих запросов.

  3. Удалите бета-заголовок детализированной потоковой передачи инструментов: «fine-grained tool streaming» (детализированная потоковая передача инструментов) не требует бета-заголовка. Удалите бета fine-grained-tool-streaming-2025-05-14 из своих запросов.

  4. Удалите бета-заголовок чередующихся размышлений: при адаптивных размышлениях «interleaved thinking» (чередующиеся размышления) включаются автоматически на каждой модели, поддерживающей адаптивные размышления. Удалите бета interleaved-thinking-2025-05-14 из своих запросов.

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

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

Если вы переходите с Claude Opus 4.1 или более ранних моделей непосредственно на Claude Opus 5.5, сначала примените всё, что описано в разделе Миграция с Claude Opus 4.5 или более ранних моделей. Этот подраздел начинается со всех предыдущих разделов, поэтому фактически вы читаете эту страницу с начала. Затем примените дополнительные изменения из этого подраздела.

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

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

  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 5.5 с Claude Sonnet 5

Пройдите разделы Требования к каждому запросу к Claude Opus 5.5, Обработка размышлений в каждом ответе и Миграция на Claude Opus 5.5 с Claude Opus 5. В качестве заменяемого идентификатора модели используйте claude-sonnet-5. Последний из этих разделов применим к коду на Claude Sonnet 5 без изменений, поскольку Claude Sonnet 5, как и Claude Opus 5:

  • По умолчанию работает с включёнными размышлениями и принимает thinking: {"type": "disabled"} — в данном случае при любом уровне усилий.
  • Принимает принудительный выбор инструмента и инструмент computer_20251124.
  • Возвращает текст между вызовами инструментов в виде блоков text.
  • По умолчанию использует уровень усилий high.

Ручные расширенные размышления, параметры сэмплирования и предзаполнение ассистента возвращают ошибку 400 на обеих моделях, поэтому здесь ничего не меняется. Ни одно из обязательных изменений в разделах для Claude Opus 4.8, Claude Opus 4.7 и Claude Opus 4.6 к вам не относится.

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

  1. Системные сообщения в середине диалога: В Claude API, Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) и Claude Models on Google Cloud (Google managed) Claude Opus 5.5 принимает сообщения role: "system" сразу после хода пользователя в массиве messages (с учётом правил размещения). Эта функция недоступна в Claude Sonnet 5. Если вы поддерживаете пути кода, которые перестраивают всю историю сообщений для обновления инструкций, вы можете упростить их и сохранить попадания в кэш подсказок на более ранних ходах.

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

Эта страница была полезной?