Руководство по настройке · на 2026-11-04

Codex CLI со сторонним API: руководство по настройке

По состоянию на 20 ноября 2026 года Codex CLI rust-v0.171.0 (опубликован 2026-11-20) добавил GPT-6.2 Sol и Astra в каталоги моделей, где Sol выбран по умолчанию в каталоге; чтобы закрепить модель на кастомном провайдере, явно укажите model = "gpt-6.2-sol" в ~/.codex/config.toml или используйте codex --model gpt-6.2-sol для разового запуска. Codex-ретранслятор означает направление Codex CLI на эндпоинт, обслуживающий протокол OpenAI Responses, с оплатой за токены ключом, начинающимся с cr_ – это отдельная система, не связанная с подпиской ChatGPT. По состоянию на 2026-11-04 документация QCode задаёт base_url для Codex как https://api.qcode.cc/openai. По состоянию на 2026-10-07 подключить Codex CLI к стороннему или кастомному эндпоинту можно, добавив собственную таблицу в разделе model_providers файла ~/.codex/config.toml с base_url, wire_api и env_key (имя переменной окружения, в которой хранится ключ), и указав её в верхнеуровневом model_provider; официальный справочник конфигурации говорит, что responses — единственное поддерживаемое значение wire_api. Для QCode base_url — https://api.qcode.cc/openai; документация QCode задаёт requires_openai_auth = true в этой таблице и помещает ключ в ~/.codex/auth.json, а чтобы передавать ключ через переменную окружения, вы заменяете эту строку на env_key – используйте что-то одно. Эта страница последовательно разбирает каждый ключ, типичные ошибки и то, какие модели выбирать.

Обновлено 2026-11-20

Подключите этот инструмент к эндпоинту QCode — один ключ для Claude, GPT и китайских моделей.

#config.toml#model_providers#base_url#gpt-6.1-sol

Четыре значения, которые важно не перепутать

responses

Единственное значение wire_api

Официальный справочник пишет, что responses — единственное поддерживаемое значение, и оно же действует по умолчанию, если поле не указано. В документации QCode wire_api тоже равен responses, что соответствует пути /openai/v1/responses.

env_key

переменная окружения с ключом

В env_key пишут имя переменной окружения, а не сам ключ; официальная формулировка — переменная окружения, через которую передаётся API-ключ провайдера. Ключи QCode начинаются с cr_. Имя переменной можно выбрать самому; в примере из документации QCode используется QCODE_API_KEY.

/openai

Чем заканчивается base_url у QCode

В документации QCode сказано, что base_url для Codex должен быть именно https://api.qcode.cc/openai; Codex работает по протоколу Responses, поэтому запросы идут на /openai/v1/responses.

По состоянию на 20 ноября 2026 года последняя запись в официальных GitHub releases OpenAI — Codex CLI rust-v0.171.0 (опубликован 2026-11-20). До этого, по состоянию на 2026-11-04, последней была Codex CLI 0.166.0 (2026-10-29); ещё раньше последней была 0.160.1 от 2026-10-05, а начиная с 0.159.1 (2026-09-29) встроенный каталог моделей использовал GPT-6.1 Sol как модель по умолчанию.

Последняя версия CLI в официальных релизах

На 2026-11-04 в официальных релизах OpenAI на GitHub последняя версия — Codex CLI 0.166.0 (вышла 2026-10-29). До неё последней была 0.160.1 от 2026-10-05; начиная с 0.159.1 (2026-09-29) встроенный каталог моделей использует GPT-6.1 Sol как модель по умолчанию.

Как Codex выбирает эндпоинт

По состоянию на 2026-10-07 Codex CLI решает, куда отправлять запросы, по ключу model_provider в config.toml: его значение — id таблицы в разделе model_providers, а если ключ не задан, используется openai. В официальной документации сказано, что провайдер модели определяет, как Codex подключается к модели: базовый URL, wire API, аутентификация и необязательные HTTP-заголовки; собственные провайдеры не могут занимать зарезервированные встроенные id openai, ollama и lmstudio.

Пользовательская конфигурация лежит в ~/.codex/config.toml (в Windows — в %USERPROFILE%\.codex\); файл .codex/config.toml внутри проекта загружается только после того, как вы доверите проекту, а model_provider и model_providers на этом уровне игнорируются. В документации QCode провайдер называется qcode и работает по протоколу OpenAI Responses; один и тот же ключ подходит для api.qcode.cc, us.qcode.cc и asia.qcode.cc.

