В официальной документации OpenAI описаны два отдельных способа удалённой работы Codex: Remote Control и подключение к удалённым компьютерам через SSH (правила обнаружения SSH-хостов). Поэтому симптом «обычный терминал входит на Mac, но Codex не показывает хост» не означает, что сломан сам Mac.

Симптом → быстрый способ исправления: сначала проверьте обычный SSH, затем запись хоста, удалённую команду Codex и только после этого папку проекта. Codex Remote SSH может использовать удалённый Mac как фактическую среду выполнения, но для этого удалённая оболочка должна найти Codex.

Эта инструкция предназначена для студентов с Windows, школьным или университетским компьютером, а также для владельцев старого Mac, которым нужен macOS для учебного проекта или Xcode. Если вы уже получили данные для входа, но не понимаете, как добавить машину в Codex, двигайтесь по уровням проверки ниже. Если Codex показывает подключение, но файлы и команды остаются локальными, отдельный раздел поможет это доказать.

Последняя проверка инструкции выполнена 7 сентября 2026 года по документации OpenAI и Apple: Remote connections для Codex, справке по использованию Codex и руководству Apple по Remote Login. Интерфейс приложения и требования к учётной записи могут меняться, поэтому перед настройкой сверяйте актуальные названия с официальными страницами.

Сначала отделите проблему SSH от проблемы Codex

SSH — это не сам Codex, а дверь в удалённый компьютер. Пока вы не доказали, что дверь открывается обычным ключом или другим разрешённым способом, бессмысленно искать причину в AI-инструменте. На Mac должен быть включён поддерживаемый Remote Login, а удалённый пользователь должен иметь право входа; соответствующие условия описаны в инструкции Apple по удалённому входу в macOS.

Проверку запускайте с того компьютера, где работает настольное приложение Codex. Если это Windows, используйте обычный терминал и данные, выданные для вашего удалённого Mac. Если это другой Mac, используйте его Terminal. Ваша первая цель — не запустить проект, а получить стабильную командную строку на удалённой машине.

Проверьте последовательно:

  1. Уточните имя пользователя, адрес удалённого Mac и способ аутентификации. Не угадывайте имя учётной записи по имени владельца компьютера.
  2. Выполните обычное SSH-подключение, используя выданный вам адрес или псевдоним из SSH-конфигурации.
  3. После входа выполните безопасную команду, которая показывает текущего пользователя и путь к домашнему каталогу.
  4. Завершите сеанс и повторите вход ещё раз. Одно случайно успешное подключение не доказывает, что параметры сохранены правильно.
  5. Запишите точный результат: тайм-аут, отказ соединения, неизвестный пользователь, ошибка ключа или успешный вход.
Ожидаемый результат — вы видите приглашение удалённой оболочки и можете перейти в разрешённую рабочую папку. При тайм-ауте проверяйте адрес, доступность хоста и сетевое ограничение. При отказе соединения уточняйте, включён ли Remote Login и слушает ли Mac разрешённое подключение. При ошибке ключа проверяйте выбранный ключ и права доступа к нему. Не отключайте проверку отпечатка хоста и не открывайте посторонние порты ради «быстрого решения».

**Остановка:** если обычный SSH не входит на Mac, остановитесь на этом уровне. Не переустанавливайте Codex и не меняйте настройки проекта, пока не исправлена базовая связь.

Шаг второй: проверьте, как Codex обнаруживает хост

Codex не обязан показывать каждый компьютер, который доступен по адресу или к которому вы когда-то подключались. Remote SSH использует сведения из SSH-конфигурации, включая псевдоним хоста и параметры входа; именно это объясняет, почему запись «есть только адрес, логин и пароль» не всегда появляется автоматически в списке. Подробные правила обнаружения описаны в документации OpenAI по удалённым подключениям.

Представьте школьное здание. IP-адрес — это адрес здания, имя пользователя — фамилия ученика, а запись Host — понятная охране карточка с номером кабинета. Codex ориентируется на такую карточку, а не просто на догадку по адресу.

