ByteNoteByteNote
手机浏览器就是 Codex 的遥控器:出门在外回一句 agent
字

字节笔记本

2026年11月6日 · 约 2 分钟读完

手机浏览器就是 Codex 的遥控器:出门在外回一句 agent

API中转
¥120

白天出门、晚上才回电脑的 Codex 用户,最想拥有的能力是「在路上回 agent 一句」。开源的 codex-web-relay(11 星、MIT)就是这个工具:一个轻量、手机友好的网页桥,让你在手机浏览器里远程跟本机 Codex CLI 会话,实时看终端输出、发命令、一键批准、看 Git Diff,不用装 App。

功能按 README 口径:共享 Web 终端基于 node-pty 加 WebSocket 加 xterm.js 实时流式输出;手机端快捷指令栏;Git 预览含已暂存与未暂存改动、新目录下的未追踪文件、Unicode 文件名;可选 Cloudflare Tunnel 对外连(临时 URL、自有域名或 dashboard 托管 tunnel token);浏览器脚本与样式全部本地提供,不走第三方 CDN。

要划清的边界不少。默认仅本地访问,不需要域名与 Cloudflare 账号就能起步。「Send y + Enter」和「Send n + Enter」只是终端快捷键,不是绑定到某个 Codex 请求的审批,用之前要先读终端提示。终端里的数字菜单是渲染出来的文字、不是 HTML 按钮,点文字不一定选中,要用上下键选再回车确认。认证浏览器获得宿主用户权限的真实 shell,Relay 不做沙箱或命令白名单。QR 与 URL 含凭据,浏览器存 localStorage;泄露需轮换并重启。

和 agent-browser 对照:那篇是 agent 替你操作浏览器,这篇是你用浏览器遥控 agent,方向正好反过来。和 WeiAssist 加 iphone-control 对照:那两篇是 agent 操作真手机,这篇是你远程操作 agent。三个工具拼在一起,agent 的「手」已经伸到了浏览器、桌面和真机。

安装:git clone 后 npm ci,复制 .env.example 为 .env,设 CODEX_CWD 为项目绝对路径即可;需要 Node.js 22 或 24、npm、Git、已装好并登录的 Codex CLI。11 星、单人作者、10 月 23 日创建,很早期,遇到问题要自己修或等作者修。对外访问要走 Cloudflare Tunnel,公网暴露终端入口之前先想好鉴权,别裸奔。

相关文章

分享: