分享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 的读文件、写文件、运行命令等操作，都会发生在远程机器上。

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

连接成功：

此后可以创建远程项目