Проверьте SSH-конфигурацию без копирования в неё секретов:

  • существует ли пользовательская конфигурация SSH в ожидаемом месте вашей операционной системы;
  • есть ли отдельный псевдоним Host, по которому вы можете выполнить обычный вход;
  • указан ли адрес удалённого Mac в этой записи;
  • совпадает ли имя пользователя с тем, которое прошло проверку в терминале;
  • назначен ли правильный ключ, если вход выполняется по ключу;
  • не ссылается ли конфигурация на файл или путь, доступный только вашему локальному компьютеру.
Для начинающего пользователя лучше иметь одну ясную запись для одного учебного Mac, чем несколько похожих псевдонимов с разными ключами. После изменения конфигурации полностью перезапустите приложение Codex, если новый хост не появился сразу. Не делайте вывод о неисправности по одному отсутствующему пункту меню: название элемента и расположение настроек зависят от текущей версии приложения.

Затем снова выполните вход по псевдониму в терминале. Если он работает, а Codex всё ещё не показывает хост, сравните среду запуска: приложение может использовать другой пользовательский профиль, другой файл конфигурации или другой способ аутентификации. Это уже проблема обнаружения, а не доказательство, что удалённый Mac недоступен.

Шаг третий: убедитесь, что Codex установлен именно на удалённой машине

Распространённая ошибка — установить Codex на Windows и считать, что удалённый Mac автоматически получил ту же команду. На самом деле это два разных компьютера и две разные среды. Настольное приложение на вашем ноутбуке инициирует удалённую работу через SSH, а команда или служба, которую нужно запустить для выполнения задач, должна быть доступна на удалённой macOS-машине.

После успешного SSH-входа проверьте три вещи:

  1. На удалённом Mac выполнена официальная установка Codex по актуальной инструкции, а не только установка на локальном компьютере.
  2. Удалённая учётная запись прошла необходимую авторизацию в соответствии с актуальными условиями использования Codex.
  3. Входная оболочка видит каталог с командой Codex через переменную PATH.
Проверяйте это в том же типе сеанса, который использует приложение. Команда, доступная в интерактивном окне терминала, может не находиться в неинтерактивной login-shell, потому что разные файлы настройки оболочки загружаются по-разному. Для новичка достаточно сравнить: команда находится в обычном удалённом SSH-сеансе или нет, и возвращается ли понятная информация об установленном инструменте.

Если система сообщает, что команда не найдена, не добавляйте случайные каталоги в PATH из чужого ответа. Сначала определите, где официальная установка разместила программу, затем внесите только проверенный путь в конфигурацию разрешённой оболочки. После изменения закройте SSH-сеанс, войдите снова и повторите проверку.

Если авторизация не проходит, не смешивайте её с проблемой SSH-ключа. SSH отвечает за вход на Mac, а учётная запись Codex — за доступ к самому инструменту. Это две двери в одном здании: открытая первая не означает, что открыта вторая.

Когда хост найден, выберите удалённую папку, а не только удалённое соединение

Даже успешное подключение не переносит автоматически уже открытый локальный проект. Вы можете видеть зелёный статус удалённого хоста, но продолжать редактировать папку на диске Windows. Перед первым настоящим заданием нужно проверить именно расположение файлов.

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

Проверка занимает несколько минут:

  • попросите Codex показать текущий путь проекта;
  • создайте файл с нейтральным именем, например файл-пометку для проверки;
  • запишите в него короткий текст без персональных данных;
  • выполните безопасную команду, которая показывает имя компьютера или окружения;
  • проверьте наличие файла отдельной SSH-сессией на удалённом Mac;
  • после этого удалите тестовый файл вручную или оставьте его только в одноразовой папке.
Ожидаемый результат: путь относится к файловой системе удалённого Mac, тестовый файл виден из отдельного SSH-сеанса, а команда возвращает признаки удалённого окружения. Если файл появился на локальном диске, удалённая папка не выбрана. Если путь выглядит правильно, но отдельный SSH-сеанс не видит файл, вы могли подключиться к другому пользователю, другому хосту или другой рабочей папке.

**Проверка перед учебным репозиторием:** не считайте соединение подтверждённым только потому, что интерфейс показывает «подключено». Файл, путь и результат команды должны указывать на одну и ту же удалённую машину.

