EnglishРусский中文

Урок 5. Работа с AI-агентами#

Зачем это нужно#

HAPI поддерживает несколько AI-агентов — не только Claude Code. В этом уроке вы узнаете, как запускать разных агентов, переключаться между ними и одобрять их запросы прямо с телефона.

Какие AI-агенты поддерживаются#

Агент Компания Команда запуска
Claude Code Anthropic hapi
Codex OpenAI hapi codex
Gemini CLI Google hapi gemini
OpenCode Open source hapi opencode

💡 По умолчанию (просто hapi) запускается Claude Code. Это самый популярный вариант.

Запуск разных агентов#

Подготовка#

Убедитесь, что hub уже запущен (из урока 3):

hapi hub --relay

Запуск Claude Code#

hapi

Это запустит Claude Code в обёртке HAPI. Вы работаете с ним как обычно в терминале, но теперь сессия видна и с телефона.

Запуск Codex#

hapi codex

Запуск Gemini#

hapi gemini

Запуск OpenCode#

hapi opencode

⚠️ Перед запуском убедитесь, что нужный агент установлен. Например, для Claude Code: claude --version. Если команда не найдена — установите агент отдельно.

Несколько сессий одновременно#

Вы можете запустить несколько агентов одновременно! Каждый — в отдельном терминале:

Терминал 1: hapi hub --relay     ← hub (всегда один)
Терминал 2: hapi                 ← Claude Code (сессия 1)
Терминал 3: hapi codex           ← Codex (сессия 2)
Терминал 4: hapi gemini          ← Gemini (сессия 3)

Все сессии появятся в списке в веб-интерфейсе. Вы можете переключаться между ними на телефоне.

Одобрение запросов с телефона#

Это одна из главных функций HAPI. Вот как это работает:

Как это выглядит#

  1. AI-агент хочет выполнить действие (например, отредактировать файл)
  2. Он отправляет запрос на разрешение
  3. Вы получаете уведомление на телефон 🔔
  4. Открываете HAPI и видите запрос:
Claude Code хочет:
📝 Отредактировать файл src/app.js

[✅ Одобрить]  [❌ Отклонить]
  1. Нажимаете «Одобрить» — агент продолжает работу
  2. Или «Отклонить» — агент не выполнит действие

Зачем нужно одобрение#

AI-агенты мощные, но иногда ошибаются. Система одобрений — это ваш контроль:

  • Вы видите, что именно хочет сделать агент, прежде чем он это сделает
  • Вы можете остановить нежелательные изменения
  • Вы всегда в курсе, что происходит с вашим кодом

Одобрение через Telegram#

Если вы настроили Telegram-бот (это тема для продвинутого курса), уведомления приходят прямо в Telegram. Одобрять можно не выходя из мессенджера.

Seamless Handoff в действии#

Вот типичный сценарий рабочего дня с HAPI:

Утро: работа за компьютером#

hapi hub --relay    # в первом терминале
hapi                # во втором терминале

Вы работаете с Claude Code в терминале как обычно. Даёте задания, обсуждаете код.

Обед: переключение на телефон#

Вы уходите от компьютера. Но Claude Code продолжает работать! С телефона вы:

  • Следите за прогрессом в чате
  • Одобряете запросы одним нажатием
  • Отправляете дополнительные инструкции

В терминале на компьютере отображается: «Remote mode — waiting for input».

После обеда: возвращение к компьютеру#

Садитесь за компьютер и нажимаете двойной пробел в терминале. Мгновенно возвращается локальное управление. Продолжаете работу как ни в чём не бывало.

Удалённый запуск сессий#

Ещё одна полезная функция: можно запускать новые сессии прямо с телефона, даже если вы далеко от компьютера.

Для этого нужен Runner — фоновый сервис:

hapi runner start

После этого:

  1. Откройте HAPI на телефоне
  2. В списке «Machines» (Машины) вы увидите свой компьютер
  3. Нажмите, чтобы создать новую сессию
  4. Выберите AI-агента и начните работу

💡 Runner полезен, когда вы хотите запустить задачу на домашнем компьютере, находясь в другом месте.

Диагностика#

Если что-то не работает, HAPI имеет встроенную диагностику:

hapi doctor

Эта команда проверит:

  • Подключение к hub
  • Правильность токена
  • Наличие AI-агентов
  • Общее состояние системы

Итоги урока#

  • HAPI поддерживает 4 AI-агента: Claude Code, Codex, Gemini, OpenCode
  • Можно запускать несколько сессий одновременно в разных терминалах
  • Одобрение запросов с телефона — ваш контроль над действиями AI
  • Seamless Handoff позволяет плавно переключаться между компьютером и телефоном
  • Runner позволяет запускать сессии удалённо
  • Команда hapi doctor поможет найти проблемы

Что дальше#

Поздравляем! 🎉 Вы прошли все 5 уроков для начинающих. Теперь вы умеете:

  1. ✅ Понимать, что такое HAPI и чем он отличается от Happy
  2. ✅ Устанавливать HAPI на компьютер
  3. ✅ Запускать hub и подключаться с телефона
  4. ✅ Использовать веб-интерфейс и PWA
  5. ✅ Работать с разными AI-агентами и одобрять запросы удалённо

В следующем уровне курса мы рассмотрим продвинутые темы: настройку Telegram-бота, самостоятельный хостинг, голосовое управление и многое другое.