Claude Code на VPS: агент, который работает без вашего ноутбука

Проблема: агент привязан к вашей машине

Claude Code — это агент Anthropic для работы с кодом, и он не похож на подсказки в редакторе. Это отдельная программа в терминале: вы ставите задачу словами, а она сама читает файлы, ищет по коду, правит, запускает тесты и коммитит. Работа идёт минутами, иногда десятками минут, и всё это время процесс должен быть жив.

Отсюда четыре неудобства, с которыми сталкивается каждый, кто пользуется им всерьёз.

Отдельный VPS закрывает все четыре пункта разом. Агент работает на машине, которая не выключается; если сервер отведён только под него, ломать там нечего; подойти к нему можно с любого устройства, где есть SSH; а проект и его окружение — прямо под рукой.

Что понадобится

Шаг 1. Отдельный пользователь и своп

Ставить агента под root не надо, и причин на это две. Первая техническая: если запустить установщик из корня файловой системы, он начинает сканировать её целиком и на слабой машине зависает. Вторая важнее: агент запускает команды в shell, и пусть он делает это с правами обычного пользователя, а не администратора.

adduser dev
usermod -aG sudo dev
cp -r ~/.ssh /home/dev/
chown -R dev:dev /home/dev/.ssh

Первая команда заведёт пользователя dev и спросит пароль, вторая даст ему право на sudo, две последние скопируют ваш SSH-ключ, чтобы заходить сразу под новой учёткой. Если вы входите на сервер по паролю, а не по ключу, копирование пропустите — но лучше сначала настроить вход по ключу, об этом есть отдельная статья.

Дальше зайдите на сервер уже под dev и поставьте то, что понадобится в следующих шагах:

sudo apt update
sudo apt install -y git tmux

Затем — минимальный файрвол. Наружу у этого сервера ничего смотреть не должно, кроме SSH:

sudo ufw allow 22/tcp
sudo ufw enable

Вторая команда переспросит, не оборвёт ли включение файрвола ваше SSH-соединение. Отвечайте y: порт 22 разрешён первой строкой, и связь не пропадёт.

И своп. Установщику Claude Code нужно примерно 512 МБ свободной памяти; если их нет, его убивает OOM-killer и установка обрывается с кодом 137. На маленьком сервере, где память уже занята базой и приложением, это случается легко, поэтому своп-файл делаем заранее:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Последняя строка нужна, чтобы своп подключался после перезагрузки. Проверить, что он работает: free -h — в строке Swap появятся 2 ГБ.

Шаг 2. Установка

Официальный установщик — одна команда. Выполнять её нужно от пользователя dev и обязательно из домашней папки, а не из корня:

cd ~
curl -fsSL https://claude.ai/install.sh | bash

Скрипт скачает бинарник в ~/.local/share/claude/versions/ и поставит на него симлинк ~/.local/bin/claude. В конце он почти наверняка напишет предупреждение:

⚠ Setup notes:
  ● Native installation exists but ~/.local/bin is not in your PATH.

Пугаться не нужно. Ubuntu добавляет ~/.local/bin в PATH автоматически, но только если папка существовала на момент входа в систему — а до установки её не было. Поэтому просто выйдите и зайдите по SSH заново:

exit
ssh dev@ВАШ_IP
claude --version

Должна напечататься версия вида 2.1.246 (Claude Code). Если вместо неё вы видите bash: claude: command not found, значит автоматика не сработала — пропишите путь руками:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Полную диагностику установки печатает отдельная команда — она ничего не запускает и не меняет, только показывает состояние:

claude doctor

Claude Code doctor

Running: native (2.1.246)
Platform: linux-x64
Path: /home/dev/.local/share/claude/versions/2.1.246
Config install method: native
Search: OK (bundled)
Auto-updates: enabled
Auto-update channel: latest

No installation issues found.

Шаг 3. Вход в аккаунт, когда браузера нет

Это единственное место, где установка на сервер отличается от установки на ноутбук, и именно здесь обычно застревают. Claude Code входит в аккаунт через браузер, а на сервере браузера нет. Штатное решение — команда, которая читает код авторизации из обычного ввода:

claude auth login

Она напечатает длинную ссылку и остановится в ожидании:

Opening browser to sign in…
If the browser didn't open, visit: https://claude.com/cai/oauth/authorize?code=true&client_id=…
Paste code here if prompted >

Дальше три действия:

