Свой AI-агент на VPS за 3 шага (Claude Code и ИИ агент на VPS сервере)

Сервер, Claude Code, Telegram – и у тебя свой AI-агент в облаке. Управляешь с телефона из любой точки мира.

Канал с гайдами и контентом по claude code, выкладываем новости (когда режут лимиты в 10 раз) и какие инструменты через claude реализуем для проектов, канал: https://t.me/claudedevolper

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

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

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

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

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

– Создаёт пользователя 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

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 для памяти агента, добавить скиллы, подключить инструменты.