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. Кроки 4 і 6 Maude виконує за вас, а крок 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 р. — Перша публікація.