# 在手机上用 OpenCode：看会话、续聊、新开任务

> OpenCode 官方没有手机 app。这篇对比 opencode web、社区手机客户端和 BotBus 几种在手机上用 OpenCode 的办法，讲清各自适合谁和限制。

Canonical: https://botbus.io/blog/opencode-on-your-phone  
Published: 2026-10-06

## 先说结论

截至 2026-10-06 核对，OpenCode 官方提供的是终端程序、桌面 app、几款编辑器插件和 `opencode web` 网页界面，没有官方手机 app。想离开电脑也能看 OpenCode 的会话、接着聊或者新开一个任务，可以把 `opencode web` 开到局域网或隧道上用手机浏览器打开，装社区做的手机客户端，或者用 [BotBus](https://botbus.io/)：它在电脑上读 OpenCode 的会话，经端到端加密的中转同步到手机和 Apple Watch，你在手机上续聊、新建、中断，不用把 OpenCode 的端口开出去。

下面先说清楚 OpenCode 自己的远程办法各适合谁，再讲 BotBus 具体能做什么、做不到什么。

## OpenCode 官方现在有哪些端

以下是 2026-10-06 在 opencode.ai 的下载页和文档里核对到的情况：

- **终端程序**：最常用的形态，可以用安装脚本、npm、bun、Homebrew 等方式装。
- **桌面 app**：macOS、Linux 等主流桌面系统都有官方版本。桌面 app 和终端程序共用同一份本机会话数据。
- **编辑器插件**：VS Code、Cursor、Zed、Windsurf、VSCodium 等。
- **网页界面**：`opencode web` 在本机起一个服务并打开浏览器。默认只监听 `127.0.0.1`，加 `--hostname 0.0.0.0` 才能被同一网络里的其他设备访问；可以用 `--mdns` 在局域网里以 `opencode.local` 被发现；用环境变量 `OPENCODE_SERVER_PASSWORD` 设密码，文档明说不设密码时服务是不受保护的。还可以用 `opencode attach` 让终端界面接到同一个服务上。
- **分享链接**：会话里执行 `/share` 会生成一个公开链接，任何拿到链接的人都能看，会话内容同步到 OpenCode 的服务器，`/unshare` 才删除。它适合给别人看一段对话，不是遥控手段。
- **手机端**：下载页没有 iOS 或 Android app。GitHub 和应用商店里有几款社区做的手机客户端，都自称非官方，原理是连你自己跑起来的 `opencode serve` / `opencode web` 服务。

所以“在手机上用 OpenCode”，本质是让手机碰到电脑上的 OpenCode 服务，或者换一条路把会话同步出去。

## 几种免费办法，各适合谁

**局域网直连 `opencode web`。** 在电脑上用 `--hostname 0.0.0.0` 和一个固定端口启动，设好 `OPENCODE_SERVER_PASSWORD`，手机连同一个 Wi-Fi 打开电脑的地址就行。这是最省事的办法，界面和电脑上的网页版一样完整。限制也很明显：出了这个 Wi-Fi 就连不上；网页界面不是为小屏设计的；手机浏览器切到后台以后，OpenCode 停下来等你时手机不会响。

**Tailscale、Cloudflare Tunnel 或反向代理。** 想在外面也能打开，就给这个服务加一层组网或隧道。社区手机客户端的文档推荐的也是这条路：`opencode serve` 加认证，再经 HTTPS 隧道或代理暴露出去。适合本来就在用 Tailscale 或会配 Caddy、Nginx 的人。代价是你要自己维护一个对外的入口，密码、证书、访问范围都要自己管，服务一开到公网上，安全就由你负责。

**社区手机客户端。** 搜 “opencode mobile” 能找到几款：有的是 Android 原生客户端，有的同时有 iOS 测试版，有的把网页界面包成手机 app。它们直接说 OpenCode 的 HTTP 接口，功能贴 OpenCode 很近，不经过第三方中转。选的时候看清楚它要你怎么暴露服务、怎么鉴权，iOS 版是否已经正式发布。

如果你只用 OpenCode、会折腾网络、想要和电脑上一样完整的界面，上面几条都能用。BotBus 适合的是另一种情况：你同时在用 OpenCode 和 Codex、Claude Code 这些别的 agent，想在一个列表里看所有任务、跑完时手机响一下，又不想开端口、不想改 OpenCode 的配置，也不想记得每次先手动起一个 `opencode web`。

## BotBus 怎么接 OpenCode

前提先说清楚：OpenCode 的命令行程序装在跑 BotBus 的那台电脑上，并且已经在 OpenCode 里配好了能用的模型；电脑要开着、联网。电脑端有 Mac 版（菜单栏应用，需要 macOS 26 或更新）和 Linux 版（x86_64 / aarch64 的命令行程序，见[安装说明](https://botbus.io/docs/install-linux)），装最新版即可。

OpenCode 在 BotBus 里是内置支持的 agent，走的是 ACP（Agent Client Protocol），不用写任何配置文件。BotBus 会在 PATH 和官方安装目录 `~/.opencode/bin` 里找 `opencode` 命令。只装了桌面 app 没装命令行程序的话，需要先把命令行装上，因为手机上的续聊和新建都要靠它。

它看见会话的方式很简单：OpenCode 的桌面 app 和终端程序共用一个本机数据库，BotBus 每 5 秒只读地查一次，列出最近 7 天的会话，不分项目，跳过已归档的会话和子代理会话。查看历史只读这个数据库，不会为了看一眼就把会话载入、占住。手机上显示的是对话本身，模型的思考过程不显示。

![BotBus 手机上的电脑任务列表](https://botbus.io/shots/zh/phone-machine.webp)

## 在手机上能做什么

**看会话和对话记录。** 你在桌面 app 或终端里开的 OpenCode 会话，和别的 agent 的任务一起按电脑、项目排好，点进去能读完整对话。

**收推送。** 任务跑完或者失败时手机会收到通知（前提是手机开了通知权限）。电脑上那些会话的状态来自每 5 秒一次的数据库扫描，所以会有几秒的延迟。

**续聊。** 一轮结束后想补一句“顺便把测试跑一遍”，在手机上打开会话直接发。BotBus 在电脑上用 `opencode acp` 载入原来那个会话，把你的话发进去，结果写回同一个会话记录，回到电脑在 OpenCode 里接着看就行。续聊的通用做法见[手机续聊 agent 会话](https://botbus.io/blog/continue-agent-session-on-phone)。

**新建任务。** 在手机上选项目、写需求，BotBus 在电脑上起 OpenCode 跑这一轮。手机发起的这些轮次里，agent 可以用 BotBus 提供的工具把文件、网页预览和链接发回手机，比如让它改完页面后把预览发过来。

![BotBus 手机上新建任务](https://botbus.io/shots/zh/phone-newtask.webp)

**审批。** OpenCode 默认大部分工具直接放行，只有重复调用同一个工具、访问项目目录以外的路径这类情况会问你；你也可以在 `opencode.json` 里把某些操作改成要确认。手机发起的轮次里，OpenCode 发出的确认请求会以审批卡片出现在手机上，可以允许或拒绝。通用的审批说明见[在手机上审批 agent 请求](https://botbus.io/blog/approve-claude-code-from-phone)。

**中断。** 手机发起的一轮跑偏了，在手机上点停止，BotBus 给 OpenCode 发取消。各 agent 中断的差异见[远程停止 AI agent](https://botbus.io/blog/stop-ai-agent-remotely)。

**回到电脑接着做（Mac 版）。** 菜单栏里 OpenCode 那一行会列出从手机发起的会话，点“继续聊”会打开“终端”，用 `opencode --session <id>` 在原来的目录里接上。

## 限制与边界

- **电脑上正在跑的一轮管不了。** BotBus 对桌面 app 和终端里的会话只是读数据库，不接管它们。电脑上那一轮还在跑时，手机上不能并行续聊，BotBus 会直接拒绝，等它跑完再发；那一轮里 OpenCode 弹出的确认也只能在电脑上点，手机上收不到；中断也只对手机发起的轮次有效。
- **不会出现“等待回复”。** ACP 没有“agent 在向你提问”的信号，OpenCode 在对话里问你问题时，手机上显示的是这一轮结束了，不会单独提醒你回答。
- **手机上不能换模型、不能开自动批准。** 换模型和思考强度、项目级自动批准这两项目前只对部分内置 agent 开放，OpenCode 用的是你在它自己配置里定的模型和权限。
- **手机发图别指望。** 目前手机发图只对 Codex 和 Claude Code 做了支持和验证。
- **只列最近 7 天。** 更早的会话不在手机上出现，归档的会话和子代理会话也不列。
- **电脑睡了就停。** BotBus 本身不阻止休眠，电脑睡着或断网时，手机上能看已经同步过的会话，但续聊、新建和中断都要等电脑回来。
- **内容加密，元数据不加密。** 对话、命令、审批内容在设备上加密后才经过中转服务器，服务器看不到内容，但看得到设备编号、在线状态、更新时间和数据大小；开发预览不在端到端加密范围内。详见[端到端加密说明](https://botbus.io/docs/security)。
- **手机端。** iPhone 和 Apple Watch 版已在 [App Store](https://apps.apple.com/app/id6815751066) 上架，需要 iOS 26 / watchOS 26 或更新；Android 版需要 Android 8.0 或更新，在官网下载区下载安装包。

## 常见问题

### OpenCode 有官方手机 app 吗？

截至 2026-10-06 核对没有。官方提供终端程序、桌面 app、编辑器插件和 `opencode web` 网页界面；能找到的手机客户端都是社区项目，需要你自己把 OpenCode 服务暴露给手机。

### 用 BotBus 需要开着 opencode web 吗？

不需要。BotBus 直接读 OpenCode 的本机数据库来列会话，续聊和新建时自己起 `opencode acp`，不依赖 `opencode web`，也不用往局域网或公网开端口。

### 只装了 OpenCode 桌面 app 可以吗？

能列出会话的前提是 BotBus 找得到 `opencode` 命令行程序。只有桌面 app 时，先按官方说明把命令行程序装上（装到 PATH 或 `~/.opencode/bin` 都行）。

### 手机上发的消息，回到电脑能看到吗？

能。手机上的续聊写进原来的同一个会话；手机新开的会话在 OpenCode 的会话记录里也有，Mac 版还可以从菜单栏“继续聊”直接在终端里接上。

### 怎么开始？

在电脑上装最新版 BotBus，用手机扫电脑上的配对二维码，OpenCode 会自动出现在本机 agent 列表里。下载见[官网首页](https://botbus.io/#download)。
