> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI Codex

> Одна конфигурация, три интерфейса: используйте gpt-5.6-sol / gpt-5.5 / gpt-5.4 через APIYI в настольном приложении Codex, расширениях IDE (VSCode/Cursor) и CLI. Рекомендуемый путь — `config.toml` + `auth.json` — без возни с переменными окружения.

## Обзор

<Info>
  **Codex и приложение ChatGPT объединились**: в начале июля 2026 года OpenAI встроила настольное приложение Codex в приложение ChatGPT — теперь это один продукт. Это руководство поэтому **применимо и к приложению Codex, и к приложению ChatGPT**: если вы используете Codex внутри приложения ChatGPT, конфигурация абсолютно та же.
</Info>

**OpenAI Codex** — официальный AI-помощник OpenAI для программирования, доступный тремя способами: **настольное приложение**, **расширения IDE** (VSCode / Cursor и т. д.) и **командная строка CLI**. Все три варианта используют **одну и ту же конфигурацию** в `~/.codex/` (`config.toml` и `auth.json`).

Интеграция с APIYI сводится к одному предложению:

> **Замените эндпоинт OpenAI на APIYI**

APIYI — это **совместимый с OpenAI интерфейс (прозрачный прокси)** — настройте его один раз, и настольное приложение, расширения и терминал будут работать.

<CardGroup cols={2}>
  <Card title="🔁 Одна конфигурация, три интерфейса" icon="layers">
    Настольное приложение / расширение / CLI используют `~/.codex/` — настройте один раз
  </Card>

  <Card title="⚡ Последние модели" icon="sparkles">
    Поддерживает `gpt-5.6-sol` / `gpt-5.5` / `grok-4.5`, а также другие модели
  </Card>

  <Card title="💰 Оплата по мере использования" icon="calculator">
    Согласовано с тарификацией OpenAI, более выгодные цены
  </Card>

  <Card title="🪟 Кроссплатформенность" icon="globe">
    Windows / Mac / Linux — все поддерживаются
  </Card>
</CardGroup>

<Info>
  **Сначала разберитесь в этом**: ключ к тому, чтобы направить Codex на сторонний API (например, APIYI), — установить «model provider» на APIYI в `~/.codex/config.toml` и указать ваш ключ в `~/.codex/auth.json`. **И настольное приложение, и расширения IDE опираются на эти файлы** — поэтому в этом руководстве сначала рассматриваются файлы конфигурации, а не переменные окружения.
</Info>

## 1. Предварительные требования: получите ваш ключ APIYI

