跳到正文

Codex Remote：从手机启动、引导和审阅编码任务

用手机遥控一台已连接的 Mac 或 PC 上的 Codex：设置流程、四项核心能力、主机该选哪一台、任务如何在主机之间交接，以及断连时怎么排查。

当前有效最后核验

适用平台

  • ChatGPT 手机应用（iOS / Android）
  • 已连接的 macOS 或 Windows 主机

官方文档怎么说

  • Codex Remote 让你从手机跟进进度、批准操作、发送指令；Codex 在你已连接的电脑上运行每个任务。

    Codex Remote

  • 使用方式是 ChatGPT 手机应用配合一台已连接的 Mac 或 Windows PC；可用性取决于灰度和你的工作区设置。

    Codex Remote

  • 四项核心能力分别是：从手机启动任务、在任务进行中引导工作、批准请求的操作、审阅结果。

    Codex Remote

  • 设置流程为在电脑上打开 ChatGPT 桌面应用，进入 Settings > Connections > Control this Mac or PC，选择 Set up 或 Add，批准远程访问并完成要求的验证。

    Codex Remote

  • 官方提醒只连接你拥有且信任的设备，并在开始工作后保持电脑唤醒并联网。

    Codex Remote

  • 你的连接电脑在你所在组织的安全策略下运行这些工作。

    Codex Remote

  • 二维码把那一部手机与那一台主机配对；每一部手机或受支持的桌面应用设备，都要与它要控制的每一台主机分别配对。

    Remote connections

  • 远程访问使用连接主机的 projects、chats、文件、凭据、权限、插件、Computer Use、浏览器设置和本地工具。

    Remote connections

  • 交接（handoff）在你的本地电脑和已连接的远程主机之间移动一个已有对话及其 Git 状态；交接之前需要先连接目标主机，并在该主机上为同一个 Git 仓库保存一个 project。

    Remote connections

  • Codex 会在目标主机上创建或复用一个 worktree、传输对话和 Git 状态，并把该对话切换到那台主机；对话正在运行时，交接会先中断当前回应再传输。

    Remote connections

  • Codex 无法交接发出该请求的那个对话，也不支持交接到 Codex 云端环境。

    Remote connections

  • 远程连接使用 SSH 来启动和管理远程 Codex app server；官方要求不要把 app-server 传输直接暴露在共享或公共网络上，需要跨网络访问时使用 VPN 或 mesh 网络工具。

    Remote connections

它把手机变成一个控制面板

官方对 Codex Remote 的定位是：从手机跟进进度、批准操作、发送指令——而 Codex 在你已连接的电脑上运行每个任务。

后半句是理解这个功能的关键。手机不是运行环境，是遥控器。它发送提示、审批和后续消息；真正的仓库文件、shell 命令、MCP servers、技能、浏览器访问和 Computer Use，全都来自那台连接的主机的配置。

使用方式是 ChatGPT 手机应用配合一台已连接的 Mac 或 Windows PC。可用性取决于灰度和你的工作区设置。

四项能力

官方列出的四条，正好覆盖了一次远程介入的完整生命周期：

从手机启动任务。 选择一台已连接的电脑和一个项目，描述任务，然后让 Codex 开始工作。

在任务进行中引导工作。 打开一个任务、跟进它的进度、发送新指令——不必回到工位。

批准请求的操作。 在 Codex 于你已连接的电脑上继续之前，先审阅它请求的命令和操作。

审阅结果。 检查回应、改动的文件、diff 和测试结果，再决定接下来发生什么。

设置：三步，从电脑开始

  1. 在电脑上开始设置。 在你的 Mac 或 Windows PC 上打开 ChatGPT 桌面应用，进入 Settings > Connections > Control this Mac or PC，选择 Set up 或 Add。批准远程访问并完成要求的验证。
  2. 扫描二维码。 用手机扫码，登录同一个 ChatGPT 账号和工作区，批准这次连接。官方在这里加了一句提醒：只连接你拥有且信任的设备。
  3. 从手机开始工作。 在 ChatGPT 手机应用中打开 Remote，选择你已连接的电脑，开始一个新任务或继续一个已有任务。保持电脑唤醒并联网。