Что делать с проектом Xcode через Remote SSH

Codex Remote SSH подходит для удалённого чтения файлов, изменения проекта и выполнения команд в удалённой оболочке. Это может включать командную сборку или тестирование, если на удалённом Mac установлены нужные инструменты и проект сам поддерживает такой режим. Apple отдельно описывает удалённую работу с macOS-проектами из среды на другом компьютере в руководстве по удалённой сборке.

Но SSH не показывает графический интерфейс Xcode сам по себе. Если задание требует открыть storyboard, нажимать элементы интерфейса или работать в окне Simulator, одного терминального подключения может быть недостаточно. Для таких задач нужен поддерживаемый удалённый экран либо другой способ доступа к графической сессии. Если курс требует только сборку, тесты и просмотр логов, SSH-подход может оказаться достаточным; если нужен полный интерфейс, заранее проверьте ограничения удалённой машины.

Не начинайте с Xcode, если ещё не прошли тестовый файл и безопасную команду. Иначе ошибка может находиться на любом уровне: SSH, Codex, путь проекта, зависимости или графическая сессия.

Первый запуск: выполните маленькое и обратимое задание

Для первой проверки возьмите проект, который можно восстановить или удалить. Это может быть простой учебный репозиторий без секретов и платных ключей. Не давайте инструменту разрешение на удаление файлов, изменение системных каталогов, загрузку неизвестных скриптов или чтение каталогов за пределами проекта.

Рабочий порядок такой:

  1. Откройте выбранную папку через удалённый SSH-хост.
  2. Попросите Codex кратко описать структуру каталогов без изменения файлов.
  3. Проверьте, что названия папок совпадают с тестовым проектом на удалённом Mac.
  4. Попросите предложить небольшое изменение, например поправить текст в учебном файле.
  5. До применения изменения просмотрите, какой файл будет затронут.
  6. Примените только одну правку и проверьте разницу.
  7. Запустите предусмотренную проектом безопасную проверку.
  8. Верните изменение или оставьте его только после того, как убедились в правильном месте выполнения.
Ваша цель — подтвердить четыре условия: Codex читает нужный удалённый проект, изменение можно отменить, команда выполняется на Mac, а файл после отключения остаётся в ожидаемой папке. Если хотя бы одно условие не выполнено, не переходите к курсовому репозиторию.

Для проектов Xcode полезно разделить проверку на две части: сначала убедиться, что файлы и командная среда удалённые, затем проверить сборку или тесты. Возможности автоматизации Xcode и ограничения командного запуска описаны в официальном материале Apple о тестировании. Конкретные команды зависят от проекта, поэтому не вставляйте в учебную работу универсальную команду, если она не указана в её документации.

Инструмент решения: выберите следующий шаг по результату проверки

Отметьте пункты по порядку. Переходите к следующему уровню только после выполнения условия предыдущего.

  • [ ] Если обычный SSH не устанавливает сеанс, выберите вариант A: исправлять базовое подключение. Проверьте адрес, имя пользователя, Remote Login и способ аутентификации. Иначе, если вы уже видите удалённую оболочку, переходите к проверке SSH-конфигурации.
  • [ ] Если терминал входит по псевдониму, но Codex не показывает хост, выберите вариант B: исправлять обнаружение. Проверьте запись Host, используемый профиль, путь к ключу и перезапуск приложения. Иначе, если хост виден в Codex, переходите к удалённой команде.
  • [ ] Если удалённая оболочка не находит Codex, выберите вариант C: исправлять установку или PATH на Mac. Не переустанавливайте Codex на Windows в надежде исправить удалённую среду. Иначе, если команда доступна, переходите к тестовой папке.
  • [ ] Если путь проекта или тестовый файл указывают на Windows, выберите вариант D: заново открыть папку через SSH-хост. Не запускайте учебный проект до подтверждения удалённого расположения.
  • [ ] Если путь удалённый, файл виден после повторного SSH-входа, а безопасная команда выполняется на Mac, выберите вариант E: выполнить минимальное учебное задание.
  • [ ] Если курсу требуется графический интерфейс Xcode или Simulator, а у вас есть только терминальный SSH, вернитесь к варианту B или D для проверки доступного удалённого экрана. Если графический доступ невозможен, не обещайте себе, что одного Remote SSH достаточно.