1. Скопируйте ссылку целиком и откройте её в браузере на своей машине. Ссылка длинная, и терминал может перенести её на несколько строк — следите, чтобы в буфер попало всё до последнего символа.
2. Войдите в аккаунт Claude и подтвердите доступ. Браузер покажет код авторизации.
3. Вставьте код в терминал сервера и нажмите Enter. Появится Login successful.

Код живёт недолго, поэтому не откладывайте вставку: если между шагами прошло много времени, вы получите OAuth error: Invalid code и всё придётся повторить. Проверить результат:

claude auth status

{
  "loggedIn": false,
  "authMethod": "none",
  "apiProvider": "firstParty",
  "analyticsDisabled": false
}

После успешного входа loggedIn станет true. Если вы заходите не по подписке, а по аккаунту Claude Console, добавьте флаг: claude auth login --console.

Для скриптов и запусков по расписанию есть второй способ — годовой токен. Команда claude setup-token проводит через тот же вход в браузере, но вместо сохранения печатает токен в терминал; его кладут в переменную окружения:

export CLAUDE_CODE_OAUTH_TOKEN=ВАШ_ТОКЕН

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

Шаг 4. Первый запуск в проекте

Claude Code всегда запускают из папки проекта — оттуда он берёт контекст, права на файлы и настройки. Заберите проект на сервер и зайдите внутрь:

mkdir -p ~/projects && cd ~/projects
git clone https://github.com/ВАШ_АККАУНТ/myapp.git
cd myapp
claude

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

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

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

Шаг 5. tmux — чтобы обрыв связи не убивал задачу

Лечится это tmux — программой, которая держит терминальные сессии отдельно от вашего подключения. Вы отцепляетесь, а всё, что внутри, продолжает работать.

tmux new -s claude

Вы попадёте в новую сессию с именем claude — внешне это обычный терминал с полоской внизу. Запускайте агента прямо в ней:

cd ~/projects/myapp
claude

Дальше три сочетания:

Проверьте связку до того, как доверите ей настоящую работу: поставьте агенту любую задачу на пару минут, нажмите Ctrl+B, D, закройте окно терминала целиком, зайдите заново и сделайте tmux attach -t claude. Задача должна оказаться доделанной.

Перезагрузку сервера tmux не переживает — сессии создаются заново. Если хочется, чтобы пустая сессия поднималась автоматически, добавьте строку в crontab -e:

@reboot /usr/bin/tmux new-session -d -s claude -c /home/dev/projects/myapp

После перезагрузки достаточно будет сделать tmux attach -t claude и запустить claude — папка уже будет правильной. А чтобы продолжить прерванный разговор, а не начинать с нуля, запускайте claude --continue: история сессий лежит на диске и перезагрузку переживает спокойно.

Шаг 6. Управление с телефона

У Claude Code есть режим Remote Control: сессия остаётся на вашем сервере — там же файлы, там же команды, — но писать ей можно из приложения Claude на телефоне или из браузера на claude.ai/code. Это второй по важности повод держать агента на VPS: сервер не спит, а вы подключаетесь к нему откуда угодно и без SSH-клиента.

Два условия:

• нужна подписка Pro, Max, Team или Enterprise — с API-ключом режим не работает;
• в папке проекта нужно хотя бы раз запустить claude и принять диалог доверия, иначе подключиться будет не к чему.

Запускается флагом — лучше всего внутри той же сессии tmux:

cd ~/projects/myapp
claude --remote-control "myapp на сервере"

Это обычная интерактивная сессия, просто доступная ещё и снаружи: печатать можно и в терминале, и с телефона, история везде одна. Внизу под полем ввода появится индикатор /rc active — выберите его стрелкой вниз и нажмите Enter, чтобы открыть панель со ссылкой на сессию и QR-кодом. Наведите на код камеру телефона, и вы окажетесь в этом же разговоре.

Если терминал на сервере вам вообще не нужен, есть второй режим — без дефисов в начале:

claude remote-control --name "myapp"

Процесс работает как сервер и только ждёт подключений; нажатие пробела покажет QR-код. Внутри tmux это превращается в постоянно доступного агента: подключился с телефона, поставил задачу, закрыл приложение.

Шаг 7. Что агенту разрешать

По умолчанию Claude Code спрашивает подтверждение перед каждой командой в shell и перед каждой правкой файла; без вопросов он только читает. Это нормальный режим для работы за столом, но на сервере, куда вы заходите раз в час, каждое подтверждение — остановка на час.

Соблазн решить это флагом --dangerously-skip-permissions («не спрашивай ничего») велик, и название выбрано не случайно. На сервере с боевой базой или рабочими ключами так делать не стоит. Правильный ответ — песочница: команды выполняются с настоящими ограничениями операционной системы, а не на честном слове.

