Codex CLI: настройка пользовательского API и подключение через OfoxAI

Что такое Codex CLI

Codex CLI — инструмент командной строки для ИИ-кодирования от OpenAI. Он работает прямо в терминале: генерирует код, рефакторит существующий, выполняет задачи по описанию на естественном языке. Благодаря полной совместимости OfoxAI с протоколом OpenAI подключение происходит без каких-либо изменений в самом инструменте.

В этом руководстве — установка Codex CLI, настройка переменных окружения для работы через OfoxAI, выбор модели и практические примеры.

Установка

npm install -g @openai/codex

Убедитесь, что Node.js установлен на вашей системе. После установки команда codex станет доступна в терминале.

Настройка переменных окружения

Codex CLI использует протокол OpenAI. Для подключения к OfoxAI достаточно настроить две переменные окружения:

# Добавьте в ~/.zshrc (или ~/.bashrc)
export OPENAI_API_KEY=<Ваш OFOXAI_API_KEY>
export OPENAI_BASE_URL=https://api.ofox.ai/v1

После сохранения примените изменения:

source ~/.zshrc

Переменная OPENAI_BASE_URL перенаправляет все API-запросы Codex CLI на сервер OfoxAI вместо OpenAI. OPENAI_API_KEY должен содержать ваш ключ OfoxAI.

Проверка настройки

codex "Создай скрипт Hello World на Python"

Если ответ получен — настройка выполнена успешно. Codex CLI подключён к OfoxAI и готов к работе.

Указание модели

Модель можно указать через параметр командной строки --model:

# Модель Codex для повседневных задач
codex --model openai/gpt-5.4-mini-codex "Отрефактори эту функцию"

# Codex Max для сложных задач
codex --model openai/gpt-5.1-codex-max "Исправь этот баг"

Рекомендуемые модели

openai/gpt-5.4-mini-codex — быстрая и экономичная модель, подходящая для большинства задач: генерация кода, написание тестов, простой рефакторинг. Для сложных многофайловых изменений и архитектурных задач используйте openai/gpt-5.1-codex-max.

Практические сценарии

Генерация каркаса проекта

codex --model openai/gpt-5.4-mini-codex "Создай REST API на Express с маршрутами для CRUD операций"

Рефакторинг

codex --model openai/gpt-5.1-codex-max "Перепиши этот класс с использованием паттерна Strategy"

Написание тестов

codex --model openai/gpt-5.4-mini-codex "Напиши юнит-тесты для всех функций в utils.ts"

Исправление ошибок

codex --model openai/gpt-5.1-codex-max "Исправь ошибку TypeError в файле parser.js"

Codex CLI в связке с другими инструментами

Codex CLI отлично дополняет IDE-инструменты вроде Cursor или Cline. Типичный сценарий: Codex CLI для генерации каркаса проекта и пакетных операций в терминале, IDE-инструмент для точечного редактирования в редакторе. Если все инструменты подключены через один провайдер OfoxAI, достаточно одного API-ключа.

Важное замечание

Конкретные параметры конфигурации Codex CLI могут меняться с обновлениями версий. Если что-то не работает — проверьте официальную документацию Codex CLI на GitHub.

Решение типичных проблем

Ошибка подключения

Убедитесь, что переменные окружения загружены. Выполните в терминале:

echo $OPENAI_BASE_URL
echo $OPENAI_API_KEY

Если пустые — повторите source ~/.zshrc.

Ошибка 401 Unauthorized

API Key недействителен. Проверьте, что это ключ OfoxAI, а не OpenAI, и что ключ активен.

Неизвестная модель

Убедитесь, что ID модели указан с префиксом провайдера: openai/gpt-5.4-mini-codex, а не просто gpt-5.4-mini-codex.

Итог

Codex CLI — терминальный AI-инструмент от OpenAI, который через OfoxAI подключается за две переменные окружения: OPENAI_API_KEY и OPENAI_BASE_URL=https://api.ofox.ai/v1. Для повседневных задач используйте openai/gpt-5.4-mini-codex, для сложных — openai/gpt-5.1-codex-max.

Подробнее — в документации по интеграции Codex CLI. API Key можно создать на ofox.ai.