Руководство по миграции на Claude Fable 5.1 и Claude Mythos 5.1
Перейдите на Claude Fable 5.1 и Claude Mythos 5.1 с Claude Fable 5, Claude Mythos 5, Claude Opus 5 или Claude Opus 4.8 с помощью этого руководства по миграции. Инструкции по включению Claude Fable 5.1 и Claude Mythos 5.1 содержат идентификаторы моделей, критические изменения и контрольные списки миграции.
Claude Fable 5.1 приходит на смену Claude Fable 5 по тем же ценам на входные и выходные токены, а чтение из кэша стоит в четыре раза дешевле. Модель доступна в Claude API, Amazon Bedrock, Claude Platform on AWS, Google Cloud и Microsoft Foundry. Claude Mythos 5.1 обладает теми же возможностями и доступна только организациям, прошедшим проверку в рамках программ верификации Anthropic, таких как Cyber Verification Program. О различиях в поведении и приёмах составления подсказок см. Составление подсказок для Claude Fable 5.1.
Базовые настройки, общие для claude-fable-5-1 и claude-mythos-5-1:
- Размышления: «adaptive thinking» (адаптивные размышления) всегда включены, как и в Claude Fable 5. Модель сама определяет, когда и сколько размышлять. Настройка
thinkingне требуется. Иthinking: {type: "disabled"}, и ручные расширенные размышления (thinking: {type: "enabled", budget_tokens: N}) возвращают ошибку 400. - Предзаполнение: «prefill» (предзаполнение) сообщения ассистента возвращает ошибку 400, как и в Claude Fable 5. Вместо этого используйте инструкции в системной подсказке.
- Выбор инструмента: поддерживаются
{type: "auto"}(по умолчанию) и{type: "none"}. Принудительный вызов инструмента с помощью{type: "any"}или{type: "tool", name: "..."}возвращает ошибку 400. См. Критические изменения. - Сохранение размышлений между моделями: Claude Fable 5.1 читает блоки размышлений от Claude Opus 5, Claude Fable 5, Claude Mythos 5 и более ранних моделей Claude. Ни одна из этих моделей не может читать блоки Claude Fable 5.1. См. Критические изменения.
- Контекстное окно и вывод: по умолчанию «context window» (контекстное окно) на 1M токенов и до 128k выходных токенов на запрос.
- Цены: $10 USD за миллион входных токенов и $50 USD за миллион выходных токенов, как и у Claude Fable 5. Чтение из кэша подсказок стоит $0,25 USD за миллион токенов — четверть тарифа Claude Fable 5. См. Цены Claude.
- Хранение данных: обе модели требуют 30-дневного хранения данных, недоступны в рамках соглашений «zero data retention» (нулевое хранение данных), или ZDR, если это явно не разрешено Anthropic, и отнесены к категории Covered Models, как и Claude Fable 5 и Claude Mythos 5. В Claude API запрос от организации или рабочего пространства без 30-дневного хранения возвращает ошибку 400
invalid_request_error. Организациям с соглашением ZDR следует связаться со своей командой по работе с клиентами Anthropic или настроить хранение для отдельного рабочего пространства. Подробности по платформам см. в разделе Требования к хранению данных для конкретных моделей.
Чем различаются две модели:
- Доступность: Claude Fable 5.1 не требует одобрения доступа. Claude Mythos 5.1 доступна только организациям, прошедшим проверку в рамках программ верификации Anthropic, таких как Cyber Verification Program. Чтобы запросить доступ, подайте заявку в программу, охватывающую ваш сценарий использования, или свяжитесь со своей командой по работе с клиентами Anthropic.
- Priority Tier: ни одна из моделей не поддерживается в Priority Tier. Claude Fable 5 поддерживается.
Миграция на Claude Fable 5.1 с Claude Fable 5
В большинстве случаев достаточно просто заменить модель. Поверхность API, ограничения, цены за токен, токенизатор, постоянно включённые адаптивные размышления, обработка отказов и категории stop_details совпадают с Claude Fable 5. Что меняется: принудительный выбор инструмента возвращает ошибку 400; блоки размышлений Claude Fable 5.1 читают только Claude Fable 5.1 и Claude Mythos 5.1, и только в том разговоре, в котором они были созданы; чтение из кэша стоит дешевле; поведение в агентных циклах отличается в трёх аспектах. Те же изменения относятся и к Claude Mythos 5.1, за исключением проверки разговора для блоков размышлений, которую Claude Mythos 5.1 не выполняет.
Обновите название модели
model = "claude-fable-5" # Before
model = "claude-fable-5-1" # After
# Или для Claude Mythos 5.1, который предоставляет те же возможности верифицированным организациям:
model = "claude-mythos-5-1" # AfterКритические изменения
-
Принудительный выбор инструмента не поддерживается: Claude Fable 5 принимает
tool_choiceсо значениямиauto,none,anyиtool. Вclaude-fable-5-1значения{type: "any"}и{type: "tool", name: "..."}возвращают ошибку 400invalid_request_error:tool_choice: type "tool" and "any" are not supported for this model.Проверка применяется в Messages API, Message Batches API и в эндпоинте подсчёта токенов.
До (Claude Fable 5):
Pythonclient = anthropic.Anthropic() record_summary_tool = { "name": "record_summary", "description": "Record the structured summary of the document.", "input_schema": { "type": "object", "properties": {"summary": {"type": "string"}}, "required": ["summary"], }, } response = client.messages.create( model="claude-fable-5", max_tokens=16000, tools=[record_summary_tool], tool_choice={"type": "tool", "name": "record_summary"}, messages=[{"role": "user", "content": "Summarize: The meeting moved to Thursday."}], ) print(response.content)После (Claude Fable 5.1): оставьте
tool_choiceсо значениемauto, назовите инструмент в инструкции и установитеstrict: true, чтобы вызов соответствовал вашей схеме. (В организации с CMEK, где структурированные выходные данные, включаяstrict: true, недоступны для моделей Claude Fable, полагайтесь только на инструкцию.) Например:Pythonclient = anthropic.Anthropic() record_summary_tool = { "name": "record_summary", "description": "Record the structured summary of the document.", "strict": True, "input_schema": { "type": "object", "properties": {"summary": {"type": "string"}}, "required": ["summary"], "additionalProperties": False, }, } response = client.messages.create( model="claude-fable-5-1", max_tokens=16000, tools=[record_summary_tool], tool_choice={"type": "auto"}, messages=[ { "role": "user", "content": "Summarize: The meeting moved to Thursday. Call the record_summary tool with your result.", } ], ) print(response.content)См. Строгое использование инструментов и Принудительное использование инструментов. Если вы принудительно вызывали инструмент только для получения JSON, соответствующего схеме, используйте вместо этого выходные данные JSON (
output_config.format).Если конкретный вызов инструмента на текущем ходе многоходового разговора требуется вашему приложению, а не пользователю, добавьте системное сообщение посреди разговора после последнего хода
user. Назовите инструмент, укажите, что вызов обязателен на этом ходе, и попросите Claude начать ответ с него. Поскольку сообщение добавляется в конец, а не записывается в системную подсказку верхнего уровняsystem, предыдущие ходы остаются побайтово идентичными и сохраняют попадания в кэш подсказок:Pythonclient = anthropic.Anthropic() search_help_center_tool = { "name": "search_help_center", "description": "Search the help center for policy and troubleshooting articles.", "strict": True, "input_schema": { "type": "object", "properties": {"query": {"type": "string"}}, "required": ["query"], "additionalProperties": False, }, } response = client.messages.create( model="claude-fable-5-1", max_tokens=16000, system="You are a customer support assistant for an online electronics store.", tools=[search_help_center_tool], messages=[ { "role": "user", "content": "My headphones from order A1234 arrived yesterday.", }, { "role": "assistant", "content": "Thanks for confirming. How can I help with order A1234?", }, {"role": "user", "content": "I opened the box. Can I still return them?"}, # Приложение требует поиска в справочном центре перед любым ответом # о политике. Добавление требования как системного сообщения оставляет # предыдущие реплики без изменений. { "role": "system", "content": "Tool-use requirement for the current turn: the application requires a call to the search_help_center tool in your response to the user's latest message. Begin your response with the search_help_center tool call. Do not reply with text only.", }, ], ) print(response.content)Сохраняйте сообщение
role: "system"в истории в последующих запросах, как и любой другой ход. Системным сообщениям посреди разговора не нужен бета-заголовок.tool_choice: {"type": "none"}по-прежнему работает для хода, на котором нельзя вызывать инструменты. -
Блоки размышлений Claude Fable 5.1 читают только Claude Fable 5.1 и Claude Mythos 5.1: каждый блок
thinkingфиксирует, какая модель его создала. Claude Fable 5.1 читает собственные блоки, а также блоки от Claude Mythos 5.1, Claude Opus 5, Claude Fable 5, Claude Mythos 5 и более ранних моделей Claude. Разговор, переходящий наclaude-fable-5-1с любой из них, сохраняет свои предыдущие рассуждения. Это условие одностороннее: кроме Claude Mythos 5.1, ни одна из этих моделей не может читать блоки Claude Fable 5.1.Разговор, который выполнялся на Claude Fable 5.1, может попасть на другую модель, более старую или более новую, из-за переключения маршрутизатора, повторной попытки на стороне клиента или резервного переключения при отказе классификатора, включая резервное переключение на стороне сервера. API удаляет блоки, которые эта модель не может прочитать, до того как она их увидит, запрос выполняется успешно, и плата за отброшенные входные токены не взимается. Целевая модель заново планирует работу без этих рассуждений, что может увеличить стоимость и задержку на первом ходе после переключения. Чтобы увидеть, что было отброшено, отправьте бета-заголовок
thinking-binding-controls-2026-08-01: тогда ответы будут содержать массивinput_transformations, в котором каждый отброшенный блок указан сreason: "model_binding_mismatch". См. Переключение моделей посреди разговора. -
Редактирование предыдущих ходов делает блоки размышлений недействительными: каждый блок
thinkingот Claude Fable 5.1 действителен только относительно системной подсказкиsystem,toolsи истории разговора, которые ему предшествовали. Если историей вашего разговора управляет Claude Code, claude.ai, Claude Managed Agents или Claude Agent SDK, этот префикс уже сохраняется неизменным. Если ваш код сам формирует массивmessages, этот пункт относится к вам, а полным руководством по интеграции служит раздел Сохранённые размышления. Там, где проверка применяется, запрос, который отправляет блок обратно после изменения любого из этих элементов, отклоняется с ошибкой 400:messages.5.content.0: Invalid `signature` in `thinking` block. The block is bound to a different conversation. Remove the block, or set `thinking.block_binding.prefix_mismatch_behavior` to "drop_block". That setting requires the `thinking-binding-controls-2026-08-01` value in the `anthropic-beta` header.API применяет проверку для новых аккаунтов, созданных 31 августа 2026 года или позже. Для аккаунтов, созданных ранее, API фиксирует несоответствие, но не реагирует на него, если только в запросе не задано
thinking.block_binding.prefix_mismatch_behavior, что включает применение проверки. Если на таких аккаунтах вы отправляете бета-заголовокthinking-binding-controls-2026-08-01и оставляете это поле незаданным, ответ перечисляет каждый блок, не прошедший проверку, вinput_transformationsкак записьthinking_mismatch_allowed. Сделайте своё приложение совместимым с проверкой независимо от возраста аккаунта: те же шаблоны поддерживают кэш подсказок «тёплым», а протестировать проверку можно с любого аккаунта, отправивprefix_mismatch_behavior. Если вы выпускаете инструмент или фреймворк, который люди запускают со своим собственным ключом API, протестируйте его таким образом до запуска: ваш ключ, вероятно, относится к более старому аккаунту, а ваши пользователи на новых аккаунтах столкнутся с проверкой раньше вас. Чтобы узнать, применяется ли проверка к вашему аккаунту по умолчанию, отправьте запрос, редактирующий историю, без бета-заголовка: ошибка 400 с упоминанием заголовка означает, что применяется.Ошибка постоянна для данного тела запроса: цикл автоматических повторных попыток её не устранит. Чтобы продолжить без недействительных рассуждений вместо сбоя, удалите блоки
thinkingиз истории и повторите запрос один раз либо отправьте бета-заголовокthinking-binding-controls-2026-08-01и установитеprefix_mismatch_behaviorв"drop_block"(по умолчанию —"error"). При"drop_block"API отбрасывает несоответствующий блок и все блоки размышлений после него в разговоре и сообщает о каждом сreason: "prefix_binding_mismatch"в массивеinput_transformationsответа:Pythonclient = anthropic.Anthropic() response = client.beta.messages.create( model="claude-fable-5-1", max_tokens=16000, thinking={ "type": "adaptive", "block_binding": {"prefix_mismatch_behavior": "drop_block"}, }, messages=[ { "role": "user", "content": "What is the greatest common divisor of 1071 and 462?", } ], betas=["thinking-binding-controls-2026-08-01"], ) for block in response.content: if block.type == "text": print(block.text) print(f"Input transformations: {len(response.input_transformations or [])}")Эндпоинт подсчёта токенов выполняет ту же проверку. Формат ответа и размещение при потоковой передаче описаны в разделе Управление несохранёнными блоками (бета).
Шаблоны, которые делают последующие блоки размышлений недействительными, и что делать вместо них:
- Редактирование, изменение порядка или удаление предыдущих ходов. Сюда относятся удаление старых результатов инструментов, вырезание ходов из середины стенограммы и сжатие на стороне клиента, при котором последние ходы и их блоки размышлений сохраняются дословно после сводки (включая фоновое сжатие, которое подставляет свою сводку через несколько ходов). Вместо этого используйте серверное «compaction» (сжатие) или «context editing» (редактирование контекста) (очистку результатов инструментов для старых результатов инструментов) либо один из вариантов клиентского сжатия из раздела Сокращайте контекст на сервере.
- Внедрение содержимого, которое вы не сохраняете, например напоминания на каждом ходе, добавляемого после блоков
tool_resultи удаляемого в следующем запросе. Вместо этого отправляйте напоминание как системное сообщение, ограниченное ходом и оставляйте его в истории. - Перестроение системной подсказки верхнего уровня
systemили массиваtoolsмежду запросами в одном разговоре, например для обновления текущей даты или для добавления или удаления инструмента. Вместо этого добавьте системное сообщение посреди разговора, содержащее новую инструкцию («Текущая дата — 2026-09-14.») или блокиtool_additionиtool_removal. Инструмент, который не был объявлен вtoolsв начале, можно определить внутри блокаtool_addition(бета-заголовокinline-tools-2026-09-15). - URL изображения или документа, который в последующем запросе отдаёт другие байты. Проверка охватывает байты, а не строку URL, поэтому ротируемый подписанный URL для того же файла допустим. Для содержимого, на которое вы ссылаетесь на нескольких ходах, загрузите его один раз через Files API и отправляйте
file_idлибо отправляйте base64.
Каждая из этих замен также сохраняет предыдущие ходы побайтово идентичными и сохраняет попадания в кэш подсказок, которые были бы потеряны при редактировании истории, системной подсказки
systemили массиваtools.Шаблоны, которые продолжают работать:
- Истории только с добавлением: добавление ходов и передача предыдущих ходов обратно точно в том виде, в каком они были отправлены и получены, включая добавленные сообщения
role: "system". - Удаление блоков размышлений из предыдущих ходов ассистента, начиная с самых старых.
- Изменение
effort,max_tokensили любого другого параметра запроса внеsystem,toolsиmessages, а также добавление или перемещение маркеровcache_control. - Серверное сжатие и редактирование контекста, включая очистку блоков размышлений. Они не считаются правками, поскольку проверка сравнивает разговор в том виде, в каком вы его отправили.
Чтобы проверить существующую интеграцию:
- Зафиксируйте точные тела запросов, которые она отправляет на протяжении нескольких обычных ходов, включая сжатие или изменение инструментов, если они есть в вашем продукте. Для каждой пары последовательных запросов сравните системную подсказку
system, массивtoolsи общий префиксmessages. Они должны быть побайтово идентичны вплоть до вновь добавленных ходов. Ожидаемое исключение — запрос, который подставляет подписанный блокcompactionиз сжатия по запросу: блок заменяет сообщения, которые он обобщает, в началеmessages, а всё, что идёт после него, по-прежнему должно совпадать. - Запустите обычный многоходовый сеанс с
claude-fable-5-1с бета-заголовкомthinking-binding-controls-2026-08-01иprefix_mismatch_behavior: "drop_block"и записывайте в журналinput_transformationsдля каждого ответа. Пустой массив на каждом ходе означает, что история не нарушена. Запись сreason: "prefix_binding_mismatch"означает, что что-то перед блоком по путиpathизменилось с момента предыдущего запроса. Запись сreason: "model_binding_mismatch"означает, что разговор переключился на другую модель, и это не ошибка в вашем коде. Это работает с любого аккаунта, поскольку задание поля включает применение проверки для запроса. В CI установите вместо этого"error", чтобы правка приводила к сбою прогона. - Выберите настройку для продакшена. Оставьте значение по умолчанию
"error", если несоответствие префикса может означать только ошибку в вашем коде, или установите"drop_block", чтобы отбрасывать затронутые блоки вместо сбоя, и в любом случае отслеживайте ошибки 400 или записиinput_transformations.
Однократное отбрасывание блоков размышлений, например на границе сжатия, мало на что влияет. Интеграция, которая делает предыдущие размышления недействительными при каждом запросе, каждый раз заново начинает заполнение кэша подсказок, что может увеличить стоимость задачи (см. Ведите историю разговора в режиме только добавления).
Изменения в поведении
-
Меньше параллельных вызовов инструментов в длинных агентных циклах: в длительных циклах, где следующие независимые операции чтения лишь подразумеваются задачей, Claude Fable 5.1 может делать по одному вызову инструмента за ход. Это касается, например, собственных агентов для программирования, сред с bash и редактором и computer use. Каждый лишний ход стоит токенов, дополнительного обмена запросом и ответом и реального времени. Добавляйте после каждого сообщения пользователя инструкцию из одного предложения с просьбой объединять вызовы. Передавайте её как системное сообщение в рамках хода (
clear_at: "next_user_message", бета) или, без бета-функций, в текстовом блоке после блоковtool_result. В последующих запросах оставляйте предыдущие копии в истории. См. Объединяйте независимые вызовы инструментов в агентных циклах. -
Меньше сообщений о ходе работы между вызовами инструментов: во время длинных последовательностей вызовов Claude Fable 5.1 пишет меньше обновлений статуса, чем Claude Fable 5, а её итоговые сводки в агентном программировании короче. Если ваш интерфейс показывает такие обновления, установите для
thinking.displayзначение"updates"(бета) или"summarized"и явно попросите о них в подсказке. См. Обновления о ходе работы между вызовами инструментов и Просите показывать пользователю обновления о ходе работы. -
Меньше вызовов поиска и извлечения данных при низком уровне усилий: при уровне усилий
lowClaude Fable 5.1 чаще, чем Claude Fable 5, отвечает по памяти, не вызывая инструмент поиска или извлечения данных. Если ваш продукт рассчитывает на извлечение данных при низком уровне усилий, повысьте уровень усилий для таких запросов или укажите модели, когда нужно выполнять поиск. См. Запуск поиска при низком уровне усилий.
Различия в плотности текста, форматировании в чате, цитировании в сводках и редактировании файлов не влияют на интеграцию с API. Они описаны в разделе Изменения по сравнению с Claude Fable 5.
Рекомендуемые изменения
Эти изменения не обязательны, но каждое из них снижает стоимость или задержку либо устраняет один из сценариев сбоя:
-
Изменяйте уровень усилий посреди разговора (бета): в Claude Fable 5
output_config.effortзадаётся на уровне запроса, и его изменение между запросами сбрасывает кэшированные префиксы предыдущих ходов. Вclaude-fable-5-1сообщениеrole: "system", содержащее толькоoutput_config, повышает уровень усилий для сложного шага или понижает его для рутинных, не делая недействительным кэш подсказок:Pythonclient = anthropic.Anthropic() response = client.beta.messages.create( model="claude-fable-5-1", max_tokens=4096, output_config={"effort": "high"}, messages=[ { "role": "user", "content": "Plan a migration from SQLite to PostgreSQL in three short steps.", }, { "role": "assistant", "content": "1. Export the SQLite data. 2. Create the PostgreSQL schema. 3. Import the data and verify row counts.", }, # Системное сообщение только с effort: новый уровень действует со следующего хода пользователя. {"role": "system", "content": [], "output_config": {"effort": "low"}}, {"role": "user", "content": "Summarize the plan in one sentence."}, ], betas=["mid-conversation-output-config-2026-07-01"], ) for block in response.content: if block.type == "text": print(block.text)Если сообщение размещено между ходом
assistantи следующим ходомuser, как здесь, оно вступает в силу с этого ходаuser. Если оно размещено сразу после ходаuserс новыми входными данными, оно задаёт уровень для ответа Claude на этот ход. Ходuser, содержащий только результаты инструментов, не считается новыми входными данными: изменение ожидает следующего ходаuserс новыми входными данными. Затем уровень сохраняется, пока другое сообщениеrole: "system"его не изменит. Принимаются только именованные уровни (low,medium,high,xhigh,max), и требуется бета-заголовокmid-conversation-output-config-2026-07-01. См. Уровень усилий для отдельных сообщений. -
Изменяйте инструкции и инструменты с помощью системных сообщений посреди разговора: чтобы изменить инструкции или инструменты в ходе сеанса, добавьте сообщение
role: "system"с блокамиtool_additionиtool_removalдля изменения инструментов (бета-заголовокinline-tools-2026-09-15в Claude API). Блокtool_additionможет ссылаться на инструмент, объявленный вtoolsв начале сеанса, или содержать полное определение инструмента, поэтому инструмент, неизвестный в начале сеанса, не обязательно должен быть вtools. Это сохраняет попадания в кэш подсказок для предыдущих ходов и сохраняет историю разговора только с добавлением. Более старый заголовокmid-conversation-tool-changes-2026-07-01по-прежнему работает для изменений, ссылающихся на инструмент по имени, в Claude API, Amazon Bedrock и Google Cloud. То же сообщение заменяет принудительныйtool_choice, когда на текущем ходе должен быть выполнен конкретный инструмент (см. Критические изменения). Напоминание, которое относится только к одному ходу, отправляйте как отдельное текстовое сообщениеrole: "system"сclear_at: "next_user_message"(системные сообщения, ограниченные ходом, бета-заголовокmid-conversation-system-clear-at-2026-08-21) и оставляйте его в истории: оно перестаёт отображаться после следующего сообщения пользователя и после очистки не расходует токены. Сообщение, содержащее блокиtool_additionилиtool_removal, не может быть ограничено ходом. -
Используйте
fallbacks: "default"для отказов: продолжайте обрабатыватьstop_reason: "refusal"и читатьstop_details.categoryдо содержимого ответа. Чтобы автоматически повторно выполнять отклонённые запросы на другой модели, установитеfallbacks: "default"(бета, заголовокserver-side-fallback-2026-07-01)."default"повторяет отклонённый запрос на модели, которую Anthropic рекомендует для данной категории. Допустимые резервные модели для Claude Fable 5.1 — Claude Opus 4.8 (claude-opus-4-8) и Claude Opus 5 (claude-opus-5). Явный списокfallbacksможет указывать любую из них. Резервная модель не получает блоки размышлений Claude Fable 5.1. Параметрfallbacksнедоступен в Amazon Bedrock, Google Cloud и Microsoft Foundry. На этих платформах используйте вместо него резервное переключение на стороне клиента. Если вы реализуете повторную попытку самостоятельно, кредит при резервном переключении применяется на тех же условиях, что и для Claude Fable 5. См. Отказы и резервная обработка. -
Начинайте с уровня усилий
highи проводите перебор: значение параметра effort по умолчанию —high, и поддерживаются все пять уровней. Следуйте рекомендациям для Claude Fable 5:highдля большинства задач иmediumкак способ контроля затрат, который стоит протестировать. Преимущества Claude Fable 5.1 перед Claude Fable 5 наиболее заметны на уровняхxhighиmax, но эти уровни также увеличивают время размышлений и время до первого ответа, поэтому переходите на них для задач, наиболее чувствительных к возможностям модели, и там, где ваши оценки показывают выигрыш. Проведите новый перебор на собственных оценках вместо того, чтобы переносить настройку, подобранную для Claude Fable 5. См. Рекомендуемые уровни усилия для Claude Fable 5.1. -
Сокращайте контекст на сервере или сжимайте его в форме, не содержащей устаревших размышлений: если ваш код усекает или обобщает старые ходы на стороне клиента, самое простое решение — перенести эту работу на серверное сжатие или редактирование контекста. Ни то, ни другое не считается правкой, поскольку проверка истории сравнивает разговор в том виде, в каком вы его отправили, поэтому ничто из удалённого ими не делает последующие блоки размышлений недействительными, а параметр
instructionsсжатия принимает вашу собственную подсказку для обобщения. Если вы сохраняете последние ходы дословно после сводки или обобщаете в фоновом режиме, пока разговор продолжается, используйте сжатие по запросу (бета-заголовокcompact-2026-09-04) вместо сводки, написанной клиентом. API создаёт подписанный блок сводки, который вы помещаете на место обобщаемых им сообщений. Блоки размышлений в сохраняемых вами ходах могут оставаться действительными при условиях, описанных в разделе Сжатие и сохранённые размышления. Если вы оставляете сжатие на стороне клиента, выберите один из трёх вариантов:- Простое сжатие (рекомендуется): замените всю историю одним сообщением со сводкой плюс новым ходом пользователя и больше ничего не воспроизводите. Блоки размышлений не переносятся, поэтому ничего не ломается. Модели Claude обучены на долгосрочных задачах с этой схемой, и для большинства рабочих нагрузок она работает сопоставимо с более сложными.
- Сжатие с сохранением хвоста: если вы сохраняете последние ходы дословно после сводки, удалите из этих ходов блоки
thinkingиredacted_thinking(текст и вызовы инструментов можно оставить) или установитеprefix_mismatch_behavior: "drop_block". Их размышления были созданы относительно полной истории, и в противном случае после сводки они не пройдут проверку. - Фоновое сжатие: если вы создаёте сводку вне критического пути и подставляете её позже, каждый ход, созданный за это время, содержит размышления, предшествующие подстановке. Отправляйте
"drop_block"в каждом запросе, который всё ещё содержит блоки размышлений, созданные до подстановки (или удаляйте эти блоки самостоятельно;input_transformationsв первом ответе после подстановки точно перечисляет, какие именно), либо выполняйте сжатие синхронно.
Не вырезайте отдельные ходы из середины стенограммы: это делает недействительными все последующие блоки размышлений, и ни один клиентский вариант этого не избегает. Используйте системное сообщение посреди разговора для изменения инструкций, которое вы вносили, или серверное редактирование контекста для выборочного удаления. См. Обратная передача блоков сжатия.
Контрольный список миграции
- Обновите название модели с
claude-fable-5наclaude-fable-5-1(или сclaude-mythos-5наclaude-mythos-5-1). - Замените принудительный
tool_choice({type: "any"}или{type: "tool", ...}). Он возвращает ошибку 400. Используйте{type: "auto"}вместе с явной инструкцией и инструментами соstrict: trueлибо выходные данные JSON. Поместите инструкцию в ходuserили в сообщениеrole: "system"посреди разговора, если вызов требуется вашему приложению. - Продолжайте передавать блоки
thinkingобратно без изменений на каждом ходе, включая пустые. Claude Fable 5.1 читает блоки от Claude Opus 5, Claude Fable 5, Claude Mythos 5 и более ранних моделей. При переносе разговора с Claude Fable 5.1 на любую модель, кроме Claude Mythos 5.1, её блоки отбрасываются. - Если ваш код сам формирует массив
messages, проверьте, редактирует ли он предыдущие ходы: запустите сеанс с бета-заголовкомthinking-binding-controls-2026-08-01иprefix_mismatch_behavior: "drop_block", записывайте в журналinput_transformationsи исправьте каждыйprefix_binding_mismatch. Записиmodel_binding_mismatchпосле переключения модели ожидаемы. - Ведите историю разговора в режиме только добавления: зафиксируйте
systemиtoolsв начале сеанса и переносите изменения в ходе сеанса в сообщенияrole: "system"и блокиtool_addition/tool_removal, отправляйте напоминания для каждого хода как системные сообщения в рамках хода, которые вы никогда не удаляете, сокращайте контекст на стороне сервера или удаляйте блоки размышлений из всех ходов, которые вы переносите через клиентскую сводку, и ссылайтесь на файлы, используемые на нескольких ходах, поfile_id. - Выберите значение
prefix_mismatch_behaviorдля продакшена ("error"по умолчанию или"drop_block") и отслеживайте его. Если вы поддерживаете инструмент, который другие запускают со своим ключом API, тестируйте с заданным полем: для новых аккаунтов проверка применяется по умолчанию, даже если для вашего — нет. - Проверьте агентные циклы на поведение «один вызов инструмента за ход» и добавьте инструкцию с просьбой объединять вызовы.
- Если ваш интерфейс отображает текст о ходе работы между вызовами инструментов, установите
thinking.displayв"updates"(бета) или"summarized"и запрашивайте обновления в подсказке. - Если вы меняете уровень усилий между запросами, перенесите изменение в сообщение
role: "system"с уровнем усилий для отдельного сообщения (бета), чтобы сохранить попадания в кэш. - Обрабатывайте
stop_reason: "refusal"и читайтеstop_details.category. Рассмотрите использованиеfallbacks: "default"(бета). - Заново оцените
effortс помощью нового перебора, начиная сhigh, и заново определите базовые показатели стоимости и задержки на собственных рабочих нагрузках. Токенизатор не изменился. Чтение из кэша подсказок стоит четверть тарифа Claude Fable 5.
Миграция на Claude Fable 5.1 с Claude Opus 5
Claude Fable 5.1 использует те же приёмы работы с Messages API и «tool use» (использование инструментов), что и Claude Opus 5. Сохраняются:
- контекстное окно размером 1M токенов по умолчанию;
- максимум 128k выходных токенов;
- минимальный размер в 512 токенов для «prompt caching» (кэширование подсказок);
- поддержка системных сообщений в середине разговора.
Также остаются в силе запрет на предварительное заполнение, ограничение на параметры сэмплирования и значение "omitted" по умолчанию для thinking.display. Выполните всё, что описано в разделе Миграция на Claude Fable 5.1 с Claude Fable 5, а также следующее.
Обновите название модели
model = "claude-opus-5" # Before
model = "claude-fable-5-1" # After
# Или для Claude Mythos 5.1, который предоставляет те же возможности верифицированным организациям:
model = "claude-mythos-5-1" # AfterЧто изменилось
-
Размышления больше нельзя отключить: Claude Opus 5 принимает
thinking: {type: "disabled"}при уровне усилийhighили ниже. Вclaude-fable-5-1иclaude-mythos-5-1адаптивные размышления всегда включены, иthinking: {type: "disabled"}возвращает ошибку 400 при любом уровне усилий. Удалите это поле, контролируйте расход токенов с помощью более низких уровней усилий и пересмотритеmax_tokensдля рабочих нагрузок, которые выполнялись с отключёнными размышлениями. -
Принудительный выбор инструмента не поддерживается: Claude Opus 5 принимает
tool_choiceсо значениямиanyиtool.claude-fable-5-1возвращает ошибку 400. См. Критические изменения. -
Сохранение размышлений между моделями: Claude Fable 5.1 читает блоки размышлений Claude Opus 5: разговоры, переходящие с
claude-opus-5наclaude-fable-5-1, сохраняют свои рассуждения. Claude Opus 5 не может читать блоки Claude Fable 5.1. Блоки Claude Fable 5.1 также перестают быть действительными при изменении предыдущих ходов: если ваш код редактирует предыдущие сообщения, перестраиваетsystemилиtoolsили выполняет сжатие на стороне клиента между запросами, Claude Opus 5 не возражала, ноclaude-fable-5-1отклоняет или отбрасывает все последующие блоки размышлений. Выполните трёхшаговую проверку из того раздела, прежде чем переключать трафик. См. Критические изменения. -
Текст между вызовами инструментов возвращается в блоках размышлений: в Claude Opus 5 текст, который модель пишет между вызовами инструментов, возвращается как блоки
text. Вclaude-fable-5-1, как и в Claude Fable 5, это повествование возвращается как блокиthinkingс обновлениями о ходе работы, по одному перед каждым вызовом инструмента. При значенииthinking.displayпо умолчанию"omitted"они не содержат читаемого текста. Если ваш интерфейс отображает это повествование, установитеdisplay: "updates"(бета), чтобы получать обновления о ходе работы в виде текста, пока рассуждения остаются скрытыми, или"summarized", чтобы получать и то, и другое. Затем отображайте непустые блокиthinkingмежду блокамиtool_use. См. Обновления о ходе работы между вызовами инструментов. -
Классификаторы безопасности и маршрутизация при резервном переключении: Claude Fable 5.1 использует классификаторы безопасности, охватывающие те же категории
stop_details, что и Claude Fable 5, — более широкий набор, чем у классификаторов Claude Opus 5. Ожидайте дополнительных значенийstop_details.category, таких как"bio"; полный набор см. в таблице категорий отказов. О настройкеfallbacksи допустимых целевых моделях см. Используйтеfallbacks: "default"для отказов. -
Цены: $10 USD за миллион входных токенов и $50 USD за миллион выходных токенов по сравнению с $5 USD и $25 USD для Claude Opus 5. Чтение из кэша подсказок стоит $0,25 USD за миллион токенов — половина тарифа Claude Opus 5. См. Цены Claude.
-
Хранение данных: Claude Fable 5.1 и Claude Mythos 5.1 требуют 30-дневного хранения данных, недоступны в рамках соглашений о нулевом хранении данных (ZDR), если это явно не разрешено Anthropic, и отнесены к категории Covered Models. Claude Opus 5 доступна в рамках ZDR. См. Требования к хранению данных для конкретных моделей.
Контрольный список миграции
- Если в вашей организации действует соглашение о «zero data retention» (нулевом хранении данных), или ZDR, сначала подтвердите право на использование: эти модели недоступны в рамках ZDR, если это явно не разрешено Anthropic. См. Требования к хранению данных для конкретных моделей.
- Измените имя модели с
claude-opus-5наclaude-fable-5-1(илиclaude-mythos-5-1). - Удалите любую конфигурацию
thinking: {type: "disabled"}: наclaude-fable-5-1она возвращает ошибку 400. Контролируйте расход токенов с помощью более низких уровней effort (уровня усилий) и пересмотритеmax_tokens. - Замените принудительный
tool_choice(anyилиtool) наautoв сочетании с явной инструкцией (ходuserили системное сообщение посреди разговора) и инструментами соstrict: trueлибо на «JSON outputs» (выходные данные JSON). - Если ваш интерфейс отображает текст между вызовами инструментов, установите
display: "updates"(бета) или"summarized"и отображайте непустые блокиthinking. - Примените пункты о сохранённых размышлениях, редактировании истории, поведении, effort и «fallback» (резервном переключении) из контрольного списка для Claude Fable 5.
- Заново определите базовый уровень затрат на собственных рабочих нагрузках. «Tokenizer» (токенизатор) не изменился. Цены за токен отличаются.
Миграция на Claude Fable 5.1 с Claude Opus 4.8 или более ранних версий
Пройдите по контрольному списку ниже. Если вы используете Claude Opus 4.7 или более раннюю версию, начните с соответствующего раздела руководства по миграции на Claude Opus 5.5.
Обновите имя модели
model = "claude-opus-4-8" # Before
model = "claude-fable-5-1" # After
# Или для Claude Mythos 5.1, который предоставляет те же возможности верифицированным организациям:
model = "claude-mythos-5-1" # AfterКонтрольный список миграции
- Если у вашей организации есть соглашение о нулевом хранении данных (ZDR), сначала подтвердите право на использование: эти модели недоступны в рамках ZDR, если это явно не разрешено Anthropic. Claude Opus 4.8 доступна в рамках ZDR.
- Измените имя модели с
claude-opus-4-8наclaude-fable-5-1(илиclaude-mythos-5-1). - Удалите любую конфигурацию
thinking: {type: "disabled"}и пересмотритеmax_tokens. Запросы без поляthinkingвыполняются с адаптивными размышлениями. - Обновите разбор ответов, который читает содержимое по позиции, например
content[0].text: теперь ответ может начинаться с блоковthinking, поэтому выбирайте блоки содержимого поtype. - Замените принудительный
tool_choice(anyилиtool) наautoв сочетании с явной инструкцией (ходuserили системное сообщение посреди разговора) и инструментами соstrict: trueлибо на выходные данные JSON. - Передавайте блоки
thinkingобратно без изменений и рассматривайте их текст только как предназначенный для отображения. Claude Fable 5.1 читает блоки размышлений Claude Opus 4.8: разговор, который переходит наclaude-fable-5-1, сохраняет своё предыдущее рассуждение. Claude Opus 4.8 не может читать блоки Claude Fable 5.1. - Если ваш код сам формирует массив
messages, проверьте, редактирует ли он предыдущие ходы. Интеграции, написанные для Claude Opus 4.8 и более ранних версий, часто обрезают старые ходы, удаляют или перестраивают предыдущие сообщения или обновляют подсказкуsystemпри каждом запросе, и Claude Opus 4.8 никогда против этого не возражала. Наclaude-fable-5-1каждое из этих действий делает недействительными последующие блоки размышлений. - Обрабатывайте
stop_reason: "refusal", считывайтеstop_details.categoryи рассмотрите возможность использованияfallbacks: "default"(бета). - Примените пункты о сохранённых размышлениях, редактировании истории, поведении, effort для отдельных сообщений и обновлениях о ходе выполнения из контрольного списка для Claude Fable 5.
- Заново оцените
effort(начните сhigh), проверьте подсказки, близкие к минимуму для кэширования в 512 токенов (1 024 токена на Claude Opus 4.8), и заново определите базовые уровни затрат и задержки. Цены за токен отличаются, а токены размышлений оплачиваются как выходные токены, поэтому рабочие нагрузки, которые выполнялись без размышлений на Claude Opus 4.8, могут генерировать больше выходных токенов на запрос.
Миграция на Claude Mythos 5.1 с Claude Mythos 5
Claude Mythos 5.1 — это аналог Claude Fable 5.1 для организаций, прошедших проверку в рамках программ верификации Anthropic, таких как Cyber Verification Program. Прежде чем менять идентификаторы моделей, убедитесь, что у вашей организации есть доступ к Claude Mythos 5.1.
Отличия на уровне API совпадают с описанными в разделе Миграция на Claude Fable 5.1 с Claude Fable 5: принудительный выбор инструмента возвращает ошибку 400, и только Claude Mythos 5.1 и Claude Fable 5.1 читают блоки размышлений Claude Mythos 5.1 (Claude Mythos 5.1 читает блоки Claude Mythos 5, но не наоборот). В отличие от Claude Fable 5.1, Claude Mythos 5.1 не выполняет проверку разговора, поэтому редактирование предыдущих ходов не делает блоки размышлений недействительными, хотя по-прежнему сбрасывает кэш подсказок.
Обновите имя модели
model = "claude-mythos-5" # Before
model = "claude-mythos-5-1" # AfterКонтрольный список миграции
- Измените имя модели с
claude-mythos-5наclaude-mythos-5-1. - Замените принудительный
tool_choice(anyилиtool) наautoв сочетании с явной инструкцией (ходuserили системное сообщение посреди разговора) и инструментами соstrict: trueлибо на выходные данные JSON. - Обрабатывайте
stop_reason: "refusal"и считывайтеstop_details.categoryперед содержимым ответа. См. Отказы и резервное переключение. - Продолжайте передавать блоки
thinkingобратно без изменений на каждом ходе, включая пустые. - Если ваш код сам формирует массив
messages, сохраняйте историю разговора в режиме только добавления, чтобы кэш подсказок оставался «тёплым». Claude Mythos 5.1 не выполняет проверку разговора, поэтому правки не делают её блоки размышлений недействительными. - Примените изменения поведения и рекомендуемые изменения из раздела о Claude Fable 5, за исключением пунктов о редактировании истории, которые не относятся к Claude Mythos 5.1.
- Заново оцените
effortс помощью нового перебора значений и заново определите базовые уровни затрат и задержки. Чтение из кэша подсказок стоит четверть от тарифа Claude Mythos 5.
Was this page helpful?