一个容易忽略的配对规则：二维码把那一部手机与那一台主机配对。每一部手机（或受支持的桌面应用设备），都要与它要控制的每一台主机分别配对。

主机选哪一台

你自己的笔记本或台式机。 最省事，因为远程访问能拿到你已经在用的同一批 projects、chats、凭据、插件和本地配置。代价是它会睡眠、会断网。用作主机时保持接电，并用主机的连接设置让它保持唤醒。Mac 笔记本上，开盖接电时远程访问可以保持可用；合盖时还需要外接显示器；选择 Sleep 仍然会中断远程访问。

一台专用的常开电脑。 需要持续可达、跑较长时间的工作时用。把 Codex 该用的 projects、凭据、MCP servers、技能和工具装在那台机器上。

远程开发环境。 项目本身就在远程环境里时用 SSH 主机或托管的远程开发环境。先把桌面应用主机连到那个环境，你的手机仍然连到同一台主机，而 Codex 在远程环境里工作，使用它的依赖、安全策略和计算资源。

Windows 主机上有一条专门提示：对使用 Computer Use 的任务保持会话解锁并可用。因为 Windows 上的 Computer Use 运行在前台，远程控制最适合用来启动或查看工作，同时把主机桌面让给该任务。

任务交接：在主机之间搬工作

这是一个容易被忽略但很实用的能力。交接（handoff）在你的本地电脑和一台已连接的远程主机之间移动一个已有对话及其 Git 状态。 典型用法是：在本地开始工作，在远程电脑的 worktree 上继续，之后再把对话拿回来。

前置条件要先满足：连接目标主机，并在该主机上为同一个 Git 仓库保存一个 project。如果这个 project 是仓库的一个子目录，两台主机上要保存同一个子目录——Codex 只会显示有匹配 project 的目标。

交接步骤：

  1. 在桌面应用中打开该对话。
  2. 在对话页脚选择当前的运行位置，然后选择目标主机。把远程对话交回本地电脑时，选择 This computer。
  3. 审阅目标和分支，然后选择 Hand off。

Codex 会在目标主机上创建或复用一个 worktree、传输对话和 Git 状态，并把该对话切换到那台主机。如果对话正在运行，交接会先中断当前回应再传输。

你也可以在另一个对话里让 Codex 把某个具名对话交接到已连接的主机。两个限制：Codex 无法交接发出该请求的那个对话，也不支持交接到 Codex 云端环境。

网络与安全

远程连接使用 SSH 来启动和管理远程 Codex app server。官方给了一条明确要求：不要把 app-server 传输直接暴露在共享或公共网络上。

需要在当前网络之外访问一台远程机器时，使用 VPN 或 mesh 网络工具，而不是把 app server 直接暴露到互联网。

另外，官方提到有一个安全中继层，让受信任的机器在你已授权的 ChatGPT 设备之间可达，而不把它们直接暴露在公网上。

值得记住的一点：沙箱设置、安全控制和操作审批仍然适用于这个连接会话。远程不是绕过权限的后门。

排查

手机上看不到主机 —— 确认桌面应用正在主机上运行、已启用 Allow other devices to connect、两台设备使用同一个 ChatGPT 账号和工作区。如果自 2026 年 6 月 8 日以来没有使用过这条连接，更新两端应用并重新配对设备。

重新登录后 Remote Control 关闭了 —— 登出 ChatGPT 会关闭 Remote Control，但不会移除已有的设备配对。重新登录后打开 Remote Control 即可恢复。如果打开后选择 Add 时报错，在主机上重启 ChatGPT 桌面应用再试。

审批请求不出现 —— 在手机应用中打开 Remote，确认账号和工作区一致，然后重新扫码或从主机重新开始设置。使用工作区时，请管理员确认已启用 Remote Control 访问。

远程会话断开 —— 检查主机是否睡眠、断网或关掉了应用。

认证阻断设置 —— 完成设置过程中出现的账号或工作区认证提示。组织要求 SSO、多因素认证或 passkey 时，先完成那个流程。仍然失败就请工作区管理员确认已启用 Remote Control 访问。

