Claude Code на удалённом сервере: SSH и работа без рук

Как использовать Claude Code на удалённом сервере по SSH и в режиме без участия человека (headless). Простыми словами, на реальном кейсе QuboLab.

Обновлено 30 июня 2026 г.

Коротко

Claude Code умеет работать не только на вашем компьютере, но и на удалённом сервере — например, на VPS, где живёт ваш сайт. Подключаетесь к серверу по SSH (защищённый «туннель» в чужой компьютер через терминал), запускаете там claude — и помощник чинит, настраивает и разворачивает прямо на сервере. А ещё есть режим «без рук» (headless): помощник выполняет задачу одной командой, без живой беседы, — это нужно для автоматизации и скриптов.

Определение

SSH — это способ безопасно зайти в другой компьютер (сервер) через терминал, как будто вы сидите за ним. Сервер обычно стоит где-то в дата-центре, а вы управляете им со своего ноутбука. Вход чаще всего по «ключу» — файлу-паролю, который надёжнее обычного пароля.

Claude Code на сервере работает двумя способами. В беседе: вы зашли по SSH, запустили claude, и общаетесь с помощником прямо на сервере — он видит файлы сервера, его команды, логи. Без рук (headless): помощнику дают задачу одной командой вида claude -p "...", он выполняет её и завершается, не вступая в диалог. Второй режим — для автоматизации: его можно встроить в скрипт или запускать по расписанию.

Когда использовать

Удалённая работа нужна, когда проблема живёт на сервере, а не у вас на компьютере:

  • Починить то, что сломалось на сайте. Сайт лёг, нужно разобраться в логах и поднять — помощник делает это прямо на сервере.
  • Настроить и развернуть. Поставить программы, обновить конфиги, перезапустить сервисы — рутина администрирования.
  • Автоматизация без диалога. Режим headless встраивают в скрипты: задача выполняется сама, по команде или по расписанию.
  • Разбор инцидента. Когда на сервере что-то странное, помощник помогает быстро понять причину по логам.

Когда НЕ стоит

С удалёнкой нужна осторожность:

  • «Боевой» сервер без бэкапа. На сервере с живыми пользователями любая ошибка видна сразу. Не разрешайте опасные команды вслепую — держите подтверждение за собой и делайте бэкапы.
  • Когда хватает локальной работы. Если задача про код, а не про сам сервер, проще и безопаснее делать её у себя и потом аккуратно выкатывать.
  • Широкие права «на всякий случай». На сервере у помощника много власти. Давайте доступ под конкретную задачу, а не «пусть всё может».

Пошаговая инструкция

Общая логика: подключиться к серверу по SSH и запустить там помощника. Покажу по шагам.

  1. 1
    Подключиться к серверу по SSH

    В терминале вводят команду вида ssh -i ~/.ssh/мой-ключ root@адрес-сервера. Здесь мой-ключ — файл-пароль, а адрес-сервера — его IP. После входа вы оказываетесь «внутри» сервера: команды теперь выполняются на нём.

  2. 2
    Установить Claude Code на сервере

    На сервере Claude Code ставят так же, как на своём компьютере: нужен Node.js, затем команда установки. Это разовая настройка. Дальше помощник запускается прямо на сервере.

  3. 3
    Работать в беседе или дать задачу одной командой

    Можно запустить claude и общаться как обычно — помощник видит файлы и логи сервера. А для автоматизации есть режим без рук: claude -p "перезапусти сервис и проверь, что он поднялся" — помощник выполнит и завершится, без диалога.

  4. 4
    Держать опасное под контролем

    На сервере цена ошибки выше. Рискованные шаги (удаление данных, перезапуск важного) подтверждайте вручную, а перед крупными изменениями делайте резервную копию. Помощник — сильный инструмент, но последнее слово на «боевом» сервере оставляйте за собой.

Пример

Самый показательный наш случай — восстановление сервера. Однажды VPS QuboLab взломали (зловред XorDDoS), и сервер пришлось переустанавливать с нуля и заново разворачивать на нём все продукты. Большую часть этой работы — разбор, что заражено, чистая переустановка, перенос и запуск Astara, «Договорились» и сайта — мы вели прямо на сервере под управлением помощника по SSH.

Ключ от сервера лежит локально, подключение — обычным ssh, а дальше помощник работает на самом сервере: читает логи, ставит и настраивает сервисы, разворачивает контейнеры. Из этого кейса родилось жёсткое правило: на «боевом» сервере опасные шаги — только с подтверждением, и сначала бэкап. Мы один раз потеряли обложки статей именно потому, что бэкапили не тот путь — урок дорогой и запомнился.

Частые ошибки

Что чаще всего бьёт по рукам:

  • Разрешают опасные команды вслепую. На сервере удаление или перезапуск задевает живых пользователей. Подтверждайте такие шаги вручную.
  • Нет бэкапа перед изменениями. Мы на этом обожглись — бэкапили не тот путь и потеряли данные. Перед крупными правками — резервная копия, и проверьте, что копируете именно то.
  • Путают, где выполняется команда. После входа по SSH команды идут на сервере, а не на вашем компьютере. Легко забыть и сделать что-то не там.
  • Дают слишком широкий доступ. Помощнику на сервере хватит прав под конкретную задачу. «Пусть всё может» — лишний риск.

Частые вопросы

Что такое SSH простыми словами?+

Это безопасный способ зайти в чужой компьютер (обычно сервер) через терминал и управлять им, как будто вы сидите за ним. Подключение зашифровано, а вход чаще по «ключу» — специальному файлу-паролю, который надёжнее обычного пароля.

Чем режим headless отличается от обычной беседы?+

В обычной беседе вы переписываетесь с помощником по шагам. В режиме без рук (headless) помощнику дают задачу одной командой, он выполняет её и завершается, без диалога. Это нужно для автоматизации — например, чтобы запускать помощника по расписанию или из скрипта.

Это безопасно — пускать помощника на боевой сервер?+

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

Нужен ли отдельный сервер, чтобы попробовать?+

Чтобы просто познакомиться с Claude Code — нет, начинайте на своём компьютере (см. установку). Удалённая работа нужна, когда у вас уже есть сервер с сайтом или ботом и проблему надо решать прямо на нём.

Термины

Определения из глоссария QuboLab

Материалы QuboLab

Наши продукты, кейсы и исследования по теме