---
title: "Как подключить Claude Code к Telegram"
seoTitle: "Как подключить Claude Code к Telegram: штатная настройка"
navTitle: "Claude Code + Telegram"
description: "Claude Code в Telegram через официальный плагин Channels: привязка бота, удалённые запросы разрешений, ограничения сессии и более безопасная настройка."
slug: how-to-connect-claude-code-to-telegram
lang: ru
date: 2026-06-08
updated: 2026-07-30
author: "Chatcode"
category: guide
faq:
  - q: "Есть ли у Claude Code официальная интеграция с Telegram?"
    a: "Да. В Claude Code Channels есть официальный плагин для Telegram. Он подключает Telegram-бота со списком разрешённых пользователей к сессии Claude Code, которая продолжает работать на вашем компьютере или сервере."
  - q: "Можно ли подтверждать запросы разрешений Claude Code из Telegram?"
    a: "Да. Текущая версия официального плагина для Telegram передаёт поддерживаемые запросы разрешений для инструментов в виде кнопок Allow и Deny. Первичное подтверждение доверия к проекту, согласие на плагин и часть локальной настройки по-прежнему требуют терминала."
  - q: "Чем Channels отличается от Remote Control?"
    a: "Channels позволяет Telegram или другому сервису отправлять события в запущенную сессию Claude Code. Remote Control открывает сессию через Claude в вебе или на телефоне. Оба варианта используют процесс Claude на хосте, но различаются интерфейсом и тем, что запускает работу."
  - q: "Работает ли Telegram-бот, когда Claude Code закрыт?"
    a: "Нет. Сервер канала работает вместе с сессией Claude Code. Если бот должен оставаться доступным, держите процесс запущенным в постоянном терминале или на постоянно включённом хосте."
---

У Claude Code есть официальная интеграция с Telegram — **Channels**. Она хорошо
подходит, когда нужно отправить задачу в уже запущенную сессию, получить ответ в
Telegram и подтверждать обычные действия инструментов, не открывая ноутбук.

Главное ограничение простое: Claude Code работает не в Telegram. Работу
по-прежнему выполняет процесс Claude Code на вашем компьютере или сервере, и
этот процесс должен оставаться в сети.

## Короткий ответ

Создайте приватного бота через BotFather в Telegram, установите в Claude Code
официальный плагин Telegram, задайте токен, запустите Claude с включённым
каналом и привяжите свой аккаунт Telegram. Ограничьте бота списком разрешённых
пользователей, а не делайте его публичным.

