К содержимому
Блог

Codex скачать на ПК: приложение, CLI и подключение ключа Relay

Codex скачать на ПК: приложение, CLI и подключение ключа Relay

Слово «Codex» в поиске прячет сразу несколько программ: десктопное приложение, консольный клиент и расширение для редактора. Сам клиент бесплатный, платить приходится за модель, которая в нём работает. Ниже разобрано, что именно ставить, как подключить Codex к Relay через config.toml и по каким признакам отличить настоящий установщик от подделки.

Коротко

  • Codex ставится тремя способами: приложение, CLI из npm-пакета @openai/codex и расширение для редактора. Настройки у них общие, в каталоге ~/.codex.

  • Подключение к Relay сводится к блоку провайдера в config.toml и переменной окружения с ключом.

  • Relay Desktop умеет скачать Codex Desktop и настроить его за вас, ручной путь тоже описан.

  • Установщики берите только у вендора, а команды из чужих чатов в терминал не вставляйте.

Что именно вы скачиваете

Выбор зависит от того, где вы работаете весь день. Приложение удобно тем, кто хочет окно с историей, параллельными чатами и просмотром правок. Для терминала, скриптов и CI пригодится CLI: codex exec прогоняет агента одной командой, без диалога. Если вы живёте в VS Code, ставьте расширение. Поставить можно всё сразу, конфликта между ними нет.

ВариантДля чего удобенКак ставится
Приложение Codex Desktopокно с чатами и просмотром правоксо страницы загрузки OpenAI или через Relay Desktop
Codex CLIтерминал, скрипты, codex exec в CInpm или Homebrew
Расширение для редактораработа внутри VS Codeиз магазина расширений, идентификатор openai.chatgpt
Облачный Codex в браузерезадачи в облаке вендоравход только через ChatGPT

Две оговорки. Для Linux документация Relay пока советует CLI, а не приложение. А облачная версия по описанию вендора требует вход через ChatGPT, поэтому ключ Relay к ней не подключить. Сверьте эти пункты со страницами вендора на день установки: клиент обновляется быстро.

Установка CLI

Codex CLI требует Node.js версии 22 или новее. Проверьте, что он стоит, затем поставьте пакет и убедитесь, что команда отвечает:

bash
node --version
npm install -g @openai/codex
codex --version

На macOS есть вариант через Homebrew: brew install codex. Имя пакета сверяйте до символа: у похожих названий в реестре могут быть другие владельцы. Обновляется клиент той же командой, которой ставился.

Подключение к Relay

Нужны три вещи: ключ, переменная окружения и блок провайдера. Ключ создайте в консоли Relay, полностью он показывается один раз, поэтому сохраните его сразу. Для ключа можно задать суточный лимит расходов и список моделей, это удобно для пробного запуска.

Создайте файл ~/.codex/config.toml (на Windows %USERPROFILE%\.codex\config.toml) со следующим содержимым:

toml
model_provider = "relay"
model = "gpt-6-luna"
model_reasoning_effort = "high"

[model_providers.relay]
name = "Relay"
base_url = "https://relay-llm.ru/v1"
env_key = "RELAY_API_KEY"
wire_api = "responses"

Имя переменной в env_key выбираете вы: в примерах документации Relay там стоит OPENAI_API_KEY, и это работает так же, лишь бы строка в конфиге совпадала с переменной окружения. Задайте её в оболочке:

bash
echo 'export RELAY_API_KEY="sk-demo-not-a-real-key"' >> ~/.zshrc
source ~/.zshrc

Подставьте свой ключ вместо вымышленного. В Linux файл другой, ~/.bashrc. В Windows переменную записывают командой [Environment]::SetEnvironmentVariable("RELAY_API_KEY", "ключ", "User") в PowerShell и затем открывают новое окно. После этого перейдите в каталог проекта и введите codex. Модель в блоке выше взята из примера документации, любой другой идентификатор берите из каталога один в один.

Не добавляйте в конфиг приоритетный тариф: отдельного приоритетного тарифа у Relay нет. Подробности по каждому полю лежат в руководстве по Codex, а какую модель поставить вместо примера, разобрано в статье Модели Codex: Sol, Astra, Luna.

