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 в CI | npm или Homebrew |
| Расширение для редактора | работа внутри VS Code | из магазина расширений, идентификатор openai.chatgpt |
| Облачный Codex в браузере | задачи в облаке вендора | вход только через ChatGPT |
Две оговорки. Для Linux документация Relay пока советует CLI, а не приложение. А облачная версия по описанию вендора требует вход через ChatGPT, поэтому ключ Relay к ней не подключить. Сверьте эти пункты со страницами вендора на день установки: клиент обновляется быстро.
Установка CLI
Codex CLI требует Node.js версии 22 или новее. Проверьте, что он стоит, затем поставьте пакет и убедитесь, что команда отвечает:
node --version
npm install -g @openai/codex
codex --versionНа macOS есть вариант через Homebrew: brew install codex. Имя пакета сверяйте до символа: у похожих названий в реестре могут быть другие владельцы. Обновляется клиент той же командой, которой ставился.
Подключение к Relay
Нужны три вещи: ключ, переменная окружения и блок провайдера. Ключ создайте в консоли Relay, полностью он показывается один раз, поэтому сохраните его сразу. Для ключа можно задать суточный лимит расходов и список моделей, это удобно для пробного запуска.
Создайте файл ~/.codex/config.toml (на Windows %USERPROFILE%\.codex\config.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, и это работает так же, лишь бы строка в конфиге совпадала с переменной окружения. Задайте её в оболочке:
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.
Приложение 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.