故障处理

Codex 手机配对成功仍离线?主机状态、连接阶段与会话验证

Codex 手机扫码和授权成功,主机却仍显示 Offline、Connecting 或超时?先核对两端账号、工作空间与主机状态,再区分配对、实时连接、正确会话和任务结果,用非敏感小样例验证,避免反复删设备和重装。

二维码扫过了,电脑也列出了手机,手机端却一直显示 Offline,或停在 Connecting。先别删除设备、清缓存或反复重装。配对、实时连接、打开正确会话、任务完成是四个不同的检查点;前一步通过,不能替后一步作证。

本文处理 Codex 手机配对成功仍离线、扫码后连不上主机,以及 codex mobile host offline after pairing。目标是定位失败阶段,恢复后验证连到的是预期电脑和聊天;无法恢复时,整理足够明确的证据交支持,不承诺一组操作能修好所有版本。

先按现象找到下一步

当前现象 先检查什么
扫码后没有批准界面,手机找不到电脑 第 1、3 步:入口、账号/工作空间、认证与配对是否完成
电脑列出了手机,手机仍显示 Offline 第 2、3 步:目标主机、控制开关、唤醒和应用状态
能选电脑,但 Connecting 后超时或报错 第 4 步:连接阶段的原始错误和一次有条件的对照
已在线,打开的却是另一台电脑或另一聊天 第 5 步:主机、项目与当前聊天逐项核对
聊天能打开,但任务没产出或结果不对 第 6 步:实际执行、返回与产物分别验收

1. 确认用的是主机远程连接,记录两端现场

适用条件: 还没分清故障属于哪个入口,或照着旧版教程操作。

当前手机说明区分两条路线:选择 Cloud 和已发布环境,或选择已连接的电脑和项目。本文讲后者。手机发送指令和批准,文件、命令、权限及本地工具来自连接的主机,不会自动变成手机上的运行环境。

当前官方支持 macOS、Windows 主机,以及 iOS、Android 手机端,实际入口受版本、工作空间设置和分批开放影响。在 ChatGPT iOS 应用中打开 Codex;仍显示旧名称 Remote 的版本使用该入口。不要因为手机没有某个菜单就直接判为账号损坏。

先分别记录:

  • 手机和桌面应用的实际版本、系统,以及你打开的 Codex/Remote 入口。桌面应用从自身的 About/关于入口查看版本;codex --version 是 CLI 版本,不能代替桌面应用版本。
  • 两端是否使用同一个 ChatGPT 账号、同一个工作空间。只核对,不为测试切换认证方式或退出账号。
  • 手机选中的电脑、电脑端的设备列表和当前控制状态;错误原文、发生时间及所用时区。主机显示名只用于辅助核对,同名不证明同一个配对实例。

预期结果: 能明确“哪个手机,连接哪台主机,在什么阶段失败”。资料缺失先补齐,不混用另一工作空间或另一台电脑的结果。

ChatGPT Work 的 Local computer access with Work Cloud 是另一套功能;当前官方明确它不改变 Codex 手机连接主机的方式。云端任务在电脑睡眠时仍可能运行,不代表这台本地主机此时可被远程访问。

2. 已配对但离线:先检查主机是否具备连接条件

适用条件: 配对列表有设备,或手机能看到电脑,但仍显示离线。

在你要连接的那台电脑上逐项检查,不只看手机列表:

检查项 如何核对与处理
桌面应用 确认应用仍在运行、已登录预期账号和工作空间;不要仅凭菜单栏图标或进程名判定连接正常
主机状态 确认电脑醒着、联网,未主动进入 Sleep;恢复后等待应用正常显示,再从手机重试一次
控制状态 按当前界面查看 Settings → Connections 中允许其他设备连接/Remote Control 的状态;受组织限制时交管理员核对
Mac 笔记本 官方说明接电、开盖可保持远程可用;合盖还需外接显示器。即使选了保持唤醒,主动 Sleep 仍会停止远程访问
Windows Computer Use 涉及桌面操作时,Windows 会话还需保持解锁;这不是所有普通代码任务都必须解锁的统一条件

只恢复你本来需要且获准使用的主机连接条件。不把关闭锁屏保护、长期关闭休眠或启用 Computer Use 当所有离线问题的默认修复;纯文件小测试不需要因此新增浏览器或桌面操作能力。

