Удалённый доступ к Claude Code через Telegram

Зачем это нужно

У вас на компьютере работает Claude Code с доступом к Obsidian, скиллам, MCP-серверам, Git. Всё это мощно, но работает только когда вы сидите за компьютером.

А что если вы хотите:

С телефона попросить агента записать идею в Obsidian
По дороге на работу проверить незакрытые задачи в волте
Из кафе запустить ночной ресерч
Получить уведомление, когда длинная задача завершилась

Для этого нужно дать Claude Code "выход наружу" — чтобы вы могли общаться с ним удалённо, через мессенджер.

В этом гайде — три способа, от простого к продвинутому.

Способ 1: Dispatch (самый быстрый, без настройки)

Что это

Dispatch — встроенная фича Claude, которая связывает приложение Claude на телефоне с Claude на вашем Mac. Вы отправляете задачу с телефона — Claude выполняет её на компьютере. Когда готово — пуш-уведомление.

Как настроить

Убедитесь, что у вас Claude Pro ($20/мес) или Max
Обновите Claude Desktop на Mac до последней версии
Зайдите в Settings → Dispatch → Enable
Откройте приложение Claude на телефоне (iOS или Android)
Отсканируйте QR-код, который показывает Mac
Готово — устройства связаны

Как пользоваться

Открываете Claude на телефоне, пишете задачу:

Посмотри в моём Obsidian папку Daily/ — 
что я записал вчера в дневнике?

Claude на Mac выполнит задачу и пришлёт результат на телефон.

Ограничения

Работает только через приложение Claude (не Telegram, не WhatsApp)
Mac должен быть включён и не в режиме сна
Только macOS (Windows — скоро)
Нет возможности отправить голосовое из Telegram

Когда использовать

Dispatch — для тех, кому достаточно приложения Claude на телефоне. Настройка за 2 минуты, ничего лишнего устанавливать не нужно.

Способ 2: Claude Code + Telegram (рекомендуется)

Что это

Официальный Telegram-плагин для Claude Code. Вы создаёте бота в Telegram, подключаете его к Claude Code — и получаете полноценный доступ ко всему: файлам, терминалу, скиллам, MCP-серверам. Прямо из Telegram на телефоне.

Это не обёртка над API — это ваш реальный Claude Code, работающий на вашем компьютере, просто с Telegram как интерфейсом.

Что нужно

Требование	Зачем
Claude Code v2.1.80+	Channels появились в этой версии
Bun	Плагин работает на Bun (JavaScript runtime)
Telegram-аккаунт	Для создания бота
Компьютер включён	Claude Code работает локально

Пошаговая настройка

Шаг 1: Установите Bun

Bun — быстрый JavaScript-runtime, на котором работает Telegram-плагин.

curl -fsSL https://bun.sh/install | bash

Перезагрузите терминал после установки.

Шаг 2: Создайте Telegram-бота

Откройте Telegram на телефоне
Найдите @BotFather (это официальный бот Telegram для создания ботов)
Напишите ему /newbot
BotFather спросит:
- Имя бота — например, "My Claude Assistant"
- Username — например, my_claude_bot (должен заканчиваться на bot)
BotFather ответит токеном — длинная строка вида 123456789:AAHfiqksKZ8...
Скопируйте токен — он понадобится на следующем шаге

Шаг 3: Установите плагин в Claude Code

Откройте терминал, запустите Claude Code в папке вашего Obsidian-волта:

cd /path/to/your/vault
claude

Внутри сессии Claude Code выполните:

/plugin install telegram@claude-plugins-official
/reload-plugins

Шаг 4: Настройте токен бота

В той же сессии Claude Code:

/telegram:configure ВАШ_ТОКЕН_ОТ_BOTFATHER

Вставьте полный токен, включая цифры в начале.

Шаг 5: Перезапустите Claude Code с Channels

Выйдите из текущей сессии (/exit или Ctrl+C) и запустите заново с флагом --channels:

cd /path/to/your/vault
claude --channels plugin:telegram@claude-plugins-official

Claude Code запустится и будет слушать сообщения из Telegram.

Шаг 6: Привяжите свой аккаунт

Откройте Telegram на телефоне
Найдите вашего бота по username (например, @my_claude_bot)
Напишите ему любое сообщение
Бот ответит кодом привязки (pairing code)
В терминале (в Claude Code) выполните:

