Codex Remote 怎么连接远程电脑？手机控制、SSH Host 与 Handoff 安全指南

先说结论：先决定连接电脑，还是连接 SSH 项目

如果项目、浏览器登录状态和桌面工具都在日常电脑上，可把这台 Mac 或 Windows 电脑作为 Remote 主机，再从 iOS、Android 或另一台受支持设备接入。如果代码本来就在服务器或远程开发机上，则在桌面应用中添加 SSH Host 更合适。

两种方式都不会绕过目标环境的权限。仓库文件、Shell、MCP、Skills、浏览器、Computer Use、沙箱和审批设置来自连接的主机；远程端只是发送提示、批准操作并查看结果。

本站为第三方中文信息与服务入口，并非 OpenAI 官方。Remote、Codex 和桌面应用能力可能分批开放，请以 ChatGPT Learn 官方文档、账号工作区权限和应用实时界面为准。

一、Remote 实际能做什么

连接后可以在主机项目中创建或继续聊天、追加指令、回答 Codex 的问题、批准命令，查看输出、代码差异、测试结果、终端输出和截图，并在已连接主机之间切换。

它最适合“任务在一台机器上执行，人从另一台设备查看和指挥”的场景。例如电脑运行测试时用手机查看进度，或在办公室主机上开始任务，稍后从另一台电脑继续。

二、手机连接前的必要条件

需要在目标 Mac 或 Windows 主机安装并运行最新版 ChatGPT 桌面应用，主机保持唤醒、联网，并与手机登录同一个 ChatGPT 账号和工作区。手机端也应更新到最新版 ChatGPT。

如果工作区要求 MFA、SSO 或 Passkey，配对过程中必须完成相应验证；受管理工作区还可能需要管理员先启用 Remote Control。仅安装 Codex CLI 或 IDE 扩展不能代替手机配对流程。

三、用二维码完成手机配对

在主机桌面应用进入 Settings > Connections > Control this Mac or PC，选择 Set up 或 Add，批准远程访问并完成验证。应用会显示二维码，用手机扫描后在 ChatGPT 中完成连接。

配对成功后，主机会出现在手机端 Codex 中；部分旧版界面可能仍显示 Remote。每台手机或受支持桌面设备都需要与每个目标主机分别配对，不能默认继承另一台设备的连接。

四、主机为什么必须保持在线

远程会话依赖目标主机实际提供文件和工具。电脑休眠、网络断开或桌面应用关闭后，Remote 会停止，直到主机重新可用。可在 Connections 中查看是否支持保持唤醒。

Windows 上涉及 Computer Use 的任务还需要前台会话保持可用。专用长任务可以考虑使用持续在线且权限受控的电脑，但不要为了方便把个人主机暴露在公共网络。

五、什么时候使用专用常在线主机

需要长时间构建、测试或批量处理时，专用 Mac 或 Windows 主机更稳定。应只安装任务需要的项目、凭据、MCP、Skills 和工具，并为它使用独立的低权限账号。

常在线不等于无限权限。仍应保留沙箱、命令审批和代码审查，限制生产密钥与客户数据，确保任务输出可以被复核和回滚。

六、配置 SSH Host 的四个步骤

第一，在运行桌面应用的电脑上把具体主机别名写入 ~/.ssh/config，例如 Host devbox，并配置 HostName、User 与 IdentityFile。Codex 会读取具体别名并交给 OpenSSH 解析，只写通配符的主机可能不会被发现。

第二，先在终端执行 ssh devbox，确认普通 SSH 已可登录。第三，在远程主机安装并登录 Codex，确保远程用户登录 Shell 的 PATH 中能找到 codex 命令。第四，在 Settings > Connections 中添加或启用该 SSH 主机，再选择远程项目目录。

七、为什么终端能用 codex，远程连接却找不到

