Как использовать VS Code Remote Agent Sessions? Удалённое развёртывание Mac в 2026 году

Материал предназначен для разработчиков Apple-платформы, которые управляют удалёнными задачами с Windows, Linux или мобильного устройства.

Он также пригодится AI-инженерам, подключающим Agent к сборке и тестированию Xcode, и DevOps-командам, отвечающим за общие Mac, секреты и постоянную доступность узла.

Последнее обновление: 13 сентября 2026 года. Статус предварительного доступа, способы подключения и требования к удалённому хосту сверены с официальным описанием Remote Agent Sessions, документацией Remote SSH, Dev Tunnels и Apple Remote Login.

У Remote Agent Sessions есть несколько независимых результатов. Их нельзя объединять в один зелёный индикатор.

• Сетевой доступ: клиент видит удалённый Mac и может пройти аутентификацию.
• Доступ к рабочему каталогу: Agents window открывает выбранную папку с нужной учётной записью.
• Agent Host: на удалённом Mac запускается CLI-компонент, который получает инструкции и выполняет команды.
• Инструментальная готовность: Shell видит Git, зависимости, Xcode command-line tools и сам проект.
• Операционная готовность: узел выдерживает обрыв клиента, остановку туннеля и перезапуск Mac.
• Безопасная эксплуатация: у Agent нет лишнего доступа к сертификатам, токенам и рабочим каталогам других пользователей.

Официальная документация подтверждает предварительный статус функции и варианты подключения. Она не превращает удалённую сессию в универсальный CI Runner. Поэтому проверка должна идти от наблюдаемого результата к следующему разрешению, а не от желания сразу включить автоматическое выполнение.

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

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

Dev Tunnel подходит, когда прямой сетевой вход к Mac неудобен. Но тогда в контур добавляются учётная запись, состояние туннеля и зависимость от клиента управления туннелем. Вариант без подтверждённой личности нельзя считать приемлемым для исходного кода или инструментов подписи. Требования к настройке и управлению туннелем описаны в официальной документации VS Code Dev Tunnels.

Для SSH включите Remote Login на Mac и ограничьте список пользователей. Apple описывает этот режим в руководстве по Remote Login. Для клиентской стороны сверяйте параметры с документацией VS Code Remote SSH, а не с настройками обычного локального терминала.

Начинайте не с большого задания Agent, а с короткого теста, который оставляет проверяемый результат.

1. Создайте отдельную учётную запись Mac для испытания. Не используйте профиль владельца узла, если задача не требует его полномочий.
2. Подготовьте тестовый репозиторий с известным файлом конфигурации и небольшой командой проверки.
3. Подключите Mac выбранным способом. В Agents window убедитесь, что отображается именно нужный хост.
4. Выберите рабочий каталог вручную. Проверьте, что путь принадлежит тестовой учётной записи, а не общему каталогу.
5. Попросите Agent только прочитать файл и назвать активную папку. Сравните результат с обычной SSH-сессией.
6. Выполните контролируемое изменение в тестовой ветке. Затем отмените его обычной командой Git.
7. Остановите сессию и повторите вход. Если Agent открывает другой каталог или другую ветку, продолжать нельзя.

На этом этапе проверяется не качество AI-ответа. Проверяется контур: кто выполняет команду, где она выполняется и какой результат можно предъявить проверяющему.

Частая ошибка выглядит так: команда в локальном SSH-терминале работает, а Agent сообщает, что программа не найдена. Это не обязательно проблема соединения. Agent Host может запускаться с другим login Shell, другой переменной PATH, другим HOME или другим каталогом.

Соберите минимальный диагностический набор через Agent:

whoami
pwd
echo "$HOME"
echo "$SHELL"
echo "$PATH"
command -v git
command -v xcodebuild
xcode-select -p

Затем выполните тот же набор в обычном SSH-сеансе и сравните строки. Не вставляйте в статью или журнал реальные токены, приватные ключи и содержимое секретных переменных.

Для замкнутого цикла используйте четыре операции:

• чтение заранее созданного файла;
• изменение одной безопасной строки;
• проверка установленной зависимости;
• запуск минимальной команды тестирования.

Если чтение проходит, а изменение нет, исследуйте права каталога. Если изменение проходит, а команда не находится, исследуйте PATH и login Shell. Если команда запускается, но проект не собирается, переходите к Xcode и настройкам проекта. Не расширяйте права Agent только потому, что одна команда завершилась ошибкой.

Наличие xcodebuild в PATH — только нижняя граница проверки. Apple публикует отдельные материалы по командам Xcode и параметрам сборки. Используйте их как справочник, но окончательный вывод делайте на реальном проекте.

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

xcode-select -p
xcodebuild -version
xcodebuild -list -project <PROJECT_PATH>
xcodebuild -project <PROJECT_PATH> \
  -scheme <SCHEME_NAME> \
  -configuration Debug \
  -destination 'generic/platform=iOS' \
  build

Заменяйте значения в угловых скобках на тестовые пути и имена. Не вставляйте в команду постоянный Team ID, если он не нужен для проверки. Если сборка требует доступа к связке ключей, сертификату или профилю, остановите Agent перед выдачей разрешения и оформите отдельную процедуру.

