OpenAI Codex 中文文档(最近同步时间 2026.04.22)

远程连接

通过 SSH 让 Codex 处理远程机器上的项目。

远程连接让 Codex 可以处理位于另一台可通过 SSH 访问的机器上的项目。当所需代码库、凭据、服务或构建环境位于该主机而不是本地机器时,可以使用远程连接。

请按照你对普通 SSH 访问的安全预期来配置远程主机:使用可信密钥、最小权限账户,并避免未认证的公开监听器。

Codex App

在 Codex App 中,你可以从 SSH 主机添加远程项目,并让线程在远程文件系统和 shell 上运行。

  1. 把主机加入 SSH config,便于 Codex 自动发现。

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

    Codex 会从 ~/.ssh/config 中读取具体的 host alias,通过 OpenSSH 解析它们,并忽略只包含模式的 host。

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

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

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

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

如果远程连接尚未显示,请在 ~/.codex/config.toml 中启用 alpha 功能开关:

[features]
remote_control = true

远程项目线程会在远程主机上运行命令、读取文件并写入改动。

Codex App 设置中显示 SSH 远程连接

Codex App 设置中显示 SSH 远程连接

认证与网络暴露

请结合 SSH 端口转发和 localhost WebSocket 监听器使用。不要在共享网络或公共网络上暴露未认证的 app-server 监听器。

如果需要连接当前网络之外的远程机器,请使用 VPN 或 Tailscale 这类网状网络工具,不要把 app server 直接暴露到互联网。

另请参见


来源:https://developers.openai.com/codex/remote-connections