/telegram:access pair КОД_ПРИВЯЗКИ

Включите режим безопасности — только вы можете писать боту:

/telegram:access policy allowlist

Готово! Теперь вы пишете боту в Telegram — Claude Code выполняет на компьютере.

Как это работает

Вы (Telegram на телефоне)
  → Telegram Bot API
    → Плагин (MCP-сервер на вашем компе)
      → Claude Code (полный доступ к файлам, терминалу, скиллам)
        → Ответ обратно в Telegram

Все данные остаются на вашем компьютере. В Telegram уходит только текст сообщений.

Примеры использования с Obsidian

Записать идею:

Запиши в мой Obsidian в папку Input/:
"Идея: сделать автоматический дайджест новостей 
из NotebookLM каждое утро"

Проверить задачи:

Посмотри в моём Obsidian незакрытые задачи. 
Какие просрочены?

Запустить ресерч:

Используй exa, найди последние новости про AI-агентов.
Сохрани summary в Research/ в моём Obsidian.

Сделать бэкап:

Сделай git commit моего Obsidian-волта с комментарием
"backup before restructuring"

Прочитать заметку:

Прочитай мой дневник за вчера и пришли мне краткое summary

Запустить скилл:

Используй скилл last30days — что нового в мире 
Obsidian-плагинов за последний месяц?

Важно: компьютер должен работать

Claude Code + Telegram Channels работает, пока:

Компьютер включён
Терминал с Claude Code запущен (с флагом --channels)
Компьютер не спит

Настройте Mac, чтобы не засыпал при подключённом питании:

System Settings → Energy → Prevent automatic sleeping when the display is off → On

Советы по безопасности

Сразу после привязки включите allowlist — только ваш Telegram-аккаунт сможет писать боту
Не делитесь токеном бота — кто знает токен, может настроить своего клиента
Если токен утёк — удалите бота через BotFather (/deletebot) и создайте нового
Или перегенерируйте токен через того же BotFather
Claude Code запрашивает разрешение перед опасными операциями — отвечайте из Telegram yes или no

Способ 3: Свой Telegram-бот + Claude API (для продвинутых)

Когда это нужно

Вы хотите бота, который работает без запущенного Claude Code (через API)
Вы хотите полный контроль над логикой обработки сообщений
Вы хотите, чтобы бот работал на VPS 24/7 без привязки к вашему компьютеру
Вы хотите добавить свою логику: фильтры, маршрутизацию, интеграции

Архитектура

Telegram → Ваш бот (Node.js на VPS или компе)
              ↓
         Claude API (Anthropic)
              ↓
         Чтение/запись файлов Obsidian
              ↓
         Ответ в Telegram

Как реализовать

Это вайб-кодинг проект. Вы не пишете код сами — вы описываете задачу агенту, и он пишет за вас.

Откройте Claude Code и скажите:

Мне нужен Telegram-бот на Node.js, который:

1. Слушает мои сообщения в Telegram
2. Отправляет их в Claude API (Anthropic)
3. В системном промпте указано, что мой Obsidian-волт 
   находится в /path/to/vault
4. Бот имеет доступ к файловой системе — может читать 
   и писать файлы в волте
5. Ответы от Claude отправляет обратно в Telegram
6. Работает только для моего Telegram ID (hardcoded allowlist)

Используй:
- telegraf (npm-пакет для Telegram ботов)
- @anthropic-ai/sdk (официальный SDK)
- Мой API-ключ хранится в .env как ANTHROPIC_API_KEY
- Telegram токен хранится в .env как TELEGRAM_BOT_TOKEN

Создай проект в ~/Vibe/obsidian-telegram-bot/

Claude Code создаст проект за 5-10 минут. После этого:

cd ~/Vibe/obsidian-telegram-bot
npm install
cp .env.example .env
# Отредактируйте .env — добавьте ключи
npm start

Что нужно для этого способа

Требование	Как получить
Anthropic API key	`console.anthropic.com` → API Keys
Telegram Bot Token	@BotFather → `/newbot`
Node.js 20+	`brew install node` или `nodejs.org`
VPS (опционально)	Hetzner, DigitalOcean — от $4/мес

Стоимость

API-вызовы оплачиваются отдельно:

