---
title: "Как пользоваться Claude Code в Telegram через Chatcode"
seoTitle: "Claude Code в Telegram через Chatcode: настройка"
navTitle: "Claude Code в Telegram"
description: "Claude Code на вашем сервере с терминалом в браузере и Telegram от Chatcode: настройка и компромиссы — хост, ретранслятор, учётные данные и штатный плагин."
slug: claude-code-telegram-with-chatcode
lang: ru
date: 2026-06-11
updated: 2026-07-30
author: "Chatcode"
category: guide
faq:
  - q: "Нужен ли для Chatcode VPS?"
    a: "Нет. Можно подключить поддерживаемый Linux-сервер или Mac, который у вас уже есть. VPS полезен, когда сессия должна оставаться доступной, пока ваш личный компьютер спит."
  - q: "Telegram — это полноценный терминальный интерфейс?"
    a: "Нет. Основной терминал — браузер. Telegram даёт привязанные представления сессии, уведомления, превью файлов и непрерывность работы с той же сессией на сервере."
  - q: "Можно ли вместо этого использовать официальный плагин Claude Code для Telegram?"
    a: "Да. Используйте официальный плагин Channels от Anthropic, если вам нужен только доступ из Telegram к запущенной сессии Claude. Chatcode полезнее, когда нужны ещё и терминал в браузере, постоянно включённый управляемый хост или несколько агентов для программирования."
  - q: "Может ли Chatcode читать терминальный трафик?"
    a: "Да. Соединения шифруются TLS на каждом участке, но управляющий слой Chatcode — доверенный ретранслятор, а не канал со сквозным шифрованием. Он обрабатывает содержимое терминала для форматирования в Telegram, превью, расшифровки речи и уведомлений."
---

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

Если вам нужен только Telegram-бот для одной работающей сессии Claude, проще
начать с официального плагина Channels от Anthropic. Эта схема пригодится, когда
в требования входят полноценный терминал в браузере, постоянно работающий хост
или поддержка нескольких агентов.

## Из чего состоит схема

```text
Browser / Telegram
        ↕
Chatcode control plane
        ↕ outbound TLS WebSocket
Your server + gateway
        ↕
Claude Code session
```

Для обычного трафика Chatcode шлюзу не нужен входящий порт. Он запускает сессии
агентов на подключённой машине и держит исходящее соединение с управляющим
слоем. SSH всё равно стоит сохранить как отдельный путь для администрирования и
восстановления.

## 1. Выберите хост

Обычно выбирают один из двух вариантов:

- **Постоянно работающий Linux-сервер.** Подключите существующий VPS или
  создайте новый через интеграцию с DigitalOcean.
- **Mac, которым вы уже пользуетесь.** Отдельный сервер не нужен, но доступность
  зависит от питания Mac, сети и того, выполнен ли вход в систему.

При установке на Linux создаётся отдельный пользователь `vibe` и используется
`/home/vibe/workspace`. На macOS шлюз работает от имени текущего пользователя и
использует `~/workspace`, поэтому наследует права доступа этого пользователя к
файлам. Прежде чем решать, какая модель доверия подходит хосту, прочитайте, [как
работает шлюз](/docs/gateway).

## 2. Подключите шлюз

Войдите на [app.chatcode.dev](https://app.chatcode.dev), добавьте сервер и
используйте сгенерированную команду установки. В ней есть идентификатор шлюза и
токен аутентификации, поэтому не вставляйте её в публичный issue, чат или запись
сеанса в терминале.

Установщик настраивает шлюз как фоновую службу. Когда приложение покажет, что
шлюз в сети, проверьте хост и путь к рабочему пространству, прежде чем открывать
сессию агента.

## 3. Откройте рабочее пространство и авторизуйте Claude Code

Выберите директорию проекта внутри настроенного корня рабочего пространства,
создайте сессию и выберите Claude Code. Пройдите авторизацию Claude в терминале
на хосте так же, как сделали бы это без Chatcode.

Ограничьте учётные данные рамками задачи:

- по возможности используйте токен репозитория, выданный под конкретный проект;
- не держите продакшен-секреты в домашней директории пользователя шлюза;
- начинайте работу в ветке или worktree, которые можно проверить и выбросить;
- выберите настройку песочницы для сессии до того, как просить агента выполнять
  широкий круг команд.

На Linux для пользователя шлюза есть задокументированная модель
администрирования без участия человека. На macOS необязательный `sudo` без
пароля и системные запросы конфиденциальности нужно продумать отдельно.
Подробности — в [документации шлюза](/docs/gateway).

## 4. Привяжите Telegram

Привяжите аккаунт Telegram в Chatcode, затем откройте Mini App или привязанный
чат сессии. Сначала отправьте безобидный промпт, который ничего не меняет, и
убедитесь, что он попал в ту же сессию, что открыта в браузере.

У интерфейсов разные задачи:

- **Браузер:** полноценная работа в терминале, команды, развёрнутый вывод и
  управление сессиями.
- **Telegram:** непрерывность, уведомления, компактное взаимодействие и
  поддерживаемые представления файлов и сессий.

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

## 5. Проверьте живучесть сессии и восстановление

Прежде чем полагаться на эту схему вдали от рабочего места:

1. Запустите в браузере задачу, которая ничего не ломает.
2. Закройте браузер и убедитесь, что сессия на сервере продолжает работать.
3. Следите за ходом работы в Telegram.
4. Снова откройте браузер и проверьте, что это та же сессия.
5. Проверьте доступ по SSH и найдите логи шлюза, чтобы у вас был путь
   восстановления.

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

## Штатный Channels или Chatcode?

| | Claude Code Channels | Chatcode |
| --- | --- | --- |
| Основной интерфейс | Telegram | Терминал в браузере плюс Telegram |
| Процесс на хосте | Claude Code с включённым плагином | Служба шлюза и сессия агента |
| Запросы разрешений | Поддерживаемые запросы можно передавать в Telegram | Через терминал агента и настройки безопасности сессии |
| Агенты | Claude Code | Claude Code, Codex, Gemini и OpenCode |
| Зависимости доверия | Плагин Anthropic и Telegram | Шлюз/управляющий слой Chatcode и Telegram |
| Лучше всего подходит | Одна запущенная сессия Claude в Telegram | Постоянная работа в терминале с разных устройств или с разными агентами |

Channels — официальное, более узкое решение с меньшим числом движущихся частей.
Chatcode даёт более широкий интерфейс, но добавляет управляющий слой, который
может читать ретранслируемое содержимое терминала. Выбирайте по интерфейсу и
модели доверия, а не исходя из того, что управляемое решение автоматически
безопаснее.

Штатный путь описан в руководстве [Как подключить Claude Code к
Telegram](/articles/how-to-connect-claude-code-to-telegram).
