Руководств по подключению CC Switch к Claude Code полно, а вот настройку Codex в CC Switch — через реселлера или напрямую — внятно объясняют редко. Codex и Claude Code используют разные протоколы, поэтому и настройка, и подводные камни у них разные. Если скопировать конфигурацию от Claude, чаще всего получите ошибки 400/404. Эта статья посвящена настройке Codex внутри CC Switch: объясним, почему протокол /v1/responses — ключ к прямому подключению, дадим полную пошаговую инструкцию, сравним подключение через реселлера с прямым и в конце сведём всё к одному baseUrl с помощью TeamoRouter.
Для начала: Codex и Claude Code используют разные протоколы
CC Switch умеет управлять несколькими агентами из одного места, но при пересылке запросов он должен использовать правильный формат протокола для каждого инструмента. Вот чем различаются протоколы трёх основных инструментов:
- Claude Code → использует Anthropic Messages API (
/v1/messages); - Codex → использует OpenAI Responses API (
/v1/responses); - Другие OpenAI-совместимые CLI → в основном используют Chat Completions (
/v1/chat/completions).
Многие копируют конфигурацию провайдера Claude прямо в Codex и получают несовпадение baseUrl и формата протокола — отсюда ошибки 400 (некорректный запрос) или 404 (путь не найден). Первое правило настройки Codex: выберите правильный протокол и правильный путь.
Главное: /v1/responses определяет, сможет ли Codex подключаться напрямую
Новые версии Codex по умолчанию используют Responses API (/v1/responses) — это основной эндпоинт для вызова инструментов и возможностей рассуждения. Поддерживает ли провайдер прямое подключение для Codex, зависит от того, есть ли у него нативная сквозная передача /v1/responses:
- Шлюзы с поддержкой
/v1/responses: Codex может направить на них свой baseUrl напрямую, с полной поддержкой вызова инструментов, стриминга и функций рассуждения — это и есть «прямое подключение». - Реселлеры, поддерживающие только
/v1/chat/completions: им нужен промежуточный слой конвертации протокола (responses → chat completions), из-за которого часть продвинутых функций может ломаться или вести себя непоследовательно, а стабильность страдает — это типичный компромисс подключения «через реселлера».
Поэтому, выбирая провайдера для Codex, убедитесь, что он нативно поддерживает протокол Responses. Без этого придётся либо откатываться на старый протокол, либо добавлять лишний слой конвертации — ни то ни другое не даст такого же опыта, как прямое подключение.
Пошагово: добавляем провайдера Codex в CC Switch
- Откройте CC Switch и через верхнюю панель навигации перейдите на страницу инструмента Codex (а не на страницу Claude Code).
- Перейдите в Provider Management → Add Provider.
- В качестве протокола выберите OpenAI Compatible / Responses Format (убедитесь, что используется
/v1/responses, а не формат Anthropic). - Заполните параметры:
- Name: например,
TeamoRouter-Codex - Base URL: адрес шлюза вашего провайдера (убедитесь, что он поддерживает
/v1/responses) - API Key: ваш уникальный API-ключ
- Name: например,
- Сохраните и дождитесь, пока пройдёт проверка работоспособности CC Switch.
- Вернитесь на страницу инструмента Codex и переключите Provider по умолчанию на только что добавленный.
- Полностью перезапустите Codex CLI (большинство CLI не перечитывают переменные окружения на лету), чтобы новая конфигурация вступила в силу.
Совет: если после настройки получаете 404, первым делом проверьте, не пропущен ли /v1 в baseUrl и не выбран ли случайно формат протокола Anthropic. Ошибка 400 обычно означает, что версия Codex не соответствует эндпоинту протокола, — обновите Codex до версии с поддержкой Responses.
Через реселлера или напрямую в CC Switch: в чём разница
| Аспект | Через реселлера (слой конвертации протокола) | Прямое подключение (нативный /v1/responses) |
|---|---|---|
| Путь протокола | Конвертация responses → chat completions | Нативная сквозная передача /v1/responses |
| Вызов инструментов / функции рассуждения | Могут ломаться или вести себя непоследовательно | Полностью сохраняются |
| Стабильность | Лишний слой конвертации, больше точек отказа | Путь короче, стабильнее |
| Сложность настройки | Нужно проверять совместимость конвертации | Достаточно указать baseUrl |
| Когда подходит | Когда вышестоящий провайдер поддерживает только старые протоколы | Вариант по умолчанию |
Вывод: при любой возможности используйте прямое подключение. Если ваш провайдер нативно поддерживает /v1/responses, достаточно вписать один baseUrl в CC Switch — и Codex раскроется в полную силу. Мириться с потерей функций и лишними точками отказа из-за слоя конвертации у реселлера незачем.
Подключаем Codex одним baseUrl от TeamoRouter
TeamoRouter — единый LLM-шлюз, изначально спроектированный для ИИ-агентов, — нативно поддерживает протокол Responses, который использует Codex, и позволяет подключаться напрямую:
- 100% совместимость с агентным протоколом: полная поддержка
/v1/responsesдля Codex, Tool Calling и различных Beta-функций — без конвертации с потерями. - Прямое подключение по одному baseUrl: просто впишите Base URL и API Key в CC Switch — или вовсе обойдитесь без CC Switch и задайте их для Codex напрямую через
export: на один локальный слой маршрутизации меньше — значит, на один класс проблем с конфликтами прокси и reconnecting меньше. - Доля попаданий в кэш >99%, без подмены моделей: никакой ротации пула аккаунтов. В сочетании с плавающей в реальном времени ставкой 10–20% от официальной цены Codex может гонять задачи всю ночь с предсказуемым счётом.
- Высокая доступность корпоративного уровня: SLA 99.98%, до 5000 QPM, время до первого токена близко к уровню прямого API.
Полную пошаговую инструкцию со скриншотами ищите в руководстве по установке CC Switch и настройке TeamoRouter. О том, как выбрать провайдера, который не экономит на качестве, читайте в статье Рекомендуемые API-реселлеры для CC Switch. Если донимают проблемы с reconnecting, загляните в полное руководство по устранению reconnecting.
Часто задаваемые вопросы
Какой формат протокола выбрать для Codex в CC Switch?
Выберите OpenAI Compatible / Responses Format и убедитесь, что используется /v1/responses. Не выберите по ошибке формат Anthropic, который нужен для Claude Code. Неверно выбранный протокол — самая частая причина ошибок 400/404 при подключении Codex.
Что лучше для Codex: реселлер или прямое подключение?
При любой возможности используйте прямое подключение. Оно нативно пропускает /v1/responses, сохраняя вызов инструментов и возможности рассуждения в полном объёме, а путь получается короче и стабильнее. Подключение через реселлера требует конвертации протокола, при которой могут теряться функции и появляются лишние точки отказа. Необходимое условие — ваш провайдер должен нативно поддерживать протокол Responses.
Может ли один baseUrl работать и с Claude Code, и с Codex?
Да — если шлюз поддерживает и протокол Anthropic, и OpenAI Responses. TeamoRouter поддерживает оба, поэтому в CC Switch можно с одними и теми же учётными данными настроить отдельных провайдеров для Claude Code и Codex, выбрав для каждого инструмента правильный формат протокола.