Codex 远程控制：用手机操作电脑上跑的任务

远程控制到底能做什么

在 iOS 或 Android 上的 ChatGPT App 里打开 Codex（旧版 App 里可能叫 Remote），就能操作已经连接着的 Mac 或 Windows 主机上的 ChatGPT 与 Codex 对话。注意这里的主语：跑任务的是主机，手机只是遥控器。

前提条件：账号、主机、权限三件事

远程控制在大多数情况下装好就能用，但失败的原因往往在三个地方：账号不一致、主机不在线、企业策略没开。先确认这三件事，能省掉大半排错时间。

• 账号具备 Codex 权限，且手机与主机登录的是同一账号、同一工作区。
• 主机装的是最新版桌面端，处于开机联网、已登录状态。
• 桌面端已在 Settings > Connections > Control this Mac or PC 里开启，并完成了扫码配对。
• 企业工作区可能由管理员统一管控，需要管理员先开启 Remote Control，否则开关是灰的。
• 2026-06-08 之后没用过的旧连接需要重新配对，不会自动恢复。

扫码配对：五步接通

1. 01

   更新两端

   先把桌面端和手机 App 都更新到最新版。版本不一致时，配对界面可能对不上，开关也可能缺失。

2. 02

   在主机上打开开关

   桌面端进入 Settings > Connections，在 Control this Mac or PC 处开启。企业工作区如果这里被禁用，先找管理员确认策略。

3. 03

   用手机扫码

   开关打开后会出现二维码，用同一账号的手机 App 扫码完成配对。二维码有时效，过期就刷新重扫。

4. 04

   在手机上进入 Codex

   打开 ChatGPT App 里的 Codex（旧版叫 Remote），应该能看到刚配对的主机。

5. 05

   发一条小任务验证

   先让它读一个文件或回答一个只读问题，确认链路通了，再让它执行会改文件的命令。

如果手边还有第二台装了桌面端的 Mac 或 Windows，也可以用 Settings > Connections > Control other devices 从电脑接管另一台电脑，配对逻辑一样。

主机提供什么环境：文件和权限都在本机

远程控制的一个常见误解是“手机上跑了个轻量版”。实际上手机端没有任何执行环境，它只是把指令送到主机，把结果拿回来。所以主机上装了什么、登录了什么，决定了任务能做什么。

Handoff：把对话和 Git 状态搬过去

Handoff（交接）指的是把已有对话连同它的 Git 状态，在本机与远程主机之间搬一次。典型用法是：白天在公司电脑上起了个头，晚上接着在家里那台机器上跑。

1. 01

   在目标主机上准备好仓库

   目标主机必须先保存同一个仓库，并且是同一个子目录，否则找不到项目就交接不过去。

2. 02

   在对话底部选运行位置

   选择目标主机，再选要接续的分支。

3. 03

   确认 Hand off

   系统会在目标机上新建或复用一个 worktree，把对话接过去继续跑。

• 对话正在执行时交接，会先中断当前这一轮。
• 不能让 Codex 交接“正在发起请求的这个对话”，换个入口或等它跑完再试。
• 不支持交接到 Codex 云端环境，交接只发生在本地与远程主机之间。
• 交接过去的是对话与 Git 状态，主机上的环境差异（依赖版本、环境变量）不会跟着走。

SSH 远程项目：把仓库放在另一台机器上

SSH 远程项目和远程控制是两条不同的路：远程控制是“手机操作这台电脑”，SSH 项目是“这台电脑上的对话操作另一台机器上的代码”。后者适合代码本来就在开发机或服务器上的情况。

桌面端在 Settings > Connections 里添加 SSH 主机。它读取 ~/.ssh/config 里配置好的具体别名，通配写法会被忽略，所以先把别名写好再添加。远程主机上需要装好并登录 codex，并且它要在登录 shell 的 PATH 里。

Host dev-box
  HostName 10.0.0.12
  User dev
  IdentityFile ~/.ssh/id_ed25519
  IdentitiesOnly yes

• 添加后先测连接，能连上再打开项目，避免把网络问题和项目问题混在一起排查。
• 远程项目的对话在远程文件系统上跑命令、读写文件，产物留在那台机器上。
• 远程主机上的 codex 没登录时，对话会以未鉴权状态失败，先在主机上完成登录。

断连原因、排错与安全边界

远程控制依赖主机持续在线。断连几乎都是主机侧的状态变化，而不是手机网络的问题——先看主机，再看手机。

• 连接走一条安全中继，主机不会直接暴露在公网上；不要为了“方便”把 app-server 端口暴露到公网。
• 共用电脑先退出登录，配对等于把主机上的文件和已登录网站交给那台手机。
• 手机上批准命令和电脑上批准一样有风险，看不清意图就先拒绝，回到电脑前再处理。
• 企业环境里，远程控制属于管理员可管控能力，别绕过策略自行开启。