На Linux песочнице нужны два пакета:

sudo apt install -y bubblewrap socat

На Ubuntu 24.04 и новее есть дополнительная деталь: политика AppArmor по умолчанию запрещает bwrap создавать пространства имён, без которых изоляция не работает. Проверьте:

sysctl kernel.apparmor_restrict_unprivileged_userns

Если ответ 0 или команда говорит, что такого параметра нет, всё уже в порядке. Если 1 — добавьте профиль:

sudo tee /etc/apparmor.d/bwrap > /dev/null <<'EOF'
abi <abi/4.0>,
include <tunables/global>

profile bwrap /usr/bin/bwrap flags=(unconfined) {
  userns,
  include if exists <local/bwrap>
}
EOF

sudo systemctl reload apparmor

Профиль разрешает создавать пространства имён самому bwrap, а не тем командам, которые он потом запускает внутри. После этого перезапустите Claude Code и выполните в сессии:

/sandbox

Откроется панель с вкладками. На вкладке Mode выберите автоматическое разрешение — тогда команды, которые удалось запустить в песочнице, выполняются без вопросов. Внутри песочницы команда может писать только в папку проекта и во временный каталог сессии, а на первый выход в новый домен Claude Code всё равно спросит разрешение. Что не удаётся изолировать — по-прежнему идёт через обычные подтверждения. Если единственная вкладка в панели — Dependencies, значит какой-то пакет всё ещё не установлен.

Выбор в панели сохраняется в .claude/settings.local.json конкретного проекта. Чтобы песочница работала во всех проектах сразу, пропишите её в личных настройках:

{
  "sandbox": {
    "enabled": true
  }
}

Задачи по расписанию

Раз агент живёт на сервере, ему можно давать работу и без вас. Флаг -p запускает Claude Code без интерактивного режима: один запрос, ответ в стандартный вывод, выход.

cd ~/projects/myapp
claude -p "Посмотри git log за последние сутки и напиши, что изменилось, в трёх пунктах" \
  --allowedTools "Read,Bash(git log *),Bash(git diff *)"

Флаг --allowedTools здесь не украшение, а необходимость. В режиме -p спрашивать разрешение не у кого, поэтому команду, которая не разрешена явно, агент выполнить не сможет — и вернёт вам не результат, а объяснение, почему не смог. Пробел перед * важен: Bash(git log *) разрешает команды, начинающиеся с git log, а Bash(git log*) заодно разрешило бы и git log-something.

Такой вызов кладётся в cron как любая другая команда. Один нюанс: cron запускается с урезанным окружением и ~/.local/bin в его PATH не входит, поэтому путь пишем полностью:

0 9 * * 1-5 cd /home/dev/projects/myapp && /home/dev/.local/bin/claude -p "Проверь, какие зависимости отстали от свежих версий, и перечисли самые важные" --allowedTools "Read,Bash(npm outdated),Bash(npm outdated *)" < /dev/null >> /home/dev/claude-cron.log 2>&1

Две детали, без которых строка работает хуже, чем могла бы. < /dev/null нужен потому, что в режиме -p Claude Code сначала ждёт данные на стандартном вводе и, не дождавшись, три секунды спустя пишет в лог предупреждение; явное перенаправление это убирает.

А команда npm outdated разрешена двумя записями не по ошибке: Bash(npm outdated) — это точное совпадение, а Bash(npm outdated *) — совпадение по началу строки. Одна другую не заменяет, поэтому, когда команду можно вызвать и с аргументами, и без них, пишут обе.

Если нужен машинно-читаемый ответ, добавьте --output-format json — в поле result будет текст, а рядом окажутся идентификатор сессии и расчётная стоимость запроса. Разбирать его удобно утилитой jq (sudo apt install -y jq):

claude -p "Одной строкой: чем занимается этот проект?" --output-format json | jq -r '.result'

И ещё одна тонкость на будущее: у -p есть режим --bare, который пропускает загрузку хуков, MCP-серверов, скиллов и CLAUDE.md и потому стартует быстрее. В нём Claude Code не читает сохранённый вход вообще — авторизоваться придётся через ANTHROPIC_API_KEY.

Сколько это стоит

Расходов два, и они не связаны между собой.

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

Частые проблемы

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

curl -sI https://downloads.claude.ai/claude-code-releases/latest

unset ANTHROPIC_API_KEY
grep -n ANTHROPIC_API_KEY ~/.bashrc ~/.profile 2>/dev/null