OpenAI Codex 远程连接用于把手机或另一台设备接到已有主机上,继续处理同一个线程、批准命令、查看差异和终端输出。要先在 macOS 版 Codex App 完成手机接入,或在 SSH host 上配置可发现的主机别名,再确认同一 ChatGPT 账号、workspace 和必要的认证都已完成。

OpenAI Codex 远程连接怎么用

OpenAI Codex 的远程连接可以让你在另一台设备上继续使用 Codex。你可以在 ChatGPT mobile app 里控制一台已连接的 Mac,也可以从另一台 Codex App 设备接手工作,或者把 Codex App 连到 SSH host 上的项目。

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

远程连接能做什么

  • 在主机上的项目中新建线程,或者继续已有线程。
  • 发送后续指令、回答问题,并继续推进正在进行的工作。
  • 批准命令和其他操作。
  • 查看输出、diff、测试结果、终端输出和截图。
  • 在 Codex 完成任务或需要你处理时接收通知。
  • 在已连接的主机和线程之间切换。

下面几节讲的是如何在 ChatGPT mobile app 中控制一台 Codex App 主机。要把 Codex 连接到 SSH host 上的项目,请看 连接 SSH host

手机接入前需要准备什么

目前 Codex mobile setup 需要 macOS 版 Codex App。Windows 版 Codex App 还不支持 mobile setup。

请先确认你已经具备:

  • 你要使用的 ChatGPT 账号和 workspace 中已有 Codex access。
  • iOS 或 Android 设备上安装了最新的 ChatGPT mobile app。如果你在 ChatGPT mobile app 里看不到 Codex,请先更新 ChatGPT。
  • 一台运行最新 Codex App for macOS 的 Mac host,这台 Mac 要处于唤醒、联网状态,并且登录到同一个账号和 workspace。mobile setup 必须从 Codex App 开始,不能从 Codex CLI 或 IDE Extension 配置。
  • 该账号或 workspace 所需的 multi-factor authentication、SSO 或 passkey 配置。

如果你通过 ChatGPT workspace 使用 Codex,管理员可能需要先启用 Remote Control access,你才能从手机连接。

怎么设置手机接入

先在你要连接的主机上启动 Codex。设置流程会先为该主机开启远程访问,然后显示一个二维码,供你用手机扫描。

  1. 在主机上打开 Codex,侧边栏选择 Set up Codex mobile
  2. 用手机扫描 Codex 显示的二维码。二维码会打开 ChatGPT,继续把 mobile app 连接到这台主机。
  3. 在 ChatGPT 中完成设置。确认 ChatGPT 账号和 workspace 一致,然后完成所需的 multi-factor authentication、SSO 或 passkey 步骤。设置成功后,这台主机会出现在你手机上的 Codex 里。
  4. 在主机上的 Codex 里,进入 Settings > Connections 管理已连接设备。你也可以选择是否保持电脑唤醒、启用 Computer Use,或者安装 Chrome extension。

怎么选择连接哪台主机

可以从你平时已经在用 Codex 的 Mac laptop 或 desktop 开始;如果你需要长时间可访问,或者需要另一个运行环境,再加一台始终在线的 Mac 或 SSH host。

你的 Mac laptop 或 desktop

把你日常运行 Codex 的 Mac 连接起来,可以远程访问你已经在用的同一批项目、线程、凭据、插件和本地配置。

如果这台 Mac 进入睡眠、断网,或者关闭 Codex,远程访问就会停止,直到它恢复可用。如果你把这台电脑作为主机设备使用,请保持接电,并在主机的连接设置里打开 Keep this Mac awake

在 Mac laptop 上,只要电脑接电并保持上盖打开,远程访问可以继续可用。合上盖子时,还需要连接外接显示器。选择 Sleep 仍然会停止远程访问。

一台专用的始终在线 Mac

如果你希望 Codex 更长时间保持可达,可以使用一台专用的 always-on Mac。

把 Codex 需要使用的项目、凭据、插件、MCP servers 和工具安装到这台机器上。

远程开发环境

如果项目本来就放在远程环境里,可以使用 SSH host 或 managed devbox。先把 Codex App 主机连接到那个环境;你的手机仍然是连到 Codex App 主机,而 Codex 会在远程环境中使用那里的依赖、security policies 和计算资源。

