手机网页控制本机 Codex 的本地 bridge。适合电脑在学校/公司内网、无法被 RustDesk 这类远控软件直连,但可以主动连出公网的场景。
- 手机浏览器查看 Codex 任务进度
- 手机端 approve / deny 命令、文件修改和权限请求
- 手机端发送下一轮任务输入,运行中会走 steer
- 多个网页客户端共享同一条 Codex app-server 后端连接,手机和电脑网页同步
- 聊天列表可折叠,可按工作文件夹分组
- 可在手机端切换是否显示 command 输出
- 通过 Cloudflare Tunnel 暴露 HTTPS 临时地址,手机无需 VPN
- 支持多种认证模式:本地 token、Cloudflare Access、Access/token 过渡模式
手机浏览器 / 电脑浏览器
-> Cloudflare Tunnel HTTPS
-> 127.0.0.1:8787 codex-mobile-web
-> 127.0.0.1:8791 codex app-server
-> 本机 Codex / Git / 文件系统
codex-mobile-web 不直接调用 OpenAI API。Codex 运行在本机,网页只是本机 Codex app-server 的受控前端。
前置条件:
- Windows
- Node.js 24+
- Codex CLI / Codex Desktop 已安装并登录
- 可选:本机 HTTP 代理,例如
http://127.0.0.1:7897,用于 Cloudflare 域名被 fake-ip 代理接管的网络
启动 Codex app-server:
.\scripts\start-codex-app-server.ps1如果从 Codex 自己的工具环境里启动,需要让进程在命令结束后继续运行:
.\scripts\start-codex-app-server.ps1 -UseScheduledTask
.\scripts\start-bridge.ps1 -AuthMode access-edge -UseScheduledTask -Restart启动本地 bridge:
.\scripts\start-bridge.ps1下载并启动 Cloudflare Tunnel:
.\scripts\start-cloudflare-tunnel.ps1 -Download -Proxy http://127.0.0.1:7897如果网络不需要代理:
.\scripts\start-cloudflare-tunnel.ps1 -Download脚本会输出手机访问地址:
https://<random>.trycloudflare.com/?token=<bridge-token>
手机不需要连接 VPN;直接用浏览器打开该 HTTPS 地址即可。
如果已经在 Cloudflare 中配置 named tunnel 和固定域名,例如:
https://codex.wuyou0123.com
先把本地固定访问地址保存下来:
Set-Content .bridge-public-url "https://codex.wuyou0123.com" -NoNewline如果 Cloudflare Access 已经保护该域名,并且策略只允许你的邮箱访问,可以使用边缘认证模式:
.\scripts\start-bridge.ps1 -AuthMode access-edge -Restart如果你还想保留旧 token 链接作为备用,使用过渡模式:
.\scripts\start-bridge.ps1 -AuthMode access-or-token -Restart更严格的 Cloudflare Access JWT 本地校验需要配置 CF_ACCESS_TEAM_DOMAIN 和 CF_ACCESS_AUD。完整说明见:
docs/auth-modes.md
Cloudflare named tunnel 有两种常见运行方式:
- Dashboard-managed tunnel:在 Cloudflare 后台复制 connector token 启动,本地不需要
config.yml。 - Locally-managed tunnel:本机有
~/.cloudflared/config.yml、tunnel credentials 和 DNS route。
如果你的 Cloudflare 后台已经把 codex.wuyou0123.com 指向 tunnel,但手机仍无法访问,优先检查本机是否真的运行了该 named tunnel connector。旧的 quick tunnel 日志只会显示 trycloudflare.com,不会服务固定域名。
.bridge-token是本地随机 token,已加入.gitignore.bridge-public-url是本地域名配置,已加入.gitignore- 不要提交
.bridge-token、.bridge-public-url、日志、tools/cloudflared.exe - 不要把
127.0.0.1:8791的 Codex app-server 直接暴露公网 - 临时
trycloudflare.com隧道没有 uptime 保证,长期使用建议换成 Cloudflare named tunnel + Access
刷新手机和电脑网页。当前版本的 bridge 使用单一共享 Codex 后端连接,并广播 thread/start、turn/status/approval/output 和用户输入事件;旧页面还连着旧 JS 时需要刷新。
确认 bridge 已重启到最新代码。新版本会广播 bridge/threadStarted,其他网页客户端收到后会把新聊天加入列表并自动切换到该聊天。
这是常见 fake-ip 代理表现。传入本机代理:
.\scripts\start-cloudflare-tunnel.ps1 -Proxy http://127.0.0.1:7897本项目保证手机网页和电脑网页同步。Codex Desktop App 可能需要重新打开 thread 或手动刷新才能看到持久化后的会话。
仓库内包含可复现 Skill:
skills/codex-mobile-web/SKILL.md
把该目录复制到 $CODEX_HOME/skills 或 ~/.codex/skills 后,Codex 可按同样流程重建和运维此方案。