Claude-бот обычно означает Telegram-бота, который принимает сообщение, передаёт его вашему серверу, вызывает Claude API и возвращает ответ. Для рабочего результата нужны два отдельных токена, серверная логика, ограничение доступа и журнал ошибок. Вставлять ключ Anthropic или токен Telegram в страницу, приложение пользователя или публичный репозиторий нельзя.
Из каких частей состоит бот
Telegram отвечает за доставку сообщений, ваш сервер проверяет пользователя и хранит состояние, Claude формирует ответ через Messages API. Официальная документация Anthropic описывает POST /v1/messages: запрос содержит модель, лимит ответа и список сообщений, а результат возвращается структурированными блоками. Актуальная схема приведена в Claude API Reference.
- Бот Telegram с токеном от BotFather.
- Сервер или облачная функция, которая работает постоянно.
- Ключ Anthropic, доступный только серверу.
- Хранилище разрешённых пользователей и короткой истории диалога.
- Ограничения на длину, частоту и тип входных сообщений.
- Понятный ответ при недоступности одного из сервисов.
Секреты хранятся на сервере. Если ключ можно увидеть в исходном коде страницы или мобильного приложения, его нужно считать раскрытым и заменить.
Что должно получиться до разработки
Опишите один сценарий: кто пишет, какую задачу решает бот, какие данные можно отправлять, что считается хорошим ответом и когда нужен оператор. Сценарий «бот умеет всё» не подойдёт. Узкий сценарий проще проверить, ограничить и оплачивать.
- Выберите один тип задачи, например ответы по открытой базе знаний.
- Запишите допустимые и запрещённые данные.
- Определите, кто имеет доступ: все, список пользователей или сотрудники.
- Задайте максимальный размер сообщения и длину истории.
- Опишите проверку результата и сообщение при ошибке.
- Только после этого создайте токены и серверный обработчик.
Для общей архитектуры ИИ-ботов пригодится пошаговый разбор создания ИИ-бота. Здесь фокус уже: безопасно связать два официальных API и не перепутать роль каждого компонента.
Telegram-бот может вести целый канал за автора. Завтра в 12:00 МСК на бесплатном мастер-классе Яков Юдин показывает своего агента в деле и объясняет, какую рутину ему можно доверить.
Увидеть агента в делеСоздайте Telegram-бота
Telegram предлагает зарегистрировать бота у @BotFather командой /newbot, получить токен и обращаться к Bot API по HTTPS. Официальный учебник также предупреждает хранить токен как пароль и не делиться им. Шаги опубликованы в руководстве Telegram.
- Откройте официальный
@BotFatherи выполните/newbot. - Задайте понятное имя и свободное имя пользователя бота.
- Сохраните токен в менеджере секретов или переменной окружения сервера.
- Отправьте боту
/start, чтобы появился тестовый диалог. - Получите первое обновление через webhook или long polling.
- Не публикуйте полный объект обновления в общий журнал, если там есть личные сообщения.
Токен Telegram и ключ Anthropic не взаимозаменяемы. Первый управляет ботом, второй разрешает вызовы модели. Для понимания отдельных этапов регистрации используйте инструкцию по BotFather.
По теме: Как создать свой VPN-бот: безопасная схема и проверка
Вызовите Claude только с сервера
Anthropic рекомендует задавать ключ через переменную окружения и отправлять сообщение серверным SDK или HTTP-запросом. Начальный пример и требования к ключу опубликованы в официальном quickstart. Не фиксируйте название модели из случайного примера навсегда: вынесите его в настройку и сверяйте с текущей документацией.
TELEGRAM_BOT_TOKEN=...
ANTHROPIC_API_KEY=...
1. Получить сообщение Telegram
2. Проверить chat_id и размер текста
3. Сформировать короткий список messages
4. Вызвать POST /v1/messages
5. Извлечь текстовый блок ответа
6. Отправить ответ через sendMessage
Псевдокод намеренно не содержит настоящих токенов. В рабочей версии добавьте таймаут, повтор только для безопасных временных ошибок и единый идентификатор запроса. Не повторяйте запрос после неопределённого сбоя бесконечно: вы можете получить дубли и лишний расход.
Самое интересное начинается, когда за ботом стоит агент. Завтра в 12:00 МСК на бесплатном мастер-классе ему дают задачу голосом, и он сам собирает данные в Google-таблицу, а в Claude Code за эфир проходят путь от идеи до работающего сервиса.
Занять местоКак хранить контекст диалога
Messages API допускает передачу нескольких чередующихся сообщений, но историю собирает ваше приложение. Для каждого диалога храните только необходимый контекст, ограничивайте объём и давайте команду очистки. Не считайте Telegram архивом для серверной памяти.
- Системное правило с ролью и границами бота.
- Последние релевантные реплики, а не весь чат навсегда.
- Идентификатор пользователя без лишних личных данных.
- Время последней активности и срок удаления истории.
- Флаг передачи оператору при запрещённой или рискованной задаче.
Для бота по документам храните источник ответа отдельно и просите модель ссылаться на него. Для свободного собеседника заранее скажите, что ответы могут ошибаться. Если нужна общая разница между ботом и агентом, используйте простое объяснение ИИ-агента.
По теме: Salebot: как создать бота в Telegram и проверить сценарий
Проверка перед открытием доступа
Тестируйте не только счастливый путь. Создайте таблицу входа, ожидаемого ответа и допустимой реакции при отказе. Проверка должна доказать, что секреты не раскрываются, чужой пользователь не получает доступ и длинное сообщение не кладёт обработчик.
- Разрешённый пользователь получает ответ по выбранному сценарию.
- Неизвестный пользователь получает нейтральный отказ без деталей системы.
- Пустое и слишком длинное сообщение обрабатываются предсказуемо.
- Команда очистки удаляет серверную историю диалога.
- При таймауте Claude бот сообщает о временном сбое и не зацикливает повторы.
- Токены не встречаются в ответах, журналах и исходном коде клиента.
- Сообщение с персональными данными не сохраняется дольше заявленного срока.
Диагностика по месту разрыва
Если Telegram не видит бота, проверьте регистрацию и токен. Если сообщения приходят, но ответа нет, проверьте webhook, журнал обработчика и таймаут. Если Claude возвращает отказ или ошибку, сохраните код и безопасную часть ответа, затем сверяйте форму запроса с официальной схемой.
- Нет обновлений: webhook указывает на недоступный адрес либо long polling уже запущен в другом процессе.
- Ответ приходит дважды: два обработчика получают одно событие или повтор не учитывает идентификатор update.
- Контекст перепутан: история хранится без разделения по диалогам.
- Бот зависает на длинном ответе: ограничьте вывод и делите отправку на безопасные части.
- Расход растёт: сокращайте историю и отсекайте повторные или служебные сообщения до вызова модели.
- Ключ раскрыт: отзовите его, создайте новый и только потом ищите источник утечки.
По теме: Как сделать бота приватным в Telegram: доступ только своим 2026
Когда Claude-бот не подходит
Не отправляйте через внешнюю модель медицинские, платёжные, кадровые или другие чувствительные данные без отдельной правовой и технической оценки. Бот не нужен, если задача решается обычным меню, поиском или шаблонным ответом: модель добавит стоимость и непредсказуемость без пользы.
Если нужна нейросеть именно внутри Telegram, но выбор модели ещё не сделан, сравните границы в разборе подключения нейросети к Telegram-боту.
Частые вопросы
Можно ли сделать Claude-бота без сервера?
Для постоянной безопасной работы нужен серверный компонент или облачная функция. Иначе негде защищать ключи, принимать события и хранить состояние.
Можно ли вставить ключ Anthropic в JavaScript сайта?
Нет. Код браузера доступен посетителю. Вызов к Anthropic должен проходить через ваш сервер с проверкой доступа.
Где хранится память бота?
Её хранит ваше приложение или база. В каждом запросе вы передаёте нужный контекст по правилам Messages API.
Нужна ли отдельная подписка Claude?
Доступ к API и потребительская подписка остаются разными продуктами. Перед запуском сверяйте условия API в официальной консоли Anthropic.
Схема Claude-бота собрана и проверена. Как выглядит такой бот, когда он каждый день работает на автора, покажет Яков Юдин на бесплатном мастер-классе завтра в 12:00 МСК: дайджест новостей голосом, транскрибатор, контент-завод канала.
Записаться бесплатно