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

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



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

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



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

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



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

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

   До (Claude Mythos Preview):

   client.messages.create(
       model="claude-mythos-preview",
       max_tokens=16000,
       thinking={"type": "enabled", "budget_tokens": 10000},
       messages=[{"role": "user", "content": "..."}],
   )

   



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

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

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



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

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



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

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

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



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

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



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

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

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

   До (Claude Opus 4.8):

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

   



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

• Обновите имя модели с claude-opus-4-8 на claude-fable-5.
• Удалите любую конфигурацию thinking: {type: "disabled"}. Отключение мышления возвращает ошибку в claude-fable-5, а запросы без поля thinking выполняются с адаптивным мышлением.
• Если вы удалили ручное расширенное мышление и префиллы ассистента во время предыдущих миграций, никаких действий не требуется: оба остаются неподдерживаемыми в claude-fable-5.
• Убедитесь, что любой код, разбирающий поле thinking, обрабатывает его только как отображаемый текст и передаёт блоки мышления обратно без изменений при продолжении на той же модели. thinking.display по умолчанию имеет значение "omitted" в claude-fable-5, так же как и в Claude Opus 4.8; установите display: "summarized", чтобы получать читаемые сводки. См. .



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

Claude Opus 4.8 — самая мощная модель уровня Opus от Anthropic. Она построена на основе Claude Opus 4.7.

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



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

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



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

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

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

2. Значение effort по умолчанию — high: Значение по умолчанию для параметра effort в Claude Opus 4.8 — high на всех поверхностях, включая Claude Code и Messages API. Если вы уже устанавливаете effort явно, ваша настройка не изменяется. Для кодирования и высокоавтономной работы устанавливайте xhigh явно. Пересмотрите вашу настройку effort с учётом вашего бюджета задержки и стоимости.

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



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

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



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

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

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

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



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

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



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

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

   До (Claude Opus 4.6):

   client.messages.create(
       model="claude-opus-4-6",
       max_tokens=16000,
       thinking={"type": "enabled", "budget_tokens": 10000},
       messages=[{"role": "user", "content": "..."}],
   )

   



Выбор уровня усилий

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

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

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



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

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

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

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

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

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

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



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

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

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

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

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

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

   



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

• Обновите имя модели с claude-opus-4-6 на claude-opus-4-7 (или обновите псевдонимы).
• Удалите temperature, top_p и top_k из полезной нагрузки запросов.
• Замените thinking: {type: "enabled", budget_tokens: N} на thinking: {type: "adaptive"} плюс параметр effort.
• Удалите все предзаполнения сообщений ассистента.
• Если ваш интерфейс отображает содержимое мышления, явно включите суммаризацию мышления.
• Повторно измерьте сквозную стоимость и задержку с учётом обновлённой токенизации.
• Перенастройте с учётом обновлённой токенизации.



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

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



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

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



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

1. Удаление предзаполнения описано в разделе критических изменений Opus 4.7 выше.

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



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

Эти изменения улучшат ваш опыт работы с 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 4.1 или более ранних версий

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

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

# Из Sonnet 4
model = "claude-sonnet-4-20250514"  # Before
model = "claude-opus-4-7"  # After

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



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

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

   

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

   Начиная с Claude Opus 4.7, установка temperature, top_p или top_k в любое значение, отличное от значения по умолчанию, вернёт ошибку 400. Самый безопасный путь миграции — полностью исключить эти параметры из запросов и использовать подсказки для управления поведением модели. Если вы использовали temperature = 0 для детерминизма, учтите, что это никогда не гарантировало идентичных выводов.

   Python

   

   # До — это вызовет ошибку в моделях Claude 4+
   response = client.messages.create(
       model="claude-3-7-sonnet-20250219",
       temperature=0.7,
       top_p=0.9,  # Non-default sampling params return 400 on Opus 4.7
       # ...
   )
   
   # После
   response = client.messages.create(
       model="claude-opus-4-7",
       # ...
   )



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

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



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

• Обновите идентификатор модели на claude-opus-4-7
• Примените все критические изменения Opus 4.7 (расширенное мышление удалено, параметры сэмплирования удалены, отображение мышления по умолчанию опущено, обновлённая токенизация)
• КРИТИЧЕСКОЕ: Удалите предзаполнения сообщений ассистента (возвращает ошибку 400); используйте структурированные выводы или output_config.format вместо этого
• КРИТИЧЕСКОЕ для Opus 4.7: Замените thinking: {type: "enabled", budget_tokens: N} на thinking: {type: "adaptive"} плюс параметр effort (возвращает 400 в Opus 4.7)
• Убедитесь, что разбор JSON вызовов инструментов использует стандартный JSON-парсер
• Удалите бета-заголовок effort-2025-11-24 (effort теперь общедоступен)
• Удалите бета-заголовок



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

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

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

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

# От Sonnet 4.5
model = "claude-sonnet-4-5"  # Before
model = "claude-sonnet-4-6"  # After

# От Sonnet 4
model = "claude-sonnet-4-20250514"  # Before
model = "claude-sonnet-4-6"  # After



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



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

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

   

   Это критическое изменение при миграции с Sonnet 4.5 или более ранних версий.

   Предзаполнение сообщений ассистента возвращает ошибку 400 в Sonnet 4.6. Используйте структурированные выводы, инструкции в системной подсказке или output_config.format вместо этого.

   Распространённые сценарии использования предзаполнения и способы миграции:

   • Управление форматированием вывода (принудительный вывод JSON/YAML): Используйте структурированные выводы или инструменты с полями enum для задач классификации.

   • Устранение преамбул (удаление фраз «Вот...»): Добавьте прямые инструкции в системную подсказку: «Отвечай напрямую без преамбулы. Не начинай с фраз типа "Вот...", "На основе..." и т. д.»

   • Избежание некорректных отказов: Claude теперь гораздо лучше справляется с уместными отказами. Чёткой подсказки в сообщении пользователя без предзаполнения должно быть достаточно.



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

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

   

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

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

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

   

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

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

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

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



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

1. Удалите бета-заголовок fine-grained-tool-streaming-2025-05-14: Детальная потоковая передача инструментов теперь общедоступна (GA) в Sonnet 4.6 и больше не требует бета-заголовка.
2. Перейдите с output_format на output_config.format: Параметр output_format устарел. Используйте output_config.format вместо него.



Миграция с Sonnet 4.5

Рассмотрите миграцию с Sonnet 4.5 на Sonnet 4.6, который обеспечивает больший интеллект по той же цене.



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

Если вы не используете расширенное мышление в Sonnet 4.5, вы можете продолжать без него в Sonnet 4.6. Вам следует явно установить effort на уровень, подходящий для вашего сценария использования. При уровне усилий low с отключённым мышлением вы можете ожидать аналогичную или лучшую производительность по сравнению с Sonnet 4.5 без расширенного мышления.



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

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

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

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

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

При использовании адаптивного мышления оцените уровни усилий medium и high на ваших задачах. Правильный уровень зависит от компромисса вашей рабочей нагрузки между качеством, задержкой и использованием токенов.

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

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

Сценарии программирования и агентные сценарии

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

Чат и сценарии, не связанные с программированием

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



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

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



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

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

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

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

# Из Sonnet 4
model = "claude-sonnet-4-20250514"  # Before
model = "claude-sonnet-4-5-20250929"  # After

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



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

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

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

   

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

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

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

   

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

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

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

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



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

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



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

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

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

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

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

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

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



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

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

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

   

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

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

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

   

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

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

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

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



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

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



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

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