ChatGPT и Codex CLI: как подключить свой endpoint без ошибок
У Codex CLI есть важная особенность: свой адрес сервера через привычную переменную окружения он не берёт, зато требует аккуратной настройки в config.toml. В новой заметке разобрали, где чаще всего ломается подключение и что проверить, если вы хотите запускать Codex через свой endpoint.
Как Codex CLI подключается к своему серверу
Вместо простой подстановки URL Codex CLI использует секцию model_providers в config.toml. Там нужно указать модель, имя провайдера, base_url с окончанием /v1, имя переменной с ключом и протокол wire_api.
Если в конфиге не совпадает хотя бы один из этих пунктов, CLI может либо сразу не стартовать, либо тихо уйти на стандартный адрес api.openai.com. Для тех, кто настраивает корпоративный шлюз, прокси или собственный API-слой, это особенно важно: ошибка часто видна только по тексту ответа в терминале.
Какие ошибки встречаются чаще всего
В статье на версии 0.154 показали девять способов сломать конфиг. Например, wire_api = "chat" уже не подходит, а опечатка в значении даёт ошибку ещё до запуска. Если base_url задан без /v1, Codex может стучаться не туда и получать HTML вместо ответа API.
Ещё одна частая проблема — ключ не экспортирован в окружение, хотя записан в .env или лежит в другом терминале. Похожая история с supports_websockets: если прокси не поддерживает WebSocket, подключение начинается с неудачной попытки и только потом откатывается на HTTPS.
Что это даёт на практике
Для обычного пользователя это история про меньшее количество «магических» сбоев. Для разработчиков, маркетологов и команд, которые хотят гонять Codex через свой сервер, заметка полезна как короткий чек-лист: проверить /v1/responses, имя провайдера, экспорт переменной и то, как endpoint отвечает на WebSocket-запросы.
Отдельно автор обратил внимание на цену запроса: даже ответ из одного слова в Codex может тянуть за собой почти 15 тысяч входных токенов. Значит, в реальной работе важно не только выбрать модель, но и понять, читается ли кэш между ходами — это напрямую влияет на стоимость и скорость.