Codex Linux: установка приложения и CLI в 2026 году

Codex на Linux ставится двумя способами. На рабочем столе Ubuntu, Debian, Fedora или Arch установите приложение ChatGPT с Codex: в нём удобно работать с задачами и файлами в окне. Для терминала и сервера поставьте Codex CLI командой curl -fsSL https://chatgpt.com/codex/install.sh | sh или npm install -g @openai/codex.

Приложение ChatGPT с Codex доступно для Ubuntu 24.04/26.04 LTS, Debian 13, Fedora 43/44 и актуального, полностью обновлённого Arch Linux, со сборками x64 и ARM64. Для Ubuntu/Debian скачайте .deb и выполните sudo apt install ./chatgpt_amd64.deb, для Fedora скачайте .rpm и выполните sudo dnf install ./chatgpt.x86_64.rpm; на Arch нужен официальный скрипт установки. Эти команды установки пакетов приведены для x64; для ARM64 выберите файл своей архитектуры.

Перед работой в CLI установите пакет bubblewrap для песочницы Linux: запуск команды codex ещё не означает, что изоляция команд настроена. Для входа из России понадобится VPN или прокси на машине, где работает Codex; на сервере его нужно настроить отдельно от браузера телефона.

По тарифам OpenAI на Free за 0 $ и Go за 8 $/мес Codex доступен только в приложении для компьютера с GPT-6 Luna, причём доступ открывается постепенно. CLI входит в Plus за 20 $/мес и тарифы выше. Ещё один вариант для CLI: вход по API-ключу с оплатой использования по ценам API.

Какой вариант Codex выбрать на Linux

На поддерживаемом Linux-компьютере начинайте с приложения. Для терминала, SSH-сервера, скриптов или дистрибутива вне списка приложения выбирайте CLI. Если вы работаете в другой системе или IDE, используйте инструкцию установки Codex для вашей среды.

• Десктопное приложение: подходит для визуальной работы с задачами и файлами без постоянных команд в терминале.
• Codex CLI: подходит для локального терминала, удалённого сервера и работы внутри каталога проекта.
• Готовый бинарный файл: запасной путь, если вы не хотите ставить Node.js и npm, но готовы вручную выбрать сборку под архитектуру.

Сначала выбирайте форм-фактор, затем пакет. Ошибка в этом порядке часто приводит к установке неподходящей сборки или к попытке запустить графическое приложение на сервере без рабочего стола.

Проверьте дистрибутив и архитектуру

Перед скачиванием выполните две команды: cat /etc/os-release покажет название и версию системы, а uname -m покажет архитектуру. В официальной инструкции приложения для Linux OpenAI расшифровывает результат так: x86_64 означает x64, а aarch64 или arm64 означает ARM64. Не определяйте архитектуру по марке ноутбука или сервера на глаз.

Приложение официально поддерживает Ubuntu 24.04 LTS и 26.04 LTS, Debian 13, Fedora 43 и 44, а также актуальный, полностью обновлённый Arch Linux. Ubuntu и Debian используют .deb, Fedora использует .rpm, Arch устанавливается скриптом. На других дистрибутивах приложение может работать, но официальной поддержки нет, поэтому там выбирайте CLI.

Для CLI в системных требованиях указаны Ubuntu 20.04+ или Debian 10+, минимум 4 ГБ оперативной памяти, рекомендуется 8 ГБ; Git 2.23+ необязателен.

По теме: Codex и GLM: подключение Z.AI и проверка провайдера

Установите и обновляйте приложение ChatGPT

Скачайте пакет своей архитектуры с официальной страницы OpenAI или по прямым ссылкам ниже. Перейдите в каталог загрузок командой cd ~/Downloads и установите пакет: sudo apt install ./chatgpt_amd64.deb на Ubuntu/Debian или sudo dnf install ./chatgpt.x86_64.rpm на Fedora. На ARM64 подставьте в команду имя своего файла из списка.

• Для Ubuntu/Debian на x64 скачайте chatgpt_amd64.deb.
• Для Ubuntu/Debian на ARM64 скачайте chatgpt_arm64.deb.
• Для Fedora на x64 скачайте chatgpt.x86_64.rpm.
• Для Fedora на ARM64 скачайте chatgpt.aarch64.rpm.

На Arch Linux официальный скрипт определяет архитектуру, подключает подписанный репозиторий OpenAI и устанавливает ChatGPT. Во время установки он выполняет полное обновление системы и запрашивает подтверждение, поэтому запускайте его, когда готовы обновить и остальные пакеты:

curl --proto '=https' --tlsv1.2 -fL -o install-arch.sh \
  https://persistent.oaistatic.com/codex-app-prod/linux/install-arch.sh
sudo bash install-arch.sh

Запустите приложение из меню или командой chatgpt, войдите и откройте Codex. Установка подключает подписанный репозиторий OpenAI, и дальнейшие обновления приложения выполняются менеджером пакетов вашей системы:

• На Ubuntu/Debian выполните sudo apt update && sudo apt install --only-upgrade chatgpt.
• На Fedora выполните sudo dnf upgrade --refresh chatgpt.
• На Arch Linux выполните sudo pacman -Syu; приложение обновляется вместе с системой.

В предварительной версии приложения для Linux пока нет Computer Use. Нативный Wayland-режим экспериментальный: в сессии Wayland приложение по умолчанию использует XWayland, если он доступен. Для нативного запуска полностью закройте приложение и выполните chatgpt --ozone-platform=wayland. В этом режиме могут не работать плавающие окна, позиционирование, фокус и горячие клавиши, поэтому смена режима не гарантирует исправления проблем с окном.

Установите Codex CLI

Для терминала OpenAI предлагает отдельный установщик: curl -fsSL https://chatgpt.com/codex/install.sh | sh. Сверьте её с документацией Codex CLI и выполните от своего пользователя, без sudo; та же команда обновляет CLI. Если политика запрещает запуск загруженного скрипта через канал, сначала сохраните и изучите его. Не берите команды из случайных репозиториев.

Установщик размещает codex в ~/.local/bin; каталог можно изменить переменной CODEX_INSTALL_DIR. Если каталога нет в PATH, скрипт добавляет строку в ~/.bashrc для bash, ~/.zshrc для zsh или ~/.profile для других оболочек. При обнаружении установки через npm или Homebrew он предупреждает о порядке PATH и предлагает удалить старую копию, поскольку запускаться будет та программа, чей каталог указан раньше.

Если у вас уже настроен Node.js 16 или выше, используйте альтернативу: npm install -g @openai/codex. Именно такое минимальное требование к Node.js указано у пакета в npm. Не смешивайте установщик, npm и ручной бинарный файл: порядок каталогов в PATH может выбрать старую копию.

Пакет @openai/codex выпускается в репозитории OpenAI. На 07.10.2026 актуальна версия CLI 0.160.1 от 5 октября; у пакета npm та же версия. После установки сравните её с выводом codex --version, чтобы понимать, какой экземпляр CLI запускается на вашей машине.

В GitHub Releases есть codex-x86_64-unknown-linux-musl.tar.gz для x86_64 и codex-aarch64-unknown-linux-musl.tar.gz для ARM64. По README OpenAI Codex в архиве один файл с платформой в имени, например codex-x86_64-unknown-linux-musl: после распаковки переименуйте его в codex, сделайте исполняемым и поместите в каталог из PATH, например ~/.local/bin. Для x86_64 это команды curl -LO https://github.com/openai/codex/releases/latest/download/codex-x86_64-unknown-linux-musl.tar.gz, tar -xzf codex-x86_64-unknown-linux-musl.tar.gz и install -Dm755 codex-x86_64-unknown-linux-musl ~/.local/bin/codex. Если после этого command -v codex ничего не находит, добавьте в ~/.bashrc строку export PATH="$HOME/.local/bin:$PATH" и откройте новый терминал.

В таком одиночном архиве нет помощника bwrap. Полный пакет установщика содержит его в codex-resources/bwrap, что отражено в исходнике установщика. Если выбрали ручной бинарный файл, установите системный пакет bubblewrap, прежде чем проверять запуск команд в песочнице.

По теме: Codex Micro: что это за контроллер и как его настроить

Проверьте установку до входа

Выполните command -v codex: команда должна вернуть путь к файлу. Затем запустите codex --version и codex --help. Эти проверки подтверждают только, что CLI найден и запускается; песочницу проверьте отдельно перед работой. После запуска используйте команды и режимы Codex CLI, которые нужны для вашей задачи.

1. Сравните вывод uname -m с архитектурой установленного пакета или бинарного файла.
2. Убедитесь, что command -v codex показывает ожидаемый путь, а не старую копию.
3. Проверьте версию и справку без sudo.
4. Только после этого открывайте каталог проекта и входите в аккаунт.

