Определите задачу сервера
Удалённый сервер полезен, если код, тестовые зависимости или сборка уже живут в другой среде. Размещение готового статического сайта — отдельная задача. Для первой настройки подойдёт учётная запись без прав администратора и тестовый репозиторий, в котором можно безопасно менять файлы. Проверьте доступ по SSH до установки инструментов. Убедитесь, что терминал подключается под вашим рабочим пользователем и попадает на ожидаемую машину.
Выполните hostname, whoami, pwd и git status --short. Запишите короткое имя хоста, пользователя и путь к тестовой копии. Если они отличаются от ожидаемых, найдите нужное окно терминала или каталог до запуска агента. На сервере установите Claude Code по официальной инструкции Anthropic и проверьте claude --version. Инструмент должен быть доступен в той оболочке, в которой вы будете работать. В режиме Remote SSH расширение VS Code и терминал проверяйте в контексте открытого удалённого окна.
Проверьте туннель на одной странице
Подготовьте на сервере папку с простым index.html. В ней запустите Python HTTP-сервер с привязкой к 127.0.0.1. Выберите порт, который не занят. Затем на своём компьютере откройте отдельное подключение с перенаправлением порта и загрузите страницу по адресу 127.0.0.1:8080. В команде замените user@example.org на свой адрес. Туннель будет работать, пока открыта эта SSH-сессия.
# На сервере в папке с index.html:
python3 -m http.server 8000 --bind 127.0.0.1
# На своём компьютере в другом окне:
ssh -N -L 127.0.0.1:8080:127.0.0.1:8000 user@example.orgДля контрольного примера у страницы заголовок «Черновик лендинга», а внизу заметный маркер «Стенд 01». Проверьте оба значения в браузере. Если видите другую страницу, проверьте порт и текущую папку. При сообщении о занятом локальном адресе выберите другой локальный порт. Если соединение установлено, но запрос падает, проверьте, продолжает ли работать Python на сервере и совпадает ли его порт с правой частью команды.
Дайте агенту одну задачу и проверьте следы
Попросите Claude Code изменить только заголовок на «Лендинг готов к проверке». Пусть агент перечислит файл и команду для предпросмотра. Перезагрузите страницу по туннелю, откройте git diff и убедитесь, что поменялась одна строка. В VS Code проверьте подпись удалённой среды в строке состояния. Если агент показывает один путь, а терминал другой, откройте корень того же репозитория и повторите проверку статуса.
Для регулярной работы заведите отдельную ветку, тестовые значения конфигурации и понятное имя хоста. Закройте туннель после проверки. Перед подключением к следующему проекту повторите команды hostname и pwd: они быстрее всего показывают ошибку контекста. Права для боевой инфраструктуры задавайте отдельно от тех, которые нужны агенту для чтения файлов и запуска тестов.
Официальная документация: шаги и условия работы инструмента.