Свой AI-агент на VPS за 3 шага (Ставим ИИ агента на сервер с помощью Claude Code гайд)

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

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

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

Подключаетесь к серверу по 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 предложениях.

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

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

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

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

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

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

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

Свой AI-агент на VPS за 3 шага (Ставим ИИ агента на сервер с помощью Claude Code гайд)

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

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

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

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

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

Результат