先说结论
截至 2026-10-06 核对,OpenCode 官方提供的是终端程序、桌面 app、几款编辑器插件和 opencode web 网页界面,没有官方手机 app。想离开电脑也能看 OpenCode 的会话、接着聊或者新开一个任务,可以把 opencode web 开到局域网或隧道上用手机浏览器打开,装社区做的手机客户端,或者用 BotBus:它在电脑上读 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 的命令行程序,见安装说明),装最新版即可。
OpenCode 在 BotBus 里是内置支持的 agent,走的是 ACP(Agent Client Protocol),不用写任何配置文件。BotBus 会在 PATH 和官方安装目录 ~/.opencode/bin 里找 opencode 命令。只装了桌面 app 没装命令行程序的话,需要先把命令行装上,因为手机上的续聊和新建都要靠它。
它看见会话的方式很简单:OpenCode 的桌面 app 和终端程序共用一个本机数据库,BotBus 每 5 秒只读地查一次,列出最近 7 天的会话,不分项目,跳过已归档的会话和子代理会话。查看历史只读这个数据库,不会为了看一眼就把会话载入、占住。手机上显示的是对话本身,模型的思考过程不显示。

在手机上能做什么
看会话和对话记录。 你在桌面 app 或终端里开的 OpenCode 会话,和别的 agent 的任务一起按电脑、项目排好,点进去能读完整对话。
收推送。 任务跑完或者失败时手机会收到通知(前提是手机开了通知权限)。电脑上那些会话的状态来自每 5 秒一次的数据库扫描,所以会有几秒的延迟。
续聊。 一轮结束后想补一句“顺便把测试跑一遍”,在手机上打开会话直接发。BotBus 在电脑上用 opencode acp 载入原来那个会话,把你的话发进去,结果写回同一个会话记录,回到电脑在 OpenCode 里接着看就行。续聊的通用做法见手机续聊 agent 会话。
新建任务。 在手机上选项目、写需求,BotBus 在电脑上起 OpenCode 跑这一轮。手机发起的这些轮次里,agent 可以用 BotBus 提供的工具把文件、网页预览和链接发回手机,比如让它改完页面后把预览发过来。

审批。 OpenCode 默认大部分工具直接放行,只有重复调用同一个工具、访问项目目录以外的路径这类情况会问你;你也可以在 opencode.json 里把某些操作改成要确认。手机发起的轮次里,OpenCode 发出的确认请求会以审批卡片出现在手机上,可以允许或拒绝。通用的审批说明见在手机上审批 agent 请求。
中断。 手机发起的一轮跑偏了,在手机上点停止,BotBus 给 OpenCode 发取消。各 agent 中断的差异见远程停止 AI agent。
回到电脑接着做(Mac 版)。 菜单栏里 OpenCode 那一行会列出从手机发起的会话,点“继续聊”会打开“终端”,用 opencode --session <id> 在原来的目录里接上。
限制与边界
- 电脑上正在跑的一轮管不了。 BotBus 对桌面 app 和终端里的会话只是读数据库,不接管它们。电脑上那一轮还在跑时,手机上不能并行续聊,BotBus 会直接拒绝,等它跑完再发;那一轮里 OpenCode 弹出的确认也只能在电脑上点,手机上收不到;中断也只对手机发起的轮次有效。
- 不会出现“等待回复”。 ACP 没有“agent 在向你提问”的信号,OpenCode 在对话里问你问题时,手机上显示的是这一轮结束了,不会单独提醒你回答。
- 手机上不能换模型、不能开自动批准。 换模型和思考强度、项目级自动批准这两项目前只对部分内置 agent 开放,OpenCode 用的是你在它自己配置里定的模型和权限。
- 手机发图别指望。 目前手机发图只对 Codex 和 Claude Code 做了支持和验证。
- 只列最近 7 天。 更早的会话不在手机上出现,归档的会话和子代理会话也不列。
- 电脑睡了就停。 BotBus 本身不阻止休眠,电脑睡着或断网时,手机上能看已经同步过的会话,但续聊、新建和中断都要等电脑回来。
- 内容加密,元数据不加密。 对话、命令、审批内容在设备上加密后才经过中转服务器,服务器看不到内容,但看得到设备编号、在线状态、更新时间和数据大小;开发预览不在端到端加密范围内。详见端到端加密说明。
- 手机端。 iPhone 和 Apple Watch 版已在 App Store 上架,需要 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 列表里。下载见官网首页。