На Linux у Codex два форм-фактора. Для рабочего компьютера проще официальное приложение ChatGPT с Codex. Для терминала, сервера без графики и автоматизации нужен Codex CLI. Ниже именно Linux-путь: архитектура процессора, пакеты, вход по SSH и диагностика.
Какой вариант 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. Не определяйте архитектуру по марке ноутбука или сервера на глаз.
Для приложения OpenAI сейчас указывает Ubuntu 24.04 LTS и 26.04 LTS, Debian 13, Fedora 43 и 44. Ubuntu и Debian используют .deb, Fedora использует .rpm; есть сборки x64 и ARM64. Для другого дистрибутива выбирайте CLI. Перед скачиванием повторно сверяйтесь со страницей Linux-приложения.
Установка это ещё не результат, интереснее другое: что на этом собрать. На бесплатном вебинаре первый проект доводят от идеи до работающей страницы.
Собрать первый проектКороткий путь: установите приложение ChatGPT
Скачайте пакет только с официальной страницы OpenAI. Для Ubuntu или Debian установите подходящий .deb: sudo apt install ./chatgpt_amd64.deb; ARM64-файл называется chatgpt_arm64.deb. Для Fedora официальный пример: sudo dnf install ./chatgpt.x86_64.rpm, ARM64-файл называется chatgpt.aarch64.rpm. Команды приведены в документации OpenAI.
Запустите приложение из меню или командой chatgpt, войдите и откройте Codex. Обновления приходят через подписанный репозиторий OpenAI. В Linux preview пока нет Computer Use, а нативный Wayland-режим экспериментальный. При проблемах с окном попробуйте официальный запуск chatgpt --ozone-platform=wayland.
По теме: Кредиты Codex: как считаются и когда нужны в 2026
Подробный путь: установите Codex CLI
Для терминала OpenAI предлагает отдельный установщик. Откройте документацию Codex CLI, скопируйте актуальную команду через curl и выполните от своего пользователя. Если политика запрещает запуск загруженного скрипта через канал, сначала сохраните и изучите его. Не берите команды из случайных репозиториев.
Если Node.js уже настроен, альтернатива: npm install -g @openai/codex. Официальность пакета подтверждают npm и репозиторий OpenAI. Не смешивайте установщик, npm и ручной бинарный файл: порядок каталогов в PATH может выбрать старую копию.
В GitHub Releases есть codex-x86_64-unknown-linux-musl.tar.gz для x86_64 и codex-aarch64-unknown-linux-musl.tar.gz для ARM64. Имена перечислены в README OpenAI Codex. Этот путь требует ручной настройки исполняемого файла и PATH.
Проверьте установку до входа
Диагностика должна идти от простого к сложному. Сначала выполните command -v codex: команда должна вернуть путь к файлу. Затем запустите codex --version и codex --help. Если все три проверки проходят, установка исправна и можно переходить к авторизации. Подробный справочник по режимам после запуска есть в материале Codex CLI: команды и режимы.
- Сравните вывод
uname -mс архитектурой установленного пакета или бинарного файла. - Убедитесь, что
command -v codexпоказывает ожидаемый путь, а не старую копию. - Проверьте версию и справку без
sudo. - Только после этого открывайте каталог проекта и входите в аккаунт.
Настроенный инструмент сам ничего не создаёт: результат появляется на первом доведённом до конца проекте. На бесплатном вебинаре по вайбкодингу проходят весь путь, от запроса к ИИ до опубликованного сайта или бота.
Пройти весь путьВойдите локально или на сервере без браузера
На компьютере запустите codex и выберите вход через ChatGPT. Для SSH-сервера официальная документация авторизации рекомендует codex login --device-auth: адрес и код появятся в терминале, подтверждение выполняется в браузере другого устройства. Бета-функция должна быть разрешена в настройках безопасности аккаунта или рабочей области.
При файловом хранении ~/.codex/auth.json содержит токены доступа; при системном хранилище этого файла может не быть. OpenAI прямо советует относиться к нему как к паролю: не добавлять в Git, не отправлять в чат и не переносить между людьми. Если вход не проходит, сначала проверьте, разрешён ли device auth для аккаунта, затем повторите команду. Не публикуйте содержимое файла ради диагностики.
По теме: Codex Chrome: как подключить расширение и проверить доступ
Сделайте безопасный первый запуск
Откройте копию проекта, выполните git status и сохраните текущие изменения. Запустите codex из корня и сначала попросите только объяснить структуру и предложить план. Руководство CLI рекомендует Git-контрольные точки до и после задачи, чтобы сравнить или вернуть изменения.
/statusпоказывает текущую конфигурацию и расход контекста./permissionsпомогает выбрать, какие действия агент может выполнять без дополнительного подтверждения./reviewзапускает просмотр изменений до того, как вы примете результат.- Первую запись разрешайте только после того, как путь проекта и список файлов совпали с ожиданиями.
Критерий готовности: Codex запускается без sudo, видит только нужный проект, авторизация не требует передачи токена, а первая задача завершается понятным списком прочитанных или изменённых файлов. Если один пункт не выполнен, сначала исправьте окружение.
Диагностика частых ошибок 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. Если способ недоступен, это может быть ограничение настроек аккаунта или рабочей области, а не проблема Linux. Ещё несколько общих сценариев собраны в статье ошибки Codex и способы исправления.
По теме: Codex 5.4: что это за модель и доступна ли она сейчас
Когда этот способ не подходит
Не ставьте приложение на сервер без рабочего стола: там нужен CLI. Не используйте пакет приложения на дистрибутиве вне текущего списка OpenAI. Если организация запрещает внешние скрипты, выберите согласованный npm-пакет или бинарный файл из официального GitHub Releases. Без прав на установку попросите администратора подготовить окружение.
Частые вопросы
Есть ли официальное приложение Codex для Linux?
Да. Codex доступен внутри предварительной версии приложения ChatGPT для перечисленных OpenAI дистрибутивов 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?
Для обычной работы права администратора не нужны и расширяют область возможных изменений. sudo используйте только там, где его явно требует системный менеджер пакетов при установке приложения.
Установили Codex на Linux и хотите перейти от проверки окружения к своему сайту, боту или приложению? На бесплатном вебинаре показываем понятный путь от идеи до рабочего проекта с ИИ-агентами.
Записаться на вебинар