实际操作

  1. 在你要连接的 Mac 或 Windows PC 上打开 ChatGPT 桌面应用。
  2. 进入 Settings > Connections > Control this Mac or PC，选择 Set up 或 Add，批准远程访问并完成要求的验证。
  3. 用手机扫描二维码，登录同一个 ChatGPT 账号和工作区，并批准这次连接。
  4. 在 ChatGPT 手机应用中打开 Remote，选择你已连接的电脑，开始一个新任务或继续一个已有任务。
  5. 保持电脑唤醒并联网。
  6. 任务进行中：跟进进度、发送新指令、批准请求的命令、审阅回应与改动的文件与 diff 与测试结果。

Windows 步骤

  1. Windows PC 可以作为 Remote 主机，设置入口同样是桌面应用的 Settings > Connections > Control this Mac or PC。
  2. Windows 主机上，对使用 Computer Use 的任务需要保持会话解锁并可用。
  3. 因为 Windows 上的 Computer Use 运行在前台，远程控制最适合用来启动或查看工作，同时把主机桌面让给该任务。

手机步骤

  1. 需要 iOS 或 Android 上的最新版 ChatGPT 手机应用；如果 Remote 没出现，先更新应用。
  2. 在手机应用中打开 Remote，选择已连接的电脑。
  3. 可以启动新任务、继续已有对话、批准请求的命令，并审阅改动的文件和 diff。
  4. 官方提示：只连接你拥有且信任的设备。

使用案例

  • 离开工位后继续引导一个正在跑的编码任务。
  • 在手机上批准 Codex 请求执行的终端命令，让工作不被卡住。
  • 在手机上审阅改动的文件和 diff，再决定下一步。
  • 在本地开始一段工作，交接到远程电脑的 worktree 上继续，之后再拿回来。

常见错误

  • 试图从手机开始设置。设置必须从主机上的桌面应用开始。
  • 任务跑起来后让电脑睡眠。官方明确要求保持电脑唤醒并联网。
  • 以为配对一次就能控制所有电脑。每一部手机都要与它要控制的每一台主机分别配对。
  • 交接之前没在目标主机上为同一个 Git 仓库保存 project，然后发现目标列表是空的。
  • 把 app-server 传输直接暴露在公共网络上。官方要求改用 VPN 或 mesh 网络工具。

常见问题

手机上具体能做哪四件事？
官方归纳为四项优势：**从手机启动任务**——选择一台已连接的电脑和一个项目，描述任务，然后让 Codex 开始工作；**在任务进行中引导工作**——打开一个任务、跟进进度、发送新指令而不必回到工位；**批准请求的操作**——在 Codex 于你已连接的电脑上继续之前，先审阅它请求的命令和操作；**审阅结果**——检查回应、改动的文件、diff 和测试结果，再决定接下来发生什么。
任务实际跑在哪里？
跑在你已连接的电脑上。官方明确说明 Codex 在你已连接的电脑上运行每个任务，而该电脑在你所在组织的安全策略下运行这些工作。远程访问使用的是连接主机的 projects、chats、文件、凭据、权限、插件、Computer Use、浏览器设置和本地工具。
什么是任务交接？
交接（handoff）在你的本地电脑和一台已连接的远程主机之间移动一个已有对话及其 Git 状态。用途是在本地开始工作，在远程电脑的 worktree 上继续，之后再拿回来。Codex 会在目标主机上创建或复用一个 worktree、传输对话和 Git 状态，并把该对话切换到那台主机；如果对话正在运行，交接会先中断当前回应再传输。
交接前需要准备什么？
需要先连接目标主机，并在该主机上为**同一个 Git 仓库**保存一个 project。如果这个 project 是仓库的一个子目录，两台主机上要保存同一个子目录——Codex 只会显示有匹配 project 的目标。另外有两个限制：Codex 无法交接发出该请求的那个对话，也不支持交接到 Codex 云端环境。
网络上要注意什么？
远程连接使用 SSH 来启动和管理远程 Codex app server。官方要求不要把 app-server 传输直接暴露在共享或公共网络上；需要在当前网络之外访问一台远程机器时，使用 VPN 或 mesh 网络工具，而不是把 app server 直接暴露到互联网。

官方来源

这些是本教程对照核验的官方页面。需要厂商的原始措辞时请直接查阅。

来源状态