Модель	Input	Output	Примерная стоимость
Claude Sonnet 4.6	$3/M токенов	$15/M токенов	~$0.01-0.05 за сообщение
Claude Haiku 4.5	$0.80/M	$4/M	~$0.002-0.01 за сообщение

При 50 сообщениях в день через Sonnet — примерно $15-30/мес.

Когда выбрать этот способ

Вы хотите, чтобы бот работал на сервере 24/7 (без включённого компьютера)
Вы хотите полный контроль и понимание, как всё устроено
Вам не нужны скиллы и MCP — достаточно чтения/записи файлов

Сравнение трёх способов

	Dispatch	Channels (Telegram)	Custom Bot
Сложность настройки	2 минуты	15-20 минут	1-2 часа
Интерфейс	Claude app	Telegram	Telegram
Доступ к скиллам	Да	Да	Нет (только API)
Доступ к MCP	Да	Да	Нет
Доступ к файлам	Да	Да	Да (через код)
Нужен API-ключ	Нет (подписка)	Нет (подписка)	Да (платно)
Комп включён	Да	Да	Нет (VPS)
Голосовые в Telegram	Нет	Нет*	Можно добавить
Кастомная логика	Нет	Ограниченно	Полная
Стоимость	$20/мес (подписка)	$20/мес (подписка)	$5-30/мес (API)

*Telegram-плагин принимает текстовые сообщения. Голосовые можно обрабатывать через дополнительный скрипт.

Устранение проблем

Бот не отвечает в Telegram

Проверьте, что Claude Code запущен с флагом --channels
Проверьте, что компьютер не уснул
Проверьте, что вы привязали свой аккаунт через /telegram:access pair
Перезапустите Claude Code с Channels

"Plugin not found"

# Обновите Claude Code
claude update

# Переустановите плагин
/plugin install telegram@claude-plugins-official
/reload-plugins

"Bun not found"

curl -fsSL https://bun.sh/install | bash
source ~/.bashrc  # или source ~/.zshrc
bun --version

Сообщения теряются

Если Claude Code был выключен, когда вы отправили сообщение — оно потеряется. Telegram-плагин не имеет очереди сообщений. Отправьте заново после запуска.

Компьютер засыпает

macOS: System Settings → Energy → Prevent automatic sleeping when the display is off → On

Или через терминал:

sudo pmset -a disablesleep 1

Вернуть обратно:

sudo pmset -a disablesleep 0

Шпаргалка: быстрый старт через Telegram

1. Установить Bun:
   curl -fsSL https://bun.sh/install | bash

2. Создать бота: @BotFather → /newbot → скопировать токен

3. В Claude Code:
   /plugin install telegram@claude-plugins-official
   /reload-plugins
   /telegram:configure ВАШ_ТОКЕН

4. Перезапустить:
   claude --channels plugin:telegram@claude-plugins-official

5. В Telegram: написать боту → получить код → 
   в Claude Code: /telegram:access pair КОД
   
6. Закрыть доступ:
   /telegram:access policy allowlist

7. Готово — пишите боту из любой точки мира!

Курс AI Obsidian — 3 недели, 9 встреч, максимум 20 человек

Записаться →

Удалённый доступ к Claude Code через Telegram

Зачем это нужно

Способ 1: Dispatch (самый быстрый, без настройки)

Что это

Как настроить

Как пользоваться

Ограничения

Когда использовать

Способ 2: Claude Code + Telegram (рекомендуется)

Что это

Что нужно

Пошаговая настройка

Шаг 1: Установите Bun

Шаг 2: Создайте Telegram-бота

Шаг 3: Установите плагин в Claude Code

Шаг 4: Настройте токен бота

Шаг 5: Перезапустите Claude Code с Channels

Шаг 6: Привяжите свой аккаунт

Как это работает

Примеры использования с Obsidian

Важно: компьютер должен работать

Советы по безопасности

Способ 3: Свой Telegram-бот + Claude API (для продвинутых)

Когда это нужно

Архитектура

Как реализовать

Что нужно для этого способа

Стоимость

Когда выбрать этот способ

Сравнение трёх способов

Рекомендация для студентов курса

Устранение проблем

Бот не отвечает в Telegram

"Plugin not found"

"Bun not found"

Сообщения теряются

Компьютер засыпает

Шпаргалка: быстрый старт через Telegram