Свои ИИ-агенты с пультом на рабочем столе: пошаговая сборка с Claude Code

За один-два дня в разговоре с Claude Code вы соберёте своих ИИ-агентов в Telegram и пульт, который следит за ними сам. Программировать не нужно: вы описываете задачу словами, Claude Code пишет код и выкладывает его на сервер.

У меня так работают два агента. Коуч по целям сидит в рабочей группе, разбирает планы и отчёты команды, напоминает в 11:00 и 19:00, а в воскресенье подводит итог недели. СемьКус — семейная память и бухгалтер в канале: траты, бюджеты, напоминания, таблица расчётов по квартире.

Что получится в итоге

Вокруг агентов — система, которая не даёт им тихо упасть или съесть бюджет:

1. Агенты живут на сервере и работают круглосуточно.
2. Учёт расходов и лимиты: каждый запрос к нейросети записывается, у каждого бота есть потолок в день и в месяц.
3. Пульт — веб-страница: статусы ботов, расходы по дням и месяцам, здоровье сервера, паспорт каждого агента.
4. Тревоги в Telegram: бот упал или завис, лимит на исходе, сервер на пределе.
5. Внешний сторож: если ляжет весь сервер, вам всё равно напишут.
6. Виджет на рабочем столе: карточка на матовом стекле, открывается сама при включении компьютера.

Что понадобится

Расходы на старте — сервер и токены нейросети. Остальное бесплатно.

На компьютере нужны Windows 11 (для матового стекла виджета), Node.js и доступ к серверу по SSH по ключу. Как настроить SSH, Claude Code объяснит сам — спросите его в первом же сообщении.

Шаг 1. Собираем агента

Агент — это Telegram-бот, который на каждое сообщение спрашивает нейросеть и помнит историю в своей базе. Самое важное здесь — не код, а точное описание роли.

1. Создайте бота. В Telegram напишите @BotFather → /newbot → имя и адрес. Скопируйте токен. Если бот будет читать группу целиком: /setprivacy → Disable.
2. Опишите роль словами — как для нового сотрудника:
   • где живёт (группа, канал, личка) и когда отвечает (всегда или только на обращение «коуч, …»);
   • что делает сам по расписанию (напоминания, итоги недели);
   • что умеет читать (фото, голосовые, файлы, Google-таблицы);
   • чего делать нельзя (например, менять таблицу без подтверждения кнопкой ✅).
3. Отдайте это Claude Code (готовый промпт — в шпаргалке в конце). Он создаст папку проекта: код бота на Python, базу SQLite для памяти, файл-образец .env.example для ключей.
4. Попросите сразу поставить git — тогда любую правку можно откатить.
5. Проверьте без Telegram. Попросите сделать прогон сценариев с заглушками: «вот такое сообщение — вот такой ответ». У Коуча таких сценариев больше 20, и перед каждым деплоем все должны быть зелёными.

Шаг 2. Сажаем агента на сервер

Пока бот запущен на вашем компьютере, он засыпает вместе с ним. На сервере он работает круглосуточно и сам поднимается после сбоя.

1. Папка на сервере — например /opt/coach-bot. Claude Code сам скопирует туда код и поставит зависимости.
2. Ключи — в .env на сервере: токен бота, ключ Claude, id чата. Этот файл не перезаписывается при деплое и не попадает в git.
3. Служба systemd — бот стартует вместе с сервером и перезапускается через 10 секунд после падения (Restart=always).
4. Прокси для РФ. С российского сервера Telegram часто не отвечает, а Claude отдаёт ошибку 403. Решение — два бесплатных воркера Cloudflare: один пересылает запросы в Telegram, другой — в Claude. В .env бота прописываются их адреса (TELEGRAM_API_BASE, ANTHROPIC_BASE_URL). Учтите честно: Anthropic официально не работает с Россией, и доступ через прокси нарушает его правила — аккаунт и ключ могут заблокировать. Держите резервный ключ и не храните в одном аккаунте всё самое важное.
5. Бэкап базы — раз в сутки ночью, хранить 14 дней.
6. Добавьте бота в группу и напишите ему. Логи смотрит Claude Code: «покажи, что бот писал в журнал за последний час».

Второй агент ставится так же, в соседнюю папку (/opt/family-bot), со своим ботом и своей службой. На одном сервере с 4 ГБ памяти у меня живут почти 20 ботов и сервисов, а один агент занимает около 100 МБ.

Шаг 3. Учёт расходов и лимиты

