远程连接让你可以从另一台设备或另一台机器使用 Codex。你可以在 ChatGPT mobile app 中使用 Codex，连接到一台 Mac 上的 Codex；也可以从另一台 Codex App 设备继续工作，或把 Codex App 连接到 SSH 主机上的项目。
远程访问会使用已连接主机上的项目、线程、文件、凭据、权限、插件、Computer Use、浏览器设置和本地工具。
可以远程完成什么
- 在主机上的项目里启动新线程，或继续现有线程。
- 发送后续指令、回答问题，并引导正在进行的工作。
- 审批命令和其他动作。
- 查看输出、diff、测试结果、终端输出和截图。
- 在 Codex 完成任务或需要你处理时收到通知。
- 在已连接主机和线程之间切换。
下面几节介绍如何在 ChatGPT mobile app 中使用 Codex 控制一台 Codex App 主机。如果要把 Codex 连接到 SSH 主机上的项目，请参见连接到 SSH 主机。
设置移动端访问前
请先确认你具备以下条件：
- 你想使用的 ChatGPT 账号和工作区已经拥有 Codex 访问权限。
- iOS 或 Android 设备上安装了最新版 ChatGPT mobile app。如果 ChatGPT mobile app 中看不到 Codex，请先更新 ChatGPT。
- 一台处于唤醒、在线状态并运行最新版 Codex App for macOS 的 Mac 主机，且它登录的是同一个账号和工作区。移动端设置从 Codex App 开始；不能从 Codex CLI 或 IDE Extension 设置。
- 该账号或工作区所需的多因素认证、SSO 或 passkey 配置已经准备好。
如果你通过 ChatGPT 工作区使用 Codex，管理员可能需要先启用 Remote Control 访问权限，你才能从手机连接。
设置移动端访问
从你要连接的主机上的 Codex App 开始。设置流程会为该主机启用远程访问，然后显示一个可用手机扫描的二维码。
启动 Codex mobile setup。
在主机上打开 Codex，并在侧边栏中选择 Set up Codex mobile。
扫描二维码。
用手机扫描 Codex 显示的二维码。二维码会打开 ChatGPT，让你继续把 mobile app 连接到这台主机。
在 ChatGPT 中完成设置。
ChatGPT 会打开 Codex mobile setup 流程。确认使用的是同一个 ChatGPT 账号和工作区，然后完成所需的多因素认证、SSO 或 passkey 步骤。设置成功后，这台主机会出现在手机上的 Codex 中。
检查主机设置。
在主机上的 Codex 中，使用 Settings > Connections 管理已连接设备。你也可以选择是否保持电脑唤醒、启用 Computer Use，或安装 Chrome extension。
选择要连接的对象
可以先从你日常使用 Codex 的 Mac 笔记本或台式机开始。需要持续可访问或不同环境时，再添加一台常开 Mac 或 SSH 主机。
你的 Mac 笔记本或台式机
连接你日常运行 Codex 的 Mac。这样可以远程访问你已经在使用的同一批项目、线程、凭据、插件和本地设置。
如果这台 Mac 进入睡眠、断网或关闭 Codex，远程访问会停止，直到它重新可用。如果你把这台电脑作为主机设备，请接入电源，并在主机的连接设置中打开 Keep this Mac awake。
在 Mac 笔记本上，只要保持屏幕打开并接入电源，远程访问就可以继续可用。如果合上屏幕，还需要同时连接外接显示器。选择 Sleep 仍会停止远程访问。
专用常开 Mac
当你希望 Codex 在较长时间任务中保持可访问时，可以使用一台专用的常开 Mac。
在这台机器上安装 Codex 需要使用的项目、凭据、插件、MCP servers 和工具。
远程开发环境
如果项目已经位于远程环境中，可以使用 SSH 主机或托管 devbox。先把 Codex App 主机连接到该环境；你的手机仍然连接到 Codex App 主机，而 Codex 会在远程环境中使用那里的依赖、安全策略和计算资源工作。
SSH 设置细节请参见连接到 SSH 主机。
如果要在常开 Mac 或远程主机上执行浏览器或桌面任务，请在那台主机上启用 Computer Use 并安装 Chrome extension。
已连接主机提供什么
你的手机会把提示词、审批和后续消息发送给 Codex。已连接主机提供 Codex 使用的执行环境。
这意味着：
- 仓库文件和本地文档来自已连接主机。
- Shell 命令会在该主机或远程环境中运行。
- 该主机上安装的任何插件，在你远程使用 Codex 时都可用。
- MCP servers、技能、浏览器访问和 Computer Use 都来自该主机的配置。
- 已登录的网站和桌面应用只在主机能够访问它们时可用。
- 沙箱、安全控制和动作审批仍然适用于已连接的会话。
Codex 使用安全 relay 层，让受信任机器可以在你已授权的 ChatGPT 设备之间保持可达，而不需要把这些机器直接暴露到公网。
从另一台设备继续工作
你可以从另一台已登录的 Codex App 设备继续工作。例如，如果你的笔记本暂时不可用，可以先从手机在一台常开主机上启动线程，之后再在笔记本上打开 Codex 并继续同一条线程。
在笔记本上的 Codex 中，使用 Settings > Connections > Control other devices 添加另一台主机。一台设备可以同时允许远程访问并控制另一台设备。
连接到 SSH 主机
在 Codex App 中，你可以从 SSH 主机添加远程项目，并让线程在远程文件系统和 shell 上运行。远程项目线程会在远程主机上运行命令、读取文件并写入改动。
请按照你对普通 SSH 访问的安全预期来配置远程主机：使用可信密钥、最小权限账户，并避免未认证的公开监听器。
把主机加入 SSH config，便于 Codex 自动发现。
Host devbox HostName devbox.example.com User you IdentityFile ~/.ssh/id_ed25519Codex 会从
~/.ssh/config中读取具体的 host alias，通过 OpenSSH 解析它们，并忽略只包含模式的 host。确认你可以从运行 Codex App 的机器 SSH 到该主机。
ssh devbox在远程主机上安装并认证 Codex。
App 会通过 SSH 启动远程 Codex app server，并使用远程用户的登录 shell。请确保远程主机在该 shell 的
PATH中可以找到codex命令。在 Codex App 中打开 Settings > Connections，添加或启用 SSH 主机，然后选择一个远程项目文件夹。
认证与网络暴露
远程连接会使用 SSH 启动和管理远程 Codex app server。不要在共享网络或公共网络上直接暴露 app-server transport。
如果需要连接当前网络之外的远程机器，请使用 VPN 或 mesh networking 工具，不要把 app server 直接暴露到互联网。
故障排查
手机上看不到主机
确认主机上正在运行 Codex App，Allow other devices to connect 已启用，并且两台设备选择的是同一个 ChatGPT 账号和工作区。
审批请求没有出现
在 ChatGPT mobile app 中打开 Codex。确认手机和主机使用同一个 ChatGPT 账号和工作区，然后重新扫描二维码，或从主机重新开始设置。如果你使用 ChatGPT 工作区，请让管理员确认 Remote Control 访问权限已启用。
远程会话断开
检查主机是否进入睡眠、断网或关闭了 Codex。Codex 工作期间，请保持主机唤醒并联网。
认证阻止设置
完成设置期间显示的账号或工作区认证提示。如果你的组织要求 SSO、多因素认证或 passkey，请先完成对应流程再重试。如果设置仍然失败，请让工作区管理员确认 Remote Control 访问权限已启用。