GPT-6 Luna0,08 $ за 1 млн входных токенов
GPT-6.1 Sol0,12 $ за 1 млн входных токенов

Приложение Codex Desktop

Самый короткий путь описан в документации Relay: Relay Desktop, официальное десктопное приложение сервиса, скачивает Codex Desktop, подключает его к Relay и применяет конфигурацию моделей. После входа в аккаунт вы нажимаете «Connect to Relay», выбираете модель, и всё готово. Кнопка «Disconnect Relay» убирает подключение и возвращает приложение к официальной подписке. Скачивайте Relay Desktop только со страницы документации Relay, а не с зеркал.

Ручная настройка делается тем же config.toml, что и для CLI. После правки приложение нужно закрыть полностью и открыть заново, иначе оно не прочитает ни файл, ни новую переменную. Есть и подводный камень на macOS: приложение, запущенное из Dock, может не увидеть переменные из ~/.zshrc. Запустите его из терминала или воспользуйтесь Relay Desktop.

Если Codex не запускается или просит войти

Пять частых причин и проверки:

  • Оболочка отвечает «command not found». Новый путь к программе видят только свежие сессии, поэтому закройте терминал и откройте заново. Заодно проверьте, что Node.js не старше 22.

  • Codex предлагает войти в ChatGPT, хотя ключ создан. Убедитесь, что файл лежит именно в ~/.codex, что model_provider ссылается на объявленную ниже таблицу [model_providers.relay] и что переменная из env_key существует в той же сессии, где вы запускаете клиент.

  • Ошибка про неизвестную модель. Строка model попадает в запрос как есть, любая опечатка ломает вызов. Сравните её со списком, который отдаёт GET https://relay-llm.ru/v1/models, и со справочником моделей.

  • Ответ с ошибкой 402. Баланс на нуле, пополните его и повторите запрос.

  • Генерация картинок из Codex не проходит. По документации Relay, с разрешениями по умолчанию сеть у агента ограничена. Полный доступ в настройках разрешений это снимает, но заодно убирает подтверждения перед изменением файлов и запуском команд, поэтому включайте его осознанно.

Как не поймать подделку

Вокруг слова «скачать» много ловушек. Исследователи компании PhishFort 17 августа 2026 описали кампанию: спонсорская ссылка на запрос про загрузку Codex для Mac открывала общий чат на настоящем домене chatgpt.com, а в чате предлагали вставить в Терминал команду, где пряталась закодированная строка. Внутри был похититель паролей и данных кошельков. Факт стоит перепроверить по первоисточнику, но выводы от этого не меняются.

  • Рекламу над выдачей пропускайте. Вводите адрес вендора вручную, например chatgpt.com/download, а исходники клиента ищите в репозитории github.com/openai/codex.

  • Команды из чужих чатов, рассылок и объявлений в терминал не копируйте. Публичный чат на знакомом домене может создать любой человек.

  • Если в команде мелькает длинная абракадабра из букв и цифр, остановитесь.

  • «Бесплатные ключи Codex», «пожизненные подписки» и взломанные сборки обходите стороной. Ключ Relay вы создаёте сами в консоли и ни у кого не покупаете. Свой ключ не отправляйте и в поддержку: достаточно идентификатора запроса и времени ошибки.

Нужен ли WSL, чтобы запустить Codex на Windows?

Нет, если верить документации OpenAI: на Windows агент выполняет команды в PowerShell, внутри песочницы. WSL нужен тем, чей рабочий процесс уже построен на Linux. Требования к версии системы смотрите на странице вендора.

Codex скачать бесплатно: он платный?

Клиент ничего не стоит, а исходники CLI, по описанию вендора, открыты под лицензией Apache-2.0. Счёт выставляют за модель: либо подписка ChatGPT, либо токены. Через Relay подписки нет, списание идёт с баланса за фактический расход.

Как обновить Codex?

Повторите ту же команду, которой ставили клиент: для npm это установка глобального пакета заново. Приложение обновляется собственным установщиком. Часть возможностей привязана к версии клиента, поэтому после обновления проверьте codex --version.

Получить ключ Relay

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.