怎么在手机上看到 OpenCode 界面？

一句话概括：通过在电脑上启动一个服务，让你能在手机浏览器里像看网页一样使用 OpenCode。

---

你会学到什么

• 如何在局域网内用手机访问 OpenCode
• 如何让你出门在外也能连上家里的 OpenCode
• 新手最容易踩的坑和解决办法

---

方法一（简单）：局域网访问

如果你在家里，手机和电脑连着同一个 WiFi（或者插着同一台路由器的网线），用这个方法最快。

第一步：设置密码

为了不让别人随便连你的 OpenCode，我们先设个密码。打开你的终端，一行一行地复制下面的命令。

先复制这行，按回车：

export OPENCODE_SERVER_PASSWORD='你的密码'

（把“你的密码”换成你想设置的密码，比如 '123456'） 你会看到什么：终端什么都不提示，直接跳到下一行。这说明成功了。 如果你看到的不一样：提示 "command not found" 或其他报错，说明你复制错了，检查一下是不是多了空格。

接着复制这行，按回车：

export OPENCODE_SERVER_USERNAME='opencode'

你会看到什么：同样什么都不提示，跳到下一行。 如果你看到的不一样：检查复制有没有漏掉字母。

第二步：启动服务

继续在这个终端窗口里，复制这行，按回车：

opencode web --port 4096 --hostname 0.0.0.0

你会看到什么：终端会打印出一堆英文字母，告诉你服务已经在 4096 这个端口跑起来了。 如果你看到的不一样：如果提示 "address already in use"，说明 4096 端口被占了，把命令里的 4096 换成 4097 试试。

第三步：找到你的局域网地址

刚才的提示信息里，会有一行类似于 http://192.168.x.x:4096 的地址，这个 192.168 开头的地址就是你在局域网的访问地址。

第四步：在手机上打开

确保手机和电脑连着同一个 WiFi，打开手机浏览器，输入你刚刚找到的那个地址（比如 192.168.1.100:4096）。 你会看到什么：手机屏幕上出现了 OpenCode 的登录界面。输入你刚才设置的用户名和密码就能用了！

---

方法二（推荐）：Cloudflare Tunnel — 出门也能用

方法一只能在家里用。如果你想出门在外（用手机流量或者其他 WiFi）也能连，就要把家里的服务暴露到公网上。这听起来很难，其实只要一个工具就行。

注意：在这个方法前，请确保你已经按照方法一，在第一个终端窗口里成功启动了 OpenCode 服务！不要关掉那个窗口！

第一步：安装 cloudflared

现在，新开一个终端窗口（这样你就有两个终端窗口了）。在新窗口里复制这行命令，按回车：

brew install cloudflare/cloudflare/cloudflared

你会看到什么：屏幕上会刷刷刷地下载东西，最后告诉你安装成功。 如果你看到的不一样：如果提示 "brew command not found"，说明你没装 Homebrew，得先去装一下 Homebrew。

第二步：开启隧道

继续在这个新终端里，复制这行，按回车：

cloudflared tunnel --url http://localhost:4096

(这里的 localhost 就代表你现在的这台电脑)

你会看到什么：终端会跑出一堆日志，注意找中间有类似 https://xxxxxx.trycloudflare.com 的一行网址。 如果你看到的不一样：如果一直卡住，检查一下你的电脑网络。

第三步：复制网址

把刚才那个 https://xxxxxx.trycloudflare.com 开头的网址复制下来。

第四步：在手机上打开

现在你可以关掉手机 WiFi，用手机流量打开浏览器，输入刚才复制的网址。 你会看到什么：熟悉的 OpenCode 登录界面！现在你可以在任何地方访问它了。

---

最容易犯的错（提前避坑）

1. 三条命令一次性粘进去：千万别！终端反应不过来的，一定要一行一行地复制，每复制一行按一次回车。
2. 只开一个终端窗口：方法二需要用到两个工具同时跑。一定要保留跑 OpenCode 的第一个窗口，再新开一个窗口跑 Cloudflare！
3. 手机去打开 localhost:4096：localhost 是电脑叫自己的名字。手机要是去打开 localhost，就是在手机里面找服务，当然找不到。
4. 关掉终端窗口：不管你用方法一还是方法二，只要你想在手机上用，电脑上的那两个终端窗口绝对不能关！关了服务就停了。
5. VPN 导致地址异常：如果你连不上，第一件事就是关掉电脑和手机上的所有 VPN（翻墙软件），它们会把网络搞乱。

---

遇到问题了？

Q: 为什么我输入了密码还是登录不上？

A: 可能是浏览器存了以前错误的缓存。试着换个浏览器，或者用手机浏览器的“无痕模式”/“隐私模式”打开。

Q: 方法二的 cloudflared 网址每次都不一样吗？

A: 是的，这种免费试用的方式每次都会变网址。想固定的话需要花钱买域名配置，小白暂时不折腾那个。

🤔 遇到问题了？

Q: 我跟着做了一遍还是不行
A: 回头仔细看看「最容易犯的错」那一段，90% 的人都是在那里摔跤的。

Q: 手机屏幕太小看不清代码
A: 手机主要是用来在外面紧急查阅或者简单交互的，写大段代码还是推荐回电脑上操作哦。

👉 下一步看什么

回电脑上继续学习 OpenCode →