Недавно ставил Claude Code на свежий VPS. Потратил 25 минут, из них десять - на авторизацию. В статье расскажу, что реально сработало, и где я наступил на грабли. Если коротко: сервер, SSH, npm, tmux - и готово. Но без пары подводных камней не обошлось.
Почему Claude Code стоит поднимать именно на сервере
Claude Code - это терминальный агент Anthropic. Он не похож на обычный чат: умеет подключаться к репозиторию, читать файлы, запускать тесты, править код и коммитить. Работает в терминале, поэтому на удалённом Linux-сервере ему даже удобнее, чем на ноутбуке. Во-первых, сервер всегда включён. Во-вторых, там уже есть окружение для твоего проекта - зависимости, база данных, конфиги. Можно дать агенту задачу, отключиться, а потом через час получить готовый результат.
Если ты вайбкодишь серьезно - ставь Claude Code на VPS. Это не маркетинговый разгон, а реальный паттерн из моей практики. Я перенес на сервер пачку скриптов. Claude Code разбирает их в три раза быстрее, чем локально, потому что не тратит время на перенос файлов туда-обратно.
Понятно, что подходит не каждому. Если у тебя сложный локальный проект с GUI, интеграциями с Windows, то сервер для автономного агента может быть излишен. Но для веб-разработки, деплоя, бэкенда - это золотая жила.
Что понадобится: от VPS до Node.js
Минимально нужно три вещи: доступ к серверу с Ubuntu, SSH-ключ для входа, Node.js 18+. Последний нужен, потому что Claude Code ставится через npm. Через официальный скрипт тоже можно, но серверный вариант удобнее, когда надо быстро переключаться между версиями.
Если говорить про конфигурацию, не гонись за дешёвым VPS с 512 MB RAM. Claude Code - это не тупой запрос в REST API, а агент, который держит в контексте состояние проекта. Для комфортной работы нужно хотя бы 2 GB RAM и 1 vCPU. Если планируешь запускать несколько сессий с субагентами, бери с запасом: 4 GB и 2 vCPU. Всё равно выйдет дешевле, чем арендовать какую-нибудь мощную GPU-машину.
Из софта на сервере заранее ставь git, curl и build-essential. Не потому, что я жадный, а потому что Claude Code часто сам вызывает git и другие утилиты. Отсутствие базовых пакетов - самая частая причина падений в первые минуты.
Шаг 1: Подключение к серверу по SSH
Открываешь локальный терминал. В панели управления твоего VPS есть строка вида ssh root@203.0.113.7 - скопируй и вставь. Если работаешь из Windows, подойдёт PowerShell или Windows Terminal. Команда одна и та же.
При первом подключении увидишь предупреждение про неизвестный хост. Нормальная история. Набираешь yes и жмешь Enter. Дальше попросит пароль - либо вводишь, либо (лучше) используешь SSH-ключ. С ключом вход происходит вообще без пароля.
После входа ты уже находишься на сервере. Никакого графического интерфейса - только bash. Привыкай, потому что все манипуляции с Claude Code будут идти отсюда.
Шаг 2: Ставим базовый софт: Node.js, Git, tmux
В свежей Ubuntu часто не хватает нужных пакетов. Проверяем версии:
node -v && git --version
Если node не найден - ставим из ППА или стандартного apt. На момент написания статьи актуальная LTS-версия - 20.x.
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt install -y nodejs
Также ставим git и tmux:
sudo apt install git tmux -y
Ничего сложного, но экономит нервы в середине установки.
Шаг 3: Устанавливаем Claude Code через npm
Теперь главное. В терминале пишем:
npm install -g @anthropic-ai/claude-code
Через минуту появится версия. Проверяем:
claude --version
Если команда не находится, перезапусти терминал или экспортнируй путь: export PATH="$PATH:$(npm prefix -g)/bin". После этого всё заработает.
Официальная документация Anthropic рекомендует именно этот способ для Linux-серверов. Он чуть проще, чем скачивать бинарный релиз с GitHub.
Шаг 4: Авторизация Claude Code без танцев с бубном
Когда запустишь claude в первый раз, тебя попросят войти в аккаунт. На экране будет ссылка на auth.claude.ai и восьмизначный код. На сервере браузера нет, поэтому открываем ссылку на своём локальном компьютере или телефоне, вводим код, подтверждаем доступ.
Тут многие спотыкаются, потому что ждут, что код сразу исчезнет. Код живёт пару минут, поэтому не отвлекайся. Если не успел - запусти claude ещё раз, он выдаст новый код.
После подтверждения в терминале появится сообщение, что ты залогинен. Теперь claude можно использовать.
Важный момент: авторизация привязана к твоему Anthropic-аккаунту. На сервере ты также должен быть залогинен в GitHub, если хочешь, чтобы Claude делал коммиты напрямую. Сделай:
gh auth login
Следуй шагам - и агент получит доступ к репозиториям.
Шаг 5: Запуск в tmux и алиас для быстрого входа
Если закрыть SSH, Claude Code умрет, не сохранив прогресс. Поэтому используй tmux.
Сначала установи и создай сессию:
sudo apt install tmux -y
tmux new -s claude
Внутри запусти claude. Чтобы отключиться от сессии, нажми Ctrl+b, затем d. Сессия останется работать в фоне. Подключиться обратно:
tmux attach -t claude
Чтобы не набирать каждый раз длинную команду, я добавил алиас в ~/.bashrc:
echo 'alias tm="tmux attach -t claude || tmux new -s claude"' >> ~/.bashrc && source ~/.bashrc
Теперь просто tm - и ты либо прикрепишся к существующей сессии, либо создашь новую. Это реально ускоряет работу.
Работа с несколькими проектами и сессиями
Claude Code позволяет подключаться к разным папкам. Если у тебя два проекта на сервере, не заставляй их делить одну сессию. Создай tmux-сессии с уникальными именами:
tmux new -s project1
tmux new -s project2
Внутри каждой запусти claude и работай с соответствующим репозиторием. Так агенты не будут путать контекст, а ты сможешь параллельно мониторить несколько задач.
Если сервер с 4+ GB RAM, можно запустить сразу несколько сессий Claude Code с субагентами. Бывает, что один агент делает миграцию, другой ревьюит код, третий пишет тесты. Выглядит как маленькая команда без перерывов.
Типичные ошибки при установке
Вот что чаще всего ломается у новичков, судя по обсуждениям на Хабре:
1. Забыли поставить Node.js. claude не находится - хотя не ошибка, а банальное отсутствие бинарника.
2. Авторизация истекает. Ввели код слишком медленно - перезапустите установку.
3. Нет доступа к GitHub. Claude пытается сделать git push, а ключи не настроены. Решение - gh auth login или git config --global user.name.
4. Не хватает RAM. Сервер на 512 MB задыхается уже на первом запросе, потому что агент держит в контексте длинный диалог. Решение - не жадничать при выборе тарифа.
5. Маленький диск. Claude Code скачает зависимости - и место на диске тает. 20 GB минимум.
Справился со всеми пунктами - установка проходит за 15-20 минут.
Личный кейс: что я запустил на сервере
У меня есть VPS на 4 GB RAM, крутится несколько pet-проектов. На прошлой неделе я поставил Claude Code в /var/www/myapp. Дал ему задачу: “открой tag 1.2, сделай миграцию на новую схему и обнови тесты”. Честно, сначала было жутковато отпускать его одного. Но когда вернулся через час, он уже закоммитил изменения, оставил подробный лог и не поломал прод. Да, были неидеальные решения, но он сам предложил рефакторинг, а я принял merge request.
Теперь на сервере постоянно крутится сессия claude в tmux. Когда нужна новая задача - просто подключаюсь, пишу prompt, отключаюсь и прихожу позже. Это как ночная смена, только без человеческого фактора.
Быстрая альтернатива: Claude для России без сервера
Вся инструкция выше хороша для тех, кто дружит с терминалом. Но иногда задача совершенно другая - не кодить, а просто воспользоваться Claude для контента, аналитики или генерации идей. И тут поднимать сервер из-за одного чата - перебор.
Есть сервис 3GPT, который даёт доступ к последним флагманским моделям прямо из России. Без VPN, без иностранных карт. Внутри можно выбрать Claude Opus 5.5, Claude Fable 5.1, а также Chat GPT 6 или даже модель для картинок Nano Banana. Всё это работает в одном окне, как мессенджер, через браузер.
Цена смешная - от 149 ₽. Оплата российской картой, СБП или криптой. Это важно, потому что официальная подписка Anthropic из России сейчас недоступна, а VPN только добавляет головной боли.
Для повседневных задач - продающие тексты, сайты, идеи для постов, создание картинок - 3GPT закрывает все случаи. Модель переключается на лету, так что можно сравнить ответы Claude и GPT без перелогинов.
Ещё удобная фишка - готовые ИИ-агенты на странице 3seller.com/ai/agents. Выбираешь агента под задачу, и он работает в чате с твоим аккаунтом 3GPT. Внутри агента можно сменить модель - и поведение тут же меняется. Как минимум это экономит массу времени на формулировке промптов.
Так что если не хочешь возиться с VPS, но хочешь полноценный доступ к Claude и другим нейросетям из России, просто загляни на официальный сайт: https://3seller.com/3gpt.
Что выбрать: сервер или онлайн-роутер
Однозначного ответа нет. Если тебе нужен автономный агент для репозитория, который исполнит кучу задач без твоего присутствия, - ставь Claude Code на сервер по описанной схеме. Это реальная промышленная автоматизация. Например, я включаю агента на рефакторинг утром, а после обеда уже принимаю pull request.
Если тебе нужен живой разговор с моделью, помощь в написании текста или генерация идей - онлайн-сервис будет проще и быстрее. Не нужно ни SSH, ни Node.js, ни авторизаций. Зашёл, выбрал Claude, получил ответ.
А многие комбинируют: держат Claude Code на сервере для рутины и используют 3GPT для быстрых консультаций. Такой гибрид стоит копейки и закрывает все сценарии, которые я только встречаю в реальной работе.