Настройте песочницу CLI на Linux

На Linux CLI изолирует команды через bwrap (bubblewrap) и seccomp. Начните с установки пакета: sudo apt install bubblewrap для Ubuntu/Debian или sudo dnf install bubblewrap для Fedora. По инструкции песочницы Codex берёт первый bwrap из PATH, а при его отсутствии обращается к встроенному помощнику, которому нужны разрешённые непривилегированные user namespaces. Если bwrap отсутствует или не может создать нужное пространство имён пользователя, при запуске появится предупреждение.

На Ubuntu 24.04 предупреждение о user namespace может остаться даже после установки bubblewrap. Сначала установите и загрузите профиль AppArmor для bwrap, чтобы разрешить нужную операцию без снятия ограничения для всей системы:

sudo apt update
sudo apt install apparmor-profiles apparmor-utils
sudo install -m 0644 \
  /usr/share/apparmor/extra-profiles/bwrap-userns-restrict \
  /etc/apparmor.d/bwrap-userns-restrict
sudo apparmor_parser -r /etc/apparmor.d/bwrap-userns-restrict

Если профиль не помог, документация OpenAI допускает крайний вариант: sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0. Команда снимает ограничение глобально, поэтому применяйте её только после попытки с профилем. На Ubuntu 25.04 профиль bwrap-userns-restrict уже входит в пакет apparmor.

Для проверки песочницы выполните codex sandbox linux [COMMAND]..., например codex sandbox linux ls. WSL2 использует обычный Linux-путь. WSL1 поддерживался до Codex 0.114 включительно; начиная с 0.115 песочница перешла на bwrap, и WSL1 больше не поддерживается.

В Docker песочница может не работать, если хост или контейнер блокирует namespaces, setuid bwrap или seccomp. Тогда рекомендация OpenAI состоит в том, чтобы обеспечить изоляцию самим контейнером и запускать внутри codex --sandbox danger-full-access. Используйте такой вариант только с доверенными репозиториями: агенту будет доступно всё внутри контейнера, включая токены Codex.

По теме: Codex harness: что это и когда он нужен

Установка и вход из России

Из России можно скачать CLI через npm или архив GitHub Releases, а приложение через прямые ссылки на пакеты выше. На 07.10.2026 с российского IP адрес https://chatgpt.com/codex/install.sh и загрузки с https://releases.openai.com/codex/... отвечают ошибкой 403. При этом registry.npmjs.org, архив CLI на GitHub и пакеты приложения с persistent.oaistatic.com отвечают 200/206. Для официального установщика нужен VPN; без него выбирайте npm install -g @openai/codex или ручную установку архива.

Для входа и работы нужен IP поддерживаемой страны; России в списке нет. При запросе кода устройства с российского IP auth.openai.com возвращает unsupported_country_region_territory, поэтому смена способа входа сама по себе проблему не решает.

VPN или прокси должен работать на машине, где запущен codex: код устройства запрашивает сам CLI. Если сервер находится в России, VPN только в браузере телефона не поможет, даже когда страница подтверждения на телефоне открывается. На рабочем столе используйте VPN-клиент в режиме TUN, который направляет весь трафик системы, включая приложение и терминал, через выбранный узел; на сервере подойдёт системный VPN или VPS в поддерживаемой стране.

Для прокси поддерживаемой страны задайте HTTPS_PROXY, HTTP_PROXY и NO_PROXY в ~/.bashrc или ~/.codex/.env. Codex читает файл окружения при каждом запуске, и значения из него перекрывают переменные терминала. При смене прокси учитывайте оба места настройки. Используйте настройку прокси для Codex или доступ к Codex через VPN. Держите один стабильный узел одной страны и не меняйте страну во время входа.

Войдите локально или на сервере без браузера

На компьютере запустите codex и выберите вход через ChatGPT. Для SSH-сервера документация авторизации рекомендует codex login --device-auth или пункт Sign in with Device Code в меню входа: адрес и код появятся в терминале, подтверждение выполняется в браузере другого устройства. Это бета-функция: включите её в настройках безопасности личного аккаунта ChatGPT либо попросите администратора разрешить её в правах рабочего пространства.

Если device code недоступен, используйте проброс порта по SSH: на своём компьютере выполните ssh -L 1455:localhost:1455 user@remote, в открывшейся сессии запустите codex login, затем откройте выданный адрес в браузере своего компьютера. Ещё один запасной путь: войдите на машине с браузером и скопируйте ~/.codex/auth.json на свой сервер в ~/.codex/auth.json, например через scp; это работает только при файловом хранении.

