主题
Hapi 远程控制配置指南
随时随地远程控制你的 AI 编程助手。
- 作者：weishu
- 官方文档：https://hapi.run/
📋 简介
Hapi 是一个本地优先的应用程序，可以让你在本地运行 Claude Code / Codex / Gemini 会话，并通过 Web / PWA / Telegram Mini App 进行远程控制。这意味着你可以在手机或浏览器上监控和管理你的 AI 编程任务。
🔗 相关链接
✨ 核心功能
Hapi 提供以下强大功能：
- ✅ 无缝切换：在本地原生环境和远程控制之间无缝切换
- ✅ 远程会话：从任何设备发起远程会话
- ✅ 移动监控：通过手机或浏览器监控和管理任务
- ✅ 权限控制：远程批准 / 拒绝工具权限
- ✅ 文件浏览：浏览文件和查看
git diff - ✅ 进度跟踪：通过待办事项列表跟踪进度
- ✅ 多后端支持：支持 Claude Code、Codex、Gemini
🛠️ 安装步骤
第一步：安装 Hapi
💡 前置要求
请确保已安装 Node.js 18+ 环境。如需安装，请参考 Node.js 环境安装。
推荐使用 npx 快速启动 Hapi 服务器：
bash
npx @twsxtd/hapi server启动后会显示 Token 凭证和访问地址。
⚠️ 重要提示
请务必保存好 Token 凭证！这是你连接和控制 Hapi 服务的唯一凭证。
第二步：启动 AI 会话
在项目目录下执行以下命令启动对应的 AI 服务：
启动 Claude Code：
bash
hapi claude启动 Codex：
bash
hapi codex启动 Gemini：
bash
hapi gemini启动成功后，前端界面会显示连接状态。
🎉 局域网访问
此时你已经可以在本地局域网内通过 http://<server-ip>:3006 访问和控制你的 AI 编程助手了！
🌐 配置 Cloudflare 内网穿透
如果你想实现公网访问（手机出门在外也能控制家里/办公室的 AI），可以使用 Cloudflare Tunnel 内网穿透。
前置要求
- 已有一个绑定到 Cloudflare 的域名（如
hapi.nassaapi.xyz） - 已安装
cloudflared工具
配置流程
参考 Cloudflare 创建远程隧道，将 localhost:3006 映射到你的域名即可。
详细步骤见 Hapi 进阶：优选 IP 配置。
✅ 使用 Hapi
配置完成后，你可以：
- 本地访问：
http://localhost:3006 - 局域网访问：
http://<server-ip>:3006 - 公网访问：
https://your-domain.com（如果配置了 Cloudflare Tunnel）
使用步骤：
- 打开浏览器访问 Hapi 地址
- 输入 Token 登录
- 选择要启动的 AI 后端（Claude / Codex / Gemini）
- 开始远程控制你的 AI 编程助手
💡 使用技巧
- 在手机浏览器中访问可以随时随地监控任务进度
- 可以安装为 PWA 应用，获得类似原生应用的体验
- 支持多设备同时连接和控制
🔒 安全建议
- 不要将 Token 泄露给他人
- 如果使用公网访问，建议启用 Cloudflare 的安全功能（如 Access 策略）
- 定期更换 Token
- 仅在可信网络环境下使用
常见问题
提示无法连接到服务器？
- 检查 Hapi Server 是否仍在运行
- 检查防火墙是否放行
3006端口 - 检查 Token 是否正确
Cloudflare Tunnel 配置失败？
- 确认
cloudflared版本为最新 - 确认域名已经成功接入 Cloudflare
- 参考 Hapi 进阶 页面
更多问题
请查阅 疑难杂症 或 常见问题 (FAQ)。