远程连接

使用 Remote 访问已连接电脑上的工作,或通过 SSH 将 ChatGPT 桌面 App 连接到项目

远程连接让你访问运行在另一台设备或机器上的工作。在 ChatGPT 移动 App 中打开 Remote,可以处理已连接 Mac 或 Windows 设备上的 ChatGPT Work 或 Codex 任务。你也可以从另一台运行 ChatGPT 桌面 App 的受支持设备继续工作,或让桌面 App 连接 SSH 主机上的项目。

远程访问会使用已连接主机上的项目、任务、文件、凭据、权限、插件、Computer Use、浏览器设置和本地工具。

可以远程完成什么

  • 在主机项目中开始新任务,或继续现有任务。
  • 发送后续指令、回答问题并引导进行中的工作。
  • 批准命令和其他操作。
  • 评审输出、diff、测试结果、终端输出和截图。
  • 在 ChatGPT 完成任务或需要你关注时接收通知。
  • 在已连接主机和任务之间切换。

下面介绍如何在 ChatGPT 移动 App 中打开 Remote 并访问桌面主机。要把 Codex 连接到 SSH 主机上的项目,请参阅连接 SSH 主机

ChatGPT 移动 App 中的 Remote 设置页面(浅色模式)

设置 Remote 前

请准备:

  • 目标 ChatGPT 账户和工作区中的 Codex 访问权限。
  • iOS 或 Android 设备上的最新版 ChatGPT 移动 App。如果没有 Remote,请先更新 ChatGPT。
  • 在主机上运行的最新版 macOS 或 Windows 版 ChatGPT 桌面 App。主机需要保持唤醒、联网,并登录同一账户和工作区。移动端设置必须从桌面 App 开始,不能从 Codex CLI 或 IDE 扩展设置。
  • 该账户或工作区要求的多重身份验证、SSO 或 passkey 配置。

如果通过 ChatGPT 工作区使用 Codex,管理员可能需要先启用 Remote Control 访问权限,手机才能连接。

设置 Remote

从要连接的主机上的 ChatGPT 桌面 App 开始。设置流程会为该主机启用远程访问,并显示可由手机扫描的 QR code。QR code 会将手机与主机配对;每台手机或受支持的桌面 App 设备,都需要分别与要控制的主机配对。

  1. 启动 Remote 设置

    在主机应用侧边栏选择 Set up Remote(设置 Remote)

  2. 扫描 QR code

    用手机扫描 App 显示的 QR code。它会打开 ChatGPT,以完成移动 App 与主机的连接。

  3. 在 ChatGPT 中完成设置

    ChatGPT 会打开 Remote 设置流程。确认使用同一 ChatGPT 账户和工作区,再完成所需的多重身份验证、SSO 或 passkey。成功后,主机会出现在手机的 Remote 中。

  4. 检查主机设置

    在主机应用中打开 Settings > Connections(设置 > 连接),管理已连接设备。还可以选择是否让电脑保持唤醒、启用 Computer Use,或安装 Chrome 扩展。

选择要连接的设备

先连接日常使用 ChatGPT 的笔记本或台式机。需要持续访问或不同环境时,再添加常开电脑或 SSH 主机。

笔记本或台式机

连接已安装桌面 App 的 Mac 或 Windows PC,即可远程访问日常使用的相同项目、任务、凭据、插件和本地设置。

电脑休眠、失去网络或关闭应用后,远程访问会停止,直到它重新可用。如果把日常电脑作为主机,请连接电源,并在主机连接设置中启用保持唤醒(如果可用)。

Mac 笔记本在打开屏幕并连接电源时可以保持远程访问;合上屏幕后还需要连接外部显示器。选择 Sleep(睡眠) 仍会停止远程访问。

Windows 主机上的任务需要 Computer Use 时,请保持会话解锁并可用。Windows 的 Computer Use 在前台运行,因此更适合通过 Remote 启动或检查工作,同时把主机桌面专门留给该任务。

专用常开电脑

希望 ChatGPT 在长时间工作中始终可访问时,可以使用专用常开 Mac 或 Windows PC。

请在该机器上安装 ChatGPT 需要使用的项目、凭据、MCP server、技能和工具。

远程开发环境

如果项目已经位于远程环境,请使用 SSH 主机或受管理远程开发环境。先把桌面 App 主机连接到该环境;手机仍连接同一台桌面主机,而 ChatGPT 会在远程环境中使用它的依赖、安全策略和计算资源。

SSH 设置详情见连接 SSH 主机

已连接主机提供什么