Свежие релизы, затрагивающие провайдеров

По состоянию на 20 ноября 2026 года: Codex CLI rust-v0.171.0 вышла 2026-11-20, добавив GPT-6.2 Sol и Astra в каталоги моделей, где Sol выбран по умолчанию в каталоге; в официальном API OpenAI тариф Standard для gpt-6.2-sol составляет $2.00 за вход, $10.00 за выход и $0.10 за кэшированный вход — столько же, сколько тариф Standard для gpt-6.1-sol.

Изменения в более ранних релизах: официальный changelog показывает, что с 2026-09-22 GPT-6 Sol и GPT-6 Luna начали распространяться на Codex и выбираются в CLI через /model или codex --model gpt-6-sol; 2026-09-29 Codex CLI 0.159.1 сделала GPT-6.1 Sol моделью по умолчанию во встроенном каталоге; 0.160.0 от 2026-10-01 уточнила, как env_key определяет переменную окружения с API-ключом, перестала добавлять неподдерживаемые встроенные модели в явно заданные каталоги моделей провайдера и заставила терминальный интерфейс сохранять настройки провайдера сервера; 0.160.1 вышла 2026-10-05, затем 0.164.0 — 2026-10-23 и 0.166.0 — 2026-10-29; по состоянию на 2026-11-04 0.166.0 является последней в официальных GitHub releases.

Отдельно официальное уведомление от 2026-09-14 указывает 2026-10-14 как дату вывода GPT-5.5 из ChatGPT, ChatGPT Work и Codex (вывод не распространяется на OpenAI API) и просит обновить сохранённые настройки моделей, кастомных агентов и скриптов, которые всё ещё выбирают gpt-5.5. Проверьте локальную версию командой codex --version.

Хронология

2026-09-22

GPT-6 Sol и GPT-6 Luna начинают постепенно появляться в Codex; OpenAI советует Sol для сложного программирования и агентных сценариев, а в CLI модель переключают через /model или codex --model gpt-6-sol.

2026-09-29

GPT-6.1 Sol появляется в Codex; в тот же день Codex CLI 0.159.1 делает её моделью по умолчанию во встроенном каталоге. В документации QCode gpt-6.1-sol указана как обновлённая GPT-6 Sol.

2026-10-05

Выходит Codex CLI 0.160.1 — самая новая версия CLI в официальном журнале на момент проверки 2026-10-07; перед ней, 2026-10-01, версия 0.160.0 уточнила описание env_key. Затем вышли 0.164.0 (2026-10-23) и 0.166.0 (2026-10-29); на 2026-11-04 последняя — 0.166.0.

Подтверждено vs не проверено

Подтверждено (дословно по официальным страницам и документации QCode)

Официальная документация Codex: model_provider по умолчанию — openai; openai, ollama и lmstudio — зарезервированные id, переопределить их нельзя; единственное поддерживаемое значение wire_api — responses, оно же по умолчанию; env_key — переменная окружения с API-ключом; requires_openai_auth по умолчанию false; прямой токен в experimental_bearer_token не рекомендуется; model и model_provider должны стоять до первой TOML-таблицы.

Официальный журнал: с 0.159.1 GPT-6.1 Sol — модель по умолчанию во встроенном каталоге, 0.160.1 вышла 2026-10-05. Документация QCode: base_url — https://api.qcode.cc/openai, wire_api — responses, requires_openai_auth — true, ключ начинается с cr_ и записывается в OPENAI_API_KEY в ~/.codex/auth.json; в варианте с переменной окружения requires_openai_auth = true заменяется на env_key = "QCODE_API_KEY", и использовать можно только один из двух вариантов.

Не проверено или не описано в документации

