使用教程
从零到手机上的第一个会话
一份可照抄的完整流程：安装 opencode、启动服务端、在局域网直连应用，再按需开启加密中继从任何地方回连 —— 附 ocrelay 完整命令参考。
安装 opencode
opencode mobile 是 opencode 的移动客户端 —— 先在存放项目的机器上安装 opencode CLI。已经装好了？直接进入下一步。
# 官方安装脚本
$ curl -fsSL https://opencode.ai/install | bash
$ opencode --version
启动 opencode serve
在存放项目的机器上启动服务端。应用兼容任意 opencode serve 实例 —— 已有实例在运行的话，这一步可以直接跳过。
# 在托管项目的机器上执行
$ export OPENCODE_SERVER_PASSWORD=your-secret
$ opencode serve --hostname 0.0.0.0 --port 4096
server listening on http://0.0.0.0:4096
务必设置密码
OPENCODE_SERVER_PASSWORD 为服务端启用 HTTP Basic 认证。不设置时，任何能访问该地址的人都能驱动你的代理。
绑定局域网，而非公网
默认绑定只接受本机连接。加 --hostname 0.0.0.0（或机器的局域网 IP）手机才能连上；同时不要把该端口做公网端口转发。
它就是标准 opencode
服务端就是常规 opencode CLI 的无界面模式。模型、服务商等全部配置遵循官方文档。
安装应用并直连
在手机上安装 opencode mobile，把服务器添加为一条连接配置。同一 Wi-Fi 下应用直接连接 —— 无需账号、不经中间方。
- 01
安装应用
iOS 经 TestFlight，Android 直接安装签名 APK —— 均免费。
- 02
添加服务器配置
填入服务器地址（例如 http://192.168.1.10:4096）、用户名与你在服务端设置的密码。
- 03
选择项目并开始会话
指定代理工作的目录，之后的一切实时流回你的手机。
开启中继隧道
不在同一网络？opencode relay 经 Cloudflare 边缘节点为手机建立加密隧道 —— 无需公网 IP、无需端口转发。只需在运行 opencode serve 的机器上配置一次。
- 01
在应用内登录中继
用邮箱验证码登录；首次登录自动创建免费账号，每月含 512 MB 流量。
- 02
安装 ocrelay
在运行 opencode serve 的机器上执行官方安装脚本。
- 03
执行 connect 并扫码配对
ocrelay connect 会依次询问 opencode 地址、用户名与密码，随后显示二维码。在应用中扫码完成配对；配对码一次性且限时有效。
- 04
完成
此后应用可在任何网络访问你的服务器。同一 Wi-Fi 下仍走直连，中继只在需要时承载流量。
# 安装中继客户端
$ curl -fsSL https://opencodemobile.com/install.sh | bash
# 开始配对；前台运行
$ ocrelay connect
本地 opencode 地址 [http://localhost:4096]: http://localhost:4096
用户名 [admin]: admin
密码: ••••••••••
配对码: 7QK4-2X9C
请使用 App 扫描二维码（或输入配对码）完成授权
配对成功 —— 在线后按 b 转入后台
你的 opencode 密码只留在那台机器上：中继客户端在本地注入凭据，中继全程只见加密流量。
ocrelay 命令参考
四个子命令覆盖中继客户端的全部能力。首次成功运行后，凭据与配对状态保存在本地。
| 命令 | 说明 |
|---|---|
| ocrelay connect | 扫码配对并等待 App 发起会话。前台运行；在线后按 b 转入后台。 |
| ocrelay stop | 停止后台运行的 ocrelay 实例。 |
| ocrelay status | 查看配对与本地状态（纯本地检查）。 |
| ocrelay upgrade | 检查并升级到最新版本。 |
| ocrelay connect --re-pair | 强制重新扫码配对（本地 opencode 配置保留；旧设备凭据需先在 App 中解绑）。 |
| ocrelay --version | 显示客户端与协议版本。 |
需要修改 opencode 地址、用户名或密码？重新执行 ocrelay connect，在提示中选择重新设置。