手机向 ChatGPT 发送提示词、审批和后续消息;已连接主机提供 ChatGPT 实际使用的环境。这意味着:

  • 仓库文件和本地文档来自已连接主机。
  • Shell 命令运行在该主机或远程环境上。
  • MCP server、技能、浏览器访问和 Computer Use 来自主机配置。
  • 只有主机本身能够访问时,才可使用已登录网站和桌面 App。
  • 沙箱设置、安全控制和操作审批仍适用于远程会话。

安全中继层让可信机器可以在已授权 ChatGPT 设备之间保持可访问,而无需直接暴露到公共互联网。

从另一台设备继续工作

你可以从另一台已登录、运行 ChatGPT 桌面 App 并支持远程控制的设备继续工作。例如,笔记本不可用时,可以从手机在常开主机上开始任务;之后再在笔记本中打开 App 并继续同一任务。

功能可用时,在 Mac 或 Windows 设备上打开 Settings > Connections > Control other devices(设置 > 连接 > 控制其他设备) 添加其他主机。同一台设备可以同时允许其他设备远程访问,也可以控制另一台设备。

连接 SSH 主机

在 ChatGPT 桌面 App 中,可以添加 SSH 主机上的远程项目,并针对远程文件系统和 shell 运行任务。远程项目任务会在远程主机上运行命令、读取文件并写入改动。

请按照正常 SSH 访问的安全标准配置远程主机:使用可信 key、最小权限账户,并避免未经认证的公共监听器。

  1. 把主机加入 SSH config,以便 Codex 自动发现。

    Host devbox
      HostName devbox.example.com
      User you
      IdentityFile ~/.ssh/id_ed25519

    Codex 从 ~/.ssh/config 读取具体主机别名,通过 OpenSSH 解析,并忽略只使用通配模式的主机。

  2. 确认运行桌面 App 的机器可以通过 SSH 连接该主机。

    ssh devbox
  3. 在远程主机上安装并认证 Codex。

    桌面 App 通过 SSH 启动远程 Codex app-server,并使用远程用户的登录 shell。请确认 codex 命令在该 shell 的远程 PATH 中可用。

  4. 在应用中打开 Settings > Connections,添加或启用 SSH 主机,再选择远程项目文件夹。

在主机之间交接任务

Handoff 会在本地电脑和已连接远程主机之间移动现有任务及其 Git 状态。可以先在本地开始,再到远程电脑的工作树继续,最后把任务带回来。

交接前,请连接目标主机,并在该主机上保存同一 Git 仓库的项目。如果项目是仓库子目录,两台主机必须保存相同子目录。Codex 只会显示具有匹配已保存项目的目标。

交接任务:

  1. 在桌面 App 中打开任务。
  2. 在任务底部选择当前运行位置,再选择目标主机。要把远程任务交回本地,请选择 This computer(这台电脑)
  3. 检查目标和分支,再选择 Hand off

Codex 会在目标主机创建或复用工作树、传输任务和 Git 状态,并把任务切换到该主机。任务仍在运行时,Handoff 会先中断当前回复,再执行传输。

也可以在另一个任务中,让 Codex 把指定任务交接给已连接主机。Codex 不能交接正在发出该请求的任务,也不支持交接到 Codex 云端环境。

认证与网络暴露

远程连接通过 SSH 启动和管理远程 Codex app-server。不要直接在共享或公共网络中暴露 app-server 传输端点。

需要从当前网络之外访问远程机器时,请使用 VPN 或 mesh 网络工具,不要把 app-server 直接暴露到互联网。

故障排查

手机上看不到主机

确认主机正在运行桌面 App、已启用 Allow other devices to connect(允许其他设备连接),并且两台设备使用同一 ChatGPT 账户和工作区。如果该连接自 2026 年 6 月 8 日以来没有使用过,请更新两端应用并重新配对。

重新登录后 Remote Control 关闭

退出 ChatGPT 会关闭 Remote Control,但不会删除已有设备配对。重新登录后,再次启用 Remote Control 即可恢复之前的连接状态。

如果打开 Remote Control 并选择 Add 后出现错误,请重启主机上的 ChatGPT 桌面 App 再重试。

审批请求没有出现

在 ChatGPT 移动 App 中打开 Remote。确认手机与主机使用相同的 ChatGPT 账户和工作区,然后重新扫描 QR code,或从主机重新开始设置。如果使用 ChatGPT 工作区,请让管理员确认已启用 Remote Control。

远程会话断开

检查主机是否休眠、断网或关闭了应用。ChatGPT 工作期间应让主机保持唤醒和联网。

认证阻止设置

完成设置过程中显示的账户或工作区认证。如果组织要求 SSO、多重身份验证或 passkey,请先完成对应流程。仍然失败时,请让工作区管理员确认 Remote Control 已启用。

另请参阅