CODEX MOBILE BRIDGE电脑运行 · 跨设备接力

开源 · 自托管 · Codex App 浏览器入口

离开电脑,也能继续你的 Codex 工作。

任务还在运行,却要离开电脑;使用 API 或自定义模型服务,也希望随时查看进度、补充要求、回应确认。

手机、平板或另一台电脑,打开浏览器即可继续同一条会话。沿用原有模型、认证与上下文,任务仍在原电脑或 SSH 服务器执行。

执行端需保持在线,访问设备需能连接网关。

同一会话,跨设备继续。界面展示 v1.3.0。
API 接入,也能远程接力

在桌面添加官方账号或自定义 API,保存后可在电脑和网页切换。

浏览器,就是访问入口

手机、平板、电脑上的主流现代浏览器,无需在访问端安装 Codex App。

原来的聊天,原来的配置

继续已有工作,保留上下文、工作目录、模型与权限。

为什么需要独立入口?

官方 Remote 采用同一 ChatGPT 账号与工作区的设备配对。本项目使用独立的网关登录,访问设备无需登录同一个 OpenAI 账号。

查看官方 Remote 的连接条件 ↗

01 / WALKTHROUGH

先看看,它是怎么用的。

从启动网关到跨设备继续聊天,跟着实际界面走一遍。

真实界面 · 示例数据 · 中英文字幕 单独打开视频 ↗

跟随 v1.3.0 界面,了解账号配置、额度查看、API 模型选择和电脑使用授权。演示中的账号与聊天均为示例数据。

02 / GET STARTED

四步,接上已有工作。

先从局域网开始,再按需要配置外网入口。

电脑端集中管理网关、连接地址和通知。
  1. 1

    下载并打开 App

    电脑上先打开 Codex App,再打开对应系统的 Codex Mobile Bridge。

  2. 2

    启动网关

    保留局域网访问,保存配置后点击“启动网关”。

  3. 3

    扫码或打开地址

    手机扫描“扫码登录”;另一台电脑可打开访问地址,使用网关凭据登录。

  4. 4

    选择聊天,继续交互

    打开已有会话或新建聊天,查看进度、发送消息、回应支持的确认请求。

首次局域网使用无需 Python、Node.js 或部署 Agent。扫码负责登录,网络仍需可达;二维码为短期、一次性登录凭据。

NEW IN 1.3.0 / ACCOUNTS

电脑上配置,两端都能切换。

官方账号与自定义 API 统一管理。切换前先结束运行中的任务;Codex 会重启,手机网关保持在线。

03 / CAPABILITIES

远程接力,覆盖完整工作流程。

从会话管理到阅读、确认和通知,按你的使用方式展开。

v1.3.0 当前可用功能,从接入配置到继续对话。

01

会话与项目

  • 继续已有聊天、新建项目聊天
  • 本机与 SSH 会话,保留原执行环境
  • 最近交互、项目分组和搜索
  • 编辑最近消息,或编辑历史消息后新建分支
  • 从已完成轮次分支;复制完整回复与代码
02

任务操作与确认

  • 发送消息、补充当前任务、停止运行
  • 排队下一条消息、撤回待发送消息
  • 回应命令、文件与问题卡片;按请求选择电脑使用授权范围
03

计划与目标

  • 普通、计划、目标模式入口
  • 查看计划、执行计划或提出修改
  • 查看目标进度与用量,隐藏或恢复目标栏
04

文件与内容

  • 工作目录内已引用的本地文件与图片预览
  • Markdown、代码、表格与数学公式
  • 多文件与图片上传,随消息发送
05

模型与技能

  • 读取 API 上游模型,切换模型与推理强度,或手动填写模型 ID
  • 搜索并附带会话主机上已安装的 Skill
  • 官方登录且模型与工作区允许时开关 Fast
06

状态与通知

  • Bark / ntfy / PushPlus 待确认及运行完成提醒
  • 运行中、完成未读标识,可在设置中关闭
  • 电脑查看、管理、删除逐会话通知监控
07

连接与访问

  • 扫码登录、独立账号密码与登录有效期
  • 局域网、临时 HTTPS、自有服务器、NAS
  • 多入口并行、设备登录管理、IP 访问规则
