Claude Code на VPS

Запуск Claude Code на сервере вместо ноутбука даёт три вещи. Он продолжает работать, когда ноутбук закрыт. Он переживает обрыв связи. И агент оказывается на машине, которую можно выбросить, а не на той, где лежат ваши SSH-ключи и профиль браузера. Это руководство описывает схему, на которую уходит около пятнадцати минут на свежей машине с Debian или Ubuntu. На Alpine и Fedora те же шаги работают с небольшими изменениями.

Вам нужен тариф Claude, включающий Claude Code: Pro, Max, Team или Enterprise либо аккаунт Console. Бесплатный тариф claude.ai его не включает. Входите по подписке — и никаких ключей API и доплат за использование.

1. Выберите машину

В системных требованиях Anthropic указано от 4 ГБ RAM и процессор x64 или ARM64. Поддерживаемые системы Linux — Ubuntu 20.04+, Debian 10+ и Alpine 3.19+. На практике набор инструментов вашего проекта значит больше, чем сам CLI:

• 4 ГБ: документированный минимум, хватит для одной сессии на скромном проекте.
• 8 ГБ: если вы собираете что-то существенное (бандлер, набор тестов, пару контейнеров) или запускаете несколько сессий одновременно.
• 16 ГБ: если вы запускаете нескольких агентов параллельно или рядом с ними базу данных.

Подойдут Hetzner, DigitalOcean, Scaleway, OVH, Vultr и другие, как и старый компьютер под столом. Выберите регион рядом с собой, если когда-нибудь будете печатать в терминале на этой машине. ARM-инстансы обычно самые дешёвые в пересчёте на гигабайт, и Claude Code работает на них нативно. Наше руководство по лучшим VPS для агентов сравнивает провайдеров и размеры.

2. Создайте пользователя без root

Многие образы VPS пускают вас как root. Не запускайте агента от root. Так любая ошибка становится ошибкой всей системы. К тому же Claude Code отказывается запускаться в режиме bypass-permissions от root, так что обычный пользователь вам рано или поздно всё равно понадобится. На Debian или Ubuntu:

adduser dev
usermod -aG sudo dev
rsync --archive --chown=dev:dev ~/.ssh /home/dev

На Fedora группа администраторов — wheel, а не sudo. На Alpine сначала установите sudo или doas. Последняя строка копирует ключ, с которым вы уже вошли, чтобы можно было переподключиться как dev, прежде чем что-либо закрывать. Проверьте это из второго терминала, прежде чем закрывать первый. Запереть себя снаружи свежего VPS — обряд посвящения, который лучше пропустить.

3. SSH-ключи и усиление защиты

Если вы всё ещё входите по паролю, сначала перейдите на ключ. Создайте его на компьютере командой ssh-keygen -t ed25519, затем скопируйте на сервер через ssh-copy-id dev@your-server. Когда вход по ключу заработает, отредактируйте /etc/ssh/sshd_config:

PermitRootLogin no
PasswordAuthentication no
PubkeyAuthentication yes

Затем перезапустите SSH: sudo systemctl restart ssh на Debian и Ubuntu. На Fedora служба называется sshd, поэтому выполните sudo systemctl restart sshd. Для большей защиты добавьте fail2ban и файрвол, пропускающий только SSH. Если машине вообще не нужно быть в публичном интернете, поместите её в сеть Tailscale. Телефон подключается к той же сети и достаёт до неё напрямую.

С телефона: SSH-приложения умеют создавать ключ на устройстве и показывать публичную часть, которую нужно вставить в ~/.ssh/authorized_keys. Maude делает это за вас: её кнопка «Настроить вход по ключу» создаёт ключ через подключение, с которым вы уже вошли. Она устанавливает публичную часть, проверяет новый ключ и хранит закрытую часть только в связке ключей телефона.

4. Установите Claude Code

Теперь Anthropic рекомендует нативный установщик, которому не нужен Node.js. Запускайте его от обычного пользователя, а не через sudo:

curl -fsSL https://claude.ai/install.sh | bash
claude --version
claude doctor

Он кладёт лаунчер в ~/.local/bin/claude и обновляется сам в фоне. claude doctor проверяет установку и ваши настройки, не запуская сессию. Некоторые альтернативы, все из документации по установке:

• Подписанные репозитории apt, dnf и apk — если хотите, чтобы установкой управлял системный менеджер пакетов. Они не обновляются автоматически; вы обновляете их вместе с остальной системой.
• npm по-прежнему работает (npm install -g @anthropic-ai/claude-code, Node.js 22 или новее). Он устанавливает тот же нативный бинарник. Anthropic предостерегает от sudo npm install -g.
• Alpine нужны bash, curl, libgcc, libstdc++ и ripgrep, а также USE_BUILTIN_RIPGREP=0 в настройках.

