Как подключить Codex на Windows к своему VPS по SSH

Что потребуется

Подготовьте компьютер с Windows, настольное приложение ChatGPT с режимом Codex и вкладкой SSH, VPS с Debian, адрес VPS, имя пользователя и действующий SSH-порт. Задание вы пишете в чате удалённого проекта в приложении Windows. Агент выполняет команды на подключённом VPS и возвращает результат в этот чат.

Здесь все адреса и примеры вывода условные. Заменяйте ПОРТ действующим SSH-портом, а IP_СЕРВЕРА — адресом своего VPS. Названия пунктов приложения могут немного отличаться между версиями.

Первый вход из Windows

Откройте PowerShell и проверьте, установлен ли SSH-клиент:

ssh -V

Ожидается строка с версией OpenSSH. Если команда не найдена, включите компонент «Клиент OpenSSH» в дополнительных компонентах Windows. Затем подключитесь:

ssh -p ПОРТ root@IP_СЕРВЕРА

При первом соединении сверьте отпечаток ключа сервера с доверенным источником: например, через консоль VPS у провайдера. Только после совпадения подтвердите соединение словом yes. При вводе пароля символы и звёздочки не отображаются — это нормально.

Проверка и установка Codex на VPS

В окне с открытым SSH-сеансом выполните:

whoami
command -v codex
codex --version

Для этого примера whoami возвращает root. Следующие команды должны показать путь к Codex и его версию. Если Codex уже установлен и работает, пропустите установку. Если видите codex: command not found, используйте способ, которым мы воспользовались:

apt update
apt install -y curl ca-certificates
curl -fsSL https://chatgpt.com/codex/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
codex --version

Команда скачивает и запускает официальный установщик. export добавляет папку в PATH только для текущего сеанса. Если после повторного входа команда снова не находится, повторите этот export и проверьте настройку PATH в профиле оболочки.

Вход в аккаунт на VPS

codex login --device-auth

Откройте выданный командой адрес в браузере на своём компьютере. Войдите в аккаунт ChatGPT, введите выданный одноразовый код и вернитесь в терминал. Никому не отправляйте этот код. Затем проверьте вход:

codex login status

Ожидаемый ответ в нашем случае: Logged in using ChatGPT. Если вход по коду недоступен, проверьте, разрешена ли device code authentication в настройках безопасности аккаунта или рабочей области.

Отдельный SSH-ключ на Windows

Оставьте первое окно с терминалом VPS открытым. Откройте ВТОРОЕ окно PowerShell на Windows. Убедитесь, что видите приглашение вида PS C:\…>, и выполните именно в нём:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.ssh" | Out-Null
ssh-keygen -t ed25519 -f "$env:USERPROFILE\.ssh\codex_vps" -C "codex-windows"

SSH попросит парольную фразу и её повтор. Она защищает закрытый ключ. В нашем примере для автоматического входа нажали Enter дважды и оставили её пустой; тогда доступ к файлу ключа позволяет использовать его без этой дополнительной защиты.

Создаются два файла: codex_vps — закрытый ключ, остаётся на Windows; codex_vps.pub — открытый ключ, его добавляем на сервер. Закрытый ключ не вставляйте в чат и не загружайте на VPS.

Добавление открытого ключа на Debian

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

Get-Content "$env:USERPROFILE\.ssh\codex_vps.pub"

Скопируйте одну строку целиком. Переключитесь в первое окно, где всё ещё открыт SSH-сеанс VPS под root:

mkdir -p /root/.ssh
chmod 700 /root/.ssh
cat >> /root/.ssh/authorized_keys

После последней команды терминал ждёт ввод. Вставьте скопированную строку открытого ключа, нажмите Enter, затем Ctrl+D. Когда вернётся приглашение сервера, выполните:

chmod 600 /root/.ssh/authorized_keys

Проверка входа по ключу

Во втором окне PowerShell на Windows выполните:

ssh -o IdentitiesOnly=yes -i "$env:USERPROFILE\.ssh\codex_vps" -p ПОРТ root@IP_СЕРВЕРА

Ожидаемый результат — приглашение сервера без запроса пароля пользователя root. Если ключ защищён парольной фразой, SSH может отдельно запросить её. После подключения это окно тоже выполняет команды на Debian; чтобы вернуть его на Windows, выполните exit.

Подключение в графическом приложении

Переключитесь в Codex и откройте Настройки → Подключения → SSH → Добавить. Если список пуст и написано «SSH-подключения не найдены», выберите «Добавить вручную».

Чтобы узнать полный путь, в PowerShell Windows, вне SSH-сеанса, выполните:

Write-Output "$env:USERPROFILE\.ssh\codex_vps"

Выберите файл или укажите полученный путь и нажмите «Сохранить». Ориентир успешного подключения — зелёная точка и статус «Подключено».

Создание удалённого проекта

В терминале VPS создайте рабочую папку:

mkdir -p /root/server-admin

В приложении Windows нажмите значок папки с плюсом справа от SSH-подключения. Выберите /root/server-admin, назовите проект «Управление VPS» и нажмите «Создать проект».

Когда появится «Доверять этой папке?», сверьте сервер и путь. В нашем примере папку только что создал сам пользователь, поэтому выбрали «Доверять папке».

Где писать первый промт

Вернитесь в основное окно приложения. Слева в разделе «Проекты» откройте свой удалённый проект «Управление VPS», затем откройте в нём чат. Вставьте туда проверочное задание:

Выполни hostname, whoami, pwd, cat /etc/os-release, uptime, free -h и df -h /. Кратко сообщи имя сервера, пользователя, рабочую папку, версию ОС, нагрузку, доступную память и место на диске. Ничего не изменяй и не устанавливай. Не читай пароли, токены и приватные ключи

Подключение работает, если имя узла в ответе совпадает с именем в SSH-терминале, рабочая папка — /root/server-admin, а результаты появились в чате Windows. Для сверки имени выполните в SSH-терминале:

hostname

Если застряли