<Steps>
  <Step title="Зарегистрируйтесь / войдите в APIYI">
    Перейдите на [api.apiyi.com](https://api.apiyi.com) и зарегистрируйтесь или войдите.
  </Step>

  <Step title="Создайте ключ API">
    Откройте страницу «Управление Token» ([api.apiyi.com/token](https://api.apiyi.com/token)) и нажмите «Создать новый Token».
  </Step>

  <Step title="Скопируйте ключ">
    Скопируйте сгенерированный API Key (format: `sk-***`) и храните его в надежном месте — вы вставите его в файл конфигурации.
  </Step>
</Steps>

### Выберите вариант

Все три варианта используют **точно одну и ту же конфигурацию** — выберите тот, который подходит вашему рабочему процессу:

<CardGroup cols={3}>
  <Card title="🖥️ Настольное приложение" icon="monitor">
    Отдельное приложение, работает сразу после установки, **лучше всего для новичков**
  </Card>

  <Card title="🧩 Расширение IDE" icon="puzzle">
    Расширение для VSCode / Cursor, работайте с кодом рядом с ним
  </Card>

  <Card title="⌨️ CLI" icon="terminal">
    Рабочий процесс в терминале, отлично подходит для скриптов и автоматизации
  </Card>
</CardGroup>

## 2. Основная конфигурация (рекомендуется: файлы конфигурации, а не переменные окружения)

Ниже три способа — **выберите один**. Рекомендуемый порядок: вручную создать файлы конфигурации (самый надежный) → визуально → переменные окружения.

### Вариант 1 · Вручную создать `auth.json` + `config.toml` (рекомендуется, самый надежный)

Откройте каталог конфигурации Codex (создайте его, если он отсутствует) и добавьте/отредактируйте внутри два файла:

<Tabs>
  <Tab title="🪟 Windows">
    Каталог конфигурации: `%USERPROFILE%\.codex\` (то есть `C:\Users\YourName\.codex\`).

    Откройте его в Проводнике.
  </Tab>

  <Tab title="Mac / Linux">
    Каталог конфигурации: `~/.codex/`.

    Выполните `mkdir -p ~/.codex` в терминале, чтобы перейти в него.
  </Tab>
</Tabs>

<Warning>
  **Если `config.toml` уже существует, НЕ перезаписывайте его целиком!** В нем уже могут быть ваши предыдущие настройки модели, политика одобрения, MCP servers и т. д. Правильный подход — **сначала сделать резервную копию, затем объединить** (см. «Как безопасно отредактировать существующий config.toml» ниже) — добавьте только те несколько строк, которые нужны APIYI. То же касается `auth.json`: если он существует, просто обновите значение `OPENAI_API_KEY`.
</Warning>

**1) `auth.json` — укажите здесь ваш ключ:**

```json theme={null}
{
  "OPENAI_API_KEY": "sk-your-APIYI-key"
}
```

**2) `config.toml` — укажите для провайдера модели APIYI:**

Для **нового файла** вставьте содержимое ниже. Для **существующего файла** добавьте «глобальные ключи» в **самое начало** и добавьте блок `[model_providers.apiyi]` в **самый конец** (причина — в подсказке ниже).

```toml theme={null}
# === Global (put at the very top of the file) ===
model = "gpt-5.4"                 # default model, change to gpt-5.5 etc. as needed
model_provider = "apiyi"          # use the apiyi provider defined below
preferred_auth_method = "apikey"  # authenticate with API Key (not chatgpt login)

# === APIYI provider definition (put at the very bottom) ===
[model_providers.apiyi]
name = "apiyi"
base_url = "https://api.apiyi.com/v1"
experimental_bearer_token = "sk-your-APIYI-key"
wire_api = "responses"
```

<Warning>
  **Перед сохранением замените `sk-your-APIYI-key` на ваш реальный ключ** (строку `sk-`, которую вы скопировали из `api.apiyi.com/token`). Ключ должен совпадать в обоих файлах.
</Warning>

<Accordion title="Как безопасно отредактировать существующий config.toml (резервная копия + лучшее практическое объединение)">
  **Шаг 1: Сначала сделайте резервную копию.** Прежде чем менять любую конфигурацию, скопируйте оригинал, чтобы вы всегда могли восстановить его:

  ```bash theme={null}
  # Mac / Linux
  cp ~/.codex/config.toml ~/.codex/config.toml.bak

  # Windows PowerShell
  Copy-Item $env:USERPROFILE\.codex\config.toml $env:USERPROFILE\.codex\config.toml.bak
  ```

  **Шаг 2: Объединяйте, а не перезаписывайте.** Добавьте в существующий файл только то, что нужно APIYI: поместите строки `model` / `model_provider` / `preferred_auth_method` в **самое начало**, а блок `[model_providers.apiyi]` добавьте в **самый конец**. Все остальное оставьте без изменений.

  <Warning>
    **Подводный камень порядка в TOML**: в TOML все «простые пары ключ-значение» (например, `model = "..."`) **должны идти перед любым заголовком таблицы `[xxx]`**, иначе они будут поглощены предыдущей таблицей. Поэтому самый безопасный вариант — держать глобальные ключи наверху, а `[model_providers.apiyi]` — внизу.
  </Warning>

  **Шаг 3: Хотите просто протестировать, не затрагивая основную конфигурацию?** Используйте профиль: создайте `~/.codex/apiyi.config.toml` с содержимым выше, затем выполните `codex --profile apiyi` — полностью изолированно (см. [Дополнительно](#6-advanced-configuration)).
</Accordion>

<Note>
  **Примечания по полям**:

  * `base_url`: всегда `https://api.apiyi.com/v1` — он **обязательно должен включать `/v1`**, иначе вы получите ошибки 404.
  * `experimental_bearer_token`: помещает ключ прямо в блок провайдера и отправляет его как Bearer token. **Это единственный вариант, который надежно работает в desktop app, расширении IDE и CLI** — без участия переменной окружения.
  * Поля аутентификации провайдера **взаимоисключающие — выберите ровно одно**: `experimental_bearer_token` (ключ в конфиге, рекомендуется) / `env_key` (читает ключ из **переменной окружения процесса запуска** — обратите внимание, он **не** откатывается к `auth.json`, и desktop app не может видеть переменные, экспортированные в вашем терминале) / `requires_openai_auth` (переиспользует официальное состояние входа в `auth.json`). Если вы следовали более старой версии этого руководства, где сочетались `env_key` + `requires_openai_auth`, переключитесь на текущий вариант.
  * `wire_api = "responses"`: протокол Codex по умолчанию и предпочтительный, поддерживается APIYI. Если конкретная модель возвращает 404 / неизвестный эндпоинт, переключите ее на `"chat"` как на запасной вариант (см. [Дополнительно](#6-advanced-configuration)).
  * Не задавайте в этом файле жестко абсолютные пути вроде `C:\Users\xxx\.codex\...` — это сломается на других машинах.
</Note>

### Вариант 2 · Визуальная настройка cc-switch (GUI, без ручного редактирования)

Если вы не хотите редактировать файлы вручную, используйте **CC Switch** — GUI, которая запишет в конфигурацию Codex URL, ключ и модель APIYI всего за несколько кликов. Она также управляет Claude Code, Codex, Gemini CLI и многим другим в одном месте, с переключением в один клик, и берет на себя резервное копирование/объединение выше — хороший первый выбор для новичков.

См. [Визуальная настройка CC Switch](/ru/scenarios/programming/cc-switch). После настройки desktop app / extension / CLI Codex автоматически подхватят конфигурацию.

### Вариант 3 · Переменные окружения (необязательно, неудобно, не рекомендуется)

<Accordion title="Хотите быстро протестировать в терминале? Разверните метод с переменными окружения (не для долгосрочного использования)">
  Codex CLI также может читать переменные окружения `OPENAI_BASE_URL` / `OPENAI_API_KEY`:

  ```bash theme={null}
  export OPENAI_BASE_URL="https://api.apiyi.com/v1"
  export OPENAI_API_KEY="sk-your-APIYI-key"
  ```

  <Warning>
    **Не рекомендуется как основной путь**: переменные окружения часто не применяются в новых сборках Codex, и **desktop app / расширения IDE их не читают** — они учитывают только `config.toml` + `auth.json`. Переменные окружения подходят только для быстрого теста в CLI; для долгосрочного использования выбирайте Вариант 1 или Вариант 2.
  </Warning>
</Accordion>

## 3. Использование каждого интерфейса (сначала настольная версия)

После настройки `~/.codex/` выберите любой вариант ниже. **Перезапускайте программу после изменения config** (Codex читает config только при запуске).

### 1. Настольное приложение Codex (рекомендуется в первую очередь)

1. Установите и откройте настольное приложение Codex.
2. При первом запуске выберите способ аутентификации: **выберите apikey** (не вход через ChatGPT).
3. В селекторе model / provider выберите провайдера `apiyi` и целевую модель (например, `gpt-5.4`).
4. **Перезапустите приложение**, чтобы изменения вступили в силу.
5. Выполните минимальную задачу для проверки (см. [Раздел 4](#4-minimal-verification)).

### 2. Расширение IDE (VSCode / Cursor)

1. Откройте маркетплейс расширений (в VSCode нажмите `Ctrl+Shift+X` / `Cmd+Shift+X`), найдите `Codex — OpenAI's coding agent` и нажмите `Install`.
2. После установки в боковой панели появится значок Codex — нажмите его, чтобы открыть панель.
3. При первом открытии ответьте на три запроса: ① способ аутентификации — **выберите apikey**; ② источник ключа — выберите «конфигурационный файл / переменная окружения»; ③ включите `AGENTS.md` (рекомендуется).
4. **Перезапустите редактор**, чтобы изменения вступили в силу.
5. Выполните минимальную задачу в панели Codex для проверки.

### 3. CLI

Установите официальный CLI глобально (требуется Node.js 18+):

```bash theme={null}
npm install -g @openai/codex
codex --version
```

Перейдите в свой проект и запустите, либо выполните разовую задачу:

```bash theme={null}
cd /your/project
codex                                  # interactive mode
codex "write a Python HTTP server"     # pass a task directly
codex -q "fix the build errors"        # non-interactive / silent mode
```

<Tip>
  Пользователям Mac, которые сталкиваются с ошибками разрешений при глобальной установке, следует использовать nvm / fnm для управления Node и избегать `sudo`.
</Tip>

## 4. Минимальная проверка

После настройки и перезапуска введите минимальную задачу в любом интерфейсе:

```text theme={null}
Create a hello endpoint in this project and include a usage example.
```

Пользователи CLI также могут выполнить:

```bash theme={null}
codex -q "hello"
```

Если в ответе возвращается исполняемый код, интеграция APIYI работает.

## 5. Модели (Рекомендации APIYI)

Задайте это в поле `model` в `config.toml` или переключайте во время выполнения:

| Модель               | Сильные стороны                                                   | Лучше всего подходит для                                                                              |
| -------------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **`gpt-5.6-sol`**    | флагман 5.6 (выпущен 9 июля 2026 года)                            | Самые сложные задачи: сложное программирование, глубокий инженерный анализ, агентные рабочие процессы |
| **`gpt-5.6-terra`**  | сбалансированный уровень 5.6                                      | Массовые бизнес-задачи, баланс производительности и стоимости                                         |
| **`gpt-5.6-luna`**   | быстрый, недорогой уровень 5.6                                    | Суммаризация, черновики, рутинная автоматизация — быстро и дешево                                     |
| **`gpt-5.5`**        | флагман предыдущего поколения                                     | Сложное программирование, инженерный анализ, агентные рабочие процессы                                |
| **`gpt-5.4`**        | Стабильная рабочая модель                                         | Большинство задач по программированию, отладке и рефакторингу (вариант по умолчанию)                  |
| **`gpt-5.4-mini`**   | недорогой вариант 5.4                                             | Задачи среднего масштаба, пакетная обработка, экономия средств                                        |
| **`grok-4.5`**       | флагман xAI, **нативная поддержка протокола responses**           | Кодирующие агенты, сложные задачи — лучший выбор вне линейки OpenAI                                   |
| **`grok-build-0.1`** | модель Grok, ориентированная на код, с самой низкой ценой в серии | Частое автодополнение кода, легкие задачи по программированию                                         |

<Tip>
  **Как выбрать**: повседневные задачи → `gpt-5.4` или `gpt-5.6-terra`; тяжелая работа / агенты → `gpt-5.6-sol` (или `gpt-5.5`); экономия → `gpt-5.6-luna` / `gpt-5.4-mini`; для разнообразия вне OpenAI → `grok-4.5`.
</Tip>

<Note>
  **Почему Grok заслуживает отдельного упоминания**: официальный API xAI сам по себе является API, совместимым с OpenAI, с двумя эндпоинтами (Chat Completions + Responses API), что делает Grok **редкой не-OpenAI моделью с нативной поддержкой протокола `/v1/responses`** — оставьте `wire_api = "responses"` как есть в Codex и просто переключите `model` на `grok-4.5`; агентные возможности Codex (вызовы инструментов, элементы рассуждения и т. д.) работают поверх нативного протокола. Эндпоинт responses проверен в APIYI с помощью `grok-4.5`; другие модели Grok используют ту же архитектуру и, как ожидается, будут вести себя идентично — если одна возвращает 404, используйте запасной вариант из [Раздела 6](#6-advanced-configuration). См. [Руководство по API Grok](/ru/api-capabilities/grok/overview).

  **Сравнение с Claude / Gemini**: в APIYI эти две модели работают только в **режиме чата, совместимом с OpenAI — без эндпоинта responses** — поэтому в Codex вам нужно перейти на `wire_api = "chat"`. Поскольку агентные сценарии Codex построены вокруг протокола responses, в режиме чата могут проявляться несовместимости при вызове инструментов и ухудшение опыта. Для программирования с Claude / Gemini используйте их нативные инструменты ([Claude Code](/ru/scenarios/programming/claude-code) / [Gemini CLI](/ru/scenarios/programming/gemini-cli)).
</Note>

<Note>
  **Другие модели, совместимые с OpenAI, тоже работают**: APIYI агрегирует множество моделей, и любая модель, поддерживающая вызовы, совместимые с OpenAI, работает в Codex — например, `glm-5.2` от Zhipu. Просто измените поле `model` у `config.toml` (или `-m` во время выполнения) на ID целевой модели.
</Note>

### 4 способа переключения моделей

**① Указать при запуске** (CLI):

```bash theme={null}
codex -m gpt-5.5
codex --model gpt-5.4 "review this project's structure"
```

**② Указать в неинтерактивном режиме** (CLI):

```bash theme={null}
codex -q -m gpt-5.4 "fix the build errors in this project"
```

**③ Переключить внутри сессии**: введите `/model` в интерактивной панели и следуйте подсказкам.

**④ Настроить модель по умолчанию (постоянно)**: отредактируйте `~/.codex/config.toml`, измените `model`, сохраните и перезапустите:

```toml theme={null}
model = "gpt-5.5"
```

## 6. Дополнительная конфигурация

<AccordionGroup>
  <Accordion title="Пользовательские системные промпты (instructions.md)">
    Измените `~/.codex/instructions.md`, чтобы задать стиль кодирования, язык вывода и соглашения проекта, например:

    ```markdown theme={null}
    - Write code comments in English
    - Follow the project's ESLint config
    - Provide detailed explanations
    ```
  </Accordion>

  <Accordion title="AGENTS.md на уровне проекта">
    Запустите `codex /init` в проекте, чтобы сгенерировать `AGENTS.md`, фиксирующий структуру и соглашения. Чтобы заставить Codex по умолчанию отвечать на определенном языке, добавьте:

    ```markdown theme={null}
    Always respond to the user in English for this project.
    ```
  </Accordion>

  <Accordion title="Резервный вариант протокола: переключите wire_api на chat">
    `wire_api = "responses"` — это протокол по умолчанию и предпочтительный протокол Codex, и большинство моделей работают напрямую. Если модель возвращает 404 / unknown endpoint, измените `wire_api` этого провайдера на `"chat"` (использует `/chat/completions`) и повторите попытку.
  </Accordion>

  <Accordion title="Несколько конфигураций (профилей)">
    Создайте `<name>.config.toml` в `~/.codex/` (например, `openai.config.toml` для официальной настройки), затем переключайтесь во время выполнения с помощью `codex --profile <name>`. Удобно для быстрого переключения между APIYI и другими провайдерами.
  </Accordion>

  <Accordion title="Распространенные флаги">
    ```bash theme={null}
    codex -h          # full help
    codex -m <model>  # specify model
    codex -q          # non-interactive / silent mode
    codex --full-auto # auto-execute (use cautiously)
    ```
  </Accordion>
</AccordionGroup>

## 7. Устранение неполадок

<AccordionGroup>
  <Accordion title="1. Отсутствует переменная окружения: OPENAI_API_KEY (чаще всего в настольном приложении / расширении)">
    Вы правильно указали `auth.json` + `config.toml` и перезапустили приложение, но оно по-прежнему показывает `Missing environment variable: OPENAI_API_KEY` — причина в `env_key = "OPENAI_API_KEY"` в блоке провайдера (в том формате, который использовала более старая версия этого руководства).

    `env_key` означает **брать Key из переменных окружения процесса, который запустил Codex** — он **не** откатывается к `auth.json` (который обслуживает только официальное состояние входа OpenAI). А когда настольное приложение / IDE запускается из Dock или лаунчера, оно **не наследует переменные, которые вы экспортировали в терминале** (`export` в `.zshrc` не влияет на GUI-приложения), поэтому никакие перезапуски не заставят переменную появиться.

    **Исправление (рекомендуется)**: отредактируйте `~/.codex/config.toml`, удалите `env_key` из блока провайдера (и `requires_openai_auth`, если есть), и поместите Key напрямую в config:

    ```toml theme={null}
    [model_providers.apiyi]
    name = "apiyi"
    base_url = "https://api.apiyi.com/v1"
    experimental_bearer_token = "sk-your-APIYI-key"
    wire_api = "responses"
    ```

    Затем **перезапустите** приложение.

    **Альтернативный вариант** (если вы настаиваете на `env_key`): задайте переменную на уровне системы — на macOS выполните `launchctl setenv OPENAI_API_KEY "sk-your-key"`, затем перезапустите приложение (после перезагрузки команду нужно выполнить снова); на Windows выполните `setx OPENAI_API_KEY "sk-your-key"`, затем перезапустите приложение. Для использования только в CLI достаточно `export` в профиле вашей оболочки.
  </Accordion>

  <Accordion title="2. Проверьте путь и содержимое auth.json / config.toml">
    * `auth.json` должен быть валидным JSON, а `OPENAI_API_KEY` должен быть установлен в ваш настоящий `sk-` Key.
    * `config.toml` должен корректно парситься как TOML (обратите внимание на кавычки и отступы).
    * Пути: Windows `%USERPROFILE%\.codex\`, Mac/Linux `~/.codex/`.
  </Accordion>

  <Accordion title="3. Убедитесь, что Key действителен и есть доступный баланс">
    Проверьте в консоли APIYI, что срок действия Key не истек и на вашем аккаунте есть баланс / квота.
  </Accordion>

  <Accordion title="4. Убедитесь, что base_url включает /v1">
    Самая частая ошибка подключения / таймаут / 404 — это отсутствие `/v1`. Правильно: `https://api.apiyi.com/v1`. Затем проверьте локальный proxy и DNS.
  </Accordion>

  <Accordion title="5. Перезапускайте после каждого изменения config">
    Codex (CLI / extension / настольное приложение) читает config только при запуске. **После редактирования `auth.json` / `config.toml` всегда перезапускайте программу.**
  </Accordion>

  <Accordion title="6. По-прежнему нестабильно: переключите wire_api на chat">
    Если с конкретной моделью несовместим протокол `responses`, измените `wire_api` этого провайдера на `"chat"` и повторите попытку.
  </Accordion>
</AccordionGroup>

## 8. Часто задаваемые вопросы

<AccordionGroup>
  <Accordion title="Почему Codex работает с APIYI?">
    Потому что APIYI **полностью совместим с протоколом API OpenAI** — `https://api.apiyi.com/v1` и `https://api.openai.com/v1` взаимозаменяемы в формате запроса/ответа. Достаточно заменить базовый URL.
  </Accordion>

  <Accordion title="Почему простой hello расходует десятки тысяч input tokens?">
    Обычно это **ожидаемо**: при запуске Codex **читает некоторые файлы из вашего текущего проекта для инициализации** (структуру каталогов, `AGENTS.md`, релевантный исходный код) и отправляет их как контекст вместе с вашим prompt. Поэтому даже запрос из одного слова `hello` может стоить тысячи входных tokens.

    **Как уменьшить расход?**

    * Тестируйте минимальные задачи в **пустом каталоге** или **очень маленьком проекте**, чтобы контекст оставался небольшим.
    * Давайте конкретную небольшую задачу и **указывайте точный файл** (например, «смотрите только `app.py`, добавьте hello endpoint»), чтобы ограничить то, что сканирует Codex.
    * Используйте более дешевую модель (например, `gpt-5.4-mini`) для таких одноразовых проверок.
  </Accordion>

  <Accordion title="`command not found: codex`">
    Проверьте установку:

    ```bash theme={null}
    npm install -g @openai/codex
    codex --version
    ```

    Если это все еще не помогает, проверьте, находится ли `npm bin -g` в вашем `PATH`.
  </Accordion>

  <Accordion title="Неверный API-ключ (401 / Неверный ключ)">
    1. Убедитесь, что вы используете **ключ APIYI** (начинается с `sk-`), а не ключ OpenAI.
    2. Убедитесь, что ключ в `auth.json` указан верно и без лишних пробелов.
    3. **Перезапустите** программу после изменения конфигурации.
  </Accordion>

  <Accordion title="Ошибка подключения / тайм-аут / 404">
    Самая частая причина: **в Base URL отсутствует `/v1`**. Правильно: `https://api.apiyi.com/v1`. Затем проверьте локальный proxy и DNS.
  </Accordion>

  <Accordion title="Какие модели поддерживаются?">
    * **серия OpenAI**: ✅ полностью поддерживается (рекомендуются `gpt-5.6-sol` / `gpt-5.6-terra` / `gpt-5.6-luna` / `gpt-5.5` / `gpt-5.4`).
    * **серия Grok**: ✅ родная поддержка протокола responses — `grok-4.5` работает без изменения `wire_api`; см. [Руководство по API Grok](/ru/api-capabilities/grok/overview).
    * **Другие модели, совместимые с OpenAI**: поддерживаются APIYI, например `glm-5.2` — просто измените поле `model`.
    * Примечание: **Claude / Gemini в APIYI предлагают только совместимый с OpenAI режим чата — без responses endpoint** — поэтому в Codex вам нужно переключить `wire_api` на `"chat"`, а агентные функции, такие как tool calling, могут столкнуться с несовместимостью. Для разработки на Claude / Gemini используйте их нативные инструменты (например, Claude Code / Gemini CLI).
  </Accordion>

  <Accordion title="Не работает desktop app / extension?">
    Настольное приложение и расширения IDE **читают только `~/.codex/config.toml` + `auth.json`, а не переменные окружения**. Убедитесь, что эти два файла корректны, метод авторизации установлен в **apikey**, и **перезапустите** программу.
  </Accordion>

  <Accordion title="Подходит для production?">
    * **CLI / приложение**: лучше всего для продуктивности при разработке.
    * **Production**: предпочтительнее прямые вызовы API (больше контроля, мониторинг, постепенное развертывание).
  </Accordion>

  <Accordion title="Как удалить или отключить настройку APIYI?">
    **Удалите CLI**:

    ```bash theme={null}
    npm uninstall -g @openai/codex
    ```

    **Отключите конфигурацию APIYI**: удалите или восстановите `~/.codex/config.toml` и `auth.json` (для настольного приложения / расширения управляйте этим в соответствующих интерфейсах).
  </Accordion>
</AccordionGroup>

## 9. Кратко

Вся интеграция сводится к одной фразе:

> **Замените endpoint OpenAI на APIYI**

Суть в том, чтобы один раз настроить `~/.codex/`: поместите ключ в `auth.json` и укажите `base_url` на `https://api.apiyi.com/v1` в `config.toml`. После этого **будут работать настольное приложение, расширения IDE и CLI**. Все остальное — выбор моделей, prompts, `instructions.md`, `AGENTS.md` — это лишь полировка.

## Связанные ресурсы

<CardGroup cols={2}>
  <Card title="Консоль APIYI" icon="settings" href="https://api.apiyi.com">
    Управляйте API-ключами и просматривайте использование
  </Card>

  <Card title="Визуальная конфигурация CC Switch" icon="toggle-left" href="/ru/scenarios/programming/cc-switch">
    GUI-настройка в один клик для Codex / Claude Code
  </Card>

  <Card title="Интеграция Claude Code" icon="bot" href="/ru/scenarios/programming/claude-code">
    Используйте модели Claude для программирования в CLI
  </Card>

  <Card title="Сравнение моделей" icon="chart-bar" href="/ru/api-capabilities/model-info">
    Все доступные модели и тарификация
  </Card>
</CardGroup>