Закрываешь крышку ноутбука — и консольный кодинг-агент моментально засыпает вместе с системой. Фоновая задача обрывается, а если в дороге нужно проверить репозиторий или прогнать скрипт, приходится искать 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-репозитория на сервере, а не в ленте чата.




