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

> Установите OpenAI Codex App на macOS и Windows и подключитесь к LLMoxy Grok 4.7 через config.toml.

> **Область применения**
> Эта статья охватывает только подключение Codex App к LLMoxy, пример модели единообразно использует `grok-4.7`. Для терминальной версии, пожалуйста, обратитесь к «Руководству по настройке Codex CLI».

![Предпросмотр интерфейса Codex App](https://ru.llmoxy.com/docs-assets/migrated/tutorial-codex-app/app-screenshot-light.webp)

## Подготовка

Подготовьте три вещи перед началом:

1. Активная учетная запись [LLMoxy](https://llmoxy.com/)
2. Ключ API LLMoxy из группы **auto**
3. Название модели, единообразно используемое в этой статье: `grok-4.7`

Codex App совместно использует уровень конфигурации Codex с Codex CLI и плагинами IDE. Конфигурация уровня пользователя обычно размещается в `~/.codex/config.toml`; в нативном режиме Windows это соответствует `%USERPROFILE%\.codex\config.toml`.

## Универсальная конфигурация LLMoxy

Следующие разделы macOS, Windows Native и Windows + WSL все используют одну и ту же конфигурацию. Запишите ее в `config.toml` соответствующей среды:

```toml
model_provider = "llmoxy"
model = "grok-4.7"
model_reasoning_effort = "high"
model_verbosity = "medium"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

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

Значения конфигурации:

- `model_provider = "llmoxy"`: По умолчанию используется провайдер LLMoxy, определенный ниже
- `model = "grok-4.7"`: По умолчанию вызывается Grok 4.7 на LLMoxy
- `base_url = "https://llmoxy.com/v1"`: Конечная точка Codex, совместимая с OpenAI, требует `/v1`
- `wire_api = "responses"`: Используйте `/v1/responses`. Codex поддерживает только это значение, с `chat` он завершается ошибкой
- `env_key = "LLMOXY_API_KEY"`: Ключ API считывается из переменных среды, не записывается в файл конфигурации
- `approval_policy` и `sandbox_mode`: Сохраняйте подтверждение и песочницу рабочей области, подходящие для обычных пользователей

## Установка и настройка macOS

### 1. Установить Codex App

Откройте официальный адрес скачивания macOS:

- [https://persistent.oaistatic.com/codex-app-prod/Codex.dmg](https://persistent.oaistatic.com/codex-app-prod/Codex.dmg)

После скачивания дважды щелкните `.dmg` и перетащите Codex в `Applications` по подсказке системы.

### 2. Записать файл конфигурации

Откройте терминал и создайте каталог конфигурации Codex:

```bash
mkdir -p ~/.codex
open -a TextEdit ~/.codex/config.toml
```

Вставьте «Универсальную конфигурацию LLMoxy» выше и сохраните.

### 3. Установить ключ API

Shell по умолчанию на macOS обычно Zsh; запишите в `~/.zshrc`:

```bash
{
echo ''
echo '# LLMoxy'
echo 'export LLMOXY_API_KEY="Ваш ключ API LLMoxy"'
} >> ~/.zshrc
source ~/.zshrc
```

Проверить:

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

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

### 4. Открыть проект для проверки

Запустите Codex App, выберите каталог кода и отправьте легкую задачу:

```text
Объясните текущую структуру проекта и укажите, где находится входной файл.
```

Если Codex может прочитать проект и ответить нормально, сторона macOS подключена к LLMoxy.

## Установка и настройка Windows Native

![Интерфейс Codex App Windows](https://ru.llmoxy.com/docs-assets/migrated/tutorial-codex-app/codex-windows-light.webp)

Windows по умолчанию использует **Windows Native Agent**; команды выполняются в среде PowerShell, а файл конфигурации находится в каталоге пользователя Windows.

### 1. Установить Codex App

Выберите любой метод:

- Страница Microsoft Store: [Codex App](https://apps.microsoft.com/detail/9plm9xgg6vks?hl=en-US&gl=US)
- Установка PowerShell:

```powershell
winget install Codex -s msstore
```

### 2. Записать файл конфигурации

Создайте и откройте файл конфигурации с помощью PowerShell:

```powershell
New-Item -ItemType Directory -Force "$HOME\.codex"
notepad "$HOME\.codex\config.toml"
```

Вставьте «Универсальную конфигурацию LLMoxy» и сохраните.

Фактический путь обычно похож на:

```text
C:\Users\ВашеИмяПользователя\.codex\config.toml
```

### 3. Установить ключ API

Рекомендуется записать в переменные среды уровня пользователя Windows:

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

Закройте Codex App и PowerShell, откройте заново и проверьте:

```powershell
echo $env:LLMOXY_API_KEY
```

### 4. Открыть проект для проверки

Запустите Codex App, добавьте каталог проекта, затем отправьте:

```text
Выполните git status и объясните текущее состояние рабочей области.
```

Если политика выполнения PowerShell блокирует выполнение скриптов, вы можете выполнить в PowerShell:

```powershell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
```

Если функциональность Git недоступна, сначала установите нативный Git:

```powershell
winget install Git.Git
```

## Настройка Windows + WSL

Если ваш проект в основном разрабатывается в цепочке инструментов Linux, вы можете переключить Codex Agent на WSL.

![Переключиться на WSL Agent](https://ru.llmoxy.com/docs-assets/migrated/tutorial-codex-app/wsl-select-light.webp)

### 1. Переключить Agent

В Codex App откройте `Settings`, переключите Agent с Windows Native на WSL, затем перезапустите App. Эта настройка вступает в силу после перезапуска.

### 2. Записать конфигурацию внутри WSL

После переключения на терминал WSL создайте конфигурацию:

```bash
mkdir -p ~/.codex
nano ~/.codex/config.toml
```

Запишите «Универсальную конфигурацию LLMoxy» в `~/.codex/config.toml` внутри WSL.

### 3. Установить ключ API внутри WSL

Пользователи Bash:

```bash
{
echo ''
echo '# LLMoxy'
echo 'export LLMOXY_API_KEY="Ваш ключ API LLMoxy"'
} >> ~/.bashrc
source ~/.bashrc
```

Пользователи Zsh:

```bash
{
echo ''
echo '# LLMoxy'
echo 'export LLMOXY_API_KEY="Ваш ключ API LLMoxy"'
} >> ~/.zshrc
source ~/.zshrc
```

Проверить:

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

Windows Native и WSL — это два отдельных окружения. Когда Agent работает в WSL, вам нужно изменить `~/.codex/config.toml` в WSL и установить `LLMOXY_API_KEY` в WSL.

## Общие настройки App

### Редактор по умолчанию

Вы можете выбрать редактор по умолчанию `Open In` в настройках, например VS Code или Visual Studio.

![Установить редактор по умолчанию](https://ru.llmoxy.com/docs-assets/migrated/tutorial-codex-app/open-in-windows-light.webp)

### Интегрированный терминал

В Windows интегрированный терминал может выбирать PowerShell, Command Prompt, Git Bash или WSL. Эта настройка и среда выполнения Agent — две разные вещи: вы можете запускать Agent в WSL, а интегрированный терминал по-прежнему использовать PowerShell.

![Установить интегрированный терминал](https://ru.llmoxy.com/docs-assets/migrated/tutorial-codex-app/integrated-shell-light.webp)

После изменения терминала обычно вступает в силу только для новых сессий; при необходимости перезапустите Codex App.

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

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

Убедитесь, что `config.toml` в текущей среде записан:

```toml
model_provider = "llmoxy"
```

И убедитесь, что `LLMOXY_API_KEY` может быть прочитан в той же среде. При использовании провайдера LLMoxy Codex использует ключ API из переменной среды для вызова LLMoxy; нет необходимости записывать секретный ключ в файл конфигурации.

### 404 или модель не существует

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

1. `base_url` должен быть `https://llmoxy.com/v1`
2. `model` должен быть `grok-4.7`
3. Ключ API должен использовать токен из группы **auto**

### Несоответствие конфигурации Windows и WSL

Посмотрите, в какой среде работает Agent:

- Windows Native: измените `%USERPROFILE%\.codex\config.toml`, установите переменную среды пользователя Windows
- WSL: измените `~/.codex/config.toml` внутри WSL, установите переменную среды Shell WSL

### Хотите сбросить на более консервативные права

Сохраните следующую конфигурацию:

```toml
approval_policy = "on-request"
sandbox_mode = "workspace-write"
```

Это заставит Codex спрашивать перед выходом за пределы песочницы или выполнением чувствительных операций.

## Ссылки

- [OpenAI Codex App](https://developers.openai.com/codex/app/)
- [OpenAI Codex App для Windows](https://developers.openai.com/codex/app/windows/)
- [Базовая конфигурация OpenAI Codex](https://developers.openai.com/codex/config-basic)
- [Руководство по аутентификации OpenAI Codex](https://developers.openai.com/codex/auth)

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