Настройка cli_auth_credentials_store в ~/.codex/config.toml задаёт место хранения токенов и принимает file, keyring, auto или ephemeral. При file данные попадают в auth.json внутри CODEX_HOME, по умолчанию ~/.codex. При системном хранилище файла ~/.codex/auth.json может не быть. Обращайтесь с ним как с паролем: не добавляйте в Git, не отправляйте в чат и не передавайте другим людям. Если вход не проходит, проверьте разрешение на device auth и повторите команду; содержимое файла для диагностики не публикуйте.

Сделайте безопасный первый запуск

Откройте копию проекта, выполните git status и сохраните текущие изменения. Запустите codex из корня и сначала попросите только объяснить структуру и предложить план. Руководство CLI рекомендует Git-контрольные точки до и после задачи, чтобы сравнить или вернуть изменения.

• /status показывает текущую конфигурацию и расход контекста.
• /permissions помогает выбрать, какие действия агент может выполнять без дополнительного подтверждения.
• /review запускает просмотр изменений до того, как вы примете результат.
• Первую запись разрешайте только после того, как путь проекта и список файлов совпали с ожиданиями.

Перед первой задачей убедитесь, что Codex запускается без sudo из каталога проекта. В обычном режиме песочницы запись ограничена активным каталогом проекта, сеть для команд по умолчанию выключена. Читать агент может всю файловую систему в пределах прав пользователя: такую область чтения задаёт политика доступа CLI. Вход не должен требовать передачи токена другому человеку, а первая задача должна завершиться понятным списком прочитанных или изменённых файлов. Если одно из этих условий не выполнено, сначала исправьте окружение.

Диагностика частых ошибок Linux

При codex: command not found повторите command -v codex, откройте новый терминал и проверьте, добавил ли выбранный установщик каталог в PATH. При npm-установке сравните путь глобальных бинарных файлов npm с PATH. Не переустанавливайте программу несколькими способами подряд.

При Exec format error сначала сверьте архитектуру: x86_64-бинарный файл не запустится как ARM64-программа и наоборот. Удалите только ошибочно скачанный файл и поставьте сборку под архитектуру из uname -m.

Если приложение не устанавливается, сравните дистрибутив, версию и формат пакета с официальным списком. Не пытайтесь ставить .rpm через apt или .deb через dnf. Для системы без официальной поддержки приложения выбирайте CLI; неофициальную перепаковку не используйте.

Если вход зависает на удалённом сервере, прервите браузерный сценарий и используйте codex login --device-auth. Когда способ недоступен, проверьте настройки аккаунта или рабочей области; запасные пути в инструкции входа используют SSH-проброс порта либо перенос своего ~/.codex/auth.json. При unsupported_country_region_territory проверьте VPN или прокси именно на сервере. Если сообщение другое, найдите его среди ошибок Codex и способов исправления.

При обновлении CLI со старой конфигурацией отключите настройку features.use_legacy_landlock, если она включена: Linux-песочница использует bubblewrap и отклоняет прежний режим Landlock для политик с ограничением доступа к файлам.

Если внешние скрипты или установка запрещены

Если организация запрещает внешние скрипты, используйте согласованный npm-пакет или бинарный файл из официального GitHub Releases. Без прав на установку попросите администратора подготовить окружение.

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

Есть ли официальное приложение Codex для Linux?

Да. Codex доступен внутри предварительной версии приложения ChatGPT для поддерживаемых дистрибутивов Linux, включая актуальный, полностью обновлённый Arch Linux. Для терминала существует отдельный Codex CLI.

Что выбрать для Ubuntu: приложение или CLI?

Для обычного рабочего стола на поддерживаемой версии начните с приложения. Для SSH, скриптов и работы исключительно в терминале выбирайте CLI.

Нужен ли Node.js?

Не обязательно. Официальный Linux-установщик и готовый бинарный файл не требуют установки через npm. Node.js нужен именно для варианта npm install -g @openai/codex.

Можно ли войти в Codex на сервере без браузера?

Да, используйте codex login --device-auth, если этот бета-способ разрешён для вашего аккаунта или рабочей области.

Почему нельзя запускать Codex через sudo?

Для обычной работы права администратора не нужны и расширяют область возможных изменений. Сам codex запускайте без sudo. Права администратора используйте для описанных шагов установки приложения и настройки песочницы, где они требуются.