远程连接

远程连接

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

远程访问使用的是连接主机的项目、线程、文件、凭证、权限、插件、计算机使用、浏览器设置和本地工具。

远程功能

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

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

设置移动访问前的准备

确保你具备以下条件：

• 在要使用的 ChatGPT 账户和工作区中拥有 Codex 访问权限。
• 在 iOS 或 Android 设备上安装最新版 ChatGPT 移动应用。如果在 ChatGPT 移动应用中看不到 Codex，请先更新 ChatGPT。
• 在 Mac 主机上运行最新版 Codex App for macOS，该主机需处于唤醒、在线状态，并登录到相同的账户和工作区。移动设置从 Codex App 开始；你无法从 Codex CLI 或 IDE 扩展进行设置。
• 该账户或工作区所需的任何多因素认证、SSO 或通行密钥配置。

如果你通过 ChatGPT 工作区使用 Codex，管理员可能需要先启用远程控制访问权限，你才能从手机连接。

设置移动访问

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

1. 启动 Codex 移动设置。 在主机上打开 Codex，在侧边栏中选择 设置 Codex 移动端。

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

3. 在 ChatGPT 中完成设置。 ChatGPT 会打开 Codex 移动设置流程。确认使用相同的 ChatGPT 账户和工作区，然后完成任何所需的多因素认证、SSO 或通行密钥步骤。设置成功后，主机将出现在你手机的 Codex 中。

4. 查看主机设置。 在主机上的 Codex 中，使用 设置 > 连接 来管理已连接的设备。你还可以选择是否保持计算机唤醒、启用计算机使用，或安装 Chrome 扩展。

选择连接方式

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

你的 Mac 笔记本或台式机

连接你日常运行 Codex 的 Mac。这样你就能远程访问已有的项目、线程、凭证、插件和本地设置。

如果该 Mac 进入睡眠状态、失去网络访问或关闭 Codex，远程访问将停止，直到它再次可用。如果将这台计算机用作主机设备，请保持电源连接，并在主机的连接设置中开启 保持此 Mac 唤醒。

在 Mac 笔记本上，当计算机接通电源且盖子打开时，远程访问可以保持可用。如果盖子关闭，还需要连接外接显示器。选择 睡眠 仍然会停止远程访问。

专用的始终在线 Mac

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

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

远程开发环境

当项目已存在于远程环境中时，使用 SSH 主机或托管的 devbox。先将 Codex App 主机连接到该环境；你的手机仍然连接到 Codex App 主机，Codex 在远程环境中使用其依赖项、安全策略和计算资源进行工作。

SSH 设置详情请参阅连接 SSH 主机。

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

连接主机的功能

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

这意味着：

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

Codex 使用安全中继层，使受信任的机器在你授权的 ChatGPT 设备之间保持可访问，而不会将它们直接暴露到公共互联网。

从其他设备继续工作

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

在笔记本上的 Codex 中，使用 设置 > 连接 > 控制其他设备 来添加其他主机。一台设备可以同时允许远程访问和控制另一台设备。

连接 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 应用服务器，使用远程用户的登录 Shell。确保 codex 命令在该 Shell 中远程主机的 PATH 上可用。

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

认证与网络暴露

远程连接使用 SSH 来启动和管理远程 Codex 应用服务器。不要将应用服务器传输直接暴露在共享或公共网络上。

如果你需要从当前网络之外访问远程机器，请使用 VPN 或网状网络工具，而不是将应用服务器直接暴露到互联网。

故障排除

手机上未显示主机

确认 Codex App 正在主机上运行，允许其他设备连接 已启用，并且两台设备上选择了相同的 ChatGPT 账户和工作区。

批准请求未出现

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

远程会话断开

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

认证阻止设置

完成设置期间显示的账户或工作区认证提示。如果你的组织要求 SSO、多因素认证或通行密钥，请先完成该流程再重试。如果设置仍然失败，请让工作区管理员确认远程控制访问已启用。

另请参阅

• Codex App
• Codex App 功能
• Codex App 设置
• 计算机使用
• Chrome 扩展
• 命令行选项
• 认证