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

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

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

Различия в поведении и шаблоны подсказок для этой модели описаны в разделе Составление подсказок для Claude Opus 5.5.

Claude Opus 5.5 стоит дешевле, чем Claude Opus 5: $4 / $20 USD за миллион входных / выходных токенов против $5 / $25 (см. цены Claude). При этом модель сохраняет от Claude Opus 5 «context window» (контекстное окно) на 1M токенов и максимум 128k выходных токенов. Для кода, который уже работает на Claude Opus 5, есть четыре «breaking changes» (критических изменения). Они описаны в разделе Критические изменения. Сведения о поддержке функций см. в разделе Что нового в Claude Opus 5.5.

Миграция на Claude Opus 5.5 с Claude Opus 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, Google Cloud и 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 и выберите «effort» (уровень усилий). Если вы отключали мышление ради экономии токенов, выберите более низкий уровень. После этого ответы начинаются с блоков thinking. Поэтому выбирайте блоки содержимого по type, а блоки thinking передавайте обратно без изменений вместе с результатами инструментов. См. Мышление нельзя отключить.

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

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 вместе со «strict tool use» (строгим использованием инструментов) или «structured outputs» (структурированными выходными данными). В подсказке укажите, когда следует применять инструмент. См. Принудительное использование инструментов не поддерживается.

До:

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 Opus 5.5 читают только Claude Fable 5.1 и Claude Mythos 5.1. Если маршрутизатор или резервный механизм переводит разговор с Claude Opus 5.5 на любую другую модель, эти ходы выполняются без блоков мышления. В обратном направлении Claude Opus 5.5 читает блоки мышления от Claude Opus 5 и более ранних моделей Opus, Sonnet и Haiku, но не от моделей Claude Fable или Claude Mythos.

Чтобы блоки оставались действительными, ведите разговор в режиме только добавления: не изменяйте системную подсказку system, tools или более ранние сообщения посреди разговора. Claude Code, claude.ai, Claude Managed Agents и Claude Agent SDK уже работают так. Это правило применяется так же, как для Claude Fable 5.1, на всех платформах. Для аккаунтов, созданных 31 августа 2026 года в 00:00 UTC или позже, повторная передача блока мышления после такого изменения по умолчанию возвращает ошибку 400. Интеграциям в режиме только добавления менять код не нужно. См. Блоки мышления привязаны к модели и разговору и Сохранённое мышление.

Инструмент использования компьютера computer_20251124 не поддерживается в Claude API и Google Cloud

В Claude API и Google Cloud запись tools с типом computer_20251124 возвращает ошибку 400. Текст ошибки — 'claude-opus-5-5' does not support tool types: computer_20251124., за ним следует список типов инструментов, которые принимает модель. Вместо этого объявите «toolset» (набор инструментов) computer_toolset_20260801: уберите бета-заголовок и отправьте запись без name и размеров дисплея.

В цикле агента внесите следующие изменения:

  • обрабатывайте блоки tool_use для инструментов набора; действие задаётся полем name блока, а не input.action;
  • учитывайте, что за один ход может прийти несколько таких блоков;
  • возвращайте toolset_name в каждом результате.

Изменение запроса показано ниже. Изменения цикла агента перечислены в разделе Миграция с computer_20251124.

В Amazon Bedrock прежний инструмент computer_20251124 работает в Claude Opus 5.5 так же, как в Claude Opus 5, поэтому там ничего менять не нужно. Для других платформ см. раздел Совместимость инструмента использования компьютера. См. Инструмент использования компьютера computer_20251124 не поддерживается в Claude API и Google Cloud.

До:

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,
    # без бета-заголовка; запись toolset не принимает имя или размер экрана
    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 в этих блоках пустое.

Запросы не завершаются ошибкой. Но если приложение через «streaming» (потоковую передачу) показывает этот текст пользователям как обновления о ходе работы, между вызовами инструментов оно замолкает. Чтобы вернуть обновления, считывайте их из блоков 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. Поэтому, помимо "cyber", ожидайте в stop_details.category и другие значения, например "bio" и "reasoning_extraction"; см. таблицу категорий отказов.

Обрабатывайте отказы и настройте «server-side fallback» (резервный механизм на стороне сервера) или собственные повторные попытки. Резервный механизм на стороне сервера не повторяет запросы, отклонённые с "reasoning_extraction": такой отказ возвращается вам. См. Отказы и резервная обработка и Отказы защитных механизмов.

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

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

  • Замените идентификатор модели на claude-opus-5-5.
  • Удалите thinking: {"type": "disabled"} и thinking: {"type": "enabled", ...} и выберите уровень усилий.
  • Задайте effort явно: по умолчанию используется medium, а в Claude Opus 5 — high.
  • Замените типы tool_choice any и tool на auto в сочетании со строгим использованием инструментов или структурированными выходными данными.
  • Если вы используете инструмент использования компьютера в Claude API или Google Cloud, объявите computer_toolset_20260801 (без бета-заголовка) вместо computer_20251124 и адаптируйте цикл агента к набору инструментов. В 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 Fable или Claude Mythos.
  • Считывайте блоки содержимого по type. В циклах использования инструментов передавайте блоки thinking обратно без изменений.
  • Если ваш интерфейс показывает текст между вызовами инструментов, задайте display: "updates" (бета) или "summarized" и отображайте непустые блоки thinking.
  • Если ваш код посреди разговора изменяет более ранние ходы, системную подсказку system или tools, следуйте разделу Сохранённое мышление.
  • Обрабатывайте stop_reason: "refusal" и настройте резервный механизм.
  • Заново измерьте базовые показатели стоимости и задержки на выбранном уровне усилий.

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

Сначала выполните шаги из раздела Миграция на Claude Opus 5 с Claude Opus 4.8. В нём описано мышление, включённое по умолчанию, и связанные с ним изменения структуры ответа. Затем выполните шаги из раздела Миграция с Claude Opus 5. Второе критическое изменение Claude Opus 5 из того раздела здесь не действует. Там сказано, что мышление можно отключить только при уровне усилий high или ниже, а в Claude Opus 5.5 его нельзя отключить вообще.

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

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

Руководство по миграции на Claude Opus 5 описывает критические изменения между вашей текущей моделью и Claude Opus 5:

  • параметры сэмплирования отклоняются;
  • ручное «extended thinking» (расширенное мышление) отклоняется;
  • предзаполнение (prefill) удалено;
  • используется более новый токенизатор.

Выполните шаги из раздела для вашей модели, указывая claude-opus-5-5 вместо claude-opus-5. Затем выполните шаги из раздела Миграция с Claude Opus 5.

Учтите два расхождения с тем руководством:

  • Там сказано, что мышление можно отключить при уровне усилий high или ниже. В Claude Opus 5.5 это невозможно.
  • Там сказано, что существующие интеграции с computer_20251124 продолжают работать. В Claude API и Google Cloud они не работают с Claude Opus 5.5: на этих платформах модель принимает использование компьютера только в виде набора инструментов computer_toolset_20260801 (см. критическое изменение). В Amazon Bedrock такие интеграции продолжают работать.

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

Что меняется при переходе на старший класс моделей, описано в разделе Миграция на Claude Opus 5 с Claude Sonnet 5. После этого выполните шаги из раздела Миграция с Claude Opus 5.

Was this page helpful?