Codex Desktop App 支持SSH远程连接操作指南

✍ 一🕐 2026-05-03📦 11.8 KB 🟢 已读 𝕏 文章列表

Codex Desktop App 发布了 Alpha 版本的 SSH 远程连接功能，允许用户直接连接远程服务器进行文件系统和 Shell 操作，统一本地与远程开发体验。文章详细介绍了该功能的适用场景、依赖条件，并提供了从开启 SSH、配置别名到在 App 中添加连接的完整操作步骤及常见问题排查方案。

Codex SSH 远程开发教程 DevOps 开发工具配置指南 AI编程

# Codex Desktop App 支持SSH远程连接了，附操作指南 **作者**: 一 **日期**: 2026-05-03T04:07:38.000Z **来源**: [https://x.com/XChatScout/status/2050789356093518188](https://x.com/XChatScout/status/2050789356093518188) --- ![Image](/doc/1478/image/img_14f1600bc17a.jpg) Codex App 现在已经支持通过 SSH 连接远程机器，目前这个功能还处于 alpha 阶段。对于平时需要在远程服务器上开发、跑环境、训练模型的人来说，这个功能还是挺关键的。简单说就是： - 可以直接在 Codex 里连接远程服务器 - 可以让 Codex 在远程文件系统和 shell 里工作 - 不用在本地终端、VSCode Remote、SSH、tmux 之间来回切 - 本地项目和远程项目的开发体验更统一 ## 一、这个功能适合谁？如果你平时有下面这些场景，可以重点关注一下： - 本地写代码，服务器跑模型 - 需要连实验室 / 公司 GPU 服务器 - 后端项目依赖远程部署环境 - 项目代码、依赖、数据库、服务都在远程 devbox 上 - 平时大量使用 `ssh + tmux + vim` 或 VSCode Remote-SSH - 需要在多台机器之间切换开发环境以前这类 workflow 通常是： ```bash ssh devbox cd project tmux attach vim / code / run scripts 现在 Codex 这边开始把"远程开发环境"也作为一等公民接进来了。 # 它依赖两个前提在配置 Codex App 之前，先搞清楚一件事： Codex 远程连接不是单独存在的，它依赖 SSH 和远程 Codex CLI。你至少要满足两个条件：第一，本地电脑能通过 SSH 登录远程机器；第二，远程机器上已经安装并能运行 Codex CLI。也就是说，在打开 Codex App 填表之前，最好先在终端里确认两件事： 1. 你能通过 SSH 登录远程机器； 2. 登录远程机器后，能正常运行 codex 命令。更稳妥的操作顺序是： 1. 在远程 Mac 上开启 SSH 远程登录 2. 在本地 Mac 终端里测试能否 SSH 登录远程机器 3. 确认远程机器上能运行 Codex CLI 4. 开启 Codex Desktop App 的远程连接功能 5. 在 Codex App 里添加远程连接其中第五步有两种填写方式：方式 A：直接填写用户名@远程机器地址，适合快速测试方式 B：通过 ~/.ssh/config 配置 SSH 别名，适合长期使用和多机器管理下面我们按这个顺序来给出实际操作指南。 # 第一步：在远程 Mac 上开启 SSH 远程登录在连接 Codex App 之前，先要确认远程机器允许被 SSH 登录。如果你的远程机器是 Mac mini，需要在 Mac mini 本机上打开：系统设置 → 通用 → 共享 → 远程登录把远程登录打开。打开后，系统通常会显示一行提示，类似：若要远程登录这台电脑，请键入：ssh 用户名@这台电脑的地址这里的用户名，就是后面 SSH 命令里 @ 前面的部分。如果不确定用户名是什么，可以在 Mac mini 本机终端里执行： whoami 输出什么，SSH 命令里的用户名通常就写什么。如果你通过 Tailscale 连接远程 Mac，可以在 Tailscale 里找到这台 Mac 的地址。文章里统一用下面这种脱敏写法表示IP地址： 100.84.xxx.xxx 真正操作时，把它替换成你自己的 Tailscale IP 或 MagicDNS 地址即可。 # 第二步：在本地 Mac 终端里测试 SSH 登录这一步是在你的本地 MacBook / MacBook Air 的终端里操作，不是在 Codex App 里操作。打开终端后，输入： ssh 用户名@远程机器地址例如： ssh Selena@100.84.xxx.xxx 第一次连接时，终端可能会提示是否信任这台主机。输入： yes 然后回车。接着会提示输入密码： Password: 这里输入的是远程 Mac mini 上这个用户的登录密码，不是 Apple ID 密码。输入时终端不会显示任何字符，直接输入密码后回车即可。登录成功后，你当前这个终端窗口就已经进入远程 Mac 的命令行环境。可以执行： whoami hostname pwd 如果 hostname 显示的是远程 Mac 的名字，说明 SSH 已经连通。 # 第三步：确认远程机器上能运行 Codex CLI 接下来要确认远程机器上已经安装 Codex CLI。先 SSH 登录远程机器。如果你已经配置过 SSH 别名，可以这样登录： ssh macmini 如果还没有配置别名，也可以直接用用户名和地址登录，例如： ssh Selena@100.84.xxx.xxx 登录成功后，在远程机器上执行： which codex codex --version 如果能看到 Codex 的路径和版本号，说明远程机器上的 Codex CLI 可以正常使用。你还可以直接执行： codex 确认 Codex CLI 能正常启动。 # 第四步：开启 Codex Desktop App 的远程连接功能在你已经能通过 SSH 登录远程机器，并确认远程 Codex CLI 可用之后，才轮到配置 Codex Desktop App。在本地电脑上编辑 Codex 配置文件： nano ~/.codex/config.toml 加入下面这段： [features] remote_connections = true 保存后，彻底退出并重启 Codex Desktop App。这段配置的作用是打开 Codex App 里的远程连接功能入口。官方文档也说明：如果远程连接入口还没有出现，可以在 ~/.codex/config.toml 里启用这个 alpha feature flag。注意，这个配置是写在本地电脑上的，不是写在远程机器上。也就是说，如果你是在 MacBook 上使用 Codex Desktop App，就在 MacBook 的： ~/.codex/config.toml 里添加这段。 # 第五步：在 Codex App 里添加远程连接重启 Codex Desktop App 之后，进入： Codex App → Settings → Connections → Add connection 这里会看到一个添加连接的窗口，通常有四个字段： Display name HostName SSH port Identity file 这个窗口的作用是：手动添加一个 SSH 远程主机。假设你要连接的是家里的 Mac mini，并且 Mac mini 的 Tailscale IP 是： 100.84.xxx.xxx Mac mini 上的用户名是： Selena 这里有两种填写方式。 # 方式 A：直接填写用户名和远程地址这是最直接的方式，适合快速测试。 ``` Display name macmini HostName Selena@100.84.xxx.xxx SSH port 22 Identity file 先留空 ``` 也就是： ![Image](/doc/1478/image/img_9f51f4b72166.jpg) 如果你只是想先确认 Codex App 能不能连上远程机器，可以先用方式 A。 # 方式 B：通过 ~/.ssh/config 配置 SSH 别名如果你准备长期使用，或者以后要管理多台远程机器，更推荐方式 B。先在本地 Mac 的终端里打开 SSH 配置文件： nano ~/.ssh/config 加入类似下面的配置： Host macmini HostName 100.84.xxx.xxx User Selena Port 22 这里的意思是： Host macmini = 给这台远程机器起一个别名 HostName 100.84.xxx.xxx = 远程机器的真实地址 User Selena = 登录远程机器使用的用户名 Port 22 = SSH 默认端口保存后，在终端里测试： ssh macmini 如果可以正常登录，说明这个 SSH 别名配置成功。然后回到 Codex App 的连接窗口，这样填： ``` Display name macmini HostName macmini SSH port 22 Identity file 留空 ``` 也就是： ![Image](/doc/1478/image/img_f715024caac2.jpg) 方式 B 的好处是：以后如果远程 IP、用户名、密钥路径变化，只需要改 ~/.ssh/config，不用在每个工具里重新改。 # Identity file 要不要填？这个字段最容易让人困惑，单独解释一下。一般先不填。只有当你平时 SSH 需要指定私钥时，才需要填。例如你的私钥路径是： /Users/Selena/.ssh/id_ed25519 那可以填这个路径。对应的 SSH 配置可能长这样： Host macmini HostName 100.84.xxx.xxx User Selena Port 22 IdentityFile ~/.ssh/id_ed25519 如果你不确定，就先留空。判断标准很简单： ssh macmini 或者： ssh Selena@100.84.xxx.xxx 如果这两条命令已经能正常登录，Identity file 通常就不用填。 # 保存后做什么？填写完成后，点击： Save 保存连接。接下来，会显示连接成功，接着在Codex 远程连接配置界面中选择Creat a remote projects，会让你选择远程机器上的项目目录，例如： /Users/Selena/Projects/Atlasnote 选好项目目录后，Codex 就可以在这个远程项目里工作。你可以先让它执行一些低风险任务，例如：请先查看当前项目结构，不要修改文件。或者：运行 git status，并告诉我当前工作区是否干净。再进一步让它跑测试：请运行 npm test，检查当前项目是否能通过测试。不要一上来就让它大规模改代码。先确认它确实进入了正确的远程目录、能读取项目、能运行命令，再交给它更复杂的任务。如果保存后连接失败，不要直接怀疑 Codex App。先回到终端分别测试： ssh macmini ssh macmini "which codex" 这样能快速判断问题到底出在 SSH 连接，还是远程机器上的 Codex CLI。 # 常见问题排查 # 1. SSH 连接不上先不要管 Codex App，先单独解决 SSH。测试： ssh 用户名@远程机器地址如果失败，常见原因包括：远程机器没有开启 SSH 用户名写错 IP 地址写错端口不对当前网络无法访问远程机器 Tailscale 没有连接成功如果远程机器是 Mac mini，检查：系统设置 → 通用 → 共享 → 远程登录 # 2. SSH 直连可以，但 ssh macmini 不行这说明 SSH 别名配置有问题。检查： cat ~/.ssh/config 确认格式类似这样： Host macmini HostName 100.84.xxx.xxx User Selena Port 22 注意： Host 后面是别名 HostName 后面是真实地址 User 是远程机器用户名文件路径是本地电脑上的 ~/.ssh/config # 3. SSH 能连上，但 Codex App 连接失败大概率是远程机器上的 codex 命令找不到。在本地执行： ssh macmini "which codex" 如果没有输出，说明远程 login shell 找不到 Codex。这时需要检查远程机器的 shell 配置，比如： echo $PATH 以及 Codex CLI 的实际安装位置。 # 4. Codex App 里看不到 Connections 先确认本地配置文件内容： cat ~/.codex/config.toml 应该能看到： [features] remote_connections = true 然后彻底退出并重启 Codex Desktop App。如果还是没有入口，可能和当前 App 版本、账号状态或功能灰度有关。这个功能目前仍带有实验性质，不一定所有环境都完全一致。 # 5. 不要把远程 app server 暴露到公网这一点很重要。 Codex 远程连接适合通过 SSH 使用，不要随便把远程 app server 直接暴露到公网。 OpenAI 关于 Codex app server 的文档也提醒：loopback listener 适合 localhost 和 SSH port forwarding；如果把非本地 WebSocket listener 暴露出去，需要先配置认证，不要把未认证服务暴露在共享或公网环境中。务实建议：只通过 SSH 连接，不要手动开放 Codex app server 端口到公网。尤其是多人共享服务器、公司服务器、云服务器，更要谨慎。 ![Image](/doc/1478/image/img_aed2a3b31742.jpg) ## 相关链接 - [@XChatScout](https://x.com/XChatScout) - [3.3K](https://x.com/XChatScout/status/2050789356093518188/analytics) - [100.84.xxx.xxx](https://100.84.xxx.xxx/) - [100.84.xxx.xxx](https://100.84.xxx.xxx/) - [100.84.xxx.xxx](https://100.84.xxx.xxx/) - [100.84.xxx.xxx](https://100.84.xxx.xxx/) - [100.84.xxx.xxx](https://100.84.xxx.xxx/) - [100.84.xxx.xxx](https://100.84.xxx.xxx/) - [$PATH](https://x.com/search?q=%24PATH&src=cashtag_click) - [Upgrade to Premium](https://x.com/i/premium_sign_up) - [12:07 PM · May 3, 2026](https://x.com/XChatScout/status/2050789356093518188) - [3,329 Views](https://x.com/XChatScout/status/2050789356093518188/analytics) - [View quotes](https://x.com/XChatScout/status/2050789356093518188/quotes) --- *导出时间: 2026/5/3 14:02:33*

🔗 相关文档