Claude Code в кармане 24/7: как развернуть кодинг-агента на VPS и подключить к TelegramСтатья · дайджест за 21 ноября
Кинематографичный ночной натюрморт с удалённым терминалом и мобильным интерфейсом бота
Статья4 раздела≈ 10 мин

Claude Code в кармане 24/7: как развернуть кодинг-агента на VPS и подключить к Telegram

Закрываешь крышку ноутбука — и консольный кодинг-агент моментально засыпает вместе с системой. Фоновая задача обрывается, а если в дороге нужно проверить репозиторий или прогнать скрипт, приходится искать Wi-Fi и доставать ноут. Автор канала Nate Herk решил это просто: вынес Claude Code на облачный сервер и подключил к личному Telegram-боту. Прямо с телефона он пишет боту herc2 вопрос «Кто я и с чем ты должен мне помогать?», наверху загорается typing…, и через пару секунд агент отвечает с опорой на все его проекты и навыки.

Вся связка держится на официальном механизме Claude Code Channels и паре стандартных Linux-утилит. Главный подвох тут не в установке, а в трёх мелочах: блокировке доступа по твоему Telegram ID, автозапуске после ребута сервера и раннем сжатии длинного контекста. Разберём настройку шаг за шагом.

Зачем нужен VPS и что подготовить на старте

Основа схемы — VPS (виртуальный выделенный сервер), облачная Linux-машина, которая работает 24/7 и не уходит в спящий режим. Нейт в своём разборе брал готовый шаблон Hostinger с предустановленным Claude Code в один клик, но подойдёт любой обычный Ubuntu или Debian VPS с доступом по SSH.

Для Telegram-плагина на сервере нужны три вещи: сам Claude Code версии v2.1.80+, tmux и bun.

  • tmux (мультиплексор терминала) держит сессию живой в фоне: если закроешь SSH или отвалится интернет, агент продолжит работать.
  • bun — быстрый JavaScript/TypeScript-рантайм. На нём плагин Anthropic поднимает локальный MCP-сервер (мост между Telegram Bot API и твоей сессией).

Подключись к серверу под обычным рабочим пользователем (не под root) и проверь окружение. У Нейта tmux на сервере стоял сразу, а bun не нашёлся — он просто скормил ошибку самому Claude и получил команды установки:

# Проверяем версии: Claude Code нужен от v2.1.80 и выше
claude --version
tmux -V
bun --version

# Ставим bun, если система ответила "command not found"
curl -fsSL https://bun.sh/install | bash
source ~/.bashrc

# Ставим tmux, если его нет
sudo apt update && sudo apt install -y tmux

Серверная база готова. Теперь создай бота в @BotFather (проверь синюю галочку): отправь /newbot, задай имя и уникальный username с окончанием bot (например, herc2_bot). Даже сам Нейт не с первой попытки уложился в правила имени, так что спокойно подбери свободный вариант. Скопируй выданный HTTP API-токен вида 123456789:AAHfiqksKZ8... — если он когда-нибудь утечёт, в Telegram Bot API его можно сразу перевыпустить командой /revoke у того же @BotFather.

Официальная документация Claude Code Channels — передача событий и сообщений в сессию через MCP-сервер (Источник: code.claude.com)

Подключаем Telegram-плагин и запираем доступ

Запусти claude на сервере и войди в подписку. Здесь есть два важных ограничения. Во-первых, каналы работают только при прямой авторизации Anthropic (claude.ai или Console API key) — через Bedrock, Vertex или Foundry подключить Telegram нельзя. Во-вторых, на тарифах Team и Enterprise каналы по умолчанию выключены. Это частая грабля: пока владелец или админ организации не включит настройку channelsEnabled, бот будет молчать.

После входа установи официальный плагин из anthropics/claude-plugins-official и передай ему токен прямо в сессии Claude Code:

# Ставим официальный плагин (выбирай user scope)
/plugin install telegram@claude-plugins-official

# Привязываем токен от @BotFather
/telegram:configure 123456789:AAHfiqksKZ8...

# Выходим, чтобы перезапуститься с флагом канала
/exit

Команда /telegram:configure сохранит TELEGRAM_BOT_TOKEN в ~/.claude/channels/telegram/.env. На практике перезагрузка плагинов на лету срабатывает не всегда, поэтому надёжнее выйти через /exit и сразу поднять сессию внутри tmux с флагом --channels:

# Запускаем фоновую сессию tmux и подключаем канал Telegram
tmux new -s claude-tg
claude --channels plugin:telegram@claude-plugins-official

Теперь напиши своему боту в Telegram /start или любое сообщение. В ответ придёт одноразовый 6-символьный pairing-код (код сопряжения) — он привязывает твой числовой Telegram ID без ручного поиска. Но одного сопряжения мало: пока политика открыта, любой случайный пользователь сможет постучаться к боту. Сразу после привязки включай жёсткий allowlist:

