> Полный список статей есть в [llms.txt](https://docs.f3cloud.com/llms.txt). Markdown-версия есть у каждой страницы, достаточно добавить .md к её адресу. Эта страница в Markdown: [https://docs.f3cloud.com/ru/software-setup/claude-code-na-vps.md](https://docs.f3cloud.com/ru/software-setup/claude-code-na-vps.md).

# Claude Code на VPS – установка, вход и работа через приложение

Как установить Claude Code на VPS, войти в аккаунт на сервере без браузера и управлять сессией с компьютера или телефона через приложение Claude с помощью Remote Control.

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

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

| Что          | Требования                                                                       |
| ------------ | -------------------------------------------------------------------------------- |
| Сервер       | Ubuntu 22.04, 24.04 или Debian 12, от 4 ГБ ОЗУ – подойдёт тариф **DE-RZ9-2**     |
| Аккаунт      | Claude Pro, Max, Team или Enterprise. Бесплатный план Claude Code не включает    |
| Компьютер    | Браузер для входа и приложение Claude на ПК или телефоне для Remote Control      |
| Доступ       | SSH к серверу – как подключиться, описано в [статье про Termius](https://docs.f3cloud.com/ru/vps/termius-connection.md) |

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

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

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

Дальше работайте под этим пользователем – переключитесь командой `su - dev` или подключайтесь к серверу сразу как `ssh dev@IP-адрес`.

<details>

<summary>Нужно ли давать пользователю права sudo</summary>

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

</details>

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

Выполните официальный установщик под пользователем `dev`:

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

Проверьте установку:

```bash
claude --version
claude doctor
```

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

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

На сервере нет браузера, поэтому вход проходит через ваш компьютер. Выберите подходящий способ.

#### Через браузер на ПК

Мы рекомендуем этот способ, потому что только с ним работает управление из приложения (Remote Control). Понадобятся компьютер с браузером и открытое подключение к серверу по SSH.

1. **Запустите Claude Code.** Подключитесь к серверу под пользователем `dev`, введите `claude` и нажмите Enter.
2. **Ответьте на первые вопросы.** При первом запуске Claude Code предложит выбрать оформление. Выберите любое стрелками на клавиатуре и нажмите Enter. Если появятся экраны с пояснениями, просто нажимайте Enter.
3. **Выберите способ входа.** В списке выберите первый пункт – вход через аккаунт Claude с подпиской (Claude account with subscription) – и нажмите Enter.
4. **Скопируйте ссылку.** Сервер не может открыть браузер, поэтому Claude Code покажет длинную ссылку. Нажмите клавишу `c`, и ссылка скопируется. Если не получилось, выделите ссылку мышью целиком (она может занимать несколько строк) и скопируйте её.
5. **Откройте ссылку на компьютере.** Вставьте её в адресную строку браузера, войдите в свой аккаунт Claude и подтвердите доступ кнопкой Authorize.
6. **Скопируйте код.** После подтверждения браузер покажет код. Скопируйте его кнопкой рядом с кодом.
7. **Вставьте код на сервере.** Вернитесь в окно с сервером, там будет строка «Paste code here if prompted». Вставьте код (в Termius – правой кнопкой мыши, в других программах – сочетанием `Ctrl+Shift+V` или `Cmd+V`) и нажмите Enter.
8. **Готово.** Появится сообщение `Login successful`. Нажмите Enter, и откроется Claude Code. Если он спросит, доверяете ли вы файлам в этой папке, выберите «Yes, proceed».

> **Совет.**
>
> Код одноразовый. Если появилась ошибка или с момента входа прошло много времени, введите в Claude Code команду `/login` и пройдите шаги 3–8 заново.

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

Если Claude Code уже установлен на вашем компьютере, можно выпустить долгоживущий токен (действует около года).

1. На **компьютере** выполните `claude setup-token`, подтвердите доступ в браузере и скопируйте токен.
2. На **сервере** сохраните токен в настройках оболочки:

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

> **Внимание.**
>
> С таким токеном Claude Code отвечает на запросы, но **не может запустить Remote Control**. Если планируете работать через приложение, войдите через браузер.

#### Ключ API

Для оплаты по тарифам Anthropic Console создайте ключ на [platform.claude.com](https://platform.claude.com) и сохраните его на сервере:

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

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

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

Перейдите в каталог проекта и запустите Claude Code:

```bash
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.

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

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

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

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

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

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

Вернуться в окно tmux можно командой `tmux attach -t claude`.

<details>

<summary>Как это работает и что нужно знать</summary>

* **Порты открывать не нужно.** Сервер сам подключается к Anthropic по HTTPS, входящих подключений нет.
* **Нужна подписка.** Remote Control работает при входе через аккаунт Claude Pro, Max, Team или Enterprise. В Team и Enterprise функцию сначала должен включить владелец организации.
* **Сессию можно продолжить.** После остановки её можно возобновить командой `claude remote-control --continue`.
* **Уже открытую сессию** можно перевести в Remote Control командой `/remote-control` прямо в Claude Code.

</details>

> **Примечание.**
>
> **Подключиться к серверу по SSH прямо из приложения Claude на ПК пока нельзя.** Такие подключения сейчас в бета-версии и доступны только корпоративным клиентам, работающим через облачные платформы Amazon, Google и Microsoft. Для обычной подписки используйте Remote Control из этого шага.

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

* **Отдельный пользователь** – не запускайте Claude Code от root.
* **Без флага `--dangerously-skip-permissions`** на рабочем сервере – с ним Claude Code без вопросов может изменить или удалить любые файлы пользователя. Этот режим подходит только для одноразовых контейнеров.
* **Режим планирования** – если хотите сначала увидеть план действий, переключитесь в него сочетанием `Shift+Tab`.
* **Данные входа** хранятся в файле `~/.claude/.credentials.json`. Не давайте посторонним доступ к пользователю, под которым работает Claude Code.
* **SSH по ключам** – настройте вход по ключам и отключите вход по паролю по нашей [инструкции по защите сервера](https://docs.f3cloud.com/ru/client-area/kak-zashitit-server-vps-vds-ot-nesankcionirovannogo-dostupa.md).

### Если что-то не работает

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