Такой порядок помогает не перепутать четыре разные неисправности. Подключение к хосту, запуск Codex, выбор каталога и выполнение Xcode-задачи — не одно и то же событие.

Решение: продолжать удалённую работу или выбрать другой путь

Используйте этот список условий перед оплатой долгого периода или переносом всех учебных проектов:

  • Если курс требует macOS, Xcode или специфичных инструментов Apple, то оставьте удалённый Mac основным окружением после успешной минимальной проверки.
  • Если SSH работает, но графическая работа в Xcode обязательна, то сначала подтвердите наличие удалённого рабочего стола; иначе выберите среду, где интерфейс доступен напрямую.
  • Если проект сохраняется только на временной машине и вы не знаете, останется ли он после отключения, то настройте резервную копию и отдельное хранилище до начала серьёзной работы.
  • Если вы подключаетесь редко и выполняете только короткие задания, то сравните аренду на нужный срок с локальной покупкой, не оплачивая постоянный ресурс без необходимости.
  • Если вам нужна непрерывная тяжёлая работа, физический USB-доступ или гарантированная автономность без сети, то рассмотрите собственный Mac либо другой подход.
  • Если обычный SSH стабилен, Codex найден удалённо, папка проверена, а тестовое изменение сохраняется после повторного входа, то можно переносить учебный проект.
Для ориентира по доступному формату удалённой работы ознакомьтесь с [руководством MACGPU по Mac на Apple Silicon](https://macgpu.com/ru/m4-rukovodstvo.html). Если вопрос уже упирается не в настройку, а в срок использования и бюджет, сравните варианты на странице [аренды Mac у MACGPU](https://macgpu.com/ru/m4-tseny-arendy.html). Это не заменяет проверку курса: сначала выясните, нужен ли вам именно настоящий macOS-компьютер и требуется ли графический Xcode.

FAQ для начинающих

Почему Codex не показывает SSH-хост, хотя терминал подключается?

Codex ищет параметры удалённого подключения в SSH-конфигурации и не всегда строит список по одному адресу. Проверьте псевдоним Host, имя пользователя, адрес и способ аутентификации. Повторите вход по тому же псевдониму в терминале, затем перезапустите приложение. Если терминал использует другой профиль или файл конфигурации, приложение может не видеть рабочую запись.

Нужно ли отдельно устанавливать Codex на удалённый Mac?

Да, локальная установка на Windows не переносится на удалённую macOS-машину. После SSH-входа проверьте официальную установку и авторизацию Codex на самом Mac. Затем убедитесь, что login-shell находит команду через PATH. Если команда доступна только в локальном терминале, удалённый запуск не сработает, даже если список SSH-хостов отображается правильно.

Почему подключение есть, а проект запускается на моём компьютере?

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

Подходит ли Codex Remote SSH для проекта Xcode?

Он подходит для работы с удалёнными файлами и выполнения командной части проекта, если необходимые инструменты уже установлены на Mac. Однако SSH не передаёт графическое окно Xcode. Если курс требует интерфейс IDE или Simulator, отдельно проверьте доступ к удалённому рабочему столу. Для командной сборки и тестов SSH может быть достаточен, но это зависит от структуры проекта.

После минимальной проверки сравните текущий вариант с удалённым Mac. Windows-компьютер не запускает macOS-инструменты напрямую, школьный компьютер часто ограничивает установку и фоновые процессы, а старый Mac может не справляться с нужной версией инструментов или постоянно оставлять вас без доступа к учебной среде. Если вам нужен именно настоящий Mac на короткий срок — для курса, проверки проекта или первого опыта с Xcode — аренда MACGPU может быть рациональнее покупки устройства вслепую. При этом для длительной тяжёлой работы, физической периферии и полностью автономного режима собственный Mac по-прежнему может оказаться честно лучшим выбором.