Автоматическое одобрение команд ускоряет работу, но вместе с удалённым входом увеличивает радиус ошибки. Агент может получить доступ к файлам, которые не связаны с текущей задачей, если рабочая учётная запись и каталог настроены слишком широко. Правила подтверждений и режимы одобрения описаны в официальной документации VS Code Agent Approvals.

Для личного тестового узла достаточно отдельной рабочей папки и тестовой учётной записи. Для общего Mac добавьте следующие границы:

• отдельная учётная запись для каждой команды или изолированная роль;
• отдельный каталог для каждого репозитория;
• запрет чтения каталогов с сертификатами и долговременными токенами;
• тестовая ветка или отдельный worktree для изменений;
• ручное подтверждение команд, удаляющих файлы, меняющих права или отправляющих артефакты наружу;
• журнал изменения разрешений;
• понятная команда остановки Agent и отзыва сетевого доступа.

Рекомендации VS Code по безопасности Agent отдельно подчёркивают необходимость контролировать доверие к рабочей области и выполняемым действиям. Не переносите секрет из локального терминала в окружение Agent только потому, что так удобнее.

Минимальная запись изменения должна отвечать на вопросы: кто запросил доступ, к какому каталогу, на какой срок, для какой команды и каким действием доступ будет отозван. Если этих ответов нет, узел не готов к общему использованию.

Постоянная доступность — это не обещание «Mac включён». Вам нужно проверить весь путь восстановления.

Выполните проверки по отдельности:

• закройте клиент, оставив тестовую задачу в контролируемом состоянии;
• отключите сетевой канал и зафиксируйте, что видит Agents window;
• остановите Dev Tunnel, если он используется;
• перезапустите Mac;
• дождитесь загрузки Remote Login или восстановления туннеля;
• снова откройте рабочую папку;
• повторите whoami, pwd, чтение файла и безопасную тестовую команду;
• проверьте, не появился ли новый процесс с другой учётной записью.

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

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

После проверок выберите один из режимов.

Продолжать пробный запуск. Подключение стабильно, Agent использует правильную учётную запись, рабочий каталог изолирован, базовая команда Xcode проходит, а после перезапуска есть понятный путь восстановления. Секреты всё ещё остаются за отдельным ручным контуром.

Ограничить использование. Код читается и меняется, но Shell, Simulator или восстановление требуют ручных действий. В этом режиме Agent подходит для анализа, небольших правок и контролируемых команд, но не для автономного выпуска.

Отложить производственное подключение. Неясно, кто владеет туннелем, общий каталог смешивает проекты, отсутствует процедура отзыва доступа или после перезапуска нельзя подтвердить окружение. Исправьте границы узла, а не увеличивайте количество разрешений.

Если для теста нужен настоящий Mac без покупки отдельного оборудования, можно рассмотреть тарифы CALMVPS на аренду Mac и начать с короткого изолированного периода. Выбирайте вариант только после проверки доступа, рабочего каталога и правил хранения секретов.

Поддерживает ли VS Code Remote Agent Sessions macOS?

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

Может ли Agent напрямую выполнить xcodebuild?

Да, если xcodebuild доступен в Shell Agent Host и проект настроен для этой учётной записи. Начинайте с xcode-select, версии Xcode и списка схем. Не переходите сразу к подписи или публикации.

Как выбрать между SSH и Dev Tunnel?

Используйте SSH при наличии управляемого сетевого маршрута и процедуры отзыва ключей. Выбирайте Dev Tunnel, если прямой вход неудобен, но вы можете обязательно контролировать учётную запись, состояние туннеля и журналы доступа.

Что проверять после перезапуска Mac?

Сначала доступность хоста и способ входа, затем учётную запись, рабочую папку, PATH, Agent Host и тестовую команду. Только после этого можно считать восстановление подтверждённым.

Как защитить общий Mac?

Разделите учётные записи, каталоги и worktree. Ограничьте автоматические одобрения. Не выдавайте Agent постоянные сертификаты, токены и ключи без отдельной записи, срока действия и процедуры отзыва.

Обычный локальный Windows или Linux-компьютер удобен для большей части кода, но не закрывает нативный macOS-инструментарий. Виртуальная среда добавляет ограничения по графике, доступу к системным компонентам и воспроизводимости. Общий физический Mac без изоляции создаёт другой риск: чужие рабочие каталоги, сертификаты и незаметно изменённое окружение. Даже отдельный Mac mini как постоянный узел требует доставки, обслуживания, питания и самостоятельного восстановления.

Если вам нужно временно проверить Agent, Xcode-команды и сценарий восстановления на настоящем Mac, аренда CALMVPS позволяет начать с изолированного удалённого узла без немедленной покупки оборудования. После испытания по журналу команд можно решить, продлевать ли аренду, переносить ли нагрузку на собственный Mac или оставлять Agent только как ручной исполнитель. Для создания заказа CALMVPS сначала подготовьте тестовый репозиторий и список проверок, а не долгоживущие производственные секреты.