Если старое руководство велело сначала установить Node, этот шаг теперь можно пропустить.

5. Вход без браузера

Запустите claude (или claude auth login) и следуйте подсказкам. На VPS нет браузера, поэтому ссылку для входа вы откроете на любом другом устройстве. Claude Code позволяет нажать c, чтобы её скопировать. Войдите там. Когда браузер не может достучаться до локального callback Claude Code, что по SSH нормально, он вместо этого показывает код. Вставьте его в строку Paste code here if prompted, и вход завершится на сервере.

Учётные данные сохраняются в ~/.claude/.credentials.json с правами 0600. Относитесь к машине соответственно: любой, у кого есть оболочка от этого пользователя, может пользоваться вашей подпиской Claude. Для скриптов и CI есть также claude setup-token, который выводит токен на год — его задают как CLAUDE_CODE_OAUTH_TOKEN. Согласно документации по аутентификации, этот токен может только отправлять запросы к модели и не может запускать сессии Remote Control.

6. Поддерживайте работу

Всё, что вы запускаете на переднем плане SSH-сессии, умирает вместе с подключением. Обычное решение — tmux:

sudo apt install tmux
tmux new -s work
# start claude, then detach with Ctrl-B then D
tmux attach -t work

Можно отключиться, потерять связь, переподключиться через несколько часов и снова подключиться к сессии — она останется нетронутой. Но перезагрузку tmux не переживает. После неё claude --continue подхватывает последний разговор в этой папке. Другие варианты, включая systemd и демоны сессий, описаны в нашем руководстве о том, как Claude Code продолжает работать после закрытия ноутбука.

7. Та же машина, больше агентов

Сервер, на котором работает Claude Code, может запускать рядом и других агентов для кода. Каждый устанавливается в ваш домашний каталог и хранит свой вход, так что они не мешают друг другу. Оставьте запас RAM для каждого, кто работает одновременно.

Источники: аутентификация Codex, документация OpenCode, документация Grok Build, установка Antigravity CLI, проверено в октябре 2026 года. Для Codex и Antigravity есть отдельные пошаговые руководства: Codex CLI на VPS и Antigravity CLI на сервере. Gemini CLI больше не вариант для личных аккаунтов Google, и Antigravity CLI — замена от Google.

8. Доступ с телефона

Есть три способа — от самого ручного до наименее ручного:

SSH-приложение и tmux. Termius, Blink или любой другой клиент, подключённый к вашей сессии tmux. Это бесплатно и полноценно, но вы управляете полноэкранным терминалом с экранной клавиатуры. Вот как это выглядит в сравнении.

Remote Control. Запустите claude remote-control внутри tmux и откройте сессию на вкладке Code в приложении Claude. Он входит в Pro, Max, Team и Enterprise. Документация Anthropic советует tmux или screen именно для этого случая. Работает только для Claude, а запросы разрешений, которые выдаёт сессия, приходят на телефон, и вы отвечаете на них оттуда. Переключить сессию в Auto или Bypass permissions из приложения нельзя.

Maude. Maude выполняет за вас шаги 4 и 6, а шаг 5 переезжает на ваш телефон. Вы добавляете сервер по адресу, вставкой команды ssh … или сканированием QR-кода из curl -fsSL https://maude.pilotdev.fr/setup | sh. Если вы вошли как root, кнопка создаст пользователя без root из шага 2 за вас. Затем Maude разворачивает по SSH собственный демон и устанавливает каждого агента в проверенной и зафиксированной нами версии. В Claude, Codex или любого другого агента вы входите с телефона. Сессии продолжают работать на сервере, когда приложение закрыто, а сервер сам подключается к ретранслятору Maude, так что всё работает за NAT без открытого порта.

9. Решите вопрос с разрешениями

Теперь интересный вопрос: сколько вы позволите ему делать без присмотра? Сервер, который можно пересобрать, — правильное место, чтобы ослабить разрешения, если вы действительно относитесь к нему как к одноразовому. Режим auto в Claude Code, где безопасные действия одобряет классификатор, закрывает большую часть разрыва. У полного bypass свои правила, включая ограничение для root из шага 2. Им посвящена отдельная страница: как безопасно запускать Claude Code с полными правами.

Управление с телефона

Когда сервер готов, статья Claude Code на телефоне объясняет, как им управляет Maude. Если Claude — не единственный ваш агент, начните с обзора агентов.

Часто задаваемые вопросы

Что изменилось

• 1 октября 2026 г. — Установка переведена на нативный установщик Anthropic (Node.js больше не нужен); рекомендации по RAM приведены к документированному минимуму в 4 ГБ; добавлены вход со вставкой кода без браузера и setup-token; новый раздел о запуске Codex, OpenCode, Grok Build и Antigravity на той же машине.
• 25 июля 2026 г. — Первая публикация.