用 WebMux 远程运行 OpenCode

1. 安装并认证 OpenCode

在运行 WebMux 的机器上按 OpenCode 官方说明（外部链接） 安装，并以运行 WebMux 的服务用户身份完成认证。WebMux 不会自动安装或认证 CLI，也不代管模型密钥。

2. 使用预置启动配置

交互式命令

opencode

预置参数

--auto

在“新建会话 → 预先输入”选择该启动配置，指定目录或工作树，再创建会话。也可以在服务所在机器的终端里启动，Ctrl+] 分离后到手机上继续：

webmux run -- opencode --auto

已有安装升级时不会改写 launch-configs.json；列表里缺少该 CLI 时，在“设置 → 启动配置 → 新建启动配置”填写名称和上面的命令。预置命令用“加载 shell 启动文件”包装，以读取 ~/.bashrc 或 ~/.zshrc 中的 PATH。 已有安装

3. 终端、混合会话与提醒

终端

持久 PTY 终端：浏览器断线不会结束进程，可重新连接并回放缓冲；服务重启会结束会话。

混合会话（聊天 ↔ 终端）

支持。预置配置已勾选混合模式，可在终端与聊天视图之间切换同一段对话，历史由 OpenCode 自己保存。 开启条件

“需要你介入”提醒

按其源码，OpenCode 2.x 直接报告 OSC 7501，无需配置。 提醒配置

4. 已知限制

• 预置参数 --auto 会自动批准工具调用；混合会话中 TUI 以 --standalone 运行，看不到后台服务中其他客户端的实时事件。
• 已验证版本为 OpenCode 2.1.4（2.2.0 参数相同）。