Содержание
Как пользоваться этим документом
Это рабочая инструкция по установке и настройке ИИ-агента. Часть А — чек-лист готовности (заполняет тех-команда до интенсива). Часть Б — пошаговая установка. Часть В — готовый промпт запуска, который ускоряет установку и сокращает время в 1,5–2 раза по сравнению с импровизацией.
Часть А. Чек-лист готовности рабочего места
Заполняется по каждому участнику отдельно. Все пункты должны быть отмечены до старта.
Блок 1. Устройство и доступ
- Ноутбук без чувствительных корпоративных данных, с правами на установку ПО
- Защищённый канал доступа на ноутбуке, ключ VLESS активирован
- Удалённый облачный сервер (VPS) зарегистрирован и оплачен — отдельный на этого участника
- Защищённый канал доступа установлен на сервер — VPN формата VLESS
- Telegram скачан на ноутбук и выполнен вход
Блок 2. Аккаунты и боты
- Бот в Telegram создан, tgID и токен бота получены и сохранены
- Claude скачан на ноутбук
- Платная подписка Claude активирована (желательно $100–200)
- Браузер Chrome + расширение Claude для Chrome установлены
- Выполнен вход в Claude и через браузер, и с ноутбука
Блок 3. Резерв спикера
- У спикера есть подменные аккаунты Claude на случай неготовности участника
- Проведён тестовый прогон доступа к серверу и Telegram-боту по этому рабочему месту
Почему чек-лист критичен: на первом интенсиве этот чек-лист не был реализован тех-командой. Итог — отсутствие токенов Telegram, не заведённые аккаунты Claude и один сервер на двоих. Практику удалось вытянуть только наполовину.
Конфигурация сервера (справочно)
| Параметр | Значение |
|---|---|
| Провайдер | cloud.ru — рекомендуемый (российский контур) |
| ОС | Ubuntu 24.04 LTS |
| Память | от 4 ГБ RAM (8 ГБ — комфортно) |
| Процессор | 2 vCPU |
| Диск | 40–60 ГБ SSD |
Часть Б. Пошаговая установка агента
Самый простой способ установки: дать Claude Code доступ к серверу — он установит всё сам. После установки доступ можно закрыть.
Шаги
- Завести и настроить сервер: регистрация у провайдера, конфигурация из таблицы выше.
- Установить Claude на ноутбук, войти в аккаунт с платной подпиской.
- Открыть Claude Code на ноутбуке.
- Дать Claude Code доступ к серверу (самый простой путь — напрямую).
- Запустить установку готовым промптом (Часть В). Claude установит окружение сам.
- Загрузить заранее подготовленные файлы в «мозг» агента (soul.md, identity.md, user.md — см. отдельный документ с шаблонами).
- Проверить связь: написать агенту в Telegram, получить ответ.
Что изменить против первого прогона: запускать установку в начале практики, а не в конце. Пока окружение ставится (10–15 минут), спикер коротко рассказывает, что именно устанавливается. К моменту готовности окружения сразу начинается практика — без 15 минут «развлечения аудитории».
Часть В. Готовый промпт запуска установки
Импровизированная установка на первом интенсиве занимала 15+ минут: модель сама искала зависимости, разбиралась с ошибками. Детальный промпт с явными инструкциями сокращает это время примерно вдвое. Промпт ниже выдаётся участнику в Claude Code; при необходимости — кладётся на сервер как install.md, на который агенту даётся ссылка.
Шаблон промпта
Роль: ты — инженер по развёртыванию ИИ-агента на чистом сервере Ubuntu 24.04. Контекст окружения: — сервер: Ubuntu 24.04 LTS, 2 vCPU, 4–8 ГБ RAM, доступ по защищённому каналу; — канал общения агента с владельцем: Telegram (tgID и токен бота переданы ниже); — среда агента: Claude Code Channels (на платной подписке Claude). Задача: развернуть рабочее окружение агента и поднять связь с Telegram. Делай по шагам и перед каждым шагом одной строкой сообщай, что делаешь: 1. Проверь версии ОС, доступ в интернет, наличие нужных пакетов; чего нет — поставь. 2. Зафиксируй версии зависимостей явно (не «latest»), чтобы установка была воспроизводимой. 3. Разверни файловую структуру агента: папка с файлами soul.md, identity.md, user.md, beliefs.md, agents.md, tools.md, memory.md, active.md, heartbeat.md, roles.md. 4. Создай локальную базу данных для агента (по умолчанию SQLite в папке агента) под задачи, напоминания, расписание и структурированную память. Сделай таблицы и опиши схему в tools.md, чтобы агент знал, где и что хранится. 5. Подключи Telegram-бот по переданным tgID и токену. 6. Запусти агента и пришли в Telegram тестовое сообщение «агент на связи». Правила: — при ошибке не уходи в долгий самостоятельный дебаг: покажи ошибку и краткий план фикса; — не запрашивай и не сохраняй чувствительные персональные данные; — в конце выведи короткий отчёт: что установлено, какие версии, как перезапустить. Данные для подключения: tgID: ___ Токен бота: ___
Почему так быстрее
- Явная роль и контекст — модель не тратит шаги на выяснение окружения.
- Зафиксированные версии зависимостей — меньше конфликтов и долгого «копания» в ошибках.
- Запрет на долгий самостоятельный дебаг — модель не зависает на 15 минут, а возвращает управление спикеру.
- Готовая структура файлов «мозга» — сразу можно грузить личность агента.
Рекомендация на будущее: после нескольких прогонов обкатанный промпт стоит сохранить как install.md и положить в репозиторий материалов — тогда установка станет одной командой «прочти install.md и выполни».