Codex CLI использует Responses API OpenAI, а не /v1/chat/completions. Для интеграции с GetVibe требуется wire_api = "responses"; базовый URL для chat completions, скопированный из примера для универсального SDK, не является заменой. Сгенерированная конфигурация поддерживается в документации Codex CLI и может быть обновлена из /api/integrations/codex.toml.
Установите CLI и задайте ключ
Установите CLI и создайте каталог конфигурации. Храните API-ключ в окружении, а не внутри TOML-файла:
npm install -g @openai/codex
mkdir -p ~/.codex
export GETVIBE_API_KEY="your-dashboard-key"Добавьте этот блок провайдера в ~/.codex/config.toml:
model = "gpt-5.6-luna"
model_provider = "getvibe"
model_reasoning_effort = "medium"
model_reasoning_summary = "auto"
model_context_window = 786432
[model_providers.getvibe]
name = "GetVibe"
base_url = "https://getvibeapi.com/v1"
env_key = "GETVIBE_API_KEY"
wire_api = "responses"
request_max_retries = 4
stream_max_retries = 5
stream_idle_timeout_ms = 600000Не указывайте $GETVIBE_API_KEY в значении TOML. Codex считывает переменную, имя которой указано в env_key; текст внутри конфигурационного файла не разворачивается оболочкой. Для настройки, управляемой командой, задайте переменную окружения через профиль оболочки или менеджер секретов, из которого запускается Codex.
Выберите модель с поддержкой Responses
Сгенерированная конфигурация Codex создаётся на основе опубликованного каталога и рекомендует модель для программирования, а также профили для быстрых и сложных задач. Перед выбором другой модели убедитесь, что она указана для Responses API и имеет нужный вам лимит контекста. В версии каталога, проверенной 3 октября 2026 года, GPT-6 Luna стоит $0.0055 вход · $0.0274 выход за 1 млн токенов, GPT-6 Sol — $0.1096 вход · $0.548 выход за 1 млн токенов, а GPT-6.1 Sol — $0.1096 вход · $0.548 выход за 1 млн токенов за миллион входных и выходных токенов. Каждое значение отображается со страницы актуальной модели.
Профиль полезен, когда для разных классов задач требуются разные затраты и уровень рассуждений. Используйте быстрый профиль для сводок или сообщений коммитов, а более глубокий профиль — для изменений в нескольких файлах. Сгенерированная конфигурация проекта демонстрирует этот подход и обновляет рекомендуемые идентификаторы по мере изменения общедоступного каталога. Не изменяйте вручную размер окна контекста так, чтобы он превышал поддерживаемый лимит модели: в этом случае Codex может отправить слишком большой запрос, который завершится ошибкой на стороне вышестоящего сервиса.
Проверьте работу с задачей только для чтения
Запустите Codex в отдельной временной рабочей копии. Попросите его объяснить одну функцию без внесения изменений. Убедитесь, что используется провайдер GetVibe и что запрос выполняется успешно. Затем попросите внести небольшой патч, явно указав необходимость проверки разрешений. Если CLI сообщает об отсутствии провайдера, проверьте точное имя таблицы и соответствие model_provider этому имени. Если аутентификация завершается ошибкой, проверьте значение GETVIBE_API_KEY в той же оболочке, из которой запускается Codex.
Если в ответе говорится, что инструменты недоступны, сначала проверьте поддержку Responses выбранной моделью и версию CLI. Наличие идентификатора модели в общем каталоге не означает, что для неё доступны все протоколы. Сохраняйте точный идентификатор модели в журналах, чтобы отличать сбой инструмента от ошибки конечной точки или аутентификации.
Контролируйте контекст и затраты агента
Codex считывает файлы репозитория и отправляет результаты работы инструментов обратно как часть диалога. Исключите сгенерированные файлы и каталоги зависимостей с помощью настроек игнорирования, просите его проверять только релевантные пути и не повторяйте огромную спецификацию в каждом запросе. Стоимость задачи агента включает каждый обмен сообщениями, а не только финальный патч. После типичной задачи сравните использование в панели управления со ставками за входные и выходные данные на странице модели.
Для корректного сравнения моделей используйте один и тот же коммит репозитория, запрос, политику подтверждений и набор тестов. Возьмите исправление ошибки и задачу с изменениями в нескольких файлах, затем оцените успешность тестов и количество циклов исправлений. Тариф GPT-6 Luna в каталоге на 3 октября 2026 года указан как $0.0055 вход · $0.0274 выход за 1 млн токенов; фактическая стоимость запроса зависит от объёма использованных задачей контекста и вывода.
Профили и безопасные настройки по умолчанию
Начните с рассуждений medium для обычной задачи программирования, затем сравните low для повышения скорости и high для сложных рассуждений, если модель поддерживает эти настройки. Более интенсивные рассуждения могут увеличить объём вывода. Не устанавливайте большое глобальное окно контекста по привычке: сгенерированный файл выбирает взвешенный размер окна для конкретной модели. Оставляйте режим подтверждения действий Codex включённым, пока не поймёте, какие команды он предлагает.
Если CLI запускается успешно, но не связывается с GetVibe, проверьте фактически используемую конфигурацию, а не только изменённый вами файл: Codex может запускаться с другим профилем или из другого расположения конфигурации. Выполните безопасный запрос, проверьте использование в панели управления и только после этого применяйте его к важному репозиторию.
Используйте профили для повторяющихся классов задач
Профили Codex позволяют команде использовать одного провайдера, меняя модель и уровень рассуждений для конкретной задачи. Быстрый профиль может составить сводку diff или подготовить сообщение коммита; глубокий профиль может исследовать сбой в нескольких файлах. Указывайте имя профиля в команде, которую документирует команда, чтобы два разработчика не сравнивали разные настройки по умолчанию, сами того не зная. В профилях следует использовать идентификаторы моделей, которые опубликованы в данный момент и совместимы с Responses.
Сгенерированная конфигурация GetVibe содержит пример быстрых и глубоких профилей, но он может измениться вместе с рекомендациями. Обновляйте её из документированной конечной точки, а не копируйте старый лимит контекста модели. Codex может сворачивать историю в соответствии с настроенным размером окна контекста, поэтому окно, превышающее лимит маршрута, способно превратить длительные задачи в ошибки запросов вместо полезного контекста.
Сохраняйте контекст репозитория сфокусированным
Перед запуском агента убедитесь, что правила игнорирования исключают кэши пакетов, результаты сборки, сгенерированные API-клиенты и большие тестовые данные. Укажите Codex, какой пакет или тест следует проверить первым. При исправлении ошибки попросите его воспроизвести сбой, назвать файлы, которые он планирует изменить, затем внести минимальный патч и запустить тест. Это сокращает повторяющийся вывод инструментов и упрощает проверку результата.
Для корректного сравнения затрат запускайте один и тот же запрос на одном и том же коммите. Включите задачу, не требующую изменений, чтобы проверить, соблюдает ли агент границы, а также задачу, требующую запуска тестов, чтобы подсчитать циклы исправлений. Фиксируйте использование токенов и факт успешного прохождения патча, а не только длину финального ответа.
Рассуждения и бюджеты вывода
Используйте минимальный уровень рассуждений, соответствующий вашей цели по качеству. Высокий уровень полезен для некоторых задач планирования, но может увеличить задержку и объём вывода. Установите бюджет вывода, достаточный для запрошенного патча и объяснения, не оставляя его неограниченным. Если ответ завершается слишком рано, проверьте причину завершения, прежде чем повторять весь запрос: адресное продолжение может использовать меньше контекста.
Сохраняйте автоматические подтверждения команд консервативными. Codex может предложить деструктивную команду оболочки или изменить файлы за пределами предполагаемой области. Проверяйте diff и результаты тестов перед подтверждением, даже если сводка рассуждений звучит уверенно.
Распространённые ошибки
- Неправильная конечная точка: базовый URL должен заканчиваться на
/v1, аwire_apiдолжен иметь значениеresponses. - 401: экспортируйте
GETVIBE_API_KEYв окружение процесса; TOML не разворачивает переменные оболочки. - Ошибка контекста: сопоставьте
model_context_windowс опубликованной страницей выбранной модели. - Инструменты ведут себя иначе: протестируйте модель, совместимую с Responses, и используйте актуальную версию CLI.
Поля JSON-запросов описаны в разделе Сообщения и Responses; сведения о балансах и тарификации доступны в документации по использованию.