预期结果: 主机满足当前官方要求,再检查手机是否真正连上。即使上述项全部符合,也只能说明运行条件已核对,不能宣布根因已找到;仍离线就进入第 3、4 步。

3. 核实配对和批准,别把旧记录当新连接

适用条件: 扫码没有完成安全设置、批准请求不出现,或重新登录后突然离线。

官方当前配对流程从主机桌面应用的 Settings → Connections → Control this Mac or PC → Set up/Add 开始,再由手机扫码、核对账号与工作空间,并完成所需认证。每部手机与每台目标主机分别配对;不能从 Codex CLI 或 IDE 扩展发起这套手机设置流程。界面可能使用本地化名称,以当前版本实际显示为准。

按情况处理:

  1. 没有批准或认证没有完成: 在手机打开 Codex/旧 Remote,核对两端账号与工作空间。按正常设置流程完成要求的 MFA、SSO 或 passkey;组织控制未开放时让管理员确认,不绕过验证。
  2. 退出账号再登录后不能连接: 官方说明退出会关闭 Remote Control,但保留已有配对。先核控制状态,按获准的正常入口恢复;不要把“重新登录”误当已经清除了旧配对。
  3. 确实需要重新配对: 按当前官方适用条件从正常界面操作。官方另说明,2026 年 6 月 8 日以来使用过的既有连接可保留,早于该时间且未再使用的旧连接需更新两端并重新配对。不要把这一历史边界套到所有新故障。

预期结果: 两端能核对本次配对和批准状态。设备出现在列表里,只提供配对阶段的证据;还要从手机选择目标主机,验证实时连接。

若启用 Remote Control 后选择 Add 报错,官方建议重启主机上的桌面应用再试。先保存工作、确认不会打断重要任务,通过正常应用入口重启;不强杀未知进程,不循环重装。仍回到旧离线页、找不到某个“忘记主机”入口或安全设置继续失败,记录所见状态转支持,不自行删除设备数据库、凭据或缓存,也不编造所有版本都有的删除入口。

4. 已配对却一直 Connecting:记录连接失败,而非猜原因

适用条件: 扫码、批准已经有证据,但选择主机后仍 Connecting、TimedOut 或 Errored。

保留这一轮的错误原文和时间,确认第 1、2 步的对象及运行条件仍相同。若先前未更新,按两端各自正常渠道检查可用更新;“本机没有更新”不证明另一端版本也一致。版本入口不明时见更新后版本没变排查。

需要网络对照时,只在组织允许的网络中进行一次有记录的比较:保持同一账号、目标主机和操作,写清改变的是手机网络还是主机网络,以及两次状态。不要为测试关 TLS 校验、防火墙或组织代理,也不要开放 app-server 端口到公网。

预期结果: 缩小到“这次、这些条件下在哪个阶段失败”。换网成功不证明唯一根因;换网仍失败也不排除所有网络因素。普通网页可打开、TCP/TLS 可达或设备列表可加载,都不能单独证明远程会话通道可用。错误提到 WebSocket 就保留原文,不把某个旧版本端点或超时秒数写成全部客户端的契约。

仍失败时停止整套重复配对,按末尾清单走私密支持。过去的 issue 里有人重装、重启后仍离线,只能说明那些个案没有解决;既不证明当前所有版本都坏,也不证明这些操作永远无效。

5. 已在线:确认打开的是正确主机、项目和聊天

适用条件: 手机显示在线,能打开聊天,但还不能确认执行位置,或者看到了旧消息。

先核对手机选择的主机和项目,再打开预期聊天,对照桌面端的同一聊天。标题可以重名;用你刚写的非敏感临时标记、当前任务内容和可见运行位置辅助核对,不仅凭“列表中有同名聊天”。查看历史记录也不证明这一轮实时消息已送达。