Четыре пункта не проверены, не стройте на них расчёты: во-первых, в официальном справочнике, загруженном для этой страницы 2026-10-07, параметра preferred_auth_method нет, в текущем примере QCode этой строки тоже больше нет, и что он делает в текущих версиях, если остался в старой конфигурации, не проверено; во-вторых, в официальном справочнике есть также таблица auth с получением токена через команду, http_headers, supports_websockets и другое, документация QCode их не описывает, и эта страница не обещает, что они работают с QCode; в-третьих, не проверено, знают ли версии Codex до 0.159.1 имя gpt-6.1-sol, а официальный документ о шлюзах лишь советует без собственного каталога моделей сначала убедиться, что ваша версия Codex распознаёт модель; в-четвёртых, OpenAI заявляет, что GPT-6.1 Sol даёт производительность, близкую к Astra, при меньшей стоимости, чем у Astra, — это заявление самого вендора без сторонних измерений.

Два выбора и как их сделать

Свой провайдер или openai_base_url

Официальная документация даёт два пути: если нужно лишь направить встроенный провайдер openai на прокси или маршрутизатор, достаточно задать openai_base_url, не создавая нового провайдера; если нужны своя переменная для ключа и свои настройки протокола, добавьте таблицу в model_providers. Таблицу с именем openai создать нельзя: встроенные id не переопределяются. Документация QCode использует второй путь (провайдер qcode) и не описывает подключение через openai_base_url, поэтому эта страница не рекомендует его для QCode.

auth.json или переменная окружения

Документация QCode предлагает выбрать один из двух вариантов: либо задать в таблице провайдера requires_openai_auth = true и записать OPENAI_API_KEY в ~/.codex/auth.json (основной вариант документации), либо заменить requires_openai_auth = true на env_key = "QCODE_API_KEY" и экспортировать QCODE_API_KEY. По официальной документации при requires_openai_auth = true Codex игнорирует env_key, так что если указать и то и другое, переменная окружения не сработает.

OpenAI советует не хранить учётные данные в TOML-файлах и репозиториях и предупреждает, что переменная, заданная в терминале, может быть недоступна приложению, запущенному с рабочего стола.

Пять шагов для подключения QCode

По состоянию на 20 ноября 2026 года модель по умолчанию во встроенном каталоге — GPT-6.2 Sol, поэтому, если нужна фиксированная модель, закрепите её в конфиге. По документации QCode

  1. 1создайте папку конфигурации ~/.codex (в Windows — %USERPROFILE%\.codex)
  2. 2разместите верхнеуровневые ключи в начале config.toml: model_provider со значением qcode, model с явным указанием gpt-6.2-sol (значение по умолчанию каталога rust-v0.171.0 по состоянию на 2026-11-20), gpt-6.1-sol или gpt-6-sol и при желании model_reasoning_effort; для разового запуска используйте codex --model gpt-6.2-sol; они должны идти до первого заголовка таблицы, иначе будут прочитаны как часть этой таблицы
  3. 3добавьте таблицу model_providers.qcode с name qcode, base_url https://api.qcode.cc/openai, wire_api responses, requires_openai_auth true (из Северной Америки и Европы можно заменить хост на us.qcode.cc)
  4. 4укажите ключ: поместите свой ключ cr_ как OPENAI_API_KEY в ~/.codex/auth.json; чтобы вместо этого передавать ключ через переменную окружения, замените requires_openai_auth = true в таблице на env_key = "QCODE_API_KEY" и выполните export QCODE_API_KEY. Используйте что-то одно: официальная документация утверждает, что Codex игнорирует env_key, когда requires_openai_auth = true
  5. 5запустите codex и выполните /status, чтобы убедиться в активной модели и провайдере, либо запустите codex doctor для проверки конфигурации.

Codex на QCode

Скопируйте в консоли QCode ключ, начинающийся с cr_, и выполните пять шагов выше; либо воспользуйтесь скриптом настройки в один шаг из документации QCode: он установит CLI, запишет конфигурацию в ~/.codex и проверит соединение. Codex работает по протоколу OpenAI Responses, поэтому через него в QCode работают модели семейства GPT: gpt-6.2-sol, gpt-6.2-astra, gpt-6.2-sol, gpt-6.2-astra, gpt-6.2-sol, gpt-6.2-astra, gpt-6.1-sol, gpt-6.1-terra, gpt-6-sol, gpt-6-astra и gpt-5.6-terra (таблица моделей на странице Codex в документации QCode, 2026-11-04), а также gpt-5.6-sol, которая по-прежнему есть в /models, можно вызывать, а переключение — только сменой model (gpt-6-luna и gpt-5.6-luna QCode пока не поддерживает, поэтому используйте одну из этих моделей GPT); Claude и модели GLM, Kimi, DeepSeek, Qwen этим протоколом не обслуживаются.

