Как контролировать Claude Code и Gemini прямо с телефона - обзор HAPI

Представьте ситуацию: вы запустили сложную задачу в Claude Code или другом AI-агенте на рабочем компьютере. Процесс идет, нейронка вовсю «кодит», но вам нужно отойти — на обед, встречу или просто размяться. Обычно в такие моменты приходится либо оставлять процесс без присмотра (на свой страх и риск), либо прерывать сессию. Но что, если бы вы могли забрать этот терминал с собой в кармане?

Сегодня разберем проект HAPI (транслитерация китайского «哈皮» — «счастливый»), который превращает локальные AI-сессии в мобильное и кроссплатформенное приключение.

Что такое HAPI и зачем он разработчику?

HAPI — это опенсорсный инструмент, который оборачивает официальные CLI-агенты (Claude Code, Codex, Gemini, OpenCode) и позволяет управлять ими удаленно через веб-интерфейс, PWA или Telegram Mini App.

Главная идея в том, что это не замена вашим любимым инструментам, а «умная прослойка». Вы продолжаете работать в привычном терминале на своей машине, но получаете возможность бесшовно переключиться на телефон или браузер в любой момент.

Это идеальное решение для тех, кто практикует «vibe coding» — когда процесс написания кода становится более гибким, итеративным и не привязанным к рабочему столу.

Пять фишек, которые меняют рабочий процесс

1. Бесшовный переход (Seamless Handoff)

Вы начали писать фичу за монитором, но поняли, что пора ехать домой? Просто открываете HAPI на смартфоне. Сессия подхватывается мгновенно: никакого сброса контекста, никакой перезагрузки агента. Вы видите ту же историю команд и тот же вывод терминала.

2. Подтверждение действий в один тап

AI-агенты часто запрашивают разрешение на выполнение опасных команд или запись файлов. С HAPI вам не нужно сидеть и ждать этого запроса. Ушли за кофе? Телефон в кармане вибрирует, вы нажимаете «Approve» прямо в Telegram или PWA, и агент продолжает работу.

3. Терминал везде

Это не просто чат с ботом. HAPI транслирует полноценный терминал. Вы можете запускать команды, смотреть логи сборки или править конфиги удаленно, находясь при этом в той же среде, где развернут ваш проект.

4. Голосовое управление

Иногда лень даже печатать. В HAPI встроен голосовой ассистент. Можно буквально продиктовать: «Исправь отступы в этом компоненте и запусти тесты», пока вы идете по улице.

5. Безопасность прежде всего

Разработчик уделил внимание приватности. По умолчанию используется релей на базе WireGuard + TLS с оконечным шифрованием (E2E). Ваши данные шифруются на вашем устройстве и дешифруются только на рабочей машине. Для тех, кто не доверяет публичным релеям, есть инструкции по настройке через Cloudflare Tunnel или Tailscale.

Как это работает изнутри?

HAPI написан на TypeScript и использует Bun для максимальной производительности. Архитектура проекта построена вокруг концепции «хаба».

Когда вы запускаете hapi, создается локальный сервер, который проксирует ввод-вывод терминала. Если активирован флаг --relay, хаб подключается к защищенному каналу, через который вы получаете доступ к интерфейсу по QR-коду или ссылке.

Интересно, что проект поддерживает «Single Executable Binary» — его можно собрать в один исполняемый файл, что удобно для переноса между серверами.

Быстрый старт

Попробовать HAPI проще, чем настроить ESLint в новом проекте. Если у вас установлен Node.js, просто выполните:

# Запускаем хаб с зашифрованным релеем
npx @twsxtd/hapi hub --relay

# В соседней вкладке запускаем нужного агента (например, Claude Code)
npx @twsxtd/hapi

После запуска в терминале появится QR-код. Сканируете его телефоном — и вуаля, ваша IDE теперь в кармане.

Для кого этот проект?

В моей практике HAPI особенно полезен в трех случаях:

Длинные задачи: Когда AI перелопачивает огромную кодовую базу, и нужно периодически поглядывать за процессом.
Демонстрации: Можно показывать работу кода прямо с телефона на встрече, пока основной билд крутится на мощном ноутбуке в рюкзаке.
Лень: Когда хочется допилить мелкий баг, лежа на диване, не доставая тяжелый ноутбук.

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

Если вы активно используете CLI-агентов и чувствуете себя «привязанным» к терминалу, HAPI определенно стоит того, чтобы потратить 5 минут на его запуск.

Ознакомиться с проектом и документацией можно в репозитории на GitHub.

Удачного вайб-кодинга!