Skip to main content

​
Обзор

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

🔁 Одна конфигурация, три интерфейса

Настольное приложение / расширение / CLI используют ~/.codex/ — настройте один раз

⚡ Последние модели

Поддерживает gpt-5.6-sol / gpt-5.5 / grok-4.5, а также другие модели

💰 Оплата по мере использования

Согласовано с тарификацией OpenAI, более выгодные цены

🪟 Кроссплатформенность

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

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

1

Зарегистрируйтесь / войдите в APIYI

Перейдите на api.apiyi.com и зарегистрируйтесь или войдите.
2

Создайте ключ API

Откройте страницу «Управление Token» (api.apiyi.com/token) и нажмите «Создать новый Token».
3

Скопируйте ключ

Скопируйте сгенерированный API Key (format: sk-***) и храните его в надежном месте — вы вставите его в файл конфигурации.

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

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

🖥️ Настольное приложение

Отдельное приложение, работает сразу после установки, лучше всего для новичков

🧩 Расширение IDE

Расширение для VSCode / Cursor, работайте с кодом рядом с ним

⌨️ CLI

Рабочий процесс в терминале, отлично подходит для скриптов и автоматизации

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

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

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

Откройте каталог конфигурации Codex (создайте его, если он отсутствует) и добавьте/отредактируйте внутри два файла:
Каталог конфигурации: %USERPROFILE%\.codex\ (то есть C:\Users\YourName\.codex\).Откройте его в Проводнике.
Если config.toml уже существует, НЕ перезаписывайте его целиком! В нем уже могут быть ваши предыдущие настройки модели, политика одобрения, MCP servers и т. д. Правильный подход — сначала сделать резервную копию, затем объединить (см. «Как безопасно отредактировать существующий config.toml» ниже) — добавьте только те несколько строк, которые нужны APIYI. То же касается auth.json: если он существует, просто обновите значение OPENAI_API_KEY.
1) auth.json — укажите здесь ваш ключ:
2) config.toml — укажите для провайдера модели APIYI: Для нового файла вставьте содержимое ниже. Для существующего файла добавьте «глобальные ключи» в самое начало и добавьте блок [model_providers.apiyi] в самый конец (причина — в подсказке ниже).
Перед сохранением замените sk-your-APIYI-key на ваш реальный ключ (строку sk-, которую вы скопировали из api.apiyi.com/token). Ключ должен совпадать в обоих файлах.
Шаг 1: Сначала сделайте резервную копию. Прежде чем менять любую конфигурацию, скопируйте оригинал, чтобы вы всегда могли восстановить его:
Шаг 2: Объединяйте, а не перезаписывайте. Добавьте в существующий файл только то, что нужно APIYI: поместите строки model / model_provider / preferred_auth_method в самое начало, а блок [model_providers.apiyi] добавьте в самый конец. Все остальное оставьте без изменений.
Подводный камень порядка в TOML: в TOML все «простые пары ключ-значение» (например, model = "...") должны идти перед любым заголовком таблицы [xxx], иначе они будут поглощены предыдущей таблицей. Поэтому самый безопасный вариант — держать глобальные ключи наверху, а [model_providers.apiyi] — внизу.
Шаг 3: Хотите просто протестировать, не затрагивая основную конфигурацию? Используйте профиль: создайте ~/.codex/apiyi.config.toml с содержимым выше, затем выполните codex --profile apiyi — полностью изолированно (см. Дополнительно).
Примечания по полям:
  • 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" как на запасной вариант (см. Дополнительно).
  • Не задавайте в этом файле жестко абсолютные пути вроде C:\Users\xxx\.codex\... — это сломается на других машинах.

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

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

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

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

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

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

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

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

​
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+):
Перейдите в свой проект и запустите, либо выполните разовую задачу:
Пользователям Mac, которые сталкиваются с ошибками разрешений при глобальной установке, следует использовать nvm / fnm для управления Node и избегать sudo.

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

После настройки и перезапуска введите минимальную задачу в любом интерфейсе:
Пользователи CLI также могут выполнить:
Если в ответе возвращается исполняемый код, интеграция APIYI работает.

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

Задайте это в поле model в config.toml или переключайте во время выполнения:
Как выбрать: повседневные задачи → 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.
Почему 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. См. Руководство по API Grok.Сравнение с Claude / Gemini: в APIYI эти две модели работают только в режиме чата, совместимом с OpenAI — без эндпоинта responses — поэтому в Codex вам нужно перейти на wire_api = "chat". Поскольку агентные сценарии Codex построены вокруг протокола responses, в режиме чата могут проявляться несовместимости при вызове инструментов и ухудшение опыта. Для программирования с Claude / Gemini используйте их нативные инструменты (Claude Code / Gemini CLI).
Другие модели, совместимые с OpenAI, тоже работают: APIYI агрегирует множество моделей, и любая модель, поддерживающая вызовы, совместимые с OpenAI, работает в Codex — например, glm-5.2 от Zhipu. Просто измените поле model у config.toml (или -m во время выполнения) на ID целевой модели.

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

