Примечание автора: ни Codex, ни WorkBuddy не создавались специально для работы с Claude, поэтому почти все ошибки возникают на уровне интеграции. В статье мы разбираем три их типа — эндпоинты, обмен с инструментами и блоки рассуждений — и для каждого приводим текст ошибки и способ исправления.
Мы сами наступили на эти грабли. Сначала решили сэкономить время и вызывали Claude через OpenAI-совместимый протокол, то есть использовали его как модель OpenAI. Обычный диалог работал нормально, но стоило вызвать инструмент — появлялась ошибка, и повторные попытки не помогали. Всё заработало только после перехода на нативный эндпоинт Anthropic /v1/messages.
Сначала проверьте, столкнулись ли вы с той же проблемой: если Codex выдаёт ошибку, связанную с wire_api, сразу после запуска, WorkBuddy нормально общается, но возвращает 400 при вызове инструмента, или ответ почему-то оказывается пустым — скорее всего, это ваш случай.
- С самой моделью всё в порядке: проблема в том, что на уровне интеграции не совпадают три вещи — эндпоинты, обмен с инструментами и блоки рассуждений.
- Проще всего исправить третью категорию — блоки рассуждений и бюджет вывода. Достаточно изменить способ чтения ответа и значение
max_tokensв клиенте. - Средняя по сложности — вторая категория, обмен с инструментами. Обычно её исправляют с помощью слоя преобразования или шлюза.
- Сложнее всего первая категория — эндпоинты. Придётся сменить клиент или добавить шлюз преобразования.
Главный вывод статьи: нативный протокол Anthropic > шлюз с преобразованием в протокол Anthropic > OpenAI-совместимый чат. Для начала можно сделать одну вещь: определить по таблице ниже, к какой категории относится ваша ошибка.
Три основные причины ошибок при работе Codex и WorkBuddy с Claude
Для начала разберёмся с терминами. Responses, Messages и Chat Completions — это как три способа сделать заказ: на кухне готовят одно и то же блюдо, но формат меню отличается. Codex делает заказ только через Responses, а Claude принимает Messages и Chat Completions. Блок thinking — это что-то вроде черновика модели. Anthropic проверяет, не изменил ли кто-нибудь этот черновик.
| Категория | В чём проблема | Кто в основном исправляет | Сложность |
|---|---|---|---|
| 1. Несовпадение эндпоинтов | Codex отправляет только Responses, а Claude не принимает этот формат | Замена инструмента или шлюза | Самая высокая |
| 2. Несовпадение при обмене данными с инструментами | При преобразовании меняются id, блоки содержимого или блоки thinking | Преимущественно шлюз | Средняя |
| 3. Несовпадение блоков thinking и бюджета | Модель каждый раз выполняет рассуждение, а клиент по-прежнему читает результат по-старому | Клиент | Самая низкая |
Категория 1: несовместимость эндпоинтов при вызове Claude из Codex
Как выглядит ошибка: Error loading config.toml: wire_api = "chat" is no longer supported. How to fix: set wire_api = "responses".
Это значит, что настройка wire_api = "chat" больше не поддерживается и её нужно заменить на responses.
Почему это происходит: согласно официальной справке по настройке Codex, теперь для wire_api доступно только значение responses. Прежний обходной путь — переключить wire_api на chat — больше не работает: новая версия Codex выдаёт ошибку уже при загрузке конфигурации. Даже если этот провайдер вообще не используется, из-за ошибки не запустится и codex login status. При этом для моделей Claude в APIYI apiyi.com доступны только эндпоинты Anthropic и OpenAI, а /v1/responses не предоставляется. Форматы на двух сторонах не совпадают, а преобразовывать их некому — поэтому ошибка неизбежна.
Как исправить:
1. Клиент: откройте ~/.codex/config.toml и, следуя подсказке в ошибке, удалите оставшуюся настройку chat, чтобы Codex снова мог запускаться.
2. Другой инструмент: если вы просто хотите писать код с Claude, перейдите на Claude Code — он использует нативный API Messages.
3. Шлюз: если нужно остаться в Codex, добавьте шлюз, который преобразует запросы Responses в Messages. В качестве адреса провайдера предпочтительно указывать нативный эндпоинт Anthropic.
Как проверить: codex login status выполняется без ошибки; при работе через шлюз отправьте команду, для которой нужно прочитать файл, — Codex должен успешно завершить полный цикл вызова инструмента.
Категория 2: ошибки в цикле вызова инструментов Claude
Как выглядит ошибка:
— tool_use ids were found without tool_result blocks immediately after
— An assistant message with 'tool_calls' must be followed by tool messages...
— thinking or redacted_thinking blocks in the latest assistant message cannot be modified
— Invalid signature in thinking block. The block is bound to a different conversation.
Первая ошибка означает, что за блоком tool_use не следует соответствующий tool_result. Вторая указывает на ту же проблему в формате Chat. Третья говорит о том, что блок рассуждений из предыдущего сообщения был изменён. Четвёртая — что подпись блока рассуждений не соответствует текущей сессии.
Почему это происходит: слой совместимости по отдельности преобразует блоки Claude — text, tool_use, tool_result и thinking — в tool_calls и role: tool, а затем преобразует их обратно. Если ID не совпадут, блоки содержимого объединятся или блок thinking переместится, API вернёт ошибку 400. Кроме того, в Responses есть роль developer, а в Messages её нет, поэтому её содержимое нужно включить в system. Также claude-opus-5-5 не поддерживает следующие старые настройки: принудительный tool_choice (any или конкретный инструмент), предварительное заполнение сообщения assistant (prefill), а также temperature / top_p / top_k.
Как исправить:
1. Шлюз: за каждым tool_use должен сразу следовать tool_result с тем же ID. При этом tool_result должен стоять в самом начале блоков содержимого сообщения user.
2. Шлюз: передавайте сообщение assistant из предыдущего хода без изменений, включая блоки с пустым полем thinking; содержимое developer добавьте в system.
3. Клиент: для tool_choice оставьте только auto или none, удалите prefill и параметры сэмплирования.
4. Клиент: если ошибка подписи уже появилась, начните новую сессию. Согласно официальному FAQ APIYI, такая ошибка иногда отображается как Request rejected (429), но это не ограничение частоты запросов, и повторные попытки с увеличением интервала не помогут.
5. Смените инструмент: если принудительный tool_choice жёстко задан в harness и вы не можете его изменить, используйте другой клиент.
Подробнее о диагностике похожих ошибок 400 — в статье Ошибка 400 tool use concurrency в Claude Code. В ней рассказано, как шаг за шагом искать причину сбоя при сопоставлении tool_use и tool_result.
Критерий проверки: последовательные вызовы инструментов в нескольких ходах — чтение файла, изменение файла и повторное чтение — больше не вызывают ошибку 400, а в рамках одной сессии не возникает ошибок подписи.
Категория 3: блоки размышлений Claude и бюджет выходных токенов не совпадают
Как выглядит ошибка: "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior. Также может появиться ошибка "thinking.type.disabled" is not supported for this model. Бывает и так, что ошибки нет, но ответ пустой или обрезан.
Почему это происходит: claude-opus-5-5 размышляет при каждом запросе, поэтому ответ может начинаться с блока thinking. Если клиент читает content[0].text по позиции, он получит пустое значение. Токены размышлений тарифицируются как выходные и тоже расходуют бюджет max_tokens. Начиная с этого поколения пояснения между вызовами инструментов также помещаются в блок thinking, а display по умолчанию установлен в omitted, поэтому ответ может выглядеть пустым.
Как исправить:
1. На стороне клиента: либо опустите параметр thinking, либо укажите thinking: {"type": "adaptive"} и удалите budget_tokens.
2. На стороне клиента: управляйте глубиной размышлений через output_config.effort. Доступные значения: low / medium / high / xhigh / max, по умолчанию — medium.
3. На стороне клиента: при чтении ответа ищите блок text по полю type, а не по позиции.
4. На стороне клиента: max_tokens должен покрывать и размышления, и основной текст. Чтобы видеть пояснения, установите thinking.display в summarized.
Чтобы разобраться в новом механизме, прочитайте руководство по Adaptive Thinking. В нём объясняется, как перейти с budget_tokens на уровни effort.
Критерий проверки: отправьте один и тот же промпт несколько раз подряд. Основной текст ответа каждый раз должен быть непустым, а ошибки, связанные с thinking.type, больше не должны появляться.
Таблица ошибок Claude: что проверить в первую очередь
| Ключевые слова из ошибки | Категория | Что проверить за 5 минут | Куда обратиться, если ошибка осталась |
|---|---|---|---|
wire_api = "chat" is no longer supported |
Категория 1 | Проверьте, не осталась ли настройка chat в config.toml | Руководство по Magpie |
tool_use ids were found without tool_result |
Категория 2 | Проверьте id и расположение tool_result | Ошибка 400 в Claude Code: параллельное использование инструментов |
must be followed by tool messages |
Категория 2 | Проверьте, проходит ли запрос через слой совместимости с Chat API | Ошибка 400 в Claude Code: параллельное использование инструментов |
Invalid signature in thinking block |
Категория 2 | Начните новый сеанс и попробуйте снова | Разбираемся в Adaptive Thinking |
thinking.type.enabled / пустой ответ |
Категория 3 | Удалите budget_tokens и считывайте данные по type | Разбираемся в Adaptive Thinking |
| Обычный диалог работает, но при вызове инструмента возникает ошибка | Категория 2 | Проверьте протокол подключения WorkBuddy | Поддерживает ли WorkBuddy вызовы в нативном формате Claude |
Два способа исправить ошибки при вызове Claude из Codex и WorkBuddy
| Вариант | Кому подходит | Приоритет протокола |
|---|---|---|
| A. Вернуться к нативному клиенту | Тем, кто просто хочет писать код с помощью Claude | Высший: без потерь при преобразовании |
| B. Добавить шлюз преобразования | Тем, кому необходимо остаться в Codex или WorkBuddy | Следующий: в качестве адреса поставщика укажите anthropic |
| Надолго остаться на совместимом chat | Не рекомендуется | Низший: возможны проблемы с вызовом инструментов и блоками thinking |
Вариант A: если вы хотите использовать Claude в Codex, перейдите на Claude Code. В официальных настройках моделей WorkBuddy есть только /chat/completions и переключатель «Пользовательский протокол», а нативного интерфейса Anthropic нет. Поэтому рассчитывать на нативный thinking в WorkBuddy не стоит. Подробнее — в статье Поддерживает ли WorkBuddy вызовы Claude в нативном формате: в ней объясняется, почему диалог работает, а вызов инструментов приводит к ошибке, и как это обойти.
Чтобы подключиться напрямую из WorkBuddy, откройте «Настройки → Модель → Пользовательская». В поле Base URL укажите https://api.apiyi.com/v1, в поле модели — claude-opus-5-5, а в поле Key — ключ, созданный на странице токенов APIYI apiyi.com. URL должен заканчиваться на /v1 — добавлять /chat/completions вручную не нужно.
Подпись: проверьте, что URL заканчивается на /v1, имя модели — claude-opus-5-5, а переключатель «Пользовательский протокол» выключен.
Вариант B: при добавлении шлюза для Codex оставьте настройку wire_api = "responses" без изменений. Шлюз преобразует запрос в формат Messages и отправит его дальше. В WorkBuddy укажите URL локального шлюза в настройках пользовательской модели, а в качестве адреса поставщика для моделей Claude задайте нативный эндпоинт Anthropic https://api.apiyi.com.
🎯 Техническая рекомендация: с одним ключом можно проверить оба эндпоинта — нативный Messages и совместимый chat. Сначала сравните работу вызовов инструментов в обоих протоколах, используя тестовый баланс на APIYI apiyi.com, а затем выберите подходящий вариант.
Подключаем Claude к Codex и WorkBuddy через Magpie
Magpie — открытый инструмент сообщества с лицензией MIT. Он запускает локальный шлюз на 127.0.0.1:3425 и конвертирует запросы между OpenAI Chat, Responses и Anthropic Messages, закрывая пробел для первого типа клиентов. Помимо ручной настройки, можно воспользоваться графическим интерфейсом Magpie: указать API-ключ и Base URL, а затем подключить Codex и WorkBuddy к одному шлюзу — без редактирования конфигурационных файлов. Подробные шаги описаны в руководстве по Magpie: там показано, как настроить единый шлюз для подключения моделей к нескольким агентам.
- Страница провайдеров: добавьте API-ключ. APIYI находится в группе «Прокси»; также можно нажать «+ Пользовательский провайдер» и ввести данные вручную.
- Страница агентов: выберите claude-opus-5-5 для Codex и WorkBuddy.
- Начните новую сессию, не используя историю старой.
Подпись: проверьте, что провайдер отображается как доступный в группе «Прокси», Base URL указывает на нативный адрес Anthropic, а оба переключателя на странице агентов включены.
Стоимость вызовов Claude и кэширования
Цены указаны в долларах за миллион токенов. Данные проверены 28.10.2026; актуальные модели и цены уточняйте в списке моделей платформы.
| Модель | Входные токены | Выходные токены | Чтение из кэша | Платформа |
|---|---|---|---|---|
| claude-opus-5-5 | $4 | $20 | $0.2 | APIYI apiyi.com |
| claude-sonnet-5-5 | $2 | $10 | $0.1 | APIYI apiyi.com |
| claude-haiku-5-5 | $0.1 | $0.5 | $0.01 | APIYI apiyi.com |
На каждом шаге агент повторно отправляет всю историю, а токены рассуждений claude-opus-5-5 оплачиваются по цене выходных токенов. Если слой преобразования изменит порядок system, tools или префикса, точка кэширования cache_control перестанет работать — и стоимость, и задержка вырастут. Если доля попаданий в кэш неожиданно снизилась, загляните в статью «Доля попаданий в кэш Claude упала до 0: диагностика». В ней рассказывается, как найти причину сбоя точки кэширования.
Риски и блокировка аккаунта
Шлюзы вроде Magpie — это инструменты с открытым исходным кодом, созданные сообществом, а не официальные компоненты APIYI. Мы не рекомендуем их и не предоставляем для них техническую поддержку. При пересылке запросов через такие инструменты целевой сервис может ограничить частоту запросов или даже заблокировать аккаунт. Пользователь самостоятельно несёт ответственность за последствия. Рекомендуем сначала проверить всю цепочку на тестовом аккаунте и только после этого использовать её с основным.
Когда не стоит возиться с настройкой
Если вы лишь изредка используете Claude в Codex, в компании запрещено устанавливать дополнительное ПО или вам вообще нужен только Claude, настраивать шлюз ни к чему. Гораздо проще сменить клиент на Claude Code или выбрать в Codex модель с нативной поддержкой Responses.
Частые вопросы FAQ
Q1: Codex официально поддерживает Claude?
Нет. Codex работает только через Responses, а Claude не предоставляет такой эндпоинт. Чтобы использовать Claude, нужен слой преобразования.
Q2: Можно ли использовать Claude на APIYI через /v1/responses?
Нет. Для моделей Claude на APIYI apiyi.com доступны только два типа эндпоинтов: anthropic и openai.
Q3: Ошибка 429 означает, что сработало ограничение частоты запросов?
Если в сообщении об ошибке есть `Invalid signature in thinking block`, дело не в ограничении частоты запросов: не прошла проверка подписи блока рассуждений. Просто начните новый сеанс.
Q4: WorkBuddy поддерживает нативный протокол Anthropic?
В официальной конфигурации нет возможности подключиться по нативному протоколу Anthropic. Можно использовать протокол, совместимый с OpenAI, или преобразовать запросы через шлюз.
Q5: Как быстро проверить, что всё заработало?
Начните новый сеанс, используя тестовый баланс APIYI apiyi.com, выполните несколько последовательных вызовов инструментов и убедитесь, что текст ответа не пустой.
Чек-лист для поиска ошибок Claude в Codex и WorkBuddy
- В конфигурации Codex больше нет упоминаний chat.
- Запросы к Claude идут по нативному протоколу или через шлюз, который переводит их в формат anthropic, а не через совместимость с chat.
- За каждым tool_use сразу следует tool_result с тем же id.
- Блок thinking из предыдущего хода передаётся обратно без изменений.
- Принудительный tool_choice, prefill и параметры сэмплирования не используются.
- Ответы считываются с учётом type, а в
max_tokensпредусмотрен запас для рассуждений.
Итоги
Ошибки Claude в Codex и WorkBuddy обычно связаны с одной из трёх причин: эндпоинтом, обменом данными с инструментами или блоками рассуждений. Исправлять их стоит по порядку: сначала изменить способ чтения ответов клиентом, затем исправить слой преобразования протоколов и только после этого рассматривать смену клиента или добавление шлюза.
По возможности используйте нативный протокол Anthropic. Если это невозможно, настройте шлюз для преобразования запросов в формат anthropic и не полагайтесь на совместимость с chat в долгосрочной перспективе. Чтобы сравнить работу разных протоколов с одним и тем же ключом, рекомендуем APIYI apiyi.com.
📚 Справочные материалы
- Справочник по настройке Codex: допустимые значения wire_api
- Ссылка:
developers.openai.com/codex/config-reference - Описание: подтверждает, что wire_api сейчас поддерживает только responses
- Пример ошибки загрузки конфигурации Codex
- Ссылка:
github.com/openai/codex/issues/41816 - Описание: источник оригинального текста ошибки wire_api
- Руководство по переходу на Claude Opus 5.5
- Ссылка:
platform.claude.com/docs/en/models/opus-5-5/migration-guide - Описание: обязательные ограничения для thinking, tool_choice и параметров сэмплирования
- Устранение проблем с вызовом инструментов Anthropic
- Ссылка:
platform.claude.com/docs/en/agents-and-tools/tool-use/troubleshooting-tool-use - Описание: правила сопоставления tool_use и tool_result
- Настройка моделей в WorkBuddy
- Ссылка:
www.workbuddy.ai/docs/zh/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model - Описание: где добавить пользовательскую модель и включить пользовательский протокол
- Репозиторий Magpie
- Ссылка:
github.com/yetone/magpie - Описание: шлюз с открытым исходным кодом, разработанный сообществом. Перед использованием самостоятельно оцените риски
Автор: техническая команда APIYI
Технические вопросы: свяжитесь с нами через главную страницу APIYI apiyi.com. Дополнительные материалы доступны в центре документации docs.apiyi.com
