分享Codex SSH 远程开发教程

问题描述：

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 这边开始把"远程开发环境"也作为一等公民接进来了。

---

二、开启 SSH Remote 功能

目前这个功能还是 alpha，需要手动打开 feature flag。

编辑本地 Codex 配置文件：

~/.codex/config.toml

加入下面配置：

[features] remote_control = true remote_connections = true

保存后，重启 Codex App。

注意：这个功能目前还在 alpha，后续配置项、入口、稳定性都有可能变化。

---

三、先配置 SSH Host

官方更推荐先把远程机器写到本地 SSH config 里，这样 Codex 可以自动发现具体的 SSH host。

编辑：

~/.ssh/config

示例：

Host devbox HostName 你的服务器IP或域名 User your_username Port 22 IdentityFile ~/.ssh/id_ed25519

然后先在本地终端确认能正常连上：

ssh devbox

如果这里都连不上，Codex 里大概率也连不上。

---

四、远程机器也要准备 Codex

需要注意的是，Codex App 连接远程项目时，会通过 SSH 在远程机器上启动对应的 Codex app server。

所以远程机器上也需要：

1. 已安装 Codex

2. 已完成认证

3. codex 命令在远程登录 shell 的 PATH 里可用

可以 SSH 到远程机器后检查：

which codex codex --version

如果 which codex 没输出，说明远程 shell 找不到 Codex，需要先处理 PATH 或安装问题。

---

五、在 Codex App 里添加远程项目

重启 Codex App 后：

1. 打开 Codex App

2. 进入 Settings

3. 找到 Connections

4. 添加或启用 SSH Host

5. 选择远程机器上的项目目录

6. 创建 / 打开远程项目线程

之后 Codex 的读文件、写文件、运行命令等操作，都会发生在远程机器上。

也就是说，它不是简单地"看远程代码"，而是可以直接在远程环境里工作。

连接成功：

image2166×1180 129 KB

此后可以创建远程项目

网友解答：

---

--【壹】--：

这个我上个月用的时候就能在我服务器里开发了，直接把你的服务器信息给他就行了，他自己连

---

--【贰】--：

有点好奇请求是走本机还是服务器，服务器上没装梯子能用吗

---

--【叁】--：

功能确定是有的
我猜是设置完之后没有真的完全关掉 codex app
右上角点 X 之后仍会在系统匣里面

image2559×1435 251 KB

---

--【肆】--：

这个跟直接在远程用codex有什么区别哇

---

--【伍】--：

目前还不支持 WSL
只能透过 SSH 连线

---

--【陆】--：

我加了，奇怪，也更新到最新了，还是不行，神奇

---

--【柒】--：

这个更新很实在，但本地与remote端要用同一个登录源才能实现远程开发？

---

--【捌】--：

我更新到最新版也看不到这个，win版codex是个什么毛病。

---

--【玖】--： Herny:

Codex App

我发现WINDOWS版本怎么安装都没有连接这个选项，应该是只有MAC OS才有

---

--【拾】--：

这个官方功能是通过什么来实现的，远程服务器连不上openai可以用吗，之前看论坛里有一个方案可以直接通过ssh mcp来实现。

---

--【拾壹】--：

我可能知道了，你要写的是：

remote_connections = true

以及上面那个

Herny:

remote_control = true

你可以让Codex自己读一下自己的代码得出结论

---

--【拾贰】--：

Windows下就容易爆炸了 .ssh的权限给你加一堆

---

--【拾叁】--：

这个具体没试过，我觉得应该是都得要开代理的

---

--【拾肆】--：

和这个不一样的佬，把信息发给codex相当于codex在终端执行ssh命令连接服务器，一般会本地开发再上传服务器。这个方法就类似于vscode使用ssh插件，是直接通过桌面app在服务器上开发的

---

--【拾伍】--：

不用那么麻烦吧，.ssh config配置好服务器，随便打开个空文件夹或者干脆把代码也拉下来，直接跟他说连接服务器开启 远程同步开发模式（Sync-based Remote Development)或 Headless 远程工作空间就行了。codex antigravity 我一直都这么干。甚至可以同时操作好几台服务器。

---

--【拾陆】--：

下一步可以开发codex手机app了随时随地vibe coding

---

--【拾柒】--：

这个可以直接用app进行远程开发吧，不用在服务器里开codex终端命令，会便捷一点

---

--【拾捌】--：

这个可以有，远程代码也要远程管理哈，我上次纯主机上开发，机器失联，干了一半的工程，代码全没了

---

--【拾玖】--：

Windows 有的，需要更新
有可能没关干净，直接把整个线程砍了重啟

C:\Users\<user>\.codex\config.toml

[features] remote_connections = true