本文为非官方中文翻译，内容以 OpenAI 官方英文文档为准。
官方来源：https://developers.openai.com/codex/remote-connections

远程连接

将你的手机或其他设备连接到 Codex 主机，或通过 SSH 使用远程机器上的项目

Desktop, Storage, Terminal, } from "@components/react/oai/platform/ui/Icon.react";

远程连接让你可以从另一台设备或另一台机器使用 Codex。 你可以在 ChatGPT 移动应用中使用 Codex，在已连接的 Mac 上使用 Codex 进行工作， 从另一台 Codex App 设备继续工作，或将 Codex App 连接到 SSH 主机上的项目。

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

你可以远程执行的操作

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

接下来的部分介绍如何在 ChatGPT 移动应用中使用 Codex 来控制 Codex App 主机。要将 Codex 连接到 SSH 主机上的项目，请参见 连接到 SSH 主机。

设置移动访问前

请确保你具备：

• 你想使用的 ChatGPT 账户和工作区中的 Codex 访问权限。
• iOS 或 Android 设备上的最新版 ChatGPT 移动应用。如果你在 ChatGPT 移动应用中看不到 Codex，请先更新 ChatGPT。
• 在一台 Mac 主机上运行的最新版 macOS 版 Codex App，该主机处于唤醒、 联网并已登录到相同的账户和工作区。移动设置从 Codex App 开始；你无法从 Codex CLI 或 IDE Extension 进行设置。
• 该账户或工作区所需的任何多重身份验证、SSO 或 passkey 配置。

如果你通过 ChatGPT 工作区使用 Codex，你的管理员可能需要先启用 Remote Control 访问，你才能从手机进行连接。

设置移动访问

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

1. 开始 Codex 移动设置。

   在主机上打开 Codex，并在 侧边栏中选择 Set up Codex mobile。

2. 扫描二维码。

   用你的手机扫描 Codex 显示的二维码。该二维码会打开 ChatGPT， 以便你完成将移动应用连接到主机的操作。

3. 在 ChatGPT 中完成设置。

   ChatGPT 会打开 Codex 移动设置流程。确认使用相同的 ChatGPT 账户 和工作区，然后完成任何所需的多重身份验证、SSO 或 passkey 步骤。设置成功后，该主机会显示在你手机上的 Codex 中。

4. 检查主机设置。

   在主机上的 Codex 中，使用 Settings > Connections 来管理已连接的 设备。你还可以选择是否让电脑保持唤醒、启用 Computer Use，或安装 Chrome 扩展。

选择要连接的对象

先从你已日常使用 Codex 的 Mac 笔记本或台式机开始。在你需要持续访问 或不同环境时，再添加一台始终在线的 Mac 或 SSH 主机。

你的 Mac 笔记本或台式机

连接你已经日常运行 Codex 的那台 Mac。这样可以远程访问 你已经在使用的同一套项目、线程、凭据、插件和本地设置。

如果这台 Mac 进入睡眠、失去网络连接或关闭 Codex，远程访问将停止， 直到它再次可用。如果你将这台电脑用作主机设备，请保持接通电源， 并在主机的连接设置中打开 Keep this Mac awake。

在 Mac 笔记本上，只要电脑接通电源并保持屏幕开启，远程访问就可以持续可用。 如果合上盖子，还需要连接外接显示器。选择 Sleep 仍会停止远程访问。

专用的始终在线 Mac

当你希望 Codex 在更长时间的工作过程中保持可访问时，请使用专用的始终在线 Mac。

在该机器上安装 Codex 应使用的项目、凭据、插件、MCP 服务器和工具。

远程开发环境

如果项目本来就位于远程环境中，请使用 SSH 主机或托管 devbox。 先将 Codex App 主机连接到该环境；你的手机仍然连接到 Codex App 主机， 而 Codex 则在远程环境中工作，并使用其中的依赖、安全策略和计算资源。

有关 SSH 设置的详细信息，请参见连接到 SSH 主机。

对于始终在线的 Mac 或远程主机上的浏览器或桌面任务，请启用 Computer Use 并在该主机上安装 Chrome 扩展。

哪些内容来自已连接主机

你的手机会向 Codex 发送提示、批准和后续消息。已连接主机提供 Codex 使用的环境。

这意味着：

• 仓库文件和本地文档来自已连接主机。
• Shell 命令在该主机或远程环境上运行。
• 安装在该主机上的任何插件在你远程使用 Codex 时都可用。
• MCP 服务器、skills、浏览器访问和 Computer Use 来自主机的 配置。
• 只有当主机能够访问时，已登录的网站和桌面应用才可用。
• 沙箱、安全控制和操作批准仍然适用于已连接会话。

Codex 使用安全中继层，让受信任的机器能够在你已授权的 ChatGPT 设备之间保持可达， 而无需将它们直接暴露在公共互联网中。

从另一台设备继续工作

你可以从另一台已登录的 Codex App 设备继续工作。例如，如果你的笔记本电脑不可用， 你可以先在手机上通过一台始终在线的主机启动一个线程， 然后稍后在你的笔记本电脑上打开 Codex，并在那里继续同一个线程。

在笔记本电脑上的 Codex 中，使用 Settings > Connections > Control other devices 来添加另一台主机。一台设备可以同时允许远程访问并控制另一台 设备。

连接到 SSH 主机

在 Codex App 中，从 SSH 主机添加远程项目，并针对 远程文件系统和 Shell 运行线程。远程项目线程会在远程主机上运行命令、 读取文件并写入更改。

请像对待普通 SSH 访问一样，为远程主机保持相同的安全配置预期： 受信任的密钥、最小权限账户，以及没有 未认证的公共监听器。

1. 将主机添加到你的 SSH 配置中，以便 Codex 自动发现它。

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

   Codex 会从 ~/.ssh/config 读取具体的主机别名，使用 OpenSSH 解析它们，并忽略仅包含模式的主机。

2. 确认你可以从运行 Codex App 的机器 SSH 到该主机。

   ssh devbox

3. 在远程主机上安装并验证 Codex。

   应用会通过 SSH 启动远程 Codex app server，并使用远程 用户的登录 shell。请确保 codex 命令在该 shell 中可通过远程主机的 PATH 使用。

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

身份验证与网络暴露

远程连接使用 SSH 来启动和管理远程 Codex app server。 不要在共享网络或公共网络上直接暴露 app-server 传输层。

如果你需要访问当前网络之外的远程机器，请使用 VPN 或 mesh 网络工具，而不要将 app server 直接暴露到 互联网。

故障排除

你在手机上看不到主机

确认主机上正在运行 Codex App，Allow other devices to connect 已启用，并且两台设备上选择的是相同的 ChatGPT 账户和工作区。

批准请求未出现

在 ChatGPT 移动应用中打开 Codex。确认手机和主机使用的是 相同的 ChatGPT 账户和工作区，然后再次扫描二维码或从主机重新开始设置。 如果你使用 ChatGPT 工作区，请让管理员确认 Remote Control 访问已启用。

远程会话断开连接

检查主机是否进入睡眠、失去网络连接或关闭了 Codex。 在 Codex 工作期间，让主机保持唤醒并连接网络。

身份验证阻止设置

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

另请参阅

• Codex App
• Codex App 功能
• Codex App 设置
• Computer Use
• Chrome 扩展
• 命令行选项
• 身份验证