Claude неожиданно "отрубил" мне OpenClaw - и моя повседневная рабочая связка разлетелась в момент. Никакого доступа к Claude Code через Telegram, никакого удобного управления проектами из одного окна. После короткой фазы негодования я просто сел и написал собственную замену.
Я назвал её TeleClaude.
Это self‑hosted инструмент, написанный на TypeScript под Bun, который:
- работает на вашей машине;
- использует вашу собственную подписку Claude (Max, Pro или Team);
- не обращается напрямую к Anthropic API;
- не требует сторонних сервисов или дополнительных платежей;
- авторизуется через тот же OAuth, что и Claude Code в терминале.
Фактически TeleClaude - это "прокладка" между Telegram и Claude Code CLI, которая превращает супергруппу с топиками в удобный центр управления всеми вашими проектами.
---
Зачем вообще нужен Claude Code в Telegram
Мой типичный рабочий день - это несколько параллельных проектов: бэкенд, фронтенд, лендинг, DevOps, внутренняя автоматизация. У каждого - свои файлы, свои решения, состояние задач и инфраструктура. А ещё есть привычка всё делать из одного интерфейса - Telegram.
Claude Code отлично работает с файловой системой напрямую, но постоянное переключение каталогов и контекстов в терминале быстро утомляет. Хотелось:
- один чат вместо десятка разных окон;
- жёсткую привязку каждого топика к своему проекту;
- постоянную память по проектам, чтобы можно было "вернуться в разговор" через неделю;
- полноценный доступ к файлам и командам, как в обычном Claude Code.
Раньше эту схему обеспечивал OpenClaw. Когда Anthropic закрыл ему доступ к Claude Code через Telegram, схема посыпалась. TeleClaude решает ту же задачу, но уже локально, без завязки на чужие сервисы.
---
Архитектура TeleClaude
В основе TeleClaude - простой, но продуманный пайплайн:
1. Telegram‑бот получает сообщения из супергруппы.
2. Grammy (Telegram‑фреймворк для Node/Bun) обрабатывает апдейты и определяет:
- из какого топика пришло сообщение;
- какому проекту этот топик соответствует.
3. Для каждого топика запускается изолированный процесс Claude Code CLI:
- со своей рабочей директорией;
- со своей файловой памятью;
- со своим контекстом диалога.
4. Ответ Claude стримится обратно в Telegram:
- видно "печатает...";
- сообщение обновляется по мере генерации.
Ключевая особенность - TeleClaude не стучится в Anthropic API сам по себе. Он запускает такие же процессы `claude` (Claude Code CLI), как если бы вы это делали руками в терминале. Авторизация - та же, через OAuth. Если вы уже залогинены в Claude Code, TeleClaude просто начинает работать.
Это снимает с вас головную боль:
- не нужно думать про ключи, токены и ограничение по API;
- не нужно настраивать биллинг специально под Telegram‑бота;
- не возникает "двух разных Claude" с отдельной историей - это тот же самый Claude Code.
---
Система памяти: три уровня контекста
Самая значимая часть TeleClaude - файловая память. Она разделена на три слоя, и именно это делает работу с проектами ощущаемой "цельной" и непрерывной.
1. SOUL.md - "душа" бота
Один общий файл для всего бота. В нём задаются:
- язык общения;
- тон и стиль (насколько формально, сколько деталей, как отвечать на вопросы);
- правила форматирования (например, всегда использовать списки и код‑блоки);
- принципы принятия решений.
Этот файл подключён ко всем проектам одинаково. Благодаря этому:
- Claude ведёт себя предсказуемо в любом топике;
- переход между темами не ломает стиль общения;
- вам не нужно каждый раз заново объяснять, "как со мной разговаривать".
2. main-memory.md - общая база знаний
Это симлинкованный файл, доступный из каждого проекта. В нём удобно хранить:
- карту всех проектов и их краткое описание;
- контакты и ответы на типичные организационные вопросы;
- ссылочную информацию: где какой репозиторий, какие сервера, какие ключи хранятся где;
- общие технические соглашения (кодстайл, соглашения по именованию, инфраструктурные правила).
Главный плюс: всё важное, что Claude узнал в одном топике, может быть использовано в другом. Например:
- в "DevOps" вы настроили кластер и описали, как с ним работать;
- спустя неделю в топике "Бэкенд" просите настроить CI под этот кластер;
- Claude находит нужную информацию в общей памяти и не задаёт элементарных вопросов.
3. topic-memory.md - память конкретного проекта
Для каждого топика создаётся свой файл памяти, куда попадает:
- история ключевых решений;
- эволюция архитектуры;
- текущий статус задач;
- временная линия: что делали в последние сессии.
Claude обновляет этот файл автоматически, по мере работы. За счёт этого:
- можно сбрасывать сессию, не боясь потерять контекст;
- можно перезапускать процессы, не восстанавливая историю руками;
- через неделю или месяц можно вернуться с вопросом "где мы остановились?" и получить содержательный ответ.
---
Автоматическое создание проектов из топиков
Как только в супергруппе появляется новый топик, TeleClaude:
1. Создаёт под него директорию проекта по шаблону.
2. Линкует в неё общие файлы `SOUL.md` и `main-memory.md`.
3. Генерирует начальный `topic-memory.md`.
4. Подготавливает рабочее окружение для Claude Code.
Следующее сообщение в этом топике уже попадёт в свой, изолированный процесс Claude с полноценным контекстом. Вам не нужно:
- руками создавать папки;
- копировать и вставлять инструкции;
- регистрировать проект где‑то отдельно.
За всё отвечает механизм шаблонов в каталоге `templates/`. В шаблоне можно заранее определить:
- стартовую структуру каталогов (src, docs, infra и т.д.);
- дефолтные инструкции для конкретного типа проекта (например, "это фронтенд на React" или "это Terraform‑конфигурация");
- начальный контент памяти (общее ТЗ, список обязательных требований).
---
Компрессия контекста: как TeleClaude обходит лимиты
У Claude Code есть ограничение на объём контекста. При длинных диалогах история переполняется:
- растёт объём запросов;
- растёт стоимость (если вы в Max/Pro);
- повышается риск, что модель "забудет" важные детали или обрежет историю в неудобный момент.
TeleClaude решает эту проблему автоматически:
1. Отслеживает размер текущего контекста.
2. Когда объём приближается к лимиту:
- извлекает ключевые решения, факты и выводы из диалога;
- сохраняет их в соответствующие файлы памяти (`main-memory.md` и `topic-memory.md`);
- сбрасывает текущую сессию.
3. Запускает новую сессию Claude Code, но уже с подгруженной файловой памятью.
С вашей точки зрения это выглядит как "обновление страницы", но при этом:
- вы не теряете смысловую нить;
- старые важные факты не исчезают;
- модель опирается на уже структурированную базу знаний, а не на хаотичный лог чата.
Если нужно, компрессию можно запустить вручную командой `/compact` - полезно после больших обсуждений, когда вы чувствуете, что "всё уже сказано, пора зафиксировать выводы".
---
Полный набор возможностей TeleClaude
Функциональность TeleClaude строится вокруг удобной работы с проектами из одного Telegram‑чата:
- Маршрутизация по топикам
Каждый топик = отдельный проект = отдельный процесс Claude Code со своей рабочей директорией.
- Постоянная память
Три уровня:
- общая личность бота (SOUL);
- общая база знаний;
- память по конкретному проекту.
- Автоматическое создание проектов
Новые топики автоматически получают директорию на диске, связанную с шаблоном.
- Голосовые сообщения
Поддерживается распознавание речи через локальный Whisper ASR. Можно наговорить задачу голосом, TeleClaude превратит её в текст и передаст Claude.
- Стриминг ответов
Ответ не появляется единым куском - вы видите, как он печатается и обновляется. Это особенно удобно при длинных развёрнутых сообщениях или при просмотре шагов размышления.
- Переключение моделей
Можно работать с разными вариантами:
- Claude Opus;
- Claude Sonnet;
- Claude Haiku;
- локальные модели через те же интерфейсы, что использует Claude Code.
- Непрерывность сессий
Флаг `--continue` в запущенном процессе Claude Code сохраняет контекст между сообщениями в рамках одного топика.
- Управление процессами
Настраиваются:
- время жизни (TTL) неактивных процессов;
- максимальное количество параллельных процессов;
- логика очистки простаивающих сессий, чтобы не засорять систему.
- Дедупликация памяти
Периодически запускается пересмотр файлов памяти и очистка дублирующейся информации, чтобы база знаний не разрасталась бесконтрольно.
---
Требования к окружению
Чтобы поднять TeleClaude, потребуется:
- Bun 1.0+ - среда выполнения для TypeScript‑приложения.
- Claude Code CLI - должен быть установлен и авторизован через OAuth (как обычно, через `claude login`).
- Любая активная подписка Claude - Max, Pro или Team, без разницы.
- Telegram‑бот, созданный через @BotFather.
- Telegram‑супергруппа с включёнными топиками - именно в ней будут "жить" ваши проекты.
---
Настройка и запуск (общая схема)
Процесс установки в общих чертах выглядит так:
1. Устанавливаете Bun и Claude Code CLI.
2. Авторизуетесь в Claude Code через OAuth.
3. Создаёте Telegram‑бота и получаете токен.
4. Настраиваете окружение через `.env`:
- токен бота;
- ID супергруппы;
- путь к директории с проектами;
- параметры процессов (TTL, лимиты и т.п.).
5. Запускаете TeleClaude:
- создаются базовые шаблоны;
- подключается к Telegram;
- начинает слушать сообщения и события топиков.
После этого достаточно создать или использовать существующий топик - и бот начнёт относиться к нему как к отдельному рабочему пространству.
---
Команды бота
Набор команд может меняться, но базовый функционал обычно включает:
- `/start` - первичная инициализация, проверка связи и краткая справка.
- `/compact` - ручной запуск компрессии контекста и обновления файлов памяти.
- `/model` - выбор модели (Opus, Sonnet, Haiku и т.д.) для конкретного топика.
- `/reset` - сброс текущей сессии Claude Code для топика при сохранённой файловой памяти.
- `/status` - отображение статуса процессов: активные сессии, время работы, текущий размер памяти.
- `/help` - список доступных команд и краткое описание сценариев использования.
Конкретная реализация каждой команды завязана на внутреннюю логику TeleClaude, но общий принцип прост: все операции управляют либо памятью, либо процессами Claude, либо настройкой контекста.
---
TeleClaude vs OpenClaw: что изменилось
По ощущениям TeleClaude повторяет тот сценарий, который давал мне OpenClaw, но с важными отличиями:
1. Полный контроль
Всё крутится у вас на машине или вашем сервере. Никаких внешних прокладок, которые могут внезапно потерять доступ.
2. Нет отдельного биллинга
Используется ваша стандартная подписка Claude. TeleClaude не добавляет никаких подписок поверх.
3. Глубокая файловая интеграция
Трёхуровневая память и шаблонизация проектов превращают Telegram в настоящий "центр управления" кодовой базой, а не просто чат с моделью.
4. Прозрачная авторизация
Вход в систему - тот же, что и у Claude Code. Никаких дополнительных ключей или конфигураций для API.
5. Гибкость под свои нужды
Архитектура на TypeScript + Bun позволяет быстро дописывать свою логику:
- новые команды;
- интеграции с CI/CD;
- собственные форматы шаблонов.
---
Как TeleClaude меняет рабочий процесс
После перехода с OpenClaw на TeleClaude моё ежедневное использование Claude выглядит так:
- один Telegram‑чат с супергруппой;
- по топику на каждый реальный проект или подсистему;
- Claude в каждом топике знает:
- контекст проекта;
- историю решений;
- текущий статус задач;
- переключение между задачами - просто смена топика, а не директории и терминала;
- любой важный инсайт, однажды сохранённый в памяти, доступен отовсюду.
Психологически это снимает ощущение "хрупкости" сетапа: когда цепочка из внешних сервисов может сломаться в любом звене. Здесь всё завязано на локальном CLI и вашей подписке.
---
Дополнительные сценарии использования
Помимо классической разработки, TeleClaude очень неплохо подходит для:
- Документации
Отдельный топик под "Docs", где Claude:
- поддерживает живую документацию по проекту;
- сам обновляет `topic-memory.md` при изменении архитектуры;
- генерирует README, инструкции по деплою и on‑boarding.
- Продуктового менеджмента
Топик для фич, приоритизации, дорожной карты:
- хранится контекст по обсуждениям;
- фиксируются компромиссы;
- в памяти остаются обоснования, почему от чего‑то отказались.
- Обучения и онбординга
Отдельный топик для новых участников команды:
- bot отвечает на типовые вопросы на основе общей памяти;
- подсказывает, где какие репозитории и сервисы;
- даёт ссылки на внутренние практики и стандарты.
- Инфраструктуры и DevOps
Топик "Инфра":
- хранит историю изменений конфигураций;
- фиксирует архитектуру кластеров и пайплайнов;
- помогает генерировать и править конфиги.
---
Заключение
TeleClaude родился из простой, но болезненной проблемы: когда внешний сервис внезапно перестаёт работать, а вся твоя повседневная рутина завязана на него. Перенеся логику "Claude в Telegram" в локальный, self‑hosted мир, удалось:
- сохранить удобство общения через Telegram;
- усилить возможности за счёт многоуровневой памяти;
- избавиться от зависимости от сторонних прокладок и их внутренней политики.
Если вы привыкли управлять проектами из одного окна и активно используете Claude Code, связка супергруппа с топиками + TeleClaude даёт очень комфортный и предсказуемый способ работать с ИИ как с постоянным членом команды, а не просто как с "чатом на сайте".
