> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmeasy.ru/llms.txt
> Use this file to discover all available pages before exploring further.
# Настройка кастомной модели Codex через LLMEasy
> Подключите LLMEasy к Codex через /v1 и OpenAI Responses.
Для подключения Codex к LLMEasy нужен custom model provider и API Key. `base_url` должен быть `https://www.llmeasy.ru/v1`, протокол — `OpenAI Responses`.
Если вы хотите сохранить официальный login state Codex App, plugins или Remote Control при использовании стороннего API, используйте [настройку с сохранением login state](/faq/codex/official-login-third-party-api).
## Требования
* Установленный Node.js
* API Key LLMEasy (зарегистрироваться)
Перед настройкой очистите OpenAI-related переменные окружения, чтобы они не переопределили `config.toml`.
Очистите:
* `OPENAI_API_KEY`
* `OPENAI_BASE_URL`
macOS / Linux:
```bash theme={null}
unset OPENAI_API_KEY
unset OPENAI_BASE_URL
```
Windows PowerShell:
```powershell theme={null}
Remove-Item Env:OPENAI_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:OPENAI_BASE_URL -ErrorAction SilentlyContinue
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", $null, "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", $null, "User")
```
## Установка Codex
```bash theme={null}
npm install -g @openai/codex
```
## Настройка
Можно запустить автоматический скрипт LLMEasy. Он записывает только provider-конфигурацию LLMEasy и не заменяет предварительные требования выше. Скрипту нужен `Node.js`. Если API Key или модель не переданы явно, скрипт запросит их интерактивно, когда это поддерживается.
Выберите шаг для своей ОС. Нужен только один вариант.
```bash theme={null}
curl -fsSL https://www.llmeasy.ru/install-codex-provider.sh | bash
```
```powershell theme={null}
iwr https://www.llmeasy.ru/install-codex-provider.ps1 -OutFile "$env:TEMP\install-codex-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-codex-provider.ps1"
```
Этот путь описан в [инструкции CC Switch](/ai-tools/cc-switch#codex-cli).
Перейдите сразу к [вкладке Codex в инструкции CC Switch](/ai-tools/cc-switch#codex-cli).
После настройки в CC Switch вернитесь на эту страницу, чтобы проверить запуск и остальные примечания.
Конфигурация ниже использует `gpt-5.5` как модель по умолчанию и `gpt-5.4` как review model. Если нужно выбрать другую модель, откройте LLMEasy model plaza и скопируйте актуальный ID модели из группы **GPT**.
Для ручной настройки нужен файл Codex `config.toml`.
| Система | `config.toml` |
| ------------- | --------------------------------------- |
| macOS / Linux | `~/.codex/config.toml` |
| Windows | `C:\Users\YOUR_USER\.codex\config.toml` |
Откройте `config.toml`. Создайте его, если файла нет.
Этот блок применим только при ручном редактировании `~/.codex/config.toml`. Если вы настраиваете Codex через CC Switch, точно следуйте [инструкции CC Switch](/ai-tools/cc-switch#codex-cli) и не заменяйте конфигурацию, которой управляет CC Switch.
Добавьте:
```toml theme={null}
model_provider = "custom"
model = "gpt-5.5"
review_model = "gpt-5.4"
model_reasoning_effort = "high"
model_context_window = 1000000
model_auto_compact_token_limit = 900000
windows_wsl_setup_acknowledged = true
[model_providers]
[model_providers.custom]
name = "LLM Easy"
base_url = "https://www.llmeasy.ru/v1"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false
```
После изменения `config.toml` остановите текущий процесс Codex и запустите его в новой terminal session.
```bash theme={null}
codex
```
### Справочник параметров
В [официальном справочнике конфигурации Codex](https://developers.openai.com/codex/config-reference) указано, что `model_provider` ссылается на provider id внутри `model_providers`, custom provider задается через `[model_providers.]`, а `wire_api = "responses"` — поддерживаемое значение provider protocol.
| Конфигурация | Значение | Рекомендуемое значение |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| `model_provider` | Выбирает model provider, который использует Codex. Значение должно совпадать с `[model_providers.custom]`. | `"custom"` |
| `model` | Основная модель Codex для повседневного написания кода, правок и задач агента. | `"gpt-5.5"` |
| `review_model` | Модель для команды `/review`. Если не задано, Codex использует текущую основную модель. | `"gpt-5.4"` |
| `model_reasoning_effort` | Управляет reasoning strength для моделей с Responses API. Возможные значения: `minimal`, `low`, `medium`, `high`, `xhigh`. | `"high"` |
| `model_context_window` | Сообщает Codex размер context window активной модели в токенах. | `1000000` |
| `model_auto_compact_token_limit` | Автоматически сжимает историю диалога при достижении этого token threshold. | `900000` |
| `windows_wsl_setup_acknowledged` | Флаг подтверждения Windows / WSL onboarding, чтобы избежать повторных setup prompts. | `true` |
| `[model_providers]` | Родительская секция для custom model provider configuration. | `[model_providers]` |
| `[model_providers.custom]` | Определяет custom provider с id `custom`; `model_provider = "custom"` ссылается на эту секцию. | `[model_providers.custom]` |
| `name` | Отображаемое имя provider. Влияет только на отображение, не на request logic. | `"LLM Easy"` |
| `base_url` | Базовый API URL. Codex отправляет model requests на этот адрес. | `"https://www.llmeasy.ru/v1"` |
| `wire_api` | Provider protocol. В конфигурации Codex provider `responses` — поддерживаемое и default значение. | `"responses"` |
| `requires_openai_auth` | Использовать ли официальную OpenAI authentication. Для этого custom proxy provider OpenAI auth отключен. | `false` |
| `request_max_retries` | Максимальное число повторов для обычных failed HTTP requests. Официальное default значение — `4`. | `4` |
| `stream_max_retries` | Максимальное число повторов при прерывании SSE stream. Официальное default значение — `5`; для proxy chain можно увеличить. | `8` |
| `stream_idle_timeout_ms` | Idle timeout для SSE stream в миллисекундах. `300000` — это 5 минут. | `300000` |
| `supports_websockets` | Объявляет ли provider поддержку Responses API WebSocket transport. | `false` |
Примечание: [страница модели `gpt-5.5`](https://developers.openai.com/api/docs/models/gpt-5.5) показывает поддержку `high` reasoning effort и context window `1,050,000` tokens. Поэтому `model_context_window = 1000000` — разумное консервативное значение, а `model_auto_compact_token_limit = 900000` откладывает compaction и подходит для долгих задач.
Если конфигурацию пишет CC Switch, предпочитайте сгенерированный им файл. Редактируйте эти значения вручную только для manual setup или troubleshooting.
## Связанные FAQ
* [Что такое Codex CLI?](/faq/codex/what-is-codex-cli)
* [Codex CLI, Codex App и Codex Web: в чем разница?](/faq/codex/codex-cli-vs-app-vs-web)
* [Как настроить Codex CLI config.toml](/faq/codex/config-toml)
* [Что такое model\_provider, base\_url и wire\_api?](/faq/codex/model-provider-base-url-wire-api)
* [Что означают review\_model и reasoning\_effort?](/faq/codex/review-model-reasoning-effort)
* [Что такое AGENTS.md и как его писать?](/faq/codex/agents-md)
* [Что такое sandbox и approval mode в Codex CLI?](/faq/codex/sandbox-approval)
* [OpenAI-compatible API и Anthropic-compatible API](/faq/concepts/openai-compatible-vs-anthropic-compatible)
* [Claude Code и Codex CLI: в чем разница?](/faq/concepts/claude-code-vs-codex-cli)
## Проверка
После запуска отправьте тестовое сообщение. Обычный ответ означает, что подключение работает.
Если что-то не работает, проверьте:
1. `base_url` равен `https://www.llmeasy.ru/v1`
2. `wire_api` остается `responses`
3. `model` — это ID модели из группы **GPT**
4. `model_provider` совпадает с provider id в `[model_providers.custom]`
5. Старые переменные `OPENAI_API_KEY` или `OPENAI_BASE_URL` не мешают настройке