codex-mobile

一键在浏览器中运行 Codex 桌面应用界面

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:codex-mobile。
它的用途是:一键在浏览器中运行 Codex 桌面应用界面
完整的 Skill 内容见:https://321skill.com/skills/codex-mobile/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'帮我在本地启动 Codex 的 Web 界面,并生成一个可以让我在手机上访问的链接。' 它会执行 `npx codexapp` 命令,启动服务并自动创建安全隧道,随后在终端中打印出包含二维码和密码的访问链接,你只需用手机扫描二维码即可在浏览器中打开完整的 Codex 应用界面进行交互。

介绍

codexapp 解决了 Codex 桌面应用界面无法在非原生平台便捷访问的问题。它是一个轻量级桥接工具,通过一条简单的 npx codexapp 命令,即可在本地启动一个 Web 服务器,将 Codex 的完整 UI 界面暴露在浏览器中,让你可以在 Linux、Windows 甚至 Android 的 Termux 环境中,通过浏览器获得与原生桌面应用一致的体验。

使用极其简单,只需确保 Node.js 版本在 18 以上,在终端运行 npx codexapp 即可。启动后,它会自动打开一个本地端口(默认 18923),并默认创建一个 Cloudflare Tunnel 隧道,在终端输出隧道 URL、二维码和访问密码,方便你在局域网或外部网络安全访问。你还可以通过 --no-tunnel 禁用隧道,或使用 --no-login 跳过强制登录步骤。

这个工具非常适合那些需要在多台设备、不同操作系统间灵活使用 Codex,或者希望在移动设备上也能体验 Codex 完整功能的前后端开发、全栈开发、运维工程师以及内容创作者。它让 Codex 的交互不再局限于单一的桌面环境。

使用建议:在 Android Termux 上使用时,请务必在系统设置中为 Termux 禁用电池优化,并保持应用在前台运行或使用 termux-wake-lock 命令防止被系统休眠。对于希望通过 iPhone/iPad 访问的用户,建议结合 Tailscale Serve 来提供 HTTPS 访问,以获得更好的移动端兼容性和功能支持(如听写)。

核心特点

核心区别在于它并非一个独立的 Web 应用,而是直接桥接并暴露了原生 Codex 桌面应用的完整 UI 到浏览器,实现了“一次部署,多端同体验”;同时,它默认集成 Cloudflare Tunnel,开箱即用即可获得安全的远程访问能力,无需复杂的反向代理配置。

注意事项

其功能完全依赖于本地的 Codex 后端服务,如果本地服务未运行或出现问题,Web 界面将无法工作;此外,移动端浏览器访问可能存在一些 CSS 样式兼容性问题。

常见问题

在 Android 上使用,如何防止 Termux 被系统杀掉?

在 Android 设置中为 Termux 禁用电池优化,保持 Termux 通知常驻,并在 Termux 内运行 `termux-wake-lock` 命令。

如何通过 iPhone 或 iPad 访问 codexapp?

推荐使用 Tailscale Serve:本地运行 `npx codexapp --no-tunnel --port 5900`,然后运行 `tailscale serve --bg 5900`,即可通过生成的 HTTPS 链接在 Safari 中安全访问。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/codex-mobile/raw/index.md 读取 codex-mobile 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。