切换深浅色
Hapi 远程控制
让 AI 帮你完成配置
首次安装或切换到 XXAPI，都可以使用。
AI 打不开链接时，。
查看短提示词
Hapi 可以把电脑上的编程会话同步到浏览器或手机。电脑仍然负责运行任务，XXAPI 地址和密钥继续使用原来工具里的配置。
先完成 Claude Code、Codex 或 OpenCode 中任意一个工具的接入，并确认已经能收到回复。
1. 安装 Hapi
打开终端，运行下面的命令。
bash
npm install -g @twsxtd/hapi --registry=https://registry.npmjs.org安装结束后运行 hapi --version。如果提示找不到 npm，先从 Node.js 官网 安装当前 LTS 版本，重新打开终端，再执行上面的命令。
看到什么算完成 hapi --version 能显示版本号。
2. 先在本机打开 Hapi
运行下面的命令，保持这个终端窗口开着。
bash
hapi hub --no-relay首次启动时，终端会显示访问地址和 Hapi Token。打开 http://localhost:3006，在提示登录时输入刚显示的 Token。再次启动时若没有显示 Token，可在你自己的 ~/.hapi/settings.json 文件中找到 cliApiToken；Windows 对应用户目录下的 .hapi\settings.json。不要把这个文件发给别人。
两种密钥的用途
Hapi Token 用于登录你自己的远程控制页面。XXAPI Key 用于调用模型，它已经保存在 Claude Code 或 Codex 等工具的配置中。两者分别使用，不要互相替换。
3. 启动一个已配置 XXAPI 的会话
另开一个终端，进入你准备使用的项目目录，只运行与你工具对应的一条命令。
| 你要使用的工具 | 启动命令 |
|---|---|
| Claude Code | hapi claude |
| Codex | hapi codex |
| OpenCode | hapi opencode |
当前 Hapi 的 Codex 集成要求 Codex 0.154.0 或更新版本，可以先运行 codex --version 检查。
如果你之前只在某个终端临时设置了 XXAPI 环境变量，要在那个终端里启动会话，或先按对应教程保存配置。新开的终端不一定继承另一个窗口里的临时设置。
回到浏览器，打开出现的会话，发送一条简单消息。
看到什么算完成 浏览器里能看到同一段会话，发送消息后电脑上的工具正常回复。
4. 想在手机上继续使用
先看风险
- 开启远程后，拿到网页地址和 Hapi Token 的人，就能通过 Hapi 让你电脑上的 AI 工具读写文件、执行命令。Token 相当于你电脑的遥控钥匙。
- 二维码、网页地址和 Token 只在自己的手机上使用，不要截图发给别人，也不要发到群里。
- 不用的时候，回到运行 Hub 的终端按
Ctrl+C关闭远程。怀疑 Token 泄露时，先关闭 Hub，按 Hapi 官方说明 处理好以后再开启远程。
先回到运行 Hub 的终端，按 Ctrl+C 停止本地 Hub，然后运行官方远程连接方式。
bash
hapi hub --relay终端会显示网页地址和二维码。手机扫描 Web / 网页 二维码，打开页面；如果要求登录，输入本机生成的 Hapi Token。另一个二维码用于原生 App 配对，本页暂时用不到。不要把二维码和 Token 发到公开群里。
若重启 Hub 后会话没有重新出现，回到项目终端，再执行第 3 步中对应的启动命令。
远程方式会通过 Hapi 的 relay 提供访问。仅在电脑上使用时，继续用 --no-relay 即可。无需为这一步购买域名，也无需单独开放电脑端口。
看到什么算完成 手机里能看到电脑上的会话，并可以发送消息或处理权限确认。运行任务时保持电脑在线。
常见问题
本机网页打不开 检查 Hub 终端是否仍在运行，使用终端实际显示的地址。手机的 localhost 指手机自己，手机应使用第 4 步的地址。
Hapi 可以登录，模型却报错 先在终端直接运行你使用的 Claude Code、Codex 或 OpenCode，检查 XXAPI 配置。直接运行成功后，再通过 Hapi 启动同一个工具。
列表里没有会话 确认使用了第 3 步中对应的 Hapi 启动命令，并且 Hub 仍在运行。需要查看诊断信息时执行 hapi doctor，发给别人前遮盖凭据。