有条件时,用下面的小测试继续验证。它会使用账号任务额度,仅在你愿意进行一次最小任务时使用:

  1. 在目标电脑的仓库外建立一个新的空测试目录,用编辑器新建 remote-check.txt。写入两行:check_id=本次新建的非敏感唯一标记 和 value=37。标记不要沿用公开例子的答案,也不要先粘进聊天;保留文件原件。
  2. 通过本版本的正常项目入口选择该目录,从手机在该主机、该测试项目新建专用测试聊天,或使用你已确认属于该目录的测试聊天。不要给正在运行的业务聊天插入探针。
  3. 发送下面的请求;如果缺权限或不支持这个入口,就记录实际提示,不扩大权限来制造成功。
只检查当前测试目录的 remote-check.txt,不修改任何文件。
请实际读取文件,返回文件名、check_id 和 value,并说明本次读取的依据。
不要联网或调用外部业务工具;缺少文件或权限就报告原始错误,不猜内容。

独立目录只隔离样例文件,仍可能加载全局规则、hooks 和工具。已有全局业务流程时使用获准的测试环境;这段请求不建立安全沙箱。无需复制凭据、另开端口或关闭原有保护。

预期结果: 手机请求出现在桌面端对应聊天,本轮读取记录指向预期测试文件,返回标记和值与目标电脑原件相同。如果手机选错电脑或同名目录,可能读到另一份 remote-check.txt;只返回 37 不够,要核本次标记和实际读取证据。

如果看不到本轮读取记录,或答案本来已在聊天中出现,就把读取验证记为未确认。能复述正确答案不能单独证明读取过文件。历史聊天找不到时另看resume 与会话查找,不要用恢复历史代替主机连接检查。

6. 会话可用后,再验证任务是否真正完成

适用条件: 消息能收发,开始检查小测试或原任务的交付。

取得的结果 能确认什么
桌面端收到手机这一轮请求 消息到达了对应聊天;不代表命令已执行
有本轮实际读取记录,标记和值与原件一致 这个小读取任务通过;不证明其他项目、工具或业务任务也能完成
有回复但标记不符、文件缺失或权限失败 分别核执行位置、文件路径或实际权限;不能宣布验收通过
只显示回合结束或收到提醒 检查实际返回和产物;不等于原任务已完成

测试后重新打开样例文件,确认未改变;需要严格确认字节时保存前后 SHA256 再比较。真实代码任务还需核对实际文件、diff 和相关测试;提交、推送、PR 也要各自确认,见推送与 PR 交付验证。

若会话已连通但任务在等输入、审批或已报错,按任务状态与继续执行处理。若只是没收到提醒,看完成通知的触发验证;若失败发生在任务命令的 DNS/代理请求,看任务联网排查。这些问题不自动等于手机配对失败。

仍失败时,提交哪些信息

整理两端系统与应用版本、Codex/Remote 入口、账号与工作空间是否一致、失败阶段、发生时间及时区、脱敏错误、主机当时是否醒着联网且应用运行,以及已做的对照及结果。没有对应版本字段就写未知,不用 CLI 版本补填桌面版本。

通过官方私密支持渠道提交必要材料;截图先遮住二维码、配对码、设备与主机身份、账号信息和私有聊天,日志只保留相关的脱敏片段。不公开凭据、完整日志或配置,不为收集材料触发真实业务任务。支持调查不保证能立即恢复连接。

本次核验范围

本文于 2026-10-23 重新读取官方 Remote connections 和 Codex on mobile 全文。所列设置路径和两端界面名称来自当日官方说明。当前自动化工具不允许操作本机 Codex 原生应用,本次未能实查 Connections 设置页,也没有实测手机扫码、配对、在线状态、重新连接或真实消息送达。 Windows、Android、iOS、SSH 与不同工作空间的实际界面差异均未逐端验证,不把官方示意图或用户原帖当作本站实测截图。

隔离目录仅验证虚构文件的创建、读取、前后哈希,以及同名文件但不同标记、正确数值却错误标记等验收边界;人工构造的阶段记录用于检查“配对不等于连接、会话不等于完成”的判断方法,不是远程连接实测,也不代表 Codex 事件格式。未调用真实模型、改变用户远程访问设置或删除任何配对。

最终记录应分别写明:配对是否确认、连接是否确认、是否进入正确会话、任务结果是否核对。未知项保留未知,不用“配对成功”代替全部通过。

社区讨论

补充你的经验或问题

评论由 GitHub Discussions 承载;参与讨论需要登录 GitHub。