tanaka.host  / блог
RSSЗаказать VPS
Введение/ИИ на сервере

Claude Code на VPS: установка, вход и управление из приложения (Remote Control)

Ставим Claude Code на сервер под отдельным пользователем, входим через браузер на ПК, запускаем сессию в tmux и управляем ею из приложения Claude. Ubuntu 22.04/24.04, Debian 12.

23 октября 2026 г.·5 мин чтения·claude-code, anthropic, tmux, ai-agent

Claude Code — ИИ-ассистент для разработки от Anthropic, который работает в терминале. На сервере он пишет и правит код, запускает команды и помогает настраивать программы. С функцией Remote Control сессией на сервере можно управлять из приложения Claude на компьютере или телефоне, не держа SSH открытым.

Что нужно

Что Требования
Сервер Ubuntu 22.04, 24.04 или Debian 12, от 4 ГБ ОЗУ — сервер на tanaka.host
Аккаунт Claude Pro, Max, Team или Enterprise. Бесплатный план Claude Code не включает
Компьютер Браузер для входа и приложение Claude на ПК или телефоне для Remote Control
Доступ SSH к серверу — как подключиться

1. Подготовка сервера

Под root установите git и tmux и создайте отдельного пользователя. Запускать Claude Code от root не нужно и небезопасно.

apt update && apt install -y git tmux
adduser dev

Дальше работайте под этим пользователем: su - dev или сразу ssh dev@IP-адрес.

Нужен ли sudo? Если Claude Code должен ставить пакеты или менять системные настройки — usermod -aG sudo dev; каждый такой запуск всё равно потребует вашего подтверждения и пароля. Если задача только код в домашнем каталоге, sudo лучше не давать.

2. Установка

Под пользователем dev:

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

Проверьте:

claude --version
claude doctor

Если claude: command not found — перезайдите на сервер или source ~/.profile. Node.js ставить не нужно, обновления Claude Code ставит сам в фоне.

3. Вход в аккаунт

На сервере нет браузера, поэтому вход идёт через ваш компьютер. Три способа.

Через браузер на ПК (рекомендуется)

Только этот способ даёт Remote Control. Нужны компьютер с браузером и открытое SSH-подключение.

  1. Под dev введите claude, Enter.
  2. При первом запуске выберите оформление стрелками, Enter. Экраны с пояснениями — Enter.
  3. Способ входа — первый пункт, Claude account with subscription.
  4. Сервер не откроет браузер и покажет длинную ссылку. Нажмите c — ссылка скопируется. Если не вышло, выделите её мышью целиком (может занимать несколько строк).
  5. Вставьте ссылку в браузер на компьютере, войдите в аккаунт Claude, подтвердите кнопкой Authorize.
  6. Браузер покажет код — скопируйте кнопкой рядом.
  7. Вернитесь в окно сервера, в строку Paste code here if prompted вставьте код (Ctrl+Shift+V или Cmd+V, в некоторых SSH-клиентах — правой кнопкой) и Enter.
  8. Login successful. Enter — откроется Claude Code. На вопрос, доверяете ли вы файлам в папке, — Yes, proceed.

Код одноразовый. При ошибке или если прошло много времени — команда /login внутри Claude Code и шаги 3–8 заново.

Токен из Claude Code на ПК

Если Claude Code уже стоит на вашем компьютере, можно выпустить долгоживущий токен (около года). На компьютере claude setup-token, подтвердите в браузере, скопируйте токен. На сервере:

echo 'export CLAUDE_CODE_OAUTH_TOKEN=ваш-токен' >> ~/.bashrc && source ~/.bashrc

С токеном Remote Control не работает. Claude Code отвечает на запросы, но запустить управление из приложения не сможет. Планируете работать через приложение — входите через браузер.

Ключ API

Для оплаты по тарифам Anthropic Console создайте ключ на platform.claude.com:

echo 'export ANTHROPIC_API_KEY=ваш-ключ' >> ~/.bashrc && source ~/.bashrc

С ключом API Remote Control тоже недоступен — функция работает только с подпиской Claude.

4. Работа в терминале

mkdir -p ~/project && cd ~/project
claude

Опишите задачу словами, например «создай простой сайт на Flask и запусти его на порту 5000». Перед изменением файлов и запуском команд Claude Code спрашивает разрешения.

Команда Что делает
claude Новая сессия в текущем каталоге
claude --continue Продолжить последнюю сессию
claude --resume Выбрать сессию из списка
/remote-control Открыть текущую сессию для управления из приложения
Shift+Tab Переключить режим разрешений
/exit Выйти

5. Remote Control: работа из приложения

Remote Control держит сессию на сервере, а вы пишете ей из приложения Claude на компьютере или телефоне. Чтобы сессия не умирала при обрыве SSH, запускайте её в tmux.

Создайте окно tmux и запустите Remote Control в каталоге проекта:

tmux new -s claude
cd ~/project && claude remote-control --name "Мой сервер"

При первом запуске подтвердите включение функции, введя y.

Отключитесь от tmux: Ctrl+B, затем D. Сессия продолжит работать, даже если закрыть SSH.

Подключитесь одним из способов:

  • в приложении Claude на компьютере или телефоне откройте раздел Code и выберите сессию «Мой сервер» — у работающей горит зелёный индикатор;
  • отсканируйте QR-код телефоном — чтобы его показать, вернитесь в tmux и нажмите пробел;
  • откройте ссылку вида https://claude.ai/code/..., которую Claude Code вывел в терминал.

Вернуться в tmux: tmux attach -t claude.

Что важно знать:

  • Порты открывать не нужно. Сервер сам подключается к Anthropic по HTTPS, входящих соединений нет.
  • Нужна подписка. Pro, Max, Team или Enterprise; в Team и Enterprise функцию сначала включает владелец организации.
  • Остановленную сессию можно возобновить: claude remote-control --continue.
  • Уже открытую сессию можно перевести в Remote Control командой /remote-control прямо внутри Claude Code.
  • Подключиться к серверу по SSH прямо из приложения Claude на ПК пока нельзя — это бета только для корпоративных клиентов на облаках Amazon, Google и Microsoft. Для обычной подписки — Remote Control.

Безопасность

  • Отдельный пользователь, не root.
  • Без флага --dangerously-skip-permissions на рабочем сервере — с ним Claude Code без вопросов может изменить или удалить любые файлы пользователя. Режим для одноразовых контейнеров.
  • Хотите сначала увидеть план действий — режим планирования по Shift+Tab.
  • Данные входа лежат в ~/.claude/.credentials.json. Не давайте посторонним доступ к пользователю dev.
  • Вход по SSH-ключу и отключённый пароль.

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

Симптом Что сделать
claude: command not found Перезайдите на сервер или source ~/.profile
Браузер на сервере не открывается Нормально — скопируйте ссылку клавишей c и откройте на компьютере
Remote Control не запускается Войдите через браузер командой /login — с токеном и ключом API функция не работает
Сессия пропала после отключения SSH Запускайте внутри tmux, как в шаге 5
Тормозит или не хватает памяти Claude Code нужно от 4 ГБ ОЗУ — возьмите сервер побольше

Документация — code.claude.com/docs. Альтернативы с бесплатными моделями — OpenCode.