Тот же ключ подходит и для Claude Code. Оплата за токены, цены по моделям — на /models. На 2026-11-04 страница пополнения принимает Alipay, WeChat Pay, банковские карты и криптовалюту. Alipay, WeChat Pay, карты, Apple Pay и Google Pay обычно зачисляются в течение минуты; СБП и российские карты — в течение нескольких минут; криптовалюта проверяется вручную и зачисляется в течение одного дня.

Не хотите месячный тариф? «Разовые пакеты» начинаются с $4: разовый объём, который нужно израсходовать за 7 дней. Если у вас уже есть личный тариф и квоты не хватает, докупите бустер-пакет. Как выбирать сервис подключения — на /how-to-choose-ai-api-relay.

Частые вопросы

Что изменить, чтобы подключить Codex CLI к стороннему API?

Две вещи в ~/.codex/config.toml: верхнеуровневый model_provider должен указывать на id вашего провайдера, а для этого id нужна таблица в model_providers с base_url, wire_api и env_key. Официальный справочник пишет, что единственное поддерживаемое значение wire_api — responses, а env_key — имя переменной окружения с API-ключом; requires_openai_auth означает, что провайдер использует аутентификацию OpenAI, по умолчанию это false; при true Codex игнорирует env_key, поэтому нужен только один из двух вариантов. Основной вариант в документации QCode — requires_openai_auth = true и ключ в ~/.codex/auth.json, а env_key ставится вместо него только в варианте с переменной окружения.

Что писать в base_url? Добавлять /v1?

Для QCode — https://api.qcode.cc/openai, без /v1 и без завершающего слеша. В документации QCode сказано, что base_url для Codex должен быть именно таким, а Codex обращается к пути /openai/v1/responses. Общее правило из документации по эндпоинтам: без завершающего слеша, иначе получится путь с двойным слешем и ответ 404; 404 обычно означает неверный префикс пути. Резервный адрес для Азии — https://asia.qcode.cc/openai, для Северной Америки и Европы есть us.qcode.cc.

Что делать при 401 или API key not found?

Проверьте три вещи: начинается ли ключ с cr_ и нет ли в ключе в auth.json лишних пробелов или переносов строки; в варианте с переменной окружения — совпадает ли её имя со значением env_key в config.toml (в документации QCode — QCODE_API_KEY), не осталось ли в таблице requires_openai_auth = true (с ним Codex игнорирует env_key) и задана ли переменная в текущей оболочке; наконец, состояние ключа в консоли QCode.

Я поправил config.toml — почему провайдер не применился?

Чаще всего верхнеуровневый ключ стоит не на месте: официальная документация требует, чтобы model и model_provider шли до первой TOML-таблицы, потому что ключи после заголовка таблицы относятся к ней. Далее, .codex/config.toml в проекте игнорирует model_provider и model_providers, так что провайдер нужно описывать в пользовательском ~/.codex/config.toml, и называть таблицу openai нельзя. Кроме того, по документации QCode, начиная с Codex 0.134.0 старые таблицы profiles в config.toml упразднены, и запуск с --profile при оставленных старых таблицах завершается ошибкой. После запуска команда /status покажет активные model и provider.

Можно ли одним ключом пользоваться и в Codex, и в Claude Code?

Да. По документации QCode, перепроверенной 2026-11-04, Claude Code и Codex используют один и тот же ключ QCode, и для смены модели ничего дополнительно подключать не нужно. Но отправить модель Claude в Codex нельзя. По документации QCode, Codex работает по протоколу OpenAI Responses, который обслуживает только семейство GPT, а не Claude и не модели GLM, Kimi, DeepSeek, Qwen; модели Claude работают только по протоколу Anthropic. Пример из документации: если отправить модель Claude на /openai/v1/chat/completions, вернётся model_not_available_on_endpoint, а эта проверка выполняется до аутентификации, так что ошибка означает неверный протокол, а не плохой ключ. Для Claude используйте Claude Code с тем же ключом.

Чем подключение Codex через сторонний API отличается от подключения Claude Code?

