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

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

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

Codex CLI ставится четырьмя способами: скриптом (curl на macOS и Linux, PowerShell на Windows), через npm, через Homebrew или готовым архивом из GitHub Releases. Результат один: команда codex. Работать с Relay она начнёт после того, как в пользовательском config.toml появится провайдер с вашим ключом.

Коротко

  • Скрипт ставит и обновляет Codex на macOS, Linux и Windows.

  • npm подходит, если Node.js уже есть. Архив нужен CI и закрытым сетям.

  • Вход через ChatGPT необязателен: Codex принимает ключ API, а провайдер Relay описывается в ~/.codex/config.toml.

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

СпособГде работаетКогда брать
Скрипт-установщикmacOS, Linux, Windowsпо умолчанию, он же обновляет
npmвсюду, где есть Node.jsnpm уже часть вашей среды
Homebrewгде установлен brewвсё остальное вы ведёте через brew
Архив из GitHub ReleasesmacOS (arm64, x86_64), Linux (x86_64, arm64)CI, контейнеры, сети без доступа к скрипту

Я брал бы скрипт и менял его на другой способ только по делу: на машине единый менеджер пакетов или нужна установка без запуска чужого скрипта. Все команды ниже взяты из README репозитория openai/codex и справочника OpenAI на 14 октября 2026.

Установка на macOS и Linux

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

Для Homebrew это cask, а не формула:

bash
brew install --cask codex

Через npm:

bash
npm install -g @openai/codex

Версия Node.js для npm в описании установки не названа. Её видно в реестре: у пакета @openai/codex версии 0.162.1 в поле engines указано node >=16. Если npm install падает с синтаксической ошибкой, начните с node --version.

Установка на Windows

В README для Windows дана такая команда, её копируют целиком вместе с -ExecutionPolicy ByPass:

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

Пакет npm выкладывается и под Windows, поэтому npm install -g @openai/codex работает и в PowerShell. Здесь встречается своя ловушка: если PowerShell отвечает running scripts is disabled on this system, политика выполнения блокирует .ps1-оболочки, которые создаёт npm. Разрешите локальные скрипты для своего пользователя командой Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser или вызывайте npm.cmd.

Архив без скрипта

Для CI и контейнеров на странице релизов лежат архивы с одним исполняемым файлом: codex-aarch64-apple-darwin.tar.gz и codex-x86_64-apple-darwin.tar.gz для macOS, codex-x86_64-unknown-linux-musl.tar.gz и codex-aarch64-unknown-linux-musl.tar.gz для Linux. После распаковки файл переименовывают в codex и кладут в каталог из PATH. Архива под Windows в README нет, там используют скрипт или npm.

Скрипты по умолчанию скачивают сборки с releases.openai.com/codex и при сбое переходят на GitHub Releases. Принудительно взять GitHub можно переменной CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false.

Первый запуск: ChatGPT или ключ

При первом запуске codex предлагает войти через ChatGPT. По README это основной путь для тарифов Plus, Pro, Business, Edu и Enterprise. Ключ API тоже поддерживается: ключ OpenAI тарифицируется по стандартным ценам API, а не по тарифу ChatGPT. Часть возможностей, завязанных на рабочее пространство ChatGPT и облачные сервисы, с ключом ограничена или недоступна.

Войти по ключу и проверить режим можно так:

bash
printenv OPENAI_API_KEY | codex login --with-api-key
codex login status

Для Relay вход не нужен. Достаточно описать провайдера в пользовательском ~/.codex/config.toml: base_url с /v1, env_key = "RELAY_API_KEY" и wire_api = "responses". Проектный .codex/config.toml провайдеров не читает. Ключ выпускается по инструкции как получить API-ключ Claude: шаги для кабинета те же, модель выбирается позже. Готовый конфиг и ограничения Responses API я не повторяю здесь, они разобраны в статье Codex CLI через Relay, на странице интеграции и в описании Responses API. Выбор между Codex, Cursor и Claude Code описан в сравнении.

Как убедиться, что установка удалась

Установка считается успешной, когда оболочка находит команду. На macOS и Linux это command -v codex, в PowerShell Get-Command codex: обе печатают путь к файлу. Затем запустите codex login status. До настройки провайдера она показывает, как Codex авторизован сейчас.

После того как провайдер Relay описан в config.toml, проверка другая: codex exec "ping" возвращает ответ модели, а запись о запросе появляется в журнале кабинета. Запускайте команду в каталоге Git-репозитория. Для разовой пустой папки добавьте флаг --skip-git-repo-check, он разрешает работу вне репозитория. Страница интеграции Relay сверена с Codex CLI версии 0.159.3, а в реестре npm на 14 октября 2026 лежит 0.162.1. Если после обновления изменилось поведение конфига, сверяйтесь со справочником конфигурации OpenAI и страницей интеграции.

Типичные ошибки после установки

СимптомПричинаЧто сделать
codex: command not foundокно терминала открыто до установки и не видит свежий PATHоткройте новое окно или выполните source ~/.zshrc
EACCES при npm install -gглобальный каталог npm принадлежит системене используйте sudo, задайте префикс в домашней папке: npm config set prefix ~/.npm-global и добавьте ~/.npm-global/bin в PATH
running scripts is disabled on this systemполитика выполнения PowerShell блокирует оболочки npmSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser или npm.cmd
Codex просит вход в ChatGPT, хотя ключ готовв config.toml не выбран model_provider, и Codex работает со встроенным openaiзадайте model_provider и поместите блок в пользовательский файл
Шлюз отвечает 401 с кодом invalid_api_keyпеременная из env_key не задана в оболочке, из которой запущен codexэкспортируйте её в том же окне и проверьте ключ запросом GET /v1/key

Обновление

Скрипт-установщик обновляет повторным запуском той же команды. Команда codex update проверяет и применяет обновление, если установленный релиз поддерживает самообновление. Для Homebrew и npm остаются их штатные команды.

Нужен ли аккаунт ChatGPT, чтобы пользоваться Codex CLI?

Нет. Вход через ChatGPT рекомендован в README, но ключ API тоже поддерживается. Через Relay Codex работает с ключом кабинета, а ChatGPT при этом не нужен.

Чем отличаются codex и codex exec?

codex открывает интерактивный терминальный интерфейс. codex exec (псевдоним codex e) выполняет задачу без диалога и подходит для скриптов. Для проверки подключения хватает codex exec "ping" в каталоге Git-репозитория.

Что делает команда codex app?

Она запускает десктопное приложение ChatGPT из терминала на macOS и Windows. Для работы CLI через Relay это приложение не нужно.

Источники

Команды установки сверены с README репозитория openai/codex, справочник команд и режимы входа с документацией Codex CLI reference и Authentication на 14 октября 2026. Требование к Node.js взято из метаданных пакета в реестре npm на ту же дату.

Создать аккаунт и ключ

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