Свой AI-агент на VPS за 3 шага

Подготовка: создаём цифровой след

Claude – зарубежный сервис. Для регистрации и оплаты из РФ нужно подготовиться. Ваша задача – создать цифровой след, который показывает, что вы находитесь в Казахстане или Европе.

Почта Gmail

Claude больше всего доверяет аккаунтам Google. Зарегистрировать Gmail из РФ непросто, поэтому проще купить готовый аккаунт.

Готовые Gmail-аккаунты: https://ggsel.net/catalog/gmail

Номер телефона

Claude запрашивает SMS-подтверждение при регистрации. Подойдёт номер Казахстана – его можно купить как eSIM без KYC.

Где взять номер:

– https://ggsel.net/catalog/product/esim-kazaxstan-nomer-esim-esim-sms-bez-kyc-77-5095011 – eSIM Казахстан без KYC

– https://grizzlysms.com – виртуальные номера для SMS-верификации

Карта для оплаты

Из РФ оплатить зарубежные сервисы обычной картой не получится. Heleket – сервис, который выпускает карты для международных платежей.

Регистрация в Heleket: https://dash.heleket.com/ru/signup?ref=wOxaex

Доступ к зарубежным сервисам

Для регистрации Claude потребуется доступ с IP-адреса вне РФ. Используйте инструмент для смены геолокации – вы знаете какой. Выбирайте серверы Казахстана или Европы.

Почему Казахстан?

Две причины:

1. Claude не блокирует аккаунты из Казахстана

2. Нет дополнительных налогов на подписку. В Европе вы заплатите сверху 20–30% НДС

Регистрация в Claude

Переходите на claude.ai и регистрируйтесь через купленный Gmail. Подтверждаете номер Казахстана через SMS.

После регистрации – не торопитесь оплачивать. Сначала прогрейте аккаунт (подробнее – в следующей секции).

Лайфхак: оплата через AppStore

Надёжный способ – скачать приложение «Claude by Anthropic» из AppStore и оплатить подписку через Apple.

Для этого:

1. Смените страну AppStore на Казахстан – инструкция: https://t-j.ru/apple-region/

2. Скачайте «Claude by Anthropic»

3. Оплатите Max-подписку через Apple – $100/мес

При оплате через Apple аккаунты блокируют значительно реже.

Прогрев аккаунта

Не начинайте сразу с Claude Code. Новый аккаунт нужно прогреть – иначе рискуете получить блокировку.

Первые 2–3 дня пользуйтесь бесплатной версией Claude через браузер:

– Задавайте вопросы, ведите диалоги

– Пробуйте разные задачи – тексты, анализ, код

– Используйте Projects, загружайте файлы

– Заходите каждый день, создавайте историю активности

После 2–3 дней оплатите Max за $100/мес. И только после оплаты переходите к установке Claude Code на сервер.

Шаг 1: Арендовать VPS

VPS – виртуальный сервер в облаке. Выбирайте дата-центр в Европе: Германия, Финляндия или Голландия.

Провайдеры:

– VDSina – от $2.10/мес, Германия / Финляндия / Голландия. Ссылка: https://www.vdsina.com/?partner=6x47zemriu8q

– DigitalOcean – от $4/мес, Амстердам / Франкфурт. Ссылка: https://m.do.co/c/63cded1ddfa3

– Hetzner – от €3.79/мес, Фалькенштайн / Хельсинки. Ссылка: https://hetzner.com/cloud

– Timeweb – от ₽149/мес, Нидерланды / Польша. Ссылка: https://timeweb.cloud/r/pt392094

Минимальные параметры: 2 vCPU, 4 GB RAM, Ubuntu 22.04 или 24.04.

Шаг 2: Установить Claude Code

Подключаетесь к серверу по SSH. Одна команда ставит всё – Claude Code, Telegram Gateway, безопасность.

Инструкции по SSH для каждого провайдера:

– Timeweb – https://timeweb.cloud/docs/unix-guides/ssh

– VDSina – https://vdsina.ru/qa/q/kak-podklyuchitsya-k-serveru-po-ssh

– DigitalOcean – https://docs.digitalocean.com/products/droplets/how-to/connect-with-ssh/

– Hetzner – https://docs.hetzner.com/cloud/servers/getting-started/connecting-to-the-server/

Установщик автоматически:

– Создаёт пользователя edgelab (Claude Code не работает под root)

– Ставит Node.js 22, Python 3.12 и системные пакеты

– Устанавливает Claude Code через официальный установщик Anthropic

– Клонирует Telegram Gateway и создаёт шаблон конфига

– Настраивает файрвол (ufw) и защиту от брутфорса (fail2ban)

– Создаёт systemd-сервис для автозапуска

После установки – авторизуйте Claude Code:

Откроется ссылка авторизации. Откройте её с того же IP, с которого регистрировали аккаунт – это важно. Введите код. Готово – Claude Code подключён к вашей Max-подписке.

# Подключение к серверу
ssh root@<your-server-ip>

# Запуск установщика EdgeLab
curl -fsSL https://edgelab.su/install | bash

# Переключитесь на пользователя edgelab
su - edgelab

# Запустите авторизацию
claude

Покажи системную информацию:
1. ОС и версия ядра
2. Сколько RAM и CPU
3. Где я нахожусь (hostname, IP)
4. Создай файл ~/test-agent.md с текстом «Агент работает»

