Telegram Remote — установка и использование

Обновлено в сентябре 2026

Remote — это мост между вашим локальным Claude Code и Telegram. Один раз настраиваете его на своём компьютере — дальше пишете задачи боту из телефона откуда угодно, и Claude Code выполняет их прямо на вашей машине: читает и правит файлы, гоняет команды, а в чат прилетает живой статус и итоговый ответ. Доступно на тарифах Pro и Lifetime.

1. Установите ContextGuard CLI

Если ещё не установлен — один из вариантов:

macOS & Linux:

curl -sSf https://contextguard.tech/install.sh | sh

Windows (PowerShell):

irm https://contextguard.tech/install.ps1 | iex

Подробнее — на странице установки CLI.

2. Привяжите Telegram

Проще всего — с дашборда: откройте Settings → Telegram Remote Control и нажмите «Подключить Telegram». Откроется бот — нажмите «Старт», и аккаунт привязан.

Это только связывает аккаунт с чатом. Сам локальный мост запускается отдельно — шаг 3.

3. Один раз сохраните API-ключ

Возьмите ключ на странице API Keys и передайте его любой из этих команд один раз:

contextguard tg --api-key cg_live_...

или

contextguard remote --api-key cg_live_...

CLI сохраняет ключ в ~/.claude/contextguard/remote-auth.json на вашем компьютере. После этого ключ больше не нужен — просто запускайте contextguard remote без флагов, в любом новом окне терминала, в любой день. Не нужно создавать новый ключ каждый раз, когда открываете новый терминал — старая переменная окружения $CONTEXTGUARD_API_KEY живёт только внутри одного окна, а сохранённый файл — нет.

4. Запустите мост

Вариант A — из терминала:

contextguard remote

Вариант B — прямо внутри Claude Code, без отдельного окна:

/plugin marketplace add ChevvyOkK/contextguard-plugin /plugin install contextguard@contextguard /contextguard:remote

Первые две строки нужны один раз (устанавливают плагин). /contextguard:remote запускает мост в фоне текущей сессии Claude Code и сообщает, подключился ли он.

Готово, когда видите: Connected. Waiting for prompts from Telegram...

5. Пользуйтесь

Пока мост запущен, просто пишите боту в Telegram что нужно сделать — как обычному собеседнику:

почини падающий тест в auth.service.spec.ts

В ответ прилетит живое сообщение: сначала статус вроде «🔧 Инструмент: Edit: src/auth.service.ts», по мере генерации — растущий текст ответа, а в конце — сам ответ Claude Code и список того, что было прочитано/изменено.

Полезные команды в чате: /status — активные сессии, /stop — прервать текущую задачу.

О правах доступа

Запросы из Telegram выполняются без интерактивных вопросов — там некому отвечать «y/n» на другом конце. Поэтому чтение и правка файлов (Read/Edit/Write) выполняются автоматически, а всё остальное, что явно не разрешено (например, произвольный Bash), по умолчанию тихо отклоняется. Это касается только сессий, запущенных через Remote — на своей интерактивной сессии Claude Code в терминале ничего не меняется.

Проблемы?

Бот пишет «Терминал оффлайн»

Мост не запущен на компьютере. Запустите contextguard remote (или /contextguard:remote в Claude Code) — команда должна работать, пока вы им пользуетесь.

«This command needs your ContextGuard API key»

Ключ ещё ни разу не сохранялся на этой машине. Выполните шаг 3 один раз.

Соединение постоянно обрывается / переподключается

Проверьте тариф (нужен Pro или Lifetime) и что ключ на странице API Keys не отозван.