Сейчас интеграция находится в статусе research preview. Прежде чем
автоматизировать её на машине с чувствительными данными, сверьтесь с
[документацией Channels](https://code.claude.com/docs/en/channels) от Anthropic:
команды и возможности могут меняться.

## Что понадобится

- Актуальная версия Claude Code, авторизованная через поддерживаемый аккаунт
  Anthropic.
- [Bun](https://bun.sh/) на хосте: официальный плагин канала работает на Bun.
- Аккаунт Telegram и токен бота от [@BotFather](https://t.me/BotFather).
- Терминал, который может оставаться открытым, или постоянная сессия, например
  `tmux`.

Обращайтесь с токеном бота как с паролем. Не вставляйте его в репозиторий или в
историю оболочки, которую видят другие пользователи, и не показывайте на
скриншотах.

## 1. Создайте приватного Telegram-бота

Откройте BotFather в Telegram, отправьте `/newbot` и следуйте подсказкам. Имя
пользователя бота должно заканчиваться на `bot`. Сохраните токен во временном
месте, недоступном посторонним.

Для личной работы с кодом добавлять бота в группу незачем. С личными сообщениями
и списком разрешённых пользователей гораздо проще понять, у кого есть доступ.

## 2. Установите официальный плагин

Установите плагин Telegram прямо в Claude Code:

```text
/plugin install telegram@claude-plugins-official
```

Если маркетплейс ещё не зарегистрирован, добавьте его и повторите попытку:

```text
/plugin marketplace add anthropics/claude-plugins-official
/plugin install telegram@claude-plugins-official
/reload-plugins
```

Используйте официальное имя маркетплейса, а не сторонний пакет с похожим
названием.

## 3. Задайте токен бота

Выполните команду плагина в Claude Code:

```text
/telegram:configure <BOT_TOKEN>
```

Плагин сохраняет токен в локальной конфигурации канала. Если токен засветился в
логах или в чате, отзовите его через BotFather и задайте новый.

## 4. Запустите Claude Code с включённым Telegram

Выйдите из текущей сессии и запустите её снова с каналом:

```bash
claude --channels plugin:telegram@claude-plugins-official
```

Запускайте команду в репозитории, с которым должен работать Claude. На постоянно
включённом хосте делайте это в именованной сессии `tmux`, чтобы разрыв
SSH-соединения не завершил процесс:

```bash
tmux new -s claude-telegram
claude --channels plugin:telegram@claude-plugins-official
```

`tmux` сохраняет процесс, но не мешает ноутбуку уснуть и не восстанавливает
упавшее сетевое соединение.

## 5. Привяжите аккаунт и ограничьте доступ

Отправьте боту сообщение — в ответ он пришлёт код привязки. В терминале Claude
Code подтвердите этот код и оставьте доступ ограниченным:

```text
/telegram:access pair <PAIRING_CODE>
/telegram:access policy allowlist
```

Проверьте связку запросом, который ничего не меняет, — например, попросите
Claude кратко описать текущую директорию. Прежде чем давать более широкий доступ
к инструментам, убедитесь, что сообщение попало в нужную сессию.

## Как сейчас работают запросы разрешений

В старых описаниях Channels часто говорится, что на каждый запрос разрешения
нужно возвращаться в терминал. Это уже не так. Текущий [официальный плагин для
Telegram](https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/telegram/server.ts)
объявляет поддержку ретрансляции разрешений Claude Code и может отправлять
поддерживаемые запросы инструментов в Telegram с кнопками **Allow** и **Deny**.

Но подтверждения без присмотра от этого не становятся безопасными. В маленькой
карточке в чате может потеряться контекст, который был бы очевиден при просмотре
диффа в терминале. Читайте команду и затрагиваемый путь, избегайте широких
правил «всегда разрешать» и запускайте постоянно работающую сессию под аккаунтом
с минимальными правами. Первичное подтверждение доверия к проекту, согласие на
MCP и настройка плагина могут по-прежнему требовать работы в локальном
терминале.

## Ограничения, важные на практике

- **Процесс на хосте должен продолжать работать.** Если закрыть Claude Code,
  канал остановится.
- **Telegram — это поток событий, а не хранилище сессии.** Bot API доставляет
  новые обновления, но не даёт плагину полную историю с поиском.
- **Ответ остаётся в Telegram.** Терминал может показывать входящее событие и
  статус доставки, а не транскрипт, совпадающий с чатом.
- **Это решение только для Claude.** Плагин не даёт доступа к Codex и другим
  агентам.
- **Это предварительная версия.** Перепроверяйте официальную документацию после
  обновлений и не полагайтесь на недокументированное поведение.

## Channels или Remote Control

[Remote Control](https://code.claude.com/docs/en/remote-control) от Anthropic —
отдельный вариант. Он позволяет управлять сессией на хосте из Claude в вебе или
из приложения для iOS/Android. Файлы и инструменты остаются на хосте, а телефон
служит удалённым интерфейсом.

Выбирайте **Channels**, если вам нужен именно Telegram или внешние события
должны попадать в сессию. Выбирайте **Remote Control**, если нужен фирменный
интерфейс Claude и более полное представление об активной сессии. Оба варианта
всё равно зависят от процесса на хосте.

## Когда имеет смысл другой удалённый слой

Для одной сессии Claude штатный плагин обычно самое простое решение. Другая
схема становится актуальной, когда меняются требования: например, нужен
полноценный терминал в браузере, несколько агентов для программирования или
постоянно работающий VPS, которым управляют отдельно от ноутбука.

Chatcode — один из таких вариантов: он подключает сервер к терминалу в браузере
и Telegram и может запускать Claude Code вместе с Codex, Gemini и OpenCode. При
этом добавляются сторонний ретранслятор и ответственность за управление
сервером, так что это не автоматическое улучшение. Практическая настройка и
компромиссы разобраны в руководстве [Claude Code в Telegram через
Chatcode](/articles/claude-code-telegram-with-chatcode).