# Подтверждаем свой аккаунт 6-значным кодом из ответа бота
/telegram:access pair A1B2C3

# Закрываем доступ всем посторонним
/telegram:access policy allowlist

После этого бот отвечает только тебе. Напиши «Привет» с телефона: в шапке появится typing… (плагин сам шлёт индикатор набора, режет длинные ответы на части и сохраняет входящие фото до 50 МБ в ~/.claude/channels/telegram/inbox/), а в окне tmux текст прилетит прямо в консоль агента.

Выживание после перезагрузки и безопасный перенос .env

Ручная сессия tmux переживёт обрыв SSH, но исчезнет после первой перезагрузки VPS. Чтобы агент поднимался сам, оформи его как службу systemd и сразу задай переменную CLAUDE_CODE_AUTO_COMPACT_WINDOW=400k (зачем именно 400k, разберём ниже). Создай /etc/systemd/system/claude-telegram.service и подставь своего пользователя вместо ubuntu:

# /etc/systemd/system/claude-telegram.service
[Unit]
Description=Claude Code Telegram Channel in tmux
After=network-online.target
Wants=network-online.target

[Service]
Type=forking
User=ubuntu
WorkingDirectory=/home/ubuntu/workspace
# Путь к bun и claude (сверь через `which bun` и `which claude`)
Environment="PATH=/home/ubuntu/.bun/bin:/usr/local/bin:/usr/bin:/bin"
Environment="CLAUDE_CODE_AUTO_COMPACT_WINDOW=400k"
ExecStart=/usr/bin/tmux new-session -d -s claude-tg \
  "claude --channels plugin:telegram@claude-plugins-official"
ExecStop=/usr/bin/tmux kill-session -t claude-tg
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

Включи автозапуск и проверь статус (если claude лежит в ~/.local/bin, добавь этот путь в PATH, иначе служба не найдёт бинарник):

# Применяем unit-файл, запускаем и проверяем статус
sudo systemctl daemon-reload
sudo systemctl enable --now claude-telegram.service
sudo systemctl status claude-telegram.service

Единственный надёжный тест автозапуска — выполнить sudo reboot, подождать минуту и написать боту в Telegram. Если агент ответил, всё поднялось чисто.

Дальше перенеси на сервер свой рабочий репозиторий (у Нейта это Herc2 со всеми навыками и проектами) и отдельно скопируй .env с ключами API:

# Клонируем рабочий репозиторий на сервере
git clone git@github.com:your-user/your-workspace.git ~/workspace

# Копируем .env с ноутбука по шифрованному scp
scp .env ubuntu@<ip-сервера>:~/workspace/.env

# На сервере закрываем файл от чужого чтения
chmod 600 ~/workspace/.env

Важная оговорка по безопасности. В своём примере Нейт сидит под root, хранит root-пароль в .env и отдаёт его локальному Claude, чтобы тот сам чинил сервер по SSH. Для быстрого демо это удобно, но в бою опасно: root-пароль в файлах проекта и контексте модели — прямой путь к потере сервера.

Чек-лист безопасности для VPS с агентом

  • Заведи отдельного non-root пользователя, входи по SSH-ключу и отключи вход под root по паролю.
  • Проверь, что .env есть в .gitignore и не улетает в GitHub.
  • Передавай секреты через scp с правами chmod 600.
  • Не вставляй пароли в чат с ИИ — для отладки смотри journalctl -u claude-telegram.service.

Останавливаем «протухание» чата на 400k токенов

В обычном терминале ты часто открываешь новую сессию под новую задачу. В Telegram всё иначе: канал держит одну бесконечную сессию. Без настройки история разрастается почти до стандартного порога около 960k токенов, и начинается «протухание» контекста (context rot): из-за длинного хвоста старых логов модель хуже слушается свежих инструкций и тратит лишние токены.

Автокомпактизация (auto-compact) сама сжимает старую переписку в краткую выжимку. Нейт снижает порог до 400k токенов — этого хватает, чтобы помнить текущую задачу, но не «замыливать» внимание модели. В systemd мы уже задали CLAUDE_CODE_AUTO_COMPACT_WINDOW=400k, а если удобнее настраивать порог в процентах от окна, используй переменную CLAUDE_AUTOCOMPACT_PCT_OVERRIDE (от 1 до 100, например 40–50). Пощёлкай симулятор ниже, чтобы проверить цепочку прохождения сообщения и работу порога сжатия.

Симулятор связки VPS + Telegram и порога автокомпактизации

И последнее ограничение, о котором важно помнить: Telegram Bot API не отдаёт ботам историю переписки и не умеет искать по старым сообщениям. Агент видит только то, что пришло, пока он запущен, поэтому все рабочие инструкции, заметки и сценарии держи в файлах Git-репозитория на сервере, а не в ленте чата.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 4