Сайт возвращает ошибку 502. Вместо того чтобы копировать логи в чат-бот, вы просите ИИ-агента на сервере изучить нужные файлы и объяснить проблему. Это один из практических сценариев использования Codex CLI на Linux VPS.
В этом руководстве описаны установка, вход в аккаунт из SSH-сессии и первая задача с ограниченными правами. Затем мы объясняем реальный тест, лежащий в основе нашего видео: Codex определил несовпадение портов на специально сломанном демо-сайте.
Что и где работает: агент Codex и его инструменты командной строки работают на вашем VPS. При описанной здесь настройке с OpenAI ИИ-модель работает в облаке OpenAI. Вам понадобится собственный подходящий аккаунт ChatGPT или оплачиваемый отдельно доступ к API OpenAI. VPS SharpHeberg такой доступ не включает.
Прежде чем начать
- Linux VPS с доступом по SSH и исходящим доступом по HTTPS. Приведённые ниже команды для пакетов рассчитаны на Debian и Ubuntu.
- Обычный пользователь Linux с доступным sudo для установки системных пакетов. Запускайте Codex от имени этого пользователя, а не от root.
- Аккаунт OpenAI с доступом к Codex. Проверьте актуальную доступность и лимиты вашего тарифа; оплата API не зависит от подписки ChatGPT.
- Тестовый проект или staging-окружение. Держите учётные данные production и не относящиеся к делу файлы клиентов вне аккаунта и рабочей директории, доступных агенту.
Размещать веса модели или подключать GPU для этого облачного сценария не нужно. Ресурсы, которые потребляют ваши проекты, инструменты сборки и сервисы, всё равно важны при выборе VPS.
Область проверки: наша диагностическая демонстрация выполнялась на временном VPS с Debian 12 и Codex CLI 0.164.0. В этом изолированном эксперименте использовалась привилегированная диагностическая учётная запись; мы не рекомендуем такую настройку для production. Мы также проверили официальный автономный установщик в изолированной директории установки Linux x86-64 и убедились в версии CLI и параметрах входа и песочницы. Мы не тестировали все релизы Ubuntu и все конфигурации VPS.
1. Подключитесь к VPS
С вашего компьютера подключитесь через существующий SSH-аккаунт без root-прав. Замените пользователя и адрес из примера:
ssh youruser@YOUR_VPS_IP
Если на сервере есть только аккаунт root, сначала создайте и проверьте отдельный аккаунт по инструкции по администрированию вашей операционной системы. Не стоит давать ИИ-агенту root-оболочку лишь для того, чтобы начать.
В Debian или Ubuntu установите инструменты для загрузки и работы с проектами, которые используются в этом руководстве:
sudo apt update
sudo apt install ca-certificates curl git less
Эти команды устанавливают системные пакеты; они не обновляют весь сервер и не меняют настройки firewall.
2. Установите Codex CLI
OpenAI описывает автономный установщик для macOS и Linux, а также альтернативы через npm и Homebrew. Автономный способ не требует предварительной установки Node.js и npm. См. официальное руководство по установке Codex CLI.
Скачайте установщик в собственную директорию, чтобы изучить его перед запуском:
mkdir -p "$HOME/codex-setup"
curl -fsSL https://chatgpt.com/codex/install.sh -o "$HOME/codex-setup/install.sh"
less "$HOME/codex-setup/install.sh"
Нажмите q, чтобы выйти из less. Изучив скрипт, запустите его от имени обычного пользователя:
sh "$HOME/codex-setup/install.sh"
export PATH="$HOME/.local/bin:$PATH"
codex --version
codex --help
Официальный установщик по умолчанию использует ~/.local/bin и управляет своим автономным пакетом в пользовательской директории Codex. Он может изменить файл запуска вашей оболочки. Откройте терминал заново, когда будет предложено; команда export выше также делает путь установки по умолчанию доступным в текущей сессии.
Если короткий URL для загрузки не работает: исходный код установщика также доступен в официальном репозитории OpenAI Codex. Скачайте этот код, изучите его и затем выполните те же шаги установки:
curl -fsSL https://raw.githubusercontent.com/openai/codex/main/scripts/install/install.sh -o "$HOME/codex-setup/install.sh"
less "$HOME/codex-setup/install.sh"
sh "$HOME/codex-setup/install.sh"
Не заменяйте его скриптом с неизвестного зеркала. Если не удаётся скачать сам бинарный файл, OpenAI описывает переменную CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false для выбора GitHub Releases:
CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh "$HOME/codex-setup/install.sh"
Если у вас уже есть поддерживаемая установка Node.js/npm, описанная в документации альтернатива через npm — команда npm install -g @openai/codex. Выберите один способ установки, а не смешивайте несколько, а потом гадайте, какой codex оказался в PATH.
3. Войдите в аккаунт на сервере без графического интерфейса
На вашем VPS обычно нет браузера с рабочим столом. В такой ситуации OpenAI рекомендует аутентификацию по коду устройства:
codex login --device-auth
Перейдите по ссылке, показанной в терминале, на своём компьютере или телефоне, войдите в аккаунт и введите одноразовый код. Возможно, сначала вам придётся включить вход по коду устройства в настройках безопасности ChatGPT или попросить администратора рабочего пространства разрешить его. Никогда не передавайте этот код другим.
Затем проверьте способ аутентификации:
codex login status
Если вход по коду устройства недоступен, OpenAI также описывает SSH-туннель для обычного входа через браузер. Запустите это соединение со своего компьютера:
ssh -L 1455:localhost:1455 youruser@YOUR_VPS_IP
Внутри этой SSH-сессии выполните codex login и откройте ссылку для входа в локальном браузере. Так обратный вызов на localhost перенаправляется без публичного открытия порта аутентификации. Если в вашей среде используется другая конфигурация обратного вызова, обратитесь к инструкции OpenAI по входу на устройствах без интерфейса.
Использование API-ключа вместо входа
Если вы предпочитаете доступ к API с оплатой по использованию, безопасно задайте собственный API-ключ OpenAI в переменной окружения, а затем передайте его через стандартный ввод:
printenv OPENAI_API_KEY | codex login --with-api-key
Не вставляйте API-ключ в явном виде в команду, которая сохранится в истории оболочки. Использование API оплачивается через ваш аккаунт OpenAI Platform и не вычитается из счёта за хостинг VPS. Относитесь к сохранённым учётным данным Codex как к паролям и не размещайте их в репозиториях, скриншотах и обращениях в поддержку. Оба способа объясняет официальное руководство по аутентификации.
4. Начните с задачи только для чтения
Перейдите в тестовый проект, файлы которого вам понятны. Если такого проекта нет, достаточно пустой директории, чтобы открыть CLI и изучить интерфейс:
mkdir -p "$HOME/codex-first-session"
cd "$HOME/codex-first-session"
codex --sandbox read-only --ask-for-approval on-request
В реальном тестовом репозитории хороший первый запрос такой:
Explain how this project starts. Read the relevant configuration and README files, identify the entry point, and list anything you cannot verify. Do not change files or install packages.
read-only ограничивает команды, генерируемые моделью, через настроенную песочницу. on-request позволяет модели запрашивать дополнительное подтверждение; это не значит, что каждая команда автоматически требует подтверждения. Прочитайте запрос на расширение прав, прежде чем решать, разрешать ли его.
Просьба «ничего не меняй» сама по себе не является границей безопасности. Используйте отдельный аккаунт и тестовое окружение, ограничьте доступные данные и проверьте права, показываемые вашей установленной версией. Доступ только на чтение всё равно может открыть содержимое читаемых файлов сервису модели.
Проверьте codex --help и справочник по командам CLI, прежде чем копировать флаги из устаревшего руководства. Не обходите песочницу и подтверждения, чтобы справиться с ошибкой установки.
5. От объяснения к полезной задаче на сервере
Разумный следующий шаг — дать Codex небольшую, чётко очерченную диагностическую область. Подготовьте очищенные копии нужных логов и конфигурации в тестовой директории, а затем попросите:
This demo site returns HTTP 502. Inspect only the supplied nginx configuration, application entry point and error log. Explain the cause and propose the smallest fix. Do not edit files, install packages or restart services.
Проверьте предложенное изменение, прежде чем применять его самостоятельно. Для реального сервиса сделайте резервную копию конфигурации, проверьте её штатной проверкой сервиса и подготовьте откат. Объяснение от ИИ не доказывает, что изменение безопасно для production.
Что произошло в нашей демонстрации
Мы намеренно сломали настройки демо-сайта на временном VPS. Nginx перенаправлял запросы на порт 3000, тогда как приложение слушало порт 3001. Сайт возвращал HTTP 502.
Codex изучил выбранные конфигурацию, приложение и лог ошибок в режиме только для чтения. Он определил несовпадение и примерно за 22 секунды предложил исправление в одну строку, не изменяя предоставленные файлы. Наш оператор применил это предложение, проверил конфигурацию nginx, перезагрузил сервис и убедился, что возвращается ответ HTTP 200.
Это был один контролируемый тест с известной, намеренно внесённой неисправностью. Это не бенчмарк, не гарантия времени починки и не демонстрация автономного восстановления в production.
Если что-то не работает
codex: command not found: откройте терминал заново, проверьтеcommand -v codexи убедитесь, что директория установщика есть в PATH.- URL установщика или загрузка заблокированы: используйте исходный код из официального репозитория и описанный выше выбор GitHub Releases. Не отключайте проверку TLS.
- Вход не может открыть браузер: используйте вход по коду устройства или описанный SSH-туннель. Не открывайте публично порты аутентификации на localhost.
- Вы достигли лимита использования: проверьте аккаунт и способ аутентификации, показанные в
codex login status. Установка CLI или покупка VPS не снимает лимиты использования OpenAI. - Ошибки песочницы или вспомогательных компонентов: сохраните установку официального пакета целиком и проверьте поддержку вашим дистрибутивом необходимых механизмов изоляции. В контейнере или на ограниченном VPS могут быть дополнительные ограничения. Не решайте проблему запуском Codex от root или отключением его защитных механизмов.
Посмотрите демонстрацию, затем попробуйте на своём VPS
Наше сопровождающее видео показывает диагностический пример от сломанного сайта до проверенного ответа. Оно демонстрирует, в чём может помочь установленный агент; команды установки приведены в этом руководстве.
Контролируемая демонстрация на временном тестовом VPS: Codex предлагает исправление, наш оператор применяет и проверяет его. Смотреть демонстрацию на YouTube.
Начните с тестового проекта, ограничьте права агента и проверяйте каждый результат. Если для этого рабочего пространства вам нужен сервер, ознакомьтесь с тарифами Linux VPS от SharpHeberg. Ваш аккаунт OpenAI и его использование остаются отдельными от услуги хостинга.