Claude Code Telegram Bot CLI
Telegram-бот дает удаленный доступ к Claude Code: пишете в чат, а агент правит проект с сохранением сессий и защитой каталога.
- 2 823 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Бот дает допущенным пользователям Telegram управление Claude Code с чтением, изменением файлов и запуском команд в каталоге проекта, а токен бота нужно хранить в секрете.
Установка
- Работает в
Ручная установка
uv tool install git+https://github.com/overwirehq/claude-code-telegram@v1.3.0Рекомендуемый способ из README. После установки заполните `.env` и запустите `make run`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Бот дает допущенным пользователям Telegram управление Claude Code с чтением, изменением файлов и запуском команд в каталоге проекта, а токен бота нужно хранить в секрете.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Бот соединяет Telegram с Claude Code, так что с кодом можно работать из чата с любого устройства. Сессия сохраняется для каждой пары пользователь и проект, команда `/repo` переключает каталоги, а `/verbose` задает, сколько фоновой работы показывать. Есть режим терминальных команд (`AGENTIC_MODE=false`) с `/cd`, `/ls`, `/git` и кнопками. Для безопасности заданы список разрешенных пользователей, каталог `APPROVED_DIRECTORY` с защитой от выхода за его пределы, лимит запросов и журнал действий. Дополнительно бот принимает вебхуки GitHub, запускает задачи по расписанию, разбирает загруженные файлы и скриншоты и расшифровывает голосовые сообщения.
Для кого. Разработчикам, которые хотят дать задачу агенту с телефона и получить результат в Telegram, пока компьютер с проектом работает дома или на сервере.
Подходит, если
- Нужно с телефона посмотреть тесты проекта и попросить агента поправить мелкую ошибку.
- Уведомления о событиях GitHub и итоги ночных проверок должны приходить в Telegram.
- Сервер с проектом без графического доступа, и работать с агентом удобнее в мессенджере.
- Один бот обслуживает несколько проектов, и нужно быстро переключаться между репозиториями.
Не подходит, если
- Проект с секретами или закрытым кодом, который нельзя доверять цепочке из Telegram и ключей бота.
- Нужна полная проверка каждого изменения перед записью: бот работает через Claude Code с правами на каталог.
- Нет Claude Code на машине с бота: он управляет уже установленным CLI.
Пример запроса к агенту
Подключи бота к каталогу `~/projects`, допусти только мой идентификатор Telegram и покажи, как с телефона попросить Claude запустить тесты.Ограничения
Нужны Python 3.11 или новее, установленный Claude Code CLI и токен бота от BotFather. В `.env` задаются `TELEGRAM_BOT_TOKEN`, `APPROVED_DIRECTORY` и `ALLOWED_USERS`, где перечислены числовые идентификаторы допущенных пользователей. Любой, кого вы допустили, получает управление Claude Code с доступом к файлам и командам внутри этого каталога, поэтому список держите коротким. Автор советует ставить из тега релиза, а не из `main`. На GitHub лицензия не определена, хотя в README стоит значок MIT.
Как отключить. Остановите бот (`Ctrl+C` или остановка службы), отзовите токен у @BotFather командой `/revoke`, удалите пакет `uv tool uninstall` и файл `.env`.
Частые вопросы
Как поставить бот?
Через `uv tool install git+https://github.com/overwirehq/claude-code-telegram@v1.3.0` или `pip install` из тега релиза. Для разработки есть `make dev` с Poetry.
Что нужно задать минимально?
`TELEGRAM_BOT_TOKEN`, `TELEGRAM_BOT_USERNAME`, `APPROVED_DIRECTORY` и `ALLOWED_USERS` в файле `.env`.
Чем отличаются режимы?
Агентный режим по умолчанию: вы просто пишете. Классический (`AGENTIC_MODE=false`) добавляет 13 команд с кнопками, навигацией по каталогам и командами git.
Можно ли получать уведомления?
Да, при `ENABLE_API_SERVER=true` и `ENABLE_SCHEDULER=true` бот принимает вебхуки GitHub и выполняет задачи по расписанию.
Как защищен доступ?
Список допущенных пользователей, необязательный токен, ограничение запросов, защита от выхода из `APPROVED_DIRECTORY` и журнал действий.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыТелеграм-бот для OpenCode: ставит задачи агенту, следит за ходом работы и переключает модели с телефона, пока OpenCode работает на вашем компьютере
Claude Chat Mobile пускает с телефона в сессию Claude Code на вашем компьютере: подтверждения, вопросы и пуши на экран блокировки.
Выводит скрытые мысли, вызовы инструментов и подагентов Claude Code в отдельный терминал с деревом сессий в реальном времени
Xylocopa — браузерный оркестратор агентов Claude Code: задачи GTD, параллельные агенты в деревьях git, подтверждения с телефона.
Набор slash-команд, скиллов и субагентов для Claude Code: ревью, тесты, безопасность, релизы, документация и синхронизация GitHub с Linear
Общие настройки Claude Code для команды: хуки против опасных команд, проверка перед завершением и скиллы от спецификации до ревью
Коротко о README
В README описан Telegram-бот поверх Claude Code с двумя режимами, защитой каталога, вебхуками и расписанием. Ставится из тега релиза через `uv` или `pip`.