По состоянию на 20 ноября 2026 года модель по умолчанию в каталоге — GPT-6.2 Sol (rust-v0.171.0), и gpt-6.2-sol имеет тот же тариф Standard официального API OpenAI, что и gpt-6.1-sol. Разница — в протоколе и моделях, которые он обслуживает: Codex использует протокол OpenAI Responses и только семейство GPT, а Claude Code использует протокол Anthropic и модели Claude. Остальное без изменений. По состоянию на 2026-10-07 документация QCode рекомендует по умолчанию gpt-6-sol (контекст 1.05M, общие и сложные задачи); gpt-6.1-sol — это обновление GPT-6 Sol от 2026-09-29, тоже с контекстом 1.05M и, согласно документации, с более низкой ценой чтения из кэша, и с 0.159.1 он является моделью по умолчанию встроенного каталога официального Codex; gpt-5.6-sol относится к флагманской линейке GPT-5.6, gpt-5.6-terra настроена под код, gpt-6-astra — верхний уровень по высокой цене, а gpt-6-luna OpenAI позиционирует для сфокусированных задач с большим объёмом. Все они, кроме gpt-6-luna, доступны на QCode; переключение выполняется изменением model или через codex --model. QCode сейчас не поддерживает gpt-6-luna и gpt-5.6-luna (на QCode не поддерживается); используйте другую модель GPT, например gpt-6.1-sol, gpt-6-sol или gpt-5.6-terra. При повторной проверке 2026-11-04 строка model на странице Codex в docs рекомендует gpt-6.1-sol как модель по умолчанию. По состоянию на 2026-11-04 таблица моделей на странице Codex в документации QCode перечисляет gpt-6.1-sol, gpt-6.1-terra, gpt-6-sol, gpt-6-astra и gpt-5.6-terra; gpt-6.1-terra — средний уровень GPT-6.1 для повседневного кодинга и пакетных задач. gpt-5.6-sol в этой таблице отсутствует, но по-прежнему указан на /models.

Источники

Проверено 2026-11-20: официальный релиз Codex CLI rust-v0.171.0 (github.com/openai/codex/releases/tag/rust-v0.171.0, опубликован 2026-11-20), официальная страница моделей Codex от OpenAI (developers.openai.com/codex/models, с формами codex --model gpt-6.2-sol и model = "gpt-6.2-sol") и официальная страница цен API OpenAI (уровень Standard, где у gpt-6.2-sol тот же тариф, что у gpt-6.1-sol). Ключи конфигурации Codex: официальный справочник конфигурации Codex и документация по расширенной настройке от OpenAI (learn.chatgpt.com, проверено 2026-10-07), охватывающие значение по умолчанию model_provider, зарезервированные id, значение wire_api, env_key и requires_openai_auth, openai_base_url и ключи, игнорируемые на уровне проекта. Размещение верхнеуровневых ключей, хранение учётных данных и проверка через /status: официальный документ Connect to a gateway, проверенный в тот же день. Версии и модели: официальный changelog ChatGPT и Codex, проверенный в тот же день (0.159.1, 0.160.0, 0.160.1, анонсы GPT-6 Sol и GPT-6.1 Sol и уведомление о выводе GPT-5.5). Настройка QCode, base_url, имя env_key, префикс ключа и список моделей: полное руководство по Codex, быстрый старт Codex и страницы эндпоинтов и форматов API на docs.qcode.cc, проверено 2026-10-07. Повторно проверено 2026-11-04 по четырём страницам на docs.qcode.cc: полное руководство по Codex, эндпоинты и пути API, способы оплаты и сравнение подписок и API-ключей.

Codex на одном ключе

Укажите base_url https://api.qcode.cc/openai и выберите gpt-6.1-sol, gpt-6-sol или gpt-5.6-sol: оплата за токены, запуск сразу после регистрации.

Читайте также

Оплата криптовалютой

Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.

Параметры конфигурации и сведения о версиях на этой странице сверены 2026-10-07 с официальной документацией и журналом изменений Codex от OpenAI и с документацией QCode; ориентируйтесь на официальные страницы, изменения у вендора возможны без предупреждения. Совместимость сверх описанной в документации эта страница не обещает; доступность моделей — по /models.

Не знаете, с чего начать?

Попробовать неделю

Пакет «Малый» — $4: квота $30 на 7 дней

Работаете каждый день

«Стартовый» — $9.00 в месяц и $5 квоты каждый день: всего $0.060 за $1 квоты, у пакета «Средний» — около $0.113