Как скачать и установить Codex на Windows, macOS и Linux

Скачать Codex проще всего через npm: npm install -g @openai/codex. На macOS подойдёт и Homebrew, а на всех системах есть официальный установщик. После установки проверьте результат командой codex --version. Из России обычный вход через аккаунт ChatGPT недоступен, поэтому для работы нужен свой провайдер: ключ с оплатой в рублях даёт AI для кода от PurpleSchool.

Ниже — установка на Windows, macOS и Linux, настройка доступа и частые ошибки.

Какой способ выбрать

Выберите один. Несколько установок одновременно приводят к путанице: терминал может запускать не ту версию.

Отдельно существует расширение для редактора и настольное приложение. В этой статье речь о Codex CLI — программе для терминала. Для VS Code смотрите инструкцию Claude Code и Codex в VS Code.

Установка через npm

Способ работает на всех системах и не зависит от доступности установщика. Нужен Node.js:

node -v
npm -v

Если команд нет, установите актуальную LTS-версию с официального сайта Node.js. Затем:

npm install -g @openai/codex

Проверьте:

codex --version

На macOS и Linux не запускайте установку через sudo, если можно этого избежать: так проще получить проблемы с правами в глобальной папке.

Установка на macOS через Homebrew

brew install --cask codex

Обновление:

brew upgrade --cask codex

Официальный установщик

На macOS и Linux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

На Windows в новом окне PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Адрес установщика находится на домене ChatGPT. Если загрузка из вашей сети не проходит, используйте npm.

Подробности для Windows, включая PATH и PowerShell, есть в статье Как установить Codex на Windows.

Настройка доступа из России

Установка не решает вопрос входа: OpenAI не поддерживает Россию. Codex умеет работать через своего провайдера, и аккаунт OpenAI тогда не нужен.

Получите ключ в AI для кода и добавьте в ~/.codex/config.toml:

model = "gpt-6-luna"
model_provider = "purpleschool"

[model_providers.purpleschool]
name = "PurpleSchool"
base_url = "https://app.purpleschool.ru/api-v2/public/ai-proxy/openai/v1"
env_key = "PURPLESCHOOL_API_KEY"
wire_api = "responses"

Сам ключ храните в переменной окружения. На macOS и Linux:

export PURPLESCHOOL_API_KEY="ваш ключ"

Чтобы переменная сохранилась, добавьте строку в ~/.zshrc или ~/.bashrc.

На Windows:

[Environment]::SetEnvironmentVariable("PURPLESCHOOL_API_KEY", "ваш ключ", "User")

Затем откройте новое окно терминала.

Проверка

codex exec --sandbox read-only "Ответь одним словом: ок" < /dev/null

Если пришёл ответ, настройка работает. Команду мы проверили на Codex CLI 0.167 через адрес PurpleSchool. Для общей диагностики есть встроенная команда:

codex doctor

Запустите агента в папке проекта:

cd ~/projects/my-app
codex

Частые проблемы

codex: command not found. Откройте новое окно терминала. Если не помогло, узнайте папку глобальных пакетов командой npm prefix -g и проверьте, что её подкаталог bin есть в PATH. На Windows исполняемые файлы лежат прямо в этой папке.

EACCES при установке. Не хватает прав на глобальную папку npm. Настройте папку в домашнем каталоге или используйте Homebrew.

Просит войти в аккаунт. Codex не видит настройки провайдера. Проверьте, что в config.toml есть model_provider.

401 или ошибка ключа. Переменная не задана в этом окне либо ключ скопирован неверно.

Команда зависает в скрипте. При неинтерактивном запуске codex exec может ждать stdin, поэтому добавьте < /dev/null.

Разбор других ошибок — в статье Codex не работает.

Частые вопросы

Codex бесплатный? Сама программа устанавливается бесплатно, а запросы к моделям оплачиваются. Новым аккаунтам с почтой из белого списка в AI для кода доступен пробный баланс на 7 дней.

Нужен ли VPN для скачивания? Для установки через npm обычно нет. Для работы с ключом PurpleSchool VPN тоже не нужен.

Как обновить Codex? Способом, которым вы его установили, либо командой codex update.

Можно ли использовать Codex без терминала? Да, через расширение редактора или приложение. Они используют те же настройки.

Итог

Для большинства случаев достаточно одной команды npm install -g @openai/codex. Из России добавьте своего провайдера в config.toml, задайте ключ и проверьте запуск. Получить ключ с оплатой в рублях можно в AI для кода от PurpleSchool.