① Указать при запуске (CLI):
② Указать в неинтерактивном режиме (CLI):
③ Переключить внутри сессии: введите /model в интерактивной панели и следуйте подсказкам. ④ Настроить модель по умолчанию (постоянно): отредактируйте ~/.codex/config.toml, измените model, сохраните и перезапустите:

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

Измените ~/.codex/instructions.md, чтобы задать стиль кодирования, язык вывода и соглашения проекта, например:
Запустите codex /init в проекте, чтобы сгенерировать AGENTS.md, фиксирующий структуру и соглашения. Чтобы заставить Codex по умолчанию отвечать на определенном языке, добавьте:
wire_api = "responses" — это протокол по умолчанию и предпочтительный протокол Codex, и большинство моделей работают напрямую. Если модель возвращает 404 / unknown endpoint, измените wire_api этого провайдера на "chat" (использует /chat/completions) и повторите попытку.
Создайте <name>.config.toml в ~/.codex/ (например, openai.config.toml для официальной настройки), затем переключайтесь во время выполнения с помощью codex --profile <name>. Удобно для быстрого переключения между APIYI и другими провайдерами.

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

Вы правильно указали 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:
Затем перезапустите приложение.Альтернативный вариант (если вы настаиваете на env_key): задайте переменную на уровне системы — на macOS выполните launchctl setenv OPENAI_API_KEY "sk-your-key", затем перезапустите приложение (после перезагрузки команду нужно выполнить снова); на Windows выполните setx OPENAI_API_KEY "sk-your-key", затем перезапустите приложение. Для использования только в CLI достаточно export в профиле вашей оболочки.
  • auth.json должен быть валидным JSON, а OPENAI_API_KEY должен быть установлен в ваш настоящий sk- Key.
  • config.toml должен корректно парситься как TOML (обратите внимание на кавычки и отступы).
  • Пути: Windows %USERPROFILE%\.codex\, Mac/Linux ~/.codex/.
Проверьте в консоли APIYI, что срок действия Key не истек и на вашем аккаунте есть баланс / квота.
Самая частая ошибка подключения / таймаут / 404 — это отсутствие /v1. Правильно: https://api.apiyi.com/v1. Затем проверьте локальный proxy и DNS.
Codex (CLI / extension / настольное приложение) читает config только при запуске. После редактирования auth.json / config.toml всегда перезапускайте программу.
Если с конкретной моделью несовместим протокол responses, измените wire_api этого провайдера на "chat" и повторите попытку.

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

Потому что APIYI полностью совместим с протоколом API OpenAI — https://api.apiyi.com/v1 и https://api.openai.com/v1 взаимозаменяемы в формате запроса/ответа. Достаточно заменить базовый URL.
Обычно это ожидаемо: при запуске Codex читает некоторые файлы из вашего текущего проекта для инициализации (структуру каталогов, AGENTS.md, релевантный исходный код) и отправляет их как контекст вместе с вашим prompt. Поэтому даже запрос из одного слова hello может стоить тысячи входных tokens.Как уменьшить расход?
  • Тестируйте минимальные задачи в пустом каталоге или очень маленьком проекте, чтобы контекст оставался небольшим.
  • Давайте конкретную небольшую задачу и указывайте точный файл (например, «смотрите только app.py, добавьте hello endpoint»), чтобы ограничить то, что сканирует Codex.
  • Используйте более дешевую модель (например, gpt-5.4-mini) для таких одноразовых проверок.
Проверьте установку:
Если это все еще не помогает, проверьте, находится ли npm bin -g в вашем PATH.
  1. Убедитесь, что вы используете ключ APIYI (начинается с sk-), а не ключ OpenAI.
  2. Убедитесь, что ключ в auth.json указан верно и без лишних пробелов.
  3. Перезапустите программу после изменения конфигурации.
Самая частая причина: в Base URL отсутствует /v1. Правильно: https://api.apiyi.com/v1. Затем проверьте локальный proxy и DNS.
  • серия 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.
  • Другие модели, совместимые с OpenAI: поддерживаются APIYI, например glm-5.2 — просто измените поле model.
  • Примечание: Claude / Gemini в APIYI предлагают только совместимый с OpenAI режим чата — без responses endpoint — поэтому в Codex вам нужно переключить wire_api на "chat", а агентные функции, такие как tool calling, могут столкнуться с несовместимостью. Для разработки на Claude / Gemini используйте их нативные инструменты (например, Claude Code / Gemini CLI).
Настольное приложение и расширения IDE читают только ~/.codex/config.toml + auth.json, а не переменные окружения. Убедитесь, что эти два файла корректны, метод авторизации установлен в apikey, и перезапустите программу.
  • CLI / приложение: лучше всего для продуктивности при разработке.
  • Production: предпочтительнее прямые вызовы API (больше контроля, мониторинг, постепенное развертывание).
Удалите CLI:
Отключите конфигурацию APIYI: удалите или восстановите ~/.codex/config.toml и auth.json (для настольного приложения / расширения управляйте этим в соответствующих интерфейсах).

​
9. Кратко

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

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

Консоль APIYI

Управляйте API-ключами и просматривайте использование

Визуальная конфигурация CC Switch

GUI-настройка в один клик для Codex / Claude Code

Интеграция Claude Code

Используйте модели Claude для программирования в CLI

Сравнение моделей

Все доступные модели и тарификация