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

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

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

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

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

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

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

npm install -g @openai/codex
BASH

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

brew install codex
BASH

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

codex --version
BASH

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 = "grok-4.7"
model_provider = "llmoxy"

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

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

  • model — Название модели по умолчанию, заполните модель, поддерживаемую LLMoxy (например, grok-4.7)
  • model_provider — Указывает на ID провайдера, определенный ниже
  • base_url — Адрес шлюза LLMoxy, с /v1
  • wire_api — Укажите responses для /v1/responses. Codex поддерживает только это значение, с 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

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

macOS / Linux:

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

Проверить:

echo "$LLMOXY_API_KEY"
BASH

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

4. Запуск

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

codex
BASH

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

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

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

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

codex -m grok-4.7
BASH

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

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

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

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

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

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

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

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

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

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

Веб-поиск

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

codex --search
BASH

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

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

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

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

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

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

npm config set prefix ~/.npm-global
BASH

Затем добавьте ~/.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": Codex больше не поддерживает chat, и wire_api = "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