Код под рукой - как управлять проектами через Claude прямо в Telegram
Представьте ситуацию: вы едете в метро или стоите в очереди за кофе, и вдруг в рабочем чате всплывает баг, требующий немедленного фикса. Или вам пришла гениальная идея по рефакторингу, но ноутбука под рукой нет. Обычно в такие моменты мы просто вздыхаем и ждем возвращения к рабочему столу. Но что, если бы ваш терминал с мощным ИИ-помощником был доступен в обычном мессенджере?
Проект claude-code-telegram превращает эту фантазию в реальность. Это мост между вашим кодом и Claude Code — продвинутым CLI-агентом от Anthropic.
Что это такое и зачем оно разработчику
По сути, перед нами продвинутый Telegram-бот, который дает удаленный доступ к вашему рабочему окружению. Но это не просто «командная строка в телеге». Благодаря интеграции с Claude Code, бот понимает контекст вашего проекта, умеет читать файлы, запускать тесты и даже самостоятельно вносить правки.
Кому это пригодится?
- Тимлидам, которым нужно быстро проверить статус сборки или глянуть кусок кода без открытия IDE.
- Full-stack разработчикам, работающим «в полях».
- Энтузиастам автоматизации, которые хотят, чтобы ИИ сам присылал отчеты о здоровье проекта.
Главные фишки: почему это удобно
1. Агентский режим (Agentic Mode)
Это основной режим работы. Вы общаетесь с ботом как с коллегой-сеньором. Не нужно помнить синтаксис команд — просто пишите: «Добавь обработку ошибок в api.py и проверь, не упали ли тесты». Бот проанализирует файл, предложит изменения и сам запустит pytest.
Кстати, уровень «болтливости» бота настраивается командой /verbose. На максималках он будет показывать цепочку рассуждений (Reasoning), что очень помогает понять, почему ИИ принял то или иное решение.
2. GitHub на стероидах
Бот отлично дружит с gh CLI. Прямо из чата можно:
- Клонировать репозитории.
- Просматривать список открытых Issue.
- Создавать ветки под фиксы и пушить их в удаленный репозиторий.
Это превращает Telegram в полноценный пульт управления вашим GitHub-аккаунтом.
3. Режим терминала (Classic Mode)
Если вы предпочитаете старый добрый контроль, можно переключиться в классический режим. Там появляются привычные команды: /ls, /cd, /pwd, а также интерактивные кнопки для быстрых действий — например, запуск линтера или форматирование кода в один клик.
4. Проактивная автоматизация
Интересная особенность проекта — поддержка вебхуков и планировщика (Cron). Вы можете настроить бота так, чтобы он:
- Присылал краткое резюме каждого Pull Request в GitHub.
- Раз в сутки проводил «чекап» кодовой базы и уведомлял о потенциальных проблемах.
- Реагировал на события CI/CD.
Безопасность: чтобы код не утек «не туда»
Когда речь заходит об удаленном доступе к коду, первый вопрос — безопасность. Разработчик предусмотрел несколько уровней защиты:
- Белый список пользователей: бот будет отвечать только вам (нужно указать свой Telegram ID).
- Песочница (Sandboxing): вы жестко ограничиваете директорию, выше которой бот не сможет подняться. Никакого доступа к системным файлам
/etc/passwd. - Лимиты на токены: можно выставить бюджет в долларах, чтобы Claude случайно не «съел» всю зарплату на бесконечных циклах рефакторинга.
Как запустить у себя
Проект написан на Python и использует Poetry для управления зависимостями. Для старта понадобятся:
- Токен бота от @BotFather.
- Установленный Claude Code CLI (или API-ключ Anthropic).
- Python 3.10+.
Быстрый запуск выглядит стандартно:
git clone https://github.com/RichardAtCT/claude-code-telegram.git
cd claude-code-telegram
make dev
cp .env.example .env # Настраиваем свои ID и токены
make run
Практические кейсы: когда это спасает
Кейс №1: Срочный хотфикс. Вы замечаете опечатку в конфиге или тексте на проде. Открываете Telegram, пишете боту: «Исправь опечатку в config.yaml на строке 42 и запушь в main». Готово.
Кейс №2: Быстрый аудит. Вы скачали новую библиотеку и хотите быстро понять, как она устроена. Просите бота: «Проанализируй структуру папки libs/new-lib и объясни основные точки входа».
Кейс №3: Мониторинг. Настройте ежедневный отчет: «Каждое утро в 9:00 проверяй покрытие тестами и пиши мне, если оно упало ниже 80%».
claude-code-telegram — это не замена полноценной IDE, а мощный дополнительный инструмент. Он стирает границу между «я за компьютером» и «я на связи». Если вы уже используете Claude для помощи в кодинге, этот бот станет отличным дополнением к вашему рабочему процессу.
Проект активно развивается, и в планах автора — система плагинов для расширения возможностей. Определенно стоит добавить в закладки или развернуть на домашнем сервере/VPS для личного пользования.
