前言
我的主要开发环境一直是Linux + VS Code,平时使用 VS Code 中的 Codex 插件辅助开发。
最近发现 Codex CLI 已经加入了一个很有意思的实验性功能:
Remote Control
它可以在 Linux 上启动 Codex App Server,并生成手机端使用的配对信息,使 ChatGPT 手机 App 能够访问支持 Remote 的 Codex 会话。
这样我们的开发方式就有机会变成:
┌───────────────────────┐ │ ChatGPT 手机 App │ │ Remote │ └───────────┬───────────┘ │ │ Remote Control ▼ ┌───────────────────────┐ │ Linux 开发机 │ │ │ │ Codex CLI │ │ ↓ │ │ app-server daemon │ │ ↓ │ │ Linux 项目 / Git │ │ C++ / ROS 2 / Python │ └───────────────────────┘也就是说:
代码和开发环境仍然放在 Linux 上,而手机只作为 Codex 的远程控制端。
对于 Linux、ROS、服务器、嵌入式、机器人开发用户来说,这个工作流还是非常有吸引力的。
需要注意的是,截至本文测试时,OpenAI 仍然将 App Server 中的 Remote Control API 标记为experimental(实验性),因此后续命令、界面和配对流程都有可能发生变化。
一、我的使用环境
本文测试环境:
系统:Linux x86_64 开发方式:VS Code Codex:VS Code Codex Extension + Codex CLI Codex CLI:0.147.0 登录方式:ChatGPT Account在安装 CLI 之前,我一直只有:
Linux └── VS Code └── Codex 插件VS Code 插件本身可以正常使用 Codex,但是插件界面目前并没有提供一个明显的 Linux → 手机 Remote Control 配对入口。
所以这里额外安装Codex CLI。
最终结构变成:
Linux ├── VS Code │ └── Codex Extension │ └── Codex CLI └── Remote Control平时仍然可以继续使用 VS Code 开发,而 CLI 主要负责 Remote Control。
二、安装 Codex CLI
这里我没有使用:
npm install -g @openai/codex而是使用 OpenAI 当前提供的 standalone installer:
curl -fsSL https://chatgpt.com/codex/install.sh | sh安装指令有可能会由于网络原因失败,可以多试几次,官方安装脚本默认将 Codex standalone 包安装到:
~/.codex/packages/standalone/同时在:
~/.local/bin/创建 Codex 的可执行入口。官方安装脚本源码中也可以看到默认BIN_DIR为$HOME/.local/bin,Standalone 包目录为$HOME/.codex/packages/standalone。
我实际安装时输出:
==> Installing Codex CLI ==> Detected platform: Linux (x64) ==> Resolved version: 0.147.0 ==> Downloading Codex CLI curl: (56) OpenSSL SSL_read: error:0A000126:SSL routines::unexpected eof while reading, errno 0 WARNING: Could not download or verify https://releases.openai.com/codex/releases/0.147.0/codex-package-x86_64-unknown-linux-musl.tar.gz; retrying from GitHub Releases. ==> Installing standalone package to /home/zuimo/.codex/packages/standalone/releases/0.147.0-x86_64-unknown-linux-musl ==> /home/zuimo/.local/bin is already on PATH ==> Current terminal: codex ==> Future terminals: open a new terminal and run: codex Codex CLI 0.147.0 installed successfully. Start Codex now? [y/N] y ==> Launching Codex说明安装已经成功。
三、安装后提示“找不到 codex 命令”
这里我遇到了第一个坑。
安装完成之后执行:
codex --version终端却提示:
找不到命令 “codex”,但可以通过以下软件包安装它: sudo snap install codex千万不要看到这个提示就直接执行:
sudo snap install codex实际上 Codex 已经安装好了。
原因只是:
安装程序修改了~/.bashrc,但是当前 Shell 还没有重新读取配置。
执行:
source ~/.bashrc然后重新检查:
codex --version这时正常输出:
codex-cli 0.147.0也可以检查命令位置:
which codex通常应该位于:
/home/你的用户名/.local/bin/codex例如:
/home/ws/.local/bin/codex四、npm安装Codex,删除方法
首先需要确定是通过npm安装的codex,在终端输入下面的指令
npm list -g --depth=0 | grep codex输出中有下面这样一行,就说明确实是通过npm安装的
├── @openai/codex@0.144.5接下来输入以下指令卸载codex:
sudo npm uninstall -g @openai/codex之后输入下列指令删除可能的残留文件和验证是否删除成功:
sudo rm -f /usr/local/bin/codex which codex没有反馈信息就说明使用npm安装的codex以及删除成功了,这时按照章节二的standalone installer重新安装codex即可。
五、检查 Codex 登录状态
接下来检查 Codex 是否已经登录:
codex login status我的输出:
Logged in using ChatGPT说明 CLI 当前已经使用 ChatGPT Account 登录。
如果这里还没有登录,可以先按照 Codex CLI 给出的登录流程完成 ChatGPT 授权,再继续配置 Remote Control。
六、检查 Remote Control 是否可用
执行:
codex remote-control --help在我当前使用的 Codex CLI 0.147.0 中,输出如下:
[experimental] Manage the app-server daemon with remote control enabled Usage: codex remote-control [OPTIONS] [COMMAND] Commands: start Start the app-server daemon with remote control enabled stop Stop the app-server daemon pair Create and print a short-lived manual pairing code help Print this message or the help of the given subcommand(s)这里最值得注意的是三个命令:
start stop pair尤其是:
pair它的作用是:
Create and print a short-lived manual pairing code即:
创建一个短时间有效的手动配对码。
这也是 Linux CLI Remote Control 非常关键的一步。
实际上,2026 年 7 月初还有 Linux 用户反馈,当时的 CLI 只有start和stop,并没有pair命令,因此 Linux 主机很难重新和新的手机 Remote 配对。
而现在我测试的:
codex-cli 0.147.0已经出现:
pair说明这一部分正在快速完善。
七、启动 Linux Remote Control
执行:
codex remote-control start这个命令会启动带 Remote Control 功能的Codex app-server daemon,需要等待一会儿,成功启动后输出如下:
Starting app-server daemon with remote control enabled... This machine is available for remote control as zuimo-Legion-Y7000P-IRX9. Daemon used app-server: path: /home/zuimo/.codex/packages/standalone/current/codex version: 0.147.0可以理解为:
codex remote-control start │ ▼ app-server daemon │ ▼ Remote Control │ ▼ OpenAI Remote ServiceOpenAI 当前的 App Server 文档中已经存在:
remoteControl/enable remoteControl/disable remoteControl/status/read remoteControl/pairing/start remoteControl/pairing/status remoteControl/client/list remoteControl/client/revoke等接口,而且这些接口目前都标记为 experimental。
Remote Control 的状态包括:
disabled connecting connected errored因此如果使用 JSON 模式:
codex remote-control start --json就可以更方便地查看当前连接状态。
八、生成手机配对码
Remote Control 启动以后执行:
codex remote-control pairCLI 会生成:
short-lived manual pairing code
也就是一个短时间有效的配对码。
如果需要程序处理,也可以尝试:
codex remote-control pair --json普通用户手动连接手机的话,直接:
codex remote-control pair就够了。
目前 OpenAI Codex 社区甚至已经有人提出,希望:
codex remote-control start启动的时候就直接生成 pairing code,而不是要求用户再运行一次:
codex remote-control pair这也侧面说明当前 CLI 的典型流程就是:
start ↓ pair如果没有pair之后没有看到配对码,或者出现如下报错:
Error: timed out waiting for remoteControl/pairing/start response Caused by: deadline has elapsed可以先杀掉codex app-serve,等待一段时间或者切换节点,重新再试一次:
pkill -f "codex app-server"九、手机 ChatGPT 连接
接下来打开手机上的ChatGPT App。
在手机 App 中侧滑找到codex入口,点击进入
OpenAI 当前帮助中心明确说明:
ChatGPT 手机端可以通过Remote tab访问支持 Remote 的 Codex chats。
进去之后在右上角点击添加连接,然后按照手机端界面提示改为手动配对,并使用 Linux 上:
codex remote-control pair生成的配对码完成配对。
整个过程就变成:
Linux: codex remote-control start ↓ codex remote-control pair ↓ 生成配对码 │ │ ▼ 手机 ChatGPT ↓ Remote ↓ 输入配对码 ↓ Linux Codex如果配对成功,以后手机就可以作为 Codex Remote 的控制端。
十、为什么推荐 standalone 安装?
这里还有一个很重要的问题。
如果目标只是普通使用 Codex CLI,那么 npm 安装当然也可以。
但是如果目标涉及:
app-server daemon Remote Control目前更建议使用 OpenAI 的 standalone installer:
curl -fsSL https://chatgpt.com/codex/install.sh | sh因为 OpenAI 当前app-server-daemon的实现明确假设 Codex 是通过install.sh安装的,并从:
CODEX_HOME/packages/standalone/current/启动 managed Codex binary。
之前也有用户手动安装 tarball 后运行:
codex remote-control start出现:
managed standalone Codex install not found的问题。
所以如果目标就是尝试 Linux Remote Control,我个人更推荐直接使用 standalone installer。
十一、Remote Control 和 VS Code Codex 插件是什么关系?
这里非常容易产生一个误解:
安装 Codex CLI 并不意味着以后必须放弃 VS Code Codex 插件。
实际上完全可以:
Linux │ ┌───────────┴───────────┐ │ │ ▼ ▼ VS Code Codex CLI │ │ Codex Extension Remote Control │ ▼ ChatGPT Mobile我的使用思路就是:
坐在电脑前:
VS Code + Codex 插件离开电脑后:
ChatGPT 手机 ↓ Codex Remote ↓ LinuxLinux 仍然是唯一真正的开发环境。
代码、Git Repository、ROS 2 环境、CMake、GCC、Python、Docker 等东西全部继续放在 Linux 上。
手机只是远程控制 Codex。
十二、目前仍然存在的限制
虽然这个功能非常有意思,但目前还不能把它理解成一个已经完全成熟的正式功能。
最明显的一点就是:
[experimental]OpenAI App Server 文档目前也仍然把:
remoteControl/enable remoteControl/pairing/start remoteControl/client/list ...标记为 experimental。
社区目前也还有一些相关问题,例如 daemon 更新、连接稳定性,以及多个客户端共享同一个 App Server 等。
所以如果出现:
pairing failed daemon error remote disconnected之类的问题,不一定是自己的 Linux 配置有问题,也有可能是当前 Remote Control 本身仍然处在快速迭代阶段。
建议遇到问题时首先确认:
codex --version codex login status codex remote-control --help然后再尝试:
codex remote-control stop codex remote-control start重新启动 Remote Control。
十三、常用命令整理
安装 Codex:
curl -fsSL https://chatgpt.com/codex/install.sh | sh刷新 Shell:
source ~/.bashrc查看版本:
codex --version查看登录状态:
codex login status查看 Remote Control:
codex remote-control --help启动:
codex remote-control start启动并输出 JSON:
codex remote-control start --json生成手机配对码:
codex remote-control pair停止:
codex remote-control stop十四、最终效果
以前我的开发方式是:
Linux ↓ VS Code ↓ Codex Extension离开电脑之后,基本就无法继续控制 Linux 上正在工作的 Codex。
现在则可以尝试:
┌───────────────────┐ │ ChatGPT 手机 │ │ Remote │ └─────────┬─────────┘ │ ▼ ┌───────────────────┐ │ Codex Remote │ │ Control │ └─────────┬─────────┘ │ ▼ ┌─────────────────────────────────────────┐ │ Linux │ │ │ │ Codex CLI / app-server daemon │ │ │ │ │ ▼ │ │ Linux 开发环境 │ │ │ │ VS Code / Git / ROS 2 / C++ / Python │ └─────────────────────────────────────────┘对于主要使用 Linux 开发的人来说,我认为这比:
手机 ↓ Windows/macOS ↓ SSH ↓ Linux要自然很多。
Linux 本身就是开发主机,就应该直接作为 Codex Remote Host。
总结
这次折腾下来,最让我意外的是:
Codex CLI 在 Linux 上的 Remote Control 能力实际上已经比之前完善了很多。
尤其是新版 CLI 已经出现:
codex remote-control pairLinux 主机终于具备了比较明确的手动配对入口。
目前完整流程可以概括为:
安装 standalone Codex CLI ↓ source ~/.bashrc ↓ codex --version ↓ codex login status ↓ codex remote-control start ↓ codex remote-control pair ↓ 手机 ChatGPT Remote ↓ 连接 Linux Codex当然,目前 Remote Control 依旧属于 experimental 功能,距离真正的 Linux 一等公民体验还有一些距离。
我更期待以后 OpenAI 能进一步做到:
VS Code Codex Extension │ Codex CLI │ ChatGPT Mobile │ Codex Desktop │ ▼ 共享同一套 Linux Codex Session这样对于 Linux、服务器、ROS、机器人、嵌入式和后端开发用户来说,Codex 的完整体验才算真正打通。
参考资料
OpenAI Codex GitHub Repository — install.sh
Codex standalone 安装脚本
OpenAI Codex App Server
Codex app-server README
OpenAI Codex App Server Daemon
Codex app-server-daemon README
OpenAI Help Center
ChatGPT Work and Codex
注:Codex Remote Control 目前仍在快速迭代。本文基于 Codex CLI 0.147.0 的实际测试结果整理,后续版本的命令、手机界面和配对方式可能发生变化。