GPT-5.1 Codex: что это, как настроить и проверить модель

GPT-5.1-Codex — это вариант GPT-5.1, настроенный на агентную работу с кодом: разбором репозитория, планированием изменений, вызовом инструментов и проверкой результата. Это не отдельный тариф ChatGPT и не синоним обычной GPT-5.1. Название описывает модельный вариант и сценарий её применения, а не новый интерфейс.

Официальная карточка относит модель к доступу через Responses API; для неё заявлены streaming, function calling и structured outputs. В Codex или похожей среде модель может быть частью агентного цикла: среда передаёт задачу, модель возвращает действия или ответ, а затем получает результат выполнения этих действий. Карточка GPT-5.1-Codex

Чем GPT-5.1-Codex отличается от обычной GPT-5.1

Разница не в том, что одна модель «умеет программировать», а другая нет. Разница в оптимизации и ожидаемом режиме работы.

Обычная GPT-5.1 — более общее обозначение модели для задач разработки и других запросов. GPT-5.1-Codex ориентирована на агентный кодинг: ей важнее удерживать технический контекст, разбирать изменения по шагам и работать в связке с инструментами среды. Поэтому выбор Codex имеет смысл там, где модель не только объясняет фрагмент, но и участвует в цикле «задача → проверка проекта → действие → результат». Introducing GPT-5.1 for developers

При этом GPT-5.1-Codex не следует называть «текущей моделью ChatGPT». ChatGPT — это продуктовый интерфейс и набор доступных в нём функций, а GPT-5.1-Codex — идентификатор модельного варианта для поддерживаемого способа доступа. Подписка ChatGPT, доступ к API и доступ конкретного проекта к определённой модели — разные вещи.

Если параллельно нужно оплатить отдельный зарубежный цифровой сервис, можно посмотреть каталог Amber Market. Это отдельный маршрут оплаты заказа через СБП: наличие и условия проверяются в карточке услуги. Каталог не пополняет баланс OpenAI API, не выдаёт API-ключ и не включает GPT-5.1-Codex.

Минимальная проверка через Responses API

Сначала проверьте, что нужный идентификатор ещё доступен вашему проекту. На 20 сентября 2026 года alias gpt-5.1-codex помечен в официальной карточке и общем списке моделей как deprecated. Это означает: старое имя нельзя считать гарантированно рабочим и нельзя автоматически подменять его случайной «новой» моделью. Сначала получите актуальный список моделей и выберите ID, который действительно доступен проекту. All models

Сначала можно запросить список моделей проекта и убедиться, что выбранный ID в нём есть:

export OPENAI_API_KEY='ваш_ключ_из_переменной_окружения'

curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

В выводе найдите доступный id; если gpt-5.1-codex там отсутствует или отмечен как недоступный, не подставляйте его в тестовый запрос.

После этого можно выполнить illustrative-запрос. Он предназначен для запуска на стороне читателя и создаёт реальный API-запрос, поэтому ключ не нужно вставлять в текст команды, репозиторий, браузерный JavaScript или клиентское приложение.

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.1-codex",
    "input": "Кратко опиши, какие каталоги верхнего уровня стоит проверить в неизвестном репозитории перед изменением кода. Не выполняй команды."
  }'

Если alias уже заменён в вашем списке доступных моделей, измените только значение model. Остальная схема Responses API остаётся той же: переменная окружения хранит секрет, POST отправляется на /v1/responses, а модель указывается в JSON. GPT-5.1-Codex Model

Как понять результат проверки

Проверяйте не только наличие ответа в терминале. Для автоматической проверки нужны как минимум HTTP-код и JSON-поле output.

• Успешный запрос возвращает успешный HTTP-код и объект ответа с output. Это подтверждает, что данный model ID принял API-запрос в конкретном проекте.
• Ошибка 401 обычно указывает на проблему с ключом или его передачей. Проверьте переменную окружения и не выводите сам ключ в лог.
• Ошибка 403 говорит о правах или доступе проекта. Она не доказывает, что Codex как среда неисправен.
• Ошибка 429 относится к лимитам, квоте или частоте запросов. Повторить запрос можно после проверки лимитов, но это не исправляет недоступный model ID.
• Ответ с признаком deprecated для alias означает, что нужно вернуться к актуальному списку моделей и выбрать доступный идентификатор, а не бесконечно повторять тот же POST.

Для простого shell-предохранителя можно добавить проверку HTTP-кода:

http_code=$(curl -sS -o response.json -w '%{http_code}' \
  https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.1-codex","input":"Ответь одним предложением: зачем перед изменением кода читать структуру репозитория?"}')

test "$http_code" = "200" || {
  echo "API вернул HTTP $http_code"
  exit 1
}

jq -e '.output' response.json >/dev/null && echo "Есть поле output"

Эта проверка не заменяет проверку содержимого ответа и не доказывает доступность модели для любого другого аккаунта. Она отвечает на более узкий вопрос: принял ли ваш проект этот запрос и вернул ли ожидаемую структуру JSON.

Что делать при устаревшем alias

Сценарий такой:

1. Получите текущий список моделей, доступный вашему проекту.
2. Найдите в нём идентификатор, предназначенный для нужного сценария, и проверьте документацию именно к нему.
3. Подставьте этот ID в model.
4. Повторите небольшой тестовый запрос.
5. Только после успешной проверки подключайте модель к агентному циклу, function calling или потоковой выдаче.

Не стоит считать, что gpt-5.1-codex автоматически означает «последняя модель Codex». На 20 сентября 2026 года этот alias уже отмечен как deprecated, а статус моделей может меняться. Поэтому надёжная настройка — это не зафиксированная навсегда строка из старой статьи, а проверка доступного списка перед запуском.

Если нужен общий разбор HTTP-вызовов, заголовков и Responses API, пригодится инструкция по curl для OpenAI API. Общее объяснение различий моделей GPT-5.1 собрано в статье о GPT-5.1 для разработчиков.