Codex (OpenAI)

Запускайте новые локальные задачи Codex через streaming Responses API OneProvider.

CLI и desktop-агент Codex для программирования

Что поддерживается

Поддерживаются streaming-ответы, function calls, локальные инструменты вроде apply_patch и учёт usage. Настройка действует на новые локальные задачи CLI, desktop и IDE, но не меняет Codex cloud chats.

Ограничение клиента

После смены провайдера перезапустите Codex и создайте новую локальную задачу: существующая задача сохраняет исходные модель и провайдера.

Настройка

1. Установите или проверьте Codex

   Если codex --version уже выводит версию, переходите дальше. Иначе установите актуальный CLI.

   npm install --global @openai/codex
   codex --version

2. Экспортируйте отдельный ключ

   Создайте отдельный ключ OneProvider и экспортируйте его в той же сессии терминала, из которой запускается Codex.

   export ONEPROVIDER_API_KEY="sk-your-key-here"

3. Добавьте custom provider

   Откройте ~/.codex/config.toml (desktop: Settings → Configuration → Open config.toml) и добавьте provider OneProvider.

   model_provider = "oneprovider"
   model = "gpt-6.1-sol"
   [model_providers.oneprovider]
   name = "OneProvider"
   base_url = "https://api.oneprovider.dev/v1"
   env_key = "ONEPROVIDER_API_KEY"
   wire_api = "responses"

4. Перезапустите и проверьте новую задачу

   В CLI выполните read-only probe. Desktop-приложение полностью закройте, откройте снова и создайте новую локальную задачу.

   codex

Проверка подключения

Подтвердите запрос в dashboard

Завершённый запрос должен показывать выбранную модель, /v1/responses, расход токенов и списание.

Параметры подключения

Протокол

responses

Endpoint

https://api.oneprovider.dev/v1

Безопасность ключа

Используйте отдельный ключ с ограниченным scope. На macOS desktop-приложение из Dock может не получить переменную терминала — используйте command-backed Keychain authentication Codex, а не записывайте секрет в config.toml.

Какую модель выбрать

Задайте model в том же config.toml, ниже model_provider. gpt-6.1-sol это топовый уровень для сложных агентных задач, gpt-5.6-terra сбалансированный вариант на каждый день, gpt-5.6-luna дешёвый уровень для больших объёмов и быстрых задач. Codex работает по Responses API, поэтому берите id GPT со страницы моделей ; ставки на странице тарифов .

Частые ошибки и решения

401 или «missing credentials»

Codex не видит ONEPROVIDER_API_KEY. Экспортируйте её в терминале, из которого запускается Codex. Desktop-приложение, открытое из Dock на macOS, её не наследует: используйте аутентификацию через Keychain.

404

base_url должен быть https://api.oneprovider.dev/v1 с /v1, а wire_api равен "responses".

Codex всё ещё использует старую модель или провайдера

Существующие задачи сохраняют провайдера, с которым начались. Перезапустите Codex и создайте новую локальную задачу.

«You've hit your usage limit» или Codex просит войти в ChatGPT

Это лимит подписки ChatGPT: запрос ушёл в ChatGPT, значит провайдер OneProvider не включён. Поставьте model_provider = "oneprovider" в самое начало config.toml, выше любой [таблицы] (без типографских кавычек), полностью закройте Codex и начните новую локальную задачу. Затем выйдите из ChatGPT командой codex logout (в desktop-приложении: в его настройках) и запустите codex в терминале, где экспортирована ONEPROVIDER_API_KEY: при включённом провайдере он работает только на ключе. Быстрая проверка: codex -c model_provider=oneprovider. wire_api принимает только "responses".

429 «Insufficient balance»

Баланс или лимит ключа исчерпан. Пополните; повтор не поможет.

Вопросы и ответы

Меняет ли это Codex cloud chats?

Нет, только новые локальные задачи CLI, desktop и IDE.

Нужен ли аккаунт OpenAI?

Нет, для локальных задач его заменяет ключ OneProvider.

Можно ли использовать Claude в Codex?

Codex использует Responses API с id GPT. Для Claude возьмите Claude Code .

Где проверить расход?

В разделе «Расход» кабинета: у каждого запроса видны модель, /v1/responses и списание.

Быстрые ответы

Какой base URL использовать?

Claude Code и Anthropic SDK работают с https://api.oneprovider.dev. OpenAI SDK и OpenAI-совместимые клиенты работают с https://api.oneprovider.dev/v1. За обоими адресами один ключ; список моделей: странице моделей , ставки на странице тарифов .

Как авторизоваться?

Передайте сырой ключ sk-… в заголовке x-api-key или Authorization: Bearer: один из двух, не оба. Храните ключ в переменной окружения, а не в файле, который попадает в репозиторий. Подробнее об аутентификации .

Где взять ключ?

Откройте кабинет в Telegram-боте @oneprovider_robot или на app.oneprovider.dev, пополните баланс и нажмите «Выпустить ключ». У каждого ключа может быть свой лимит расхода. Кабинет и ключи .

Что значат ошибки 401, 404 и 429?

401: ключ не задан, написан с ошибкой или передан не в том заголовке; вставьте ключ целиком, без кавычек и пробелов. 404: обычно неверный base URL, например лишний или двойной /v1. 429 с текстом «Insufficient balance»: баланс кабинета или лимит ключа исчерпан, пополните его вместо повторов; любой другой 429 это лимит частоты, подождите Retry-After. Разбор: коды ошибок и решение проблем .

Почему обрывается стрим или сбрасывается соединение?

VPN и VLESS-прокси часто буферизуют SSE или ломают согласование HTTP/2. У OneProvider нет региональных ограничений, и стримы на нашей стороне не буферизуются: отключите прокси и повторите запрос.

Куда писать, если не помогло?

Напишите в Telegram @Oneproviderhelpbot или откройте «Поддержку» в веб-кабинете: приложите код статуса и точный текст ошибки. Как работает поддержка .