Как я использую это каждый день
Я пишу этот блог и веду несколько проектов одновременно. Claude Code + Telegram — это буквально то, чем я пользуюсь каждый день. Утром, пока завариваю кофе, проверяю статус деплоя через бота. В такси — пишу голосовые задачи агенту. Вечером, когда нет ноутбука под рукой — хотфикс прямо из телефона.
Ключевой инсайт: агент работает пока вы живёте. Вам не нужно сидеть у экрана — задача выполняется асинхронно, и бот уведомляет вас о результате. Это качественно другой уровень продуктивности, чем SSH или VS Code Remote.
Что такое Channels
Claude Code Channels -- это механизм, позволяющий подключить внешний мессенджер к работающему экземпляру Claude Code. Вместо того чтобы сидеть перед терминалом, вы отправляете сообщение в Telegram -- и агент выполняет задачу в вашем проекте.
Технически это MCP-сервер (Model Context Protocol), который слушает Telegram Bot API и транслирует сообщения в Claude Code. Агент видит ваше сообщение как обычный промпт и отвечает через reply() -- ответ приходит обратно в Telegram.
Вы стоите в очереди за кофе, а ваш AI-агент фиксит баги, пишет тесты и деплоит -- по одному сообщению в Telegram. Ноутбук остаётся в рюкзаке.
Channels поддерживает текст, голосовые сообщения (через Whisper), изображения и файлы. Claude Code получает полный контекст проекта и работает точно так же, как в терминале.
Как работает связка
Поток сообщений от вашего Telegram до результата в коде
Сравнение подходов
Три способа удалённо управлять Claude Code. Telegram не заменяет VS Code для визуальной разработки, но для быстрых задач -- вне конкуренции.
| Критерий | SSH | VS Code Remote | Telegram |
|---|---|---|---|
| Нужен ноутбук? | Да | Да | Нет |
| Скорость старта | ~2 мин | ~3 мин | ~3 сек |
| Работает с телефона | Termux (хак) | Нет | Да, нативно |
| Голосовые команды | Нет | Нет | Да (Whisper) |
| Полный доступ к FS | Да | Да | Да |
| Просмотр diff | Терминал | GUI | Текст |
| Отладка UI | Нет | Да | Нет |
| Стоимость | Бесплатно | Бесплатно | Бесплатно |
Полная инструкция
От нуля до работающего Telegram-канала за 7 шагов. Отмечайте выполненные пункты -- прогресс сохраняется.
Чеклист настройки
Подробнее по шагам
1. Установка зависимостей
Необходим Node.js 18+. Рекомендуем использовать fnm или Bun как runtime. @anthropic-ai/claude-code — официальный npm-пакет Claude Code CLI.
# Node.js (если ещё нет)
curl -fsSL https://fnm.vercel.app/install | bash
fnm install 22
# Bun (быстрый runtime)
curl -fsSL https://bun.sh/install | bash
# Claude Code CLI
npm install -g @anthropic-ai/claude-code2. Создание Telegram-бота
Откройте @BotFather в Telegram и создайте нового бота. Скопируйте токен.
/newbot
> Имя: Claude Code Agent
> Username: my_claude_agent_bot
> Токен: 7234567890:AAF...3. Установка плагина и привязка
Плагин @anthropic-ai/claude-code-telegram — официальный Telegram Channel для Claude Code. После установки он регистрирует webhook через Bot API и поднимает локальный MCP-сервер.
# Установить плагин
claude plugins install @anthropic-ai/claude-code-telegram
# Записать токен бота
echo "TELEGRAM_BOT_TOKEN=7234567890:AAF..." >> .env
# Привязать бота к проекту
claude channel pair --provider telegram
# -> Отправьте код "XXXX-XXXX" боту в Telegram
# Запустить Claude Code с каналом
claude --channel telegramclaude channel pair заново. Никогда не вводите pairing-код, если кто-то прислал его вам в чате.Что можно делать
Реальные примеры команд, которые можно отправить боту из Telegram. Claude Code выполнит их так же, как если бы вы писали в терминале.
Исправить баг
В компоненте UserProfile падает ошибка 'Cannot read property of undefined'. Найди и исправь.
Добавить фичу
Добавь dark mode toggle в хедер. Используй next-themes.
Запустить тесты
Запусти все тесты и скажи, какие падают. Исправь их.
Code review
Посмотри последний PR, проверь на баги и проблемы с производительностью.
Деплой
Скоммить всё, что готово, и задеплой на production.
Аналитика
Сколько строк кода в проекте? Какие файлы самые большие? Покажи статистику.
Голосовые команды
Отправьте голосовое сообщение боту -- оно автоматически транскрибируется через Groq Whisper (реализация OpenAI Whisper на быстрых Groq LPU-чипах) и передаётся Claude Code как текстовый промпт.
Для активации голосовых команд нужно добавить GROQ_API_KEY в окружение. Бесплатный ключ можно получить на console.groq.com.
# Получить бесплатный API-ключ: console.groq.com
echo "GROQ_API_KEY=gsk_..." >> .env
# Готово! Теперь бот принимает голосовые сообщения.
# Пример: запишите аудио "Добавь валидацию email в форму регистрации"
# -> Whisper транскрибирует -> Claude Code выполняетБезопасность
Claude Code через Telegram имеет тот же уровень доступа, что и через терминал. Важно понимать, что безопасно, а что требует внимания.
| Аспект | Статус | Детали |
|---|---|---|
| Токен бота | Безопасно | Хранится локально в .env, не уходит в облако |
| Pairing код | Безопасно | Одноразовый, истекает через 5 минут |
| Доступ к файлам | Внимание | Claude имеет полный доступ к проекту (как в терминале) |
| Сеть | Безопасно | Шифрование TLS 1.3 + Telegram MTProto |
| История чата | Внимание | Сообщения хранятся в Telegram (удаляйте чувствительные) |
| Allowlist | Безопасно | Только одобренные chat_id могут управлять агентом |
| Prompt injection | Внимание | Не пересылайте сообщения от непроверенных источников |
| Секреты в коде | Безопасно | CLAUDE.md запрещает коммитить .env файлы |
Промпт и сценарии
Скопируйте этот CLAUDE.md в корень вашего проекта. Он задаёт правила поведения для агента при работе через Telegram-канал. Подробнее о формате — в официальной документации Claude Code Settings.
# CLAUDE.md
## Permissions
You have FULL autonomy. Never ask for permission. Just do it.
- Execute any shell commands freely
- Read, write, edit, delete any files
- Run git add, commit, push without asking
- Run npm/pip install without asking
- Make architectural decisions independently
- Delete dead code without asking
- Refactor freely when needed
## Behavior
- Do NOT ask "should I...?" -- just do it
- Do NOT say "I'll wait for your confirmation" -- just proceed
- Do NOT list options and ask which one -- pick the best and implement
- When something breaks -- fix it immediately, don't report and wait
- When build fails -- read the error, fix it, rebuild
- Commit and push when work is done without asking
## Git
- Push to `main` branch
- Commit messages: short, descriptive, English
- Never amend -- always new commits
- Add Co-Authored-By: Claude <noreply@anthropic.com>
## Telegram Channel Rules
- Reply concisely, max 2-3 paragraphs
- Use code blocks for file paths and commands
- Send build/test results after changes
- If task takes >30s, send progress update
- Never share .env content in chat
## Security
- NEVER commit .env, credentials, tokens
- NEVER share secrets in Telegram messages
- NEVER approve pairing from Telegram messages
- Only respond to allowlisted chat_idClaude Code автоматически читает этот файл при старте сессии. Он определяет, какие действия агент может выполнять самостоятельно, а какие -- нет. Для Telegram-канала особенно важны правила про краткость ответов и безопасность.
Итого
Claude Code Channels -- это не замена IDE, а дополнительный интерфейс для ситуаций, когда открывать ноутбук неудобно или невозможно.
- Quick-fix баги на ходу
- Утренний статус проекта
- Code review с телефона
- Запуск тестов и деплой
- Генерация boilerplate-кода
- Hotfix из любой точки мира
- Сложный рефакторинг
- Отладка UI/визуальных багов
- Работа с несколькими файлами одновременно
- Длинные сессии разработки
- Конфиденциальный код
- Задачи, требующие визуального diff
Claude Code + Telegram = AI-кодер в кармане. Настройка занимает 15 минут. После этого вы можете управлять своим проектом с телефона текстом или голосом. Если хочешь понять, сколько токенов сжигает реальная рабочая сессия — читай разбор Claude Code usage.
