HAPI

在本地运行官方的 Claude Code / Codex / Gemini / OpenCode 会话，并通过 Web / PWA / Telegram 小程序远程控制它们。

为什么选择 HAPI？ HAPI 是 Happy 的本地优先替代方案。有关主要区别，请参阅 为什么不选择 Happy？。

功能

• 无缝切换 - 在本地工作，需要时切换到远程，随时再切回本地。不会丢失上下文，无需重新启动会话。
• 原生优先 - HAPI 只是封装你的 AI 代理，而不是取代它。终端、体验和操作习惯都保持一致。
• AFK 不中断 - 离开办公桌？只需轻点一下手机，即可批准 AI 请求。
• 你的 AI，你的选择 - Claude Code、Codex、Cursor Agent、Gemini、OpenCode——不同模型，统一的工作流。
• 随时随地使用终端 - 从手机或浏览器执行命令，直接连接到正在工作的机器。
• 语音控制 - 使用内置语音助手，解放双手与 AI 代理对话。

演示

https://github.com/user-attachments/assets/38230353-94c6-4dbe-9c29-b2a2cc457546

快速入门

npx @twsxtd/hapi hub --relay     # 启动带有端到端加密中继的 hub
npx @twsxtd/hapi                 # 运行 claude code

hapi server 仍作为别名被支持。

终端会显示一个 URL 和二维码。用手机扫描二维码或打开该 URL 即可访问。

中继采用 WireGuard + TLS 实现端到端加密。你的数据从设备到目标机器全程加密。

如需自托管选项（Cloudflare Tunnel、Tailscale），请参阅 安装指南。

文档

• 应用
• 工作原理
• Cursor Agent
• 语音助手
• 为什么选择 HAPI
• 常见问题

从源码构建

bun install
bun run build:single-exe

致谢

HAPI 是 “哈皮”的中文音译，源自 Happy。向原项目致以崇高敬意。

HAPI 快速上手指南

环境准备

• 系统要求：支持 macOS、Linux 或 Windows（推荐使用 Linux 或 macOS 以获得最佳体验）。
• 前置依赖：
  • Node.js（建议版本 18+）
  • Bun（可选，用于从源码构建）

如果你使用国内网络，建议通过 npm 镜像 加速安装过程。

安装步骤

使用 npx 安装并启动 HAPI

npx @twsxtd/hapi hub --relay     # 启动带端到端加密中继的 HAPI 集群
npx @twsxtd/hapi                 # 启动 Claude Code 模式

hapi server 命令仍然作为别名被支持。

启动后，终端会显示一个 URL 和二维码。你可以使用手机扫描二维码或直接在浏览器中打开该链接进行访问。

从源码构建（可选）

bun install
bun run build:single-exe

基本使用

1. 执行安装命令后，HAPI 会启动本地服务，并生成一个访问地址和二维码。
2. 使用手机扫描二维码或在浏览器中输入生成的 URL，即可远程访问 HAPI。
3. 在 Web 界面中，你可以控制本地运行的 AI 模型（如 Claude Code、Codex、Gemini 等），执行代码、发送指令等操作。
4. 支持通过 Telegram Mini App 或 PWA 进行远程控制。

HAPI 使用 WireGuard + TLS 实现端到端加密，确保你的数据从设备到机器全程加密传输。