Hapi 远程控制
Hapi 可以把 Claude Code、Codex、Gemini CLI 等命令行工具放到浏览器里远程使用。接入 MuskAI 时，核心是把 Hapi 里的模型服务配置成本站提供的 API Key 和 Base URL。
准备工作
- 一个可用的 MuskAI 账号。
- 在官网用户中心 -【API密钥】页面创建并复制 API Key。
- 在官网用户中心 -【API密钥】页面复制当前推荐的 Base URL。
- 本机或服务器已安装 Node.js 18 及以上版本。
安装 Hapi
在需要运行 Hapi 的机器上执行：
npx hapi
首次启动会按提示安装依赖并创建配置。建议在稳定网络环境下操作，安装完成后记录终端输出的访问地址和管理入口。
配置 MuskAI 服务
进入 Hapi 管理界面后，新增或编辑模型服务，按 OpenAI 兼容服务填写：
| 字段 | 填写方式 |
|---|---|
| Provider / Service | 自定义 OpenAI 兼容服务 |
| API Key | 官网用户中心 -【API密钥】页面复制的 Key |
| Base URL | 官网用户中心 -【API密钥】页面复制的 Base URL |
| Model | 控制台可用模型名 |
保存后新建一个会话，发送简单问题测试连通性。测试成功后，可以再按需要配置 Claude Code、Codex 或其他工具的默认模型。
远程访问
如果 Hapi 跑在服务器上，推荐使用带 HTTPS 的反向代理或 Cloudflare Tunnel 暴露访问入口。不要直接把未加保护的本地端口暴露到公网。
常见做法：
- Hapi 在服务器本机监听内网端口。
- 使用 Nginx 或 Cloudflare Tunnel 转发到该端口。
- 给入口设置 HTTPS、访问密码或来源限制。
- 用手机或另一台电脑访问页面，确认能打开会话并发送请求。
验证
配置完成后检查三件事：
- Hapi 页面可以正常打开。
- 会话里能收到模型回复。
- MuskAI 控制台能看到对应 API Key 的使用记录。
常见问题
- 连接失败：检查 Base URL 是否完整复制，末尾路径不要自行拼接接口地址。
- 401 或 403：检查 API Key、余额、套餐权限和模型权限。
- 模型不存在：改用控制台可用模型名。
- 远程页面打不开：检查服务器防火墙、反向代理、Tunnel 状态和端口监听。