Агент платит за каждый ответ нейросети, поэтому счёт должен вести сам бот — с первого дня.

1. Каждый запрос — в базу. В ответе Claude есть число токенов на вход и выход. Бот умножает их на цену модели и пишет в таблицу llm_calls: время, тип запроса, стоимость.
2. Команда /cost — бот сам отвечает, сколько потратил сегодня, за 7 и 30 дней, в рублях.
3. Два лимита в .env: в день и в месяц. У меня у обоих ботов — 190 ₽ ($2) в день и 3 800 ₽ ($40) в месяц.
4. Что делать при исчерпании — решите заранее. Коуч перестаёт болтать и смотреть фото, но планы и отчёты разбирает всегда — это центы. СемьКус копит новые посты и предлагает кнопкой поднять лимит.
5. Тревога про баланс. Кончились деньги на счёте Claude или ключ не принимается — бот один раз (не чаще раза в 6 часов) пишет владельцу.

Шаг 4. Пульт агентов

Пульт — одна веб-страница, которая читает базы ботов и состояние сервера. В самих ботах для него ничего менять не нужно.

Что на нём:

• общий статус вверху: зелёная точка мерцает — всё работает, красная мигает — есть сбой;
• карточка на каждого агента: статус, расход сегодня и за месяц, полоски лимитов, сколько работает без перезапуска;
• кнопка «Паспорт»: роль, что умеет, где живёт, как позвать, команды, модель, лимиты, дата запуска, где лежит код;
• сервер: процессор, память, диск, сколько дней без перезагрузки, а ещё баланс хостинга и до какого числа сервер оплачен (через API хостера, у меня Timeweb Cloud);
• расходы: сегодня, с начала месяца, прогноз на месяц и график с переключателем «Дни / Месяцы».

Как собрать:

1. Попросите Claude Code сделать на сервере маленький сервис без лишних библиотек: память на сервере дорогая, мой занимает около 60 МБ.
2. Базы ботов он открывает только на чтение, лимиты берёт из их .env — цифры на пульте всегда совпадают с /cost.
3. Стиль задайте одной фразой: «чёрно-белый, как у Apple, много воздуха, цвет только у статусов».
4. Закройте пульт паролем. На нём ваши расходы, его нельзя выставлять в интернет открытым. У меня он открывается на поддомене моего сайта под логином и паролем, пароль лежит в файле на компьютере. Адрес пульта нигде не публикуйте.
5. Проверьте с телефона: страница должна читаться без горизонтальной прокрутки.

Шаг 5. Тревоги в Telegram

Пульт полезен, пока вы на него смотрите. Тревоги нужны, чтобы смотреть не приходилось: сообщение придёт само, когда что-то не так.

Сторож внутри пульта

Раз в минуту он всё проверяет и пишет через бота-оповещателя, если:

• бот упал — проверяется вторым замером, чтобы не дёргать из-за обычного перезапуска;
• за 15 минут в журнале 5 и больше ошибок;
• потрачено 80% и 100% дневного или месячного лимита — один раз за день или месяц;
• на сервере свободно меньше 8% памяти, диск заполнен на 90% или какой-то процесс съел больше 1,2 ГБ.

И ещё одна тревога — про деньги на сервере: если баланса хостинга осталось меньше чем на 5 дней, раз в день приходит «пополни баланс». Для этого в панели хостера создаётся API-токен, и вы сами кладёте его в .env пульта на сервере.

Когда всё восстановится, приходит «снова в норме». Одна тревога на событие, без спама каждую минуту — иначе вы перестанете их читать.

Пульс ботов

Бот может не упасть, а зависнуть: процесс жив, но сообщения не обрабатывает. Поэтому каждый бот раз в минуту пишет в файл текущее время. Нет отметки 5 минут — на пульте красное «Завис» и тревога.

Внешний сторож

Пульт живёт на том же сервере: ляжет сервер — ляжет и пульт, и никто не предупредит. Поэтому снаружи стоит бесплатный воркер Cloudflare:

1. В пульте делаем один адрес без пароля, который отвечает только «ok» (/healthz).
2. В Cloudflare создаём воркер hub-watchdog и вставляем его код.
3. Переменные: TG_TOKEN (тип Secret) — токен бота-оповещателя, TG_CHAT — ваш id в Telegram (его покажет бот @userinfobot, а перед первой тревогой напишите боту-оповещателю /start, иначе он не сможет вам писать).
4. Хранилище KV с именем STATE — помнит «уже тревожили», чтобы не спамить.
5. Расписание (Cron) — каждые 3 минуты.