08

阅读与个性化

  • 渐进加载历史,按需展开工具输出
  • 思考与执行过程开关,收起输入区
  • 主题、强调色、字号、阅读间距和中英文
09

桌面管理

  • 一键启停网关、管理连接与查看日志
  • 桌面添加账号,两端切换;账号旁查看额度与重置卡
  • Mac / Windows 应用内升级;Ubuntu 实验性安装包手动升级

能力沿用原 Codex 会话与主机配置。复杂 MCP 表单及部分特殊确认仍需在桌面处理;云聊天和 SSH 文件下载尚未接入。

04 / THE INTERFACE

看得清,也操作得顺手。

界面按浏览器宽度适配。点击截图放大,了解 v1.3.0 的操作界面。

05 / CONNECTIONS

选一条适合你的连接方式。

多个入口可以同时启用,连接同一个电脑网关。

浏览器 手机 / 平板 / 电脑
同一局域网 同网可达的电脑地址
电脑网关 独立登录与内容同步
原 Codex App 本机 / SSH 执行
手机与电脑在同一可互访网络。

启动局域网访问,使用 App 显示的地址即可开始,无需额外域名。

扫码登录不会自动打通网络。固定 HTTPS 和 NAS 需要完成首次网络配置;使用期间保持电脑唤醒、原 Codex App 与网关运行。

06 / DOWNLOAD

让手边的设备,接上工作。

v1.3.2 · 当前正式版

v1.3.2 新增网关启动与入口通知:每次启动发送已启用地址,临时入口变化后自动补发。

安装包内置网关运行时。按电脑的系统与芯片下载。

Mac 版未公证,首次打开可能需要手动允许;Windows 版未做证书签名。另提供完整 ZIP 与 Linux AppImage;Linux 需手动升级,Windows ARM 暂无专用安装包。

所有版本与 SHA-256 校验文件 ↗

Mac / Windows 已安装 v1.1.0–v1.2.2?可在桌面 App 的“应用更新”中升级,然后刷新网页。原有设置会保留。

访问端需要登录同一个 OpenAI 账号吗?

不需要。网关使用独立登录;模型调用仍沿用原 Codex 会话的提供商和认证。官方登录、API 或自定义服务需先在原 App 中正常工作。

手机、平板和另一台电脑都能用吗?

可以使用主流现代浏览器访问可达的网关地址。执行端 App 提供 macOS、Windows 和实验性 Ubuntu x64/ARM64 安装包;访问端不必使用相同系统。

关闭电脑后还能继续吗?

不能。电脑需保持唤醒、联网,并运行原 Codex App 和网关。SSH 任务还需要对应主机与连接可用。

怎样开启聊天通知?

在电脑 App 配置并测试 Bark 或 ntfy,再到网页聊天中开启“提醒”。可单独开启完成通知;即使关闭网页,在线网关仍会监听已关注聊天。

怎样切换账号或 API 接入?

升级至 v1.3.0 并刷新网页,在 Bridge 桌面端“账号与接入”添加或导入配置,然后在桌面端或网页切换。先结束运行中的任务;切换会重启 Codex,Bridge 网关保持在线。

Mac 提示无法验证开发者或“已损坏”怎么办?

先核对 Release 的 SHA-256,再尝试从“系统设置 → 隐私与安全性”允许打开。详细步骤见使用说明中的首次打开章节。

哪些请求仍需要桌面处理?

复杂 MCP 表单、身份验证挑战和部分特殊请求仍需在桌面处理。当前适配 Codex App,其他 Agent App、云聊天及 SSH 文件下载尚未接入。

怎样更新、查看更完整的使用说明?

在“应用更新”检查版本并按提示更新。旧版更新失败时,可手动安装新包并保留原数据目录。网络、登录、通知及兼容性说明见项目 README。

如果它让你的 Codex 使用更方便

欢迎在 GitHub 点一个 ⭐ Star,让更多需要跨设备使用 Codex 的人发现这个项目。也欢迎通过 Issue 分享使用体验和改进建议。