HAPI: вайбкодинг с телефона - Claude Code, Codex и Cursor Agent под тап

HAPI - это бесплатная опенсорсная тулза, которая пробрасывает твои кодинг-агенты (Claude Code, Codex, Cursor Agent, Grok Build, OpenCode и ещё несколько) на телефон. Сессия крутится на твоей машине, а с мобилы ты подтверждаешь действия одним тапом, диктуешь запросы голосом и смотришь файлы проекта. Управлять можно через веб, PWA или Telegram Mini App. Ниже - что реально умеет, как поставить двумя командами и чем HAPI отличается от ZCode.

Что такое HAPI

HAPI - опенсорсная оболочка, GitHub-репо tiann/hapi, 4,8k звёзд, лицензия AGPL-3.0. Работает по схеме local-first: сам кодинг-агент крутится у тебя на ноуте, твои файлы никуда не улетают. Телефон работает как пульт - тапаешь, агент делает шаг; говоришь голосом - агент понимает; приходит запрос на разрешение операции - подтверждаешь пальцем.

В описании репо HAPI обозначен как приложение "для Codex, Claude Code, Pi, OpenCode, Kimi Code и Grok Build - вайбкодинг anytime, anywhere". Название - транслитерация китайского "哈皮" (Happy).

Какие агенты поддерживает

На старте HAPI работает с девятью агентами:

• Claude Code
• Codex (OpenAI)
• Cursor Agent
• Grok Build
• OpenCode
• Kimi
• GitHub Copilot
• Antigravity
• Pi

HAPI не заменяет агента, а даёт ему второй интерфейс - мобильный. Ты сидишь на своём Claude Code или Codex, ничего не меняешь, просто оборачиваешь одной командой.

Что умеет

Основные фичи из документации на hapi.run:

• Seamless Handoff - начал сессию на ноуте, продолжил на телефоне без потери контекста.
• Native First - оборачивает агента, но не ломает терминал: всё, что ты привык видеть в CLI, остаётся.
• AFK Approval - агент просит подтвердить операцию (изменить файл, запустить команду), ты жмёшь одну кнопку с телефона.
• Terminal Anywhere - терминал в браузере или в приложении, команды идут в реальный shell на твоей машине.
• Voice Control - голосовой ввод для запросов агенту.
• Workspace Browser - смотришь дерево файлов проекта прямо с телефона.

Трафик между устройством и машиной идёт по связке WireGuard + TLS, end-to-end зашифрован. Твой код не оседает на чужих серверах.

Как поставить одной командой

Нужен Node.js на машине, где будет крутиться агент. Дальше - две команды в двух окнах терминала.

Запускаешь хаб с E2E-relay:

npx @twsxtd/hapi hub --relay

Во втором окне - сам агент (по умолчанию Claude Code):

npx @twsxtd/hapi

Хаб выдаст адрес и QR-код. Открываешь в браузере телефона, добавляешь как PWA либо подключаешь через Telegram Mini App. Всё, теперь агент отвечает на команды с мобилы.

AFK Approval и голосовое управление - главные фишки

AFK Approval - это то, ради чего HAPI и делали. Claude Code, Codex и Cursor Agent постоянно спрашивают: "выполнить эту команду?", "переписать этот файл?". Без HAPI сидишь и подтверждаешь с клавиатуры. С HAPI - агент шлёт push, ты подтверждаешь с телефона: на планёрке, в дороге, в спортзале. Работа не встаёт.

Голос закрывает главную боль мобильного кодинга - на телефоне тяжело печатать длинные промпты. Диктуешь: "почини баг с фильтром в поиске, у меня падает 500-я", - агент получает текст и уходит работать. Ответ приходит в тот же чат, сессия ловится и с ноута, и с телефона.

Готовый запрос для Claude Code

Если у тебя ещё не стоит Claude Code - начни с гайда для новичков. Если сидишь из России, тут же лежит разбор как работать с Claude Code без бана. Остальное отдашь самому Claude Code.

Вставь в Claude Code:

Поставь на этой машине HAPI (github.com/tiann/hapi): запусти хаб через npx @twsxtd/hapi hub --relay, подними мою сессию Claude Code через npx @twsxtd/hapi, покажи адрес и QR для подключения с телефона. Объясни, как активировать AFK Approval, голосовое управление и Telegram Mini App. Любые чувствительные операции пусть спрашивают моё разрешение.

Claude сам поставит, поднимет, покажет ссылку и продиктует, что тыкать на телефоне.

Чем HAPI отличается от ZCode

ZCode от Z.ai - тоже про вайбкодинг с телефона, но это закрытая платная связка на движке GLM-5.2 (от $16,2/мес). HAPI - опенсорсный, бесплатный и работает с чужими агентами: ставишь на Claude Code, Codex, Cursor Agent и остальные. Разные ниши: ZCode - вертикальная IDE Z.ai для их же модели; HAPI - универсальный пульт над любым агентом.

Сколько стоит и что с нативными приложениями

HAPI - бесплатный, лицензия AGPL-3.0. Платить придётся только за агента, которого он оборачивает (подписка Claude Code / Codex / Cursor Agent, если у тебя её нет).

Нативные приложения под iOS (SwiftUI) и Android (Kotlin Compose) на момент публикации в разработке. Пока используется веб-версия, PWA и Telegram Mini App - для 90% сценариев этого хватает: PWA ставится на домашний экран как обычное приложение, ловит push, работает офлайн-friendly.

Частые вопросы

HAPI бесплатный?

Да, репозиторий под AGPL-3.0, скачивается и работает бесплатно. Платить нужно только за самого кодинг-агента (Claude Code, Codex, Cursor Agent), которого HAPI оборачивает.

Мои файлы уходят на чужой сервер?

Нет. HAPI - local-first: сессия и файлы остаются у тебя на машине, телефон просто пульт. Трафик между устройствами идёт через WireGuard + TLS, end-to-end зашифрован. Ключей у автора HAPI на твой код нет.

Есть приложение под iOS и Android?

Нативные клиенты (SwiftUI под iOS, Kotlin Compose под Android) в разработке. Сейчас работает через веб, PWA и Telegram Mini App. PWA ставится на домашний экран как обычное приложение.

С какими агентами работает?

Claude Code, Codex (OpenAI), Cursor Agent, Grok Build, OpenCode, Kimi, GitHub Copilot, Antigravity, Pi. Свой сетап собираешь сам - HAPI просто даёт пульт.

Можно ли передать сессию с ноута на телефон?

Да, это фича Seamless Handoff: начал на ноуте, вышел из-за стола, продолжил тем же контекстом на телефоне. Ничего не обрывается.

Коротко

HAPI - бесплатный опенсорсный пульт для кодинг-агентов (Claude Code, Codex, Cursor Agent, Grok Build, OpenCode и остальных) с телефона. Ставится двумя командами через npx, работает через веб, PWA или Telegram Mini App. Управление голосом, подтверждение действий агента одним тапом, продолжение сессии на телефоне без потери контекста. Сессия крутится локально, трафик шифруется E2E. По-простому: ты больше не привязан к креслу, чтобы кодить.

Что дальше

Если хочешь собрать такую систему у себя - у меня есть курс по вайбкодингу и работе с нейросетями в клубе Мандарин Лаб: mandarinedu.ru. Первые уроки открыты бесплатно.

Если нужно внедрить ИИ в бизнес - процессы, агентов, автоматизацию под вашу задачу - пишите мне напрямую: t.me/Philigranchik. Разберу задачу и скажу, что реально автоматизируется, а что нет.