Если всё ок – подтверди в 2 предложениях.

Шаг 3: Подключить Telegram

Telegram становится пультом управления агентом. Пишете боту с телефона -- агент выполняет задачу на сервере.

Установщик уже поставил Gateway. Осталось создать бота и дать Claude Code одну команду.

Создать бота в Telegram

1. Откройте @BotFather в Telegram

2. Отправьте /newbot -- придумайте имя и username

3. Скопируйте токен бота (длинная строка вида 123456:ABC-DEF...)

4. Узнайте свой Telegram ID -- напишите @userinfobot, он вернёт число (например, 164795011)

Дать команду Claude Code

Claude Code уже работает на сервере. Одна команда -- и он сам настроит Gateway, проверит токен, запустит сервис.

Замените два значения (токен и ID) и вставьте в терминал:

:::warning Важно

Замените ВСТАВЬ_ТОКЕН на реальный токен от @BotFather (длинная строка с двоеточием). Замените ВСТАВЬ_ID на числовой Telegram ID от @userinfobot. Не делитесь токеном бота.

:::

Claude Code выполнит всё сам: запишет токен, проверит его через Telegram API, настроит конфиг с правильными путями, удалит мешающий webhook, запустит сервис и проверит статус. Если что-то пойдёт не так -- покажет лог и решение.

После выполнения напишите боту в Telegram -- агент ответит.

:::tip Первое задание для агента

Это ваш первый опыт работы с AI-агентом. Вы описали задачу текстом -- Claude Code сам разобрался с файлами, API, конфигами и системными сервисами. Так работает AI-агент: вы говорите что нужно, он делает.

:::

claude -p "Ты -- AI-агент на VPS. Подключи Telegram-бота как интерфейс управления.

ДАННЫЕ ОТ ПОЛЬЗОВАТЕЛЯ:
- Токен бота от @BotFather: ВСТАВЬ_ТОКЕН
- Telegram ID владельца: ВСТАВЬ_ID

ЧТО УЖЕ УСТАНОВЛЕНО (установщик EdgeLab):
- Gateway: ~/claude-gateway/
- Конфиг: ~/claude-gateway/config.json (шаблон, нужно заполнить)
- Секреты: ~/claude-gateway/secrets/ (chmod 700)
- Python venv: ~/claude-gateway/.venv/
- Systemd: claude-gateway.service (зарегистрирован, не запущен)

ВЫПОЛНИ ПО ПОРЯДКУ:

1. ОПРЕДЕЛИ ПУТИ
   HOME_DIR=\$(eval echo ~)
   Все пути ниже используют абсолютные (\$HOME_DIR/..., не ~/...)

2. СОХРАНИ ТОКЕН
   echo -n 'ТОКЕН' > \$HOME_DIR/claude-gateway/secrets/bot-token
   chmod 600 \$HOME_DIR/claude-gateway/secrets/bot-token
   Проверь: cat \$HOME_DIR/claude-gateway/secrets/bot-token

3. ПРОВЕРЬ ТОКЕН ЧЕРЕЗ API
   curl -s https://api.telegram.org/bot<ТОКЕН>/getMe
   Должен вернуть ok:true и username бота.
   Если ok:false -- ОСТАНОВИ работу и сообщи: токен неверный.

4. НАСТРОЙ config.json
   Открой \$HOME_DIR/claude-gateway/config.json и заполни:
   - allowlist_user_ids: [TELEGRAM_ID] (число, не строка)
   - telegram_bot_token_file: абсолютный путь к secrets/bot-token
   - workspace: абсолютный путь к \$HOME_DIR/.claude
   - model: opus
   ВАЖНО: замени ВСЕ ~ и относительные пути на абсолютные (\$HOME_DIR/...)
   Проверь JSON: python3 -c \"import json, pathlib; json.loads(pathlib.Path('\$HOME_DIR/claude-gateway/config.json').read_text())\"

5. УБЕРИ WEBHOOK (если есть)
   curl -s https://api.telegram.org/bot<ТОКЕН>/deleteWebhook
   Gateway использует polling, webhook мешает.

6. ЗАПУСТИ СЕРВИС
   sudo systemctl daemon-reload
   sudo systemctl start claude-gateway
   sudo systemctl enable claude-gateway
   Подожди 5 секунд.

7. ПРОВЕРЬ СТАТУС
   sudo systemctl status claude-gateway --no-pager
   Если active (running) -- всё работает.
   Если failed:
   - Покажи: sudo journalctl -u claude-gateway -n 30 --no-pager
   - Частые причины: неверный путь к токену, невалидный JSON, нет прав
   - Попробуй исправить и перезапустить: sudo systemctl restart claude-gateway

ОТВЕТ (обязательный формат):
- Бот: @username
- Владелец: Telegram ID
- Сервис: active / failed
- Конфиг: /путь/к/config.json
- Итог: Готово, напишите боту / Есть проблема: описание

При ошибке -- покажи лог и конкретное решение, не останавливайся."

Результат

Claude Code на сервере в облаке. Доступ через Telegram с телефона. Агент работает 24/7 – даже когда вы спите.

Следующий уровень: настроить CLAUDE.md для памяти агента, добавить скиллы, подключить инструменты.

Исходный код установщика: https://github.com/qwwiwi/edgelab-install

Присоединяйтесь к сообществу EdgeLab – https://edgelab.su