Обязательно проверьте вживую

Попросите на 5 минут остановить пульт и дождитесь тревоги. У меня она пришла через 4 минуты, а сама проверка нашла баг, из-за которого тревога не пришла бы никогда (подробнее — в «Граблях»).

Шаг 6. Виджет на рабочий стол

Виджет — маленькая карточка на матовом стекле Windows 11. Она показывает главное с пульта и сама обновляется раз в 30 секунд, открывать браузер не нужно.

1. Сборка. Попросите Claude Code сделать настольный виджет на Electron: окно без рамки, фон — матовое стекло Windows 11 (acrylic), данные берёт с вашего пульта. Пароль от пульта виджет читает из файла на компьютере, в коде его нет.
2. Два режима. Стрелка в шапке переключает полный вид (расходы, лимиты по дню и месяцу, сервер, итог за месяц) и свёрнутый — по строке на агента: статус, сколько потрачено сегодня, процент дневного лимита.
3. Меню «⋯»: свернуть или развернуть, «Закрепить», «Поверх всех окон», открыть полный пульт, закрыть виджет.
4. Закрепить. Закреплённый виджет не двигается и остаётся на месте, когда вы нажимаете Win+D или «Свернуть все окна». Секрет в том, что окно привязывается к самому рабочему столу Windows.
5. Не уходит за край экрана. Утащить его за границу или под панель задач нельзя — он возвращается в экран.
6. Автозапуск. Ярлык кладётся в папку автозагрузки (Win+R → shell:startup), и виджет открывается сам при включении компьютера.

Нагрузка маленькая: около 180 МБ памяти (как одна вкладка браузера), процессор почти не трогает, загрузку Windows замедляет на секунду-две.

Грабли, на которые я уже наступил

Всё это случилось на самом деле — не повторяйте.

Шпаргалка: промпты для Claude Code

Копируйте по одному и подставляйте своё в [скобках]. После каждого шага просите показать, что именно проверено.

Шаг 1 — агент

Сделай Telegram-бота на Python с Claude. Роль: [кто он и зачем]. Живёт в [группа/канал/личка], отвечает, когда [условие]. По расписанию: [что и когда]. Читает: [фото, голосовые, файлы]. Нельзя: [запреты]. Память — в SQLite, краткие выжимки + кэш, чтобы было дёшево. Ключи только в .env. Поставь git и сделай прогон сценариев без Telegram.

Шаг 2 — сервер

Разверни бота на моём сервере [root@IP] в /opt/[имя]: systemd с автоперезапуском, .env не перезаписывать, бэкап базы ночью на 14 дней. Сервер в РФ — если Telegram или Claude не отвечают, предложи прокси-воркеры в Cloudflare.

Шаг 3 — расходы

Пусть бот пишет стоимость каждого запроса к Claude в базу, отвечает на /cost в рублях и держит лимиты [190 ₽ в день, 3 800 ₽ в месяц]. При исчерпании: [что останавливаем, что работает всегда].

Шаг 4 — пульт

Сделай пульт моих агентов на сервере: чёрно-белый, как у Apple. Статусы ботов (зелёная точка мерцает, красная мигает), расходы и лимиты по дням и месяцам, сервер, кнопка «Паспорт» у каждого агента. Базы ботов — только на чтение. Закрой паролем и проверь, что без пароля не пускает.

Шаг 5 — тревоги

Добавь тревоги в Telegram: бот упал или завис (пульс раз в минуту), лимит 80% и 100%, сервер на пределе. Одна тревога на событие и «снова в норме». И внешнего сторожа в Cloudflare на случай падения всего сервера. Потом проверь вживую: останови пульт на 5 минут и дождись сообщения.

Шаг 6 — виджет

Сделай виджет на рабочий стол Windows 11 на матовом стекле с данными пульта. Полный и свёрнутый режим; «Закрепить» — не двигается и остаётся при Win+D; не уходит за край экрана; автозапуск вместе с Windows. Пароль пульта не клади в код, читай из файла.

Если хочется понять, зачем обычному человеку вообще свои ИИ-сотрудники, — начните с истории о том, как я построил трёх ИИ-сотрудников. А какими нейросетями я пользуюсь каждый день и сколько за них плачу, собрал в отдельной статье. Разбирать такие сборки вживую, со своими задачами и вопросами, можно в клубе НейроКус.

Вступить в клуб НейроКус →