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

> Подключите Codex CLI к шлюзу LLMoxy через ~/.codex/config.toml с пользовательским провайдером моделей, используя Grok 4.7 и другие модели для программирования в терминале.

> **📌 О Codex CLI**
> Codex CLI — это официальный терминальный агент кодирования OpenAI, написанный на Rust, способный локально читать, изменять и запускать код ([открытый исходный код](https://github.com/openai/codex)). По умолчанию подключается к OpenAI, но поддерживает пользовательский `model_provider`, поэтому может бесшовно подключаться к шлюзу LLMoxy и использовать Grok 4.7 и другие модели.

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

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

Посетите [официальный сайт Node.js](https://nodejs.org/). Рекомендуется скачать версию LTS слева, это версия с долгосрочной поддержкой, более стабильная.

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

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

```bash
npm install -g @openai/codex
```

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

```bash
brew install codex
```

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

```bash
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](https://llmoxy.com/) → Управление ключами API → Скопируйте секретный ключ.

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

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

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

```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"
```

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

- `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, постоянно):**

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

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

**macOS / Linux:**

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

Проверить:

```bash
echo "$LLMOXY_API_KEY"
```

Вы **должны** заменить `Ваш ключ API LLMoxy` на реальный ключ, скопированный из [Консоли LLMoxy](https://llmoxy.com/).

### 4. Запуск

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

```bash
codex
```

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

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

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

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

```bash
codex -m grok-4.7
```

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

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

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

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

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

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

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

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

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

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

### Веб-поиск

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

```bash
codex --search
```

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

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

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

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

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

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

```bash
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"`: Codex больше не поддерживает `chat`, и `wire_api = "chat"` из старых инструкций приводит к ошибке

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

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

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

- Проверьте, что ключ API не содержит лишних пробелов
- Перейдите в [Консоль LLMoxy](https://llmoxy.com/) для проверки баланса счета и группы токенов (рекомендуется использовать группу **auto**)

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

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

Это markdown-версия страницы https://ru.llmoxy.com/docs/code-tutorials/codex-cli.