SSH 的配置细节请看 连接 SSH host

如果要在始终在线的 Mac 或远程主机上执行浏览器或桌面任务,请在那台主机上启用 Computer Use,并安装 Chrome extension。

已连接主机里的内容会带过来什么

你的手机负责把 prompts、approvals 和后续消息发送给 Codex;真正提供运行环境的是已连接的主机。

这意味着:

  • 仓库文件和本地文档来自已连接的主机。
  • Shell 命令在那台主机或远程环境中运行。
  • 该主机上安装的插件,在你远程使用 Codex 时同样可用。
  • MCP servers、skills、浏览器访问和 Computer Use 都来自那台主机的配置。
  • 已登录的网站和桌面应用,只有在主机能够访问它们时才可用。
  • sandboxing、security controls 和 action approvals 仍然适用于这个连接会话。

Codex 使用 secure relay layer,让你在授权过的 ChatGPT 设备之间保持可信机器可达,但不会把这些机器直接暴露到公共互联网。

怎么从另一台设备接手工作

你可以从另一台已登录的 Codex App 设备继续工作。比如,笔记本临时不可用时,你可以先在手机上连接一台始终在线的主机开启线程,之后再在笔记本上打开 Codex,继续同一个线程。

在笔记本上的 Codex 中,进入 Settings > Connections > Control other devices 添加另一台主机。一个设备可以同时允许远程访问,也可以去控制另一台设备。

怎么连接 SSH host

在 Codex App 里,可以把 SSH host 上的远程项目加进来,并针对远程文件系统和 shell 运行线程。远程项目线程会在远程主机上执行命令、读取文件并写入修改。

请保持远程主机遵循你平时使用 SSH 时的安全要求:可信的 keys、最小权限账号,以及不要暴露未认证的 public listeners。

  1. 把主机加入 SSH config,让 Codex 能自动发现它。

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

    Codex 会读取 ~/.ssh/config 里的具体 host aliases,通过 OpenSSH 解析它们,并忽略只靠 pattern 匹配的 hosts。

  2. 确认在运行 Codex App 的那台机器上可以直接 SSH 到该主机。

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

    App 会通过 SSH 启动远程 Codex app server,并使用远程用户的 login shell。请确保远程主机在那个 shell 的 PATH 里能找到 codex 命令。

  4. 在 Codex App 中打开 Settings > Connections,添加或启用这个 SSH host,然后选择一个远程项目文件夹。

身份验证和网络暴露

Remote connections 会使用 SSH 来启动和管理远程 Codex app server。不要把 app-server transports 直接暴露在共享网络或公共网络上。

如果你需要访问当前网络之外的远程机器,请使用 VPN 或 mesh networking tool,不要直接把 app server 暴露到互联网。

常见问题

为什么手机上看不到主机

先确认主机上的 Codex App 正在运行,Allow other devices to connect 已开启,并且两台设备登录的是同一个 ChatGPT 账号和 workspace。

为什么审批请求没有出现

在 ChatGPT mobile app 里打开 Codex,确认手机和主机使用的是同一个 ChatGPT 账号和 workspace,然后重新扫描二维码,或者从主机重新开始设置。如果你使用 ChatGPT workspace,请让管理员确认已经启用 Remote Control access。

远程会话为什么会断开

检查主机是否进入睡眠、断网,或者关闭了 Codex。要让 Codex 持续工作,主机必须保持唤醒并联网。

为什么认证会阻止设置

完成设置过程中出现的账号或 workspace 认证提示。如果你的组织要求 SSO、multi-factor authentication 或 passkey,请先完成这些流程再重试。如果还是失败,让 workspace 管理员确认 Remote Control access 已启用。

OpenAI Codex 怎么连接 SSH host

把主机加入 ~/.ssh/config,确认本机可以 ssh devbox,再在远程主机上安装并认证 Codex。随后在 Codex App 的 Settings > Connections 里启用该 SSH host,并选择远程项目文件夹。

OpenAI Codex 手机接入需要什么条件

目前需要 macOS 版 Codex App,Windows 版还不支持 mobile setup。还要有同一 ChatGPT 账号和 workspace 的 Codex access,以及最新 ChatGPT mobile app、必要的 SSO、passkey 或 multi-factor authentication。

另见