📌 О Codex CLI Codex CLI — это официальный терминальный агент кодирования OpenAI, написанный на Rust, способный локально читать, изменять и запускать код (открытый исходный код). По умолчанию подключается к OpenAI, но поддерживает пользовательский model_provider, поэтому может бесшовно подключаться к шлюзу LLMoxy и использовать GPT-5.4 и другие модели.

Шаги установки

1. Установить Node.js

Посетите официальный сайт Node.js. Рекомендуется скачать версию LTS слева, это версия с долгосрочной поддержкой, более стабильная.

2. Установить Codex CLI

Откройте командную строку и установите глобально через npm:

npm install -g @openai/codex

Пользователи macOS также могут использовать Homebrew:

brew install codex

Проверить установку:

codex --version

Codex CLI поддерживает macOS, Linux и Windows. Пользователям Windows рекомендуется запускать нативно в PowerShell или использовать WSL2 для нативной среды Linux.

Шаги настройки

Файл конфигурации Codex CLI находится в ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml). Подключение к LLMoxy требует только двух шагов: зарегистрировать пользовательского провайдера + предоставить ключ API.

1. Получить ключ API

Перейдите в Консоль LLMoxy → Управление ключами API → Скопируйте секретный ключ.

Примечание: Пожалуйста, используйте токен из группы auto.

2. Записать config.toml

Добавьте следующее в ~/.codex/config.toml (создайте, если не существует):

# По умолчанию используется провайдер и модель LLMoxy
model = "gpt-5.4"
model_provider = "llmoxy"

[model_providers.llmoxy]
name = "LLMoxy"
base_url = "https://llmoxy.com/v1"
wire_api = "responses"
env_key = "LLMOXY_API_KEY"

Пояснения элементов конфигурации:

model — Название модели по умолчанию, заполните модель, поддерживаемую LLMoxy (например, gpt-5.4, gpt-5.3-codex)
model_provider — Указывает на ID провайдера, определенный ниже
base_url — Адрес шлюза LLMoxy, с /v1
wire_api — Протокол интерфейса. LLMoxy поддерживает как /v1/responses (API Responses, нативный режим Codex, рекомендуется), так и /v1/chat/completions (Chat Completions). Предпочтительно responses; при проблемах совместимости измените на chat
env_key — Имя переменной среды для хранения ключа API, устанавливается на следующем шаге

ПОДСКАЗКА В отличие от Claude Code, base_url Codex CLI должен включать /v1.

3. Установить переменную среды ключа API

Переменная среды, указанная env_key, должна быть установлена с реальным ключом в системе.

Windows (PowerShell, постоянно):

[Environment]::SetEnvironmentVariable("LLMOXY_API_KEY","Ваш ключ API LLMoxy","User")

После установки закройте PowerShell и откройте новое окно, чтобы оно загрузилось.

macOS / Linux:

{
echo ''
echo '# LLMoxy'
echo 'export LLMOXY_API_KEY="Ваш ключ API LLMoxy"'
} >> ~/.zshrc   # Пользователи Bash меняют на ~/.bashrc
source ~/.zshrc

Проверить:

echo "$LLMOXY_API_KEY"

Вы должны заменить Ваш ключ API LLMoxy на реальный ключ, скопированный из Консоли LLMoxy.

4. Запуск

Войдите в каталог вашего проекта и запустите интерактивную сессию:

codex

Если вы можете нормально общаться и выполнять задачи, значит вы успешно подключились к LLMoxy.

Общие операции

Переключение модели и интенсивности рассуждения

Введите /model в сессии для переключения моделей или настройки интенсивности рассуждения. Вы также можете указать при запуске через -m:

codex -m gpt-5.3-codex

Режимы одобрения

Codex запрашивает подтверждение перед редактированием файлов или выполнением команд. Вы можете переключаться в сессии с помощью /approvals, или указать при запуске:

codex --ask-for-approval      # Подтверждать каждый шаг (по умолчанию, самый безопасный)
codex --full-auto             # Автоматическое выполнение, только в рабочем каталоге в песочнице с ограниченным сетевым доступом

💡 Подсказка При первом запуске в каталоге проекта Codex спросит, доверяете ли вы этому каталогу.

Скриптовый запуск (неинтерактивный)

Используйте подкоманду exec для передачи разовых задач Codex, подходящей для вызова в скриптах или CI:

codex exec "Добавить модульные тесты для ParseConfig в main.go"

Ввод изображений

Вы можете прикрепить скриншоты или макеты дизайна, чтобы Codex понимал требования в сочетании с изображениями:

codex -i screenshot.png "Реализуйте страницу входа согласно этому макету"

Веб-поиск

Включите веб-поиск для получения последней информации:

codex --search

Подключение инструментов MCP

Зарегистрируйте сервисы MCP в config.toml через [mcp_servers.*], чтобы предоставить сторонние инструменты и контекст для Codex. Эта конфигурация может сосуществовать с конфигурацией провайдера LLMoxy:

[mcp_servers.chrome-devtools]
command = "npx"
args = ["chrome-devtools-mcp@latest"]

Распространенные проблемы

Ошибка прав `npm install -g`

Не используйте sudo npm install -g. Рекомендуется использовать nvm для управления Node.js, или изменить глобальный каталог npm:

npm config set prefix ~/.npm-global

Затем добавьте ~/.npm-global/bin в PATH. Пользователи macOS также могут установить Node.js через Homebrew (sudo не требуется).

После запуска все еще требуется вход в аккаунт OpenAI

Убедитесь, что model_provider = "llmoxy" активен в config.toml, и переменная среды LLMOXY_API_KEY установлена. После настройки пользовательского провайдера Codex использует аутентификацию по ключу API и не требует входа в ChatGPT.

Ошибка 404 / модель не существует

Убедитесь, что base_url включает /v1: https://llmoxy.com/v1
Убедитесь, что model заполнено названием модели, поддерживаемой LLMoxy
Если wire_api = "responses" выдает ошибку, попробуйте изменить на chat

Переменные среды не активны

Windows: SetEnvironmentVariable(...,"User") требует переоткрытия терминала
macOS / Linux: выполните source ~/.zshrc (или ~/.bashrc), или переоткройте терминал, затем проверьте с помощью echo "$LLMOXY_API_KEY"

Сбой вызова API / проблема с балансом

Проверьте, что ключ API не содержит лишних пробелов
Перейдите в Консоль LLMoxy для проверки баланса счета и группы токенов (рекомендуется использовать группу auto)

Тайм-аут подключения к удаленному серверу (Linux)

Проверьте сеть: curl -I https://llmoxy.com
Если требуется прокси, настройте переменную среды HTTPS_PROXY

Руководство по настройке Codex CLI