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

开源 · 自托管 · v2.2.0 正式版

你的工作台,
不止在电脑前。

Codex、Claude Desktop、DeepSeek Harness、ZCode 各司其职,你在手机上接着聊、查文件、看 Git、用终端。浏览器随开随用,Android 与 iOS App 随身接力。

代码开源,欢迎共建。觉得有用,欢迎前往 GitHub 点个 Star,也欢迎反馈问题、贡献代码。

任务仍在你的电脑或 SSH 主机上执行,执行端需保持在线。

2.2STABLE

从远程聊天,
到随身工作台。

WebAndroidiOS

01 / TRY IT

拿起这台手机,试试看。

不必安装,先走一遍你的工作流程。点击设备里的按钮,也可以直接选择下方场景。

模拟交互 · 无需登录
MOBILE WORKSPACE

    iOS APP · V2.0.0
    直接体验

    工作台与电脑网关使用 v2.0.0 产品界面和示例数据,手机首页为浏览器模拟。聊天回复、客户端状态、终端输出和 Git 操作均在本页模拟;不连接电脑、不调用模型、不读取或上传你的文件,刷新即重置。

    FOUR CLIENTS / ONE BRIDGE

    四个应用,各自继续自己的工作。

    扫描电脑中已安装的客户端,只启用需要的应用。底部切换或左右滑动聊天列表,各自的会话与项目互不混淆。

    Codex

    Codex

    继续本机与 SSH 会话,保留模型、Skill、权限、计划和目标操作。官方账号与兼容 API 沿用原桌面工作环境。

    Claude

    Claude Desktop

    Code 与 Cowork 分组展示,继续消息并回应支持的授权。自动接入支持 macOS、Windows;首次连接可能需要解锁电脑完成准备。

    DeepSeek Harness

    DeepSeek Harness

    通过兼容的 Harness 插件接入,沿用账号与工作目录。查看模型、推理选项与客户端提供的额度;手机 App 也可打开独立的 DSH 原生 Mobile 页面。

    ZCode

    ZCode

    继续原生聊天、发送附件和处理审批,选择模型与 Skill,管理 API 与客户端提供的额度。支持 macOS、Windows、Linux 本地连接,也可使用已配置的官方远控。

    02 / THE WORKBENCH

    不只是把聊天装进手机。

    聊天、文件与工具连成完整工作台。手机 Web、Android、iOS 和电脑浏览器共用会话,按屏幕宽度呈现。

    01 / FILES

    文件跟着项目走。

    浏览项目目录,将电脑上的文件或文件夹直接引用到消息,无需先下载到手机。预览 Markdown、源码与图片;Claude、DSH 历史图片按需加载,代码块支持语法高亮与原文复制。

    聊天下载上限可即时调整;文件标签页的主动下载不受此上限限制。

    02 / TERMINAL

    不是单次命令,是连续终端。

    保留 cd 后的目录、环境变量和交互状态。采用用户实际登录 shell:macOS 通常为 zsh,Linux 通常为 bash,Windows 使用 COMSPEC。手机换行用于编写,点击发送才执行。

    切换标签保留会话,关闭终端标签结束会话。

    03 / GIT

    看见变更,也能完成提交。

    从增删差异到历史链路,在手机上审阅并暂存文件、填写提交说明。支持创建或切换本地分支、本地合并与中止合并。

    不提供远程推送、历史重写或强制丢弃。

    04 / SIDE CHAT

    Codex 侧边聊天,另开一条思路。

    按 Codex 原生父子关系,将已有侧边聊天放回主会话的子标签中。继续消息、切换可用模型并处理支持的请求;关闭标签保留原生聊天。

    可用操作取决于原生客户端和接入能力;下方演示保留 v2.0.0 的交互示意。

    05 / SPLIT VIEW

    宽屏,真正用起来。

    主聊天在左,文件、Git、终端或侧边聊天在右。拖动标签开启分屏,拖动分隔条调整比例;详情窗口可调节高度。窄屏和手机保持单栏。

    会话区域宽度至少 720 px 时提供分屏;以实际可用空间为准。

    06 / SUBAGENTS

    Codex 子智能体,进度看得见。

    在任务树里查看当前会话派生的子智能体,展开最近已保存的输入、回复和工具记录,不必离开主聊天。

    当前为只读记录,不提供创建、发消息或停止子智能体。

    看看 v2.0.0 的分屏界面
    真实 Web 界面 · 示例数据;上方可点击设备为交互示意。

    03 / MADE FOR YOUR PHONE

    一个 App,接上你的几台电脑。

    扫码保存 Mac、Windows 或 Ubuntu 网关,回到电脑列表随时切换。应用图标显示未读角标,点击直达对应应用。

    01

    连接与登录

    同一电脑的局域网、固定 HTTPS 和临时 HTTPS 汇入一张卡片,查看延迟、手动选择或自动切换信道,保留聊天、草稿和阅读位置。电脑端可撤销设备。

    02

    真正顺手的操作

    长按、右键或点击聊天标题打开会话菜单,查看详情、改名、置顶和整理项目。按客户端能力操作原生会话;仅在 Bridge 中生效的分类会明确标注。

    03

    完整的输入区

    新建聊天前即可选择模型和思考强度,创建后保留选择。聊天中使用 Skill、权限、附件和支持的工作模式;Codex 异步问题可逐题跳过,保留其他未提交答案。

    04

    外观、语言与更新

    中英文界面切换,聊天内容保持原样。手机设置可选浅色、深色或跟随系统;Android 当前应用于原生设置页,聊天页可单独调整外观。支持手动检查 App 更新。

    下载手机 App ↗Android APK · iOS IPA(需自行签名)

    STAY IN THE LOOP

    收到提醒,也知道它的边界。

    Android 可开启后台任务通知,默认关闭;不同事件分别保留,同一聊天的待确认与完成提醒互不覆盖。按连接选择通知来源,减少重复提醒。iOS 支持前台提醒,也可配置 Bark、ntfy 或 PushPlus。

    iOS 灵动岛与锁屏实时活动

    查看执行、待回应和连接状态,点击回到聊天。不显示聊天正文;App 不活跃时可能显示最后已知状态。

    iOS 后台或锁屏通知仍不保证送达,灵动岛不等于后台推送;Android 后台通知受系统权限与省电策略影响。

    04 / GET THE APPS

    准备好,把演示变成你的工作台。

    v2.2.0 正式版 · 网关与手机 App 配套更新

    01

    先安装电脑网关

    macOS、Windows,以及实验性 Ubuntu x64 / ARM64。Web 工作台由网关提供,浏览器打开地址即可。

    电脑端下载 ↗
    02

    Android

    覆盖安装 APK 以保留已保存的电脑。支持应用内更新,可选择手机下载或电脑下载;升级后可在设置中按需开启后台通知。

    下载 Android APK ↗

    手机 App 请搭配 v2.2.0 网关使用。升级前保留配置备份,相同端口只运行一个网关;iOS 仍需使用自己的 Apple 账号签名安装。

    基础操作录像 · v1.3.0 界面(展开观看)

    01 / WALKTHROUGH

    先看看,它是怎么用的。

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

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

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

    02 / GET STARTED

    四步,接上已有工作。

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

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

      下载并打开 App

      在电脑安装并登录需要的客户端,再打开对应系统的 Codex Mobile Bridge。

    2. 2

      启动网关

      在“客户端与接入”扫描并选择应用;保留局域网访问,保存后启动网关。

    3. 3

      扫码或打开地址

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

    4. 4

      选择聊天,继续交互

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

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

    ACCOUNTS & PROVIDERS

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

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

    03 / CAPABILITIES

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

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

    Codex 的成熟工作流继续保留,Claude 与 DeepSeek 按各自客户端能力提供对应操作。

    01

    会话与项目

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

    任务操作与确认

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

    计划与目标

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

    文件与内容

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

    模型与技能

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

    状态与通知

    • 按应用汇总待处理和完成通知,支持 Bark / ntfy / PushPlus
    • 运行、待回应、完成未读标识;电脑列表显示应用通知角标
    • 电脑查看、管理、删除逐会话通知监控
    07

    连接与访问

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

    阅读与个性化

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

    桌面管理

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

    能力沿用原客户端与主机配置。计划、目标、Skill、侧边聊天等支持范围随客户端而异;复杂 MCP 表单及部分特殊确认仍需桌面处理,云聊天尚未接入。

    展开看看 v2.0.0 的手机界面

    04 / THE INTERFACE

    看得清,也操作得顺手。

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

    05 / CONNECTIONS

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

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

    按实际网络选择局域网、临时 HTTPS 或固定入口。v2.0.0 新增 Tailscale 固定 HTTPS,也支持自有服务器与 SSH。

    推荐个人快速接入:无需域名和服务器,配置最少、上手最快。网关与隧道进程持续运行且连接正常时,通常可以沿用当前地址;Cloudflare 不保证永久占用或持续可用。隧道重建导致地址变化后,启用“每次启动网关及入口变化时发送地址”并配置好通知渠道,即可接收新地址;送达时间取决于网络与通知服务。

    进阶方案需要具备 DNS、HTTPS、SSH、服务器或 NAS 管理等相关知识。本文命令与配置仅供参考,不保证适合你的环境;执行前请自行核对、备份并取得必要授权。使用、修改或执行这些示例的风险由使用者自行承担。在适用法律允许的最大范围内,项目作者与贡献者不对由此造成的数据丢失、服务中断、安全事件、费用或其他损失承担责任;依法不得排除或限制的责任除外。

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

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

    局域网配置图解 →

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

    06 / DOWNLOAD

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

    v2.2.0 · 正式版

    v2.2.0 新增 ZCode 接入、多信道切换与原生侧边聊天,支持新建时选择模型,完善会话管理、通知与连接恢复,优化空闲能耗。

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

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

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

    建议网关与手机 App 一起更新到 v2.2.0,再重新加载网页。Android 支持应用内更新或覆盖安装 APK;iOS 仍需自行签名,Ubuntu 使用安装包手动升级。

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

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

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

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

    关闭电脑后还能继续吗?

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

    怎样开启聊天通知?

    手机可按设置接收请求与完成提醒,电脑列表显示各应用未处理数量。Android 后台通知需手动开启,默认关闭,并受系统权限与省电策略影响;iOS 以前台同步为主。可按连接选择通知来源,也可配置 Bark、ntfy 或 PushPlus。

    怎样切换账号或 API 接入?

    使用当前正式版并刷新网页,在 Bridge 桌面端“账号与接入”添加或导入配置,然后在桌面端或网页切换。先结束运行中的任务;切换会重启 Codex,Bridge 网关保持在线。

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

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

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

    复杂 MCP 表单、身份验证挑战和部分特殊请求仍需桌面处理。Claude 支持 Code 与 Cowork,普通 Chat 暂不支持;自动接入支持 macOS / Windows,首次初始化可能需要解锁与系统授权。Linux 仍为实验性支持。

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

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

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

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