ClaudeBot CLI
Telegram-бот управляет Claude Code на вашем компьютере: пишете в чат, а агент правит проект и стримит ответ.
- 65 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Сообщение в Telegram запускает агента, который правит файлы и выполняет команды на вашем компьютере.
- Через `/pair` агент получает доступ к файлам удаленной машины по WebSocket.
Установка
- Работает в
Ручная установка
npx claudebot-appСкачивает проект, запускает мастер настройки и стартует бота.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сообщение в Telegram запускает агента, который правит файлы и выполняет команды на вашем компьютере.
- Через `/pair` агент получает доступ к файлам удаленной машины по WebSocket.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ClaudeBot запускает установленные у вас CLI Claude Code, Gemini и Codex и связывает их с чатом Telegram. Ответ идет в чат потоком, правки применяются к реальным файлам и репозиториям, а сессии хранятся отдельно для каждого проекта и продолжаются через `--resume`. В комплекте очередь задач с блокировкой между ботами, режим `/deep` с Opus и субагентами, параллельный запуск в отдельных ветках git, плагины без расхода токенов, голосовой ввод через локальный Sherpa-ONNX и подключение удаленной машины командой `/pair`. API-ключи и облачный посредник не нужны.
Для кого. Разработчикам, которые хотят ставить задачи Claude Code с телефона и держать весь процесс на своей машине.
Подходит, если
- Нужно поставить в очередь десять задач и уйти от компьютера, получая отчеты в Telegram.
- Несколько ботов работают над одним проектом в отдельных ветках git.
- Голосовое сообщение превращают в задачу для агента.
- Удаленную машину подключают командой `/pair`, и агент читает и пишет там файлы.
Не подходит, если
- Нужен только разовый чат без доступа к коду и файлам.
- Компьютер с Claude CLI не может оставаться включенным.
- Доступ к файлам по сообщению из мессенджера для вас неприемлем.
Пример запроса к агенту
Поставь задачу в очередь: обнови зависимости в проекте и пришли итог в Telegram.Ограничения
Нужны Node.js версии 20 или новее и Claude CLI с выполненным входом. Gemini CLI, Python версии 3.11 или новее и sherpa-onnx необязательны. Голосовой ввод работает после установки sherpa-onnx. Доступ к боту защищают идентификатор чата, bcrypt и лимит запросов, а файлы `.env`, `.sessions.json` и `.pairings.json` агент удалить не может. Бот управляет реальными файлами и командами, поэтому токен Telegram и список разрешенных чатов храните в секрете.
Как отключить. Остановите процесс бота и удалите каталог проекта вместе с `.env`. Токен бота в Telegram отзовите через BotFather.
Частые вопросы
Как запустить ClaudeBot?
Выполните `npx claudebot-app`. Команда скачивает проект, запускает мастер настройки и стартует бота; ffmpeg уже в комплекте.
Нужны ли API-ключи?
Нет. Бот вызывает установленные CLI, поэтому работает через ваш вход в Claude CLI.
Как запустить несколько ботов на одном проекте?
Задайте `WORKTREE_BRANCH=bot1` в `.env`: бот создаст изолированный worktree git и не будет мешать другим.
Что делает команда /deep?
Переключает бота на Opus с субагентами для разбора задачи с нескольких сторон.
Как бот защищает доступ?
Проверяет идентификатор чата, хранит пароль через bcrypt и ограничивает частоту запросов. Файлы `.env`, `.sessions.json` и `.pairings.json` агент удалить не может.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыUntether связывает Claude Code, Codex и OpenCode с Telegram: задачи голосом и текстом, прогресс в чате, подтверждения кнопками.
Подключает Claude Code, Cursor, Codex или OpenCode к Telegram, Slack и Discord: коллеги пишут боту, отвечает кодовый агент
Расширение официального плагина Telegram для Claude Code: голосовые сообщения, живой прогресс, кнопки, память и доска агентов
Плагин превращает Claude Code в фонового ассистента: расписание задач, ответы в Telegram, Discord и Slack, веб-панель.
CLI управляет аккаунтом Telegram из терминала: демон, вывод JSON для агентов, события по вебхукам и готовый скилл для Claude Code.
CLI держит агентов Claude Code круглосуточно в сессиях PTY, а управлять ими можно из Telegram, панели и по расписанию.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| ClaudeBot (эта карточка) | нет | 65 | |
| Claude Code Telegram Bot | нет | 2 823 | минимальный мост между чатом и Claude Code; ClaudeBot добавляет очередь, ветки git, голос и плагины |
| OpenCode Telegram Bot | нет | 1 352 | бот для OpenCode; ClaudeBot работает с Claude Code, Gemini и Codex |
Коротко о README
Проект позиционирует себя как командный центр на телефоне, а не обертка над API. Основа описана в разделах об архитектуре, директивах ИИ и памяти из четырех слоев.