q quicktuiv1
iOS 应用iOS → Android 应用Android →

指南 · OpenCode

在手机上运行 OpenCode：iPhone、iPad 与 Android

要在手机上使用 OpenCode，做法是让它在你自己的电脑上运行，再用 QuickTUI 在手机上打开它的终端界面。你在 iPhone、iPad 或 Android 上操作的是真实的 OpenCode 界面，放下手机后 OpenCode 仍在电脑上继续运行。

在手机上的 QuickTUI App 中显示 OpenCode 终端界面
QuickTUI 终端原样显示电脑上运行的 OpenCode。

OpenCode 是什么

OpenCode 是开源的终端 AI 编程 Agent，由 Anomaly 发布，采用 MIT 协议（anomalyco/opencode，原 sst/opencode）。它支持众多模型服务商，也支持本地模型，以全屏终端界面运行。

安装 OpenCode 与 QuickTUI

  1. 在要运行 OpenCode 的电脑上，用任一官方方式安装： 
    # macOS / Linux
curl -fsSL https://opencode.ai/install | bash

# npm
npm install -g opencode-ai

# Homebrew
brew install anomalyco/tap/opencode
    Windows 上可以用 Chocolatey、Scoop 或 npm 安装，OpenCode 推荐使用 WSL。
  2. 运行 opencode，用 /connect 连接模型服务商，或运行 opencode auth login。
  3. 在手机上安装 QuickTUI：iPhone 和 iPad 从 App Store 下载，Android 使用 Android 应用（Preview）。
  4. 在 App 的设置向导中选择 通过 SSH 连接并启用增强功能（推荐），填写电脑的 SSH 登录信息，点 安装。App 会安装 QuickTUI 服务端并自动完成配对；电脑上没有 tmux 和 Herdr 时，会自动安装 Herdr。

Windows 电脑或不支持 SSH 登录的电脑，先在电脑上运行安装命令，再扫码配对：

# macOS / Linux
curl -fsSL https://quicktui.ai/q.sh | sh -s -- install --channel server2

# Windows（PowerShell）
& ([scriptblock]::Create((irm https://quicktui.ai/q.ps1))) install --channel server2

手机与电脑之间的连接全程端到端加密，默认直连。详见安装指南。

从手机启动 OpenCode

在 App 中打开 Agent 向导，选择 OpenCode，QuickTUI 会在当前 tmux 会话中新建窗口，或在当前 Herdr 工作区中新建标签页来启动它。Luvus 后端不支持 Agent 向导。

模式
Default 保留 OpenCode 的权限确认。YOLO 会加上 --auto，不再逐项询问，只建议在允许它随意修改的仓库中使用。
模型
从 OpenCode 内置的模型列表中选择，通过 --model 传入。也可以在「设置 > Agent 模型」中添加自定义模型。
恢复会话
用 --session 继续之前的会话。工作区运行在 Herdr 上时不支持恢复。
工作目录
选择项目文件夹，最近用过的文件夹可以直接点选。常用组合可以保存为预设。

也可以在电脑上自己启动，放在一个有名字的 tmux 会话里，之后在 App 中就能找到：

tmux new-session -s opencode
opencode

在手机上使用 OpenCode 的建议

鼠标捕获
OpenCode 默认捕获鼠标。如果想用终端自身的选择功能选中文字，可以在 OpenCode 配置中设置 "mouse": false。
发送截图
在输入栏中附加文件、图片或相机照片。文件会上传到电脑（上限 10 MiB），并把路径填入输入内容，OpenCode 就能读取它。
常用命令一键发送
命令面板内置 OpenCode 分组，收录了常用命令，不必在手机键盘上逐字输入。
看清哪个会话需要你
使用 Herdr 时，会话管理器会用图标标出每个 OpenCode 会话，并显示它是空闲、工作中、等待输入还是已完成。

OpenCode 网页版与 QuickTUI

OpenCode 自带浏览器界面：opencode web 会在电脑的一个端口上提供网页，只要网络能访问这个端口，就可以在手机浏览器中打开。QuickTUI 的方式不同：它通过自己的端到端加密连接接入 OpenCode 的终端界面，不需要对外开放端口，同一个 App 里还能管理你的其他终端会话和 Agent。

常见问题

OpenCode 有手机 App 吗？

OpenCode 本身运行在电脑上。借助 QuickTUI，你可以在 iPhone、iPad 或 Android 手机上使用它；也可以在手机浏览器中打开 OpenCode 自带的网页界面。

关闭 App 后，OpenCode 还会继续运行吗？

会。它运行在电脑上的 tmux 或 Herdr 会话中，关闭 App 后照常工作。重新打开 App 即可回到正在运行的会话。

可以同时运行 OpenCode、Claude Code 和 Codex 吗？

可以。每个 Agent 各用一个窗口、标签页或会话，在 App 中随时切换。

我的代码会经过 QuickTUI 的服务器吗？

不会。App 默认直连你的电脑，全程端到端加密。OpenCode 本身照常与你配置的模型服务商通信。

相关链接