桌面应用通过 SSH 启动远程 Codex app server，使用的是远程用户的登录 Shell。交互式终端里临时加载的 PATH、别名或版本管理器配置，不一定会出现在该登录 Shell 中。

先通过 ssh devbox 登录后执行 command -v codex 和 codex --version，再检查 Shell 初始化文件。基础环境安装可参考 https://gptupcn.com/blog/codex-local-environment-setup-scripts-actions-worktree-guide-20260928/ ，不要用 root 全局安装来掩盖普通用户 PATH 问题。

八、手机、桌面与 SSH 主机之间的关系

手机负责发送提示、批准操作和查看结果；桌面应用负责维持设备连接；SSH 主机负责提供远程仓库、Shell、依赖和算力。若项目位于 SSH 环境，手机仍先连接到已配置该环境的桌面主机。

因此排查时要分三段看：手机到桌面是否已配对，桌面应用是否在线，桌面到 SSH 主机是否能正常登录。只检查其中一段，很容易把网络问题误判为 Codex 故障。

九、Handoff 会转移哪些内容

Handoff 用于在本地电脑和已连接远程主机之间移动现有聊天及其 Git 状态。目标主机必须已连接，并为同一个 Git 仓库保存项目；若项目指向仓库子目录，两端应保存相同子目录。

执行 Handoff 后，Codex 会在目标主机创建或复用 worktree，转移聊天和 Git 状态，并把该聊天切换到目标主机。如果聊天正在运行，当前回复会先被中断再转移。

十、Handoff 不等于复制整台电脑

Git 状态能转移，不代表 .env、未跟踪大文件、系统依赖、数据库或本机凭据一定会跟随。远程项目仍需要自己的运行环境和安全配置，不能假设本地能跑的任务在远程必然能跑。

若遇到环境文件缺失，可参考 https://gptupcn.com/blog/codex-handoff-worktree-missing-env-files/ 。正确做法是用模板、密钥管理和可复现安装脚本重建环境，不要把真实密钥提交进 Git。

十一、远程连接的安全底线

SSH 主机应使用可信密钥、最小权限账号，并避免任何未认证的公共监听。官方明确提醒，不要把 app-server transport 直接暴露在共享或公共网络；需要跨网络访问时，使用 VPN 或 Mesh 网络，而不是开放服务端口。

Remote 仍遵守连接会话的沙箱、安全控制与动作审批。高风险操作应保留人工确认；生产环境建议把部署权限、读写权限和审计日志分开，避免一条远程任务同时拥有代码、密钥与生产写权限。

十二、常见故障的排查顺序

手机看不到主机：确认桌面应用正在运行、允许其他设备连接、两端为同一账号与工作区，并重新配对。退出 ChatGPT 后 Remote Control 会关闭，但已有设备配对不会自动删除，重新登录后需要再次打开。

会话断开：检查主机是否休眠、掉线或关闭应用。SSH 项目失败：依次验证 ssh 别名、密钥、远程 PATH、codex 版本和项目目录。批准请求不出现：重新扫描二维码，并确认组织管理员已允许 Remote Control。

十三、上线前检查清单

确认两端账号和工作区一致；主机保持在线且应用最新；配对设备清单没有陌生设备；SSH 使用独立密钥与低权限用户；登录 Shell 能找到 codex；项目路径匹配正确仓库；Handoff 前提交或备份重要改动。

同时确认没有公开暴露 app server，没有把密码、Token 或私钥写入仓库；远程任务仍需审批和测试；任务结束后检查 diff、测试结果与运行日志，再决定是否合并或部署。

结语

Codex Remote 的核心不是“远程桌面”，而是让受信设备访问指定主机上的项目、工具与权限。先把手机到桌面、桌面到 SSH、项目到 worktree 三层关系理清，连接和排错都会更直接。

更多 Codex 中文实践可从 https://gptupcn.com/ 的技术博客进入。请始终遵循最小权限、可信密钥、VPN 或 Mesh 网络、人工复核与可回滚流程。