Repolode
提交项目
tiann

tiann/hapi

远程控制 Claude Code、Codex 等 AI 编程代理，在本机运行会话，通过手机或网页操作。

可替代:Happy

在 GitHub 查看官网
Star
5,269
Fork
616
未关闭 Issue
364
最近提交
22小时前

这是什么？

HAPI 对 Claude Code、Codex、Cursor Agent、OpenCode、Pi 等官方 AI 编程代理进行封装，会话始终在你自己的机器上运行，你可以通过原生 iOS / Android 应用、Web / PWA 或 Telegram Mini App 远程查看和操作。

它的核心是本地与远程之间的无缝切换：可以先在终端工作，离开工位时用手机接管，回来后再切换回本地，上下文不会丢失，会话也无需重启。代理发出的审批请求可以在手机上一键确认。启动 hub 后会显示网址和配对二维码，连接可经由端到端加密中继，或 Cloudflare Tunnel、Tailscale 等自托管方案传输。

此外还提供网页端终端、语音输入，以及需手动开启的工作区文件浏览器，只能访问通过 runner 参数允许的目录。

核心功能

  • 01会话可在本地终端与手机或网页之间切换，无需重启。
  • 02通过移动设备一键审批代理的请求。
  • 03支持 Claude Code、Codex、Cursor Agent、OpenCode、Kimi、Copilot 等多种代理。
  • 04提供 iOS 和 Android 原生客户端，包含聊天、审批、文件和推送通知。
  • 05可浏览允许的工作区目录，并在其中从网页发起会话。

适用场景

  • 离开工位时用手机查看长时间运行的编程代理进度。
  • 无需回到工作机即可远程审批代理的工具调用请求。
  • 在家中或办公室的机器上运行编程代理，并在任何地方访问。

快速上手

  1. 1

    启动带端到端加密中继的 hub

    npx @twsxtd/hapi hub --relay
  2. 2

    选择代理并启动会话

    npx @twsxtd/hapi
  3. 3

    在浏览器中打开 hub 显示的网址，或用配套二维码配对原生应用

使用前须知

  • 从源码构建需要 Bun 1.4.0。
  • 通过中继或自托管隧道进行远程访问需要基础命令之外的额外配置。
  • 采用 AGPL-3.0 许可证，这是一种 copyleft 许可证，网络使用修改后的代码时需要公开源码。

标签

#ai-agent#claude-code#codex#remote-control#developer-tools#mobile#pwa#self-hosted#app#gemini-cli

常见问题

hapi 是什么？
远程控制 Claude Code、Codex 等 AI 编程代理，在本机运行会话，通过手机或网页操作。 HAPI 对 Claude Code、Codex、Cursor Agent、OpenCode、Pi 等官方 AI 编程代理进行封装，会话始终在你自己的机器上运行，你可以通过原生 iOS / Android 应用、Web / PWA 或 Telegram Mini App 远程查看和操作。
hapi 可以免费使用吗？用的什么许可证？
hapi 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
hapi 还在维护吗？
活跃维护中。hapi 最近一次提交是在 2026年10月19日。
hapi 适合用来做什么？
离开工位时用手机查看长时间运行的编程代理进度。 无需回到工作机即可远程审批代理的工具调用请求。 在家中或办公室的机器上运行编程代理，并在任何地方访问。
hapi 怎么安装和运行？
启动带端到端加密中继的 hub: npx @twsxtd/hapi hub --relay 选择代理并启动会话: npx @twsxtd/hapi 在浏览器中打开 hub 显示的网址，或用配套二维码配对原生应用
在哪里获取 hapi？
源代码和安装说明在 GitHub 上：https://github.com/tiann/hapi

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目