Руководство

Как пользоваться Claude Code в Telegram через Chatcode

Claude Code на вашем сервере с терминалом в браузере и Telegram от Chatcode: настройка и компромиссы — хост, ретранслятор, учётные данные и штатный плагин.

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

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

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

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

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

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

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

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

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

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

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

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

Привяжите аккаунт 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.

Часто задаваемые вопросы

Нужен ли для Chatcode VPS?

Нет. Можно подключить поддерживаемый Linux-сервер или Mac, который у вас уже есть. VPS полезен, когда сессия должна оставаться доступной, пока ваш личный компьютер спит.

Telegram — это полноценный терминальный интерфейс?

Нет. Основной терминал — браузер. Telegram даёт привязанные представления сессии, уведомления, превью файлов и непрерывность работы с той же сессией на сервере.

Можно ли вместо этого использовать официальный плагин Claude Code для Telegram?

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

Может ли Chatcode читать терминальный трафик?

Да. Соединения шифруются TLS на каждом участке, но управляющий слой Chatcode — доверенный ретранслятор, а не канал со сквозным шифрованием. Он обрабатывает содержимое терминала для форматирования в Telegram, превью, расшифровки речи и уведомлений.

Поделиться руководством